VisualStyleElement.ListView.EmptyText Class


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Provides a VisualStyleElement for the text area of a list view that contains no items. This class cannot be inherited.

Namespace:   System.Windows.Forms.VisualStyles
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)


public static class EmptyText


Gets a visual style element that represents the text area of a list view that contains no items.

The Normal property of the VisualStyleElement.ListView.EmptyText class returns a VisualStyleElement that represents the text area that accompanies an empty list view.


Visual styles are supported only on these platforms.

The following code example demonstrates how to create a VisualStyleRenderer with the VisualStyleElement returned by the Normal property. To run this example, paste it into a Windows Form. Handle the form’s Paint event and call the DrawVisualStyleElementListViewEmptyText1 method from the Paint event-handling method, passing e as PaintEventArgs.

public void DrawVisualStyleElementListViewEmptyText1(PaintEventArgs e)
    if (VisualStyleRenderer.IsElementDefined(
        VisualStyleRenderer renderer =
             new VisualStyleRenderer(VisualStyleElement.ListView.EmptyText.Normal);
        Rectangle rectangle1 = new Rectangle(10, 50, 50, 50);
        renderer.DrawBackground(e.Graphics, rectangle1);
             this.Font, Brushes.Black, new Point(10, 10));
        e.Graphics.DrawString("This element is not defined in the current visual style.",
             this.Font, Brushes.Black, new Point(10, 10));

.NET Framework
Available since 2.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top