На главную

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 | Скачать Вниз

Composition String



The composition string is the current text in the composition window. This is the text that the IME converts to final characters. Each composition string consists of one or more clauses, where a clause is the smallest combination of characters that the IME can convert to a final character. You can get and set the composition string and get and set the composition string by using the ImmGetCompositionString and ImmSetCompositionString functions.

As the user enters text in the composition window, the IME tracks the status of the composition string. This status includes attribute information, clause information, typing information, and cursor position. You can retrieve the composition status by using the ImmGetCompositionString function.
In the attribute information array, all characters of one clause must have the same attribute. The attribute information is an array of 8-bit values that specifies the status of characters in the composition string. There is one value for each byte in the string, including one byte each for the lead and second bytes of any double-byte characters in the string. For each value in the array, bits 0 through 3 can be one combination of these values:

ATTR_INPUT
Character being entered by the user. It is yet to be converted by the IME.
ATTR_INPUT_ERROR
Character is the error character and cannot be converted by the IME.
ATTR_TARGET_CONVERTED
Character converted by the IME. The user has selected this character and the IME has converted it.
ATTR_CONVERTED
A converted character. The IME has already converted this character.
ATTR_TARGET_NOTCONVERTED
Character being converted. The user has selected this character but the IME has not yet converted it.


All other values are reserved. In Japanese, any unconverted character having the ATTR_INPUT attribute is a Hiragana, Katakana, or alphanumeric character. In Korean, this character is a Hangeul character that is not converted by IME yet. In Traditional and Simplified Chinese, each IME may limit its character in some range.
You can retrieve the composition status by using the ImmGetCompositionString function.
The clause information is an array of 32-bit values that specify the positions of the clauses in the composition string. There is one value for each clause and a final value that specifies the length of the full string. Each value in the array specifies the offset, in bytes, from the beginning of the string to the clause. The first value is always 0 because the first clause always starts at the beginning of the string. For example, if a string has two clauses, the clause information has three values: the first value is 0, the second value is the offset of the second clause, and the third value is the length of the string.

The typing information a null-terminated character string representing the characters entered at the keyboard.
The cursor position is a value indicating the position of the cursor relative to the characters in the composition string. The value is the offset, in bytes, from the beginning of the string. If this value is 0, the cursor is immediately before the first character in the string. If the value is equal to the length of the string, the cursor is immediately after the last character. If -1, the cursor is not present.

You can set the composition string or elements of the composition status by using the ImmSetCompositionString function. To ensure that the composition window updates it appearance based on these changes, the function allows for generating a notification message to be sent to the window. Applications that set a combination of composition status elements typically set the fNotify parameter to FALSE for all but the last call to this function so that only one notification message is generated for the composition window.


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

Строка Композиции



Строка композиции является текущим текстом в окне композиции. Это - текст это преобразования IME в конечные символы. Каждая строка композиции состоит из одной или более статей, где статья является минимальной комбинацией символов, что IME может преобразоваться в конечный символ. Вы можете получить и устанавливать строку композиции и получать и устанавливать строку композиции используя ImmGetCompositionString и функции ImmSetCompositionString.

Так как потребитель вводит текст в окно композиции, IME прослеживает статус строки композиции. Этот статус включает вспомогательную информационную, статью информационное, занесение информации, и позицию курсора. Вы можете извлечь статус композиции используя функцию ImmGetCompositionString.
Во вспомогательном информационном массиве, все типы одной статьи должны иметь тот же атрибут. Вспомогательная информация является массивом 8- битовых величин, которые определяют статус символов в строке композиции. Есть один величина для каждого байта в строке, включая один байт каждый для свинцовй и байтов секунды любых двойных-байтовых символов в строке. Для каждой величины в массиве, биты 0 по 3 могут быть одна комбинация этих величин:

ATTR_INPUT
Символ, ввоженный пользователем. Это пока должно быть преобразованн IME.
ATTR_INPUT_ERROR
Символ является символом ошибки и не мочь быть преобразовано IME.
ATTR_TARGET_CONVERTED
Символ преобразовывался IME. Пользователь выбрался этот символ и IME преобразовал это.
ATTR_CONVERTED
Преобразованный символ. IME Уже преобразовал этот символ.
ATTR_TARGET_NOTCONVERTED
Символ, преобразовыванный. Пользователь выбрался этот символ но IME еще не преобразовал это.


Все другие величины зарезервированы. В Японце, любой unconverted символ, имеющий атрибут ATTR_INPUT является Hiragana, Katakana, или текстовым символом. В Корейце, этот символ является символом Hangeul, что не преобразован IME пока. В Традиционном и Упрощенном Китайце, каждый IME может ограничить свой символ в некотором дипазоне.
Вы можете извлечь статус композиции используя функцию ImmGetCompositionString.
Информация статьи является массивом 32- битовых величин, которые определяют позиции статей в строке композиции. Есть один величина для каждой статьи и конечная величина, которые определяют длину полной строки. Каждая величина в массиве определяет смещение, в байтах, от начала строки до статьи. Первая величина - всегда 0 поскольку первая статья всегда начинается в начале строки. Например, если строка имеет две статьи, информация статьи имеет три величины: первая величина - 0, вторая величина является смещением второй статьи, и третья величина является длиной строки.

Печатающая информация недействительный расторгнутая символьная строка, представляющая, что символы входили на клавиатуре.
Позиция курсора является величиной, указывающей позицию курсора относительно символов в строке композиции. Величина является смещением, в байтах, из начала строки. Если эта величина - 0, курсор - немедленно перед первым символом в строке. Если величина равняется длине строки, курсор - немедленно после последнего символа. Если -1, курсор не присутствует.

Вы можете установить строку композиции или элементов статуса композиции используя функцию ImmSetCompositionString. Чтобы проверять, что окно композиции корректирует этому появление основывался в этих изменениях, функция учитывает генерируя сообщение уведомления, которое нужно посылаться в окно. Приложения, которые устанавливают комбинацию элементов статуса композиции обычно установленной fNotify параметр в ЛОЖЬ для почти последнего вызова в эту функцию чтобы только одно сообщение уведомления было сгенерировано для окна композиции.


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz