Share via


FormGroupControl.height Method

Definition

Overloads

height(Int32)

Gets or sets the height of the control.

height(Int32, Int32)

height(Int32)

Gets or sets the height of the control.

public:
 override int height(int num1);
public override int height (int num1);
override this.height : int -> int
Public Overrides Function height (num1 As Integer) As Integer

Parameters

num1
Int32

Returns

The height of the control in pixels.

Remarks

Exact mode is used if the value parameter is omitted. Calculate the height according to the following table.

Mode Height calculation
Exact (-1) The exact height of the control in pixels is used.
Auto (0) The height of the control is calculated automatically, and the value parameter is ignored.
Column height (1) The layout of the form determines the height of the control.

The height and the height calculation mode can be set separately.

The following example shows a call to the height method to the set the control height to 120 pixels.

static void createForm(Args _args) 
{ 
    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.height(120, -1); 
}

Applies to

height(Int32, Int32)

public:
 override int height(int _value, int _mode);
public override int height (int _value, int _mode);
override this.height : int * int -> int
Public Overrides Function height (_value As Integer, _mode As Integer) As Integer

Parameters

_value
Int32

An integer value that indicates how the height is calculated; optional.

_mode
Int32

An integer value that indicates how the height is calculated; optional.

Returns

Applies to