Метод IPenInputPanel::EnableTsf (peninputpanel.h)

Статья
08/25/2023

[ Элемент PenInputPanel был заменен панелью ввода текста (TIP).]

Не рекомендуется. Возвращает или задает логическое значение, указывающее, пытается ли объект PenInputPanel отправить текст присоединенному элементу управления через платформу текстовых служб (TSF) и позволяет использовать пользовательский интерфейс коррекции .

Синтаксис

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

Параметры

Enable

Значение TRUE , если объект PenInputPanel должен попытаться отправить текст в присоединенный элемент управления с помощью TSF и что необходимо включить пользовательский интерфейс коррекции; В противном случае — FALSE. Значение по умолчанию — TRUE.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Успешно.
E_UNEXPECTED	Непредвиденный параметр или тип свойства.
E_NOINTERFACE	Интерфейсы TSF не предоставляются в присоединенном элементе управления.
E_FAIL	Произошла неизвестная ошибка.

EnableTsf следует использовать, чтобы разрешить PenInputPanel использовать контекст вставки TSF, а не функцию SendInput для отправки результатов распознавания рукописного ввода в элемент управления . В результате текст можно вставить, даже если поле больше не имеет фокуса.

При вызове EnableTsf со значением TRUE объект PenInputPanel отправляет сообщение EM_SETEDITSTYLE присоединенному элементу управления. Если элемент управления не поддерживает это сообщение, результаты могут быть непредсказуемыми. Элемент управления InkEdit поддерживает TSF.

Поддержка устаревших приложений

В TSF и Microsoft Windows добавлена поддержка, обеспечивая согласованный пользовательский интерфейс для всех приложений на настольном компьютере. Эта новая поддержка позволяет устаревшим приложениям или элементам управления, которые не знают о TSF, бесплатно пользоваться преимуществами некоторых расширенных текстовых служб. Например, диктовку речи и рукописный ввод теперь можно использовать для ввода текста в документ в любом приложении.

Эта новая функция доступна и включена по умолчанию в выпуске Windows XP Tablet PC Edition. Чтобы включить или отключить его, выполните приведенные далее действия.

В панель управления щелкните Региональные и языковые параметры.
На вкладке Языки щелкните Сведения.
На вкладке Дополнительно диалогового окна Текстовые службы и языки ввода выберите или снимите флажок Расширить поддержку расширенных текстовых служб для всех программ.

В случае успешного выполнения текст отправляется в присоединенный элемент управления через TSF. Кроме того, если элемент управления поддерживает TSF (а не просто получает текст из TSF только потому, что расширенные текстовые службы включены для всех программ в панель управления, как указано выше), то пользовательский интерфейс исправления отображается в элементе управления и предоставляет доступ к альтернативным рукописным данным. Вызов этого метода с параметром Enable с значением FALSE приводит к тому, что объект PenInputPanel попытается завершить работу TSF для присоединенного элемента управления.

Требования


Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	peninputpanel.h
Библиотека	InkObj.dll

См. также раздел

IPenInputPanel

PenInputPanel

Поделиться через