.
Eloquence JDLG contact contact


JDLG object and attribute reference:
Image class

 
.
  Document revision: 2023-02-22
Refers to JDLG version: 2.0.16


Contents


The Image class allows to display images in a Dialog. The sw and sh attributes specify how the image is aligned and whether it is clipped or scaled.

If a nonzero rule value is specified, the Image is clickable, although not focusable.

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).


 
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision: 2023-02-22  
  Copyright © 1995-2021 Marxmeier Software AG