Skip to main content
A newer version of this page is available. .
Tab

ASPxGridSearchPanelSettings.EditorNullTextDisplayMode Property

Specifies when the null text is visible in the grid’s search panel.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

NuGet Package: DevExpress.Web

Declaration

[DefaultValue(NullTextDisplayMode.Unfocused)]
public NullTextDisplayMode EditorNullTextDisplayMode { get; set; }

Property Value

Type Default Description
NullTextDisplayMode **Unfocused**

The null text display mode.

Available values:

Name Description
Unfocused

The null text is displayed when the editor is unfocused.

UnfocusedAndFocused

The null text is displayed when the editor is focused or unfocused.

Property Paths

You can access this nested property as listed below:

Show 20 property paths
Library Object Type Path to EditorNullTextDisplayMode
ASP.NET Controls and MVC Extensions ASPxCardView
.SettingsSearchPanel .EditorNullTextDisplayMode
ASPxGridView
.SettingsSearchPanel .EditorNullTextDisplayMode
ASPxTreeList
.SettingsSearchPanel .EditorNullTextDisplayMode
ASPxVerticalGrid
.SettingsSearchPanel .EditorNullTextDisplayMode
GridViewProperties
.SettingsSearchPanel .EditorNullTextDisplayMode
ASP.NET Bootstrap Controls BootstrapCardView
.SettingsSearchPanel .EditorNullTextDisplayMode
BootstrapGridView
.SettingsSearchPanel .EditorNullTextDisplayMode
ASP.NET MVC Extensions CardViewSettings
.SettingsSearchPanel .EditorNullTextDisplayMode
CardViewSettings<CardType>
.SettingsSearchPanel .EditorNullTextDisplayMode
GridViewSettings
.SettingsSearchPanel .EditorNullTextDisplayMode
GridViewSettings<RowType>
.SettingsSearchPanel .EditorNullTextDisplayMode
MVCxCardView
.SettingsSearchPanel .EditorNullTextDisplayMode
MVCxGridView
.SettingsSearchPanel .EditorNullTextDisplayMode
MVCxGridViewProperties
.SettingsSearchPanel .EditorNullTextDisplayMode
MVCxTreeList
.SettingsSearchPanel .EditorNullTextDisplayMode
MVCxVerticalGrid
.SettingsSearchPanel .EditorNullTextDisplayMode
TreeListSettings
.SettingsSearchPanel .EditorNullTextDisplayMode
TreeListSettings<RowType>
.SettingsSearchPanel .EditorNullTextDisplayMode
VerticalGridSettings
.SettingsSearchPanel .EditorNullTextDisplayMode
VerticalGridSettings<ColumnType>
.SettingsSearchPanel .EditorNullTextDisplayMode

Remarks

The null text is a prompt text displayed in an editor when it is empty and unfocused. Use the NullTextDisplayMode property to specifies whether the null text is also displayed in the editor when it is focused.

Use the SearchPanelEditorNullText property to specify the editor’s null text.

Example

Web Forms (declaratively):

<dx:ASPxGridView ID="Grid" runat="server" >
    ...
    <SettingsSearchPanel Visible="true" EditorNullTextDisplayMode="UnfocusedAndFocused" />
    <SettingsText SearchPanelEditorNullText="Custom text" />
</dx:ASPxGridView>

Web Forms (in code):

ASPxGridView grid1 = new ASPxGridView();
grid1.ID = "grid1";
Page.Form.Controls.Add(grid1);
...
grid1.SettingsSearchPanel.Visible = true;
grid1.SettingsSearchPanel.EditorNullTextDisplayMode = NullTextDisplayMode.UnfocusedAndFocused;
grid1.SettingsText.SearchPanelEditorNullText="Custom text";

MVC:

@Html.DevExpress().GridView(settings => {
    settings.Name = "grid";
    settings.SettingsSearchPanel.Visible = true;
    settings.SettingsSearchPanel.EditorNullTextDisplayMode = NullTextDisplayMode.UnfocusedAndFocused;
    settings.SettingsText.SearchPanelEditorNullText="Custom text";
    ...
}).Bind(Model).GetHtml()

Concept

GridView:

CardView:

VerticalGrid:

TreeList:

Online Demos

GridView:

CardView:

Vertical Grid:

Tree List:

See Also