Метод ITfDocumentMgr::P ush (msctf.h)
Добавляет контекст в верхнюю часть стека контекста.
Синтаксис
HRESULT Push(
[in] ITfContext *pic
);
Параметры
[in] pic
Указатель на объект ITfContext , добавляемый в стек. Этот объект получен из предыдущего вызова метода ITfDocumentMgr::CreateContext.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Значение | Описание |
|---|---|
|
Метод выполнен успешно. |
|
недопустимое значение pic . |
|
В стеке нет места для контекста. Стек контекста имеет ограничение в два контекста. |
|
Этот метод был вызван во время вызова 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 Профессиональная |