Aracılığıyla paylaş

DrawListViewItemEventArgs.DrawText Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Geçerli ön plan rengini ve varsayılan biçimlendirmesini kullanarak metnini ListViewItem çizer.

Aşırı Yüklemeler

DrawText()

geçerli ön plan rengini kullanarak metnini ListViewItem çizer.
DrawText(TextFormatFlags)

geçerli ön plan rengini kullanarak metnini ListViewItem çizer ve belirtilen TextFormatFlags değerlerle biçimlendirer.

DrawText()

geçerli ön plan rengini kullanarak metnini ListViewItem çizer.

public:
 void DrawText();
public void DrawText ();
member this.DrawText : unit -> unit
Public Sub DrawText ()

Örnekler

Aşağıdaki kod örneği, bir denetim için ListView özel çizim sağlayan bir uygulamada yönteminin nasıl kullanılacağını DrawText gösterir. Örnekte, olay işleyicisi ListView.DrawItem tüm öğelerin arka planını çizer. Ayrıntılar görünümü dışındaki tüm görünümlerde, bu işleyici ön plan metnini de çizer. Ayrıntılar görünümünde, olayda ListView.DrawSubItem ön plan metni çizilir.

Tam örnek için genel bakış başvuru konusuna DrawListViewItemEventArgs bakın.

// 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

Açıklamalar

ve ListViewItem.Font özelliklerinin geçerli değerlerini ListViewItem.ForeColor kullanarak öğe metnini çizmek için bu yöntemi kullanın. Metin, özelliği tarafından Bounds belirtilen alanın içine çizilir. Ayrıca özelliği aracılığıyla Graphics alınan öğesini Graphics kullanarak metni el ile çizebilirsiniz.

DrawText yöntemi en çok özelliği dışında View.Detailsbir değere ayarlandığında kullanışlıdırListView.View. Ayrıntılar görünümünde, bu yöntem için ListViewItemmetin çizer, ancak alt öğeleri için metin çizmez. Bu nedenle ayrıntılar görünümünde genellikle olayın işleyicisindeki ListView.DrawSubItem tüm metinleri ListView çizmek daha uygundur.

Ayrıca bkz.

Şunlara uygulanır

DrawText(TextFormatFlags)

geçerli ön plan rengini kullanarak metnini ListViewItem çizer ve belirtilen TextFormatFlags değerlerle biçimlendirer.

public:
 void DrawText(System::Windows::Forms::TextFormatFlags flags);
public void DrawText (System.Windows.Forms.TextFormatFlags flags);
member this.DrawText : System.Windows.Forms.TextFormatFlags -> unit
Public Sub DrawText (flags As TextFormatFlags)

Parametreler

flags
TextFormatFlags

Değerlerin bit düzeyinde birleşimi TextFormatFlags .

Açıklamalar

ve ListViewItem.Font özelliklerinin geçerli değerlerini ListViewItem.ForeColor kullanarak öğe metnini çizmek için bu yöntemi kullanın. TextFormatFlags parametresinde flags belirtilen değerler, düğüm etiketi için metin hizalama gibi biçimlendirme özellikleri sağlamanıza olanak sağlar. Metin, özelliği tarafından Bounds belirtilen alanın içine çizilir. Ayrıca özelliği aracılığıyla Graphics alınan öğesini Graphics kullanarak metni el ile çizebilirsiniz.

DrawText yöntemi en çok özelliği dışında View.Detailsbir değere ayarlandığında kullanışlıdırListView.View. Ayrıntılar görünümünde, bu yöntem için ListViewItemmetin çizer, ancak alt öğeleri için metin çizmez. Bu nedenle ayrıntılar görünümünde genellikle olayın işleyicisindeki ListView.DrawSubItem tüm metinleri ListView çizmek daha uygundur.

Ayrıca bkz.

Şunlara uygulanır