RibbonGroup Rozhraní

Definice

Obor názvů:

Microsoft.Office.Tools.Ribbon

Sestavení:

Microsoft.Office.Tools.Common.dll

Představuje skupinu ovládacích prvků na kartě pásu karet.

public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent

Atributy

GuidAttribute

Implementuje

RibbonComponent IComponent IDisposable

Poznámky

Visual Studio vytvoří RibbonGroup objekt při přetažení ovládacího prvku Skupina z karty Office Ribbon Controls (Ovládací prvky pásu karet Office) sady nástrojů na Designer pásu karet.

Obecné úlohy

V následující tabulce jsou uvedeny členy, které jsou užitečné pro běžné úlohy. Všechny tyto úlohy je možné provádět v době návrhu. Některé z těchto úloh je možné provádět za běhu před načtením pásu karet. Další informace najdete v tématu Přehled objektového modelu pásu karet.

Úkol	Člen
Přístup k ovládacím prvkům ve skupině, přidání ovládacích prvků do skupiny nebo odebrání ovládacích prvků ze skupiny	Items Použijte vlastnost .
Přidání skupiny na kartu pásu karet	RibbonGroup Přidejte do Groups kolekce na kartě .
Zadejte umístění skupiny na předdefinované kartě vzhledem k umístění předdefinované skupiny.	Position Použijte vlastnost .

Za běhu můžete vytvořit RibbonGroup pomocí CreateRibbonGroup metody objektu RibbonFactory .

Existují dva způsoby přístupu k objektu RibbonFactory :

• Pomocí Factory vlastnosti pásu karet třídy. Použijte tento přístup z kódu ve své třídě pásu karet.

• Pomocí Globals.Factory.GetRibbonFactory metody . Použijte tento přístup z kódu mimo svou třídu pásu karet.

Poznámka

Toto rozhraní je implementováno modulem Visual Studio Tools for Office Runtime. Rozhraní není určeno k implementaci do vašeho kódu. Další informace najdete v tématu přehled modulu Visual Studio Tools for Office Runtime.

Využití

Tato dokumentace popisuje verzi tohoto typu, který se používá v projektech Office cílených na rozhraní .NET Framework 4 nebo novější. V projektech cílených pro rozhraní .NET Framework 3.5 může mít tento typ jiné členy a ukázky kódu, poskytnuté pro tento typ, nemusejí fungovat. Dokumentaci k tomuto typu v projektech, které cílí na rozhraní .NET Framework 3.5, naleznete v následující referenční části v dokumentaci k sadě Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Vlastnosti

DialogLauncher	Získá nebo nastaví ikonu pro otevření dialogového okna pásu karet, která je přidružena ke skupině.
Id	Získá řetězec, který identifikuje aktuální skupinu.
Items	Získá ovládací prvky ve skupině.
KeyTip	Získá nebo nastaví klávesovou zkratku skupiny.
Label	Získá nebo nastaví text, který je zobrazen popiskem skupiny.
Name	Získá nebo nastaví název tohoto RibbonComponent. (Zděděno od RibbonComponent)
Parent	Získá objekt RibbonComponent , který představuje nadřazený objekt tohoto RibbonComponentobjektu . (Zděděno od RibbonComponent)
Position	Získá nebo nastaví pozici skupiny na předdefinované kartě vzhledem k předdefinované skupině na kartě.
Ribbon	Získá objekt nejvyšší úrovně Ribbon , který obsahuje hierarchii ovládacích prvků. (Zděděno od RibbonComponent)
RibbonUI	Získá IRibbonUI instance, která je poskytnuta microsoft office aplikace do kódu rozšiřitelnosti pásu karet. (Zděděno od RibbonComponent)
Tag	Získá nebo nastaví data specifická pro aplikaci, která je přidružena k tomuto RibbonComponent. (Zděděno od RibbonComponent)
Visible	Získá nebo nastaví hodnotu, která označuje, zda je skupina viditelná.

Metody

PerformDynamicLayout()	Volá Metodu Microsoft.Office.Core.IRibbonUI.InvalidateControl nadřazeného ovládacího prvku, pokud RibbonComponent má dynamický nadřazený prvek, například dynamickou nabídku, a rozložení není pozastaveno. (Zděděno od RibbonComponent)
PerformLayout()	Volání Microsoft.Office.Core.IRibbonUI.InvalidateControl pokud RibbonComponent má nadřazený a rozložení není pozastaveno. (Zděděno od RibbonComponent)
ResumeLayout()	Obrátí účinek SuspendLayout() metody . (Zděděno od RibbonComponent)
ResumeLayout(Boolean)	Obrátí účinek SuspendLayout() metody . (Zděděno od RibbonComponent)
SuspendLayout()	Zabrání aplikaci Microsoft Office v aktualizaci stavu ovládacích prvků na pásu karet. (Zděděno od RibbonComponent)

Událost

DialogLauncherClick

Vyvolá se, když uživatel klikne na ikonu pro otevření dialogového okna pásu karet ve skupině.