DrawListViewItemEventArgs.Item 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得要繪製的 ListViewItem。
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 ListViewItem屬性值
要繪製的 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();
}
}
' 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
備註
使用這個屬性來存取 ListViewItem 要繪製的 。 當 屬性未提供足夠的資訊以符合您的需求時 State ，這非常有用。 屬性 State 只提供基本狀態資訊，例如，用來判斷專案是否已選取、核取或聚焦。 另一方面，屬性 Item 可讓您存取 的所有成員 ListViewItem 。 例如，您必須直接存取專案，以自行繪製 ListViewItem.Text 值，而不是使用 DrawText 方法。
