RibbonGallery.OfficeImageId-Eigenschaft

Artikel
05/07/2013

Ruft das Bild ab bzw. legt das Bild fest, das auf dem Steuerelement 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

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-Werten, finden Sie die Microsoft Download Center-Seite Office 2010-Add-In: Symbol-Katalog.

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 werden zwei Elementen in einem Steuerelement für Kataloge Microsoft Office-Symbole zugewiesen.

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

Fügen Sie ein Menüband (Visual Designer) zu einem Projekt hinzu, das von den Office-Projektvorlagen in Visual Studio erstellt wird.
Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.
Fügen Sie der Gruppe einen Katalog hinzu.

Private Sub SetGalleryImage()
    Gallery1.OfficeImageId = "PersonaStatusOnline"
    Gallery1.ShowImage = True
End Sub

private void SetGalleryImage()
{
    gallery1.OfficeImageId = "PersonaStatusOnline";
    gallery1.ShowImage = true;
}

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