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.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	Uno o più parametri non sono validi.

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

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfDocumentMgr

ITfThreadMgr

ITfThreadMgr::SetFocus