Skip to content
This repository was archived by the owner on Oct 29, 2025. It is now read-only.

Commit 9759761

Browse files
authored
upd readme (#16)
1 parent cdc581f commit 9759761

File tree

1 file changed

+20
-28
lines changed

1 file changed

+20
-28
lines changed

Readme.md

Lines changed: 20 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,52 @@
11
<!-- default badges list -->
2-
![](https://img.shields.io/endpoint?url=https://codecentral.devexpress.com/api/v1/VersionRange/128594111/24.2.1%2B)
32
[![](https://img.shields.io/badge/Open_in_DevExpress_Support_Center-FF7200?style=flat-square&logo=DevExpress&logoColor=white)](https://supportcenter.devexpress.com/ticket/details/E1101)
43
[![](https://img.shields.io/badge/📖_How_to_use_DevExpress_Examples-e9f6fc?style=flat-square)](https://docs.devexpress.com/GeneralInformation/403183)
54
[![](https://img.shields.io/badge/💬_Leave_Feedback-feecdd?style=flat-square)](#does-this-example-address-your-development-requirementsobjectives)
65
<!-- default badges end -->
76

87
# XAF WinForms - How to use a custom Lookup Property Editor control for reference properties
98

10-
> **Note**
11-
> The description of this example is currently under construction and may not match the code in the example. We are currently working to provide you with up-to-date content.
12-
13-
## Scenario
9+
This example demonstrates a simple drop-down editor for reference properties. The editor contains **Open**, **Add**, and **Clear** buttons.
1410

15-
This example demonstrates a simple drop-down editor for reference properties. The editor provides the **Open**, **Add** and **Clear** buttons.
1611

1712
![Custom Lookup](./media/CustomLookup.png)
1813

1914
## Implementation Details
2015

21-
1. The _Editors.Win_ module implements a reusable `LookupPropertyEditorEx` class. This is an XAF Property Editor that can be used for reference properties instead of the standard `LookupPropertyEditor` in WinForms XAF applications.
16+
The [LookupPropertyEditorEx.cs](./CS/EFCore/Editors.Win/LookupPropertyEditorEx.cs) file contains the reusable `LookupPropertyEditorEx` class. This Property Editor can be used for reference properties instead of the standard `LookupPropertyEditor` in WinForms XAF applications.
2217

23-
2. The `LookUpEditEx` and `RepositoryItemLookUpEditEx` classes implement a control for this Property Editor. This control is inherited from the `LookUpEdit` class and extends it with additional features required for the Property Editor.
18+
The `LookUpEditEx` and `RepositoryItemLookUpEditEx` classes implement a control for this Property Editor. The control extends the [LookUpEdit](https://docs.devexpress.com/WindowsForms/DevExpress.XtraEditors.LookUpEdit) class with additional features.
2419

25-
## Additional Information
26-
27-
1. From this example, you need use only one assembly (the _WinSolution_ from the example is just a demo application, and it has no relation to the solution): `Editors.Win.dll`.
28-
29-
Since this is a regular XAF module, you should add this module to your application to be able to use its features. In case of standard modules, you add them from the Toolbox via the Application or Module designer. Since we deal with a custom module, you should add this into the Toolbox manually. For additional information, refer to the following article: [To add a tool to the toolbox](https://learn.microsoft.com/en-us/visualstudio/modeling/customizing-tools-and-the-toolbox?view=vs-2022#to-add-a-tool-to-the-toolbox).
30-
31-
Alternatively, you can take the source code and include it in your solution.
20+
> **Note**
21+
> To further research how the lookup property editor works, you can look at its source code in the following file:
22+
> _C:\Program Files\DevExpress xx.x\Components\Sources\DevExpress.ExpressApp\DevExpress.ExpressApp.Win\Editors\LookupPropertyEditor.cs_
3223
33-
2. The `LookupPropertyEditorEx` is set as default for all lookup properties in the application.
34-
35-
If you want to change this, then invoke the Model Editor for the Windows Forms application project or module, and change the **EditorType** property of the **DetailViewItems** | **PropertyEditors** | **LookupProperty** node. Or change the **PropertyEditorType** property for a class member, List View column or Detail View item nodes individually.
36-
37-
## Files to Review (XPO)
38-
* [LookupPropertyEditorEx.cs](./CS/XPO/Editors.Win/LookupPropertyEditorEx.cs)
39-
* [LookUpEditEx.cs](./CS/XPO/Editors.Win/LookUpEditEx.cs)
40-
* [RepositoryItemLookUpEditEx.cs](./CS/XPO/Editors.Win/RepositoryItemLookUpEditEx.cs)
4124

4225
## Files to Review (EF Core)
4326
* [LookupPropertyEditorEx.cs](./CS/EFCore/Editors.Win/LookupPropertyEditorEx.cs)
4427
* [LookUpEditEx.cs](./CS/EFCore/Editors.Win/LookUpEditEx.cs)
4528
* [RepositoryItemLookUpEditEx.cs](./CS/EFCore/Editors.Win/RepositoryItemLookUpEditEx.cs)
4629

30+
## Files to Review (XPO)
31+
* [LookupPropertyEditorEx.cs](./CS/XPO/Editors.Win/LookupPropertyEditorEx.cs)
32+
* [LookUpEditEx.cs](./CS/XPO/Editors.Win/LookUpEditEx.cs)
33+
* [RepositoryItemLookUpEditEx.cs](./CS/XPO/Editors.Win/RepositoryItemLookUpEditEx.cs)
4734

4835
## Documentation
4936

5037
* [Implement Custom Property Editors](https://documentation.devexpress.com/eXpressAppFramework/113097/Concepts/UI-Construction/View-Items/Implement-Custom-Property-Editors)
51-
* [PropertyEditors.Lookup - How to provide alternative data representations for reference lookup properties (e.g., a simple drop-down box, a complex multi-column grid, or a tree view)](https://www.devexpress.com/Support/Center/Question/Details/S92425/propertyeditors-lookup-how-to-provide-alternative-data-representations-for-reference)
38+
* [Custom Dropdown Editors with Popup Forms](https://docs.devexpress.com/WindowsForms/4716/controls-and-libraries/editors-and-simple-controls/common-editor-features-and-concepts/custom-editors#custom-dropdown-editors-with-popup-forms)
39+
* [IComplexViewItem Interface](https://docs.devexpress.com/eXpressAppFramework/DevExpress.ExpressApp.Editors.IComplexViewItem)
40+
* [IGridInplaceEdit Interface](https://docs.devexpress.com/eXpressAppFramework/DevExpress.ExpressApp.Win.Core.IGridInplaceEdit)
41+
* [LookUpEdit Class](https://docs.devexpress.com/WindowsForms/DevExpress.XtraEditors.LookUpEdit)
42+
* [PropertyEditorAttribute Class](https://docs.devexpress.com/eXpressAppFramework/DevExpress.ExpressApp.Editors.PropertyEditorAttribute)
43+
* [RepositoryItemPopupContainerEdit Class](https://docs.devexpress.com/WindowsForms/DevExpress.XtraEditors.Repository.RepositoryItemPopupContainerEdit)
5244

5345

5446
<!-- feedback -->
55-
## Does this example address your development requirements/objectives?
56-
57-
[<img src="https://www.devexpress.com/support/examples/i/yes-button.svg"/>](https://www.devexpress.com/support/examples/survey.xml?utm_source=github&utm_campaign=xaf-win-custom-lookup-property-editor&~~~was_helpful=yes) [<img src="https://www.devexpress.com/support/examples/i/no-button.svg"/>](https://www.devexpress.com/support/examples/survey.xml?utm_source=github&utm_campaign=xaf-win-custom-lookup-property-editor&~~~was_helpful=no)
58-
47+
## Does this example address your development requirements/objectives?
48+
49+
[<img src="https://www.devexpress.com/support/examples/i/yes-button.svg"/>](https://www.devexpress.com/support/examples/survey.xml?utm_source=github&utm_campaign=xaf-win-custom-lookup-property-editor&~~~was_helpful=yes) [<img src="https://www.devexpress.com/support/examples/i/no-button.svg"/>](https://www.devexpress.com/support/examples/survey.xml?utm_source=github&utm_campaign=xaf-win-custom-lookup-property-editor&~~~was_helpful=no)
50+
5951
(you will be redirected to DevExpress.com to submit your response)
6052
<!-- feedback end -->

0 commit comments

Comments
 (0)