RibbonMenu.Image-Eigenschaft
Ruft das im Menü angezeigte Bild ab oder legt dieses fest.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Syntax
'Declaration
Property Image As Image
Get
Set
Image Image { get; set; }
Eigenschaftswert
Typ: System.Drawing.Image
Ein im Menü angezeigtes Image.
Hinweise
Das empfohlene Bildformat ist PNG, da Bilder im PNG-Format Transparenz durch den Alphakanal unterstützen.
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.
Die ShowImage-Eigenschaft muss true sein, damit das Bild vom Steuerelement angezeigt wird. Wenn Sie die Image-Eigenschaft zur Entwurfszeit festlegen, legt Visual Studio die ShowImage-Eigenschaft automatisch auf true fest. Wird die Image-Eigenschaft während der Laufzeit festgelegt, muss die ShowImage-Eigenschaft im Code auf true festgelegt werden.
.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.