FormGroupControl.heightMode Method

Definition

Overloads

heightMode()

Gets or sets a calculation mode for the height of the control.

heightMode(Int32)

heightMode()

Gets or sets a calculation mode for the height of the control.

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

Returns

The 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.

The following example shows a call to the heightMode method to adjust the control height, based on an exact pixel value.

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.heightMode(-1); 
    formGroupControl.heightValue(120); 
}

Applies to

heightMode(Int32)

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

Parameters

_value
Int32

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

Returns

Applies to