OfficeRibbon.LoadImage Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.