Klasse GroupField

java.lang.Object

com.inet.report.Field

com.inet.report.GroupField

Alle implementierten Schnittstellen:

NodeParser, com.inet.report.ReferencedObject, com.inet.report.ReferenceHolder, Validatable, Serializable

public class GroupField
extends Field
implements com.inet.report.ReferenceHolder, Validatable

The GroupField represents a group name field, which is automatically created with the creation of a Group object. When evaluating a GroupField the name of the group will returned. So if you have a group then you can print out the name with a FieldElement containing the GroupField.
You can get the GroupField of each group with Fields.getGroupNameField(int) in class Fields.

This class is part of the RDC.

Siehe auch:

• Fields.getGroupNameField(int)
• Fields.getGroupNameFieldsCount()
• FieldElement
• FieldPart
• Serialisierte Form

Verschachtelte Klassen - Übersicht

Von Klasse geerbte verschachtelte Klassen/Schnittstellen Field

Field.FieldAttributeTag

Feldübersicht

Von Klasse geerbte Felder Field

BINARY, BOOLEAN, CURRENCY, CURSOR, DATABASE_FIELD, DATE, DATETIME, FORMULA_FIELD, GROUP_NAME_FIELD, NUMBER, PARAMETER_FIELD, SORT_FIELD, SPECIAL_FIELD, SQL_FIELD, STRING, SUMMARY_FIELD, TIME, UNKNOWN

Methodenübersicht

Modifikator und Typ	Methode	Beschreibung
final void	addReferencedObject(com.inet.report.ReferencedObject reference)	FOR INTERNAL USE ONLY
Field	getField()	Gets the field definition element (for example, database field element, prompt field element).
Group	getGroup()	Returns the group this field is associated with.
int	getGroupType()	Returns the type of the group, which is associated with this group name field.
String	getName()	Returns a string which represents the name of the group field.
final int	getRealReferencedObjectCount()	FOR INTERNAL USE ONLY
final int	getReferencedObjectCount()	FOR INTERNAL USE ONLY
final com.inet.report.ReferencedObject[]	getReferencedObjects()	FOR INTERNAL USE ONLY
int	getValueType()	The return value type of a GroupField is always Field.String, but for formatting the return value type of the group the field is based on is needed.
NodeParser	parseElement(com.inet.report.parser.XMLTag group, String tag, Attributes atts, Map<String,Object> parserMap)	FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XML
final void	removeReferencedObject(com.inet.report.ReferencedObject reference)	FOR INTERNAL USE ONLY
final void	resetReferences()	FOR INTERNAL USE ONLY
protected void	saveFieldXML2(PrintWriter pw, int depth)	FOR INTERNAL USE ONLY
protected void	saveXML2GroupField(PrintWriter pw, int depth)	FOR INTERNAL USE ONLY
void	setField(Field newField)	Sets the field definition element (for example, DatabaseField element, prompt field element).
void	setName(String name)	Setting the name of a GroupField is not allowed.
final void	setReferences()	FOR INTERNAL USE ONLY
Validity	validate()	Check if the object is valid and returns the state and details of possible errors.

Von Klasse geerbte Methoden Field

addReferenceHolder, checkNameExists, duplicate, equals, extractReference, getPlaceholderName, getRealReferenceCount, getReferenceHolderCount, getReferenceHolders, getRefName, getType, indexOf, isDOMParser, isUsed, paramString, parseDOM, parseEndElement, parseText, removeReferenceHolder, rename, setGroup, setValueType, trimAwayBrackets

Von Klasse geerbte Methoden Object

clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methodendetails

setName

public void setName(String name)
             throws ReportException

Setting the name of a GroupField is not allowed. If you want to customize the name of the GroupField use:

• GroupField.getGroup().setCustomizeGroupNameField(CUSTOMIZE_GROUP_NAME_FIELD_ENABLED)
  and GroupField.getGroup().setGroupNameDbField(<your field>)
• or use GroupField.getGroup().setCustomizeGroupNameField(CUSTOMIZE_GROUP_NAME_FIELD_ENABLED_WITH_FM)
  and GroupField.getGroup().setGroupNameFormula(<your field>).

Otherwise an exception will be thrown.

Angegeben von:

setName in Klasse Field

Parameter:

name - a name.

Löst aus:

ReportException - will be thrown when you use this method to set the name of a GroupField.

Seit:

6.0

Siehe auch:

• getName()

getGroup

public Group getGroup()

Returns the group this field is associated with.

Setzt außer Kraft:

getGroup in Klasse Field

Gibt zurück:

the group this field belongs to.

Seit:

6.0

Siehe auch:

• Field.setGroup(Group)

getGroupType

public int getGroupType()

Returns the type of the group, which is associated with this group name field. The following values possible:

• 0 - field results from a standard group definition
• 1 - field results from group definition of a cross-tab column
• 2 - field results from group definition of a cross-tab row
• 3 - field results from group definition of a chart

That means this group name field is associated with a standard group if the type is 0. In this case eng.getGroup(getGroupNumber()+1) results the Group object which is associated with this field. Otherwise a null is returned by getGroup.

Gibt zurück:

the group type.

Seit:

6.0

getField

public Field getField()

Gets the field definition element (for example, database field element, prompt field element).

Setzt außer Kraft:

getField in Klasse Field

Gibt zurück:

Field The current value of the 'field' property.

setField

public void setField(Field newField)

Sets the field definition element (for example, DatabaseField element, prompt field element).

Setzt außer Kraft:

setField in Klasse Field

Parameter:

newField - The new field element of the property 'field'.

saveFieldXML2

protected void saveFieldXML2(PrintWriter pw,
 int depth)

FOR INTERNAL USE ONLY

Angegeben von:

saveFieldXML2 in Klasse Field

Parameter:

pw - the print writer

depth - the current depth

getValueType

public int getValueType()

The return value type of a GroupField is always Field.String, but for formatting the return value type of the group the field is based on is needed.

Setzt außer Kraft:

getValueType in Klasse Field

Gibt zurück:

The value of the property 'value type'.

Seit:

6.0

Siehe auch:

• Field.NUMBER
• Field.CURRENCY
• Field.BOOLEAN
• Field.DATE
• Field.TIME
• Field.STRING
• Field.DATETIME

getName

public String getName()

Returns a string which represents the name of the group field. The string returned depends on the settings of Group.getCustomizeGroupNameField().

Setzt außer Kraft:

getName in Klasse Field

Gibt zurück:

name of the groupfield

Seit:

6.0

Siehe auch:

• setName(String)
• Group.getCustomizeGroupNameField()

addReferencedObject

public final void addReferencedObject(com.inet.report.ReferencedObject reference)

FOR INTERNAL USE ONLY

Angegeben von:

addReferencedObject in Schnittstelle com.inet.report.ReferenceHolder

Seit:

6.0

getReferencedObjects

public final com.inet.report.ReferencedObject[] getReferencedObjects()

FOR INTERNAL USE ONLY

Angegeben von:

getReferencedObjects in Schnittstelle com.inet.report.ReferenceHolder

getRealReferencedObjectCount

public final int getRealReferencedObjectCount()

FOR INTERNAL USE ONLY

Angegeben von:

getRealReferencedObjectCount in Schnittstelle com.inet.report.ReferenceHolder

Seit:

6.0

getReferencedObjectCount

public final int getReferencedObjectCount()

FOR INTERNAL USE ONLY

Angegeben von:

getReferencedObjectCount in Schnittstelle com.inet.report.ReferenceHolder

removeReferencedObject

public final void removeReferencedObject(com.inet.report.ReferencedObject reference)

FOR INTERNAL USE ONLY

Angegeben von:

removeReferencedObject in Schnittstelle com.inet.report.ReferenceHolder

Seit:

6.0

resetReferences

public final void resetReferences()

FOR INTERNAL USE ONLY

Angegeben von:

resetReferences in Schnittstelle com.inet.report.ReferenceHolder

setReferences

public final void setReferences()

FOR INTERNAL USE ONLY

Angegeben von:

setReferences in Schnittstelle com.inet.report.ReferenceHolder

saveXML2GroupField

protected void saveXML2GroupField(PrintWriter pw,
 int depth)

FOR INTERNAL USE ONLY

parseElement

public NodeParser parseElement(com.inet.report.parser.XMLTag group,
 String tag,
 Attributes atts,
 Map<String,Object> parserMap)
                        throws FatalParserException

FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XML

Parses an XML node with the given information, and returns either a sub-element which was created as a result, or null if no sub-element was created, i.e. the information was applied to the ReportComponent itself. Note that the parsing is highly tolerant, i.e. exceptions are intercepted and suppressed if at all possible.

Angegeben von:

parseElement in Schnittstelle NodeParser

Setzt außer Kraft:

parseElement in Klasse Field

Parameter:

group - XMLTag of the current node to be parsed, or null if there is no such current group. An XMLTag is a group of nodes bundled together, usually it is a Properties node such as CommonProperties, BorderProperties, etc.

tag - The XMLTag to be parsed

atts - The set of attributes in the current XMLTag

parserMap - The map of current Parser.

Gibt zurück:

The NodeParser sub-element if one needed to be created, or null if none was created.

Löst aus:

FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.

validate

public Validity validate()

Check if the object is valid and returns the state and details of possible errors.

Angegeben von:

validate in Schnittstelle Validatable

Gibt zurück:

the current state, never null.