Freigeben über


RibbonComboBox.Image-Eigenschaft

Ruft ein in RibbonComboBox dargestelltes 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
Das in RibbonComboBox angezeigte Bild.

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.

Das empfohlene Bildformat ist PNG, da Bilder im PNG-Format Transparenz durch den Alphakanal unterstützen.

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

Siehe auch

Referenz

RibbonComboBox Schnittstelle

Microsoft.Office.Tools.Ribbon-Namespace

Weitere Ressourcen

Multifunktionsleisten-Objektmodellübersicht