Interfejs RibbonDialogLauncher

Artykuł
01/08/2014

Reprezentuje mała ikona standardowych na grupę, która umożliwia otwarcie okna dialogowego.

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

Składnia

'Deklaracja
<GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")> _
Public Interface RibbonDialogLauncher _
    Inherits IDisposable

[GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable

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

Właściwości

	Nazwa	Opis
	Enabled	Pobiera lub ustawia wartość wskazującą, czy to RibbonDialogLauncher jest włączona.
	Image	Pobiera lub ustawia obraz, który pojawia się w tej sprawie RibbonDialogLauncher po dodaniu do paska narzędzi Szybki dostęp.
	ImageName	Pobiera lub ustawia identyfikator, który jest używany do przypisania do tego obrazu RibbonDialogLauncher po dodaniu do paska narzędzi Szybki dostęp.
	KeyTip	Pobiera lub ustawia skrót klawiaturowy dla tej RibbonDialogLauncher.
	OfficeImageId	Pobiera lub ustawia obraz do wyświetlenia na tym RibbonDialogLauncher, jeśli chcesz użyć wbudowanego ikonę programu Microsoft Office.
	Parent	Pobiera RibbonGroup obiekt, które to RibbonDialogLauncher jest członkiem.
	Ribbon	Pobiera OfficeRibbon na której ta RibbonDialogLauncher jest umieszczony.
	ScreenTip	Zwraca lub ustawia tekst porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonDialogLauncher.
	SuperTip	Zwraca lub ustawia tekst wielowierszowy porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonDialogLauncher.
	Visible	Pobiera lub ustawia wartość wskazującą, czy to RibbonDialogLauncher jest widoczny.

Początek

Metody

	Nazwa	Opis
	Dispose	Wykonuje zadania zdefiniowane przez aplikację skojarzone z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów. (Odziedziczone z IDisposable).
	ResumeLayout	Cofa efekt SuspendLayout metody.
	SuspendLayout	Zapobiega odświeżania stanu formantów w aplikacji Microsoft Office OfficeRibbon.

Początek

Uwagi

A RibbonDialogLauncher jest domyślnie wyświetlany w prawym dolnym rogu grupy.

Image, ImageName, I OfficeImageId właściwości nie skutkują widoczne po RibbonDialogLauncher jest wyświetlany w grupie na Wstążce.Jednak, gdy użytkownik dodaje RibbonDialogLauncher do paska narzędzi Szybki dostęp do tych właściwości sterowania zachowaniem obrazu, który jest wyświetlany.Ponadto Visible właściwość nie powoduje ukrycia RibbonDialogLauncher kiedy jest wyświetlany na pasku narzędzi Szybki dostęp.Użytkownik może dodawać RibbonDialogLauncher do paska narzędzi Szybki dostęp, za pośrednictwem Wstążki (XML) elementu.Aby uzyskać więcej informacji, zobacz Wstążka ― Omówienie.

RibbonDialogLauncher Ma zastosowanie tylko do RibbonGroup.RibbonGroup Obiekt ma DialogLauncher członkiem RibbonDialogLauncher typu.Aby uzyskać informacje o dodawaniu RibbonDialogLauncher do RibbonGroup, zobacz Porady: dodawanie przycisk Uruchom okno dialogowe do grupy wstążek.

Można utworzyć RibbonDialogLauncher w czasie wykonywania za pomocą CreateRibbonDialogLauncher 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.

Niektóre właściwości tego formantu można ustawić tylko przed Wstążka jest ładowany do aplikacji pakietu Office.Aby uzyskać informacje o ustawianiu tych właściwości, zobacz Model obiektu Wstążka ― Omówienie.

[!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.

Przykłady

Poniższy przykład pokazuje, jak dodać RibbonDialogLauncher do grupy Wstążki i jak uruchomić niestandardowe okno dialogowe, które umożliwia użytkownikowi wybranie ustawienia zaawansowane po kliknięciu na RibbonDialogLauncher ikonę w prawym dolnym rogu RibbonGroup.

Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:

Dodaj wstążki (wizualnego projektowania) element do projektu programu pakietu Office.
Dodaj RibbonDialogLauncher do domyślnej grupy grupa1 jak podkreślono w Porady: dodawanie przycisk Uruchom okno dialogowe do grupy wstążek.
Jeśli używasz języka Visual Basic, Dodaj nowy okno dialogowe elementu do projektu.Jeśli używasz języka C#, Dodaj nowy Formularz systemu Windows przedmiotu i przekształcić go w dialogu przez dodanie OK i anulowanie przyciski do formularza i tworząc programy obsługi zdarzeń dla zdarzeń kliknij przyciski.
Ustaw (nazwa) właściwości okno dialogowe, aby advancedSettingsDialog.Można dostosować okno dialogowe Dodawanie formantów i ustawiając właściwości więcej.
Dodaj DialogLauncherClick obsługi zdarzeń w kodzie.
Umieść zawartość w następującej metody DialogLauncherClick program obsługi zdarzeń.

Private Sub Group1_DialogLauncherClick(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
End Sub

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}