RibbonBase.LoadImage-Ereignis
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.