Condividi tramite


Metodo ITfDocumentMgr::P ush (msctf.h)

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

Vedi anche

ITfContext

ITfDocumentMgr

ITfDocumentMgr::CreateContext

ITfDocumentMgr::P op

ITfThreadMgrEventSink::OnInitDocumentMgr

ITfThreadMgrEventSink::OnPushContext