Bagikan melalui

Kelas CTooltipManager

  • Artikel

Mempertahankan informasi runtime tentang tipsalat. Kelas CTooltipManager ini dibuat satu kali per aplikasi.

Sintaks

class CTooltipManager : public CObject

Anggota

Metode Publik

Nama Deskripsi
CTooltipManager::CreateToolTip Membuat kontrol tipsalat untuk jenis kontrol Windows yang ditentukan.
CTooltipManager::D eleteToolTip Menghapus kontrol tipsalat.
CTooltipManager::SetTooltipParams Menyesuaikan tampilan visual kontrol tipsalat untuk jenis kontrol Windows yang ditentukan.
CTooltipManager::SetTooltipText Mengatur teks dan deskripsi untuk kontrol tipsalat.
CTooltipManager::UpdateTooltips

Keterangan

Gunakan Kelas CMFCToolTipCtrl, CMFCToolTipInfo, dan CTooltipManager bersama-sama untuk mengimplementasikan tipsalat yang disesuaikan dalam aplikasi Anda. Untuk contoh cara menggunakan kelas tipsalat ini, lihat topik Kelas CMFCToolTipCtrl.

Hierarki Warisan

CObject

CTooltipManager

Persyaratan

Header: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Membuat kontrol tipsalat.

static BOOL CreateToolTip(
    CToolTipCtrl*& pToolTip,
    CWnd* pWndParent,
    UINT nType);

Parameter

pToolTip
[out] Referensi ke penunjuk tipsalat. Ini diatur untuk menunjuk ke tipsalat yang baru dibuat saat fungsi kembali.

pWndParent
[di] Induk tipsalat.

nType
[di] Jenis tipsalat.

Tampilkan Nilai

Bukan nol jika tipsalat berhasil dibuat.

Keterangan

Anda harus memanggil CTooltipManager::D eleteToolTip untuk menghapus kontrol tipsalat yang diteruskan kembali di pToolTip.

CTooltipManager mengatur parameter tampilan visual dari setiap tipsalat yang dibuatnya berdasarkan jenis tipsalat yang ditentukan nType. Untuk mengubah parameter untuk satu atau beberapa jenis tipsalat, panggil CTooltipManager::SetTooltipParams.

Jenis tipsalat yang valid tercantum dalam tabel berikut:

Jenis tipsalat Kategori kontrol Contoh jenis
AFX_TOOLTIP_TYPE_BUTTON Sebuah tombol. CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR Bilah keterangan. CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT Kontrol apa pun yang tidak sesuai dengan kategori lain. Tidak ada.
AFX_TOOLTIP_TYPE_DOCKBAR Panel yang dapat ditampung. CDockablePane
AFX_TOOLTIP_TYPE_EDIT Kotak teks. Tidak ada.
AFX_TOOLTIP_TYPE_MINIFRAME Sebuah miniframe. CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER Perencana. Tidak ada.
AFX_TOOLTIP_TYPE_RIBBON Bilah pita. CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB Kontrol tab. CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR Bilah alat. CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX Kotak alat. Tidak ada.

CTooltipManager::D eleteToolTip

Menghapus kontrol tipsalat.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parameter

pToolTip
[masuk, keluar] Referensi ke penunjuk ke tipsalat yang akan dihancurkan.

Keterangan

Panggil metode ini untuk setiap Kelas CToolTipCtrl yang dibuat oleh CTooltipManager::CreateToolTip. Kontrol induk harus memanggil metode ini dari handler-nya OnDestroy . Ini diperlukan untuk menghapus tipsalat dengan benar dari kerangka kerja. Metode ini mengatur pToolTip ke NULL sebelum kembali.

CTooltipManager::SetTooltipParams

Menyesuaikan tampilan kontrol tipsalat untuk tipe kontrol Windows yang ditentukan.

void SetTooltipParams(
    UINT nTypes,
    CRuntimeClass* pRTC=RUNTIME_CLASS(CMFCToolTipCtrl),
    CMFCToolTipInfo* pParams=NULL);

Parameter

nTypes
[di] Menentukan jenis kontrol.

pRTC
[di] Kelas runtime tipsalat kustom.

pParams
[di] Parameter tipsalat.

Keterangan

Metode ini mengatur kelas runtime dan parameter awal yang digunakan CToolTipManager saat membuat tipsalat. Ketika kontrol memanggil CTooltipManager::CreateToolTip dan meneruskan jenis tipsalat yang merupakan salah satu jenis yang ditunjukkan oleh nTypes, manajer tipsalat membuat kontrol tipsalat yang merupakan instans kelas runtime yang ditentukan oleh pRTC dan meneruskan parameter yang ditentukan oleh pParams ke tipsalat baru.

Ketika Anda memanggil metode ini, semua pemilik tipsalat yang ada menerima pesan AFX_WM_UPDATETOOLTIPS dan mereka harus membuat ulang tipsalat mereka dengan menggunakan CTooltipManager::CreateToolTip.

nTypes dapat berupa kombinasi jenis tipsalat valid yang digunakan CTooltipManager::CreateToolTip , atau dapat AFX_TOOLTIP_TYPE_ALL. Jika Anda lulus AFX_TOOLTIP_TYPE_ALL, semua jenis tipsalat terpengaruh.

Contoh

Contoh berikut menunjukkan cara menggunakan SetTooltipParams metode CTooltipManager kelas. Cuplikan kode ini adalah bagian dari sampel Draw Client.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

theApp.GetTooltipManager()->SetTooltipParams(AFX_TOOLTIP_TYPE_ALL, RUNTIME_CLASS(CMFCToolTipCtrl), &params);

CTooltipManager::SetTooltipText

Mengatur teks dan deskripsi untuk tipsalat.

static void SetTooltipText(
    TOOLINFO* pTI,
    CToolTipCtrl* pToolTip,
    UINT nType,
    const CString strText,
    LPCTSTR lpszDescr=NULL);

Parameter

Pti
[di] Penunjuk ke objek TOOLINFO.

pToolTip
[masuk, keluar] Penunjuk ke kontrol tipsalat untuk mengatur teks dan deskripsi.

nType
[di] Menentukan jenis kontrol yang terkait dengan tipsalat ini.

strText
[di] Teks yang akan diatur sebagai teks tipsalat.

lpszDescr
[di] Penunjuk ke deskripsi tipsalat. Bisa NULL.

Keterangan

Nilai nType harus sama dengan parameter nType CTooltipManager ::CreateToolTip saat Anda membuat tipsalat.

CTooltipManager::UpdateTooltips

Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

void UpdateTooltips();

Keterangan

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCToolTipctrl
Kelas CMFCToolTipInfo