Version

ButtonMode Property

Gets or sets ButtonMode value specifying the current mode of the toolbar buttons.
Syntax
'Declaration
 
Public Property ButtonMode As ButtonMode
public ButtonMode ButtonMode {get; set;}

Property Value

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 WebHtmlEditor.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

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also