IIMCallback::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 IIMCallback::SendCharEvents and IIMCallback::SendVirtualKey to send characters to the current application.

Requirements

Header sip.h
Library uuid.lib
Windows Embedded CE Windows CE 2.01 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IIMCallback::SendCharEvents
IIMCallback::SendVirtualKey