Klasa CMFCRibbonPanel

Implementuje panel zawierający zestaw elementów wstążki. Gdy panel zostanie narysowany, wyświetla jak najwięcej elementów, biorąc pod uwagę rozmiar panelu.

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Składnia

class CMFCRibbonPanel : public CObject

Elementy członkowskie

Konstruktory chronione

Nazwa/nazwisko	opis
CMFCRibbonPanel::CMFCRibbonPanel	Tworzy i inicjuje CMFCRibbonPanel obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CMFCRibbonPanel::Dodaj	Dodaje element wstążki do panelu.
CMFCRibbonPanel::AddSeparator	Dodaje separator do panelu wstążki.
CMFCRibbonPanel::AddToolBar	Dodaje pasek narzędzi do panelu wstążki.
CMFCRibbonPanel::FindByData
CMFCRibbonPanel::FindByID	Zwraca element zidentyfikowany przez określony identyfikator polecenia.
CMFCRibbonPanel::GetCaptionHeight
CMFCRibbonPanel::GetCount	Zwraca liczbę elementów na panelu wstążki.
CMFCRibbonPanel::GetData	Zwraca dane zdefiniowane przez użytkownika skojarzone z panelem.
CMFCRibbonPanel::GetDefaultButton
CMFCRibbonPanel::GetDroppedDown
CMFCRibbonPanel::GetElement	Zwraca element wstążki znajdujący się w określonym indeksie.
CMFCRibbonPanel::GetElements	Pobiera wszystkie elementy zawarte w panelu wstążki.
CMFCRibbonPanel::GetElementsByID
CMFCRibbonPanel::GetFocused	Zwraca element fokusu.
CMFCRibbonPanel::GetGalleryRect	Zwraca prostokąt ograniczenia elementu Galeria.
CMFCRibbonPanel::GetHighlighted
CMFCRibbonPanel::GetIndex
CMFCRibbonPanel::GetItemIDsList
CMFCRibbonPanel::GetName
CMFCRibbonPanel::GetParentButton
CMFCRibbonPanel::GetParentCategory	Zwraca kategorię nadrzędną panelu wstążki.
CMFCRibbonPanel::GetParentMenuBar
CMFCRibbonPanel::GetPreferedMenuLocation
CMFCRibbonPanel::GetPressed
CMFCRibbonPanel::GetRect
CMFCRibbonPanel::GetVisibleElements	Uzyskuje tablicę widocznych elementów.
CMFCRibbonPanel::HasElement
CMFCRibbonPanel::HitTest
CMFCRibbonPanel::HitTestEx
CMFCRibbonPanel::Wstaw	Wstawia element wstążki na danej pozycji.
CMFCRibbonPanel::InsertSeparator	Wstawia separator w danej pozycji.
CMFCRibbonPanel::IsCenterColumnVert	Określa, czy wszystkie elementy panelu powinny być wyśrodkowane (wyrównane) w pionie według kolumny.
CMFCRibbonPanel::IsCollapsed
CMFCRibbonPanel::IsHighlighted
CMFCRibbonPanel::IsJustifyColumns	Określa, czy wszystkie kolumny panelu mają taką samą szerokość.
CMFCRibbonPanel::IsMainPanel
CMFCRibbonPanel::IsMenuMode
CMFCRibbonPanel::MakeGalleryItemVisible	Przewija galerię, aby uwidocznić określony element wstążki.
CMFCRibbonPanel::OnKey
CMFCRibbonPanel::RecalcWidths
CMFCRibbonPanel::Remove	Usuwa i opcjonalnie usuwa element znajdujący się w określonym indeksie.
CMFCRibbonPanel::RemoveAll	Usuwa wszystkie elementy z panelu wstążki.
CMFCRibbonPanel::Replace	Zamienia jeden element na inny na podstawie ich odpowiednich wartości indeksu.
CMFCRibbonPanel::ReplaceByID	Zamienia jeden element na inny na podstawie określonego identyfikatora polecenia.
CMFCRibbonPanel::SetCenterColumnVert	Nakazuje panelowi wyrównanie elementów w pionie według kolumny.
CMFCRibbonPanel::SetData	Kojarzy dane zdefiniowane przez użytkownika z panelem wstążki.
CMFCRibbonPanel::SetElementMenu	Przypisuje menu podręczne do elementu, który ma podany identyfikator polecenia.
CMFCRibbonPanel::SetElementRTC	Dodaje element wstążki określony przez podane informacje o klasie środowiska uruchomieniowego do panelu wstążki.
CMFCRibbonPanel::SetElementRTCByID	Dodaje element wstążki określony przez podane informacje o klasie środowiska uruchomieniowego do panelu wstążki.
CMFCRibbonPanel::SetFocused	Ustawia fokus na określony element wstążki.
CMFCRibbonPanel::SetJustifyColumns	Włącza lub wyłącza uzasadnienie kolumn.
CMFCRibbonPanel::SetKeys	Ustawia skrót klawiaturowy, który wyświetla panel wstążki.
CMFCRibbonPanel::ShowPopup

Uwagi

Panele wstążki to logiczne grupowania powiązanych zadań tworzonych w ramach kategorii wstążki. W miarę zmiany rozmiaru wstążki układ panelu automatycznie dostosowuje się do wyświetlania jak największej liczby elementów.

Panele wstążki znajdujące się w kategorii wstążki można uzyskać, wywołując metodę CMFCRibbonCategory::GetPanel .

Przykład

W poniższym przykładzie pokazano, jak skonfigurować CMFCRibbonPanel obiekt przy użyciu różnych metod w CMFCRibbonPanel klasie. W przykładzie pokazano, jak ustawić skrót klawiaturowy, który wyświetla panel wstążki, wyrównuje elementy w panelu pionowo według kolumny i włącza uzasadnienie kolumny. Ten fragment kodu jest częścią przykładu pokazowego pakietu MS Office 2007.

// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel *pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();

Hierarchia dziedziczenia

Obiekt CObject

CMFCRibbonPanel

Wymagania

Nagłówek: afxRibbonPanel.h

CMFCRibbonPanel::Dodaj

Dołącza określony element wstążki do tablicy elementów wstążki zawartych w panelu wstążki.

virtual void Add(CMFCRibbonBaseElement* pElem);

Parametry

pElem
[in, out] Wskaźnik do elementu wstążki.

Uwagi

CMFCRibbonPanel::AddSeparator

Dodaje separator do panelu wstążki.

virtual void AddSeparator();

Uwagi

Wywołaj tę metodę, aby dodać separator do panelu wstążki. Separator zostanie dodany obok elementu wstążki, który został dodany przez poprzednie wywołanie do cmFCRibbonPanel::Add. Aby wstawić separator na danej pozycji, wywołaj metodę CMFCRibbonPanel::InsertSeparator.

CMFCRibbonPanel::AddToolBar

Dodaje pasek narzędzi do panelu wstążki.

CMFCRibbonButtonsGroup* AddToolBar(
UINT uiToolbarResID,
UINT uiColdResID = 0,
UINT uiHotResID = 0,
UINT uiDisabledResID = 0);

Parametry

uiToolbarResID
[in] Określa identyfikator zasobu paska narzędzi do dodania.

uiColdResID
[in] Określa identyfikator zasobu zimnych obrazów paska narzędzi.

uiHotResID
[in] Określa identyfikator zasobu gorących obrazów paska narzędzi.

uiDisabledResID
[in] Określa identyfikator zasobu wyłączonych obrazów paska narzędzi.

Wartość zwracana

Wywołaj tę metodę, aby dodać pasek narzędzi do panelu wstążki. Pasek narzędzi zostanie dodany obok elementu wstążki dodanego przez poprzednie wywołanie do cmFCRibbonPanel::Add.

Uwagi

Aby uzyskać więcej informacji na temat pasków narzędzi, gorących obrazów, zimnych obrazów i wyłączonych obrazów, zobacz Klasa CMFCToolBar.

CMFCRibbonPanel::CMFCRibbonPanel

Tworzy i inicjuje obiekt CMFCRibbonPanel .

CMFCRibbonPanel(
LPCTSTR lpszName = NULL,
HICON hIcon = NULL);

CMFCRibbonPanel(CMFCRibbonGallery* pPaletteButton);

Parametry

lpszName
[in] Nazwa panelu wstążki.

hIcon
[in] Dojmij do ikony domyślnego przycisku na panelu wstążki.

pPaletteButton
[in] Wskaźnik do galerii wstążki dla panelu wstążki.

CMFCRibbonPanel::FindByData

Pobiera element wstążki skojarzony z określonymi danymi.

CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData) const;

Parametry

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

Wartość zwracana

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

Uwagi

CMFCRibbonPanel::FindByID

Pobiera element wstążki, który jest identyfikowany przez określony identyfikator polecenia.

CMFCRibbonBaseElement* FindByID(UINT uiCmdID) const;

Parametry

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

Wartość zwracana

Element wstążki, który jest identyfikowany przez określony identyfikator polecenia; w przeciwnym razie wartość NULL, jeśli żaden element wstążki nie jest identyfikowany z określonym identyfikatorem polecenia.

CMFCRibbonPanel::GetCaptionHeight

Pobiera wysokość podpisu dla panelu wstążki.

int GetCaptionHeight() const;

Wartość zwracana

Wysokość w pikselach podpisu dla panelu wstążki.

Uwagi

CMFCRibbonPanel::GetCount

Pobiera liczbę elementów wstążki zawartych w panelu wstążki.

int GetCount() const;

Wartość zwracana

Liczba elementów wstążki zawartych w panelu wstążki.

CMFCRibbonPanel::GetData

Zwraca dane zdefiniowane przez użytkownika skojarzone z panelem.

DWORD_PTR GetData() const;

Wartość zwracana

Dane zdefiniowane przez użytkownika skojarzone z panelem.

CMFCRibbonPanel::GetDefaultButton

Pobiera przycisk domyślny dla panelu wstążki.

CMFCRibbonButton& GetDefaultButton();

Wartość zwracana

Domyślny przycisk panelu wstążki.

Uwagi

Przycisk domyślny jest wyświetlany, gdy panel wstążki ma za mało miejsca, aby wyświetlić jego elementy wstążki.

CMFCRibbonPanel::GetDroppedDown

Pobiera wskaźnik do elementu wstążki, jeśli menu podręczne zostanie usunięte.

CMFCRibbonBaseElement* GetDroppedDown() const;

Wartość zwracana

Wskaźnik do elementu wstążki, który ma menu podręczne upuszczone; w przeciwnym razie wartość NULL, jeśli żaden element wstążki nie ma wyskakującego menu rozwijanego.

Uwagi

Testowane są tylko elementy wstążki zawarte w panelu wstążki.

CMFCRibbonPanel::GetElement

Zwraca element wstążki znajdujący się w określonym indeksie.

CMFCRibbonBaseElement* GetElement(int nIndex) const;

Parametry

nIndex
[in] Określa indeks zerowy elementu do pobrania.

Wartość zwracana

Prawidłowy wskaźnik do podstawowego elementu wstążki znajdujący się na pozycji nIndex w panelu wstążki lub NULL, jeśli nie ma elementu w określonym indeksie.

CMFCRibbonPanel::GetElements

Pobiera wszystkie elementy wstążki zawarte w panelu wstążki.

void GetElements(CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

Parametry

arElements
[out] Tablica do wypełnienia wszystkimi elementami wstążki, które znajdują się w panelu wstążki.

Uwagi

CMFCRibbonPanel::GetElementsByID

Dodaje elementy wstążki, które mają określony identyfikator polecenia do określonej tablicy.

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

Parametry

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

arElements
[in] Tablica elementów wstążki.

Uwagi

Testowane są tylko elementy wstążki zawarte w panelu wstążki.

CMFCRibbonPanel::GetHighlighted

Pobiera element wstążki wyróżniony na panelu wstążki.

CMFCRibbonBaseElement* GetHighlighted() const;

Wartość zwracana

Wskaźnik do elementu wstążki wyróżnionego na panelu wstążki.

Uwagi

CMFCRibbonPanel::GetIndex

Pobiera indeks zerowy określonego elementu wstążki z tablicy elementów wstążki zawartych w panelu wstążki.

virtual int GetIndex(CMFCRibbonBaseElement* pElem) const;

Parametry

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

Wartość zwracana

Indeks na podstawie zera określonego elementu wstążki, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie -1.

Uwagi

CMFCRibbonPanel::GetItemIDsList

Pobiera identyfikatory poleceń dla wszystkich elementów wstążki w panelu wstążki.

void GetItemIDsList(CList<UINT, UINT>& lstItems) const;

Parametry

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

Uwagi

CMFCRibbonPanel::GetName

Pobiera nazwę panelu wstążki.

LPCTSTR GetName() const;

Wartość zwracana

Nazwa panelu wstążki.

Uwagi

CMFCRibbonPanel::GetParentButton

CMFCRibbonBaseElement* GetParentButton() const;

Wartość zwracana

Uwagi

CMFCRibbonPanel::GetParentCategory

Zwraca kategorię nadrzędną panelu wstążki.

CMFCRibbonCategory* GetParentCategory() const;

Wartość zwracana

Wskaźnik do kategorii wstążki zawierającej ten panel wstążki.

CMFCRibbonPanel::GetParentMenuBar

CMFCRibbonPanelMenuBar* GetParentMenuBar() const;

Wartość zwracana

Uwagi

CMFCRibbonPanel::GetPreferedMenuLocation

Pobiera preferowany prostokąt wyświetlania dla menu podręcznego panelu wstążki.

virtual BOOL GetPreferedMenuLocation(CRect& rect);

Parametry

Rect
[out] Ten parametr nie jest używany.

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Ta metoda zawsze zwraca wartość FALSE. Zastąpij tę metodę, aby pobrać preferowany prostokąt wyświetlania dla menu podręcznego panelu wstążki.

CMFCRibbonPanel::GetPressed

Pobiera wskaźnik do elementu wstążki na panelu wstążki, jeśli użytkownik aktualnie go naciśnie.

CMFCRibbonBaseElement* GetPressed() const;

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli użytkownik aktualnie go naciśnie; w przeciwnym razie wartość NULL.

Uwagi

CMFCRibbonPanel::GetRect

Pobiera prostokąt wyświetlania dla panelu wstążki.

const CRect& GetRect() const;

Wartość zwracana

Prostokąt wyświetlania panelu wstążki.

Uwagi

CMFCRibbonPanel::HasElement

Wskazuje, czy panel wstążki zawiera określony element wstążki.

BOOL HasElement(const CMFCRibbonBaseElement* pElem) const;

Parametry

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

Wartość zwracana

WARTOŚĆ TRUE, jeśli panel wstążki zawiera określony element wstążki; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonPanel::Wyróżnij

Ustawia kolor wyróżnienia dla wybranego panelu wstążki i dla elementu wstążki określonego przez punkt.

virtual void Highlight(
BOOL bHighlight,
CPoint point);

Parametry

bHighlight
[in] PRAWDA, aby wyróżnić panel wstążki; FAŁSZ, aby cofnąć zaznaczenie panelu wstążki.

punkt
[in] Współrzędne x i y wskaźnika względem lewego górnego rogu okna.

Uwagi

CMFCRibbonPanel::HitTest

Pobiera element wstążki, jeśli określony punkt znajduje się w nim.

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

Parametry

punkt
[in] Współrzędne x i y wskaźnika względem lewego górnego rogu okna.

bCheckPanelCaption
[in] Wartość TRUE do testowania podpisu panelu wstążki; w przeciwnym razie FAŁSZ.

Wartość zwracana

Wskaźnik do elementu wstążki, jeśli określony punkt znajduje się w nim; w przeciwnym razie wartość NULL.

Uwagi

Testowane są tylko elementy wstążki zawarte w panelu wstążki.

CMFCRibbonPanel::HitTestEx

Pobiera indeks na podstawie zera elementu wstążki, który ma określony punkt znajdujący się w nim.

virtual int HitTestEx(CPoint point) const;

Parametry

punkt
[in] Współrzędne x i y wskaźnika względem lewego górnego rogu okna.

Wartość zwracana

Indeks na podstawie zera elementu wstążki, który ma określony punkt znajdujący się w nim; w przeciwnym razie -1.

Uwagi

Testowane są tylko elementy wstążki zawarte w panelu wstążki.

CMFCRibbonPanel::Wstaw

Wstawia określony element wstążki na określonej pozycji w tablicy elementów wstążki zawartych w panelu wstążki.

virtual BOOL Insert(
CMFCRibbonBaseElement* pElem,
int nIndex);

Parametry

pElem
[in, out] Wskaźnik do elementu wstążki.

nIndex
[in] Wartość oparta na zera, od -1 do liczby elementów wstążki zawartych w tablicy.

Wartość zwracana

Wartość TRUE, jeśli element wstążki został pomyślnie wstawiony; w przeciwnym razie FAŁSZ.

Uwagi

Jeśli wartość nIndex wynosi -1 lub jeśli nIndex jest równa liczbie elementów wstążki w tablicy, określony element wstążki zostanie dodany na końcu tablicy. Jeśli wartość nIndex jest poza zakresem, metoda zakończy się niepowodzeniem.

CMFCRibbonPanel::InsertSeparator

Wstawia separator w danej pozycji.

virtual BOOL InsertSeparator(int nIndex);

Parametry

nIndex
[in] Określa indeks oparty na zerach, w którym jest wstawiany separator.

Wartość zwracana

WARTOŚĆ TRUE, jeśli separator został pomyślnie wstawiony; w przeciwnym razie, FAŁSZ.

Uwagi

Wywołaj tę metodę, aby wstawić separator w pozycji określonej przez nIndex. Aby wstawić separator obok ostatnio dodanego elementu wstążki, wywołaj metodę CMFCRibbonPanel::AddSeparator.

CMFCRibbonPanel::IsCenterColumnVert

Wskazuje, czy pionowe pozycje elementów wstążki są wyśrodkowane w ich prostokątie wyświetlania.

BOOL IsCenterColumnVert() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli pionowe pozycje elementów wstążki są wyśrodkowane w ich prostokąt wyświetlania; w przeciwnym razie FAŁSZ.

CMFCRibbonPanel::IsCollapsed

Wskazuje, czy rozmiar wyświetlania panelu wstążki jest zminimalizowany w kierunku poziomym.

BOOL IsCollapsed() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli rozmiar wyświetlania panelu wstążki jest zminimalizowany w kierunku poziomym; w przeciwnym razie FAŁSZ.

Uwagi

Po zwinięciu panelu wstążki zostanie wyświetlony tylko jego domyślny przycisk, jego nazwa i strzałka listy rozwijanej.

CMFCRibbonPanel::IsHighlighted

Wskazuje, czy ekran panelu wstążki jest wyróżniony.

BOOL IsHighlighted() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli zostanie wyróżniony ekran panelu wstążki; w przeciwnym razie FAŁSZ.

Uwagi

Wyświetlanie panelu wstążki jest wyróżnione, gdy wskaźnik jest nad nim wyświetlany.

CMFCRibbonPanel::IsJustifyColumns

Wskazuje, czy wymiary wyświetlania elementów wstążki, które znajdują się w tej samej kolumnie na panelu wstążki, są ustawione na taką samą szerokość.

BOOL IsJustifyColumns() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli wymiary wyświetlania elementów wstążki, które znajdują się w tej samej kolumnie na panelu wstążki, są ustawione na taką samą szerokość; w przeciwnym razie FAŁSZ.

CMFCRibbonPanel::IsMainPanel

Wskazuje, czy panel wstążki jest głównym panelem wstążki.

virtual BOOL IsMainPanel() const;

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Ta metoda zawsze zwraca wartość FALSE. Zastąpij tę metodę, aby wskazać, czy panel wstążki jest głównym panelem wstążki.

Główny panel wstążki jest wyświetlany, gdy użytkownik wybierze przycisk aplikacji.

CMFCRibbonPanel::IsMenuMode

BOOL IsMenuMode() const;

Wartość zwracana

Uwagi

CMFCRibbonPanel::OnKey

virtual BOOL OnKey(UINT nChar);

Parametry

[in] nChar

Wartość zwracana

Uwagi

CMFCRibbonPanel::RecalcWidths

Oblicza ponownie szerokość każdej konfiguracji układu wyświetlania dla panelu wstążki.

virtual void RecalcWidths(
CDC* pDC,
int nHeight);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla panelu wstążki.

nHeight
[in] Wysokość panelu wstążki.

Uwagi

Panel wstążki zmienia konfigurację układu w miarę zmiany dostępnej szerokości.

CMFCRibbonPanel::Remove

Usuwa i opcjonalnie usuwa element znajdujący się w określonym indeksie.

BOOL Remove(
int nIndex,
BOOL bDelete = TRUE);

Parametry

nIndex
[in] Określa indeks zerowy elementu, który jest usuwany z panelu wstążki.

bDelete
[in] WARTOŚĆ TRUE, aby usunąć usuwany element; w przeciwnym razie, FAŁSZ.

Wartość zwracana

WARTOŚĆ TRUE, jeśli element został usunięty i usunięty (jeśli bDelete ma wartość TRUE); FAŁSZ, jeśli element nie został usunięty lub nie ma elementu wstążki znajdującego się w nIndex.

Uwagi

Wywołaj tę metodę, aby usunąć element z panelu wstążki.

CMFCRibbonPanel::RemoveAll

Usuwa wszystkie elementy wstążki z panelu wstążki.

void RemoveAll();

Uwagi

Wszystkie elementy wstążki są usuwane z panelu wstążki i niszczone.

CMFCRibbonPanel::Replace

Zamienia jeden element na inny na podstawie ich wartości indeksu.

BOOL Replace(
int nIndex,
CMFCRibbonBaseElement* pElem);

Parametry

nIndex
[in] Określa indeks zerowy elementu do zastąpienia.

pElem
[in, out] Prawidłowy wskaźnik do elementu, który zastępuje oryginalny element.

Wartość zwracana

WARTOŚĆ TRUE, jeśli oryginalny element wstążki został pomyślnie zastąpiony przez nowy element wstążki; FAŁSZ, jeśli element wstążki nie został zastąpiony lub jeśli nie ma żadnego elementu w określonym indeksie.

Uwagi

Aby zastąpić element wstążki za pomocą identyfikatora polecenia, wywołaj polecenie CMFCRibbonPanel::ReplaceByID.

CMFCRibbonPanel::ReplaceByID

Zamienia jeden element na inny na podstawie określonego identyfikatora polecenia.

BOOL ReplaceByID(
UINT uiCmdID,
CMFCRibbonBaseElement* pElem);

Parametry

uiCmdID
[in] Określa identyfikator polecenia elementu do zastąpienia.

pElem
[in, out] Prawidłowy wskaźnik do elementu, który zastąpi oryginalny element.

Wartość zwracana

WARTOŚĆ TRUE, jeśli oryginalny element wstążki został pomyślnie zastąpiony przez nowy element wstążki; FAŁSZ, jeśli element wstążki nie został zastąpiony lub jeśli żaden element o określonym identyfikatorze polecenia rzeczywiście istnieje.

Uwagi

Aby zastąpić element wstążki na podstawie pozycji, wywołaj polecenie CMFCRibbonPanel::Replace.

CMFCRibbonPanel::SetCenterColumnVert

Włącza lub wyłącza wyśrodkowanie pionowych pozycji elementów wstążki w ich prostokątze wyświetlania.

void SetCenterColumnVert(BOOL bSet = TRUE);

Parametry

Zestaw bSet
[in] WARTOŚĆ TRUE, aby wyśrodkować pionowe pozycje elementów wstążki w ich prostokątze wyświetlania; FAŁSZ, aby wyłączyć tę funkcję.

Uwagi

CMFCRibbonPanel::SetData

Kojarzy dane zdefiniowane przez użytkownika z panelem wstążki.

void SetData(DWORD_PTR dwData);

Parametry

dwData
[in] Określa dane zdefiniowane przez użytkownika do ustawienia.

Uwagi

Wywołaj tę metodę, aby skojarzyć dane zdefiniowane przez użytkownika z panelem wstążki.

CMFCRibbonPanel::SetElementMenu

Przypisuje menu podręczne do elementu, który ma podany identyfikator polecenia.

BOOL SetElementMenu(
UINT uiCmdID,
HMENU hMenu,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

BOOL SetElementMenu(
UINT uiCmdID,
UINT uiMenuResID,
BOOL bIsDefautCommand = FALSE,
BOOL bRightAlign = FALSE);

Parametry

uiCmdID
[in] Określa identyfikator polecenia elementu wstążki, w którym jest dodawane menu.

hMenu
[in] Określa uchwyt do menu systemu Windows, aby dodać do panelu wstążki.

bIsDefautCommand
[in] TRUE, aby określić, że polecenie skojarzone z elementem wstążki powinno zostać wykonane, jeśli element wstążki zostanie kliknięty. W takim przypadku menu jest otwierane tylko wtedy, gdy użytkownik kliknie strzałkę obok elementu wstążki. FALSE , aby określić, że polecenie skojarzone z elementem wstążki nie powinno być wykonywane, jeśli element wstążki zostanie kliknięty. W takim przypadku menu podręczne jest wyświetlane niezależnie od tego, gdzie użytkownik kliknie element.

bRightAlign
[in] PRAWDA, aby określić, że menu podręczne jest wyrównane do prawej; w przeciwnym razie, FAŁSZ.

uiMenuResID
[in] Określa identyfikator zasobu menu, który ma zostać dodany do panelu wstążki.

Wartość zwracana

WARTOŚĆ TRUE, jeśli menu zostało przypisane do elementu wstążki; w przeciwnym razie, FAŁSZ.

Uwagi

Wywołaj tę metodę, aby przypisać menu podręczne do elementu wstążki, który ma podany identyfikator polecenia.

CMFCRibbonPanel::SetElementRTC

Dodaje element wstążki określony przez podane informacje o klasie środowiska uruchomieniowego do panelu wstążki.

CMFCRibbonBaseElement* SetElementRTC(
int nIndex,
CRuntimeClass* pRTC);

Parametry

nIndex
[in] Określa indeks zerowy elementu wstążki do dodania.

PRTC
[in, out] Wskaźnik do informacji o klasie środowiska uruchomieniowego dla elementu wstążki, który jest dodawany do panelu wstążki.

Wartość zwracana

Element wstążki, który został utworzony przy użyciu określonych informacji o klasie środowiska uruchomieniowego.

Uwagi

Jeśli chcesz dodać element niestandardowy (na przykład przycisk koloru) do panelu wstążki, musisz określić informacje o klasie środowiska uruchomieniowego elementu niestandardowego. Wstążka przechowuje te informacje, tworzy element niestandardowy i zastępuje istniejący element, który znajduje się (zidentyfikowany przez) określony identyfikator polecenia. Następnie wstążka zwraca wskaźnik do nowo utworzonego elementu.

CMFCRibbonPanel::SetElementRTCByID

Dodaje element wstążki określony przez podane informacje o klasie środowiska uruchomieniowego do panelu wstążki.

CMFCRibbonBaseElement* SetElementRTCByID(
UINT uiCmdID,
CRuntimeClass* pRTC);

Parametry

uiCmdID
[in] Określa identyfikator polecenia elementu wstążki do dodania.

PRTC
[in, out] Wskaźnik do informacji o klasie środowiska uruchomieniowego skojarzonych z elementem wstążki dodanym do panelu wstążki.

Wartość zwracana

Element wstążki, który został utworzony przy użyciu określonych informacji o klasie środowiska uruchomieniowego.

Uwagi

Jeśli chcesz dodać element niestandardowy (na przykład przycisk koloru) do panelu wstążki, musisz określić informacje o klasie środowiska uruchomieniowego elementu niestandardowego. Wstążka przechowuje te informacje, tworzy element niestandardowy i zastępuje istniejący element znajdujący się przy użyciu określonego identyfikatora polecenia. Następnie zwraca wskaźnik do nowo utworzonego elementu.

Przykład

W poniższym przykładzie pokazano, jak używać SetElementRTCByID metody :

// Load and add toolbar with standard buttons. This toolbar
// should display a custom color button with id ID_CHAR_COLOR:

pPanel->AddToolBar(IDR_MAINFRAME,
    IDB_MAINFRAME256);

CMFCRibbonColorButton* pColorButton =
(CMFCRibbonColorButton*)pPanel->SetElementRTCByID(
ID_CHAR_COLOR,
    RUNTIME_CLASS (CMFCRibbonColorButton));

// SetElementRTCByID sets runtime class and returns a pointer
// to the newly created custom button,
    which can be set up immediately:
pColorButton->EnableAutomaticButton(_T("Automatic"),
    RGB (0,
    0,
    0));

CMFCRibbonPanel::SetJustifyColumns

Włącza lub wyłącza korektę szerokości elementów wstążki w tej samej kolumnie.

void SetJustifyColumns(BOOL bSet = TRUE);

Parametry

Zestaw bSet
[in] WARTOŚĆ TRUE, aby dostosować szerokość elementów wstążki w tej samej kolumnie do szerokości największego elementu wstążki w kolumnie; WARTOŚĆ FALSE, aby wyłączyć tę korektę szerokości.

Uwagi

Gdy ta funkcja jest włączona w panelu wstążki, szerokości elementów wstążki w tej samej kolumnie są dostosowywane do szerokości największego elementu wstążki w tej samej kolumnie.

CMFCRibbonPanel::SetKeys

Ustawia etykietkę klucza dla domyślnego przycisku panelu wstążki.

void SetKeys(LPCTSTR lpszKeys);

Parametry

lpszKeys
[in] Etykietka dla domyślnego przycisku panelu wstążki.

Uwagi

Przycisk domyślny jest wyświetlany, gdy panel wstążki ma za mało miejsca, aby wyświetlić jego elementy wstążki.

CMFCRibbonPanel::ShowPopup

Tworzy i wyświetla menu podręczne panelu wstążki.

CMFCRibbonPanelMenu* ShowPopup(CMFCRibbonDefaultPanelButton* pButton = NULL);

Parametry

PButton
[in] Wskaźnik do domyślnego przycisku panelu wstążki.

Wartość zwracana

Wskaźnik do menu podręcznego panelu wstążki, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.

Uwagi

Menu podręczne panelu wstążki jest dostępne tylko po zwinięciu ekranu panelu wstążki.

CMFCRibbonPanel::SetFocused

Ustawia fokus na określony element wstążki.

void SetFocused(CMFCRibbonBaseElement* pNewFocus);

Parametry

pNewFocus
Wskaźnik do elementu wstążki, który odbiera fokus.

Uwagi

CMFCRibbonPanel::MakeGalleryItemVisible

Przewija galerię, aby uwidocznić określony element wstążki.

void MakeGalleryItemVisible(CMFCRibbonBaseElement* pItem);

Parametry

pItem
Wskaźnik do elementu wstążki do pokazania.

Uwagi

CMFCRibbonPanel::IsWindows7Look

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

BOOL IsWindows7Look() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli nadrzędna wstążka ma wygląd systemu Windows 7; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonPanel::GetVisibleElements

Pobiera tablicę widocznych elementów.

void GetVisibleElements(
CArray<CMFCRibbonBaseElement*,
CMFCRibbonBaseElement*>& arElements);

Parametry

arElements
Gdy funkcja zwróci, ten parametr zawiera tablicę widocznych elementów.

Uwagi

CMFCRibbonPanel::GetGalleryRect

Zwraca prostokąt ograniczenia elementu Galeria.

CRect GetGalleryRect();

Wartość zwracana

Rozmiar i położenie elementu Galeria w tym panelu.

Uwagi

CMFCRibbonPanel::GetFocused

Zwraca element fokusu.

CMFCRibbonBaseElement* GetFocused() const;

Wartość zwracana

Wskaźnik do elementu ukierunkowanego lub wartości NULL.

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CObject
Klasa CMFCRibbonCategory
Klasa CMFCRibbonBaseElement