DrawListViewItemEventArgs.Item Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene l'oggetto ListViewItem da disegnare.
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
Valore della proprietà
Classe ListViewItem da disegnare.
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare la Item proprietà in un'applicazione che fornisce disegno personalizzato per un ListView controllo . Nell'esempio, un gestore per l'evento ListView.DrawItem disegna lo sfondo per interi elementi. In tutte le visualizzazioni, ad eccezione della visualizzazione dettagli, questo gestore disegna anche il testo in primo piano. Nella visualizzazione dei dettagli il testo in primo piano viene disegnato nell'evento ListView.DrawSubItem .
Per l'esempio completo, vedere l'argomento di DrawListViewItemEventArgs riferimento di panoramica.
// 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
Commenti
Utilizzare questa proprietà per accedere all'oggetto ListViewItem da disegnare. Ciò è utile quando la State proprietà non fornisce informazioni adeguate per soddisfare le proprie esigenze. La State proprietà fornisce solo informazioni sullo stato di base che è possibile utilizzare, ad esempio, per determinare se un elemento è selezionato, selezionato o attivo. La Item proprietà, invece, consente di accedere a tutti i membri di ListViewItem. È necessario accedere direttamente all'elemento, ad esempio per disegnare manualmente il ListViewItem.Text valore anziché usare il DrawText metodo .