IMR_DOCUMENTFEED (Windows Embedded CE 6.0)

1/6/2010

This message is sent to the application when the selected IME needs the converted string from the application.

Syntax

wParam = (WPARAM) wDocumentFeed;
lParam = (LPARAM)lpReconvertstring;

Parameters

  • wDocumentFeed
    Set to IMR_DOCUMENTFEED.
  • lpReconvertstring
    Pointer to a buffer to contain the RECONVERTSTRING structure.

Return Value

If lParam is NULL, the application must return the required size of the RECONVERTSTRING structure. If the application filled the RECONVERTSTRING structure in lParam, return the required size of the RECONVERTSTRING structure. Otherwise return zero.

Remarks

The IME caches converted strings for higher conversion accuracy. There are, however, some limitations to caching converted strings because the IME loses the corrected converted string under the following circumstances:

  • When a key, such as the cursor key, moves the application's caret position.
  • When the mouse moves the application's caret position.
  • When a new document is opened.

With the IMR_DOCUMENTFEED command, the IME can refresh its cached strings any time. This improves conversion accuracy.

Requirements

Header imm.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

WM_IME_REQUEST
RECONVERTSTRING

Other Resources

Input Method Manager (IMM) Messages