ITfThreadMgr::AssociateFocus-Methode (msctf.h)
Ordnet den Fokus für ein Fenster einem Dokument-Manager-Objekt zu.
Syntax
HRESULT AssociateFocus(
[in] HWND hwnd,
[in] ITfDocumentMgr *pdimNew,
[out] ITfDocumentMgr **ppdimPrev
);
Parameter
[in] hwnd
Handle des Fensters, dem der Fokus zugeordnet werden soll.
[in] pdimNew
Zeiger auf den Dokument-Manager, dem der Fokus zugeordnet werden soll. Der TSF-Manager erhöht die Objektverweisanzahl nicht. Dieser Wert kann NULL sein.
[out] ppdimPrev
Empfängt den Dokument-Manager, der zuvor dem Fenster zugeordnet war. Empfängt NULL, wenn keine vorherige Zuordnung vorhanden ist. Dieser Parameter darf nicht NULL sein.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich. |
|
Mindestens ein Parameter ist ungültig. |
Hinweise
Diese Methode wird dem Anwendungsentwickler als Benutzerfreundlichkeit bereitgestellt. Das Zuordnen des Fokus für ein Fenster zu einem Dokument-Manager bewirkt, dass der TSF-Manager ITfThreadMgr::SetFocus automatisch mit dem zugeordneten Dokument-Manager aufruft, wenn das zugeordnete Fenster den Fokus empfängt.
Diese Methode kann nur einem einzelnen Dokument-Manager ein einzelnes Fenster zuordnen. Wenn die Implementierung mehrere Dokument-Manager mit einem einzelnen Fenster oder umgekehrt verknüpft, muss die Implementierung ITfThreadMgr::SetFocus aufrufen, um den Fokus auf den richtigen Dokument-Manager festzulegen.
Um die vorherige Fokuszuordnung wiederherzustellen, rufen Sie diese Methode mit dem gleichen Fensterhandle und dem wert auf, der im ursprünglichen Aufruf ppdimPrev für pdimNew zurückgegeben wurde. Im Folgenden finden Sie ein Beispiel.
//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();
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | msctf.h |
| DLL | Msctf.dll |
| Verteilbare Komponente | TSF 1.0 unter Windows 2000 Professional |