SetPosition
method (DataWindows)
Description
Moves a control within the DataWindow to another band or changes the
front-to-back order of controls within a band.
Applies to
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control, DataWindowChild object, DataStore |
Syntax
PowerBuilder
|
1 |
integer dwcontrol.SetPosition ( string controlname, string band, boolean bringtofront ) |
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to a DataWindow control or |
|
controlname |
The name of the control within the DataWindow that |
|
band |
A string whose value is the name of the band or layer Band names are detail, |
|
bringtofront |
A boolean indicating whether you want to bring
|
Return value
Returns 1 when it succeeds and -1 if an error occurs. If any
argument’s value is null, in PowerBuilder and JavaScript the method
returns null.
Usage
PowerBuilder environment
For setting the position of controls in the front-to-back order of
a PowerBuilder window, see the section called “SetPosition” in PowerScript Reference.
Examples
This statement moves oval_red in dw_rpt to the header and brings it
to the front:
|
1 |
dw_rpt.SetPosition("oval_red", "header", true) |
This statement does not change the position of oval_red , but does
bring it to the front:
|
1 |
dw_rpt.SetPosition("oval_red", "", true) |
This statement moves oval_red to the footer, but does not bring it
to the front:
|
1 |
dw_rpt.SetPosition("oval_red", "footer", false) |