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 object |
Syntax
PowerBuilder
integer dwcontrol.SetPosition ( string controlname, string band, boolean bringtofront )
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to a DataWindow control or DataStore. |
|
controlname |
The name of the control within the DataWindow that you want to move. You assign names to the controls in the DataWindow painter. |
|
band |
A string whose value is the name of the band or layer in which you want to position controlname. Layer names are background and foreground. Band names are detail, header, footer, summary, header.#, and trailer.#, where # is the group level number. Enter the empty string ("") if you do not want to change the band. |
|
bringtofront |
A boolean indicating whether you want to bring controlname to the front within the band:
|
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:
dw_rpt.SetPosition("oval_red", "header", true)This statement does not change the position of oval_red , but does bring it to the front:
dw_rpt.SetPosition("oval_red", "", true)This statement moves oval_red to the footer, but does not bring it to the front:
dw_rpt.SetPosition("oval_red", "footer", false)