Selection Type property

This documentation is valid for:

Defines the behavior of the Grid's rows when they are selected.

Values

Keep selection while executing	The selection ends when the Default Action ends.
Keep until new selection	The selection ends when another selection is made.
No selection	The tapped row will not be selected.
Platform Default	Default value. Uses the platform default behavior.

Scope

Generators: Android, Apple
Controls: Grid

Description

Values

Value	Description
Platform Default	Default value. Uses the platform default behavior.
No Selection	The tapped row will not be selected. • The grid's Highlighted Background color is shown while the user interacts with the control. • The Default Selected Item Layout is not going to be shown even if it is defined or not. • The SelectionChanged Event will not be triggered. Note: Until GeneXus 15 Upgrade 5, the No Selection value was known as Autodeselect.
Keep Selection While Executing	The selection ends when the Default Action ends. • If the Default Selected Item Layout is defined it is shown, if not, the grid's Highlighted Background color is shown. • This value only makes sense when the Default Action or SelectionChanged Event of the Grid are defined. • If an item is selected, and the user selects it again, the item is still going to be selected and the Default Action of the Grid is executed again.
Keep Until New Selection	The selection ends when another selection is done. • If the Default Selected Item Layout is defined it is shown, if not, the grid's Highlighted Background color is shown. • This value only makes sense when the Default Selected Item Layout is defined. • If an item is selected, and the user selects it again, the item is going to be deselected and the Default Action is executed again.

Platform Default values

For Apple:

If the Default Action is defined, then the Keep Selection While Executing value is the default.
If the Default Action is not defined and the Default Selected Item Layout is defined, then the Keep Until New Selection value is the default.

For Android:

If the Default Action is defined, then the No Selection value is the default.
If the Default Action is not defined and the Default Selected Item Layout is defined, then the Keep Until New Selection value is the default.

For Multiple Selection

Will behave such as the Keep Until New Selection value.

Runtime/Design time

This property applies only at design-time.

Let's take as an example the EventDay sample KB and see how different values of the Selection Type property changes the behavior of a row when it is selected. For instance in the Sessions Grid at the List level of the WWSD Session:

Using the Auto Deselect value the Highlighted Background color is shown only when the user presses the row, after that the row is deselected automatically: