RibbonMenu.Image-Eigenschaft (2007 System)
Aktualisiert: November 2007
Ruft das im Menü angezeigte Bild ab oder legt dieses fest.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Syntax
Public Property Image As Image
Dim instance As RibbonMenu
Dim value As Image
value = instance.Image
instance.Image = value
public Image Image { get; set; }
Eigenschaftenwert
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. Beim Festlegen der Image-Eigenschaft während der Entwurfszeit legt Visual Studio Tools for Office 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.
Berechtigungen
- 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.