Klasa CMFCToolBarMenuButton

Przycisk paska narzędzi zawierający menu podręczne. 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 CMFCToolBarMenuButton : public CMFCToolBarButton

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMFCToolBarMenuButton::CMFCToolBarMenuButton	CMFCToolBarMenuButton Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CMFCToolBarMenuButton::CompareWith	Porównuje to wystąpienie z podanym CMFCToolBarButton obiektem. (Przesłonięcia) CMFCToolBarButton::CompareWith.)
CMFCToolBarMenuButton::CopyFrom	Kopiuje właściwości innego przycisku paska narzędzi do bieżącego przycisku. (Przesłonięcia) CMFCToolBarButton::CopyFrom.)
CMFCToolBarMenuButton::CreateFromMenu	Inicjuje menu paska narzędzi z uchwytu menu systemu Windows.
CMFCToolBarMenuButton::CreateMenu	Tworzy menu systemu Windows składające się z poleceń w menu paska narzędzi. Zwraca uchwyt do menu systemu Windows.
CMFCToolBarMenuButton::CreatePopupMenu	Tworzy obiekt menu podręcznego ( KLASA CMFCPopupMenu), aby wyświetlić menu paska narzędzi.
CMFCToolBarMenuButton::EnableQuickCustomize
CMFCToolBarMenuButton::GetCommands	Zapewnia dostęp tylko do odczytu do listy poleceń w menu paska narzędzi.
CMFCToolBarMenuButton::GetImageRect	Pobiera prostokąt ograniczenia dla obrazu przycisku.
CMFCToolBarMenuButton::GetPaletteRows	Zwraca liczbę wierszy w menu podręcznym, gdy menu jest w trybie palety.
CMFCToolBarMenuButton::GetPopupMenu	Zwraca wskaźnik do obiektu menu podręcznego skojarzonego z przyciskiem .
CMFCToolBarMenuButton::HasButton
CMFCToolBarMenuButton::HaveHotBorder	Określa, czy obramowanie przycisku jest wyświetlane, gdy użytkownik wybierze przycisk. (Przesłonięcia) CMFCToolBarButton::HaveHotBorder.)
CMFCToolBarMenuButton::IsBorder
CMFCToolBarMenuButton::IsClickedOnMenu
CMFCToolBarMenuButton::IsDroppedDown	Określa, czy jest wyświetlane menu podręczne.
CMFCToolBarMenuButton::IsEmptyMenuAllowed	Wywoływana przez platformę w celu określenia, czy użytkownik może otworzyć podmenu z wybranego elementu menu.
CMFCToolBarMenuButton::IsExclusive	Określa, czy przycisk jest w trybie wyłącznym, czyli czy menu podręczne pozostaje otwarte, nawet gdy użytkownik przenosi wskaźnik na inny pasek narzędzi lub przycisk.
CMFCToolBarMenuButton::IsMenuPaletteMode	Określa, czy menu podręczne jest w trybie palety.
CMFCToolBarMenuButton::IsQuickMode
CMFCToolBarMenuButton::IsTearOffMenu	Określa, czy menu podręczne ma pasek odrywania.
CMFCToolBarMenuButton::OnAfterCreatePopupMenu
CMFCToolBarMenuButton::OnBeforeDrag	Określa, czy przycisk można przeciągnąć. (Przesłonięcia) CMFCToolBarButton::OnBeforeDrag.)
CMFCToolBarMenuButton::OnCalculateSize	Wywoływana przez platformę w celu obliczenia rozmiaru przycisku dla określonego kontekstu urządzenia i stanu dokowania. (Przesłonięcia) CMFCToolBarButton::OnCalculateSize.)
CMFCToolBarMenuButton::OnCancelMode	Wywoływana przez platformę do obsługi komunikatu WM_CANCELMODE . (Przesłonięcia) CMFCToolBarButton::OnCancelMode.)
CMFCToolBarMenuButton::OnChangeParentWnd	Wywoływana przez strukturę po wstawieniu przycisku do nowego paska narzędzi. (Przesłonięcia) CMFCToolBarButton::OnChangeParentWnd.)
CMFCToolBarMenuButton::OnClick	Wywoływana przez platformę, gdy użytkownik kliknie przycisk myszy. (Przesłonięcia) CMFCToolBarButton::OnClick.)
CMFCToolBarMenuButton::OnClickMenuItem	Wywoływana przez platformę, gdy użytkownik wybierze element w menu podręcznym.
CMFCToolBarMenuButton::OnContextHelp	Wywoływana przez platformę, gdy nadrzędny pasek narzędzi obsługuje komunikat WM_HELPHITTEST. (Przesłonięcia) CMFCToolBarButton::OnContextHelp.)
CMFCToolBarMenuButton::OnDraw	Wywoływana przez strukturę w celu narysowania przycisku przy użyciu określonych stylów i opcji. (Przesłonięcia) CMFCToolBarButton::OnDraw.)
CMFCToolBarMenuButton::OnDrawOnCustomizeList	Wywoływana przez strukturę, aby narysować przycisk w okienku Polecenia okna dialogowego Dostosowywanie . (Przesłonięcia) CMFCToolBarButton::OnDrawOnCustomizeList.)
CMFCToolBarMenuButton::OpenPopupMenu	Wywoływana przez platformę po otwarciu menu podręcznego przez użytkownika.
CMFCToolBarMenuButton::ResetImageToDefault	Ustawia wartość domyślną obrazu skojarzonego z przyciskiem . (Przesłonięcia) CMFCToolBarButton::ResetImageToDefault.)
CMFCToolBarMenuButton::SaveBarState	Zapisuje stan przycisku paska narzędzi. (Przesłonięcia) CMFCToolBarButton::SaveBarState.)
CMFCToolBarMenuButton::Serialize	Odczytuje ten obiekt z archiwum lub zapisuje go w archiwum. (Przesłonięcia) CMFCToolBarButton::Serialize.)
CMFCToolBarMenuButton::SetACCData	Wypełnia podany CAccessibilityData obiekt danymi ułatwień dostępu za pomocą przycisku paska narzędzi. (Przesłonięcia) CMFCToolBarButton::SetACCData.)
CMFCToolBarMenuButton::SetMenuOnly	Określa, czy przycisk można dodać do paska narzędzi.
CMFCToolBarMenuButton::SetMenuPaletteMode	Określa, czy menu podręczne jest w trybie palety.
CMFCToolBarMenuButton::SetMessageWnd
CMFCToolBarMenuButton::SetRadio	Wymusza naciśnięcie przycisku menu paska narzędzi w celu wyświetlenia ikony wskazującej, że jest zaznaczona.
CMFCToolBarMenuButton::SetTearOff	Określa identyfikator paska odrętywania dla menu podręcznego.

Metody chronione

Nazwa/nazwisko	opis
CMFCToolBarMenuButton::D rawDocumentIcon	Rysuje ikonę na przycisku menu.

Składowe danych

Nazwa/nazwisko	opis
CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw	Jeśli wartość TRUE, struktura zawsze wywołuje obiekt CFrameWndEx::OnDrawMenuImage , gdy zostanie narysowany przycisk.

Uwagi

Element CMFCToolBarMenuButton menu może być wyświetlany jako menu, element menu z pod menu, przycisk, który wykonuje polecenie lub wyświetla menu albo przycisk, który wyświetla tylko menu. Zachowanie i wygląd przycisku menu można określić, określając parametry, takie jak obraz, tekst, uchwyt menu i identyfikator polecenia skojarzony z przyciskiem w konstruktorze CMFCToolbarMenuButton::CMFCToolbarMenuButton.

Klasa niestandardowa pochodząca z CMFCToolbarMenuButton klasy musi używać makra DECLARE_SERIAL . Makro DECLARE_DYNCREATE generuje błąd po zamknięciu aplikacji.

Przykład

W poniższym przykładzie pokazano, jak skonfigurować CMFCToolBarMenuButton obiekt. Kod ilustruje sposób określania, że menu rozwijane jest w trybie palety i określa identyfikator paska odrętywania, który jest tworzony, gdy użytkownik przeciąga przycisk menu z paska menu. Ten fragment kodu jest częścią przykładu okienka word.

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

Hierarchia dziedziczenia

Obiekt CObject

CMFCToolBarButton

CMFCToolBarMenuButton

Wymagania

Nagłówek: afxtoolbarmenubutton.h

CMFCToolBarMenuButton::CMFCToolBarMenuButton

CMFCToolBarMenuButton Tworzy obiekt.

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

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

Parametry

Src
[in] Istniejący CMFCToolBarMenuButton obiekt do skopiowania do tego CMFCToolBarMenuButton obiektu.

identyfikator uiID
[in] Identyfikator polecenia do wykonania, gdy użytkownik kliknie przycisk; lub (UINT)-1 dla przycisku menu, który nie wykonuje bezpośrednio polecenia.

hMenu
[in] Uchwyt do menu; lub null, jeśli przycisk nie ma menu.

iImage
[in] Indeks obrazu przycisku; lub -1, jeśli ten przycisk nie ma ikony lub używa ikony dla polecenia określonego przez uiID. Indeks jest taki sam dla każdego CMFCToolBarImages obiektu w aplikacji.

lpszText
[in] Tekst przycisku menu paska narzędzi.

bUserButton
[in] WARTOŚĆ TRUE, jeśli przycisk wyświetla obraz zdefiniowany przez użytkownika; FALSE, jeśli przycisk wyświetla wstępnie zdefiniowany obraz skojarzony z poleceniem określonym przez uiID.

Uwagi

Jeśli identyfikator uiID jest prawidłowym identyfikatorem polecenia, przycisk wykonuje to polecenie, gdy użytkownik go kliknie. Jeśli hMenu jest prawidłowym uchwytem menu, przycisk udostępnia menu rozwijane, gdy pojawi się na pasku narzędzi lub podmenu, gdy pojawi się w menu. Jeśli zarówno identyfikator uiID , jak i hMenu są prawidłowe, przycisk jest podzielonym przyciskiem z częścią, która wykona polecenie po kliknięciu go przez użytkownika i części ze strzałką w dół, która będzie rozwijana menu po kliknięciu go przez użytkownika. Jeśli jednak parametr hMenu jest prawidłowy, użytkownik nie będzie mógł kliknąć przycisku, aby wykonać polecenie, gdy przycisk zostanie wstawiony do menu.

Przykład

W poniższym przykładzie pokazano, jak utworzyć obiekt CMFCToolBarMenuButton klasy. Ten fragment kodu jest częścią przykładu okienka word.

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;

Parametry

[in] inny

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametry

[in] Src

Uwagi

CMFCToolBarMenuButton::CreateFromMenu

Inicjuje menu paska narzędzi z uchwytu menu systemu Windows.

virtual void CreateFromMenu(HMENU hMenu);

Parametry

hMenu
[in] Uchwyt do menu.

Uwagi

Przycisk menu paska narzędzi może wyświetlać podmenu listy rozwijanej.

Struktura wywołuje tę metodę, aby zainicjować polecenia w podmenu z menu.

CMFCToolBarMenuButton::CreateMenu

Tworzy menu składające się z poleceń w menu paska narzędzi. Zwraca uchwyt do menu.

virtual HMENU CreateMenu() const;

Wartość zwracana

Dojście do menu w przypadku powodzenia. Wartość NULL, jeśli lista poleceń skojarzonych z przyciskiem menu paska narzędzi jest pusta.

Uwagi

Tę metodę można zastąpić w klasie pochodnej, aby dostosować sposób generowania menu.

CMFCToolBarMenuButton::CreatePopupMenu

Tworzy obiekt do CMFCPopupMenu wyświetlania menu paska narzędzi.

virtual CMFCPopupMenu* CreatePopupMenu();

Wartość zwracana

Wskaźnik do CMFCPopupMenu obiektu, który wyświetla menu rozwijane skojarzone z przyciskiem menu paska narzędzi.

Uwagi

Ta metoda jest wywoływana przez strukturę w celu przygotowania wyświetlania menu rozwijanego skojarzonego z przyciskiem.

Domyślna implementacja po prostu konstruuje i zwraca nowy CMFCPopupMenu obiekt. Zastąp tę metodę, jeśli chcesz użyć pochodnego typu klasy CMFCPopupMenu lub wykonać dodatkową inicjację.

CMFCToolBarMenuButton::D rawDocumentIcon

Rysuje ikonę dokumentu na przycisku menu.

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

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia.

rectImage
[in] Współrzędne prostokąta ograniczenia obrazu.

hIcon
[in] Uchwyt ikony.

Uwagi

Ta metoda pobiera ikonę dokumentu i rysuje go na przycisku menu, wyśrodkowanego w obszarze określonym przez rectImage.

CMFCToolBarMenuButton::EnableQuickCustomize

void EnableQuickCustomize();

Uwagi

CMFCToolBarMenuButton::HasButton

virtual BOOL HasButton() const;

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::HaveHotBorder

virtual BOOL HaveHotBorder() const;

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::IsBorder

virtual BOOL IsBorder() const;

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::IsClickedOnMenu

BOOL IsClickedOnMenu() const;

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::IsQuickMode

BOOL IsQuickMode();

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::GetCommands

Zapewnia dostęp tylko do odczytu do listy poleceń w menu paska narzędzi.

const CObList& GetCommands() const;

Wartość zwracana

Odwołanie const do obiektu klasy CObList, który zawiera kolekcję obiektów klasy CMFCToolBarButton.

Uwagi

Przycisk menu paska narzędzi może wyświetlać podmenu. Możesz podać listę poleceń w podmenu w konstruktorze lub w cmFCToolBarMenuButton::CreateFromMenu jako uchwyt do menu (HMENU). Menu jest konwertowane na listę obiektów, które pochodzą z klasy CMFCToolBarButton i przechowywane w obiekcie wewnętrznym CObList . Dostęp do tej listy można uzyskać, wywołując tę metodę.

CMFCToolBarMenuButton::GetImageRect

Pobiera prostokąt ograniczenia dla obrazu przycisku.

void GetImageRect(CRect& rectImage);

Parametry

rectImage
[out] Odwołanie do CRect obiektu, który odbiera współrzędne prostokąta ograniczenia obrazu.

CMFCToolBarMenuButton::GetPaletteRows

Zwraca liczbę wierszy w menu rozwijanym, gdy menu jest w trybie palety.

int GetPaletteRows() const;

Wartość zwracana

Liczba wierszy w palecie.

Uwagi

Po ustawieniu przycisku menu na tryb palety elementy menu będą wyświetlane w wielu kolumnach z ograniczoną liczbą wierszy. Wywołaj tę metodę, aby uzyskać liczbę wierszy. Możesz włączyć lub wyłączyć tryb palety i określić liczbę wierszy przy użyciu polecenia CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::GetPopupMenu

Zwraca wskaźnik do obiektu klasy CMFCPopupMenu, który reprezentuje menu rozwijane przycisku.

CMFCPopupMenu* GetPopupMenu() const;

Wartość zwracana

Wskaźnik do obiektu klasy CMFCPopupMenu, który został utworzony podczas tworzenia struktury narysował podmenu przycisku menu paska narzędzi; Wartość NULL, jeśli nie jest wyświetlana żadna podmenu.

Uwagi

Gdy przycisk menu paska narzędzi wyświetla menu rozwijane, przycisk tworzy obiekt klasy CMFCPopupMenu reprezentujący menu. Wywołaj tę metodę, aby uzyskać wskaźnik do CMFCPopupMenu obiektu. Nie należy przechowywać zwróconego wskaźnika, ponieważ jest tymczasowy i staje się nieprawidłowy, gdy użytkownik zamknie menu rozwijane.

CMFCToolBarMenuButton::IsDroppedDown

Wskazuje, czy menu podręczne jest obecnie wyświetlane.

virtual BOOL IsDroppedDown() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk menu paska narzędzi wyświetla jego podmenu; w przeciwnym razie FAŁSZ.

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Określa, czy elementy menu zawierają puste podmenu.

virtual BOOL IsEmptyMenuAllowed() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli platforma otwiera podmenu z aktualnie wybranego elementu menu nawet wtedy, gdy podmenu jest pusty; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, gdy użytkownik próbuje otworzyć podmenu z aktualnie wybranego elementu menu. Jeśli podmenu jest pusty i IsEmptyMenuAllowed zwraca wartość FALSE, podmenu nie zostanie otwarty.

Domyślna implementacja zwraca wartość FALSE. Zastąpij tę metodę, aby dostosować to zachowanie.

CMFCToolBarMenuButton::IsExclusive

Wskazuje, czy przycisk jest w trybie wyłącznym.

virtual BOOL IsExclusive() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk działa w trybie wyłącznym; w przeciwnym razie FAŁSZ.

Uwagi

Gdy użytkownik otworzy menu podręczne przycisku, a następnie przesuwa wskaźnik myszy na innym pasku narzędzi lub przycisku menu, menu podręczne zostanie zamknięte, chyba że przycisk jest w trybie wyłącznym.

Domyślna implementacja zawsze zwraca wartość FALSE. Zastąp tę metodę w klasie pochodnej, jeśli chcesz włączyć tryb wyłączny.

CMFCToolBarMenuButton::IsMenuPaletteMode

Określa, czy menu rozwijane jest w trybie palety.

BOOL IsMenuPaletteMode() const;

Wartość zwracana

Wartość TRUE, jeśli tryb palety jest włączony, w przeciwnym razie wartość FALSE.

Uwagi

Gdy przycisk menu jest ustawiony na tryb palety, elementy menu są wyświetlane w wielu kolumnach z ograniczoną liczbą wierszy. Wywołaj tę metodę, aby uzyskać liczbę wierszy. Tryb palety można włączyć lub wyłączyć, wywołując polecenie CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::IsTearOffMenu

Wskazuje, czy menu rozwijane ma pasek odrywania.

virtual BOOL IsTearOffMenu() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk menu paska narzędzi ma pasek odrywania; w przeciwnym razie FAŁSZ.

Uwagi

Aby włączyć funkcję odrywania i ustawić identyfikator paska odrywania, wywołaj polecenie CMFCToolBarMenuButton::SetTearOff.

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Określa, czy struktura zawsze wywołuje CFrameWndEx ::OnDrawMenuImage , gdy przycisk jest rysowany.

static BOOL m_bAlwaysCallOwnerDraw;

Uwagi

Gdy ta zmienna składowa ma wartość TRUE, przycisk zawsze wywołuje metodę CFrameWndEx::OnDrawMenuImage , aby wyświetlić obraz na przycisku. Gdy m_bAlwaysCallOwnerDraw jest to FAŁSZ, sam przycisk rysuje obraz, jeśli obraz jest wstępnie zdefiniowany. W przeciwnym razie wywołuje metodę OnDrawMenuImage.

CMFCToolBarMenuButton::OnAfterCreatePopupMenu

virtual void OnAfterCreatePopupMenu();

Uwagi

CMFCToolBarMenuButton::OnBeforeDrag

virtual BOOL OnBeforeDrag() const;

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::OnCalculateSize

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

Parametry

[in] PDC
[in] sizeDefault
[in] bHorz

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::OnCancelMode

virtual void OnCancelMode();

Uwagi

CMFCToolBarMenuButton::OnChangeParentWnd

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parametry

[in] pWndParent

Uwagi

CMFCToolBarMenuButton::OnClick

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

Parametry

[in] pWnd
[in] bDelay

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::OnClickMenuItem

Wywoływana przez platformę, gdy użytkownik wybierze element w menu rozwijanym.

virtual BOOL OnClickMenuItem();

Wartość zwracana

FAŁSZ, jeśli struktura powinna kontynuować domyślne przetwarzanie elementów menu; w przeciwnym razie wartość TRUE. Domyślna implementacja zawsze zwraca wartość FALSE.

Uwagi

Gdy użytkownik kliknie element menu, platforma wykonuje polecenie skojarzone z tym elementem.

Aby dostosować przetwarzanie elementów menu, przesłoń OnClickMenuItem w klasie pochodzącej z CMFCToolBarMenuButton klasy. Należy również zastąpić przyciski menu CFrameWndEx::OnShowPopupMenu i zastąpić przyciski menu wymagające specjalnego przetwarzania wystąpieniami klasy pochodnej.

CMFCToolBarMenuButton::OnContextHelp

virtual BOOL OnContextHelp(CWnd* pWnd);

Parametry

[in] pWnd

Wartość zwracana

Uwagi

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

Parametry

[in] PDC
[in] Rect
[in] pImages
[in] bHorz
[in] bCustomizeMode
[in] bHighlight
[in] bDrawBorder
[in] bGrayDisabledButtons

Uwagi

CMFCToolBarMenuButton::OnDrawOnCustomizeList

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

Parametry

[in] PDC
[in] Rect
[in] bSelected

Wartość zwracana

Uwagi

CMFCToolBarMenuButton::OpenPopupMenu

Wywoływana przez platformę po otwarciu menu rozwijanego przycisku menu paska narzędzi przez użytkownika.

virtual BOOL OpenPopupMenu(CWnd* pWnd=NULL);

Parametry

pWnd
[in] Określa okno odbierające polecenia menu rozwijanego. Może mieć wartość NULL tylko wtedy, gdy przycisk menu paska narzędzi ma okno nadrzędne.

Wartość zwracana

WARTOŚĆ TRUE, gdy obiekt klasy CMFCPopupMenu został utworzony i otwarty pomyślnie; w przeciwnym razie FALSE.

Uwagi

Ta funkcja jest wywoływana przez platformę, gdy użytkownik otworzy menu rozwijane z poziomu przycisku menu paska narzędzi.

CMFCToolBarMenuButton::ResetImageToDefault

virtual void ResetImageToDefault();

Uwagi

CMFCToolBarMenuButton::SaveBarState

virtual void SaveBarState();

Uwagi

Struktura wywołuje tę metodę podczas tworzenia przycisku paska narzędzi w wyniku operacji przeciągania i upuszczania. Ta metoda wywołuje metodę CMFCPopupMenu::SaveState menu podręcznego najwyższego poziomu, co powoduje, że przycisk nadrzędny menu podręcznego zostanie utworzony ponownie.

CMFCToolBarMenuButton::Serialize

virtual void Serialize(CArchive& ar);

Parametry

[in] Ar

Uwagi

CMFCToolBarMenuButton::SetACCData

Ustawia dane ułatwień dostępu dla elementu wstążki.

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

Parametry

PParent
Okno nadrzędne elementu wstążki.

data
Dane ułatwień dostępu dla elementu wstążki.

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

Domyślnie ta metoda ustawia dane ułatwień dostępu dla elementu wstążki i zawsze zwraca wartość TRUE. Zastąpij tę metodę, aby ustawić dane ułatwień dostępu i zwrócić wartość wskazującą powodzenie lub niepowodzenie.

CMFCToolBarMenuButton::SetMenuOnly

Określa, czy przycisk jest rysowany jako przycisk menu, czy przycisk podziału, gdy ma zarówno prawidłowy identyfikator polecenia, jak i podmenu.

void SetMenuOnly(BOOL bMenuOnly);

Parametry

bMenuOnly
[in] Wartość TRUE, aby wyświetlić ten przycisk jako przycisk menu, jeśli ma zarówno prawidłowy identyfikator polecenia, jak i podmenu, FALSE, aby wyświetlić ten przycisk jako przycisk podziału, gdy ma zarówno prawidłowy identyfikator polecenia, jak i podmenu.

Uwagi

Zazwyczaj gdy przycisk menu paska narzędzi ma zarówno podmenu, jak i identyfikator polecenia, menu wydaje się być przyciskiem podziału, który ma przycisk główny i dołączony przycisk strzałki w dół. Jeśli wywołasz tę metodę i parametr bMenuOnly ma wartość TRUE, zamiast tego przycisk będzie pojedynczym przyciskiem menu ze strzałką w dół w przycisku. Gdy użytkownik kliknie strzałkę w obu trybach, zostanie otwarty podmenu, a gdy użytkownik kliknie część przycisku bez strzałki w obu trybach, platforma wykonuje polecenie .

CMFCToolBarMenuButton::SetMenuPaletteMode

Określa, czy menu rozwijane jest w trybie palety.

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

Parametry

bMenuPaletteMode
[in] Określa, czy menu rozwijane jest w trybie palety.

nPaletteRows
[in] Liczba wierszy w palecie.

Uwagi

W trybie palety wszystkie elementy menu są wyświetlane jako paleta wielokolumnowa. Liczbę wierszy należy określić przy użyciu nPaletteRows.

CMFCToolBarMenuButton::SetMessageWnd

void SetMessageWnd(CWnd* pWndMessage);

Parametry

[in] pWndMessage

Uwagi

CMFCToolBarMenuButton::SetRadio

Ustawia przycisk menu paska narzędzi, aby wyświetlić ikonę stylu przycisku radiowego po zaznaczeniu.

virtual void SetRadio();

Uwagi

Gdy przycisk menu zostanie narysowany podczas jego zaznaczenia, wywołuje polecenie CMFCVisualManager::OnDrawMenuCheck , aby narysować ikonę znacznika wyboru. Domyślnie żąda, OnDrawMenuCheck aby bieżący menedżer wizualizacji rysował znacznik wyboru stylu pola wyboru na przycisku menu. Po wywołaniu tej metody bieżący menedżer wizualizacji zamiast tego rysuje znacznik wyboru stylu przycisku radiowego na przycisku menu. Tej zmiany nie można cofnąć.

Gdy wywołasz tę metodę, a przycisk menu jest obecnie wyświetlany, zostanie odświeżony.

CMFCToolBarMenuButton::SetTearOff

Określa identyfikator paska odrywania dla menu rozwijanego.

virtual void SetTearOff(UINT uiBarID);

Parametry

uiBarID
[in] Określa nowy identyfikator paska odrywania.

Uwagi

Wywołaj tę metodę, aby określić identyfikator paska odrywania, który jest tworzony, gdy użytkownik przeciąga przycisk menu z paska menu. Jeśli parametr uiBarID ma wartość 0, użytkownik nie może odrącić przycisku menu.

Wywołaj metodę CWinAppEx::EnableTearOffMenus , aby włączyć funkcję menu łzawiącego w aplikacji.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCToolBarButton
Klasa CMFCToolBar
Klasa CMFCPopupMenu