FormListControl.widthMode Method

Article
2014-04-11

Gets or sets the calculation mode of the width of the control.

Syntax

public int widthMode([int value])

Run On

Client

Parameters

value
Type: int
An integer that indicates how the width of the control is calculated; optional.

Return Value

Type: int
An integer value that indicates the current width calculation mode.

Remarks

Calculate the width according to the following table.

Mode	Width calculation
Exact	The exact width of the control in pixels is used.
Auto	The width of the control is calculated automatically, and the value parameter is ignored.
Column width	The layout of the form determines the width of the control.

The width of the control might change when the calculation mode is set to Auto or Column width.

Examples

The following example shows a call to the widthMode method to calculate the width 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. 
    formRun = classfactory.formRunClass(args); 
 
    formRun.run(); 
    formRun.detach(); 
 
    formListControl = formRun.control(idx4); 
    formListControl.widthMode(-1); 
    formListControl.widthValue(120); 
}

Share via