ITfDocumentMgr ::P ush, méthode (msctf.h)

Ajoute un contexte en haut de la pile de contextes.

Syntaxe

HRESULT Push(
  [in] ITfContext *pic
);

Paramètres

[in] pic

Pointeur vers l’objet ITfContext à ajouter à la pile. Cet objet est obtenu à partir d’un appel précédent à ITfDocumentMgr ::CreateContext.

Valeur retournée

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

Remarques

Le premier contexte ajouté à la pile devient le main contexte de document.

Le gestionnaire TSF et les services de texte interagissent uniquement avec le contexte situé en haut de la pile. Normalement, seul le contexte de document main se trouve sur la pile. Parfois, il est nécessaire d’ajouter un deuxième contexte à la pile. Par exemple, lorsqu’un service de texte doit afficher une interface utilisateur modale, telle qu’une liste de candidats. Pendant ce temps, le service de texte ajoute son contexte à la pile. Lorsque l’interface utilisateur du service de texte n’est plus nécessaire, le service de texte supprime le contexte de la pile. Le contexte main retourne ensuite en haut de la pile. Pour simplifier ce processus et empêcher l’affichage de plusieurs interfaces utilisateur modales, deux contextes maximum sont autorisés sur la pile.

Cette méthode entraîne l’appel de la méthode ITfThreadMgrEventSink ::OnPushContext de tous les récepteurs d’événements du gestionnaire de threads installés. S’il s’agit du premier contexte à ajouter à la pile, cette méthode provoque l’appel de la méthode ITfThreadMgrEventSink ::OnInitDocumentMgr de tous les récepteurs d’événements du gestionnaire de threads installés.

ITfDocumentMgr ::P op doit être appelé pour supprimer ce contexte de la pile de contexte.

Configuration requise

Voir aussi

ITfContext

ITfDocumentMgr

ITfDocumentMgr ::CreateContext

ITfDocumentMgr ::P op

ITfThreadMgrEventSink ::OnInitDocumentMgr

ITfThreadMgrEventSink ::OnPushContext