This topic provides reference information about the recordable user methods for testing the navigation and selection actions in xamDataPresenter™ controls.
This topic contains the following sections:
The following table briefly explains the recordable methods for testing the control. Detailed information about the methods is provided in the text blocks following the table.
The ActivateCell method is used for recording and replaying the cell activation action performed by the user.
When replaying, this method performs some validations first and then activates a cell:
Validating the specified cell path,
Activating the cell
The method accepts as a parameter the cell path in the active field layout.
The path is formed by concatenating the record path and the field name or field index (the parenthesis and the brackets are part of the syntax):
{record path}[field name or field index]
For example, the cross-section of the first record and the field name is denoted as {0 }[ name], the cross-section of the first child record of the first record and the field name is denoted as {0}{0}[name] .
The following table explains the method’s parameters along with some sample code.
No default setting.
The following table lists the possible exceptions for the method and the reason that is likely to be causing them.
The ActivateRecord method is used for recording and replaying the record activation action performed by the user.
When replaying, this method performs some validations first and then activates the specified record:
Validating the specified record path,
Activating the record
The method accepts as a parameter the number of the record in the active field layout. The numbering starts from 0.
The record path is formed in the following way:
root record number
{root record number}{parent record number}
{root record number}{parent record number}{child record number}
The following table explains the method’s parameters along with some sample code.
No default setting.
The following table lists the possible exceptions for the method and the reason that is likely to be causing them.
The ExpandRecord method is used for recording and replaying the record expanding action performed by the user.
When replaying, this method performs some validations first and then expands the record:
Validating the specified record path,
Expanding the record
The method accepts as a parameter the record path in the active field layout.
The record path is formed in the following way:
root record number
{root record number}{parent record number}
{root record number}{parent record number}{child record number}
The following table explains the method’s parameters along with some sample code.
No default settings.
The following table lists the possible exceptions for the method and the reason that is likely to be causing them.
The CollapseRecord method is used for recording and replaying the record collapsing action performed by the user.
When replaying, this method performs some validations first and then collapses the record:
Validating the specified record path
Collapsing the record
The method accepts as a parameter the record path in the active field layout.
The record path is formed in the following way:
root record number
{root record number}{parent record number}
{root record number}{parent record number}{child record number}
The following table explains the method’s parameters along with some sample code.
No default settings.
The following table lists the possible exceptions for the method and the reason that is likely to be causing them.
The MoveField method is used for recording and replaying the moving of a particular field from the initial location to a new location performed by the user.
The method accepts as a parameter the name of the field to be moved and the customization information saved during the recording while the field moving is performed by the user.
The following table explains the method’s parameters.
No default settings.
No known exception.
The Select method is used for recording and replaying the item selection action performed by the user.
The method takes the selectable item type and an item as parameters.
The selectable item types are listed in the xamDataPresenter - Enumeration Reference topic.
The following table explains the method’s parameters along with some sample code.
No default setting.
The following table lists the possible exceptions for the method and the reason that is likely to be causing them.
The SelectionAdded method is used for recording and replaying the muliple selection action performed by the user.
The method accepts the selectable item type and item to be added in existing selection as parameters.
The selectable item types are listed in the xamDataPresenter - Enumeration Reference topic.
The following table explains the method’s parameters along with some sample code.
No default setting.
The following table lists the possible exceptions for the method and the reason that is likely to be causing them.
The SelectionRemoved method is used for recording and replaying the removal of an item from existing selection.
The method takes the selectable item type and item to be removed from existing selection as parameters.
The selectable item types are listed in the xamDataPresenter - Enumeration Reference topic.
The following table explains the method’s parameters together with some sample code.
No default settings.
The following table lists the possible exceptions for the method and the reason that is likely to be causing them.
The SelectionChanged method is used for recording and replaying the changes (adding and removing of items) in existing selection.
The method takes a selectable item type and items to be added and removed from existing selection as parameters.
The selectable item types are listed in the xamDataPresenter - Enumeration Reference topic.
The following table explains the method’s parameters along with some sample code.
No default setting.
The following table lists the possible exceptions for the method and the reason that is likely to be causing them.
The table below lists other topics you may find useful.