Kelas CMFCMenuBar
Bilah menu yang mengimplementasikan docking. Untuk detail selengkapnya, lihat kode sumber yang terletak di folder VC\atlmfc\src\mfc dari penginstalan Visual Studio Anda.
Sintaks
class CMFCMenuBar : public CMFCToolbar
Anggota
Metode Publik
| Nama | Deskripsi |
|---|---|
| CMFCMenuBar::AdjustLocations | (Mengambil alih CMFCToolBar::AdjustLocations.) |
| CMFCMenuBar::AllowChangeTextLabels | Menentukan apakah label teks dapat ditampilkan di bawah gambar pada tombol toolbar. (Penimpaan CMFCToolBar::AllowChangeTextLabels.) |
| CMFCMenuBar::AllowShowOnPaneMenu | (Mengambil alih CPane::AllowShowOnPaneMenu.) |
| CMFCMenuBar::CalcFixedLayout | Menghitung ukuran horizontal toolbar. (Penimpaan CMFCToolBar::CalcFixedLayout.) |
| CMFCMenuBar::CalcLayout | (Mengambil alih CMFCToolBar::CalcLayout.) |
| CMFCMenuBar::CalcMaxButtonHeight | Menghitung tinggi maksimum tombol di toolbar. (Penimpaan CMFCToolBar::CalcMaxButtonHeight.) |
| CMFCMenuBar::CanBeClosed | Menentukan apakah pengguna dapat menutup bilah alat. (Penimpaan CMFCToolBar::CanBeClosed.) |
| CMFCMenuBar::CanBeRestored | Menentukan apakah sistem dapat memulihkan bilah alat ke status aslinya setelah penyesuaian. (Penimpaan CMFCToolBar::CanBeRestored.) |
| CMFCMenuBar::Create | Membuat kontrol menu dan melampirkannya ke CMFCMenuBar objek. |
| CMFCMenuBar::CreateEx |
CMFCMenuBar Membuat objek dengan opsi gaya tambahan. |
| CMFCMenuBar::CreateFromMenu | Menginisialisasi CMFCMenuBar objek. Menerima parameter HMENU yang bertindak sebagai templat untuk yang diisi CMFCMenuBar. |
| CMFCMenuBar::EnableHelpCombobox | Mengaktifkan kotak kombo Bantuan yang terletak di sisi kanan bilah menu. |
| CMFCMenuBar::EnableMenuShadows | Menentukan apakah akan menampilkan bayangan untuk menu pop-up. |
| CMFCMenuBar::GetAvailableExpandSize | (Penimpaan CPane::GetAvailableExpandSize.) |
| CMFCMenuBar::GetColumnWidth | Mengembalikan lebar tombol toolbar. (Penimpaan CMFCToolBar::GetColumnWidth.) |
| CMFCMenuBar::GetDefaultMenu | Mengembalikan handel ke menu asli dalam file sumber daya. |
| CMFCMenuBar::GetDefaultMenuResId | Mengembalikan pengidentifikasi sumber daya untuk menu asli dalam file sumber daya. |
| CMFCMenuBar::GetFloatPopupDirection | |
| CMFCMenuBar::GetForceDownArrows | |
| CMFCMenuBar::GetHelpCombobox | Mengembalikan penunjuk ke kotak kombo Bantuan . |
| CMFCMenuBar::GetHMenu | Mengembalikan handel ke menu yang dilampirkan ke CMFCMenuBar objek. |
| CMFCMenuBar::GetMenuFont | Mengembalikan font global saat ini untuk objek menu. |
| CMFCMenuBar::GetMenuItem | Mengembalikan tombol toolbar yang terkait dengan indeks item yang disediakan. |
| CMFCMenuBar::GetRowHeight | Mengembalikan tinggi tombol toolbar. (Penimpaan CMFCToolBar::GetRowHeight.) |
| CMFCMenuBar::GetSystemButton | |
| CMFCMenuBar::GetSystemButtonsCount | |
| CMFCMenuBar::GetSystemMenu | |
| CMFCMenuBar::HighlightDisabledItems | Menunjukkan apakah item menu yang dinonaktifkan disorot. |
| CMFCMenuBar::IsButtonExtraSizeAvailable | Menentukan apakah bilah alat dapat menampilkan tombol yang memiliki batas yang diperluas. (Penimpaan CMFCToolBar::IsButtonExtraSizeAvailable.) |
| CMFCMenuBar::IsHighlightDisabledItems | Menunjukkan apakah item yang dinonaktifkan disorot. |
| CMFCMenuBar::IsMenuShadows | Menunjukkan apakah bayangan digambar untuk menu pop-up. |
| CMFCMenuBar::IsRecentlyUsedMenus | Menunjukkan apakah perintah menu yang baru saja digunakan ditampilkan pada bilah menu. |
| CMFCMenuBar::IsShowAllCommands | Menunjukkan apakah menu pop-up menampilkan semua perintah. |
| CMFCMenuBar::IsShowAllCommandsDelay | Menunjukkan apakah menu menampilkan semua perintah setelah penundaan singkat. |
| CMFCMenuBar::LoadState | Memuat status CMFCMenuBar objek dari registri. |
| CMFCMenuBar::OnChangeHot | Dipanggil oleh kerangka kerja saat pengguna memilih tombol pada toolbar. (Penimpaan CMFCToolBar::OnChangeHot.) |
| CMFCMenuBar::OnDefaultMenuLoaded | Dipanggil oleh kerangka kerja saat jendela bingkai memuat menu default dari file sumber daya. |
| CMFCMenuBar::OnSendCommand | (Mengambil alih CMFCToolBar::OnSendCommand.) |
| CMFCMenuBar::OnSetDefaultButtonText | Dipanggil oleh kerangka kerja saat menu berada dalam mode kustomisasi dan pengguna mengubah teks item menu. |
| CMFCMenuBar::OnToolHitTest | (Mengambil alih CMFCToolBar::OnToolHitTest.) |
| CMFCMenuBar::P reTranslateMessage | (Mengambil alih CMFCToolBar::PreTranslateMessage.) |
| CMFCMenuBar::RestoreOriginalstate | Dipanggil oleh kerangka kerja saat menu berada dalam mode kustomisasi dan pengguna memilih Reset untuk bilah menu. |
| CMFCMenuBar::SaveState | Menyimpan status CMFCMenuBar objek ke registri. |
| CMFCMenuBar::SetDefaultMenuResId | Mengatur menu asli dalam file sumber daya. |
| CMFCMenuBar::SetForceDownArrows | |
| CMFCMenuBar::SetMaximizeMode | Dipanggil oleh kerangka kerja ketika jendela anak MDI mengubah mode tampilannya. Jika jendela anak MDI baru dimaksimalkan atau tidak lagi dimaksimalkan, metode ini memperbarui bilah menu. |
| CMFCMenuBar::SetMenuButtonRTC | Mengatur informasi kelas runtime yang dihasilkan saat pengguna membuat tombol menu secara dinamis. |
| CMFCMenuBar::SetMenuFont | Mengatur font untuk semua menu dalam aplikasi. |
| CMFCMenuBar::SetRecentlyUsedMenus | Menentukan apakah bilah menu menampilkan perintah menu yang baru-baru ini digunakan. |
| CMFCMenuBar::SetShowAllCommands | Menentukan apakah bilah menu menampilkan semua perintah. |
Keterangan
Kelas CMFCMenuBar adalah bilah menu yang mengimplementasikan fungsionalitas docking. Ini menyerupai toolbar, meskipun tidak dapat ditutup - selalu ditampilkan.
CMFCMenuBar mendukung opsi menampilkan objek item menu yang baru digunakan. Jika opsi ini diaktifkan, CMFCMenuBar hanya menampilkan subset perintah yang tersedia pada tampilan pertama. Setelah itu, perintah yang baru-baru ini digunakan ditampilkan bersama dengan subset perintah asli. Selain itu, pengguna selalu dapat memperluas menu untuk melihat semua perintah yang tersedia. Dengan demikian, setiap perintah yang tersedia dikonfigurasi untuk ditampilkan terus-menerus, atau ditampilkan hanya jika baru-baru ini dipilih.
Untuk menggunakan CMFCMenuBar objek, sematkan di objek bingkai jendela utama. Saat memproses WM_CREATE pesan, panggil CMFCMenuBar::Create atau CMFCMenuBar::CreateEx. Terlepas dari fungsi buat mana yang Anda gunakan, teruskan penunjuk ke jendela bingkai utama. Kemudian aktifkan docking dengan memanggil CFrameWndEx::EnableDocking. Dock menu ini dengan memanggil CFrameWndEx::D ockPane.
Contoh
Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCMenuBar kelas . Contoh memperlihatkan cara mengatur gaya panel, mengaktifkan tombol kustomisasi, mengaktifkan kotak Bantuan, mengaktifkan bayangan untuk menu pop-up, dan memperbarui bilah menu. Cuplikan kode ini adalah bagian dari sampel Demo IE.
CMFCMenuBar m_wndMenuBar;
m_wndMenuBar.SetPaneStyle(m_wndMenuBar.GetPaneStyle() | CBRS_SIZE_DYNAMIC);
m_wndMenuBar.EnableCustomizeButton(TRUE, -1, _T(""));
// first parameter is the command ID for the button of the Help combo box
// third parameter is the width of the button for the combo box in pixels.
m_wndMenuBar.EnableHelpCombobox(1, _T("enter text here"), 30);
m_wndMenuBar.EnableMenuShadows();
m_wndMenuBar.SetMaximizeMode(true);
Hierarki Warisan
CMFCMenuBar
Persyaratan
Header: afxmenubar.h
CMFCMenuBar::AdjustLocations
Menyesuaikan posisi item menu pada bilah menu.
virtual void AdjustLocations();
Keterangan
CMFCMenuBar::AllowChangeTextLabels
Menentukan apakah label teks diizinkan di bawah gambar di bilah menu.
virtual BOOL AllowChangeTextLabels() const;
Tampilkan Nilai
Mengembalikan TRUE jika pengguna dapat memilih untuk menampilkan label teks di bawah gambar.
Keterangan
CMFCMenuBar::AllowShowOnPaneMenu
virtual BOOL AllowShowOnPaneMenu() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::CalcFixedLayout
virtual CSize CalcFixedLayout(
BOOL bStretch,
BOOL bHorz);
Parameter
[di] bStretch
[di] bHorz
Tampilkan Nilai
Keterangan
CMFCMenuBar::CalcLayout
virtual CSize CalcLayout(
DWORD dwMode,
int nLength = -1);
Parameter
[di] dwMode
[di] nLength
Tampilkan Nilai
Keterangan
CMFCMenuBar::CalcMaxButtonHeight
virtual int CalcMaxButtonHeight();
Tampilkan Nilai
Keterangan
CMFCMenuBar::CanBeClosed
virtual BOOL CanBeClosed() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::CanBeRestored
virtual BOOL CanBeRestored() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::Create
Membuat kontrol menu dan melampirkannya ke objek CMFCMenuBar .
virtual BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle = AFX_DEFAULT_TOOLBAR_STYLE,
UINT nID = AFX_IDW_MENUBAR);
Parameter
pParentWnd
[di] Penunjuk ke jendela induk untuk objek baru CMFCMenuBar .
dwStyle
[di] Gaya bilah menu baru.
Nid
[di] ID untuk jendela anak dari bilah menu.
Tampilkan Nilai
TRUE jika berhasil; jika tidak FALSE.
Keterangan
Setelah membuat CMFCMenuBar objek, Anda harus memanggil Create. Metode ini membuat CMFCMenuBar kontrol dan melampirkannya ke CMFCMenuBar objek.
Untuk informasi selengkapnya tentang gaya toolbar, lihat CBasePane::SetPaneStyle.
CMFCMenuBar::CreateEx
Membuat objek CMFCMenuBar dengan gaya yang diperluas yang ditentukan.
virtual BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwCtrlStyle = TBSTYLE_FLAT,
DWORD dwStyle = AFX_DEFAULT_TOOLBAR_STYLE,
CRect rcBorders = CRect(1,
1,
1,
1),
UINT nID =AFX_IDW_MENUBAR);
Parameter
pParentWnd
[di] Penunjuk ke jendela induk objek baru CMFCMenuBar .
dwCtrlStyle
[di] Gaya tambahan untuk bilah menu baru.
dwStyle
[di] Gaya utama bilah menu baru.
rcBorders
[di] Parameter CRect yang menentukan ukuran untuk batas CMFCMenuBar objek.
Nid
[di] ID untuk jendela anak dari bilah menu.
Tampilkan Nilai
Bukan nol jika metode berhasil; jika tidak, 0.
Keterangan
Anda harus menggunakan fungsi ini alih-alih CMFCMenuBar::Buat saat Anda ingin menentukan gaya selain gaya toolbar. Beberapa gaya tambahan yang sering digunakan adalah TBSTYLE_TRANSPARENT dan CBRS_TOP.
Untuk daftar gaya tambahan, lihat Kontrol Toolbar dan Gaya Tombol, gaya kontrol umum, dan gaya jendela umum.
Contoh
Contoh berikut menunjukkan cara menggunakan CreateEx metode CMFCMenuBar kelas. Cuplikan kode ini adalah bagian dari sampel Demo IE.
CMFCMenuBar m_wndMenuBar;
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndMenuBar.CreateEx(this, TBSTYLE_TRANSPARENT))
{
TRACE0("Failed to create menubar\n");
return -1; // fail to create
}
CMFCMenuBar::CreateFromMenu
Menginisialisasi objek CMFCMenuBar . Metode ini memodelkan CMFCMenuBar objek setelah parameter HMENU.
virtual void CreateFromMenu(
HMENU hMenu,
BOOL bDefaultMenu = FALSE,
BOOL bForceUpdate = FALSE);
Parameter
hMenu
[di] Handel ke sumber daya menu.
CreateFromMenu menggunakan sumber daya ini sebagai templat untuk CMFCMenuBar.
bDefaultMenu
[di] Boolean yang menunjukkan apakah menu baru adalah menu default.
bForceUpdate
[di] Boolean yang menunjukkan apakah metode ini memaksa pembaruan menu.
Keterangan
Gunakan metode ini jika Anda ingin kontrol menu memiliki item menu yang sama dengan sumber daya menu. Anda memanggil metode ini setelah Anda memanggil CMFCMenuBar::Create atau CMFCMenuBar::CreateEx.
CMFCMenuBar::EnableHelpCombobox
Mengaktifkan kotak kombo Bantuan yang terletak di sisi kanan bilah menu.
void EnableHelpCombobox(
UINT uiID,
LPCTSTR lpszPrompt = NULL,
int nComboBoxWidth = 150);
Parameter
uiID
[di] ID perintah untuk tombol kotak kombo Bantuan .
lpszPrompt
[di] String yang berisi teks yang ditampilkan kerangka kerja dalam kotak kombo jika kosong dan tidak aktif. Misalnya, "Masukkan teks di sini".
nComboBoxWidth
[di] Lebar tombol untuk kotak kombo dalam piksel.
Keterangan
Kotak kombo Bantuan menyerupkan kotak kombo Bantuan di bilah menu Microsoft Word.
Ketika Anda memanggil metode ini dengan uiID diatur ke 0, metode ini menyembunyikan kotak kombo. Jika tidak, metode ini menampilkan kotak kombo secara otomatis di sisi kanan bilah menu Anda. Setelah Anda memanggil metode ini, panggil CMFCMenuBar::GetHelpCombobox untuk mendapatkan penunjuk ke objek CMFCToolBarComboBoxButton yang disisipkan.
CMFCMenuBar::EnableMenuShadows
Mengaktifkan bayangan untuk menu pop-up.
static void EnableMenuShadows(BOOL bEnable = TRUE);
Parameter
bEnable
[di] Parameter Boolean yang menunjukkan apakah bayangan harus diaktifkan untuk menu pop-up.
Keterangan
Algoritma yang digunakan metode ini rumit dan dapat mengurangi performa aplikasi Anda pada sistem yang lebih lambat.
CMFCMenuBar::GetAvailableExpandSize
virtual int GetAvailableExpandSize() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::GetColumnWidth
virtual int GetColumnWidth() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::GetDefaultMenu
Mengambil handel ke menu asli. Kerangka kerja memuat menu asli dari file sumber daya.
HMENU GetDefaultMenu() const;
Tampilkan Nilai
Handel ke sumber daya menu.
Keterangan
Jika aplikasi Anda menyesuaikan menu, Anda dapat menggunakan metode ini untuk mengambil handel ke menu asli.
CMFCMenuBar::GetDefaultMenuResId
Mengambil pengidentifikasi sumber daya untuk menu default.
UINT GetDefaultMenuResId() const;
Tampilkan Nilai
Pengidentifikasi sumber daya menu.
Keterangan
Kerangka kerja memuat menu default untuk CMFCMenuBar objek dari file sumber daya.
CMFCMenuBar::GetFloatPopupDirection
int GetFloatPopupDirection(CMFCToolBarMenuButton* pButton);
Parameter
[di] pButton
Tampilkan Nilai
Keterangan
CMFCMenuBar::GetForceDownArrows
BOOL GetForceDownArrows();
Tampilkan Nilai
Keterangan
CMFCMenuBar::GetHelpCombobox
Mengembalikan penunjuk ke kotak kombo Bantuan .
CMFCToolBarComboBoxButton* GetHelpCombobox();
Tampilkan Nilai
Penunjuk ke kotak kombo Bantuan . NULL jika kotak kombo Bantuan disembunyikan atau tidak diaktifkan.
Keterangan
Kotak kombo Bantuan terletak di sisi kanan bilah menu. Panggil metode CMFCMenuBar::EnableHelpCombobox untuk mengaktifkan kotak kombo ini.
CMFCMenuBar::GetHMenu
Mengambil handel ke menu yang dilampirkan ke objek CMFCMenuBar .
HMENU GetHMenu() const;
CMFCMenuBar::GetMenuFont
Mengambil font menu saat ini.
static const CFont& GetMenuFont(BOOL bHorz = TRUE);
Parameter
bHorz
[di] Parameter Boolean yang menentukan apakah akan mengembalikan font horizontal atau vertikal. TRUE menunjukkan font horizontal.
Tampilkan Nilai
Penunjuk ke parameter CFont yang berisi font bilah menu saat ini.
Keterangan
Font yang dikembalikan adalah parameter global untuk aplikasi. Dua font global dipertahankan untuk semua CMFCMenuBar objek. Font terpisah ini digunakan untuk bilah menu horizontal dan vertikal.
CMFCMenuBar::GetMenuItem
Mengambil objek CMFCToolBarButton pada bilah menu berdasarkan indeks item.
CMFCToolBarButton* GetMenuItem(int iItem) const;
Parameter
iItem
[di] Indeks item menu yang akan dikembalikan.
Tampilkan Nilai
Penunjuk ke CMFCToolBarButton objek yang cocok dengan indeks yang ditentukan oleh iItem. NULL jika indeks tidak valid.
CMFCMenuBar::GetRowHeight
virtual int GetRowHeight() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::GetSystemButton
CMFCToolBarMenuButtonsButton* GetSystemButton(
UINT uiBtn,
BOOL bByCommand = TRUE) const;
Parameter
[di] uiBtn
[di] bByCommand
Tampilkan Nilai
Keterangan
CMFCMenuBar::GetSystemButtonsCount
int GetSystemButtonsCount() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::GetSystemMenu
CMFCToolBarSystemMenuButton* GetSystemMenu() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::HighlightDisabledItems
Mengontrol apakah kerangka kerja menyoroti item menu yang dinonaktifkan.
static void HighlightDisabledItems(BOOL bHighlight = TRUE);
Parameter
bHighlight
[di] Parameter Boolean yang menunjukkan apakah kerangka kerja menyoroti item menu yang tidak tersedia.
Keterangan
Secara default, kerangka kerja tidak menyoroti item menu yang tidak tersedia saat pengguna memposisikan penunjuk mouse di atasnya.
CMFCMenuBar::IsButtonExtraSizeAvailable
virtual BOOL IsButtonExtraSizeAvailable() const;
Tampilkan Nilai
Keterangan
CMFCMenuBar::IsHighlightDisabledItems
Menunjukkan apakah kerangka kerja menyoroti item menu yang tidak tersedia.
static BOOL IsHighlightDisabledItems();
Tampilkan Nilai
TRUE jika item menu tidak tersedia disorot; jika tidak FALSE.
Keterangan
Secara default, kerangka kerja tidak menyoroti item menu yang tidak tersedia saat pengguna memposisikan penunjuk mouse di atasnya. Gunakan metode CMFCMenuBar::HighlightDisabledItems untuk mengaktifkan fitur ini.
CMFCMenuBar::IsMenuShadows
Menunjukkan apakah kerangka kerja menggambar bayangan untuk menu pop-up.
static BOOL IsMenuShadows();
Tampilkan Nilai
TRUE jika kerangka kerja menggambar bayangan menu; jika tidak FALSE.
Keterangan
Gunakan metode CMFCMenuBar::EnableMenuShadows untuk mengaktifkan atau menonaktifkan fitur ini.
CMFCMenuBar::IsRecentlyUsedMenus
Menunjukkan apakah perintah menu yang baru saja digunakan ditampilkan pada bilah menu.
static BOOL IsRecentlyUsedMenus();
Tampilkan Nilai
Bukan nol jika CMFCMenuBar objek menunjukkan perintah menu yang baru digunakan; jika tidak, 0.
Keterangan
Gunakan fungsi CMFCMenuBar::SetRecentlyUsedMenus untuk mengontrol apakah bilah menu menunjukkan perintah menu yang baru digunakan.
CMFCMenuBar::IsShowAllCommands
Menunjukkan apakah menu menampilkan semua perintah.
static BOOL IsShowAllCommands();
Tampilkan Nilai
Bukan nol jika CMFCMenuBar menampilkan semua perintah; jika tidak, 0.
Keterangan
Objek CMFCMenuBar dapat dikonfigurasi untuk menampilkan semua perintah atau hanya menampilkan subset perintah. Untuk informasi selengkapnya tentang fitur ini, lihat Kelas CMFCMenuBar.
IsShowAllCommands akan memberi tahu Anda bagaimana fitur ini dikonfigurasi untuk CMFCMenuBar objek. Untuk mengontrol perintah menu mana yang ditampilkan, gunakan metode CMFCMenuBar::SetShowAllCommands dan CMFCMenuBar::SetRecentlyUsedMenus.
CMFCMenuBar::IsShowAllCommandsDelay
Menunjukkan apakah objek CMFCMenuBar menampilkan semua perintah setelah penundaan singkat.
static BOOL IsShowAllCommandsDelay();
Tampilkan Nilai
Bukan nol jika bilah menu menampilkan menu lengkap setelah penundaan singkat; jika tidak, 0.
Keterangan
Saat Anda mengonfigurasi bilah menu untuk menampilkan item yang baru digunakan, bilah menu menampilkan menu lengkap dengan salah satu dari dua cara:
Tampilkan menu lengkap setelah penundaan yang diprogram dari saat pengguna mengarahkan kursor ke panah di bagian bawah menu.
Tampilkan menu lengkap setelah pengguna mengklik panah di bagian bawah menu.
Secara default, semua CMFCMenuBar objek menggunakan opsi untuk menampilkan menu lengkap setelah penundaan singkat. Opsi ini tidak dapat diubah secara terprogram di CMFCMenuBar kelas. Namun, pengguna dapat mengubah perilaku selama kustomisasi toolbar dengan menggunakan kotak dialog Kustomisasi.
CMFCMenuBar::LoadState
Memuat status bilah menu dari registri Windows.
virtual BOOL LoadState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT)-1);
Parameter
lpszProfileName
[di] String yang berisi jalur kunci registri Windows.
nIndex
[di] ID kontrol untuk bilah menu.
uiID
[di] Nilai yang dipesan.
Tampilkan Nilai
TRUE jika metode berhasil; jika tidak FALSE.
Keterangan
Gunakan metode CMFCMenuBar::SaveState untuk menyimpan status bilah menu ke registri. Informasi yang disimpan mencakup item menu, status dok, dan posisi bilah menu.
Dalam kebanyakan kasus, aplikasi Anda tidak memanggil LoadState. Kerangka kerja memanggil metode ini ketika menginisialisasi ruang kerja.
CMFCMenuBar::OnChangeHot
virtual void OnChangeHot(int iHot);
Parameter
[di] iHot
Keterangan
CMFCMenuBar::OnDefaultMenuLoaded
Kerangka kerja memanggil metode ini saat memuat sumber daya menu dari file sumber daya.
virtual void OnDefaultMenuLoaded(HMENU hMenu);
Parameter
hMenu
[di] Handel untuk menu yang dilampirkan ke CMFCMenuBar objek.
Keterangan
Implementasi default fungsi ini tidak melakukan apa pun. Ambil alih fungsi ini untuk menjalankan kode kustom setelah kerangka kerja memuat sumber daya menu dari file sumber daya.
CMFCMenuBar::OnSendCommand
virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);
Parameter
[di] pButton
Tampilkan Nilai
Keterangan
CMFCMenuBar::OnSetDefaultButtonText
Kerangka kerja memanggil metode ini ketika pengguna mengubah teks item pada bilah menu.
virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);
Parameter
pButton
[di] Penunjuk ke objek CMFCToolBarButton yang ingin dikustomisasi pengguna.
Tampilkan Nilai
TRUE jika kerangka kerja menerapkan perubahan pengguna ke bilah menu; jika tidak FALSE.
Keterangan
Implementasi default untuk metode ini mengubah teks tombol menjadi teks yang disediakan pengguna.
CMFCMenuBar::OnToolHitTest
virtual INT_PTR OnToolHitTest(
CPoint point,
TOOLINFO* pTI) const;
Parameter
[di] ujung
[di] Pti
Tampilkan Nilai
Keterangan
CMFCMenuBar::P reTranslateMessage
virtual BOOL PreTranslateMessage(MSG* pMsg);
Parameter
[di] pMsg
Tampilkan Nilai
Keterangan
CMFCMenuBar::RestoreOriginalstate
Dipanggil oleh kerangka kerja saat pengguna memilih Reset dari kotak dialog Kustomisasi .
virtual BOOL RestoreOriginalstate();
Tampilkan Nilai
Bukan nol jika metode berhasil; jika tidak, 0.
Keterangan
Metode ini dipanggil ketika pengguna memilih Reset dari menu kustomisasi. Anda juga dapat memanggil metode ini secara manual untuk mengatur ulang status bilah menu secara terprogram. Metode ini memuat status asli dari file sumber daya.
Ambil alih metode ini jika Anda ingin melakukan pemrosesan apa pun saat pengguna memilih opsi Reset .
CMFCMenuBar::SaveState
Menyimpan status objek CMFCMenuBar ke registri Windows.
virtual BOOL SaveState (
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT)-1);
Parameter
lpszProfileName
[di] String yang berisi jalur kunci registri Windows.
nIndex
[di] ID kontrol untuk bilah menu.
uiID
[di] Nilai yang dipesan.
Tampilkan Nilai
TRUE jika berhasil; jika tidak FALSE;
Keterangan
Biasanya, aplikasi Anda tidak memanggil SaveState. Kerangka kerja memanggil metode ini ketika ruang kerja diserialisasikan. Untuk informasi selengkapnya, lihat CWinAppEx::SaveState.
Informasi yang disimpan mencakup item menu, status dok, dan posisi bilah menu.
CMFCMenuBar::SetDefaultMenuResId
Mengatur menu default untuk objek CMFCMenuBar berdasarkan ID sumber daya.
void SetDefaultMenuResId(UINT uiResId);
Parameter
uiResId
[di] ID sumber daya untuk menu default baru.
Keterangan
Metode CMFCMenuBar::RestoreOriginalstate memulihkan menu default dari file sumber daya.
Gunakan metode CMFCMenuBar::GetDefaultMenuResId untuk mengambil menu default tanpa memulihkannya.
CMFCMenuBar::SetForceDownArrows
void SetForceDownArrows(BOOL bValue);
Parameter
[di] bValue
Keterangan
CMFCMenuBar::SetMaximizeMode
Kerangka kerja memanggil metode ini ketika MDI mengubah mode tampilannya dan bilah menu harus diperbarui.
void SetMaximizeMode(
BOOL bMax,
CWnd* pWnd = NULL,
BOOL bRecalcLayout = TRUE);
Parameter
bMax
[di] Boolean yang menentukan mode . Lihat bagian Keterangan untuk informasi lebih lanjut.
pWnd
[di] Penunjuk ke jendela anak MDI yang berubah.
bRecalcLayout
[di] Boolean yang menentukan apakah tata letak bilah menu harus segera dihitung ulang.
Keterangan
Saat jendela anak MDI dimaksimalkan, bilah menu yang dilampirkan ke jendela bingkai utama MDI menampilkan menu sistem dan tombol Minimalkan, Maksimalkan, dan Tutup. Jika bMax TRUE dan pWnd bukan NULL, jendela anak MDI dimaksimalkan dan bilah menu harus menggabungkan kontrol tambahan. Jika tidak, bilah menu kembali ke status regulernya.
CMFCMenuBar::SetMenuButtonRTC
Mengatur informasi kelas runtime yang digunakan kerangka kerja saat pengguna membuat tombol menu.
void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);
Parameter
pMenuButtonRTC
[di] Informasi CRuntimeClass untuk kelas yang berasal dari Kelas CMFCMenuButton.
Keterangan
Saat pengguna menambahkan tombol baru ke bilah menu, kerangka kerja membuat tombol secara dinamis. Secara default, ini membuat CMFCMenuButton objek. Ambil alih metode ini untuk mengubah jenis objek tombol yang dibuat kerangka kerja.
CMFCMenuBar::SetMenuFont
Mengatur font untuk semua bilah menu di aplikasi Anda.
static BOOL SetMenuFont(
LPLOGFONT lpLogFont,
BOOL bHorz = TRUE);
Parameter
lpLogFont
[di] Penunjuk ke struktur LOGFONT yang menentukan font yang akan diatur.
bHorz
[di] TRUE jika Anda ingin parameter lpLogFont digunakan untuk font vertikal, FALSE jika Anda ingin digunakan untuk font horizontal.
Tampilkan Nilai
TRUE jika metode berhasil; jika tidak FALSE.
Keterangan
Dua font digunakan untuk semua CMFCMenuBar objek. Font terpisah ini digunakan untuk bilah menu horizontal dan vertikal.
Pengaturan font adalah variabel global dan memengaruhi semua CMFCMenuBar objek.
CMFCMenuBar::SetRecentlyUsedMenus
Mengontrol apakah bilah menu menampilkan perintah menu yang baru digunakan.
static void SetRecentlyUsedMenus (BOOL bOn = TRUE);
Parameter
Bon
[di] Boolean yang mengontrol apakah perintah menu yang baru digunakan ditampilkan.
CMFCMenuBar::SetShowAllCommands
Mengontrol apakah menu menampilkan semua perintah yang tersedia.
static void SetShowAllCommands(BOOL bShowAllCommands = TRUE);
Parameter
bShowAllCommands
[di] Parameter Boolean yang menentukan apakah menu pop-up menampilkan semua perintah menu.
Keterangan
Jika menu tidak menampilkan semua perintah menu, menu akan menyembunyikan perintah yang jarang digunakan. Untuk informasi selengkapnya tentang menampilkan perintah menu, lihat Kelas CMFCMenuBar.