FormListControl.topValue Method

Article
2014-04-11

Sets or returns the vertical position of a form list control in pixels.

Syntax

public int topValue([int value])

Run On

Client

Parameters

value
Type: int
An integer that specifies the vertical position; optional.

Return Value

Type: int
An integer that specifies the vertical position of a form list control.

Remarks

The vertical position is not changed unless the top mode is set for an exact pixel value. For more information, see topMode.

Examples

The following example shows a call to the topValue method that sets the vertical position to 50 pixels.

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); 
}

Share via