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.

Copy code

    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-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: