ImageMode (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

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

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ImageMode (Property)

In french: ImageMode

The ImageMode property is used to get and change:

the display mode of an image,
the alignment 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,
for a Button control.

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

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

// 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: The image stretches or shrinks while maintaining its aspect ratio to fit the control.
imgHC Homothetic centered: The image stretches or shrinks while maintaining its aspect ratio to be centered and fit 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 full image fits the control, it is displayed at its original size (100%) and centered in the control. Otherwise, it is downsized, while maintaining its aspect ratio to fit and appear centered in the control.
This constant is not available.
imgHE Homothetic extended: The image stretches or shrinks while maintaining its aspect ratio so that the smaller side of the image fits the control.
imgHWIS Homothetic without enlargement: If the full image fits the control, it is displayed at its original size (100%). Otherwise, it is downsized, while maintaining its aspect ratio to fit the control.
This constant is not available.
imgNormal 100%: The image is displayed at its original size (100%) in the upper-left corner of the control.
imgStretched Stretched: The image stretches to fill the control.
imgTiled Tiled: The image is repeated while maintaining its original size (100%) to fit the control (tile design).
Alignment mode of the image:
imgAlignHCentered Horizontally centered.
This constant is not available.
imgAlignHRight Horizontal alignment to right.
This constant is not available.
imgAlignVBottom Bottom vertical alignment.
This constant is not available.
imgAlignVCentered Vertically centered.
This constant is not available.
Management of image quality:
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 large fonts:
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 drawing in controls that contain a bitmap 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: The image stretches or shrinks while maintaining its aspect ratio to fit the control.
imgHC Homothetic centered: The image stretches or shrinks while maintaining its aspect ratio to be centered and fit 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 full image fits the control, it is displayed at its original size (100%) and centered in the control. Otherwise, it is downsized, while maintaining its aspect ratio to fit and appear centered in the control.
This constant is not available.
imgHE Homothetic extended: The image stretches or shrinks while maintaining its aspect ratio so that the smaller side of the image fits the control.
imgHWIS Homothetic without enlargement: If the full image fits the control, it is displayed at its original size (100%). Otherwise, it is downsized, while maintaining its aspect ratio to fit the control.
This constant is not available.
imgNormal 100%: The image is displayed at its original size (100%) in the upper-left corner of the control.
imgStretched Stretched: The image stretches to fill the control.
imgTiled Tiled: The image is repeated while maintaining its original size (100%) to fit the control (tile design).
Alignment mode of the image:
imgAlignHCentered Horizontally centered.
This constant is not available.
imgAlignHRight Horizontal alignment to right.
This constant is not available.
imgAlignVBottom Bottom vertical alignment.
This constant is not available.
imgAlignVCentered Vertically centered.
This constant is not available.
Management of image quality:
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 large fonts:
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 drawing in controls that contain a bitmap 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 (BitwiseAND).

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 = BitwiseAND(CurrentMode, MaskAlignmentMode)
Info(AlignmentMode)

Limitations

The ImageMode property applies only to:

Image controls,
Image columns in Table controls,
Chart controls in windows,
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.