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

Метод ITfUIElementSink::BeginUIElement (msctf.h)

  • Статья

Метод ITfUIElementSink::BeginUIElement вызывается при запуске UIElement. Этот приемник может позволить службе textservice рисовать или не рисовать элемент пользовательского интерфейса.

Синтаксис

HRESULT BeginUIElement(
  [in] DWORD dwUIElementId,
       BOOL  *pbShow
);

Параметры

[in] dwUIElementId

[in] Идентификатор запущенного элемента UIElement.

pbShow

[вход, выход] Возвращает значение true , если приложение не рисует содержимое UIElement, а текстовая служба рисует исходное содержимое пользовательского интерфейса. Возвращает значение false , если приложение рисует содержимое UIElement и останавливает службу текста от его рисования. Приложение может получить интерфейс ITfUIElement с помощью ITfUIElementMgr::GetUIElement и оценить, может ли оно обрабатывать UIElement с помощью QI с помощью IID_ITfCandidateListUIElement или с другими интерфейсами UIElement. Приложение всегда может возвращать значение FALSE , если оно неизвестно или оно не может быть обработано. В этом случае служба текста не будет отображать дополнительный пользовательский интерфейс на экране. Это хороший способ для некоторых полноэкранных приложений. Кроме того, приложение может возвращать значение TRUE , чтобы использовать пользовательский интерфейс TextService в некоторых определенных или неизвестных пользовательских интерфейсах.

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

Диспетчер TSF игнорирует возвращаемое значение этого метода.

Значение Описание
S_OK
 Метод выполнен успешно.
E_FAIL
 Произошла неизвестная ошибка.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header msctf.h
DLL Msctf.dll
Распространяемые компоненты TSF 1.0 в Windows 2000 Профессиональная