Version

Field Label

The headings that appear on Fields are called labels. Field labels should briefly explain the meaning of any values displayed in the cells affiliated with this Field. There will be one cell for each Data Record in your table. By default, every Field is automatically labeled with the name of your data’s "attribute" (recall that this may be a public property name, the local name of an XML node, or a data column name, depending on what Data Source you have used). If these are not meant for your end users to see, you should set the Label property on your Field objects to a presentable name for human consumption.

Comparison of LabelLocation Settings

You can identify whether or not labels are shown, where they appear, and how frequently they are repeated. You would simply make some assignments to the LabelLocation property of the FieldLayoutSettings on your Field Layout.

Note
Note

There will be one Field Layout object for each Type of Data Record in your table. Consequently, your settings for the position and recurrence of the Field labels must be the same for all Data Records that have a particular Type.

Specifying a ControlTemplate for your Field Label

Field labels are not limited to simple text. Like many areas of the Ultimate UI for WPF controls, the use of Microsoft® Windows® Presentation Foundation control templates is fully supported by Field labels. Therefore, you can set the LabelPresenterStyle property to your own style resource that you have designed to control the styling and structure of content for display in a Field label. The scope resolution for Field Settings permits you to define the Label Presenter at the individual field, at the field layout (all Fields for the given Data Record Type), and all fields in the control level. For more information about using custom control templates, see Presenters.

Other properties available on the Field Settings allow you to customize the dimensions (height and width) of your Field labels. You can also set the LabelClickAction property to specify the behavior that will occur when your user clicks on a Field label. For example, you can declaratively set the LabelClickAction property to start sorting on its Field, without having to write a mouse-click event handler.