Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The EM_STREAMIN message replaces the contents of a RichInk control with a stream of data provided by an application-defined EditStreamCallbackcallback function.

Syntax 

EM_STREAMIN
  wParam = (WPARAM) (UINT) 
uFormat;
  lParam = (LPARAM) (EDITSTREAM FAR *) 
lpStream;

Parameters

uFormat

A set of bit flags that indicate the data format and replacement options.

This value must specify one of the following data formats.

Flag Data format

SF_TEXT

ASCII Text

SF_RTF

Rich Text Format (RTF)

SF_UTEXT

Unicode text

SF_PWI

Word Mobile (formerly Pocket Word) Ink (PWI)
lpStream

Pointer to an EDITSTREAMstructure. On input, the pfnCallbackmember of this structure must point to an application-defined EditStreamCallbackfunction. On output, the dwErrormember can contain a nonzero error code if an error occurred.

When this DLL is used on the desktop, it is assumed that the EDITSTREAMstructure contains a dwCookieof the following type:

Copy Code 
  
pstm;
  
bValue;
  
pData;
  
bLoss;
Note:
Prior to Windows Mobile 6.5, the EDITSTREAM structure's first item was a DWORD, not a DWORD_PTR.

The RichInk control may then modify the value to indicate whether any data loss occurs during the input conversion. For more information about this structure, see COOKIE.

Return Value

Returns zero if there are no errors.

Remarks

Copy Code 
#define EM_STREAMIN (WM_USER + 73)

When you send an EM_STREAMIN message, the RichInk Control makes repeated calls to the EditStreamCallbackfunction specified by the pfnCallbackmember of the EDITSTREAMstructure. Each time the callback function is called, it fills a buffer with data to read into the control. This continues until the callback function indicates that the stream-in operation has been completed or an error occurs.

The EditStreamCallbackfunction returns the number of bytes processed. If this is not the same as the number of bytes requested, then the caller assumes an end-of-file condition has occurred.

Requirements

Header richink.h
Library richink.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later

See Also