RibbonDialogLauncher Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein kleines standardisiertes Symbol für eine Gruppe dar, die verwendet werden kann, um ein Dialogfeld zu öffnen.
[System.Runtime.InteropServices.Guid("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable
- Attribute
- Implementiert
Beispiele
Im folgenden Beispiel wird gezeigt, wie ein RibbonDialogLauncher zu einer Menü Bandgruppe hinzugefügt wird und wie ein benutzerdefiniertes Dialogfeld gestartet wird, mit dem Benutzer erweiterte Einstellungen auswählen können, wenn Sie auf das RibbonDialogLauncher Symbol in der unteren rechten Ecke von klicken RibbonGroup .
Zum Ausführen dieses Code Beispiels müssen Sie zunächst die folgenden Schritte ausführen:
Fügen Sie einem Office-Projekt ein Element vom Typ Menüband (visueller Designer) hinzu.
Fügen Sie RibbonDialogLauncher der Standardgruppe ein hinzu,
Group1wie unter Gewusst wie: Hinzufügen eines Dialog Feld-Start Programms zu einer Menü Bandgruppebeschrieben.Wenn Sie Visual Basic verwenden, fügen Sie dem Projekt ein neues Dialog Feld Element hinzu. Wenn Sie c# verwenden, fügen Sie ein neues Windows Form -Element hinzu, und schalten Sie es in einem Dialogfeld ein, indem Sie dem Formular die Schaltflächen OK und Abbrechen hinzufügen, und erstellen Sie Ereignishandler für die Click-Ereignisse der Schaltflächen.
Legen Sie die Eigenschaft (Name) des Dialog Felds auf fest
advancedSettingsDialog. Sie können das Dialogfeld Anpassen, indem Sie Steuerelemente hinzufügen und weitere Eigenschaften festlegen.Fügen Sie dem DialogLauncherClick Code den Ereignishandler hinzu.
Platzieren Sie den Inhalt der folgenden Methode in den- DialogLauncherClick Ereignishandler.
void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
advancedSettingsDialog dlg = new advancedSettingsDialog();
dlg.ShowDialog();
}
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
Hinweise
Ein RibbonDialogLauncher wird standardmäßig in der unteren rechten Ecke einer Gruppe angezeigt.
Die Image ImageName Eigenschaften, und OfficeImageId sind nicht sichtbar, wenn der RibbonDialogLauncher in einer Gruppe auf dem Menüband angezeigt wird. Wenn ein Benutzer jedoch RibbonDialogLauncher der Symbolleiste für den schnell Zugriff hinzugefügt wird, steuern diese Eigenschaften das Verhalten des Bilds, das angezeigt wird. Außerdem wird die- Visible Eigenschaft nicht ausgeblendet, RibbonDialogLauncher Wenn Sie auf der Symbolleiste für den schnell Zugriff angezeigt wird. Der Benutzer kann das der RibbonDialogLauncher Symbolleiste für den schnell Zugriff über das Menüband (XML) -Element hinzufügen. Weitere Informationen finden Sie unter Übersicht über das Menüband.
Das RibbonDialogLauncher gilt nur für RibbonGroup . Das- RibbonGroup Objekt verfügt über einen DialogLauncher Member des- RibbonDialogLauncher Typs. Weitere Informationen zum Hinzufügen eines RibbonDialogLauncher zu einem finden Sie unter Gewusst RibbonGroup wie: Hinzufügen eines Dialog Feld-Start Programms zu einer Menü Bandgruppe.
Sie können einen RibbonDialogLauncher zur Laufzeit erstellen, indem Sie die- CreateRibbonDialogLauncher Methode des-Objekts verwenden RibbonFactory .
Es gibt zwei Möglichkeiten, um auf das RibbonFactory-Objekt zuzugreifen:
Mithilfe der
Factory-Eigenschaft der Ribbon-Klasse. Verwenden Sie diesen Ansatz aus Code in der Ribbon-Klasse.Mithilfe der
Globals.Factory.GetRibbonFactory-Methode. Verwenden Sie diesen Ansatz aus Code außerhalb der Ribbon-Klasse.
Einige Eigenschaften dieses Steuer Elements können nur festgelegt werden, bevor das Menüband in die Office-Anwendung geladen wird. Weitere Informationen zum Festlegen dieser Eigenschaften finden Sie unter Übersicht über das Menüband-Objektmodell.
Hinweis
Diese Schnittstelle wird von der Visual Studio-Tools für Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Visual Studio Tools for Office Runtime Overview.
Verwendung
Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und höher ausgerichtet sind. In Projekten, die auf .NET Framework 3.5 abzielen, verfügt dieser Typ möglicherweise über unterschiedliche Member, und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Eine Dokumentation dieser Art von Projekten, die auf den .NET Framework 3.5 abzielen, erhalten Sie in den folgenden Verweisabschnitten in der Dokumentation zu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.
Eigenschaften
| Enabled |
Ruft einen Wert ab, der angibt, ob das RibbonDialogLauncher aktiviert ist, oder legt einen Wert fest. |
| Image |
Ruft ein Bild ab, das auf diesem RibbonDialogLauncher angezeigt wird, wenn es der Symbolleiste für den Schnellzugriff hinzugefügt wird, oder legt das Bild fest. |
| ImageName |
Ruft einen Bezeichner ab, mit dem ein Bild diesem RibbonDialogLauncher zugeordnet wird, wenn es der Symbolleiste für den Schnellzugriff hinzugefügt wird, oder legt den Bezeichner fest. |
| KeyTip |
Ruft die Tastenkombination für dieses RibbonDialogLauncher ab oder legt sie fest. |
| OfficeImageId |
Ruft das Bild ab, das für das RibbonDialogLauncher angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten, oder legt dieses Bild fest. |
| Parent |
Ruft ein RibbonGroup-Objekt ab, dessen Member RibbonDialogLauncher ist. |
| Ribbon |
Ruft die OfficeRibbon ab, auf der RibbonDialogLauncher platziert ist. |
| ScreenTip |
Ruft Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonDialogLauncher richtet, oder legt diesen fest. |
| SuperTip |
Ruft mehrzeiligen Tipptext ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonDialogLauncher richtet, oder legt diesen fest. |
| Visible |
Ruft einen Wert ab, der angibt, ob das RibbonDialogLauncher sichtbar ist, oder legt den Wert fest. |
Methoden
| ResumeLayout() |
Kehrt den Effekt der SuspendLayout()-Methode um. |
| SuspendLayout() |
Hindert die Microsoft Office-Anwendung am Aktualisieren des Zustands der Steuerelemente auf dem OfficeRibbon. |