RibbonBase.LoadImage-Ereignis

Artikel
08/10/2011

Tritt auf, wenn RibbonBase geladen wird, falls die ImageName-Eigenschaft für mindestens ein Steuerelement festgelegt ist.

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

Syntax

'Declaration
Public Event LoadImage As RibbonLoadImageEventHandler

public event RibbonLoadImageEventHandler LoadImage

Hinweise

Das LoadImage-Ereignis ermöglicht das Zwischenspeichern von Bildern in der Menübandanpassung und dadurch eine verbesserte Leistung.

Standardmäßig wird ein Bild immer dann in das Menüband geladen, wenn der Benutzer eine Registerkarte mit dem Bild anzeigt. Ein Bild wird immer neu geladen, wenn die Eigenschaften eines Steuerelements, auf dem das Bild angezeigt wird, programmgesteuert geändert werden.

Weisen Sie einem Steuerelement mithilfe des LoadImage-Ereignisses ein Bild zu. Wählt der Benutzer auf dem Menüband eine Registerkarte aus, wird von der Microsoft Office-Anwendung das zwischengespeicherte Bild verwendet. Wird eine Steuerelementeigenschaft während der Laufzeit geändert, wird das Bild auf dem Steuerelement von der Microsoft Office-Anwendung nicht neu geladen. Dadurch wird unter Umständen eine leichte Leistungssteigerung erzielt.

Soll das Bild eines Steuerelements zwischengespeichert werden, legen Sie die ImageName-Eigenschaft des Steuerelements fest. Das LoadImage-Ereignis wird nicht ausgelöst, sofern nicht die ImageName-Eigenschaft von mindestens einem Steuerelement festgelegt wird.

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) hinzu.
Fügen Sie bei Verwendung eines Visual Basic-Projekts am Anfang der Menüband-Codedatei die folgende Anweisung hinzu: Imports Microsoft.Office.Tools.Ribbon

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

Private Sub Ribbon1_LoadImage(sender As Object, 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;
    }
}

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

Siehe auch

Referenz

RibbonBase Klasse

Microsoft.Office.Tools.Ribbon-Namespace

Freigeben über