ListViewItemStates Enum
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.
Definieert constanten die de mogelijke toestanden van een ListViewItem.
Deze opsomming ondersteunt een bitsgewijze combinatie van de waarden van de leden.
public enum class ListViewItemStates
[System.Flags]
public enum ListViewItemStates
[<System.Flags>]
type ListViewItemStates =
Public Enum ListViewItemStates
- Overname
- Kenmerken
Velden
| Name | Waarde | Description |
|---|---|---|
| Selected | 1 | Het item is geselecteerd. |
| Grayed | 2 | Het item is uitgeschakeld. |
| Checked | 8 | Het item is ingeschakeld. |
| Focused | 16 | Het item heeft de focus. |
| Default | 32 | Het item heeft de standaardstatus. |
| Hot | 64 | Het item bevindt zich momenteel onder de muis aanwijzer. |
| Marked | 128 | Het item is gemarkeerd. |
| Indeterminate | 256 | Het item heeft een onbepaalde status. |
| ShowKeyboardCues | 512 | Het item moet een sneltoets aangeven. |
Voorbeelden
In het volgende voorbeeld ziet u hoe u aangepaste tekening voor een ListView besturingselement kunt opgeven. Het ListView besturingselement in het voorbeeld heeft een achtergrond met kleurovergang. Subitems met negatieve waarden hebben een rode voorgrond en een zwarte achtergrond.
Een handler voor de ListView.DrawItem gebeurtenis tekent de achtergrond voor hele items en voor de rij met kolomkoppen. Een handler voor de ListView.DrawSubItem gebeurtenis tekent de tekstwaarden en zowel de tekst als de achtergrond voor subitems met negatieve waarden.
Een ContextMenu onderdeel biedt een manier om te schakelen tussen de detailweergave en de lijst. In de lijstweergave wordt alleen de ListView.DrawItem gebeurtenis geactiveerd. In dit geval worden de tekst en de achtergrond beide getekend in de ListView.DrawItem gebeurtenis-handler.
Zie het naslagonderwerp voor het ListView.OwnerDraw 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
Deze opsomming wordt gebruikt door de DrawListViewItemEventArgs.State en DrawListViewSubItemEventArgs.ItemState eigenschappen. Zie de ListView.DrawItem en ListView.DrawSubItem gebeurtenissen voor meer informatie.