Klasa CMFCMenuBar

Pasek menu, który implementuje dokowanie. Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Składnia

class CMFCMenuBar : public CMFCToolbar

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko	opis
CMFCMenuBar::AdjustLocations	(Przesłania CMFCToolBar::AdjustLocations).
CMFCMenuBar::AllowChangeTextLabels	Określa, czy etykiety tekstowe mogą być wyświetlane na obrazach na przyciskach paska narzędzi. (Przesłonięcia) CMFCToolBar::AllowChangeTextLabels).
CMFCMenuBar::AllowShowOnPaneMenu	(Przesłania CPane::AllowShowOnPaneMenu).
CMFCMenuBar::CalcFixedLayout	Oblicza rozmiar poziomy paska narzędzi. (Przesłonięcia) CMFCToolBar::CalcFixedLayout).
CMFCMenuBar::CalcLayout	(Przesłania CMFCToolBar::CalcLayout).
CMFCMenuBar::CalcMaxButtonHeight	Oblicza maksymalną wysokość przycisków na pasku narzędzi. (Przesłonięcia) CMFCToolBar::CalcMaxButtonHeight.)
CMFCMenuBar::CanBeClosed	Określa, czy użytkownik może zamknąć pasek narzędzi. (Przesłonięcia) CMFCToolBar::CanBeClosed.)
CMFCMenuBar::CanBeRestored	Określa, czy system może przywrócić pasek narzędzi do pierwotnego stanu po dostosowaniu. (Przesłonięcia) CMFCToolBar::CanBeRestored.)
CMFCMenuBar::Create	Tworzy kontrolkę menu i dołącza ją do CMFCMenuBar obiektu.
CMFCMenuBar::CreateEx	Tworzy CMFCMenuBar obiekt z dodatkowymi opcjami stylu.
CMFCMenuBar::CreateFromMenu	Inicjuje CMFCMenuBar obiekt. Akceptuje parametr HMENU, który działa jako szablon dla wypełnionego CMFCMenuBarelementu .
CMFCMenuBar::EnableHelpCombobox	Włącza pole kombi Pomoc, które znajduje się po prawej stronie paska menu.
CMFCMenuBar::EnableMenuShadows	Określa, czy mają być wyświetlane cienie dla wyskakujących menu.
CMFCMenuBar::GetAvailableExpandSize	(Przesłonięcia) CPane::GetAvailableExpandSize.)
CMFCMenuBar::GetColumnWidth	Zwraca szerokość przycisków paska narzędzi. (Przesłonięcia) CMFCToolBar::GetColumnWidth.
CMFCMenuBar::GetDefaultMenu	Zwraca uchwyt do oryginalnego menu w pliku zasobu.
CMFCMenuBar::GetDefaultMenuResId	Zwraca identyfikator zasobu oryginalnego menu w pliku zasobu.
CMFCMenuBar::GetFloatPopupDirection
CMFCMenuBar::GetForceDownArrows
CMFCMenuBar::GetHelpCombobox	Zwraca wskaźnik do pola kombi Pomoc .
CMFCMenuBar::GetHMenu	Zwraca uchwyt do menu dołączonego CMFCMenuBar do obiektu.
CMFCMenuBar::GetMenuFont	Zwraca bieżącą czcionkę globalną dla obiektów menu.
CMFCMenuBar::GetMenuItem	Zwraca przycisk paska narzędzi skojarzony z podanym indeksem elementów.
CMFCMenuBar::GetRowHeight	Zwraca wysokość przycisków paska narzędzi. (Przesłonięcia) CMFCToolBar::GetRowHeight.)
CMFCMenuBar::GetSystemButton
CMFCMenuBar::GetSystemButtonsCount
CMFCMenuBar::GetSystemMenu
CMFCMenuBar::HighlightDisabledItems	Wskazuje, czy wyłączone elementy menu są wyróżnione.
CMFCMenuBar::IsButtonExtraSizeAvailable	Określa, czy pasek narzędzi może wyświetlać przyciski, które mają rozszerzone obramowania. (Przesłonięcia) CMFCToolBar::IsButtonExtraSizeAvailable.)
CMFCMenuBar::IsHighlightDisabledItems	Wskazuje, czy wyłączone elementy są wyróżnione.
CMFCMenuBar::IsMenuShadows	Wskazuje, czy cienie są rysowane dla wyskakujących menu.
CMFCMenuBar::IsRecentlyUsedMenus	Wskazuje, czy na pasku menu są wyświetlane ostatnio używane polecenia menu.
CMFCMenuBar::IsShowAllCommands	Wskazuje, czy menu podręczne wyświetlają wszystkie polecenia.
CMFCMenuBar::IsShowAllCommandsDelay	Wskazuje, czy menu wyświetlają wszystkie polecenia po krótkim opóźnieniu.
CMFCMenuBar::LoadState	Ładuje stan CMFCMenuBar obiektu z rejestru.
CMFCMenuBar::OnChangeHot	Wywoływana przez platformę, gdy użytkownik wybierze przycisk na pasku narzędzi. (Przesłonięcia) CMFCToolBar::OnChangeHot).
CMFCMenuBar::OnDefaultMenuLoaded	Wywoływana przez platformę, gdy okno ramki ładuje menu domyślne z pliku zasobu.
CMFCMenuBar::OnSendCommand	(Przesłania CMFCToolBar::OnSendCommand).
CMFCMenuBar::OnSetDefaultButtonText	Wywoływana przez platformę, gdy menu jest w trybie dostosowywania, a użytkownik zmienia tekst elementu menu.
CMFCMenuBar::OnToolHitTest	(Przesłania CMFCToolBar::OnToolHitTest).
CMFCMenuBar::P reTranslateMessage	(Przesłania CMFCToolBar::PreTranslateMessage).
CMFCMenuBar::RestoreOriginalstate	Wywoływana przez platformę, gdy menu jest w trybie dostosowywania, a użytkownik wybiera pozycję Resetuj na pasku menu.
CMFCMenuBar::SaveState	Zapisuje stan CMFCMenuBar obiektu w rejestrze.
CMFCMenuBar::SetDefaultMenuResId	Ustawia oryginalne menu w pliku zasobu.
CMFCMenuBar::SetForceDownArrows
CMFCMenuBar::SetMaximizeMode	Wywoływana przez platformę, gdy okno podrzędne MDI zmienia tryb wyświetlania. Jeśli okno podrzędne MDI jest nowo zmaksymalizowane lub nie jest już zmaksymalizowane, ta metoda aktualizuje pasek menu.
CMFCMenuBar::SetMenuButtonRTC	Ustawia informacje o klasie środowiska uruchomieniowego generowane podczas dynamicznego tworzenia przycisków menu przez użytkownika.
CMFCMenuBar::SetMenuFont	Ustawia czcionkę dla wszystkich menu w aplikacji.
CMFCMenuBar::SetRecentlyUsedMenus	Określa, czy pasek menu wyświetla ostatnio używane polecenia menu.
CMFCMenuBar::SetShowAllCommands	Określa, czy na pasku menu są wyświetlane wszystkie polecenia.

Uwagi

Klasa CMFCMenuBar to pasek menu, który implementuje funkcjonalność dokowania. Przypomina pasek narzędzi, chociaż nie można go zamknąć — zawsze jest wyświetlany.

CMFCMenuBar obsługuje opcję wyświetlania ostatnio używanych obiektów elementów menu. Jeśli ta opcja jest włączona, CMFCMenuBar wyświetla tylko podzbiór dostępnych poleceń podczas pierwszego wyświetlania. Następnie ostatnio używane polecenia są wyświetlane razem z oryginalnym podzbiorem poleceń. Ponadto użytkownik zawsze może rozwinąć menu, aby wyświetlić wszystkie dostępne polecenia. W związku z tym każde dostępne polecenie jest skonfigurowane do ciągłego wyświetlania lub wyświetlania tylko wtedy, gdy zostało ostatnio wybrane.

Aby użyć CMFCMenuBar obiektu, osadź go w głównym obiekcie ramki okna. Podczas przetwarzania komunikatu wywołaj metodę WM_CREATECMFCMenuBar::Create lub CMFCMenuBar::CreateEx. Niezależnie od tego, która funkcja tworzenia jest używana, przekaż wskaźnik do głównego okna ramki. Następnie włącz dokowanie, wywołując element CFrameWndEx::EnableDocking. Zadokuj to menu, wywołując element CFrameWndEx::D ockPane.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CMFCMenuBar klasie . W przykładzie pokazano, jak ustawić styl okienka, włączyć przycisk dostosowywania, włączyć pole Pomocy, włączyć cienie dla wyskakujących menu i zaktualizować pasek menu. Ten fragment kodu jest częścią przykładu pokazu programu 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);

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCMenuBar

Wymagania

Nagłówek: afxmenubar.h

CMFCMenuBar::AdjustLocations

Dostosowuje pozycje elementów menu na pasku menu.

virtual void AdjustLocations();

Uwagi

CMFCMenuBar::AllowChangeTextLabels

Określa, czy etykiety tekstowe są dozwolone na obrazach na pasku menu.

virtual BOOL AllowChangeTextLabels() const;

Wartość zwracana

Zwraca wartość TRUE, jeśli użytkownik może wybrać wyświetlanie etykiet tekstowych pod obrazami.

Uwagi

CMFCMenuBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Wartość zwracana

Uwagi

CMFCMenuBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametry

[in] bStretch

[in] bHorz

Wartość zwracana

Uwagi

CMFCMenuBar::CalcLayout

virtual CSize CalcLayout(
    DWORD dwMode,
    int nLength = -1);

Parametry

[in] dwMode

[in] nLength

Wartość zwracana

Uwagi

CMFCMenuBar::CalcMaxButtonHeight

virtual int CalcMaxButtonHeight();

Wartość zwracana

Uwagi

CMFCMenuBar::CanBeClosed

virtual BOOL CanBeClosed() const;

Wartość zwracana

Uwagi

CMFCMenuBar::CanBeRestored

virtual BOOL CanBeRestored() const;

Wartość zwracana

Uwagi

CMFCMenuBar::Create

Tworzy kontrolkę menu i dołącza ją do obiektu CMFCMenuBar .

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID = AFX_IDW_MENUBAR);

Parametry

pParentWnd
[in] Wskaźnik do okna nadrzędnego dla nowego CMFCMenuBar obiektu.

dwStyle
[in] Styl nowego paska menu.

Nid
[in] Identyfikator okna podrzędnego paska menu.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Po utworzeniu obiektu należy wywołać metodę CMFCMenuBarCreate. Ta metoda tworzy kontrolkę CMFCMenuBar i dołącza ją do CMFCMenuBar obiektu.

Aby uzyskać więcej informacji na temat stylów paska narzędzi, zobacz CBasePane::SetPaneStyle.

CMFCMenuBar::CreateEx

Tworzy obiekt CMFCMenuBar z określonymi stylami rozszerzonymi.

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);

Parametry

pParentWnd
[in] Wskaźnik do okna nadrzędnego nowego CMFCMenuBar obiektu.

dwCtrlStyle
[in] Dodatkowe style dla nowego paska menu.

dwStyle
[in] Główny styl nowego paska menu.

rcBorders
[in] Parametr CRect określający rozmiary obramowania CMFCMenuBar obiektu.

Nid
[in] Identyfikator okna podrzędnego paska menu.

Wartość zwracana

Nonzero, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie 0.

Uwagi

Należy użyć tej funkcji zamiast CMFCMenuBar::Create , jeśli chcesz określić style oprócz stylu paska narzędzi. Niektóre często używane dodatkowe style są TBSTYLE_TRANSPARENT i CBRS_TOP.

Aby uzyskać listę dodatkowych stylów, zobacz Style kontrolek i przycisków paska narzędzi, typowe style kontrolek i typowe style okien.

Przykład

W poniższym przykładzie pokazano, jak używać CreateEx metody CMFCMenuBar klasy . Ten fragment kodu jest częścią przykładu pokazu programu 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

Inicjuje obiekt CMFCMenuBar . Ta metoda modeluje CMFCMenuBar obiekt po parametrze HMENU.

virtual void CreateFromMenu(
    HMENU hMenu,
    BOOL bDefaultMenu = FALSE,
    BOOL bForceUpdate = FALSE);

Parametry

hMenu
[in] Uchwyt do zasobu menu. CreateFromMenu używa tego zasobu jako szablonu dla elementu CMFCMenuBar.

bDefaultMenu
[in] Wartość logiczna wskazująca, czy nowe menu jest menu domyślne.

bForceUpdate
[in] Wartość logiczna wskazująca, czy ta metoda wymusza aktualizację menu.

Uwagi

Użyj tej metody, jeśli chcesz, aby kontrolka menu miała te same elementy menu co zasób menu. Ta metoda jest wywoływana po wywołaniu metody CMFCMenuBar::Create lub CMFCMenuBar::CreateEx.

CMFCMenuBar::EnableHelpCombobox

Włącza pole kombi Pomoc, które znajduje się po prawej stronie paska menu.

void EnableHelpCombobox(
    UINT uiID,
    LPCTSTR lpszPrompt = NULL,
    int nComboBoxWidth = 150);

Parametry

identyfikator uiID
[in] Identyfikator polecenia dla przycisku pola kombi Pomoc .

lpszPrompt
[in] Ciąg zawierający tekst wyświetlany przez strukturę w polu kombi, jeśli jest pusty i nie jest aktywny. Na przykład "Wprowadź tutaj tekst".

nComboBoxWidth
[in] Szerokość przycisku pola kombi w pikselach.

Uwagi

Pole kombi Pomoc przypomina pole kombi Pomoc na pasku menu programu Microsoft Word.

Gdy wywołasz tę metodę z wartością uiID ustawioną na 0, ta metoda ukrywa pole kombi. W przeciwnym razie ta metoda automatycznie wyświetla pole kombi po prawej stronie paska menu. Po wywołaniu tej metody wywołaj metodę CMFCMenuBar::GetHelpCombobox , aby uzyskać wskaźnik do wstawionego obiektu CMFCToolBarComboBoxButton .

CMFCMenuBar::EnableMenuShadows

Włącza cienie dla wyskakujących menu.

static void EnableMenuShadows(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Parametr logiczny wskazujący, czy w menu podręcznych powinny być włączone cienie.

Uwagi

Algorytm używany przez tę metodę jest złożony i może zmniejszyć wydajność aplikacji w wolniejszych systemach.

CMFCMenuBar::GetAvailableExpandSize

virtual int GetAvailableExpandSize() const;

Wartość zwracana

Uwagi

CMFCMenuBar::GetColumnWidth

virtual int GetColumnWidth() const;

Wartość zwracana

Uwagi

CMFCMenuBar::GetDefaultMenu

Pobiera uchwyt do oryginalnego menu. Struktura ładuje oryginalne menu z pliku zasobu.

HMENU GetDefaultMenu() const;

Wartość zwracana

Uchwyt do zasobu menu.

Uwagi

Jeśli aplikacja dostosowuje menu, możesz użyć tej metody, aby pobrać uchwyt do oryginalnego menu.

CMFCMenuBar::GetDefaultMenuResId

Pobiera identyfikator zasobu dla menu domyślnego.

UINT GetDefaultMenuResId() const;

Wartość zwracana

Identyfikator zasobu menu.

Uwagi

Struktura ładuje domyślne menu dla CMFCMenuBar obiektu z pliku zasobu.

CMFCMenuBar::GetFloatPopupDirection

int GetFloatPopupDirection(CMFCToolBarMenuButton* pButton);

Parametry

[in] PButton

Wartość zwracana

Uwagi

CMFCMenuBar::GetForceDownArrows

BOOL GetForceDownArrows();

Wartość zwracana

Uwagi

CMFCMenuBar::GetHelpCombobox

Zwraca wskaźnik do pola kombi Pomoc .

CMFCToolBarComboBoxButton* GetHelpCombobox();

Wartość zwracana

Wskaźnik do pola kombi Pomoc . Wartość NULL, jeśli pole kombi Pomocy jest ukryte lub nie jest włączone.

Uwagi

Pole kombi Pomoc znajduje się po prawej stronie paska menu. Wywołaj metodę CMFCMenuBar::EnableHelpCombobox , aby włączyć to pole kombi.

CMFCMenuBar::GetHMenu

Pobiera uchwyt do menu dołączonego do obiektu CMFCMenuBar .

HMENU GetHMenu() const;

CMFCMenuBar::GetMenuFont

Pobiera bieżącą czcionkę menu.

static const CFont& GetMenuFont(BOOL bHorz = TRUE);

Parametry

bHorz
[in] Parametr logiczny określający, czy ma być zwracana czcionka pozioma, czy pionowa. Wartość TRUE wskazuje czcionkę poziomą.

Wartość zwracana

Wskaźnik do parametru CFont, który zawiera bieżącą czcionkę paska menu.

Uwagi

Zwracana czcionka jest parametrem globalnym aplikacji. Dla wszystkich CMFCMenuBar obiektów są zachowywane dwie czcionki globalne. Te oddzielne czcionki są używane do poziomych i pionowych pasków menu.

CMFCMenuBar::GetMenuItem

Pobiera obiekt CMFCToolBarButton na pasku menu na podstawie indeksu elementu.

CMFCToolBarButton* GetMenuItem(int iItem) const;

Parametry

iItem
[in] Indeks elementu menu do zwrócenia.

Wartość zwracana

Wskaźnik do obiektu, który pasuje do indeksu CMFCToolBarButton określonego przez iItem. Wartość NULL, jeśli indeks jest nieprawidłowy.

CMFCMenuBar::GetRowHeight

virtual int GetRowHeight() const;

Wartość zwracana

Uwagi

CMFCMenuBar::GetSystemButton

CMFCToolBarMenuButtonsButton* GetSystemButton(
    UINT uiBtn,
    BOOL bByCommand = TRUE) const;

Parametry

[in] uiBtn

[in] bByCommand

Wartość zwracana

Uwagi

CMFCMenuBar::GetSystemButtonsCount

int GetSystemButtonsCount() const;

Wartość zwracana

Uwagi

CMFCMenuBar::GetSystemMenu

CMFCToolBarSystemMenuButton* GetSystemMenu() const;

Wartość zwracana

Uwagi

CMFCMenuBar::HighlightDisabledItems

Określa, czy platforma wyróżnia wyłączone elementy menu.

static void HighlightDisabledItems(BOOL bHighlight = TRUE);

Parametry

bHighlight
[in] Parametr logiczny wskazujący, czy platforma wyróżnia niedostępne elementy menu.

Uwagi

Domyślnie platforma nie wyróżnia niedostępnych elementów menu, gdy użytkownik umieszcza wskaźnik myszy nad nimi.

CMFCMenuBar::IsButtonExtraSizeAvailable

virtual BOOL IsButtonExtraSizeAvailable() const;

Wartość zwracana

Uwagi

CMFCMenuBar::IsHighlightDisabledItems

Wskazuje, czy platforma wyróżnia niedostępne elementy menu.

static BOOL IsHighlightDisabledItems();

Wartość zwracana

WARTOŚĆ TRUE, jeśli elementy menu niedostępne są wyróżnione; w przeciwnym razie FAŁSZ.

Uwagi

Domyślnie platforma nie wyróżnia niedostępnych elementów menu, gdy użytkownik umieszcza wskaźnik myszy nad nimi. Użyj metody CMFCMenuBar::HighlightDisabledItems, aby włączyć tę funkcję.

CMFCMenuBar::IsMenuShadows

Wskazuje, czy struktura rysuje cienie dla wyskakujących menu.

static BOOL IsMenuShadows();

Wartość zwracana

WARTOŚĆ TRUE, jeśli struktura rysuje cienie menu; w przeciwnym razie FAŁSZ.

Uwagi

Użyj metody CMFCMenuBar::EnableMenuShadows, aby włączyć lub wyłączyć tę funkcję.

CMFCMenuBar::IsRecentlyUsedMenus

Wskazuje, czy na pasku menu są wyświetlane ostatnio używane polecenia menu.

static BOOL IsRecentlyUsedMenus();

Wartość zwracana

Nonzero, jeśli CMFCMenuBar obiekt pokazuje ostatnio używane polecenia menu; w przeciwnym razie 0.

Uwagi

Użyj funkcji CMFCMenuBar::SetRecentlyUsedMenus , aby kontrolować, czy pasek menu wyświetla ostatnio używane polecenia menu.

CMFCMenuBar::IsShowAllCommands

Wskazuje, czy menu wyświetlają wszystkie polecenia.

static BOOL IsShowAllCommands();

Wartość zwracana

Nonzero, jeśli CMFCMenuBar wyświetla wszystkie polecenia; w przeciwnym razie 0.

Uwagi

Obiekt CMFCMenuBar można skonfigurować tak, aby pokazywał wszystkie polecenia lub pokazywał tylko podzbiór poleceń. Aby uzyskać więcej informacji na temat tej funkcji, zobacz Klasa CMFCMenuBar.

IsShowAllCommands Pokaże, jak ta funkcja jest skonfigurowana dla CMFCMenuBar obiektu. Aby kontrolować wyświetlane polecenia menu, użyj metod CMFCMenuBar::SetShowAllCommands i CMFCMenuBar::SetRecentlyUsedMenus.

CMFCMenuBar::IsShowAllCommandsDelay

Wskazuje, czy obiekt CMFCMenuBar wyświetla wszystkie polecenia po krótkim opóźnieniu.

static BOOL IsShowAllCommandsDelay();

Wartość zwracana

Nonzero, jeśli pasek menu wyświetla pełne menu po krótkim opóźnieniu; w przeciwnym razie 0.

Uwagi

Po skonfigurowaniu paska menu do wyświetlania ostatnio używanych elementów pasek menu wyświetla pełne menu na jeden z dwóch sposobów:

• Wyświetl pełne menu po zaprogramowanym opóźnieniu od momentu, gdy użytkownik umieści kursor na strzałki w dolnej części menu.

• Wyświetl pełne menu po kliknięciu strzałki w dolnej części menu.

Domyślnie wszystkie CMFCMenuBar obiekty używają opcji , aby wyświetlić pełne menu po krótkim opóźnieniu. Tej opcji nie można zmienić programowo w CMFCMenuBar klasie. Jednak użytkownik może zmienić zachowanie podczas dostosowywania paska narzędzi przy użyciu okna dialogowego Dostosowywanie.

CMFCMenuBar::LoadState

Ładuje stan paska menu z rejestru systemu Windows.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT)-1);

Parametry

lpszProfileName
[in] Ciąg zawierający ścieżkę klucza rejestru systemu Windows.

nIndex
[in] Identyfikator kontrolki paska menu.

identyfikator uiID
[in] Wartość zarezerwowana.

Wartość zwracana

Wartość TRUE, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Użyj metody CMFCMenuBar::SaveState, aby zapisać stan paska menu w rejestrze. Zapisane informacje obejmują elementy menu, stan docku i położenie paska menu.

W większości przypadków aplikacja nie wywołuje metody LoadState. Struktura wywołuje tę metodę podczas inicjowania obszaru roboczego.

CMFCMenuBar::OnChangeHot

virtual void OnChangeHot(int iHot);

Parametry

[in] iHot

Uwagi

CMFCMenuBar::OnDefaultMenuLoaded

Struktura wywołuje tę metodę, gdy ładuje zasób menu z pliku zasobu.

virtual void OnDefaultMenuLoaded(HMENU hMenu);

Parametry

hMenu
[in] Uchwyt dla menu dołączonego CMFCMenuBar do obiektu.

Uwagi

Domyślna implementacja tej funkcji nic nie robi. Zastąpij tę funkcję, aby wykonać kod niestandardowy po załadowaniu zasobu menu z pliku zasobu.

CMFCMenuBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parametry

[in] PButton

Wartość zwracana

Uwagi

CMFCMenuBar::OnSetDefaultButtonText

Struktura wywołuje tę metodę, gdy użytkownik zmieni tekst elementu na pasku menu.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parametry

PButton
[in] Wskaźnik do obiektu CMFCToolBarButton , który użytkownik chce dostosować.

Wartość zwracana

WARTOŚĆ TRUE, jeśli struktura stosuje zmianę użytkownika na pasku menu; w przeciwnym razie FAŁSZ.

Uwagi

Domyślna implementacja tej metody zmienia tekst przycisku na tekst, który udostępnia użytkownik.

CMFCMenuBar::OnToolHitTest

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

Parametry

[in] punkt

[in] Pti

Wartość zwracana

Uwagi

CMFCMenuBar::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

[in] PMsg

Wartość zwracana

Uwagi

CMFCMenuBar::RestoreOriginalstate

Wywoływana przez platformę, gdy użytkownik wybierze pozycję Resetujw oknie dialogowym Dostosowywanie .

virtual BOOL RestoreOriginalstate();

Wartość zwracana

Nonzero, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie 0.

Uwagi

Ta metoda jest wywoływana, gdy użytkownik wybierze pozycję Resetuj z menu dostosowywania. Możesz również ręcznie wywołać tę metodę, aby programowo zresetować stan paska menu. Ta metoda ładuje oryginalny stan z pliku zasobu.

Zastąpi tę metodę, jeśli chcesz wykonać jakiekolwiek przetwarzanie, gdy użytkownik wybierze opcję Resetuj.

CMFCMenuBar::SaveState

Zapisuje stan obiektu CMFCMenuBar w rejestrze systemu Windows.

virtual BOOL SaveState (
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT)-1);

Parametry

lpszProfileName
[in] Ciąg zawierający ścieżkę klucza rejestru systemu Windows.

nIndex
[in] Identyfikator kontrolki paska menu.

identyfikator uiID
[in] Wartość zarezerwowana.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ;

Uwagi

Zazwyczaj aplikacja nie wywołuje metody SaveState. Struktura wywołuje tę metodę, gdy obszar roboczy jest serializowany. Aby uzyskać więcej informacji, zobacz CWinAppEx::SaveState.

Zapisane informacje obejmują elementy menu, stan docku i położenie paska menu.

CMFCMenuBar::SetDefaultMenuResId

Ustawia menu domyślne dla obiektu CMFCMenuBar na podstawie identyfikatora zasobu.

void SetDefaultMenuResId(UINT uiResId);

Parametry

uiResId
[in] Identyfikator zasobu dla nowego menu domyślnego.

Uwagi

Metoda CMFCMenuBar::RestoreOriginalstate przywraca menu domyślne z pliku zasobu.

Użyj metody CMFCMenuBar::GetDefaultMenuResId, aby pobrać menu domyślne bez przywracania.

CMFCMenuBar::SetForceDownArrows

void SetForceDownArrows(BOOL bValue);

Parametry

[in] bValue

Uwagi

CMFCMenuBar::SetMaximizeMode

Platforma wywołuje tę metodę, gdy interfejs MDI zmienia tryb wyświetlania, a pasek menu musi zostać zaktualizowany.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL,
    BOOL bRecalcLayout = TRUE);

Parametry

bMax
[in] Wartość logiczna określająca tryb. Zobacz sekcję Spostrzeżenia, aby uzyskać więcej informacji.

pWnd
[in] Wskaźnik do zmieniającego się okna podrzędnego MDI.

bRecalcLayout
[in] Wartość logiczna określająca, czy układ paska menu powinien zostać natychmiast ponownie obliczony.

Uwagi

Gdy okno podrzędne MDI jest zmaksymalizowane, pasek menu dołączony do głównego okna ramki MDI wyświetla menu systemowe i przyciski Minimalizuj, Maksymalizuj i Zamknij. Jeśli wartość bMax ma wartość TRUE, a pWnd nie ma wartości NULL, okno podrzędne MDI jest zmaksymalizowane, a pasek menu musi zawierać dodatkowe kontrolki. W przeciwnym razie pasek menu powraca do stanu regularnego.

CMFCMenuBar::SetMenuButtonRTC

Ustawia informacje o klasie środowiska uruchomieniowego używane przez platformę podczas tworzenia przycisków menu przez użytkownika.

void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);

Parametry

pMenuButtonRTC
[in] Informacje CRuntimeClass dla klasy pochodzącej z klasy CMFCMenuButton.

Uwagi

Gdy użytkownik dodaje nowe przyciski na pasku menu, platforma tworzy przyciski dynamicznie. Domyślnie tworzy CMFCMenuButton obiekty. Zastąpij tę metodę, aby zmienić typ obiektów przycisków tworzonych przez platformę.

CMFCMenuBar::SetMenuFont

Ustawia czcionkę dla wszystkich pasków menu w aplikacji.

static BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz = TRUE);

Parametry

lpLogFont
[in] Wskaźnik do struktury LOGFONT , która definiuje czcionkę do ustawienia.

bHorz
[in] WARTOŚĆ TRUE, jeśli chcesz , aby parametr lpLogFont był używany dla czcionki pionowej, FALSE, jeśli chcesz, aby był używany dla czcionki poziomej.

Wartość zwracana

Wartość TRUE, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Dla wszystkich CMFCMenuBar obiektów są używane dwie czcionki. Te oddzielne czcionki są używane do poziomych i pionowych pasków menu.

Ustawienia czcionki są zmiennymi globalnymi i mają wpływ na wszystkie CMFCMenuBar obiekty.

CMFCMenuBar::SetRecentlyUsedMenus

Określa, czy pasek menu wyświetla ostatnio używane polecenia menu.

static void SetRecentlyUsedMenus (BOOL bOn = TRUE);

Parametry

Bon
[in] Wartość logiczna określająca, czy są wyświetlane ostatnio używane polecenia menu.

CMFCMenuBar::SetShowAllCommands

Określa, czy w menu są wyświetlane wszystkie dostępne polecenia.

static void SetShowAllCommands(BOOL bShowAllCommands = TRUE);

Parametry

bShowAllCommands
[in] Parametr logiczny określający, czy menu podręczne zawiera wszystkie polecenia menu.

Uwagi

Jeśli menu nie wyświetla wszystkich poleceń menu, ukrywa polecenia, które są rzadko używane. Aby uzyskać więcej informacji na temat wyświetlania poleceń menu, zobacz Klasa CMFCMenuBar.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCToolBar