TImageEnMView.UpperGap

Declaration

property UpperGap: integer;

Description

Specifies the distance between the thumbnail image and its top border.
UpperGap is also the default value, if -1 is specified for LeftGap or BottomGap.

You can use UpperGap to reserve space for painting, e.g. custom text (with OnImageDraw).

Default: 0 (but is changed by calls to SetModernStyling)

Compatibility Notes

In older versions, UpperGap would be internally increased to allow space for top text. This does not occur from v6.22.
To maintain consistent styling, an UpperGap of more than twelve is assumed to include text space (i.e. If UpperGap <= 12: ActualGap = UpperGap + Text_Height. If UpperGap > 12: ActualGap = UpperGap Only).

Example

// Add six pixel gap on all sides of thumbnail
ImageEnMView1.UpperGap := 6;
ImageEnMView1.BottomGap := -1; // inherit
ImageEnMView1.LeftGap   := -1; // inherit
ImageEnMView1.RightGap := -1; // inherit

// Add 6 pixel gap on sides and 4 pixels above and below
ImageEnMView1.UpperGap := 4;
ImageEnMView1.BottomGap := -1; // inherit
ImageEnMView1.LeftGap   := 6;
ImageEnMView1.RightGap := -1; // inherit

// Add custom gaps on all sides
ImageEnMView1.UpperGap := 4;
ImageEnMView1.BottomGap := 10;
ImageEnMView1.LeftGap   := 6;
ImageEnMView1.RightGap := 5;

TImageEnMView.UpperGap