Version

Touch-enabled WinGrid Control Elements

WinGrid Touchable Elements

Overview

The following sections illustrate the WinGrid ’s touchable elements and provide code examples demonstrating how to enable them.

Card expansion indicator

Card expansion indicator will display when a Band is in CardView mode with the CardSettings.Style set to Compressed style.

In C#:

ultraGrid1.DisplayLayout.Bands[0].CardView = true;
ultraGrid1.DisplayLayout.Bands[0].CardSettings.Style = CardStyle.Compressed;

In Visual Basic:

ultraGrid1.DisplayLayout.Bands(0).CardView = True
ultraGrid1.DisplayLayout.Bands(0).CardSettings.Style = CardStyle.Compressed
Touch WinGrid Control Elements 1.png

Column chooser button

Set the Override.RowSelectorHeaderStyle = ColumnChooserButton or ColumnChooserButtonFixedSize to enable the column chooser button, displayed above the row selectors.

Note
Note:

You must first enable the Row selector for the column choosers to appear.

In C#:

ultraGrid1.DisplayLayout.Override.RowSelectorHeaderStyle = RowSelectorHeaderStyle.ColumnChooserButton;

In Visual Basic:

ultraGrid1.DisplayLayout.Override.RowSelectorHeaderStyle = RowSelectorHeaderStyle.ColumnChooserButton
Touch WinGrid Control Elements 2.png

Column Header check box

Set the Override.HeaderCheckBoxVisibility = Always or WhenUsingCheckEditor to enable the check boxes on the column headers.

Touch WinGrid Control Elements 3.png

Filter clear button

Set the filter operator on the FilterRow to enable the filter clear button.

Touch WinGrid Control Elements 4.png

Filter drop-down button

The following code demonstrates how to enable the column header’s filter drop-down button.

In C#:

ultraGrid1.DisplayLayout.Override.AllowRowFiltering = DefaultableBoolean.True;

In Visual Basic:

ultraGrid1.DisplayLayout.Override.AllowRowFiltering = DefaultableBoolean.[True]
Touch WinGrid Control Elements 5.png

Filter operator

The following code demonstrates how to enable the FilterRow filter operator.

In C#:

ultraGrid1.DisplayLayout.Override.FilterUIType = FilterUIType.FilterRow;

In Visual Basic:

ultraGrid1.DisplayLayout.Override.FilterUIType = FilterUIType.FilterRow
Touch WinGrid Control Elements 6.png

Fixed header indicator

The following code demonstrates how to enable the column headers’ fixed header indicator.

In C#:

ultraGrid1.DisplayLayout.UseFixedHeaders = true;

In Visual Basic:

ultraGrid1.DisplayLayout.UseFixedHeaders = True
Touch WinGrid Control Elements 7.png

Fixed row indicator

The following code demonstrates how to enable the fixed row indicator displayed in the row selectors by setting the Override.FixedRowIndicator = Button .

In C#:

ultraGrid1.DisplayLayout.Override.FixedRowIndicator = FixedRowIndicator.Button;

In Visual Basic:

ultraGrid1.DisplayLayout.Override.FixedRowIndicator = FixedRowIndicator.Button
Touch WinGrid Control Elements 8.png

Row expansion indicator

The following code demonstrates how to enable the row’s row expansion indicators.

In C#:

ultraGrid1.DisplayLayout.Override.ExpansionIndicator = ShowExpansionIndicator.Always;

In Visual Basic:

ultraGrid1.DisplayLayout.Override.ExpansionIndicator = ShowExpansionIndicator.Always

Compare the before and after touch-enabled screenshots and notice that the expansion indicators are the same size, but the touchable area is larger when Touch is enabled.

Before enabling Touch

Touch WinGrid Control Elements 9.png

After enabling Touch

Touch WinGrid Control Elements 10.png

Row selector edit template

The following code demonstrates how to enable the row selectors in which the row edit template displayed.

In C#:

ultraGrid1.DisplayLayout.Override.RowEditTemplateUIType = RowEditTemplateUIType.RowSelectorImage;

In Visual Basic:

ultraGrid1.DisplayLayout.Override.RowEditTemplateUIType = RowEditTemplateUIType.RowSelectorImage
Touch WinGrid Control Elements 11.png

Row selector

The following code demonstrates how to enable the row selector.

In C#:

ultraGrid1.DisplayLayout.Bands[0].Override.RowSelectors = DefaultableBoolean.True;

In Visual Basic:

ultraGrid1.DisplayLayout.Bands(0).Override.RowSelectors = DefaultableBoolean.[True]
Touch WinGrid Control Elements 12.png

Row summary button

The following code demonstrates how to enable the row summary buttons displayed on the column headers.

In C#:

ultraGrid1.DisplayLayout.Override.AllowRowSummaries = AllowRowSummaries.True;

In Visual Basic:

ultraGrid1.DisplayLayout.Override.AllowRowSummaries = AllowRowSummaries.[True]
Touch WinGrid Control Elements 13.png

Swap button

The following code demonstrates how to enable the column header’s swap button on the column header, thus allowing column swapping within a group or band.

In C#:

ultraGrid1.DisplayLayout.Override.AllowColSwapping = AllowColSwapping.WithinBand;

In Visual Basic:

ultraGrid1.DisplayLayout.Override.AllowColSwapping = AllowColSwapping.WithinBand
Touch WinGrid Control Elements 14.png

Related Content

Topics

The following topics provide additional information related to this topic.

Topic Purpose

The topic provides conceptual overview about Touch feature of Infragistics touch-enabled controls.

This topic illustrates the Infragistics touch-enabled editor controls and elements.

This topic illustrates the Infragistics touch-enabled Tab controls and components, which include WinTab and WinTabStrip controls, and WinTabbedMdiManager component.

This topic illustrates the Infragistics touch-enabled WinListView control elements.

This topic illustrates the Infragistics touch-enabled WinTree control elements.