RibbonMenu.OfficeImageId 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 Bild ab, oder legt das Bild fest, das im Menü angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.
public string OfficeImageId { get; set; }
Eigenschaftswert
Die ID eines integrierten Microsoft Office-Symbols, das als Symbol für dieses Menü dient.
Beispiele
Im folgenden Beispiel wird ein Microsoft Office Symbol einem Menü zugewiesen.
Zum Ausführen dieses Code Beispiels müssen Sie zunächst die folgenden Schritte ausführen:
Fügen Sie einem Office-Projekt ein Element vom Typ Menüband (visueller Designer) hinzu.
Fügen Sie der Registerkarte Benutzer definiert eine Gruppe hinzu.
Fügen Sie der Gruppe ein Menü hinzu.
Legen Sie die dynamische -Eigenschaft des Menüs auf fest
true.
private void SetMenuImage()
{
menu1.OfficeImageId = "HighImportance";
menu1.ShowImage = true;
}
Private Sub SetMenuImage()
Menu1.OfficeImageId = "HighImportance"
Menu1.ShowImage = True
End Sub
Hinweise
Die- OfficeImageId Eigenschaft identifiziert ein Office-Symbol, das vom-Steuerelement angezeigt wird. Der Eigenschafts Wert ist eine Zeichenfolge, die den imageMso Wert des ausgewählten Symbols angibt. 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.
Eine Liste der imageMso Werte finden Sie auf der Microsoft Download Center-Seite Office 2010 Add-in: Symbol Gallery.
Diese Eigenschaft wird ignoriert, wenn die- Image Eigenschaft festgelegt ist. Bilder, die durch die- OfficeImageId Eigenschaft identifiziert werden, können etwas schneller geladen werden als Bilder, die durch die-Eigenschaft identifiziert werden Image , da Sie in der Office-Anwendung zwischengespeichert werden
Die- ShowImage Eigenschaft muss sein true , damit das-Steuerelement das Bild anzeigt. Wenn Sie die- OfficeImageId Eigenschaft zur Entwurfszeit festlegen, wird die-Eigenschaft von Visual Studio automatisch auf festgelegt ShowImage true . Wenn Sie die- OfficeImageId Eigenschaft zur Laufzeit festlegen, müssen Sie die- ShowImage Eigenschaft true im Code auf festlegen.