Version

Toolbar Property (WebHtmlEditor)

Gets an HtmlBoxToolbar control representing the toolbar.
Syntax
'Declaration
 
Public ReadOnly Property Toolbar As Toolbar
public Toolbar Toolbar {get;}

Property Value

An HtmlBoxToolbar control representing the toolbar.
Remarks

The Toolbar contains/manages all toolbar items. Only classes that derive from BaseToolbarItem can be placed on the toolbar. The following list describes each class that derives from BaseToolbarItem:

ToolbarButton - Represents a standard formatting button.ToolbarDialogButton - Represents a button which launches a dialog.ToolbarUploadButton - Represents a button which launches a file upload dialog.ToolbarMenuButton - Represents a button which launches a menu.ToolbarImage - Represents an image on the toolbar.ToolbarText - Represents text on the toolbar.

The HtmlBoxToolbar.Items property exposes the ToolbarItemCollection which contains/manages all toolbar items. Use the WebHtmlEditor.AddToolbarItem method as a shortcut method to easily add a new toolbar item. The ToolbarItemCollection.Clear method of the ToolbarItemCollection and the WebHtmlEditor.Clear method of the WebHtmlEditor both clear this collection.

Example
Examples to add new items to existing drop-down lists, to create a predefined toolbar button (or drop-down list) with custom actions, to create a custom toolbar button with custom action.

'--------------------
' Note: custom buttons with all their properties can be created within aspx.
' That would reduce size of hidden viewstate field and improve persistance of properties.
' To generate toolbar items at visual design,- the editor for Toolbar property can be used.
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
		If (Me.IsPostBack) Then
			Return
		End If

		'-------------------
		' Add another item to a build-in Insert drop-down list
		Dim dropDownInsert As ToolbarDropDown = CType(Me.WebHtmlEditor1.FindByKeyOrAction("Insert"), ToolbarDropDown)
		If (Not dropDownInsert Is Nothing) Then
			dropDownInsert.Items.Add(New ToolbarDropDownItem("Signature2", "<span style='background-color:red'>My Signature<span>"))
		End If

		'-------------------
		' Add another item to the Style (font-style) drop-down list.
		' Note: commented line below shows example to remove default items from list.
		' Me.WebHtmlEditor1.FontStyleList.Clear()
		Dim dropDownFont As ToolbarDropDown = CType(Me.WebHtmlEditor1.FindByKeyOrAction("FontStyle"), ToolbarDropDown)
		If (Not dropDownFont Is Nothing) Then
			dropDownFont.Items.Add(New ToolbarDropDownItem("40px", "font-size:40px"))
		End If

		'-------------------
		' Add a custom button with custom action.
		' Note: implementation of actual action requires processing ClientSideEvents.BeforeAction
		Dim customAction As ToolbarButton = New ToolbarButton()
		customAction.Key = "MyCustomAct"
		customAction.Type = ToolbarButtonType.Custom
		Me.WebHtmlEditor1.Toolbar.Items.Add(customAction)
End Sub


To process custom actions on client, application should set
<ClientSideEvents BeforeAction="WebHtmlEditor1_BeforeAction" />
and codes below should appear within the HEAD section of HTML.

<script type="text/javascript">
<!--
// function fired before actions
function WebHtmlEditor1_BeforeAction(oEditor, actID, oEvent, p4, p5, p6, p7, p8)
{
	// if it is our custom MyCustomAct toolbar button,
	// then insert text at the current selection in editor
	if(actID == "MyCustomAct")
	{
		iged_insText("My Custom Action");
	}
}
// -->
</script>
//--------------------
	// Note: custom buttons with all their properties can be created within aspx.
	// That would reduce size of hidden viewstate field and improve persistance of properties.
	// To generate toolbar items at visual design,- the editor for Toolbar property can be used.
	protected void Page_Load(object sender, EventArgs e)
	{
		if(this.IsPostBack)
			return;

		//-------------------
		// Add another item to a built-in Insert drop-down list
		ToolbarDropDown dropDownInsert = this.WebHtmlEditor1.FindByKeyOrAction("Insert") as ToolbarDropDown;
		if(dropDownInsert != null)
		{
			dropDownInsert.Items.Add(new ToolbarDropDownItem("Signature2", "<span style='background-color:red'>My Signature<span>"));
		}

		//-------------------
		// Add another item to the Style (font-style) drop-down list
		// Note: commented line below shows example to remove default items from list
		// this.WebHtmlEditor1.FontStyleList.Clear();
		ToolbarDropDown dropDownFont = this.WebHtmlEditor1.FindByKeyOrAction("FontStyle") as ToolbarDropDown;
		if(dropDownFont != null)
		{
			dropDownFont.Items.Add(new ToolbarDropDownItem("40px", "font-size:40px"));
		}

		//-------------------
		// Add a custom button with custom action.
		// Note: implementation of actual action requires processing ClientSideEvents.BeforeAction
		ToolbarButton customAction = new ToolbarButton();
		customAction.Key = "MyCustomAct";
		customAction.Type = ToolbarButtonType.Custom;
		this.WebHtmlEditor1.Toolbar.Items.Add(customAction);
	}

To process custom actions on client, application should set
<ClientSideEvents BeforeAction="WebHtmlEditor1_BeforeAction" />
and codes below should appear within the HEAD section of HTML.

<script type="text/javascript">
<!--
// function fired before actions
function WebHtmlEditor1_BeforeAction(oEditor, actID, oEvent, p4, p5, p6, p7, p8, act)
{
	// if it is our custom MyCustomAct toolbar button,
	// then insert text at the current selection in editor
	if(actID == "MyCustomAct")
	{
		iged_insText("My Custom Action");
	}
}
// -->
</script>
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