On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

ImmGetGuideLine

[Now Supported on Windows NT]

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.

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

ImmGetGuideLine

[Теперь Поддерживанное на Windows NT]

Функция ImmGetGuideLine получает информацию об ошибках. Приложения используют информацию, чтобы уведомлять пользователей.

DWORD ImmGetGuideLine(dwBufLen

HIMC hIMC, DWORD dwIndex, LPTSTR lpBuf, DWORD dwBufLen
);

Параметры

hIMC

Прооперируйте входной контекст.

dwIndex

Тип информации основного направления, чтобы извлекаться. Может быть одним из следующего величин:

Значение Величины
GGL_LEVEL Возвращает уровень ошибки.
GGL_INDEX Возвращает индекс ошибки.
GGL_STRING Извлекает строку сообщения ошибки.
GGL_PRIVATE Возвращает информацию об обратном преобразовании.

lpBuf

Указатель в буфер, который получает строку сообщения ошибки. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если dwIndex - не GGL_STRING или GGL_PRIVATE если dwBufLen нулевой.

dwBufLen

Размер, в байтах, буфера указывался, чтобы lpBuf. Если нуль, функция возвращает буферный размер, которому нужно получать строку сообщения ошибки, не включая завершающий недействительный символ.

Обратные Величины

Обратная величина - уровень ошибки, индекс ошибки, или размер строки сообщения ошибки, в зависимости от величины параметра dwIndex. Если dwIndex - GGL_LEVEL, обратная величина - одно из следующего:

Значение Величины
Ошибка GL_LEVEL_ERROR. IME Не может быть способным остаться.
Неисправимая ошибка GL_LEVEL_FATAL. IME Не может остаться, и данные могут быть потерены.
No ошибка GL_LEVEL_INFORMATION, но информация доступно для пользователя.
No ошибка GL_LEVEL_NOGUIDELINE. Удалите предшествующее сообщение ошибки если все еще видимый.
Неожиданный ввод GL_LEVEL_WARNING или другой результат. Пользователь должен быть предупрежден, но IME может остаться.

Если dwIndex - GGL_INDEX, обратная величина - одно из следующего:

Значение Величины
GL_ID_CANNOTSAVE словарь или данные статистики не могут быть сохранены.
GL_ID_NOCONVERT IME не может преобразоваться больше.
GL_ID_NODICTIONARY IME не может найти словарь, или словарь имеет неожиданный формат.
GL_ID_NOMODULE IME не может находить модуль, что IME нужно.
GL_ID_READINGCONFLICT Например, некоторые гласные не могут скомпоновать.
GL_ID_TOOMANYSTROKE Есть слишком много штрихов для одного символа или одной статьи.
GL_ID_TYPINGERROR, печатающий ошибку. IME Не может оперировать это занесение.
Неизвестная ошибка GL_ID_UNKNOWN. Приложение должно ссылаться на строку сообщения ошибки.
GL_ID_INPUTREADING IME принимает символьный ввод чтения.
GL_ID_INPUTRADICAL IME принимает радикальный символьный ввод.
GL_ID_INPUTCODE IME принимает символьный кодовый ввод.
GL_ID_CHOOSECANDIDATE IME принимает возможный выбор строки.
Информация GL_ID_REVERSECONVERSION об обратном преобразовании доступна.

Если dwIndex - GGL_STRING, обратная величина является количеством байтов строки скопированной в буфер, или если dwBufLen - нуль, обратная величина является буферным размером, которому нужно получать строку.
Если dwIndex - GGL_PRIVATE, обратная величина является количеством байтов информации скопированной в буфер. Если dwIndex - GGL_PRIVATE и dwBufLen - нуль, обратная величина является буферным размером, которому нужно получать информацию.

Замечания

Приложения обычно вызывают эту функцию после получать сообщения IMN_GUIDELINE.

Используются технологии uCoz