Kelas CMFCToolTipctrl

Implementasi tipsalat yang diperluas berdasarkan Kelas CToolTipCtrl. Tipsalat CMFCToolTipCtrl berdasarkan kelas dapat menampilkan ikon, label, dan deskripsi. Anda dapat menyesuaikan tampilan visualnya dengan menggunakan isian gradien, teks kustom dan warna batas, teks tebal, sudut bulat, atau gaya balon.

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

Sintaks

class CMFCToolTipCtrl : public CToolTipCtrl

Anggota

Konstruktor Publik

Metode Publik

Keterangan

Gunakan CMFCToolTipCtrlobjek Kelas , CMFCToolTipInfo, , dan CTooltipManager bersama-sama untuk mengimplementasikan tipsalat yang disesuaikan dalam aplikasi Anda.

Misalnya, untuk menggunakan tipsalat gaya balon, ikuti langkah-langkah berikut:

1. Gunakan metode Kelas CWinAppEx untuk menginisialisasi manajer tipsalat di aplikasi Anda.

2. Buat CMFCToolTipInfo struktur untuk menentukan gaya visual yang Anda inginkan:

   CMFCToolTipInfo params;
   params.m_bBoldLabel = FALSE;
   params.m_bDrawDescription = FALSE;
   params.m_bDrawIcon = FALSE;
   params.m_bRoundedCorners = TRUE;
   params.m_bDrawSeparator = FALSE;
   if (m_bCustomColors)
   {
       params.m_clrFill = RGB (255, 255, 255);
       params.m_clrFillGradient = RGB (228, 228, 240);
       params.m_clrText = RGB (61, 83, 80);
       params.m_clrBorder = RGB (144, 149, 168);
   
   }
   

3. Gunakan metode CTooltipManager::SetTooltipParams untuk mengatur gaya visual untuk semua tipsalat dalam aplikasi dengan menggunakan gaya yang ditentukan dalam CMFCToolTipInfo objek:

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

Anda juga dapat memperoleh kelas baru dari CMFCToolTipCtrl untuk mengontrol perilaku dan penyajian tipsalat. Untuk menentukan kelas kontrol tipsalat baru, gunakan CTooltipManager::SetTooltipParams metode :

myApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMyToolTipCtrl))

Untuk memulihkan kelas kontrol tipsalat default dan mengatur ulang tampilan tipsalat ke status defaultnya, tentukan NULL di kelas runtime dan parameter info tipsalat dari SetTooltipParams:

theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    NULL,
    NULL);

Contoh

Contoh berikut menunjukkan cara membuat CMFCToolTipCtrl objek, mengatur deskripsi yang ditampilkan tipsalat, dan mengatur lebar kontrol tipsalat.

CMFCToolTipInfo *params = new CMFCToolTipInfo();

params->m_bBoldLabel = FALSE;
params->m_bDrawDescription = FALSE;
params->m_bDrawIcon = FALSE;
params->m_bRoundedCorners = TRUE;
params->m_bDrawSeparator = FALSE;
params->m_clrFill = RGB(255, 255, 255);
params->m_clrFillGradient = RGB(228, 228, 240);
params->m_clrText = RGB(61, 83, 80);
params->m_clrBorder = RGB(144, 149, 168);

CMFCToolTipCtrl *tipCtrl = new CMFCToolTipCtrl(params);
tipCtrl->SetDescription(_T("tool tip control"));
tipCtrl->SetFixedWidth(100, 150);

Hierarki Warisan

CObject

CCmdTarget

CWnd

CToolTipCtrl

CMFCToolTipctrl

Persyaratan

Header: afxtooltipctrl.h

CMFCToolTipctrl::CMFCToolTipctrl

CMFCToolTipCtrl(CMFCToolTipInfo* pParams = NULL);

Parameter

[di] pParams

Keterangan

CMFCToolTipctrl::Geticonsize

Mengembalikan ukuran ikon dalam tipsalat.

virtual CSize GetIconSize();

Tampilkan Nilai

Ukuran ikon, dalam piksel.

CMFCToolTipCtrl::GetParams

Mengembalikan pengaturan tampilan tipsalat.

const CMFCToolTipInfo& GetParams() const;

Tampilkan Nilai

Pengaturan tampilan tipsalat saat ini, yang disimpan dalam objek Kelas CMFCToolTipInfo.

CMFCToolTipctrl::OnDrawBorder

Menggambar batas tipsalat.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect rect,
    COLORREF clrLine);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi panjang batas tipsalat.

clrLine
[di] Warna batas.

Keterangan

Ambil alih metode ini di kelas turunan untuk menyesuaikan tampilan batas tipsalat.

CMFCToolTipctrl::OnDrawDescription

virtual CSize OnDrawDescription(
    CDC* pDC,
    CRect rect,
    BOOL bCalcOnly);

Parameter

[di] pDC
[di] rect
[di] bCalcOnly

Tampilkan Nilai

Keterangan

CMFCToolTipctrl::OnDrawIcon

Menampilkan ikon dalam tipsalat.

virtual BOOL OnDrawIcon(
    CDC* pDC,
    CRect rectImage);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rectImage
[di] Koordinat ikon.

Tampilkan Nilai

TRUE jika ikon digambar. Jika tidak, FALSE.

Keterangan

Ambil alih metode ini di kelas turunan untuk menampilkan ikon kustom. Anda juga harus mengambil alih CMFCToolTipCtrl::GetIconSize untuk mengaktifkan tipsalat untuk menghitung tata letak teks dan deskripsi dengan benar.

CMFCToolTipctrl::OnDrawLabel

Menggambar label tipsalat, atau menghitung ukuran label.

virtual CSize OnDrawLabel(
    CDC* pDC,
    CRect rect,
    BOOL bCalcOnly);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi panjang pembatas area label.

bCalcOnly
[di] Jika TRUE, label tidak akan digambar.

Tampilkan Nilai

Ukuran label, dalam piksel.

Keterangan

Ambil alih metode ini di kelas turunan jika Anda ingin menyesuaikan tampilan label tipsalat.

CMFCToolTipctrl::OnDrawSeparator

Menggambar pemisah antara label dan deskripsi dalam tipsalat.

virtual void OnDrawSeparator(
    CDC* pDC,
    int x1,
    int x2,
    int y);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

x1
[di] Koordinat horizontal dari ujung kiri pemisah.

x2
[di] Koordinat horizontal dari ujung kanan pemisah.

Y
[di] Koordinat vertikal pemisah.

Keterangan

Implementasi default menarik garis dari titik (x1, y) ke titik (x2, y).

Ambil alih metode ini di kelas turunan untuk menyesuaikan tampilan pemisah.

CMFCToolTipctrl::OnFillBackground

Mengisi latar belakang tipsalat.

virtual void OnFillBackground(
    CDC* pDC,
    CRect rect,
    COLORREF& clrText,
    COLORREF& clrLine);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Menentukan persegi panjang batas area yang akan diisi.

clrText
[di] Warna latar depan tipsalat.

clrLine
[di] Warna batas dan garis pemisah antara label dan deskripsi.

Keterangan

Implementasi default mengisi persegi panjang yang ditentukan oleh rect dengan warna atau pola yang ditentukan oleh panggilan terbaru ke CMFCToolTipCtrl::SetParams.

Ambil alih metode ini di kelas turunan jika Anda ingin menyesuaikan tampilan tipsalat.

CMFCToolTipctrl::SetDescription

Mengatur deskripsi yang akan ditampilkan oleh tipsalat.

virtual void SetDescription(const CString strDesrciption);

Parameter

strDesrciption
[di] Teks deskripsi.

Keterangan

Teks deskripsi ditampilkan pada tipsalat di bawah pemisah.

CMFCToolTipCtrl::SetFixedWidth

void SetFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parameter

[di] nWidthRegular
[di] nWidthLargeImage

Keterangan

CMFCToolTipCtrl::SetHotRibbonButton

void SetHotRibbonButton(CMFCRibbonButton* pRibbonButton);

Parameter

[di] pRibbonButton

Keterangan

CMFCToolTipCtrl::SetLocation

void SetLocation(CPoint pt);

Parameter

[di] Pt

Keterangan

CMFCToolTipCtrl::SetParams

Menentukan tampilan visual tipsalat dengan menggunakan objek Kelas CMFCToolTipInfo.

void SetParams(CMFCToolTipInfo* pParams);

Parameter

pParams
[di] Penunjuk ke objek Kelas CMFCToolTipInfo yang berisi parameter tampilan.

Keterangan

Setiap kali tipsalat ditampilkan, tip alat digambar dengan menggunakan warna dan gaya visual yang ditentukan pParams . Nilai pParams disimpan dalam anggota m_Paramsyang dilindungi , yang dapat diakses oleh kelas turunan yang mengambil alih CMFCToolTipCtrl::OnDrawBorder, CMFCToolTipCtrl::OnDrawIcon, CMFCToolTipCtrl::OnDrawLabel, CMFCToolTipCtrl::OnDrawSeparator, atau CMFCToolTipCtrl::OnFillBackground untuk mempertahankan tampilan yang ditentukan.

Lihat juga

Bagan Hierarki
Kelas
Kelas CToolTipctrl
Kelas CTooltipManager
Kelas CMFCToolTipInfo
Kelas CWinAppEx