Freigeben über


OfficeRibbon.LoadImage Ereignis

Definition

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

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;
event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;
member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler 
Event LoadImage As RibbonLoadImageEventHandler 

Ereignistyp

Hinweise

Das LoadImage Ereignis ermöglicht es Ihnen, Bilder in der Menübandanpassung zwischenzuspeichern, wodurch die Leistung verbessert werden kann.

Standardmäßig wird jedes Mal, wenn der Benutzer eine Registerkarte mit dem Bild anzeigt, ein Bild in das Menüband geladen. Ein Bild wird jedes Mal neu geladen, wenn Sie programmgesteuert die Eigenschaften eines Steuerelements ändern, in dem das Bild angezeigt wird.

Verwenden Sie das LoadImage -Ereignis, um einem Steuerelement ein Bild zuzuweisen. Wenn der Benutzer eine Registerkarte im Menüband auswählt, verwendet die Microsoft Office-Anwendung das zwischengespeicherte Bild. Wenn Sie eine Steuerelementeigenschaft zur Laufzeit ändern, lädt die Microsoft Office-Anwendung das Image nicht auf das Steuerelement neu. Dies kann Ihnen einen kleinen Leistungsgewinn verschaffen.

Wenn Sie das Image eines Steuerelements zwischenspeichern möchten, legen Sie die ImageName-Eigenschaft des Steuerelements fest. Das LoadImage Ereignis wird nur ausgelöst, wenn Sie die ImageName-Eigenschaft von mindestens einem Steuerelement festlegen.

Gilt für: