Partager via


RibbonToggleButton.Image Property

Definition

Gets or sets the image that is displayed on the control.

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 is displayed on the control.

Remarks

The recommended image format is PNG, because images in the PNG format support transparency through their alpha channel.

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.

The ShowImage property must be true for the control to display the image. When you set the Image property at design time, Visual Studio automatically sets the ShowImage property to true. If you set the Image property at run time, you must set the ShowImage property to true in your code.

Applies to