User Interactions

11 Feb 201912 minutes to read

Tooltip for the data points can be enabled using the “Visible” option of the Tooltip property under “CommonSeriesOptions” of the PivotChart.

CSHTML

//Enabling tooltip of data point
@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).CommonSeriesOptions(comm => { comm.Tooltip(tool => { tool.Visible(true); })}).Size(size => size.Height("460px").Width("100%"))

Tooltip in ASP NET MVC pivot chart control

HTML elements can be displayed inside 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.

CSHTML

<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>
//Enabling tooltip of data point
@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).CommonSeriesOptions(comm => { comm.Tooltip(tool => { tool.Visible(true).Template("Tooltip"); });}).Size(size => size.Height("460px").Width("100%"))

Tooltip template in ASP NET MVC pivot chart control

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

CSHTML

//Change tooltip color and border
@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).CommonSeriesOptions(comm => { comm.Tooltip(tool => { tool.Visible(true). Fill("#FF9933").Border(border => border.Width(1).Color("#993300")); });}).Size(size => size.Height("460px").Width("100%"))

Tooltip customization in ASP NET MVC pivot chart control

The tooltip properties, RX and RY are used to customize its corner radius.

CSHTML

//Customize the corner radius of the tooltip rectangle.
@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).CommonSeriesOptions(comm => { comm.Tooltip(tool => { tool.Visible(true).RX(50).RY(50);});}).Size(size => size.Height("460px").Width("100%"))

Tooltip with rounded corners in ASP NET MVC pivot chart control

Zooming and Panning

Enable Zooming

There are two ways to zoom the Chart:

When zooming.Enable option is set to true, you can zoom the Chart by using rubber band selection.
When zooming.EnableMouseWheel option is set to true, you can zoom the Chart on mouse wheel scrolling.

CSHTML

//Enable zooming in chart
@Html.EJ().Pivot().PivotChart("PivotChart1").Zooming(zoom=> zoom.Enable(true)).Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px"))

Zooming in ASP NET MVC pivot chart control

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

Panning in ASP NET MVC pivot chart control

Types of Zooming

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

NOTE

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

CSHTML

//Enable horizontal zooming
@Html.EJ().Pivot().PivotChart("PivotChart1").Zooming(zoom=> zoom.Enable(true).Type("x")).Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px"))

Enable Scrollbar

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

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Zooming(zoom => { zoom.EnableScrollbar(true); })

Scrollbar in ASP NET MVC pivot chart control

Marker and Crosshair

Marker Shape Customization

In PivotChart, you can customize the marker shape with following symbols.

Rectangle
Circle
Cross
Diamond
Pentagon
Hexagon
Star
Ellipse
Triangle etc.

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).CommonSeriesOptions(comm => { comm.Type(SeriesType.Line);}).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   function onSeriesRenders(args) {
      for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
        this.model.series[seriescount].marker.shape = "Triangle";
</script>

Marker customization in ASP NET MVC pivot chart control

Enable Crosshair and Crosshair Label

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

CSHTML

//Initializing Crosshair and crosshair label
@Html.EJ().Pivot().PivotChart("PivotChart1").CrossHair(crossHair => crossHair.Visible(true)).PrimaryXAxis(primaryX => primaryX.CrosshairLabel(crosshairlabel => crosshairlabel.Visible(true))).Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px"))

Visibility of crosshair label in ASP NET MVC pivot chart control

Crosshair Line and Label Customization

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

CSHTML

//Customizing the crosshair label background color and border
@Html.EJ().Pivot().PivotChart("PivotChart1").CrossHair(crossHair => crossHair.Line(line => line.Color("gray").Width(2)).Visible(true)).PrimaryXAxis(primaryX => primaryX.CrosshairLabel(crosshairlabel => crosshairlabel.Visible(true).Fill("red").Border(border => border.Color("green").Width(2)))).PrimaryYAxis(primaryy => primaryy.CrosshairLabel(crosshairlabel => crosshairlabel.Visible(true))).Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px"))

Customization of crosshair line and label in ASP NET MVC 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”.

CSHTML

//Change crosshair type to track ball
@Html.EJ().Pivot().PivotChart("PivotChart1").CrossHair(crossHair => crossHair.Visible(true).Type(CrosshairType.Trackball)).Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px"))

Trackball in ASP NET MVC pivot chart control

Trackball Marker and Line Customization

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

CSHTML

//Customize the trackball line color and width and Marker visible and shape
@Html.EJ().Pivot().PivotChart("PivotChart1").CrossHair(crossHair => crossHair.Visible(true).Type(CrosshairType.Trackball).Line(line => line.Color("#800000").Width(2)).Marker(marker => marker.Shape(ChartShape.Pentagon).Size(size => size.Height(9).Width(9)).Visible(true))).Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px"))

Customization of Trackball in ASP NET MVC pivot chart control

Highlight

PivotChart provides highlighting support for the series and data points on mouse hover. To enable highlighting, set the “enable” property to true in the highlightSettings option of the series.

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   function onSeriesRenders(args) {
      for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
        this.model.series[seriescount].highlightSettings.enable = true
</script>

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

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   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>

Highlight mode in ASP NET MVC pivot chart control

Customize the Highlight Styles

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

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   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>

Highlight style in ASP NET MVC pivot chart control

Patterns to Highlight

PivotChart 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

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   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>

Highlight settings in ASP NET MVC pivot chart control

Selection

PivotChart provides selection support for the series and data points on mouse click. To enable selection, set the “enable” property to true in the selectionSettings option of the series.

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   function onSeriesRenders(args) {
      for (var seriescount = 0; seriescount < this.model.series.length; seriescount++)
        this.model.series[seriescount].selectionSettings.enable = true
</script>

Selection Mode

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

series
points
cluster

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   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>

Selection mode in ASP NET MVC pivot chart control

Customize the Selection Styles

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

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   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.opacity = "0.5";
        this.model.series[seriescount].selectionSettings.border.width = "1.5";
        this.model.series[seriescount].selectionSettings.border.color = "red";
    }
</script>

Selection style in ASP NET MVC pivot chart control

Patterns for Selection

PivotChart provides pattern support for the selecting the data by setting an appropriate value to the pattern property of the selectionSettings option. 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

CSHTML

@Html.EJ().Pivot().PivotChart("PivotChart1").Url(Url.Content("/RelationalChartService.svc")).Size(size => size.Height("460px").Width("950px")).ClientSideEvents(
    oEve => { oEve.SeriesRendering("onSeriesRenders"); })
<script>
   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>

Selection settings in ASP NET MVC 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