Miscellaneous Property Types

Data Types displayed by WinForms Property Editors

Each WinForms Property Editor has a control that displays a corresponding property in a Detail View, and a repository item that displays a property in a List Editor that supports in-place editing. Both the control and repository item are shown below.

Data Type

Image

Property Editor Type and Description

IAnalysis

AnalysisEditorWin_Trasnparent

AnalysisEditorWin

Intended for displaying properties that reference an object implementing the IAnalysis interface.

This Property Editor is supplied with the Pivot Chart Module. Its control represents a user control that contains a tab control with two pages. One page contains a Pivot Grid. The second page contains the Chart Control and two check edits: ShowRowGrandTotalCheckEdit and ShowColumnGrandTotalCheckEdit. When the Analysis class from the Business Class Library has been added, the AnalysisEditorWin allows end-users to build analysis reports on the data of a specified type. For details, refer to the Pivot Chart Module Overview topic.

Control: AnalysisControlWin.

Repository Item: There is no repository item. A textual representation of an Analysis object will be displayed.

IChartDataSourceProvider

ChartPropertyEditor

ChartPropertyEditor

Used to display key performance indicator results supplied by the KPI Module as a chart.

You can see this Property Editor in action by using the Show Chart Action in a KPIScorecard Detail View.

Control: ChartControl.

Repository Item: There is no repository item. A textual representation of an IChartDataSourceProvider object will be displayed.

IEvent.Label

SchedulerLabelPropertyEditor_Transparent

SchedulerLabelPropertyEditor

Used to display the Label property of a business class implementing the built-in IEvent interface by default.

This Property Editor is supplied with the Scheduler Module. Its control represents an image combobox. Its items represent the AppointmentLabel objects. These objects are contained in the control's SchedulerStorage, and can be accessed using the AppointmentStorage.Labels collection of the AppointmentStorage, returned by the SchedulerStorage.Appointments property.

To expand the editor's drop-down window, use Alt + Down Arrow.

Control: AppointmentLabelEdit editor from the XtraScheduler Library.

Repository Item: There is no repository item. The Scheduler control displays the Event.Label property in a specific way.

IEvent.Status

SchedulerStatusPropertyEditor_Transparent

SchedulerStatusPropertyEditor

Used to display the Status property of a business class implementing the built-in IEvent interface by default.

This Property Editor is supplied with the Scheduler Module. Its control represents an image combobox. Its items represent the AppointmentStatus objects. These objects are contained in the control's SchedulerStorage, and can be accessed via the AppointmentStorage.Statuses collection, returned by the SchedulerStorage.Appointments property.

To expand the editor's drop-down window, use Alt + Down Arrow.

Control: AppointmentStatusEdit editor from the XtraScheduler Library.

Repository Item: There is no repository item. The Scheduler control displays the Event.Label property in a specific way.

ISparklineProvider

SparklinePropertyEditor

SparklinePropertyEditor

Used to display a key performance indicator trend supplied by the KPI Module as a sparkline.

You can see this Property Editor in action in a KPIScorecard Detail View.

Control: ChartControl.

Repository Item: A custom SparklineRepositoryItem that uses a ChartControl to display data.

ITrackingRecordVisualizationInfo

WorkflowVisualizationPropertyEditor

WorkflowVisualizationPropertyEditor

Used by the WinForms Workflow Module to display the TrackingRecordVisualizationInfo property in the Views displaying information on running workflow instances.

Control: WorkflowVisualizationControl which uses the re-hosted WF designer.

Repository Item: There is no repository item. A textual representation of the bound Activity will be displayed.

ISupportRecurrences.RecurrenceInfoXml

SchedulerRecurrenceInfoPropertyEditor

SchedulerRecurrenceInfoPropertyEditor

Used to display the RecurrenceInfoXml property of a business class by default implementing the built-in IEvent and ISupportRecurrences interfaces.

This Property Editor is supplied with the Scheduler Module. When clicking or double-clicking the ellipsis button of the ButtonEdit control representing this Property Editor, a form is invoked. This form allows end-users to set the current event's recurrence options or remove the recurrence.

Control: ButtonEdit editor from the XtraEditors Library.

Repository Item: There is no repository item. The Scheduler control displays the ISupportRecurrences.RecurrenceInfoXml property in a specific way.

String

RichTextBoxWithBinding_Transparent

RichTextPropertyEditor

Intended for string properties. To use it, set it for the PropertyEditorType property of the required BOModel | <Class> | OwnMembers | <Member> or Views | <DetailView> | Items | <PropertyEditor> node.

The control's height is calculated by multiplying the value set for the corresponding RowCount property and a default height for a row. If the RowCount property is not specified, it is set to 10. If it is set to 0, it is assumed that 15 rows will fit in the control.

The RepositoryItemRtfEditEx repository item is displayed via the RtfEditEx editor, representing a descendant of the BlobBaseEdit editor from the XtraEditors Library. This editor displays the PopupRtfEditExForm form as a pop-up form.

Control: RichTextBoxWithBinding that is a descendant of the System.Windows.Forms.RichTextBox editor.

Repository Item: RepositoryItemRtfEditEx that is a descendant of the RepositoryItemBlobBaseEdit repository item from the XtraEditors Library.

String

WorkflowPropertyEditor

WorkflowPropertyEditor

Used by the WinForms Workflow Module to display the Xaml property in the Views displaying workflow definitions.

Control: WorkflowDesignerControl uses the re-hosted WF designer.

Repository Item: There is no repository item. A textual representation of the bound Activity will be displayed.

Any data type

DefaultPropertyEditor_Collection_Transparent

or

DefaultPropertyEditor_SingleValue_Transparecy

DefaultPropertyEditor

Important

The DefaultPropertyEditor has a number of limitations and should not be used intentionally in your applications. For instance, this Property Editor does not support the Conditional Appearance functionality.

Used when there is no default Property Editor for the current property's data type and the PropertyEditorType property of the corresponding IModelMember node is not specified.

GridControl is used when the property represents a collection implementing either the IEnumerable or ITypedList interface.

StringEdit is used for the remaining properties. It displays the property's textual representation.

Both the GridControl and StringEdit display data in read-only mode by default.

Control: GridControl editor from the XtraGrid Library orStringEdit editor used by the StringPropertyEditor.

Repository Item: There is no specific repository item.

Any type property that must be protected from viewing

ProtectedContentEdit

ProtectedContentPropertyEditor

Used for properties that are prohibited to be viewed by the current user by the Security System by default.

The "Protected Content" text for the ProtectedContentEdit control is taken from the IModelApplication.ProtectedContentText property of the Application Model's Application node.

This Property Editor is always read-only.

For details on approaches to granting permissions to users, refer to the Security System Overview topic and the Security Demo application.

Control: ProtectedContentEdit that is a descendant of the StringEdit editor used by the IntegerPropertyEditor

Repository Item: RepositoryItemProtectedContentTextEdit that is a descendant of the RepositoryItemTextEdit repository item from the XtraEditors Library

Data Types displayed by ASP.NET Property Editors

Each ASP.NET Property Editor has controls that display a property in a Detail View's View and Edit mode (see DetailView.ViewEditMode). These controls are listed below.

Data Type

Image

Property Editor Type and Description

Byte[]

ASPxTextBox_ASPxByteArrayPropertyEditor_Transparent

ASPxByteArrayPropertyEditor

Used for byte[] properties by default.

Represents the ASPxStringPropertyEditor descendant.

Displays the property's value using the UTF8 encoding. If you need to use another encoding, inherit from this Property Editor and override the GetPropertyDisplayValue method.

Note that this Property Editor is always read-only.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxTextBox, or ASPxMemo editor from the ASPxEditors Library.

IAnalysis

AnalysisEditorWeb_Transparent

AnalysisEditorWeb

Intended for displaying properties that reference an object implementing the IAnalysis interface.

This Property Editor is supplied with the Pivot Chart Module. Its control represents a user control that contains a tab control with two pages. One page contains a Pivot Grid. The second page contains the Chart Control. When having the Analysis class from the Business Class Library added, the AnalysisEditorWeb allows end-users to build analysis reports on data of a specified type. For details, refer to the Pivot Chart Module Overview topic.

View Mode Control: AnalysisControlWeb.

Edit Mode Control: AnalysisControlWeb.

IChartDataSourceProvider

ChartPropertyEditor_Web

ChartPropertyEditor

Used to display key performance indicator results supplied by the KPI Module as a chart.

You can see this Property Editor in action by using the Show Chart Action in a KPIScorecard Detail View.

View Mode Control: WebChartControlContainer using the WebChartControl to display data.

Edit Mode Control: WebChartControlContainer using the WebChartControl to display data.

IEvent.Label

SchedulerLabelPropertyEditor_Web_Transparent

ASPxSchedulerLabelPropertyEditor

Used to display the Label property of a business class implementing the built-in IEvent interface by default.

This Property Editor is supplied with the Scheduler Module. Its control represents an image combobox. Its items represent the AppointmentLabel objects. These objects are contained in the control's SchedulerStorage, and can be accessed via the AppointmentStorage.Labels collection, returned by the SchedulerStorage.Appointments property.

To expand the editor's drop-down window, use Alt + Down Arrow.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxComboBox editor from the ASPxEditors Library.

IEvent.Status

SchedulerStatusPropertyEditor_WebTransparent

ASPxSchedulerStatusPropertyEditor

Used to display the Status property of a business class implementing the built-in IEvent interface by default.

This Property Editor is supplied with the Scheduler Module. Its control represents an image combobox. Its items represent the AppointmentStatus objects. These objects are contained in the control's SchedulerStorage, and can be accessed using the AppointmentStorage.Statuses collection, returned by the SchedulerStorage.Appointments property.

To expand the editor's drop-down window, use Alt + Down Arrow.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxComboBox editor from the ASPxEditors Library.

ISparklineProvider

SparklinePropertyEditor_Web

SparklinePropertyEditor

Used to display a key performance indicator trend supplied by the KPI Module as a sparkline.

You can see this Property Editor in action in a KPIScorecard Detail View.

View Mode Control: WebChartControl.

Edit Mode Control: WebChartControl.

ISupportRecurrences.RecurrenceInfoXml

ASPxSchedulerRecurrenceInfoPropertyEditor

ASPxSchedulerRecurrenceInfoPropertyEditor

Used to display the RecurrenceInfoXml property of a business class implementing the built-in IEvent and ISupportRecurrences interfaces by default.

This Property Editor is supplied with the Scheduler Module. When clicking the ellipsis button of the ASPxButtonEdit control representing this Property Editor, a form is invoked. This form allows end-users to set the current event's recurrence options or remove the recurrence.

View Mode Control: ASPxLabel from the ASPxEditors Library.

Edit Mode Control: ASPxSchedulerRecurrenceInfoEdit based on the ASPxButtonEdit editor from the ASPxEditors Library.

Any data type

ASPxTextBox_ASPxDefaultPropertyEditor_Transparency

ASPxDefaultPropertyEditor

Important

The ASPxDefaultPropertyEditor has a number of limitations and should not be used intentionally in your applications. For instance, this Property Editor does not support the Conditional Appearance functionality.

Used when there is no default Property Editor for the current property's data type, and the PropertyEditorType property of the corresponding IModelMember node is not specified.

Inherited from the ASPxStringPropertyEditor class. Displays the property's value in a read-only mode.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxTextBox editor from the ASPxEditors Library.

Any data type property that must be protected from viewing

ASPxTextBox_ASPxProtectedContentPropertyEditor_Transpare nt

ASPxProtectedContentPropertyEditor

Used for properties that are prohibited to be viewed by the current user by the Security System by default.

Inherited from the ASPxStringPropertyEditor class. However, this Property Editor is always read-only.

The "Protected Content" text for the ProtectedContentEdit control is taken from the IModelApplication.ProtectedContentText property of the Application Model's Application node.

This Property Editor is always read-only.

For details on approaches to granting permissions to users, refer to the Security System Overview topic and the Security Demo application.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxTextBox editor from the ASPxEditors Library.

See Also