sapgui_grid_select_cell_column

Grid Functions

Selects a cell in the current row in specified column.

int sapgui_grid_select_cell_column( const char *description, const char *gridID, const char *column, [args,] LAST );
description User entered text to aid in understanding script
gridIDObject ID Strings
column Grid column identifier. The column identifier string is inserted in the script during recording. This string is the field name defined in the SAP data dictionary. This identifier cannot be replaced with a column number
argsOptional Arguments
LAST A marker indicating the end of the argument list. Not required if Optional Arguments are used.

sapgui_grid_select_cell_column selects a cell in the same row as the current selection, but a different column. It moves the selection left or right in the same row to the column number specified by argument column.

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_column to select a cell in the same row as the current selection, but a different column.

// 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 );