`CMFCRibbonBar` osztály

Cikk
03/17/2025

A CMFCRibbonBar osztály az Office 2007-hez hasonló menüszalagsávot implementál.

További részletekért tekintse meg a Visual Studio-telepítés mfc mappájában található forráskódot. Például %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Szintaxis

class CMFCRibbonBar : public CPane

Tagok

Nyilvános konstruktorok

Név	Leírás
`CMFCRibbonBar::CMFCRibbonBar`	Alapértelmezett konstruktor.

Nyilvános metódusok

Név	Leírás
`CMFCRibbonBar::ActivateContextCategory`	Aktivál egy már látható környezeti kategóriát.
`CMFCRibbonBar::AddCategory`	Új menüszalagkategóriát ad hozzá a menüszalaghoz.
`CMFCRibbonBar::AddContextCategory`	Környezeti kategóriát ad hozzá.
`CMFCRibbonBar::AddMainCategory`	Új fő menüszalagkategóriát ad hozzá.
`CMFCRibbonBar::AddPrintPreviewCategory`
`CMFCRibbonBar::AddQATOnlyCategory`
`CMFCRibbonBar::AddToTabs`	Vegyen fel egy menüszalagelemet a menüszalag jobb oldalára.
`CMFCRibbonBar::CreateEx`	Létrehoz egy vezérlősávot, és csatolja a `CPane` objektumhoz. (Felülbírálások `CPane::CreateEx`.)
`CMFCRibbonBar::Create`	Létrehoz egy menüszalagsáv-vezérlőt, és egy menüszalagsávhoz csatolja.
`CMFCRibbonBar::DeactivateKeyboardFocus`
`CMFCRibbonBar::DrawMenuImage`
`CMFCRibbonBar::DWMCompositionChanged`
`CMFCRibbonBar::EnableKeyTips`	A menüszalag vezérlőjének főbb tippjeinek engedélyezése vagy letiltása.
`CMFCRibbonBar::EnablePrintPreview`	Engedélyezze a Nyomtatási kép lapot.
`CMFCRibbonBar::EnableToolTips`	Engedélyezi vagy letiltja az elemleírásokat és az elemleírások leírását a menüszalagsávon.
`CMFCRibbonBar::FindByData`	Menüszalagelem keresése a felhasználó által megadott adatokkal.
`CMFCRibbonBar::FindByID`	Megkeresi a megadott parancsazonosítóval rendelkező menüszalagelemet.
`CMFCRibbonBar::FindCategoryIndexByData`	Megkeresi a felhasználó által megadott adatokat tartalmazó menüszalagkategória indexét.
`CMFCRibbonBar::ForceRecalcLayout`
`CMFCRibbonBar::GetActiveCategory`	Mutatót kap egy aktív kategóriához.
`CMFCRibbonBar::GetCaptionHeight`	A felirat magasságát adja vissza. (Felülbírálások `CBasePane::GetCaptionHeight`.)
`CMFCRibbonBar::GetCategory`	Lekéri az egérmutatót egy adott indexen található kategóriára.
`CMFCRibbonBar::GetCategoryCount`	Lekéri a menüszalag-kategóriák számát a menüszalagsávon.
`CMFCRibbonBar::GetCategoryHeight`
`CMFCRibbonBar::GetCategoryIndex`	Egy menüszalagkategória indexét adja vissza.
`CMFCRibbonBar::GetContextName`	Beolvassa a környezetkategória-felirat nevét, amelyet egy azonosító használatával ad meg.
`CMFCRibbonBar::GetDroppedDown`
`CMFCRibbonBar::GetElementsByID`	Egy tömböt kap, amely a megadott azonosítóval rendelkező menüszalag-elemek mutatóit tartalmazza.
`CMFCRibbonBar::GetApplicationButton`	Egy menüszalag gombjára mutató mutatót kap.
`CMFCRibbonBar::GetFocused`	Egy szűrt elemet ad vissza.
`CMFCRibbonBar::GetHideFlags`
`CMFCRibbonBar::GetItemIDsList`
`CMFCRibbonBar::GetKeyboardNavigationLevel`
`CMFCRibbonBar::GetKeyboardNavLevelCurrent`
`CMFCRibbonBar::GetKeyboardNavLevelParent`
`CMFCRibbonBar::GetMainCategory`	Az aktuálisan kijelölt menüszalagkategóriára mutató mutatót ad vissza.
`CMFCRibbonBar::GetQATCommandsLocation`
`CMFCRibbonBar::GetQATDroppedDown`
`CMFCRibbonBar::GetQuickAccessCommands`	Kitölt egy listát, amely a gyorselérési eszköztáron megjelenő összes elem parancsazonosítóit tartalmazza.
`CMFCRibbonBar::GetQuickAccessToolbarLocation`
`CMFCRibbonBar::GetTabTrancateRatio`
`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`
`CMFCRibbonBar::GetTooltipFixedWidthRegular`
`CMFCRibbonBar::GetVisibleCategoryCount`
`CMFCRibbonBar::HideAllContextCategories`	Elrejti az összes aktív és látható kategóriát.
`CMFCRibbonBar::HideKeyTips`
`CMFCRibbonBar::HitTest`	Megkeresi a menüszalag azon elemére mutató mutatót, amely a menüszalagsáv ügyfélkoordinátáinak megadott pontján található.
`CMFCRibbonBar::IsKeyTipEnabled`	Meghatározza, hogy engedélyezve vannak-e a kulcsleírások.
`CMFCRibbonBar::IsMainRibbonBar`
`CMFCRibbonBar::IsPrintPreviewEnabled`	Meghatározza, hogy a Nyomtatási kép lap engedélyezve van-e.
`CMFCRibbonBar::IsQATEmpty`
`CMFCRibbonBar::IsQuickAccessToolbarOnTop`	Megadja, hogy a gyorselérési eszköztár a menüszalag sávja felett található-e.
`CMFCRibbonBar::IsReplaceFrameCaption`	Meghatározza, hogy a szalagsáv lecseréli-e a fő képkeret feliratát, vagy a keret felirata alatt van-e hozzáadva.
`CMFCRibbonBar::IsShowGroupBorder`
`CMFCRibbonBar::IsToolTipDescrEnabled`	Meghatározza, hogy engedélyezve vannak-e az elemleírások leírásai.
`CMFCRibbonBar::IsToolTipEnabled`	Meghatározza, hogy engedélyezve vannak-e a menüszalagsáv elemleírásai.
`CMFCRibbonBar::IsTransparentCaption`
`CMFCRibbonBar::IsWindows7Look`	Azt jelzi, hogy a menüszalag windows 7-stílusú megjelenésű-e (kis téglalap alakú alkalmazásgomb).
`CMFCRibbonBar::LoadFromResource`	Túlterhelt. Betölt egy menüszalagsávot az alkalmazáserőforrásokból.
`CMFCRibbonBar::OnClickButton`
`CMFCRibbonBar::OnEditContextMenu`
`CMFCRibbonBar::OnRTLChanged`	(Felülbírálások `CPane::OnRTLChanged`.)
`CMFCRibbonBar::OnSetAccData`	(Felülbírálások `CBasePane::OnSetAccData`.)
`CMFCRibbonBar::OnShowRibbonContextMenu`
`CMFCRibbonBar::OnShowRibbonQATMenu`
`CMFCRibbonBar::OnSysKeyDown`
`CMFCRibbonBar::OnSysKeyUp`
`CMFCRibbonBar::PopTooltip`
`CMFCRibbonBar::PreTranslateMessage`	(Felülbírálások `CBasePane::PreTranslateMessage`.)
`CMFCRibbonBar::RecalcLayout`	(Felülbírálások `CPane::RecalcLayout`.)
`CMFCRibbonBar::RemoveAllCategories`	Eltávolítja az összes menüszalagkategóriát a menüszalagsávról.
`CMFCRibbonBar::RemoveAllFromTabs`	Eltávolítja a menüszalag összes elemét a lapterületről.
`CMFCRibbonBar::RemoveCategory`	Eltávolítja a megadott indexen található menüszalagkategóriát.
`CMFCRibbonBar::SaveToXMLBuffer`	Menti a menüszalagsávot egy pufferbe.
`CMFCRibbonBar::SaveToXMLFile`	Menti a menüszalagsávot XML-fájlba.
`CMFCRibbonBar::SetActiveCategory`	Egy megadott menüszalagkategória beállítása aktívra.
`CMFCRibbonBar::SetActiveMDIChild`
`CMFCRibbonBar::SetElementKeys`	Beállítja a megadott kulcsleírásokat az összes olyan menüszalag-elemhez, amely rendelkezik a megadott parancsazonosítóval.
`CMFCRibbonBar::SetApplicationButton`	Alkalmazás menüszalagjának gombjának hozzárendelése a menüszalagsávhoz.
`CMFCRibbonBar::SetKeyboardNavigationLevel`
`CMFCRibbonBar::SetMaximizeMode`
`CMFCRibbonBar::SetQuickAccessCommands`	Egy vagy több menüszalagelemet ad hozzá a gyorselérési eszköztárhoz.
`CMFCRibbonBar::SetQuickAccessDefaultState`	A gyorselérési eszköztár alapértelmezett állapotát adja meg.
`CMFCRibbonBar::SetQuickAccessToolbarOnTop`	A gyorselérési eszköztár (QAT) elhelyezése a menüszalagsáv felett vagy alatt.
`CMFCRibbonBar::SetTooltipFixedWidth`
`CMFCRibbonBar::SetWindows7Look`	Menüszalag engedélyezése/letiltása Windows 7-stílusú megjelenés (kis téglalap alakú alkalmazás gomb)
`CMFCRibbonBar::ShowCategory`	Megjeleníti vagy elrejti a megadott menüszalagkategóriát.
`CMFCRibbonBar::ShowContextCategories`	Megjeleníti vagy elrejti a megadott azonosítóval rendelkező környezeti kategóriákat.
`CMFCRibbonBar::ShowKeyTips`
`CMFCRibbonBar::ToggleMimimizeState`	A szalagsáv váltása a kis méretű és a teljes állapot között.
`CMFCRibbonBar::TranslateChar`

Megjegyzések

A Microsoft bemutatta az Office Fluent menüszalagot, amikor egyidejűleg kiadta a Microsoft Office 2007-et. Ez a menüszalagsáv nem csak egy új vezérlő. Ez egy új felhasználói felületi paradigmát jelöl. A menüszalag egy panel, amely kategóriáknak nevezett lapokat tartalmaz. Minden kategória logikailag szalagpanelre van felosztva, és mindegyik panel különböző vezérlőket és parancsgombokat tartalmazhat.

A szalagsávon megjelenő elemek kibontva és összeadva a lehető legjobban kihasználják a rendelkezésre álló területet. Ha például egy menüszalagpanelen nincs elegendő hely az elemek megjelenítéséhez, az egy menügomb lesz, amely egy előugró menü alelemeit jeleníti meg. A szalagsáv statikus (nem lebegő) vezérlősávként viselkedik, és a keret tetején rögzíthető.

A CMFCRibbonStatusBar osztály használatával az Office 2007-ben használthoz hasonló állapotsort implementálhat. A menüszalag-kategória menüszalagpanelekegy csoportját tartalmazza (és jeleníti meg). Minden menüszalagpanel egy vagy több menüszalagelemet tartalmaz, amelyek CMFCRibbonBaseElementszármaztathatók.

A menüszalagsáv meglévő MFC-alkalmazáshoz való hozzáadásáról további információt az útmutatóban talál: Az MFC scribble alkalmazásfrissítése.

Öröklési hierarchia

Követelmények

fejléc:afxribbonbar.h

`CMFCRibbonBar::ActivateContextCategory`

Aktivál egy már látható környezeti kategóriát.

BOOL ActivateContextCategory(UINT uiContextID);

Paraméterek

uiContextID
[in] A környezeti kategória azonosítója.

Visszaadott érték

TRUE, ha uiContextID környezeti kategória található és aktiválva van; egyéb esetben FALSE.

`CMFCRibbonBar::AddCategory`

Létrehoz és inicializál egy új menüszalagkategóriát a menüszalagsávhoz.

CMFCRibbonCategory* AddCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage= CSize(16,
    16),
    CSize sizeLargeImage= CSize(32,
    32),
    int nInsertAt = -1,
    CRuntimeClass* pRTI= NULL);

Paraméterek

lpszName
[in] A menüszalag kategória neve.

uiSmallImagesResID
[in] A menüszalag-kategória kis képlistájának erőforrás-azonosítója.

uiLargeImagesResID
[in] A menüszalag kategória nagyméretű képlistájának erőforrás-azonosítója.

sizeSmallImage
[in] A menüszalag kategóriájához tartozó kis méretű képek méretét adja meg.

sizeLargeImage
[in] A menüszalag kategóriájához tartozó nagyméretű képek méretét adja meg.

nInsertAt
[in] A kategóriahely nulla alapú indexe.

pRTI
[in] Mutasson egy CMFCRibbonCategory osztályra futásidejű osztályra, hogy futásidőben dinamikusan hozzon létre egy menüszalagkategóriát.

Visszaadott érték

Az új menüszalagkategóriára mutató mutató, ha a metódus sikeres volt; ellenkező esetben NULL.

Megjegyzések

Ha a pRTI paraméter nem NULL, az új menüszalagkategória dinamikusan jön létre a futásidejű osztály használatával.

Példa

Az alábbi példa bemutatja, hogyan használható a AddCategory metódus a CMFCRibbonBar osztályban.

// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory *pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
                                                               IDB_WRITESMALL, IDB_WRITELARGE);

`CMFCRibbonBar::AddContextCategory`

Létrehoz és inicializál egy új környezeti kategóriát a menüszalagsávhoz.

CMFCRibbonCategory* AddContextCategory(
    LPCTSTR lpszName,
    LPCTSTR lpszContextName,
    UINT uiContextID,
    AFX_RibbonCategoryColor clrContext,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32),
    CRuntimeClass* pRTI = NULL);

Paraméterek

lpszName
[in] A kategória neve.

lpszContextName
[in] A környezeti kategória feliratának neve.

uiContextID
[in] Környezeti azonosító.

clrContext
[in] A környezeti kategória feliratának színe.

uiSmallImagesResID
[in] A környezetkategória kis képének erőforrás-azonosítója.

uiLargeImagesResID
[in] Egy környezetkategória nagy képének erőforrás-azonosítója.

sizeSmallImage
[in] Kis méretű kép.

sizeLargeImage
[in] Nagy kép mérete.

pRTI
[in] Mutató egy futtatókörnyezeti osztályra.

Visszaadott érték

Mutató az újonnan létrehozott kategóriára, vagy NULL, ha a CreateObjectpRTI metódusa nem tudja létrehozni a megadott kategóriát.

Megjegyzések

Ezzel a függvénnyel környezeti kategóriát vehet fel. A környezetkategóriák egy speciális kategóriatípus, amely futásidőben jeleníthető meg vagy rejthető el az aktuális alkalmazáskörnyezettől függően. Ha például a felhasználó kiválaszt egy objektumot, speciális lapokat jeleníthet meg környezetkategóriákkal, amelyekkel módosíthatja az adott kijelölt objektumot.

A környezetkategóriák színe a következő értékek egyike lehet:

AFX_CategoryColor_None
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet

`CMFCRibbonBar::AddMainCategory`

Létrehoz egy új fő menüszalagkategóriát a menüszalagsávhoz.

CMFCRibbonMainPanel* AddMainCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

Paraméterek

lpszName
[in] A fő menüszalagkategória neve.

uiSmallImagesResID
[in] Kis méretű képek erőforrás-azonosítója.

uiLargeImagesResID
[in] Nagy méretű képek erőforrás-azonosítója.

sizeSmallImage
[in] A kis méretű képek.

sizeLargeImage
[in] A nagyméretű képek mérete.

Visszaadott érték

Ha a metódus sikeres volt, mutasson az új fő menüszalagkategóriára; ellenkező esetben NULL.

Megjegyzések

Ha már létezik fő menüszalagkategória, az törlődik.

Példa

Az alábbi példa bemutatja, hogyan használható a AddMainCategory metódus a CMFCRibbonBar osztályban.

// m_wndRibbonBar is declared as a protected member variable
// CMFCRibbonBar m_wndRibbonBar.
// strTemp is a CString variable.
strTemp.LoadString(IDS_RIBBON_FILE);
CMFCRibbonMainPanel *pMainPanel = m_wndRibbonBar.AddMainCategory(strTemp,
                                                                 IDB_FILESMALL, IDB_FILELARGE);

`CMFCRibbonBar::AddPrintPreviewCategory`

Létrehoz egy nyomtatási kép kategóriát a menüszalagsávon.

CMFCRibbonCategory* AddPrintPreviewCategory();

Visszaadott érték

Az új menüszalagkategóriára mutató mutató, ha a metódus sikeres volt; ellenkező esetben NULL.

Megjegyzések

Ez a módszer létrehoz egy menüszalagkategóriát és azokat a vezérlőket, amelyekre szüksége van a nyomtatási kép megjelenítéséhez.

`CMFCRibbonBar::AddQATOnlyCategory`

Létrehoz egy gyorselérési eszköztár menüszalag kategóriáját.

CMFCRibbonCategory* AddQATOnlyCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    CSize sizeSmallImage = CSize(16,
    16));

Paraméterek

lpszName
[in] A kategória neve.

uiSmallImagesResID
[in] A kategória képlistájának erőforrás-azonosítója.

sizeSmallImage
[in] A kategória menüszalagelemeihez tartozó képek mérete.

Visszaadott érték

Az új kategóriára mutató mutató, ha a metódus sikeres volt; ellenkező esetben NULL.

Megjegyzések

A gyorselérési eszköztár menüszalagkategóriája csak a gyorselérési eszköztár testreszabási párbeszédpanelén használható.

`CMFCRibbonBar::AddToTabs`

Hozzáadja a megadott menüszalagelemet a menüszalagsáv tabulátorsorához.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Paraméterek

pElement
[in] Mutasson egy menüszalagelemre.

Megjegyzések

A menüszalag elem a rendszergombok előtt van elhelyezve.

`CMFCRibbonBar::CMFCRibbonBar`

Létrehoz és inicializál egy CMFCRibbonBar objektumot.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Paraméterek

bReplaceFrameCaption
[in] TRUE a szalagsávon a fő keretablak feliratának helyére; FALSE a szalagsáv megkereséséhez a fő keretablak felirata alatt.

Megjegyzések

`CMFCRibbonBar::Create`

Létrehoz egy ablakot a menüszalagsávhoz.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Paraméterek

pParentWnd
[in] Mutasson a menüszalagsáv szülőablakára.

dwStyle
[in] Az új ablak stílusainak logikai kombinációja.

nID
[in] Az új ablak azonosítója.

Visszaadott érték

TRUE, hogy az ablak létrejött-e; egyéb esetben FALSE.

Megjegyzések

Példa

Az alábbi példa a Create osztály CMFCRibbonBar metódusának használatát mutatja be.

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.Create(this, WS_CHILD | CBRS_TOP);

`CMFCRibbonBar::CreateEx`

Létrehoz egy ablakot a menüszalagsávhoz.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = 0,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Paraméterek

pParentWnd
[in] Mutasson a menüszalagsáv szülőablakára.

dwCtrlStyle
[in] Ezt a paramétert nem használja a rendszer.

dwStyle
[in] Az új ablak stílusainak logikai kombinációja.

nID
[in] Az új ablak azonosítója.

Visszaadott érték

TRUE, hogy az ablak létrejött-e; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::DeactivateKeyboardFocus`

Bezárja a menüszalagsáv összes billentyűtip vezérlőelemét.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Paraméterek

bSetFocus
[in] TRUE, hogy a fókusz a menüszalagsáv szülőablakára legyen állítva.

Megjegyzések

`CMFCRibbonBar::DrawMenuImage`

A menügomb képének rajzolása.

BOOL DrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuItem,
    const CRect& rectImage);

Paraméterek

pDC
[in] Mutasson a menügomb eszközkörnyezetére.

pMenuItem
[in] Mutasson egy eszköztár menü gombjára.

rectImage
[in] A menügomb megjelenítendő téglalapja.

Visszaadott érték

TRUE, hogy a kép meg lett-e rajzolva; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::DWMCompositionChanged`

Módosítja a menüszalag megjelenítését, ha a Desktop Window Manager (DWM) összeállítása engedélyezve van vagy le van tiltva.

virtual void DWMCompositionChanged();

Megjegyzések

`CMFCRibbonBar::EnableKeyTips`

Engedélyezi vagy letiltja a menüszalagsáv kulcsleírási funkcióját.

void EnableKeyTips(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] TRUE a kulcsleírások funkció engedélyezéséhez; FALSE a kulcsleírások funkció letiltásához.

Megjegyzések

Ha engedélyezi ezt a funkciót, a kulcstippek akkor jelennek meg, amikor a felhasználó lenyomja az ALT vagy F10 billentyűket. Amikor a felhasználó lenyomja ALT billentyűt, a kulcstippek 200 ezredmásodpercnyi késéssel jelennek meg. Ez a késleltetés lehetővé teszi a billentyűparancsok végrehajtását, hogy a lenyomott ALT billentyű ne zavarja a ALT billentyűt tartalmazó egyéb kombinációkat.

`CMFCRibbonBar::EnablePrintPreview`

Engedélyezi vagy letiltja a Nyomtatási kép funkciót.

void EnablePrintPreview(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] TRUE a Nyomtatási kép funkció engedélyezéséhez; FALSE a Nyomtatási kép funkció letiltásához.

Megjegyzések

Ha bEnableFALSE, és létezik nyomtatási kép kategória, akkor az törlődik.

Alapértelmezés szerint engedélyezve van a Nyomtatási kép funkció.

`CMFCRibbonBar::EnableToolTips`

Engedélyezi vagy letiltja az elemleírásokat és az opcionális elemleírásokat a menüszalagsávon.

void EnableToolTips(
    BOOL bEnable = TRUE,
    BOOL bEnableDescr = TRUE);

Paraméterek

bEnable
[in] TRUE az elemleírások engedélyezéséhez a menüszalagsávon; FALSE letilthatja az elemleírásokat a menüszalagsávon.

bEnableDescr
[in] TRUE az elemleírások leírásának engedélyezéséhez az elemleíráson; FALSE az elemleírás leírásának letiltásához.

Megjegyzések

A bEnable paraméter határozza meg, hogy megjelennek-e elemleírások, amikor az egér rámutat egy menüszalagelemre. A bEnableDescr paraméter határozza meg, hogy megjelenik-e további leíró szöveg az elemleírás szövegével.

`CMFCRibbonBar::FindByData`

Ha a megadott adatokkal és láthatóságkal rendelkezik, egy menüszalagelemre mutató mutatót kér le.

CMFCRibbonBaseElement* FindByData(
    DWORD_PTR dwData,
    BOOL bVisibleOnly = TRUE) const;

Paraméterek

dwData
[in] A menüszalag eleméhez társított adatok.

bVisibleOnly
[in] csak a látható menüszalagelemek kereséséhez TRUE; FALSE a menüszalag összes elemének kereséséhez.

Visszaadott érték

A menüszalag elemére mutató mutató, ha a megadott adatokkal és láthatóságkal rendelkezik; egyéb esetben NULL.

Megjegyzések

A menüszalag bármely olyan vezérlője, amelyet hozzáadhat a menüszalaghoz, például egy menüszalaggombot, egy menüszalagkategóriát vagy egy menüszalag csúszkát.

`CMFCRibbonBar::FindByID`

A megadott parancsazonosítóval és keresési értékekkel rendelkező menüszalagelemre mutató mutatót kér le.

CMFCRibbonBaseElement* FindByID(
    UINT uiCmdID,
    BOOL bVisibleOnly = TRUE,
    BOOL bExcludeQAT = FALSE) const;

Paraméterek

uiCmdID
[in] Menüszalagelem parancsazonosítója.

bVisibleOnly
[in] csak a látható menüszalagelemek kereséséhez TRUE; FALSE a menüszalag összes elemének kereséséhez.

bExcludeQAT
[in] TRUE, hogy kizárja a gyorselérési eszköztár elemeit a keresésből; ellenkező esetben FALSE.

Visszaadott érték

Egy menüszalagelemre mutató mutató, ha rendelkezik a megadott parancsazonosítóval és keresési értékekkel; ellenkező esetben NULL.

Megjegyzések

A menüszalag bármely olyan vezérlője, amely hozzáadható a menüszalaghoz, például a menüszalag gombja, a menüszalag kategóriája vagy a menüszalag csúszka.

Általában több olyan menüszalagelem is lehet, amely ugyanazzal a parancsazonosítóval rendelkezik. Ha a megadott parancsazonosítót használó összes menüszalag-elemre mutatót szeretne beszerezni, használja a CMFCRibbonBar::GetElementsByID metódust.

`CMFCRibbonBar::FindCategoryIndexByData`

Lekéri a megadott adatokat tartalmazó menüszalagkategória indexét.

int FindCategoryIndexByData(DWORD dwData) const;

Paraméterek

dwData
[in] A menüszalag kategóriájához társított adatok.

Visszaadott érték

A menüszalag-kategória nulla alapú indexe, ha a metódus sikeres volt; egyéb esetben -1.

`CMFCRibbonBar::ForceRecalcLayout`

Beállítja a menüszalag és a szülőablak összes elemének elrendezését, és újrarajzolva az egész ablakot.

void ForceRecalcLayout();

Megjegyzések

`CMFCRibbonBar::GetActiveCategory`

Az aktív menüszalag kategóriájára mutató mutatót kér le.

CMFCRibbonCategory* GetActiveCategory() const;

Visszaadott érték

Mutató az aktív menüszalag kategóriájára; vagy NULL, ha nincs aktív kategória.

Megjegyzések

Egy kategória aktív, ha a fókusza van. Alapértelmezés szerint az aktív kategória a menüszalagsáv bal oldalán található első kategória.

A fő kategória akkor jelenik meg, amikor a felhasználó lenyomja az alkalmazás gombját, és nem lehet aktív kategória.

`CMFCRibbonBar::GetApplicationButton`

Az alkalmazás gombjára mutató mutatót kér le.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Visszaadott érték

Az alkalmazás gombjára mutató mutató; vagy NULL, ha a gomb nincs beállítva.

`CMFCRibbonBar::GetCaptionHeight`

Lekéri a szalagsáv feliratterületének magasságát.

int GetCaptionHeight() const;

Visszaadott érték

A szalagsáv feliratterületének magassága képpontban.

Megjegyzések

`CMFCRibbonBar::GetCategory`

A megadott index menüszalag kategóriájára mutató mutatót kér le.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Paraméterek

nIndex
[in] A menüszalag kategóriájának nulla alapú indexe a menüszalagsávon található menüszalagkategóriák listájában.

Visszaadott érték

Mutató a menüszalag kategóriájára a megadott indexben; ellenkező esetben NULL, ha nIndex tartományon kívül volt.

`CMFCRibbonBar::GetCategoryCount`

Lekéri a menüszalagsáv menüszalagkategóriáinak számát.

int GetCategoryCount() const;

Visszaadott érték

A menüszalag sávjának menüszalagkategóriáinak száma.

`CMFCRibbonBar::GetCategoryHeight`

Lekéri a kategória magasságát.

int GetCategoryHeight() const;

Visszaadott érték

A kategória magassága.

Megjegyzések

A kategória magassága tartalmazza a kategória fül magasságát.

`CMFCRibbonBar::GetCategoryIndex`

Lekéri a megadott menüszalagkategória indexét.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Paraméterek

pCategory
[in] Mutató egy menüszalagkategóriára.

Visszaadott érték

A pCategoryáltal megadott menüszalagkategória nullaalapú indexe; vagy -1, ha a menüszalag kategória nem található.

`CMFCRibbonBar::GetContextName`

Lekéri a környezetazonosító által megadott környezetkategória-felirat nevét.

BOOL GetContextName(
    UINT uiContextID,
    CString& strName) const;

Paraméterek

uiContextID
[in] Szalagkategória környezeti azonosítója.

strName
[kifelé] A környezeti kategória feliratának neve.

Visszaadott érték

TRUE, hogy a módszer sikeres volt-e; ellenkező esetben FALSE, ha uiContextID nulla volt, vagy a környezeti kategória felirata nem található.

`CMFCRibbonBar::GetDroppedDown`

Lekéri az aktuálisan elvetett menüszalagelemet.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Visszaadott érték

Az aktuálisan elvetett menüszalagelem; vagy NULL, ha a menüszalag egyik elemét sem ejtette le.

Megjegyzések

`CMFCRibbonBar::GetElementsByID`

Egy mutatótömböt kér le az összes menüszalag-elemhez, amely egy adott parancsazonosítóval rendelkezik.

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

Paraméterek

uiCmdID
[in] Egy menüszalagelem parancsazonosítója.

arButtons
[kifelé] A menüszalag elemeire mutató mutatótömb.

Megjegyzések

Több menüszalagelem is rendelkezhet ugyanazzal a parancsazonosítóval, mert egyes menüszalagelemek átmásolhatók a gyorselérési eszköztárra.

`CMFCRibbonBar::GetHideFlags`

Lekéri azokat a jelzőket, amelyek jelzik, hogy a menüszalag sávjának mekkora része látható.

DWORD GetHideFlags() const;

Visszaadott érték

A menüszalag sávjának látható részét jelző jelzők.

Megjegyzések

Az alábbi táblázat a visszatérési érték jelzőinek lehetséges kombinációját sorolja fel:

Zászló	Leírás
`AFX_RIBBONBAR_HIDE_ELEMENTS`	A menüszalag sávja függőlegesen kis méretű, és csak a kategóriafülek, a főgomb és a gyorselérési eszköztár látható.
`AFX_RIBBONBAR_HIDE_ALL`	A szalagsáv szélessége kisebb, mint a minimális szélesség, és teljesen rejtett.

`CMFCRibbonBar::GetItemIDsList`

Lekéri a menüszalagsávon található menüszalagelemek megadott gyűjteményéhez tartozó parancsazonosítókat.

void GetItemIDsList(CList<UINT, UINT>& lstItems,
    BOOL bHiddenOnly = FALSE) const;

Paraméterek

lstItems
[kifelé] A menüszalag sávjában található menüszalagelemek parancsazonosítóinak listája.

bHiddenOnly
[in] TRUE a megjelenő menüszalagelemek kizárásához; FALSE, hogy az összes menüszalag-elemet belefoglalja a menüszalagsávba.

Megjegyzések

`CMFCRibbonBar::GetKeyboardNavigationLevel`

Lekéri az aktuális navigációs szintet, miközben a felhasználó lenyomja a menüszalagsávon található billentyűleírásokat.

int GetKeyboardNavigationLevel() const;

Visszaadott érték

Az aktuális navigációs szint, amikor a felhasználó lenyomja a menüszalagsávon található billentyűleírásokat. Az alábbi táblázat a lehetséges visszatérési értékeket sorolja fel:

Érték	Leírás
-1	A kulcsleírások nem jelennek meg.
0	Megjelennek a kulcsleírások.
1	A felhasználó lenyomott egy megjelenített kulcsleírást.

Megjegyzések

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

Lekéri a menüszalag sávjának aktuális billentyűzet-navigációs objektumát.

CObject* GetKeyboardNavLevelCurrent() const;

Visszaadott érték

A menüszalag sávjának aktuális billentyűzet-navigációs objektuma; ellenkező esetben NULL, ha jelenleg egyetlen objektum sem jelenít meg kulcsleírásokat.

Megjegyzések

A billentyűleírásokat jelenleg megjelenítő objektum az aktuális billentyűzet-navigációs objektum.

`CMFCRibbonBar::GetKeyboardNavLevelParent`

Lekéri a szülőbillentyűzet navigációs objektumát a menüszalagsávon.

CObject* GetKeyboardNavLevelParent() const;

Visszaadott érték

A szülőbillentyűzet navigációs objektuma a menüszalagsávon; egyéb esetben NULL.

Megjegyzések

Amikor a felhasználó lenyom egy billentyűt a menüszalagsávon, az aktuális billentyűzet navigációs objektum lesz a szülőbillentyűzet navigációs objektuma.

`CMFCRibbonBar::GetMainCategory`

A menüszalag fő kategóriájára mutató mutatót kér le.

CMFCRibbonCategory* GetMainCategory() const;

Visszaadott érték

A menüszalag fő kategóriájára mutató mutató.

Megjegyzések

A fő menüszalag kategória tartalmazza a fő menüszalag panelt.

`CMFCRibbonBar::GetQATCommandsLocation`

Lekéri a gyorselérési eszköztár parancsszakaszának megjelenítendő téglalapját.

CRect GetQATCommandsLocation() const;

Visszaadott érték

A gyorselérési eszköztár parancsszakaszának megjelenítendő téglalapja.

Megjegyzések

A megjelenítési téglalap parancsszakasza nem tartalmazza a testreszabás gombot.

`CMFCRibbonBar::GetQATDroppedDown`

A gyorselérési eszköztár menüszalagelemére mutató mutatót kér le, amelynek előugró menüje le van állítva.

CMFCRibbonBaseElement* GetQATDroppedDown();

Visszaadott érték

A gyorselérési eszköztár menüszalagelemére mutató mutató, amelyen az előugró menü le van állítva.

Megjegyzések

`CMFCRibbonBar::GetQuickAccessCommands`

A gyorselérési eszköztár menüszalagelemeinek parancsazonosítóinak listáját kéri le.

void GetQuickAccessCommands(CList<UINT,UINT>& lstCommands);

Paraméterek

lstCommands
[kifelé] A gyorselérési eszköztár menüszalagelemeinek parancsazonosítóinak listája.

Megjegyzések

A lista nem tartalmaz olyan menüszalagelemeket, amelyek vezérlőelválasztók.

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

A gyorselérési eszköztár megjelenítendő téglalapjának lekérése.

CRect GetQuickAccessToolbarLocation() const;

Visszaadott érték

A gyorselérési eszköztár megjelenítési téglalapja.

Megjegyzések

`CMFCRibbonBar::GetTabTrancateRatio`

Lekéri a kategóriafülek megjelenítési szélességének százalékos méretét.

int GetTabTrancateRatio() const;

Visszaadott érték

A kategóriafülek megjelenítési szélességének százalékos csökkentése.

Megjegyzések

A kategóriafülek szélessége csökken, ha nincs elég szélesség a menüszalagsávon.

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

Lekéri a menüszalagsáv elemleírás-szélességének nagy méretét.

int GetTooltipFixedWidthLargeImage() const;

Visszaadott érték

Az elemleírás szélességének nagy mérete képpontban.

Megjegyzések

Ha az elemleírás szélessége 0, a szélesség változó.

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

Lekéri a menüszalagsáv elemleírás-szélességének normál méretét.

int GetTooltipFixedWidthRegular() const;

Visszaadott érték

Az elemleírás szélességének normál mérete képpontban.

Megjegyzések

Ha az elemleírás szélességének normál mérete 0, a szélesség változó.

`CMFCRibbonBar::GetVisibleCategoryCount`

Lekéri a menüszalag sávján látható kategóriák számát.

int GetVisibleCategoryCount() const;

Visszaadott érték

A menüszalag sávján látható kategóriák száma.

Megjegyzések

`CMFCRibbonBar::HideAllContextCategories`

Elrejti az összes környezeti kategóriát a menüszalagsávon.

BOOL HideAllContextCategories();

Visszaadott érték

TRUE, ha legalább egy környezetkategória el volt rejtve; ellenkező esetben FALSE.

Megjegyzések

Ha egy környezetkategória aktív, az aktív kategória a kategórialistában az első látható kategóriára lesz visszaállítva.

`CMFCRibbonBar::HideKeyTips`

Elrejti a menüszalag sávjának összes kulcsleírását.

void HideKeyTips();

Megjegyzések

`CMFCRibbonBar::HitTest`

A pont helye által megadott menüszalagelemre mutató mutatót kér le.

virtual CMFCRibbonBaseElement* HitTest(
    CPoint point,
    BOOL bCheckActiveCategory= FALSE,
    BOOL bCheckPanelCaption= FALSE);

Paraméterek

point
[in] A pont helye a menüszalag sávkoordinátáiban.

bCheckActiveCategory
[in] TRUE az aktív kategória kereséséhez; FALSE, hogy ne keressen az aktív kategóriában.

bCheckPanelCaption
[in] TRUE, hogy tesztelje a menüszalag paneljének feliratát a benne található ponttal; FALSE ne tesztelje a menüszalag paneljének feliratát a benne található ponttal. További információt a Megjegyzések szakaszban talál.

Visszaadott érték

A megadott ponton található menüszalagelemre mutató mutató; ellenkező esetben NULL, ha a pont nem egy menüszalagelemben található.

Megjegyzések

A menüszalag paneljének felirata és a benne található pont csak akkor lesz tesztelve, ha a bCheckActiveCategory paraméter TRUE.

`CMFCRibbonBar::IsKeyTipEnabled`

Azt jelzi, hogy a kulcsleírások funkció engedélyezve van-e.

BOOL IsKeyTipEnabled() const;

Visszaadott érték

TRUE, hogy engedélyezve van-e a kulcsleírások funkció; egyéb esetben FALSE.

`CMFCRibbonBar::IsMainRibbonBar`

Azt jelzi, hogy a menüszalag sávja-e az elsődleges szalagsáv.

virtual BOOL IsMainRibbonBar() const;

Visszaadott érték

Mindig TRUEad vissza.

Megjegyzések

Alapértelmezés szerint ez a metódus mindig TRUEad vissza. A metódus felülbírálása annak jelzésére, hogy a menüszalag sávja az elsődleges szalagsáv.

`CMFCRibbonBar::IsPrintPreviewEnabled`

Azt jelzi, hogy a Nyomtatási kép funkció engedélyezve van-e.

BOOL IsPrintPreviewEnabled() const;

Visszaadott érték

TRUE, hogy engedélyezve van-e a Nyomtatási kép funkció; egyéb esetben FALSE.

`CMFCRibbonBar::IsQATEmpty`

Azt jelzi, hogy a gyorselérési eszköztár tartalmaz-e parancsgombokat.

BOOL IsQATEmpty() const;

Visszaadott érték

TRUE, hogy a gyorselérési eszköztár tartalmaz-e parancsgombokat; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::IsQuickAccessToolbarOnTop`

Azt jelzi, hogy a gyorselérési eszköztár a menüszalagsávon vagy alatt található-e.

BOOL IsQuickAccessToolbarOnTop() const;

Visszaadott érték

TRUE, hogy a gyorselérési eszköztár a menüszalagsávon található-e; FALSE, ha a gyorselérési eszköztár a menüszalag alatt található.

`CMFCRibbonBar::IsReplaceFrameCaption`

Azt jelzi, hogy a szalagsáv lecserélve van-e, vagy a fő keretablak felirata alatt van.

BOOL IsReplaceFrameCaption() const;

Visszaadott érték

TRUE, ha a szalagsáv lecseréli a fő keretablak feliratát; FALSE, ha a szalagsáv a fő keretablak felirata alatt van.

`CMFCRibbonBar::IsShowGroupBorder`

Azt jelzi, hogy a menüszalagsávon található gombcsoportok megjelenítenek-e csoportszegélyt.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Paraméterek

pGroup
[in] Ezt a paramétert nem használja a rendszer.

Visszaadott érték

Mindig FALSEad vissza.

Megjegyzések

Alapértelmezés szerint ez a metódus mindig FALSEad vissza. A metódus felülbírálása annak jelzéséhez, hogy a menüszalag sávján található gombcsoportok megjelenítenek-e csoportszegélyt.

`CMFCRibbonBar::IsToolTipDescrEnabled`

Azt jelzi, hogy engedélyezve vannak-e az elemleírások leírásai.

BOOL IsToolTipDescrEnabled() const;

Visszaadott érték

TRUE, hogy engedélyezve vannak-e az elemleírások leírása; FALSE, ha az elemleírások leírása le van tiltva.

Megjegyzések

Az elemleírás-leírások további leíró szövegek, amelyek az elemleírás szövegével jelennek meg.

`CMFCRibbonBar::IsToolTipEnabled`

Azt jelzi, hogy engedélyezve vagy letiltva vannak-e az elemleírások a menüszalagsávon.

BOOL IsToolTipEnabled() const;

Visszaadott érték

TRUE, hogy engedélyezve vannak-e az elemleírások; FALSE, ha az elemleírások le vannak tiltva.

`CMFCRibbonBar::IsTransparentCaption`

Azt jelzi, hogy a megjelenítés be van-e állítva a Windows Aero színsémához.

BOOL IsTransparentCaption() const;

Visszaadott érték

TRUE, hogy a színséma Windows Aero-e; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::OnClickButton`

Ez a módszer megmarad a meglévő alkalmazásokkal való visszamenőleges kompatibilitás érdekében, és nem használható új fejlesztéshez.

virtual void OnClickButton(
    CMFCRibbonButton* pButton,
    CPoint point);

Paraméterek

pButton
[in] Mutasson a kattintott gombra.

point
[in] Ezt a paramétert nem használja a rendszer.

Megjegyzések

`CMFCRibbonBar::OnEditContextMenu`

virtual void OnEditContextMenu(
    CMFCRibbonRichEditCtrl* pEdit,
    CPoint point);

Paraméterek

[in] pEdit
[in] point

Megjegyzések

`CMFCRibbonBar::OnRTLChanged`

A keretrendszer meghívta, amikor az elrendezés irányt változtat.

virtual void OnRTLChanged(BOOL bIsRTL);

Paraméterek

bIsRTL
[in] TRUE, ha az elrendezés jobbról balra; FALSE, hogy az elrendezés balról jobbra van-e.

Megjegyzések

Ez a módszer az új elrendezés irányának megfelelően módosítja a menüszalag sávjának összes vezérlőjének elrendezését.

`CMFCRibbonBar::OnSetAccData`

Ez a metódus a keretrendszer belső része, és nem felhasználói kódból való meghívásra szolgál.

BOOL OnSetAccData(long lVal);

Paraméterek

hosszú lVal Az akadálymentes objektum indexe.

Visszaadott érték

sikeres S_OK; egyéb esetben FALSE vagy S_FALSE.

Megjegyzések

`CMFCRibbonBar::OnShowRibbonContextMenu`

virtual BOOL OnShowRibbonContextMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Paraméterek

[in] pWnd
[in] x
[in] y
[in] pHit

Visszaadott érték

Megjegyzések

`CMFCRibbonBar::OnShowRibbonQATMenu`

virtual BOOL OnShowRibbonQATMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Paraméterek

[in] pWnd
[in] x
[in] y
[in] pHit

Visszaadott érték

Megjegyzések

`CMFCRibbonBar::OnSysKeyDown`

A keretrendszer meghívja, amikor a felhasználó lenyomja az F10 billentyűt, vagy lenyomja a ALT billentyűt, majd lenyom egy másik billentyűt.

BOOL OnSysKeyDown(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Paraméterek

pFrameWnd
[in] Mutasson a menüszalagsáv szülőkeretablakára.

wParam
[in] A lenyomott kulcs virtuális kulcskódja.

lParam
[in] A billentyűzet állapotjelzői a billentyű lenyomásakor.

Visszaadott érték

TRUE, hogy a billentyűleütési esemény feldolgozása megtörtént-e; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::OnSysKeyUp`

A keretrendszer meghívja, amikor a felhasználó kiadja az F10 kulcsot, az ALT kulcsot, vagy egy olyan kulcsot, amelyet a ALT billentyű lenyomásakor lenyomtak.

BOOL OnSysKeyUp(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Paraméterek

pFrameWnd
[in] Mutasson a menüszalagsáv szülőkeretablakára.

wParam
[in] A felszabadított kulcs virtuális kulcskódja.

lParam
[in] Ezt a paramétert nem használja a rendszer.

Visszaadott érték

TRUE, hogy a billentyűleütési esemény feldolgozása megtörtént-e; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::PopTooltip`

Elemleírás eltávolítása a nézetből.

void PopTooltip();

Megjegyzések

`CMFCRibbonBar::PreTranslateMessage`

Meghatározza, hogy a menüszalag sávja feldolgozta-e a megadott üzenetet.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Paraméterek

pMsg
[in] Mutasson egy üzenetre.

Visszaadott érték

TRUE, hogy a menüszalag sávja feldolgozta-e az üzenetet; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::RecalcLayout`

A menüszalagsávon lévő összes vezérlő elrendezését módosítja.

virtual void RecalcLayout();

Megjegyzések

Az elrendezés módosítása után a menüszalag sávjának megjelenítése frissül.

`CMFCRibbonBar::RemoveAllCategories`

Törli az összes menüszalagkategóriát a menüszalagsávról.

void RemoveAllCategories();

Megjegyzések

Ez a metódus törli az összes menüszalagkategóriát a memóriából és a kategórialistából.

`CMFCRibbonBar::RemoveAllFromTabs`

Eltávolítja a menüszalag összes elemét a lapterületről.

void RemoveAllFromTabs();

Megjegyzések

Ezt a függvényt akkor használja, ha CMFCRibbonBar::AddToTabs metódussal el szeretné távolítani a lapterületre felvett összes elemet.

`CMFCRibbonBar::RemoveCategory`

Törli a megadott menüszalagkategóriát a menüszalagsávról.

BOOL RemoveCategory(int nIndex);

Paraméterek

nIndex
[in] Egy kategória nullaalapú indexe a menüszalagsávon található menüszalagkategóriák listájában.

Visszaadott érték

TRUE, hogy a megadott menüszalagkategória törölve lett-e; egyéb esetben FALSE.

Megjegyzések

A megadott menüszalagkategória törlődik a memóriából és a kategórialistából.

`CMFCRibbonBar::SetActiveCategory`

A megadott menüszalagkategória beállítása aktív kategóriaként.

BOOL SetActiveCategory(
    CMFCRibbonCategory* pCategory,
    BOOL bForceRestore= FALSE);

Paraméterek

pCategory
[in] A menüszalag sávjában található menüszalagkategória.

bForceRestore
[in] TRUE a szalagsáv teljes méretének maximalizálásához, ha kis méretű; FALSE az aktív kategória megjelenítéséhez egy előugró ablakban, ha a menüszalag sávja kis méretű.

Visszaadott érték

TRUE, hogy a megadott kategória aktív kategória-e; egyéb esetben FALSE.

Megjegyzések

A menüszalag fő kategóriája nem lehet aktív kategória.

Ha a pCategory által megadott kategória nem jelenik meg, akkor nem állítható be aktív kategóriaként.

`CMFCRibbonBar::SetActiveMDIChild`

A többdokumentumos felület (MDI) gyermekablakához tartozó menüszalagsáv rendszergombjait a megadott MDI gyermekablakhoz társítja.

void SetActiveMDIChild(CWnd* pWnd);

Paraméterek

pWnd
[in] Mutasson egy MDI gyermekablakra.

Megjegyzések

`CMFCRibbonBar::SetApplicationButton`

Alkalmazás menüszalagjának gombjának hozzárendelése a menüszalagsávhoz.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Paraméterek

pButton
[in] Mutató az alkalmazás menüszalagjának gombjára.

sizeButton
[in] Az alkalmazás menüszalagjának mérete gomb.

Megjegyzések

Az alkalmazás menüszalag gombja egy nagy, lekerekített gomb, amely a menüszalag vezérlőelem bal felső sarkában található.

Példa

Az alábbi példa bemutatja, hogyan használható a SetApplicationButton metódus a CMFCRibbonBar osztályban.

// Init main button:
// CMFCRibbonApplicationButton m_MainButton
m_MainButton.SetImage(IDB_MAIN);
m_MainButton.SetText(_T("\nf"));
m_MainButton.SetToolTipText(strTemp);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetApplicationButton(&m_MainButton, CSize(45, 45));

`CMFCRibbonBar::SetElementKeys`

Beállítja a megadott parancsazonosítóval rendelkező összes menüszalag-elemhez tartozó kulcsleírásokat.

BOOL SetElementKeys(
    UINT uiCmdID,
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys= NULL);

Paraméterek

uiCmdID
[in] Egy menüszalagelem parancsazonosítója.

lpszKeys
[in] A kulcsleírás.

lpszMenuKeys
[in] A menükulcstipp.

Visszaadott érték

TRUE, hogy legalább egy menüszalagelem kulcsleírása be van-e állítva; egyéb esetben FALSE.

Megjegyzések

Az opcionális menükulcstipp a felugró menüt megnyitó felosztott gombot tartalmazó menüszalagelemekhez tartozik.

`CMFCRibbonBar::SetKeyboardNavigationLevel`

A billentyűzet navigációs szintjét úgy állítja be, hogy a felhasználó lenyomja a menüszalagsávon található billentyűleírásokat.

void SetKeyboardNavigationLevel(
    CObject* pLevel,
    BOOL bSetFocus = TRUE);

Paraméterek

pLevel
[in] Mutasson az aktuális billentyűzet navigációs objektumára.

bSetFocus
[in] TRUE a menüszalag sávjának billentyűzetfókuszának beállításához.

Megjegyzések

A menüszalag sávjának billentyűzetes navigációja akkor indul el, amikor a felhasználó lenyomja az ALT vagy F10 billentyűt. A felhasználó a menüszalag sávján található billentyűtipp lenyomásával választja ki a következő navigációs szintet. A felhasználó a feloldókulcs lenyomásával visszatérhet az előző navigációs szintre.

`CMFCRibbonBar::SetMaximizeMode`

Akkor módosítja a menüszalagsávot, ha egy több dokumentumból álló felület (MDI) gyermekablakának ablakmérete belép vagy elhagyja a teljes állapotot.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL);

Paraméterek

bMax
[in] TRUE egy MDI gyermekablak rendszergombjainak megjelenítéséhez a menüszalagsávon; FALSE egy MDI gyermekablak rendszergombjainak eltávolításához a menüszalagsávról.

pWnd
[in] Mutasson a menüszalagsáv fő keretablakára.

Megjegyzések

A menüszalag sávja egy MDI gyermekablak rendszergombjait jeleníti meg a tabulátorsorban, amikor az MDI gyermekablaka teljes méretű.

`CMFCRibbonBar::SetQuickAccessCommands`

Egy vagy több menüszalagelemet ad hozzá a gyorselérési eszköztárhoz.

void SetQuickAccessCommands(
    const CList<UINT,UINT>& lstCommands,
    BOOL bRecalcLayout=TRUE);

Paraméterek

lstCommands
[in] A gyorselérési eszköztáron elhelyezendő parancsok listája.

bRecalcLayout
[in] TRUE, ha a menüszalag elemeinek hozzáadása után újra szeretné átrajzolni a menüszalagot; máskülönben FALSE.

Példa

Az alábbi példa bemutatja, hogyan használható a SetQuickAccessCommands metódus a CMFCRibbonBar osztályban.

// Add quick access commands to the toolbar
CList<UINT, UINT> lstQATCmds;

lstQATCmds.AddTail(ID_FILE_NEW);
lstQATCmds.AddTail(ID_FILE_OPEN);
lstQATCmds.AddTail(ID_FILE_SAVE);
lstQATCmds.AddTail(ID_FILE_PRINT_DIRECT);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessCommands(lstQATCmds);

`CMFCRibbonBar::SetQuickAccessDefaultState`

A gyorselérési eszköztár beállítása az alapértelmezett állapotra.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Paraméterek

state
[in] A gyorselérési eszköztár alapértelmezett állapota.

Megjegyzések

A gyorselérési eszköztár állapota tartalmazza a parancsok listáját és azok láthatóságát.

Példa

Az alábbi példa bemutatja, hogyan használható a SetQuickAccessDefaultState metódus a CMFCRibbonBar osztályban.

CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
    new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessDefaultState(*qaToolBarState);

`CMFCRibbonBar::SetQuickAccessToolbarOnTop`

A gyorselérési eszköztár elhelyezése a menüszalag sávja fölött vagy alatt.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Paraméterek

bOnTop
[in] TRUE a gyorselérési eszköztár a menüszalag sávja felett való elhelyezéséhez; FALSE a gyorselérési eszköztár a menüszalag alatt való elhelyezéséhez.

`CMFCRibbonBar::SetTooltipFixedWidth`

Beállítja a szalagsáv elemleírásának normál és nagy méretű rögzített szélességét.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Paraméterek

nWidthRegular
[in] Egy normál rögzített méretű elemleírás képpontban kifejezett szélessége.

nWidthLargeImage
[in] Egy nagy, rögzített méretű elemleírás szélessége képpontban.

Megjegyzések

Ha egy paramétert 0-ra állít be, a megfelelő szélesség eltérő lesz.

`CMFCRibbonBar::ShowCategory`

Megjeleníti vagy elrejti a megadott menüszalagkategóriát.

void ShowCategory(
    int nIndex,
    BOOL bShow=TRUE);

Paraméterek

nIndex
[in] A menüszalag kategória indexe.

bShow
[in] Ha TRUE, a menüszalag kategória megjelenítése; ellenkező esetben rejtse el a menüszalag kategóriáját.

`CMFCRibbonBar::ShowContextCategories`

Megjeleníti vagy elrejti a megadott azonosítóval rendelkező környezeti kategóriákat.

void ShowContextCategories(
    UINT uiContextID,
    BOOL bShow=TRUE);

Paraméterek

uiContextID
[in] A környezeti kategória azonosítója.

bShow
[in] Ha TRUE, a megadott azonosítóval rendelkező kategóriák megjelenítése; ellenkező esetben rejtse el a megadott azonosítóval rendelkező kategóriákat.

`CMFCRibbonBar::ShowKeyTips`

A menüszalag sávjának egyes menüszalagelemeihez tartozó kulcsleírásokat jeleníti meg.

void ShowKeyTips();

Megjegyzések

`CMFCRibbonBar::ToggleMimimizeState`

A szalagsáv váltása a kis méretű és a teljes állapot között.

void ToggleMimimizeState();

Megjegyzések

A metódusnévben szereplő elírás ismert probléma.

Kis méretű állapotban a menüszalag vezérlőelem rejtett, és csak a lapok jelennek meg. Amikor a felhasználó egy fülre kattint, a menüszalag vezérlőelem előugró ablakként jelenik meg. Az ablak bezárul, amikor a felhasználó rákattint vagy végrehajt egy parancsot.

`CMFCRibbonBar::TranslateChar`

Meghatározza, hogy a menüszalagsáv feldolgozta-e a megadott billentyűleütési karakterkódot.

virtual BOOL TranslateChar(UINT nChar);

Paraméterek

nChar
[in] Egy felhasználói billentyűleütés karakterkódja.

Visszaadott érték

TRUE, hogy a menüszalagsáv feldolgozta-e a karakterkódot; egyéb esetben FALSE.

Megjegyzések

A billentyűtippek funkcióval a felhasználók a billentyűzet használatával navigálhatnak a menüszalag sávján.

`CMFCRibbonBar::GetFocused`

Egy szűrt elemet ad vissza.

virtual CMFCRibbonBaseElement* GetFocused();

Visszaadott érték

Mutató egy szűrt elemre vagy NULL.

Megjegyzések

`CMFCRibbonBar::IsWindows7Look`

Azt jelzi, hogy a menüszalag windows 7 megjelenésű-e (kis téglalap alakú alkalmazásgomb).

BOOL IsWindows7Look() const;

Visszaadott érték

TRUE, hogy a menüszalag windows 7-beli megjelenéssel rendelkezik-e; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::LoadFromResource`

Túlterhelt. Betölt egy menüszalagsávot az alkalmazáserőforrásokból.

virtual BOOL LoadFromResource(
    UINT uiXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

virtual BOOL LoadFromResource(
    LPCTSTR lpszXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

Paraméterek

uiXMLResID
Az XML-sztring erőforrás-azonosítóját adja meg a menüszalagsáv adataival.

lpszResType
A uiXMLResIDhelyen található erőforrás típusát adja meg.

hInstance
Kezelje azt a modult, amelynek végrehajtható fájlja tartalmazza az erőforrást. Ha hInstanceNULL, a rendszer betölti az erőforrást az aktuális folyamat létrehozásához használt modulból.

lpszXMLResID
Megadja az erőforrás-azonosítót (sztring formában) a menüszalagsáv adataival.

Visszaadott érték

TRUE, hogy a terhelés sikeres-e; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::SaveToXMLBuffer`

Menti a menüszalagsávot egy pufferbe.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Paraméterek

ppBuffer
Amikor ez a függvény visszatér, ppBuffer a metódus által lefoglalt pufferre mutat, és XML formátumban tartalmazza a szalagsáv adatait.

Visszaadott érték

sikeres TRUE; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::SaveToXMLFile`

A menüszalagsávot XML-fájlba menti.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Paraméterek

lpszFilePath
Megadja a kimeneti fájlt.

Visszaadott érték

sikeres TRUE; egyéb esetben FALSE.

Megjegyzések

`CMFCRibbonBar::SetWindows7Look`

Engedélyezi vagy letiltja a Windows 7 megjelenését (kis téglalap alakú alkalmazásgomb) a menüszalagon.

void SetWindows7Look(
    BOOL bWindows7Look,
    BOOL bRecalc = TRUE);

Paraméterek

bWindows7Look
TRUE Windows 7-megjelenést állít be; máskülönben FALSE.

bRecalc
TRUE újraszámítja a menüszalag elrendezését; máskülönben FALSE.

Megjegyzések

Lásd még:

hierarchiadiagram
osztályok
CPane osztály
CMFCRibbonCategory osztály
CMFCRibbonPanel osztály
CMFCRibbonBaseElement osztály
útmutató: Az MFC Scribble-alkalmazás frissítése

Megosztás a következőn keresztül:

CMFCRibbonBar osztály

Szintaxis

Tagok

Nyilvános konstruktorok

Nyilvános metódusok

Megjegyzések

Öröklési hierarchia

Követelmények

CMFCRibbonBar::ActivateContextCategory

Paraméterek

Visszaadott érték

CMFCRibbonBar::AddCategory

Paraméterek

Visszaadott érték

Megjegyzések

Példa

CMFCRibbonBar::AddContextCategory

Paraméterek

Visszaadott érték

Megjegyzések

CMFCRibbonBar::AddMainCategory

Paraméterek

Visszaadott érték

Megjegyzések

Példa

CMFCRibbonBar::AddPrintPreviewCategory

Visszaadott érték

Megjegyzések

CMFCRibbonBar::AddQATOnlyCategory

Paraméterek

Visszaadott érték

Megjegyzések

CMFCRibbonBar::AddToTabs

Paraméterek

Megjegyzések

CMFCRibbonBar::CMFCRibbonBar

Paraméterek

Megjegyzések

CMFCRibbonBar::Create

Paraméterek

Visszaadott érték

Megjegyzések

Példa

CMFCRibbonBar::CreateEx

Paraméterek

Visszaadott érték

Megjegyzések

CMFCRibbonBar::DeactivateKeyboardFocus

Paraméterek

Megjegyzések

CMFCRibbonBar::DrawMenuImage

Paraméterek

Visszaadott érték

Megjegyzések

CMFCRibbonBar::DWMCompositionChanged

Megjegyzések

CMFCRibbonBar::EnableKeyTips

Paraméterek

Megjegyzések

CMFCRibbonBar::EnablePrintPreview

Paraméterek

Megjegyzések

CMFCRibbonBar::EnableToolTips

Paraméterek

Megjegyzések

CMFCRibbonBar::FindByData

Paraméterek

Visszaadott érték

Megjegyzések

CMFCRibbonBar::FindByID

Paraméterek

Visszaadott érték

Megjegyzések

CMFCRibbonBar::FindCategoryIndexByData

Paraméterek

Visszaadott érték

CMFCRibbonBar::ForceRecalcLayout

Megjegyzések

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar` osztály

`CMFCRibbonBar::ActivateContextCategory`

`CMFCRibbonBar::AddCategory`

`CMFCRibbonBar::AddContextCategory`

`CMFCRibbonBar::AddMainCategory`

`CMFCRibbonBar::AddPrintPreviewCategory`

`CMFCRibbonBar::AddQATOnlyCategory`

`CMFCRibbonBar::AddToTabs`

`CMFCRibbonBar::CMFCRibbonBar`

`CMFCRibbonBar::Create`

`CMFCRibbonBar::CreateEx`

`CMFCRibbonBar::DeactivateKeyboardFocus`

`CMFCRibbonBar::DrawMenuImage`

`CMFCRibbonBar::DWMCompositionChanged`

`CMFCRibbonBar::EnableKeyTips`

`CMFCRibbonBar::EnablePrintPreview`

`CMFCRibbonBar::EnableToolTips`

`CMFCRibbonBar::FindByData`

`CMFCRibbonBar::FindByID`

`CMFCRibbonBar::FindCategoryIndexByData`

`CMFCRibbonBar::ForceRecalcLayout`

`CMFCRibbonBar::GetActiveCategory`

`CMFCRibbonBar::GetApplicationButton`

`CMFCRibbonBar::GetCaptionHeight`

`CMFCRibbonBar::GetCategory`

`CMFCRibbonBar::GetCategoryCount`

`CMFCRibbonBar::GetCategoryHeight`

`CMFCRibbonBar::GetCategoryIndex`

`CMFCRibbonBar::GetContextName`

`CMFCRibbonBar::GetDroppedDown`

`CMFCRibbonBar::GetElementsByID`

`CMFCRibbonBar::GetHideFlags`

`CMFCRibbonBar::GetItemIDsList`

`CMFCRibbonBar::GetKeyboardNavigationLevel`

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

`CMFCRibbonBar::GetKeyboardNavLevelParent`

`CMFCRibbonBar::GetMainCategory`

`CMFCRibbonBar::GetQATCommandsLocation`

`CMFCRibbonBar::GetQATDroppedDown`

`CMFCRibbonBar::GetQuickAccessCommands`

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

`CMFCRibbonBar::GetTabTrancateRatio`

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

`CMFCRibbonBar::GetVisibleCategoryCount`