DrawListViewItemEventArgs.DrawText Метод

Определение

Рисует текст элемента ListViewItem, используя его текущий основной цвет и форматирование по умолчанию.

Перегрузки

DrawText()

Рисует текст элемента ListViewItem, используя его текущий основной цвет.

DrawText(TextFormatFlags)

Рисует текст элемента ListViewItem с использованием его текущего основного цвета и форматирования, заданного значениями TextFormatFlags.

DrawText()

Рисует текст элемента ListViewItem, используя его текущий основной цвет.

public:
 void DrawText();
public void DrawText ();
member this.DrawText : unit -> unit
Public Sub DrawText ()

Примеры

В следующем примере кода показано, как использовать DrawText метод в приложении, которое предоставляет пользовательское рисование ListView для элемента управления . В этом примере обработчик события ListView.DrawItem рисует фон для целых элементов. Во всех представлениях, кроме представления сведений, этот обработчик также рисует текст переднего плана. В представлении сведений текст переднего плана рисуется в событии ListView.DrawSubItem .

Полный пример см. в обзорной справочной DrawListViewItemEventArgs статье.

// Draws the backgrounds for entire ListView items.
private void listView1_DrawItem(object sender,
    DrawListViewItemEventArgs e)
{
    if ((e.State & ListViewItemStates.Selected) != 0)
    {
        // Draw the background and focus rectangle for a selected item.
        e.Graphics.FillRectangle(Brushes.Maroon, e.Bounds);
        e.DrawFocusRectangle();
    }
    else
    {
        // Draw the background for an unselected item.
        using (LinearGradientBrush brush =
            new LinearGradientBrush(e.Bounds, Color.Orange,
            Color.Maroon, LinearGradientMode.Horizontal))
        {
            e.Graphics.FillRectangle(brush, e.Bounds);
        }
    }

    // Draw the item text for views other than the Details view.
    if (listView1.View != View.Details)
    {
        e.DrawText();
    }
}
' Draws the backgrounds for entire ListView items.
Private Sub listView1_DrawItem(ByVal sender As Object, _
    ByVal e As DrawListViewItemEventArgs) _
    Handles listView1.DrawItem

    If Not (e.State And ListViewItemStates.Selected) = 0 Then

        ' Draw the background for a selected item.
        e.Graphics.FillRectangle(Brushes.Maroon, e.Bounds)
        e.DrawFocusRectangle()

    Else

        ' Draw the background for an unselected item.
        Dim brush As New LinearGradientBrush(e.Bounds, Color.Orange, _
            Color.Maroon, LinearGradientMode.Horizontal)
        Try
            e.Graphics.FillRectangle(brush, e.Bounds)
        Finally
            brush.Dispose()
        End Try

    End If

    ' Draw the item text for views other than the Details view.
    If Not Me.listView1.View = View.Details Then
        e.DrawText()
    End If

End Sub

Комментарии

Используйте этот метод для рисования текста элемента с использованием текущих значений ListViewItem.ForeColor свойств и ListViewItem.Font . Текст рисуется в пределах области, указанной свойством Bounds . Вы также можете нарисовать текст вручную с помощью объекта , Graphics полученного Graphics с помощью свойства .

Метод DrawText наиболее полезен, если свойству ListView.View присвоено значение, отличное от View.Details. В представлении сведений этот метод рисует текст для ListViewItem, но не рисует текст для подэлементов. Поэтому в представлении сведений обычно удобнее рисовать весь ListView текст в обработчике ListView.DrawSubItem события.

См. также раздел

Применяется к

DrawText(TextFormatFlags)

Рисует текст элемента ListViewItem с использованием его текущего основного цвета и форматирования, заданного значениями TextFormatFlags.

public:
 void DrawText(System::Windows::Forms::TextFormatFlags flags);
public void DrawText (System.Windows.Forms.TextFormatFlags flags);
member this.DrawText : System.Windows.Forms.TextFormatFlags -> unit
Public Sub DrawText (flags As TextFormatFlags)

Параметры

flags
TextFormatFlags

Побитовое сочетание значений TextFormatFlags.

Комментарии

Используйте этот метод для рисования текста элемента с использованием текущих значений ListViewItem.ForeColor свойств и ListViewItem.Font . Значения TextFormatFlags , указанные в параметре flags , позволяют предоставлять свойства форматирования для метки узла, такие как выравнивание текста. Текст рисуется в пределах области, указанной свойством Bounds . Вы также можете нарисовать текст вручную с помощью объекта , Graphics полученного Graphics с помощью свойства .

Метод DrawText наиболее полезен, если свойству ListView.View присвоено значение, отличное от View.Details. В представлении сведений этот метод рисует текст для ListViewItem, но не рисует текст для подэлементов. Поэтому в представлении сведений обычно удобнее рисовать весь ListView текст в обработчике ListView.DrawSubItem события.

См. также раздел

Применяется к