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


Метод ITfDocumentMgr::P ush (msctf.h)

Добавляет контекст в верхнюю часть стека контекста.

Синтаксис

HRESULT Push(
  [in] ITfContext *pic
);

Параметры

[in] pic

Указатель на объект ITfContext , добавляемый в стек. Этот объект получен из предыдущего вызова метода ITfDocumentMgr::CreateContext.

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

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

Значение Описание
S_OK
Метод выполнен успешно.
E_INVALIDARG
недопустимое значение pic .
TF_E_STACKFULL
В стеке нет места для контекста. Стек контекста имеет ограничение в два контекста.
E_UNEXPECTED
Этот метод был вызван во время вызова ITfDocumentMgr::P op .

Комментарии

Первый контекст, добавленный в стек, становится main контекстом документа.

Диспетчер TSF и текстовые службы взаимодействуют только с контекстом в верхней части стека. Обычно в стеке находится только main контекст документа. Иногда необходимо добавить второй контекст в стек. Например, если служба текста должна отображать модальный пользовательский интерфейс, например список кандидатов. В течение этого времени служба текста добавит свой контекст в стек. Если пользовательский интерфейс службы текста больше не требуется, служба текста удаляет контекст из стека. Затем контекст main возвращается в верхнюю часть стека. Чтобы упростить этот процесс и предотвратить отображение нескольких модальных пользовательских интерфейсов, в стеке разрешено не более двух контекстов.

Этот метод вызывает метод ITfThreadMgrEventSink::OnPushContext всех установленных приемников событий диспетчера потоков. Если это первый контекст, добавляемый в стек, этот метод вызывает метод ITfThreadMgrEventSink::OnInitDocumentMgr всех установленных приемников событий диспетчера потоков.

Чтобы удалить этот контекст из стека контекста, необходимо вызвать ITfDocumentMgr::P op.

Требования

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

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

ITfContext

ITfDocumentMgr

ITfDocumentMgr::CreateContext

ITfDocumentMgr::P op

ITfThreadMgreventSink::OnInitDocumentMgr

ITfThreadMgreventSink::OnPushContext