RibbonToggleButton.OfficeImageId-Eigenschaft (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Ruft das Bild ab bzw. legt das Bild fest, das für RibbonToggleButton angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.

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

Syntax

'Declaration
Public Property OfficeImageId As String
'Usage
Dim instance As RibbonToggleButton
Dim value As String

value = instance.OfficeImageId

instance.OfficeImageId = value

public string OfficeImageId { get; set; }

Eigenschaftenwert

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 Eigenschaftenwert 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. Beim Festlegen der Image-Eigenschaft während der Entwurfszeit legt Visual Studio Tools for Office die ShowImage-Eigenschaft automatisch auf true fest. Wird die Image-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 Visual Studio Tools for Office-Projekt ein Element von Multifunktionsleiste (Visual Designer) hinzu.
Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.
Fügen Sie der Gruppe eine Umschaltfläche hinzu.

Private Sub SetToggleButtonImage()
    ToggleButton1.OfficeImageId = "PersonaStatusOnline"
    ToggleButton1.ShowImage = True
End Sub

private void SetToggleButtonImage()
{
    toggleButton1.OfficeImageId = "PersonaStatusOnline";
    toggleButton1.ShowImage = true;
}

Berechtigungen

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.