This documentation is archived and is not being maintained.

DrawMode Enumeration

Specifies how the elements of a control are drawn.

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

public enum class DrawMode

Member nameDescription
NormalAll the elements in a control are drawn by the operating system and are of the same size.
OwnerDrawFixedAll the elements in the control are drawn manually and are of the same size.
OwnerDrawVariableAll the elements in the control are drawn manually and can differ in size.

This enumeration is used by members such as DrawMode in the ListBox, CheckedListBox, and ComboBox classes.

You can override the drawing of some controls or certain elements. This enumeration is used to specify if a control is drawn by the operating system or if your own code handles the drawing of the control.

NoteNote

The CheckedListBox class only supports DrawMode::Normal; owner draw modes are ignored.

For more information about using the DrawMode enumeration, see the MeasureItem and DrawItem events, and the ItemHeight property.

The following example demonstrates how to create owner-drawn ListBox items. The code uses the DrawMode property to specify that the items drawn are fixed sized and the DrawItem event to perform the drawing of each item into the ListBox. The example code uses the properties and methods of the DrawItemEventArgs class passed as a parameter to the event handler to draw the items. This example assumes that a ListBox control called listBox1 has been added to a form and that the DrawItem event is handled by the event handler defined in the example code. The example also assumes that items have been added to the ListBox with the text of "Apple", "Orange", and "Plum" in that order.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: