RepositoryItemTextEdit.AllowNullInput Property
Gets or sets whether end users can reset the editor’s value to null with the keyboard.
Namespace: DevExpress.XtraEditors.Repository
Assembly: DevExpress.XtraEditors.v24.2.dll
NuGet Package: DevExpress.Win.Navigation
#Declaration
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public virtual DefaultBoolean AllowNullInput { get; set; }
#Property Value
Type | Default | Description |
---|---|---|
Default |
Default | A Default |
Available values:
Name | Description | Return Value |
---|---|---|
True | The value is true. |
|
False | The value is false. |
|
Default | The value is specified by a global option or a higher-level object. |
|
#Remarks
If the AllowNullInput
property is set to DefaultBoolean.True, end-users
can reset the editor’s value using the actions shown below.
Editors | Action | Result |
---|---|---|
All editors. | Press | The edit value is set to null (Nothing in Visual Basic). |
Editors with the built-in auto-search functionality (Popup | Clear the text. Note: Set the Repository | The edit value is set to null (Nothing in Visual Basic). |
Look Look | Press The Text | The edit value is set to null (Nothing in Visual Basic). |
If the AllowNullInput property is set to False, these actions are disabled.
The DefaultBoolean.Default value is treated differently for different editors, as covered in the table below:
Editors | Default |
---|---|
Date | True |
Standalone editors | False |
Inplace editors embedded in grid and tree list control cells. | True |
Inplace editors embedded in bars and Ribbon UI. | False |
For the DateEdit control, the AllowNullInput and RepositoryItemDateEdit.ShowClear properties are synchronized. When you set the ShowClear property to true, the AllowNullInput property is set to Default, and vice versa. When you set the ShowClear property to false, the AllowNullInput property is set to False, and vice versa.
Note
The Edit
property of the WinAllow
option is enabled and a user presses Ctrl+Del or Ctrl+0.
#Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the AllowNullInput property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.