Interfejs RibbonGroup

Artykuł
01/08/2014

Reprezentuje grupę formantów na karcie wstążki.

Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

'Deklaracja
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

Typ RibbonGroup uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	DialogLauncher	Pobiera lub ustawia uruchamiania okna dialogowego wstążki, która jest skojarzona z grupą.
	Id	Pobiera ciąg, który identyfikuje bieżącej grupy.
	Items	Pobiera formantów w grupie.
	KeyTip	Pobiera lub ustawia skrót klawiaturowy grupy.
	Label	Pobiera lub ustawia tekst wyświetlany na etykiecie grupy.
	Name	Pobiera lub ustawia nazwę tego RibbonComponent. (Odziedziczone z RibbonComponent).
	Parent	Pobiera RibbonComponent reprezentująca nadrzędny to RibbonComponent. (Odziedziczone z RibbonComponent).
	Position	Pobiera lub ustawia pozycję grupy na karty wbudowanej w stosunku do wbudowanej grupy na karcie.
	Ribbon	Pobiera najwyższego poziomu Ribbon obiekt, który zawiera hierarchię kontroli. (Odziedziczone z RibbonComponent).
	RibbonUI	Infrastruktura. Pobiera IRibbonUI instancji, która jest dostarczana przez aplikacji Microsoft Office do kodu rozszerzalność wstążki. (Odziedziczone z RibbonComponent).
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, która jest skojarzona z tym RibbonComponent. (Odziedziczone z RibbonComponent).
	Visible	Pobiera lub ustawia wartość wskazującą, czy grupa stanie się widoczna.

Początek

Metody

	Nazwa	Opis
	Dispose	Wykonuje zadania zdefiniowane przez aplikację skojarzone z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów. (Odziedziczone z IDisposable).
	PerformDynamicLayout	Wywołania Microsoft.Office.Core.IRibbonUI.InvalidateControl metoda nadrzędnego kontroli, jeśli RibbonComponent ma element nadrzędny dynamicznych, takich jak menu dynamiczne i układ nie jest zawieszony. (Odziedziczone z RibbonComponent).
	PerformLayout	Wywołania Microsoft.Office.Core.IRibbonUI.InvalidateControl Jeśli RibbonComponent ma element nadrzędny i układ nie jest zawieszony. (Odziedziczone z RibbonComponent).
	ResumeLayout()	Cofa efekt SuspendLayout metody. (Odziedziczone z RibbonComponent).
	ResumeLayout(Boolean)	Cofa efekt SuspendLayout metody. (Odziedziczone z RibbonComponent).
	SuspendLayout	Zapobiega aplikacji Microsoft Office odświeżania stanu formantów na Wstążce. (Odziedziczone z RibbonComponent).

Początek

Zdarzenia

	Nazwa	Opis
	DialogLauncherClick	Występuje po kliknięciu ikony wstęgi okno dialogowe Uruchamianie w grupie.
	Disposed	Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).

Początek

Uwagi

Visual Studio utworzy RibbonGroup obiektu, podczas przeciągania grupy sterowania z Formanty wstążki Office na karcie Przybornik na projektanta wstążki.

Typowe zadania

Poniższa lista zawiera elementy członkowskie, które są przydatne do wykonywania typowych zadań.Wszystkie te zadania mogą być wykonywane w czasie projektowania.Niektóre z tych zadań można wykonać w czasie wykonywania przed załadowaniem wstążki.Aby uzyskać więcej informacji, zobacz Model obiektu Wstążka ― Omówienie.

Zadanie	Członek
Dostęp do formantów w grupie, dodać formanty do grupy lub usunąć z grupy formanty.	Użyj właściwości Items.
Grupę można dodać do karty wstążki.	Dodaj RibbonGroup do Groups kolekcji na karcie.
Określ lokalizację grupy wbudowane karty, powiązane z lokalizacją wbudowanej grupy.	Użyj właściwości Position.

Można utworzyć RibbonGroup w czasie wykonywania za pomocą CreateRibbonGroup metoda RibbonFactory obiektu.

Istnieją dwa sposoby dostępu do RibbonFactory obiekt:

Za pomocą Factory właściwość klasy wstążki.Użyj tego podejścia do kodu w klasie wstążki.
Za pomocą Globals.Factory.GetRibbonFactory metody.Użyj tego podejścia do kodu poza klasy wstążki.

[!UWAGA]

Ten interfejs jest implementowany przez Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz Visual Studio Tools for Office Runtime ― Przegląd.

Użycie

W dokumentacji opisano wersję typu używanego w projektach dla pakietu Office przeznaczonych do pracy z programem .NET Framework 4 i .NET Framework 4.5. 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ę tego typu używanego w projektach przeznaczonych do działania z programem .NET Framework 3.5, zobacz następującą sekcję informacyjną w dokumentacji programu Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.