States object

States object

Represents states of DOM elements.

To access state collection of the element use its state property: element.state

Properties

link
rw – true/false, true if this element is a link – has href attribute defined.
hover
rw – true/false,
active
rw – true/false,
focus
rw – true/false, this element is in focus. To set focus on the element is it enough to assign true value to the attribute:
el.state.focus = true;
tabfocus
r – true/false, this element is in focus and got the focus due to TAB/SHIFT+TAB key handling.
visited
rw – true/false,
current
rw – true/false,
checked
rw – true/false,
disabled
rw – true/false,
readonly
rw – true/false,
expanded
rw – true/false,
collapsed
rw – true/false,
incomplete
rw – true/false,
animating
r – true/false, element is running animation.
focusable
rw – true/false, element is focusable. Focusable is the element having either: tabindex >= 0 attribute defined or it has behavior that has focus handler defined.
anchor
rw – true/false, element is an anchor (first element) in selection.
synthetic
rw – true/false, element was synthesized – created by some behavior.
popup
rw – true/false, element is shown as popup window. To close such popup window simply assign value false to the attribute:
el.state.popup = false;
ownspopup
r – true/false, element is requested popup to be shown and that popup is visible. Following:
el.popup(elementToPopup, pos);

will cause this flag to be set for the element el.

empty
r – true/false, the element is empty – has no children and no text.
busy
rw – true/false, element is requested data to be delivered by calling el.request(...) and that data is not delivered yet.
dragover
r – true/false, the dragged element is over the element.
droptarget
r – true/false, dragging is active and the element is active drop target for the dragging element.
moving
copying
r – true/false, either one of these is true for the element that is being dragged. Engine creates copy of drag-source element and that copy is being dragged.
dragsource
r – true/false, element one of these is true for the element that being dragged.
pressed
rw – true/false, element has mouse pressed in it.
isltr
isrtl
r – true/false, element is in directional environment – itself or one of its parents has attribute dir defined.
value
rw – "raw" value of the element. It is either the value managed by native behavior or, if the element has no behavior attached, it is a text of the element (see Element.text).
screen
r – integer, number of screen (monitor) on which this element is rendered at the moment. Note in can be different from view.screen for popup elements.
awaitsDraw
rw – boolean, flag indicating that the element is awaiting to be drawn after Element.refresh() was issued for it. Sciter sets this flag autmatically. It also resets it when the element gets drawn on the scree. In between you can set/reset it from code.

Methods

get
() returns: int

Returns integer – "ORed" set of Element.STATE_*** constants.

set
(flags:int) returns: undefined

Sets flags. flags here "ORed" set of Element.STATE_*** constants.

clear
(flags:int) returns: undefined

Clears flags.