RibbonLoadImageEventArgs-Klasse (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Stellt Daten für das LoadImage-Ereignis bereit.

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

Syntax

'Declaration
Public NotInheritable Class RibbonLoadImageEventArgs _
    Inherits EventArgs
'Usage
Dim instance As RibbonLoadImageEventArgs

public sealed class RibbonLoadImageEventArgs : EventArgs

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

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

Vererbungshierarchie

System.Object
System.EventArgs
Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventArgs

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

RibbonLoadImageEventArgs-Member

Microsoft.Office.Tools.Ribbon-Namespace

Sdílet prostřednictvím