This method is called by the input method (IM) to send an entire string to the window that currently has the focus; that is, the window that would have received keyboard input if a key had been pressed on an external keyboard.
At a Glance
| Header file: | Sip.h |
| Windows CE Versions: | 2.12 and later |
Syntax
HRESULT SendString( LPTSTR ptszStr, DWORD dwSize );
Parameters
ptszStr
Pointer to a string buffer containing the string to send.
dwSize
Specifies the number of characters in the buffer. This number should not include the terminating null character, which is not sent.
Return Values
An appropriate HRESULT value is returned.
Remarks
An IM uses this method after an entire word or sentence has been entered. For example, a character recognizer IM could call this method after the user enters a full word. The input panel sends each character in the buffer as a WM_CHAR message to the current application. You can also use IIMCallback2::SendCharEvents and IIMCallback2::SendVirtualKey to send characters to the current application.
See Also