This page is In Progress

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.


Overview Table

Synchronous No
Bubbles No
Target dom/Element
Cancelable No
Default action ?
## Examples

This example shows how to prevent a context menu from appearing by canceling the oncontextmenu event handler.

<span style="width: 300px; background-color: blue; color: white;"
    oncontextmenu="return false">
The context menu never displays when you right-click in this box. </span>

View live example

Although area elements inherit the oncontextmenu event by way of the object hierarchy, they do not respond to right-click events in Internet Explorer. However, it is possible to imitate the desired behavior by using the onfocus and onblur events to determine the currently selected region and trigger the appropriate action in the context menu handler of the img itself. Although it isn’t used by Internet Explorer, retain the oncontextmenu event attribute on the area elements for a fully cross-client implementation.

<script type="text/javascript">
var selectedArea = null;
function activate(e,f) {
    selectedArea = f ? e : null;
function menu(e) {
    if (selectedArea)
        alert('right-click: ' +;
    else {
        // cross-client case
        if (e.tagName == 'AREA')
            alert('right-click: ' +;
            alert('right-click: ' + e.tagName);
    return false;
<map id="Map0">
<area id="Area1" onfocus="activate(this,true)" onblur="activate(this,false)"
    oncontextmenu="return menu(this)" shape="rect" coords="100, 50, 200, 150" href="..."/>
<img src="..." oncontextmenu="return menu(this)" usemap="#Map0" />

View live example



Opens the context menu. To cancel the default behavior, set the returnValue property of the event object to false. To invoke this event, do one of the following:

  • Right-click the object.

The pEvtObj parameter is required for the following interfaces:

  • HTMLAnchorEvents2
  • HTMLAreaEvents2
  • HTMLButtonElementEvents2
  • HTMLControlElementEvents2
  • HTMLDocumentEvents2
  • HTMLElementEvents2
  • HTMLFormElementEvents2
  • HTMLImgEvents2
  • HTMLFrameSiteEvents2
  • HTMLInputFileElementEvents2
  • HTMLInputImageEvents2
  • HTMLInputTextElementEvents2
  • HTMLLabelEvents2
  • HTMLLinkElementEvents2
  • HTMLMapEvents2
  • HTMLMarqueeElementEvents2
  • HTMLObjectElementEvents2
  • HTMLOptionButtonElementEvents2
  • HTMLScriptEvents2
  • HTMLSelectElementEvents2
  • HTMLStyleElementEvents2
  • HTMLTableEvents2
  • HTMLTextContainerEvents2
  • HTMLWindowEvents2


Standards information

There are no standards that apply here.

Event handler parameters

pEvtObj [in]
Type: ****IHTMLEventObj****