DrawListViewItemEventArgs.DrawText メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の前景色と既定の書式を使用して、ListViewItem のテキストを描画します。
オーバーロード
| DrawText() |
現在の前景色を使用して、ListViewItem のテキストを描画します。 |
| DrawText(TextFormatFlags) |
現在の前景色を使用し、指定された ListViewItem 値で書式を設定して、TextFormatFlags のテキストを描画します。 |
DrawText()
現在の前景色を使用して、ListViewItem のテキストを描画します。
public:
void DrawText();public void DrawText ();member this.DrawText : unit -> unitPublic 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 -> unitPublic 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 便利です。
こちらもご覧ください
適用対象
.NET