Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

onclick event

Fires when the user clicks the left mouse button on the object.

Note  Starting with Internet Explorer 11, this event fires a MSPointerEvent object instead of MouseEvent. You can use the MouseEvent.pointerType property to determine the type of contact that the click originated from (touch, mouse, or pen).

HTML 4.01 Specification, Section 18.2.3

Syntax

HTML Attribute <element onclick = "handler(event)">
Event Property object.onclick = handler;
attachEvent Method object.attachEvent("onclick", handler)
addEventListener Method object.addEventListener("click", handler, useCapture)

Event information

SynchronousNo
BubblesYes
CancelableYes

Event handler parameters

pEvtObj [in]

Type: IHTMLEventObj

Standards information

Remarks

If the user clicks the left mouse button, the HTMLLabelEvents::onclick event for an object occurs only if the mouse pointer is over the object and an HTMLLabelEvents::onmousedown and an HTMLLabelEvents::onmouseup event occur in that order. For example, if the user clicks the mouse on the object but moves the mouse pointer away from the object before releasing, no HTMLLabelEvents::onclick event occurs.

The HTMLLabelEvents::onclick event changes the value of a control in a group. This change initiates the event for the group, not for the individual control. For example, if the user clicks a radio button or check box in a group, the HTMLLabelEvents::onclick event occurs after the HTMLLabelEvents::onbeforeupdate and HTMLLabelEvents::onafterupdate events for the control group.

If the user clicks an object that can receive the input focus but does not already have the focus, the HTMLLabelEvents::onfocus event occurs for that object before the HTMLLabelEvents::onclick event. If the user double-clicks the left mouse button in a control, an HTMLLabelEvents::ondblclick event occurs immediately after the HTMLLabelEvents::onclick event.

Although the HTMLLabelEvents::onclick event is available on a large number of HTML elements, if a document is to be accessible to keyboard users, you should restrict its use to the a, input, area, and button elements. These elements automatically allow keyboard access through the TAB key, making documents that use the elements accessible to keyboard users. For more information, please see the section on writing accessible Dynamic HTML.

Initiates any action associated with the object. For example, if the user clicks an a object, the client loads the document specified by the IHTMLLinkElement4::href property. To cancel the default behavior, set the IHTMLEventObj::returnValue property of the event object to FALSE.

To invoke this event, do one of the following:

  • Click the object.
  • Invoke the IHTMLElement::click method.
  • Press the ENTER key in a form.
  • Press the access key for a control.
  • Select an item in a combo box or list box by clicking the left mouse button or by pressing the arrow keys and then pressing the ENTER key.

See also

IHTMLElement::click
onmsgesturetap

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.