RibbonDialogLauncher.Image Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets an image that appears on this RibbonDialogLauncher when it is added to the Quick Access Toolbar.
public:
property System::Drawing::Image ^ Image { System::Drawing::Image ^ get(); void set(System::Drawing::Image ^ value); };
public System.Drawing.Image Image { get; set; }
member this.Image : System.Drawing.Image with get, set
Public Property Image As Image
Property Value
An image that appears on this RibbonDialogLauncher when it is added to the Quick Access Toolbar.
Remarks
The recommended image format is PNG, because images in the PNG format support transparency through their alpha channel.
The Image property has no visible effect when the RibbonDialogLauncher is displayed in a group on the Ribbon. However, when a user adds a RibbonDialogLauncher to the Quick Access Toolbar, this property controls the behavior of the image that is shown.
The Image property identifies an image that is displayed by the control. This property can be set at design time or at run time. If you update this property at run time, the control's appearance is updated to reflect the change.
If the Image property is set, the OfficeImageId and ImageName properties are ignored. Although the Image property gives you more control than the other two properties do, it can be slower because the image object is sent to the Office application every time the control is updated.