ImageWidth (Property)

the width of the image section that is displayed in an Image control or in the background of a Chart control.
Versions 18 and later
the width reserved in a row of a TreeView Table control for the image of a treeview column.
New in version 18
the width reserved in a row of a TreeView Table control for the image of a treeview column.
the width reserved in a row of a TreeView Table control for the image of a treeview column.

Remark: The display mode of the image selected in the description of the Image control will be applied to the image section.

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 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Example

IMG_ImageControl.XImage = 20
IMG_ImageControl.YImage = 20
IMG_ImageControl.ImageHeight = 40
IMG_ImageControl.ImageWidth = 40

Versions 18 and later

// Reserves 70 pixels for the image of the hierarchy in the 1st row of the treeview table
TVT_FOLDERS[1].ImageWidth = 70

New in version 18

// Reserves 70 pixels for the image of the hierarchy in the 1st row of the treeview table
TVT_FOLDERS[1].ImageWidth = 70

Syntax

Finding out the width of the displayed section Hide the details

<Section width> = <Control used>.ImageWidth

<Section width>: Integer

Width (expressed in pixels):
of the image section that must be displayed in the Image control.
of the image section that must be displayed in the background of the Chart control.
Versions 18 and later
of the area reserved to the image of the hierarchy in a row of a TreeView Table control.
New in version 18
of the area reserved to the image of the hierarchy in a row of a TreeView Table control.
of the area reserved to the image of the hierarchy in a row of a TreeView Table control.
-1 in the following cases:
the entire image is displayed in the Image control or in the background of the Chart control.
Versions 18 and later
the area reserved to the image of the hierarchy corresponds to the default size.
New in version 18
the area reserved to the image of the hierarchy corresponds to the default size.
the area reserved to the image of the hierarchy corresponds to the default size.

<Control used>: Control name

Name of the control to be used.

Modifying the width of the displayed section Hide the details

<Control used>.ImageWidth = <New width>

<Control used>: Control name

Name of the control to be used.

<New width>: Integer

Width (expressed in pixels):
of the image section that must be displayed in the Image control.
of the image section that must be displayed in the background of the Chart control.
Versions 18 and later
of the area reserved to the image of the hierarchy in a row of a TreeView Table control.
New in version 18
of the area reserved to the image of the hierarchy in a row of a TreeView Table control.
of the area reserved to the image of the hierarchy in a row of a TreeView Table control.
-1 in the following cases:
to display the entire image in the Image control or in the background of the Chart control.
Versions 18 and later
in order for the area reserved to the image of the hierarchy to correspond to the default size.
New in version 18
in order for the area reserved to the image of the hierarchy to correspond to the default size.
in order for the area reserved to the image of the hierarchy to correspond to the default size.

Remarks

Defining the image section

An Image control is used to display a section of the image found in the associated image file. The following properties are used to define the image section that will be displayed in the Image control:

XImage: used to define the origin of the image section.
YImage: used to define the origin of the image section.
ImageHeight: used to define the height of the image section.
ImageWidth: used to define the width of the image section.


	In this example, the image section included in the red border will be displayed in the Image control. The display mode of this image section will be the one defined for the Image control.

Limits

In the windows, this property only applies to the following controls:

Image control.
Chart control.
Versions 18 and later
Row of a TreeView Table control.
New in version 18
Row of a TreeView Table control.
Row of a TreeView Table control.

The ImageWidth property applies only to Image controls.