Metode ITfThreadMgr::AssociateFocus (msctf.h)

Artikel
03/08/2023

Mengaitkan fokus untuk jendela dengan objek manajer dokumen.

Sintaks

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

Parameter

[in] hwnd

Tangani jendela untuk mengaitkan fokus.

[in] pdimNew

Arahkan ke manajer dokumen untuk mengaitkan fokus. Manajer TSF tidak menaikkan jumlah referensi objek. Nilai ini bisa NULL.

[out] ppdimPrev

Menerima manajer dokumen yang sebelumnya terkait dengan jendela. Menerima NULL jika tidak ada asosiasi sebelumnya. Parameter ini tidak boleh NULL.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.

Keterangan

Metode ini disediakan sebagai kenyamanan untuk pengembang aplikasi. Mengaitkan fokus untuk jendela dengan manajer dokumen menyebabkan manajer TSF secara otomatis memanggil ITfThreadMgr::SetFocus dengan manajer dokumen terkait saat jendela terkait menerima fokus.

Metode ini hanya dapat mengaitkan satu jendela dengan satu manajer dokumen. Jika implementasi mengaitkan beberapa manajer dokumen dengan satu jendela, atau sebaliknya, implementasi harus memanggil ITfThreadMgr::SetFocus untuk mengatur fokus ke manajer dokumen yang tepat.

Untuk memulihkan asosiasi fokus sebelumnya, panggil metode ini dengan handel jendela yang sama dan nilai yang dikembalikan dalam panggilan asli ppdimPrev untuk pdimNew. Berikut adalah contohnya.


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

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Lihat juga

ITfDocumentMgr

ITfThreadMgr

ITfThreadMgr::SetFocus

Bagikan melalui