Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
A CMFCRibbonBaseElement osztály az összes elem alaposztálya, amelyet hozzáadhat egy menüszalagsávhoz. A menüszalag elemei közé tartoznak például a menüszalag gombjai, a menüszalag jelölőnégyzetei és a menüszalag kombinált mezői.
Szintaxis
class CMFCRibbonBaseElement : public CObject
Tagok
Nyilvános konstruktorok
| Név | Leírás |
|---|---|
CMFCRibbonBaseElement |
Egy CMFCRibbonBaseElement objektumot hoz létre. |
Nyilvános metódusok
| Név | Leírás |
|---|---|
| CMFCRibbonBaseElement::AddToKeyList | A menüszalag eleméhez hozzáad egy kulcsleírást tartalmazó tömbhöz. |
| CMFCRibbonBaseElement::AddToListBox | Hozzáad egy menüszalagelemet a megadott menüszalagparancsok listájához. |
| CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar | Azt jelzi, hogy a menüszalag elem hozzáadható-e a gyorselérési eszköztárhoz. |
| CMFCRibbonBaseElement::CanBeCompacted | Azt jelzi, hogy a szalagelem mérete tömör lehet-e. |
| CMFCRibbonBaseElement::CanBeStretched | Azt jelzi, hogy a menüszalag elemének magassága függőlegesen növekedhet-e a szalagsor magasságára. |
| CMFCRibbonBaseElement::CanBeStretchedHorizontally | Azt jelzi, hogy a menüszalag elemének szélessége változhat-e. |
| CMFCRibbonBaseElement::CleanUpSizes | Törli a menüszalag elemének dimenzióbeállításait. |
| CMFCRibbonBaseElement::ClosePopupMenu | Bezárja a menüszalag elemének előugró menüjét. |
| CMFCRibbonBaseElement::CopyFrom | Másolja a megadott CMFCRibbonBaseElement állapotát az aktuális objektumba. |
| CMFCRibbonBaseElement::D estroyCtrl | Megsemmisíti a menüszalag elemet. |
| CMFCRibbonBaseElement::D rawImage | A menüszalag elem képének rajzolása. |
| CMFCRibbonBaseElement::Find | A megadott mutatót adja vissza a menüszalag eleméhez, ha az az aktuális objektumra mutat. |
| CMFCRibbonBaseElement::FindByData | A menüszalag elemére mutató mutatót kér le, ha a megadott adatokat tartalmazza. |
| CMFCRibbonBaseElement::FindByID | A menüszalag elemére mutató mutatót kér le, ha ezt az elemet a megadott parancsazonosító azonosítja. |
| CMFCRibbonBaseElement::FindByOriginal | A menüszalag elemére mutató mutatót kér le, ha az eredeti menüszalageleme megfelel a megadott menüszalagelemnek. |
| CMFCRibbonBaseElement::GetCompactSize | A menüszalag elem kompakt méretét adja vissza. |
| CMFCRibbonBaseElement::GetData | Lekéri a menüszalag eleméhez társított felhasználó által megadott adatokat. |
| CMFCRibbonBaseElement::GetDescription | A menüszalag elemének leírását adja vissza. |
| CMFCRibbonBaseElement::GetDroppedDown | A menüszalag elemére mutató mutatót kér le, ha az előugró menü le van állítva. |
| CMFCRibbonBaseElement::GetElements | Hozzáadja az aktuális menüszalagelemet a megadott tömbhöz. |
| CMFCRibbonBaseElement::GetElementsByID | Hozzáadja az aktuális menüszalagelemet a megadott tömbhöz, ha az aktuális menüszalagelem tartalmazza a megadott parancsazonosítót. |
| CMFCRibbonBaseElement::GetHighlighted | A menüszalag elemére mutató mutatót kér le, ha ki van emelve. |
| CMFCRibbonBaseElement::GetID | A menüszalag elemének parancsazonosítóját adja vissza. |
| CMFCRibbonBaseElement::GetImageSize | A menüszalag elem képméretét adja vissza. |
| CMFCRibbonBaseElement::GetIntermediateSize | A menüszalag elemének méretét adja vissza a köztes állapotában. |
| CMFCRibbonBaseElement::GetKeys | A menüszalag eleméhez társított kulcsleírást adja vissza. |
| CMFCRibbonBaseElement::GetKeyTipRect | Lekéri a menüszalag eleméhez tartozó kulcsleírás-határ téglalapot. |
| CMFCRibbonBaseElement::GetKeyTipSize | Lekéri a kulcsleírás szövegének méretét. |
| CMFCRibbonBaseElement::GetLocationInGroup | Egy menüszalagcsoport menüszalagelemének megjelenítési helyét jelzi. |
| CMFCRibbonBaseElement::GetMenuKeys | A gombhoz társított kulcsleírásokat adja vissza. |
| CMFCRibbonBaseElement::GetNotifyID | Lekéri a menüszalagelem értesítési parancsazonosítóját. |
| CMFCRibbonBaseElement::GetOriginal | Lekéri az eredeti menüszalagelemet. |
| CMFCRibbonBaseElement::GetParentCategory | Lekéri a menüszalag elem menüszalag kategóriáját. |
| CMFCRibbonBaseElement::GetParentPanel | Lekéri a menüszalag elemét tartalmazó menüszalagpanelt. |
| CMFCRibbonBaseElement::GetParentRibbonBar | Lekéri a menüszalag eleméhez tartozó szülő menüszalagsávot. |
| CMFCRibbonBaseElement::GetParentWnd | Lekéri a menüszalag elemének szülőablakát. |
| CMFCRibbonBaseElement::GetPressed | A menüszalag elemére mutató mutatót kér le, ha a felhasználó éppen lenyomja. |
| CMFCRibbonBaseElement::GetQuickAccessToolBarID | Lekéri a menüszalag elemének parancsazonosítóját, amikor az a gyorselérési eszköztáron található. |
| CMFCRibbonBaseElement::GetRect | A menüszalag elemének határoló téglalapját adja vissza. |
| CMFCRibbonBaseElement::GetRegularSize | A menüszalag elemének normál méretét adja vissza. |
| CMFCRibbonBaseElement::GetSize | A menüszalag elemének aktuális méretét adja vissza. |
| CMFCRibbonBaseElement::GetText | A menüszalag eleméhez társított szöveget adja vissza. |
| CMFCRibbonBaseElement::GetToolTipText | A menüszalag elemleírásának szövegét adja vissza. |
| CMFCRibbonBaseElement::GetTopLevelRibbonBar | Lekéri a menüszalag elemének felső szintű menüszalagsávja. |
| CMFCRibbonBaseElement::HasCompactMode | Azt határozza meg, hogy a menüszalag elem kompakt üzemmóddal rendelkezik-e. |
| CMFCRibbonBaseElement::HasFocus | Azt jelzi, hogy a szülőelem rendelkezik-e billentyűzetfókusszal. |
| CMFCRibbonBaseElement::HasIntermediateMode | Azt határozza meg, hogy a menüszalag elemének van-e köztes módja. |
| CMFCRibbonBaseElement::HasLargeMode | Megadja, hogy a menüszalag elemének nagy üzemmódja van-e. |
| CMFCRibbonBaseElement::HasMenu | Azt jelzi, hogy a menüszalag elemének van-e menüje. |
| CMFCRibbonBaseElement::HitTest | A menüszalag elemére mutató mutatót kér le, ha a megadott pont található benne. |
| CMFCRibbonBaseElement::IsAlignByColumn | Azt jelzi, hogy a menüszalag eleme függőlegesen van-e igazítva más menüszalagelemekhez. |
| CMFCRibbonBaseElement::IsAlwaysLargeImage | Azt jelzi, hogy a menüszalag elemének képmérete mindig nagy-e. |
| CMFCRibbonBaseElement::IsAutoRepeatMode | Azt jelzi, hogy a menüszalag elem automatikus ismétlési módban van-e. |
| CMFCRibbonBaseElement::IsChecked | Megadja, hogy a menüszalag elem be van-e jelölve. |
| CMFCRibbonBaseElement::IsCompactMode | Megadja, hogy a menüszalag elem kompakt módban van-e. |
| CMFCRibbonBaseElement::IsDefaultMenuLook | |
| CMFCRibbonBaseElement::IsDisabled | Megadja, hogy a menüszalag elem le van-e tiltva. |
| CMFCRibbonBaseElement::IsDroppedDown | Meghatározza, hogy a menüszalag eleme megjelenít-e egy előugró menüt, és le van-e dobott állapotban. |
| CMFCRibbonBaseElement::IsFocused | Megadja, hogy a menüszalag elem rendelkezik-e a fókuszsal. |
| CMFCRibbonBaseElement::IsGalleryIcon | Azt jelzi, hogy a menüszalag eleme szerepel-e egy menüszalaggyűjteményben. |
| CMFCRibbonBaseElement::IsHighlighted | Megadja, hogy a menüszalag elem ki van-e emelve. |
| CMFCRibbonBaseElement::IsIntermediateMode | Azt jelzi, hogy a menüszalag elemének aktuális képe köztes méretű-e. |
| CMFCRibbonBaseElement::IsLargeMode | Azt jelzi, hogy a menüszalag elemének aktuális képe nagy méretű-e. |
| CMFCRibbonBaseElement::IsMenuMode | Azt jelzi, hogy a menüszalag elem szerepel-e a menüben. |
| CMFCRibbonBaseElement::IsPressed | Azt jelzi, hogy a felhasználó a menüszalag elemére kattintott-e. |
| CMFCRibbonBaseElement::IsQATMode | Azt jelzi, hogy a menüszalag eleme szerepel-e a gyorselérési eszköztárban. |
| CMFCRibbonBaseElement::IsSeparator | Azt jelzi, hogy a menüszalag eleme megjelenítendő elválasztó-e. |
| CMFCRibbonBaseElement::IsShowGroupBorder | Azt jelzi, hogy a menüszalag eleme szerepel-e egy közös szegélyt megjelenítő csoportban. |
| CMFCRibbonBaseElement::IsShowTooltipOnBottom | Azt jelzi, hogy az elemleírás megjelenik-e a menüszalag elem alatt. |
| CMFCRibbonBaseElement::IsTabStop | Azt jelzi, hogy a menüszalag elem kijelölhető-e a billentyűzettel. |
| CMFCRibbonBaseElement::IsTextAlwaysOnRight | Azt jelzi, hogy a menüszalag elemének szövege megjelenik-e a jobb oldalon. |
| CMFCRibbonBaseElement::IsVisible | Azt jelzi, hogy a menüszalag elem jelenleg megjelenik-e. |
| CMFCRibbonBaseElement::IsWholeRowHeight | Azt jelzi, hogy a menüszalag elemének megjelenítési heige megegyezik-e az azt tartalmazó menüszalagpanel megjelenítési magasságával. |
| CMFCRibbonBaseElement::NotifyCommand | Parancsértesítést küld a menüszalag elem szülőablakának. |
| CMFCRibbonBaseElement::NotifyHighlightListItem | Értesíti a menüszalagsáv szülőablakát, ha egy felhasználó kiemel egy listában található menüszalagelemet. |
| CMFCRibbonBaseElement::OnAddToQAToolbar | Hozzáadja a menüszalag elemet a megadott gyorselérési eszköztárhoz. |
| CMFCRibbonBaseElement::OnAfterChangeRect | Frissíti a menüszalag elemleírását. |
| CMFCRibbonBaseElement::OnAutoRepeat | Frissíti a menüszalag elemét a tartós felhasználói bemenetre válaszul. |
| CMFCRibbonBaseElement::OnCalcTextSize | Kiszámítja a menüszalag eleméhez tartozó szöveg méretét. |
| CMFCRibbonBaseElement::OnChangeMenuHighlight | A keretrendszer meghívta, amikor egy menüben található menüszalagelem kiemelése megváltozik. |
| CMFCRibbonBaseElement::OnDraw | A keretrendszer meghívta a menüszalag elemének rajzolásához. |
| CMFCRibbonBaseElement::OnDrawKeyTip | A keretrendszer meghívta, hogy megrajzolja a menüszalag elemének kulcsleírását. |
| CMFCRibbonBaseElement::OnDrawMenuImage | A keretrendszer meghívja a menüszalag eleméhez tartozó menükép rajzolásakor. |
| CMFCRibbonBaseElement::OnDrawOnList | A keretrendszer meghívta, hogy megrajzolja a menüszalag elemét egy parancslistamezőben. |
| CMFCRibbonBaseElement::OnKey | A keretrendszer meghívja, amikor a felhasználó lenyom egy billentyűt, és a menüszalag elem a fókuszban van. |
| CMFCRibbonBaseElement::OnMenuKey | |
| CMFCRibbonBaseElement::OnRTLChanged | A keretrendszer meghívta, amikor az elrendezés irányt változtat. |
| CMFCRibbonBaseElement::OnShow | A keretrendszer meghívta a menüszalag elemének megjelenítésére vagy elrejtésére. |
| CMFCRibbonBaseElement::OnShowPopupMenu | A keretrendszer meghívja, amikor a menüszalag eleme egy előugró menüt fog megjeleníteni. |
| CMFCRibbonBaseElement::P ostMenuCommand | |
| CMFCRibbonBaseElement:: újraírása | Frissíti a menüszalag elemének megjelenítését. |
| CMFCRibbonBaseElement::SetACCData | Beállítja a menüszalag elemének akadálymentességi adatait. |
| CMFCRibbonBaseElement::SetCompactMode | A menüszalag elem megjelenítési méretének beállítása. |
| CMFCRibbonBaseElement::SetData | Adatelemet társít a menüszalag eleméhez. |
| CMFCRibbonBaseElement::SetDefaultMenuLook | |
| CMFCRibbonBaseElement::SetDescription | Beállítja a menüszalag elemének leírását. |
| CMFCRibbonBaseElement::SetID | Beállítja a menüszalag elemének parancsazonosítóját. |
| CMFCRibbonBaseElement::SetInitialMode | Beállítja a menüszalag elemének kezdeti megjelenítési méretét. |
| CMFCRibbonBaseElement::SetKeys | Beállítja a menüszalag elemének kulcsleírását. |
| CMFCRibbonBaseElement::SetOriginal | Beállítja a menüszalag elemének eredeti menüszalagelemét. |
| CMFCRibbonBaseElement::SetParentCategory | A menüszalag elem szülőkategóriájának beállítása. |
| CMFCRibbonBaseElement::SetParentMenu | Beállítja a menüszalag eleméhez tartozó szülőmenü-tárolót. |
| CMFCRibbonBaseElement::SetParentRibbonBar | Beállítja a menüszalag eleméhez tartozó szülő menüszalagsávot. |
| CMFCRibbonBaseElement::SetRect | Beállítja a menüszalag eleméhez tartozó megjelenítési téglalap méretét. |
| CMFCRibbonBaseElement::SetText | Beállítja a menüszalag elemének szövegét. |
| CMFCRibbonBaseElement::SetTextAlwaysOnRight | Beállítja a menüszalag elemének szövegét a jobb oldalon való megjelenítésre. |
| CMFCRibbonBaseElement::SetToolTipText | Beállítja a menüszalag elemleírásának szövegét. |
| CMFCRibbonBaseElement::SetVisible | Beállítja a menüszalag elem láthatósági állapotát. |
| CMFCRibbonBaseElement::StretchHorizontally | Kinyújtja a menüszalag elemének szélességét. |
| CMFCRibbonBaseElement::StretchToWholeRow | A menüszalag elemének megjelenítési magasságát a megadott sormagasságra módosítja. |
| CMFCRibbonBaseElement::UpdateTooltipInfo | Frissíti az elemleírás szövegét a menüszalag eleméhez tartozó parancserőforrás használatával. |
Védett metódusok
| Név | Leírás |
|---|---|
| CMFCRibbonBaseElement::OnProcessKey | A keretrendszer meghívja, amikor a felhasználó lenyom egy billentyűparancsot. |
| CMFCRibbonBaseElement::OnSetFocus | A keretrendszer meghívja, amikor egy menüszalagelem megkapja vagy elveszíti a bemeneti fókuszt. |
Megjegyzések
A CMFCRibbonBaseElement osztály határozza meg a parancsazonosítót, a szövegcímkét, az elemleírást, az elemleírást és az állapotot (amely szűrhető, kiemelhető, le van nyomva, letiltva, bejelölve vagy letörve).
A menüszalag elemének képméretét a RibbonImageType tag határozza meg, amely az alábbi értékek egyike lehet:
RibbonImageLargeRibbonImageSmall
Méretétől függően egy menüszalagelem kis vagy nagy képet jelenít meg.
Példa
Az alábbi példa bemutatja, hogyan használhat különböző metódusokat a CMFCRibbonBaseElement osztályban. A példa bemutatja, hogyan kérhet le egy CMFCRibbonBaseElement objektumot egy CMFCRibbonStatusBar osztályból, hogyan állíthatja be a menüszalag elemének leírását, hogyan állíthatja be a szöveget, állíthat be egy kulcsleírást, és hogyan állíthatja be a menüszalag elemleírásának szövegét. Ez a kódrészlet a Ügyfélmintarésze.
// 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"));
Öröklési hierarchia
Követelmények
fejléc: afxbaseribbonelement.h
CMFCRibbonBaseElement::AddToKeyList
A menüszalag eleméhez hozzáad egy kulcsleírást tartalmazó tömbhöz.
virtual void AddToKeyList(
CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);
Paraméterek
arElems
[in] Hivatkozás a kulcsleírások CArray.
Megjegyzések
Ha a menüszalag billentyűtipjei funkció engedélyezve van, a keretrendszer a menüszalag billentyűleírásait jeleníti meg, amikor a felhasználó lenyomja az ALT vagy az F10 billentyűt.
CMFCRibbonBaseElement::AddToListBox
Hozzáad egy menüszalagelemet a megadott menüszalagparancsok listájához.
virtual int AddToListBox(
CMFCRibbonCommandsListBox* pWndListBox,
BOOL bDeep);
Paraméterek
pWndListBox
[in] Mutató egy parancslistamezőre.
bDeep
[in] Ezt a paramétert nem használja a rendszer.
Visszaadott érték
A hozzáadott menüszalagelem nulla alapú indexe.
Megjegyzések
A keretrendszer menüszalagelemeket ad hozzá egy parancslistamezőhöz, hogy a felhasználó testre szabhassa a felhasználói felületet.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar
Azt jelzi, hogy a menüszalag elem hozzáadható-e a gyorselérési eszköztárhoz.
virtual BOOL CanBeAddedToQuickAccessToolBar() const;
Visszaadott érték
IGAZ, ha az elem hozzáadható; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::CanBeCompacted
Azt jelzi, hogy a szalagelem mérete tömör lehet-e.
virtual BOOL CanBeCompacted() const;
Visszaadott érték
IGAZ, ha a szalagelem mérete kompakt lehet; egyéb esetben HAMIS.
Megjegyzések
A szalagelemek mérete lehet tömör, köztes vagy nagy.
CMFCRibbonBaseElement::CanBeStretched
Azt jelzi, hogy a menüszalag elemének magassága függőlegesen növekedhet-e a szalagsor magasságára.
virtual BOOL CanBeStretched();
Visszaadott érték
Mindig IGAZ értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig IGAZ értéket ad vissza. Bírálja felül ezt a módszert, hogy jelezze, hogy a menüszalag elemének magassága függőlegesen a szalagsor magasságára nőhet-e.
CMFCRibbonBaseElement::CanBeStretchedHorizontally
Azt jelzi, hogy a menüszalag elemének szélessége változhat-e.
virtual BOOL CanBeStretchedHorizontally();
Visszaadott érték
Mindig HAMIS értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig HAMIS értéket ad vissza. Bírálja felül ezt a módszert, hogy jelezze, hogy a menüszalag elemének szélessége változhat-e.
CMFCRibbonBaseElement::CleanUpSizes
Törli a menüszalag elemének dimenzióbeállításait.
virtual void CleanUpSizes();
Megjegyzések
Alapértelmezés szerint ez a metódus nem tesz semmit. Felülbírálja ezt a metódust egy származtatott osztályban a menüszalagelem dimenzióbeállításainak alaphelyzetbe állításához.
CMFCRibbonBaseElement::ClosePopupMenu
Bezárja a menüszalag elem előugró menüjét.
virtual void ClosePopupMenu();
Megjegyzések
CMFCRibbonBaseElement::CopyFrom
Másolja a megadott CMFCRibbonBaseElement állapotát az aktuális objektumba.
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
Paraméterek
src
[in] A forrás CMFCRibbonBaseElement objektumot.
Megjegyzések
CMFCRibbonBaseElement::D estroyCtrl
Megsemmisíti a menüszalag elemet.
virtual void DestroyCtrl();
Megjegyzések
Alapértelmezés szerint ez a metódus nem tesz semmit. Felülbírálja ezt a metódust egy származtatott osztályban a menüszalag elemének megsemmisítéséhez.
CMFCRibbonBaseElement::D rawImage
A menüszalag elem képének rajzolása.
virtual void DrawImage(
CDC* pDC,
RibbonImageType type,
CRect rectImage);
Paraméterek
pDC
[in] Mutasson egy eszközkörnyezetre.
típus
[in] Egy képtípus számbavételi értéke. A lehetséges értékek listáját a Megjegyzések szakaszban találja.
rectImage
[in] A kép téglalapja.
Megjegyzések
Alapértelmezés szerint ez a metódus nem tesz semmit. Felülbírálja ezt a metódust egy származtatott osztályban a menüszalagelem képének rajzolásához.
Az alábbi táblázat a típus paraméter lehetséges értékeit sorolja fel:
| Érték | Leírás |
|---|---|
RibbonImageLarge |
Nagy, 32x32 képpontos képméret. |
RibbonImageSmall |
Kicsi, 16x16 képpontos képméret. |
CMFCRibbonBaseElement::Find
A megadott mutatót adja vissza, ha az aktuális objektumra mutat.
virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);
Paraméterek
pElement
[in] Mutasson egy menüszalagelemre.
Visszaadott érték
A menüszalag elemére mutató mutató, ha pElement az aktuális objektumra mutat; ellenkező esetben NULL.
Megjegyzések
CMFCRibbonBaseElement::FindByData
A menüszalag elemére mutató mutatót kér le, ha a megadott adatokat tartalmazza.
virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);
Paraméterek
dwData
[in] A menüszalag eleméhez társított adatok.
Visszaadott érték
A menüszalag elemére mutató mutató, ha a megadott adatokat tartalmazza; ellenkező esetben NULL.
Megjegyzések
CMFCRibbonBaseElement::FindByID
A menüszalag elemére mutató mutatót kér le, ha ezt az elemet a megadott parancsazonosító azonosítja.
virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);
Paraméterek
uiCmdID
[in] Menüszalagelem parancsazonosítója.
Visszaadott érték
A menüszalag elemére mutató mutató, ha ezt az elemet a megadott parancsazonosító azonosítja; ellenkező esetben NULL.
Megjegyzések
CMFCRibbonBaseElement::FindByOriginal
Az aktuális menüszalagelemre mutató mutatót kér le, ha az eredeti menüszalageleme megfelel a megadott menüszalagelemnek.
virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);
Paraméterek
pOriginal
[in] Mutasson egy menüszalagelemre.
Visszaadott érték
A menüszalag elemére mutató mutató, ha az eredeti menüszalagelem megegyezik a megadott menüszalagelemmel; ellenkező esetben NULL.
Megjegyzések
A másik tárolóba másolt menüszalagelemek megtartják az eredeti menüszalagelemre mutató mutatót.
CMFCRibbonBaseElement::GetCompactSize
A menüszalag elem kompakt méretét adja vissza.
virtual CSize GetCompactSize(CDC* pDC);
Paraméterek
pDC
[in] Egy eszközkörnyezetre mutató mutató.
Visszaadott érték
Egy menüszalagelem kompakt mérete.
Jegyzet
A kompakt méret azt jelenti, hogy a menüszalag elem csonkolt (egy kis képet jelenít meg, vagy egy szöveg nélküli képet).
CMFCRibbonBaseElement::GetData
Lekéri a menüszalag eleméhez társított felhasználó által megadott adatokat.
DWORD_PTR GetData() const;
Visszaadott érték
A menüszalag eleméhez társított felhasználó által megadott adatok.
CMFCRibbonBaseElement::GetDescription
A menüszalag elemének leírását adja vissza.
virtual CString GetDescription() const;
Visszaadott érték
A menüszalag elemleírása. A leírás megjelenik az állapotsoron vagy egy elemleírásban, vagy a menügomb alatt, ha a menüszalag elem a CMFCRibbonMainPanel osztály.
CMFCRibbonBaseElement::GetDroppedDown
A menüszalag elemére mutató mutatót kér le, ha az előugró menü le van állítva.
virtual CMFCRibbonBaseElement* GetDroppedDown();
Visszaadott érték
A menüszalag elemére mutató mutató, ha az előugró menü le van állítva; ellenkező esetben NULL.
Megjegyzések
CMFCRibbonBaseElement::GetElements
Hozzáadja az aktuális menüszalagelemet a megadott tömbhöz.
virtual void GetElements(
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Paraméterek
arElements
[be, ki] Menüszalagelemek tömbje.
Megjegyzések
CMFCRibbonBaseElement::GetElementsByID
Hozzáadja az aktuális menüszalagelemet a megadott tömbhöz, ha az aktuális menüszalagelem tartalmazza a megadott parancsazonosítót.
virtual void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
Paraméterek
uiCmdID
[in] Egy menüszalagelem parancsazonosítója.
arElements
[in] Menüszalagelemek tömbje.
Megjegyzések
CMFCRibbonBaseElement::GetHighlighted
A menüszalag elemére mutató mutatót kér le, ha ki van emelve.
virtual CMFCRibbonBaseElement* GetHighlighted();
Visszaadott érték
A menüszalag elemére mutató mutató, ha ki van emelve; ellenkező esetben NULL.
Megjegyzések
CMFCRibbonBaseElement::GetID
A menüszalag elemének parancsazonosítóját adja vissza.
UINT GetID() const;
Visszaadott érték
A menüszalag elemének parancsazonosítója.
CMFCRibbonBaseElement::GetImageSize
A menüszalag elem képméretét adja vissza.
virtual CSize GetImageSize(RibbonImageType R) const;
Visszaadott érték
A menüszalag elemének képmérete.
CMFCRibbonBaseElement::GetIntermediateSize
A menüszalag elemének méretét adja vissza a köztes állapotában.
virtual CSize GetIntermediateSize(CDC* pDC);
Paraméterek
pDC
[in] Egy eszközkörnyezetre mutató mutató.
Visszaadott érték
A szalagelem mérete köztes állapotban.
CMFCRibbonBaseElement::GetKeys
A menüszalag eleméhez társított kulcsleírást adja vissza.
LPCTSTR GetKeys() const;
Visszaadott érték
A menüszalag eleméhez társított kulcsleírás.
CMFCRibbonBaseElement::GetKeyTipRect
Lekéri a menüszalag eleméhez tartozó kulcsleírás-határ téglalapot.
virtual CRect GetKeyTipRect(
CDC* pDC,
BOOL bIsMenu);
Paraméterek
pDC
[in] Mutasson egy eszközkörnyezetre.
bIsMenu
[in] IGAZ, ha a menüszalag eleme előugró menüt jelenít meg; egyéb esetben HAMIS.
Visszaadott érték
Mindig 0 értékű téglalapot ad vissza.
Megjegyzések
Felülbírálja ezt a metódust egy származtatott osztályban a kulcstip határ téglalap visszaadásához.
CMFCRibbonBaseElement::GetKeyTipSize
Lekéri a kulcsleírás szövegének méretét.
virtual CSize GetKeyTipSize(CDC* pDC);
Paraméterek
pDC
[in] Mutasson egy eszközkörnyezetre.
Visszaadott érték
A kulcsleírás szövegének mérete.
Megjegyzések
CMFCRibbonBaseElement::GetLocationInGroup
Egy menüszalagcsoport menüszalagelemének megjelenítési helyét jelzi.
RibbonElementLocation GetLocationInGroup() const;
Visszaadott érték
Egy RibbonElementLocation számbavételi érték. Az alábbi táblázat a lehetséges értékeket sorolja fel.
| Érték | Leírás |
|---|---|
RibbonElementNotInGroup |
A menüszalag elem nem szerepel a menüszalagcsoportban. |
RibbonElementSingleInGroup |
A menüszalagelem egyetlen elemként jelenik meg a menüszalagcsoportban. |
RibbonElementFirstInGroup |
A menüszalag elem a menüszalagcsoport bal oldalán jelenik meg. |
RibbonElementLastInGroup |
A menüszalag elem a menüszalagcsoport jobb végén jelenik meg. |
RibbonElementMiddleInGroup |
A menüszalag elem nem jelenik meg a menüszalagcsoport egyik végén sem. |
Megjegyzések
A menüszalag elemcsoportjai csak vízszintesen vannak igazítva.
CMFCRibbonBaseElement::GetMenuKeys
A menüszalag eleméhez tartozó menükulcsleírást adja vissza.
LPCTSTR GetMenuKeys() const;
Visszaadott érték
A menüszalag eleméhez társított menükulcstipp.
Megjegyzések
Meghíváskor egy menükulcstipp egy előugró menüt jelenít meg.
CMFCRibbonBaseElement::GetNotifyID
Lekéri a menüszalagelem értesítési parancsazonosítóját.
virtual UINT GetNotifyID();
Visszaadott érték
Az értesítési parancs azonosítója.
Megjegyzések
CMFCRibbonBaseElement::GetOriginal
Lekéri az eredeti menüszalagelemet.
CMFCRibbonBaseElement* GetOriginal() const;
Visszaadott érték
Az eredeti menüszalagelemre mutató mutató.
Megjegyzések
A másik tárolóba másolt menüszalagelemek megtartják az eredeti menüszalagelemre mutató mutatót.
CMFCRibbonBaseElement::GetParentCategory
Lekéri a menüszalag elem menüszalag kategóriáját.
CMFCRibbonCategory* GetParentCategory() const;
Visszaadott érték
Mutató a menüszalag kategóriájára.
Megjegyzések
CMFCRibbonBaseElement::GetParentPanel
Lekéri a menüszalag elemét tartalmazó menüszalagpanelt.
virtual CMFCRibbonPanel* GetParentPanel() const;
Visszaadott érték
A menüszalag elemet tartalmazó menüszalagpanelre mutató mutató.
Megjegyzések
CMFCRibbonBaseElement::GetParentRibbonBar
Lekéri a menüszalag eleméhez tartozó szülő menüszalagsávot.
CMFCRibbonBar* GetParentRibbonBar() const;
Visszaadott érték
A menüszalag elem szülő menüszalagsávjának mutatója.
Megjegyzések
CMFCRibbonBaseElement::GetParentWnd
Lekéri a menüszalag elemének szülőablakát.
virtual CWnd* GetParentWnd() const;
Visszaadott érték
A menüszalag elem szülőablakára mutató mutató, ha a metódus sikeres volt; ellenkező esetben NULL.
Megjegyzések
A menüszalag elemének szülőablaka egy CMFCRibbonBar osztály vagy CMFCRibbonPanelMenuBar.
CMFCRibbonBaseElement::GetPressed
A menüszalag elemére mutató mutatót kér le, ha a felhasználó éppen lenyomja.
virtual CMFCRibbonBaseElement* GetPressed();
Visszaadott érték
A menüszalag elemére mutató mutató, ha a felhasználó éppen lenyomja; ellenkező esetben NULL.
Megjegyzések
CMFCRibbonBaseElement::GetQuickAccessToolBarID
Lekéri a menüszalag elemének parancsazonosítóját, amikor az a gyorselérési eszköztáron található.
virtual UINT GetQuickAccessToolBarID() const;
Visszaadott érték
A menüszalag elemének parancsazonosítója, amikor a gyorselérési eszköztáron található.
Megjegyzések
CMFCRibbonBaseElement::GetRect
A menüszalag elemének határoló téglalapját adja vissza.
CRect GetRect() const;
Visszaadott érték
A menüszalag elemének határoló téglalapja. A téglalap pozíciója a szülő menüszalag vezérlőelem koordinátáiban van.
CMFCRibbonBaseElement::GetRegularSize
A menüszalag elemének normál méretét adja vissza.
virtual CSize GetRegularSize(CDC* pDC) = 0;
Paraméterek
pDC
[in] Egy eszközkörnyezetre mutató mutató.
Visszaadott érték
A menüszalag elemének normál mérete.
Megjegyzések
Jegyzet
A normál méret a szalagelem lehető legnagyobb mérete.
CMFCRibbonBaseElement::GetSize
A menüszalag elemének aktuális méretét adja vissza.
virtual CSize GetSize(CDC* pDC);
Paraméterek
pDC
[in] Egy eszközkörnyezetre mutató mutató.
Visszaadott érték
A menüszalag elemének aktuális mérete.
CMFCRibbonBaseElement::GetText
A menüszalag eleméhez társított szöveget adja vissza.
LPCTSTR GetText() const;
Visszaadott érték
A menüszalag eleméhez társított szöveg.
CMFCRibbonBaseElement::GetToolTipText
A menüszalag elemleírásának szövegét adja vissza.
virtual CString GetToolTipText() const;
Visszaadott érték
A menüszalag elemleírásának szövege.
CMFCRibbonBaseElement::GetTopLevelRibbonBar
Lekéri a menüszalag elemének felső szintű menüszalagsávja.
CMFCRibbonBar* GetTopLevelRibbonBar() const;
Visszaadott érték
A menüszalag elem felső szintű menüszalagsávjának mutatója, ha a metódus sikeres volt; ellenkező esetben NULL.
Megjegyzések
CMFCRibbonBaseElement::HasCompactMode
Azt határozza meg, hogy a menüszalag elem kompakt üzemmóddal rendelkezik-e.
virtual BOOL HasCompactMode() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme kompakt módban van. HAMIS egyéb esetben.
Megjegyzések
Jegyzet
Kompakt módban egy elem csak egy kis képet jelenít meg.
CMFCRibbonBaseElement::HasIntermediateMode
Azt határozza meg, hogy a menüszalag elemének van-e köztes módja.
virtual BOOL HasIntermediateMode() const;
Visszaadott érték
IGAZ, ha a menüszalagelem köztes móddal rendelkezik, akkor hamis. Köztes módban egy elem egy kis képet és szöveget jelenít meg a kép jobb oldalán.
Megjegyzések
CMFCRibbonBaseElement::HasLargeMode
Meghatározza, hogy a szalagelem rendelkezik-e nagy módban.
virtual BOOL HasLargeMode() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme nagy módban van. HAMIS egyéb esetben.
Megjegyzések
Nagy módban egy elem a szülőpanel teljes magasságát is elérheti.
CMFCRibbonBaseElement::HasMenu
Azt jelzi, hogy a menüszalag elemének van-e menüje.
virtual BOOL HasMenu() const;
Visszaadott érték
Mindig HAMIS értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig HAMIS értéket ad vissza. Felülbírálja ezt a metódust egy származtatott osztályban annak jelzéséhez, hogy a menüszalag elemének van-e menüje.
CMFCRibbonBaseElement::HitTest
A menüszalag elemére mutató mutatót kér le, ha a megadott pont található benne.
virtual CMFCRibbonBaseElement* HitTest(CPoint point);
Paraméterek
pont
[in] Ezt a paramétert nem használja a rendszer.
Visszaadott érték
A menüszalag elemére mutató mutató, ha létezik; egyéb esetben HAMIS.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig érvényes mutatót ad vissza a menüszalag eleméhez, ha létezik. Bírálja felül ezt a metódust, hogy jelezze, hogy a pont a menüszalag elemében található-e.
CMFCRibbonBaseElement::IsAlignByColumn
Azt jelzi, hogy a menüszalag eleme függőlegesen van-e igazítva más menüszalagelemekhez.
virtual BOOL IsAlignByColumn() const;
Visszaadott érték
Mindig IGAZ értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig IGAZ értéket ad vissza. Felülbírálja ezt a metódust egy származtatott osztályban, hogy jelezze, hogy a származtatott menüszalagelem függőlegesen van-e igazítva más menüszalagelemekhez.
CMFCRibbonBaseElement::IsAlwaysLargeImage
Azt jelzi, hogy a menüszalag elemének képmérete mindig nagy-e.
virtual BOOL IsAlwaysLargeImage() const;
Visszaadott érték
IGAZ, ha a menüszalag elemének képmérete mindig nagy; egyéb esetben HAMIS.
Megjegyzések
A nagy képméret 32 x 32 képpont.
CMFCRibbonBaseElement::IsAutoRepeatMode
Azt jelzi, hogy a menüszalag elem automatikus ismétlési módban van-e.
virtual BOOL IsAutoRepeatMode(int& nDelay) const;
Paraméterek
nDelay
[in] Ezt a paramétert nem használja a rendszer.
Visszaadott érték
Mindig HAMIS értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig HAMIS értéket ad vissza. Felülbírálja ezt a metódust, hogy jelezze, hogy a menüszalag eleme automatikus ismétlési módban van-e.
Automatikus ismétlési módban a menüszalag eleme megadott időközönként, ezredmásodpercben mérve válaszol a tartós felhasználói bemenetre.
CMFCRibbonBaseElement::IsChecked
Megadja, hogy a menüszalag elem be van-e jelölve.
virtual BOOL IsChecked() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme be van jelölve; egyéb esetben HAMIS.
CMFCRibbonBaseElement::IsCompactMode
Megadja, hogy a menüszalag elem kompakt módban van-e.
BOOL IsCompactMode() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme kompakt módban van; egyéb esetben HAMIS.
CMFCRibbonBaseElement::IsDefaultMenuLook
Azt jelzi, hogy a menüszalag eleme előugró parancsként van-e beállítva.
BOOL IsDefaultMenuLook() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme előugró parancsként van beállítva; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::IsDisabled
Megadja, hogy a menüszalag elem le van-e tiltva.
virtual BOOL IsDisabled() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme le van tiltva; egyéb esetben HAMIS.
CMFCRibbonBaseElement::IsDroppedDown
Megadja, hogy a menüszalagelem megjelenít-e egy előugró menüt, és le van-e állítva.
virtual BOOL IsDroppedDown() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme le van állítva, és megjelenik egy előugró menü; egyéb esetben HAMIS.
CMFCRibbonBaseElement::IsFocused
Megadja, hogy a menüszalag elem rendelkezik-e a fókuszsal.
virtual BOOL IsFocused() const;
Visszaadott érték
IGAZ, ha a menüszalag elemének fókusza van; egyéb esetben HAMIS.
CMFCRibbonBaseElement::IsGalleryIcon
Azt jelzi, hogy a menüszalag eleme szerepel-e egy menüszalaggyűjteményben.
virtual BOOL IsGalleryIcon() const;
Visszaadott érték
Mindig HAMIS értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig HAMIS értéket ad vissza. Felülbírálja ezt a metódust egy származtatott osztályban, hogy jelezze, hogy a menüszalag eleme megtalálható-e egy menüszalaggyűjteményben.
CMFCRibbonBaseElement::IsHighlighted
Megadja, hogy a menüszalag elem ki van-e emelve.
virtual BOOL IsHighlighted() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme ki van emelve; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::IsIntermediateMode
Azt jelzi, hogy a menüszalag elemének aktuális képe köztes méretű-e.
BOOL IsIntermediateMode() const;
Visszaadott érték
IGAZ, ha a menüszalag elemének képe köztes méretű; egyéb esetben HAMIS.
Megjegyzések
A köztes képméret 16 x 16 képpont.
CMFCRibbonBaseElement::IsLargeMode
Azt jelzi, hogy a menüszalag elemének aktuális képe nagy méretű-e.
BOOL IsLargeMode() const;
Visszaadott érték
IGAZ, ha a menüszalag elemének képe nagy méretű; egyéb esetben HAMIS.
Megjegyzések
A nagy képméret 32 x 32 képpont.
CMFCRibbonBaseElement::IsMenuMode
Azt jelzi, hogy a menüszalag elem szerepel-e a menüben.
BOOL IsMenuMode() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme egy menüben található; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::IsPressed
Azt jelzi, hogy a felhasználó a menüszalag elemére kattintott-e.
virtual BOOL IsPressed() const;
Visszaadott érték
IGAZ, ha a felhasználó a menüszalag elemére kattintott; egyéb esetben HAMIS.
CMFCRibbonBaseElement::IsQATMode
Azt jelzi, hogy a menüszalag eleme szerepel-e a gyorselérési eszköztárban.
BOOL IsQATMode() const;
Visszaadott érték
IGAZ, ha a menüszalag elemét a gyorselérési eszköztár tartalmazza; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::IsSeparator
Azt jelzi, hogy a menüszalag eleme megjelenítendő elválasztó-e.
virtual BOOL IsSeparator() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme egy megjelenítési elválasztó; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::IsShowGroupBorder
Azt jelzi, hogy a menüszalag eleme szerepel-e egy közös szegélyt megjelenítő csoportban.
BOOL IsShowGroupBorder() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme egy közös szegélyt megjelenítő csoportban található; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::IsShowTooltipOnBottom
Azt jelzi, hogy az elemleírás megjelenik-e a menüszalag elem alatt.
virtual BOOL IsShowTooltipOnBottom() const;
Visszaadott érték
IGAZ, ha az elemleírás a menüszalag elem alatt jelenik meg; HAMIS, ha az elemleírás az egérmutató közelében jelenik meg.
Megjegyzések
CMFCRibbonBaseElement::IstabStop
Azt jelzi, hogy a menüszalag elem kijelölhető-e a billentyűzettel.
virtual BOOL IsTabStop() const;
Visszaadott érték
Mindig IGAZ értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig IGAZ értéket ad vissza. Bírálja felül ezt a metódust, hogy jelezze, hogy a menüszalag elem kijelölhető-e a billentyűzettel.
CMFCRibbonBaseElement::IsTextAlwaysOnRight
Azt jelzi, hogy a menüszalag elemének szövege megjelenik-e a jobb oldalon.
BOOL IsTextAlwaysOnRight() const;
Visszaadott érték
IGAZ, ha a menüszalag elemének szövege megjelenik a jobb oldalon; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::IsVisible
Azt jelzi, hogy a menüszalag elem jelenleg megjelenik-e.
BOOL IsVisible() const;
Visszaadott érték
IGAZ, ha a menüszalag elem jelenleg jelenik meg; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::IsWholeRowHeight
Azt jelzi, hogy a menüszalag elemének megjelenítési magassága megegyezik-e az azt tartalmazó menüszalagpanel megjelenítési magasságával.
virtual BOOL IsWholeRowHeight() const;
Visszaadott érték
Mindig HAMIS értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig HAMIS értéket ad vissza. Bírálja felül ezt a módszert, hogy jelezze, hogy a menüszalag elemének megjelenítési magassága megegyezik-e az azt tartalmazó menüszalagpanel megjelenítési magasságával.
CMFCRibbonBaseElement::NotifyCommand
Parancsértesítést küld a menüszalag elem szülőablakának.
BOOL NotifyCommand(BOOL bWithDelay = FALSE);
Paraméterek
bWithDelay
[in] IGAZ, ha hozzáadja a parancsértesítést a szülőablak üzenetsorához; HAMIS, ha azonnal elküldi az üzenetet a szülőablakba.
Visszaadott érték
IGAZ, ha az üzenet el lett küldve; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::NotifyHighlightListItem
Értesíti a menüszalagsáv szülőablakát, ha egy felhasználó kiemel egy listában található menüszalagelemet.
virtual void NotifyHighlightListItem(int nIndex);
Paraméterek
nIndex
[in] A menüszalag elemének indexe a listában.
Megjegyzések
CMFCRibbonBaseElement::OnAddToQAToolbar
Hozzáadja a menüszalag elemet a megadott gyorselérési eszköztárhoz.
virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);
Paraméterek
qat
[in] A gyorselérési eszköztár.
Visszaadott érték
Mindig IGAZ értéket ad vissza, amely azt jelzi, hogy a menüszalag elem hozzáadva lett a gyorselérési eszköztárhoz.
Megjegyzések
CMFCRibbonBaseElement::OnAfterChangeRect
Frissíti a menüszalag elemleírását.
virtual void OnAfterChangeRect(CDC* pDC);
Paraméterek
pDC
[in] Ezt a paramétert nem használja a rendszer.
Megjegyzések
Ez a módszer alapértelmezés szerint frissíti a menüszalag elemleírását. Felülbírálja ezt a metódust a menüszalag elemének frissítéséhez a megjelenítési téglalap módosítása után.
CMFCRibbonBaseElement::OnAutoRepeat
Frissíti a menüszalag elemét a tartós felhasználói bemenetre válaszul.
virtual BOOL OnAutoRepeat();
Visszaadott érték
Mindig HAMIS értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig HAMIS értéket ad vissza. A módszer felülbírálása a tartós felhasználói bevitel feldolgozásához.
CMFCRibbonBaseElement::OnCalcTextSize
Kiszámítja a menüszalag eleméhez tartozó szöveg méretét.
virtual void OnCalcTextSize(CDC* pDC);
Paraméterek
pDC
[in] Ezt a paramétert nem használja a rendszer.
Megjegyzések
Alapértelmezés szerint ez a metódus nem tesz semmit. Bírálja felül ezt a metódust a menüszalag elem szövegének méretének kiszámításához.
CMFCRibbonBaseElement::OnChangeMenuHighlight
A keretrendszer meghívta, amikor egy menüben található menüszalagelem kiemelése megváltozik.
virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
CMFCRibbonBaseElement* pHot);
Paraméterek
pPanelMenuBar
[in] Ezt a paramétert nem használja a rendszer.
pHot
[in] Ezt a paramétert nem használja a rendszer.
Megjegyzések
Alapértelmezés szerint ez a metódus nem tesz semmit. Felülbírálja ezt a metódust egy menüben található menüszalagelem frissítéséhez, amikor a kiemelés megváltozik.
CMFCRibbonBaseElement::OnDraw
A keretrendszer meghívta a menüszalag elemének rajzolásához.
virtual void OnDraw(CDC* pDC) = 0;
Paraméterek
pDC
[in] Egy eszközkörnyezetre mutató mutató.
Megjegyzések
Bírálja felül ezt a metódust egy származtatott osztályban, ha testre szeretné szabni egy adott menüszalagelem rajzát.
CMFCRibbonBaseElement::OnDrawKeyTip
A keretrendszer meghívta, hogy megrajzolja a menüszalag elemének kulcsleírását.
virtual void OnDrawKeyTip(
CDC* pDC,
const CRect& rect,
BOOL bIsMenu);
Paraméterek
pDC
[in] Mutasson egy eszközkörnyezetre.
[in] A kulcsleírás határ téglalapja.
bIsMenu
[in] IGAZ, ha a kulcsleírás egy előugró menügombhoz tartozik; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::OnDrawMenuImage
A keretrendszer meghívja a menüszalag eleméhez tartozó menükép rajzolásakor.
virtual BOOL OnDrawMenuImage(
CDC* pDC,
CRect rect);
Paraméterek
pDC
[in] Mutasson egy eszközkörnyezetre.
[in] Menü kép téglalapja.
Visszaadott érték
Mindig IGAZ értéket ad vissza, hogy jelezze a kép megrajzolását.
Megjegyzések
CMFCRibbonBaseElement::OnDrawOnList
A keretrendszer meghívta, hogy megrajzolja a menüszalag elemét egy parancslistamezőben.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Paraméterek
pDC
[in] Mutasson a menüszalag eleméhez tartozó eszközkörnyezetre.
strText
[in] A megjelenített szöveg.
nTextOffset
[in] Távolság képpontban a lista bal oldalától a megjelenítendő szövegig.
[in] A menüszalag elemének megjelenítendő téglalapja.
bIsSelected
[in] Ezt a paramétert nem használja a rendszer.
bHighlighted
[in] Ezt a paramétert nem használja a rendszer.
Megjegyzések
A parancsok listája párbeszédpanel menüszalagelemeket jelenít meg, amelyekkel a felhasználók testre szabhatják a gyorselérési eszköztárat.
CMFCRibbonBaseElement::OnKey
A keretrendszer meghívja, amikor a felhasználó lenyom egy billentyűt, és a menüszalag elem a fókuszban van.
virtual BOOL OnKey(BOOL bIsMenuKey);
Paraméterek
bIsMenuKey
[in] IGAZ, ha a kulcsleírás előugró menüt jelenít meg; egyéb esetben HAMIS.
Visszaadott érték
IGAZ, ha az eseményt kezelték; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::OnMenuKey
A keretrendszer meghívja, amikor a felhasználó lenyom egy menübillentyűt a főpanelen.
virtual BOOL OnMenuKey(UINT nUpperChar);
Paraméterek
nUpperChar
[in] Ezt a paramétert nem használja a rendszer.
Visszaadott érték
Mindig HAMIS értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a metódus mindig HAMIS értéket ad vissza. Bírálja felül ezt a metódust, hogy válaszoljon, amikor egy felhasználó lenyom egy menükulcsot a főpanelen.
CMFCRibbonBaseElement::OnProcessKey
A keretrendszer meghívja, amikor a felhasználó lenyom egy billentyűparancsot.
virtual BOOL OnProcessKey(UINT nChar);
Paraméterek
nChar
[in] Ezt a paramétert nem használja a rendszer.
Visszaadott érték
Mindig HAMIS értéket ad vissza.
Megjegyzések
Bírálja felül ezt a metódust, ha azt szeretné, hogy a menüszalag eleme egy billentyűparancsot dolgoz fel.
CMFCRibbonBaseElement::OnRTLChanged
A keretrendszer meghívta, amikor az elrendezés irányt változtat.
virtual void OnRTLChanged(BOOL bIsRTL);
Paraméterek
bIsRTL
[in] Ezt a paramétert nem használja a rendszer.
Megjegyzések
Alapértelmezés szerint ez a metódus nem tesz semmit. Felülbírálja ezt a módszert a menüszalag elemének módosításához, amikor az elrendezés iránya megváltozik. Az alapértelmezett elrendezés iránya balról jobbra.
CMFCRibbonBaseElement::OnSetFocus
A keretrendszer meghívja, amikor egy menüszalagelem megkapja vagy elveszíti a bemeneti fókuszt.
virtual void OnSetFocus(BOOL B);
Megjegyzések
Bírálja felül ezt a metódust egy származtatott osztályban, ha azt szeretné, hogy az alkalmazás kezelje a menüszalag elemeinek fókuszában bekövetkező változásokat.
CMFCRibbonBaseElement::OnShow
A keretrendszer meghívta a menüszalag elemének megjelenítésére vagy elrejtésére.
virtual void OnShow(BOOL bShow);
Paraméterek
bShow
[in] Ezt a paramétert nem használja a rendszer.
Megjegyzések
Alapértelmezés szerint ez a metódus nem tesz semmit. A menüszalag elemének megjelenítéséhez vagy elrejtéséhez felülbírálja ezt a módszert.
CMFCRibbonBaseElement::OnShowPopupMenu
A keretrendszer meghívta, mielőtt a menüszalagelem előugró menüt jelenít meg.
virtual void OnShowPopupMenu();
Megjegyzések
Ez a metódus értesíti a menüszalag sávjának szülőablakát, hogy a menüszalag eleme előugró menüt jelenít meg.
CMFCRibbonBaseElement::P ostMenuCommand
Bezárja a menüszalag elemének előugró menüjét, és bezárási üzenetet küld a szülőmenünek.
void PostMenuCommand(UINT uiCmdId);
Paraméterek
uiCmdId
[in] A paraméter nem használatos.
Megjegyzések
A bezárási üzenetet csak akkor küldi el a rendszer, ha a menüszalag eleme egy előugró menüben található.
CMFCRibbonBaseElement::Redraw
Frissíti a menüszalag elemének megjelenítését.
virtual void Redraw();
Megjegyzések
Ez a módszer a CWnd::RedrawWindow meghívásával újrarajzozza a menüszalag elemének megjelenítendő téglalapját a RDW_INVALIDATE, RDW_ERASE és RDW_UPDATENOW jelölőkkel.
CMFCRibbonBaseElement::SetACCData
Beállítja a menüszalag elemének akadálymentességi adatait.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Paraméterek
pParent
A menüszalag elemének szülőablaka.
adat
A menüszalag elemének akadálymentességi adatai.
Visszaadott érték
Mindig IGAZ értéket ad vissza.
Megjegyzések
Alapértelmezés szerint ez a módszer beállítja a menüszalag elemének akadálymentességi adatait, és mindig IGAZ értéket ad vissza. Bírálja felül ezt a metódust a kisegítő lehetőségek adatainak beállításához, és adjon vissza egy sikeres vagy sikertelen értéket.
CMFCRibbonBaseElement::SetCompactMode
A menüszalag elem megjelenítési méretének beállítása.
virtual void SetCompactMode(BOOL bCompactMode = TRUE);
Paraméterek
bCompactMode
[in] IGAZ a menüszalag elem megjelenítési méretének csökkentéséhez; HAMIS a menüszalag elem megjelenítési méretének növeléséhez.
Megjegyzések
Az alábbi táblázat a metódus logikáját foglalja össze.
| bCompactMode | A menüszalag aktuális elemmérete | Új menüszalagelem mérete |
|---|---|---|
| IGAZ | Kompakt | Nincs változás. |
| IGAZ | Középfokú | Ha lehetséges, tömörítse. |
| IGAZ | Nagy | Ha lehetséges, köztes. |
| TÉVES | Kompakt | Ha lehetséges, köztes; egyébként nagy. |
CMFCRibbonBaseElement::SetData
Adatelemet társít a menüszalag eleméhez.
void SetData(DWORD_PTR dwData);
Paraméterek
dwData
[in] Az adatérték.
CMFCRibbonBaseElement::SetDefaultMenuLook
A menüszalag elemét előugró parancsként állítja be.
void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);
Paraméterek
bIsDefaultMenuLook
[in] TRUE (IGAZ) beállítással a menüszalag eleme előugró parancsként jelenik meg; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::SetDescription
Beállítja a menüszalag elemének leírását.
virtual void SetDescription(LPCTSTR lpszText);
Paraméterek
lpszText
[in] A menüszalag elemének leírása.
Megjegyzések
A keretrendszer megjeleníti az új leírást az állapotsoron, az elemleírásban vagy a menügomb alatt.
CMFCRibbonBaseElement::SetID
Beállítja a menüszalag elemének parancsazonosítóját.
virtual void SetID(UINT nID);
Paraméterek
nID
[in] A parancs azonosítója.
CMFCRibbonBaseElement::SetInitialMode
Beállítja a menüszalag elemének kezdeti megjelenítési méretét.
virtual void SetInitialMode(BOOL bOneRow = FALSE);
Paraméterek
bOneRow
[in] IGAZ a menüszalag elem megjelenítési méretének tömörítésre vagy köztesre való korlátozásához; egyéb esetben HAMIS.
Megjegyzések
A menüszalag elemeinek megjelenítési mérete lehet tömör, köztes vagy nagy.
CMFCRibbonBaseElement::SetKeys
Beállítja a menüszalag elemének kulcsleírásait.
virtual void SetKeys(
LPCTSTR lpszKeys,
LPCTSTR lpszMenuKeys=NULL);
Paraméterek
lpszKeys
[in] A menüszalag elemének kulcsleírása.
lpszMenuKeys
[in] A menüszalag elem előugró menüjének kulcsleírása.
CMFCRibbonBaseElement::SetOriginal
Beállítja a menüszalag elemének eredeti menüszalagelemét.
virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);
Paraméterek
pOriginal
[in] Mutasson egy menüszalagelemre.
Megjegyzések
A másik tárolóba másolt menüszalagelemek megtartják az eredeti menüszalagelemre mutató mutatót.
CMFCRibbonBaseElement::SetParentCategory
A menüszalag elem szülőkategóriájának beállítása.
virtual void SetParentCategory(CMFCRibbonCategory* pParent);
Paraméterek
pParent
[in] Mutató egy menüszalagkategóriára.
Megjegyzések
A menüszalag vezérlőinek lapozott csoportjait kategóriáknak nevezzük.
CMFCRibbonBaseElement::SetParentMenu
Beállítja a menüszalag eleméhez tartozó szülőmenü-tárolót.
virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);
Paraméterek
pMenuBar
[in] A szülőmenü.
Megjegyzések
CMFCRibbonBaseElement::SetParentRibbonBar
Beállítja a menüszalag eleméhez tartozó szülő menüszalagsávot.
virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);
Paraméterek
pRibbonBar
[in] Mutasson a szülő menüszalagsávra.
Megjegyzések
CMFCRibbonBaseElement::SetRect
Beállítja a menüszalag eleméhez tartozó megjelenítési téglalap méretét.
void SetRect(CRect rect);
Paraméterek
[in] A téglalap méretei.
Megjegyzések
CMFCRibbonBaseElement::SetText
Beállítja a menüszalag elemének szövegét és kulcsleírását.
virtual void SetText(LPCTSTR lpszText);
Paraméterek
lpszText
[in] A menüszalag elemének szövege és kulcsleírása.
Megjegyzések
A menüszalag elemének kulcsleírásának beállításához fűzze hozzá az új sorkiemelési sorozatot, majd a kulcstip karaktereket lpszText.
Példa
//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
Beállítja a menüszalag elemének szövegét a jobb oldalon való megjelenítésre.
virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);
Paraméterek
bSet
[in] IGAZ a jobb oldali szöveg megjelenítéséhez; egyéb esetben HAMIS.
Megjegyzések
CMFCRibbonBaseElement::SetToolTipText
Beállítja a menüszalag elemleírásának szövegét.
virtual void SetToolTipText(LPCTSTR lpszText);
Paraméterek
lpszText
[in] Az elemleírás szövege.
CMFCRibbonBaseElement::SetVisible
Beállítja a menüszalag elem láthatóságát.
void SetVisible(BOOL bIsVisible);
Paraméterek
bIsVisible
[in] IGAZ a menüszalag elemének megjelenítéséhez; HAMIS a menüszalag elemének elrejtéséhez.
Megjegyzések
CMFCRibbonBaseElement::StretchHorizontally
Kinyújtja a menüszalag elemének szélességét.
virtual void StretchHorizontally();
Megjegyzések
Ez a módszer alapértelmezés szerint hibakeresési hibát okoz a hibakeresési buildekben, ezért nem szabad meghívni. Felülbírálja ezt a módszert a menüszalag elem szélességének megnyújtásához.
CMFCRibbonBaseElement::StretchToWholeRow
A menüszalag elemének megjelenítési magasságát a megadott sormagasságra módosítja.
virtual BOOL StretchToWholeRow(
CDC* pDC,
int nHeight);
Paraméterek
pDC
[in] Ezt a paramétert nem használja a rendszer.
nHeight
[in] A sor magassága.
Visszaadott érték
IGAZ, ha a megjelenítési magasság be van állítva; egyéb esetben HAMIS.
Megjegyzések
Felülbírálhatja ezt a módszert, ha a menüszalag elemének megjelenítési magasságát a megadott sormagasságra szeretné módosítani.
CMFCRibbonBaseElement::UpdateTooltipInfo
Frissíti az elemleírás szövegét a menüszalag eleméhez tartozó parancserőforrás használatával.
virtual void UpdateTooltipInfo();
Megjegyzések
CMFCRibbonBaseElement::HasFocus
Azt jelzi, hogy a szülőelem rendelkezik-e billentyűzetfókusszal.
virtual BOOL HasFocus() const;
Visszaadott érték
IGAZ, ha a menüszalag eleme szűrt; egyéb esetben HAMIS.