RibbonDialogLauncher.Image-Eigenschaft
Ruft ein Bild ab bzw. legt ein Bild fest, das in diesem RibbonDialogLauncher angezeigt wird, wenn es der Symbolleiste für den Schnellzugriff hinzugefügt wird.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Syntax
'Declaration
Property Image As Image
Image Image { get; set; }
Eigenschaftswert
Typ: System.Drawing.Image
Ein Bild, das in diesem RibbonDialogLauncher angezeigt wird, wenn es der Symbolleiste für den Schnellzugriff hinzugefügt wird.
Hinweise
Das empfohlene Bildformat ist PNG, da Bilder im PNG-Format Transparenz durch den Alphakanal unterstützen.
Die Image-Eigenschaft hat keinen sichtbaren Effekt, wenn RibbonDialogLauncher in einer Gruppe auf dem Menüband angezeigt wird.Wenn ein Benutzer der Symbolleiste für den Schnellzugriff jedoch einen RibbonDialogLauncher hinzufügt, steuert diese Eigenschaft das Verhalten des angezeigten Bilds.
Mit der Image-Eigenschaft wird ein vom Steuerelement angezeigtes Bild identifiziert.Diese Eigenschaft kann zur Lauf- oder zur Entwicklungszeit festgelegt werden.Wird diese Eigenschaft während der Laufzeit aktualisiert, wird die Darstellung des Steuerelements der Änderung entsprechend aktualisiert.
Wird die Image-Eigenschaft festgelegt, werden die OfficeImageId-Eigenschaft und die ImageName-Eigenschaft ignoriert.Durch die Image-Eigenschaft erhalten Sie zwar mehr Steuerungsmöglichkeiten als mit den anderen beiden Eigenschaften, doch es kann eine Verlangsamung eintreten, da das Bildobjekt bei jeder Aktualisierung des Steuerelements an die Office-Anwendung gesendet wird.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Siehe auch
Referenz
RibbonDialogLauncher Schnittstelle
Microsoft.Office.Tools.Ribbon-Namespace