DrawListViewItemEventArgs.DrawText Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee tekent u de tekst van het gebruik van de ListViewItem huidige voorgrondkleur en de standaardopmaak.
Overloads
| Name | Description |
|---|---|
| DrawText() |
Hiermee tekent u de tekst van het gebruik van de ListViewItem huidige voorgrondkleur. |
| DrawText(TextFormatFlags) |
Hiermee tekent u de tekst van het gebruik van de ListViewItem huidige voorgrondkleur en maakt u deze op met de opgegeven TextFormatFlags waarden. |
DrawText()
Hiermee tekent u de tekst van het gebruik van de ListViewItem huidige voorgrondkleur.
public:
void DrawText();public void DrawText();member this.DrawText : unit -> unitPublic Sub DrawText ()Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de DrawText methode gebruikt in een toepassing die aangepaste tekening voor een ListView besturingselement biedt. In het voorbeeld tekent een handler voor de ListView.DrawItem gebeurtenis de achtergrond voor hele items. In alle weergaven behalve de detailweergave tekent deze handler ook de voorgrondtekst. In de detailweergave wordt de voorgrondtekst getekend in de ListView.DrawSubItem gebeurtenis.
Zie het overzichtsonderwerp voor het DrawListViewItemEventArgs volledige voorbeeld.
// 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
Opmerkingen
Gebruik deze methode om de itemtekst te tekenen met behulp van de huidige waarden van de ListViewItem.ForeColor en ListViewItem.Font eigenschappen. De tekst wordt getekend binnen het gebied dat door de Bounds eigenschap is opgegeven. U kunt de tekst ook handmatig tekenen met behulp van de Graphics opgehaalde eigenschap Graphics .
De DrawText methode is het handigst wanneer de ListView.View eigenschap is ingesteld op een andere waarde dan View.Details. In de detailweergave tekent deze methode de tekst voor de ListViewItem, maar tekent de tekst niet voor subitems. Daarom is het in de detailweergave over het algemeen handiger om alle ListView tekst in een handler voor de ListView.DrawSubItem gebeurtenis te tekenen.
Zie ook
Van toepassing op
DrawText(TextFormatFlags)
Hiermee tekent u de tekst van het gebruik van de ListViewItem huidige voorgrondkleur en maakt u deze op met de opgegeven TextFormatFlags waarden.
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)Parameters
- flags
- TextFormatFlags
Een bitsgewijze combinatie van TextFormatFlags waarden.
Opmerkingen
Gebruik deze methode om de itemtekst te tekenen met behulp van de huidige waarden van de ListViewItem.ForeColor en ListViewItem.Font eigenschappen. Met de TextFormatFlags waarden die in de flags parameter zijn opgegeven, kunt u opmaakeigenschappen opgeven voor het knooppuntlabel, zoals tekstuitlijning. De tekst wordt getekend binnen het gebied dat door de Bounds eigenschap is opgegeven. U kunt de tekst ook handmatig tekenen met behulp van de Graphics opgehaalde eigenschap Graphics .
De DrawText methode is het handigst wanneer de ListView.View eigenschap is ingesteld op een andere waarde dan View.Details. In de detailweergave tekent deze methode de tekst voor de ListViewItem, maar tekent de tekst niet voor subitems. Daarom is het in de detailweergave over het algemeen handiger om alle ListView tekst in een handler voor de ListView.DrawSubItem gebeurtenis te tekenen.
