RepositoryItemTextEdit.ShowNullValuePromptWhenFocused Property
Gets or sets whether the focused editor displays a prompt when its value is not specified.
Namespace: DevExpress.XtraEditors.Repository
Assembly: DevExpress.XtraEditors.v24.2.dll
NuGet Package: DevExpress.Win.Navigation
#Declaration
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public bool ShowNullValuePromptWhenFocused { get; set; }
#Property Value
Type | Default | Description |
---|---|---|
Boolean | false | true if the focused editor displays a prompt when its value is not specified; otherwise, false. |
#Remarks
The editor can display a prompt when its value is not specified. Use the NullValuePrompt property to specify the prompt.
The ShowNullValuePrompt property provides access to the following flags that specify when the prompt is shown:
- EmptyValue — the prompt is displayed when the editor’s value equals String.Empty or null (Nothing in VB). Disable this option to only display the prompt when the editor’s value equals null (Nothing in VB).
- EditorReadOnly — the prompt is displayed when the editor is in the read-only and editable states. Disable this option to only display the prompt when the editor is editable.
- EditorFocused — the prompt is displayed when the editor is focused and not focused. Disable this option to only display the prompt when the editor is not focused.
The prompt disappears when the user clicks the focused editor or starts to enter a value. The prompt does not appear again if the user clears the entered value.
You can specify the flags in the Properties window.
The snippet below shows how to specify the flags in code.
textEdit1.Properties.ShowNullValuePrompt =
ShowNullValuePromptOptions.EditorFocused | ShowNullValuePromptOptions.EmptyValue;
Note
Since version 19.
See Version Compatibility: Default Property Values for more information about changes introduced in specific versions.