public class

TabGraphGeneralTransform

extends AbstractTabTransform
implements LayoutTransform

java.lang.Object
↳	com.microstrategy.web.transform.AbstractTransform
	↳	com.microstrategy.web.transform.AbstractLayoutTransform
		↳	com.microstrategy.web.app.transforms.AbstractAppTransform
			↳	com.microstrategy.web.app.transforms.AbstractTabTransform
				↳	com.microstrategy.web.app.transforms.TabGraphGeneralTransform

Class Overview

This class transforms a TabBean allowing users to view/modify general graph properties (like graph type, subtype, categories, etc) of a graph. As with other TabTransforms, this one assumes its TabManagerBean will take care of rendering the required HTML & Javascript allowing users to switch between different formatting TabBean instances.

The output of this transform can be divided into thre main sections:

Graph Styles (type and subtype)

Maximum Settings (for categories and series)

Other (like settings for fonts and series orientation)
Each one of these sections has its own render method. Furthermore each section generates individual settings which have been divided into their own render method.

This Transform implements LayoutTransform, therefore its render methods can be invoked using a custom layout-xml. When this is the case, the layout-xml specified in the style-catalog controls which methods are called and in which order. Otherwise, the default output of this transform is divided as follows:

     Contents / ContentsBody
     -----------------------------------------------------
     |                                                   |
     |         Graph Styles                              |
     |                                                   |
     |                                                   |
     -----------------------------------------------------
     |                                                   |
     |         Maximum Settings                          |
     |                                                   |
     |                                                   |
     -----------------------------------------------------
     |                                                   |
     |         Other Settings                            |
     |                                                   |
     |                                                   |
     -----------------------------------------------------

Summary

Constants
String	FP_SUB_TYPES_PICKER_NAME	Constant specifying the name of the subTypesPickerName formal parameter.
String	FP_TYPES_PICKER_NAME	Constant specifying the name of the typesPickerName formal parameter.

[Expand]

Inherited Constants

From class com.microstrategy.web.app.transforms.AbstractTabTransform

From class com.microstrategy.web.app.transforms.AbstractAppTransform

Fields
public FormalParameter	subTypesPickerName	Indicates the name of the system picker (defined in the page-config) that contains the list graph sub-types that shall be displayed to the user.
public FormalParameter	typesPickerName	Indicates the name of the system picker (defined in the page-config) that contains the list graph types that shall be displayed to the user.

[Expand]

Inherited Fields

From class com.microstrategy.web.app.transforms.AbstractTabTransform

protected String	cssBody	Property with the name of the css class to use for the body of this instance transform output.
protected String	cssFrame	Property with the name of the css class to use for the frame of this instance transform output.
protected String	cssPicker	Property with the name of the css class to use for the div including a single picker of this instance transform output.
protected String	cssPickers	Property with the name of the css class to use for the div including all pickers of this instance transform output.
protected String	scriptClassBody	Property with the value of the scriptClass attribute for the body of this instance transform output
protected String	scriptClassFrame	Property with the value of the scriptClass attribute for the frame of this instance transform output
protected String	styBody	Property with the value of the sty attribute for the body of this instance transform output
protected String	styFrame	Property with the value of the sty attribute for the frame of this instance transform output
public FormalParameter	tabHeight	Indicates the height of the tabs on the editor.
protected String	tyBody	Property with the value of the ty attribute for the body of this instance transform output
protected String	tyFrame	Property with the value of the ty attribute for the frame of this instance transform output

From class com.microstrategy.web.app.transforms.AbstractAppTransform

protected final String	CLASS_INPUT	This field is deprecated. This property is not used anymore by the transform.
protected final String	CLASS_MESSAGE	This field is deprecated. This property is not used anymore by the transform.
protected WebComponent	_bean	Instance of `WebComponent` being transformed.
protected ComponentBlock	_componentBlock
protected String	_cssPrefix	Property corresponding to the value of the `cssPrefix` formal parameter
protected String	_imgBlank	Field that containts the URL location of a blank image (used as the source of most <IMG> tags as the real URL is specified through css).
protected String	_imgWait	This field is deprecated. This value is not used anymore by the Transform as the wait image is included using css.
protected MarkupOutput	_selfOutput	This field is deprecated. this field is no longer used since partial update blocks are now generated via `ComponentBlock`
protected MarkupOutput	_subOutput	This field is deprecated. this field is no longer used since partial update blocks are now generated via `ComponentBlock`
public FormalParameter	appliesTo	This parameter informs the javascript the id of the bone the actions of this component applies to.
public FormalParameter	contextMenus	This formal parameter is used by the Transform to identify the context-menus definition.
public FormalParameter	cssFile	CSS file that includes the style definition.
public FormalParameter	cssPrefix	Prefix to append to all css class names.
public FormalParameter	debugErrorFlags	Indicates which extra debug information to include in case of an error.
public FormalParameter	debugFlags	Indicates which debug information to include.
public FormalParameter	dragMode	Indicates the drag mode that the component to render will have.
public FormalParameter	extraInput	Indicates any extra inputs to be included in the forms generated by the transform.
public FormalParameter	extraUrl	Indicates any extra parameters to be included in the links generated by the transform.
public FormalParameter	globalCssErrorMessage	This field is deprecated. The css class to use cannot be controlled through a formal parameter anymore.
public FormalParameter	globalCssErrorTitle	This field is deprecated. The css class to use cannot be controlled through a formal parameter anymore.
public FormalParameter	height	Indicates the default height of the component.
public FormalParameter	iframeEnabled	Indicates whether the transform supports iframe manipulations.
public FormalParameter	imgWait	This field is deprecated. This value is not used anymore by the Transform as the wait image is included using css.
protected int	indent	This field is deprecated. Indentation is not appended by Transforms anymore. Although it provided a somewhat better looking HTML source, it also affected performance by increasing the HTML size.
public FormalParameter	initialIndent	This field is deprecated. Indentation is not appended by Transforms anymore. Although it provided a somewhat better looking HTML source, it also affected performance by increasing the HTML size.
protected boolean	isDHTML	This field is deprecated. Use `isDhtml()`.
public FormalParameter	orientation	Indicates the orientation the dialog to render will have.
public FormalParameter	orientationsAllowed	Indicates the orientation modes allowed for the dialog to render.
public FormalParameter	partialIframeUpdate	This formal parameter specifies whether we should replace the whole contentst of the div shell (outerHTML) or the just the inner contents (innerHTML) of that shell div for the transform when the iframe update is going on.
public FormalParameter	processingButtonsFlags	Indicates which buttons to include on the wait page.
public FormalParameter	processingInfoFlags	Indicates which information to include on the wait page.
public FormalParameter	resizeLevel	Indicates whether the component can be resized vertically/horizontally or both or none.
public FormalParameter	scriptClass	Holds the name of the javaScript class (if any) to be associated with the component.
protected static final ScriptVariableJSONEncoder	scriptEndTagEncoder	reference to encoder that deals with tag encoding
public FormalParameter	type	This parameter is used when the output of this Transform generates a corresponding Microstrategy bone in the page, and it informs the javascript the type of bone it is.
public FormalParameter	useDHTML	Indicates whether to use DHTML on the output.
public FormalParameter	width	Indicates the default width of the component.

Public Constructors
	TabGraphGeneralTransform() Default no-argument constructor.

Public Methods
String	getDescription() Returns the textual description of the transform
ShortcutList	getSubTypesPicker() Returns the graph sub-types picker.
Class	getSupportedBeanType() Returns the supported bean type.
ShortcutList	getTypesPicker() Returns the graph types picker.
void	initializeCss() Initializes the Css Classes to use.
void	initializeJavaScriptAttributes() For JavaScript, certain properties are required to be added to the HTML tags to generate for its integration with the code generated for the feature to work in DHTML environments.
void	renderAntiAliasing(MarkupOutput out)
void	renderContentsBody(MarkupOutput out) This is the entry point for the Tranform, and generates the body of the Tab.
void	renderCurvedLines(MarkupOutput out)
void	renderDropdown(MarkupOutput out, String cmdId, String cmdValue, ShortcutList picker, String value) This method renders a single dropdown list to be used within a tab.
void	renderGraphStyles(MarkupOutput out) Generates the HTML output for the Graph Styles section on this format tab instance.
void	renderJavascriptLinks(MarkupOutput out) Render any JavaScript information required for this tab to work correctly on client side.
void	renderMaximumSettings(MarkupOutput out) Generates the HTML output for the Maximum Settings section on this format tab instance.
void	renderRoundedEffect(MarkupOutput out)
void	setSubTypesPicker(ShortcutList picker) Register the sub-types picker.
void	setTypesPicker(ShortcutList picker) Register the major types picker.

Protected Methods
WebGraphProperties	getGraphProperties()

[Expand]

Inherited Methods

From class com.microstrategy.web.app.transforms.AbstractTabTransform

void	AddJSValidationInfo(Tag inputTag, String type, String min, String max, String name, String errorMsg) This method is deprecated. please use `addJSValidationInfo(Tag, String, String, String, String, String)` instead
void	addJSValidationInfo(Tag inputTag, String type, String min, String max, String name, String errorMsg) Add the necessary JavaScript validation information
void	addPicker(ShortcutList picker)
String	getArgumentName(WebEvent event, int argumentId) Get the name of the argument assigned to the `WebEvent`, based on the indicated id.
Map	getAttributesBody() This method return a Map (name/value pairs) of attributes to use for the div enclosing the body of the Tab.
Map	getAttributesFrame() This method return a Map (name/value pairs) of attributes to use for the div enclosing the content of the Tab.
String	getDescription() Returns the textual description of the transform
Tag	getDropDownTag(String cmdId, String cmdValue, ShortcutList picker, String type)
Tag	getFieldSetTag(String title) Convenience method that builds and returns a fieldset html tag.
Tag	getLabelTag(String attFor, String labelDescriptor)
String	getPickerId(ShortcutList picker)
Class	getSupportedBeanType() Returns the supported bean type.
TabBean	getTabBean() Returns the TabBean for this tab.
TabManagerBean	getTabManagerBean() Returns the TabManagerBean for this Tab.
void	initializeCss() Initializes the Css Classes to use.
void	initializeJavaScriptAttributes() For JavaScript, certain properties are required to be added to the HTML tags to generate for its integration with the code generated for the feature to work in DHTML environments.
void	initializeTransform(Transformable data) This method initialize the private and protected fields of the transform.
boolean	isCurrentTab() This method returns true whenever this Tab is selected.
boolean	isIFrameEnabled() Whether iframe update technology is enabled for this Transform.
void	renderColorDropdown(MarkupOutput out, String cmdId, String cmdValue, ShortcutList picker) This method renders a single dropdown to be used with a color picker
void	renderContents(MarkupOutput out) Method that renders a frame for the main contents of the transform, according to the information available on the bean.
abstract void	renderContentsBody(MarkupOutput out) Method that renders the main contents of the transform, according to the information available on the bean.
void	renderDropdown(MarkupOutput out, String cmdId, String cmdValue, ShortcutList picker, String value) This method renders a single dropdown list to be used within a tab.
void	renderFlashWarning(MarkupOutput out) Generates the HTML with a label that reads '(Flash Only)'.
void	renderJavascriptLinks(MarkupOutput out) Used to dynamically include links to js files.
void	renderPickers(MarkupOutput out) This method needs to be overriden by those Transforms that has a picker.
void	renderSingleOption(MarkupOutput out, String cmdId, String propertyValue, String msg, boolean isDisabled)
void	renderSingleOption(MarkupOutput out, String cmdId, boolean checked, String msg, boolean isDisabled, boolean setCmdValue)
void	renderTabFrame(MarkupOutput out) Method that renders a frame for all the contents and sections of the bean that are to be displayed.
void	renderTabSectionTitle(MarkupOutput out, String title) This method is deprecated. please use getFieldSetTag instead
void	transformForRequestSuccessful(MarkupOutput out) Transforms the assosciated `TabBean` when its status is `WebBeanRequestSuccessful`.

From class com.microstrategy.web.app.transforms.AbstractAppTransform

From class com.microstrategy.web.transform.AbstractLayoutTransform

From class com.microstrategy.web.transform.AbstractTransform

void	addFormalParam(FormalParameterImpl formal) This method is used to add a `FormalParameterImpl` object to the transform.
boolean	canTransform(Transformable data) Checks that the transform supports specified data object and that object is in the state supported by this transform.
static List<Integer>	getEvents(RequestKeys rkeys) Determines event(s) triggered from the request keys.
FormalParameters	getFormalParams() Returns the collection of formal parameters associated with this transform.
String	getID() Returns the unique name of the component to be used as the ID for its shell
MarkupOutput	getPreview() Produces a preview output for this transform.
boolean	isPreviewAvailable() Returns true if this transform supports preview functionality, false otherwise.
boolean	isResolved() Returns whether each required formal parameter has a value associated with it.
FormalParameterImpl	removeFormalParam(String name) Removes the formal parameter with the given name from the formal parameters collection.
void	setAnnotation(FormalParameter fp, FormalParameterAnnotation fpa) Used for internal housekeeping.
void	setDeprecated(FormalParameter fp, String desc) Used for internal housekeeping.
boolean	supports(Class type) Returns true if the transform supports objects of specified type.
boolean	supports(Transformable data) Returns true if the transform supports the specified data object.

From class java.lang.Object

From interface com.microstrategy.web.app.transforms.AppTransform

From interface com.microstrategy.web.transform.LayoutTransform

From interface com.microstrategy.web.transform.Transform

abstract boolean	canTransform(Transformable data) Checks that the transform supports specified data object and that object is in the state supported by this transform.
abstract String	getDescription() Returns a textual description of the transform.
abstract FormalParameters	getFormalParams() Returns the collection of formal parameters associated with this transform.
abstract String	getID() Returns the unique name of the component to be used as the ID for its shell
abstract MarkupOutput	getPreview() This method is deprecated. This feature is not used
abstract Class	getSupportedBeanType() Returns a root class/interface supported by this transform.
abstract boolean	isPreviewAvailable() This method is deprecated. This feature is not used
abstract boolean	isResolved() Returns whether each required formal parameter has a value associated with it.
abstract boolean	supports(Class beanClass) Returns true if the transform supports objects of specified type.
abstract boolean	supports(Transformable data) Returns true if the transform supports the specified data object.
abstract void	transform(Transformable data, MarkupOutput transOut) Transforms the data object and appends result to the transOut.

Constants

public static final String FP_SUB_TYPES_PICKER_NAME

Constant specifying the name of the subTypesPickerName formal parameter.

Constant Value: "subTypesPickerName"

public static final String FP_TYPES_PICKER_NAME

Constant specifying the name of the typesPickerName formal parameter.

Constant Value: "typesPickerName"

Fields

public FormalParameter subTypesPickerName

Indicates the name of the system picker (defined in the page-config) that contains the list graph sub-types that shall be displayed to the user.

public FormalParameter typesPickerName

Indicates the name of the system picker (defined in the page-config) that contains the list graph types that shall be displayed to the user.

Public Constructors

public TabGraphGeneralTransform ()

Default no-argument constructor. Initializes formal parameters.

Public Methods

public String getDescription ()

Returns the textual description of the transform

Returns

the description of the transform

public ShortcutList getSubTypesPicker ()

Returns the graph sub-types picker. If a non-null instance have been registered through the setSubTypesPicker(ShortcutList) method, it will return that one, otherwise, it will search for a system picker with the name specified in subTypesPickerName.

Returns

ShortcutList to use for the graph sub-types picker.

public Class getSupportedBeanType ()

Returns the supported bean type. This transform supports any of the TabBean instances

Returns

the class of the bean supported by this transform.

public ShortcutList getTypesPicker ()

Returns the graph types picker. If a non-null instance have been registered through the setTypesPicker method, it will return that one, otherwise, it will search for a system picker with the name specified in typesPickerName.

Returns

ShortcutList to use for the graph types picker.

public void initializeCss ()

Initializes the Css Classes to use. For each one of the css classes to use, the prefix indicated on the formal parameter is added to the name of the class to use.

public void initializeJavaScriptAttributes ()

For JavaScript, certain properties are required to be added to the HTML tags to generate for its integration with the code generated for the feature to work in DHTML environments. This method assigns values to these attributes, so they can be displayed together with the tags they represent. If a value is set to be null, it won't be included on the HTML tag definition. By default, it includes the definition of values for properties such as styFrame, tyFrame and scriptClassFrame.

public void renderAntiAliasing (MarkupOutput out)

public void renderContentsBody (MarkupOutput out)

This is the entry point for the Tranform, and generates the body of the Tab.

If a layout-xml is specified, this method will delegate the output generation to the Layout parser, otherwise it calls renderGraphStyles(), renderMaximumSettings() and renderOtherSettings().

Parameters

out	`MarkupOutput` instance where the HTML contents to render will be saved.

public void renderCurvedLines (MarkupOutput out)

public void renderDropdown (MarkupOutput out, String cmdId, String cmdValue, ShortcutList picker, String value)

This method renders a single dropdown list to be used within a tab.

Parameters

out	MarkupOutput where the content should be generated
cmdId	the dropdown's command id
cmdValue	the dropdown's current command value.
picker	the ShortcutList for the picker.
value	the dropdown current value.

public void renderGraphStyles (MarkupOutput out)

Generates the HTML output for the Graph Styles section on this format tab instance. Includes major and subtype option combo boxes.

Parameters

out	`MarkupOutput` instance where the HTML contents to render will be saved.

public void renderJavascriptLinks (MarkupOutput out)

Render any JavaScript information required for this tab to work correctly on client side.

Parameters

out	`MarkupOutput` instance where the HTML contents to render will be saved.

public void renderMaximumSettings (MarkupOutput out)

Generates the HTML output for the Maximum Settings section on this format tab instance. Includes categories and series.

Parameters

out	`MarkupOutput` instance where the HTML contents to render will be saved.

public void renderRoundedEffect (MarkupOutput out)

public void setSubTypesPicker (ShortcutList picker)

Register the sub-types picker. This allows the transform to use a ShortcutList that is not defined inside the pageConfig.

Parameters

picker	the minor type picker to set.

public void setTypesPicker (ShortcutList picker)

Register the major types picker. This allows the transform to use a ShortcutList that is not defined inside the pageConfig.

Parameters

picker	the major type picker to set.

Interfaces

Classes

TabGraphGeneralTransform

Class Overview

Summary

Constants

public static final String FP_SUB_TYPES_PICKER_NAME

public static final String FP_TYPES_PICKER_NAME

Fields

public FormalParameter subTypesPickerName

public FormalParameter typesPickerName

Public Constructors

public TabGraphGeneralTransform ()

Public Methods

public String getDescription ()

Returns

public ShortcutList getSubTypesPicker ()

Returns

public Class getSupportedBeanType ()

Returns

public ShortcutList getTypesPicker ()

Returns

public void initializeCss ()

public void initializeJavaScriptAttributes ()

public void renderAntiAliasing (MarkupOutput out)

public void renderContentsBody (MarkupOutput out)

Parameters

public void renderCurvedLines (MarkupOutput out)

public void renderDropdown (MarkupOutput out, String cmdId, String cmdValue, ShortcutList picker, String value)

Parameters

public void renderGraphStyles (MarkupOutput out)

Parameters

public void renderJavascriptLinks (MarkupOutput out)

Parameters

public void renderMaximumSettings (MarkupOutput out)

Parameters

public void renderRoundedEffect (MarkupOutput out)

public void setSubTypesPicker (ShortcutList picker)

Parameters

public void setTypesPicker (ShortcutList picker)

Parameters

Protected Methods

protected WebGraphProperties getGraphProperties ()