KB Article S19503
Visible to All Users

Filtering - How to search objects within ListPropertyEditor or enabling the standard FullTextSearch Action for nested ListView

By default, the standard FullTextSearch Action is mapped to the "FullTextSearch" category or Action Container that is physically present in the main, detail and lookup control templates. Historically, it is missing in the nested frame template, which is typically used for ListPropertyEditor, DetailPropertyEditor or DashboardViewItem, mainly not to overload their toolbar with a large text box.

If you still need full text search functionality in nested frame templates, you can consider the following solutions:

1.  Enable native filtering features of the underlying grid, tree and other data bound controls used in nested ListView, because they also provide very good filtering experiences many of your clients will love:
ASP.NET WebForms Controls> Grid View > Concepts > Data Shaping and Manipulation > Filtering > Search Panel  + end-user documentation
WinForms Controls > Controls and Libraries > Data Grid > Visual Elements > Grid Control Elements > Find Panel  + end-user documentation
WinForms Controls > Controls and Libraries > Data Grid > Visual Elements > Grid View Elements > Auto Filter Row
ASP.NET WebForms Controls> Grid View > Concepts > Data Shaping and Manipulation > Filtering > Filter Row
WinForms Controls > Controls and Libraries > Tree List > Visual Elements > Find Panel

The only disadvantage (which can be noticeable in advanced scenarios only) is that with the standard FullTextSearch Action you can provide common customizations for root and nested ListView using the events and other extensibility points of our FilterController, while for the native control features, you will likely have to implement platform-dependent customizations.

2.  Create a custom nested frame template as per the Template Customization. article and manually add the "FullTextSearch" action container into it. This solution appears to be the most difficult from the implementation and further maintenance points of view.

3.  Customize the default mapping of Actions to the default Action Containers in the Application Model. To do this, invoke the Model Editor and follow this video:


Take special note that It is important to make a copy of the Action definition and place it into the Action Container (e.g., Link), which is NOT present in the main, detail and lookup control templates to avoid duplication of Actions in the UI:


This solutions appears to be the easiest one from all points.

Disclaimer: The information provided on DevExpress.com and affiliated web properties (including the DevExpress Support Center) is provided "as is" without warranty of any kind. Developer Express Inc disclaims all warranties, either express or implied, including the warranties of merchantability and fitness for a particular purpose. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.

Confidential Information: Developer Express Inc does not wish to receive, will not act to procure, nor will it solicit, confidential or proprietary materials and information from you through the DevExpress Support Center or its web properties. Any and all materials or information divulged during chats, email communications, online discussions, Support Center tickets, or made available to Developer Express Inc in any manner will be deemed NOT to be confidential by Developer Express Inc. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.