Share via


FormListControl.topMode Method

Sets or returns a value that indicates how the vertical position for a form list control is calculated.

Syntax

public int topMode([int value])

Run On

Client

Parameters

  • value
    Type: int
    An integer that indicates how the vertical position is calculated; optional.

Return Value

Type: int
An Integer data type value that indicates how the vertical position is calculated. The return value can be -1 or a FormTop enumeration value.

Remarks

The value parameter and return value are integer values that can be either -1 for an exact pixel value or a FormTop enumeration value.

For more information, see FormTop Enumeration.

Examples

The following example shows a call to the topMode method that calculates the vertical position 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.topMode(-1); 
    formListControl.topValue(50); 
}

See Also

FormListControl Class

FormListControl.topValue Method