Version

ButtonMode Enumeration

Enumerates possible values for the WebHtmlEditor.ButtonMode property.
Syntax
'Declaration
 
Public Enum ButtonMode 
   Inherits System.Enum
public enum ButtonMode : System.Enum 
Members
MemberDescription
HTMLHTML buttons (input type='button') will be used to represent toolbar buttons.
ImageSingle images will be used to represent buttons. Mouse-effects will be applied by changing the style of the image using DHTML.
ThreeStateImageThree images will be used to represent each button ("off", "over", and "down").
TwoStateImageTwo images will be used to represent each button ("off" and "down").
Remarks

By default the WebHtmlEditor.ButtonMode property of the WebHtmlEditor 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 WebHtmlEditor.ButtonMode 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 toolbr 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