You are here: Reference > JavaScript > client-side > event handling > properties > ctrlLeft (event)

ctrlLeft property (event)

A A

Font size

Browser support:

Sets or retrieves whether the left CTRL key was down at the time when the event occurred.

If it is not necessary to know which CTRL key was pressed, use the cross-browser ctrlKey property.

For ALT and SHIFT keys, use the (altKey, altLeft) and (shiftKey, shiftLeft) properties.

Syntax:

object.ctrlLeft;

You can find the related objects in the Supported by objects section below.

The ctrlLeft property is read-only for the window.event object, but it is read/write for event objects created by the createEventObject method.

Possible values:

Boolean, one of the following values:

false

Left CTRL key is up.

true

Left CTRL key is down.

Default: this property has no default value.

Example HTML code 1:

This example illustrates the use of the ctrlLeft property:

<head>
    <script>
        function GetCtrlState (event) {
            if (event.ctrlKey) {
                if (event.ctrlLeft != undefined) {
                    if (event.ctrlLeft) {
                        alert ("Left Ctrl key is down.");
                    }
                    else {
                        alert ("Right Ctrl key is down.");
                    }
                }
                else {
                    alert ("Ctrl key is down.");
                }
            }
            else {
                alert ("Ctrl key is up.");
            }
        }
    </script>
</head>
<body>
    Press or release the left or right CTRL key before you click on the button.
    <br />
    <button onclick="GetCtrlState (event);">Get Ctrl keys state!</button>
</body>