nca_lov_select_index_item

List Object Functions

Selects an item from a list of values by its index number.

int nca_lov_select_index_item( LPCSTR name, int index );
name The logical name of the window containing the list of values.
index The numerical index of the item to be selected.

The nca_lov_select_index_item function selects an item from a list of values using the item's index number.

Return Values

Oracle NCA Error Codes

Parameterization

The following variable can be parameterized using standard parameterization: name

Example

In the following example, each entry in the table called Journals is accessed. The function nca_obj_get_info retrieves the number of rows in the window. A for loop then sets the index i and the function nca_lov_select_index_item uses the indexto pull out each successive entry.

char num_rows_string[3];
int num_rows, i;
nca_set_window("Journals");
nca_lov_retrieve_items("Journals", 1, 18);
/* Find out how many entries in the "Journals" table there are */
nca_obj_get_info("Journals", "num_rows", num_rows_string);
num_rows = atoi(num_rows_string); /* num_rows holds the number of entries */
/* Iterate through each item */
for (i=1; i<num_rows; ++i) {
     nca_lov_select_index_item("Journals", i);
     /* To retrieve the next entries a switch is required */
     nca_menu_select_item("N", "File;Switch Responsibility...");
     nca_lov_retrieve_items("Journals", 1, num_rows);
}