Interfejs RibbonDialogLauncher

Artykuł
05/08/2013

Reprezentuje mała ikona znormalizowanym 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	Zwraca lub ustawia wartość, która wskazuje, czy to RibbonDialogLauncher jest włączone.
	Image	Pobiera lub ustawia obraz, który wygląda na to RibbonDialogLauncher po dodaniu do paska narzędzi Szybki dostęp.
	ImageName	Pobiera lub ustawia identyfikator, który służy do przypisywania obrazu do tego RibbonDialogLauncher po dodaniu do paska narzędzi Szybki dostęp.
	KeyTip	Pobiera lub ustawia skrót klawiaturowy do tego RibbonDialogLauncher.
	OfficeImageId	Pobiera lub ustawia obraz do wyświetlenia w tej sprawie RibbonDialogLauncher, aby użyć wbudowanego ikony programu Microsoft Office.
	Parent	Pobiera RibbonGroup obiekt, który to RibbonDialogLauncher jest elementem członkowskim.
	Ribbon	Pobiera OfficeRibbon zastosowania niniejszego RibbonDialogLauncher jest umieszczony.
	ScreenTip	Pobiera lub ustawia tekst porady, który pojawia się, gdy użytkownik przesuwa wskaźnik myszy nad RibbonDialogLauncher.
	SuperTip	Pobiera lub ustawia tekst wielowierszowy porady, który pojawia się, gdy użytkownik przesuwa wskaźnik myszy nad RibbonDialogLauncher.
	Visible	Zwraca lub ustawia wartość, która wskazuje, czy to RibbonDialogLauncher jest widoczny.

Początek

Metody

	Nazwa	Opis
	Dispose	Wykonuje zadania zdefiniowane aplikacji skojarzonej z zwalniania, zwalnianie lub resetowanie niezarządzanych zasobów. (Odziedziczone z IDisposable).
	ResumeLayout	Odwraca efekt SuspendLayout metoda.
	SuspendLayout	Zapobiega odświeżania stanu formantów w aplikacji Microsoft Office OfficeRibbon.

Początek

Uwagi

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

Image, ImageName, I OfficeImageId właściwości nie mają żadnego wpływu widoczne po RibbonDialogLauncher jest wyświetlany w grupie na Wstążce.Jednakże, kiedy użytkownik dodaje RibbonDialogLauncher do paska narzędzi Szybki dostęp, właściwości te kontrolują zachowanie obrazu, który jest wyświetlany.Ponadto Visible właściwości 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) przedmiotu.Aby uzyskać więcej informacji, zobacz Omówienie wstążki.

RibbonDialogLauncher Ma zastosowanie tylko do RibbonGroup.RibbonGroup Obiekt ma DialogLauncher członkiem RibbonDialogLauncher typu.Aby uzyskać informacje o dodawaniu RibbonDialogLauncher do RibbonGroup, zobacz Jak: dodać przycisk otwierający okno dialogowe grupy wstążki.

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żyć tej metody z kodu w klasie wstążki.
Za pomocą Globals.Factory.GetRibbonFactory metoda.Użyj tego podejścia od kodu poza klasy wstążki.

Niektóre właściwości tego formantu można ustawić, tylko w przypadku, zanim wstążki jest ładowany do aplikacji pakietu Office.Aby uzyskać informacje o ustawianiu tych właściwości, zobacz Omówienie modelu obiektu 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 dla pakietu Office, omówienie Runtime.

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 sposób dodawania 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 ikony w dolnym prawym rogu RibbonGroup.

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

Dodać wstążki (Visual Designer) element do projektu programu pakietu Office.
Dodać RibbonDialogLauncher do domyślnej grupy grupa1 jak podkreślono w Jak: dodać przycisk otwierający okno dialogowe grupy wstążki.
Jeśli używasz języka Visual Basic, Dodaj nowy okno dialogowe element do projektu.Jeśli używasz języka C#, Dodaj nowy Windows Form pozycji i przetworzyć ją na okno dialogowe, dodając OK i anulować przyciski do formularza, a także przez tworzenie procedury obsługi zdarzeń dla przycisków kliknij zdarzenia.
Ustaw (nazwa) właściwość okno dialogowe, aby advancedSettingsDialog.Okna dialogowego można dostosować, dodając formanty i ustawiając więcej właściwości.
Dodać DialogLauncherClick program obsługi zdarzeń do kodu.
Się z treścią następującą metodę w DialogLauncherClick programu 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();
}