This topic has not yet been rated - Rate this topic

Control Element

Customer Care Framework

This section describes the various WebDDA binding’s elements.

<AnchorElement> associates a named control to an <a/> HTML element.


                    <AnchorElement name="control name">
   Search Path Elements
</AnchorElement>

Element	Description
FindControl	Returns “true” or “false” whether control can be found on UI
GetControlValue	Returns URL text.
SetControlValue	Throws UnsupportedControlOperation exception
ExecuteControlAction	Navigates to the specified URL.

ButtonElement

<ButtonElement> associates a named control to an <button/> HTML element.

XML


                    <ButtonElement name="control name">
   Search Path Elements
</ButtonElement>

Element	Description
FindControl	Returns “true” or “false” whether control can be found on UI
GetControlValue	Returns URL text.
SetControlValue	Throws UnsupportedControlOperation exception
ExecuteControlAction	Executes a click() command on the control

InputElement

<InputElement> associates a named control with an <input/> HTML element if the element has one of the following type=attribute values: check box, radio, text, password, submit, reset, hidden, image, or file.

XML


                    <InputElement name="control name" type="type">
   Search Path Elements
</InputElement>

Element	Description
FindControl	Returns “true” if it finds the element on the page or “false” if it does not find the element.
GetControlValue	Returns “true” or “false” (string-valued) when type=”checkbox” or “radio”. Returns the value of the element for all other types.
SetControlValue	Sets to “true” or “false” when type=”checkbox” or “radio”. Sets the value of the element when type=”text” or “password” or “hidden”. Throws UnsupportedControlOperation exception for all other types.
ExecuteControlAction	Inverts an existing “true”/”false” state when type=”checkbox”. Sets state to “true” when type=”radio”. Returns UnsupportedControlOperation when type=”text” or “password” or “hidden”. Issues a Click() for all other types.

SelectElement

<SelectElement> searches for a named control on an HTML page, and returns or reverses its value.

XML


                    <SelectElement name=" control name">
   Search Path Elements
</SelectElement>

Element	Description
FindControl	Returns “true” or “false” whether control can be found in the UI
GetControlValue	Returns the selected item(s), as a comma-separated list
SetControlValue	Inverts the selection status of the first matching item in the list. This clears the entire selection when the provided set text is empty.
ExecuteControlAction	For single-selection modes, this inverts the selection status of the current selection. For multi-selection modes, it adds the next unselected item to the current selection

TextAreaElement

<TextAreaElement> associates a named control with a text area element on the HTML page.

XML


                    <TextAreaElement name="name goes here">
   Search Path Elements
</TextAreaElement>

Element	Description
FindControl	Returns “true” or “false” whether control can be found in the UI
GetControlValue	Returns the value of the text area element
SetControlValue	Sets the value of a text area element
ExecuteControlAction	Throws UnsupportedControlOperation exception.

HtmlElement

<HTMLElement> associates a named control to the HTML object specified by the search path.

XML


                    <ButtonElement name="control name">
   Search Path Elements
</ButtonElement>

Element	Description
FindControl	Returns “true” or “false” whether control can be found in the UI
GetControlValue	Returns the content of the HTML object.
SetControlValue	Throws UnsupportedControlOperation exception
ExecuteControlAction	Executes a click() command on the control

HyperLink

The HyperLink element does not define an element on the Web applications UI but allows navigating to a specified URL. In difference to the other element types defined below, this element does not allow to navigate through the DOM tree (e.g. using <ElementMatchPath/>), it only takes the <Url> tag to specify the target URL.

XML


                    <HyperLink name="control name">
   <Url>http://www.urlgoeshere.org</Url>
</HyperLink>

Element	Description
FindControl	Returns whether control can be found in the bindings. Keep in mind the control does not exist on the UI just in the bindings.
GetControlValue	Returns URL text.
SetControlValue	Set the value of the control to the specified URL.
ExecuteControlAction	Navigates to the specified URL.

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)