RibbonBase.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 RibbonBase geladen wird, falls die ImageName-Eigenschaft für mindestens ein Steuerelement festgelegt ist.
public:
event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler Public Custom Event LoadImage As RibbonLoadImageEventHandler Ereignistyp
Beispiele
Im folgenden Beispiel werden die Images für zwei RibbonButton Steuerelemente zwischengespeichert.
Um dieses Codebeispiel auszuführen, müssen Sie zunächst die folgenden Schritte ausführen:
Fügen Sie einem Office-Projekt ein Menüband (Visual Designer) hinzu.
Wenn Sie ein Visual Basic-Projekt verwenden, fügen Sie die folgende Anweisung am Anfang der Menübandcodedatei hinzu:
Imports Microsoft.Office.Tools.Ribbon
Anschließend können Sie diesen Code in der generierten Ribbon-Klasse ausführen.
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;
}
}
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.