DrawListViewItemEventArgs.DrawText Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Zeichnet den Text des ListViewItem mit seiner aktuellen Vordergrundfarbe und der Standardformatierung.
Überlädt
| DrawText() |
Zeichnet den Text der ListViewItem mit seiner aktuellen Vordergrundfarbe. |
| DrawText(TextFormatFlags) |
Zeichnet den Text des ListViewItem mit seiner aktuellen Vordergrundfarbe und formatiert ihn mit den angegebenen TextFormatFlags-Werten. |
DrawText()
- Quelle:
- DrawListViewItemEventArgs.cs
- Quelle:
- DrawListViewItemEventArgs.cs
- Quelle:
- DrawListViewItemEventArgs.cs
Zeichnet den Text der ListViewItem mit seiner aktuellen Vordergrundfarbe.
public:
void DrawText();public void DrawText ();member this.DrawText : unit -> unitPublic Sub DrawText ()Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die DrawText -Methode in einer Anwendung verwendet wird, die benutzerdefinierte Zeichnung für ein ListView Steuerelement bereitstellt. Im Beispiel zeichnet ein Handler für das ListView.DrawItem Ereignis den Hintergrund für ganze Elemente. In allen Ansichten mit Ausnahme der Detailansicht zeichnet dieser Handler auch den Vordergrundtext. In der Detailansicht wird der Vordergrundtext im ListView.DrawSubItem -Ereignis gezeichnet.
Das vollständige Beispiel finden Sie im DrawListViewItemEventArgs Übersichtsreferenzthema.
// 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
Hinweise
Verwenden Sie diese Methode, um den Elementtext mit den aktuellen Werten der ListViewItem.ForeColor Eigenschaften und ListViewItem.Font zu zeichnen. Der Text wird innerhalb des von der -Eigenschaft angegebenen Bereichs Bounds gezeichnet. Sie können den Text auch manuell zeichnen, indem Sie das Graphics über die Graphics -Eigenschaft abgerufene verwenden.
Die DrawText -Methode ist besonders nützlich, wenn die ListView.View -Eigenschaft auf einen anderen Wert als View.Detailsfestgelegt ist. In der Detailansicht zeichnet diese Methode den Text für , ListViewItemzeichnet jedoch nicht den Text für Unterelemente. Daher ist es in der Detailansicht im Allgemeinen bequemer, den ListView gesamten Text in einem Handler für das ListView.DrawSubItem Ereignis zu zeichnen.
Weitere Informationen
Gilt für:
DrawText(TextFormatFlags)
- Quelle:
- DrawListViewItemEventArgs.cs
- Quelle:
- DrawListViewItemEventArgs.cs
- Quelle:
- DrawListViewItemEventArgs.cs
Zeichnet den Text des ListViewItem mit seiner aktuellen Vordergrundfarbe und formatiert ihn mit den angegebenen TextFormatFlags-Werten.
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)Parameter
- flags
- TextFormatFlags
Eine bitweise Kombination von TextFormatFlags-Werten.
Hinweise
Verwenden Sie diese Methode, um den Elementtext mit den aktuellen Werten der ListViewItem.ForeColor Eigenschaften und ListViewItem.Font zu zeichnen. Mit TextFormatFlags den flags im Parameter angegebenen Werten können Sie Formatierungseigenschaften für die Knotenbezeichnung angeben, z. B. textausrichtung. Der Text wird innerhalb des von der -Eigenschaft angegebenen Bereichs Bounds gezeichnet. Sie können den Text auch manuell zeichnen, indem Sie das Graphics über die Graphics -Eigenschaft abgerufene verwenden.
Die DrawText -Methode ist besonders nützlich, wenn die ListView.View -Eigenschaft auf einen anderen Wert als View.Detailsfestgelegt ist. In der Detailansicht zeichnet diese Methode den Text für , ListViewItemzeichnet jedoch nicht den Text für Unterelemente. Daher ist es in der Detailansicht im Allgemeinen bequemer, den ListView gesamten Text in einem Handler für das ListView.DrawSubItem Ereignis zu zeichnen.
