DrawListViewItemEventArgs.DrawText Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Desenha o texto do ListViewItem usando a cor de primeiro plano atual e a formatação padrão.
Sobrecargas
| DrawText() |
Desenha o texto do ListViewItem usando a cor de primeiro plano atual. |
| DrawText(TextFormatFlags) |
Desenha o texto do ListViewItem usando a cor de primeiro plano atual e formatando-o com os valores TextFormatFlags especificados. |
DrawText()
Desenha o texto do ListViewItem usando a cor de primeiro plano atual.
public:
void DrawText();public void DrawText ();member this.DrawText : unit -> unitPublic Sub DrawText ()Exemplos
O exemplo de código a seguir demonstra como usar o DrawText método em um aplicativo que fornece desenho personalizado para um ListView controle. No exemplo, um manipulador para o ListView.DrawItem evento desenha a tela de fundo para itens inteiros. Em todos os modos de exibição, exceto no modo de exibição de detalhes, esse manipulador também desenha o texto em primeiro plano. Na exibição de detalhes, o texto em primeiro plano é desenhado no ListView.DrawSubItem evento.
Para obter o exemplo completo, consulte o DrawListViewItemEventArgs tópico de referência de visão geral.
// 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
Comentários
Use esse método para desenhar o texto do item usando os valores atuais das ListViewItem.ForeColor propriedades e ListViewItem.Font . O texto é desenhado dentro da área especificada pela Bounds propriedade . Você também pode desenhar o texto manualmente usando o Graphics recuperado por meio da Graphics propriedade .
O DrawText método é mais útil quando a ListView.View propriedade é definida como um valor diferente de View.Details. Na exibição de detalhes, esse método desenha o texto do ListViewItem, mas não desenha o texto para subitems. Portanto, na exibição de detalhes, geralmente é mais conveniente desenhar todo o ListView texto em um manipulador para o ListView.DrawSubItem evento.
Confira também
Aplica-se a
DrawText(TextFormatFlags)
Desenha o texto do ListViewItem usando a cor de primeiro plano atual e formatando-o com os valores TextFormatFlags especificados.
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)Parâmetros
- flags
- TextFormatFlags
Uma combinação bit a bit dos valores TextFormatFlags.
Comentários
Use esse método para desenhar o texto do item usando os valores atuais das ListViewItem.ForeColor propriedades e ListViewItem.Font . Os TextFormatFlags valores especificados no flags parâmetro permitem que você forneça propriedades de formatação para o rótulo do nó, como alinhamento de texto. O texto é desenhado dentro da área especificada pela Bounds propriedade . Você também pode desenhar o texto manualmente usando o Graphics recuperado por meio da Graphics propriedade .
O DrawText método é mais útil quando a ListView.View propriedade é definida como um valor diferente de View.Details. Na exibição de detalhes, esse método desenha o texto do ListViewItem, mas não desenha o texto para subitems. Portanto, na exibição de detalhes, geralmente é mais conveniente desenhar todo o ListView texto em um manipulador para o ListView.DrawSubItem evento.
