RibbonButton.ImageName-Eigenschaft (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft den Namen ab oder legt den Namen fest, mit dem die Schaltfläche im LoadImage-Ereignishandler identifiziert wird.

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

Syntax

Public Property ImageName As String

Dim instance As RibbonButton
Dim value As String

value = instance.ImageName

instance.ImageName = value

public string ImageName { get; set; }

Eigenschaftenwert

Typ: System.String

Eine Zeichenfolge, die im LoadImage-Ereignishandler zum Kennzeichnen der Schaltfläche verwendet wird.

Hinweise

Diese Eigenschaft kann zur Laufzeit nur unter bestimmten Bedingungen festgelegt werden. Weitere Informationen hierzu finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Informationen zum Festlegen dieser Eigenschaft finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Mit der ImageName-Eigenschaft wird ein vom Steuerelement angezeigtes Bild identifiziert. Die Office-Anwendung ruft dieses Bild zur Leistungssteigerung nur einmal von der Projektmappe ab. Diese Eigenschaft kann nur während der Entwurfszeit festgelegt werden, da das identifizierte Bild während des LoadImage-Ereignisses geladen wird. LoadImage wird nur einmal pro Bildname ausgelöst, wenn die Multifunktionsleiste angezeigt wird. Anschließend kann das Steuerelementbild mithilfe dieser Eigenschaft nicht geändert werden.

Fügen Sie zum Laden des Bilds dem LoadImage-Ereignishandler Code hinzu. Überprüfen Sie die ImageName-Eigenschaft von RibbonLoadImageEventArgs, und legen Sie die Image-Eigenschaft des RibbonLoadImageEventArgs-Objekts auf das zu ladende Bild fest.

Diese Eigenschaft wird bei Festlegen der Image-Eigenschaft bzw. der OfficeImageId-Eigenschaft ignoriert. Durch die ImageName-Eigenschaft identifizierte Bilder können ein wenig schneller als Bilder geladen werden, die durch die Image-Eigenschaft identifiziert werden, da die Office-Anwendung das Bild nur beim ersten Anzeigen der Multifunktionsleiste von der Projektmappe abruft.

Die ShowImage-Eigenschaft muss true sein, damit das Bild vom Steuerelement angezeigt wird. Beim Festlegen der ImageName-Eigenschaft während der Entwurfszeit legt Visual Studio Tools for Office die ShowImage-Eigenschaft automatisch auf true fest. Wird die ImageName-Eigenschaft während der Laufzeit festgelegt, muss die ShowImage-Eigenschaft im Code auf true festgelegt werden.

Beispiele

Im folgenden Beispiel werden die Bilder für zwei Schaltflächen zwischengespeichert.

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 zwei Schaltflächen hinzu.
Fügen Sie den Projektressourcen zwei Bilder hinzu. Weitere Informationen hierzu finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.

Anschließend kann dieser Code in der generierten Multifunktionsleistenklasse ausgeführt werden.

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal e As RibbonLoadImageEventArgs)
    Select Case e.ImageName
        Case "Button1Image"
            e.Image = My.Resources.Image1
        Case "Button2Image"
            e.Image = My.Resources.Image2
    End Select
End Sub

private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)
{
    switch (e.ImageName)
    {
        case "Button1Image":
            e.Image = Properties.Resources.Image1;
            break;
        case "Button2Image":
            e.Image = Properties.Resources.Image2;
            break;
    }
}

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.