DrawListViewItemEventArgs.Item Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Krijgt de ListViewItem te tekenen.
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.ListViewItemPublic ReadOnly Property Item As ListViewItemWaarde van eigenschap
De ListViewItem te tekenen.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de Item eigenschap gebruikt in een toepassing die aangepaste tekening voor een ListView besturingselement biedt. In het voorbeeld tekent een handler voor de ListView.DrawItem gebeurtenis de achtergrond voor hele items. In alle weergaven behalve de detailweergave tekent deze handler ook de voorgrondtekst. In de detailweergave wordt de voorgrondtekst getekend in de ListView.DrawSubItem gebeurtenis.
Zie het overzichtsonderwerp voor het DrawListViewItemEventArgs volledige voorbeeld.
// 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
Opmerkingen
Gebruik deze eigenschap om toegang te krijgen tot de ListViewItem tekening. Dit is handig wanneer de State eigenschap niet voldoende informatie biedt om aan uw behoeften te voldoen. De State eigenschap bevat alleen basisstatusgegevens die u kunt gebruiken, bijvoorbeeld om te bepalen of een item is geselecteerd, ingeschakeld of gericht is. De Item eigenschap daarentegen geeft u toegang tot alle leden van de ListViewItem. U moet het item bijvoorbeeld rechtstreeks openen om de ListViewItem.Text waarde zelf te tekenen in plaats van de DrawText methode te gebruiken.
