RibbonSplitButton.ImageName Eigenschaft
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.
Ruft den Namen ab, den Sie im E:Microsoft.Office.Tools.Ribbon.LoadImage-Ereignishandler zum Identifizieren eines Images für das Steuerelement verwenden können, oder legt ihn fest.
public:
property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };public string ImageName { get; set; }member this.ImageName : string with get, setPublic Property ImageName As StringEigenschaftswert
Eine Zeichenfolge, die Sie im E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage-Ereignishandler verwenden können, um ein Image für das Steuerelement zu identifizieren.
Hinweise
Die ImageName -Eigenschaft identifiziert ein Bild, das vom -Steuerelement angezeigt wird. Die Office-Anwendung ruft dieses Image nur einmal aus Ihrer Lösung ab, um die Leistung zu verbessern. Diese Eigenschaft kann nur zur Entwurfszeit festgelegt werden, da das identifizierte Bild während des Ereignisses LoadImage geladen wird. LoadImage wird nur einmal pro Bildnamen ausgelöst, wenn das Menüband angezeigt wird. Danach kann das Steuerelementbild mit dieser Eigenschaft nicht mehr geändert werden.
Um das Image zu laden, fügen Sie dem LoadImage Ereignishandler Code hinzu. Überprüfen Sie die ImageName -Eigenschaft von, RibbonLoadImageEventArgs und legen Sie die Image -Eigenschaft des RibbonLoadImageEventArgs -Objekts auf das Bild fest, das Sie laden möchten.
Diese Eigenschaft wird ignoriert, wenn entweder die Image -Eigenschaft oder die OfficeImageId -Eigenschaft festgelegt ist. Durch die ImageName -Eigenschaft identifizierte Bilder können etwas schneller geladen werden als Bilder, die von der Image -Eigenschaft identifiziert werden, da die Office-Anwendung das Bild nur bei der ersten Anzeige des Menübands aus Ihrer Lösung abruft.