Vcl.StdCtrls.TEllipsisPosition

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

TEllipsisPosition = (epNone, epPathEllipsis, epEndEllipsis, epWordEllipsis);

C++

enum DECLSPEC_DENUM TEllipsisPosition : unsigned char { epNone, epPathEllipsis, epEndEllipsis, epWordEllipsis };

Properties

Type Visibility Source Unit Parent
enum public
Vcl.StdCtrls.pas
Vcl.StdCtrls.hpp
Vcl.StdCtrls Vcl.StdCtrls

Description

Specifies how ellipsis is placed in text not fitting in allocated rectangle.

TEllipsisPosition specifies how an ellipsis is placed in text that does not fit in its allocated rectangle. The constants here correspond to constants specifying ellipsis placement in the dwDTFormat parameter of the Windows DrawText and DrawTextEx functions.

The following table lists values for TEllipsisPosition:



Value Meaning

epNone

An ellipsis is not inserted.

epPathEllipsis

Replaces text in the middle with an ellipsis so that the resulting text fits in the rectangle specified. If the text contains backslash (\) characters, treat the text as a path and attempt to preserve as much text as possible after the last backslash. Corresponds to a value of DT_PATH_ELLIPSIS in the dwDTFormat parameter.

epEndEllipsis

Replaces text at the end with an ellipsis so that the resulting text fits in the rectangle specified. Any word not fitting in the rectangle is truncated without adding an ellipsis. Corresponds to a value of DT_END_ELLIPSIS in the dwDTFormat parameter.

epWordEllipsis

Truncates any word that doesn't fit in the rectangle and adds ellipses. Corresponds to a value of DT_WORD_ELLIPSIS in the dwDTFormat parameter.