Official Content

In a web application, it highlights the selected Grid row with a color for performing actions with it.

Syntax

control. AllowSelection

Where:
control
    Is the name of a grid control inserted in the form.

Values

False
True

Scope

Generators: .NET, Java
Controls: Grid

Description

In a Grid, created within a Web Panel Web Layout or Transaction Web Layout, enabling the Allow Selection property as True allows the end-user to mark a row inside the Grid to work with it. This automatically sets the Allow Hovering property to its default value of True as well.

Default value: False.

Multiple selection is not supported. Only the selection of one line at a time is allowed.

You can use the arrow keys Up and Down to move between rows. Take into account the following considerations when using the arrow keys:

  • You can select the Grid row with the ENTER key.
  • The Grid OnLineActivate event is triggered if it is programmed in the object; otherwise, the Object's Enter event (if programmed) is triggered.
  • When both the mouse hover and arrow keys are used for movement, priority is given to the 'mouse hover' action.
  • When the Allow Selection property is enabled, the arrow keys automatically serve to select the Grid item.
  • By default, you must select at least one line (with the mouse) to be "located" in the Grid and iterate it with the arrows of the keyboard; Use Grid.SetFocus () method to avoid having to make the first click.
  • If you click outside the Grid or in any other field outside the Grid, the Grid is no longer iterable as it assumes that the focus has been removed.
  • Sort in Client Side of Grids is not supported.

Note: The option to iterate within the grid using the arrow keys (Up and Down) has been available since GeneXus 15 Upgrade 6.

Runtime/Design time

This property applies both at runtime and at design time.

See Also

Allow Hovering property
HoveringColor property
SelectionColor property

Last update: April 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant