RibbonSplitButton.ImageName-Eigenschaft
Ruft den Namen ab oder legt den Namen fest, den Sie im E:Microsoft.Office.Tools.Ribbon.LoadImage-Ereignishandler zum Identifizieren eines Bilds für das Steuerelement verwenden können.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Syntax
'Declaration
Property ImageName As String
string ImageName { get; set; }
Eigenschaftswert
Typ: System.String
Eine Zeichenfolge, die im E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage-Ereignishandler zum Identifizieren eines Bilds für das Steuerelement verwendet werden kann.
Hinweise
Mit der ImageName-Eigenschaft wird ein vom Steuerelement angezeigtes Bild identifiziert.Die Office-Anwendung ruft dieses Bild zur Leistungssteigerung nur einmal von der Projektmappe ab.Diese Eigenschaft kann nur zur Entwurfszeit festgelegt werden, da das Bild, das sie identifiziert, während des LoadImage-Ereignisses geladen wird.LoadImage wird nur einmal pro Bildname ausgelöst, wenn das Menüband angezeigt wird.Anschließend kann das Steuerelementbild mithilfe dieser Eigenschaft nicht geändert werden.
Fügen Sie zum Laden des Bilds dem LoadImage-Ereignishandler Code hinzu.Überprüfen Sie die ImageName-Eigenschaft von RibbonLoadImageEventArgs, und legen Sie die Image-Eigenschaft des RibbonLoadImageEventArgs-Objekts auf das zu ladende Bild fest.
Diese Eigenschaft wird bei Festlegen der Image-Eigenschaft bzw. der OfficeImageId-Eigenschaft ignoriert.Durch die ImageName-Eigenschaft identifizierte Bilder können ein wenig schneller als Bilder geladen werden, die durch die Image-Eigenschaft identifiziert werden, da die Office-Anwendung das Bild nur beim ersten Anzeigen des Menübands von der Projektmappe abruft.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Siehe auch
Referenz
RibbonSplitButton Schnittstelle
Microsoft.Office.Tools.Ribbon-Namespace