Метод IInkRecognizerContext::p utref_Guide (msinkaut.h)
Возвращает или задает inkRecognizerGuide , используемый для ввода рукописного ввода.
Это свойство является чтением и записью.
Синтаксис
HRESULT putref_Guide(
IInkRecognizerGuide *RecognizerGuide
);
Параметры
RecognizerGuide
Возвращаемое значение
None
Remarks
Установка свойства Guide выполняется успешно, только если коллекция InkStrokes имеет значение NULL. Перед присоединением коллекции InkStrokes к InkRecognizerContext необходимо задать свойство Guide или задать для коллекции 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 |