Built-in Controllers and Actions in the System Module
- 37 minutes to read
This topic lists the built-in Controllers and their Actions supplied with the System’s base, ASP.NET Core Blazor, Windows Forms, and ASP.NET Web Forms modules.
For more information on individual Controllers or Actions, navigate to the Application Model‘s ActionDesign | Controllers or ActionDesign | Actions node in the Model Editor.
Note
In this topic, we refer to built-in Actions using their ActionBase.Id property values. Use the Model Editor to find out which caption is assigned to an Action.
Create, Read, Update and Delete (CRUD)
Platform-independent
CheckDeletedObjectController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated for Detail Views.
Makes the current Detail View read-only and displays the “Data is displayed in read-only mode, because it has been deleted.” message if the View’s object has been deleted.
DeleteObjectsViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: Delete.
Activated for all Views. Contains the Delete Action. This Action allows users to delete the current object displayed in a Detail View or the currently selected object(s) in a List View. Note that objects deleted from nested collections are not deleted at once. They are deleted when a user saves the entire root object.
See Also: DeleteObjectsViewController | DeleteObjectsViewController.DeleteAction | DeleteObjectsViewController.AutoCommit
DependentEditorController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated for Detail Views. Updates fields that display the values of an object’s reference properties when a reference property is changed.
LinkDialogController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
A DialogController descendant. Activated in the Link Action’s pop-up window if it supports the Search functionality. Adds the LinkNewObjectController to the window, invoked when pressing the New button. Executes the FullTextSearch Action to retrieve the newly created object to the current List View’s collection.
See Also: LinkUnlinkController.LinkAction | FilterController.FullTextFilterAction | How to: Add a Search Action to Lookup Property Editors and Link Pop-up Windows
LinkNewObjectController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
A DialogController descendant. Activated in the pop-up window that is invoked when the New button is pressed in the Link Action’s pop-up window. When the OK button is pressed, this Controller saves the newly created object, and passes it to the LinkDialogController, so that it can be selected in the Link Action’s pop-up window.
See Also: LinkUnlinkController.LinkAction | How to: Add a Search Action to Lookup Property Editors and Link Pop-up Windows
LinkToListViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
For internal use. Creates a Link object used by the DetailViewLinkController to synchronize changes made in a Detail View invoked from the List View.
LinkUnlinkController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: Link, Unlink.
Activated for nested List Views. The Link Action allows users to add an existing object to the current nested collection. The objects to be chosen are displayed by a List View in a pop-up window. The Unlink Action deletes references to the object selected in the current nested collection. The changes made to a collection are not saved immediately; they are saved when the root object is saved. This behavior is overridden in the ASP.NET Web Forms-specific WebLinkUnlinkController.
See Also: LinkUnlinkController | LinkUnlinkController.LinkAction | LinkUnlinkController.UnlinkAction | LinkUnlinkController.AutoCommit
ModificationsController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: Cancel, Save, SaveAndClose, SaveAndNew.
Activated for Detail Views. Creates and manages the active and enabled state of the Cancel, Save, SaveAndClose, and SaveAndNew Actions.
See Also: ModificationsController | ModificationsController.CancelAction | ModificationsController.SaveAction | ModificationsController.SaveAndCloseAction | ModificationsController.SaveAndNewAction | ModificationsController.ModificationsCheckingMode | ModificationsController.ModificationsHandlingMode
NewObjectViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: New.
Activated for all Views. The New Action allows users to create a new object of the type selected from the list of predefined types. To specify predefined types in the Model Editor, add child nodes to the CreatableItems node. To specify a predefined type in code, use the NavigationItem attribute, or handle the Controller’s CollectCreatableItemTypes and CollectDescendantTypes events.
See Also: NewObjectViewController | NewObjectViewController.NewObjectAction | IModelCreatableItems | NavigationItemAttribute | NewObjectViewController.CollectDescendantTypes | How to: Customize the New Action’s Items List
WebDeleteObjectsViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: inherited.
A DeleteObjectsViewController descendant. Changes the default DeleteObjectsViewController.AutoCommit property value to true, so that objects deleted from any collection are deleted at once.
ASP.NET Core Blazor
BlazorModificationsController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: inherited.
A ModificationsController descendant activated for Object Views.
BlazorNewObjectViewController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: inherited.
A NewObjectViewController descendant activated for Object Views. Overrides the UpdateActionsState method to populate the NewObjectViewController.NewObjectAction‘s Items collection with objects of the current View’s object type (including descendants).
Windows Forms
WinModificationsController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: inherited.
A ModificationsController‘s descendant. Activated for Object Views.
See Also: WinModificationsController
WinNewObjectViewController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: inherited.
The controller is inherited from the NewObjectViewController. Overrides the UpdateActionsState method to populate the New Action’s ChoiceActionBase.Items collection. The current View’s object type, its descendants, and the types listed in the Application Model’s CreatableItems node are added to the collection.
See Also: WinNewObjectViewController | NewObjectViewController.NewObjectAction | IModelCreatableItems
ASP.NET Web Forms
WebLinkUnlinkController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: inherited.
The controller is inherited from the LinkUnlinkController.
Sets the LinkUnlinkController.AutoCommit property to true when the current IModelOptionsWeb.CollectionsEditMode is ViewEditMode.View.
See Also: IModelOptionsWeb.CollectionsEditMode
WebModificationsController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: SwitchToEditMode and inherited.
The controller is inherited from the ModificationsController. Activated for Object Views. The SwitchToEditMode Action, implemented in this Controller, allows users to switch to edit mode when a Detail View is displayed in view mode. Manages the active state of all its Actions, depending on the current View’s DetailView.ViewEditMode property value.
See Also: WebModificationsController | WebModificationsController.EditAction
WebNewObjectViewController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: QuickCreateAction and inherited.
The controller is inherited from the NewObjectViewController. Overrides the UpdateActionsState method to populate the NewObjectViewController.NewObjectAction Action’s Items collection. Only the current View’s object type and its descendants are added to the collection.
Contains the QuickCreate Action, whose Items collection includes only the elements that are child nodes of the Application Model’s IModelCreatableItems node. The collection is populated in the UpdateActionsState method.
See Also: WebNewObjectViewController | WebNewObjectViewController.QuickCreateAction
Search and Filtering
Platform-independent
FilterController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: SetFilter, FullTextSearch.
Activated for List Views. The SetFilter Action allows users to select one of the predefined filters created for the current List View. The FullTextSearch Action allows users to search objects that match the entered text. In addition to Actions, this Controller filters the current List View’s data source according to the criteria specified in the Application Model.
See Also: FilterController | FilterController.SetFilterAction | FilterController.FullTextFilterAction | Filters Application Model Node | FullTextSearch Action | Criteria Property in the Application Model
FindLookupDialogController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
A DialogController‘s descendant. Activated in the Lookup Property Editor’s lookup window if the search functionality is enabled.
Adds the FindLookupNewObjectDialogController to the invoked window when pressing the New button. Executes the FullTextSearch Action to select the newly created object in the current List View’s collection.
See Also: IModelOptions.LookupSmallCollectionItemCount | How to: Add a Search Action to Lookup Property Editors and Link Pop-up Windows
FindLookupNewObjectDialogController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
A DialogController‘s descendant. Activated in the pop-up window that is invoked when pressing the New button in a Lookup Property Editor’s lookup window. When the OK button is pressed, this Controller saves the newly created object and passes it to the FindLookupDialogController, so that it can be selected in the Lookup Property Editor’s lookup window.
ASP.NET Core Blazor
LookupSearchDialogController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: EditRowAction.
A DialogController descendant. If Search functionality is enabled for a LookupPropertyEditor, this controller activates in the Search Action’s pop-up window. Adds a LookupSearchNewObjectController to all windows created with the New or Clone buttons.
See Also: LookupPropertyEditor | FilterController.FullTextFilterAction | How to: Add a Search Action to Lookup Property Editors and Link Pop-up Windows
LookupSearchNewObjectController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: EditRowAction.
A DialogController descendant. Activated in the pop-up window that is invoked when you click the New or Clone button in the Search Action’s pop-up window of LookupPropertyEditor. When you click the OK button, the Controller saves the created object and passes it to the editor’s property value.
See Also: LookupPropertyEditor | How to: Add a Search Action to Lookup Property Editors and Link Pop-up Windows
Navigation
Platform-independent
RecordsNavigationController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: PreviousObject, NextObject.
Activated for all Views. The PreviousObject Action is intended to navigate to the previous object in the collection source. When using this Action for a List View, the previous object in the View’s editor is selected. When using this Action in a Detail View that displays an object currently selected in a List View, the previous object in the List View’s editor is shown in the Detail View. The NextObject Action does the same, but navigates to the next object in the collection.
See Also: RecordsNavigationController | RecordsNavigationController.PreviousObjectAction | RecordsNavigationController.NextObjectAction
ShowNavigationItemController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: ShowNavigationItem.
Activated in the main window. The ShowNavigationItem Action allows users to navigate between predefined Views. In a Windows Forms application, this Action is displayed by the navigation bar. In an ASP.NET Web Forms application, it is displayed by navigation tabs. The Views to which you can navigate using this Action are specified in the Application Model’s NavigationItems node.
See Also: ShowNavigationItemController | ShowNavigationItemController.ShowNavigationItemAction | IModelNavigationItems | Navigation System
ViewNavigationController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: NavigateBack, NavigateForward.
Activated in all windows. The Actions implemented by this controller allow users to navigate to recently invoked Views. These Actions are activated in the main window only.
ASP.NET Core Blazor
BlazorRecordsNavigationController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: inherited.
A RecordsNavigationController descendant that activates Next Object and Previous Object Actions in a List View with a Split Layout. For more information about the Split Layout, refer to the following topic: MasterDetailMode.ListViewAndDetailView.
BlazorViewNavigationController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: inherited.
A ViewNavigationController descendant that implements Blazor-specific functionality for the NavigateBackAction.
NavigationSettingsController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Supplies IModelApplicationNavigationItems.NavigationItems to the ShowNavigationItemActionControl.
ProcessViewShortcutController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Handles a View Shortcut obtained from the current page URL.
Windows Forms
WinShowStartupNavigationItemController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated in the main window. Displays a View when the start-up window is shown. Uses the ShowNavigationItemController to get a start-up navigation item and execute the ShowNavigationItem Action.
WinViewNavigationController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: inherited.
The Windows Forms-specific version of the ViewNavigationController.
ASP.NET Web Forms
WebRecordsNavigationController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: inherited.
The controller is inherited from the RecordsNavigationController. Makes the NextObject and PreviousObject Actions active if the current View is a Detail View.
See Also:
WebShowStartupNavigationItemController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in the main window. Displays a View when the start-up window is shown. Uses the ShowNavigationItemController to get a start-up navigation item and execute the ShowNavigationItem Action.
WebViewNavigationController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: NavigateTo and inherited.
The controller is inherited from the ViewNavigationController. Deactivates the inherited NavigateBack and NavigateForward Actions. The NavigateTo Action is displayed as breadcrumbs and replaces the deactivated Actions functionality.
List Views
Platform-independent
AutoFilterRowListViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated for List Views.
Extends the Application Model’s IModelClass interface with the IModelClassShowAutoFilterRow interface and the IModelListView interface with the IModelListViewShowAutoFilterRow interface.
See Also: Application Model Basics | Application Model Structure | Extend and Customize the Application Model in Code
ListEditorNewObjectController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated for List Views. Manages creation of new objects using List Editors by handling the ListEditor.NewObjectAdding, ListEditor.NewObjectCreated, and ListEditor.NewObjectCanceled events.
See Also: NewObjectViewController
ListEditorPreviewRowViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated for List Views. Extends the Application Model with the PreviewColumnName property of the Views | <ListView> node. Serves as the base class for Controllers that activate preview rows in platform-specific List Editors. There are three platform-specific descendants: DxGridListEditorPreviewRowController, GridListEditorPreviewRowController, and ASPxGridListEditorPreviewRowViewController.
See Also: IModelListViewPreviewColumn.PreviewColumnName | IModelListView
ListViewProcessCurrentObjectController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: ListViewShowObject.
Activated for List Views. The ListViewShowObject Action is executed when you double-click an object in a List View in a Windows Forms application, and when you click an object in a List View in an ASP.NET Web Forms application. The object is displayed in a separate Window. If you need to execute a custom Action instead of the ListViewShowObject Action, deactivate this Controller and subscribe to the ListView.ProcessSelectedItem event in a custom Controller.
See Also: ListViewProcessCurrentObjectController | ListViewProcessCurrentObjectController.ProcessCurrentObjectAction | How to: Replace a List View’s Default Action
NewItemRowListViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated for List Views. Extends the Application Model with the DefaultListViewNewItemRowPosition property in the BOModel | <Class> node and the NewItemRowPosition property in the Views | <ListView> node. Configures the new item row, if the List Editor implements the ISupportNewItemRowPosition interface.
See Also: IModelClassNewItemRow.DefaultListViewNewItemRowPosition | IModelListViewNewItemRow.NewItemRowPosition
ASP.NET Core Blazor
BlazorExportController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: inherited.
An ExportController descendant. The Export to Action exports List View data to a memory stream. This Action is only displayed in List Views whose EditorType is DxGridListEditor. XAF uses the data-aware export that ships with the DevExpress Blazor Grid. For more information about this functionality and its limitations, refer to the following topics: Export Data in Blazor Grid and Exporting.
ColumnChooserController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: ColumnChooser.
Implements a Column Chooser with the help of the ShowColumnChooser(DialogDisplayOptions) method. The ColumnChooser Action is active if the current List View uses a DxGridListEditor and the IModelView.CustomizationFormEnabled property is set to true.
DxGridListEditorColumnContextMenuController
Platform: ASP.NET Core Blazor
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Implements a context menu for grid column headers. Menu actions allow users to shape grid data (filter/search, sort, group) or customize the layout (show or hide columns). To disable this menu, deactivate the controller:
using DevExpress.ExpressApp.Blazor.SystemModule;
using DevExpress.ExpressApp;
namespace SolutionName.Blazor.Server.Controllers;
public class RemoveContextMenuController : Controller {
protected override void OnActivated() {
base.OnActivated();
if (Frame.GetController<DxGridListEditorColumnContextMenuController>() is { Active: { } active1 }) {
active1["DisableReason"] = false;
}
}
}
DxGridListEditorPreviewRowController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
A ListEditorPreviewRowViewController descendant activated in List Views. Initializes the preview section if the List View uses a DxGridListEditor.
See also: PreviewColumnName
FilterEditorController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: FilterEditorAction.
Displays a FilterEditorAction if the List View uses a DxGridListEditor. This Action creates a pop-up Detail View with a FilterPropertyEditor.
GridBatchModificationsDisplayController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Tracks changes made to the Object Space for ListView in Batch mode. Customizes grid appearance to display values that are modified and not yet committed.
GridEditingRefreshController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Refreshes DxGridListEditor‘s property editors in certain circumstances when the grid is in editing mode.
ListViewContextMenuActionsController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Implements a context menu that can be invoked for grid rows. Menu actions allow users to work with individual objects (create, clone, delete, or export). To disable this menu, deactivate the controller:
using DevExpress.ExpressApp.Blazor.SystemModule;
using DevExpress.ExpressApp;
namespace SolutionName.Blazor.Server.Controllers;
public class RemoveContextMenuController : Controller {
protected override void OnActivated() {
base.OnActivated();
if (Frame.GetController<ListViewContextMenuActionsController>() is { Active: { } active1 }) {
active1["DisableReason"] = false;
}
}
}
ListEditorInplaceEditController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Activated for List Views. Override its AutoCommitChanges property to commit changes automatically in a nested List View. For more information, refer to the following topic: List View Edit Modes.
Windows Forms
ColumnChooserControllerBase
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
The base Controller for the GridEditorColumnChooserController and WinLayoutManagerController. Adds the Add and Remove buttons to a grid’s Column Chooser or Field List. When pressing the Add button, the Controller shows a tree representing current object properties.
GridEditorColumnChooserController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
A ColumnChooserControllerBase descendant. Intended for List Views that are displayed with the GridListEditor, which uses the XtraGrid editor. The Controller sets up the editor’s Customization form and supports its functionality. This form can be invoked by selecting the Column Chooser in the grid’s context menu.
GridListEditorController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for List Views. Sets up the GridListEditor if it displays the current List View. Intended for internal use.
GridListEditorPreviewRowController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for List Views. A ListEditorPreviewRowViewController descendant. Initializes the preview section, if the List View uses the GridListEditor.
ListViewFocusedElementToClipboardController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: CopyCellValue.
Activated for List Views. The CopyCellValue Action, implemented by this Controller, allows you to copy the contents of the focused List Editor cell to the clipboard. The List Editor should support the IFocusedElementCaptionProvider interface.
NewItemRowDataSourcePropertyController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for List Views. For internal use. Allows users to use the lookup editors in the GridListEditor‘s New Item Row.
ToolbarVisibilityController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: ToggleToolbarVisibility.
Activated for nested List Views. The ToggleToolbarVisibility Action allows users to hide the toolbar that accompanies a nested List View. This Action can be accessed by right-clicking a nested List View, and selecting Toggle Toolbar in the invoked context menu.
ASP.NET Web Forms
ASPxGridListEditorPreviewRowViewController
Platform: ASP.NET Web Forms
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated for List Views. The controller is inherited from the ListEditorPreviewRowViewController Controller. Initializes the preview section, if the List View uses the ASPxGridListEditor.
CallbackStartupScriptController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in all pages. Registers startup scripts required by List Editors on callbacks.
ListEditorInplaceEditController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated for List Views. Saves the changes made using the List Editor’s in-place editors to the database when the current View is the root or the current Show View Strategy operates in ViewEditMode.View mode. Changes are not committed automatically in nested List Views. You can inherit this Controller and override the AutoCommitChanges property to return true.
See Also: List Editors | IModelOptionsWeb.CollectionsEditMode
ListViewController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: Edit.
Activated for List View. The Edit Action provided by this Controller invokes a Detail View for the object that is currently selected in a List View. This Detail View is displayed in edit mode.
UpdateListEditorSelectedObjectsController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in List Views. Updates a List Editor’s selection when the bound collection changes.
WebListEditorRefreshController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in List Views. Refreshes a List Editor when data displayed by it is filtered or changed.
See Also: ListEditor.Refresh | Filtering
WebListEditorSettingsStoreViewController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated for List Views. Adds the SaveListViewStateInCookies property to the Application Model’s Options node and the SaveStateInCookies property to the Views | List View node. SaveListViewStateInCookies is a global setting for all List Views. SaveStateInCookies is useful to set an individual value for a particular List View. When the current List View’s settings must be saved to Cookies, the Controller saves the differences that are found between the List View’s state defined in the Application Model, and the current state to the current Session. Then, the SessionDictionaryDifferenceStoreWindowController will save the differences from the Session to Cookies.
See Also: IModelOptionsStateStore.SaveListViewStateInCookies | IModelListViewStateStore.SaveStateInCookies
Security
Platform-independent
LogoffController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: LogOff.
Activated for all Views. The LogOff Action allows users to log on to the application using another user account. This Action is available when the Standard Authentication strategy is used and is deactivated when the Active Directory Authentication strategy is used.
See Also: LogoffController | LogoffController.LogoffAction | Security System
LogonController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: inherited.
A DialogController descendant. Activated in the Logon window. Replaces the DialogController‘s DialogOk Action with the Logon Action. The Action’s Execute event handler is provided by the base DialogController class.
See Also: Security System
ASP.NET Core Blazor
BlazorLogonController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: inherited.
A LogonController descendant. Deactivates the Cancel Action.
ASP.NET Web Forms
WebLogonController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: inherited.
The controller is inherited from the LogonController Dialog Controller. Deactivates the Cancel Action.
Dashboards
Platform-independent
DashboardCreationWizardController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: CreateDashboard.
Activated in the main Window. Supplies the CreateDashboard Action, allowing users to create dashboards.
See Also: IModelOptionsDashboard.EnableCreation | DashboardView
DashboardCustomizationController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: OrganizeDashboard.
Activated in nested DashboardOrganizer Detail Views. Supplies the OrganizeDashboard Action, allowing users to organize dashboards.
See Also: IModelOptionsDashboard.EnableCustomization | DashboardView
DashboardDeactivateItemsActionsController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: OrganizeDashboard.
Activated in Dashboard Views. Deactivates the SaveAndClose and SaveAndNew Actions in Views displayed on a dashboard.
See Also: ModificationsController.SaveAndCloseAction | ModificationsController.SaveAndNewAction |DashboardView
DashboardOrganizerHideToolbarController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated in nested DashboardOrganizationItem Views. Disables the Actions toolbar in the dashboard organizer.
See Also: IModelOptionsDashboard.EnableCustomization | DashboardView
DashboardOrganizerItemsCollectionsController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: DeleteItem, HideItemsFromDashboard, ShowItemsOnDashboard.
Activated in nested DashboardOrganizationItem Views. Supplies Actions allowing users to show, hide, and delete dashboard View Items in a dashboard View.
See Also: IModelOptionsDashboard.EnableCustomization | DashboardView | DashboardViewItem
DeleteDashboardsController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: DeleteDashboard.
Activated in the main Window. Supplies the DeleteDashboard Action located in the Tools category. This Action invokes a popup dialog with a list of all dashboard views defined in the user’s model differences. In this popup you can select one or more dashboards and click Delete to remove them. The DeleteDashboardsController.CanDeleteParentGroup property specifies whether or not the dashboard’s parent group is deleted when you remove the last dashboard in this group. The DeleteDashboard Action is active when there are dashboards that can be deleted and the EnableCreation property of the Options | Dashboards node is set to true in the Application Model.
See Also: IModelOptionsDashboard.EnableCustomization | DashboardView
ViewDashboardOrganizationItemController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated in ViewDashboardOrganizationItem Views. Refreshes the dashboard organizer when a dashboard View Item type changes.
See Also: IModelOptionsDashboard.EnableCustomization | DashboardView
Windows Forms
DashboardWinLayoutManagerController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated in Dashboard Views. Allows users to add new Views and remove existing Views from a dashboard with the Customization dialog.
See Also: IModelOptionsDashboard.EnableCustomization | DashboardView | DashboardViewItem
Debugging and Testing
Platform-independent
ActionsInfoController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
A Diagnostic Controller implementing the IDiagnosticController interface. This Controller collects information on all Controllers of the current Frame (Window), the Controllers’ Actions, the current Template and its Action Containers, and the current View and its Editor(s). The DiagnosticInfoController adds the Single Choice Action Item exposed by this Controller to the DiagnosticInfo Action. When an user selects this item, the collected information is shown in an invoked window.
DiagnosticInfoProviderBase
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated in all windows and frames. DiagnosticInfoProviderBase is the base class for the ActionsInfoController, ViewInfoController, and ShowRulesController Controllers. These Controllers provide items for the DiagnosticInfoController‘s Diagnostic Info Action. The DiagnosticInfoProviderBase class exposes members designed to create the Diagnostic Info Action’s items and collect the information displayed when selecting these items.
See Also: Determine Why an Action, Controller or Editor is Inactive | ActionBase.DiagnosticInfo
DiagnosticInfoController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: Diagnostic Info.
Activated in all windows and frames. Finds all Controllers that implement the IDiagnosticController interface. These Controllers collect information on the required objects (Controllers, Actions, current Template, validation rules and so on). The DiagnosticInfoController‘s Diagnostic Info Action, representing a Single Choice Action, contains the Single Choice Action Items that are exposed by Diagnostic Controllers that are found. When the Diagnostic Info Action’s item is selected, a window with the information collected by the corresponding Controller is displayed. This information helps to find out why the Controller or Action is inactive or invisible.
See Also: Determine Why an Action, Controller or Editor is Inactive | ActionBase.DiagnosticInfo
ViewInfoController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
A Diagnostic Controller implementing the IDiagnosticController interface. This Controller collects information on the current View and its editor(s). The DiagnosticInfoController adds the Single Choice Action Item exposed by this Controller to the DiagnosticInfo Action. When a user selects this item, the collected information is shown in an invoked window.
See Also: Determine Why an Action, Controller or Editor is Inactive
ASP.NET Core Blazor
EasyTestAssistanceController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
For internal use. Implements functionally required to support DetailPropertyEditor in EasyTest.
Windows Forms
LookupControlFinderController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for Views displayed by LookupPropertyEditor. Discovers controls in pop-up Windows and supplies them to EasyTest.
See Also: Functional Testing
WindowControlFinderController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: EasyTest Control.
Activated in all Windows. Discovers controls in the current Window and supplies them to EasyTest. Declares the EasyTest Control diagnostic Action, which lists all these controls.
See Also: Functional Testing
ASP.NET Web Forms
TestScriptsController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in all Windows when EasyTest is enabled. Allows an ASP.NET Web Forms XAF application to be tested with EasyTest.
See Also: Functional Testing
Miscellaneous
Platform-independent
ActionsCriteriaViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll. Actions: none.
Disables and enables Actions depending on their ActionBase.TargetObjectsCriteria and ActionBase.TargetObjectsCriteriaMode property values.
DetailViewEditorActionController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated for Detail Views. Collects the Actions of the current Detail View’s Items that implement the IActionSource interface and ensures that the Actions will be activated and can be executed. Actions are exposed by the IActionSource.Actions property.
DetailViewLinkController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Activated for Detail Views. When a Detail View is invoked from a List View in a separate window, this Controller updates the List View if anything changes in the Detail View. For instance, when a Detail View’s object is replaced with another (for example, using the NextObject Action), the focused object in the List View changes. When an object is modified or deleted in a Detail View, the List View’s objects are updated as well. When an object is opened in a Detail View from a nested list view, all new objects created in this Detail View are automatically linked to the master object, which owns the collection bound to the nested List View. The DetailViewLinkController subscribes to the IObjectSpace.Committed event. In this event handler, an object matching the DetailView.CurrentObject is searched in the List View from which the current Detail View was opened. The found object is reloaded if the DetailView.CurrentObject is modified.
DialogController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: DialogOK, DialogCancel.
Activated in pop-up windows invoked by the PopupWindowShowAction. Contains the DialogOK and DialogCancel Actions. You can add this Controller to a pop-up window when you create it using an Action’s ShowViewParameters object.
See Also: DialogController | DialogController.AcceptAction | DialogController.CancelAction | Dialog Controller
ExportAnalysisController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: Export.
Activated in Detail Views when the CompositeView.Items collection includes editors that support the IExportableAnalysisEditor interface. The abstract base Controller for the WinExportAnalysisController and WebExportAnalysisController Controllers. Contains the ExportAnalysis Action which exports data from analysis Property Editors (see Pivot Chart Module).
See Also: ExportController | ExportController.ExportAction | How to: Customize the Export Action Behavior
ExportController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: Export.
Activated in all Views. The abstract base Controller for the WinExportController and WebExportController Controllers. Contains the Export Action which exports data from List View. The Action is active in List Views when the ListView.Editor editor supports the IExportable interface.
See Also: ExportController | ExportController.ExportAction | How to: Customize the Export Action Behavior
FillActionContainersController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
When a Template is created, all its Action Containers are created as well. Then, the FillActionContainers Controller uses the Application Model to determine Actions that are to be displayed within Action Containers. In particular, the ActionDesign | ActionToContainerMapping node provides this information. Then, this Controller calls the Action Container’s Register method for each Action to create the corresponding control. Action Containers create specific controls for each Action type.
See Also: IModelActionToContainerMapping | Actions | Action Containers
FocusDefaultDetailViewItemController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Extends the Application Model‘s DetailView nodes with the DefaultFocusedItem property that specifies the property editor initially focused when the root Detail View is displayed. Note that the Detail View displayed with the List View (see Display a Detail View with a List View) is not a root, so the DefaultFocusedItem property makes no sense in this case. The following platform-specific Controllers are derived from FocusDefaultDetailViewItemController: WinFocusDefaultDetailViewItemController and WebFocusDefaultDetailViewItemController.
See Also: IModelDetailViewDefaultFocusedItem.DefaultFocusedItem | IModelDetailView | View.IsRoot
HideActionsViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Deactivates the Actions that are listed in the HiddenActions child node of the current View’s View node.
See Also: IModelHiddenActions | IModelView
ObjectMethodActionsViewController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: Actions, added with the Action Attribute.
Activated for all Views. Iterates through all business classes present in the Application Model’s BOModel node, collects methods that are decorated with the Action attribute, and converts them to Simple Actions. Each Action is activated if the current View’s object type corresponds to the class from which it was generated.
See Also: ActionAttribute | SimpleAction | Add a Simple Action Using an Attribute | How to: Create an Action Using the Action Attribute
RefreshController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: Refresh.
Activated for all Views. Contains the Refresh Action, which is activated for root Views only. When executing this Action, the BaseObjectSpace.Refresh method is called.
See Also: RefreshController | RefreshController.RefreshAction
ResetViewSettingsController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: ResetViewSettings.
Activated for all Views. Contains the ResetViewSettings Action, which re-opens the current View and resets all user customizations of the View’s model. If you use the ListViewAndDetailView display mode, the ResetViewSettings Action is applied to both List and Detail Views unless the AllowResetEditView property is set to false. The Action is disabled (grayed out) if there are unsaved changes.
See Also: BlazorResetViewSettingsController | List View Columns Customization | Detail View Layout Customization
WindowTemplateController
Platform: platform-independent.
Assembly: DevExpress.ExpressApp.v24.2.dll.
Actions: none.
Updates the current Window’s caption and status messages. Exposes events and methods allowing you to customize and refresh caption and status messages. Has a WinForms-specific descendant - WinWindowTemplateController.
See Also: WindowTemplateController | How to: Customize a Window Caption | How to: Customize Window Status Messages (WinForms)
ASP.NET Core Blazor
ActionHandleExceptionController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Handles exceptions that are thrown when XAF executes an Action.
BlazorResetViewSettingsController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: inherited.
Blazor-specific ResetViewSettingsController descendant. Changes the base controller’s AllowResetEditView property to false. This way Detail Views are not affected when a user executes this action in split views. To revert changes to a Detail View’s layout, use the Reset Layout context menu action instead. Reset View Settings Action is available in record context menus (List Views):
Note
All actions that customize a List View are available in column header context menus. If you disable these menus (deactivate the DxGridListEditorColumnContextMenuController), the Reset View Settings Action becomes unnecessary and XAF disables it too.
CloseDetailViewController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: Close Action.
Activated for Detail Views. The CloseAction closes the current View.
ConfirmationActionRegistrationController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Implements the IModelActionBlazor.ConfirmUnsavedChanges functionality and registers Actions whose ConfirmUnsavedChanges property is set to true.
ConfirmationDetailViewController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Implements “unsaved changes” confirmation dialog functionality in Detail Views.
ConfirmationListViewController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Implements “unsaved changes” confirmation dialog functionality in List Views.
ConfirmationUnsavedLinkedObjectController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Implements “unsaved changes” confirmation dialog functionality in nested List Views.
CustomizeActionControlController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Supports AdaptivePriority and CustomCSSClassName in Actions displayed by the DxToolbar control.
CustomizeBlazorActionContainerViewItemController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Activated in Composite Views. Implements functionality required for ActionContainerViewItem.
DetailViewRefreshController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Activated for Detail Views. Forces an update for neighboring property editors after a value change in the current property editor.
DisableDashboardLayoutEditorController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Activated for Dashboard Views. Disables runtime layout customization in the current Dashboard View and its nested Detail Views.
DisableLayoutEditorController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Disables runtime layout customization in specific Views.
DisableNestedLayoutEditorController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Activated for Detail Views. Disables runtime layout customization in nested Detail Views.
LayoutEditorConfirmationController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Activated for Composite Views. Implements “unsaved changes” confirmation dialog functionality for runtime layout customization.
ManageActionVisibilityController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Manages Toolbar visibility in selection-dependent Actions in List Views. For more information about this behavior, refer to the following topic: BlazorApplication.EnableDefaultSelectionDependencyType.
ObjectModelController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Adds the Customize button to the List View’s DxGridListEditor Column Chooser and to the Detail View’s Customization Form. When a user clicks the button, XAF displays the Object Model dialog window where you can hide or display properties.
See also: Display a Nested Property Editor in a Detail View
PopupCaptionPositionController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Sets vertical caption position for Layout Manager in pop-up windows.
PopupWindowTemplateClosingController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Manages the Close button’s visibility in a pop-up window. When a user clicks the button, XAF executes the ClosePopupWindow method. Your can override this method to implement your own logic:
using DevExpress.ExpressApp.Blazor.SystemModule;
using DevExpress.ExpressApp;
using YourApplicationName.Module.BusinessObjects;
namespace YourApplicationName.Blazor.Server.Controllers;
public class PopupWindowTemplateClosingControllerExample : PopupWindowTemplateClosingController {
protected override bool ClosePopupWindow(Window popupWindow) {
if (popupWindow.View.CurrentObject is Employee employee && employee.FirstName == "James") {
return false;
}
return base.ClosePopupWindow(popupWindow);
}
}
See Also: PopupWindowTemplateClosingController
PopupWindowTemplateSizeController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Manages drag and resize settings of a pop-up window.
See Also: PopupWindowTemplateSizeController
PrimaryToolbarItemsController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Sets RenderStyle to Primary for several Actions (such as Logon and Save).
SaveModelDifferencesController
Platform: ASP.NET Core Blazor.
Assembly: DevExpress.ExpressApp.Blazor.v24.2.dll.
Actions: none.
Activated for List Views. Saves user differences (individual user settings). For example, saved information includes filter conditions and sort order in List Views.
Windows Forms
AboutInfoController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: AboutInfo.
Activated in the main window. Contains the About Info Action. In Windows Forms applications, this Action presents general information on the current application collected from the Application Model by this Controller.
See Also: Application Personalization
AboutInfoFormController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated in the Detail Views of the AboutInfo objects. Sets up the About window:
- Disables the ability to customize layouts.
- Fixes the window’s width according to the Logo image’s width.
- Removes the Static Image View Item if the image is not specified.
- Enables the Label Emphasis feature to divide the About text into multiple strings.
AsyncLoadingCancelationController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Cancels the asynchronous loading of data in a View when a user closes it. This Controller allows you to show a confirmation message when you close a View in the UI.
See Also: How to: Customize Asynchronous Data Loading Behavior and UI
AsyncLoadingIndicationController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Shows the Overlay Form and disables built-in Actions while an asynchronous operation is in progress.
See Also: How to: Customize Asynchronous Data Loading Behavior and UI
ChooseSkinController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: ChooseSkin.
Activated in the main window if the UseLightStyle property is false. Otherwise, the ConfigureSkinController is activated instead.
Contains the ChooseSkin Action. This Action allows users to apply a predefined skin to the application. The selected skin is stored in the Skin property of the Application Model’s Options node.
See Also: Application Model Basics | Application Model Structure
ConfigureSkinController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: ConfigureSkin.
Activated in the main window if the UseLightStyle property is true. Otherwise, the ChooseSkinController is activated instead.
Contains the ConfigureSkin Action. This Action allows users to apply a predefined skin to the application. Users can also select a palette if a skin supports palettes. The selected skin is stored in the Skin property of the Application Model’s Options node. The selected palette is stored in the Palette property of the Application Model’s Options node.
See Also: Application Model Basics | Application Model Structure
CloseMdiChildWindowController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win24.2.dll.
Actions: none.
Activated in child Windows when MdiShowViewStrategy is used. Prohibits closing a child Window while its View is changing and closes the Window when its View is closed.
CloseWindowController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win24.2.dll.
Actions: Close.
Activated in child Windows. The Close Action closes the current window. It is active when a current window contains a View.
DockPanelsVisibilityController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for all windows. Creates a SingleChoiceAction in the Panels category for each dock panel located in the current window if the current window Template implements the IDockManagerHolder interface. The created Actions allow you to change dock panel visibility to Visible, AutoHide, or Hidden.
See Also: Template Customization
EditModelController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: EditModel.
Activated in all windows. Contains the EditModel Action. This Action allows users to invoke the Model Editor at runtime. When the Security System is used, this Action is deactivated if the current user does not have permission to edit the Application Model.
ExitController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: Exit.
Contains the Exit Action, which is used to close the application.
HtmlFormattingController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for all Views. Adds the EnableHtmlFormatting property to the Options node. When this property is set to true, HTML formatting of the Property Editor captions, List View column captions, and Static View Item text are rendered. When this property is set to false, HTML formatting is not supported.
See Also: IModelOptionsEnableHtmlFormatting.EnableHtmlFormatting | IModelOptions | How to: Apply HTML Formatting to Windows Forms XAF UI Elements
LockController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for all Views. Locks modifying an object, if it is currently being modified in another View.
See Also: Optimistic Concurrency Control
MdiTabImageController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for child Windows when the MdiShowViewStrategy is used in MdiMode.Tabbed mode. Sets tab images accordingly to the displayed Views.
See Also: UIType.TabbedMDI
OpenObjectController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: OpenObject.
Activated for all Views. The Action is executed after you:
- Focus a reference property editor and click the Action’s button on the toolbar.
- Hold SHIFT+CTRL and click a reference property editor.
- Focus an editor and press Shift+Ctrl+Enter.
In Detail Views, this Controller operates with Property Editors inherited from the WinPropertyEditor class; if the currently focused editor is bound to a reference property, the OpenObject Action invokes the referenced object Detail View. In List Views, this Controller operates when the current ListView.Editor is GridListEditor; the OpenObject Action invokes the Detail View of the object from the focused cell.
Note
- The OpenObject Action is inactive when the List View is in DataView, ServerView, InstantFeedback, and InstantFeedbackView mode.
- The OpenObject Action does not work with a reference property in TreeListEditor.
- The IModelMemberViewItem.View property is ignored when you invoke the Detail View from the List View through the Ctrl+Shift+Click combination.
To specify the View invoked on the OpenObject Action execution, use the OpenObjectController.CustomOpenObject event, as shown in the How to specify what DetailView is shown by the Open Related Record action execute or ctrl shift key combination click Support Center ticket.
PrintingController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: PageSetup, Print and PrintPreview.
Activated for Detail Views whose control implements the IPrintable interface and List Views whose List Editor implements the IExportable interface. Provides Actions that allow users to print the current View.
See Also: PrintingController
VersionsCompatibilityController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated in all Views. When working with an application, its version and database can be updated. This can corrupt the database. This Controller checks the application and database versions compatibility periodically during the application run. If a version mismatch is found, a warning window is invoked.
WaitCursorController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Changes the cursor to the hour glass mode while an Action is executing.
WinExportController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
The Windows Forms-specific descendant of the ExportController. Creates a file stream for the exported data.
See Also: WinExportController
WinFocusDefaultDetailViewItemController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
The platform-specific descendent of the FocusDefaultDetailViewItemController.
WinFocusListEditorControlController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated in all Windows. When the currently displayed View changes to a List View, focuses the List Editor’s control.
See Also: List Editors
WinLayoutManagerController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Sets up the editor’s Customization form and supports its functionality. To invoke this form, select Customize Layout in the detail form’s context menu.
See Also: View Items Layout Customization
WinWindowTemplateController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
A WinForms-specific descendant of the WindowTemplateController. Handles events of the DocumentManager to update the current Window’s caption.
XtraGridInLookupController
Platform: Windows Forms.
Assembly: DevExpress.ExpressApp.Win.v24.2.dll.
Actions: none.
Activated for all Views. Intended for internal use. Sets up the XtraGrid control used in the Lookup Property Editor’s lookup window in Detail and List Views.
ASP.NET Web Forms
ChooseThemeController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: ChooseTheme.
Contains the ChooseTheme Action. This Action allows users to select one of the themes used in the application. The currently selected theme is stored in a user’s browser cookies.
See Also: ChooseThemeController | ASP.NET Web Forms Application Appearance
FocusController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
A Window Controller that manages focus on the current page.
See Also: FocusController
ParameterlessLogonFailedInfoViewController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Intended for internal use. Customizes an error message displayed when a parameterless log-on procedure has failed.
PreserveValidationErrorMessageAfterPostbackController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in root Views. Prevents validation error messages displayed on the screen from being lost when a postback occurs.
See Also: Validation Module
ProcessActionContainerHolderController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Represents a base class from which Controllers customizing Action Container controls are derived.
RedirectOnCallbackController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in all pages. Designed for internal use. When a View is changed in a Frame, this Controller performs redirection, if required.
RedirectOnViewChangedController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated for all Views. Designed for internal use. When a View is changed in a Frame, some controls can be replaced. The RedirectOnViewChangedController Controller prevents the loading of view state and form data into the wrong control.
RegisterThemeAssemblyController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in all pages. Registers theme-related CSS files stored as resources in the DevExpress.Web.ASPxThemes.24.2.dll assembly on the current page. If you need to use custom CSS files, you can disable this Controller by setting its EnableXafThemeAssembly property to false.
See Also: ASP.NET Web Forms Application Appearance
SessionDictionaryDifferenceStoreWindowController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
The Controller saves the Application Model differences made by a user from the current Session to the underlying storage (for example, in cookies) when a page is loaded prior to rendering.
See Also: IModelListViewStateStore.SaveStateInCookies | IModelOptionsStateStore.SaveListViewStateInCookies
WebExportController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: inherited.
An ASP.NET Web Forms specific descendant of the ExportController. Creates a memory stream for the exported data.
See Also: WebExportController
WebFocusDefaultDetailViewItemController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
The platform-specific descendent of the FocusDefaultDetailViewItemController.
WebFocusPopupWindowController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated in pop-up Windows. This Controller focuses the FullTextSearch Parametrized Action when the invoked pop-up Window contains a List View.
See Also: FilterController | FilterController.FullTextFilterAction
WebIdAssignationController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
For internal use. Activated for Detail Views. Sets identifiers for all View Items.
WebObjectMethodActionsViewController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: inherited.
The controller is inherited from the ObjectMethodActionsViewController. Commits changes made by an Action created using the ActionAttribute when a Detail View is in view mode.
WebWindowController
Platform: ASP.NET Web Forms.
Assembly: DevExpress.ExpressApp.Web.v24.2.dll.
Actions: none.
Activated for all windows. Ensures the correct processing of changing the current object into a Detail View. For internal use.