[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Expand]Concepts
 [Expand]Design-Time Features
 [Expand]Deployment
 [Expand]Task-Based Help
  Frequently Asked Questions (FAQ)
 [Collapse]API Reference
  [Expand]DevExpress.EasyTest.Framework
  [Expand]DevExpress.ExpressApp
  [Expand]DevExpress.ExpressApp.Actions
  [Expand]DevExpress.ExpressApp.AuditTrail
  [Expand]DevExpress.ExpressApp.Chart
  [Expand]DevExpress.ExpressApp.Chart.Web
  [Expand]DevExpress.ExpressApp.Chart.Win
  [Expand]DevExpress.ExpressApp.CloneObject
  [Expand]DevExpress.ExpressApp.ConditionalAppearance
  [Expand]DevExpress.ExpressApp.Dashboards
  [Expand]DevExpress.ExpressApp.Dashboards.Web
  [Expand]DevExpress.ExpressApp.Dashboards.Win
  [Expand]DevExpress.ExpressApp.Data
  [Expand]DevExpress.ExpressApp.DC
  [Expand]DevExpress.ExpressApp.DC.ClassGeneration
  [Expand]DevExpress.ExpressApp.Editors
  [Expand]DevExpress.ExpressApp.EF
  [Expand]DevExpress.ExpressApp.EF.Utils
  [Expand]DevExpress.ExpressApp.FileAttachments.Web
  [Expand]DevExpress.ExpressApp.FileAttachments.Win
  [Expand]DevExpress.ExpressApp.Filtering
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Web
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Win
  [Expand]DevExpress.ExpressApp.Kpi
  [Expand]DevExpress.ExpressApp.Layout
  [Expand]DevExpress.ExpressApp.Maps.Mobile
  [Expand]DevExpress.ExpressApp.Maps.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Maps.Web
  [Expand]DevExpress.ExpressApp.Maps.Web.Helpers
  [Expand]DevExpress.ExpressApp.MiddleTier
  [Expand]DevExpress.ExpressApp.Mobile
  [Expand]DevExpress.ExpressApp.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Mobile.MobileModel
  [Expand]DevExpress.ExpressApp.Mobile.SystemModule
  [Expand]DevExpress.ExpressApp.Mobile.Templates
  [Expand]DevExpress.ExpressApp.Model
  [Expand]DevExpress.ExpressApp.Model.Core
  [Expand]DevExpress.ExpressApp.Model.NodeGenerators
  [Expand]DevExpress.ExpressApp.ModelEditor
  [Expand]DevExpress.ExpressApp.Notifications
  [Expand]DevExpress.ExpressApp.Notifications.Web
  [Expand]DevExpress.ExpressApp.Notifications.Win
  [Expand]DevExpress.ExpressApp.Office.Win
  [Expand]DevExpress.ExpressApp.PivotChart
  [Expand]DevExpress.ExpressApp.PivotChart.Web
  [Expand]DevExpress.ExpressApp.PivotChart.Win
  [Expand]DevExpress.ExpressApp.PivotGrid
  [Expand]DevExpress.ExpressApp.PivotGrid.Web
  [Expand]DevExpress.ExpressApp.PivotGrid.Win
  [Expand]DevExpress.ExpressApp.Reports
  [Expand]DevExpress.ExpressApp.Reports.Web
  [Expand]DevExpress.ExpressApp.Reports.Win
  [Expand]DevExpress.ExpressApp.ReportsV2
  [Expand]DevExpress.ExpressApp.ReportsV2.Mobile
  [Expand]DevExpress.ExpressApp.ReportsV2.Web
  [Expand]DevExpress.ExpressApp.ReportsV2.Win
  [Expand]DevExpress.ExpressApp.Scheduler
  [Expand]DevExpress.ExpressApp.Scheduler.Web
  [Expand]DevExpress.ExpressApp.Scheduler.Win
  [Expand]DevExpress.ExpressApp.ScriptRecorder
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Web
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Win
  [Expand]DevExpress.ExpressApp.Security
  [Expand]DevExpress.ExpressApp.Security.Adapters
  [Expand]DevExpress.ExpressApp.Security.ClientServer.Wcf
  [Expand]DevExpress.ExpressApp.Security.EF.Adapters
  [Expand]DevExpress.ExpressApp.Security.Strategy
  [Expand]DevExpress.ExpressApp.Security.Xpo.Adapters
  [Expand]DevExpress.ExpressApp.StateMachine
  [Collapse]DevExpress.ExpressApp.SystemModule
   [Expand]AboutInfo Class
   [Expand]ActionControlsSiteController Class
   [Expand]CustomBuildCriteriaEventArgs Class
   [Expand]CustomExportAnalysisEventArgs Class
   [Expand]CustomExportEventArgs Class
   [Expand]CustomGetDefaultFileNameEventArgs Class
   [Expand]CustomGetFiltersEventArgs Class
   [Expand]CustomGetFullTextSearchPropertiesEventArgs Class
   [Expand]CustomizeShowViewParametersEventArgs Class
   [Expand]CustomizeWindowCaptionEventArgs Class
   [Expand]CustomizeWindowStatusMessagesEventArgs Class
   [Expand]CustomShowNavigationItemEventArgs Class
   [Expand]DeleteObjectsViewController Class
   [Expand]DialogController Class
   [Expand]DialogControllerAcceptingEventArgs Class
   [Expand]ExportAnalysisController Class
   [Expand]ExportController Class
   [Expand]FilterController Class
    FullTextSearchTargetPropertiesMode Enumeration
   [Expand]IDataAwareExportable Interface
   [Expand]IDataAwareExportableCsv Interface
   [Expand]IDataAwareExportableXls Interface
   [Expand]IDataAwareExportableXlsx Interface
   [Expand]IExportable Interface
   [Expand]IExportableAnalysisEditor Interface
   [Expand]IModelActionContainer Interface
   [Expand]IModelActionDesignContainerMapping Interface
   [Expand]IModelActionLink Interface
   [Expand]IModelActionToContainerMapping Interface
   [Expand]IModelApplicationCreatableItems Interface
   [Expand]IModelApplicationNavigationItems Interface
   [Expand]IModelClassNavigation Interface
   [Expand]IModelClassNewItemRow Interface
   [Expand]IModelClassShowAutoFilterRow Interface
   [Expand]IModelClassShowFindPanel Interface
   [Expand]IModelCreatableItem Interface
   [Expand]IModelCreatableItems Interface
   [Expand]IModelDetailViewDefaultFocusedItem Interface
   [Expand]IModelHiddenActions Interface
   [Expand]IModelListViewFilter Interface
   [Expand]IModelListViewFilterItem Interface
   [Expand]IModelListViewFilters Interface
   [Expand]IModelListViewNewItemRow Interface
   [Expand]IModelListViewPreviewColumn Interface
   [Expand]IModelListViewShowAutoFilterRow Interface
   [Expand]IModelListViewShowFindPanel Interface
   [Expand]IModelNavigationItem Interface
   [Expand]IModelNavigationItems Interface
   [Expand]IModelOptionsDashboard Interface
   [Expand]IModelOptionsDashboards Interface
   [Expand]IModelPropertyEditorLinkView Interface
   [Expand]IModelRootNavigationItems Interface
   [Expand]IModelViewHiddenActions Interface
   [Expand]LinkUnlinkController Class
   [Expand]ListViewFilterAttribute Class
   [Expand]ListViewProcessCurrentObjectController Class
   [Expand]LogoffController Class
   [Expand]ModelActionContainersGenerator Class
   [Expand]ModelCreatableItemsGenerator Class
   [Expand]ModelListViewFiltersGenerator Class
    ModificationsCheckingMode Enumeration
   [Expand]ModificationsController Class
    ModificationsHandlingMode Enumeration
   [Expand]NavigationItemCreatedEventArgs Class
   [Expand]NavigationItemNodeGenerator Class
    NewObjectActionItemListMode Enumeration
   [Collapse]NewObjectViewController Class
     NewObjectViewController Members
     NewObjectViewController Constructor
    [Expand]NewObjectViewController Properties
    [Expand]NewObjectViewController Events
    [Expand]NewObjectViewController Methods
   [Expand]ObjectCreatingEventArgs Class
   [Expand]PrintableChangedEventArgs Class
   [Expand]RecordsNavigationController Class
   [Expand]RefreshController Class
   [Expand]ShowNavigationItemController Class
   [Expand]SystemModule Class
   [Expand]WindowTemplateController Class
  [Expand]DevExpress.ExpressApp.Templates
  [Expand]DevExpress.ExpressApp.Templates.ActionContainers
  [Expand]DevExpress.ExpressApp.TreeListEditors
  [Expand]DevExpress.ExpressApp.TreeListEditors.Web
  [Expand]DevExpress.ExpressApp.TreeListEditors.Win
  [Expand]DevExpress.ExpressApp.Updating
  [Expand]DevExpress.ExpressApp.Utils
  [Expand]DevExpress.ExpressApp.Validation
  [Expand]DevExpress.ExpressApp.Validation.Web
  [Expand]DevExpress.ExpressApp.Validation.Win
  [Expand]DevExpress.ExpressApp.ViewVariantsModule
  [Expand]DevExpress.ExpressApp.Web
  [Expand]DevExpress.ExpressApp.Web.Controls
  [Expand]DevExpress.ExpressApp.Web.Editors
  [Expand]DevExpress.ExpressApp.Web.Editors.ASPx
  [Expand]DevExpress.ExpressApp.Web.SystemModule
  [Expand]DevExpress.ExpressApp.Web.Templates
  [Expand]DevExpress.ExpressApp.Web.Utils
  [Expand]DevExpress.ExpressApp.Win
  [Expand]DevExpress.ExpressApp.Win.Core
  [Expand]DevExpress.ExpressApp.Win.Editors
  [Expand]DevExpress.ExpressApp.Win.Model
  [Expand]DevExpress.ExpressApp.Win.SystemModule
  [Expand]DevExpress.ExpressApp.Win.Templates
  [Expand]DevExpress.ExpressApp.Win.Templates.Navigation
  [Expand]DevExpress.ExpressApp.Win.Utils
  [Expand]DevExpress.ExpressApp.Workflow
  [Expand]DevExpress.ExpressApp.Workflow.Win
  [Expand]DevExpress.ExpressApp.Xpo
  [Expand]DevExpress.ExpressApp.Xpo.Utils
  [Expand]DevExpress.Persistent.Base
  [Expand]DevExpress.Persistent.Base.General
  [Expand]DevExpress.Persistent.Base.ReportsV2
  [Expand]DevExpress.Persistent.Base.Security
  [Expand]DevExpress.Persistent.BaseImpl
  [Expand]DevExpress.Persistent.BaseImpl.EF
  [Expand]DevExpress.Persistent.BaseImpl.EF.PermissionPolicy
  [Expand]DevExpress.Persistent.BaseImpl.PermissionPolicy
  [Expand]DevExpress.Persistent.Validation
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

NewObjectViewController Class

Represents a ViewController descendant that contains the New Action.

Namespace:DevExpress.ExpressApp.SystemModule
Assembly:DevExpress.ExpressApp.v19.1.dll

Expanded Syntax

Expanded Remarks

The NewObjectViewController is intended for presenting the New Action.

In a Windows Forms application:

In an ASP.NET application:

For details on the New Action, refer to the description of the NewObjectAction property that provides access to this Action.

To customize the default behavior of the New Action, you can inherit from this Controller, or subscribe to its events. In addition, you can access the Action to modify its behavior.

If you need to inherit from the NewObjectViewController, the following protected virtual methods are available:

Method

When is it called?

Description

OnObjectCreating

Invoked as a result of calling the New method before creating a new object of the chosen type.

Raises the ObjectCreating event.

OnCustomAddObjectToCollection

Invoked as a result of calling the New method after the new object has been created, but not added to the current object collection.

Raises the CustomAddObjectToCollection event.

OnObjectCreated

Invoked as a result of calling the New method after the new object has been created and added to the current object collection. If the ObjectCreatedEventArgs.ShowDetailView property is set to true, a Detail View with the new object is invoked after calling this method.

Raises the ObjectCreated event.

New

When the New Action's SingleChoiceAction.Execute event is raised.

  • Creates a new object using ObjectCreatedEventArgs' properties.
  • Adds the new object to the collection source of the Controller's current List View. If the current View represents a Detail View, the object is added to the List View from which the Detail View has been added. If you need to add the new object in a custom way, handle the CustomAddObjectToCollection event and set the handler's ProcessNewObjectEventArgs.Handled parameter to false.
  • Shows a Detail View with the new object, if the ObjectCreating event handler's ObjectCreatingArgs.ShowDetailView parameter is set to true.

UpdateActionState

Called when the NewObjectViewController is activated. In addition, it is called when the current ListView's CollectionSource is changed, and when the current View's View.AllowNew property is changed. In this Controller's platform-specific descendants, this method is overridden to populate the New Action's ChoiceActionBase.Items collection.

 

Public members are described individually in the documentation.

Note

Inherit from the DevExpress.ExpressApp.Win.SystemModule.WinNewObjectViewController or DevExpress.ExpressApp.Web.SystemModule.WebNewObjectViewController class, if you need to implement a UI-specific behavior.

To ascertain whether the Controller is active, use the Controller.Active property (see How to: Detect a Lookup List View in Code). If you need to know the reason for its deactivation or activation at runtime, use the DiagnosticInfo Action.

Information on the NewObjectViewController and its New Action is available in the Application Model. To access it, use the Model Editor.

Expanded Inheritance Hierarchy

System.Object
    System.MarshalByRefObject
       System.ComponentModel.Component
          Controller
             ViewController
                NewObjectViewController
                   WebNewObjectViewController
                   WinNewObjectViewController

Expanded See Also

Is this topic helpful?​​​​​​​