Прочитать на английском

Поделиться через


DrawListViewItemEventArgs.Item Свойство

Определение

Получает панель ListViewItem, которая будет нарисована.

public System.Windows.Forms.ListViewItem Item { get; }

Значение свойства

Изображение ListViewItem для отрисовки.

Примеры

В следующем примере кода показано, как использовать Item свойство в приложении, которое предоставляет пользовательское рисование 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();
    }
}

Комментарии

Используйте это свойство для доступа к объекту для рисования ListViewItem . Это полезно, если State свойство не предоставляет достаточной информации для удовлетворения ваших потребностей. Свойство State предоставляет только основные сведения о состоянии, которые можно использовать, например, чтобы определить, выбран ли элемент, установлен ли он или сфокусирован. Свойство Item , с другой стороны, позволяет получить доступ ко всем членам ListViewItem. Например, необходимо получить доступ к элементу напрямую, чтобы нарисовать ListViewItem.Text значение самостоятельно, а не с помощью DrawText метода .

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

Продукт Версии
.NET Framework 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

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