nca_list_select_index_item

Selects a list item by its index.

int nca_list_select_index_item( LPCSTR list, int index );

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.