IIMCallback2::SendString

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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.

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 Value

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 software-based 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.

Requirements

See Also

Reference

WM_CHAR
IIMCallback2::SendCharEvents
IIMCallback2::SendVirtualKey