This topic describes how to access UI elements such as View Items, List Editors, Property Editors and their underlying controls.
Create a custom ViewController descendant (or a generic ViewController<ViewType> or ObjectViewController<ViewType, ObjectType>) and implement a solution from one the following sections:
Use the CompositeView.FindItem(String) method in the ViewController.Activated event handler or overridden ViewController.OnActivated virtual method. The View Item's name should match the corresponding Views | CompositeView | Items | ViewItem Model node's ID property. The default Property Editor's ID matches the property name.
Examples: Access Editor Settings | How to: Access the Dashboard Control
Use the CompositeView.Items property in the ViewController.Activated event handler or overridden ViewController.OnActivated virtual method.
Use the CompositeView.GetItems<T> method in the ViewController.Activated event handler or overridden ViewController.OnActivated virtual method.
Examples: How to: Access the ASPxDocumentViewer and ASPxWebDocumentViewer Controls | How to: Access the ReportViewer Control
Use the ViewItem.Control property in the ViewItem.ControlCreated event handler. You can also use the overridden ViewItem.OnControlCreated virtual method to access a control of a custom View Item.
Examples: Access Editor Settings | Access Mobile Editor Settings
Use the NestedFrame.ViewItem property in the ViewController.Activated event handler or overridden ViewController.OnActivated virtual method.
Examples: How to: Initialize an Object Created Using the New Action | How to: Access Master Detail View and Nested List View Environment
Create a Property Editor's descendant and customize it. Apply the custom Property Editor to target properties in Model Editor. You can also use this Property Editor for all properties of a specific type.
Examples: How to: Customize a Built-in Property Editor (WinForms | ASP.NET | Mobile)
Use the ViewItem.View property in the ViewController.Activated event handler or overridden ViewController.OnActivated virtual method.
Follow the steps from the View Items Layout Customization topic's Access the Layout Control section.
Use the ListView.Editor property in the ViewController.Activated event handler or overridden ViewController.OnActivated virtual method.
Examples: Access Grid Control Properties | Access List Control Properties
XAF provides various platform-specific List Editors. Each editor has properties, methods, and events for accessing an editor's control. Handle the View.ControlsCreated, ListEditor.ControlsCreated or ViewController.ViewControlsCreated event and use this API in the handler.
Example: ListEditor.Control | How to: Access the List Editor's Control
There is no common solution for all List Editors. A List Editor can instantiate an internal Property Editor to propagate settings to underlying data cell controls in view and edit modes. Use List Editor's members or customize its underlying control directly as described in the control's documentation. If you want to customize a control globally for List and Detail Views, refer to the Customize a control of a Property Editor used both in a List and Detail View globally section.
Examples: ComplexWebListEditor.FindPropertyEditor | How to: Edit a Reference Property in the Batch Edit Mode | How to add an unbound column to GridListEditor
To access an ActionContainerViewItem's control, follow the directions from the How to: Include an Action to a Detail View Layout topic.
using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Editors;
using DevExpress.ExpressApp.Win.Editors;
using DevExpress.XtraGrid;
// ...
public class MyViewController : ViewController<ListView> {
protected override void OnActivated() {
base.OnActivated();
ListPropertyEditor editorForCollectionProperty = View.FindItem("CollectionProperty") as ListPropertyEditor;
editorForCollectionProperty.ControlCreated += (s, e) => {
ListView nestedListView = ((ListPropertyEditor)s).ListView;
nestedListView.ControlsCreated += (s1, e1) => {
GridListEditor gridListEditor = ((ListView)s1).Editor as GridListEditor;
if (gridListEditor != null) {
GridControl grid = gridListEditor.Grid;
}
};
};
}
}
using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Editors;
// ...
public class MyViewController : ViewController<DetailView> {
protected override void OnActivated() {
base.OnActivated();
DetailPropertyEditor editorForReferenceProperty =
View.FindItem("ReferenceProperty") as DetailPropertyEditor;
editorForReferenceProperty.ControlCreated += (s, e) => {
NestedFrame nestedFrame = ((DetailPropertyEditor)s).Frame as NestedFrame;
ViewItem nestedFrameViewItem = nestedFrame.ViewItem;
if (nestedFrameViewItem.Control != null) { /* ... */ }
};
}
}
If you customize a control as described in the previous sections and this does not take effect, handle one of the following platform-specific events:
WinForms | ASP.NET |
|---|---|
|
|
In ASP.NET applications, you can also perform specific customizations on the client-side (see Client-Side Functionality Overview).
control.Controls[index]) only if there is no solution for your scenario in this topic and the control's documentation.