FormGroupControl.topValue Method
Sets or returns the vertical position of a form group control in pixels.
Syntax
public int topValue([int value])
Run On
Client
Parameters
- value
Type: int
An Integer data type that specifies the vertical position.
Return Value
Type: int
An Integer data type value that specifies the vertical position of a form group control.
Remarks
The vertical position is not changed unless the top mode is set for an exact pixel value. For more information, see the topMode method.
Examples
The following example shows a call to the topValue method that sets the vertical position to 50 pixels.
void FormGoupControl()
{
Args args;
Form form;
FormRun formRun;
FormBuildDesign formBuildDesign;
FormBuildDataSource formBuildDataSource;
FormBuildStringControl formBuildStringControl;
FormBuildGroupControl formBuildGroupControl;
FormGroupControl formGroupControl;
int idx;
DictTable dictTable;
CustTable custTable;
// Create the form header.
form = new Form();
// Add data sources to the form.
dictTable = new DictTable(tableNum(custTable));
formBuildDataSource = form.addDataSource(dictTable.name());
formBuildDataSource.table(dictTable.id());
// Create the form design.
formBuildDesign = form.addDesign("Design");
formBuildDesign.caption("myForm");
// Add controls.
formBuildGroupControl =
formBuildDesign.addControl(FormControlType::Group,"Group");
idx = formBuildGroupControl.id();
formBuildStringControl =
formBuildGroupControl.addControl(FormControlType::String,"String");
// Add data fields to the controls.
formBuildGroupControl.dataSource(formBuildDataSource.id());
formBuildStringControl.dataSource(formBuildDataSource.id());
formBuildStringControl.dataField(2);
args = new Args();
args.object(form);
// Create the run-time form.
formRun = classfactory.formRunClass(args);
formRun.run();
formRun.detach();
formGroupControl = formRun.control(idx);
formGroupControl.topMode(-1);
formGroupControl.topValue(50);
}