RibbonDialogLauncher – rozhraní

Článek
08/11/2011

Představuje standardizovaný malou ikonu skupiny, která může být použita otevřený dialogové okno.

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 tento RibbonDialogLauncher povolena.
	Image	Získá nebo nastaví bitová kopie zobrazený na tomto RibbonDialogLauncher Po přidání na panel nástrojů Rychlý přístup.
	ImageName	Získá nebo nastaví identifikátor , který je použita k přiřadit bitová kopie tohoto RibbonDialogLauncher Po přidání na panel nástrojů Rychlý přístup.
	KeyTip	Získá nebo nastaví tuto klávesovou zkratku RibbonDialogLauncher.
	OfficeImageId	Získá nebo nastaví bitová kopie zobrazit v tomto RibbonDialogLauncher, pokud chcete používat s vestavěnou systém Microsoft Office ikonu.
	Parent	Získává RibbonGroupkteréobjekt RibbonDialogLauncher je člen.
	Ribbon	Získává OfficeRibbon na které RibbonDialogLauncher umístěna.
	ScreenTip	Získá nebo nastaví text tipu, 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 tento RibbonDialogLauncher je viditelný.

Na začátek

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 obrátí SuspendLayout metody.
	SuspendLayout	Zabrání aktualizaci stavu ovládací prvkyaplikace sady systém Microsoft Office OfficeRibbon.

Na začátek

Poznámky

A RibbonDialogLauncher se zobrazí v pravém dolním rohu skupiny ve výchozím nastavení.

Image, ImageName, A OfficeImageId Vlastnosti nemají žádný viditelný efekt při RibbonDialogLauncher je zobrazen ve skupině na Pás karet. Však když uživatel přidá RibbonDialogLauncher na panel nástrojů Rychlý přístup těchto vlastností řízení chování bitová kopie zobrazený. Také Visiblenemávlastnost skrýt RibbonDialogLauncher Při zobrazení na panelu nástrojů Rychlý přístup. uživatel může přidat RibbonDialogLauncher na panel nástrojů Rychlý přístup prostřednictvím **Pás karet (jazyk XML)**položka. Další informace naleznete v tématu Ribbon Overview.

RibbonDialogLauncher Se týká pouze RibbonGroup. RibbonGroupobjekt DialogLauncher člena RibbonDialogLauncher typu. Informace o přidání RibbonDialogLauncher na RibbonGroup, viz How to: Add a Dialog Box Launcher to a Ribbon Group.

Můžete vytvořit RibbonDialogLauncher za běhu pomocí CreateRibbonDialogLauncher metodu RibbonFactory objektu.

Existují dva způsoby přístupu RibbonFactory objekt:

Pomocí Factoryvlastnosttřída Pás karet. Použít tento přístup z Pás karet třídav kódu.
Pomocí Globals.Factory.GetRibbonFactory metoda. Použít tento přístup z kódu mimotřída Pás karet.

Některé vlastnosti tohoto ovládacího prvku lze nastavit pouze před načtením Pás karet do aplikacesady Office. Informace o nastavení těchto vlastností v Ribbon Object Model Overview.

Poznámka

Toto rozhraní je implementováno modulem runtime nástrojů Visual Studio Tools for Office. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Visual Studio Tools for Office Runtime Overview.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených na rozhraní .NET Framework 4. V projektech cílených na rozhraní .NET Framework 3.5 může mít tento typ rozdílné členy a příklady kódů pro tento typ nemusí 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 skupiny Pás karet a jak spuštění vlastní dialogové okno umožňující uživatelům zvolit upřesňující nastavení, klepnete na RibbonDialogLauncher ikony v pravém dolním rohu RibbonGroup.

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

Přidat Pás karet (vizuální Návrhář) položka Office projekt.
Přidat RibbonDialogLauncher do výchozí skupiny skupina1 podle How to: Add a Dialog Box Launcher to a Ribbon Group.
Pokud pomocí jazyka Visual Basic, přidejte nový Dialog položka projekt. Používáte C#, přidat nový Formuláře systému Windows položka a převést jej do dialogové okno přidáním OK a Storno tlačítka na formulář a vytvoření událost rutiny na tlačítka Klepněte na položku události.
Nastavit (Název) vlastnost dialogovém okně advancedSettingsDialog. Dialogové okno můžete přizpůsobit přidáním nastavení ovládacích prvků a další vlastnosti.
Přidat obslužné rutinyudálostDialogLauncherClickkódu.
Umístit obsah do následující metoda DialogLauncherClickobslužnou rutinuudálost .

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