execCommand Method | Internet Development Index |
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
document, controlRange, TextRange
See Also
queryCommandEnabled, queryCommandIndeterm, queryCommandState, queryCommandSupported, queryCommandValue