RibbonGallery Interfejs

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Ribbon

Zestaw:

Microsoft.Office.Tools.Common.dll

Reprezentuje kontrolkę, która wyświetla menu RibbonDropDownItem obiektów i RibbonButton kontrolek.

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Atrybuty

GuidAttribute

Implementuje

RibbonComponent RibbonControl IComponent IDisposable

Uwagi

Podobnie jak w przypadku interfejsu RibbonDropDownRibbonDropDownItem, RibbonGallery wyświetla menu obiektów i RibbonButton kontrolek.

W przeciwieństwie do interfejsu RibbonDropDownRibbonGallery interfejs wywołuje Click zdarzenia, a nie SelectionChanged zdarzenia, gdy użytkownik kliknie RibbonDropDownItemelement . Oznacza to na przykład, że Click zdarzenie jest wywoływane dwa razy, gdy użytkownik klika to samo RibbonDropDownItem dwa razy. (Zdarzenie SelectionChanged zostanie podniesione co najwyżej raz, gdy początkowy wybór został wykonany dla tego samego scenariusza w zależności RibbonDropDownod tego, jaki wybór był przed pierwszym kliknięciem).

Właściwość ShowItemSelection określa, czy aktualnie wybrane RibbonDropDownItem elementy są wizualnie rozróżniane od niezaznakowanych elementów. W elemencie RibbonGallerymożna wybrać tylko jeden element jednocześnie.

Właściwość ItemImageSize może służyć do określania rozmiarów obrazów innych niż 16x16 i 32x32.

Dodawanie obiektów RibbonDropDownItem w czasie projektowania

1. Kliknij właściwość Items w oknie Właściwości .

2. Kliknij wielokropek (...).

3. W Redaktor Kolekcji rozwijanej dodaj, porządkuj i edytuj nowe elementy.

Kontrolki można dodawać RibbonButton do RibbonGallery elementu w czasie projektowania.

Dodawanie formantów RibbonButton w czasie projektowania

1. Kliknij właściwość Buttons w oknie Właściwości .

2. Kliknij wielokropek (...).

3. W Redaktor kolekcji przycisków dodaj, porządkuj i edytuj nowe kontrolki przycisków.

Obiekt można utworzyć RibbonGallery w czasie wykonywania przy użyciu CreateRibbonGallery metody RibbonFactory obiektu .

Istnieją dwa sposoby uzyskiwania RibbonFactory dostępu do obiektu:

• Za pomocą Factory właściwości klasy Wstążki. Użyj podejścia z kodu w klasie wstążki.

• Przy użyciu Globals.Factory.GetRibbonFactory metody . Użyj podejścia do kodu spoza klasy wstążki.

Niektóre właściwości tej kontrolki można ustawić tylko przed załadowaniem wstążki do aplikacji pakietu Office lub przed dodaniu kontrolki do menu dynamicznego w czasie wykonywania. Aby uzyskać informacje na temat ustawiania tych właściwości, zobacz Temat Omówienie modelu obiektów wstążki.

Uwaga

Ten interfejs jest wdrażany przy użyciu programu Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz omówienie środowiska uruchomieniowego Visual Studio Tools dla pakietu Office.

Użycie

W tej dokumentacji opisano wersję tego typu używaną tylko w projektach pakietu Office przeznaczonych dla platformy .NET Framework 4 i nowszych. W projektach przeznaczonych do pracy z programem .NET Framework 3.5 ten typ może mieć inne elementy członkowskie, a przykładowy kod podany dla tego typu może nie działać. Aby uzyskać dokumentację dotyczącą tego typu projektów przeznaczonych dla .NET Framework 3.5, zobacz następującą sekcję referencyjną w dokumentacji programu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Właściwości

Buttons	Pobiera kolekcję przycisków w tym RibbonGalleryobiekcie .
ColumnCount	Pobiera lub ustawia liczbę kolumn elementu w tym elemencie RibbonGallery.
ControlSize	Pobiera lub ustawia rozmiar kontrolki RibbonGallery .
Description	Pobiera lub ustawia tekst wyświetlany w tej RibbonGallery kontrolce w menu lub przycisku podziału.
Enabled	Pobiera lub ustawia wartość wskazującą, czy jest to RibbonControl włączone. (Odziedziczone po RibbonControl)
Id	Pobiera ciąg używany przez pakiet Microsoft Office do identyfikowania tego RibbonControl obiektu. (Odziedziczone po RibbonControl)
Image	Pobiera lub ustawia obraz wyświetlany na przycisku.
ImageName	Pobiera lub ustawia nazwę, której można użyć do identyfikacji RibbonGallery elementu w procedurze obsługi zdarzeń LoadImage .
ItemImageSize	Pobiera lub ustawia element Size , który daje wymiary obrazów wyświetlanych przez elementy w tym obiekcie RibbonGallery.
Items	Pobiera kolekcję składników RibbonDropDownItem w tym RibbonGallerypliku .
KeyTip	Pobiera lub ustawia skrót klawiaturowy dla tego RibbonGallery.
Label	Pobiera lub ustawia tekst wyświetlany w tym RibbonGalleryobiekcie .
Name	Pobiera lub ustawia nazwę tego RibbonComponentelementu . (Odziedziczone po RibbonComponent)
OfficeImageId	Pobiera lub ustawia obraz do wyświetlenia w kontrolce, jeśli chcesz użyć wbudowanej ikony pakietu Microsoft Office.
Parent	Pobiera element RibbonComponent reprezentujący element nadrzędny tego RibbonComponentobiektu . (Odziedziczone po RibbonComponent)
Position	Pobiera lub ustawia pozycję galerii, jeśli galeria znajduje się w menu pakietu Microsoft Office.
Ribbon	Pobiera obiekt najwyższego poziomu Ribbon zawierający hierarchię sterowania. (Odziedziczone po RibbonComponent)
RibbonUI	Pobiera wystąpienie IRibbonUI udostępniane przez aplikację pakietu Microsoft Office do kodu rozszerzalności wstążki. (Odziedziczone po RibbonComponent)
RowCount	Pobiera lub ustawia liczbę wierszy składników RibbonDropDownItem , które RibbonGallery są wyświetlane.
ScreenTip	Pobiera lub ustawia tekst porad, który pojawia się, gdy użytkownik przenosi wskaźnik na ten RibbonGalleryelement .
SelectedItem	Pobiera lub ustawia aktualnie wybrany element.
SelectedItemIndex	Pobiera lub ustawia indeks aktualnie wybranego RibbonDropDownItemelementu .
ShowImage	Pobiera lub ustawia wartość wskazującą, czy obraz skojarzony z elementem RibbonGallery jest widoczny.
ShowItemImage	Pobiera lub ustawia wartość wskazującą, czy obrazy są wyświetlane dla elementów w galerii.
ShowItemLabel	Pobiera lub ustawia wartość wskazującą, czy etykiety są wyświetlane dla elementów w tym RibbonGalleryobiekcie .
ShowItemSelection	Pobiera lub ustawia wartość wskazującą, czy aktualnie zaznaczona RibbonDropDownItem wartość jest wizualnie rozróżniana od pozostałych niezaznawanych elementów.
ShowLabel	Pobiera lub ustawia wartość wskazującą, czy etykieta dla tego RibbonGallery elementu jest widoczna.
SuperTip	Pobiera lub ustawia tekst wielowierszowej porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonGallery.
Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, które są skojarzone z tym RibbonComponent. (Odziedziczone po RibbonComponent)
Visible	Pobiera lub ustawia wartość wskazującą, czy jest ona RibbonControl widoczna. (Odziedziczone po RibbonControl)

Metody

PerformDynamicLayout()	Wywołuje metodę Microsoft.Office.Core.IRibbonUI.InvalidateControl kontrolki nadrzędnej, jeśli RibbonComponent obiekt ma dynamiczny element nadrzędny, taki jak menu dynamiczne, i układ nie jest zawieszony. (Odziedziczone po RibbonComponent)
PerformLayout()	Wywołuje element Microsoft.Office.Core.IRibbonUI.InvalidateControl, jeśli RibbonComponent obiekt ma element nadrzędny i układ nie jest zawieszony. (Odziedziczone po RibbonComponent)
ResumeLayout()	Odwraca efekt SuspendLayout() metody . (Odziedziczone po RibbonComponent)
ResumeLayout(Boolean)	Odwraca efekt SuspendLayout() metody . (Odziedziczone po RibbonComponent)
SuspendLayout()	Uniemożliwia aplikacji pakietu Microsoft Office odświeżanie stanu kontrolek na wstążce. (Odziedziczone po RibbonComponent)

Zdarzenia

ButtonClick	Występuje, gdy użytkownik kliknie przycisk w tym RibbonGallerypliku .
Click	Występuje, gdy użytkownik kliknie element w tym RibbonGalleryelemencie .
ItemsLoading	Występuje po otwarciu.RibbonGallery