SAP GUI Functions (SAPGUI) > Alphabetical List of Functions > sapgui_grid_select_columns

sapgui_grid_select_columns

Example: sapgui_grid_select_columns Grid Functions

Selects one or more columns in a grid.

int sapgui_grid_select_columns( const char *description, const char *gridID, char *arg1, ..., char *argn, [optionalArgs,] LAST ); 
description User entered text to aid in understanding script
gridID Object ID Strings
arg1...argn A list of Grid column identifiers. The list must be terminated with either an optional arguments clause or with LAST. 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.
optionalArgs Optional Arguments
LAST A marker indicating the end of the argument list. Not required if Optional Arguments are used.

sapgui_grid_select_columns selects one or more columns in a grid control. The columns do not have to be adjacent. They do not have to be passed to the function in the order in which they appear in the grid.

The column listmust be terminated even if only one column ID is passed.

To select only one column, you can also use sapgui_grid_select_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.