DrawListViewItemEventArgs.DrawFocusRectangle 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

DrawListViewItemEventArgs.cs

如果 ListViewItem 具有焦點 (Focus)，則繪製它的焦點矩形 (Focus Rectangle)。

public:
 void DrawFocusRectangle();

public void DrawFocusRectangle ();

member this.DrawFocusRectangle : unit -> unit

Public Sub DrawFocusRectangle ()

範例

下列程式碼範例示範如何在應用程式中使用 DrawFocusRectangle 方法，為 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

備註

使用此方法可繪製專案周圍的標準焦點矩形。 焦點矩形通常會在 屬性所 Bounds 指定的區域內繪製。 如果控制項位於詳細資料檢視中 ListView.FullRowSelect ，而屬性值為 false ，但是焦點矩形會繪製在專案第一欄的預設文字區域周圍。

只有在專案有焦點時，才會繪製焦點矩形，因此您不需要在呼叫此方法之前檢查項目的焦點狀態。

另請參閱

• Bounds
• ListView
• DrawItem
• ListViewItem