THIS CLASS IS INTENDED FOR INTERNAL USE IN IMPLEMENTING LOCALE SENSITIVE
COMPONENTS THAT USE IMAGE RESOURCES AND SHOULD NOT BE USED DIRECTLY BY
END-USERS.
This class contains the logic for extracting static image resources
referenced by the SRC attribute of component tags and keeping these static
image resources in sync with the component locale.
If no image is specified by the SRC attribute of an IMG tag, then any VALUE
attribute is inspected. If there is a VALUE attribute, it must be of the form
"[factoryName]:[sharedImageName]?:[specification]". [factoryName] is the name
of a resource factory that has been added to Application (for example,
DefaultButtonImageResourceFactory is installed by default under the name
"buttonFactory"). The [sharedImageName] value is optional and gives a name
under which a given generated image is shared. For example, a cancel button
image generated by the VALUE attribute "buttonFactory:cancelButton:Cancel" is
shared under the name "cancelButton" and this specification will cause a
component to reference the same image resource no matter what page it appears
on, which is a very convenient and efficient way to create and share images.
The [specification] string which follows the second colon is passed directly
to the image factory and its format is dependent on the specific image
factory. For details on the default buttonFactory, see
DefaultButtonImageResourceFactory .
Finally, if there is no SRC attribute and no VALUE attribute, the Image
component's model is converted to a String and that value is used as a path
to load the image.
This class contains the logic for extracting static image resources referenced by the SRC attribute of component tags and keeping these static image resources in sync with the component locale.
If no image is specified by the SRC attribute of an IMG tag, then any VALUE attribute is inspected. If there is a VALUE attribute, it must be of the form "[factoryName]:[sharedImageName]?:[specification]". [factoryName] is the name of a resource factory that has been added to Application (for example, DefaultButtonImageResourceFactory is installed by default under the name "buttonFactory"). The [sharedImageName] value is optional and gives a name under which a given generated image is shared. For example, a cancel button image generated by the VALUE attribute "buttonFactory:cancelButton:Cancel" is shared under the name "cancelButton" and this specification will cause a component to reference the same image resource no matter what page it appears on, which is a very convenient and efficient way to create and share images. The [specification] string which follows the second colon is passed directly to the image factory and its format is dependent on the specific image factory. For details on the default buttonFactory, see DefaultButtonImageResourceFactory .
Finally, if there is no SRC attribute and no VALUE attribute, the Image component's model is converted to a String and that value is used as a path to load the image.