DrawListViewItemEventArgs.DrawText メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

現在の前景色と既定の書式を使用して、ListViewItem のテキストを描画します。

オーバーロード

DrawText()

現在の前景色を使用して、ListViewItem のテキストを描画します。
DrawText(TextFormatFlags)

現在の前景色を使用し、指定された ListViewItem 値で書式を設定して、TextFormatFlags のテキストを描画します。

DrawText()

現在の前景色を使用して、ListViewItem のテキストを描画します。

public:
 void DrawText();
public void DrawText ();
member this.DrawText : unit -> unit
Public Sub DrawText ()

例

次のコード例では、コントロールのカスタム描画を DrawText 提供するアプリケーションで メソッドを使用する方法を 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.Font プロパティの現在の値を使用してアイテム テキストを描画するには、このメソッドをListViewItem.ForeColor使用します。 テキストは、 プロパティで指定された領域内に Bounds 描画されます。 プロパティを使用して取得した を使用して、テキストを Graphics 手動で Graphics 描画することもできます。

メソッドはDrawText、 プロパティが 以外View.DetailsのListView.View値に設定されている場合に最も便利です。 詳細ビューでは、このメソッドは のテキストを ListViewItem描画しますが、サブ項目のテキストは描画しません。 したがって、詳細ビューでは、イベントのハンドラーですべてのテキストを ListView 描画する方が一般的に ListView.DrawSubItem 便利です。

こちらもご覧ください

適用対象

DrawText(TextFormatFlags)

現在の前景色を使用し、指定された ListViewItem 値で書式を設定して、TextFormatFlags のテキストを描画します。

public:
 void DrawText(System::Windows::Forms::TextFormatFlags flags);
public void DrawText (System.Windows.Forms.TextFormatFlags flags);
member this.DrawText : System.Windows.Forms.TextFormatFlags -> unit
Public Sub DrawText (flags As TextFormatFlags)

パラメーター

flags
TextFormatFlags

TextFormatFlags 値のビットごとの組み合わせ。

注釈

プロパティと ListViewItem.Font プロパティの現在の値を使用してアイテム テキストを描画するには、このメソッドをListViewItem.ForeColor使用します。 TextFormatFlagsパラメーターで指定した値をflags使用すると、テキストの配置など、ノード ラベルの書式設定プロパティを指定できます。 テキストは、 プロパティで指定された領域内に Bounds 描画されます。 プロパティを使用して取得した を使用して、テキストを Graphics 手動で Graphics 描画することもできます。

メソッドはDrawText、 プロパティが 以外View.DetailsのListView.View値に設定されている場合に最も便利です。 詳細ビューでは、このメソッドは のテキストを ListViewItem描画しますが、サブ項目のテキストは描画しません。 したがって、詳細ビューでは、イベントのハンドラーですべてのテキストを ListView 描画する方が一般的に ListView.DrawSubItem 便利です。

こちらもご覧ください

適用対象