Metodo ITfDocumentMgr::P ush (msctf.h)

Articolo
03/13/2024

Aggiunge un contesto all'inizio dello stack di contesto.

Sintassi

HRESULT Push(
  [in] ITfContext *pic
);

Parametri

[in] pic

Puntatore all'oggetto ITfContext da aggiungere allo stack. Questo oggetto viene ottenuto da una chiamata precedente a ITfDocumentMgr::CreateContext.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	pic non è valido.
TF_E_STACKFULL	Non esiste spazio nello stack per il contesto. Lo stack di contesto ha un limite di due contesti.
E_UNEXPECTED	Questo metodo è stato chiamato durante una chiamata ITfDocumentMgr::P op .

Commenti

Il primo contesto aggiunto allo stack diventa il contesto del documento principale.

Il gestore TSF e i servizi di testo interagiscono solo con il contesto nella parte superiore dello stack. In genere, solo il contesto del documento principale si trova nello stack. Occasionalmente, è necessario aggiungere un secondo contesto allo stack. Ad esempio, quando un servizio di testo deve visualizzare un'interfaccia utente modale, ad esempio un elenco candidato. Durante questo periodo, il servizio di testo aggiungerà il relativo contesto allo stack. Quando l'interfaccia utente del servizio di testo non è più necessaria, il servizio di testo rimuove il contesto dallo stack. Il contesto principale restituisce quindi la parte superiore dello stack. Per semplificare questo processo e impedire la visualizzazione di più UI modali, è consentito un massimo di due contesti nello stack.

Questo metodo causa la chiamata del metodo ITfThreadMgrEventSink::OnPushContext di tutti i sink di eventi di Gestione thread installati. Se si tratta del primo contesto da aggiungere allo stack, questo metodo causa la chiamata al metodo ITfThreadMgrEventSink::OnInitDocumentMgr di tutti i sink di eventi di Gestione thread installati.

ITfDocumentMgr::P op deve essere chiamato per rimuovere questo contesto dallo stack di contesto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional