RibbonGroup Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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. |