TRVTableItemInfo.Options

<< Click to display table of contents >>

TRVTableItemInfo.Options

Specifies options for the table.

type

  TRVTableOption = (rvtoEditing,

    rvtoRowSizing, rvtoColSizing,

    rvtoRowSelect, rvtoColSelect,

    rvtoNoCellSelect,

    rvtoRTFSaveCellPixelBestWidth,

    rvtoHideGridLines,

    rvtoCellBelowBorders,

    rvtoOverlappingCorners,

    rvtoRTFAllowAutofit,

    rvtoIgnoreContentWidth,

    rvtoIgnoreContentHeight);

  TRVTableOptions = set of TRVTableOption;

 

property Options: TRVTableOptions;

Default value

[rvtoEditing, rvtoRowSizing, rvtoColSizing, rvtoRowSelect, rvtoColSelect]

Options for Editing

Option

Meaning

rvtoEditing

If set (default), users can edit content of cells using inplace editor.

(table must be inserted in TRichViewEdit or TDBRichViewEdit)

Options for Resizing and Selection

Option

Meaning

rvtoRowSizing

rvtoColSizing

If set (default), users can resize individual rows/columns with the mouse.

(table must be inserted in TRichViewEdit or TDBRichViewEdit)

rvtoRowSelect,

rvtoColSelect

If set (default), user can select rows/columns by clicking on the left/top border of the table (when cursor has a special vertical/horizontal arrow shape)

The options have no effect if the table is inserted in RichView with rvoAllowSelection excluded from Options.

rvtoNoCellSelect

If set, multicell selection by mouse is not allowed (remove also rvtoRowSelect and rvtoColSelect to disallow making multicell selection completely.

Layout Options

Option

Meaning

rvtoIgnoreContentWidth

If set, contents of cells are completely ignored when calculating widths of table columns.Wide pictures, controls, etc. are clipped.

rvtoIgnoreContentHeight

If set, heights of rows are calculated basing only on BestHeight properties of cells.

But (unlike rvtoIgnoreContentWidth), heights of cells having BestHeight=0 are still calculated basing on their content.

If you want to turn this option on only for some cells, use the cell's IgnoreContentHeight property instead.

Visual Options

Option

Meaning

rvtoHideGridLines

If not set (default), invisible borders are shown using GridColor, GridReadOnlyColor, GridStyle, GridReadOnlyStyle properties of the linked TRVStyle.

It's not recommended to use this option. Use rvoShowGridLines option in TRichView.Options instead.

rvtoCellBelowBorders

If not set (default), space below invisible side of border has color of tables. If set, color of cell is used.

tblcbb

rvtoOverlappingCorners

If not set (default), colored borders (CellBorderStyle=rvtbColor) have three-dimensional appearance. If not set, they are flat.

The effect can be noticed for wide borders with some invisible sides.

tbljoints

RTF and DocX Export Options

Option

Meaning

rvtoRTFAllowAutofit

If set, tables with default width (BestWidth=0) are exported to RTF and DocX as fit-by-content tables. Off by default.

See also: RichViewTableDefaultRTFAutofit

rvtoRTFSaveCellPixelBestWidth

If set, exact sizes of cells are saved to RTF and DocX. Off by default.

The options above are explained in the topic about table RTF and DocX export.