RibbonEditBox.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, mit dem die Schaltfläche im LoadImage-Ereignishandler identifiziert wird, oder legt ihn fest.
public string ImageName { get; set; }
Eigenschaftswert
Eine Zeichenfolge, die im LoadImage-Ereignishandler zum Identifizieren des Bilds verwendet wird.
Hinweise
Diese Eigenschaft kann nur unter bestimmten Bedingungen zur Laufzeit festgelegt werden. Weitere Informationen finden Sie unter Übersicht über das Menüband-Objektmodell.
Die- ImageName Eigenschaft identifiziert ein Bild, das vom-Steuerelement angezeigt wird. Die Office-Anwendung ruft dieses Image nur einmal aus der Lösung ab, um die Leistung zu verbessern. Diese Eigenschaft kann nur zur Entwurfszeit festgelegt werden, da das Bild, das Sie identifiziert, während des Ereignisses geladen wird LoadImage . LoadImagewird nur einmal pro Bildname ausgelöst, wenn das Menüband angezeigt wird. Danach kann das Steuerelement Bild nicht mehr mit dieser Eigenschaft geändert werden.
Fügen Sie dem-Ereignishandler Code hinzu, um das Bild zu laden LoadImage . Überprüfen Sie die ImageName -Eigenschaft der, 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. Bilder, die durch die- ImageName Eigenschaft identifiziert werden, können etwas schneller geladen werden als Bilder, die durch die-Eigenschaft identifiziert werden Image , da die Office-Anwendung das Bild nur bei der ersten Anzeige der Multifunktionsleiste aus der Projekt Mappe abruft.
Die- ShowImage Eigenschaft muss sein true , damit das-Steuerelement das Bild anzeigt. Wenn Sie die- ImageName Eigenschaft zur Entwurfszeit festlegen, wird die-Eigenschaft von Visual Studio automatisch auf festgelegt ShowImage true . Wenn Sie die- ImageName Eigenschaft zur Laufzeit festlegen, müssen Sie die- ShowImage Eigenschaft true im Code auf festlegen.