RibbonButton.Image-Eigenschaft

Artikel
08/10/2011

Ruft das auf der Schaltfläche 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 auf der Schaltfläche 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.

Beispiele

Im folgenden Beispiel wird die Image-Eigenschaft von zwei Schaltflächen festgelegt. Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:

Fügen Sie ein Menüband (Visual Designer)-Element zu einem Projekt hinzu, in dem Sie die Office-Entwicklungstools in Visual Studio verwenden.
Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.
Fügen Sie der Gruppe zwei Schaltflächen hinzu.
Fügen Sie den Projektressourcen zwei Bilder hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.

Private Sub LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}

.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.