Метод 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