Version

Summaries

Topic Overview

Purpose

This topic provides reference information about the recordable user methods for testing the summary feature in xamDataPresenter™ controls.

In this topic

This topic contains the following sections:

Recordable Methods Summary

Recordable methods summary chart

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.

Method Description

CloseSummaryDropDown

Closes a summary selection dialog box for specified header.

OpenSummaryDropDown

Opens a summary selection dialog box for specified header.

CloseSummaryDropDown Method

Description

The CloseSummaryDropDown method is used for recording and replaying the closing of the summary drop-down menu.

Details

This method takes a header path as a required parameter.

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] .

Parameters

The following table explains the method’s parameters along with some sample code.

Method parameter Description

Header path

Using the header path as a parameter.

Example

Closing of the summary menu for amount field:

WpfWindow("MainWindow").XamDataGrid("XamDataGrid1").CloseSummaryDropDown "{0}[amount]"

Default setting

No default setting.

Possible exceptions

The following table lists the possible exceptions for the method and the reason that is likely to be causing them.

Exception name Exception description Possible reasons

The following items have not been found.

The specified item cannot be located when replaying the method.

The selected item path is not correct.

The argument is malformed.

The parameter is not format correctly.

The method parameter is not correctly formatted.

Summaries are not allowed for the supplied field.

Summary cannot be performed when replaying the method.

Summaries are disabled.

Summary Icon is not visible

Summary cannot be performed when replaying the method.

OpenSummaryDropDown Method

Description

The OpenSummaryDropDown method is used for recording and replaying the opening of the summary drop-down menu.

Details

This method takes a header path as a required parameter.

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] .

Parameters

The following table explains the method’s parameters along with some sample code.

Method parameter Description

Header path

Using the header path as a parameter.

Example

Opening of the summary menu for amount field , choosing summary operation S um and confirming the action by clicking the Ok button.

WpfWindow("MainWindow").XamDataGrid("XamDataGrid1").OpenSummaryDropDown "{0}[amount]"

WpfWindow("MainWindow").WpfCheckBox("Sum").Set "On"

WpfWindow("MainWindow").WpfButton("Ok").Click

Default setting

No default setting.

Possible exceptions

The following table lists the possible exceptions for the method and the reason that is likely to be causing them.

Exception name Exception description Possible reasons

The following items have not been found.

The specified item cannot be located when replaying the method.

The selected item path is not correct.

The argument is malformed.

The parameter is not format correctly.

The method parameter is not correctly formatted.

Summaries are not allowed for the supplied field.

Summary cannot be performed when replaying the method.

Summaries are disabled.

Summary Icon is not visible

Summary cannot be performed when replaying the method.

Related Content

Topics

The table below lists other topics you may find useful.

Topic Purpose

This topic provides reference information about the recordable user methods for testing the editing in xamDataPresenter controls.

This topic provides reference information about the recordable user methods for testing the filtering in xamDataPresenter controls.

This topic provides reference information about the recordable user methods for testing the navigation and selection actions in xamDataPresenter controls.

This topic provides reference information about the recordable user methods for testing the sorting and grouping user actions in xamDataPresenter controls.