RibbonDialogLauncher.ImageName-Eigenschaft (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Ruft einen Bezeichner ab bzw. legt einen Bezeichner fest, mit dem ein Bild diesem RibbonDialogLauncher zugeordnet wird, wenn es der Symbolleiste für den Schnellzugriff hinzugefügt wird.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

'Declaration
Public Property ImageName As String
'Usage
Dim instance As RibbonDialogLauncher
Dim value As String

value = instance.ImageName

instance.ImageName = value

public string ImageName { get; set; }

Eigenschaftenwert

Typ: System.String

Ein Bezeichner, mit dem diesem RibbonDialogLauncher ein Bild zugewiesen wird, wenn es der Symbolleiste für den Schnellzugriff hinzugefügt wird.

Hinweise

Diese Eigenschaft kann nur unter bestimmten Bedingungen zur Laufzeit festgelegt werden. Weitere Informationen hierzu finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Die ImageName-Eigenschaft hat keinen sichtbaren Effekt, wenn RibbonDialogLauncher in einer Gruppe auf der Multifunktionsleiste angezeigt wird. Fügt ein Benutzer der Symbolleiste für den Schnellzugriff jedoch ein RibbonDialogLauncher hinzu, steuert diese Eigenschaft das Verhalten des angezeigten Bilds, sofern die Image-Eigenschaft oder die OfficeImageId-Eigenschaft nicht ebenfalls festgelegt ist.

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 während der Entwurfszeit festgelegt werden, da das identifizierte Bild während des LoadImage-Ereignisses geladen wird. LoadImage wird nur einmal pro Bildname ausgelöst, wenn die Multifunktionsleiste 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 der Multifunktionsleiste von der Projektmappe abruft.

Berechtigungen

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.