DrawMode Wyliczenie

Definicja

Określa sposób rysowania elementów kontrolki.

C#
public enum DrawMode
Dziedziczenie
DrawMode

Pola

Nazwa Wartość Opis
Normal 0

Wszystkie elementy w kontrolce są rysowane przez system operacyjny i mają taki sam rozmiar.

OwnerDrawFixed 1

Wszystkie elementy w kontrolce są rysowane ręcznie i mają ten sam rozmiar.

OwnerDrawVariable 2

Wszystkie elementy w kontrolce są rysowane ręcznie i mogą różnić się rozmiarem.

Przykłady

W poniższym przykładzie pokazano, jak utworzyć elementy rysowane ListBox przez właściciela. Kod używa ListBox.DrawMode właściwości , aby określić, że rysowane elementy mają stały rozmiar, a ListBox.DrawItem zdarzenie do wykonania rysunku każdego elementu w ListBoxobiekcie . W przykładzie użyto właściwości i metod klasy przekazanej DrawItemEventArgs jako parametr do procedury obsługi zdarzeń w celu narysowania elementów. W tym przykładzie przyjęto założenie, że kontrolka ListBox o nazwie listBox1 została dodana do formularza i że ListBox.DrawItem zdarzenie jest obsługiwane przez program obsługi zdarzeń zdefiniowany w przykładzie. W przykładzie założono również, że elementy zostały dodane do ListBox elementu z tekstem "Apple", "Orange" i "Plum" w tej kolejności.

C#
private ListBox ListBox1 = new ListBox();
private void InitializeListBox()
{
    ListBox1.Items.AddRange(new Object[] 
        { "Red Item", "Orange Item", "Purple Item" });
    ListBox1.Location = new System.Drawing.Point(81, 69);
    ListBox1.Size = new System.Drawing.Size(120, 95);
    ListBox1.DrawMode = DrawMode.OwnerDrawFixed;
    ListBox1.DrawItem += new DrawItemEventHandler(ListBox1_DrawItem);
    Controls.Add(ListBox1);
}

private void ListBox1_DrawItem(object sender, 
    System.Windows.Forms.DrawItemEventArgs e)
{
    // Draw the background of the ListBox control for each item.
    e.DrawBackground();
    // Define the default color of the brush as black.
    Brush myBrush = Brushes.Black;

    // Determine the color of the brush to draw each item based 
    // on the index of the item to draw.
    switch (e.Index)
    {
        case 0:
            myBrush = Brushes.Red;
            break;
        case 1:
            myBrush = Brushes.Orange;
            break;
        case 2:
            myBrush = Brushes.Purple;
            break;
    }

    // Draw the current item text based on the current Font 
    // and the custom brush settings.
    e.Graphics.DrawString(ListBox1.Items[e.Index].ToString(), 
        e.Font, myBrush, e.Bounds, StringFormat.GenericDefault);
    // If the ListBox has focus, draw a focus rectangle around the selected item.
    e.DrawFocusRectangle();
}

Uwagi

To wyliczenie jest używane przez elementy członkowskie, takie jak DrawMode w ListBoxklasach , CheckedListBoxi ComboBox .

Można zastąpić rysunek niektórych kontrolek lub niektórych elementów. To wyliczenie służy do określania, czy kontrolka jest rysowana przez system operacyjny, czy też własny kod obsługuje rysunek kontrolki.

Uwaga

Klasa CheckedListBox obsługuje Normaltylko tryby ; tryby rysowania właściciela są ignorowane.

Aby uzyskać więcej informacji na temat korzystania z DrawMode wyliczenia, zobacz i MeasureItemDrawItem zdarzenia oraz ItemHeight właściwość .

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Zobacz też