public class

ReportGridDisplayCellRowHeader

extends ReportGridDisplayCellImpl
implements ReportGridCellRowHeader
java.lang.Object
   ↳ com.microstrategy.web.app.transforms.ReportGridDisplayCellImpl
     ↳ com.microstrategy.web.app.transforms.ReportGridDisplayCellRowHeader

This class is deprecated.
Please use the ReportGridCellRowHeader interface or extend the ReportGridCellRowHeaderImpl class.

Class Overview

This class represents a Row Header cell cell of the report grid.
This class has been deprecated along with all the ReportGridDisplayCell classes.
In its place, the Transform manipulates the cells through the ReportGridCell interface.

Summary

[Expand]
Inherited Constants
From interface com.microstrategy.web.app.transforms.ReportGridDisplayCell
[Expand]
Inherited Fields
From class com.microstrategy.web.app.transforms.ReportGridDisplayCellImpl
Public Constructors
ReportGridDisplayCellRowHeader()
Constructor used for creating a generic display cell.
ReportGridDisplayCellRowHeader(FormalParameters formalParas)
Constructor used for creating a generic display cell.
ReportGridDisplayCellRowHeader(ReportBean rb, WebTemplateMetric metric, FormalParameters formalParas)
Constructor used for creating a dummy display cell of row header in design mode when it's corresponding to a metric.
ReportGridDisplayCellRowHeader(ReportBean rb, WebTemplateUnit unit, FormalParameters formalParas)
Constructor used for creating a dummy display cell of row header in design mode when it's not corresponding to a metric.
ReportGridDisplayCellRowHeader(ReportBean rb, WebHeader header, HashMap cachedObjects)
Constructor used to display row header in report grid in execute mode.
Public Methods
void generateRowHeaderContent(MarkupOutput out)
int getCellType()
Returns the cell type
WebEvent getDerivedElementsEvent()
WebEvent getFilterOnEvent()
Get the event for filter on the cell header instance
WebEvent getInsertMetricPercentToTotalEvent(int axisBitMap)
Get the event for inserting a new metric based on Percent to Total
WebEvent getInsertMetricPercentToTotalEvent(int axisBitMap, String attributeID)
Get the event for inserting a new metric based on Percent to Total
WebEvent getInsertMetricRankEvent(String attributeID, int sortOrder)
Get the event for inserting a new metric based on a rank
WebEvent getInsertMetricTransformationEvent(String transformationID, int formulaType)
Get the event for inserting a new metric based on a transformation
int getKey()
WebEvent getOpenFormatEditorEvent()
Get the event for opening the format editor
WebEvent getRenameEvent()
Get the event for renaming the current cell
WebEvent getSetFormatEditorTargetEvent()
Get the event for setting the current target of the format editor to be this cell instance
WebHeader getWebHeader()
return the WebHeader object associated with this cell
WebTemplateMetric getWebTemplateMetric(boolean retrieve)
Obtain the WebTemplateMetric instance associated with this class
WebTemplateMetric getWebTemplateMetric()
return the WebTemplateMetric object associated with this cell
void init(TransformContext context, WebTemplateMetric metric)
This method is called to initialize the cell in design mode.
void init(WebComponent wc, WebTemplateMetric metric, FormalParameters formalParas)
This method is called to initialize the cell in design mode.
void init(WebComponent wc, WebHeader header, HashMap cachedObjects)
This method is called to initialize the cell in view mode.
void init(TransformContext context, WebHeader header)
This method is called to initialize the cell in view mode.
void init(WebComponent wc, WebTemplateMetric metric, HashMap cachedObjects)
This method is called to initialize the cell in design mode.
void init(WebComponent wc, WebTemplateUnit unit, FormalParameters formalParas)
This method is called to initialize the cell in design mode.
boolean isMetric()
determine if the row header is containing a metric
boolean isMetricDrillable(WebHeader header, WebDrillPath drillPath)
return whether the header has a drillable metric
void reset()
Reset all of the instance variables.
void setOutlinemodeRowCount(int value)
set row count for outline mode
void setOutlinemodeSubTotalName(String value)
get subtotal name for outline mode
void setOutlinemodeWrapHeaderText(boolean isWrap)
Indicates the header text of the outline mode cell need to be wrap up with related html tags.
void setShowOutlinemodeImage(boolean value)
set whether display outline mode image
Protected Methods
void generateContent(MarkupOutput mo)
Override the protected method of ReportDisplayCellImpl.
void generateContextMenu(MarkupOutput mo)
Override the protected method of ReportDisplayCellImpl.
void generateDrillCheckBox(MarkupOutput mo)
Override the protected method of ReportDisplayCellImpl.
void generateFilterOnSelectionCheckBox(MarkupOutput mo)
Override the protected method of ReportDisplayCellImpl.
void generateOutlineModeImage(MarkupOutput mo)
Override the protected method of ReportDisplayCellImpl.
void generateOutlineSubTotalName(MarkupOutput mo)
Override the protected method of ReportDisplayCellImpl.
void generateTooltip(MarkupOutput mo)
Generate the tool tip for this cell.
int getOutlinemodeRowCount()
get row count for outline mode
String getOutlinemodeSubTotalName()
get subtotal name for outline mode
boolean getShowOutlinemodeImage()
get whether display outline mode image
WebTemplateUnit getWebTemplateUnit()
return the getWebTemplateUnit object associated with this cell
void initDNDForDesignMode(DragAndDropItem item)
initialize a drag and drop item for a row header cell in design mode
void initDNDForExecuteMode(DragAndDropItem item)
initialize a drag and drop item for a row header cell in execute mode
boolean isTotal()
[Expand]
Inherited Methods
From class com.microstrategy.web.app.transforms.ReportGridDisplayCellImpl
From class java.lang.Object
From interface com.microstrategy.web.app.transforms.ReportGridCellHeader
From interface com.microstrategy.web.app.transforms.ReportGridCellRowHeader
From interface com.microstrategy.web.app.transforms.ReportGridDisplayCell

Public Constructors

public ReportGridDisplayCellRowHeader ()

Constructor used for creating a generic display cell.

public ReportGridDisplayCellRowHeader (FormalParameters formalParas)

Constructor used for creating a generic display cell.

Parameters
formalParas all the formal parameters from the report transform. Used to control some output generation. For example, the cssPrefix is needed for the empty cells in design mode.

public ReportGridDisplayCellRowHeader (ReportBean rb, WebTemplateMetric metric, FormalParameters formalParas)

Constructor used for creating a dummy display cell of row header in design mode when it's corresponding to a metric. When the metrics are on row axis, the row header will display the corresponding metric name.

Parameters
rb the associated report bean
metric the associated metric on template
formalParas all the formal parameters from the report transform. Used to control some output generation. For example, the cssPrefix is needed for the empty cells in design mode.

public ReportGridDisplayCellRowHeader (ReportBean rb, WebTemplateUnit unit, FormalParameters formalParas)

Constructor used for creating a dummy display cell of row header in design mode when it's not corresponding to a metric. Basically the row header will contain the information to the corresponding Template unit.

Parameters
rb the associated report bean
unit the associated template unit
formalParas all the formal parameters from the report transform. Used to control some output generation. For example, the cssPrefix is needed for the empty cells in design mode.

public ReportGridDisplayCellRowHeader (ReportBean rb, WebHeader header, HashMap cachedObjects)

Constructor used to display row header in report grid in execute mode.

Parameters
rb the associated report bean
header the associated row header object
cachedObjects cached object, used to store some information shared across multiple cells

Public Methods

public void generateRowHeaderContent (MarkupOutput out)

public int getCellType ()

Returns the cell type

Returns
  • the cell type - EnumReportGridDisplayCellTypes.EnumReportGridDisplayCellTypeRowHeader. It's read-only.

public WebEvent getDerivedElementsEvent ()

public WebEvent getFilterOnEvent ()

Get the event for filter on the cell header instance

Returns
  • WebEvent instance initialized for filtering on the information of this cell

public WebEvent getInsertMetricPercentToTotalEvent (int axisBitMap)

Get the event for inserting a new metric based on Percent to Total

Parameters
axisBitMap identifier of the axis to be used for calculating the metric information. Values expected come from the EnumDSSXMLAxesBitMap enumeration.
Returns
  • WebEvent initialized with the event information for inserting a new metric.

public WebEvent getInsertMetricPercentToTotalEvent (int axisBitMap, String attributeID)

Get the event for inserting a new metric based on Percent to Total

Parameters
axisBitMap identifier of the axis to be used for calculating the metric information. Values expected come from the EnumDSSXMLAxesBitMap enumeration.
attributeID identifier of the attribute at which the metric will be calculated
Returns
  • WebEvent initialized with the event information for inserting a new metric.

public WebEvent getInsertMetricRankEvent (String attributeID, int sortOrder)

Get the event for inserting a new metric based on a rank

Parameters
attributeID identifier of the attribute at which the metric will be calculated
sortOrder int with the sort order to be used on the new rank metric. Values expected include EnumViewBeanEvents#SORT_ORDER_ASCENDING and EnumViewBeanEvents#SORT_ORDER_DESCENDING
Returns
  • WebEvent initialized with the event information for inserting a new metric.

public WebEvent getInsertMetricTransformationEvent (String transformationID, int formulaType)

Get the event for inserting a new metric based on a transformation

Parameters
transformationID identifier of the role of the transformation to be used
formulaType identifier of the type of formula to be used. Values expected come from the EnumDSSXMLMetricFormulaType enumeration
Returns
  • WebEvent initialized with the event information for inserting a new metric.

public int getKey ()

public WebEvent getOpenFormatEditorEvent ()

Get the event for opening the format editor

Returns
  • WebEvent instance initialized for opening the format editor

public WebEvent getRenameEvent ()

Get the event for renaming the current cell

Returns
  • WebEvent instance initialized with the information for renaming the current cell.

public WebEvent getSetFormatEditorTargetEvent ()

Get the event for setting the current target of the format editor to be this cell instance

Returns
  • WebEvent instance initialized for setting the target of the format editor to be the current cell instance.

public WebHeader getWebHeader ()

return the WebHeader object associated with this cell

Returns
  • the WebHeader object

public WebTemplateMetric getWebTemplateMetric (boolean retrieve)

Obtain the WebTemplateMetric instance associated with this class

Parameters
retrieve boolean flag that if true indicates it will search also on the header information and the template's metric collection for the metric represented here.
Returns
  • WebTemplateMetric instance from where the information to be rendered by this class will be retrieved.

public WebTemplateMetric getWebTemplateMetric ()

return the WebTemplateMetric object associated with this cell

Returns
  • the getWebTemplateUnitWebTemplateMetric object

public void init (TransformContext context, WebTemplateMetric metric)

This method is called to initialize the cell in design mode. It receives a WebTemplateMetric as the underlying SDK object.

Parameters
context TransformContext instance initialized with the grid's transform information.
metric WebTemplateMetric instance corresponding to the cell to be displayed.

public void init (WebComponent wc, WebTemplateMetric metric, FormalParameters formalParas)

This method is called to initialize the cell in design mode. It receives a WebTemplateMetric as the underlying SDK object.

Parameters
wc The bean being transformed.
metric The WebTemplateMetric corresponding to this cell.
formalParas all the formal parameters from the report transform. Used to control some output generation.

public void init (WebComponent wc, WebHeader header, HashMap cachedObjects)

This method is called to initialize the cell in view mode. It receives a WebHeader as the underlying SDK object.

Parameters
wc The bean being transformed.
header The WebHeader corresponding to this cell.
cachedObjects A HashMap populated by the transform and used to store information shared across multiple cells.

public void init (TransformContext context, WebHeader header)

This method is called to initialize the cell in view mode. It receives a WebHeader instance as the underlying SDK object

Parameters
context TransformContext instance initialized with the grid's transform information.
header WebHeader instance coresponding to the cell to be displayed.

public void init (WebComponent wc, WebTemplateMetric metric, HashMap cachedObjects)

This method is called to initialize the cell in design mode. It receives a WebTemplateMetric as the underlying SDK object.

Parameters
wc The bean being transformed.
metric The WebTemplateMetric corresponding to this cell.
cachedObjects A HashMap populated by the transform and used to store information shared across multiple cells.

public void init (WebComponent wc, WebTemplateUnit unit, FormalParameters formalParas)

This method is called to initialize the cell in design mode. It receives a WebTemplateUnit as the underlying SDK object.

Parameters
wc The bean being transformed.
unit The WebTemplateUnit corresponding to this cell.
formalParas all the formal parameters from the report transform. Used to control some output generation.

public boolean isMetric ()

determine if the row header is containing a metric

Returns
  • whether the cell is containing a metric

public boolean isMetricDrillable (WebHeader header, WebDrillPath drillPath)

return whether the header has a drillable metric

Parameters
header the header object
drillPath the drill path
Returns
  • whether the header has a drillable metric

public void reset ()

Reset all of the instance variables. This method is very important when improve the memory performance: we create only one instance for a particular cell type and reuse it instead of creating a new instance for each concrete grid cell. Therefore, it saves a lot of memory. For implementation of this method, please follow the workflow of how all the instance variables are initialized in the class hierarchy when a new instance is created: superclass instance variables are initialized first, subclass instance variables are initialized second. Note: for the purpose of cell reuse.

public void setOutlinemodeRowCount (int value)

set row count for outline mode

Parameters
value row count

public void setOutlinemodeSubTotalName (String value)

get subtotal name for outline mode

Parameters
value subtotal name for outline mode

public void setOutlinemodeWrapHeaderText (boolean isWrap)

Indicates the header text of the outline mode cell need to be wrap up with related html tags.

Parameters
isWrap If set to true, the header text need to do format converting.

public void setShowOutlinemodeImage (boolean value)

set whether display outline mode image

Parameters
value whether display outline mode image

Protected Methods

protected void generateContent (MarkupOutput mo)

Override the protected method of ReportDisplayCellImpl.

Parameters
mo the output object

protected void generateContextMenu (MarkupOutput mo)

Override the protected method of ReportDisplayCellImpl.

Parameters
mo the output object

protected void generateDrillCheckBox (MarkupOutput mo)

Override the protected method of ReportDisplayCellImpl.

Parameters
mo the output object

protected void generateFilterOnSelectionCheckBox (MarkupOutput mo)

Override the protected method of ReportDisplayCellImpl.

Parameters
mo the output object

protected void generateOutlineModeImage (MarkupOutput mo)

Override the protected method of ReportDisplayCellImpl.

Parameters
mo the output object

protected void generateOutlineSubTotalName (MarkupOutput mo)

Override the protected method of ReportDisplayCellImpl.

Parameters
mo the output object

protected void generateTooltip (MarkupOutput mo)

Generate the tool tip for this cell.

Parameters
mo the output object

protected int getOutlinemodeRowCount ()

get row count for outline mode

Returns
  • row count for outline mode

protected String getOutlinemodeSubTotalName ()

get subtotal name for outline mode

Returns
  • subtotal name for outline mode

protected boolean getShowOutlinemodeImage ()

get whether display outline mode image

Returns
  • whether display outline mode image

protected WebTemplateUnit getWebTemplateUnit ()

return the getWebTemplateUnit object associated with this cell

Returns
  • the WebTemplateUnit object

protected void initDNDForDesignMode (DragAndDropItem item)

initialize a drag and drop item for a row header cell in design mode

Parameters
item the DragAndDropItem item

protected void initDNDForExecuteMode (DragAndDropItem item)

initialize a drag and drop item for a row header cell in execute mode

Parameters
item the DragAndDropItem item

protected boolean isTotal ()