User interactions

11 Feb 201922 minutes to read

The tooltip for data points can be enabled by using the “Visible” option of the Tooltip property under “CommonSeriesOptions” of the pivot chart.

HTML

<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
    //Enabling tooltip of data point
    <CommonSeriesOptions Tooltip-Visible="True" />
    <Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Tooltip in ASP NET pivot chart control

HTML elements can be displayed in the tooltip by using the Template option. The template option takes the value of the “id” attribute from the HTML element. You can use the #point.x# and #point.y# as place holders in the HTML element to display the X and Y values of the corresponding data points.

HTML

<div id="Tooltip" style="display: none;">
    <div id="icon">
        <div id="ccicon"> </div>
    </div>
    <div id="value">
        <div>
            <label id="ccvalue">&nbsp;#point.y# </label>
            <label id="cc">Customer Count </label>
        </div>
    </div>
</div>
<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
    //Enabling tooltip of data point
    <CommonSeriesOptions Tooltip-Visible="True" Tooltip-Template="Tooltip" />
    <Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Tooltip template in ASP NET pivot chart control

By using Fill and Border properties of tooltip, you can customize its background color, border color, and border width.

HTML

<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
    //Change tooltip color and border
    <CommonSeriesOptions Tooltip-Visible="True" Tooltip-Fill="#FF9933" Tooltip-Border-Width="1" Tooltip-Border-Color="#993300" />
    <Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Tooltip customization in ASP NET pivot chart control

The tooltip properties Rx and Ry are used to customize its corner radius.

HTML

<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
    //Customize the corner radius of the tooltip rectangle.
    <CommonSeriesOptions Tooltip-Visible="True" Tooltip-RX="50" Tooltip-RY="50" />
    <Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Tooltip with rounded corners in ASP NET pivot chart control

Zooming and panning

Enable zooming

The following are the two ways to zoom the chart:

When Zooming.Enable is set to true, you can zoom the chart by using the rubber band selection.
When Zooming.EnableMouseWheel is set to true, you can zoom the chart by scrolling the mouse wheel.

HTML

//Enable zooming in chart
<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" Zooming-Enable="true" ClientIDMode="Static">
<Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Zooming in ASP NET pivot chart control

After zooming the chart, a zooming toolbar will appear with options to zoom, pan, and reset. Selecting the “Pan” will allow to view the chart and selecting the “Reset” will reset the zoomed chart.

Panning in ASP NET pivot chart control

Types of zooming

You can zoom the particular axis like horizontal axis or vertical axis or both axes by using the Type option in zooming.

NOTE

By default, the value for the Type option in zooming is “x,y” (indicating both axes) in the pivot chart.

HTML

//Enable horizontal zooming
<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" Zooming-Enable="true" Zooming-Type="x" ClientIDMode="Static">
<Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Enable scrollbar

When zooming.EnableScrollbar is set to true, the pivot chart is rendered with scroll bars for a precise view of the data. The data can be viewed by using the scroll bar or by scrolling the mouse wheel.

HTML

<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
<Zooming EnableScrollbar="true" />
<Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Scrollbar in ASP NET pivot chart control

Marker and crosshair

Marker shape customization

In pivot chart, you can customize the marker shape with following symbols:

Rectangle
Circle
Cross
Diamond
Pentagon
Hexagon
Star
Ellipse
Triangle etc.

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Line" />
        <ClientSideEvents Load="loadTheme" SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
                this.model.series[seriescount].marker.shape = "Triangle";
        }
    </script>
</body>

</html>

Marker customization in ASP NET pivot chart control

Enable crosshair and crosshair label

Crosshair helps you to view the value at mouse position or touch contact point. This can be enabled by using the Visible option in Crosshair property. The crosshair label can be enabled by using the “Visible” option in the CrosshairLabel property within its corresponding axis.

HTML

<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
    //Initializing Crosshair
    <CrossHair Visible="true"></CrossHair>
    //Enable crosshairLabel to X-Axis
    <PrimaryXAxis CrosshairLabel-Visible="true"></PrimaryXAxis>
    //Enable crosshairLabel to Y-Axis
    <PrimaryYAxis CrosshairLabel-Visible="true"></PrimaryYAxis>
    <Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Visibility of crosshair label in ASP NET pivot chart control

Crosshair line and label customization

By using the Line property of crosshair, you can customize its line color and width. By using Fill and Border properties of crosshair label, you can customize its background color, border color, and border width.

HTML

<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
    //Customizing the crosshair line
    <CrossHair Visible="true" Line-Width="2" Line-Color="Gray"></CrossHair>
    //Customizing the crosshair label background color and border
    <PrimaryXAxis CrosshairLabel-Visible="true" CrosshairLabel-Fill="Red" CrosshairLabel-Border-Color="Green" CrosshairLabel-Border-Width="2">
    </PrimaryXAxis>
    <PrimaryYAxis CrosshairLabel-Visible="true"></PrimaryYAxis>
    <Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Customization of crosshair line and label in ASP NET pivot chart control

Trackball

Enable trackball

Trackball can be enabled by setting both - Visible option of the crosshair to true and Type option of the crosshair to “Trackball”. The default value of type is “CrossHair”.

HTML

<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
    //Change crosshair type to track ball
    <CrossHair Visible="true" Type="TrackBall"></CrossHair>
    <Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Trackball in ASP NET pivot chart control

Trackball marker and line customization

Shape and size of the trackball marker can be customized by using the Shape and Size options of the crosshair marker. The color and width of the trackball line can be customized by using the “Line” option in the crosshair.

HTML

<ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
    //Customize the trackball line color and width, marker shape and visibility
    <CrossHair Visible="true" Line-Width="2" Line-Color="#800000'" Type="TrackBall" Marker-Shape="Pentagon" Marker-Visible="true"></CrossHair>
    <Size Width="950px" Height="460px"></Size>
</ej:PivotChart>

Customization of Trackball in ASP NET pivot chart control

Highlight

The pivot chart provides highlighting support for the series and data points by hovering the mouse. To enable highlighting, set the “enable” property to true in the highlightSettings of the series.

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Column" />
        <ClientSideEvents SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
                this.model.series[seriescount].highlightSettings.enable = true
        }
    </script>
</body>

</html>

Highlight mode

You can set three different modes for highlighting data points and series by using the mode property of the highlightSettings.

series
points
cluster

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Column" />
        <ClientSideEvents SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++) {
                this.model.series[seriescount].highlightSettings.enable = true
                this.model.series[seriescount].highlightSettings.mode = "series";
            }
        }
    </script>
</body>

</html>

Highlight mode in ASP NET pivot chart control

Customize the highlight styles

To customize the highlighted series, use border.color, border.width, and opacity options in the highlightSettings property.

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Column" />
        <ClientSideEvents SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++) {
                this.model.series[seriescount].highlightSettings.enable = true
                this.model.series[seriescount].highlightSettings.opacity = "0.5";
                this.model.series[seriescount].highlightSettings.border.width = "1.5";
                this.model.series[seriescount].highlightSettings.border.color = "red";
            }
        }
    </script>
</body>

</html>

Highlight style in ASP NET pivot chart control

Patterns to highlight

The pivot chart provides pattern support for highlighting the data by setting an appropriate value to the pattern property of the highlightSettings. The different types of highlight patterns are as follows:

chessboard
crosshatch
dots
pacman
grid
turquoise
star
triangle
circle
tile
horizontalDash
verticalDash
rectangle
box
verticalStripe
horizontalStripe
bubble
diagonalBackward
diagonalForward

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Column" />
        <ClientSideEvents SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++) {
                this.model.series[seriescount].highlightSettings.enable = true
                this.model.series[seriescount].highlightSettings.pattern = "chessboard";
            }
        }
    </script>
</body>

</html>

Highlight settings in ASP NET pivot chart control

Selection

The pivot chart provides selection support for the series and data points by clicking the mouse. To enable selection, set the “enable” property to true in the selectionSettings of the series.

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Column" />
        <ClientSideEvents SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++) {
                this.model.series[seriescount].selectionSettings.enable = true;
            }
        }
    </script>
</body>

</html>

Selection mode

You can set three different selection modes for highlighting the data points and series by using the mode property of the selectionSettings.

series
points
cluster

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Column" />
        <ClientSideEvents SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++) {
                this.model.series[seriescount].selectionSettings.enable = true;
                this.model.series[seriescount].selectionSettings.mode = "series";
            }
        }
    </script>
</body>

</html>

Selection mode in ASP NET pivot chart control

Customize the selection styles

To customize the selection styles, use the border.color, border.width, and opacity options in the selectionSettings.

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Column" />
        <ClientSideEvents SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++) {
                this.model.series[seriescount].selectionSettings.enable = true;
                this.model.series[seriescount].selectionSettings.border.width = "1.5";
                this.model.series[seriescount].selectionSettings.border.color = "red";
            }
        }
    </script>
</body>

</html>

Selection style in ASP NET pivot chart control

Patterns for selection

The pivot chart provides pattern support for selecting the data by setting an appropriate value to the pattern property of the selectionSettings. The different types of selection patterns are as follows:

chessboard
crosshatch
dots
pacman
grid
turquoise
star
triangle
circle
tile
horizontalDash
verticalDash
rectangle
box
verticalStripe
horizontalStripe
bubble
diagonalBackward
diagonalForward

HTML

<html xmlns="http://www.w3.org/1999/xhtml">
//...

<body>
    <ej:PivotChart ID="MyPivotChart1" runat="server" Url="/RelationalChartService.svc" ClientIDMode="Static">
        <CommonSeriesOptions Type="Column" />
        <ClientSideEvents SeriesRendering="onSeriesRenders" />
        <Size Width="950px" Height="460px"></Size>
    </ej:PivotChart>
    <script type="text/javascript">
        function onSeriesRenders(args) {
            for (var seriescount = 0; seriescount < this.model.series.length; seriescount++) {
                this.model.series[seriescount].selectionSettings.enable = true
                this.model.series[seriescount].selectionSettings.pattern = "chessboard";
            }
        }
    </script>
</body>

</html>

Selection settings in ASP NET pivot chart control

User interactions

Tooltip

Enable tooltip for data points

Tooltip template

Tooltip customization

Tooltip with rounded corners

Zooming and panning

Enable zooming

Types of zooming

Enable scrollbar

Marker and crosshair

Marker shape customization

Enable crosshair and crosshair label

Crosshair line and label customization

Trackball

Enable trackball

Trackball marker and line customization

Highlight

Highlight mode

Customize the highlight styles

Patterns to highlight

Selection

Selection mode

Customize the selection styles

Patterns for selection