Selection Type property

Official Content
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:
For Android:

For Multiple Selection

  • Will behave such as the Keep Until New Selection value.

Run-time/Design-time

This property applies only at design-time.

Samples

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:

Selection Type AutoDeselect Grid image Flecha_der Selection Type AutoDeselect iPad screenshot

Using the Keep Selection While Executing value the Highlighted Background color is shown until the Default Action ends:

Selection Type KeepWhile image Flecha_der Selection Type KeepWhile iPad screenshot

Availability

This property is available since GeneXus X Evolution 3.

See Also

Grids with Multiple Selection for Native Mobile Applications
Default Selected Item Layout property
Multiple Layouts for Smart Devices