DrawListViewItemEventArgs.DrawText Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ritar texten i ListViewItem med den aktuella förgrundsfärgen och standardformateringen.
Överlagringar
| Name | Description |
|---|---|
| DrawText() |
Ritar texten i ListViewItem med den aktuella förgrundsfärgen. |
| DrawText(TextFormatFlags) |
Ritar texten i ListViewItem med den aktuella förgrundsfärgen och formaterar den med de angivna TextFormatFlags värdena. |
DrawText()
Ritar texten i ListViewItem med den aktuella förgrundsfärgen.
public:
void DrawText();public void DrawText();member this.DrawText : unit -> unitPublic Sub DrawText ()Exempel
Följande kodexempel visar hur du använder DrawText metoden i ett program som tillhandahåller anpassad ritning för en ListView kontroll. I exemplet ritar en hanterare för ListView.DrawItem händelsen bakgrunden för hela objekt. I alla vyer utom informationsvyn ritar den här hanteraren även förgrundstexten. I informationsvyn ritas förgrundstexten ListView.DrawSubItem i händelsen.
Det fullständiga exemplet finns i översiktsreferensavsnittet 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
Kommentarer
Använd den här metoden för att rita objekttexten med hjälp av de aktuella värdena för ListViewItem.ForeColor egenskaperna och ListViewItem.Font . Texten ritas inom det område som anges av egenskapen Bounds . Du kan också rita texten manuellt med hjälp av den Graphics som hämtats via egenskapen Graphics .
Metoden DrawText är mest användbar när egenskapen är inställd på ListView.View ett annat värde än View.Details. I informationsvyn ritar den här metoden texten för ListViewItem, men ritar inte texten för underwebbplatser. I informationsvyn är det därför i allmänhet enklare att rita all ListView text i en hanterare för ListView.DrawSubItem händelsen.
Se även
Gäller för
DrawText(TextFormatFlags)
Ritar texten i ListViewItem med den aktuella förgrundsfärgen och formaterar den med de angivna TextFormatFlags värdena.
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)Parametrar
- flags
- TextFormatFlags
En bitvis kombination av TextFormatFlags värden.
Kommentarer
Använd den här metoden för att rita objekttexten med hjälp av de aktuella värdena för ListViewItem.ForeColor egenskaperna och ListViewItem.Font . Med TextFormatFlags de värden som anges i parametern flags kan du ange formateringsegenskaper för nodetiketten, till exempel textjustering. Texten ritas inom det område som anges av egenskapen Bounds . Du kan också rita texten manuellt med hjälp av den Graphics som hämtats via egenskapen Graphics .
Metoden DrawText är mest användbar när egenskapen är inställd på ListView.View ett annat värde än View.Details. I informationsvyn ritar den här metoden texten för ListViewItem, men ritar inte texten för underwebbplatser. I informationsvyn är det därför i allmänhet enklare att rita all ListView text i en hanterare för ListView.DrawSubItem händelsen.
