Метод ITextServices::OnTxInPlaceActivate (textserv.h)

Статья
08/26/2023

Уведомляет объект текстовых служб о том, что этот элемент управления активен на месте.

Синтаксис

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

Параметры

[in] prcClient

Тип: const RECT*

Клиентский прямоугольник элемента управления.

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

Тип: HRESULT

Если объект успешно активирован, возвращаемое значение будет S_OK.

Если объект не удалось активировать из-за ошибки, возвращаемое значение будет E_FAIL. Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.

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

Обратите внимание, что активация пользовательского интерфейса отличается от получения фокуса. Чтобы сообщить объекту текстовых служб о том, что элемент управления получает или теряет фокус, узел отправляет WM_SETFOCUS и WM_KILLFOCUS сообщения. Кроме того, обратите внимание, что узел без окна передает значение NULL в качестве wParam (окно, которое потеряло фокус) для этих сообщений.

При переходе непосредственно из неактивного состояния в состояние активности пользовательского интерфейса узел должен сначала вызвать ITextServices::OnTxInPlaceActivate , а затем ITextServices::OnTxUIActivate.

ITextServices::OnTxInPlaceActivate принимает в качестве параметра клиентский прямоугольник активируемого представления. Этот прямоугольник задается в клиентских координатах содержащего окна. Это то же, что и при вызове TxGetClientRect на узле.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	textserv.h
DLL	Msftedit.dll