DrawListViewItemEventArgs.Item Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe o ListViewItem para sacar.
public:
property System::Windows::Forms::ListViewItem ^ Item { System::Windows::Forms::ListViewItem ^ get(); };
public System.Windows.Forms.ListViewItem Item { get; }
member this.Item : System.Windows.Forms.ListViewItem
Public ReadOnly Property Item As ListViewItem
Valor de Propriedade
O ListViewItem desenho.
Exemplos
O exemplo de código seguinte demonstra como usar a Item propriedade numa aplicação que fornece desenho personalizado para um ListView controlo. No exemplo, um handler do ListView.DrawItem evento desenha o fundo de itens inteiros. Em todas as vistas, exceto na visão de detalhes, este manipulador também desenha o texto em primeiro plano. Na vista de detalhes, o texto em primeiro plano é desenhado no ListView.DrawSubItem evento.
Para o exemplo completo, consulte o DrawListViewItemEventArgs tópico de referência de visão geral.
// 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
Observações
Use esta propriedade para aceder ao ListViewItem para sortear. Isto é útil quando a State propriedade não fornece informação adequada para satisfazer as suas necessidades. A State propriedade fornece apenas informações básicas de estado que pode usar, por exemplo, para determinar se um item está selecionado, verificado ou focado. A Item propriedade, por outro lado, permite-lhe aceder a todos os membros do ListViewItem. Deve aceder diretamente ao item, por exemplo, para obter o ListViewItem.Text valor por si próprio em vez de usar o DrawText método.