Udostępnij za pośrednictwem


Klasa CMFCRibbonBaseElement

Klasa CMFCRibbonBaseElement jest klasą bazową dla wszystkich elementów, które można dodać do paska wstążki. Przykłady elementów wstążki to przyciski wstążki, pola wyboru wstążki i pola kombi wstążki.

Składnia

class CMFCRibbonBaseElement : public CObject

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CMFCRibbonBaseElement CMFCRibbonBaseElement Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CMFCRibbonBaseElement::AddToKeyList Dodaje etykietkę klucza elementu wstążki do tablicy etykietek kluczy.
CMFCRibbonBaseElement::AddToListBox Dodaje element wstążki do określonego pola listy poleceń wstążki.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar Wskazuje, czy element wstążki można dodać do paska narzędzi szybkiego dostępu.
CMFCRibbonBaseElement::CanBeCompacted Wskazuje, czy rozmiar elementu wstążki może być kompaktowy.
CMFCRibbonBaseElement::CanBeStretched Wskazuje, czy wysokość elementu wstążki może wzrosnąć pionowo do wysokości wiersza wstążki.
CMFCRibbonBaseElement::CanBeStretchedHorizontally Wskazuje, czy szerokość elementu wstążki może ulec zmianie.
CMFCRibbonBaseElement::CleanUpSizes Czyści ustawienia wymiarów elementu wstążki.
CMFCRibbonBaseElement::ClosePopupMenu Zamyka menu podręczne elementu wstążki.
CMFCRibbonBaseElement::CopyFrom Kopiuje stan określonego CMFCRibbonBaseElement obiektu do bieżącego obiektu.
CMFCRibbonBaseElement::D estroyCtrl Niszczy element wstążki.
CMFCRibbonBaseElement::D rawImage Rysuje obraz elementu wstążki.
CMFCRibbonBaseElement::Find Zwraca określony wskaźnik do elementu wstążki, jeśli wskazuje bieżący obiekt.
CMFCRibbonBaseElement::FindByData Pobiera wskaźnik do elementu wstążki, jeśli zawiera określone dane.
CMFCRibbonBaseElement::FindByID Pobiera wskaźnik do elementu wstążki, jeśli ten element jest identyfikowany przez określony identyfikator polecenia.
CMFCRibbonBaseElement::FindByOriginal Pobiera wskaźnik do elementu wstążki, jeśli jego oryginalny element wstążki jest zgodny z określonym elementem wstążki.
CMFCRibbonBaseElement::GetCompactSize Zwraca kompaktowy rozmiar elementu wstążki.
CMFCRibbonBaseElement::GetData Pobiera dane zdefiniowane przez użytkownika skojarzone z elementem wstążki.
CMFCRibbonBaseElement::GetDescription Zwraca opis elementu wstążki.
CMFCRibbonBaseElement::GetDroppedDown Pobiera wskaźnik do elementu wstążki, jeśli menu podręczne zostanie usunięte.
CMFCRibbonBaseElement::GetElements Dodaje bieżący element wstążki do określonej tablicy.
CMFCRibbonBaseElement::GetElementsByID Dodaje bieżący element wstążki do określonej tablicy, jeśli bieżący element wstążki zawiera określony identyfikator polecenia.
CMFCRibbonBaseElement::GetHighlighted Pobiera wskaźnik do elementu wstążki, jeśli został wyróżniony.
CMFCRibbonBaseElement::GetID Zwraca identyfikator polecenia elementu wstążki.
CMFCRibbonBaseElement::GetImageSize Zwraca rozmiar obrazu elementu wstążki.
CMFCRibbonBaseElement::GetIntermediateSize Zwraca rozmiar elementu wstążki w stanie pośrednim.
CMFCRibbonBaseElement::GetKeys Zwraca etykietkę klucza skojarzona z elementem wstążki.
CMFCRibbonBaseElement::GetKeyTipRect Pobiera prostokąt granicy etykietki klucza dla elementu wstążki.
CMFCRibbonBaseElement::GetKeyTipSize Pobiera rozmiar tekstu etykietki klucza.
CMFCRibbonBaseElement::GetLocationInGroup Wskazuje lokalizację wyświetlania elementu wstążki w grupie wstążki.
CMFCRibbonBaseElement::GetMenuKeys Zwraca etykietki skojarzone z przyciskiem.
CMFCRibbonBaseElement::GetNotifyID Pobiera identyfikator polecenia powiadomienia dla elementu wstążki.
CMFCRibbonBaseElement::GetOriginal Pobiera oryginalny element wstążki.
CMFCRibbonBaseElement::GetParentCategory Pobiera kategorię wstążki dla elementu wstążki.
CMFCRibbonBaseElement::GetParentPanel Pobiera panel wstążki zawierający element wstążki.
CMFCRibbonBaseElement::GetParentRibbonBar Pobiera nadrzędny pasek wstążki dla elementu wstążki.
CMFCRibbonBaseElement::GetParentWnd Pobiera okno nadrzędne dla elementu wstążki.
CMFCRibbonBaseElement::GetPressed Pobiera wskaźnik do elementu wstążki, jeśli użytkownik aktualnie go naciska.
CMFCRibbonBaseElement::GetQuickAccessToolBarID Pobiera identyfikator polecenia elementu wstążki, gdy znajduje się na pasku narzędzi szybkiego dostępu.
CMFCRibbonBaseElement::GetRect Zwraca prostokąt ograniczenia elementu wstążki.
CMFCRibbonBaseElement::GetRegularSize Zwraca zwykły rozmiar elementu wstążki.
CMFCRibbonBaseElement::GetSize Zwraca bieżący rozmiar elementu wstążki.
CMFCRibbonBaseElement::GetText Zwraca tekst skojarzony z elementem wstążki.
CMFCRibbonBaseElement::GetToolTipText Zwraca tekst etykietki narzędzia elementu wstążki.
CMFCRibbonBaseElement::GetTopLevelRibbonBar Pobiera pasek wstążki najwyższego poziomu dla elementu wstążki.
CMFCRibbonBaseElement::HasCompactMode Określa, czy element wstążki ma tryb kompaktowy.
CMFCRibbonBaseElement::HasFocus Wskazuje, czy element nadrzędny ma fokus klawiatury.
CMFCRibbonBaseElement::HasIntermediateMode Określa, czy element wstążki ma tryb pośredni.
CMFCRibbonBaseElement::HasLargeMode Określa, czy element wstążki ma duży tryb.
CMFCRibbonBaseElement::HasMenu Wskazuje, czy element wstążki ma menu.
CMFCRibbonBaseElement::HitTest Pobiera wskaźnik do elementu wstążki, jeśli określony punkt znajduje się w nim.
CMFCRibbonBaseElement::IsAlignByColumn Wskazuje, czy element wstążki jest wyrównany w pionie do innych elementów wstążki.
CMFCRibbonBaseElement::IsAlwaysLargeImage Wskazuje, czy rozmiar obrazu elementu wstążki jest zawsze duży.
CMFCRibbonBaseElement::IsAutoRepeatMode Wskazuje, czy element wstążki jest w trybie automatycznego powtarzania.
CMFCRibbonBaseElement::IsChecked Określa, czy element wstążki jest zaznaczony.
CMFCRibbonBaseElement::IsCompactMode Określa, czy element wstążki jest w trybie kompaktowym.
CMFCRibbonBaseElement::IsDefaultMenuLook
CMFCRibbonBaseElement::IsDisabled Określa, czy element wstążki jest wyłączony.
CMFCRibbonBaseElement::IsDroppedDown Określa, czy element wstążki wyświetla menu podręczne i jest rozwijany.
CMFCRibbonBaseElement::IsFocused Określa, czy element wstążki ma fokus.
CMFCRibbonBaseElement::IsGalleryIcon Wskazuje, czy element wstążki znajduje się w galerii wstążki.
CMFCRibbonBaseElement::IsHighlighted Określa, czy element wstążki jest wyróżniony.
CMFCRibbonBaseElement::IsIntermediateMode Wskazuje, czy bieżący obraz elementu wstążki ma rozmiar pośredni.
CMFCRibbonBaseElement::IsLargeMode Wskazuje, czy bieżący obraz elementu wstążki ma duży rozmiar.
CMFCRibbonBaseElement::IsMenuMode Wskazuje, czy element wstążki znajduje się w menu.
CMFCRibbonBaseElement::IsPressed Wskazuje, czy użytkownik kliknął element wstążki.
CMFCRibbonBaseElement::IsQATMode Wskazuje, czy element wstążki znajduje się na pasku narzędzi szybkiego dostępu.
CMFCRibbonBaseElement::IsSeparator Wskazuje, czy element wstążki jest separatorem wyświetlania.
CMFCRibbonBaseElement::IsShowGroupBorder Wskazuje, czy element wstążki znajduje się w grupie, która wyświetla wspólne obramowanie.
CMFCRibbonBaseElement::IsShowTooltipOnBottom Wskazuje, czy etykietka narzędzia jest wyświetlana pod elementem wstążki.
CMFCRibbonBaseElement::IsTabStop Wskazuje, czy element wstążki można wybrać za pomocą klawiatury.
CMFCRibbonBaseElement::IsTextAlwaysOnRight Wskazuje, czy tekst elementu wstążki jest wyświetlany po prawej stronie.
CMFCRibbonBaseElement::IsVisible Wskazuje, czy element wstążki jest obecnie wyświetlany.
CMFCRibbonBaseElement::IsWholeRowHeight Wskazuje, czy heigth wyświetlania elementu wstążki jest taki sam jak wysokość wyświetlania panelu wstążki, który go zawiera.
CMFCRibbonBaseElement::NotifyCommand Wysyła powiadomienie polecenia do okna nadrzędnego elementu wstążki.
CMFCRibbonBaseElement::NotifyHighlightListItem Powiadamia okno nadrzędne paska wstążki, gdy użytkownik wyróżni element wstążki znajdujący się na liście.
CMFCRibbonBaseElement::OnAddToQAToolbar Dodaje element wstążki do określonego paska narzędzi szybkiego dostępu.
CMFCRibbonBaseElement::OnAfterChangeRect Aktualizuje etykietkę narzędzia elementu wstążki.
CMFCRibbonBaseElement::OnAutoRepeat Aktualizuje element wstążki w odpowiedzi na trwałe dane wejściowe użytkownika.
CMFCRibbonBaseElement::OnCalcTextSize Oblicza rozmiar tekstu dla elementu wstążki.
CMFCRibbonBaseElement::OnChangeMenuHighlight Wywoływana przez platformę, gdy wyróżnienie zmienia się dla elementu wstążki znajdującego się w menu.
CMFCRibbonBaseElement::OnDraw Wywoływana przez strukturę w celu narysowania elementu wstążki.
CMFCRibbonBaseElement::OnDrawKeyTip Wywoływana przez strukturę, aby narysować etykietkę dla elementu wstążki.
CMFCRibbonBaseElement::OnDrawMenuImage Wywoływana przez platformę, gdy obraz menu dla elementu wstążki jest rysowany.
CMFCRibbonBaseElement::OnDrawOnList Wywoływana przez strukturę w celu narysowania elementu wstążki w polu listy poleceń.
CMFCRibbonBaseElement::OnKey Wywoływana przez platformę, gdy użytkownik naciska etykietkę, a element wstążki ma fokus.
CMFCRibbonBaseElement::OnMenuKey
CMFCRibbonBaseElement::OnRTLChanged Wywoływana przez platformę, gdy układ zmienia kierunek.
CMFCRibbonBaseElement::OnShow Wywoływana przez strukturę w celu pokazania lub ukrycia elementu wstążki.
CMFCRibbonBaseElement::OnShowPopupMenu Wywoływana przez platformę, gdy element wstążki wyświetli menu podręczne.
CMFCRibbonBaseElement::P ostMenuCommand
CMFCRibbonBaseElement::Redraw Aktualizuje ekran elementu wstążki.
CMFCRibbonBaseElement::SetACCData Ustawia dane ułatwień dostępu dla elementu wstążki.
CMFCRibbonBaseElement::SetCompactMode Ustawia rozmiar wyświetlania elementu wstążki.
CMFCRibbonBaseElement::SetData Kojarzy element danych z elementem wstążki.
CMFCRibbonBaseElement::SetDefaultMenuLook
CMFCRibbonBaseElement::SetDescription Ustawia opis elementu wstążki.
CMFCRibbonBaseElement::SetID Ustawia identyfikator polecenia elementu wstążki.
CMFCRibbonBaseElement::SetInitialMode Ustawia początkowy rozmiar wyświetlania elementu wstążki.
CMFCRibbonBaseElement::SetKeys Ustawia etykietkę klucza dla elementu wstążki.
CMFCRibbonBaseElement::SetOriginal Ustawia oryginalny element wstążki dla elementu wstążki.
CMFCRibbonBaseElement::SetParentCategory Ustawia kategorię nadrzędną elementu wstążki.
CMFCRibbonBaseElement::SetParentMenu Ustawia kontener menu nadrzędnego dla elementu wstążki.
CMFCRibbonBaseElement::SetParentRibbonBar Ustawia nadrzędny pasek wstążki dla elementu wstążki.
CMFCRibbonBaseElement::SetRect Ustawia wymiary, aby wyświetlić prostokąt dla elementu wstążki.
CMFCRibbonBaseElement::SetText Ustawia tekst elementu wstążki.
CMFCRibbonBaseElement::SetTextAlwaysOnRight Ustawia tekst elementu wstążki do wyświetlenia po prawej stronie.
CMFCRibbonBaseElement::SetToolTipText Ustawia tekst etykietki narzędzia dla elementu wstążki.
CMFCRibbonBaseElement::SetVisible Ustawia stan widoczności elementu wstążki.
CMFCRibbonBaseElement::StretchHorizontally Rozciąga szerokość elementu wstążki.
CMFCRibbonBaseElement::StretchToWholeRow Zmienia wysokość wyświetlania elementu wstążki na określoną wysokość wiersza.
CMFCRibbonBaseElement::UpdateTooltipInfo Aktualizuje tekst etykietki narzędzia przy użyciu zasobu polecenia dla elementu wstążki.

Metody chronione

Nazwa/nazwisko opis
CMFCRibbonBaseElement::OnProcessKey Wywoływana przez platformę, gdy użytkownik naciska skrótu.
CMFCRibbonBaseElement::OnSetFocus Wywoływana przez platformę, gdy element wstążki odbiera lub traci fokus wejściowy.

Uwagi

Klasa CMFCRibbonBaseElement definiuje właściwości wspólne dla wszystkich elementów wstążki, które zawierają identyfikator polecenia, etykietę tekstową, tekst etykietki narzędzia, opis elementu i stan (które mogą być ukierunkowane, wyróżnione, naciskane, wyłączone, zaznaczone lub usunięte).

Rozmiar obrazu elementu wstążki jest definiowany przez RibbonImageType element członkowski, który może być jedną z następujących wartości:

  • RibbonImageLarge

  • RibbonImageSmall

W zależności od rozmiaru element wstążki wyświetla mały lub duży obraz.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CMFCRibbonBaseElement klasie . W przykładzie pokazano, jak pobrać CMFCRibbonBaseElement obiekt z CMFCRibbonStatusBar klasy, ustawić opis elementu wstążki, ustawić tekst, ustawić etykietkę klucza i ustawić tekst etykietki narzędzia dla elementu wstążki. Ten fragment kodu jest częścią przykładu Draw Client.

// CMFCRibbonStatusBar m_wndStatusBar
CMFCRibbonBaseElement *pPane = m_wndStatusBar.FindByID(nID);
pPane->SetDescription(_T("a pane"));
// CString strText
pPane->SetText(strText);
pPane->SetKeys(_T("p"));
pPane->SetToolTipText(_T("this is a pane"));

Hierarchia dziedziczenia

Obiekt CObject

CMFCRibbonBaseElement

Wymagania

Nagłówek: afxbaseribbonelement.h

CMFCRibbonBaseElement::AddToKeyList

Dodaje etykietkę klucza elementu wstążki do tablicy etykietek kluczy.

virtual void AddToKeyList(
    CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);

Parametry

arElems
[in] Odwołanie do CArray etykietek kluczy.

Uwagi

Po włączeniu funkcji etykietek wstążki platforma wyświetla etykietki wstążki, gdy użytkownik naciska ALT lub F10.

CMFCRibbonBaseElement::AddToListBox

Dodaje element wstążki do określonego pola listy poleceń wstążki.

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Parametry

pWndListBox
[in] Wskaźnik do pola listy poleceń.

bDeep
[in] Ten parametr nie jest używany.

Wartość zwracana

Indeks zerowy dodanego elementu wstążki.

Uwagi

Struktura dodaje elementy wstążki do pola listy poleceń, aby umożliwić użytkownikowi dostosowanie interfejsu użytkownika.

CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar

Wskazuje, czy element wstążki można dodać do paska narzędzi szybkiego dostępu.

virtual BOOL CanBeAddedToQuickAccessToolBar() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli można dodać element; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonBaseElement::CanBeCompacted

Wskazuje, czy rozmiar elementu wstążki może być kompaktowy.

virtual BOOL CanBeCompacted() const;

Wartość zwracana

Wartość TRUE, jeśli rozmiar elementu wstążki może być kompaktowy; w przeciwnym razie, FAŁSZ.

Uwagi

Rozmiar elementu wstążki może być kompaktowy, pośredni lub duży.

CMFCRibbonBaseElement::CanBeStretched

Wskazuje, czy wysokość elementu wstążki może wzrosnąć pionowo do wysokości wiersza wstążki.

virtual BOOL CanBeStretched();

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość TRUE. Zastąpi tę metodę, aby wskazać, czy wysokość elementu wstążki może wzrosnąć pionowo do wysokości wiersza wstążki.

CMFCRibbonBaseElement::CanBeStretchedHorizontally

Wskazuje, czy szerokość elementu wstążki może ulec zmianie.

virtual BOOL CanBeStretchedHorizontally();

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąpij tę metodę, aby wskazać, czy szerokość elementu wstążki może ulec zmianie.

CMFCRibbonBaseElement::CleanUpSizes

Czyści ustawienia wymiarów elementu wstążki.

virtual void CleanUpSizes();

Uwagi

Domyślnie ta metoda nic nie robi. Zastąp tę metodę w klasie pochodnej, aby zresetować ustawienia wymiaru elementu wstążki.

CMFCRibbonBaseElement::ClosePopupMenu

Zamyka menu podręczne elementu wstążki.

virtual void ClosePopupMenu();

Uwagi

CMFCRibbonBaseElement::CopyFrom

Kopiuje stan określonego elementu CMFCRibbonBaseElement do bieżącego obiektu.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parametry

Src
[in] Źródłowy obiekt CMFCRibbonBaseElement .

Uwagi

CMFCRibbonBaseElement::D estroyCtrl

Niszczy element wstążki.

virtual void DestroyCtrl();

Uwagi

Domyślnie ta metoda nic nie robi. Zastąp tę metodę w klasie pochodnej, aby zniszczyć element wstążki.

CMFCRibbonBaseElement::D rawImage

Rysuje obraz elementu wstążki.

virtual void DrawImage(
    CDC* pDC,
    RibbonImageType type,
    CRect rectImage);

Parametry

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

type
[in] Wyliczona wartość typu obrazu. Zobacz sekcję Uwagi, aby uzyskać listę możliwych wartości.

rectImage
[in] Prostokąt obrazu.

Uwagi

Domyślnie ta metoda nic nie robi. Zastąp tę metodę w klasie pochodnej, aby narysować obraz elementu wstążki.

W poniższej tabeli wymieniono możliwe wartości parametru typu :

Wartość Opis
RibbonImageLarge Duży rozmiar obrazu o rozmiarze 32x32 pikseli.
RibbonImageSmall Mały rozmiar obrazu o rozmiarze 16 x 16 pikseli.

CMFCRibbonBaseElement::Find

Zwraca określony wskaźnik, jeśli wskazuje bieżący obiekt.

virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);

Parametry

pElement
[in] Wskaźnik do elementu wstążki.

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli pElement wskazuje bieżący obiekt; w przeciwnym razie wartość NULL.

Uwagi

CMFCRibbonBaseElement::FindByData

Pobiera wskaźnik do elementu wstążki, jeśli zawiera określone dane.

virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);

Parametry

dwData
[in] Dane skojarzone z elementem wstążki.

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli zawiera określone dane; w przeciwnym razie wartość NULL.

Uwagi

CMFCRibbonBaseElement::FindByID

Pobiera wskaźnik do elementu wstążki, jeśli ten element jest identyfikowany przez określony identyfikator polecenia.

virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);

Parametry

uiCmdID
[in] Identyfikator polecenia dla elementu wstążki.

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli ten element jest identyfikowany przez określony identyfikator polecenia; w przeciwnym razie wartość NULL.

Uwagi

CMFCRibbonBaseElement::FindByOriginal

Pobiera wskaźnik do bieżącego elementu wstążki, jeśli jego oryginalny element wstążki jest zgodny z określonym elementem wstążki.

virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);

Parametry

pOriginal
[in] Wskaźnik do elementu wstążki.

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli jego oryginalny element wstążki pasuje do określonego elementu wstążki; w przeciwnym razie wartość NULL.

Uwagi

Elementy wstążki skopiowane do innego kontenera zachowują wskaźnik do oryginalnego elementu wstążki.

CMFCRibbonBaseElement::GetCompactSize

Zwraca kompaktowy rozmiar elementu wstążki.

virtual CSize GetCompactSize(CDC* pDC);

Parametry

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

Wartość zwracana

Kompaktowy rozmiar elementu wstążki.

Uwaga

Rozmiar kompaktowy oznacza, że element wstążki jest obcięty (wyświetla mały obraz lub obraz bez tekstu).

CMFCRibbonBaseElement::GetData

Pobiera dane zdefiniowane przez użytkownika skojarzone z elementem wstążki.

DWORD_PTR GetData() const;

Wartość zwracana

Dane zdefiniowane przez użytkownika skojarzone z elementem wstążki.

CMFCRibbonBaseElement::GetDescription

Zwraca opis elementu wstążki.

virtual CString GetDescription() const;

Wartość zwracana

Opis elementu wstążki. Opis jest wyświetlany na pasku stanu lub w etykietce narzędzia albo pod przyciskiem menu, jeśli element wstążki znajduje się w klasie CMFCRibbonMainPanel.

CMFCRibbonBaseElement::GetDroppedDown

Pobiera wskaźnik do elementu wstążki, jeśli menu podręczne zostanie usunięte.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli menu podręczne zostanie usunięte; w przeciwnym razie wartość NULL.

Uwagi

CMFCRibbonBaseElement::GetElements

Dodaje bieżący element wstążki do określonej tablicy.

virtual void GetElements(
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametry

arElements
[in, out] Tablica elementów wstążki.

Uwagi

CMFCRibbonBaseElement::GetElementsByID

Dodaje bieżący element wstążki do określonej tablicy, jeśli bieżący element wstążki zawiera określony identyfikator polecenia.

virtual void GetElementsByID(
    UINT uiCmdID,
    CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametry

uiCmdID
[in] Identyfikator polecenia elementu wstążki.

arElements
[in] Tablica elementów wstążki.

Uwagi

CMFCRibbonBaseElement::GetHighlighted

Pobiera wskaźnik do elementu wstążki, jeśli został wyróżniony.

virtual CMFCRibbonBaseElement* GetHighlighted();

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli jest wyróżniony; w przeciwnym razie wartość NULL.

Uwagi

CMFCRibbonBaseElement::GetID

Zwraca identyfikator polecenia elementu wstążki.

UINT GetID() const;

Wartość zwracana

Identyfikator polecenia elementu wstążki.

CMFCRibbonBaseElement::GetImageSize

Zwraca rozmiar obrazu elementu wstążki.

virtual CSize GetImageSize(RibbonImageType R) const;

Wartość zwracana

Rozmiar obrazu elementu wstążki.

CMFCRibbonBaseElement::GetIntermediateSize

Zwraca rozmiar elementu wstążki w stanie pośrednim.

virtual CSize GetIntermediateSize(CDC* pDC);

Parametry

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

Wartość zwracana

Rozmiar elementu wstążki w stanie pośrednim.

CMFCRibbonBaseElement::GetKeys

Zwraca etykietkę klucza skojarzona z elementem wstążki.

LPCTSTR GetKeys() const;

Wartość zwracana

Etykietka klucza skojarzona z elementem wstążki.

CMFCRibbonBaseElement::GetKeyTipRect

Pobiera prostokąt granicy etykietki klucza dla elementu wstążki.

virtual CRect GetKeyTipRect(
    CDC* pDC,
    BOOL bIsMenu);

Parametry

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

bIsMenu
[in] WARTOŚĆ TRUE, jeśli element wstążki wyświetla menu podręczne; w przeciwnym razie FAŁSZ.

Wartość zwracana

Zawsze zwraca prostokąt z 0 wartościami.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby zwrócić prostokąt granicy etykietki klucza.

CMFCRibbonBaseElement::GetKeyTipSize

Pobiera rozmiar tekstu etykietki klucza.

virtual CSize GetKeyTipSize(CDC* pDC);

Parametry

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

Wartość zwracana

Rozmiar tekstu etykietki klucza.

Uwagi

CMFCRibbonBaseElement::GetLocationInGroup

Wskazuje lokalizację wyświetlania elementu wstążki w grupie wstążki.

RibbonElementLocation GetLocationInGroup() const;

Wartość zwracana

RibbonElementLocation Wyliczona wartość. W poniższej tabeli wymieniono możliwe wartości.

Wartość Opis
RibbonElementNotInGroup Element wstążki nie jest zawarty w grupie wstążki.
RibbonElementSingleInGroup Element wstążki jest wyświetlany jako jedyny element w grupie wstążki.
RibbonElementFirstInGroup Element wstążki jest wyświetlany na lewym końcu grupy wstążki.
RibbonElementLastInGroup Element wstążki jest wyświetlany na prawym końcu grupy wstążki.
RibbonElementMiddleInGroup Element wstążki nie jest wyświetlany na końcu grupy wstążki.

Uwagi

Grupy elementów wstążki są wyrównane tylko w poziomie.

CMFCRibbonBaseElement::GetMenuKeys

Zwraca etykietkę menu dla elementu wstążki.

LPCTSTR GetMenuKeys() const;

Wartość zwracana

Etykietka menu skojarzona z elementem wstążki.

Uwagi

Po wywołaniu etykietka menu wyświetla menu podręczne.

CMFCRibbonBaseElement::GetNotifyID

Pobiera identyfikator polecenia powiadomienia dla elementu wstążki.

virtual UINT GetNotifyID();

Wartość zwracana

Identyfikator polecenia powiadomienia.

Uwagi

CMFCRibbonBaseElement::GetOriginal

Pobiera oryginalny element wstążki.

CMFCRibbonBaseElement* GetOriginal() const;

Wartość zwracana

Wskaźnik do oryginalnego elementu wstążki.

Uwagi

Elementy wstążki skopiowane do innego kontenera zachowują wskaźnik do oryginalnego elementu wstążki.

CMFCRibbonBaseElement::GetParentCategory

Pobiera kategorię wstążki dla elementu wstążki.

CMFCRibbonCategory* GetParentCategory() const;

Wartość zwracana

Wskaźnik do kategorii wstążki.

Uwagi

CMFCRibbonBaseElement::GetParentPanel

Pobiera panel wstążki zawierający element wstążki.

virtual CMFCRibbonPanel* GetParentPanel() const;

Wartość zwracana

Wskaźnik do panelu wstążki, który zawiera element wstążki.

Uwagi

CMFCRibbonBaseElement::GetParentRibbonBar

Pobiera nadrzędny pasek wstążki dla elementu wstążki.

CMFCRibbonBar* GetParentRibbonBar() const;

Wartość zwracana

Wskaźnik do nadrzędnego paska wstążki dla elementu wstążki.

Uwagi

CMFCRibbonBaseElement::GetParentWnd

Pobiera okno nadrzędne dla elementu wstążki.

virtual CWnd* GetParentWnd() const;

Wartość zwracana

Wskaźnik do okna nadrzędnego elementu wstążki, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.

Uwagi

Okno nadrzędne elementu wstążki jest klasą CMFCRibbonBar lub CMFCRibbonPanelMenuBar.

CMFCRibbonBaseElement::GetPressed

Pobiera wskaźnik do elementu wstążki, jeśli użytkownik aktualnie go naciska.

virtual CMFCRibbonBaseElement* GetPressed();

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli użytkownik aktualnie go naciśnie; w przeciwnym razie wartość NULL.

Uwagi

CMFCRibbonBaseElement::GetQuickAccessToolBarID

Pobiera identyfikator polecenia elementu wstążki, gdy znajduje się na pasku narzędzi szybkiego dostępu.

virtual UINT GetQuickAccessToolBarID() const;

Wartość zwracana

Identyfikator polecenia elementu wstążki, gdy znajduje się na pasku narzędzi szybkiego dostępu.

Uwagi

CMFCRibbonBaseElement::GetRect

Zwraca prostokąt ograniczenia elementu wstążki.

CRect GetRect() const;

Wartość zwracana

Prostokąt ograniczenia elementu wstążki. Położenie prostokąta znajduje się we współrzędnych nadrzędnej kontrolki wstążki.

CMFCRibbonBaseElement::GetRegularSize

Zwraca zwykły rozmiar elementu wstążki.

virtual CSize GetRegularSize(CDC* pDC) = 0;

Parametry

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

Wartość zwracana

Zwykły rozmiar elementu wstążki.

Uwagi

Uwaga

Zwykły rozmiar to maksymalny możliwy rozmiar elementu wstążki.

CMFCRibbonBaseElement::GetSize

Zwraca bieżący rozmiar elementu wstążki.

virtual CSize GetSize(CDC* pDC);

Parametry

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

Wartość zwracana

Bieżący rozmiar elementu wstążki.

CMFCRibbonBaseElement::GetText

Zwraca tekst skojarzony z elementem wstążki.

LPCTSTR GetText() const;

Wartość zwracana

Tekst skojarzony z elementem wstążki.

CMFCRibbonBaseElement::GetToolTipText

Zwraca tekst etykietki narzędzia elementu wstążki.

virtual CString GetToolTipText() const;

Wartość zwracana

Tekst etykietki narzędzia elementu wstążki.

CMFCRibbonBaseElement::GetTopLevelRibbonBar

Pobiera pasek wstążki najwyższego poziomu dla elementu wstążki.

CMFCRibbonBar* GetTopLevelRibbonBar() const;

Wartość zwracana

Wskaźnik na pasku wstążki najwyższego poziomu dla elementu wstążki, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.

Uwagi

CMFCRibbonBaseElement::HasCompactMode

Określa, czy element wstążki ma tryb kompaktowy.

virtual BOOL HasCompactMode() const;

Wartość zwracana

Wartość TRUE, jeśli element wstążki ma tryb kompaktowy. FAŁSZ w przeciwnym razie.

Uwagi

Uwaga

W trybie kompaktowym element wyświetla tylko mały obraz.

CMFCRibbonBaseElement::HasIntermediateMode

Określa, czy element wstążki ma tryb pośredni.

virtual BOOL HasIntermediateMode() const;

Wartość zwracana

Wartość TRUE, jeśli element wstążki ma tryb pośredni, w przeciwnym razie wartość FALSE. W trybie pośrednim element wyświetla mały obraz i tekst po prawej stronie obrazu.

Uwagi

CMFCRibbonBaseElement::HasLargeMode

Określa, czy element wstążki ma duży tryb.

virtual BOOL HasLargeMode() const;

Wartość zwracana

Wartość TRUE, jeśli element wstążki ma duży tryb. FAŁSZ w przeciwnym razie.

Uwagi

W trybie dużym element może mieć pełną wysokość panelu nadrzędnego.

CMFCRibbonBaseElement::HasMenu

Wskazuje, czy element wstążki ma menu.

virtual BOOL HasMenu() const;

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąp tę metodę w klasie pochodnej, aby wskazać, czy element wstążki ma menu.

CMFCRibbonBaseElement::HitTest

Pobiera wskaźnik do elementu wstążki, jeśli określony punkt znajduje się w nim.

virtual CMFCRibbonBaseElement* HitTest(CPoint point);

Parametry

punkt
[in] Ten parametr nie jest używany.

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli istnieje; w przeciwnym razie FAŁSZ.

Uwagi

Domyślnie ta metoda zawsze zwraca prawidłowy wskaźnik do elementu wstążki, gdy istnieje. Zastąpi tę metodę, aby wskazać, czy punkt znajduje się w elemecie wstążki.

CMFCRibbonBaseElement::IsAlignByColumn

Wskazuje, czy element wstążki jest wyrównany w pionie do innych elementów wstążki.

virtual BOOL IsAlignByColumn() const;

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość TRUE. Zastąp tę metodę w klasie pochodnej, aby wskazać, czy pochodny element wstążki jest wyrównany w pionie z innymi elementami wstążki.

CMFCRibbonBaseElement::IsAlwaysLargeImage

Wskazuje, czy rozmiar obrazu elementu wstążki jest zawsze duży.

virtual BOOL IsAlwaysLargeImage() const;

Wartość zwracana

Wartość TRUE, jeśli rozmiar obrazu elementu wstążki jest zawsze duży; w przeciwnym razie FAŁSZ.

Uwagi

Duży rozmiar obrazu to 32 x 32 piksele.

CMFCRibbonBaseElement::IsAutoRepeatMode

Wskazuje, czy element wstążki jest w trybie automatycznego powtarzania.

virtual BOOL IsAutoRepeatMode(int& nDelay) const;

Parametry

nDelay
[in] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąpij tę metodę, aby wskazać, czy element wstążki jest w trybie automatycznego powtarzania.

W trybie automatycznego powtarzania element wstążki odpowiada w określonym interwale mierzonym w milisekundach w celu trwałego wprowadzania danych przez użytkownika.

CMFCRibbonBaseElement::IsChecked

Określa, czy element wstążki jest zaznaczony.

virtual BOOL IsChecked() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli zaznaczono element wstążki; w przeciwnym razie FAŁSZ.

CMFCRibbonBaseElement::IsCompactMode

Określa, czy element wstążki jest w trybie kompaktowym.

BOOL IsCompactMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki jest w trybie kompaktowym; w przeciwnym razie FAŁSZ.

CMFCRibbonBaseElement::IsDefaultMenuLook

Wskazuje, czy element wstążki ma być wyświetlany jako polecenie podręczne.

BOOL IsDefaultMenuLook() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki ma być wyświetlany jako polecenie wyskakujące; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonBaseElement::IsDisabled

Określa, czy element wstążki jest wyłączony.

virtual BOOL IsDisabled() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki jest wyłączony; w przeciwnym razie FAŁSZ.

CMFCRibbonBaseElement::IsDroppedDown

Określa, czy element wstążki wyświetla menu podręczne i jest porzucany.

virtual BOOL IsDroppedDown() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki jest porzucany i wyświetla wyskakujące menu; w przeciwnym razie FAŁSZ.

CMFCRibbonBaseElement::IsFocused

Określa, czy element wstążki ma fokus.

virtual BOOL IsFocused() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki ma fokus; w przeciwnym razie FAŁSZ.

CMFCRibbonBaseElement::IsGalleryIcon

Wskazuje, czy element wstążki znajduje się w galerii wstążki.

virtual BOOL IsGalleryIcon() const;

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąp tę metodę w klasie pochodnej, aby wskazać, czy element wstążki znajduje się w galerii wstążki.

CMFCRibbonBaseElement::IsHighlighted

Określa, czy element wstążki jest wyróżniony.

virtual BOOL IsHighlighted() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki jest wyróżniony; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonBaseElement::IsIntermediateMode

Wskazuje, czy bieżący obraz elementu wstążki ma rozmiar pośredni.

BOOL IsIntermediateMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli obraz elementu wstążki ma rozmiar pośredni; w przeciwnym razie FAŁSZ.

Uwagi

Rozmiar obrazu pośredniego to 16 x 16 pikseli.

CMFCRibbonBaseElement::IsLargeMode

Wskazuje, czy bieżący obraz elementu wstążki ma duży rozmiar.

BOOL IsLargeMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli obraz elementu wstążki ma duży rozmiar; w przeciwnym razie FAŁSZ.

Uwagi

Duży rozmiar obrazu to 32 x 32 piksele.

CMFCRibbonBaseElement::IsMenuMode

Wskazuje, czy element wstążki znajduje się w menu.

BOOL IsMenuMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki znajduje się w menu; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonBaseElement::IsPressed

Wskazuje, czy użytkownik kliknął element wstążki.

virtual BOOL IsPressed() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli użytkownik kliknął element wstążki; w przeciwnym razie FAŁSZ.

CMFCRibbonBaseElement::IsQATMode

Wskazuje, czy element wstążki znajduje się na pasku narzędzi szybkiego dostępu.

BOOL IsQATMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki znajduje się na pasku narzędzi szybkiego dostępu; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonBaseElement::IsSeparator

Wskazuje, czy element wstążki jest separatorem wyświetlania.

virtual BOOL IsSeparator() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki jest separatorem wyświetlania; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonBaseElement::IsShowGroupBorder

Wskazuje, czy element wstążki znajduje się w grupie, która wyświetla wspólne obramowanie.

BOOL IsShowGroupBorder() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki znajduje się w grupie, która wyświetla wspólne obramowanie; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonBaseElement::IsShowTooltipOnBottom

Wskazuje, czy etykietka narzędzia jest wyświetlana pod elementem wstążki.

virtual BOOL IsShowTooltipOnBottom() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli etykietka narzędzia jest wyświetlana pod elementem wstążki; FAŁSZ, jeśli etykietka narzędzia jest wyświetlana w pobliżu wskaźnika.

Uwagi

CMFCRibbonBaseElement::IsTabStop

Wskazuje, czy element wstążki można wybrać za pomocą klawiatury.

virtual BOOL IsTabStop() const;

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość TRUE. Zastąp tę metodę, aby wskazać, czy element wstążki można wybrać za pomocą klawiatury.

CMFCRibbonBaseElement::IsTextAlwaysOnRight

Wskazuje, czy tekst elementu wstążki jest wyświetlany po prawej stronie.

BOOL IsTextAlwaysOnRight() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli tekst elementu wstążki jest wyświetlany po prawej stronie; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonBaseElement::IsVisible

Wskazuje, czy element wstążki jest obecnie wyświetlany.

BOOL IsVisible() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki jest aktualnie wyświetlany; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonBaseElement::IsWholeRowHeight

Wskazuje, czy wysokość wyświetlania elementu wstążki jest taka sama jak wysokość wyświetlania panelu wstążki, który go zawiera.

virtual BOOL IsWholeRowHeight() const;

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąpij tę metodę, aby wskazać, czy wysokość wyświetlania elementu wstążki jest taka sama jak wysokość wyświetlania panelu wstążki, który go zawiera.

CMFCRibbonBaseElement::NotifyCommand

Wysyła powiadomienie polecenia do okna nadrzędnego elementu wstążki.

BOOL NotifyCommand(BOOL bWithDelay = FALSE);

Parametry

bWithDelay
[in] WARTOŚĆ TRUE, aby dodać powiadomienie polecenia do kolejki komunikatów okna nadrzędnego; FAŁSZ, aby natychmiast wysłać wiadomość do okna nadrzędnego.

Wartość zwracana

WARTOŚĆ TRUE, jeśli wiadomość została wysłana; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonBaseElement::NotifyHighlightListItem

Powiadamia okno nadrzędne paska wstążki, gdy użytkownik wyróżni element wstążki znajdujący się na liście.

virtual void NotifyHighlightListItem(int nIndex);

Parametry

nIndex
[in] Indeks elementu wstążki na liście.

Uwagi

CMFCRibbonBaseElement::OnAddToQAToolbar

Dodaje element wstążki do określonego paska narzędzi szybkiego dostępu.

virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);

Parametry

qat
[in] Pasek narzędzi szybkiego dostępu.

Wartość zwracana

Zawsze zwraca wartość TRUE wskazującą, że element wstążki został dodany do paska narzędzi szybkiego dostępu.

Uwagi

CMFCRibbonBaseElement::OnAfterChangeRect

Aktualizuje etykietkę narzędzia elementu wstążki.

virtual void OnAfterChangeRect(CDC* pDC);

Parametry

PDC
[in] Ten parametr nie jest używany.

Uwagi

Domyślnie ta metoda aktualizuje etykietkę narzędzia dla elementu wstążki. Zastąpij tę metodę, aby zaktualizować element wstążki po zmianie jego prostokąta wyświetlania.

CMFCRibbonBaseElement::OnAutoRepeat

Aktualizuje element wstążki w odpowiedzi na trwałe dane wejściowe użytkownika.

virtual BOOL OnAutoRepeat();

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąpij tę metodę w celu przetworzenia trwałych danych wejściowych użytkownika.

CMFCRibbonBaseElement::OnCalcTextSize

Oblicza rozmiar tekstu dla elementu wstążki.

virtual void OnCalcTextSize(CDC* pDC);

Parametry

PDC
[in] Ten parametr nie jest używany.

Uwagi

Domyślnie ta metoda nic nie robi. Zastąpi tę metodę, aby obliczyć rozmiar tekstu dla elementu wstążki.

CMFCRibbonBaseElement::OnChangeMenuHighlight

Wywoływana przez platformę, gdy wyróżnienie zmienia się dla elementu wstążki znajdującego się w menu.

virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
    CMFCRibbonBaseElement* pHot);

Parametry

pPanelMenuBar
[in] Ten parametr nie jest używany.

Fot
[in] Ten parametr nie jest używany.

Uwagi

Domyślnie ta metoda nic nie robi. Zastąpuj tę metodę, aby zaktualizować element wstążki, który znajduje się w menu po zmianie wyróżnienia.

CMFCRibbonBaseElement::OnDraw

Wywoływana przez strukturę w celu narysowania elementu wstążki.

virtual void OnDraw(CDC* pDC) = 0;

Parametry

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

Uwagi

Zastąp tę metodę w klasie pochodnej, jeśli chcesz dostosować rysunek określonego elementu wstążki.

CMFCRibbonBaseElement::OnDrawKeyTip

Wywoływana przez strukturę, aby narysować etykietkę dla elementu wstążki.

virtual void OnDrawKeyTip(
    CDC* pDC,
    const CRect& rect,
    BOOL bIsMenu);

Parametry

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

Rect
[in] Prostokąt granicy dla etykietki klucza.

bIsMenu
[in] WARTOŚĆ TRUE, jeśli etykietka klucza jest przyciskiem menu podręcznego; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonBaseElement::OnDrawMenuImage

Wywoływana przez platformę, gdy obraz menu dla elementu wstążki jest rysowany.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    CRect rect);

Parametry

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

Rect
[in] Prostokąt obrazu menu.

Wartość zwracana

Zawsze zwraca wartość TRUE, aby wskazać, że obraz został narysowany.

Uwagi

CMFCRibbonBaseElement::OnDrawOnList

Wywoływana przez strukturę w celu narysowania elementu wstążki w polu listy poleceń.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla elementu wstążki.

strText
[in] Tekst wyświetlany.

nTextOffset
[in] Odległość w pikselach od lewej strony pola listy do tekstu wyświetlanego.

Rect
[in] Prostokąt wyświetlania elementu wstążki.

bIsSelected
[in] Ten parametr nie jest używany.

bHighlighted
[in] Ten parametr nie jest używany.

Uwagi

Pole listy poleceń wyświetla elementy wstążki, aby umożliwić użytkownikom dostosowywanie paska narzędzi szybkiego dostępu.

CMFCRibbonBaseElement::OnKey

Wywoływana przez platformę, gdy użytkownik naciska etykietkę, a element wstążki ma fokus.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parametry

bIsMenuKey
[in] WARTOŚĆ TRUE, jeśli etykietka klucza wyświetla menu podręczne; w przeciwnym razie, FAŁSZ.

Wartość zwracana

WARTOŚĆ TRUE, jeśli zdarzenie zostało obsłużone; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonBaseElement::OnMenuKey

Wywoływana przez platformę, gdy użytkownik naciska etykietkę menu na panelu głównym.

virtual BOOL OnMenuKey(UINT nUpperChar);

Parametry

nUpperChar
[in] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąpi tę metodę, aby odpowiedzieć, gdy użytkownik naciśnie etykietkę menu na panelu głównym.

CMFCRibbonBaseElement::OnProcessKey

Wywoływana przez platformę, gdy użytkownik naciska skrótu.

virtual BOOL OnProcessKey(UINT nChar);

Parametry

nChar
[in] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Zastąpi tę metodę, jeśli chcesz, aby element wstążki przetwarzał skrótu.

CMFCRibbonBaseElement::OnRTLChanged

Wywoływana przez platformę, gdy układ zmienia kierunek.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametry

bIsRTL
[in] Ten parametr nie jest używany.

Uwagi

Domyślnie ta metoda nic nie robi. Zastąpij tę metodę, aby dostosować element wstążki, gdy układ zmieni kierunek. Domyślny kierunek układu to od lewej do prawej.

CMFCRibbonBaseElement::OnSetFocus

Wywoływana przez platformę, gdy element wstążki odbiera lub traci fokus wejściowy.

virtual void OnSetFocus(BOOL B);

Uwagi

Zastąp tę metodę w klasie pochodnej, jeśli aplikacja ma obsługiwać zmianę fokusu elementu wstążki.

CMFCRibbonBaseElement::OnShow

Wywoływana przez strukturę w celu pokazania lub ukrycia elementu wstążki.

virtual void OnShow(BOOL bShow);

Parametry

bShow
[in] Ten parametr nie jest używany.

Uwagi

Domyślnie ta metoda nic nie robi. Zastąpij tę metodę, aby pokazać lub ukryć element wstążki.

CMFCRibbonBaseElement::OnShowPopupMenu

Wywoływana przez platformę przed elementem wstążki jest wyświetlana wyskakujące menu.

virtual void OnShowPopupMenu();

Uwagi

Ta metoda powiadamia okno nadrzędne paska wstążki, że element wstążki wyświetli menu podręczne.

CMFCRibbonBaseElement::P ostMenuCommand

Zamyka menu podręczne elementu wstążki i wysyła bliski komunikat do menu nadrzędnego.

void PostMenuCommand(UINT uiCmdId);

Parametry

uiCmdId
[in] Parametr nie jest używany.

Uwagi

Komunikat zamknięcia jest wysyłany tylko wtedy, gdy element wstążki znajduje się w menu podręcznym.

CMFCRibbonBaseElement::Redraw

Aktualizuje ekran elementu wstążki.

virtual void Redraw();

Uwagi

Ta metoda ponownie rysuje prostokąt wyświetlania dla elementu wstążki, wywołując CWnd ::RedrawWindow z ustawionymi flagami RDW_INVALIDATE, RDW_ERASE i RDW_UPDATENOW.

CMFCRibbonBaseElement::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.

CMFCRibbonBaseElement::SetCompactMode

Ustawia rozmiar wyświetlania elementu wstążki.

virtual void SetCompactMode(BOOL bCompactMode = TRUE);

Parametry

bCompactMode
[in] WARTOŚĆ TRUE, aby zmniejszyć rozmiar wyświetlania elementu wstążki; FAŁSZ, aby zwiększyć rozmiar wyświetlania elementu wstążki.

Uwagi

Poniższa tabela zawiera podsumowanie logiki dla tej metody.

bCompactMode Bieżący rozmiar elementu wstążki Nowy rozmiar elementu wstążki
PRAWDA CD Nie widać żadnej zmiany.
PRAWDA Średni Kompaktowanie, jeśli jest to możliwe.
PRAWDA Duży Pośredni, jeśli jest to możliwe.
FAŁSZ CD Pośredni, jeśli jest to możliwe; w przeciwnym razie duży.

CMFCRibbonBaseElement::SetData

Kojarzy element danych z elementem wstążki.

void SetData(DWORD_PTR dwData);

Parametry

dwData
[in] Wartość danych.

CMFCRibbonBaseElement::SetDefaultMenuLook

Ustawia element wstążki, który ma być wyświetlany jako polecenie podręczne.

void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);

Parametry

bIsDefaultMenuLook
[in] WARTOŚĆ TRUE, aby ustawić element wstążki, który ma być wyświetlany jako polecenie podręczne; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonBaseElement::SetDescription

Ustawia opis elementu wstążki.

virtual void SetDescription(LPCTSTR lpszText);

Parametry

lpszText
[in] Opis elementu wstążki.

Uwagi

Platforma wyświetla nowy opis na pasku stanu lub w etykietce narzędzia lub w obszarze przycisku menu.

CMFCRibbonBaseElement::SetID

Ustawia identyfikator polecenia elementu wstążki.

virtual void SetID(UINT nID);

Parametry

Nid
[in] Identyfikator polecenia.

CMFCRibbonBaseElement::SetInitialMode

Ustawia początkowy rozmiar wyświetlania elementu wstążki.

virtual void SetInitialMode(BOOL bOneRow = FALSE);

Parametry

bOneRow
[in] WARTOŚĆ TRUE, aby ograniczyć rozmiar wyświetlania elementu wstążki do kompaktowania lub pośredniego; w przeciwnym razie, FAŁSZ.

Uwagi

Rozmiar wyświetlania elementów wstążki może być kompaktowy, pośredni lub duży.

CMFCRibbonBaseElement::SetKeys

Ustawia etykietki dla elementu wstążki.

virtual void SetKeys(
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys=NULL);

Parametry

lpszKeys
[in] Etykietka elementu wstążki.

lpszMenuKeys
[in] Etykietka menu podręcznego elementu wstążki.

CMFCRibbonBaseElement::SetOriginal

Ustawia oryginalny element wstążki dla elementu wstążki.

virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);

Parametry

pOriginal
[in] Wskaźnik do elementu wstążki.

Uwagi

Elementy wstążki skopiowane do innego kontenera zachowują wskaźnik do oryginalnego elementu wstążki.

CMFCRibbonBaseElement::SetParentCategory

Ustawia kategorię nadrzędną elementu wstążki.

virtual void SetParentCategory(CMFCRibbonCategory* pParent);

Parametry

PParent
[in] Wskaźnik do kategorii wstążki.

Uwagi

Grupy z kartami w kontrolkach wstążki są nazywane kategoriami.

CMFCRibbonBaseElement::SetParentMenu

Ustawia kontener menu nadrzędnego dla elementu wstążki.

virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);

Parametry

pMenuBar
[in] Menu nadrzędne.

Uwagi

CMFCRibbonBaseElement::SetParentRibbonBar

Ustawia nadrzędny pasek wstążki dla elementu wstążki.

virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);

Parametry

pRibbonBar
[in] Wskaźnik do nadrzędnego paska wstążki.

Uwagi

CMFCRibbonBaseElement::SetRect

Ustawia wymiary prostokąta wyświetlania dla elementu wstążki.

void SetRect(CRect rect);

Parametry

Rect
[in] Wymiary prostokąta.

Uwagi

CMFCRibbonBaseElement::SetText

Ustawia tekst i etykietkę dla elementu wstążki.

virtual void SetText(LPCTSTR lpszText);

Parametry

lpszText
[in] Tekst i etykietka elementu wstążki.

Uwagi

Aby ustawić etykietkę dla elementu wstążki, dołącz sekwencję ucieczki nowego wiersza, a następnie znaki etykietki klucza na wartość lpszText.

Przykład

//Set the text for the ribbon element
SetText(_T("Margins"))
//Set the text and a single-letter keytip
SetText(_T("Margins\nm"))
//Set the text and a multiple-letter keytip
SetText(_T("Line Numbers\nln"))

CMFCRibbonBaseElement::SetTextAlwaysOnRight

Ustawia tekst elementu wstążki do wyświetlenia po prawej stronie.

virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);

Parametry

Zestaw bSet
[in] WARTOŚĆ TRUE, aby wyświetlić tekst po prawej stronie; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonBaseElement::SetToolTipText

Ustawia tekst etykietki narzędzia dla elementu wstążki.

virtual void SetToolTipText(LPCTSTR lpszText);

Parametry

lpszText
[in] Tekst etykietki narzędzia.

CMFCRibbonBaseElement::SetVisible

Ustawia widoczność elementu wstążki.

void SetVisible(BOOL bIsVisible);

Parametry

bIsVisible
[in] WARTOŚĆ TRUE, aby wyświetlić element wstążki; FAŁSZ, aby ukryć element wstążki.

Uwagi

CMFCRibbonBaseElement::StretchHorizontally

Rozciąga szerokość elementu wstążki.

virtual void StretchHorizontally();

Uwagi

Domyślnie ta metoda generuje błąd asercji w kompilacjach debugowania i dlatego nie powinien być wywoływany. Zastąp tę metodę, aby rozciągnąć szerokość elementu wstążki.

CMFCRibbonBaseElement::StretchToWholeRow

Zmienia wysokość wyświetlania elementu wstążki na określoną wysokość wiersza.

virtual BOOL StretchToWholeRow(
    CDC* pDC,
    int nHeight);

Parametry

PDC
[in] Ten parametr nie jest używany.

nHeight
[in] Wysokość wiersza.

Wartość zwracana

WARTOŚĆ TRUE, jeśli ustawiono wysokość wyświetlacza; w przeciwnym razie, FAŁSZ.

Uwagi

Zastąpij tę metodę, aby zmienić wysokość wyświetlania elementu wstążki na określoną wysokość wiersza.

CMFCRibbonBaseElement::UpdateTooltipInfo

Aktualizuje tekst etykietki narzędzia przy użyciu zasobu polecenia dla elementu wstążki.

virtual void UpdateTooltipInfo();

Uwagi

CMFCRibbonBaseElement::HasFocus

Wskazuje, czy element nadrzędny ma fokus klawiatury.

virtual BOOL HasFocus() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element wstążki jest ukierunkowany; w przeciwnym razie FAŁSZ.

Uwagi

Zobacz też

Wykres hierarchii
Klasy