RibbonMenu.OfficeImageId-Eigenschaft
Ruft das Bild ab bzw. legt das Bild fest, das im Menü 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 Menü 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 einem Menü ein Microsoft Office-Symbol zugewiesen.
Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:
Fügen Sie einem Office-Projekt ein Menüband (Visual Designer)-Element hinzu.
Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.
Fügen Sie der Gruppe ein Menü hinzu.
Legen Sie die Dynamic-Eigenschaft des Menüs auf true fest.
Private Sub SetMenuImage()
Menu1.OfficeImageId = "HighImportance"
Menu1.ShowImage = True
End Sub
private void SetMenuImage()
{
menu1.OfficeImageId = "HighImportance";
menu1.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.