Version

xamEditors - Testable User Actions and Elements

Topic Overview

Purpose

This topic provides information about the user actions of the xamEditors controls which you can test and the elements you can inspect. For information about the editor-specific user actions and inspectable elements for a particular editor, see its respective topic.

Supported editor controls

The methods covered in this topic apply to the following controls:

  • xamCheckEditor™

  • xamComboEditor™

  • xamCurrencyEditor™

  • xamDateTimeEditor™

  • xamMaskedEditor™

  • xamNumericEditor™

  • xamTextEditor™

xamEditors Common Testable User Actions

Testable user actions chart

The table below lists the testable user actions of the control and maps them to recordable and replay-only methods that emulate them.

User action Method

Clearing the editor text

Clear

Closing of the editor drop-down list

CloseUp

Opening of the editor drop-down list

DropDown

Selecting all of the editor text

SelectAll

Setting an editor value

Set

Cursor positioning

SetCaretPos

Selecting all of the text in the editor

SetSelection

Adding text in the editor

SetText

xamEditors Common Testable Elements

Testable elements summary chart

The following table lists the elements in the control that you can test, the information you can retrieve about them, and the properties and methods that manage the retrieve operations.

Legend:

spy.png – Identification property (Visible in object spy)

checkpoint.png – Checkpoint property (Visible with checkpoints)

script.png – Accessible in script

Tested element Test deliverable Member type Test object member Accessibility

Editor

whether editing is allowed.

property

iseditingallowed

spy.png

whether the editor is in edit mode.

property

isineditmode

spy.png

whether the editor accepts null values.

property

isnullable

spy.png

whether the editor is read-only.

property

isreadonly

spy.png

Editor text

the editor display text.

property

displaytext

spy.png checkpoint.png

displayed text that in case the value is null.

property

nulltext

spy.png

Editor value

whether the editor value is changed.

property

hasvaluechanged

spy.png

whether the current value is valid.

property

isvaluevalid

spy.png

the value of the editor as text.

property

text

spy.png checkpoint.png script.png

the editor value.

property

value

spy.png checkpoint.png script.png

the type the editor expects as value.

property

valuetypename

spy.png

Editor drop-down

whether the editor has drop-down.

property

hasdropdown

spy.png

whether the drop-down is open.

property

Isdroppeddown

spy.png

Related Topics

The table below lists other topics you may find useful.

Topic Purpose

This topic provides information about the user actions of the xamComboEditor™ control which you can test and the elements you can inspect.

This topic provides information about the user actions of the xamMonthCalendar™ control which you can test and the elements you can inspect.