Class ColumnHintHandle
java.lang.Object
org.eclipse.birt.report.model.api.ElementDetailHandle
org.eclipse.birt.report.model.api.ValueHandle
org.eclipse.birt.report.model.api.StructureHandle
org.eclipse.birt.report.model.api.ColumnHintHandle
Represents the handle of column hint. The column hint provides the hint about
result set columns.
- Column Name
- a column hint has a required name. It keys the column hint to a column within the result set.
- Alias
- a column hint has an optional alias. It provides an 'alias' name used for the column within the report.
- Searching
- a column hint has an optional searching. It indicates how the column will be used when searching.
- Export
- a column hint has an optional export. It determines how the column will be used when exporting data.
- Analysis
- a column hint has an optional analysis. It determines how the column is used when exporting the data to an OLAP cube.
- Parent Level
- a column hint has an optional parent level. It is used when a column's
ANALYSIS_MEMBERproperty is set toANALYSIS_TYPE_DIMENSIONorANALYSIS_TYPE_DETAIL. ForANALYSIS_TYPE_DIMENSION, this property establishes the dimension hierarchy. - Format
- a column hint has an optional format. It is used to format the column data when displaying the value in the viewing UI, especially within the search results.
- Display Name
- a column hint has an optional display name. It provides the an optional localizable display name for the column.
- Display Name ID
- a column hint has an optional display name ID. It provides the key to localize the display name.
- Help Text
- a column hint has an optional help text. It provides optional localizable descriptive text that explains the column to the end user.
- Help Text ID
- a column hint has an optional help text ID. It provides the key to localize the help text.
-
Field Summary
Fields inherited from class org.eclipse.birt.report.model.api.StructureHandle
structContextFields inherited from class org.eclipse.birt.report.model.api.ElementDetailHandle
elementHandle -
Constructor Summary
ConstructorsConstructorDescriptionColumnHintHandle(SimpleValueHandle valueHandle, int index) Constructs the handle of computed column. -
Method Summary
Modifier and TypeMethodDescriptionGets the expression handle for theACLExpressionmember.Returns a handle to work with the action property, action is a structure that defines a hyperlink.getAlias()Returns the alias name of this column.Returns the analysis option.Gets the analysis column.Returns the column name.Deprecated.Deprecated.intDeprecated.Returns the display name.Returns the resource key for display name.Returns the export option.Deprecated.Gets the heading of the column.Gets the resource key of the heading of the column.Returns the help text.Returns the resource key for help text.Gets the horizontal alignment of the column.Returns the parent level.Returns the searching option.Deprecated.Gets the value format of the column.booleanGets the flag which indicates whether the column needs to be compressed.booleanGets the flag which indicates whether the column should be generated with index.booleanGets the hint if the dimension data element should be layout on column.Set an action on the image.voidSets the alias name of this column.voidsetAnalysis(String analysis) Sets the analysis option.voidsetAnalysisColumn(String column) Sets the analysis column.voidsetColumnName(String columnName) Sets the column name.voidsetCompresssed(boolean compressed) Sets the flag which indicates whether the column needs to be compressed.voidsetDescription(String description) Deprecated.voidsetDescriptionKey(String descriptionID) Deprecated.voidsetDisplayLength(int displayLength) Deprecated.voidsetDisplayName(String displayName) Sets the display name.voidsetDisplayNameKey(String displayNameResourceKey) Sets the resource key for display name.voidSets the export option.voidDeprecated.voidsetHeading(String heading) Sets the heading of the column.voidsetHeadingKey(String headingID) Sets the resource key of the heading of the column.voidsetHelpText(String helpText) Sets the help text.voidsetHelpTextKey(String helpTextResourceKey) Sets the resource key for help text.voidsetHorizontalAlign(String align) Sets the horizontal alignment of the column.voidsetIndexColumn(boolean indexColumn) Sets the flag which indicates whether the column should be generated with index.voidsetOnColumnLayout(boolean onColumnLayout) Sets the hint if the dimension data element should be layout on column.voidsetParentLevel(String parentLevel) Sets the parent level.voidsetSearching(String searching) Sets the searching option.voidsetTextFormat(String format) Deprecated.voidsetValueFormat(FormatValue format) Sets the value format of the column.voidsetWordWrap(boolean wordWrap) Deprecated.booleanwordWrap()Deprecated.Methods inherited from class org.eclipse.birt.report.model.api.StructureHandle
drop, getContext, getDefn, getExpressionProperty, getExternalizedValue, getExternalizedValue, getIntProperty, getMember, getProperty, getPropertyDefn, getStringProperty, getStructure, isDesignTime, isLocal, iterator, setDesignTime, setExpressionProperty, setProperty, setPropertySilentlyMethods inherited from class org.eclipse.birt.report.model.api.ValueHandle
getReferenceMethods inherited from class org.eclipse.birt.report.model.api.ElementDetailHandle
getDesign, getElement, getElementHandle, getModule
-
Constructor Details
-
ColumnHintHandle
Constructs the handle of computed column.- Parameters:
valueHandle- the value handle for computed column list of one propertyindex- the position of this computed column in the list
-
-
Method Details
-
getAlias
Returns the alias name of this column.- Returns:
- the alias name of this column
-
setAlias
Sets the alias name of this column.- Parameters:
alias- the alias name to set
-
getAnalysis
Returns the analysis option. The possible values are defined inDesignChoiceConstants, and they are- ANALYSIS_TYPE_DIMENSION
- ANALYSIS_TYPE_ATTRIBUTE
- ANALYSIS_TYPE_MEASURE
- Returns:
- the analysis option
-
setAnalysis
Sets the analysis option. The allowed values are defined inDesignChoiceConstants, and they are- ANALYSIS_TYPE_DIMENSION
- ANALYSIS_TYPE_ATTRIBUTE
- ANALYSIS_TYPE_MEASURE
- Parameters:
analysis- the analysis option to set- Throws:
SemanticException- if the analysis is not in the choice list.
-
getColumnName
Returns the column name.- Returns:
- the column name
-
setColumnName
Sets the column name.- Parameters:
columnName- the column name to set- Throws:
SemanticException- value required exception.
-
getDisplayName
Returns the display name.- Returns:
- the display name
-
setDisplayName
Sets the display name.- Parameters:
displayName- the display name to set
-
getDisplayNameKey
Returns the resource key for display name.- Returns:
- the resource key for display name
-
setDisplayNameKey
Sets the resource key for display name.- Parameters:
displayNameResourceKey- the resource key to set
-
getExport
Returns the export option. The possible values are defined inDesignChoiceConstants, and they are- EXPORT_TYPE_NONE
- EXPORT_TYPE_IF_REALIZED
- EXPORT_TYPE_ALWAYS
- Returns:
- the export option
-
setExport
Sets the export option. The allowed values are defined inDesignChoiceConstants, and they are- EXPORT_TYPE_NONE
- EXPORT_TYPE_IF_REALIZED
- EXPORT_TYPE_ALWAYS
- Parameters:
export- the export option to set- Throws:
SemanticException- if the export is not in the choice list.
-
getFormat
Deprecated.Returns the format option.- Returns:
- the format option
-
setFormat
Deprecated.Sets the format option.- Parameters:
format- the format option to set
-
getHelpText
Returns the help text.- Returns:
- the help text.
-
setHelpText
Sets the help text.- Parameters:
helpText- the help text to set
-
getHelpTextKey
Returns the resource key for help text.- Returns:
- the resource key for help text
-
setHelpTextKey
Sets the resource key for help text.- Parameters:
helpTextResourceKey- the resource key to set
-
getParentLevel
Returns the parent level.- Returns:
- the parent level
-
setParentLevel
Sets the parent level.- Parameters:
parentLevel- the parent level to set
-
getSearching
Returns the searching option. The possible values are defined inDesignChoiceConstants, and they are- SEARCH_TYPE_ANY
- SEARCH_TYPE_INDEXED
- SEARCH_TYPE_NONE
- Returns:
- the searching option
-
setSearching
Sets the searching option. The allowed values are defined inDesignChoiceConstants, and they are- SEARCH_TYPE_ANY
- SEARCH_TYPE_INDEXED
- SEARCH_TYPE_NONE
- Parameters:
searching- the searching option to set- Throws:
SemanticException- if the searching is not in the choice list.
-
isOnColumnLayout
public boolean isOnColumnLayout()Gets the hint if the dimension data element should be layout on column.- Returns:
- true if the dimension data element should be layout on column, or false the dimension data element should be layout on row.
-
setOnColumnLayout
Sets the hint if the dimension data element should be layout on column.- Parameters:
onColumnLayout- the hint if the dimension data element should be layout on column.- Throws:
SemanticException
-
getHeading
Gets the heading of the column.- Returns:
- the heading
-
setHeading
Sets the heading of the column.- Parameters:
heading- the new heading
-
getHeadingKey
Gets the resource key of the heading of the column.- Returns:
- the resource key of the heading
-
setHeadingKey
Sets the resource key of the heading of the column.- Parameters:
headingID- the new resource key of the heading
-
getDisplayLength
Deprecated.Gets the display length of the column.- Returns:
- the display length
-
setDisplayLength
Deprecated.Sets the display length of the column.- Parameters:
displayLength- the new display length
-
getHorizontalAlign
Gets the horizontal alignment of the column. The returned value may be one of the constants defined inDesignChoiceConstants:TEXT_ALIGN_LEFTTEXT_ALIGN_RIGHTTEXT_ALIGN_CENTERTEXT_ALIGN_JUSTIFY
- Returns:
- the horizontal alignment
-
setHorizontalAlign
Sets the horizontal alignment of the column. The value should be one of the constants defined inDesignChoiceConstants:TEXT_ALIGN_LEFTTEXT_ALIGN_RIGHTTEXT_ALIGN_CENTERTEXT_ALIGN_JUSTIFY
- Parameters:
align- the new horizontal alignment- Throws:
SemanticException- if the align is not defined.
-
wordWrap
Deprecated.Gets the hint if the word needs to wrap.- Returns:
- true if the word needs to wrap, otherwise false.
-
setWordWrap
Deprecated.Sets the hint if the word needs to wrap.- Parameters:
wordWrap- the hint value indicates if the word needs to wrap.
-
getTextFormat
Deprecated.Gets the text format of the column. The returned value may be one of the constants defined inDesignChoiceConstants:STRING_FORMAT_TYPE_UNFORMATTEDSTRING_FORMAT_TYPE_UPPERCASESTRING_FORMAT_TYPE_LOWERCASESTRING_FORMAT_TYPE_CUSTOMSTRING_FORMAT_TYPE_ZIP_CODESTRING_FORMAT_TYPE_ZIP_CODE_4STRING_FORMAT_TYPE_PHONE_NUMBERSTRING_FORMAT_TYPE_SOCIAL_SECURITY_NUMBER
- Returns:
- the text format of the column
-
setTextFormat
Deprecated.Sets the text format of the column. The value should be one of the constants defined inDesignChoiceConstants:STRING_FORMAT_TYPE_UNFORMATTEDSTRING_FORMAT_TYPE_UPPERCASESTRING_FORMAT_TYPE_LOWERCASESTRING_FORMAT_TYPE_CUSTOMSTRING_FORMAT_TYPE_ZIP_CODESTRING_FORMAT_TYPE_ZIP_CODE_4STRING_FORMAT_TYPE_PHONE_NUMBERSTRING_FORMAT_TYPE_SOCIAL_SECURITY_NUMBER
- Parameters:
format- the new text format- Throws:
SemanticException- if the format is not defined.
-
getDescription
Deprecated.Gets the description of the column.- Returns:
- the description
-
setDescription
Deprecated.Sets the description of the column.- Parameters:
description- the new description
-
getDescriptionKey
Deprecated.Gets the resource key of the description of the column.- Returns:
- the resource key of the description
-
setDescriptionKey
Deprecated.Sets the resource key of the description of the column.- Parameters:
descriptionID- the new resource key of the description
-
getActionHandle
Returns a handle to work with the action property, action is a structure that defines a hyperlink.- Returns:
- a handle to the action property, return
nullif the action has not been set on the column hint; otherwise return null - See Also:
-
setAction
Set an action on the image.- Parameters:
action- new action to be set on the image, it represents a bookmark link, hyperlink, and drill through etc.- Returns:
- a handle to the action property, return
nullif the action has not been set on the image. - Throws:
SemanticException- if member of the action is not valid.
-
getACLExpression
Gets the expression handle for theACLExpressionmember.- Returns:
-
getAnalysisColumn
Gets the analysis column.- Returns:
- the analysis column.
-
setAnalysisColumn
Sets the analysis column.- Parameters:
column- the column to set- Throws:
SemanticException
-
getValueFormat
Gets the value format of the column.- Returns:
- the value format
-
setValueFormat
Sets the value format of the column.- Parameters:
format- the value format to set- Throws:
SemanticException
-
isIndexColumn
public boolean isIndexColumn()Gets the flag which indicates whether the column should be generated with index.- Returns:
- true if the column should be generated with index, otherwise false
-
setIndexColumn
Sets the flag which indicates whether the column should be generated with index.- Parameters:
indexColumn- the new flag to set- Throws:
SemanticException
-
isCompressed
public boolean isCompressed()Gets the flag which indicates whether the column needs to be compressed.- Returns:
- true if the column needs to be compressed, otherwise false.
-
setCompresssed
Sets the flag which indicates whether the column needs to be compressed.- Parameters:
compressed- the new flag to set- Throws:
SemanticException
-