Share via


IIMCallback3::SendString (Compact 2013)

3/28/2014

This method sends a string to the active window when the input method calls this method.

Syntax

HRESULT SendString( 
  LPTSTR ptszStr, 
  DWORD dwSize
);

Parameters

  • ptszStr
    Pointer to a string buffer containing the string to send.
  • dwSize
    Number of characters in the buffer. This number does not include the terminating NULL character, which the method does not send.

Return Value

The following table shows the possible return values.

Value

Description

S_OK

Success.

E_INVALIDARG

Invalid method parameter.

E_FAIL

Other failure. To get more information, call GetLastError.

Remarks

An input method calls this method after the user enters an entire word or sentence. For example, a character recognizer input method could call this method after the user enters the text for an entire word. The software-based input panel (SIP) sends each character in the buffer as a WM_CHAR message to the current application. You can also use IIMCallback3::SendCharEvents and IIMCallback3::SendVirtualKey to send characters to the current application.

Requirements

Header

sip.h

Library

uuid.lib

sysgen

SYSGEN_SOFTKB

See Also

Reference

IIMCallback3
WM_CHAR
IIMCallback3::GetInputContext
IIMCallback3::SendAlternatives2
IIMCallback3::SendCharEvents
IIMCallback3::SendVirtualKey
IIMCallback3::SetImInfo