ImageMode (Property)

the display mode of an image,
Versions 18 and later
the alignment of image,
New in version 18
the alignment of image,
the alignment of image,
Versions 18 and later
the HQ mode of image.
New in version 18
the HQ mode of image.
the HQ mode of image.

This property can be used:

for an Image control,
for an Image table column,
for the background of a Chart control found in a window,
Versions 22 and later
for a Button control.
New in version 22
for a Button control.
for a Button control.

Versions 15 and later

This property is available in WEBDEV in Server code.

New in version 15

This property is available in WEBDEV in Server code.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 18 and later

This property is now available for iPhone/iPad applications.

New in version 18

This property is now available for iPhone/iPad applications.

Versions 20 and later

This property is now available for table columns in Android and iPhone/iPad applications.

New in version 20

This property is now available for table columns in Android and iPhone/iPad applications.

Remark: The display mode of an image is defined in the window editor or in the page editor in the control description ("General" tab).

For example:


Normal image	Centered image	Stretched image
Homothetic centered image	Tiled image

Example

// Modify the display mode of image found in the "IMG_CarImage" control
IMG_CarImage.ImageMode = imgTiled

Versions 18 and later

// Modify the display mode and the alignment mode of image found in "IMG_CarImage"
IMG_CarImage.ImageMode = imgNormal + imgAlignVBottom

New in version 18

// Modify the display mode and the alignment mode of image found in "IMG_CarImage"
IMG_CarImage.ImageMode = imgNormal + imgAlignVBottom

Versions 21 and later

// Management of large fonts: the image is not enlarged because a drawing will be performed
IMG_CarImage.ImageMode = IMG_CarImage.ImageMode + imgNoScale

New in version 21

// Management of large fonts: the image is not enlarged because a drawing will be performed
IMG_CarImage.ImageMode = IMG_CarImage.ImageMode + imgNoScale

Syntax

Finding out the display mode and the alignment mode of an image Hide the details

<Current mode> = <Control used>.ImageMode

<Current mode>: Integer constant (or combination of constants)

Current image display mode:
imgCentered Centered: Image centered in the control.
imgH Homothetic: Image enlarged or reduced (while respecting the proportions of initial image) to occupy the entire surface of control.
imgHC Homothetic centered: Image enlarged or reduced (while respecting the proportions of initial image) to occupy the entire surface of control and centered in the control.
imgHCE Homothetic centered extended: Image enlarged or reduced (while respecting the proportions of the initial image) in order for the smaller side of the image to be entirely displayed in the control and in order for the image to be centered in the control.
imgHCWIS Homothetic without enlargement: If the image can be entirely displayed in the control, it is displayed at 100% and centered in the control. Otherwise, the image is proportionally reduced in order to be entirely displayed and centered in the control.
This constant is not available.
imgHE Homothetic extended: Image enlarged or reduced (while respecting the proportions of initial image) so that the smaller side of image is entirely displayed in the control.
imgHWIS Homothetic without enlargement: If the image can be entirely displayed in the control, it is displayed at 100%. Otherwise, the image is proportionally reduced in order to be entirely displayed.
This constant is not available.
imgNormal 100%: Image displayed at 100% in the upper-left corner of the control.
imgStretched Stretched: Image stretched across the entire surface of the control.
imgTiled Tiled: Image displayed at 100% and tiled to occupy the entire surface of control (tile).
Versions 18 and later
Alignment mode of the image:
Versions 18 and later
imgAlignHCentered
New in version 18
imgAlignHCentered
imgAlignHCentered Horizontally centered.
This constant is not available.
Versions 18 and later
imgAlignHRight
New in version 18
imgAlignHRight
imgAlignHRight Horizontal alignment to right.
This constant is not available.
Versions 18 and later
imgAlignVBottom
New in version 18
imgAlignVBottom
imgAlignVBottom Bottom vertical alignment.
This constant is not available.
Versions 18 and later
imgAlignVCentered
New in version 18
imgAlignVCentered
imgAlignVCentered Vertically centered.
This constant is not available.
New in version 18
Alignment mode of the image:
Versions 18 and later
imgAlignHCentered
New in version 18
imgAlignHCentered
imgAlignHCentered Horizontally centered.
This constant is not available.
Versions 18 and later
imgAlignHRight
New in version 18
imgAlignHRight
imgAlignHRight Horizontal alignment to right.
This constant is not available.
Versions 18 and later
imgAlignVBottom
New in version 18
imgAlignVBottom
imgAlignVBottom Bottom vertical alignment.
This constant is not available.
Versions 18 and later
imgAlignVCentered
New in version 18
imgAlignVCentered
imgAlignVCentered Vertically centered.
This constant is not available.
Alignment mode of the image:
Versions 18 and later
imgAlignHCentered
New in version 18
imgAlignHCentered
imgAlignHCentered Horizontally centered.
This constant is not available.
Versions 18 and later
imgAlignHRight
New in version 18
imgAlignHRight
imgAlignHRight Horizontal alignment to right.
This constant is not available.
Versions 18 and later
imgAlignVBottom
New in version 18
imgAlignVBottom
imgAlignVBottom Bottom vertical alignment.
This constant is not available.
Versions 18 and later
imgAlignVCentered
New in version 18
imgAlignVCentered
imgAlignVCentered Vertically centered.
This constant is not available.
Versions 18 and later
Management of image quality:
Versions 18 and later
imgHQ
New in version 18
imgHQ
imgHQ In homothetic mode, used to improve the quality of image when this one is reduced in relation to its initial size.
This constant is not available.
New in version 18
Management of image quality:
Versions 18 and later
imgHQ
New in version 18
imgHQ
imgHQ In homothetic mode, used to improve the quality of image when this one is reduced in relation to its initial size.
This constant is not available.
Management of image quality:
Versions 18 and later
imgHQ
New in version 18
imgHQ
imgHQ In homothetic mode, used to improve the quality of image when this one is reduced in relation to its initial size.
This constant is not available.
Versions 21 and later
Management of large fonts:
Versions 21 and later
imgNoScale
New in version 21
imgNoScale
imgNoScale In "Large fonts" mode of Windows, the image displayed in an Image control is automatically zoomed.
The imgNoScale constant allows you not to zoom the image in "Large fonts" mode. This constant is useful for controls where a drawing is performed on a bitmap image coming from a screenshot.
This constant must be combined with one of the constants used to define the display mode of image.
This constant is not available.
New in version 21
Management of large fonts:
Versions 21 and later
imgNoScale
New in version 21
imgNoScale
imgNoScale In "Large fonts" mode of Windows, the image displayed in an Image control is automatically zoomed.
The imgNoScale constant allows you not to zoom the image in "Large fonts" mode. This constant is useful for controls where a drawing is performed on a bitmap image coming from a screenshot.
This constant must be combined with one of the constants used to define the display mode of image.
This constant is not available.
Management of large fonts:
Versions 21 and later
imgNoScale
New in version 21
imgNoScale
imgNoScale In "Large fonts" mode of Windows, the image displayed in an Image control is automatically zoomed.
The imgNoScale constant allows you not to zoom the image in "Large fonts" mode. This constant is useful for controls where a drawing is performed on a bitmap image coming from a screenshot.
This constant must be combined with one of the constants used to define the display mode of image.
This constant is not available.

<Control used>: Control name

Name of the control to be used.

Modifying the display mode and the alignment mode of an image Hide the details

<Control used>.ImageMode = <New mode>

<Control used>: Control name

Name of the control to be used.

<New mode>: Integer constant

New display mode for the image:
imgCentered Centered: Image centered in the control.
imgH Homothetic: Image enlarged or reduced (while respecting the proportions of initial image) to occupy the entire surface of control.
imgHC Homothetic centered: Image enlarged or reduced (while respecting the proportions of initial image) to occupy the entire surface of control and centered in the control.
imgHCE Homothetic centered extended: Image enlarged or reduced (while respecting the proportions of the initial image) in order for the smaller side of the image to be entirely displayed in the control and in order for the image to be centered in the control.
imgHCWIS Homothetic without enlargement: If the image can be entirely displayed in the control, it is displayed at 100% and centered in the control. Otherwise, the image is proportionally reduced in order to be entirely displayed and centered in the control.
This constant is not available.
imgHE Homothetic extended: Image enlarged or reduced (while respecting the proportions of initial image) so that the smaller side of image is entirely displayed in the control.
imgHWIS Homothetic without enlargement: If the image can be entirely displayed in the control, it is displayed at 100%. Otherwise, the image is proportionally reduced in order to be entirely displayed.
This constant is not available.
imgNormal 100%: Image displayed at 100% in the upper-left corner of the control.
imgStretched Stretched: Image stretched across the entire surface of the control.
imgTiled Tiled: Image displayed at 100% and tiled to occupy the entire surface of control (tile).
Versions 18 and later
Alignment mode of the image:
Versions 18 and later
imgAlignHCentered
New in version 18
imgAlignHCentered
imgAlignHCentered Horizontally centered.
This constant is not available.
Versions 18 and later
imgAlignHRight
New in version 18
imgAlignHRight
imgAlignHRight Horizontal alignment to right.
This constant is not available.
Versions 18 and later
imgAlignVBottom
New in version 18
imgAlignVBottom
imgAlignVBottom Bottom vertical alignment.
This constant is not available.
Versions 18 and later
imgAlignVCentered
New in version 18
imgAlignVCentered
imgAlignVCentered Vertically centered.
This constant is not available.
New in version 18
Alignment mode of the image:
Versions 18 and later
imgAlignHCentered
New in version 18
imgAlignHCentered
imgAlignHCentered Horizontally centered.
This constant is not available.
Versions 18 and later
imgAlignHRight
New in version 18
imgAlignHRight
imgAlignHRight Horizontal alignment to right.
This constant is not available.
Versions 18 and later
imgAlignVBottom
New in version 18
imgAlignVBottom
imgAlignVBottom Bottom vertical alignment.
This constant is not available.
Versions 18 and later
imgAlignVCentered
New in version 18
imgAlignVCentered
imgAlignVCentered Vertically centered.
This constant is not available.
Alignment mode of the image:
Versions 18 and later
imgAlignHCentered
New in version 18
imgAlignHCentered
imgAlignHCentered Horizontally centered.
This constant is not available.
Versions 18 and later
imgAlignHRight
New in version 18
imgAlignHRight
imgAlignHRight Horizontal alignment to right.
This constant is not available.
Versions 18 and later
imgAlignVBottom
New in version 18
imgAlignVBottom
imgAlignVBottom Bottom vertical alignment.
This constant is not available.
Versions 18 and later
imgAlignVCentered
New in version 18
imgAlignVCentered
imgAlignVCentered Vertically centered.
This constant is not available.
Versions 18 and later
Management of image quality:
Versions 18 and later
imgHQ
New in version 18
imgHQ
imgHQ In homothetic mode, used to improve the quality of image when this one is reduced in relation to its initial size.
This constant is not available.
New in version 18
Management of image quality:
Versions 18 and later
imgHQ
New in version 18
imgHQ
imgHQ In homothetic mode, used to improve the quality of image when this one is reduced in relation to its initial size.
This constant is not available.
Management of image quality:
Versions 18 and later
imgHQ
New in version 18
imgHQ
imgHQ In homothetic mode, used to improve the quality of image when this one is reduced in relation to its initial size.
This constant is not available.
Versions 21 and later
Management of large fonts:
Versions 21 and later
imgNoScale
New in version 21
imgNoScale
imgNoScale In "Large fonts" mode of Windows, the image displayed in an Image control is automatically zoomed.
The imgNoScale constant allows you not to zoom the image in "Large fonts" mode. This constant is useful for controls where a drawing is performed on a bitmap image coming from a screenshot.
This constant must be combined with one of the constants used to define the display mode of image.
This constant is not available.
New in version 21
Management of large fonts:
Versions 21 and later
imgNoScale
New in version 21
imgNoScale
imgNoScale In "Large fonts" mode of Windows, the image displayed in an Image control is automatically zoomed.
The imgNoScale constant allows you not to zoom the image in "Large fonts" mode. This constant is useful for controls where a drawing is performed on a bitmap image coming from a screenshot.
This constant must be combined with one of the constants used to define the display mode of image.
This constant is not available.
Management of large fonts:
Versions 21 and later
imgNoScale
New in version 21
imgNoScale
imgNoScale In "Large fonts" mode of Windows, the image displayed in an Image control is automatically zoomed.
The imgNoScale constant allows you not to zoom the image in "Large fonts" mode. This constant is useful for controls where a drawing is performed on a bitmap image coming from a screenshot.
This constant must be combined with one of the constants used to define the display mode of image.
This constant is not available.

Remarks

Finding out the display mode and the alignment mode of an image (syntax 1)

The ImageMode property returns a single value representing both the image display and alignment mode.

To separate the alignment information from the display information, a binary filter must be applied in order to subtract the display mask or the alignment mask from the result (BinaryAND).

Tip: To only retrieve the value corresponding to the alignment mode, apply a binary mask whose value is the reunion of all alignment constants. The remaining constant will be the alignment constant used in the image. For example:

CurrentMode is int
MaskAlignmentMode is int
AlignmentMode is int

CurrentMode = IMG_Photo.ImageMode

MaskAlignmentMode = imgAlignHCentered + imgAlignHRight + imgAlignVBottom + imgAlignVCentered

AlignmentMode = BinaryAND(CurrentMode, MaskAlignmentMode)
Info(AlignmentMode)

Limits

The ImageMode property applies only to:

the Image controls,
the Image columns found in the Table controls,
Chart controls in windows,
Versions 22 and later
the Button controls.
New in version 22
the Button controls.
the Button controls.

The ImageMode property applies only to Image controls.

If the display mode is modified through programming, the content of the image must be re-assigned to view the changes.