FormListControl.heightMode Method
Gets or sets a calculation mode for the height of the control.
Syntax
public int heightMode([int value])
Run On
Client
Parameters
- value
Type: int
An integer that indicates how the height of the control is calculated; optional. This value can be -1 for Exact mode, 0 for Auto mode, or 1 for Column height width.
Return Value
Type: int
The height calculation mode.
Remarks
Calculate the height according to the following table.
Mode |
Height calculation |
|---|---|
Exact |
The exact height of the control in pixels is used. |
Auto |
The height of the control is calculated automatically, and the value parameter is ignored. |
Column height |
The layout of the form determines the height of the control. |
The height of the control might change when the calculation mode is set to Auto or Column height.
Examples
The following example shows a call to the heightMode method to adjust the height of the control, based on an exact pixel value.
static void createForm(Args _args)
{
Args args;
Form form;
FormRun formRun;
FormBuildDesign formBuildDesign;
FormBuildDataSource formBuildDataSource;
FormBuildListControl formBuildListControl;
FormListControl formListControl;
int idx4;
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 a form list control.
formBuildListControl =
formBuildDesign.addControl(FormControlType::ListView,"List");
idx4 = formBuildListControl.id();
args = new Args();
args.object(form);
// Create the run-time form, and then specifiy the control height.
formRun = classfactory.formRunClass(args);
formRun.run();
formRun.detach();
formListControl = formRun.control(idx4);
formListControl.heightMode(-1);
formListControl.heightValue(120);
}