Kelas CMFCToolBarButton

Artikel
06/16/2023

Menyediakan fungsionalitas tombol ke bilah alat.

Sintaks

class CMFCToolBarButton : public CObject

Anggota

Konstruktor Publik

Nama	Deskripsi
CMFCToolBarButton::CMFCToolBarButton	Membuat dan menginisialisasi `CMFCToolBarButton` objek.
`CMFCToolBarButton::~CMFCToolBarButton`	Destruktor.

Metode Publik

Nama	Deskripsi
CMFCToolBarButton::CanBeDropped	Menentukan apakah pengguna dapat memposisikan tombol pada toolbar atau menu selama penyesuaian.
CMFCToolBarButton::CanBestored	Menentukan apakah tombol dapat disimpan.
CMFCToolBarButton::CanBeStretched	Menentukan apakah pengguna dapat membentangkan tombol selama kustomisasi.
CMFCToolBarButton::CompareWith	Membandingkan instans ini dengan objek yang disediakan `CMFCToolBarButton` .
CMFCToolBarButton::CopyFrom	Menyalin properti tombol bilah alat lain ke tombol saat ini.
CMFCToolBarButton::CreateFromOleData	`CMFCToolBarButton` Membuat objek dari objek yang disediakan`COleDataObject`.
`CMFCToolBarButton::CreateObject`	Digunakan oleh kerangka kerja untuk membuat instans dinamis dari jenis kelas ini.
CMFCToolBarButton::EnableWindow	Mengaktifkan atau menonaktifkan input mouse dan keyboard.
CMFCToolBarButton::ExportToMenuButton	Menyalin teks dari tombol toolbar ke menu.
CMFCToolBarButton::GetClipboardFormat	Mengambil format clipboard global untuk aplikasi.
CMFCToolBarButton::GetHwnd	Mengambil handel jendela yang terkait dengan tombol bilah alat.
CMFCToolBarButton::GetImage	Mengambil indeks gambar tombol.
CMFCToolBarButton::GetInvalidateRect	Mengambil wilayah area klien tombol yang harus digambar ulang.
CMFCToolBarButton::GetParentWnd	Mengambil jendela induk tombol.
CMFCToolBarButton::GetProtectedCommands	Mengambil daftar perintah yang tidak dapat dikustomisasi pengguna.
CMFCToolBarButton::GetTextSize	Mengambil ukuran teks tombol.
CMFCToolBarButton::HasFocus	Menentukan apakah tombol memiliki fokus input saat ini.
CMFCToolBarButton::HaveHotBorder	Menentukan apakah batas tombol ditampilkan saat pengguna memilih tombol.
CMFCToolBarButton::IsDrawImage	Menentukan apakah gambar ditampilkan pada tombol .
CMFCToolBarButton::IsDrawText	Menentukan apakah label teks ditampilkan pada tombol .
CMFCToolBarButton::IsDroppedDown	Menentukan apakah tombol menampilkan submenu.
CMFCToolBarButton::IsEditable	Menentukan apakah tombol dapat disesuaikan.
CMFCToolBarButton::IsExtraSize	Menentukan apakah tombol dapat ditampilkan dengan batas yang diperluas.
CMFCToolBarButton::IsFirstInGroup	Menentukan apakah tombol berada di posisi pertama dalam grup tombolnya.
CMFCToolBarButton::IsHidden	Menentukan apakah tombol disembunyikan.
CMFCToolBarButton::IsHorizontal	Menentukan apakah tombol terletak pada bilah alat horizontal.
CMFCToolBarButton::IsLastIngroup	Menentukan apakah tombol berada di posisi terakhir dalam grup tombolnya.
CMFCToolBarButton::IsLocked	Menentukan apakah tombol berada pada toolbar terkunci (tidak dapat disesuaikan).
CMFCToolBarButton::IsOwnerOf	Menentukan apakah tombol adalah pemilik handel jendela yang disediakan.
CMFCToolBarButton::IsVisible	Menentukan apakah tombol toolbar terlihat.
CMFCToolBarButton::IsWindowVisible	Menentukan apakah handel jendela yang mendasar tombol terlihat.
CMFCToolBarButton::NotifyCommand	Menentukan apakah tombol memproses pesan WM_COMMAND .
CMFCToolBarButton::OnAddToCustomizePage	Dipanggil oleh kerangka kerja saat tombol ditambahkan ke kotak dialog Kustomisasi .
CMFCToolBarButton::OnBeforeDrag	Menentukan apakah tombol dapat diseret.
CMFCToolBarButton::OnBeforeDrop	Menentukan apakah pengguna dapat menjatuhkan tombol ke toolbar target.
CMFCToolBarButton::OnCalculateSize	Dipanggil oleh kerangka kerja untuk menghitung ukuran tombol untuk konteks perangkat dan status docking yang ditentukan.
CMFCToolBarButton::OnCancelMode	Dipanggil oleh kerangka kerja untuk menangani pesan WM_CANCELMODE .
CMFCToolBarButton::OnChangeParentWnd	Dipanggil oleh kerangka kerja saat tombol disisipkan ke toolbar baru.
CMFCToolBarButton::OnClick	Dipanggil oleh kerangka kerja ketika pengguna mengklik tombol mouse.
CMFCToolBarButton::OnClickUp	Dipanggil oleh kerangka kerja ketika pengguna merilis tombol mouse.
CMFCToolBarButton::OnContextHelp	Dipanggil oleh kerangka kerja saat toolbar induk menangani pesan WM_HELPHITTEST.
CMFCToolBarButton::OnCtlColor	Dipanggil oleh kerangka kerja saat toolbar induk menangani pesan WM_CTLCOLOR.
CMFCToolBarButton::OnCustomizeMenu	Perbolehkan tombol untuk mengubah menu yang disediakan ketika aplikasi menampilkan menu pintasan pada toolbar induk.
CMFCToolBarButton::OnDblClk	Dipanggil oleh kerangka kerja saat toolbar induk menangani pesan WM_LBUTTONDBLCLK .
CMFCToolBarButton::OnDraw	Dipanggil oleh kerangka kerja untuk menggambar tombol dengan menggunakan gaya dan opsi yang ditentukan.
CMFCToolBarButton::OnDrawOnCustomizeList	Dipanggil oleh kerangka kerja untuk menggambar tombol di panel Perintah dari kotak dialog Kustomisasi.
CMFCToolBarButton::OnGetCustomToolTipText	Dipanggil oleh kerangka kerja untuk mengambil teks tipsalat kustom untuk tombol .
CMFCToolBarButton::OnGlobalFontsChanged	Dipanggil oleh kerangka kerja ketika font global telah berubah.
CMFCToolBarButton::OnMove	Dipanggil oleh kerangka kerja saat toolbar induk bergerak.
CMFCToolBarButton::OnShow	Dipanggil oleh kerangka kerja ketika tombol menjadi terlihat atau tidak terlihat.
CMFCToolBarButton::OnSize	Dipanggil oleh kerangka kerja ketika toolbar induk mengubah ukuran atau posisinya dan perubahan ini memerlukan tombol untuk mengubah ukuran.
CMFCToolBarButton::OnToolHitTest	Dipanggil oleh kerangka kerja ketika toolbar induk harus menentukan apakah titik berada di persegi panjang pembatas tombol.
CMFCToolBarButton::OnUpdateToolTip	Dipanggil oleh kerangka kerja saat toolbar induk memperbarui teks tipsalatnya.
CMFCToolBarButton::P repareDrag	Dipanggil oleh kerangka kerja ketika tombol akan melakukan operasi seret dan letakkan.
CMFCToolBarButton::Rect	Mengambil persegi panjang pembatas tombol.
CMFCToolBarButton::ResetImageToDefault	Mengatur ke nilai default gambar yang terkait dengan tombol .
CMFCToolBarButton::SaveBarState	Menyimpan status tombol bilah alat.
CMFCToolBarButton::Serialize	Membaca objek ini dari arsip atau menulisnya ke arsip. (Penimpaan CObject::Serialize.)
CMFCToolBarButton::SetACCData	Mengisi objek yang disediakan `CAccessibilityData` dengan data aksesibilitas dari tombol toolbar.
CMFCToolBarButton::SetClipboardFormatName	Mengganti nama format clipboard global.
CMFCToolBarButton::SetImage	Mengatur indeks gambar tombol.
CMFCToolBarButton::SetProtectedCommands	Mengatur daftar perintah yang tidak dapat dikustomisasi pengguna.
CMFCToolBarButton::SetRadio	Dipanggil oleh kerangka kerja ketika tombol mengubah status yang dicentang.
CMFCToolBarButton::SetRect	Mengatur persegi panjang pembatas tombol.
CMFCToolBarButton::SetStyle	Mengatur gaya tombol.
CMFCToolBarButton::SetVisible	Menentukan apakah tombol terlihat.
CMFCToolBarButton::Show	Menampilkan atau menyembunyikan tombol.

Anggota Data

Nama	Deskripsi
CMFCToolBarButton::m_bImage	Menentukan apakah gambar ditampilkan pada tombol .
CMFCToolBarButton::m_bText	Menentukan apakah label teks ditampilkan pada tombol.
CMFCToolBarButton::m_bTextBelow	Menentukan apakah label teks ditampilkan di bawah gambar pada tombol .
CMFCToolBarButton::m_bUserButton	Menentukan apakah tombol memiliki gambar yang ditentukan pengguna.
CMFCToolBarButton::m_bWholeText	Menentukan apakah tombol menampilkan label teks lengkapnya meskipun tidak pas di persegi panjang pembatas.
CMFCToolBarButton::m_bWrap	Menentukan apakah tombol di samping pemisah akan diletakkan pada baris berikutnya.
CMFCToolBarButton::m_bWrapText	Menentukan apakah label teks multibaris diaktifkan.
CMFCToolBarButton::m_nID	ID perintah tombol.
CMFCToolBarButton::m_nStyle	Gaya tombol.
CMFCToolBarButton::m_strText	Label teks tombol.

Keterangan

Objek CMFCToolbarButton adalah kontrol yang berada di toolbar. Perilakunya menyerupan tombol biasa. Anda dapat menetapkan gambar dan label teks ke objek ini. Tombol toolbar juga dapat memiliki ID perintah. Saat pengguna mengklik tombol toolbar, kerangka kerja menjalankan perintah yang ditentukan ID ini.

Biasanya, tombol toolbar dapat dikustomisasi: pengguna dapat menyeret tombol dari satu toolbar ke toolbar lainnya, dan menyalin, menempel, menghapus, dan mengedit label teks dan gambar. Untuk mencegah pengguna menyesuaikan toolbar, Anda dapat mengunci toolbar dengan salah satu dari dua cara. Atur bLocked bendera ke TRUE saat Anda memanggil CMFCToolBar::LoadToolBar, atau tambahkan ID perintah tombol individual ke daftar global perintah yang dilindungi dengan menggunakan metode CMFCToolBarButton::SetProtectedCommands .

CMFCToolBarButton objek menampilkan gambar dari koleksi gambar toolbar global dalam aplikasi. Koleksi ini dikelola oleh toolbar induk, Kelas CMFCToolBar. Untuk informasi selengkapnya, lihat Kelas CMFCToolBarImages.

Ketika pengguna mengklik tombol toolbar, toolbar induknya memproses pesan mouse dan mengkomunikasikan tindakan yang sesuai ke tombol . Jika tombol memiliki ID perintah yang valid, toolbar induk mengirimkan pesan WM_COMMAND ke bingkai induk.

Kelas CMFCToolBarButton ini adalah kelas dasar untuk kelas tombol toolbar lainnya, seperti Kelas CMFCToolBarMenuButton, Kelas CMFCToolBarEditBoxButton, dan Kelas CMFCToolBarComboBoxButton.

Contoh

Contoh berikut menunjukkan cara mengonfigurasi CMFCToolBarButton objek dengan menggunakan berbagai metode di CMFCToolBarButton kelas . Contoh ini menggambarkan cara mengaktifkan input mouse dan keyboard, mengatur indeks gambar tombol, mengatur persegi panjang pembatas tombol, dan membuat tombol terlihat. Cuplikan kode ini adalah bagian dari sampel Kontrol Tab.

CMFCToolBarButton *pOffice2007 = NULL;
int nIndex = -1;

for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
   // CMFCToolBar m_wndToolBarTheme
   nIndex = m_wndToolBarTheme.CommandToIndex(uiCmd);

   CMFCToolBarButton *pButton = m_wndToolBarTheme.GetButton(nIndex);

   if (pButton != NULL)
   {
      pOffice2007 = pButton;
      break;
   }
}

pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect(CRect(1, 1, 1, 1));
pOffice2007->SetVisible();
pOffice2007->Show(true);

Hierarki Warisan

CObject

CMFCToolBarButton

Persyaratan

Header: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Menentukan apakah pengguna dapat memposisikan tombol pada toolbar atau menu selama penyesuaian.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parameter

pToolbar
[in] Tidak terpakai.

Tampilkan Nilai

Metode ini mengembalikan TRUE.

Keterangan

Secara default, tombol toolbar dapat dihilangkan pada setiap toolbar yang dapat disesuaikan (yaitu, tidak terkunci).

Implementasi default metode ini mengembalikan TRUE. Ambil alih metode ini dan kembalikan FALSE jika Anda ingin mencegah pengguna memposisikan ulang tombol.

CMFCToolBarButton::CanBestored

Menentukan apakah tombol dapat disimpan.

virtual BOOL CanBeStored() const;

Tampilkan Nilai

Metode ini mengembalikan TRUE.

Keterangan

Kerangka kerja menggunakan metode ini untuk menentukan apakah tombol dapat berpartisipasi dalam operasi seret dan letakkan.

Implementasi default mengembalikan TRUE. Ambil alih metode ini jika tombol Anda tidak dapat disimpan sebagai bagian dari operasi seret dan letakkan. Untuk informasi selengkapnya tentang operasi seret dan letakkan, lihat Seret dan letakkan OLE.

CMFCToolBarButton::CanBeStretched

Menentukan apakah pengguna dapat membentangkan tombol selama kustomisasi.

virtual BOOL CanBeStretched() const;

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Metode ini digunakan oleh kerangka kerja untuk menentukan apakah tombol dapat direntangkan dalam mode kustomisasi.

Implementasi default metode ini mengembalikan FALSE. Ambil alih metode ini untuk mengembalikan TRUE untuk kontrol lebar variabel seperti kotak kombo atau penggerak.

Untuk informasi selengkapnya tentang mode kustomisasi, lihat CMFCToolBar::SetCustomizeMode.

CMFCToolBarButton::CMFCToolBarButton

Membuat dan menginisialisasi CMFCToolBarButton objek.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Parameter

uiID
[di] ID perintah tombol.

iImage
[di] Indeks gambar tombol dalam kumpulan gambar.

lpszText
[di] Label teks tombol. Bisa NULL.

bUserButton
[di] Nilai Boolean yang menentukan apakah tombol ditentukan pengguna. Jika parameter ini TRUE, tombol ditentukan pengguna. Jika tidak, gambar tombol dimuat dari sumber daya.

buntu
[di] Nilai Boolean yang menentukan apakah tombol dapat disesuaikan. Jika parameter ini TRUE, tombol tidak dapat dikustomisasi. Jika tidak, tombol dapat disesuaikan.

CMFCToolBarButton::CompareWith

Membandingkan instans ini dengan objek yang disediakan CMFCToolBarButton .

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parameter

lain
[di] Referensi ke objek untuk dibandingkan dengan instans ini.

Tampilkan Nilai

Bukan nol jika objek yang disediakan sama dengan nilai instans ini; jika tidak, 0.

Keterangan

Implementasi default menentukan apakah ID perintah objek yang disediakan sama dengan ID perintah instans ini. Ambil alih metode ini jika Anda harus melakukan pemrosesan tambahan untuk menentukan apakah dua CMFCToolBarButton objek sama.

CMFCToolBarButton::CopyFrom

Menyalin properti tombol bilah alat lain ke tombol saat ini.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameter

src
[di] Referensi ke tombol sumber yang akan disalin.

Keterangan

Panggil metode ini untuk menyalin tombol bilah alat lain ke tombol bilah alat ini.

CMFCToolBarButton::CreateFromOleData

CMFCToolBarButton Membuat objek dari objek yang disediakanCOleDataObject.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parameter

pDataObject
[di] Objek data OLE sumber.

Tampilkan Nilai

Objek yang dibuat CMFCToolBarButton .

Keterangan

Metode ini digunakan oleh kerangka kerja untuk melakukan transfer data dalam berbagai format. Misalnya, CMFCOutlookBarPane::OnDragOver metode ini menggunakan metode ini untuk melakukan operasi seret dan letakkan.

CMFCToolBarButton::EnableWindow

Mengaktifkan atau menonaktifkan input mouse dan keyboard.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parameter

bEnable
[di] Atur parameter ini ke TRUE untuk mengaktifkan input, atau ke FALSE untuk menonaktifkan input.

Keterangan

Metode ini memanggil EnableWindow fungsi untuk mengaktifkan atau menonaktifkan input. Untuk informasi selengkapnya, lihat EnableWindow di Windows SDK.

CMFCToolBarButton::ExportToMenuButton

Menyalin teks dari tombol toolbar ke menu.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parameter

menuButton
[di] Referensi ke tombol menu target.

Tampilkan Nilai

Metode ini mengembalikan TRUE.

Keterangan

Kerangka kerja memanggil metode ini untuk menyalin teks dari tombol toolbar ke tombol menu. Implementasi default menyalin label teks tombol. Jika label teks kosong, metode ini menyalin teks tipsalat tombol.

Implementasi default metode ini mengembalikan TRUE. Ambil alih metode ini jika Anda ingin mengambil tindakan tambahan ketika kerangka kerja mengonversi objek yang berasal dari CMFCToolbarButton ke tombol menu.

CMFCToolBarButton::GetClipboardFormat

Mengambil format clipboard global untuk aplikasi.

static CLIPFORMAT __stdcall GetClipboardFormat();

Tampilkan Nilai

Nilai CLIPFORMAT global untuk aplikasi.

Keterangan

Kerangka kerja memanggil metode ini untuk mengambil format clipboard untuk operasi transfer data OLE. Misalnya, metode CMFCToolBarButton::CreateFromOleData menggunakan metode ini untuk menyalin data dari objek data OLE sumber.

Metode ini menetapkan nilai CLIPFORMAT global saat pertama kali metode ini dipanggil. Semua panggilan berikutnya ke metode ini mengembalikan nilai ini.

Untuk memungkinkan operasi seret dan letakkan terjadi di antara aplikasi, panggil metode CMFCToolBarButton::SetClipboardFormatName .

Untuk informasi selengkapnya tentang clipboard di MFC, lihat Clipboard.

CMFCToolBarButton::GetHwnd

Mengambil handel jendela yang terkait dengan tombol bilah alat.

virtual HWND GetHwnd();

Tampilkan Nilai

Handel jendela yang terkait dengan tombol toolbar atau NULL jika tombol toolbar tidak memiliki handel jendela terkait.

Keterangan

Implementasi default metode ini mengembalikan NULL. Ambil alih metode ini untuk mengembalikan handel jendela kontrol spesifik Anda.

CMFCToolBarButton::GetImage

Mengambil indeks gambar tombol.

int GetImage() const;

Tampilkan Nilai

Indeks gambar yang terkait dengan tombol ini.

Keterangan

Jika tombol memiliki gambar yang ditentukan pengguna (yaitu, jika bUserButton TRUE di konstruktor), indeks yang dikembalikan menentukan gambar dalam kumpulan gambar yang ditentukan pengguna (lihat CMFCToolBar::GetUserImages). Jika tidak, indeks menentukan gambar dalam kumpulan gambar yang dimuat dari file sumber daya (lihat CMFCToolBar::GetImages). Untuk informasi selengkapnya tentang file sumber daya, lihat Bekerja dengan File Sumber Daya.

CMFCToolBarButton::GetInvalidateRect

Mengambil wilayah area klien tombol yang harus digambar ulang.

virtual const CRect GetInvalidateRect() const;

Tampilkan Nilai

Objek CRect yang menentukan wilayah yang harus digambar ulang.

Keterangan

Implementasi default metode ini mengembalikan seluruh area klien. Ambil alih metode ini jika Anda ingin area yang berbeda digambar ulang.

CMFCToolBarButton::GetParentWnd

Mengambil jendela induk tombol.

CWnd* GetParentWnd() const;

Tampilkan Nilai

Jendela induk tombol.

CMFCToolBarButton::GetProtectedCommands

Mengambil daftar perintah yang tidak dapat dikustomisasi pengguna.

static const CList<UINT,UINT>& GetProtectedCommands();

Tampilkan Nilai

Daftar perintah yang dilindungi.

Keterangan

Dalam mode kustomisasi, kerangka kerja menonaktifkan perintah tombol toolbar yang dilindungi. Pengguna tidak dapat melakukan operasi seret dan letakkan dan edit pada tombol toolbar yang dinonaktifkan.

Gunakan metode CMFCToolBarButton::SetProtectedCommands untuk menentukan daftar perintah yang dilindungi.

CMFCToolBarButton::GetTextSize

Mengambil ukuran teks tombol.

SIZE GetTextSize() const;

Tampilkan Nilai

Objek SIZE yang berisi ukuran, dalam piksel, dari teks tombol.

CMFCToolBarButton::HasFocus

Menentukan apakah tombol memiliki fokus input saat ini.

virtual BOOL HasFocus() const;

Tampilkan Nilai

Bukan nol jika tombol memiliki fokus input; jika tidak, 0.

Keterangan

Implementasi default metode ini mengembalikan nonzero jika tombol memiliki fokus input atau merupakan jendela turunan atau anak dari jendela yang memiliki fokus input. Anda dapat mengambil alih fungsi ini untuk menyesuaikan perilaku ini.

CMFCToolBarButton::HaveHotBorder

Menentukan apakah batas tombol ditampilkan saat pengguna memilih tombol.

virtual BOOL HaveHotBorder() const;

Tampilkan Nilai

Metode ini mengembalikan TRUE.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan apakah tombol toolbar harus menampilkan batasnya saat pengguna memilihnya.

Implementasi default mengembalikan TRUE. Anda dapat mengambil alih metode ini untuk menyesuaikan perilaku ini.

CMFCToolBarButton::IsDrawImage

Menentukan apakah gambar ditampilkan pada tombol .

BOOL IsDrawImage() const;

Tampilkan Nilai

Bukan nol jika gambar ditampilkan pada tombol; jika tidak, 0.

Keterangan

Metode ini mengembalikan FALSE jika tombol toolbar tidak memiliki gambar terkait ( CMFCToolBarButton::GetImage mengembalikan -1) atau jika CMFCToolBarButton::m_bImage diatur ke FALSE.

CMFCToolBarButton::IsDrawText

Menentukan apakah label teks ditampilkan pada tombol .

BOOL IsDrawText() const;

Tampilkan Nilai

Bukan nol jika label teks ditampilkan; jika tidak, 0.

Keterangan

Metode ini mengembalikan FALSE jika tombol toolbar tidak memiliki label teks terkait ( CMFCToolBarButton::m_strText kosong) atau CMFCToolBarButton::m_bText diatur ke FALSE.

CMFCToolBarButton::IsDroppedDown

Menentukan apakah tombol menampilkan submenu.

virtual BOOL IsDroppedDown() const;

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Implementasi default metode ini mengembalikan FALSE. Ambil alih metode ini untuk mengembalikan TRUE jika kontrol Anda menampilkan submenu.

CMFCToolBarButton::IsEditable

Menentukan apakah tombol dapat disesuaikan.

virtual BOOL IsEditable() const;

Tampilkan Nilai

Bukan nol jika tombol dapat disesuaikan oleh pengguna; jika tidak, 0.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan apakah pengguna dapat menyesuaikan tombol toolbar dengan menggunakan operasi seret dan letakkan atau edit.

Implementasi default mengembalikan FALSE jika ID perintah tombol adalah perintah standar (Anda dapat menentukannya dengan memanggil IsStandardCommand fungsi) atau jika ID perintah ada dalam daftar perintah yang dilindungi. Untuk informasi selengkapnya tentang perintah yang dilindungi, lihat CMFCToolBarButton::GetProtectedCommands dan CMFCToolBarButton::SetProtectedCommands.

Ambil alih metode ini untuk menyesuaikan perilakunya.

CMFCToolBarButton::IsExtraSize

Menentukan apakah tombol dapat ditampilkan dengan batas yang diperluas.

virtual BOOL IsExtraSize() const;

Tampilkan Nilai

Bukan nol jika tombol toolbar dapat ditampilkan dengan batas yang diperluas; jika tidak, 0.

Keterangan

Beberapa skin menggunakan ukuran ekstra untuk batas tombol toolbar (misalnya, tombol bulat).

Jika pengguna memindahkan tombol ini dari satu toolbar ke toolbar lainnya, kerangka kerja memanggil metode CMFCToolBarButton::OnChangeParentWnd . Metode CMFCToolBarButton::OnChangeParentWnd mengatur bendera ukuran tambahan ke toolbar induk baru (untuk informasi selengkapnya, lihat CMFCToolBar::IsButtonExtraSizeAvailable).

CMFCToolBarButton::IsFirstInGroup

Menentukan apakah tombol berada di posisi pertama dalam grup tombolnya.

virtual BOOL IsFirstInGroup() const;

Tampilkan Nilai

TRUE jika tombol adalah tombol pertama dalam grup tombolnya; jika tidak FALSE.

Keterangan

Metode ini mendefinisikan grup tombol sebagai sekumpulan tombol tetangga yang diposisikan pada baris yang sama dan dibatasi oleh pemisah atau batas toolbar. Metode ini mengembalikan FALSE jika tombol toolbar mengacu pada tombol Kustomisasi . Untuk informasi selengkapnya tentang tombol Kustomisasi , lihat CMFCToolBar::GetCustomizeButton.

Panggil metode CMFCToolBarButton::IsLastInGroup untuk menentukan apakah tombol berada di posisi terakhir dalam grup tombolnya.

CMFCToolBarButton::IsHidden

Menentukan apakah tombol disembunyikan.

BOOL IsHidden() const;

Tampilkan Nilai

Bukan nol jika tombol disembunyikan (tidak terlihat); jika tidak, 0.

Keterangan

Kerangka kerja memanggil metode ini ketika toolbar induk direntangkan untuk menentukan apakah tombol toolbar terlihat.

Jika Anda mengatur tombol agar tidak terlihat dengan menggunakan metode CMFCToolBarButton::SetVisible , gunakan CMFCToolBarButton::IsVisible untuk menentukan apakah tombol toolbar terlihat.

Secara default, semua tombol toolbar terlihat. Gunakan metode CMFCToolBarButton::Show untuk menyembunyikan atau menampilkan tombol toolbar.

CMFCToolBarButton::IsHorizontal

Menentukan apakah tombol terletak pada bilah alat horizontal.

BOOL IsHorizontal() const;

Tampilkan Nilai

Bukan nol jika tombol toolbar terletak di toolbar horizontal; jika tidak, 0.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan tata letak tombol toolbar.

Metode ini mengembalikan m_bHorz anggota data. Nilai default anggota m_bHorz data adalah TRUE; diatur ulang pada setiap panggilan ke metode CMFCToolBarButton::OnDraw .

CMFCToolBarButton::IsLastIngroup

Menentukan apakah tombol berada di posisi terakhir dalam grup tombolnya.

virtual BOOL IsLastInGroup() const;

Tampilkan Nilai

TRUE jika tombol adalah tombol terakhir dalam grup tombolnya; jika tidak FALSE.

Keterangan

Metode ini mendefinisikan grup tombol sebagai sekumpulan tombol tetangga yang diposisikan pada baris yang sama dan dibatasi oleh pemisah atau batas toolbar Metode ini mengembalikan FALSE jika tombol toolbar tidak memiliki toolbar induk atau tombol toolbar mengacu pada tombol Kustomisasi . Untuk informasi selengkapnya tentang tombol Kustomisasi , lihat CMFCToolBar::GetCustomizeButton.

Panggil metode CMFCToolBarButton::IsFirstInGroup untuk menentukan apakah tombol berada di posisi pertama dalam grup tombolnya.

CMFCToolBarButton::IsLocked

Menentukan apakah tombol berada pada toolbar terkunci (tidak dapat disesuaikan).

BOOL IsLocked() const;

Tampilkan Nilai

Bukan nol jika tombol berada di toolbar terkunci; jika tidak, 0.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan apakah pengguna dapat menyesuaikan tombol toolbar dengan menggunakan operasi seret dan letakkan atau edit. Atur atribut terkunci pada toolbar induk dengan menggunakan metode CMFCToolBar::LoadToolBar . Kerangka kerja meneruskan nilai atribut ini ke konstruktor setiap tombol toolbar ( CMFCToolbarButton) yang dimasukkannya ke toolbar induk.

CMFCToolBarButton::IsOwnerOf

Menentukan apakah tombol adalah pemilik handel jendela yang disediakan.

virtual BOOL IsOwnerOf(HWND hwnd);

Parameter

hwnd
[di] Handel jendela.

Tampilkan Nilai

Bukan nol jika tombol adalah pemilik handel jendela yang disediakan; jika tidak, 0.

Keterangan

Metode ini mengembalikan nonzero jika hwnd mengacu pada handel jendela langsung atau merupakan anak dari handel jendela yang terkait dengan tombol . Metode ini mengembalikan 0 jika hwnd adalah NULL.

CMFCToolBarButton::IsVisible

Menentukan apakah tombol toolbar terlihat.

BOOL IsVisible() const;

Tampilkan Nilai

Bukan nol jika tombol toolbar terlihat; jika tidak, 0.

Keterangan

Anda dapat menampilkan atau menyembunyikan tombol toolbar dengan menggunakan metode CMFCToolBarButton::SetVisible . Panggil metode CPane::AdjustSizeImmediate pada toolbar induk setelah Anda memanggil CMFCToolBarButton::SetVisible untuk menghitung ulang tata letak toolbar induk.

CMFCToolBarButton::IsWindowVisible

Menentukan apakah handel jendela yang mendasar tombol terlihat.

virtual BOOL IsWindowVisible();

Tampilkan Nilai

Bukan nol jika handel jendela yang mendasar tombol terlihat; jika tidak, 0.

Keterangan

Metode ini mengembalikan nonzero jika atribut gaya dari handel jendela yang mendasar berisi gaya WS_VISIBLE. Metode ini mengembalikan FALSE jika handel jendela yang mendasar dari tombol adalah NULL.

CMFCToolBarButton::m_bImage

Menentukan apakah gambar ditampilkan pada tombol .

BOOL m_bImage;

Keterangan

Jika anggota data ini diatur ke TRUE, kerangka kerja menampilkan gambar yang terkait dengan tombol toolbar; jika tidak, kerangka kerja tidak menampilkan gambar. Anggota ini memengaruhi nilai pengembalian metode CMFCToolBarButton::m_bImage .

CMFCToolBarButton::m_bText

Menentukan apakah label teks ditampilkan pada tombol.

BOOL m_bText;

Keterangan

Jika anggota data ini diatur ke TRUE, kerangka kerja akan menampilkan label teks tombol toolbar; jika tidak, kerangka kerja tidak menampilkan label teks. Anggota ini memengaruhi nilai pengembalian metode CMFCToolBarButton::m_bText .

CMFCToolBarButton::m_bTextBelow

Menentukan apakah label teks ditampilkan di bawah gambar pada tombol .

BOOL m_bTextBelow;

Keterangan

Jika variabel anggota ini diatur ke TRUE, kerangka kerja menampilkan teks tombol di bawah gambar. Nilai default anggota ini adalah FALSE.

CMFCToolBarButton::m_bUserButton

Menentukan apakah tombol memiliki gambar yang ditentukan pengguna

BOOL m_bUserButton;

Keterangan

Anggota data ini diatur ke TRUE saat tombol memiliki gambar yang ditentukan pengguna yang terkait dengannya.

CMFCToolBarButton::m_bWholeText

Menentukan apakah tombol menampilkan label teks lengkapnya meskipun tidak pas di persegi panjang pembatas.

BOOL m_bWholeText;

Keterangan

Jika anggota data ini diatur ke TRUE, kerangka kerja menampilkan label teks lengkap dengan memperbesar tombol. Jika tidak, kerangka kerja memotong dan menambahkan elipsis ( ...) ke label teks.

CMFCToolBarButton::m_bWrap

Menentukan apakah tombol di samping pemisah akan diletakkan pada baris berikutnya.

BOOL m_bWrap;

Keterangan

Kerangka kerja mengatur anggota data ini ke TRUE ketika tombol toolbar tidak pas pada baris saat ini atau saat Anda menentukan tata letak (misalnya, jumlah tombol toolbar tertentu per baris).

Kerangka kerja menempatkan tombol ini pada baris berikutnya jika anggota data ini diatur ke TRUE dan toolbar ditambatkan secara horizontal atau mengambang.

Nilai default anggota data ini adalah FALSE.

CMFCToolBarButton::m_bWrapText

Menentukan apakah label teks multibaris diaktifkan.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Keterangan

Jika variabel anggota statis ini TRUE, kerangka kerja memungkinkan semua toolbar untuk menampilkan label teks multibaris pada tombol toolbar.

Nilai default anggota data ini adalah FALSE.

CMFCToolBarButton::m_nID

ID perintah tombol.

UINT m_nID;

Keterangan

ID perintah -1 menunjukkan bahwa tombol adalah pemisah. Semua pemisah tombol memiliki gaya TBBS_SEPARATOR. Lihat CMFCToolBarButton::m_nStyle untuk informasi selengkapnya tentang gaya tombol.

CMFCToolBarButton::m_nStyle

Gaya tombol.

UINT m_nStyle;

Keterangan

Lihat Gaya Kontrol Bilah Alat untuk daftar gaya tombol toolbar yang tersedia.

CMFCToolBarButton::m_strText

Label teks tombol.

CString m_strText;

Keterangan

Anggota data ini berisi label teks tombol. Label teks dapat kosong.

CMFCToolBarButton::NotifyCommand

Menentukan apakah tombol memproses pesan WM_COMMAND .

virtual BOOL NotifyCommand(int iNotifyCode);

Parameter

iNotifyCode
[di] Pesan pemberitahuan yang terkait dengan perintah .

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Kerangka kerja memanggil metode ini ketika akan mengirim pesan WM_COMMAND ke jendela induk.

Secara default, metode ini mengembalikan FALSE. Ambil alih metode ini untuk mengembalikan TRUE jika Anda ingin memproses pesan WM_COMMAND atau FALSE untuk menunjukkan bahwa toolbar induk harus menangani pesan.

CMFCToolBarButton::OnAddToCustomizePage

Dipanggil oleh kerangka kerja saat tombol ditambahkan ke kotak dialog Kustomisasi .

virtual void OnAddToCustomizePage();

Keterangan

Implementasi default metode ini tidak melakukan apa pun. Ambil alih metode ini jika Anda ingin melakukan beberapa tindakan saat tombol ditambahkan ke kotak dialog Kustomisasi .

CMFCToolBarButton::OnBeforeDrag

Menentukan apakah tombol dapat diseret.

virtual BOOL OnBeforeDrag() const;

Tampilkan Nilai

TRUE jika tombol dapat diseret; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini sebelum pengguna mulai menyeret tombol.

Implementasi default metode ini mengembalikan TRUE. Ambil alih metode ini untuk mengembalikan FALSE untuk menonaktifkan penyeretan tombol.

CMFCToolBarButton::OnBeforeDrop

Menentukan apakah pengguna dapat menjatuhkan tombol ke toolbar target.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parameter

pTarget
[di] Target operasi seret dan letakkan.

Tampilkan Nilai

TRUE jika tombol dapat dihilangkan ke toolbar target yang disediakan; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini sebelum tombol dihilangkan ke toolbar.

Implementasi default metode ini mengembalikan TRUE. Ambil alih metode ini untuk mengembalikan FALSE untuk menonaktifkan operasi penghilangan pada target yang ditentukan.

CMFCToolBarButton::OnCalculateSize

Dipanggil oleh kerangka kerja untuk menghitung ukuran tombol untuk konteks perangkat dan status docking yang ditentukan.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parameter

pDC
[di] Konteks perangkat yang menampilkan tombol .

sizeDefault
[di] Ukuran default tombol.

bHorz
[di] Status dok toolbar induk. Parameter ini TRUE jika toolbar ditampar secara horizontal atau mengambang, atau FALSE jika toolbar ditampuk secara vertikal.

Tampilkan Nilai

Struktur SIZE yang berisi dimensi tombol, dalam piksel.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan ukuran tombol toolbar untuk konteks perangkat dan status dok yang ditentukan.

Implementasi default mempertimbangkan ukuran teks dan gambar (jika ditampilkan), posisi teks dan gambar (teks di bawah atau di sisi kanan gambar), dan status dok toolbar.

Ambil alih metode ini jika Anda ingin menyediakan ukuran tombol non-standar (misalnya, tombol kotak edit).

CMFCToolBarButton::OnCancelMode

Dipanggil oleh kerangka kerja untuk menangani pesan WM_CANCELMODE .

virtual void OnCancelMode();

Keterangan

Implementasi default metode ini tidak melakukan apa pun. Ambil alih metode ini jika Anda ingin menangani pesan WM_CANCELMODE .

CMFCToolBarButton::OnChangeParentWnd

Dipanggil oleh kerangka kerja saat tombol disisipkan ke toolbar baru.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameter

pWndParent
[di] Jendela induk baru.

Keterangan

Tombol disisipkan ke toolbar, misalnya, ketika pengguna menyeretnya dari satu toolbar ke toolbar lain.

Implementasi default metode ini tidak melakukan apa pun.

CMFCToolBarButton::OnClick

Dipanggil oleh kerangka kerja ketika pengguna mengklik tombol mouse.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

Parameter

pWnd
[di] Jendela induk tombol toolbar.

bDelay
[di] TRUE jika pesan harus ditangani dengan penundaan.

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Kerangka kerja memanggil metode ini ketika pengguna mengklik tombol toolbar.

Implementasi default tidak melakukan apa pun dan mengembalikan FALSE. Ambil alih metode ini untuk mengembalikan nilai bukan nol jika tombol memproses pesan klik.

CMFCToolBarButton::OnClickUp

Dipanggil oleh kerangka kerja ketika pengguna merilis tombol mouse.

virtual BOOL OnClickUp();

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Kerangka kerja memanggil metode ini ketika pengguna merilis tombol toolbar.

Implementasi default tidak melakukan apa pun dan mengembalikan FALSE. Ambil alih metode ini untuk mengembalikan nilai bukan nol jika tombol memproses pesan klik.

CMFCToolBarButton::OnContextHelp

Dipanggil oleh kerangka kerja saat toolbar induk menangani pesan WM_HELPHITTEST.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parameter

pWnd
[di] Jendela induk tombol toolbar.

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Implementasi default metode ini tidak melakukan apa pun dan mengembalikan FALSE. Ambil alih metode ini untuk mengembalikan nilai bukan nol jika tombol memproses pesan bantuan.

Untuk informasi selengkapnya tentang pesan WM_HELPHITTEST, lihat TN028: Dukungan Bantuan Peka Konteks.

CMFCToolBarButton::OnCtlColor

Dipanggil oleh kerangka kerja saat toolbar induk menangani pesan WM_CTLCOLOR.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parameter

pDC
[di] Konteks perangkat yang menampilkan tombol .

nCtlColor
[di] Pemberitahuan warna tertentu.

Tampilkan Nilai

Handel ke objek kuas yang digunakan kerangka kerja untuk melukis latar belakang tombol.

Keterangan

Kerangka kerja memanggil metode ini ketika toolbar induk memproses pesan WM_CTLCOLOR untuk tombol toolbar yang berisi kontrol Windows. Kerangka kerja tidak memanggil metode ini jika tombol toolbar tanpa jendela.

Kerangka kerja memanggil metode ini ketika kerangka kerja toolbar berada dalam mode kustomisasi dan tombol toolbar tidak terkunci. Untuk informasi selengkapnya tentang mode kustomisasi, lihat CMFCToolBar::SetCustomizeMode. Untuk informasi selengkapnya tentang mengunci tombol toolbar, lihat CMFCToolBarButton::IsLocked.

Implementasi default tidak melakukan apa pun dan mengembalikan NULL.

CMFCToolBarButton::OnCustomizeMenu

Perbolehkan tombol untuk mengubah menu yang disediakan ketika aplikasi menampilkan menu pintasan pada toolbar induk.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parameter

pMenu
[di] Menu yang akan dikustomisasi.

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Implementasi default tidak melakukan apa pun dan mengembalikan FALSE. Ambil alih metode ini dan kembalikan nilai bukan nol jika Anda ingin mengubah konten menu yang disediakan.

CMFCToolBarButton::OnDblClk

Dipanggil oleh kerangka kerja saat toolbar induk menangani pesan WM_LBUTTONDBLCLK .

virtual void OnDblClk(CWnd* pWnd);

Parameter

pWnd
[in] - Jendela induk tombol.

Keterangan

Metode ini dipanggil oleh CMFCToolBar::OnLButtonDblClk metode ketika toolbar induk menangani pesan WM_LBUTTONDBLCLK .

Implementasi default metode ini tidak melakukan apa pun.

CMFCToolBarButton::OnDraw

Dipanggil oleh kerangka kerja untuk menggambar tombol dengan menggunakan gaya dan opsi yang ditentukan.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

Parameter

pDC
[di] Konteks perangkat yang menampilkan tombol .

rect
[di] Persegi panjang pembatas tombol.

pImages
[di] Kumpulan gambar toolbar yang terkait dengan tombol .

bHorz
[di] Status dok toolbar induk. Parameter ini TRUE ketika tombol ditampar secara horizontal dan FALSE saat tombol ditampar secara vertikal.

bCustomizeMode
[di] Menentukan apakah toolbar berada dalam mode kustomisasi. Parameter ini TRUE ketika toolbar berada dalam mode kustomisasi dan FALSE ketika toolbar tidak dalam mode kustomisasi.

bHighlight
[di] Menentukan apakah tombol disorot. Parameter ini TRUE ketika tombol disorot dan FALSE ketika tombol tidak disorot.

bDrawBorder
[di] Menentukan apakah tombol harus menampilkan batasnya. Parameter ini TRUE ketika tombol harus menampilkan batas dan FALSE ketika tombol tidak boleh menampilkan batasnya.

bGrayDisabledButtons
[di] Menentukan apakah akan menaungi tombol yang dinonaktifkan atau menggunakan kumpulan gambar yang dinonaktifkan. Parameter ini TRUE ketika tombol yang dinonaktifkan harus berbayang dan FALSE ketika metode ini harus menggunakan koleksi gambar yang dinonaktifkan.

Keterangan

Ambil alih metode ini untuk menyesuaikan gambar tombol bilah alat.

CMFCToolBarButton::OnDrawOnCustomizeList

Dipanggil oleh kerangka kerja untuk menggambar tombol di panel Perintah dari kotak dialog Kustomisasi.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parameter

pDC
[di] Konteks perangkat yang menampilkan tombol .

rect
[di] Persegi panjang pembatas tombol.

bPilih
[di] Menentukan apakah tombol dipilih. Jika parameter ini TRUE, tombol dipilih. Jika parameter ini FALSE, tombol tidak dipilih.

Tampilkan Nilai

Lebar, dalam piksel, tombol pada konteks perangkat yang ditentukan.

Keterangan

Metode ini dipanggil oleh kotak dialog kustomisasi ( tab Perintah ) ketika tombol akan menampilkan dirinya sendiri pada kotak daftar gambar pemilik.

Implementasi default metode ini menampilkan label gambar dan teks tombol jika tersedia. Jika label teks tombol tidak tersedia, metode akan menampilkan teks tipsalat.

Ambil alih metode ini untuk melakukan gambar kustom.

CMFCToolBarButton::OnGetCustomToolTipText

Dipanggil oleh kerangka kerja untuk mengambil teks tipsalat kustom untuk tombol .

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parameter

strToolTip
[out] Objek CString yang menerima teks tipsalat kustom.

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Kerangka kerja memanggil metode ini ketika menampilkan tipsalat untuk tombol toolbar. Jika metode ini mengembalikan FALSE, kerangka kerja menggunakan tipsalat default.

Implementasi default tidak melakukan apa pun dan mengembalikan FALSE. Ambil alih metode ini dan kembalikan nilai bukan nol untuk menyediakan teks tipsalat kustom untuk tombol toolbar.

CMFCToolBarButton::OnGlobalFontsChanged

Dipanggil oleh kerangka kerja ketika font global telah berubah.

virtual void OnGlobalFontsChanged();

Keterangan

Implementasi default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk memperbarui font yang digunakan untuk menampilkan teks tombol.

CMFCToolBarButton::OnMove

Dipanggil oleh kerangka kerja saat toolbar induk bergerak.

virtual void OnMove();

Keterangan

Implementasi default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk memposisikan ulang tombol ketika toolbar induk bergerak.

CMFCToolBarButton::OnShow

Dipanggil oleh kerangka kerja ketika tombol menjadi terlihat atau tidak terlihat.

virtual void OnShow(BOOL bShow);

Parameter

bShow
[di] Menentukan apakah tombol terlihat. Jika parameter ini TRUE, tombol akan terlihat. Jika tidak, tombol tidak terlihat.

Keterangan

Implementasi default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk memperbarui visibilitas tombol.

CMFCToolBarButton::OnSize

Dipanggil oleh kerangka kerja ketika toolbar induk mengubah ukuran atau posisinya dan perubahan ini menyebabkan tombol berubah ukuran.

virtual void OnSize(int iSize);

Parameter

iSize
[di] Lebar baru tombol.

Keterangan

Implementasi default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk mengubah ukuran tombol ketika ukuran atau posisi toolbar induk berubah.

CMFCToolBarButton::OnToolHitTest

Dipanggil oleh kerangka kerja ketika toolbar induk harus menentukan apakah titik berada di persegi panjang pembatas tombol.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Parameter

pWnd
[di] Jendela induk tombol. Bisa NULL.

Pti
[di] Struktur TOOLINFO yang berisi informasi tentang alat dalam kontrol tipsalat.

Tampilkan Nilai

Hasil dari OnMenuButtonToolHitTest apakah tombol dapat mengambil penunjuk ke jendela bingkai induk; jika tidak FALSE.

Keterangan

Metode ini memanggil salah satu metode berikut jika dapat mengonversi jendela induk ke objek bingkai yang valid:

CMFCToolBarButton::OnUpdateToolTip

Dipanggil oleh kerangka kerja saat toolbar induk memperbarui teks tipsalatnya.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parameter

pWndParent
[di] Jendela induk.

iButtonIndex
[di] Indeks berbasis nol tombol dalam kumpulan tombol induk.

wndToolTip
[di] Kontrol yang menampilkan teks tipsalat.

Str
[out] Objek CString yang menerima teks tipsalat yang diperbarui.

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Implementasi default metode ini tidak melakukan apa pun dan mengembalikan FALSE. Ambil alih metode ini untuk mengembalikan nilai bukan nol jika Anda memberikan string teks tipsalat.

CMFCToolBarButton::P repareDrag

Dipanggil oleh kerangka kerja ketika tombol akan melakukan operasi seret dan letakkan.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parameter

srcItem
[di] Objek COleDataSource yang menyimpan informasi status tentang operasi seret dan letakkan.

Tampilkan Nilai

TRUE jika operasi berhasil; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini untuk menyiapkan tombol toolbar untuk menyimpan statusnya di objek yang disediakan COleDataSource . Metode ini menyimpan statusnya dengan menserialisasikan dirinya ke file bersama dan kemudian meneruskan file tersebut ke metode COleDataSource::CacheGlobalData . Untuk informasi selengkapnya tentang serialisasi tombol toolbar, lihat CMFCToolBarButton::Serialize.

Metode ini tidak melakukan apa pun dan mengembalikan TRUE jika tombol tidak dapat disimpan ( metode CMFCToolBarButton::CanBeStored mengembalikan FALSE). Ini mengembalikan FALSE jika terjadi pengecualian selama serialisasi objek.

Untuk informasi selengkapnya tentang operasi seret dan letakkan OLE, lihat Seret dan letakkan OLE.

CMFCToolBarButton::Rect

Mengambil persegi panjang pembatas tombol.

const CRect& Rect() const;

Tampilkan Nilai

Objek CRect yang berisi persegi panjang pembatas tombol.

CMFCToolBarButton::ResetImageToDefault

Mengatur ke nilai default gambar yang terkait dengan tombol .

virtual void ResetImageToDefault();

Keterangan

Metode ini mengambil gambar default dari toolbar induknya dengan menggunakan metode CMFCToolBar::GetDefaultImage . Jika tombol tidak memiliki gambar default terkait, metode ini mengatur label teks tombol sesuai dengan sumber daya stringnya dengan menggunakan metode CStringT::LoadString . Untuk informasi selengkapnya tentang sumber daya string, lihat Bekerja dengan File Sumber Daya.

Metode ini tidak melakukan apa pun jika tombol memiliki gambar yang ditentukan pengguna.

CMFCToolBarButton::SaveBarState

Menyimpan status tombol bilah alat.

virtual void SaveBarState();

Keterangan

Kerangka kerja memanggil metode ini ketika membuat CMFCToolBarButton objek sebagai hasil dari operasi seret dan letakkan.

Implementasi default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk menyimpan status tombol toolbar ke sumber data eksternal.

CMFCToolBarButton::Serialize

Membaca objek ini dari arsip atau menulisnya ke arsip.

virtual void Serialize(CArchive& ar);

Parameter

Ar
[di] Objek CArchive dari mana atau yang akan diserialisasikan.

Keterangan

Metode ini mendukung proses transfer data seperti operasi clipboard atau seret dan letakkan. Ini membaca atau menulis properti tombol seperti ID, label teks, dan ID gambar dari atau ke objek yang disediakan CArchive .

Untuk contoh serialisasi, lihat Serialisasi: Membuat Serialisasi Objek.

CMFCToolBarButton::SetACCData

Mengisi objek yang disediakan CAccessibilityData dengan data aksesibilitas dari tombol toolbar.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parameter

pParent
[di] Jendela induk tombol toolbar.

data
[di] Objek CAccessibilityData yang diisi dengan data aksesibilitas tombol toolbar.

Tampilkan Nilai

Metode ini mengembalikan TRUE.

Keterangan

Ambil alih metode ini untuk mengembalikan FALSE jika tombol toolbar Anda tidak menyediakan data aksesibilitas.

CMFCToolBarButton::SetClipboardFormatName

Mengganti nama format clipboard global.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parameter

lpszName
[di] Nama baru format clipboard global. Tidak boleh NULL.

Keterangan

Metode ini memungkinkan operasi seret dan letakkan terjadi di antara beberapa aplikasi. Setiap aplikasi harus menyediakan nama format clipboard yang sama.

Anda harus memanggil metode ini sebelum kerangka kerja memanggil CMFCToolBarButton::GetClipboardFormat.

CMFCToolBarButton::SetImage

Mengatur indeks gambar tombol.

virtual void SetImage(int iImage);

Parameter

iImage
[di] Indeks gambar dalam kumpulan gambar toolbar.

Keterangan

Jika tombol toolbar adalah pemisah, iImage mengacu pada lebar baru tombol pemisah.

Jika iImage kurang dari nol, metode ini menonaktifkan gambar gambar dan memungkinkan gambar label teks tombol.

CMFCToolBarButton::SetProtectedCommands

Mengatur daftar perintah yang tidak dapat dikustomisasi pengguna.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Parameter

lstCmds
[di] Daftar perintah yang dilindungi.

Keterangan

Gunakan metode CMFCToolBarButton::GetProtectedCommands untuk mengambil daftar perintah yang dilindungi.

CMFCToolBarButton::SetRadio

Dipanggil oleh kerangka kerja ketika tombol mengubah status yang dicentang.

virtual void SetRadio();

Keterangan

Implementasi default metode ini tidak melakukan apa pun. Ambil alih metode ini untuk melakukan tindakan kustom ketika tombol mengubah status yang dicentang.

CMFCToolBarButton::SetRect

Mengatur persegi panjang pembatas tombol.

void SetRect(const CRect rect);

Parameter

rect
[di] Persegi panjang pembatas baru tombol.

Keterangan

Metode ini memanggil metode CMFCToolBarButton::OnMove setelah mengatur persegi panjang pembatas baru.

CMFCToolBarButton::SetStyle

Mengatur gaya tombol.

virtual void SetStyle(UINT nStyle);

Parameter

nStyle
[di] Gaya baru tombol.

Keterangan

Implementasi default mengatur anggota data CMFCToolBarButton::m_nStyle ke nStyle. Ambil alih metode ini jika Anda ingin melakukan pemrosesan tambahan untuk menangani perubahan gaya. Lihat Gaya Kontrol Bilah Alat untuk daftar bendera gaya yang valid.

CMFCToolBarButton::SetVisible

Menentukan apakah tombol terlihat.

void SetVisible(BOOL bShow=TRUE);

Parameter

bShow
[di] Nilai Boolean yang menentukan apakah akan menampilkan atau menyembunyikan tombol. Jika parameter ini TRUE, tombol ditampilkan. Jika parameter FALSE, tombol disembunyikan.

Keterangan

Gunakan fungsi ini untuk menyembunyikan atau menampilkan tombol bilah alat tertentu. Panggil metode CPane::AdjustSizeImmediate setelah Anda memanggil metode ini.

CMFCToolBarButton::Show

Menampilkan atau menyembunyikan tombol.

void Show(BOOL bShow);

Parameter

bShow
[di] Nilai Boolean yang menentukan apakah akan menampilkan atau menyembunyikan tombol. Jika parameter ini TRUE, tombol ditampilkan. Jika parameter FALSE, tombol disembunyikan.

Keterangan

Kerangka kerja memanggil metode ini untuk memperbarui visibilitas tombol toolbar saat toolbar induknya diubah ukurannya. Kerangka kerja memanggil metode ini dengan bShow diatur ke FALSE ketika tombol tidak lagi pas dalam batas toolbar. Kerangka kerja memanggil metode ini dengan bShow diatur ke TRUE ketika setelah mengubah ukuran tombol lagi pas dalam batas toolbar.

Gunakan metode CMFCToolBarButton::SetVisible untuk mengatur visibilitas umum tombol.

Metode ini memanggil metode CMFCToolBarButton::OnShow setelah memperbarui status visibilitas tombol.

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCToolBar
Kelas CMFCToolBarImages

Bagikan melalui

Kelas CMFCToolBarButton

Sintaks

Anggota

Konstruktor Publik

Metode Publik

Anggota Data

Keterangan

Contoh

Hierarki Warisan

Persyaratan

CMFCToolBarButton::CanBeDropped

Parameter

Tampilkan Nilai

Keterangan

CMFCToolBarButton::CanBestored

Tampilkan Nilai

Keterangan

CMFCToolBarButton::CanBeStretched

Tampilkan Nilai

Keterangan

CMFCToolBarButton::CMFCToolBarButton

Parameter

CMFCToolBarButton::CompareWith

Parameter

Tampilkan Nilai

Keterangan

CMFCToolBarButton::CopyFrom

Parameter

Keterangan

CMFCToolBarButton::CreateFromOleData

Parameter

Tampilkan Nilai

Keterangan

CMFCToolBarButton::EnableWindow

Parameter

Keterangan

CMFCToolBarButton::ExportToMenuButton

Parameter

Tampilkan Nilai

Keterangan

CMFCToolBarButton::GetClipboardFormat

Tampilkan Nilai

Keterangan

CMFCToolBarButton::GetHwnd

Tampilkan Nilai

Keterangan

CMFCToolBarButton::GetImage

Tampilkan Nilai

Keterangan

CMFCToolBarButton::GetInvalidateRect

Tampilkan Nilai

Keterangan

CMFCToolBarButton::GetParentWnd

Tampilkan Nilai

CMFCToolBarButton::GetProtectedCommands

Tampilkan Nilai

Keterangan

CMFCToolBarButton::GetTextSize

Tampilkan Nilai

CMFCToolBarButton::HasFocus

Tampilkan Nilai

Keterangan

CMFCToolBarButton::HaveHotBorder

Tampilkan Nilai

Keterangan

CMFCToolBarButton::IsDrawImage

Tampilkan Nilai

Keterangan

CMFCToolBarButton::IsDrawText

Tampilkan Nilai

Keterangan

CMFCToolBarButton::IsDroppedDown

Tampilkan Nilai

Keterangan

CMFCToolBarButton::IsEditable

Tampilkan Nilai

Keterangan

CMFCToolBarButton::IsExtraSize

Tampilkan Nilai