Class DataFormEditor

Base abstract class for all editors in a RadDataForm.

Inheritance

System.Object

RadContentView

DataFormContentView

DataFormItem

DataFormEditor

DataFormCustomEditor

DataFormDatePickerEditor

DataFormInputEditor

DataFormRadCheckBoxEditor

DataFormRadComboBoxEditor

DataFormRadNumericEditor

DataFormRadPickerEditor

DataFormRadSegmentedEditor

DataFormSwitchEditor

DataFormTimePickerEditor

Inherited Members

DataFormContentView.BackgroundColorProperty

DataFormContentView.BorderColorProperty

DataFormContentView.BorderThicknessProperty

DataFormContentView.CornerRadiusProperty

DataFormContentView.ContentPaddingProperty

DataFormContentView.BackgroundColor

DataFormContentView.BorderColor

DataFormContentView.BorderThickness

DataFormContentView.CornerRadius

DataFormContentView.ContentPadding

RadContentView.ActualStyleClassProperty

RadContentView.OnChildAdded(Element)

RadContentView.OnChildRemoved(Element, Int32)

RadContentView.OnBindingContextChanged()

RadContentView.OnHandlerChanged()

RadContentView.ActualStyleClass

Namespace: Telerik.Maui.Controls

Assembly: Telerik.Maui.Controls.dll

Syntax

public abstract class DataFormEditor : DataFormItem, IRadContentView, IContentView, IPadding, IDataFormView, IView, IElement, ITransform

Constructors

DataFormEditor()

Initializes a new instance of the DataFormEditor class.

Declaration

public DataFormEditor()

Fields

ActualEditorStyleProperty

Identifies the ActualEditorStyle property.

Declaration

public static readonly BindableProperty ActualEditorStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualErrorDisplayOptionsProperty

Identifies the ActualErrorDisplayOptions property.

Declaration

public static readonly BindableProperty ActualErrorDisplayOptionsProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualErrorImageSourceProperty

Identifies the ActualErrorImageSource property.

Declaration

public static readonly BindableProperty ActualErrorImageSourceProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualErrorImageStyleProperty

Identifies the ActualErrorImageStyle property.

Declaration

public static readonly BindableProperty ActualErrorImageStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualErrorLabelStyleProperty

Identifies the ActualErrorLabelStyle property.

Declaration

public static readonly BindableProperty ActualErrorLabelStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualErrorLengthProperty

Identifies the ActualErrorLength property.

Declaration

public static readonly BindableProperty ActualErrorLengthProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualErrorPositionProperty

Identifies the ActualErrorPosition property.

Declaration

public static readonly BindableProperty ActualErrorPositionProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualHeaderDisplayOptionsProperty

Identifies the ActualHeaderDisplayOptions property.

Declaration

public static readonly BindableProperty ActualHeaderDisplayOptionsProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualHeaderImageSourceProperty

Identifies the ActualHeaderImageSource property.

Declaration

public static readonly BindableProperty ActualHeaderImageSourceProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualHeaderImageStyleProperty

Identifies the ActualHeaderImageStyle property.

Declaration

public static readonly BindableProperty ActualHeaderImageStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualHeaderLabelStyleProperty

Identifies the ActualHeaderLabelStyle property.

Declaration

public static readonly BindableProperty ActualHeaderLabelStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualHeaderLengthProperty

Identifies the ActualHeaderLength property.

Declaration

public static readonly BindableProperty ActualHeaderLengthProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ActualHeaderPositionProperty

Identifies the ActualHeaderPosition property.

Declaration

public static readonly BindableProperty ActualHeaderPositionProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ColumnSpacingProperty

Identifies the ColumnSpacing property.

Declaration

public static readonly BindableProperty ColumnSpacingProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

CommitModeProperty

Identifies the CommitMode property.

Declaration

public static readonly BindableProperty CommitModeProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ConverterParameterProperty

Identifies the ConverterParameter property.

Declaration

public static readonly BindableProperty ConverterParameterProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ConverterProperty

Identifies the Converter property.

Declaration

public static readonly BindableProperty ConverterProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

EditorStyleProperty

Identifies the EditorStyle property.

Declaration

public static readonly BindableProperty EditorStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

EditorValueProperty

Identifies the EditorValue property.

Declaration

public static readonly BindableProperty EditorValueProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ErrorDisplayOptionsProperty

Identifies the ErrorDisplayOptions property.

Declaration

public static readonly BindableProperty ErrorDisplayOptionsProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ErrorImageSourceProperty

Identifies the ErrorImageSource property.

Declaration

public static readonly BindableProperty ErrorImageSourceProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ErrorImageStyleProperty

Identifies the ErrorImageStyle property.

Declaration

public static readonly BindableProperty ErrorImageStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ErrorLabelStyleProperty

Identifies the ErrorLabelStyle property.

Declaration

public static readonly BindableProperty ErrorLabelStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ErrorLengthProperty

Identifies the ErrorLength property.

Declaration

public static readonly BindableProperty ErrorLengthProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ErrorPositionProperty

Identifies the ErrorPosition property.

Declaration

public static readonly BindableProperty ErrorPositionProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HasPendingChangesProperty

Identifies the HasPendingChanges property.

Declaration

public static readonly BindableProperty HasPendingChangesProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HasValidationErrorsProperty

Identifies the HasValidationErrors property.

Declaration

public static readonly BindableProperty HasValidationErrorsProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HeaderDisplayOptionsProperty

Identifies the HeaderDisplayOptions property.

Declaration

public static readonly BindableProperty HeaderDisplayOptionsProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HeaderImageSourceProperty

Identifies the HeaderImageSource property.

Declaration

public static readonly BindableProperty HeaderImageSourceProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HeaderImageStyleProperty

Identifies the HeaderImageStyle property.

Declaration

public static readonly BindableProperty HeaderImageStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HeaderLabelStyleProperty

Identifies the HeaderLabelStyle property.

Declaration

public static readonly BindableProperty HeaderLabelStyleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HeaderLengthProperty

Identifies the HeaderLength property.

Declaration

public static readonly BindableProperty HeaderLengthProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HeaderPositionProperty

Identifies the HeaderPosition property.

Declaration

public static readonly BindableProperty HeaderPositionProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

HeaderTextProperty

Identifies the HeaderText property.

Declaration

public static readonly BindableProperty HeaderTextProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

IsErrorImageVisibleProperty

Identifies the IsErrorImageVisible property.

Declaration

public static readonly BindableProperty IsErrorImageVisibleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

IsErrorLabelVisibleProperty

Identifies the IsErrorLabelVisible property.

Declaration

public static readonly BindableProperty IsErrorLabelVisibleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

IsHeaderImageVisibleProperty

Identifies the IsHeaderImageVisible property.

Declaration

public static readonly BindableProperty IsHeaderImageVisibleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

IsHeaderLabelVisibleProperty

Identifies the IsHeaderLabelVisible property.

Declaration

public static readonly BindableProperty IsHeaderLabelVisibleProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

IsReadOnlyProperty

Identifies the IsReadOnly property.

Declaration

public static readonly BindableProperty IsReadOnlyProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

PropertyNameProperty

Identifies the PropertyName property.

Declaration

public static readonly BindableProperty PropertyNameProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

PropertyValueProperty

Identifies the PropertyValue property.

Declaration

public static readonly BindableProperty PropertyValueProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

RowSpacingProperty

Identifies the RowSpacing property.

Declaration

public static readonly BindableProperty RowSpacingProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

ValidationModeProperty

Identifies the ValidationMode property.

Declaration

public static readonly BindableProperty ValidationModeProperty

Field Value

Microsoft.Maui.Controls.BindableProperty

Properties

ActualEditorStyle

Gets the result from merging the Microsoft.Maui.Controls.Style specified in the EditorStyle property and the default base Microsoft.Maui.Controls.Style for that property.

Declaration

public Style ActualEditorStyle { get; }

Property Value

Microsoft.Maui.Controls.Style

ActualErrorDisplayOptions

Gets the actual value specified with the ErrorDisplayOptions property or inherided from the ErrorDisplayOptions property of the RadDataForm.

Declaration

public DataFormErrorDisplayOptions ActualErrorDisplayOptions { get; }

Property Value

DataFormErrorDisplayOptions

ActualErrorImageSource

Gets the actual value specified with the ErrorImageSource property or inherided from the ErrorImageSource property of the RadDataForm.

Declaration

public ImageSource ActualErrorImageSource { get; }

Property Value

Microsoft.Maui.Controls.ImageSource

ActualErrorImageStyle

Gets the result from merging the Microsoft.Maui.Controls.Style specified in the ErrorImageStyle property and the default base Microsoft.Maui.Controls.Style for that property.

Declaration

public Style ActualErrorImageStyle { get; }

Property Value

Microsoft.Maui.Controls.Style

ActualErrorLabelStyle

Gets the result from merging the Microsoft.Maui.Controls.Style specified in the ErrorLabelStyle property and the default base Microsoft.Maui.Controls.Style for that property.

Declaration

public Style ActualErrorLabelStyle { get; }

Property Value

Microsoft.Maui.Controls.Style

ActualErrorLength

Gets the actual value specified with the ErrorLength property or inherided from the ErrorLength property of the RadDataForm.

Declaration

public GridLength ActualErrorLength { get; }

Property Value

Microsoft.Maui.GridLength

ActualErrorPosition

Gets the actual value specified with the ErrorPosition property or inherided from the ErrorPosition property of the RadDataForm.

Declaration

public DataFormErrorPosition ActualErrorPosition { get; }

Property Value

DataFormErrorPosition

ActualHeaderDisplayOptions

Gets the actual value specified with the HeaderDisplayOptions property or inherided from the HeaderDisplayOptions property of the RadDataForm.

Declaration

public DataFormHeaderDisplayOptions ActualHeaderDisplayOptions { get; }

Property Value

DataFormHeaderDisplayOptions

ActualHeaderImageSource

Gets the actual value specified with the HeaderImageSource property or inherided from the HeaderImageSource property of the RadDataForm.

Declaration

public ImageSource ActualHeaderImageSource { get; }

Property Value

Microsoft.Maui.Controls.ImageSource

ActualHeaderImageStyle

Gets the result from merging the Microsoft.Maui.Controls.Style specified in the HeaderImageStyle property and the default base Microsoft.Maui.Controls.Style for that property.

Declaration

public Style ActualHeaderImageStyle { get; }

Property Value

Microsoft.Maui.Controls.Style

ActualHeaderLabelStyle

Gets the result from merging the Microsoft.Maui.Controls.Style specified in the HeaderLabelStyle property and the default base Microsoft.Maui.Controls.Style for that property.

Declaration

public Style ActualHeaderLabelStyle { get; }

Property Value

Microsoft.Maui.Controls.Style

ActualHeaderLength

Gets the actual value specified with the HeaderLength property or inherided from the HeaderLength property of the RadDataForm.

Declaration

public GridLength ActualHeaderLength { get; }

Property Value

Microsoft.Maui.GridLength

ActualHeaderPosition

Gets the actual value specified with the HeaderPosition property or inherided from the HeaderPosition property of the RadDataForm.

Declaration

public DataFormHeaderPosition ActualHeaderPosition { get; }

Property Value

DataFormHeaderPosition

ColumnSpacing

Gets or sets the horizontal spacing between the columns in the DataFormEditor.

Declaration

public double ColumnSpacing { get; set; }

Property Value

System.Double

CommitMode

Gets or sets the current commit mode of the DataFormEditor. For more information see the DataFormCommitMode type.

Declaration

public DataFormCommitMode CommitMode { get; set; }

Property Value

DataFormCommitMode

Converter

Gets or sets a Microsoft.Maui.Controls.IValueConverter to use when performing conversions between the value from the business object and the current editor.

Declaration

public IValueConverter Converter { get; set; }

Property Value

Microsoft.Maui.Controls.IValueConverter

ConverterParameter

Gets or sets a custom parameter to pass to the Microsoft.Maui.Controls.IValueConverter when performing conversions between the value from the business object and the current editor.

Declaration

public object ConverterParameter { get; set; }

Property Value

System.Object

EditorStyle

Gets or sets the Microsoft.Maui.Controls.Style applied to the editor control. The target type of this Microsoft.Maui.Controls.Style depends on the actual editor control being used. For more information see the descendants of the DataFormEditor class.

Declaration

public Style EditorStyle { get; set; }

Property Value

Microsoft.Maui.Controls.Style

EditorValue

Gets or sets the current edited value, before applying it to the business object.

Declaration

public object EditorValue { get; set; }

Property Value

System.Object

ErrorDisplayOptions

Gets or sets display options of the error indicator in the DataFormEditor. For more information see the DataFormErrorDisplayOptions type.

Declaration

public Nullable<DataFormErrorDisplayOptions> ErrorDisplayOptions { get; set; }

Property Value

System.Nullable<DataFormErrorDisplayOptions>

ErrorImageSource

Gets or sets the Microsoft.Maui.Controls.ImageSource of the error icon.

Declaration

public ImageSource ErrorImageSource { get; set; }

Property Value

Microsoft.Maui.Controls.ImageSource

ErrorImageStyle

Gets or sets the Microsoft.Maui.Controls.Style applied to the error icon. The target type of this Microsoft.Maui.Controls.Style is Microsoft.Maui.Controls.Image.

Declaration

public Style ErrorImageStyle { get; set; }

Property Value

Microsoft.Maui.Controls.Style

ErrorLabelStyle

Gets or sets the Microsoft.Maui.Controls.Style applied to the error label. The target type of this Microsoft.Maui.Controls.Style is Microsoft.Maui.Controls.Label.

Declaration

public Style ErrorLabelStyle { get; set; }

Property Value

Microsoft.Maui.Controls.Style

ErrorLength

Gets or sets the length of the error indicator in the editor. This property has an effect only when the ErrorPosition property is set to Beside. You can specify absolute values in pixels or weighted values followed by the asterisk symbol "". For instance, the value of "0.1" specifies that the error length should be 10% from the length of the corresponding editor. The special value "Auto" specifies that the error length should be computed automatically for each error indicator, based on the actual error size requirements.

Declaration

public GridLength ErrorLength { get; set; }

Property Value

Microsoft.Maui.GridLength

ErrorPosition

Gets or sets a value specifying the relative position of the error indicator in the DataFormEditor. For more information see the DataFormErrorPosition type.

Declaration

public Nullable<DataFormErrorPosition> ErrorPosition { get; set; }

Property Value

System.Nullable<DataFormErrorPosition>

HasPendingChanges

Gets a value indicating whether there are pending changes.

Declaration

public bool HasPendingChanges { get; }

Property Value

System.Boolean

HasValidationErrors

Gets a value indicating whether there are validation errors.

Declaration

public bool HasValidationErrors { get; }

Property Value

System.Boolean

HeaderDisplayOptions

Gets or sets the display options of the header in the DataFormEditor. For more information see the DataFormHeaderDisplayOptions type.

Declaration

public Nullable<DataFormHeaderDisplayOptions> HeaderDisplayOptions { get; set; }

Property Value

System.Nullable<DataFormHeaderDisplayOptions>

HeaderImageSource

Gets or sets the Microsoft.Maui.Controls.ImageSource of the header icon.

Declaration

public ImageSource HeaderImageSource { get; set; }

Property Value

Microsoft.Maui.Controls.ImageSource

HeaderImageStyle

Gets or sets the Microsoft.Maui.Controls.Style applied to the header icon. The target type of this Microsoft.Maui.Controls.Style is Microsoft.Maui.Controls.Image.

Declaration

public Style HeaderImageStyle { get; set; }

Property Value

Microsoft.Maui.Controls.Style

HeaderLabelStyle

Gets or sets the Microsoft.Maui.Controls.Style applied to the header label in the DataFormEditor. The target type of this Microsoft.Maui.Controls.Style is Microsoft.Maui.Controls.Label.

Declaration

public Style HeaderLabelStyle { get; set; }

Property Value

Microsoft.Maui.Controls.Style

HeaderLength

Gets or sets the length of the header view in the editor. This property has an effect only when the HeaderPosition property is set to Beside. You can specify absolute values in pixels or weighted values followed by the asterisk symbol "". For instance, the value of "0.5" specifies that the header length should be 50% from the length of the corresponding editor. The special value "Auto" specifies that the header length should be computed automatically for the header view, based on the actual header size requirements.

Declaration

public GridLength HeaderLength { get; set; }

Property Value

Microsoft.Maui.GridLength

HeaderPosition

Gets or sets a value specifying the relative position of the header label in the DataFormEditor. For more information see the DataFormHeaderPosition type.

Declaration

public Nullable<DataFormHeaderPosition> HeaderPosition { get; set; }

Property Value

System.Nullable<DataFormHeaderPosition>

HeaderText

Gets or sets the text of the header label in the DataFormEditor.

Declaration

public string HeaderText { get; set; }

Property Value

System.String

IsErrorImageVisible

Gets a value indicating whether the error icon is currently visible in the DataFormEditor.

Declaration

public bool IsErrorImageVisible { get; }

Property Value

System.Boolean

IsErrorLabelVisible

Gets a value indicating whether the error label is currently visible in the DataFormEditor.

Declaration

public bool IsErrorLabelVisible { get; }

Property Value

System.Boolean

IsHeaderImageVisible

Gets a value indicating whether the header icon is currently visible in the DataFormEditor.

Declaration

public bool IsHeaderImageVisible { get; }

Property Value

System.Boolean

IsHeaderLabelVisible

Gets a value indicating whether the header label is currently visible in the DataFormEditor.

Declaration

public bool IsHeaderLabelVisible { get; }

Property Value

System.Boolean

IsReadOnly

Gets or sets a value indicating whether the current editor is in a read-only mode.

Declaration

public Nullable<bool> IsReadOnly { get; set; }

Property Value

System.Nullable<System.Boolean>

PropertyName

Gets or sets the name of the property from the business object this editor is bound to.

Declaration

public string PropertyName { get; set; }

Property Value

System.String

PropertyValue

Gets or sets the value of the property from the business object this editor is bound to.

Declaration

public object PropertyValue { get; set; }

Property Value

System.Object

RowSpacing

Gets or sets the vertical spacing between the rows in the DataFormEditor.

Declaration

public double RowSpacing { get; set; }

Property Value

System.Double

ValidationErrors

Gets a collection of validation errors that are produced after the last execution of the validation logic associated with the current DataFormEditor. This collection aggregates all validation errors produced by the validation rules from the property metadata of the underlying business object data model and all custom validation rules specified to the editor. For more information see the DataFormEditorValidationError type.

Declaration

public IReadOnlyList<DataFormEditorValidationError> ValidationErrors { get; }

Property Value

System.Collections.Generic.IReadOnlyList<DataFormEditorValidationError>

ValidationMode

Gets or sets the current validation mode of the DataFormEditor. For more information see the DataFormValidationMode type.

Declaration

public DataFormValidationMode ValidationMode { get; set; }

Property Value

DataFormValidationMode

ValidationRules

Gets a collection of validation rules associated with the current DataFormEditor. The validation rules specified here extend the base set of validation rules that come from the metadata of the underlying business object data model. When the validation logic is triggered, these validation rules are executed last, after executing the validation rules for the corresponding property. This makes it possible to execute more advanced validation logic beside what is specified with metadata and provide more detailed validation errors. For more information see the inheritors of the DataFormEditorValidationRule type.

Declaration

public IList<DataFormEditorValidationRule> ValidationRules { get; }

Property Value

System.Collections.Generic.IList<DataFormEditorValidationRule>

Methods

CancelChanges()

Cancels all pending changes in the DataFormEditor and reverts to the original property value from the underlying business object. This method is mostly useful when the CommitMode property is set to Explicit.

Declaration

public void CancelChanges()

CommitChanges()

Commits all pending changes in the DataFormEditor to the corresponding property of the underlying business object. This method is mostly useful when the CommitMode property is set to Explicit.

Declaration

public bool CommitChanges()

Returns

System.Boolean True if the validation passes and the changes are committed successfully, false otherwise.

ValidateChanges()

Executes the validation logic associated with the current DataFormEditor. This method is mostly useful when the ValidationMode property is set to Explicit.

Declaration

public bool ValidateChanges()

Returns

System.Boolean True if the validation passes, false otherwise.

Events

ValidationCompleted

Raised when the validation of the editor has completed.

Declaration

public event EventHandler<DataFormEditorValidationCompletedEventArgs> ValidationCompleted

Event Type

System.EventHandler<DataFormEditorValidationCompletedEventArgs>

ValueChanged

Raised when the value of the editor has changed.

Declaration

public event EventHandler<DataFormEditorValueChangedEventArgs> ValueChanged

Event Type

System.EventHandler<DataFormEditorValueChangedEventArgs>

Extension Methods

AndroidTypeConversionExtensions.ToJavaObject(Object)