|
Summary
This page describes eValid's IndexElementEvent command
and explains its role and use.
Background
Once a particular HTML element is identified by its DOM index -- the local sourceIndex that
is found by one of the DOM manipulation commands --
this command permits the user to fire an event at that particular index.
Command Description
Here is the IndexFindElementEx command description and explanation.
KEY | COMMAND SYNTAX: Name(...) |
ORIGIN | EXPLANATION | COMMENTS |
PAGEMAP |
IndexElementEvent wid "event_name"
"property_name" "property_value"
[ "property_name" "property_value" ] ... "frame_path" [NAV] | Edit |
This command involves specifying
an event_name
and a sequence of
"property_name" "property_value"
in pairs.
Complete details on how these parameters work are given below. |
No adaptive playback activity is performed.
Use the PageMap to identify index values and attribute names. |
Command Explanation
The following syntax examples are invalid:
The example below is valid syntactically, but it may produce playback errors:
That's because it has 5 parameters, which follows the form of the first valid syntax example above. However, in this case eValid will assume "frame_path" is a property value and "NAV' as the required frame_path value.
onabort, onblur, onchange, onclick, ondblclick,
onerror, onfocus, onkeydown, onkeypress, onkeyup, onload,
onmousedown, onmousemove, onmouseout, onmouseover, onmouseup,
onresend, onresize, onselect, onsubmit, onunload
Note that there could be other events that could be used here, depending on how the page is constructed. The above list is only a suggestion and may not be complete.
"property_name" "property_value"
These values may ONLY occur in pairs and can be ONLY taken from the following combinations and options. The values given below are the exact ones to use. All values are case-sensitive. Any other combinations and options, including empty strings, are ignored without issuance of WARNINGs or ERRORs during playback.
property_name |
property_value
Explanation
| altKey
|
Possible values are:
|
Sets the state of the ALT key when given these values:
| button
|
Possible values are:
|
Sets the mouse button pressed by the user.
| cancelBubble
| Possible values for this are the following:
|
Sets whether the current event should bubble up
the hierarchy of event handlers.
| clientX, clientY
|
| Sets the x-coordinate or y-coordinate
of the mouse pointer's position relative to the client area of the window,
excluding window decorations and cross bars.
The value is a long integer expressed in pixels.
| ctrlKey
| Possible values are:
|
Sets the state of the CTRL key.
| ctrlLeft
| Possible values are:
|
Sets the state of the left CTRL key.
| keyCode
|
| Sets the Unicode key code associated with the key that caused the event.
The property value parameter is a number.
It is 0 if no key caused the event.
| offsetX, offsetY
|
| Sets the x-coordinate or y-coordinate of the mouse
pointer's position relative
to the object firing the event.
The value is a long integer expressed in pixels.
| propertyName
|
| Sets the name of the property that changes on the objects.
| qualifier
|
| Sets the name of the data member provided by a data source object.
| reason
| Possible values are these:
|
Sets the result of the data transfer for a data source object.
| repeat
| Possible values are these:
|
Sets whether the onkeydown event is being repeated.
| returnValue
| Possible values for this are:
|
Sets the return value from the event.
| screenX, screenY
|
| Sets the x-coordinate or y-coordinate of the mouse pointer's position
relative to the user's screen.
The value supplied is a long integer expressed in pixels.
| shiftKey
| Possible values that can be used are:
|
Sets the state of the SHIFT key.
| srcUrn
| Possible values that can be used are:
|
This property is set to NULL unless both of the following conditions are true:
Sets the Uniform Resource Name (URN) of the behavior that fired the event.
| x, y
|
| Sets the x-coordinate, or y-coordinate, in pixels,
of the mouse pointer's position relative to a relatively positioned parent element.
The value is a long integer.
| |
Command Examples
Some sample commands are the following:
IndexElementEvent 0 "onmousedown" "" "" ""
IndexElementEvent 0 "onmouseup" "" "" ""
IndexElementEvent 0 "onclick" "offsetX" "357" "offsetY" "215" "" NAV
IndexElementEvent 0 "onmousedown" "button" "1" ""
IndexElementEvent 0 "onmouseup" "button" "1" "" NAV
IndexElementEvent 0 "onkeydown" "keyCode" "9" "number:0"
IndexElementEvent 0 "onkeyup" "keyCode" "9" "number:0"
Additional Notes