search
The <attributeAssessment> Element
Definition and Usage
The <attributeAssessment> element is used to define a variable to be evaluated, in <assessmentStatement> elements, against other variable values or an absolute value.
The variable can be a property specifies in a <property> element, or can be a (presentation, selection or attribution) event attribute: occurrences, repetition or state (which has the following values: “occurring”, “paused”, or “sleeping”).
The <attributeAssessment>element has a role attribute, which has to be unique in the connector role set. This attribute is the connector interface point, which is associated to node interfaces (<port>, <area>, <property> or <switchPort> elements) by a <link> that refers to the connector.
The variable defined by the element depends on its eventType attribute and its attributeType attribute:
- If the eventType value is “presentation”, the attributeType attribute may specifyas variable:the “occurrences” or “repetition” event attributes,or the “state” event state.
- If the eventType is “attribution” the attributeType may have the values: “nodeProperty” (specifying a node property), “occurrences”, “repetition” or “state”.
- If the eventType value is “selection”, the <attributeAssessment>can also define to which selection apparatus (for example, keyboard keys or remote control keys) it refers, through its key attribute. The attributeType attribute may have the values: “occurrences” (default) or “state”.
An offset value may be added to an <attributeAssessment> before its comparison in an <assessmentStatement> element. For example, an offset may be added to an attributeassessment to specify: “the screen vertical position plus 50 pixels”.
Syntax
| Element | Attributes | Content | Parent |
|---|---|---|---|
| <attributeAssessment> | role, eventType, key, attributeType, offset | – | <assessmentStatement> |
Attributes
| Name | Value | Description |
|---|---|---|
| role | String. | The role attribute defines a connector interface point, which is associated to node interfaces by a link that refers to the connector. The role value must be unique within the set of roles of the connector. |
| eventType | “presentation”, “selection”, or “attribution”. | The eventType attribute identifies the type of event for the action or condition. |
| key | At least the following values (case sensitive) must be accepted for the key attribute: “0”, “1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “A”, “B”, “C”, “D”, “E”, “F”, “G”, “H”, “I”, “J”, “K”, “L”, “M”, “N”, “O”, “P”, “Q”, “R”, “S”, “T”, “U”, “V”, “W”, “X”, “Y”, “Z”, “*”, ”#”, “MENU”, “INFO”, “GUIDE”, “CURSOR_DOWN”, “CURSOR_LEFT”, “CURSOR_RIGHT”, “CURSOR_UP”, “CHANNEL_DOWN”, “CHANNEL_UP”, “VOLUME_DOWN”, “VOLUME_UP”, “ENTER”, “RED”, “GREEN”, “YELLOW”, “BLUE”, “BACK”, “EXIT”, “POWER”, “REWIND”, “STOP”, “EJECT”, “PLAY”, “RECORD”, and “PAUSE”. | The key attribute identifies the selection key used for the selection. |
| attributeType | “nodeProperty” (only in the case of eventType=“attribution”), “occurrences”, “repetition”, or “state”. The default values are: “nodeProperty” if eventType=“attribution”, or “occurrences” if eventType=“selection”. | The attributeType attribute identifies the variable to be evaluated in a <assessmentStatement> element. |
| offset | String. | The offset attribute specifies a value to be added to the selected variable before its evaluation in a <assessmentStatement> element. |