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 |
|---|---|
|
La méthode a réussi. |
|
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. |
|
Cette méthode a été appelée lors d’un autre appel ITfDocumentMgr::P op . |
|
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 |