RibbonDialogLauncher – rozhraní

Článek
05/14/2013

Představuje malou ikonu standardizované skupině, která slouží k otevření dialogového okna.

Obor názvů: Microsoft.Office.Tools.Ribbon
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

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

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

Typ RibbonDialogLauncher zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Enabled	Získá nebo nastaví hodnotu, která označuje, zda to RibbonDialogLauncher je povoleno.
	Image	Získá nebo nastaví obrázek, který se zobrazí v tomto RibbonDialogLauncher kdy je přidán na panel nástrojů Rychlý přístup.
	ImageName	Získá nebo nastaví identifikátor, který se používá k přiřazení obrázku k tomuto RibbonDialogLauncher kdy je přidán na panel nástrojů Rychlý přístup.
	KeyTip	Získá nebo nastaví klávesová zkratka pro tuto RibbonDialogLauncher.
	OfficeImageId	Získá nebo nastaví obrázek zobrazit v tomto RibbonDialogLauncher, chcete-li použít integrovanou ikonu Microsoft Office.
	Parent	Získá RibbonGroup objekt, který této RibbonDialogLauncher je členem.
	Ribbon	Získá OfficeRibbon na niž RibbonDialogLauncher je umístěn.
	ScreenTip	Získá nebo nastaví text popisu, který se zobrazí, když uživatel přesune ukazatel RibbonDialogLauncher.
	SuperTip	Získá nebo nastaví text víceřádkové tip, který se zobrazí, když uživatel přesune ukazatel RibbonDialogLauncher.
	Visible	Získá nebo nastaví hodnotu, která označuje, zda to RibbonDialogLauncher je zobrazen.

Nahoru

Metody

	Název	Popis
	Dispose	Provádí úkoly definované aplikací spojených s uvolněním, uvolnění nebo obnovení nespravované prostředky. (Zděděno z IDisposable.)
	ResumeLayout	Účinek se obrátí SuspendLayout metoda.
	SuspendLayout	Zabrání aplikaci Microsoft Office, který brání v aktualizaci stavu ovládacích prvků v OfficeRibbon.

Nahoru

Poznámky

A RibbonDialogLauncher je ve výchozím nastavení zobrazena v pravém dolním rohu skupiny.

Image, ImageName, A OfficeImageId vlastnosti mají žádný viditelný efekt při RibbonDialogLauncher se zobrazí ve skupině na pásu karet.Pokud uživatel však přidá RibbonDialogLauncher na panel nástrojů Rychlý přístup tyto vlastnosti ovládacího prvku chování obraz, který je zobrazen.Navíc Visible vlastnost neskryje RibbonDialogLauncher Pokud je zobrazen na panelu nástrojů Rychlý přístup.Uživatel může přidávat RibbonDialogLauncher na panel nástrojů Rychlý přístup prostřednictvím Pásu karet (XML) zboží.Další informace naleznete v tématu Přehled pásu karet.

RibbonDialogLauncher Se týká pouze RibbonGroup.RibbonGroup Objekt má DialogLauncher člen RibbonDialogLauncher typu.Informace o tom, jak přidat RibbonDialogLauncher k RibbonGroup, viz Jak: přidání do skupiny pásu Spouštěč dialogového okna.

Můžete vytvořit RibbonDialogLauncher v době běhu pomocí CreateRibbonDialogLauncher metoda RibbonFactory objektu.

Existují dva způsoby, jak získat přístup RibbonFactory objekt:

Při použití Factory vlastnost třídy pásu karet.Použijte tento přístup z kódu ve vaší třídě pásu karet.
Při použití Globals.Factory.GetRibbonFactory metoda.Použijte tento přístup z kódu mimo danou třídu pásu karet.

Některé vlastnosti tohoto ovládacího prvku lze nastavit pouze před pásu karet je načten do aplikace sady Office.Informace o nastavení těchto vlastností naleznete v tématu Přehled modelu objektu 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 naleznete v tématu Visual Studio Tools pro přehled Runtime sady Office.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených pro rozhraní .NET Framework 4 a .NET Framework 4.5. 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 cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k aplikaci Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

Následující příklad ukazuje, jak přidat RibbonDialogLauncher skupina pásu karet a jak spustit vlastní dialogové okno, které umožňuje uživatelům zvolit upřesňujících nastavení po klepnutí na RibbonDialogLauncher ikonu v pravém dolním rohu RibbonGroup.

Chcete-li spustit příklad kódu, musí nejprve provést následující kroky:

Přidat pásu karet (vizuální návrhář) položky pro aplikaci Office project.
Přidat RibbonDialogLauncher do výchozí skupiny skupina1 jak je uvedeno v Jak: přidání do skupiny pásu Spouštěč dialogového okna.
Pokud používáte Visual Basic, přidejte nový dialogové okno položky k projektu.Pokud používáte jazyk C#, přidejte nový Formulář pro systém Windows zboží a převést jej do dialogu s přidáním OK a zrušení tlačítka do formuláře a vytvořením obslužné rutiny událostí pro události kliknutí na tlačítka.
Nastavit (název) vlastnost dialogové okno k advancedSettingsDialog.Dialogovém okně můžete upravit přidáním ovládacích prvků a nastavovat další vlastnosti.
Přidat DialogLauncherClick obslužné rutiny události do vašeho kódu.
Umístit obsah následující metody do DialogLauncherClick obslužnou rutinu události.

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();
}