sapgui_grid_select_cell_row

Grid Functions

Selects a cell in current column in specified row.

int sapgui_grid_select_cell_row( const char *description, const char *gridID, const char *row, [args,] LAST );
description User entered text to aid in understanding script
gridIDObject ID Strings
row Grid row number. The first data row is numbered zero (0). If there is a header row it is numbered (-1).
argsOptional Arguments
LAST A marker indicating the end of the argument list. Not required if Optional Arguments are used.

sapgui_grid_select_cell_row selects a cell in the same column as the current selection, but a different row. It moves the selection point up or down in the same column to the row number specified by row.

Return Values

This function returns LR_PASS (0) on success or LR_FAIL (1) on failure.

Parameterization

You can parameterize all string (char type) arguments.

Example

The following example uses sapgui_grid_select_cell_row to select a cell in the same column as the current selection, but a different row.

// Save the Grid ID in variable "GridID"
lr_save_string
    ("usr/cntlBCALVC_TOOLBAR_D100_C1/shellcont/shell",
    "GridID");
// Select eighth row (row 7), Column CARRID
sapgui_grid_select_cell("'Overview' (7, Airline carrier)", 
        "{GridID}", 
        "7", 
        "CARRID", 
        BEGIN_OPTIONAL, 
            "AdditionalInfo=sapgui1062", 
        END_OPTIONAL);
// Select seventh row (row 6), Column CARRID
sapgui_grid_select_cell_row("Move selection to another row", 
        "{GridID}", 
        "6", 
        LAST );
// Select row 6, Column CITYFROM
sapgui_grid_select_cell_column("Move selection to another column", 
        "{GridID}", 
        "CITYFROM", 
        LAST );