Share this page

# 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
gridID | Object 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
args | Optional 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 );

Tips to improve your search results... VuGen Function Reference Version 26.1 Function Reference 26.1 All View Local Help Center View Online Help Center Version: