ImageEn, unit iemview

TImageEnMView.UpperGap

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;


See Also


- BottomGap
- LeftGap
- RightGap