FormGroupControl.width Method

Definition

Namespace:

Dynamics.AX.Application

Assembly:

Overloads

width(Int32)	Gets or sets the width of the control.
width(Int32, Int32)

width(Int32)

Gets or sets the width of the control.

public:
 override int width(int num1);

public override int width (int num1);

override this.width : int -> int

Public Overrides Function width (num1 As Integer) As Integer

Parameters

num1

Int32

Returns

Int32

The width of the control in pixels.

Remarks

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

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

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

The following example shows a call to the width method to set the control width to 200 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.width(200,-1); 
}

width(Int32, Int32)

public:
 override int width(int _value, int _mode);

public override int width (int _value, int _mode);

override this.width : int * int -> int

Public Overrides Function width (_value As Integer, _mode As Integer) As Integer

Parameters

_value

Int32

An integer that indicates how the width is calculated. This can be one of the following values:

_mode

Int32

An integer that indicates how the width is calculated. This can be one of the following values:

Returns

Int32