RibbonDialogLauncher.Image-Eigenschaft (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Ruft ein Bild ab bzw. legt ein Bild fest, das in diesem RibbonDialogLauncher angezeigt 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 Image As Image
'Usage
Dim instance As RibbonDialogLauncher
Dim value As Image

value = instance.Image

instance.Image = value

public Image Image { get; set; }

Eigenschaftenwert

Typ: System.Drawing.Image

Ein Bild, das in diesem RibbonDialogLauncher angezeigt wird, wenn es der Symbolleiste für den Schnellzugriff hinzugefügt wird.

Hinweise

Das empfohlene Bildformat ist PNG, da Bilder im PNG-Format Transparenz durch den Alphakanal unterstützen.

Die Image-Eigenschaft hat keinen sichtbaren Effekt, wenn RibbonDialogLauncher in einer Gruppe auf der Multifunktionsleiste angezeigt wird. Wenn ein Benutzer der Symbolleiste für den Schnellzugriff jedoch einen RibbonDialogLauncher hinzufügt, steuert diese Eigenschaft das Verhalten des angezeigten Bilds.

Mit der Image-Eigenschaft wird ein vom Steuerelement angezeigtes Bild identifiziert. Diese Eigenschaft kann während der Lauf- oder der Entwicklungszeit festgelegt werden. Wird diese Eigenschaft während der Laufzeit aktualisiert, wird die Darstellung des Steuerelements der Änderung entsprechend aktualisiert.

Wird die Image-Eigenschaft festgelegt, werden die OfficeImageId-Eigenschaft und die ImageName-Eigenschaft ignoriert. Durch die Image-Eigenschaft erhalten Sie zwar mehr Steuerungsmöglichkeiten als mit den anderen beiden Eigenschaften, doch es kann eine Verlangsamung eintreten, da das Bildobjekt bei jeder Aktualisierung des Steuerelements an die Office-Anwendung gesendet wird.

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.