FreeTextBox 3.2 Documentation
FreeTextBox Class
NamespacesFreeTextBoxControlsFreeTextBox
The no. 1 free ASP.NET HTML editor for IE and Mozilla.
Declaration Syntax
C# Visual Basic Visual C++
Members
All Members Constructors Methods Properties Events



Icon Member Description
FreeTextBox()()()
Initializes a new instance of the FreeTextBox class

Adapter
Gets the browser-specific adapter for the control.
(Inherited from Control.)
AddedControl(Control, Int32)
Called after a child control is added to the Controls collection of the Control object.
(Inherited from Control.)
AddParsedSubObject(Object)
Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.
(Inherited from Control.)
AllowHtmlMode Obsolete.
Depreciated: (FTB 1.x property)

ApplyStyleSheetSkin(Page)
Applies the style properties defined in the page style sheet to the control.
(Inherited from Control.)
AppRelativeTemplateSourceDirectory
Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.
(Inherited from Control.)
AssemblyResourceHandlerPath
Gets or sets the path to FtbWebResource.axd (if the web.config reference needs to happen elsewhere)

AutoConfigure Obsolete.
Depreciated: (FTB 1.x property)

AutoGenerateToolbarsFromString
Gets or sets whether the toolbars are hidden when the editor is in HTML mode.

AutoHideToolbar Obsolete.
Depreciated: (FTB 1.x property)

AutoParseStyles
Gets or sets whether styles will automagically be parsed from DesignModeCss into StylesMenu items

BackColor
Gets or sets the back color of the entire editor area.

BaseUrl
Gets or sets the base URL of the editor

BindingContainer
Gets the control that contains this control's data binding.
(Inherited from Control.)
BreakMode
Gets or sets what happens when 'Enter' is pressed (IE only)

BuildProfileTree(String, Boolean)
Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.
(Inherited from Control.)
ButtonDownImage Obsolete.
Depreciated: (FTB 1.x property)

ButtonFileExtention
Gets or sets file type extention of buttons (gif,jpg,png)

ButtonFolder
Gets or sets whether buttons change images onMouseOver.

ButtonHeight
Gets or sets the height in pixels of ToolbarButtons

ButtonImagesLocation
Gets or sets where button images are stored

ButtonOverImage Obsolete.
Depreciated: (FTB 1.x property)

ButtonPath Obsolete.
Depreciated: (FTB 1.x property)

ButtonSet
Gets or sets which button set to draw from if using resources

ButtonStyle
Style parameters for ToolbarButtons when in "normal" state.

ButtonStyleActive
Style parameters for ToolbarButtons when in "active" state.

ButtonWidth
Gets or sets the width in pixels of ToolbarButtons

ChildControlsCreated
Gets a value that indicates whether the server control's child controls have been created.
(Inherited from Control.)
ClearChildControlState()()()
Deletes the control-state information for the server control's child controls.
(Inherited from Control.)
ClearChildState()()()
Deletes the view-state and control-state information for all the server control's child controls.
(Inherited from Control.)
ClearChildViewState()()()
Deletes the view-state information for all the server control's child controls.
(Inherited from Control.)
ClientID
Overridden ClientID field to ensure CSS and JS compatibility
(Overrides Control.ClientID.)
ClientIDSeparator
Gets a character value representing the separator character used in the ClientID property.
(Inherited from Control.)
ClientSideTextChanged
Gets or sets a javascript method fired when the text changes

Context
Gets the HttpContext object associated with the server control for the current Web request.
(Inherited from Control.)
Controls
Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.
(Inherited from Control.)
ConvertHtmlSymbolsToHtmlCodes
Gets or sets whether or not to convert non-ASCII characters to HTML Hex codes.

CreateChildControls()()()
Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.
(Inherited from Control.)
CreateControlCollection()()()
Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.
(Inherited from Control.)
DataBind()()()
Binds a data source to the invoked server control and all its child controls.
(Inherited from Control.)
DataBind(Boolean)
Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.
(Inherited from Control.)
DataBindChildren()()()
Binds a data source to the server control's child controls.
(Inherited from Control.)
DataBinding
Occurs when the server control binds to a data source.
(Inherited from Control.)
DesignMode
Gets a value indicating whether a control is being used on a design surface.
(Inherited from Control.)
DesignModeBodyTagCssClass
Gets or sets a CSS class used for the editor area

DesignModeCss
Gets or sets the URL of the style sheet used in Design mode.

DisableIEBackButton
Gets or sets whether to disable onload code that allow the back button to function in Internet Explorer. This does not affect Mozilla.

Dispose()()() (Overrides Control.Dispose()()().)
Dispose(Boolean)
Disposed
Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.
(Inherited from Control.)
DownLevelCols
Gets or sets the cols property of the downlevel TEXTAREA

DownLevelMessage
Gets or sets how FreeTextBox will render for downlevel browsers

DownLevelMode
Gets or sets how FreeTextBox will render for downlevel browsers

DownLevelRows
Gets or sets the rows property of the downlevel TEXTAREA

DropDownListCssClass
Gets or sets the CSS class for DropDownLists

EditorBorderColorDark
Gets or sets the dark color of the border of the Editor window.

EditorBorderColorLight
Gets or sets the light color of the border of the Editor window.

EnableHtmlMode
Gets or sets whether to allow HTML mode

EnableSsl
Gets or sets whether to add /. to the src attribute of the iframe in order for IE to correctly function in SSL.

EnableTheming
Gets or sets a value indicating whether themes apply to this control.
(Inherited from Control.)
EnableToolbars
Gets or sets whether this control display Toolbars.

EnableViewState
Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.
(Inherited from Control.)
EnsureChildControls()()()
Determines whether the server control contains child controls. If it does not, it creates child controls.
(Inherited from Control.)
EnsureID()()()
Creates an identifier for controls that do not have an identifier assigned.
(Inherited from Control.)
Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Events
Gets a list of event handler delegates for the control. This property is read-only.
(Inherited from Control.)
Finalize()()()
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
FindControl(String)
Searches the current naming container for a server control with the specified id parameter.
(Inherited from Control.)
FindControl(String, Int32)
Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. You should not override this version of the FindControl()()() method.
(Inherited from Control.)
Focus
Gets or sets whether this control will receive focus on startup

Focus()()()
Sets input focus to a control.
(Inherited from Control.)
FontBackColorMenuList
The list of back colors in the FontBackColorsMenu

FontBackColorMenuNames
The list of display names for the back colors in FontBackColorMenuList

FontFacesMenuList
The list of fonts in the FontFacesMenu

FontFacesMenuNames
The list of display names for the fonts in FontFacesMenuList

FontForeColorMenuList
The list of font colors in the FontForeColorsMenu

FontForeColorMenuNames
The list of display names for the colors in FontForeColorMenuList

FontSizesMenuList
The list of font sizes (1,2,3) in the FontSizesMenu

FontSizesMenuNames
The list of display names for the font sizes in FontSizesMenuList

FormatHtmlTagsToXhtml
Gets or sets whether FreeTextBox will use SgmlReader to reformat tags as XHTML

GetDesignModeState()()()
Gets design-time data for a control.
(Inherited from Control.)
GetHashCode()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetType()()()
Gets the Type of the current instance.
(Inherited from Object.)
GutterBackColor
Gets or sets the back color of the gutter of the tab area.

GutterBorderColorDark
Gets or sets the dark color of the border of the Editor window.

GutterBorderColorLight
Gets or sets the light color of the border of the Editor window.

HasChildViewState
Gets a value indicating whether the current server control's child controls have any saved view-state settings.
(Inherited from Control.)
HasControls()()()
Determines if the server control contains any child controls.
(Inherited from Control.)
HasEvents()()()
Returns a value indicating whether events are registered for the control or any child controls.
(Inherited from Control.)
Height
Gets or sets the height of the editor including toolbars.

HelperFilesParameters Obsolete.
Depreciated: (FTB 1.x property)

HelperFilesPath Obsolete.
Depreciated: (FTB 1.x property)

HtmlModeCss Obsolete.
Depreciated: (FTB 1.x property)

HtmlModeCssClass
Gets or sets the CSS class for HTML Mode

HtmlModeDefaultsToMonoSpaceFont
Gets or sets the URL of the style sheet used in HTML mode.

HtmlStrippedText
Gets the Text stripped of Html tags

ID
Gets or sets the programmatic identifier assigned to the server control.
(Inherited from Control.)
IdSeparator
Gets the character used to separate control identifiers.
(Inherited from Control.)
ImageGalleryPath
The Url of the image gallery to be launched

ImageGalleryUrl
The Url of the gallery used when the InsertImageFromGallery button is pressed

Init
Occurs when the server control is initialized, which is the first step in its lifecycle.
(Inherited from Control.)
InsertHtmlMenuList
The list of HTML blocks inserted by InsertHtmlMenu

InsertHtmlMenuNames
The list of display names for the HTML blocks in InsertHtmlMenuList

InstallationErrorMessage
Gets or sets how the user is alerted that FreeTextBox has not been installed correctly

IsChildControlStateCleared
Gets a value indicating whether controls contained within this control have control state.
(Inherited from Control.)
IsLiteralContent()()()
Determines if the server control holds only literal content.
(Inherited from Control.)
IsRichCapable(HttpContext)
Static function to determine if the client's browser is capable of displaying the rich editor.

IsTrackingViewState
Gets a value that indicates whether the server control is saving changes to its view state.
(Inherited from Control.)
IsViewStateEnabled
Gets a value indicating whether view state is enabled for this control.
(Inherited from Control.)
JavaScriptLocation
Gets or sets where JS files are stored

Language
Gets or sets the lanuage used for all labels. Pulls from XML languages files in /aspnet_client/FreeTextBox/Languages folder.

Load
Occurs when the server control is loaded into the Page object.
(Inherited from Control.)
LoadControlState(Object)
Restores control-state information from a previous page request that was saved by the SaveControlState()()() method.
(Inherited from Control.)
LoadPostData(String, NameValueCollection)
LoadViewState(Object)
Gets or sets whether toolbar items are generated from a string
(Overrides Control.LoadViewState(Object).)
LoadViewStateByID
Gets a value indicating whether the control participates in loading its view state by ID instead of index.
(Inherited from Control.)
MapPathSecure(String)
Retrieves the physical path that a virtual path, either absolute or relative, maps to.
(Inherited from Control.)
MemberwiseClone()()()
Creates a shallow copy of the current Object.
(Inherited from Object.)
NamingContainer
Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.
(Inherited from Control.)
OnBubbleEvent(Object, EventArgs)
Determines whether the event for the server control is passed up the page's UI server control hierarchy.
(Inherited from Control.)
OnDataBinding(EventArgs)
Raises the DataBinding event.
(Inherited from Control.)
OnInit(EventArgs) (Overrides Control.OnInit(EventArgs).)
OnLoad(EventArgs) (Overrides Control.OnLoad(EventArgs).)
OnPreRender(EventArgs) (Overrides Control.OnPreRender(EventArgs).)
OnProcessText(EventArgs)
Event for ProcessText handler

OnSaveClick(EventArgs)
Event for Save button

OnTextChanged(EventArgs)
Event for Save button

OnUnload(EventArgs)
Raises the Unload event.
(Inherited from Control.)
OpenFile(String)
Gets a Stream used to read a file.
(Inherited from Control.)
Page
Gets a reference to the Page instance that contains the server control.
(Inherited from Control.)
ParagraphMenuList
The list of HTML blocks inserted by ParagraphMenu

ParagraphMenuNames
The list of display names for the HTML blocks used in ParagraphMenuList

Parent
Gets a reference to the server control's parent control in the page control hierarchy.
(Inherited from Control.)
PasteMode
Gets or sets what happens when a user tries to paste into the editor

PreRender
Occurs after the Control object is loaded but prior to rendering.
(Inherited from Control.)
ProcessText
The event fired on post back that processes the HTML

RaiseBubbleEvent(Object, EventArgs)
Assigns any sources of the event and its information to the control's parent.
(Inherited from Control.)
RaisePostBackEvent(String)
RaisePostDataChangedEvent()()()
ReadOnly
Gets or sets whether content is editable.

RegisterClientScript()()()
RemovedControl(Control)
Called after a child control is removed from the Controls collection of the Control object.
(Inherited from Control.)
RemoveScriptNameFromBookmarks
Gets or sets whether or not to remove the scriptname from bookmarks

RemoveServerNameFromUrls
Gets or sets whether or not to strip out the local server name from all A and IMG tags

Render(HtmlTextWriter) (Overrides Control.Render(HtmlTextWriter).)
RenderButtonStyles(HtmlTextWriter)
RenderChildren(HtmlTextWriter)
Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.
(Inherited from Control.)
RenderControl(HtmlTextWriter)
Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.
(Inherited from Control.)
RenderControl(HtmlTextWriter, ControlAdapter)
Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.
(Inherited from Control.)
RenderDownLevel(HtmlTextWriter)
RenderEditorStyles(HtmlTextWriter)
RenderMode
Gets or sets how the control will render. NotSet = FreeTextBox will attempt to figure out which browser to render for, Text or Rich forces FreeTextBox to render accordingly

RenderRichEditor(HtmlTextWriter)
RenderTabs(HtmlTextWriter)
RenderTabStyles(HtmlTextWriter)
RenderToolbar(HtmlTextWriter, Toolbar)
RenderToolbarButton(HtmlTextWriter, Toolbar, ToolbarButton)
RenderToolbarDropDownList(HtmlTextWriter, Toolbar, ToolbarDropDownList)
RenderToolbarSeparator(HtmlTextWriter, Toolbar)
ResolveAdapter()()()
Gets the control adapter responsible for rendering the specified control.
(Inherited from Control.)
ResolveClientUrl(String)
Gets a URL that can be used by the browser.
(Inherited from Control.)
ResolveUrl(String)
Converts a URL into one that is usable on the requesting client.
(Inherited from Control.)
SaveClick
Occurs when a Save button is pressed.

SaveControlState()()()
Saves any server control state changes that have occurred since the time the page was posted back to the server.
(Inherited from Control.)
SaveViewState()()() (Overrides Control.SaveViewState()()().)
ScriptMode
Gets or sets if ToolbarItem JavaScript is written inpage or comes from an external file

SetDesignModeState(IDictionary)
Sets design-time data for a control.
(Inherited from Control.)
SetRenderMethodDelegate(RenderMethod)
Assigns an event handler delegate to render the server control and its content into its parent control.
(Inherited from Control.)
SetToolbarButtonLanguage(ToolbarButton)
ShowTagPath
Gets or sets whether to show the path of tags at the cursor position

Site
Gets information about the container that hosts the current control when rendered on a design surface.
(Inherited from Control.)
SkinID
Gets or sets the skin to apply to the control.
(Inherited from Control.)
SslUrl
Gets or sets the src url for the IFRAME when in SSL mode

StartMode
Gets or sets the mode FreeTextBox starts in.

StripAllScripting
Gets or sets whether FreeTextBox will attempt strip all scripting tags and scripting events.

StylesMenuList
The list of styles in the StylesMenu

StylesMenuNames
The list of display names for the styles in StylesMenuList

SupportFolder
Gets or sets the folder where FreeTextBox images and scripts are stored

SymbolsMenuList
The list of HTML symbols inserted by SymbolsMenu

TabIndex
Gets or sets the TabIndex on the IFrame

TabMode
Gets or sets the TabMode of the control

TemplateControl
Gets or sets a reference to the template that contains this control.
(Inherited from Control.)
TemplateSourceDirectory
Gets the virtual directory of the Page or UserControl that contains the current server control.
(Inherited from Control.)
Text
Gets or sets the HTML for the editor.

TextChanged
The event fired on post back when the HTML in the editor has changed

TextDirection
Gets or sets the direction of text within the editor

ToolbarBackColor
Gets or sets the back color of each toolbar.

ToolbarBackgroundImage
Gets or sets whether a background image is used for the toolbar.

ToolbarImagesLocation
Gets or sets where the images such as the toolbar background and separators are stored

ToolbarLayout
A string of buttons used to create the toolbar. Use commas (,) to separate items. A pipe (|) will insert a separator and a semicolon (;) will start a new Toolbar. Possible values are ParagraphMenu, FontFacesMenu, FontSizesMenu, FontForeColorsMenu, FontForeColorPicker, FontBackColorsMenu, FontBackColorPicker, Bold, Italic, Underline, Strikethrough, Superscript, Subscript, CreateLink, Unlink, RemoveFormat, JustifyLeft, JustifyRight, JustifyCenter, JustifyFull, BulletedList, NumberedList, Indent, Outdent, Cut, Copy, Paste, Delete, Undo, Redo, Print, Save, SymbolsMenu, StylesMenu, InsertHtmlMenu, InsertRule, InsertDate, InsertTime, ieSpellCheck, NetSpell, WordClean, InsertImageFromGallery, InsertTable, InsertTableRowBelow, InsertTableRowAbove, DeleteTableRow, InsertTableColumnBelow, InsertTableColumnAbove, DeleteTableColumn, InsertForm, InsertForm,InsertTextBox,InsertTextArea,InsertRadioButton,InsertCheckBox,InsertDropDownList,InsertButton, InsertDiv, InsertImageFromGallery

Toolbars
Contains all the Toolbars and ToolbarItems

ToolbarStyleConfiguration
Gets or sets a prebuilt Toolbar styling to emulate versions of Microsoft Office.

ToString()()()
Returns a String that represents the current Object.
(Inherited from Object.)
TrackViewState()()() (Overrides Control.TrackViewState()()().)
UniqueID
Gets the unique, hierarchically qualified identifier for the server control.
(Inherited from Control.)
Unload
Occurs when the server control is unloaded from memory.
(Inherited from Control.)
UpdateToolbar
Gets or sets whether the ToolbarButtons and ToolbarDropDownLists reflect the style of the text at the cursor.

UseToolbarBackGroundImage
Gets or sets whether an image is behind a toolbar

ViewState
Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.
(Inherited from Control.)
ViewStateIgnoresCase
Gets a value that indicates whether the StateBag object is case-insensitive.
(Inherited from Control.)
ViewStateText
Gets the Text data from the ViewState before it is processed

Visible
Gets or sets a value that indicates whether a server control is rendered as UI on the page.
(Inherited from Control.)
Width
Gets or sets the width of the editor.

Xhtml
Converts the returned HTML to XHTML

Remarks
Supports PC/IE 5+ and Mozilla 1.3+. The Toolbar can be customized in several ways. 1) By setting the ToolbarLayout string with appopriate ToolbarButton and ToolbarDropDownList names, 2) Procedurally, by setting AutoGenerateToolbarsFromString=false and adding ASP.NET code, 3) in codebehind, 4) by inherting from ToolbarButton or ToolbarDropDownList
Examples
CopyC#
-- webform.aspx ----------------------------
<%@ Register TagPrefix="FTB" Assembly="FreeTextBox" Namespace="FreeTextBoxControls" %>
<html>
 <head>
 </head>
 <body>
    <form runat="server">
        <FTB:FreeTextBox id="FreeTextBox1" runat="server" />
    </form>
 </body>
</html>

-- web.config -------------------------------
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.web>
        <httpHandlers>
            <add verb="GET" 
                path="FtbWebResource.axd" 
                type="FreeTextBoxControls.AssemblyResourceHandler, FreeTextBox" />        
        </httpHandlers>
    </system.web>      
</configuration>
Inheritance Hierarchy
Object
Control
  FreeTextBox

Assembly: FreeTextBox (Module: FreeTextBox) Version: 3.2.0.28068