RibbonBase.LoadImage Ereignis

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Ribbon

Assembly:: Microsoft.Office.Tools.Common.v4.0.Utilities.dll

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

RibbonLoadImageEventHandler

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.

Gilt für:

Freigeben über