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

IdxRichEditTableBorder Interface

Exposes table border appearance settings.

#Declaration

Delphi
IdxRichEditTableBorder = interface(IInterface)

#Remarks

The Rich Edit control and the Document Server component allow you to configure all internal and external table borders and individual cell borders. The IdxRichEditTableBorder interface exposes the appearance settings of internal and external table borders.

#Main API Members

The list below outlines key members of the IdxRichEditTableBorder interface. You can use these members to configure table appearance settings.

LineColor
Allows you to change the table border’s line color.
LineStyle
Allows you to change the table border’s line pattern or hide the table border.
LineThickness
Allows you to adjust the table border’s line thickness.

#Code Example: Insert and Configure a Table

The following code example creates a table populated with three columns and rows at the current caret position and customizes the table’s borders and background:

uses
  dxCoreGraphics;  // This unit declares TdxAlphaColor and TdxAlphaColors types
// ...
var
  ADocument: IdxRichEditDocument;
  ATable: IdxRichEditTable;
  I, J: Integer;
begin
  ADocument := dxRichEditControl1.Document;
  ADocument.BeginUpdate;  // Initiates the following batch change
  try
    ATable := ADocument.Tables.Add(ADocument.CaretPosition, 3, 3);
    for I := 0 to ATable.Rows.Count - 1 do
      for J := 0 to ATable.Rows.Self[I].Cells.Count - 1 do
        ADocument.InsertText(ATable.Cell(I, J).Range.Start, 'Lorem ipsum dolor sit amet');
    ATable.Borders.InsideHorizontalBorder.LineStyle := TdxRichEditTableBorderLineStyle.DotDotDash;
    ATable.Borders.InsideHorizontalBorder.LineColor := TdxAlphaColors.Firebrick;
    ATable.Borders.InsideVerticalBorder.LineStyle := TdxRichEditTableBorderLineStyle.Dotted;
    ATable.Borders.Bottom.LineStyle := TdxRichEditTableBorderLineStyle.ThinThickMediumGap;
    ATable.Borders.Bottom.LineThickness := 1.5;
    ATable.Borders.Bottom.LineColor := TdxAlphaColors.Red;
    ATable.Borders.Left.LineStyle := TdxRichEditTableBorderLineStyle.ThinThickMediumGap;
    ATable.Borders.Left.LineColor := TdxAlphaColors.Red;
    ATable.Borders.Left.LineThickness := 1.5;
    ATable.Borders.Right.LineStyle := TdxRichEditTableBorderLineStyle.ThinThickMediumGap;
    ATable.Borders.Right.LineColor := TdxAlphaColors.Red;
    ATable.Borders.Right.LineThickness := 1.5;
    ATable.Borders.Top.LineStyle := TdxRichEditTableBorderLineStyle.ThinThickMediumGap;
    ATable.Borders.Top.LineColor := TdxAlphaColors.Red;
    ATable.Borders.Top.LineThickness := 1.5;
    ATable.TableBackgroundColor := TdxAlphaColors.LightSalmon;
  finally
    ADocument.EndUpdate;  // Calls EndUpdate regardless of the batch operation's success
  end;
end;

VCL Rich Edit Control: A Table Example with Custom Border Appearance

#Direct IdxRichEditTableBorder Interface References

The following public API members reference the IdxRichEditTableBorder interface:

IdxRichEditTableBorders.Bottom
Provides access to the appearance settings of the external bottom table border.
IdxRichEditTableBorders.InsideHorizontalBorder
Provides access to the appearance settings of all internal horizontal table borders.
IdxRichEditTableBorders.InsideVerticalBorder
Provides access to the appearance settings of all internal vertical table borders.
IdxRichEditTableBorders.Left
Provides access to the appearance settings of the external left table border.
IdxRichEditTableBorders.Right
Provides access to the appearance settings of the external right table border.
IdxRichEditTableBorders.Top
Provides access to the appearance settings of the external top table border.

#Inheritance

IInterface
IdxRichEditTableBorder
See Also