usage: Object.HTML.setSelection( textfield, begin, end )

textfield:
being the name of the field, not the object. usually the result of a Selection.getFocus() call!

begin:begin index gotten from Selection.getBeginIndex()

end:being the end index, usually from Selection.getEndIndex()

setSelection will navigate the HTML engine to the proper text location, afterwards you may call functions to change the formatting, eg. setBold() which is then applied to the selected range.

example:
Object.HTML.setSelection( Selection.getFocus(), Selection.getBeginIndex(), Selection.getEndIndex() );

usage: Object.HTML.restoreSelection();

restoreSelection will force flash to put the focus on the textfield previously selected by "setSelection" and restore the selection range, for example after a user has clicked a button.

usage: state = Object.HTML.getState();

getting the state of the textfield/range previously selected by "Object.HTML.setSelection"

state being an object with the following fields, or null if invalid arguments:

state.bold, where 1 = bold, 2 = unbold, 3 = mixed
state.italic, where 1 = italic, 2 = non-italic, 3 = mixed
state.underline, where 1 = underlined, 2 = not underlined, 3 = mixed

state.left, where 1 = left aligned, 2 = not left aligned
state.center, where 1 = centered, 2 = not centered
state.right, where 1 = right aligned, 2 = not right aligned

state.url, string, if the current selection holds a link
state.url_target, string, if the current selection holds a link with target
state.color, string in form "#ff0000"
state.fontsize, current font size or "---" if mixed
state.fontface, current font face or "---" if mixed

usage: Object.HTML.setColor( 0xff0000 ) or Object.HTML.setColor( 0xff, 0, 0 );

applies the desired color to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.setFont( "_sans" );

applies the desired font face to the textfield/range previously chosen by Object.HTML.setSelection(...)

valid font names are: _sans, _serif and _typewriter ... for using device fonts
or: any font name, as long as the font is embedded in the same movie that also holds the HTML textfield!

usage: Object.HTML.setTarget( "_top" );

applies the desired target to the textfield/range previously chosen by Object.HTML.setSelection(...)
if the selected range has not been a link, a link will be automatically created

usage: Object.HTML.setLink( "http://www.active-web.cc" );

applies the desired link to the textfield/range previously chosen by Object.HTML.setSelection(...)
if the selected range has not yet been a link, a link will be automatically created

if the argument was "", an eventually existing link will be removed

newly created links will use "<AEDIT HREF" instead of "<A HREF" because otherwise the link would be active in edit mode. you have to take care of this when saving/loading the text. (not used anymore since flash 5/6 have problems with unknown HTML tags. - we really create "<A HREF" now !)

usage: Object.HTML.setBold();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.removeBold();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.setItalic();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.removeItalic();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.setUnderline();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.removeUnderline();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.alignLeft();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.alignCenter();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)

usage: Object.HTML.alignRight();

applies the desired format option to the textfield/range previously chosen by Object.HTML.setSelection(...)