Share this page

# nca_list_select_index_item

List Object Functions

Selects a list item by its index.

    int nca_list_select_index_item( LPCSTR list, int index );

list | The logical name of the list.

index | The numerical index of the item to be selected.

The nca_list_select_index_item function selects (performs a single mouse-click on) an item from a list. The item is indicated by its numeric index. The index is specified as a string, beginning with 0.

## Return Values

Oracle NCA Error Codes

## Parameterization

The following variable can be parameterized using standard parameterization: index

## Example

In the following example, the nca_list_select_index_item function selects Customers and Quick in the Responsibilities navigation window. Note that the selected options are activated with the subsequent pressing of the button.

    nca_set_window("Navigator - ABM Supervisor");
    nca_list_select_item("NAVIGATOR_HOTLIST_0", "1. Concurrent Requests: View All (User Mode)");
    nca_button_press("NAV_CONTROLS_OPEN_0");
    nca_set_window("Find Requests");

    //Select the item, by number and not by name
       // Original Recorded step
    //list_select_item("JOBS_QF_ORDERBY_0", "Requested Start Time");     //Modified step

    nca_list_select_index_item("JOBS_QF_ORDERBY_0", 3);
    nca_button_press("JOBS_QF_NEW_0");
    nca_set_window("Submit a New Request");
    nca_button_press("WHAT_TYPE_OK_0");

    Example: The output window displays the list objects:
         Sub Message Properties: action=2 handlerClassId=0x0 handlerId=386
            property=327 type=0x1000 value=0
            property=328 type=0x4000 value="Request ID"
            property=327 type=0x7000 value=1
            property=328 type=0x4000 value="Name"
            property=327 type=0x7000 value=2
            property=328 type=0x4000 value="Requested Start Time"
    showing that the Requested Start Time item is the third object.

Tips to improve your search results... VuGen Function Reference Version 26.1 Function Reference 26.1 All View Local Help Center View Online Help Center Version: