`CMFCRibbonBar` Klasa

Artykuł
04/03/2023

Klasa CMFCRibbonBar implementuje pasek wstążki podobny do tego, który jest używany w pakiecie Office 2007.

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w mfc folderze instalacji programu Visual Studio. Na przykład %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Składnia

class CMFCRibbonBar : public CPane

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
`CMFCRibbonBar::CMFCRibbonBar`	Konstruktor domyślny.

Metody publiczne

Nazwa/nazwisko	opis
`CMFCRibbonBar::ActivateContextCategory`	Aktywuje kategorię kontekstu, która jest już widoczna.
`CMFCRibbonBar::AddCategory`	Dodaje nową kategorię wstążki do wstążki.
`CMFCRibbonBar::AddContextCategory`	Dodaje kategorię kontekstu.
`CMFCRibbonBar::AddMainCategory`	Dodaje nową kategorię głównej wstążki.
`CMFCRibbonBar::AddPrintPreviewCategory`
`CMFCRibbonBar::AddQATOnlyCategory`
`CMFCRibbonBar::AddToTabs`	Dodaj element wstążki po prawej stronie paska wstążki.
`CMFCRibbonBar::CreateEx`	Tworzy pasek sterowania i dołącza go do `CPane` obiektu. (Przesłania `CPane::CreateEx`).
`CMFCRibbonBar::Create`	Tworzy kontrolkę paska wstążki i dołącza ją do paska wstążki.
`CMFCRibbonBar::DeactivateKeyboardFocus`
`CMFCRibbonBar::DrawMenuImage`
`CMFCRibbonBar::DWMCompositionChanged`
`CMFCRibbonBar::EnableKeyTips`	Włącz lub wyłącz porady dotyczące klawiszy dla kontrolki wstążki.
`CMFCRibbonBar::EnablePrintPreview`	Włącz kartę Podgląd wydruku.
`CMFCRibbonBar::EnableToolTips`	Włącza lub wyłącza etykietki narzędzi i opisy etykietek narzędzi na pasku wstążki.
`CMFCRibbonBar::FindByData`	Znajdź element wstążki przy użyciu danych, które określa użytkownik.
`CMFCRibbonBar::FindByID`	Znajduje element wstążki o określonym identyfikatorze polecenia.
`CMFCRibbonBar::FindCategoryIndexByData`	Znajduje indeks kategorii wstążki zawierający dane zdefiniowane przez użytkownika.
`CMFCRibbonBar::ForceRecalcLayout`
`CMFCRibbonBar::GetActiveCategory`	Pobiera wskaźnik do aktywnej kategorii.
`CMFCRibbonBar::GetCaptionHeight`	Zwraca wysokość podpis. (Przesłania `CBasePane::GetCaptionHeight`).
`CMFCRibbonBar::GetCategory`	Pobiera wskaźnik do kategorii znajdującej się w określonym indeksie.
`CMFCRibbonBar::GetCategoryCount`	Pobiera liczbę kategorii wstążki na pasku wstążki.
`CMFCRibbonBar::GetCategoryHeight`
`CMFCRibbonBar::GetCategoryIndex`	Zwraca indeks kategorii wstążki.
`CMFCRibbonBar::GetContextName`	Pobiera nazwę kategorii kontekstu podpis, którą określisz przy użyciu identyfikatora.
`CMFCRibbonBar::GetDroppedDown`
`CMFCRibbonBar::GetElementsByID`	Pobiera tablicę zawierającą wskaźniki do wszystkich elementów wstążki, które mają określony identyfikator.
`CMFCRibbonBar::GetApplicationButton`	Pobiera wskaźnik do przycisku wstążki.
`CMFCRibbonBar::GetFocused`	Zwraca element fokusu.
`CMFCRibbonBar::GetHideFlags`
`CMFCRibbonBar::GetItemIDsList`
`CMFCRibbonBar::GetKeyboardNavigationLevel`
`CMFCRibbonBar::GetKeyboardNavLevelCurrent`
`CMFCRibbonBar::GetKeyboardNavLevelParent`
`CMFCRibbonBar::GetMainCategory`	Zwraca wskaźnik do aktualnie wybranej kategorii wstążki.
`CMFCRibbonBar::GetQATCommandsLocation`
`CMFCRibbonBar::GetQATDroppedDown`
`CMFCRibbonBar::GetQuickAccessCommands`	Wypełnia listę zawierającą identyfikatory poleceń wszystkich elementów wyświetlanych na pasku narzędzi Szybki dostęp.
`CMFCRibbonBar::GetQuickAccessToolbarLocation`
`CMFCRibbonBar::GetTabTrancateRatio`
`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`
`CMFCRibbonBar::GetTooltipFixedWidthRegular`
`CMFCRibbonBar::GetVisibleCategoryCount`
`CMFCRibbonBar::HideAllContextCategories`	Ukrywa wszystkie kategorie, które są aktywne i widoczne.
`CMFCRibbonBar::HideKeyTips`
`CMFCRibbonBar::HitTest`	Znajduje wskaźnik do elementu wstążki, który znajduje się w określonym punkcie we współrzędnych klienta paska wstążki.
`CMFCRibbonBar::IsKeyTipEnabled`	Określa, czy są włączone etykietki kluczy.
`CMFCRibbonBar::IsMainRibbonBar`
`CMFCRibbonBar::IsPrintPreviewEnabled`	Określa, czy karta Podgląd wydruku jest włączona.
`CMFCRibbonBar::IsQATEmpty`
`CMFCRibbonBar::IsQuickAccessToolbarOnTop`	Określa, czy pasek narzędzi szybkiego dostępu znajduje się nad paskiem wstążki.
`CMFCRibbonBar::IsReplaceFrameCaption`	Określa, czy pasek wstążki zastępuje podpis ramki głównej, czy jest dodawany poniżej podpis ramki.
`CMFCRibbonBar::IsShowGroupBorder`
`CMFCRibbonBar::IsToolTipDescrEnabled`	Określa, czy opisy etykietek narzędzi są włączone.
`CMFCRibbonBar::IsToolTipEnabled`	Określa, czy etykietki narzędzi paska wstążki są włączone.
`CMFCRibbonBar::IsTransparentCaption`
`CMFCRibbonBar::IsWindows7Look`	Wskazuje, czy wstążka ma wygląd w stylu windows 7 (mały prostokątny przycisk aplikacji).
`CMFCRibbonBar::LoadFromResource`	Przeciążone. Ładuje pasek wstążki z zasobów aplikacji.
`CMFCRibbonBar::OnClickButton`
`CMFCRibbonBar::OnEditContextMenu`
`CMFCRibbonBar::OnRTLChanged`	(Przesłania `CPane::OnRTLChanged`).
`CMFCRibbonBar::OnSetAccData`	(Przesłania `CBasePane::OnSetAccData`).
`CMFCRibbonBar::OnShowRibbonContextMenu`
`CMFCRibbonBar::OnShowRibbonQATMenu`
`CMFCRibbonBar::OnSysKeyDown`
`CMFCRibbonBar::OnSysKeyUp`
`CMFCRibbonBar::PopTooltip`
`CMFCRibbonBar::PreTranslateMessage`	(Przesłania `CBasePane::PreTranslateMessage`).
`CMFCRibbonBar::RecalcLayout`	(Przesłania `CPane::RecalcLayout`).
`CMFCRibbonBar::RemoveAllCategories`	Usuwa wszystkie kategorie wstążki na pasku wstążki.
`CMFCRibbonBar::RemoveAllFromTabs`	Usuwa wszystkie elementy wstążki z obszaru karty.
`CMFCRibbonBar::RemoveCategory`	Usuwa kategorię wstążki znajdującą się w określonym indeksie.
`CMFCRibbonBar::SaveToXMLBuffer`	Zapisuje pasek wstążki w buforze.
`CMFCRibbonBar::SaveToXMLFile`	Zapisuje pasek wstążki w pliku XML.
`CMFCRibbonBar::SetActiveCategory`	Ustawia aktywną kategorię określonej wstążki.
`CMFCRibbonBar::SetActiveMDIChild`
`CMFCRibbonBar::SetElementKeys`	Ustawia określone etykietki klawiszy dla wszystkich elementów wstążki, które mają określony identyfikator polecenia.
`CMFCRibbonBar::SetApplicationButton`	Przypisuje przycisk wstążki aplikacji do paska wstążki.
`CMFCRibbonBar::SetKeyboardNavigationLevel`
`CMFCRibbonBar::SetMaximizeMode`
`CMFCRibbonBar::SetQuickAccessCommands`	Dodaje co najmniej jeden element wstążki do paska narzędzi Szybki dostęp.
`CMFCRibbonBar::SetQuickAccessDefaultState`	Określa stan domyślny paska narzędzi Szybki dostęp.
`CMFCRibbonBar::SetQuickAccessToolbarOnTop`	Umieszcza pasek narzędzi Szybki dostęp (QAT) powyżej lub poniżej paska wstążki.
`CMFCRibbonBar::SetTooltipFixedWidth`
`CMFCRibbonBar::SetWindows7Look`	Włączanie/wyłączanie wyglądu wstążki systemu Windows 7 (mały prostokątny przycisk aplikacji)
`CMFCRibbonBar::ShowCategory`	Pokazuje lub ukrywa określoną kategorię wstążki.
`CMFCRibbonBar::ShowContextCategories`	Pokazuje lub ukrywa kategorie kontekstu, które mają określony identyfikator.
`CMFCRibbonBar::ShowKeyTips`
`CMFCRibbonBar::ToggleMimimizeState`	Przełącza pasek wstążki między zminimalizowanych i zmaksymalizowanych stanów.
`CMFCRibbonBar::TranslateChar`

Uwagi

Firma Microsoft wprowadziła wstążkę Office Fluent, gdy jednocześnie wydała pakiet Microsoft Office 2007. Ten pasek wstążki nie jest tylko nową kontrolką. Reprezentuje on nowy paradygmat interfejsu użytkownika. Wstążka to okienko zawierające zestaw kart nazywanych kategoriami. Każda kategoria jest logicznie podzielona na panele wstążki, a każdy panel może zawierać różne kontrolki i przyciski poleceń.

Elementy, które są wyświetlane na pasku wstążki, rozwiń i kontrakt, aby jak najlepiej wykorzystać dostępne miejsce. Jeśli na przykład panel wstążki ma za mało miejsca do wyświetlenia jego elementów, staje się przyciskiem menu, który wyświetla podstępu w menu podręcznym. Pasek wstążki zachowuje się jako statyczny (zmiennoprzecinkowy) pasek sterowania i może być zadokowany w górnej części ramki.

Za pomocą CMFCRibbonStatusBar klasy można zaimplementować pasek stanu podobny do tego, który jest używany w pakiecie Office 2007. Kategoria wstążki zawiera (i wyświetla) grupę paneli wstążki. Każdy panel wstążki zawiera co najmniej jeden element wstążki, który pochodzi z CMFCRibbonBaseElementelementu .

Aby uzyskać informacje na temat dodawania paska wstążki do istniejącej aplikacji MFC, zobacz Przewodnik: aktualizowanie aplikacji scribble MFC.

Hierarchia dziedziczenia

Wymagania

Nagłówka:afxribbonbar.h

`CMFCRibbonBar::ActivateContextCategory`

Aktywuje kategorię kontekstu, która jest już widoczna.

BOOL ActivateContextCategory(UINT uiContextID);

Parametry

uiContextID
[in] Identyfikator kategorii kontekstu.

Wartość zwracana

TRUE jeśli kategoria kontekstu z elementem uiContextID zostanie znaleziona i aktywowana; w przeciwnym razie FALSE.

`CMFCRibbonBar::AddCategory`

Tworzy i inicjuje nową kategorię wstążki dla paska wstążki.

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

Parametry

lpszName
[in] Nazwa kategorii wstążki.

uiSmallImagesResID
[in] Identyfikator zasobu małej listy obrazów dla kategorii wstążki.

uiLargeImagesResID
[in] Identyfikator zasobu dużej listy obrazów dla kategorii wstążki.

sizeSmallImage
[in] Określa rozmiar małych obrazów dla kategorii wstążki.

sizeLargeImage
[in] Określa rozmiar dużych obrazów dla kategorii wstążki.

nInsertAt
[in] Indeks na podstawie zera lokalizacji kategorii.

pRTI
[in] Wskaźnik do CMFCRibbonCategory klasy czasu wykonywania, aby dynamicznie tworzyć kategorię wstążki w czasie wykonywania.

Wartość zwracana

Wskaźnik do nowej kategorii wstążki, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie, NULL.

Uwagi

pRTI Jeśli parametr nie NULLjest , nowa kategoria wstążki jest tworzona dynamicznie przy użyciu klasy czasu wykonywania.

Przykład

W poniższym przykładzie pokazano, jak używać AddCategory metody w CMFCRibbonBar klasie .

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

`CMFCRibbonBar::AddContextCategory`

Tworzy i inicjuje nową kategorię kontekstu dla paska wstążki.

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);

Parametry

lpszName
[in] Nazwa kategorii.

lpszContextName
[in] Nazwa kategorii kontekstu podpis.

uiContextID
[in] Identyfikator kontekstu.

clrContext
[in] Kolor kategorii kontekstu podpis.

uiSmallImagesResID
[in] Identyfikator zasobu małego obrazu kategorii kontekstu.

uiLargeImagesResID
[in] Identyfikator zasobu dużego obrazu kategorii kontekstu.

sizeSmallImage
[in] Rozmiar małego obrazu.

sizeLargeImage
[in] Rozmiar dużego obrazu.

pRTI
[in] Wskaźnik do klasy środowiska uruchomieniowego.

Wartość zwracana

Wskaźnik do nowo utworzonej kategorii lub NULL jeśli CreateObject metoda pRTI nie może utworzyć określonej kategorii.

Uwagi

Użyj tej funkcji, aby dodać kategorię kontekstu. Kategorie kontekstowe to specjalny typ kategorii, który można wyświetlić lub ukryć w czasie wykonywania, w zależności od bieżącego kontekstu aplikacji. Na przykład gdy użytkownik wybierze obiekt, można wyświetlić specjalne karty z kategoriami kontekstowymi, których można użyć do zmiany określonego wybranego obiektu.

Kolor kategorii kontekstu może być jedną z następujących wartości:

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`

Tworzy nową kategorię głównej wstążki dla paska wstążki.

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

Parametry

lpszName
[in] Nazwa głównej kategorii wstążki.

uiSmallImagesResID
[in] Identyfikator zasobu małych obrazów.

uiLargeImagesResID
[in] Identyfikator zasobu dużych obrazów.

sizeSmallImage
[in] Rozmiar małych obrazów.

sizeLargeImage
[in] Rozmiar dużych obrazów.

Wartość zwracana

Wskaźnik do nowej kategorii głównej wstążki, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie, NULL.

Uwagi

Jeśli kategoria głównej wstążki już istnieje, zostanie usunięta.

Przykład

W poniższym przykładzie pokazano, jak używać AddMainCategory metody w CMFCRibbonBar klasie .

// 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`

Tworzy kategorię podglądu wydruku na pasku wstążki.

CMFCRibbonCategory* AddPrintPreviewCategory();

Wartość zwracana

Wskaźnik do nowej kategorii wstążki, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie, NULL.

Uwagi

Ta metoda tworzy kategorię wstążki i wymagane kontrolki w celu udostępnienia podglądu wydruku.

`CMFCRibbonBar::AddQATOnlyCategory`

Tworzy kategorię wstążki paska narzędzi szybkiego dostępu.

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

Parametry

lpszName
[in] Nazwa kategorii.

uiSmallImagesResID
[in] Identyfikator zasobu listy obrazów dla kategorii.

sizeSmallImage
[in] Rozmiar obrazów dla elementów wstążki w kategorii.

Wartość zwracana

Wskaźnik do nowej kategorii, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie, NULL.

Uwagi

Kategoria wstążki paska narzędzi szybkiego dostępu jest używana tylko w oknie dialogowym dostosowywania paska narzędzi szybkiego dostępu.

`CMFCRibbonBar::AddToTabs`

Dodaje określony element wstążki do wiersza tabulatorów paska wstążki.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parametry

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

Uwagi

Element wstążki jest umieszczony przed dowolnymi przyciskami systemowymi.

`CMFCRibbonBar::CMFCRibbonBar`

Tworzy i inicjuje CMFCRibbonBar obiekt.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parametry

bReplaceFrameCaption
[in] TRUE aby pasek wstążki zamienił podpis głównego okna ramowego; FALSE aby zlokalizować pasek wstążki pod podpis okna głównego ramki.

Uwagi

`CMFCRibbonBar::Create`

Tworzy okno paska wstążki.

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

Parametry

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

dwStyle
[in] Logiczna kombinacja stylów dla nowego okna.

nID
[in] Identyfikator nowego okna.

Wartość zwracana

TRUE jeśli okno zostało utworzone; w przeciwnym razie FALSE.

Uwagi

Przykład

W poniższym przykładzie pokazano, jak używać Create metody CMFCRibbonBar klasy .

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

`CMFCRibbonBar::CreateEx`

Tworzy okno paska wstążki.

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

Parametry

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

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

dwStyle
[in] Logiczna kombinacja stylów dla nowego okna.

nID
[in] Identyfikator nowego okna.

Wartość zwracana

TRUE jeśli okno zostało utworzone; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::DeactivateKeyboardFocus`

Zamyka wszystkie kontrolki etykietki klawiszy na pasku wstążki.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parametry

bSetFocus
[in] TRUE aby ustawić fokus na okno nadrzędne paska wstążki.

Uwagi

`CMFCRibbonBar::DrawMenuImage`

Rysuje obraz dla przycisku menu.

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

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia dla przycisku menu.

pMenuItem
[in] Wskaźnik do przycisku menu paska narzędzi.

rectImage
[in] Prostokąt wyświetlania przycisku menu.

Wartość zwracana

TRUE jeśli obraz został narysowany; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::DWMCompositionChanged`

Dostosowuje wyświetlanie paska wstążki, gdy kompozycja menedżera okien pulpitu (DWM) jest włączona lub wyłączona.

virtual void DWMCompositionChanged();

Uwagi

`CMFCRibbonBar::EnableKeyTips`

Włącza lub wyłącza funkcję etykietki klucza dla paska wstążki.

void EnableKeyTips(BOOL bEnable = TRUE);

Parametry

bEnable
[in] TRUE aby włączyć funkcję etykietek kluczy; FALSE aby wyłączyć funkcję etykietek kluczy.

Uwagi

Po włączeniu tej funkcji wyświetlane są porady dotyczące klawiszy, gdy użytkownik naciska klawisze ALT lub F10 . Gdy użytkownik naciśnie klawisz ALT , wskazówki dotyczące klawisza są wyświetlane z opóźnieniem 200 milisekund. To opóźnienie umożliwia wykonywanie skrótów, dzięki czemu naciśnięcie klawisza ALT nie zakłóca innych kombinacji, które zawierają klawisz ALT .

`CMFCRibbonBar::EnablePrintPreview`

Włącza lub wyłącza funkcję Podgląd wydruku.

void EnablePrintPreview(BOOL bEnable = TRUE);

Parametry

bEnable
[in] TRUE aby włączyć funkcję Podgląd wydruku; FALSE aby wyłączyć funkcję Podgląd wydruku.

Uwagi

Jeśli bEnable istnieje FALSE kategoria podglądu wydruku, zostanie ona usunięta.

Domyślnie funkcja podglądu wydruku jest włączona.

`CMFCRibbonBar::EnableToolTips`

Włącza lub wyłącza etykietki narzędzi i opcjonalne opisy etykietek narzędzi na pasku wstążki.

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

Parametry

bEnable
[in] TRUE aby włączyć etykietki narzędzi na pasku wstążki; FALSE aby wyłączyć etykietki narzędzi na pasku wstążki.

bEnableDescr
[in] TRUE aby włączyć opisy etykietek narzędzi w etykietce narzędzia; FALSE aby wyłączyć opisy etykietek narzędzi w etykietce narzędzia.

Uwagi

Parametr bEnable określa, czy etykietki narzędzi są wyświetlane, gdy wskaźnik myszy najecha kursorem na element wstążki. Parametr bEnableDescr określa, czy dodatkowy tekst opisowy pojawia się z tekstem etykietki narzędzia.

`CMFCRibbonBar::FindByData`

Pobiera wskaźnik do elementu wstążki, jeśli ma określone dane i widoczność.

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

Parametry

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

bVisibleOnly
[in] TRUE do wyszukiwania widocznych elementów wstążki tylko; FALSE aby wyszukać wszystkie elementy wstążki.

Wartość zwracana

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

Uwagi

Element wstążki to dowolna kontrolka, którą można dodać do wstążki, na przykład przycisk wstążki lub kategorię wstążki lub suwak wstążki.

`CMFCRibbonBar::FindByID`

Pobiera wskaźnik do elementu wstążki, który ma określony identyfikator polecenia i wartości wyszukiwania.

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

Parametry

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

bVisibleOnly
[in] TRUE do wyszukiwania widocznych elementów wstążki tylko; FALSE aby wyszukać wszystkie elementy wstążki.

bExcludeQAT
[in] TRUE aby wykluczyć elementy paska narzędzi szybkiego dostępu z wyszukiwania; w przeciwnym razie, FALSE.

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli ma określony identyfikator polecenia i wartości wyszukiwania; w przeciwnym razie, NULL.

Uwagi

Element wstążki to dowolna kontrolka wstążki, którą można dodać do wstążki, na przykład przycisk wstążki lub kategorię wstążki lub suwak wstążki.

Ogólnie rzecz biorąc, może istnieć więcej niż jeden element wstążki, który ma ten sam identyfikator polecenia. Jeśli chcesz uzyskać wskaźniki do wszystkich elementów wstążki, które używają określonego identyfikatora CMFCRibbonBar::GetElementsByID polecenia, użyj metody .

`CMFCRibbonBar::FindCategoryIndexByData`

Pobiera indeks kategorii wstążki zawierający określone dane.

int FindCategoryIndexByData(DWORD dwData) const;

Parametry

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

Wartość zwracana

Indeks zerowy kategorii wstążki, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie -1.

`CMFCRibbonBar::ForceRecalcLayout`

Dostosowuje układ wszystkich elementów na pasku wstążki i w oknie nadrzędnym i ponownie rysuje całe okno.

void ForceRecalcLayout();

Uwagi

`CMFCRibbonBar::GetActiveCategory`

Pobiera wskaźnik do aktywnej kategorii wstążki.

CMFCRibbonCategory* GetActiveCategory() const;

Wartość zwracana

Wskaźnik do aktywnej kategorii wstążki; lub NULL jeśli żadna kategoria nie jest aktywna.

Uwagi

Kategoria jest aktywna, jeśli ma fokus. Domyślnie aktywna kategoria jest pierwszą kategorią po lewej stronie paska wstążki.

Kategoria główna jest wyświetlana, gdy użytkownik naciska przycisk aplikacji i nie może być aktywną kategorią.

`CMFCRibbonBar::GetApplicationButton`

Pobiera wskaźnik do przycisku aplikacji.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Wartość zwracana

Wskaźnik do przycisku aplikacji; lub NULL jeśli przycisk nie został ustawiony.

`CMFCRibbonBar::GetCaptionHeight`

Pobiera wysokość obszaru podpis paska wstążki.

int GetCaptionHeight() const;

Wartość zwracana

Wysokość w pikselach obszaru podpis paska wstążki.

Uwagi

`CMFCRibbonBar::GetCategory`

Pobiera wskaźnik do kategorii wstążki w określonym indeksie.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parametry

nIndex
[in] Indeks na podstawie zera kategorii wstążki na liście kategorii wstążki, które znajdują się na pasku wstążki.

Wartość zwracana

Wskaźnik do kategorii wstążki w określonym indeksie; w przeciwnym razie, NULL jeśli nIndex był poza zakresem.

`CMFCRibbonBar::GetCategoryCount`

Pobiera liczbę kategorii wstążki na pasku wstążki.

int GetCategoryCount() const;

Wartość zwracana

Liczba kategorii wstążki na pasku wstążki.

`CMFCRibbonBar::GetCategoryHeight`

Pobiera wysokość kategorii.

int GetCategoryHeight() const;

Wartość zwracana

Wysokość kategorii.

Uwagi

Wysokość kategorii zawiera wysokość karty kategorii.

`CMFCRibbonBar::GetCategoryIndex`

Pobiera indeks określonej kategorii wstążki.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parametry

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

Wartość zwracana

Indeks na podstawie zera kategorii wstążki określony przez pCategory; lub -1, jeśli kategoria wstążki nie zostanie znaleziona.

`CMFCRibbonBar::GetContextName`

Pobiera nazwę kategorii kontekstu podpis określone przez identyfikator kontekstu.

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

Parametry

uiContextID
[in] Identyfikator kontekstu kategorii wstążki.

strName
[out] Nazwa kategorii kontekstu podpis.

Wartość zwracana

TRUEjeśli metoda zakończyła się pomyślnie; w przeciwnym razie, FALSE jeśli uiContextID nie znaleziono wartości zero lub nie znaleziono kategorii kontekstu podpis.

`CMFCRibbonBar::GetDroppedDown`

Pobiera element wstążki, który jest obecnie usuwany.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Wartość zwracana

Element wstążki, który jest obecnie porzucany; lub NULL jeśli element wstążki nie jest obecnie porzucany.

Uwagi

`CMFCRibbonBar::GetElementsByID`

Pobiera tablicę wskaźników do wszystkich elementów wstążki, które mają określony identyfikator polecenia.

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

Parametry

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

arButtons
[out] Tablica wskaźników do elementów wstążki.

Uwagi

Wiele elementów wstążki może mieć ten sam identyfikator polecenia, ponieważ niektóre elementy wstążki można skopiować na pasek narzędzi szybkiego dostępu.

`CMFCRibbonBar::GetHideFlags`

Pobiera flagi wskazujące, ile paska wstążki jest widoczne.

DWORD GetHideFlags() const;

Wartość zwracana

Flagi wskazujące, ile paska wstążki jest widoczne.

Uwagi

W poniższej tabeli wymieniono możliwą kombinację flag dla wartości zwracanej:

Flaga	opis
`AFX_RIBBONBAR_HIDE_ELEMENTS`	Pasek wstążki jest zminimalizowany w pionie, a widoczne są tylko karty kategorii, przycisk główny i pasek narzędzi szybkiego dostępu.
`AFX_RIBBONBAR_HIDE_ALL`	Szerokość paska wstążki jest mniejsza niż minimalna szerokość i jest całkowicie ukryta.

`CMFCRibbonBar::GetItemIDsList`

Pobiera identyfikatory poleceń dla określonej kolekcji elementów wstążki na pasku wstążki.

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

Parametry

lstItems
[out] Lista identyfikatorów poleceń dla elementów wstążki zawartych na pasku wstążki.

bHiddenOnly
[in] TRUE aby wykluczyć wyświetlane elementy wstążki; FALSE aby uwzględnić wszystkie elementy wstążki na pasku wstążki.

Uwagi

`CMFCRibbonBar::GetKeyboardNavigationLevel`

Pobiera bieżący poziom nawigacji, gdy użytkownik naciska etykietki klawiszy znajdujące się na pasku wstążki.

int GetKeyboardNavigationLevel() const;

Wartość zwracana

Bieżący poziom nawigacji, gdy użytkownik naciska etykietki klawiszy znajdujące się na pasku wstążki. W poniższej tabeli wymieniono możliwe wartości zwracane:

Wartość	Opis
-1	Etykietki kluczy nie są wyświetlane.
0	Wyświetlane są etykietki kluczy.
1	Użytkownik nacisnął wyświetloną etykietkę klawiszy.

Uwagi

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

Pobiera bieżący obiekt nawigacji za pomocą klawiatury na pasku wstążki.

CObject* GetKeyboardNavLevelCurrent() const;

Wartość zwracana

Bieżący obiekt nawigacji za pomocą klawiatury na pasku wstążki; w przeciwnym razie NULL , jeśli żaden obiekt aktualnie nie wyświetla etykietek kluczy.

Uwagi

Obiekt, który aktualnie wyświetla etykietki klawiszy, jest bieżącym obiektem nawigacji za pomocą klawiatury.

`CMFCRibbonBar::GetKeyboardNavLevelParent`

Pobiera obiekt nawigacji za pomocą klawiatury nadrzędnej na pasku wstążki.

CObject* GetKeyboardNavLevelParent() const;

Wartość zwracana

Obiekt nawigacji za pomocą klawiatury nadrzędnej na pasku wstążki; w przeciwnym razie NULL.

Uwagi

Gdy użytkownik naciśnie etykietkę klawiszy na pasku wstążki, bieżący obiekt nawigacji za pomocą klawiatury staje się obiektem nawigacji za pomocą klawiatury nadrzędnej.

`CMFCRibbonBar::GetMainCategory`

Pobiera wskaźnik do głównej kategorii wstążki.

CMFCRibbonCategory* GetMainCategory() const;

Wartość zwracana

Wskaźnik do głównej kategorii wstążki.

Uwagi

Kategoria głównej wstążki zawiera główny panel wstążki.

`CMFCRibbonBar::GetQATCommandsLocation`

Pobiera prostokąt wyświetlania dla sekcji poleceń paska narzędzi szybkiego dostępu.

CRect GetQATCommandsLocation() const;

Wartość zwracana

Prostokąt wyświetlania sekcji poleceń paska narzędzi szybkiego dostępu.

Uwagi

Sekcja poleceń prostokąta wyświetlania nie zawiera przycisku dostosowywania.

`CMFCRibbonBar::GetQATDroppedDown`

Pobiera wskaźnik do elementu wstążki na pasku narzędzi szybkiego dostępu, który zawiera menu podręczne usunięte.

CMFCRibbonBaseElement* GetQATDroppedDown();

Wartość zwracana

Wskaźnik do elementu wstążki na pasku narzędzi szybkiego dostępu, który ma menu podręczne usunięte.

Uwagi

`CMFCRibbonBar::GetQuickAccessCommands`

Pobiera listę identyfikatorów poleceń dla elementów wstążki na pasku narzędzi szybkiego dostępu.

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

Parametry

lstCommands
[out] Lista identyfikatorów poleceń dla elementów wstążki na pasku narzędzi szybkiego dostępu.

Uwagi

Lista nie zawiera elementów wstążki, które są separatorami kontrolek.

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

Pobiera prostokąt wyświetlania dla paska narzędzi szybkiego dostępu.

CRect GetQuickAccessToolbarLocation() const;

Wartość zwracana

Prostokąt wyświetlania paska narzędzi szybkiego dostępu.

Uwagi

`CMFCRibbonBar::GetTabTrancateRatio`

Pobiera procent redukcji rozmiaru w szerokości wyświetlania kart kategorii.

int GetTabTrancateRatio() const;

Wartość zwracana

Procentowa redukcja rozmiaru wyświetlania kart kategorii.

Uwagi

Karty kategorii są zmniejszane szerokości, gdy na pasku wstążki nie ma wystarczającej szerokości.

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

Pobiera duży rozmiar szerokości etykietki narzędzia dla paska wstążki.

int GetTooltipFixedWidthLargeImage() const;

Wartość zwracana

Duży rozmiar szerokości etykietki narzędzia w pikselach.

Uwagi

Jeśli duża szerokość etykietki narzędzia wynosi 0, szerokość będzie się różnić.

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

Pobiera zwykły rozmiar szerokości etykietki narzędzia dla paska wstążki.

int GetTooltipFixedWidthRegular() const;

Wartość zwracana

Zwykły rozmiar szerokości etykietki narzędzia w pikselach.

Uwagi

Jeśli zwykły rozmiar etykietki narzędzia wynosi 0, szerokość będzie się różnić.

`CMFCRibbonBar::GetVisibleCategoryCount`

Pobiera liczbę widocznych kategorii na pasku wstążki.

int GetVisibleCategoryCount() const;

Wartość zwracana

Liczba widocznych kategorii na pasku wstążki.

Uwagi

`CMFCRibbonBar::HideAllContextCategories`

Ukrywa wszystkie kategorie kontekstowe na pasku wstążki.

BOOL HideAllContextCategories();

Wartość zwracana

TRUE jeśli co najmniej jedna kategoria kontekstowa była ukryta; w przeciwnym razie, FALSE.

Uwagi

Jeśli kategoria kontekstu jest aktywna, aktywna kategoria zostanie zresetowana do pierwszej widocznej kategorii na liście kategorii.

`CMFCRibbonBar::HideKeyTips`

Ukrywa wszystkie etykietki klawiszy na pasku wstążki.

void HideKeyTips();

Uwagi

`CMFCRibbonBar::HitTest`

Pobiera wskaźnik do elementu wstążki określonego przez lokalizację punktu.

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

Parametry

point
[in] Lokalizacja punktu we współrzędnych paska wstążki.

bCheckActiveCategory
[in] TRUE aby wyszukać aktywną kategorię; FALSE nie należy przeszukiwać aktywnej kategorii.

bCheckPanelCaption
[in] TRUE aby przetestować podpis panelu wstążki z punktem znajdującym się w nim, FALSE a nie przetestować podpis panelu wstążki z punktem znajdującym się w nim. Aby uzyskać więcej informacji, zobacz sekcję Uwagi.

Wartość zwracana

Wskaźnik do elementu wstążki znajdujący się w określonym punkcie; w przeciwnym razie NULL , jeśli punkt nie znajduje się w elemecie wstążki.

Uwagi

Podpis panelu wstążki z punktem znajdującym się w nim nie jest testowany, chyba że bCheckActiveCategory parametr ma wartość TRUE.

`CMFCRibbonBar::IsKeyTipEnabled`

Wskazuje, czy funkcja etykietek kluczy jest włączona.

BOOL IsKeyTipEnabled() const;

Wartość zwracana

TRUE jeśli funkcja etykietek kluczy jest włączona; w przeciwnym razie FALSE.

`CMFCRibbonBar::IsMainRibbonBar`

Wskazuje, czy pasek wstążki jest podstawowym paskiem wstążki.

virtual BOOL IsMainRibbonBar() const;

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość TRUE. Zastąpij tę metodę, aby wskazać, czy pasek wstążki jest podstawowym paskiem wstążki.

`CMFCRibbonBar::IsPrintPreviewEnabled`

Wskazuje, czy funkcja podglądu wydruku jest włączona.

BOOL IsPrintPreviewEnabled() const;

Wartość zwracana

TRUEjeśli funkcja podglądu wydruku jest włączona; w przeciwnym razie FALSE.

`CMFCRibbonBar::IsQATEmpty`

Wskazuje, czy pasek narzędzi szybkiego dostępu zawiera przyciski poleceń.

BOOL IsQATEmpty() const;

Wartość zwracana

TRUE jeśli pasek narzędzi szybkiego dostępu zawiera przyciski poleceń; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::IsQuickAccessToolbarOnTop`

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

BOOL IsQuickAccessToolbarOnTop() const;

Wartość zwracana

TRUE jeśli pasek narzędzi szybkiego dostępu znajduje się na pasku wstążki; FALSE jeśli pasek narzędzi szybkiego dostępu znajduje się pod paskiem wstążki.

`CMFCRibbonBar::IsReplaceFrameCaption`

Wskazuje, czy pasek wstążki zastępuje lub znajduje się pod podpis głównego okna ramki.

BOOL IsReplaceFrameCaption() const;

Wartość zwracana

TRUEjeśli pasek wstążki zastępuje podpis głównego okna ramowego; FALSE jeśli pasek wstążki znajduje się pod podpis okna głównego ramki.

`CMFCRibbonBar::IsShowGroupBorder`

Wskazuje, czy grupy przycisków znajdujące się na pasku wstążki wyświetlają obramowanie grupy.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parametry

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

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąpij tę metodę, aby wskazać, czy grupy przycisków znajdujące się na pasku wstążki wyświetlają obramowanie grupy.

`CMFCRibbonBar::IsToolTipDescrEnabled`

Wskazuje, czy opisy etykietek narzędzi są włączone.

BOOL IsToolTipDescrEnabled() const;

Wartość zwracana

TRUE jeśli opisy etykietek narzędzi są włączone; FALSE jeśli opisy etykietek narzędzi są wyłączone.

Uwagi

Opisy etykietek narzędzi to dodatkowy tekst opisowy wyświetlany z tekstem etykietki narzędzia.

`CMFCRibbonBar::IsToolTipEnabled`

Wskazuje, czy etykietki narzędzi są włączone, czy wyłączone dla paska wstążki.

BOOL IsToolTipEnabled() const;

Wartość zwracana

TRUE jeśli etykietki narzędzi są włączone; FALSE jeśli etykietki narzędzi są wyłączone.

`CMFCRibbonBar::IsTransparentCaption`

Wskazuje, czy wyświetlacz jest ustawiony dla schematu kolorów Windows Aero.

BOOL IsTransparentCaption() const;

Wartość zwracana

TRUE jeśli schemat kolorów to Windows Aero; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::OnClickButton`

Ta metoda jest zachowywana w celu zapewnienia zgodności z poprzednimi wersjami istniejących aplikacji i nie powinna być używana do tworzenia nowych aplikacji.

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

Parametry

pButton
[in] Wskaźnik do klikniętego przycisku.

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

Uwagi

`CMFCRibbonBar::OnEditContextMenu`

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

Parametry

[in] pEdit
[in] point\

Uwagi

`CMFCRibbonBar::OnRTLChanged`

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

virtual void OnRTLChanged(BOOL bIsRTL);

Parametry

bIsRTL
[in] TRUE jeśli układ jest od prawej do lewej; FALSE jeśli układ jest od lewej do prawej.

Uwagi

Ta metoda dostosowuje układ wszystkich kontrolek na pasku wstążki dla nowego kierunku układu.

`CMFCRibbonBar::OnSetAccData`

Ta metoda jest wewnętrzna dla struktury i nie ma być wywoływana z kodu użytkownika.

BOOL OnSetAccData(long lVal);

Parametry

long lVal Indeks dostępnego obiektu.

Wartość zwracana

S_OK w przypadku powodzenia; w przeciwnym razie FALSE lub S_FALSE.

Uwagi

`CMFCRibbonBar::OnShowRibbonContextMenu`

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

Parametry

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

Wartość zwracana

Uwagi

`CMFCRibbonBar::OnShowRibbonQATMenu`

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

Parametry

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

Wartość zwracana

Uwagi

`CMFCRibbonBar::OnSysKeyDown`

Wywoływana przez platformę, gdy użytkownik naciska klawisz F10 lub przytrzymuje klawisz ALT, a następnie naciska inny klawisz.

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

Parametry

pFrameWnd
[in] Wskaźnik do nadrzędnego głównego okna ramowego paska wstążki.

wParam
[in] Wirtualny kod klawisza naciśnięcia klawisza.

lParam
[in] Flagi stanu klawiatury po naciśnięciu klawisza.

Wartość zwracana

TRUE jeśli zdarzenie naciśnięcia klawiszy zostało przetworzone; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::OnSysKeyUp`

Wywoływana przez platformę, gdy użytkownik zwalnia klawisz F10 , klawisz ALT lub klawisz, który został naciśnięty, gdy klawisz ALT został przytrzymany.

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

Parametry

pFrameWnd
[in] Wskaźnik do nadrzędnego głównego okna ramowego paska wstążki.

wParam
[in] Wirtualny kod klucza zwalnianego klucza.

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

Wartość zwracana

TRUE jeśli zdarzenie naciśnięcia klawiszy zostało przetworzone; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::PopTooltip`

Usuwa etykietkę narzędzia z widoku.

void PopTooltip();

Uwagi

`CMFCRibbonBar::PreTranslateMessage`

Określa, czy określony komunikat jest przetwarzany przez pasek wstążki.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

pMsg
[in] Wskaźnik do komunikatu.

Wartość zwracana

TRUE jeśli komunikat został przetworzony przez pasek wstążki; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::RecalcLayout`

Dostosowuje układ wszystkich kontrolek na pasku wstążki.

virtual void RecalcLayout();

Uwagi

Po dostosowaniu układu zostanie zaktualizowany ekran paska wstążki.

`CMFCRibbonBar::RemoveAllCategories`

Usuwa wszystkie kategorie wstążki na pasku wstążki.

void RemoveAllCategories();

Uwagi

Ta metoda usuwa wszystkie kategorie wstążki z pamięci i z listy kategorii.

`CMFCRibbonBar::RemoveAllFromTabs`

Usuwa wszystkie elementy wstążki z obszaru karty.

void RemoveAllFromTabs();

Uwagi

Użyj tej funkcji, jeśli chcesz usunąć wszystkie elementy dodane do obszaru tabulacji przy użyciu CMFCRibbonBar::AddToTabs metody .

`CMFCRibbonBar::RemoveCategory`

Usuwa określoną kategorię wstążki z paska wstążki.

BOOL RemoveCategory(int nIndex);

Parametry

nIndex
[in] Indeks oparty na zera kategorii na liście kategorii wstążki, który znajduje się na pasku wstążki.

Wartość zwracana

TRUE jeśli określona kategoria wstążki została usunięta; w przeciwnym razie FALSE.

Uwagi

Określona kategoria wstążki jest usuwana z pamięci i z listy kategorii.

`CMFCRibbonBar::SetActiveCategory`

Ustawia określoną kategorię wstążki jako aktywną kategorię.

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

Parametry

pCategory
[in] Kategoria wstążki zawarta na pasku wstążki.

bForceRestore
[in] TRUE aby zmaksymalizować pasek wstążki, jeśli jest zminimalizowany; FALSE aby wyświetlić aktywną kategorię w oknie podręcznym, jeśli pasek wstążki zostanie zminimalizowany.

Wartość zwracana

TRUE jeśli określona kategoria została ustawiona jako aktywna kategoria; w przeciwnym razie FALSE.

Uwagi

Kategoria głównej wstążki nie może być aktywną kategorią.

Jeśli kategoria określona przez pCategory nie jest wyświetlana, nie można jej ustawić jako aktywnej kategorii.

`CMFCRibbonBar::SetActiveMDIChild`

Kojarzy przyciski systemowe na pasku wstążki, które należą do okna podrzędnego interfejsu wielu dokumentów (MDI) do określonego okna podrzędnego MDI.

void SetActiveMDIChild(CWnd* pWnd);

Parametry

pWnd
[in] Wskaźnik do okna podrzędnego MDI.

Uwagi

`CMFCRibbonBar::SetApplicationButton`

Przypisuje przycisk wstążki aplikacji do paska wstążki.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parametry

pButton
[in] Wskaźnik do przycisku wstążki aplikacji.

sizeButton
[in] Rozmiar przycisku wstążki aplikacji.

Uwagi

Przycisk wstążki aplikacji to duży zaokrąglony przycisk znajdujący się w lewym górnym rogu kontrolki Wstążka.

Przykład

W poniższym przykładzie pokazano, jak używać SetApplicationButton metody w CMFCRibbonBar klasie .

// 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`

Ustawia etykietki klawiszy dla wszystkich elementów wstążki, które mają określony identyfikator polecenia.

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

Parametry

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

lpszKeys
[in] Etykietka klucza.

lpszMenuKeys
[in] Etykietka klawisza menu.

Wartość zwracana

TRUE jeśli ustawiono etykietki klawiszy co najmniej jednego elementu wstążki; w przeciwnym razie FALSE.

Uwagi

Opcjonalna etykietka klawisza menu dotyczy elementów wstążki z przyciskiem podziału, który otwiera menu podręczne.

`CMFCRibbonBar::SetKeyboardNavigationLevel`

Ustawia poziom nawigacji za pomocą klawiatury, gdy użytkownik naciska etykietki klawiszy znajdujące się na pasku wstążki.

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

Parametry

pLevel
[in] Wskaźnik do bieżącego obiektu nawigacji za pomocą klawiatury.

bSetFocus
[in] TRUE aby ustawić fokus klawiatury na pasku wstążki.

Uwagi

Nawigacja za pomocą klawiatury na pasku wstążki jest uruchamiana po naciśnięciu klawisza ALT lub F10 . Użytkownik wybiera następny poziom nawigacji, naciskając etykietkę klawisza na pasku wstążki. Użytkownik może wrócić do poprzedniego poziomu nawigacji, naciskając klawisz ucieczki.

`CMFCRibbonBar::SetMaximizeMode`

Dostosowuje pasek wstążki, gdy rozmiar okna okna podrzędnego interfejsu wielodokumentowego (MDI) wchodzi lub pozostawia zmaksymalizowany stan.

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

Parametry

bMax
[in] TRUE aby wyświetlić przyciski systemowe dla okna podrzędnego MDI na pasku wstążki; FALSE aby usunąć przyciski systemowe dla okna podrzędnego MDI z paska wstążki.

pWnd
[in] Wskaźnik do głównego okna ramki paska wstążki.

Uwagi

Pasek wstążki wyświetla przyciski systemowe dla okna podrzędnego MDI w wierszu karty, gdy okno podrzędne MDI jest zmaksymalizowane.

`CMFCRibbonBar::SetQuickAccessCommands`

Dodaje co najmniej jeden element wstążki do paska narzędzi Szybki dostęp.

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

Parametry

lstCommands
[in] Lista poleceń, które mają zostać umieszczone na pasku narzędzi Szybki dostęp.

bRecalcLayout
[in] TRUE jeśli chcesz ponownie narysować wstążkę po dodaniu elementów wstążki; FALSE Inaczej.

Przykład

W poniższym przykładzie pokazano, jak używać SetQuickAccessCommands metody w CMFCRibbonBar klasie .

// 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`

Ustawia pasek narzędzi szybkiego dostępu do stanu domyślnego.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parametry

state
[in] Domyślny stan paska narzędzi szybkiego dostępu.

Uwagi

Stan paska narzędzi szybki dostęp zawiera listę poleceń i ich widoczność.

Przykład

W poniższym przykładzie pokazano, jak używać SetQuickAccessDefaultState metody w CMFCRibbonBar klasie .

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`

Umieszcza pasek narzędzi szybkiego dostępu powyżej lub poniżej paska wstążki.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parametry

bOnTop
[in] TRUE aby ustawić pasek narzędzi szybkiego dostępu nad paskiem wstążki; FALSE aby ustawić pasek narzędzi szybkiego dostępu poniżej paska wstążki.

`CMFCRibbonBar::SetTooltipFixedWidth`

Ustawia regularne i duże rozmiary etykietek narzędzi o stałej szerokości paska wstążki.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parametry

nWidthRegular
[in] Szerokość w pikselach standardowej etykietki narzędzia o stałym rozmiarze.

nWidthLargeImage
[in] Szerokość w pikselach dużej stałej etykietki narzędzia o stałym rozmiarze.

Uwagi

Ustawienie parametru na 0 powoduje, że odpowiednia szerokość będzie się różnić.

`CMFCRibbonBar::ShowCategory`

Pokazuje lub ukrywa określoną kategorię wstążki.

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

Parametry

nIndex
[in] Indeks kategorii wstążki.

bShow
[in] Jeśli TRUEwartość , pokaż kategorię wstążki; w przeciwnym razie ukryj kategorię wstążki.

`CMFCRibbonBar::ShowContextCategories`

Pokazuje lub ukrywa kategorie kontekstu, które mają określony identyfikator.

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

Parametry

uiContextID
[in] Identyfikator kategorii kontekstu.

bShow
[in] Jeśli TRUEwartość , pokaż kategorie, które mają określony identyfikator; w przeciwnym razie ukryj kategorie, które mają określony identyfikator.

`CMFCRibbonBar::ShowKeyTips`

Pokazuje etykietki klawiszy dla każdego elementu wstążki na pasku wstążki.

void ShowKeyTips();

Uwagi

`CMFCRibbonBar::ToggleMimimizeState`

Przełącza pasek wstążki między zminimalizowanych i zmaksymalizowanych stanów.

void ToggleMimimizeState();

Uwagi

Błędna pisownia w nazwie metody jest znanym problemem.

W stanie zminimalizowania kontrolka wstążki jest ukryta i wyświetlane są tylko karty. Gdy użytkownik kliknie kartę, kontrolka wstążki zostanie wyświetlona jako okno podręczne. Okno zostanie zamknięte, gdy użytkownik kliknie lub wykona polecenie.

`CMFCRibbonBar::TranslateChar`

Określa, czy określony kod znaku naciśnięć klawiszy jest przetwarzany przez pasek wstążki.

virtual BOOL TranslateChar(UINT nChar);

Parametry

nChar
[in] Kod znaku na naciśnięciu klawiszy użytkownika.

Wartość zwracana

TRUE jeśli kod znaku został przetworzony przez pasek wstążki; w przeciwnym razie FALSE.

Uwagi

Funkcja etykietek klawiszy umożliwia użytkownikom nawigowanie po pasku wstążki za pomocą klawiatury.

`CMFCRibbonBar::GetFocused`

Zwraca element fokusu.

virtual CMFCRibbonBaseElement* GetFocused();

Wartość zwracana

Wskaźnik do elementu ukierunkowanego lub NULL.

Uwagi

`CMFCRibbonBar::IsWindows7Look`

Wskazuje, czy wstążka ma wygląd systemu Windows 7 (mały prostokątny przycisk aplikacji).

BOOL IsWindows7Look() const;

Wartość zwracana

TRUE jeśli wstążka ma wygląd systemu Windows 7; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::LoadFromResource`

Przeciążone. Ładuje pasek wstążki z zasobów aplikacji.

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

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

Parametry

uiXMLResID
Określa identyfikator zasobu ciągu XML z informacjami paska wstążki.

lpszResType
Określa typ zasobu znajdującego się w lokalizacji uiXMLResID.

hInstance
Dojmij do modułu, którego plik wykonywalny zawiera zasób. Jeśli hInstance to NULL, system ładuje zasób z modułu, który został użyty do utworzenia bieżącego procesu.

lpszXMLResID
Określa identyfikator zasobu (w postaci ciągu) z informacjami paska wstążki.

Wartość zwracana

TRUE jeśli ładowanie powiedzie się; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::SaveToXMLBuffer`

Zapisuje pasek wstążki w buforze.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parametry

ppBuffer
Po powrocie ppBuffer tej funkcji wskazuje bufor przydzielony przez tę metodę i zawiera informacje o pasku wstążki w formacie XML.

Wartość zwracana

TRUE w przypadku powodzenia; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::SaveToXMLFile`

Zapisuje pasek wstążki w pliku XML.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parametry

lpszFilePath
Określa plik wyjściowy.

Wartość zwracana

TRUE w przypadku powodzenia; w przeciwnym razie FALSE.

Uwagi

`CMFCRibbonBar::SetWindows7Look`

Włącza lub wyłącza wygląd systemu Windows 7 (mały prostokątny przycisk aplikacji) dla wstążki.

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

Parametry

bWindows7Look
TRUE ustawia wygląd systemu Windows 7; FALSE Inaczej.

bRecalc
TRUE oblicza ponownie układ wstążki; FALSE Inaczej.

Uwagi

Zobacz też

Wykres hierarchii
Klasy
CPane Klasa
CMFCRibbonCategory Klasa
CMFCRibbonPanel Klasa
CMFCRibbonBaseElement Klasa
Przewodnik: aktualizowanie aplikacji scribble MFC

Udostępnij za pośrednictwem

CMFCRibbonBar Klasa

Składnia

Członkowie

Konstruktory publiczne

Metody publiczne

Uwagi

Hierarchia dziedziczenia

Wymagania

CMFCRibbonBar::ActivateContextCategory

Parametry

Wartość zwracana

CMFCRibbonBar::AddCategory

Parametry

Wartość zwracana

Uwagi

Przykład

CMFCRibbonBar::AddContextCategory

Parametry

Wartość zwracana

Uwagi

CMFCRibbonBar::AddMainCategory

Parametry

Wartość zwracana

Uwagi

Przykład

CMFCRibbonBar::AddPrintPreviewCategory

Wartość zwracana

Uwagi

CMFCRibbonBar::AddQATOnlyCategory

Parametry

Wartość zwracana

Uwagi

CMFCRibbonBar::AddToTabs

Parametry

Uwagi

CMFCRibbonBar::CMFCRibbonBar

Parametry

Uwagi

CMFCRibbonBar::Create

Parametry

Wartość zwracana

Uwagi

Przykład

CMFCRibbonBar::CreateEx

Parametry

Wartość zwracana

Uwagi

CMFCRibbonBar::DeactivateKeyboardFocus

Parametry

Uwagi

CMFCRibbonBar::DrawMenuImage

Parametry

Wartość zwracana

Uwagi

CMFCRibbonBar::DWMCompositionChanged

Uwagi

CMFCRibbonBar::EnableKeyTips

Parametry

Uwagi

CMFCRibbonBar::EnablePrintPreview

Parametry

Uwagi

CMFCRibbonBar::EnableToolTips

Parametry

Uwagi

CMFCRibbonBar::FindByData

Parametry

Wartość zwracana

Uwagi

CMFCRibbonBar::FindByID

Parametry

Wartość zwracana

Uwagi

CMFCRibbonBar::FindCategoryIndexByData

Parametry

Wartość zwracana

CMFCRibbonBar::ForceRecalcLayout

Uwagi

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar` Klasa

`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`