RibbonGallery.Image Eigenschaft
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.
Ruft das auf der Schaltfläche angezeigte Bild ab oder legt dieses fest.
public System.Drawing.Image Image { get; set; }
Eigenschaftswert
Ein Image, das auf der Schaltfläche angezeigt wird.
Hinweise
Das empfohlene Bildformat ist PNG, da Bilder im PNG-Format Transparenz über Ihren Alphakanal unterstützen.
Die- Image Eigenschaft identifiziert ein Bild, das vom-Steuerelement angezeigt wird. Diese Eigenschaft kann zur Entwurfszeit oder zur Laufzeit festgelegt werden. Wenn Sie diese Eigenschaft zur Laufzeit aktualisieren, wird die Darstellung des Steuer Elements aktualisiert, um die Änderung widerzuspiegeln.
Wenn die Image -Eigenschaft festgelegt ist, OfficeImageId werden die-Eigenschaft und die-Eigenschaft ImageName ignoriert. Obwohl die- Image Eigenschaft Ihnen mehr Kontrolle bietet als die anderen beiden Eigenschaften, kann Sie langsamer sein, da das Image-Objekt bei jeder Aktualisierung des Steuer Elements an die Office-Anwendung gesendet wird.
Die- ShowImage Eigenschaft muss sein true , damit das-Steuerelement das Bild anzeigt. Wenn Sie die- Image Eigenschaft zur Entwurfszeit festlegen, wird die-Eigenschaft von Visual Studio automatisch auf festgelegt ShowImage true . Wenn Sie die- Image Eigenschaft zur Laufzeit festlegen, müssen Sie die- ShowImage Eigenschaft true im Code auf festlegen.