Package com.iizix.prop
Class ImageReference
- java.lang.Object
- com.iizix.prop.GProp<ReferenceString>
- com.iizix.prop.AbstractReference<TARGET>
- com.iizix.prop.FixedVirtualizedAbstractReference<IImageTarget>
- com.iizix.prop.ImageReference
- All Implemented Interfaces:
EventListener
,IFontConsumer
,ICircularRetargetParent
,IGProp<ReferenceString>
,IPropReference
,java.lang.Cloneable
- Direct Known Subclasses:
BackgroundImageReference
public class ImageReference extends FixedVirtualizedAbstractReference<IImageTarget> implements IFontConsumer
The Image Reference property class hold the reference to an image definition implementing IImageTarget that in turn has images for various states and resolutions.- Author:
- Christopher Mindus
Nested Class Summary
Nested classes/interfaces inherited from interface com.iizix.prop.IPropReference
IPropReference.ReferenceChangeEvent
Field Summary
Fields inherited from class com.iizix.prop.FixedVirtualizedAbstractReference
fixedTarget
Fields inherited from class com.iizix.prop.AbstractReference
ERROR_ID, hasBeenValidated, QUICK_FIX_DELETE_PROP, reference
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 Modifier Constructor Description protected
ImageReference()
Creates a Action Reference property with no name and with a null value.ImageReference(Atom propertyAtom)
Creates a Image Reference property with the specified name with a null value.ImageReference(Atom propertyAtom, java.lang.String newValue)
Creates a Image Reference property with the specified name and value.
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
appendPropValue(PropMgr propertyManager, SendTransaction trans, java.lang.Object value)
Sends the data to the client in a transaction.ImageReference
clone()
Cloning first makes sure there is a cached ClientImageData instance available in source.void
collectConsumedFonts(java.util.Set<FontConsumed> fonts)
Collects the consumed fonts.ClientImageData
getClientImageData()
Gets the ClientImageData instance.java.lang.Class<?>
getPropertyClass()
Gets the class wanted.java.lang.String
getReferenceDescription()
Gets a short description of this reference.protected void
informError()
Called when the property has an error.protected void
informResolved()
Called when the property has been resolved.protected void
initializeElement(org.w3c.dom.Element element)
Called when the XML file for the property tree is serialized from properties.protected void
initializeProp(org.w3c.dom.Element element)
Called to initialize the property from anElement
.boolean
isReferenceValid(GProp<?> property)
Validates the property reference that has been looked up.void
onEventSelf(GEvent event)
Overridden to check for cache clearing...boolean
setImage(IImageTarget image)
Sets the image reference to the specified image.void
setImageTypes(int... types)
Assigns the image types that are requested.Methods inherited from class com.iizix.prop.FixedVirtualizedAbstractReference
clearFixedTarget, getFixedTarget, informClearError, onBroken, onReferenceDisposed, onResolved, onVirtualizationCompleted, onVirtualized
Methods inherited from class com.iizix.prop.AbstractReference
assignError, assignNotFoundError, changeReference, checkCreateReference, clearError, createUpdateReference, disposeReference, doPostResolve, equalsErrors, equalValues, getAbsoluteReference, getLookupPropReference, getPropValue0, getReference, getReferences, getReferenceString, getTargetReference, getTargetReference, getValueClasses, initializeValue, isValid, onProjectNameChanged, onPropDispose, onPropParentChanged, onRefactored, onReferenceEvent, onReferenceEvent, setLookedUpReference, setPropValue, toNativeValue0, updateReference, validatePropType, validateReferenceScope, wouldValidate
Methods inherited from class com.iizix.prop.GProp
addPropError, addPropListener, convertPropError, dispose, equals, equals, equalsObj, equalsPropValue, equalsTree, 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, getPropBaseReference, 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, getVSReference, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCommunicating, 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, list, list, mapAliasToReference, mapAliasToReference, mapReferenceToAlias, mapReferenceToAlias, mapReferenceToProjectRelative, modifyPropValue, moveProp, moveProp, moveProp, onEvent, onPrepare, onPropInvalidateCache, onPropTreeInitialized, onPropValueSet, onRemoteEvent, paramString, paramValue, post, post, removePropError, removePropListener, removePropUSER, renameProp, renameProp2, resetChangedTree, resolveRuntimeReferences, setChanged, setConstraints, setConstraints, setCreateRequiredProp, setParent, setPrivateChangeEventProp, setPrivateCreateRequiredProp, setPropError, setPropErroredName, setPropExtended, setPropExtendsFinal, setPropExtendsPrivate, setPropForEditor, setPropNullable, setPropPrivate, setPropReadOnly, setPropUSER, setPropValue, setPropValue, setPropValue, setPropValueIncognito, setPropVolatile, severe, severe, severe, shouldSerializeToXML, throwIfReadOnly, toElementString, toNativeValue, toString, toString, triggerRemoteEvent, triggerRemoteEvent, validateProp, validatePropValue, verify, verifyHasPropertyItem, virtualize, warning, warning, warning
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.iizix.prop.ICircularRetargetParent
isCircularRetargetParent
Constructor Detail
ImageReference
protected ImageReference()
Creates a Action Reference property with no name and with a null value.
ImageReference
public ImageReference(Atom propertyAtom)
Creates a Image Reference property with the specified name with a null value.- Parameters:
propertyAtom
- the property atom.
ImageReference
public ImageReference(Atom propertyAtom, java.lang.String newValue)
Creates a Image Reference property with the specified name and value.- Parameters:
propertyAtom
- the property atom.newValue
- the new string value for the property.
Method Detail
setImageTypes
public void setImageTypes(int... types)
Assigns the image types that are requested.- Parameters:
types
- The list of image types requested, each value is combined of theImageDefinition.ID_MASK_*
values. If types is empty or null or contains a single value -1, all types are used.
initializeProp
protected void initializeProp(org.w3c.dom.Element element) throws PropException
Called to initialize the property from anElement
. The property should initialize itself from attributes and nodes with appropriate information.Subclasses should override this method if custom initialization is required.
The default implementation gets the attribute "value" and calls the methods
object=convertPropertyValue(string)
followed bysetPropertyValue(object)
.- Overrides:
initializeProp
in classGProp<ReferenceString>
- Parameters:
element
- TheElement
.- Throws:
PropException
- when the initialization fails.
initializeElement
protected void initializeElement(org.w3c.dom.Element element)
Called when the XML file for the property tree is serialized from properties. The property should fill attributes and nodes with appropriate information.Subclasses should override this method if custom initialization is required.
- Overrides:
initializeElement
in classGProp<ReferenceString>
- Parameters:
element
- TheElement
to initialize.
getReferenceDescription
public java.lang.String getReferenceDescription()
Gets a short description of this reference.- Specified by:
getReferenceDescription
in interfaceIPropReference
- Specified by:
getReferenceDescription
in classAbstractReference<IImageTarget>
- Returns:
- "Image".
getPropertyClass
public java.lang.Class<?> getPropertyClass()
Gets the class wanted.- Specified by:
getPropertyClass
in classAbstractReference<IImageTarget>
isReferenceValid
public boolean isReferenceValid(GProp<?> property)
Validates the property reference that has been looked up.- Specified by:
isReferenceValid
in interfaceIPropReference
- Specified by:
isReferenceValid
in classAbstractReference<IImageTarget>
- Parameters:
property
- The property to validate.- Returns:
- true if valid, false otherwise.
setImage
public boolean setImage(IImageTarget image)
Sets the image reference to the specified image.- Parameters:
image
- The image.- Returns:
- true for changed, false for no change.
- Throws:
java.lang.NullPointerException
- If image is null.
getClientImageData
public ClientImageData getClientImageData()
Gets the ClientImageData instance.- Returns:
- The instance of the Client image data, or null if not a valid reference.
onEventSelf
public void onEventSelf(GEvent event)
Overridden to check for cache clearing...- Specified by:
onEventSelf
in interfaceIGProp<ReferenceString>
- Overrides:
onEventSelf
in classAbstractReference<IImageTarget>
- Parameters:
event
- The property event.
informResolved
protected void informResolved()
Called when the property has been resolved. Subclasses override this method to implement some behavior. The default implementation performs nothing, i.e. there is no need to callsuper.informResolved()
.- Overrides:
informResolved
in classFixedVirtualizedAbstractReference<IImageTarget>
informError
protected void informError()
Called when the property has an error. Subclasses override this method to implement some behavior. The default implementation performs nothing, i.e. there is no need to callsuper.informError()
.- Overrides:
informError
in classFixedVirtualizedAbstractReference<IImageTarget>
clone
public ImageReference clone()
Cloning first makes sure there is a cached ClientImageData instance available in source.- Overrides:
clone
in classAbstractReference<IImageTarget>
appendPropValue
protected void appendPropValue(PropMgr propertyManager, SendTransaction trans, java.lang.Object value)
Sends the data to the client in a transaction.- Overrides:
appendPropValue
in classAbstractReference<IImageTarget>
- Parameters:
propertyManager
- the property manager instance.trans
- transaction to append the properties to.value
- the value to append to the transaction, a reference to the current property value.
collectConsumedFonts
public void collectConsumedFonts(java.util.Set<FontConsumed> fonts)
Collects the consumed fonts.- Specified by:
collectConsumedFonts
in interfaceIFontConsumer
- Parameters:
fonts
- The set of consumed fonts is filled in by this method.