416.467.9100 | Dundas Data Visualization | Login
Welcome Guest
This is the support page for the legacy Dundas Dashboard application. For assistance with the current Dundas BI application please click here.
Dashboard v5.0

This site makes extensive use of JavaScript.

Please enable JavaScript in your web browser and reload the page before proceeding.

Small Multiples - Interactions and Methods

Hide navigation
RSS
Modified on Tue, 28 May 2013 12:14 PM Categorized as Small Multiples
Click to return to: Documentation | Designing Dashboards | DV Controls | Small Multiples


Interactions

Click

The Click interaction lets you respond to mouse clicks on the control.

Arguments:


On Data Changed

The On Data Changed interaction lets you respond to changes in the control's underlying data.

These interactions run when the data changes in this data visualization control. This could be from a parameter change, or a real-time update. The real-time updates will cause this interaction to fire on the timer, regardless of whether the actual data changed.

Tip: On Data Changed happens only once per update, not once per changed data point. It will also happen if the values did not change.

ImageThis is an Advanced property.

Arguments:


On Layout Updated

The On Layout Updated interaction lets you respond when the layout is updated in this data visualization control. It is fired in the same scenarios as the On Data Changed Interactions with the exception that it is fired after the control has processed the updated data.

ImageThis is an Advanced property.

Arguments:


Methods

GenerateNextChildName( element )

Generates the name of the next child dashboard element.


Arguments:

  • element — A child element within a small multiples cell.

GetGeneratedCell ( element )

Gets the generated cell containing the given child element.


Arguments:

  • element — A child element within a small multiples cell.

Example:

Suppose you have a child control in the Cell Children collection of a small multiples control. Add a Click interaction script to the child control (from the Cell Children collection editor) and enter the following example script. This script gets the small multiples cell that contains the clicked element, and then changes background color of the cell.

DashboardSmallMultiplesCell cell = SmallMultiples1.GetGeneratedCell(sender); cell.Background = new DashboardSolidColorBrush(Colors.Green);

GetGeneratedChild ( sender, originalName )

Gets the generated child that is a sibling of the sender. A sibling dashboard element and the original name of the desired element must be provided as arguments. The element returned will be the one that is in the same cell as the sender and has the specified original name.


Arguments:

  • sender - The sibling dashboard element.
  • originalName - The original name of the desired cell child.

Example:

Suppose you have a small multiples control that has two cell children: ChartChild1 and LabelChild1. Add a Click interaction to the chart child (from the Cell Children collection editor) and enter the following interaction script. The script gets the sibling of the clicked element (chart), which will be the label child. Then it sets the label's text.

SmallMultiples1.GetGeneratedChild(sender, “LabelChild1”).Text = “Chart was clicked”;

GetGeneratedChild ( row, column, originalName )

Gets the generated child for a specific row and column index. The original name of the child control must also be provided as an argument. Returns the generated element with the specified original name in the cell at the specified row and column index.


Arguments:

  • row - The row index of the cell.
  • column - The column index of the cell.
  • originalName - The original name of the desired cell child.

Example:

Suppose you have a small multiples control that has a cell child: LabelChild1. Add the following interaction script to a dashboard Load interaction in order to modify the label text in cell (1,1):

SmallMultiples1.GetGeneratedChild(1, 1, “LabelChild1”).Text = “This is cell (1, 1)”;

GetGeneratedChild ( cell, originalName )

Gets the generated child for a specific cell. The original name of the child control must also be provided as an argument. Returns the generated element with the specified original name in the specified cell.


Arguments:

  • cell - The specified cell.
  • originalName - The original name of the desired cell child.

Example:

Suppose you have a small multiples control that has a cell child: LabelChild1. Add the following interaction script to a dashboard Load interaction in order to have the label child in each cell display the corresponding color dimension value for that cell:

foreach (DashboardSmallMultiplesCell cell in SmallMultiples1.Cells) { SmallMultiples1.GetGeneratedChild(cell, "LabelChild1").Text = "Color Dimension: " + cell.ColorDimensionValue; }

Related topics


Click to return to: Documentation | Designing Dashboards | DV Controls | Small Multiples

About Dundas | Contact Us Follow us on Twitter! | Privacy Statement | Report Site Issues

Copyright © 2009-2014 Dundas Data Visualization, Inc.