DataFormItemPositionAttribute Class

Specifies where to locate an editor for a property on a data form.

Namespace: DevExpress.Maui.DataForm

Assembly: DevExpress.Maui.Editors.dll

NuGet Package: DevExpress.Maui.Editors

Declaration

[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = false)]
public class DataFormItemPositionAttribute :
    Attribute

Remarks

Items on the data form are arranged in layout rows. Use the RowOrder property to specify the number of the layout row where the item should be displayed.

Multi-Item Rows

Use the ItemOrderInRow property to display multiple editors in a single row. Two items with the same RowOrder property value are placed in this row according to their ItemOrderInRow property values.

The RowOrder and ItemOrderInRow property values are relative. For example, editors defined in the XAML markup below appear on the data form as follows.

XAML

<dxdf:DataFormView>
    <dxdf:DataFormTextItem FieldName="Address" 
                           RowOrder="2"/>
    <dxdf:DataFormTextItem FieldName="City" 
                           RowOrder="3"/>
    <dxdf:DataFormTextItem FieldName="State" 
                           RowOrder="4"
                           ItemOrderInRow="0"/>
    <dxdf:DataFormNumericItem FieldName="Zip" 
                              RowOrder="4"
                              ItemOrderInRow="1"/>
    <dxdf:DataFormNumericItem FieldName="Code" 
                              RowOrder="6"
                              ItemOrderInRow="2"/>
    <dxdf:DataFormMaskedItem FieldName="PhoneNumber"
                             Keyboard="Telephone"
                             RowOrder="6"
                             ItemOrderInRow="6"/>
    <dxdf:DataFormTextItem FieldName="Email"
                           Keyboard="Email"
                           RowOrder="7"/>
</dxdf:DataFormView>

Multi-Row Items

Use the RowSpan property to allow an item to span multiple layout rows. A multi-row item spans the specified number of layout rows so that subsequent rows are located to the left or to the right of the multi-row item. For example, to span multiple layout rows with a DataFormCustomItem, use the markup below.

XAML

<dxdf:DataFormView>
    <dxdf:DataFormCustomItem IsLabelVisible="False"
                             FieldName="Photo"
                             RowSpan="2"
                             RowOrder="1"/>
    <dxdf:DataFormTextItem LabelText="First Name:"
                           FieldName="FirstName"
                           Placeholder="First name"
                           RowOrder="1"/>
    <dxdf:DataFormTextItem LabelText="Last Name:"
                           FieldName="LastName"
                           Placeholder="Last name"
                           RowOrder="2"/>
    <dxdf:DataFormDateItem LabelText="Birth Date:"
                           FieldName="BirthDate"
                           RowOrder="3"/>
</dxdf:DataFormView>

Specify the Layout in Code

In a view model, you can assign the DataFormItemPositionAttribute to a data field to specify the corresponding item’s position on the data form.

C#

[DataFormItemPosition(RowOrder = 2)]
public string Address { get; set; }
[DataFormItemPosition(RowOrder = 3)]
public string City { get; set; }
[DataFormItemPosition(RowOrder = 4, ItemOrderInRow = 0)]
public string State { get; set; }
[DataFormItemPosition(RowOrder = 4, ItemOrderInRow = 1)]
public int? Zip { get; set; }
[DataFormItemPosition(RowOrder = 6, ItemOrderInRow = 2)]
public string PhoneCode { get; set; }
[DataFormItemPosition(RowOrder = 6, ItemOrderInRow = 6)]
public string PhoneNumber { get; set; }
[DataFormItemPosition(RowOrder = 7)]
public string Email { get; set; }

Inheritance

System.Object

Attribute

DataFormItemPositionAttribute

Extension Methods

Yield<DataFormItemPositionAttribute>()

YieldIfNotNull<DataFormItemPositionAttribute>()