Nest_Arguments

Description

The values for the retrieval arguments of a nested report. The number of values in the list should match the number of retrieval arguments defined for the nested report.

Applies to

Report controls

Syntax

PowerBuilder dot notation:

dw_control.Object.reportname.Nest_Arguments

Describe and Modify argument:

"reportname.Nest_Arguments { = list } "

Parameter

Description

reportname

The name of the nested report for which you want to supply retrieval argument values.

list

A list of values for the retrieval arguments of the nested report. The format for the list is:

( ("arg1") {,("arg2") {,("arg3") {,... } } } )

Usage

The list is not a quoted string. It is surrounded by parentheses, and each argument value within the list is parenthesized, surrounded with double quotes, and separated by commas. If an argument is a literal string, use single quotes within the double quotes.

When changing the values for the retrieval arguments, you must supply values for all the retrieval arguments defined for the report. If you specify fewer or more arguments, an error will occur at runtime when the DataWindow retrieves its data.

To remove the report’s retrieval arguments, specify empty parentheses. If no arguments are specified, the user is prompted for the values at runtime.


In the painter

Select the control and set the value in the Properties view, General tab.

Examples

Example 1

setting = dw1.Object.rpt_1.Nest_Arguments

dw1.Object.rpt_1.Nest_Arguments = &

"((~"cust_id~"),(~"'Eastern'~"))"

Example 2

setting = dw1.Describe("rpt_1.Nest_Arguments")
dw1.Modify("rpt_1.Nest_Arguments" "=((~"cust_id~"),
   (~"'Eastern'~"))")
dw1.Modify("rpt_1.Nest_Arguments=()")