Bagikan melalui


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_CHECKBOXtombol -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, , flatsemi-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

CObject

CCmdTarget

CWnd

CButton

CMFCButton

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_CHECKBOXBS_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_CHECKBOXtombol -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_CHECKBOXtombol -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