FormGroupControl.top Method

Definition

Namespace:

Dynamics.AX.Application

Assembly:

Overloads

top(Int32)	Sets or returns the vertical position of a form group control in pixels and specifies how the position is calculated.
top(Int32, Int32)

top(Int32)

Sets or returns the vertical position of a form group control in pixels and specifies how the position is calculated.

public:
 override int top(int num1);

public override int top (int num1);

override this.top : int -> int

Public Overrides Function top (num1 As Integer) As Integer

Parameters

num1

Int32

Returns

Int32

An integer value that indicates the vertical position of a form group control in pixels.

Remarks

The mode parameter can be one of the following values:

• default (-1) - Use Exact mode, where the value of the value parameter is used exactly.
• A FormTop enumeration value.

The following example calls the top method to set the vertical position to 50 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.top(50,-1); 
}

top(Int32, Int32)

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

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

override this.top : int * int -> int

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

Parameters

_value

Int32

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

_mode

Int32

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

Returns

Int32