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
Członkowie
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
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.
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] Innych
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.
Danych
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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla