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
setting = dw1.Object.rpt_1.Nest_Arguments
dw1.Object.rpt_1.Nest_Arguments = &
"((~"cust_id~"),(~"'Eastern'~"))"
setting = dw1.Describe("rpt_1.Nest_Arguments")
dw1.Modify("rpt_1.Nest_Arguments" "=((~"cust_id~"), (~"'Eastern'~"))")
dw1.Modify("rpt_1.Nest_Arguments=()")