Udostępnij przez


RibbonGroup Interfejs

Definicja

Reprezentuje grupę kontrolek na karcie Wstążki.

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
Atrybuty
Implementuje

Uwagi

Program Visual Studio tworzy RibbonGroup obiekt podczas przeciągania kontrolki Grupa z karty Kontrolki wstążki pakietu Office przybornika na Projektant wstążki.

Typowe zadania

W poniższej tabeli wymieniono elementy członkowskie, które są przydatne w przypadku typowych zadań. Wszystkie te zadania można wykonywać 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 Temat Omówienie modelu obiektów wstążki.

Zadanie Członek
Uzyskaj dostęp do kontrolek w grupie, dodaj kontrolki do grupy lub usuń kontrolki z grupy. Items Użyj właściwości .
Dodaj grupę do karty Wstążki. Dodaj element RibbonGroup do Groups kolekcji karty.
Określ lokalizację grupy na wbudowanej karcie względem lokalizacji wbudowanej grupy. Position Użyj właściwości .

Obiekt można utworzyć RibbonGroup w czasie wykonywania przy użyciu CreateRibbonGroup 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.

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

DialogLauncher

Pobiera lub ustawia uruchamianie okna dialogowego wstążki skojarzonego z grupą.

Id

Pobiera ciąg identyfikujący bieżącą grupę.

Items

Pobiera kontrolki w grupie.

KeyTip

Pobiera lub ustawia skrót klawiaturowy grupy.

Label

Pobiera lub ustawia tekst wyświetlany przez etykietę grupy.

Name

Pobiera lub ustawia nazwę tego RibbonComponentelementu .

(Odziedziczone po RibbonComponent)
Parent

Pobiera element RibbonComponent reprezentujący element nadrzędny tego RibbonComponentobiektu .

(Odziedziczone po RibbonComponent)
Position

Pobiera lub ustawia pozycję grupy na wbudowanej karcie względem wbudowanej grupy na karcie.

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)
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 grupa jest widoczna.

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

DialogLauncherClick

Występuje, gdy użytkownik kliknie ikonę uruchamiania okna dialogowego wstążki w grupie.

Dotyczy