- class : string, get
- Returns "Image".
- rule : integer, get/set
- If nonzero, the rule value is returned to the program, along with the
path of the Image object (see also
ruleoverride below), when the Image is
clicked.
The default rule value is zero.
See also the documentation of the
common rule attribute.
- ruleoverride : integer, get/set
- Nonzero (default): A rule submission returns
the path of a currently focused
EditText or
ComboBox object to the program.
If neither an EditText nor a
ComboBox object is currently focused,
the path of the Image object
is returned.
Zero: A rule submission returns
the path of the Image object
to the program.
The default ruleoverride value is 1.
For details, please refer to the
RuleOverride documentation.
- scale : integer, set
- If nonzero and the image is scaled to a smaller size, the original
image data is replaced with the scaled image data. This may reduce the
amount of used memory (see note below).
The default value is zero (image not downscaled in memory) unless the
eloquence.config.imagescale
property is configured otherwise.
See also sh and sw below.
Note: If scale is set to nonzero, the data of multiple images
referring to the same URL can no longer be shared.
This may increase the amount of used image memory.
Note: Requires JDLG version 1.6.3 or newer.
- sh : integer, set
- Specifies how the image is displayed. This requires an equivalent
sw attribute setting (see below).
Zero (default): The image is centered. If the image height exceeds the
object height, the image is
vertically clipped. This requires that sw is
also set to zero.
-1: The image is aligned to the top and vertically scaled to the
object height. This requires
that sw is also set to -1.
-2: The image is centered and scaled in aspect ratio to the
object height. This requires
that sw is also set to -2.
Positive value greater than zero: The image is aligned to the top and
vertically scaled to the specified pixel size. This requires that
sw is also set to a positive value greater than zero.
Note: The sw attribute requires an equivalent
setting, otherwise the image is aligned to the left/top position and clipped
if its size exceeds the object size.
- sw : integer, set
- Specifies how the image is displayed. This requires an equivalent
sh attribute setting (see above).
Zero (default): The image is centered. If the image width exceeds the
object width, the image is
horizontally clipped. This requires that sh is
also set to zero.
-1: The image is aligned to the left and horizontally scaled to the
object width. This requires
that sh is also set to -1.
-2: The image is centered and scaled in aspect ratio to the
object width. This requires
that sh is also set to -2.
Positive value greater than zero: The image is aligned to the left and
horizontally scaled to the specified pixel size. This requires that
sh is also set to a positive value greater than zero.
Note: The sh attribute requires an equivalent
setting, otherwise the image is aligned to the left/top position and clipped
if its size exceeds the object size.
- url : string, get/set
- Specifies the URL referring to the image in png, gif
or jpg format.
If a relative URL is specified, the value of the
Application.baseurl
or System.baseurl attribute
or eloquence.config.baseurl
configuration property is prepended.
The default value is empty (image not specified).