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 an- Element.- 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, getLookupPropReference, getPropValue0, getReference, getReferences, getReferenceString, getTargetReference, getTargetReference, getValueClasses, initializeReferenceClone, 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 the- ImageDefinition.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 PropExceptionCalled to initialize the property from an- Element. 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 by- setPropertyValue(object).- Overrides:
- initializePropin class- GProp<ReferenceString>
- Parameters:
- element- The- Element.
- 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:
- initializeElementin class- GProp<ReferenceString>
- Parameters:
- element- The- Elementto initialize.
 
 - getReferenceDescription- public java.lang.String getReferenceDescription() Gets a short description of this reference.- Specified by:
- getReferenceDescriptionin interface- IPropReference
- Specified by:
- getReferenceDescriptionin class- AbstractReference<IImageTarget>
- Returns:
- "Image".
 
 - getPropertyClass- public java.lang.Class<?> getPropertyClass() Gets the class wanted.- Specified by:
- getPropertyClassin class- AbstractReference<IImageTarget>
 
 - isReferenceValid- public boolean isReferenceValid(GProp<?> property) Validates the property reference that has been looked up.- Specified by:
- isReferenceValidin interface- IPropReference
- Specified by:
- isReferenceValidin class- AbstractReference<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:
- onEventSelfin interface- IGProp<ReferenceString>
- Overrides:
- onEventSelfin class- AbstractReference<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 call- super.informResolved().- Overrides:
- informResolvedin class- FixedVirtualizedAbstractReference<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 call- super.informError().- Overrides:
- informErrorin class- FixedVirtualizedAbstractReference<IImageTarget>
 
 - clone- public ImageReference clone() Cloning first makes sure there is a cached ClientImageData instance available in source.- Overrides:
- clonein class- AbstractReference<IImageTarget>
 
 - appendPropValue- protected void appendPropValue(PropMgr propertyManager, SendTransaction trans, java.lang.Object value) Sends the data to the client in a transaction.- Overrides:
- appendPropValuein class- AbstractReference<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:
- collectConsumedFontsin interface- IFontConsumer
- Parameters:
- fonts- The set of consumed fonts is filled in by this method.