menuArguments property

Returns the window object in which the context menu item opened.

This property is not supported for Windows Store apps using JavaScript.

Syntax

Property values

Type: Variant

A pointer to a Variant that receives the arguments. The object reference of the window where the context menu was opened.

Remarks

This property is accessible by script handlers that are specified in the registry for a new context menu entry. When invoked as a menu extension, the menuArguments property returns an object reference to the window where the context menu was opened. The event object is exposed through this object reference, so that authors can query the srcElement property, the clientX property, and clientY property.

For more information about how to implement extensions to the Dynamic HTML (DHTML) Document Object Model (DOM), see About the Browser. For more information about how to add an entry into the standard context menus in Windows Internet Explorer, see Adding Entries to the Standard Context Menu.

This property is functionally identical to dialogArguments.

This property is not supported in HTML Applications.

Examples

This example uses the menuArguments property to change selected text to uppercase, or to insert text if no text is selected.

<script type="text/javascript">

// Get the window object where the context menu was opened.
var oWindow = window.external.menuArguments;

// Get the document object exposed through oWindow.
var oDocument = oWindow.document;

// Get the selection from oDocument.
// in oDocument.
var oSelect = oDocument.selection;

// Create a TextRange from oSelect.
var oSelectRange = oSelect.createRange();

// Get the text of the selection.
var sNewText = oSelectRange.text;

// If nothing was selected, insert some text.
if (sNewText.length == 0){
   oSelectRange.text = "INSERT TEXT";
}

// Otherwise, convert the selection to uppercase.
else{
   oSelectRange.text = sNewText.toUpperCase();
}
</script>

See also

external