OfficeRibbon.LoadImage-Ereignis
Tritt auf, wenn OfficeRibbon geladen wird, falls die ImageName-Eigenschaft für mindestens ein Steuerelement festgelegt ist.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Syntax
'Declaration
Event LoadImage As RibbonLoadImageEventHandler
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.
.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.