Freigeben über


RibbonButton.OfficeImageId-Eigenschaft

Ruft das Bild ab bzw. legt das Bild fest, das auf der Schaltfläche angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.

Namespace:  Microsoft.Office.Tools.Ribbon
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

'Declaration
Property OfficeImageId As String
    Get
    Set
string OfficeImageId { get; set; }

Eigenschaftswert

Typ: System.String
Die ID eines integrierten Microsoft Office-Symbols, das als Symbol für dieses Steuerelement dient.

Hinweise

Mit der OfficeImageId-Eigenschaft wird ein vom Steuerelement angezeigtes Office-Symbol identifiziert. Der Eigenschaftswert ist eine Zeichenfolge, mit der der imageMso-Wert des ausgewählten Symbols identifiziert wird. 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.

Eine Liste der imageMso-Werte finden Sie auf folgender Seite im Microsoft Download Center: 2007 Office System Add-In: Icons Gallery.

Diese Eigenschaft wird ignoriert, wenn die Image-Eigenschaft festgelegt wurde. Durch die OfficeImageId-Eigenschaft identifizierte Bilder können ein wenig schneller als durch die Image-Eigenschaft identifizierte Bilder geladen werden, da die Bilder in der Office-Anwendung zwischengespeichert werden.

Die ShowImage-Eigenschaft muss true sein, damit das Bild vom Steuerelement angezeigt wird. Wenn Sie die OfficeImageId-Eigenschaft zur Entwurfszeit festlegen, legt Visual Studio die ShowImage-Eigenschaft automatisch auf true fest. Wird die OfficeImageId-Eigenschaft während der Laufzeit festgelegt, muss die ShowImage-Eigenschaft im Code auf true festgelegt werden.

Beispiele

Im folgenden Beispiel wird einer Schaltfläche ein Microsoft Office-Symbol zugeordnet.

Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:

  1. Fügen Sie ein Menüband (Visual Designer)-Element zu einem Projekt hinzu, in dem Sie die Office-Entwicklungstools in Visual Studio verwenden.

  2. Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.

  3. Fügen Sie der Gruppe eine Schaltfläche hinzu.

  4. Legen Sie die (Name)-Eigenschaft der Schaltfläche auf mySaveButton fest.

Private Sub SetButtonImage()
    mySaveButton.OfficeImageId = "FileSave"
    mySaveButton.ShowImage = True
End Sub
private void SetButtonImage()
{
    mySaveButton.OfficeImageId = "FileSave";
    mySaveButton.ShowImage = true;
}

.NET Framework-Sicherheit

Siehe auch

Referenz

RibbonButton Schnittstelle

Microsoft.Office.Tools.Ribbon-Namespace

Weitere Ressourcen

Multifunktionsleisten-Objektmodellübersicht