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
Członkowie
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
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ść podpis panelu wstążki.
int GetCaptionHeight() const;
Wartość zwracana
Wysokość w pikselach podpis 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 przetestowania podpis panelu wstążki; w przeciwnym razie wartość FALSE.
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 klawisza 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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla