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

Статья
08/24/2023

Метод 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 Профессиональная

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