please dont rip this site Prev Next

ImmGetGuideLine info  Overview  Group

The ImmGetGuideLine function gets information about errors. Applications use the information to notify users.

DWORD ImmGetGuideLine(dwBufLen

    HIMC hIMC,

    DWORD dwIndex,

    LPTSTR lpBuf,

    DWORD dwBufLen

   );

Parameters

hIMC
Handle to the input context.
dwIndex
Type of guideline information to retrieve. Can be one of the following values:

Value

Meaning

GGL_LEVEL

Returns the error level.

GGL_INDEX

Returns the error index.

GGL_STRING

Retrieves the error message string.

GGL_PRIVATE

Returns information about reverse conversion.

lpBuf
Pointer to the buffer that receives the error message string. This parameter can be NULL if dwIndex is not GGL_STRING or GGL_PRIVATE if dwBufLen is zero.
dwBufLen
Size, in bytes, of the buffer pointed to by lpBuf. If zero, the function returns the buffer size needed to receive the error message string, not including the terminating null character.

Return Values

The return value is an error level, an error index, or the size of an error message string, depending on the value of the dwIndex parameter. If dwIndex is GGL_LEVEL, the return value is one of the following:

Value

Meaning

GL_LEVEL_ERROR

Error. The IME may not be able to continue.

GL_LEVEL_FATAL

Fatal error. The IME cannot continue, and data may be lost.

GL_LEVEL_INFORMATION

No error, but information is available for the user.

GL_LEVEL_NOGUIDELINE

No error. Remove previous error message if still visible.

GL_LEVEL_WARNING

Unexpected input or other result. The user should be warned, but the IME can continue.

If dwIndex is GGL_INDEX, the return value is one of the following:

Value

Meaning

GL_ID_CANNOTSAVE

The dictionary or the statistics data cannot be saved.

GL_ID_NOCONVERT

The IME cannot convert any more.

GL_ID_NODICTIONARY

The IME cannot find the dictionary, or the dictionary has an unexpected format.

GL_ID_NOMODULE

The IME can not find the module that IME needs.

GL_ID_READINGCONFLICT

For example, some vowels cannot put together.

GL_ID_TOOMANYSTROKE

There are too many strokes for one character or one clause.

GL_ID_TYPINGERROR

Typing error. The IME can not handle this typing.

GL_ID_UNKNOWN

Unknown error. The application should refer to the error message string.

GL_ID_INPUTREADING

IME accepts reading character input.

GL_ID_INPUTRADICAL

IME accepts radical character input.

GL_ID_INPUTCODE

IME accepts character code input.

GL_ID_CHOOSECANDIDATE

IME accepts candidate string selection.

GL_ID_REVERSECONVERSION

Information about reverse conversion is available.

If dwIndex is GGL_STRING, the return value is the number of bytes of the string copied to the buffer, or if dwBufLen is zero, the return value is the buffer size needed to receive the string.

If dwIndex is GGL_PRIVATE, the return value is the number of bytes of information copied to the buffer. If dwIndex is GGL_PRIVATE and dwBufLen is zero, the return value is the buffer size needed to receive the information.

Remarks

Applications typically call this function after receiving an IMN_GUIDELINE message.


file: /Techref/os/win/api/win32/func/src/f47_16.htm, 8KB, , updated: 2000/4/7 12:19, local time: 2024/4/18 03:01,
TOP NEW HELP FIND: 
18.188.40.207:LOG IN

 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF="http://www.piclist.com/techref/os/win/api/win32/func/src/f47_16.htm"> ImmGetGuideLine</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.


Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?

  PICList 2024 contributors:
o List host: MIT, Site host massmind.org, Top posters @none found
- Page Editors: James Newton, David Cary, and YOU!
* Roman Black of Black Robotics donates from sales of Linistep stepper controller kits.
* Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters.
* Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated!
* Contributors: Richard Seriani, Sr.
 

Welcome to www.piclist.com!

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  .