Show: Delphi C++
Display Preferences

FMX.Objects.TImageWrapMode

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

TImageWrapMode = (
Original,
Fit,
Stretch,
Tile,
Center,
Place
);

C++

enum class DECLSPEC_DENUM TImageWrapMode : unsigned char { Original, Fit, Stretch, Tile, Center, Place, iwOriginal _DEPRECATED_ATTRIBUTE3("Use TImageWrapMode.Original")  = 0, iwFit _DEPRECATED_ATTRIBUTE3("Use TImageWrapMode.Fit")  = 1, iwStretch _DEPRECATED_ATTRIBUTE3("Use TImageWrapMode.Stretch")  = 2, iwTile _DEPRECATED_ATTRIBUTE3("Use TImageWrapMode.Tile")  = 3, iwCenter _DEPRECATED_ATTRIBUTE3("Use TImageWrapMode.Center")  = 4 };

Properties

Type Visibility Source Unit Parent
enum public
FMX.Objects.pas
FMX.Objects.hpp
FMX.Objects FMX.Objects

Description

Specifies whether and how to resize, replicate, and position the image for rendering the control surface.

The TImageWrapMode type defines the following constants:

Constant Illustration Meaning

Original

IwOriginal

IwOriginal

Display the image with its original dimensions:

  • The image is placed in the upper-left corner of the rectangle of the control.
  • If the image is larger than the control's rectangle, then only the upper-left part of the image, which fits in the rectangle of the control, is shown. The image is not resized.

Fit

IwFit

IwFit

Best fit the image in the rectangle of the control:

  • If any dimension of the image is larger than the rectangle of the control, then scales down the image (keeping image proportions – the ratio between the width and height) to fit the whole image in the rectangle of the control. That is, either the width of the resized image is equal to the width of the control's rectangle or the height of the resized image is equal to the height of the rectangle of the control. The whole image should be displayed. The image is displayed centered in the rectangle of the control.
  • If the original image is smaller than the rectangle of the control, then the image is stretched to best fit in the rectangle of the control. Whole the image should be displayed. The image is displayed centered in the rectangle of the control.

Stretch

IwStretch

Stretch the image to fill the entire rectangle of the control.

Tile

IwTile

IwTile

Tile (multiply) the image to cover the entire rectangle of the control:

  • If the image is larger than the rectangle of the control, then only the upper-left part of the image, which fits in the rectangle of the control, is shown. The image is not resized.
  • If the image (original size) is smaller than the rectangle of the control, then the multiple images are tiled (placed one next to another) to fill the entire rectangle of the control. The images are placed beginning from the upper-left corner of the rectangle of the control.

Center

IwCenter

IwCenter

Center the image to the rectangle of the control:

  • The image is always displayed at its original size (regardless whether the rectangle of the control is larger or smaller than the image size).

Place

IwFit

IwFit

Fit the image in the rectangle of the control:

  • If any dimension of the image is larger than the rectangle of the control, then scales down the image (keeping image proportions--the ratio between the width and height) to fit the whole image in the rectangle of the control. That is, either the width of the resized image is equal to the width of the control's rectangle or the height of the resized image is equal to the height of the control's rectangle. Whole the image should be displayed. The image is displayed centered in the rectangle of the control.
  • If the original image is smaller than the rectangle of the control, then the image is not resized. The image is displayed centered in the rectangle of the control.

See Also

Personal tools
In Other Languages
Previous Versions
Assistance