Método ITfThreadMgr::AssociateFocus (msctf.h)

Associa o foco de uma janela a um objeto do gerenciador de documentos.

Sintaxe

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

Parâmetros

[in] hwnd

Identificador da janela à qual associar o foco.

[in] pdimNew

Ponteiro para o gerenciador de documentos ao qual associar o foco. O gerenciador do TSF não incrementa a contagem de referência de objeto. Esse valor pode ser NULL.

[out] ppdimPrev

Recebe o gerenciador de documentos anteriormente associado à janela. Receberá NULL se não houver nenhuma associação anterior. Esse parâmetro não pode ser NULL.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.

Comentários

Esse método é fornecido como uma conveniência para o desenvolvedor de aplicativos. Associar o foco de uma janela a um gerenciador de documentos faz com que o gerente do TSF chame automaticamente ITfThreadMgr::SetFocus com o gerenciador de documentos associado quando a janela associada receber o foco.

Esse método só pode associar uma única janela a um único gerenciador de documentos. Se a implementação associar vários gerentes de documentos a uma única janela ou o oposto, a implementação deverá chamar ITfThreadMgr::SetFocus para definir o foco para o gerenciador de documentos adequado.

Para restaurar a associação de foco anterior, chame esse método com o mesmo identificador de janela e o valor retornado na chamada original ppdimPrev para pdimNew. A seguir, é mostrado um exemplo.

//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();
}

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional

Confira também

ITfDocumentMgr

ITfThreadMgr

ITfThreadMgr::SetFocus