Метод IInkRecognizerContext::get_Guide (msinkaut.h)
Возвращает или задает inkRecognizerGuide , используемый для ввода рукописного ввода.
Это свойство доступно для чтения и записи.
Синтаксис
HRESULT get_Guide(
IInkRecognizerGuide **RecognizerGuide
);
Параметры
RecognizerGuide
Возвращаемое значение
None
Remarks
Установка свойства Guide завершается успешно, только если коллекция InkStrokes имеет значение NULL. Необходимо задать свойство Guide перед присоединением коллекции InkStrokes к InkRecognizerContext или задать для коллекции InkStrokes значение NULL , а затем задать guide (и, возможно, повторно присоединить коллекцию InkStrokes).
Перечисление InkRecognizerCapabilities содержит флаги IRC_FreeInput, IRC_LinedInput и IRC_BoxedInput . Эти флаги определяют возможности распознавателя, но поскольку они доступны только для чтения, невозможно задать их непосредственно в объекте IInkRecognizer или InkRecognizerContext . Единственный способ поместить распознаватель в определенный режим — задать направляющую с помощью свойства Guide . Если свойство Guide не задано, распознаватель по умолчанию будет использовать режим FreeInput (если распознаватель поддерживает это). Еще один способ установить распознаватель в режим FreeInput — задать для свойства Guide объект InkRecognizerGuide , свойство Columns которого имеет нулевое значение, а свойство Rows — нулевое.
Если для свойства Guide задано значение объекта InkRecognizerGuide , свойство Columns которого равно нулю, а свойство Rows равно 1 или более, распознаватель будет работать в режиме IRC_LinedInput (если распознаватель поддерживает это). Распознаватель использует свойство Rows для управления количеством строк.
Если для свойства Guide задано значение объекта InkRecognizerGuide , свойство Rows которого равно нулю, а свойству Columns — значение 1 или более, распознаватель будет работать в режиме IRC_LinedInput (если распознаватель может это сделать) для вертикальной записи. Распознаватель использует свойство Columns для управления количеством вертикальных линий. Если распознаватель способен на это, свойство Capabilities объекта IInkRecognizer возвращает либо IRC_DownAndLeft, либо IRC_DownAndRight, либо и то, и другое.
Если для свойства Guide задано значение объекта InkRecognizerGuide , свойство Columns которого равно 1 или более, а свойству Rows — значение 1 или более, распознаватель будет работать в режиме IRC_BoxedInput (если распознаватель может это сделать).
Если задать режим , недоступный в этом распознавателье, возвращается ошибка.
Сведения о том, как запрашивать возможности или режимы, доступные у определенного распознавателя, см. в свойстве Capabilities объекта IInkRecognizer . Как правило, распознаватели латиницы поддерживают свободный ввод и горизонтальный ввод, распознаватели восточноазиатских символов поддерживают свободный ввод и коробочный ввод, а распознаватель жестов поддерживает только свободный ввод.
Требования
| Минимальная версия клиента | Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | msinkaut.h |
| Библиотека | InkObj.dll |