Class Axis2D
- java.lang.Object
- com.iizix.prop.GProp<GProp<?>[]>
- com.iizix.prop.PropCnr
- com.iizix.prop.ui.chart.axis2d.Axis2D
- All Implemented Interfaces:
EventListener
,IGProp<GProp<?>[]>
,IPropCnr
,IPropCnrBooleanSettings<AxisOption>
,IPropCnrChoiceSettings<IAxisChoiceOption>
,IPropCnrColorSettings<AxisColor>
,IPropCnrFontSettings<AxisFont>
,IPropCnrIntegerSettings<AxisInteger>
,IPropCnrKStringSettings<AxisKString>
,IPropCnrNumberSettings<AxisNumber>
,IPropCnrStrokeSettings<AxisStroke>
,IChartContainer
,java.lang.Cloneable
- Direct Known Subclasses:
EAxis2D
public class Axis2D extends PropCnr implements IChartContainer, IPropCnrBooleanSettings<AxisOption>, IPropCnrIntegerSettings<AxisInteger>, IPropCnrNumberSettings<AxisNumber>, IPropCnrKStringSettings<AxisKString>, IPropCnrFontSettings<AxisFont>, IPropCnrColorSettings<AxisColor>, IPropCnrStrokeSettings<AxisStroke>, IPropCnrChoiceSettings<IAxisChoiceOption>
A chart axis is normally added to charts. They are either created in the Designer or constructed at runtime and added to the chart. The Designer chart axis persists in XML and can be predefined and only modified at runtime with the required settings.The axis has several options for defining axes. The first option is vertical, which determines if the axis is vertical or horizontal, and defaults to false, which of course means the axis would be horizontal. Make sure that your alignment matches with values set for hAxis and vAxis, which should be "x" and "y", by default, on your plot or your chart will not render and the validation will produce an error.
Next there are the fixUpper and fixLower settings, which align the ticks and have 4 available options: MAJOR, MINOR, MICRO, and NONE. These default to NONE, and when set will force the end bounds to align to the corresponding tick division. If NONE is chosen, the end bounds will be the highest and lowest values in the data set.
Another related option is the "includeZero" option, which will make the lower bound be zero instead of the lowest value. If the lowest data value is negative the "includeZero" option has no effect.
If you wish to have two axis in the same direction, the second one should be set to be secondary. A secondary axis for horizontal is placed above the chart, and for a vertical axis on the right side (unless Right-To-Left [RTL] is in effect).
You can use this to have different min/max ranges for the different axis in the same direction for different data series that are using the axes in question. You will then change the perspective of the second data set to the secondary axis and you have full control to adjust the axis in almost every way possible.
You can turn on and off the tick marks at the minor and micro level, and turn labels on and off for the major and minor levels. There's natural (floating point numbers), which forces all ticks to be on natural numbers, and fixed which will fix the precision on your labels. If you want you can define the step between the ticks.
You can control the color of the axis, the color and length of your tick marks, and the font and color of your labels.
Styled Axis
You can also add a grid at your tick marks to your entire chart by adding a Grid plot. The grid plot allows you to turn the grid on and off for major and minor ticks in both directions, and you can assign axes names if you have multiple axes.
Last but not least, you have the ability to assign custom labels to your axis. Make sure to allow sufficient space in your chart area in the panel for the text to display properly.
- Author:
- Christopher Mindus
Nested Class Summary
Nested classes/interfaces inherited from interface com.iizix.prop.ui.chart.IChartContainer
IChartContainer.Type
Field Summary
Fields inherited from class com.iizix.prop.PropCnr
EMPTY, EMPTY_CLASSES, EMPTY_CNRS, EXTENDS_FRAMEWORK_ERROR_ID
Fields inherited from class com.iizix.prop.GProp
GPDEBUG, PROP_ATTR_STRING_EDITOR_PROP, PROP_ATTR_STRING_ERRORED_NAME, PROP_ATTR_STRING_EXTENDS, PROP_ATTR_STRING_EXTENDS_FINAL, PROP_ATTR_STRING_EXTENDS_PRIVATE, PROP_ATTR_STRING_NULLABLE, PROP_ATTR_STRING_PRIVATE, PROP_ATTR_STRING_PRIVATE_CHANGE_EVENT, PROP_ATTR_STRING_READ_ONLY, PROP_USER_1, PROP_USER_2
Fields inherited from interface com.iizix.prop.IGProp
EQC_ERROR_IGNORE_ALL, EQC_ERROR_IGNORE_REFERENCES, EQC_IGNORE_ARRAY, EQC_IGNORE_VOLATILE_OR_EDITOR, EQC_PRIVATE, EQC_SAVE_FILE, EXT_CONTAINER_EXTENDS, EXT_CONTAINER_EXTENDS_VALID, EXT_EXTENDED, EXT_FINAL, EXT_OVERRIDES, EXT_OVERRIDES_FINAL_ERR, EXT_PRIVATE
Constructor Summary
Constructors Constructor Description Axis2D()
Constructs a new axis without a name.Axis2D(Atom atom)
Constructs a new axis from an Atom name.Axis2D(java.lang.String name)
Constructs a new horizontal axis from a name.Axis2D(java.lang.String name, boolean isVertical)
Constructs a new horizontal axis from a name.
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Axis2D
clone()
Clone must be overridden.IChartContainer.Type
getContainerType()
Gets the type of container.AxisFixLower
getFixLower()
Gets the fixLower option.AxisFixUpper
getFixUpper()
Gets the fixUpper option.AxisPosition
getPosition()
Gets the position of the axis.AxisTitleOrientation
getTitleOrientation()
Gets the title orientation.boolean
verify(PropVerification verification)
Verifies this property container.Methods inherited from class com.iizix.prop.PropCnr
__transferChildProps, addPredefinedProps, addProp, addProp, addProp2, addProp2, appendPropValue, canRequestFocus, completeVirtualize, containsProp, containsProp, convertLoadedProp, couldRequestFocusIfVirtualized, createCopyOfAtom, createUniqueAtom, createUniqueAtom, createUniqueAtom, createVSReference, doPropEqualsArrayValues, doVirtualizePropCnr, enablePropCommunication, enablePropHashMap, equalsTree, equalsTree, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getBool, getBool, getBool, getBool, getChildPropError, getChildPropError, getChildPropErrorSeverity, getChildPropErrorSeverity, getErrorsProp, getExtendsContainer, getExtendsError, getExtendsName, getExtendsOverride, getExtendsPossibleClasses, getFirstProp, getFirstProp, getFocusEngine, getInt, getInt, getInt, getInt, getLong, getLong, getLong, getLong, getNumber, getNumber, getNumber, getNumber, getPossibleChildren, getPredefinedProps, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropBaseReference, getPropCnr, getPropCount, getPropCount, getPropIndex, getPropIndex, getPropIndexes, getProps, getProps, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue0, getReferences, getRetargetedVerifyContainer, getString, getString, getString, getString, getValueClasses, getVSReference, hasFocus, hasSendData, initializeElement, initializeExtendsFramework, initializeProp, initializeValue, initPropCnr, insertProp, insertProp2, isChild, isExtendsOverriden, isExtendsPropertyValid, isExtendsRoot, isPropAddRemoveAllowed, isPropCommunicating, isPropExtended, isSibling, list, list, logPropNotFound, maybeAddProp, onInsertProp, onPropDispose, onPropRemoved, onPropTreeInitialized, onReferenceEvent, paramString, prepare, removeAllProps, removeAllProps2, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, reorderProps, replaceProps, requestFocus, requestFocus, requestFocusEx, requestFocusEx, resolveReferences, resolveRuntimeReferences, setBool, setBool, setBool, setBool, setCreateRequiredProp, setExtendsName, setExtendsOverride, setInt, setInt, setInt, setLong, setLong, setLong, setLong, setNumber, setNumber, setNumber, setNumber, setProp, setProp, setProp, setProp2, setProp2, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setString, setString, setString, setString, shouldCreateProps, shouldSerializeToXML, toElementString, toNativeValue0, usePropHashMap, usesPropIndex, validateChildPropInValue, validateClassInstances, validatePropType, validatePropValue, verifyInternalUseOnly, verifyTree, virtualize
Methods inherited from class com.iizix.prop.GProp
addPropError, addPropListener, convertPropError, dispose, equals, equals, equalsErrors, equalsObj, equalsPropValue, equalValues, extendsClone, finalize, fine, fine, finer, finer, finest, finest, fromElementString, getAliasName, getAppSessionGyro, getAppWorker, getAtomPath, getAttribute, getChildReferencePropName, getClientSessionGyro, getClientWorker, getConstraints, getEnvironment, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropName, getFullPropNameDebug, getFullPropNameDebug, getListeners, getModuleFolder, getModuleFolder, getParent, getParent, getProjectName, getPropAtom, getPropError, getPropError, getPropErroredName, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromPath, getPropFromReference, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropReferenceTarget, getPropRootPropMgr, getPropTreeErrorSeverity, getPropValue, getPropValue, getPropValueObject, getReferencePropName, getRelativePropName, getRootFromName, getRootName, getRootParent, getRootParent, getTreeLock, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropForEditor, isPropNullable, isPropPrivate, isPropPrivateAtCreation, isPropReadOnly, isPropReferenceTreeValid, isPropRoot, isPropUSER, isPropValueTreeLockNeeded, isPropVirtualized, isPropVirtualizing, isPropVolatile, isPropVolatileOrEditorOnly, isProxied, list, list, list, mapAliasToReference, mapAliasToReference, mapReferenceToAlias, mapReferenceToAlias, mapReferenceToProjectRelative, modifyPropValue, moveProp, moveProp, moveProp, onEvent, onEventSelf, onPrepare, onPropInvalidateCache, onPropParentChanged, onPropValueSet, onRemoteEvent, onVirtualizationCompleted, onVirtualized, paramValue, post, post, removePropError, removePropListener, removePropUSER, renameProp, renameProp2, resetChangedTree, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPrivateCreateRequiredProp, setPropError, setPropErroredName, setPropExtended, setPropExtendsFinal, setPropExtendsPrivate, setPropForEditor, setPropNullable, setPropPrivate, setPropReadOnly, setPropUSER, setPropValue, setPropValue, setPropValue, setPropValueIncognito, setPropVolatile, severe, severe, severe, shouldSerializeToXML, throwIfReadOnly, toNativeValue, toString, toString, triggerRemoteEvent, triggerRemoteEvent, validateProp, verifyHasPropertyItem, warning, warning, warning
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.iizix.prop.ui.chart.IChartContainer
getChart, getName
Methods inherited from interface com.iizix.prop.IGProp
addPropError, addPropListener, dispose, equals, fine, fine, finer, finer, finest, finest, fromElementString, getAppSessionGyro, getAtomPath, getClientSessionGyro, getConstraints, getEnvironment, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropNameDebug, getModuleFolder, getModuleFolder, getParent, getParent, getPropAtom, getPropBaseReference, getPropError, getPropError, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropRootPropMgr, getPropTreeErrorSeverity, getPropValue, getPropValue, getReferencePropName, getReferences, getRelativePropName, getRootParent, getTreeLock, getValueClasses, getVSReference, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCommunicating, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropNullable, isPropPrivate, isPropReadOnly, isPropReferenceTreeValid, isPropRoot, isPropVirtualized, list, list, list, list, list, mapAliasToReference, mapReferenceToAlias, mapReferenceToProjectRelative, moveProp, moveProp, moveProp, onEvent, onEventSelf, onPropTreeInitialized, onRemoteEvent, removePropError, removePropListener, renameProp, resolveRuntimeReferences, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPropError, setPropExtendsFinal, setPropExtendsPrivate, setPropNullable, setPropPrivate, setPropReadOnly, setPropValue, setPropValue, severe, severe, severe, toElementString, toNativeValue, triggerRemoteEvent, triggerRemoteEvent, validateProp, validatePropType, validatePropValue, verifyHasPropertyItem, warning, warning, warning
Methods inherited from interface com.iizix.prop.IPropCnr
addProp, addProp, addProp2, addProp2, canRequestFocus, canRequestFocus, canRequestFocus, containsProp, containsProp, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized, createCopyOfAtom, createUniqueAtom, createUniqueAtom, enablePropCommunication, enablePropHashMap, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getBool, getBool, getBool, getBool, getChildPropError, getChildPropError, getChildPropErrorSeverity, getChildPropErrorSeverity, getErrorsProp, getExtendsError, getExtendsName, getExtendsPossibleClasses, getFirstProp, getFirstProp, getFocusEngine, getInt, getInt, getInt, getInt, getLong, getLong, getLong, getLong, getNumber, getNumber, getNumber, getNumber, getPossibleChildren, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropCnr, getPropCount, getPropIndex, getPropIndex, getPropIndexes, getProps, getProps, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getString, getString, getString, getString, hasFocus, initializeExtendsFramework, insertProp, insertProp2, isChild, isExtendsOverriden, isExtendsRoot, isPropAddRemoveAllowed, isPropExtended, isSibling, removeAllProps, removeAllProps2, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, reorderProps, requestFocus, requestFocusEx, setBool, setBool, setBool, setBool, setExtendsName, setExtendsOverride, setInt, setInt, setInt, setLong, setLong, setLong, setLong, setNumber, setNumber, setNumber, setNumber, setProp, setProp, setProp, setProp2, setProp2, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setString, setString, setString, setString, usePropHashMap, usesPropIndex, validateClassInstances
Methods inherited from interface com.iizix.prop.IPropCnrBooleanSettings
get, set
Methods inherited from interface com.iizix.prop.IPropCnrChoiceSettings
set
Methods inherited from interface com.iizix.prop.IPropCnrColorSettings
get, getNoDefault, set
Methods inherited from interface com.iizix.prop.IPropCnrFontSettings
get, getNoDefault, set
Methods inherited from interface com.iizix.prop.IPropCnrIntegerSettings
get, set
Methods inherited from interface com.iizix.prop.IPropCnrKStringSettings
get, getNoDefault, set, set
Methods inherited from interface com.iizix.prop.IPropCnrNumberSettings
get, set
Methods inherited from interface com.iizix.prop.IPropCnrStrokeSettings
get, getNoDefault, set
Constructor Detail
Axis2D
public Axis2D(java.lang.String name)
Constructs a new horizontal axis from a name.- Parameters:
name
- The name of the series. The name MUST be a validAtom
name and cannot start with "$".- Throws:
java.lang.NullPointerException
- If the name is null.java.lang.IllegalArgumentException
- If the name is invalid.
Axis2D
public Axis2D(java.lang.String name, boolean isVertical)
Constructs a new horizontal axis from a name.- Parameters:
name
- The name of the series. The name MUST be a validAtom
name.isVertical
- The vertical flag.- Throws:
java.lang.NullPointerException
- If the name is null.java.lang.IllegalArgumentException
- If the name is invalid.
Axis2D
public Axis2D()
Constructs a new axis without a name.This constructor is used by the persistence framework and should not be used.
Axis2D
public Axis2D(Atom atom)
Constructs a new axis from an Atom name.This constructor is used by the persistence framework and should not be used.
- Parameters:
atom
- The atom name.
Method Detail
getContainerType
public final IChartContainer.Type getContainerType()
Gets the type of container.- Specified by:
getContainerType
in interfaceIChartContainer
- Returns:
- Type.AXIS.
getFixLower
public AxisFixLower getFixLower()
Gets the fixLower option.- Returns:
- The choice set, or the
AxisFixLower.NONE
if the option is undefined.
getFixUpper
public AxisFixUpper getFixUpper()
Gets the fixUpper option.- Returns:
- The choice set, or the
AxisFixUpper.NONE
if the option is undefined.
getPosition
public AxisPosition getPosition()
Gets the position of the axis.- Returns:
- The choice set, or the
AxisPosition.LEFT_OR_BOTTOM
if the option is undefined.
getTitleOrientation
public AxisTitleOrientation getTitleOrientation()
Gets the title orientation.- Returns:
- The choice set, or the
AxisTitleOrientation.AXIS
if the option is undefined.
verify
public boolean verify(PropVerification verification)
Verifies this property container. The check performed is the extension of classes and that no circular reference is present.