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 |
|---|---|
|
Il metodo è stato eseguito correttamente. |
|
pic non è valido. |
|
Non esiste spazio nello stack per il contesto. Lo stack di contesto ha un limite di due contesti. |
|
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 |