Метод ITextHost::TxActivate (textserv.h)

Уведомляет текстовый узел о том, что элемент управления активен.

Синтаксис

HRESULT TxActivate(
  LONG *plOldState
);

Параметры

plOldState

Тип: LONG*

Предыдущее состояние активации.

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

Тип: HRESULT

Возвращает S_OK, если метод выполнен успешно.

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

Код возврата	Описание
E_FAIL	В настоящее время активация невозможна.

Комментарии

Узлу разрешено отклонять запрос на активацию; Например, элемент управления может быть сведен к минимуму и, следовательно, невидим.

Вызывающий объект должен иметь возможность корректно обрабатывать сбой при активации.

Независимо от того, сколько раз вызывается этот метод, для отключения элемента управления требуется только один вызов ITextHost::TxDeactivate .

Эта функция возвращает непрозрачный дескриптор в plOldState. Вызывающий объект (объект текстовых служб) должен сохранить этот дескриптор и использовать его в последующем вызове ITextHost::TxDeactivate.

Требования

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

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

Основные понятия

ITextHost

Справочные материалы

TxDeactivate

Элементы управления "Полнофункционированные изменения" без окон