Condividi tramite


Metodo ITfDocumentMgr::P op (msctf.h)

Rimuove il contesto dall'inizio dello stack di contesto.

Sintassi

HRESULT Pop(
  [in] DWORD dwFlags
);

Parametri

[in] dwFlags

Se questo valore è 0, viene rimosso solo il contesto nella parte superiore dello stack. Se questo valore è TF_POPF_ALL, tutti i contesti vengono rimossi dallo stack.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
Il metodo è stato eseguito correttamente.
E_FAIL
Lo stack è vuoto o questo metodo viene chiamato senza il flag TF_POPF_ALL e solo un singolo contesto si trova nello stack.
E_UNEXPECTED
Questo metodo è stato chiamato durante un'altra chiamata ITfDocumentMgr::P op .
E_INVALIDARG
dwFlags non è valido.

Commenti

Questo metodo deve essere chiamato dallo stesso thread della chiamata ITfDocumentMgr::P ush corrispondente.

Il primo contesto aggiunto allo stack diventa il contesto primario. Il contesto primario non può essere rimosso dallo stack senza usare il flag di TF_POPF_ALL. Quando il documento non è inizializzato, questo metodo deve essere chiamato con il flag TF_POPF_ALL. In questo modo, gestione documenti rimuove tutti i contesti dallo stack di contesto e termina qualsiasi interfaccia utente del servizio di testo. Non usare il flag TF_POPF_ALL in qualsiasi altro momento.

Questo metodo fa sì che venga chiamato il metodo ITfThreadMgrEventSink::OnPopContext di tutti i sink di eventi di Gestione thread installati. Se l'ultimo contesto viene rimosso dallo stack, questo metodo fa sì che venga chiamato il metodo ITfThreadMgrEventSink::OnUninitDocumentMgr di tutti i sink eventi di Gestione thread installati.

Requisiti

   
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

ITfDocumentMgr

ITfDocumentMgr::P ush

ITfThreadMgrEventSink::OnPopContext

ITfThreadMgrEventSink::OnUninitDocumentMgr