Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

Row Header Highlighting (xamPivotGrid)

Topic Overview

Purpose

Introduces the xamPivotGrid™ control’s Row Header Highlighting feature.

Required background

Prerequisite materials to understand this topic.

Topic Purpose

An overview of the xamPivotGrid control.

In this topic

Introduction

Row Header Highlighting Summary

Row Header Highlighting is an optional feature that enables the user to highlight a grid’s row header along with the entire row’s data cells when selected. This is an option of the row selection feature of the xamPivotGrid.

The benefit of highlighting the row header cell together with the rest of the selected row is that it enhances the visual impact of the displayed data by emphasizing existing groupings and hierarchies in the grid. The following screen shot illustrates just how effective highlighting can be in drawing attention to the cell value and how it relates to the data hierarchy in which it resides.

xamPivotGrid Row Header Highlighting 01.png

The Row Header Highlighting option can be toggled between disabled, its default state, and enabled by setting the xamPivotGrid control’s AllowRowHeaderSelection property.

Enabling Row Header Highlighting

Property settings

To highlight a row header once it is selected set AllowRowHeaderSelection to True.

Use this property: And set it to:

True

Code

In XAML:

AllowRowHeaderSelection="True"

In C#:

this.pivotGrid.SelectionSettings.AllowRowHeaderSelection = true;

In Visual Basic:

Me.pivotGrid.SelectionSettings.AllowRowHeaderSelection = True

Configuring Row Selection with Row Header Highlighting

Description

To enable the user to highlight the row header along with the rest of the row by selecting it, you will have to add the AllowRowHeaderSelection="True" declaration to the ig:PivotSelectionSettings object.

Code

In XAML:

<ig:XamPivotGrid
    x:Name="pivotGrid" DataSource="{Binding DataSource}">
    <ig:XamPivotGrid.SelectionSettings>
        <ig:PivotSelectionSettings
            AllowRowHeaderSelection="True"
            CellSelection="Single"
            CellSelectionAction="SelectRow"
            RowSelection="Single" />
    </ig:XamPivotGrid.SelectionSettings>
</ig:XamPivotGrid>

In C#:

this.pivotGrid.SelectionSettings.AllowRowHeaderSelection = true;
this.pivotGrid.SelectionSettings.CellSelection = Infragistics.Controls.Grids.PivotSelectionType.Single;
this.pivotGrid.SelectionSettings.CellSelectionAction = Infragistics.Controls.Grids.PivotCellSelectionAction.SelectRow;
this.pivotGrid.SelectionSettings.RowSelection = Infragistics.Controls.Grids.PivotSelectionType.Single;

In Visual Basic:

Me.pivotGrid.SelectionSettings.AllowRowHeaderSelection = True
Me.pivotGrid.SelectionSettings.CellSelection = Infragistics.Controls.Grids.PivotSelectionType.[Single]
Me.pivotGrid.SelectionSettings.CellSelectionAction = Infragistics.Controls.Grids.PivotCellSelectionAction.SelectRow
Me.pivotGrid.SelectionSettings.RowSelection = Infragistics.Controls.Grids.PivotSelectionType.[Single]

Related Content

Topics

The following topics provide additional information related to this topic.

Topic Purpose

This section serves as an introduction to the xamPivotGrid control’s key features and functionalities. The topics listed here will give you a better idea of why you would want to use the xamPivotGrid control in your applications.