CToolTipCtrl Kelas

Merangkum fungsionalitas "kontrol tipsalat," jendela pop-up kecil yang menampilkan satu baris teks yang menjelaskan tujuan alat dalam aplikasi.

Sintaks

class CToolTipCtrl : public CWnd

Anggota

Konstruktor Publik

Nama	Deskripsi
CToolTipCtrl::CToolTipCtrl	Membuat CToolTipCtrl objek.

Metode Publik

Nama	Deskripsi
CToolTipCtrl::Activate	Mengaktifkan dan menonaktifkan kontrol tipsalat.
CToolTipCtrl::AddTool	Mendaftarkan alat dengan kontrol tipsalat.
CToolTipCtrl::AdjustRect	Mengonversi antara persegi panjang tampilan teks kontrol tipsalat dan persegi panjang jendelanya.
CToolTipCtrl::Create	Membuat kontrol tipsalat dan melampirkannya ke CToolTipCtrl objek.
CToolTipCtrl::CreateEx	Membuat kontrol tipsalat dengan gaya perluasan Windows yang ditentukan dan melampirkannya ke CToolTipCtrl objek.
CToolTipCtrl::DelTool	Menghapus alat dari kontrol tipsalat.
CToolTipCtrl::GetBubbleSize	Mengambil ukuran tipsalat.
CToolTipCtrl::GetCurrentTool	Mengambil informasi, seperti ukuran, posisi, dan teks, dari jendela tipsalat yang ditampilkan kontrol tipsalat saat ini.
CToolTipCtrl::GetDelayTime	Mengambil durasi awal, pop-up, dan reshow yang saat ini diatur untuk kontrol tipsalat.
CToolTipCtrl::GetMargin	Mengambil margin atas, kiri, bawah, dan kanan yang diatur untuk jendela tipsalat.
CToolTipCtrl::GetMaxTipWidth	Mengambil lebar maksimum untuk jendela tipsalat.
CToolTipCtrl::GetText	Mengambil teks yang dikelola kontrol tipsalat untuk alat.
CToolTipCtrl::GetTipBkColor	Mengambil warna latar belakang di jendela tipsalat.
CToolTipCtrl::GetTipTextColor	Mengambil warna teks di jendela tipsalat.
CToolTipCtrl::GetTitle	Mengambil judul kontrol tipsalat saat ini.
CToolTipCtrl::GetToolCount	Mengambil hitungan alat yang dikelola oleh kontrol tipsalat.
CToolTipCtrl::GetToolInfo	Mengambil informasi yang dipertahankan kontrol tipsalat tentang alat.
CToolTipCtrl::HitTest	Menguji titik untuk menentukan apakah itu berada dalam persegi panjang pembatas alat yang diberikan. Jika demikian, mengambil informasi tentang alat.
CToolTipCtrl::Pop	Menghapus jendela tipsalat yang ditampilkan dari tampilan.
CToolTipCtrl::Popup	Menyebabkan kontrol tipsalat saat ini ditampilkan pada koordinat pesan mouse terakhir.
CToolTipCtrl::RelayEvent	Meneruskan pesan mouse ke kontrol tipsalat untuk diproses.
CToolTipCtrl::SetDelayTime	Mengatur durasi awal, pop-up, dan reshow untuk kontrol tipsalat.
CToolTipCtrl::SetMargin	Mengatur margin atas, kiri, bawah, dan kanan untuk jendela tipsalat.
CToolTipCtrl::SetMaxTipWidth	Mengatur lebar maksimum untuk jendela tipsalat.
CToolTipCtrl::SetTipBkColor	Mengatur warna latar belakang di jendela tipsalat.
CToolTipCtrl::SetTipTextColor	Mengatur warna teks di jendela tipsalat.
CToolTipCtrl::SetTitle	Menambahkan ikon standar dan string judul ke tipsalat.
CToolTipCtrl::SetToolInfo	Mengatur informasi yang dipertahankan tipsalat untuk alat.
CToolTipCtrl::SetToolRect	Mengatur persegi panjang pembatas baru untuk alat.
CToolTipCtrl::SetWindowTheme	Mengatur gaya visual jendela tipsalat.
CToolTipCtrl::Update	Memaksa alat saat ini untuk digambar ulang.
CToolTipCtrl::UpdateTipText	Mengatur teks tipsalat untuk alat.

Keterangan

"Alat" adalah jendela, seperti jendela atau kontrol anak, atau area persegi panjang yang ditentukan aplikasi dalam area klien jendela. Tipsalat disembunyikan sebagian besar waktu, muncul hanya ketika pengguna meletakkan kursor pada alat dan membiarkannya di sana selama sekitar satu setengah detik. Tipsalat muncul di dekat kursor dan menghilang ketika pengguna mengklik tombol mouse atau memindahkan kursor dari alat.

CToolTipCtrl menyediakan fungsionalitas untuk mengontrol waktu awal dan durasi tipsalat, lebar margin mengelilingi teks tipsalat, lebar jendela tipsalat itu sendiri, dan warna latar belakang dan teks tipsalat. Kontrol tipsalat tunggal dapat memberikan informasi untuk lebih dari satu alat.

Kelas ini CToolTipCtrl menyediakan fungsionalitas kontrol tipsalat umum Windows. Kontrol ini (dan oleh karena itu CToolTipCtrl kelas) hanya tersedia untuk program yang berjalan di bawah Windows 95/98 dan Windows NT versi 3.51 dan yang lebih baru.

Untuk informasi selengkapnya tentang mengaktifkan tipsalat, lihat Tips Alat di Windows yang tidak Berasal dari CFrameWnd.

Untuk informasi selengkapnya tentang menggunakan CToolTipCtrl, lihat Kontrol dan Menggunakan CToolTipCtrl.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CToolTipCtrl

Persyaratan

Header: afxcmn.h

CToolTipCtrl::Activate

Panggil fungsi ini untuk mengaktifkan atau menonaktifkan kontrol tipsalat.

void Activate(BOOL bActivate);

Parameter

bActivate
Menentukan apakah kontrol tipsalat akan diaktifkan atau dinonaktifkan.

Keterangan

Jika bActivate adalah TRUE, kontrol diaktifkan; jika FALSE, kontrol dinonaktifkan.

Ketika kontrol tipsalat aktif, informasi tipsalat muncul ketika kursor berada pada alat yang terdaftar di kontrol; ketika tidak aktif, informasi tipsalat tidak muncul, bahkan ketika kursor berada di alat.

Contoh

Lihat contoh untuk CPropertySheet::GetTabControl.

CToolTipCtrl::AddTool

Mendaftarkan alat dengan kontrol tipsalat.

BOOL AddTool(
    CWnd* pWnd,
    UINT nIDText,
    LPCRECT lpRectTool = NULL,
    UINT_PTR nIDTool = 0);

BOOL AddTool(
    CWnd* pWnd,
    LPCTSTR lpszText = LPSTR_TEXTCALLBACK,
    LPCRECT lpRectTool = NULL,
    UINT_PTR nIDTool = 0);

Parameter

pWnd
Penunjuk ke jendela yang berisi alat.

nIDText
ID sumber daya string yang berisi teks untuk alat.

lpRectTool
Penunjuk ke struktur yang RECT berisi koordinat persegi panjang pembatas alat. Koordinat relatif terhadap sudut kiri atas area klien jendela yang diidentifikasi oleh pWnd.

nIDTool
ID alat.

lpszText
Arahkan ke teks untuk alat tersebut. Jika parameter ini berisi nilai LPSTR_TEXTCALLBACK, TTN_NEEDTEXT pesan pemberitahuan masuk ke induk jendela yang pWnd menunjuk ke.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Parameter lpRectTool dan nIDTool harus valid, atau jika lpRectTool adalah NULL, nIDTool harus 0.

Kontrol tipsalat dapat dikaitkan dengan lebih dari satu alat. Panggil fungsi ini untuk mendaftarkan alat dengan kontrol tipsalat, sehingga informasi yang disimpan di tipsalat ditampilkan ketika kursor ada di alat.

Catatan

Anda tidak dapat mengatur tipsalat ke kontrol statis menggunakan AddTool.

Contoh

Lihat contoh untuk CPropertySheet::GetTabControl.

CToolTipCtrl::AdjustRect

Mengonversi antara persegi panjang tampilan teks kontrol tipsalat dan persegi panjang jendelanya.

BOOL AdjustRect(
    LPRECT lprc,
    BOOL bLarger = TRUE);

Parameter

lprc
Penunjuk ke RECT struktur yang menampung persegi panjang jendela tipsalat atau persegi panjang tampilan teks.

bLarger
Jika TRUE, lprc digunakan untuk menentukan persegi panjang tampilan teks, dan menerima persegi panjang jendela yang sesuai. Jika FALSE, lprc digunakan untuk menentukan persegi panjang jendela, dan menerima persegi panjang tampilan teks yang sesuai.

Tampilkan Nilai

Bukan nol jika persegi panjang berhasil disesuaikan; jika tidak, 0.

Keterangan

Fungsi anggota ini menghitung persegi panjang tampilan teks kontrol tipsalat dari persegi panjang jendelanya, atau persegi panjang jendela tipsalat yang diperlukan untuk menampilkan persegi panjang tampilan teks tertentu.

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_ADJUSTRECTWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::Create

Membuat kontrol tipsalat dan melampirkannya ke CToolTipCtrl objek.

virtual BOOL Create(CWnd* pParentWnd, DWORD dwStyle = 0);

Parameter

pParentWnd
Menentukan jendela induk kontrol tipsalat, biasanya .CDialog Ini tidak boleh NULL.

dwStyle
Menentukan gaya kontrol tipsalat. Lihat bagian Keterangan untuk informasi lebih lanjut.

Tampilkan Nilai

Bukan nol jika CToolTipCtrl objek berhasil dibuat; jika tidak, 0.

Keterangan

Anda membangun CToolTipCtrl dalam dua langkah. Pertama, panggil konstruktor untuk membuat CToolTipCtrl objek, lalu panggil Create untuk membuat kontrol tipsalat dan melampirkannya ke CToolTipCtrl objek.

Parameter dwStyle dapat berupa kombinasi Gaya Jendela apa pun. Selain itu, kontrol tipsalat memiliki dua gaya khusus kelas: TTS_ALWAYSTIP dan TTS_NOPREFIX.

Gaya	Makna
TTS_ALWAYSTIP	Menentukan bahwa tipsalat akan muncul ketika kursor berada di alat, terlepas dari apakah jendela pemilik kontrol tipsalat aktif atau tidak aktif. Tanpa gaya ini, kontrol tipsalat muncul ketika jendela pemilik alat aktif, tetapi tidak saat tidak aktif.
TTS_NOPREFIX	Gaya ini mencegah sistem menghapus karakter ampersand (&) dari string. Jika kontrol tipsalat tidak memiliki TTS_NOPREFIX gaya, sistem secara otomatis menghapus karakter ampersand, memungkinkan aplikasi untuk menggunakan string yang sama dengan item menu dan sebagai teks dalam kontrol tipsalat.

Kontrol tipsalat WS_POPUP memiliki gaya jendela dan WS_EX_TOOLWINDOW , terlepas dari apakah Anda menentukannya saat membuat kontrol.

Untuk membuat kontrol tipsalat dengan gaya jendela yang diperluas, panggil CToolTipCtrl::CreateEx alih-alih Create.

Contoh

Lihat contoh untuk CPropertySheet::GetTabControl.

CToolTipCtrl::CreateEx

Membuat kontrol (jendela anak) dan mengaitkannya dengan CToolTipCtrl objek.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwStyle = 0,
    DWORD dwStyleEx = 0);

Parameter

pParentWnd
Penunjuk ke jendela yang merupakan induk kontrol.

dwStyle
Menentukan gaya kontrol tipsalat. Lihat bagian Keterangan untuk Create informasi selengkapnya.

dwStyleEx
Menentukan gaya kontrol yang diperluas yang sedang dibuat. Untuk daftar gaya Windows yang diperluas, lihat dwExStyle parameter untuk CreateWindowEx di Windows SDK.

Tampilkan Nilai

Bukan nol jika berhasil jika tidak 0.

Keterangan

Gunakan CreateEx alih-alih Create untuk menerapkan gaya Windows yang diperluas, yang ditentukan oleh preface WS_EX_gaya windows yang diperluas .

CToolTipCtrl::CToolTipCtrl

Membuat CToolTipCtrl objek.

CToolTipCtrl();

Keterangan

Anda harus memanggil Create setelah membuat objek.

Contoh

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

Menghapus alat yang ditentukan oleh pWnd dan nIDTool dari kumpulan alat yang didukung oleh kontrol tipsalat.

void DelTool(
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

Parameter

pWnd
Penunjuk ke jendela yang berisi alat.

nIDTool
ID alat.

CToolTipCtrl::GetBubbleSize

Mengambil ukuran tipsalat.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Parameter

lpToolInfo
Penunjuk ke struktur tipsalat TOOLINFO .

Tampilkan Nilai

Ukuran tipsalat.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_GETBUBBLESIZEWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::GetCurrentTool

Mengambil informasi, seperti ukuran, posisi, dan teks, dari jendela tipsalat yang ditampilkan oleh kontrol tipsalat saat ini.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Parameter

lpToolInfo
[out] Penunjuk TOOLINFO ke struktur yang menerima informasi tentang jendela tipsalat saat ini.

Tampilkan Nilai

TRUE jika informasi berhasil diambil; jika tidak, FALSE.

Keterangan

Metode ini mengirim TTM_GETCURRENTTOOL pesan, yang dijelaskan dalam Windows SDK.

Contoh

Contoh kode berikut mengambil informasi tentang jendela tipsalat saat ini.

{
    //Get information about the current tooltip. 
    TOOLINFO tInfo = {0};
    tInfo.cbSize = sizeof(TOOLINFO);
    CToolBarCtrl& m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
    CToolTipCtrl* m_toolTip = m_toolBarCtrl.GetToolTips();
    BOOL bRet = m_toolTip->GetCurrentTool( &tInfo );
}

CToolTipCtrl::GetDelayTime

Mengambil durasi awal, pop-up, dan reshow yang saat ini diatur untuk kontrol tipsalat.

int GetDelayTime(DWORD dwDuration) const;

Parameter

dwDuration
Bendera yang menentukan nilai durasi mana yang akan diambil. Parameter ini bisa menjadi salah satu nilai berikut:

• TTDT_AUTOPOP Ambil lamanya waktu jendela tipsalat tetap terlihat jika penunjuk stasioner dalam persegi panjang pembatas alat.

• TTDT_INITIAL Ambil lama waktu penunjuk harus tetap stasioner dalam persegi panjang pembatas alat sebelum jendela tipsalat muncul.

• TTDT_RESHOW Ambil lama waktu yang diperlukan agar jendela tipsalat berikutnya muncul saat penunjuk berpindah dari satu alat ke alat lainnya.

Tampilkan Nilai

Waktu penundaan yang ditentukan, dalam milidetik

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_GETDELAYTIMEWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::GetMargin

Mengambil margin atas, kiri, bawah, dan kanan yang diatur untuk jendela tipsalat.

void GetMargin(LPRECT lprc) const;

Parameter

lprc
RECT Alamat struktur yang akan menerima informasi margin. RECT Anggota struktur tidak menentukan persegi panjang pembatas. Untuk tujuan pesan ini, anggota struktur ditafsirkan sebagai berikut:

Anggota	Representasi
top	Jarak antara batas atas dan bagian atas teks tipsalat, dalam piksel.
left	Jarak antara batas kiri dan ujung kiri teks tip, dalam piksel.
bottom	Jarak antara batas bawah dan bagian bawah teks tip, dalam piksel.
right	Jarak antara batas kanan dan ujung kanan teks tip, dalam piksel.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_GETMARGINWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::GetMaxTipWidth

Mengambil lebar maksimum untuk jendela tipsalat.

int GetMaxTipWidth() const;

Tampilkan Nilai

Lebar maksimum untuk jendela tipsalat.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_GETMAXTIPWIDTHWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::GetText

Mengambil teks yang dikelola kontrol tipsalat untuk alat.

void GetText(
    CString& str,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

Parameter

str
Referensi ke CString objek yang menerima teks alat.

pWnd
Penunjuk ke jendela yang berisi alat.

nIDTool
ID alat.

Keterangan

Parameter pWnd dan nIDTool mengidentifikasi alat. Jika alat tersebut sebelumnya telah didaftarkan dengan kontrol tipsalat melalui panggilan sebelumnya ke CToolTipCtrl::AddTool, objek yang direferensikan str oleh parameter diberi teks alat.

CToolTipCtrl::GetTipBkColor

Mengambil warna latar belakang di jendela tipsalat.

COLORREF GetTipBkColor() const;

Tampilkan Nilai

COLORREF Nilai yang mewakili warna latar belakang.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_GETTIPBKCOLORWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::GetTipTextColor

Mengambil warna teks di jendela tipsalat.

COLORREF GetTipTextColor() const;

Tampilkan Nilai

Nilai COLORREF yang mewakili warna teks.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_GETTIPTEXTCOLORWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::GetTitle

Mengambil judul kontrol tipsalat saat ini.

void GetTitle(PTTGETTITLE pttgt) const;

Parameter

pttgt
[out] Penunjuk TTGETTITLE ke struktur yang berisi informasi tentang kontrol tipsalat. Ketika metode ini kembali, pszTitle anggota TTGETTITLE struktur menunjuk ke teks judul.

Keterangan

Metode ini mengirim TTM_GETTITLE pesan, yang dijelaskan dalam Windows SDK.

CToolTipCtrl::GetToolCount

Mengambil hitungan alat yang terdaftar dengan kontrol tipsalat.

int GetToolCount() const;

Tampilkan Nilai

Jumlah alat yang terdaftar dengan kontrol tipsalat.

CToolTipCtrl::GetToolInfo

Mengambil informasi yang dipertahankan kontrol tipsalat tentang alat.

BOOL GetToolInfo(
    CToolInfo& ToolInfo,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

Parameter

ToolInfo
Referensi ke TOOLINFO objek yang menerima teks alat.

pWnd
Penunjuk ke jendela yang berisi alat.

nIDTool
ID alat.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Dan hwnd uId anggota struktur yang dirujuk TOOLINFO dengan CToolInfo mengidentifikasi alat. Jika alat tersebut telah terdaftar dengan kontrol tipsalat melalui panggilan sebelumnya ke AddTool, TOOLINFO struktur diisi dengan informasi tentang alat tersebut.

CToolTipCtrl::HitTest

Menguji titik untuk menentukan apakah itu berada dalam persegi panjang pembatas alat yang diberikan dan, jika demikian, ambil informasi tentang alat tersebut.

BOOL HitTest(
    CWnd* pWnd,
    CPoint pt,
    LPTOOLINFO lpToolInfo) const;

Parameter

pWnd
Penunjuk ke jendela yang berisi alat.

pt
Penunjuk ke objek yang CPoint berisi koordinat titik yang akan diuji.

lpToolInfo
Penunjuk ke TOOLINFO struktur yang berisi informasi tentang alat.

Tampilkan Nilai

Bukan nol jika titik yang ditentukan oleh informasi uji hit berada dalam persegi panjang pembatas alat; jika tidak, 0.

Keterangan

Jika fungsi ini mengembalikan nilai bukan nol, struktur yang ditujuk oleh lpToolInfo diisi dengan informasi tentang alat di dalam persegi panjangnya titik terletak.

Struktur TTHITTESTINFO didefinisikan sebagai berikut:

typedef struct _TT_HITTESTINFO { // tthti
    HWND hwnd;   // handle of tool or window with tool
    POINT pt;    // client coordinates of point to test
    TOOLINFO ti; // receives information about the tool
} TTHITTESTINFO, FAR * LPHITTESTINFO;

• hwnd

  Menentukan handel alat.

• pt

  Menentukan koordinat titik jika titik berada di persegi panjang pembatas alat.

• ti

  Informasi tentang alat ini. Untuk informasi selengkapnya tentang TOOLINFO struktur, lihat CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

Menghapus jendela tipsalat yang ditampilkan dari tampilan.

void Pop();

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_POPWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::Popup

Menyebabkan kontrol tipsalat saat ini ditampilkan pada koordinat pesan mouse terakhir.

void Popup();

Keterangan

Metode ini mengirim TTM_POPUP pesan, yang dijelaskan dalam Windows SDK.

Contoh

Contoh kode berikut menampilkan jendela tipsalat.

{
   // Display the most recent tooltip.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CToolTipCtrl *m_toolTip = m_toolBarCtrl.GetToolTips();
   m_toolTip->Popup();
}

CToolTipCtrl::RelayEvent

Meneruskan pesan mouse ke kontrol tipsalat untuk diproses.

void RelayEvent(LPMSG lpMsg);

Parameter

lpMsg
Penunjuk MSG ke struktur yang berisi pesan untuk direlai.

Keterangan

Kontrol tipsalat hanya memproses pesan berikut, yang dikirim ke pesan tersebut dengan RelayEvent:

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

Contoh

Lihat contoh untuk CPropertySheet::GetTabControl.

CToolTipCtrl::SetDelayTime

Mengatur waktu penundaan untuk kontrol tipsalat.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Parameter

nDelay
Menentukan waktu penundaan baru, dalam milidetik.

dwDuration
Bendera yang menentukan nilai durasi mana yang akan diambil. Lihat CToolTipCtrl::GetDelayTime untuk deskripsi nilai yang valid.

iTime
Waktu penundaan yang ditentukan, dalam milidetik.

Keterangan

Waktu penundaan adalah lamanya waktu kursor harus tetap berada pada alat sebelum jendela tipsalat muncul. Waktu penundaan default adalah 500 milidetik.

CToolTipCtrl::SetMargin

Mengatur margin atas, kiri, bawah, dan kanan untuk jendela tipsalat.

void SetMargin(LPRECT lprc);

Parameter

lprc
RECT Alamat struktur yang berisi informasi margin yang akan diatur. RECT Anggota struktur tidak menentukan persegi panjang pembatas. Lihat CToolTipCtrl::GetMargin untuk deskripsi informasi margin.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_SETMARGINWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::SetMaxTipWidth

Mengatur lebar maksimum untuk jendela tipsalat.

int SetMaxTipWidth(int iWidth);

Parameter

iWidth
Lebar jendela tipsalat maksimum yang akan diatur.

Tampilkan Nilai

Lebar tip maksimum sebelumnya.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_SETMAXTIPWIDTHWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::SetTipBkColor

Mengatur warna latar belakang di jendela tipsalat.

void SetTipBkColor(COLORREF clr);

Parameter

clr
Warna latar belakang baru.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_SETTIPBKCOLORWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::SetTipTextColor

Mengatur warna teks di jendela tipsalat.

void SetTipTextColor(COLORREF clr);

Parameter

clr
Warna teks baru.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_SETTIPTEXTCOLORWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::SetTitle

Menambahkan ikon standar dan string judul ke tipsalat.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Parameter

uIcon
Lihat icon di TTM_SETTITLE Windows SDK.

lpstrTitle
Penunjuk ke string judul.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TTM_SETTITLEWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::SetToolInfo

Mengatur informasi yang dipertahankan tipsalat untuk alat.

void SetToolInfo(LPTOOLINFO lpToolInfo);

Parameter

lpToolInfo
Penunjuk ke TOOLINFO struktur yang menentukan informasi yang akan diatur.

CToolTipCtrl::SetToolRect

Mengatur persegi panjang pembatas baru untuk alat.

void SetToolRect(
    CWnd* pWnd,
    UINT_PTR nIDTool,
    LPCRECT lpRect);

Parameter

pWnd
Penunjuk ke jendela yang berisi alat.

nIDTool
ID alat.

lpRect
Penunjuk ke struktur yang RECT menentukan persegi panjang pembatas baru.

CToolTipCtrl::SetWindowTheme

Mengatur gaya visual jendela tipsalat.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameter

pszSubAppName
Penunjuk ke string Unicode yang berisi gaya visual yang akan diatur.

Tampilkan Nilai

Nilai yang dikembalikan tidak digunakan.

Keterangan

Fungsi anggota ini menimulasi fungsionalitas TTM_SETWINDOWTHEME pesan, seperti yang dijelaskan dalam Windows SDK.

CToolTipCtrl::Update

Memaksa alat saat ini untuk digambar ulang.

void Update();

CToolTipCtrl::UpdateTipText

Memperbarui teks tipsalat untuk alat kontrol ini.

void UpdateTipText(
    LPCTSTR lpszText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

void UpdateTipText(
    UINT nIDText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

Parameter

lpszText
Arahkan ke teks untuk alat tersebut.

pWnd
Penunjuk ke jendela yang berisi alat.

nIDTool
ID alat.

nIDText
ID sumber daya string yang berisi teks untuk alat.

Lihat juga

CWnd Kelas
Bagan Hierarki
CToolBar Kelas