RibbonLoadImageEventArgs-Schnittstelle

Artikel
08/10/2011

Stellt Daten für das LoadImage-Ereignis bereit.

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

Syntax

'Declaration
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs

[GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")]
public interface RibbonLoadImageEventArgs

Der RibbonLoadImageEventArgs-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	Image	Ruft das Bild eines zu ladenden Menüband-Steuerelements ab oder legt es fest.
	ImageName	Ruft den Namen des Bilds ab, das auf dem Menüband geladen wird.

Zum Seitenanfang

Hinweise

Behandeln Sie das LoadImage-Ereignis, falls Sie ein Bild laden möchten, das durch die ImageName-Eigenschaft eines Steuerelements identifiziert wird. Aus Gründen der Leistungssteigerung ruft die Microsoft Office-Anwendung dieses Bild nur einmal von der Projektmappe ab, wenn das Menüband angezeigt wird. Anschließend kann das Steuerelementbild nicht geändert werden.

Um ein Bild für ein Steuerelement hinzuzufügen, fügen Sie dem LoadImage-Ereignishandler Code hinzu. Entspricht die ImageName-Eigenschaft von RibbonLoadImageEventArgs der ImageName-Eigenschaft des Steuerelements, legen Sie die Image-Eigenschaft auf das zu ladende Bild fest.

Beispiele

Im folgenden Beispiel werden die Bilder für zwei RibbonButton-Steuerelemente zwischengespeichert.

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

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;
    }
}

Siehe auch

Referenz

Microsoft.Office.Tools.Ribbon-Namespace

Freigeben über