You're currently browsing the Ignition 7.8 docs. Click here to view the latest docs.

General

Component Palette Icon:



IULocgo


Row Selector

Description

The row selector is a component that acts like a visual filter for datasets. It takes one dataset, chops it up into various ranges based on its configuration, and lets the user choose the splices. Then it creates a virtual dataset that only contains the rows that match the selected splices.

 

The most common way to splice the data is time. You could feed the row selector an input dataset that represents a large time range, and have it break it up by Month, Day, and then Shift, for example. Then you could power a report with the output dataset, and that would let the user dynamically create reports for any time range via an intuitive interface.

 

To configure the row selector, first you set up the appropriate bindings for its input dataset. Then you use its Customizer to alter the levels that it uses to break up the data. In the customizer, you add various filters that act upon columns in the input dataset, sorting them by various criteria. For example, you could choose a date column, and have it break that up by quarter. Then below that, you could have it use a discrete filter on a product code. This would let the user choose quarterly results for each product. Each level of filter you create in the customizer becomes a level in the selection hierarchy. Note that the output data is completely unchanged other than the fact that rows that don't match the current user selection aren't present.

 

This component is very handy for driving the Report Viewer, Table, and Classic Chart components, among others.


Additional information on the Row Selector can be found on the Row Selector Component page in the appendix.
Properties

Scripting
Scripting Functions

This component does not have scripting functions associated with it.

Extension Functions

This component does not have scripting functions associated with it.

Event Handlers

This event signifies a mouse click on the source component. A mouse click the combination of a mouse press and a mouse release, both of which must have occurred over the source component. Note that this event fires after the pressed and released events have fired.

This event fires when the mouse enters the space over the source component.

This event fires when the mouse leaves the space over the source component.

This event fires when a mouse button is pressed down on the source component.

This event fires when a mouse button is released, if that mouse button's press happened over this component.

Fires when the mouse moves over a component after a button has been pushed.

Fires when the mouse moves over a component, but no buttons are pushed.

Fires whenever a bindable property of the source component changes. This works for standard and custom (dynamic) properties.

Customizers

The row selector tree customizer allows you to customize the row filtering.

Examples

There are no examples associated with this component.

  • No labels