ButtonMode Property

Gets or sets ButtonMode value specifying the current mode of the toolbar buttons.

[Visual Basic]
<DefaultValueAttribute()>
<DescriptionAttribute("Controls the how buttons are represented, Either images or HTML buttons")>
<CategoryAttribute("Appearance")>
Public Property ButtonMode As ButtonMode

[C#]
[DefaultValueAttribute()]
[DescriptionAttribute("Controls the how buttons are represented, Either images or HTML buttons")]
[CategoryAttribute("Appearance")]
public ButtonMode ButtonMode {get; set;}

[C++]
[DefaultValueAttribute()]
[DescriptionAttribute("Controls the how buttons are represented, Either images or HTML buttons")]
[CategoryAttribute("Appearance")]
public: __property ButtonMode get_ButtonMode();
public: __property void set_ButtonMode( 
   ButtonMode value
);

[C++/CLI]
[DefaultValueAttribute()]
[DescriptionAttribute("Controls the how buttons are represented, Either images or HTML buttons")]
[CategoryAttribute("Appearance")]
public:
property ButtonMode ButtonMode {
   ButtonMode get();
   void set (ButtonMode value);
}

Return Type

A ButtonMode value specifying the current mode of the toolbar buttons. The default value is ButtonMode.Image.

Remarks

By default this property is ButtonMode.Image, which specifies that a single image will represent each button and mouse-effects will be applied using DHTML (see the HtmlBox.ButtonStyle property for more information on this). If you would like to use such highly-graphical button representations such as mouse-over image swaps set this property to either ButtonMode.TwoStateImage (which specifies that there will be two images for each button, an "off" image and a "clicked" image) or ButtonMode.ThreeStateImage (which specifies that there will be three images for each button, an "off", an "over", and a "click" image). One of these two types will typically be used in skin implementations (see Using Skins) for more information. If you would like to remove images from the toolbar buttons altogether, set this property to ButtonMode.HTML and HTML input buttons will be used to represent the toolbar buttons.

Some image-name related properties will not have meaning depending on the button mode. For example:

ButtonMode.HTML

• ImageName property - not used
• MouseDownImageName property - not used
• MouseOverImageName property - not used

ButtonMode.Image

• ImageName property - represents the image used for the button (ex. "bold.gif")
• MouseDownImageName property - not used
• MouseOverImageName property - not used

ButtonMode.TwoStateImage

• ImageName property - represents the image used for the button (ex. "bold.gif")
• MouseDownImageName property - represents the image used for the button when it is clicked (ex. "bold_down.gif")
• MouseOverImageName property - not used

ButtonMode.TwoStateImage

• ImageName property - represents the image used for the button (ex. "bold.gif")
• MouseDownImageName property - represents the image used for the button when it is clicked (ex. "bold_down.gif")
• MouseOverImageName property - represents the image used for the button when the mouse is over the button (ex. "bold_over.gif")

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP, Windows Server 2003, Windows Vista

See Also

HtmlBox Class  | HtmlBox Members