IEaxTitle.TagSelection

Syntax

TagSelection(Tag: String): IDimSelection;

Parameters

Tag. Metric substitution.

Description

The TagSelection property determines substitution for visualizer metric in express report header.

Comments

On value getting, the property processes substitution and returns copy of selection by metrics dimension where elements corresponding to substitution are selected.

On setting the value, the property extracts elements from selection and sets in visualizer metric (data slice for synchronized metrics) corresponding to substitution.

Substitutions visualization:

for synchronized metrics:

&[Metric.Color]. The Color metric.
&[Metric.Size]. The Size metric.
&[Metric.Value]. The Value metric. The substitution is analogical to &[Metric.Color];

for unsynchronized metrics - &[Visualizer.Metric.Indicator], where:

Visualizer is a visualizer name (Grid - table, Chart - chart, Map - map, BubbleChart - bubble chart, TreeMap - tree map, BubbleTree - bubble tree).
Indicator - metric name. Names are presented by visualizers enumerations values:

For table - EaxGridIndicatorType.
For map - EaxMapIndicatorType.
For bubble chart - EaxBubbleChartIndicators.
For bubble tree - EaxBubbleTreeIndicators.
For tree map - EaxTreeMapIndicators.

NOTE. In the Tag parameter write substitution without signs. For example, the &[Metric.Color] substitution describes as Metric.Color.

Example

Executing the example requires that the repository contains the following:

A form containing the UiErAnalyzer component with the UiErAnalyzer1 identifier.
An express report containing a bubble chart. Set the X metric and a selection to the bubble chart. A express report is a data source for UiErAnalyzer1.

Add a link to the Dimensions system assembly.

Sub UserProc;
Var
    T: IEaxTitle;
    Sel: IDimSelection;
Begin
    T := UiErAnalyzer1.ErAnalyzer.TitleBar;
    Sel := T.TagSelection("BubbleChart.Metric.X");
    If Sel <> Null Then
        Debug.WriteLine("Metrics dimension selection - " + Sel.ToString("", ",", False));
    Else
        Debug.WriteLine("Metrics dimension is not found for specified substitution");
    End If;
End Sub UserProc;

After executing the example the console displays selection elements of metrics dimension.