Card Field

• Apr 01, 2018
• 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.

 

 

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.