RibbonDropDownItem.OfficeImageId-Eigenschaft

Artikel
08/10/2011

Ruft das Bild ab bzw. legt das Bild fest, das für RibbonDropDownItem 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
Das Bild, das für RibbonDropDownItem angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.

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.

Beispiele

Im folgenden Beispiel werden zwei Elementen in einem Dropdownfeld 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)-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 ein Dropdownfeld hinzu.

Private Sub PopulateDropDown()
    Dim status1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status1.Label = "Away"
    status1.OfficeImageId = "PersonaStatusAway"
    DropDown1.Items.Add(status1)
    Dim status2 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    status2.Label = "Online"
    status2.OfficeImageId = "PersonaStatusOnline"
    DropDown1.Items.Add(status2)
End Sub

private void PopulateDropDown()
{
    RibbonDropDownItem status1 = this.Factory.CreateRibbonDropDownItem();
    status1.Label = "Away";
    status1.OfficeImageId = "PersonaStatusAway";
    dropDown1.Items.Add(status1);
    RibbonDropDownItem status2 = this.Factory.CreateRibbonDropDownItem();
    status2.Label = "Online";
    status2.OfficeImageId = "PersonaStatusOnline";
    dropDown1.Items.Add(status2);
}

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