execCommand Method

Executes a command on the current document, current selection, or the given range.

Syntax

bSuccess = object .execCommand( sCommand [ , bUserInterface ] [ , vValue ] )

Parameters

sCommand

Required. String that specifies the command to execute. This command can be any of the command identifiers that can be executed in script.

bUserInterface

Optional. Boolean that specifies one of the following values.

false	Default. Does not display a user interface.
true	Displays a user interface, if the command supports one.

vValue

Optional. Variant that specifies the string, number, or other value to assign. Possible values depend on sCommand .

Return Value

Returns True if the command is successful.

Remarks

Do not invoke the execCommand method until after the page loads.

The bUserInterface and vValue parameters might be required depending on the command being executed.

Example

The following example shows how to use the CreateLink constant as the sCommand of the execCommand method to allow the user to create a hyperlink from selected text. The scriptMicrosoft® JScript® then retrieves the specified URL and uses it to replace the selected text.

<HTML>
<BODY>
<H1 unselectable="on">Creating a Link and Retrieving the URL</H1>
<script>
function AddLink() {
// Identify selected text
var sText = document.selection.createRange();
if (!sText==""){
// Create link document.
execCommand ("CreateLink");
// Replace text with URL
if (sText.parentElement().tagName == "A")
{ sText.parentElement().innerText=sText.parentElement().href;
document. execCommand ("ForeColor","false","#FF0033"); } }
else{ alert("Please select some blue text!"); } }
</script>
<P unselectable="on">Select any portion of the following blue text, such as "My favorite Web site". Click the button to turn the selected text into a link. The text will be changed to the URL that you specify.</P>
<P style="color=#3366CC">My favorite Web site is worth clicking on. Don't forget to check out my favorite music group!</P>
<BUTTON onclick="AddLink()" unselectable="on">Click to add link</BUTTON>
</BODY>
</HTML>

Standards Information

There is no public standard that applies to this method.

Applies To

[ Object Name ] Platform Version

Win16:
Win32:
Unix:
Mac:
Windows CE:

document , controlRange , TextRange

Home | Top | Free Ajax Editor | JavaScript Editor

Get Advanced
JavaScript and Ajax Editor,
Validator and Debugger!
1st JavaScript Editor.

→