Controls Interface

applyControlSpec(String sXML)

This method call is used trigger a redraw of the treemap according to the control spec that is passed in as argument.

Examples of XML control specs applications as follows.

Example XML control spec for group:

<?xml version='1.0' encoding='UTF-8'?>
<ControlSpec>
<HierarchySpec>
<GroupSpec level="1" attribute="Task" enum="true"><option background_color="0000ff" gutter_size="3"/></GroupSpec>
</HierarchySpec>
</ControlSpec>

Example XML control spec for size:

<?xml version='1.0' encoding='UTF-8'?>
<ControlSpec>
<SizeSpec attribute='Total_Alloc'/>
</ControlSpec>

Example XML control spec for color:

<?xml version='1.0' encoding='UTF-8'?>
<ControlSpec>
<ColorSpec attribute='Total_Alloc_Percent' color_range='Total_Alloc_PercentCLR'>
</ColorSpec>
</ControlSpec>

Example XML control spec for filter:

<?xml version='1.0' encoding='UTF-8'?>
<ControlSpec>
<FilterSpec type='filter'>
<FilterDef filterGroup='filterControl1' id='id2' attribute='Organization' operation='EQ'>
<param value='E-Solutions'/>
</FilterDef>
</FilterSpec>
</ControlSpec>

Example XML control spec for filter:

<ControlSpec>
<FilterGroupSpec name="fg1" type="filter" multiSelectOp="or">
<FilterDef attribute="Sales_Region" operation="EQ"
invert="false"><param value="Northeast"/></FilterDef>
<FilterDef attribute="Sales_Region" operation="EQ"
invert="false"><param value="Northwest"/></FilterDef>
</FilterGroupSpec>
</ControlSpec>

Example XML control spec for slider:

<ControlSpec>
<FilterSpec type='filter'>
<FilterDef filterGroup='hc_slider1a' attribute='Total_Alloc_Percent' operation='GTE'>
<param value='78.12'/>
</FilterDef>
</FilterSpec>
<FilterSpec type='filter'>
<FilterDef filterGroup='hc_slider1b' attribute='Total_Alloc_Percent' operation='LTE'>
<param value='185.08'/>
</FilterDef>
</FilterSpec>
</ControlSpec>

Example XML control spec for cell text:

<ControlSpec>
<CelltextSpec value="Project Manager: {Title}\nTotal Emp Alloc: {sigdigits(Total_Alloc_Percent,0)}%\nCurrent Alloc:
{sigdigits(Current_Alloc,0)}Hrs\nTotal Hrs Alloc: {sigdigits(Total_Alloc,0)}Hrs\n" />
</ControlSpec>

removeFilterGroup(String filterGroup)

This method call is used to remove the application of the given filter group, passed in as argument filterGroup to the call.

removeCelltext()

This method disables the visibility of text on the cells.