CMFCButton
Kelas
Kelas CMFCButton
menambahkan fungsionalitas ke CButton
kelas seperti menyelaraskan teks tombol, menggabungkan teks tombol dan gambar, memilih kursor, dan menentukan tip alat.
Sintaks
class CMFCButton : public CButton
Anggota
Konstruktor Publik
Nama | Deskripsi |
---|---|
CMFCButton::CMFCButton |
Konstruktor default. |
CMFCButton::~CMFCButton |
Destruktor. |
Metode Publik
Nama | Deskripsi |
---|---|
CMFCButton::CleanUp |
Mereset variabel internal dan membebaskan sumber daya yang dialokasikan seperti gambar, bitmap, dan ikon. |
CMFCButton::CreateObject |
Digunakan oleh kerangka kerja untuk membuat instans dinamis dari jenis kelas ini. |
CMFCButton::DrawItem |
Dipanggil oleh kerangka kerja ketika aspek visual tombol yang digambar pemilik telah berubah. (Mengambil alih CButton::DrawItem .) |
CMFCButton::EnableFullTextTooltip |
Menentukan apakah akan menampilkan teks lengkap tipsalat di jendela tipsalat besar atau versi teks yang terpotong di jendela tipsalat kecil. |
CMFCButton::EnableMenuFont |
Menentukan apakah font teks tombol sama dengan font menu aplikasi. |
CMFCButton::EnableWindowsTheming |
Menentukan apakah gaya batas tombol sesuai dengan tema Windows saat ini. |
CMFCButton::GetThisClass |
Digunakan oleh kerangka kerja untuk mendapatkan penunjuk ke CRuntimeClass objek yang terkait dengan jenis kelas ini. |
CMFCButton::GetToolTipCtrl |
Mengembalikan referensi ke kontrol tipsalat yang mendasar. |
CMFCButton::IsAutoCheck |
Menunjukkan apakah kotak centang atau tombol radio adalah tombol otomatis. |
CMFCButton::IsAutorepeatCommandMode |
Menunjukkan apakah tombol diatur ke mode pengulangan otomatis. |
CMFCButton::IsCheckBox |
Menunjukkan apakah tombol adalah tombol kotak centang. |
CMFCButton::IsChecked |
Menunjukkan apakah tombol saat ini dicentang. |
CMFCButton::IsHighlighted |
Menunjukkan apakah tombol disorot. |
CMFCButton::IsPressed |
Menunjukkan apakah tombol didorong dan disorot. |
CMFCButton::IsPushed |
Menunjukkan apakah tombol didorong. |
CMFCButton::IsRadioButton |
Menunjukkan apakah tombol adalah tombol radio. |
CMFCButton::IsWindowsThemingEnabled |
Menunjukkan apakah gaya batas tombol sesuai dengan tema Windows saat ini. |
CMFCButton::OnDrawParentBackground |
Menggambar latar belakang induk tombol di area yang ditentukan. (Mengambil alih AFX_GLOBAL_DATA::DrawParentBackground .) |
CMFCButton::PreTranslateMessage |
Menerjemahkan pesan jendela sebelum dikirim ke TranslateMessage fungsi Windows dan DispatchMessage . (Mengambil alih CWnd::PreTranslateMessage .) |
CMFCButton::SetAutorepeatMode |
Mengatur tombol ke mode pengulangan otomatis. |
CMFCButton::SetCheckedImage |
Mengatur gambar untuk tombol yang dicentang. |
CMFCButton::SetFaceColor |
Mengatur warna latar belakang untuk teks tombol. |
CMFCButton::SetImage |
Mengatur gambar untuk tombol. |
CMFCButton::SetMouseCursor |
Mengatur gambar kursor. |
CMFCButton::SetMouseCursorHand |
Mengatur kursor ke gambar tangan. |
CMFCButton::SetStdImage |
CMenuImages Menggunakan objek untuk mengatur gambar tombol. |
CMFCButton::SetTextColor |
Mengatur warna teks tombol untuk tombol yang tidak dipilih. |
CMFCButton::SetTextHotColor |
Mengatur warna teks tombol untuk tombol yang dipilih. |
CMFCButton::SetTooltip |
Mengaitkan tipsalat dengan tombol. |
CMFCButton::SizeToContent |
Mengubah ukuran tombol untuk memuat teks dan gambar tombolnya. |
Metode yang Dilindungi
Nama | Deskripsi |
---|---|
CMFCButton::OnDraw |
Dipanggil oleh kerangka kerja untuk menggambar tombol. |
CMFCButton::OnDrawBorder |
Dipanggil oleh kerangka kerja untuk menggambar batas tombol. |
CMFCButton::OnDrawFocusRect |
Dipanggil oleh kerangka kerja untuk menggambar persegi panjang fokus untuk tombol. |
CMFCButton::OnDrawText |
Dipanggil oleh kerangka kerja untuk menggambar teks tombol. |
CMFCButton::OnFillBackground |
Dipanggil oleh kerangka kerja untuk menggambar latar belakang teks tombol. |
CMFCButton::SelectFont |
Mengambil font yang terkait dengan konteks perangkat yang ditentukan. |
Anggota Data
Nama | Deskripsi |
---|---|
CMFCButton::m_nAlignStyle |
Menentukan perataan teks tombol. |
CMFCButton::m_bDontUseWinXPTheme |
Menentukan apakah akan menggunakan tema Windows XP. |
CMFCButton::m_bDrawFocus |
Menunjukkan apakah akan menggambar persegi panjang fokus di sekitar tombol. |
CMFCButton::m_nFlatStyle |
Menentukan gaya tombol, seperti tanpa batas, datar, semi-datar, atau 3D. |
CMFCButton::m_bGrayDisabled |
Ketika TRUE , mengaktifkan tombol yang dinonaktifkan untuk digambar sebagai abu-abu. |
CMFCButton::m_bHighlightChecked |
Menunjukkan apakah akan menyorot BS_CHECKBOX tombol -gaya saat kursor mengarahkan kursor ke atasnya. |
CMFCButton::m_bResponseOnButtonDown |
Menunjukkan apakah akan merespons peristiwa tombol bawah. |
CMFCButton::m_bRightImage |
Menunjukkan apakah akan menampilkan gambar di sisi kanan tombol. |
CMFCButton::m_bTopImage |
Menunjukkan apakah gambar berada di atas tombol . |
CMFCButton::m_bTransparent |
Menunjukkan apakah tombol transparan. |
CMFCButton::m_bWasDblClk |
Menunjukkan apakah peristiwa klik terakhir adalah klik dua kali. |
Keterangan
Jenis tombol lain berasal dari CMFCButton
kelas , seperti CMFCURLLinkButton
kelas , yang mendukung hyperlink, dan CMFCColorButton
kelas , yang mendukung kotak dialog pemilih warna.
Gaya CMFCButton
objek dapat berupa 3D
, , flat
semi-flat
atau no border
. Teks tombol dapat diratakan di kiri, atas, atau tengah tombol. Pada waktu proses, Anda dapat mengontrol apakah tombol menampilkan teks, gambar, atau teks dan gambar. Anda juga dapat menentukan bahwa gambar kursor tertentu ditampilkan saat kursor mengarahkan kursor ke tombol.
Buat kontrol tombol baik secara langsung di kode Anda, atau dengan menggunakan alat Wizard Kelas MFC dan templat kotak dialog. Jika Anda membuat kontrol tombol secara langsung, tambahkan CMFCButton
variabel ke aplikasi Anda, lalu panggil konstruktor dan Create
metode CMFCButton
objek. Jika Anda menggunakan Wizard Kelas MFC, tambahkan CButton
variabel ke aplikasi Anda, lalu ubah jenis variabel dari CButton
menjadi CMFCButton
.
Untuk menangani pesan pemberitahuan dalam aplikasi kotak dialog, tambahkan entri peta pesan dan penanganan aktivitas untuk setiap pemberitahuan. Pemberitahuan yang CMFCButton
dikirim oleh objek sama dengan yang dikirim oleh CButton
objek.
Contoh
Contoh berikut menunjukkan cara mengonfigurasi properti tombol dengan menggunakan berbagai metode di CMFCButton
kelas . Contohnya adalah bagian dari sampel Kontrol Baru.
CMFCButton m_Button;
// int m_iImage
// IDB_BTN1_32, IDB_BTN1_HOT_32, IDB_BTN1, IDB_BTN1_HOT are int macros that are #define.
if (m_iImage == 1)
{
m_Button.SetImage((HBITMAP)NULL);
}
else
{
m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
}
// int m_iImage
if (m_iImage == 0)
{
m_Button.SetWindowText(_T(""));
}
else
{
m_Button.SetWindowText(_T("Button"));
}
// Resize the button.
m_Button.SizeToContent();
m_Button.EnableFullTextTooltip(true);
// Use the application menu font at the button text font.
m_Button.EnableMenuFont();
// Use the current Windows theme to draw the button borders.
m_Button.EnableWindowsTheming(true);
// Set the button to auto-repeat mode.
m_Button.SetAutorepeatMode();
// Set the background color for the button text.
m_Button.SetFaceColor(RGB(255,0,0),true);
m_Button.SetTextColor(RGB(0,0,255));
// Set the tooltip of the button.
m_Button.SetTooltip(_T("this is a button!"));
Hierarki Warisan
Persyaratan
Header:afxbutton.h
CMFCButton::CleanUp
Mereset variabel internal dan membebaskan sumber daya yang dialokasikan seperti gambar, bitmap, dan ikon.
virtual void CleanUp();
CMFCButton::EnableFullTextTooltip
Menentukan apakah akan menampilkan teks lengkap tipsalat di jendela tipsalat besar atau versi teks yang terpotong di jendela tipsalat kecil.
void EnableFullTextTooltip(BOOL bOn=TRUE);
Parameter
bOn
[di] TRUE
untuk menampilkan semua teks; FALSE
untuk menampilkan teks terpotong.
CMFCButton::EnableMenuFont
Menentukan apakah font teks tombol sama dengan font menu aplikasi.
void EnableMenuFont(
BOOL bOn=TRUE,
BOOL bRedraw=TRUE);
Parameter
bOn
[di] TRUE
untuk menggunakan font menu aplikasi sebagai font teks tombol; FALSE
untuk menggunakan font sistem. Default adalah TRUE
.
bRedraw
[di] TRUE
untuk segera menggambar ulang layar; jika tidak, FALSE
. Default adalah TRUE
.
Keterangan
Jika Anda tidak menggunakan metode ini untuk menentukan font teks tombol, Anda dapat menentukan font dengan CWnd::SetFont
metode . Jika Anda tidak menentukan font sama sekali, kerangka kerja mengatur font default.
CMFCButton::EnableWindowsTheming
Menentukan apakah gaya batas tombol sesuai dengan tema Windows saat ini.
static void EnableWindowsTheming(BOOL bEnable = TRUE);
Parameter
bEnable
[di] TRUE
untuk menggunakan tema Windows saat ini untuk menggambar batas tombol; FALSE
untuk tidak menggunakan tema Windows. Default adalah TRUE
.
Keterangan
Metode ini memengaruhi semua tombol dalam aplikasi Anda yang berasal dari CMFCButton
kelas .
CMFCButton::GetToolTipCtrl
Mengembalikan referensi ke kontrol tipsalat yang mendasar.
CToolTipCtrl& GetToolTipCtrl();
Tampilkan Nilai
Referensi ke kontrol tipsalat yang mendasar.
CMFCButton::IsAutoCheck
Menunjukkan apakah kotak centang atau tombol radio adalah tombol otomatis.
BOOL IsAutoCheck() const;
Tampilkan Nilai
TRUE
jika tombol memiliki gaya BS_AUTOCHECKBOX
atau BS_AUTORADIOBUTTON
; jika tidak, FALSE
.
CMFCButton::IsAutorepeatCommandMode
Menunjukkan apakah tombol diatur ke mode pengulangan otomatis.
BOOL IsAutorepeatCommandMode() const;
Tampilkan Nilai
TRUE
jika tombol diatur ke mode pengulangan otomatis; jika tidak, FALSE
.
Keterangan
CMFCButton::SetAutorepeatMode
Gunakan metode untuk mengatur tombol ke mode pengulangan otomatis.
CMFCButton::IsCheckBox
Menunjukkan apakah tombol adalah tombol kotak centang.
BOOL IsCheckBox() const;
Tampilkan Nilai
TRUE
jika tombol memiliki atau BS_CHECKBOX
BS_AUTOCHECKBOX
gaya; jika tidak, FALSE
.
CMFCButton::IsChecked
Menunjukkan apakah tombol saat ini dicentang.
BOOL IsChecked() const;
Tampilkan Nilai
TRUE
jika tombol saat ini dicentang; jika tidak, FALSE
.
Keterangan
Kerangka kerja menggunakan berbagai cara untuk menunjukkan bahwa berbagai jenis tombol dicentang. Misalnya, tombol radio dicentang saat berisi titik; kotak centang dicentang saat berisi X
.
CMFCButton::IsHighlighted
Menunjukkan apakah tombol disorot.
BOOL IsHighlighted() const;
Tampilkan Nilai
TRUE
jika tombol disorot; jika tidak, FALSE
.
Keterangan
Tombol menjadi disorot ketika mouse mengarah ke tombol.
CMFCButton::IsPressed
Menunjukkan apakah tombol didorong dan disorot.
BOOL IsPressed() const;
Tampilkan Nilai
TRUE
jika tombol ditekan; jika tidak, FALSE
.
CMFCButton::IsPushed
Menunjukkan apakah tombol didorong.
BOOL IsPushed() const;
Tampilkan Nilai
TRUE
jika tombol didorong; jika tidak, FALSE
.
CMFCButton::IsRadioButton
Menunjukkan apakah tombol adalah tombol radio.
BOOL IsRadioButton() const;
Tampilkan Nilai
TRUE
jika gaya tombol adalah BS_RADIOBUTTON
atau BS_AUTORADIOBUTTON
; jika tidak, FALSE
.
CMFCButton::IsWindowsThemingEnabled
Menunjukkan apakah gaya batas tombol sesuai dengan tema Windows saat ini.
static BOOL IsWindowsThemingEnabled();
Tampilkan Nilai
TRUE
jika gaya batas tombol sesuai dengan tema Windows saat ini; jika tidak, FALSE
.
CMFCButton::m_bDontUseWinXPTheme
Menentukan apakah akan menggunakan tema Windows XP saat menggambar tombol.
BOOL m_bDontUseWinXPTheme;
CMFCButton::m_bDrawFocus
Menunjukkan apakah akan menggambar persegi panjang fokus di sekitar tombol.
BOOL m_bDrawFocus;
Keterangan
m_bDrawFocus
Atur anggota ke TRUE
untuk menentukan bahwa kerangka kerja akan menggambar persegi panjang fokus di sekitar teks dan gambar tombol jika tombol menerima fokus.
CMFCButton
Konstruktor menginisialisasi anggota ini ke TRUE
.
CMFCButton::m_bGrayDisabled
Ketika TRUE
, mengaktifkan tombol yang dinonaktifkan untuk digambar sebagai abu-abu.
BOOL m_bGrayDisabled;
CMFCButton::m_bHighlightChecked
Menunjukkan apakah akan menyorot BS_CHECKBOX
tombol -gaya saat kursor mengarahkan kursor ke atasnya.
BOOL m_bHighlightChecked;
Keterangan
Atur m_bHighlightChecked
anggota ke untuk TRUE
menentukan bahwa kerangka kerja akan menyoroti BS_CHECKBOX
tombol -style saat mouse mengarah ke atasnya.
CMFCButton::m_bResponseOnButtonDown
Menunjukkan apakah akan merespons peristiwa tombol bawah.
BOOL m_bResponseOnButtonDown;
CMFCButton::m_bRightImage
Menunjukkan apakah akan menampilkan gambar di sisi kanan tombol.
BOOL m_bRightImage;
CMFCButton::m_bTopImage
Menunjukkan apakah gambar berada di atas tombol .
BOOL m_bTopImage;
Keterangan
Atur m_bRightImage
anggota ke untuk TRUE
menentukan bahwa kerangka kerja akan menampilkan gambar tombol di sebelah kanan label teks tombol.
CMFCButton::m_bTransparent
Menunjukkan apakah tombol transparan.
BOOL m_bTransparent;
Keterangan
Atur m_bTransparent
anggota ke untuk TRUE
menentukan bahwa kerangka kerja akan membuat tombol transparan.
CMFCButton
Konstruktor menginisialisasi anggota ini ke FALSE
.
CMFCButton::m_nAlignStyle
Menentukan perataan teks tombol.
AlignStyle m_nAlignStyle;
Keterangan
Gunakan salah satu nilai enumerasi berikut CMFCButton::AlignStyle
untuk menentukan perataan teks tombol:
Nilai | Deskripsi |
---|---|
ALIGN_CENTER |
(Default) Meratakan teks tombol ke tengah tombol. |
ALIGN_LEFT |
Meratakan teks tombol ke sisi kiri tombol. |
ALIGN_RIGHT |
Meratakan teks tombol ke sisi kanan tombol. |
CMFCButton
Konstruktor menginisialisasi anggota ini ke ALIGN_CENTER
.
CMFCButton::m_bWasDblClk
Menunjukkan apakah peristiwa klik terakhir adalah klik dua kali.
BOOL m_bWasDblClk;
CMFCButton::m_nFlatStyle
Menentukan gaya tombol, seperti tanpa batas, datar, semi-datar, atau 3D.
FlatStyle m_nFlatStyle;
Keterangan
Tabel berikut mencantumkan CMFCButton::m_nFlatStyle
nilai enumerasi yang menentukan tampilan tombol.
Nilai | Deskripsi |
---|---|
BUTTONSTYLE_3D |
(Default) Tombol tampaknya memiliki sisi tiga dimensi yang tinggi. Saat tombol diklik, tombol tampaknya ditekan ke dalam indentasi mendalam. |
BUTTONSTYLE_FLAT |
Ketika mouse tidak menjeda tombol, tombol tampaknya dua dimensi dan tidak memiliki sisi yang dinaikkan. Ketika mouse berhenti sejenak di atas tombol, tombol tampaknya memiliki sisi tiga dimensi rendah. Ketika tombol diklik, tombol tampaknya ditekan ke dalam indentasi dangkal. |
BUTTONSTYLE_SEMIFLAT |
Tombol tampaknya memiliki sisi tiga dimensi yang rendah. Saat tombol diklik, tombol tampaknya ditekan ke dalam indentasi mendalam. |
BUTTONSTYLE_NOBORDERS |
Tombol tidak memiliki sisi yang dinaikkan dan selalu muncul dua dimensi. Tombol tampaknya tidak ditekan ke dalam indentasi saat diklik. |
CMFCButton
Konstruktor menginisialisasi anggota ini ke BUTTONSTYLE_3D
.
Contoh
Contoh berikut menunjukkan cara mengatur nilai m_nFlatStyle
variabel anggota di CMFCButton
kelas . Contoh ini adalah bagian dari sampel Kontrol Baru.
CMFCButton m_Button;
//int m_iBorderStyle
switch (m_iBorderStyle)
{
case 0:
m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_FLAT;
break;
case 1:
m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_SEMIFLAT;
break;
case 2:
m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_3D;
}
CMFCButton::OnDraw
Dipanggil oleh kerangka kerja untuk menggambar tombol.
virtual void OnDraw(
CDC* pDC,
const CRect& rect,
UINT uiState);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
rect
[di] Referensi ke persegi panjang yang mengikat tombol.
uiState
[di] Status tombol saat ini. Untuk informasi selengkapnya, lihat itemState
anggota DRAWITEMSTRUCT
topik Struktur .
Keterangan
Ambil alih metode ini untuk menggunakan kode Anda sendiri untuk menggambar tombol.
CMFCButton::OnDrawBorder
Dipanggil oleh kerangka kerja untuk menggambar batas tombol.
virtual void OnDrawBorder(
CDC* pDC,
CRect& rectClient,
UINT uiState);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
rectClient
[di] Referensi ke persegi panjang yang mengikat tombol.
uiState
[di] Status tombol saat ini. Untuk informasi selengkapnya, lihat itemState
anggota DRAWITEMSTRUCT
topik Struktur .
Keterangan
Ambil alih metode ini untuk menggunakan kode Anda sendiri untuk menggambar batas.
CMFCButton::OnDrawFocusRect
Dipanggil oleh kerangka kerja untuk menggambar persegi panjang fokus untuk tombol.
virtual void OnDrawFocusRect(
CDC* pDC,
const CRect& rectClient);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
rectClient
[di] Referensi ke persegi panjang yang mengikat tombol.
Keterangan
Ambil alih metode ini untuk menggunakan kode Anda sendiri untuk menggambar persegi panjang fokus.
CMFCButton::OnDrawText
Dipanggil oleh kerangka kerja untuk menggambar teks tombol.
virtual void OnDrawText(
CDC* pDC,
const CRect& rect,
const CString& strText,
UINT uiDTFlags,
UINT uiState);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
rect
[di] Referensi ke persegi panjang yang mengikat tombol.
strText
[di] Teks yang akan digambar.
uiDTFlags
[di] Bendera yang menentukan cara memformat teks. Untuk informasi selengkapnya, lihat nFormat
parameter CDC::DrawText
metode .
uiState
[in] Dipesan.
Keterangan
Ambil alih metode ini untuk menggunakan kode Anda sendiri untuk menggambar teks tombol.
CMFCButton::OnFillBackground
Dipanggil oleh kerangka kerja untuk menggambar latar belakang teks tombol.
virtual void OnFillBackground(
CDC* pDC,
const CRect& rectClient);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
rectClient
[di] Referensi ke persegi panjang yang mengikat tombol.
Keterangan
Ambil alih metode ini untuk menggunakan kode Anda sendiri untuk menggambar latar belakang tombol.
CMFCButton::SelectFont
Mengambil font yang terkait dengan konteks perangkat yang ditentukan.
virtual CFont* SelectFont(CDC* pDC);
Parameter
pDC
[di] Penunjuk ke konteks perangkat.
Tampilkan Nilai
Ambil alih metode ini untuk menggunakan kode Anda sendiri untuk mengambil font.
CMFCButton::SetAutorepeatMode
Mengatur tombol ke mode pengulangan otomatis.
void SetAutorepeatMode(int nTimeDelay=500);
Parameter
nTimeDelay
[di] Angka nonnegatif yang menentukan interval antara pesan yang dikirim ke jendela induk. Interval diukur dalam milidetik dan nilai defaultnya adalah 500 milidetik. Tentukan nol untuk menonaktifkan mode pesan berulang otomatis.
Keterangan
Metode ini menyebabkan tombol terus-menerus mengirim WM_COMMAND
pesan ke jendela induk hingga tombol dirilis, atau nTimeDelay
parameter diatur ke nol.
CMFCButton::SetCheckedImage
Mengatur gambar untuk tombol yang dicentang.
void SetCheckedImage(
HICON hIcon,
BOOL bAutoDestroy=TRUE,
HICON hIconHot=NULL,
HICON hIconDisabled=NULL,
BOOL bAlphaBlend=FALSE);
void SetCheckedImage(
HBITMAP hBitmap,
BOOL bAutoDestroy=TRUE,
HBITMAP hBitmapHot=NULL,
BOOL bMap3dColors=TRUE,
HBITMAP hBitmapDisabled=NULL);
void SetCheckedImage(
UINT uiBmpResId,
UINT uiBmpHotResId=0,
UINT uiBmpDsblResID=0);
Parameter
hIcon
[di] Tangani ke ikon yang berisi bitmap dan mask untuk gambar baru.
bAutoDestroy
[di] TRUE
untuk menentukan bahwa sumber daya bitmap dihancurkan secara otomatis; jika tidak, FALSE
. Default adalah TRUE
.
hIconHot
[di] Tangani ke ikon yang berisi gambar untuk status terpilih.
hBitmap
[di] Tangani ke bitmap yang berisi gambar untuk status yang tidak dipilih.
hBitmapHot
[di] Tangani ke bitmap yang berisi gambar untuk status terpilih.
bMap3dColors
[di] Menentukan warna transparan untuk latar belakang tombol; yaitu, wajah tombol.
TRUE
untuk menggunakan nilai warna RGB(192, 192, 192); FALSE
untuk menggunakan nilai warna yang ditentukan oleh AFX_GLOBAL_DATA::clrBtnFace
.
uiBmpResId
[di] ID sumber daya untuk gambar yang tidak dipilih.
uiBmpHotResId
[di] ID sumber daya untuk gambar yang dipilih.
hIconDisabled
[di] Tangani ke ikon untuk gambar yang dinonaktifkan.
hBitmapDisabled
[di] Tangani ke bitmap yang berisi gambar yang dinonaktifkan.
uiBmpDsblResID
[di] ID sumber daya bitmap yang dinonaktifkan.
bAlphaBlend
[di] TRUE
untuk hanya menggunakan gambar 32-bit yang menggunakan saluran alfa; FALSE
, untuk tidak hanya menggunakan gambar saluran alfa. Default adalah FALSE
.
CMFCButton::SetFaceColor
Mengatur warna latar belakang untuk teks tombol.
void SetFaceColor(
COLORREF crFace,
BOOL bRedraw=TRUE);
Parameter
crFace
[di] Nilai warna RGB.
bRedraw
[di] TRUE
untuk segera menggambar ulang layar; jika tidak, FALSE
.
Keterangan
Gunakan metode ini untuk menentukan warna isian baru untuk latar belakang tombol (wajah). Perhatikan bahwa latar belakang tidak diisi saat CMFCButton::m_bTransparent
variabel anggota adalah TRUE
.
CMFCButton::SetImage
Mengatur gambar untuk tombol.
void SetImage(
HICON hIcon,
BOOL bAutoDestroy=TRUE,
HICON hIconHot=NULL,
HICON hIconDisabled=NULL,
BOOL bAlphaBlend=FALSE);
void SetImage(
HBITMAP hBitmap,
BOOL bAutoDestroy=TRUE,
HBITMAP hBitmapHot=NULL,
BOOL bMap3dColors=TRUE,
HBITMAP hBitmapDisabled=NULL);
void SetImage(
UINT uiBmpResId,
UINT uiBmpHotResId=0,
UINT uiBmpDsblResID=0);
Parameter
hIcon
[di] Tangani ke ikon yang berisi bitmap dan mask untuk gambar baru.
bAutoDestroy
[di] TRUE
untuk menentukan bahwa sumber daya bitmap dihancurkan secara otomatis; jika tidak, FALSE
. Default adalah TRUE
.
hIconHot
[di] Tangani ke ikon yang berisi gambar untuk status terpilih.
hBitmap
[di] Tangani ke bitmap yang berisi gambar untuk status yang tidak dipilih.
hBitmapHot
[di] Tangani ke bitmap yang berisi gambar untuk status terpilih.
uiBmpResId
[di] ID sumber daya untuk gambar yang tidak dipilih.
uiBmpHotResId
[di] ID sumber daya untuk gambar yang dipilih.
bMap3dColors
[di] Menentukan warna transparan untuk latar belakang tombol; yaitu, wajah tombol.
TRUE
untuk menggunakan nilai warna RGB(192, 192, 192); FALSE
untuk menggunakan nilai warna yang ditentukan oleh AFX_GLOBAL_DATA::clrBtnFace
.
hIconDisabled
[di] Tangani ke ikon untuk gambar yang dinonaktifkan.
hBitmapDisabled
[di] Tangani ke bitmap yang berisi gambar yang dinonaktifkan.
uiBmpDsblResID
[di] ID sumber daya bitmap yang dinonaktifkan.
bAlphaBlend
[di] TRUE
untuk hanya menggunakan gambar 32-bit yang menggunakan saluran alfa; FALSE
, untuk tidak hanya menggunakan gambar saluran alfa. Default adalah FALSE
.
Contoh
Contoh berikut menunjukkan cara menggunakan berbagai versi SetImage
metode di CMFCButton
kelas . Contohnya adalah bagian dari sampel Kontrol Baru.
CMFCButton m_Button;
// int m_iImage
// IDB_BTN1_32, IDB_BTN1_HOT_32, IDB_BTN1, IDB_BTN1_HOT are int macros that are #define.
if (m_iImage == 1)
{
m_Button.SetImage((HBITMAP)NULL);
}
else
{
m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
}
CMFCButton::SetMouseCursor
Mengatur gambar kursor.
void SetMouseCursor(HCURSOR hcursor);
Parameter
hcursor
[di] Handel kursor.
Keterangan
Gunakan metode ini untuk mengaitkan gambar kursor, seperti kursor tangan, dengan tombol . Kursor dimuat dari sumber daya aplikasi.
Contoh
Contoh berikut menunjukkan cara menggunakan SetMouseCursor
metode di CMFCButton
kelas . Contohnya adalah bagian dari kode dalam sampel Kontrol Baru.
CMFCButton m_Button;
// int m_iCursor
void CPage1::OnSetCursor()
{
UpdateData();
switch (m_iCursor)
{
case 0:
m_Button.SetMouseCursor(NULL);
break;
case 1:
m_Button.SetMouseCursorHand();
break;
case 2:
m_Button.SetMouseCursor(AfxGetApp()->LoadCursor(IDC_CURSOR));
break;
}
}
CMFCButton::SetMouseCursorHand
Mengatur kursor ke gambar tangan.
void SetMouseCursorHand();
Keterangan
Gunakan metode ini untuk mengaitkan gambar kursor tangan dengan tombol . Kursor dimuat dari sumber daya aplikasi.
CMFCButton::SetStdImage
CMenuImages
Menggunakan objek untuk mengatur gambar tombol.
void SetStdImage(
CMenuImages::IMAGES_IDS id,
CMenuImages::IMAGE_STATE state=CMenuImages::ImageBlack,
CMenuImages::IMAGES_IDS idDisabled=(CMenuImages::IMAGES_IDS)0);
Parameter
id
[di] Salah satu pengidentifikasi gambar tombol yang ditentukan dalam CMenuImage::IMAGES_IDS
enumerasi. Nilai gambar menentukan gambar seperti panah, pin, dan tombol radio.
state
[di] Salah satu pengidentifikasi status gambar tombol yang ditentukan dalam CMenuImages::IMAGE_STATE
enumerasi. Status gambar menentukan warna tombol seperti hitam, abu-abu, abu-abu muda, putih, dan abu-abu gelap. Nilai defaultnya adalah CMenuImages::ImageBlack
.
idDisabled
[di] Salah satu pengidentifikasi gambar tombol yang ditentukan dalam CMenuImage::IMAGES_IDS
enumerasi. Gambar menunjukkan bahwa tombol dinonaktifkan. Nilai defaultnya adalah gambar tombol pertama (CMenuImages::IdArrowDown
).
CMFCButton::SetTextColor
Mengatur warna teks tombol untuk tombol yang tidak dipilih.
void SetTextColor(COLORREF clrText);
Parameter
clrText
[di] Nilai warna RGB.
CMFCButton::SetTextHotColor
Mengatur warna teks tombol untuk tombol yang dipilih.
void SetTextHotColor(COLORREF clrTextHot);
Parameter
clrTextHot
[di] Nilai warna RGB.
CMFCButton::SetTooltip
Mengaitkan tipsalat dengan tombol.
void SetTooltip(LPCTSTR lpszToolTipText);
Parameter
lpszToolTipText
[di] Arahkan ke teks untuk tipsalat. Tentukan NULL
untuk menonaktifkan tipsalat.
CMFCButton::SizeToContent
Mengubah ukuran tombol untuk memuat teks dan gambar tombolnya.
virtual CSize SizeToContent(BOOL bCalcOnly=FALSE);
Parameter
bCalcOnly
[di] TRUE
untuk menghitung, tetapi tidak berubah, ukuran baru tombol; FALSE
untuk mengubah ukuran tombol. Default adalah FALSE
.
Tampilkan Nilai
Objek CSize
yang berisi ukuran baru tombol.
Keterangan
Secara default, metode ini menghitung ukuran baru yang menyertakan margin horizontal 10 piksel dan margin vertikal 5 piksel.
Lihat juga
Bagan Hierarki
Kelas
CMFCLinkCtrl
Kelas
CMFCColorButton
Kelas
CMFCMenuButton
Kelas