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

Asocia el foco de una ventana a un objeto de administrador de documentos.

Sintaxis

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

Parámetros

[in] hwnd

Identificador de la ventana con la que asociar el foco.

[in] pdimNew

Puntero al administrador de documentos al que asociar el foco. El administrador de TSF no incrementa el recuento de referencias de objetos. Este valor puede ser NULL.

[out] ppdimPrev

Recibe el administrador de documentos asociado previamente a la ventana. Recibe NULL si no hay ninguna asociación anterior. Este parámetro no puede ser NULL.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	Uno o varios parámetros no son válidos.

Comentarios

Este método se proporciona como una comodidad para el desarrollador de aplicaciones. La asociación del foco de una ventana con un administrador de documentos hace que el administrador de TSF llame automáticamente a ITfThreadMgr::SetFocus con el administrador de documentos asociado cuando la ventana asociada recibe el foco.

Este método solo puede asociar una sola ventana a un único administrador de documentos. Si la implementación asocia varios administradores de documentos a una sola ventana, o lo contrario, la implementación debe llamar a ITfThreadMgr::SetFocus para establecer el foco en el administrador de documentos adecuado.

Para restaurar la asociación de foco anterior, llame a este método con el mismo identificador de ventana y el valor devuelto en la llamada original ppdimPrev para pdimNew. A continuación se muestra un ejemplo.

//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 compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional

Consulte también

ITfDocumentMgr

ITfThreadMgr

ITfThreadMgr::SetFocus