Selection Type property

Official Content
This documentation is valid for:
Defines the behavior of the SD 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 done.
No selection The tapped row will not be selected.
Platform Default Default value. Uses the platform default behavior.

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 iOS:
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.

Scope

Platforms: Smart Devices(Android, IOS)
Controls: Grid for Smart Devices

See Also

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

Was this page helpful?
What Is This?
Your feedback about this content is important. Let us know what you think.