Méthode ITfDocumentMgr::P op (msctf.h)

Supprime le contexte du haut de la pile de contextes.

Syntaxe

HRESULT Pop(
  [in] DWORD dwFlags
);

Paramètres

[in] dwFlags

Si cette valeur est 0, seul le contexte en haut de la pile est supprimé. Si cette valeur est TF_POPF_ALL, tous les contextes sont supprimés de la pile.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_FAIL	La pile est vide ou cette méthode est appelée sans l’indicateur TF_POPF_ALL et un seul contexte se trouve sur la pile.
E_UNEXPECTED	Cette méthode a été appelée lors d’un autre appel ITfDocumentMgr::P op .
E_INVALIDARG	dwFlags n’est pas valide.

Notes

Cette méthode doit être appelée à partir du même thread que l’appel ITfDocumentMgr::P ush correspondant.

Le premier contexte ajouté à la pile devient le contexte principal. Le contexte principal ne peut pas être supprimé de la pile sans utiliser l’indicateur TF_POPF_ALL. Lorsque le document n’est pas initialisé, cette méthode doit être appelée avec l’indicateur TF_POPF_ALL. Cela oblige le gestionnaire de documents à supprimer tous les contextes de la pile de contextes et à mettre fin à toute interface utilisateur de service de texte. N’utilisez pas l’indicateur TF_POPF_ALL à un autre moment.

Cette méthode entraîne l’appel de la méthode ITfThreadMgrEventSink::OnPopContext de tous les récepteurs d’événements du gestionnaire de threads installés. Si le dernier contexte est supprimé de la pile, cette méthode entraîne l’appel de la méthode ITfThreadMgrEventSink::OnUninitDocumentMgr de tous les récepteurs d’événements du gestionnaire de threads installés.

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITfDocumentMgr

ITfDocumentMgr::P ush

ITfThreadMgrEventSink::OnPopContext

ITfThreadMgrEventSink::OnUninitDocumentMgr