Card Field

  • 2 minutes to read

Represents a single data source field in a card. Card fields can be arranged using multiple layouts. Each card field displays a value region and can optionally display a caption.

Two objects are created in a LayoutView for each data source field:

  • LayoutViewField object that contains layout settings, such as size constraints, indents, alignment settings, visibility and location.
  • LayoutViewColumn object (derived from the GridColumn class) that provides a field's various display and behavior settings (the field caption text, in-place editor type, display format, whether the field is editable, whether sorting and filtering is enabled, etc.).

LayoutViewColumn objects are stored in the ColumnView.Columns collection. To get a LayoutViewField object that corresponds to a LayoutViewColumn object, see the LayoutViewColumn.LayoutViewField property.

 

LayoutView_VE_CardField

 

The following table lists the main properties affecting element appearance.

Appearance

Styles can be customized separately for card field captions and value cells. See these topics for more information.

Field Layout

LayoutView.TemplateCard

In-place Editor

GridColumn.ColumnEdit

Image

LayoutViewColumn.Image and LayoutViewColumn.ImageIndex

Field Caption Text

GridColumn.Caption

LayoutView.FieldCaptionFormat

Field Border

LayoutViewOptionsView.ShowCardFieldBorders

Field Hot-Tracking

LayoutViewOptionsView.AllowHotTrackFields

Hints

LayoutViewOptionsView.ShowFieldHints

Size

The Size and EditorPreferredWidth properties of LayoutViewField objects.

Size Constraints

The MinSize and MaxSize properties of LayoutViewField objects.

Field Outer and Inner Indents

The Spacing and Padding properties of LayoutViewField objects specify the outer and inner indents respectively.

Field Caption Visibility and Location

The TextVisible and TextLocation properties of LayoutViewField objects.

Field Caption Alignment Settings

The TextAlignMode property of LayoutViewField objects.

Field Caption Indent

The OptionsItemText.TextToControlDistance property of the LayoutView.TemplateCard object specifies the default caption indent for all fields.

The TextToControlDistance property of individual LayoutViewField objects allows you to specify caption indents for specific fields.