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:
RibbonImageLargeRibbonImageSmall
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
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 | Compact | 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 | Compact | 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.