Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxGPPen Class

An advanced line graphic object.

#Declaration

Delphi
TdxGPPen = class(
    TdxGPCustomGraphicObject
)

#Remarks

This class implements graphical line objects with customizable pattern, width, and painting styles. The TdxGPPen lines can be used to paint complex shapes with transparency and gradient support:

The brush layout area of the TdxGPPen line matches its bounding rectangle. The final shape of the line object is applied to the brush layout as a mask (i.e., limits the visible portion of the brush layout):

The TdxGPPen class extends its ancestor class with the following members that allow you to:

  • Set the line’s absolute width (Width);

  • Assign the line pattern (Style);

  • Customize the appearance of non-solid line patterns (DashCapStyle);

  • Customize an appearance of the starting and ending points of a non-closed line (LineStartCapStyle and LineEndCapStyle);

  • Set the parameters of the brush used to paint the line pattern (Brush);

  • Identify whether the line is actually painted (IsEmpty).

The TdxGPPen object is referenced by the Pen property implemented in the TdxSpreadSheetShape class.

See Also