Udostępnij za pośrednictwem


CMFCRibbonBar Klasa

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

Elementy członkowskie

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 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ść podpisu. (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ę podpisu kategorii kontekstu określonego 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 podpisu 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 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

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCRibbonBar

Wymagania

Nagłówek: 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 podpisu kategorii kontekstu.

uiContextID
[in] Identyfikator kontekstu.

clrContext
[in] Kolor podpisu kategorii kontekstu.

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 zastąpił podpis głównego okna ramki; FALSE aby zlokalizować pasek wstążki pod podpisem głównego okna 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 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, gdy użytkownik naciska ALT lub F10 . Gdy użytkownik naciśnie ALT , wskazówki dotyczące są wyświetlane z opóźnieniem 200 milisekund. To opóźnienie umożliwia wykonywanie skrótów, dzięki czemu naciśnięcie ALT nie zakłóca innych kombinacji, które zawierają 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ów dla paska wstążki.

int GetCaptionHeight() const;

Wartość zwracana

Wysokość w pikselach obszaru podpisu 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ę podpisu kategorii kontekstu określonego przez identyfikator kontekstu.

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

Parametry

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

strName
[out] Nazwa podpisu kategorii kontekstu.

Wartość zwracana

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

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 znajdujące się na pasku wstążki.

int GetKeyboardNavigationLevel() const;

Wartość zwracana

Bieżący poziom nawigacji, gdy użytkownik naciska etykietki 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ę.

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, 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ę 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 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 nie należy testować podpisu panelu wstążki z umieszczonym w nim punktem. 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 podpisem głównego okna ramki.

BOOL IsReplaceFrameCaption() const;

Wartość zwracana

TRUE jeśli pasek wstążki zastępuje podpis głównego okna ramki; FALSE jeśli pasek wstążki znajduje się pod podpisem głównego okna 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 F10 lub przytrzymuje ALT, a następnie naciska inny.

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 naciśnięcia.

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

Wartość zwracana

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

Uwagi

CMFCRibbonBar::OnSysKeyUp

Wywoływana przez platformę, gdy użytkownik zwalnia F10 , ALT lub, który został naciśnięty, gdy 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 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 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 menu.

Wartość zwracana

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

Uwagi

Opcjonalna etykietka 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 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 ALT lub F10 . Użytkownik wybiera następny poziom nawigacji, naciskając etykietkę na pasku wstążki. Użytkownik może wrócić do poprzedniego poziomu nawigacji, naciskając 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 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ęć jest przetwarzany przez pasek wstążki.

virtual BOOL TranslateChar(UINT nChar);

Parametry

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

Wartość zwracana

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

Uwagi

Funkcja etykietek 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