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


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

Удаляет контекст из верхней части стека контекста.

Синтаксис

HRESULT Pop(
  [in] DWORD dwFlags
);

Параметры

[in] dwFlags

Если это значение равно 0, удаляется только контекст в верхней части стека. Если это значение TF_POPF_ALL, все контексты удаляются из стека.

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

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

Значение Описание
S_OK
Метод выполнен успешно.
E_FAIL
Стек пуст или этот метод вызывается без флага TF_POPF_ALL и в стеке находится только один контекст.
E_UNEXPECTED
Этот метод был вызван во время другого вызова ITfDocumentMgr::P op .
E_INVALIDARG
Недопустимый dwFlags .

Комментарии

Этот метод должен вызываться из того же потока, что и соответствующий вызов ITfDocumentMgr::P ush .

Первый контекст, добавленный в стек, становится основным контекстом. Основной контекст нельзя удалить из стека без использования флага TF_POPF_ALL. Если документ не инициализирован, этот метод следует вызывать с флагом TF_POPF_ALL. Это приводит к тому, что диспетчер документов удаляет все контексты из стека контекстов и завершает работу любого пользовательского интерфейса службы текста. Не используйте флаг TF_POPF_ALL в любое другое время.

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

Требования

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

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

ITfDocumentMgr

ITfDocumentMgr::P ush

ITfThreadMgrEventSink::OnPopContext

ITfThreadMgreventSink::OnUninitDocumentMgr