Bagikan melalui


Kelas CMFCToolBarMenuButton

Tombol bilah alat yang berisi menu pop-up. Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.

Sintaks

class CMFCToolBarMenuButton : public CMFCToolBarButton

Anggota

Konstruktor Publik

Nama Deskripsi
CMFCToolBarMenuButton::CMFCToolBarMenuButton Membuat CMFCToolBarMenuButton objek.

Metode Publik

Nama Deskripsi
CMFCToolBarMenuButton::CompareWith Membandingkan instans ini dengan objek yang disediakan CMFCToolBarButton . (Penimpaan CMFCToolBarButton::CompareWith.)
CMFCToolBarMenuButton::CopyFrom Menyalin properti tombol bilah alat lain ke tombol saat ini. (Penimpaan CMFCToolBarButton::CopyFrom.)
CMFCToolBarMenuButton::CreateFromMenu Menginisialisasi menu bilah alat dari handel menu Windows.
CMFCToolBarMenuButton::CreateMenu Membuat menu Windows yang terdiri dari perintah di menu bilah alat. Mengembalikan handel ke menu Windows.
CMFCToolBarMenuButton::CreatePopupMenu Membuat objek menu pop-up ( Kelas CMFCPopupMenu) untuk menampilkan menu toolbar.
CMFCToolBarMenuButton::EnableQuickCustomize
CMFCToolBarMenuButton::GetCommands Memberikan akses baca-saja ke daftar perintah di menu toolbar.
CMFCToolBarMenuButton::GetImageRect Mengambil persegi panjang pembatas untuk gambar tombol.
CMFCToolBarMenuButton::GetPaletteRows Mengembalikan jumlah baris di menu pop-up saat menu berada dalam mode palet.
CMFCToolBarMenuButton::GetPopupMenu Mengembalikan penunjuk ke objek menu pop-up yang terkait dengan tombol .
CMFCToolBarMenuButton::HasButton
CMFCToolBarMenuButton::HaveHotBorder Menentukan apakah batas tombol ditampilkan saat pengguna memilih tombol. (Penimpaan CMFCToolBarButton::HaveHotBorder.)
CMFCToolBarMenuButton::IsBorder
CMFCToolBarMenuButton::IsClickedOnMenu
CMFCToolBarMenuButton::IsDroppedDown Menentukan apakah menu pop-up ditampilkan.
CMFCToolBarMenuButton::IsEmptyMenuAllowed Dipanggil oleh kerangka kerja untuk menentukan apakah pengguna dapat membuka submenu dari item menu yang dipilih.
CMFCToolBarMenuButton::IsExclusive Menentukan apakah tombol berada dalam mode eksklusif, yaitu, apakah menu pop-up tetap terbuka bahkan ketika pengguna memindahkan penunjuk ke toolbar atau tombol lain.
CMFCToolBarMenuButton::IsMenuPaletteMode Menentukan apakah menu pop-up berada dalam mode palet.
CMFCToolBarMenuButton::IsQuickMode
CMFCToolBarMenuButton::IsTearOffMenu Menentukan apakah menu pop-up memiliki bilah robek.
CMFCToolBarMenuButton::OnAfterCreatePopupMenu
CMFCToolBarMenuButton::OnBeforeDrag Menentukan apakah tombol dapat diseret. (Penimpaan CMFCToolBarButton::OnBeforeDrag.)
CMFCToolBarMenuButton::OnCalculateSize Dipanggil oleh kerangka kerja untuk menghitung ukuran tombol untuk konteks perangkat dan status docking yang ditentukan. (Penimpaan CMFCToolBarButton::OnCalculateSize.)
CMFCToolBarMenuButton::OnCancelMode Dipanggil oleh kerangka kerja untuk menangani pesan WM_CANCELMODE . (Penimpaan CMFCToolBarButton::OnCancelMode.)
CMFCToolBarMenuButton::OnChangeParentWnd Dipanggil oleh kerangka kerja saat tombol disisipkan ke toolbar baru. (Penimpaan CMFCToolBarButton::OnChangeParentWnd.)
CMFCToolBarMenuButton::OnClick Dipanggil oleh kerangka kerja ketika pengguna mengklik tombol mouse. (Penimpaan CMFCToolBarButton::OnClick.)
CMFCToolBarMenuButton::OnClickMenuItem Dipanggil oleh kerangka kerja saat pengguna memilih item di menu pop-up.
CMFCToolBarMenuButton::OnContextHelp Dipanggil oleh kerangka kerja saat toolbar induk menangani pesan WM_HELPHITTEST. (Penimpaan CMFCToolBarButton::OnContextHelp.)
CMFCToolBarMenuButton::OnDraw Dipanggil oleh kerangka kerja untuk menggambar tombol dengan menggunakan gaya dan opsi yang ditentukan. (Penimpaan CMFCToolBarButton::OnDraw.)
CMFCToolBarMenuButton::OnDrawOnCustomizeList Dipanggil oleh kerangka kerja untuk menggambar tombol di panel Perintah dari kotak dialog Kustomisasi. (Penimpaan CMFCToolBarButton::OnDrawOnCustomizeList.)
CMFCToolBarMenuButton::OpenPopupMenu Dipanggil oleh kerangka kerja saat pengguna membuka menu pop-up.
CMFCToolBarMenuButton::ResetImageToDefault Mengatur ke nilai default gambar yang terkait dengan tombol . (Penimpaan CMFCToolBarButton::ResetImageToDefault.)
CMFCToolBarMenuButton::SaveBarState Menyimpan status tombol bilah alat. (Penimpaan CMFCToolBarButton::SaveBarState.)
CMFCToolBarMenuButton::Serialize Membaca objek ini dari arsip atau menulisnya ke arsip. (Penimpaan CMFCToolBarButton::Serialize.)
CMFCToolBarMenuButton::SetACCData Mengisi objek yang disediakan CAccessibilityData dengan data aksesibilitas dari tombol toolbar. (Penimpaan CMFCToolBarButton::SetACCData.)
CMFCToolBarMenuButton::SetMenuOnly Menentukan apakah tombol dapat ditambahkan ke bilah alat.
CMFCToolBarMenuButton::SetMenuPaletteMode Menentukan apakah menu pop-up berada dalam mode palet.
CMFCToolBarMenuButton::SetMessageWnd
CMFCToolBarMenuButton::SetRadio Memaksa tombol menu bilah alat untuk menampilkan ikon yang menunjukkan bahwa tombol tersebut dipilih.
CMFCToolBarMenuButton::SetTearOff Menentukan ID bilah robek untuk menu pop-up.

Metode yang Dilindungi

Nama Deskripsi
CMFCToolBarMenuButton::D rawDocumentIcon Gambar ikon pada tombol menu.

Anggota Data

Nama Deskripsi
CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw Jika TRUE, kerangka kerja selalu memanggil CFrameWndEx::OnDrawMenuImage saat tombol digambar.

Keterangan

CMFCToolBarMenuButton Dapat muncul sebagai menu, item menu yang memiliki sub-menu, tombol yang menjalankan perintah atau menampilkan menu, atau tombol yang hanya menampilkan menu. Anda menentukan perilaku dan tampilan tombol menu dengan menentukan parameter seperti gambar, teks, handel menu, dan ID perintah yang terkait dengan tombol di konstruktor CMFCToolbarMenuButton::CMFCToolbarMenuButton.

Kelas kustom yang berasal dari CMFCToolbarMenuButton kelas harus menggunakan makro DECLARE_SERIAL . Makro DECLARE_DYNCREATE menghasilkan kesalahan saat aplikasi ditutup.

Contoh

Contoh berikut menunjukkan cara mengonfigurasi CMFCToolBarMenuButton objek. Kode ini menggambarkan cara menentukan bahwa menu drop-down berada dalam mode palet, dan menentukan ID untuk bilah sobek yang dibuat saat pengguna menyeret tombol menu dari bilah menu. Cuplikan kode ini adalah bagian dari sampel Word Pad.

pBorderType->SetMenuPaletteMode(TRUE, 2 /* Rows number */);
pBorderType->SetTearOff(ID_BORDER_TEAROFF);

Hierarki Warisan

CObject

CMFCToolBarButton

CMFCToolBarMenuButton

Persyaratan

Header: afxtoolbarmenubutton.h

CMFCToolBarMenuButton::CMFCToolBarMenuButton

Membuat CMFCToolBarMenuButton objek.

CMFCToolBarMenuButton();
CMFCToolBarMenuButton(const CMFCToolBarMenuButton& src);

CMFCToolBarMenuButton(
    UINT uiID,
    HMENU hMenu,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE);

Parameter

src
[di] Objek yang CMFCToolBarMenuButton ada untuk disalin ke dalam objek ini CMFCToolBarMenuButton .

uiID
[di] ID perintah yang akan dijalankan saat pengguna mengklik tombol; atau (UINT)-1 untuk tombol menu yang tidak langsung menjalankan perintah.

hMenu
[di] Handel ke menu; atau NULL jika tombol tidak memiliki menu.

iImage
[di] Indeks gambar untuk tombol; atau -1 jika tombol ini tidak memiliki ikon atau menggunakan ikon untuk perintah yang ditentukan oleh uiID. Indeks sama untuk setiap CMFCToolBarImages objek dalam aplikasi Anda.

lpszText
[di] Teks tombol menu toolbar.

bUserButton
[di] TRUE jika tombol menampilkan gambar yang ditentukan pengguna; FALSE jika tombol menampilkan gambar yang telah ditentukan sebelumnya yang terkait dengan perintah yang ditentukan oleh uiID.

Keterangan

Jika uiID adalah ID perintah yang valid, tombol melakukan perintah tersebut saat pengguna mengkliknya. Jika hMenu adalah handel menu yang valid, tombol menyediakan menu drop-down saat muncul di toolbar atau submenu saat muncul di menu. Jika uiID dan hMenu valid, tombol adalah tombol terpisah dengan bagian yang akan melakukan perintah ketika pengguna mengkliknya dan bagian dengan panah bawah yang akan menurun menu saat pengguna mengkliknya. Namun, jika hMenu valid, pengguna tidak akan dapat mengklik tombol untuk melakukan perintah saat tombol dimasukkan ke dalam menu.

Contoh

Contoh berikut menunjukkan cara membuat objek CMFCToolBarMenuButton kelas. Cuplikan kode ini adalah bagian dari sampel Word Pad.

CMFCToolBarMenuButton *pBorderType = new CMFCToolBarMenuButton(ID_BORDER_1, pPopup->GetSafeHmenu(),
                                                               GetCmdMgr()->GetCmdImage(ID_BORDER_1, FALSE),
                                                               _T("Borders"));

CMFCToolBarMenuButton::CompareWith

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parameter

[di] lain

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameter

[di] Src

Keterangan

CMFCToolBarMenuButton::CreateFromMenu

Menginisialisasi menu bilah alat dari handel menu Windows.

virtual void CreateFromMenu(HMENU hMenu);

Parameter

hMenu
[di] Handel ke menu.

Keterangan

Tombol menu toolbar dapat menampilkan submenu drop-down.

Kerangka kerja memanggil metode ini untuk menginisialisasi perintah di submenu dari menu.

CMFCToolBarMenuButton::CreateMenu

Membuat menu yang terdiri dari perintah di menu toolbar. Mengembalikan handel ke menu.

virtual HMENU CreateMenu() const;

Tampilkan Nilai

Handel ke menu jika berhasil. NULL jika daftar perintah yang terkait dengan tombol menu toolbar kosong.

Keterangan

Anda dapat mengambil alih metode ini di kelas turunan untuk menyesuaikan cara menu dihasilkan.

CMFCToolBarMenuButton::CreatePopupMenu

CMFCPopupMenu Membuat objek untuk menampilkan menu bilah alat.

virtual CMFCPopupMenu* CreatePopupMenu();

Tampilkan Nilai

Penunjuk ke CMFCPopupMenu objek yang menampilkan menu drop-down yang terkait dengan tombol menu toolbar.

Keterangan

Metode ini dipanggil oleh kerangka kerja untuk menyiapkan tampilan menu drop-down yang terkait dengan tombol .

Implementasi default hanya membangun dan mengembalikan objek baru CMFCPopupMenu . Ambil alih metode ini jika Anda ingin menggunakan jenis turunan Kelas CMFCPopupMenu atau untuk melakukan inisialisasi tambahan.

CMFCToolBarMenuButton::D rawDocumentIcon

Gambar ikon dokumen pada tombol menu.

void DrawDocumentIcon(
    CDC* pDC,
    const CRect& rectImage,
    HICON hIcon);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rectImage
[di] Koordinat persegi panjang pembatas gambar.

hIcon
[di] Handel ke ikon.

Keterangan

Metode ini mengambil ikon dokumen dan menggambarnya pada tombol menu, di tengah area yang ditentukan oleh rectImage.

CMFCToolBarMenuButton::EnableQuickCustomize

void EnableQuickCustomize();

Keterangan

CMFCToolBarMenuButton::HasButton

virtual BOOL HasButton() const;

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::HaveHotBorder

virtual BOOL HaveHotBorder() const;

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::IsBorder

virtual BOOL IsBorder() const;

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::IsClickedOnMenu

BOOL IsClickedOnMenu() const;

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::IsQuickMode

BOOL IsQuickMode();

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::GetCommands

Memberikan akses baca-saja ke daftar perintah di menu toolbar.

const CObList& GetCommands() const;

Tampilkan Nilai

Referensi const ke objek Kelas CObList, yang berisi kumpulan objek Kelas CMFCToolBarButton.

Keterangan

Tombol menu toolbar dapat menampilkan submenu. Anda dapat memberikan daftar perintah di submenu di konstruktor atau di CMFCToolBarMenuButton::CreateFromMenu sebagai handel ke menu (HMENU). Menu dikonversi ke daftar objek yang berasal dari Kelas CMFCToolBarButton dan disimpan di objek internal CObList . Anda dapat mengakses daftar ini dengan memanggil metode ini.

CMFCToolBarMenuButton::GetImageRect

Mengambil persegi panjang pembatas untuk gambar tombol.

void GetImageRect(CRect& rectImage);

Parameter

rectImage
[out] Referensi ke CRect objek yang menerima koordinat persegi panjang pembatas gambar.

CMFCToolBarMenuButton::GetPaletteRows

Mengembalikan jumlah baris di menu drop-down saat menu berada dalam mode palet.

int GetPaletteRows() const;

Tampilkan Nilai

Jumlah baris dalam palet.

Keterangan

Saat tombol menu diatur ke mode palet, item menu akan muncul di beberapa kolom hanya dengan jumlah baris yang terbatas. Panggil metode ini untuk mendapatkan jumlah baris. Anda dapat mengaktifkan atau menonaktifkan mode palet dan menentukan jumlah baris menggunakan CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::GetPopupMenu

Mengembalikan penunjuk ke objek Kelas CMFCPopupMenu yang mewakili menu drop-down tombol.

CMFCPopupMenu* GetPopupMenu() const;

Tampilkan Nilai

Penunjuk ke objek Kelas CMFCPopupMenu yang dibuat saat kerangka kerja menggambar submenu tombol menu toolbar; NULL jika tidak ada submenu yang ditampilkan.

Keterangan

Saat tombol menu toolbar menampilkan menu drop-down, tombol membuat objek Kelas CMFCPopupMenu untuk mewakili menu. Panggil metode ini untuk mendapatkan penunjuk ke CMFCPopupMenu objek. Anda tidak boleh menyimpan penunjuk yang dikembalikan, karena bersifat sementara dan menjadi tidak valid saat pengguna menutup menu drop-down.

CMFCToolBarMenuButton::IsDroppedDown

Menunjukkan apakah menu pop-up saat ini ditampilkan.

virtual BOOL IsDroppedDown() const;

Tampilkan Nilai

TRUE jika tombol menu toolbar menampilkan submenu-nya; jika tidak FALSE.

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Menentukan apakah item menu menunjukkan submenu kosong.

virtual BOOL IsEmptyMenuAllowed() const;

Tampilkan Nilai

TRUE jika kerangka kerja membuka submenu dari item menu yang saat ini dipilih bahkan ketika submenu kosong; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini ketika pengguna mencoba membuka submenu dari item menu yang saat ini dipilih. Jika submenu kosong dan IsEmptyMenuAllowed mengembalikan FALSE, submenu tidak akan terbuka.

Implementasi default mengembalikan FALSE. Ambil alih metode ini untuk menyesuaikan perilaku ini.

CMFCToolBarMenuButton::IsExclusive

Menunjukkan apakah tombol berada dalam mode eksklusif.

virtual BOOL IsExclusive() const;

Tampilkan Nilai

TRUE jika tombol berfungsi dalam mode eksklusif; jika tidak FALSE.

Keterangan

Saat pengguna membuka menu popup untuk tombol lalu memindahkan penunjuk mouse ke toolbar atau tombol menu lain, menu popup ditutup kecuali tombol berada dalam mode eksklusif.

Implementasi default selalu mengembalikan FALSE. Ambil alih metode ini di kelas turunan jika Anda ingin mengaktifkan mode eksklusif.

CMFCToolBarMenuButton::IsMenuPaletteMode

Menentukan apakah menu drop-down berada dalam mode palet.

BOOL IsMenuPaletteMode() const;

Tampilkan Nilai

TRUE jika mode palet diaktifkan, jika tidak FALSE.

Keterangan

Saat tombol menu diatur ke mode palet, item menu muncul di beberapa kolom hanya dengan jumlah baris yang terbatas. Panggil metode ini untuk mendapatkan jumlah baris. Anda dapat mengaktifkan atau menonaktifkan mode palet dengan memanggil CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::IsTearOffMenu

Menunjukkan apakah menu drop-down memiliki bilah robek.

virtual BOOL IsTearOffMenu() const;

Tampilkan Nilai

TRUE jika tombol menu toolbar memiliki bilah robek; jika tidak FALSE.

Keterangan

Untuk mengaktifkan fitur tear-off dan mengatur ID bilah sobek, panggil CMFCToolBarMenuButton::SetTearOff.

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Menentukan apakah kerangka kerja selalu memanggil CFrameWndEx::OnDrawMenuImage saat tombol digambar.

static BOOL m_bAlwaysCallOwnerDraw;

Keterangan

Ketika variabel anggota ini diatur ke TRUE, tombol selalu memanggil metode CFrameWndEx::OnDrawMenuImage untuk menampilkan gambar pada tombol. Ketika m_bAlwaysCallOwnerDraw FALSE, tombol itu sendiri menggambar gambar jika gambar telah ditentukan sebelumnya. Jika tidak, ia memanggil OnDrawMenuImage.

CMFCToolBarMenuButton::OnAfterCreatePopupMenu

virtual void OnAfterCreatePopupMenu();

Keterangan

CMFCToolBarMenuButton::OnBeforeDrag

virtual BOOL OnBeforeDrag() const;

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::OnCalculateSize

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

Parameter

[di] pDC
[di] sizeDefault
[di] bHorz

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::OnCancelMode

virtual void OnCancelMode();

Keterangan

CMFCToolBarMenuButton::OnChangeParentWnd

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameter

[di] pWndParent

Keterangan

CMFCToolBarMenuButton::OnClick

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

Parameter

[di] pWnd
[di] bDelay

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::OnClickMenuItem

Dipanggil oleh kerangka kerja saat pengguna memilih item di menu drop-down.

virtual BOOL OnClickMenuItem();

Tampilkan Nilai

FALSE jika kerangka kerja harus melanjutkan pemrosesan item menu default; jika tidak, TRUE. Implementasi default selalu mengembalikan FALSE.

Keterangan

Saat pengguna mengklik item menu, kerangka kerja menjalankan perintah yang terkait dengan item tersebut.

Untuk menyesuaikan pemrosesan item menu, ambil alih OnClickMenuItem di kelas yang berasal dari CMFCToolBarMenuButton kelas. Anda juga harus mengganti CFrameWndEx::OnShowPopupMenu dan mengganti tombol menu yang memerlukan pemrosesan khusus dengan instans kelas turunan.

CMFCToolBarMenuButton::OnContextHelp

virtual BOOL OnContextHelp(CWnd* pWnd);

Parameter

[di] pWnd

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::OnDraw

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

[di] pDC
[di] rect
[di] pImages
[di] bHorz
[di] bCustomizeMode
[di] bHighlight
[di] bDrawBorder
[di] bGrayDisabledButtons

Keterangan

CMFCToolBarMenuButton::OnDrawOnCustomizeList

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

Parameter

[di] pDC
[di] rect
[di] bPilih

Tampilkan Nilai

Keterangan

CMFCToolBarMenuButton::OpenPopupMenu

Dipanggil oleh kerangka kerja saat pengguna membuka menu drop-down tombol menu toolbar.

virtual BOOL OpenPopupMenu(CWnd* pWnd=NULL);

Parameter

pWnd
[di] Menentukan jendela yang menerima perintah menu drop-down. Ini bisa NULL hanya jika tombol menu toolbar memiliki jendela induk.

Tampilkan Nilai

TRUE ketika objek Kelas CMFCPopupMenu dibuat dan berhasil dibuka; jika tidak FALSE.

Keterangan

Fungsi ini dipanggil oleh kerangka kerja saat pengguna membuka menu drop-down dari tombol menu toolbar.

CMFCToolBarMenuButton::ResetImageToDefault

virtual void ResetImageToDefault();

Keterangan

CMFCToolBarMenuButton::SaveBarState

virtual void SaveBarState();

Keterangan

Kerangka kerja memanggil metode ini ketika membuat tombol toolbar sebagai hasil dari operasi seret dan letakkan. Metode ini memanggil metode CMFCPopupMenu::SaveState dari menu pop-up tingkat atas, yang menyebabkan tombol induk menu pop-up membuat ulang menunya.

CMFCToolBarMenuButton::Serialize

virtual void Serialize(CArchive& ar);

Parameter

[di] Ar

Keterangan

CMFCToolBarMenuButton::SetACCData

Mengatur data aksesibilitas untuk elemen pita.

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

Parameter

pParent
Jendela induk untuk elemen pita.

data
Data aksesibilitas untuk elemen pita.

Tampilkan Nilai

Selalu mengembalikan TRUE.

Keterangan

Secara default metode ini mengatur data aksesibilitas untuk elemen pita dan selalu mengembalikan TRUE. Ambil alih metode ini untuk mengatur data aksesibilitas dan mengembalikan nilai yang menunjukkan keberhasilan atau kegagalan.

CMFCToolBarMenuButton::SetMenuOnly

Menentukan apakah tombol digambar sebagai tombol menu atau tombol pisahkan saat memiliki ID perintah dan submenu yang valid.

void SetMenuOnly(BOOL bMenuOnly);

Parameter

bMenuOnly
[di] TRUE untuk menampilkan tombol ini sebagai tombol menu ketika memiliki ID perintah yang valid dan submenu, FALSE untuk menampilkan tombol ini sebagai tombol terpisah ketika memiliki ID perintah yang valid dan submenu.

Keterangan

Biasanya, ketika tombol menu toolbar memiliki submenu dan ID perintah, menu tampaknya menjadi tombol terpisah yang memiliki tombol utama dan tombol panah bawah yang dilampirkan. Jika Anda memanggil metode ini dan bMenuOnly adalah TRUE, tombol sebagai gantinya tampaknya menjadi tombol menu tunggal dengan panah bawah di tombol . Ketika pengguna mengklik panah dalam salah satu mode, submenu terbuka, dan ketika pengguna mengklik bagian non-panah tombol dalam salah satu mode kerangka kerja menjalankan perintah .

CMFCToolBarMenuButton::SetMenuPaletteMode

Menentukan apakah menu drop-down berada dalam mode palet.

void SetMenuPaletteMode(
    BOOL bMenuPaletteMode=TRUE,
    int nPaletteRows=1);

Parameter

bMenuPaletteMode
[di] Menentukan apakah menu drop-down berada dalam mode palet.

nPaletteRows
[di] Jumlah baris dalam palet.

Keterangan

Dalam mode palet, semua item menu ditampilkan sebagai palet multikolom. Anda menentukan jumlah baris dengan menggunakan nPaletteRows.

CMFCToolBarMenuButton::SetMessageWnd

void SetMessageWnd(CWnd* pWndMessage);

Parameter

[di] pWndMessage

Keterangan

CMFCToolBarMenuButton::SetRadio

Mengatur tombol menu bilah alat untuk menampilkan ikon gaya tombol radio saat dicentang.

virtual void SetRadio();

Keterangan

Ketika tombol menu digambar saat dicentang, tombol ini memanggil CMFCVisualManager::OnDrawMenuCheck untuk menggambar ikon tanda centang. Secara default, OnDrawMenuCheck permintaan agar manajer visual saat ini menggambar tanda centang gaya kotak centang pada tombol menu. Setelah Anda memanggil metode ini, manajer visual saat ini akan menggambar tanda centang gaya tombol radio pada tombol menu. Perubahan ini tidak bisa dibatalkan.

Ketika Anda memanggil metode ini dan tombol menu saat ini sedang ditampilkan, metode ini akan di-refresh.

CMFCToolBarMenuButton::SetTearOff

Menentukan ID bilah robek untuk menu drop-down.

virtual void SetTearOff(UINT uiBarID);

Parameter

uiBarID
[di] Menentukan ID bilah robek baru.

Keterangan

Panggil metode ini untuk menentukan ID untuk bilah robek yang dibuat saat pengguna menyeret tombol menu dari bilah menu. Jika parameter uiBarID adalah 0, pengguna tidak dapat merobek tombol menu.

Panggil CWinAppEx::EnableTearOffMenus untuk mengaktifkan fitur menu sobek di aplikasi Anda.

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCToolBarButton
Kelas CMFCToolBar
Kelas CMFCPopupMenu