Metodo ITfThreadMgr::AssociateFocus (msctf.h)

Associa lo stato attivo per una finestra a un oggetto gestione documenti.

Sintassi

HRESULT AssociateFocus(
  [in]  HWND           hwnd,
  [in]  ITfDocumentMgr *pdimNew,
  [out] ITfDocumentMgr **ppdimPrev
);

Parametri

[in] hwnd

Handle della finestra per associare lo stato attivo a.

[in] pdimNew

Puntatore al gestore documenti per associare lo stato attivo a. Il gestore TSF non incrementa il conteggio dei riferimenti dell'oggetto. Questo valore può essere NULL.

[out] ppdimPrev

Riceve il gestore documenti associato in precedenza alla finestra. Riceve NULL se non è presente alcuna associazione precedente. Questo parametro non può essere NULL.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Questo metodo viene fornito come praticità per lo sviluppatore di applicazioni. Associando lo stato attivo per una finestra a un gestore documenti, la gestione TSF chiama automaticamente ITfThreadMgr::SetFocus con gestione documenti associata quando la finestra associata riceve lo stato attivo.

Questo metodo può associare solo una singola finestra a un singolo gestore documenti. Se l'implementazione associa più gestioni documenti a una singola finestra o all'opposto, l'implementazione deve chiamare ITfThreadMgr::SetFocus per impostare lo stato attivo sul gestore documenti appropriato.

Per ripristinare l'associazione dello stato attivo precedente, chiamare questo metodo con lo stesso handle della finestra e il valore restituito nella chiamata originale ppdimPrev per pdimNew. Di seguito è riportato un esempio.

//associate the focus for m_hwnd with m_pDocMgr 
pThreadMgr->AssociateFocus(m_hwnd, m_pDocMgr, &m_pPrevDocMgr);



//Restore the original focus association. 
ITfDocumentMgr *pTempDocMgr = NULL;

pThreadMgr->AssociateFocus(m_hwnd, m_pPrevDocMgr, &pTempDocMgr);

if(pTempDocMgr)
{
    pTempDocMgr->Release();
}
    
if(m_pPrevDocMgr)
{
    m_pPrevDocMgr->Release();
}

Requisiti

Vedi anche

ITfDocumentMgr

ITfThreadMgr

ITfThreadMgr::SetFocus