DataGridView.ClipboardCopyMode Özellik

  • Başvuru

Tanım

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

Kullanıcıların hücre metni değerlerini öğesine kopyalayıp kopyalayamayacağını ve satır ve sütun başlığı metninin eklenip eklenmeyeceğini Clipboard belirten bir değer alır veya ayarlar.

public:
 property System::Windows::Forms::DataGridViewClipboardCopyMode ClipboardCopyMode { System::Windows::Forms::DataGridViewClipboardCopyMode get(); void set(System::Windows::Forms::DataGridViewClipboardCopyMode value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewClipboardCopyMode ClipboardCopyMode { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.ClipboardCopyMode : System.Windows.Forms.DataGridViewClipboardCopyMode with get, set
Public Property ClipboardCopyMode As DataGridViewClipboardCopyMode

Özellik Değeri

DataGridViewClipboardCopyMode

Değerlerden DataGridViewClipboardCopyMode biri. Varsayılan değer: EnableWithAutoHeaderText.

Öznitelikler
BrowsableAttribute

Özel durumlar

InvalidEnumArgumentException

Bu özellik ayarlanırken belirtilen değer geçerli DataGridViewClipboardCopyMode bir değer değil.

Örnekler

Aşağıdaki kod örneğinde, denetimde kopyalamanın nasıl etkinleştirileceği gösterilmektedir DataGridView . Bu örnek, Nasıl yapılır: Kullanıcıların Windows Forms DataGridView Denetiminden Panoya Birden Çok Hücre Kopyalamasını Etkinleştirme bölümünde bulunan daha büyük bir örneğin parçasıdır.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Initialize the DataGridView control.
    this.DataGridView1.ColumnCount = 5;
    this.DataGridView1.Rows.Add(new string[] { "A", "B", "C", "D", "E" });
    this.DataGridView1.Rows.Add(new string[] { "F", "G", "H", "I", "J" });
    this.DataGridView1.Rows.Add(new string[] { "K", "L", "M", "N", "O" });
    this.DataGridView1.Rows.Add(new string[] { "P", "Q", "R", "S", "T" });
    this.DataGridView1.Rows.Add(new string[] { "U", "V", "W", "X", "Y" });
    this.DataGridView1.AutoResizeColumns();
    this.DataGridView1.ClipboardCopyMode = 
        DataGridViewClipboardCopyMode.EnableWithoutHeaderText;
}

private void CopyPasteButton_Click(object sender, System.EventArgs e)
{
    if (this.DataGridView1
        .GetCellCount(DataGridViewElementStates.Selected) > 0)
    {
        try
        {
            // Add the selection to the clipboard.
            Clipboard.SetDataObject(
                this.DataGridView1.GetClipboardContent());
            
            // Replace the text box contents with the clipboard text.
            this.TextBox1.Text = Clipboard.GetText();
        }
        catch (System.Runtime.InteropServices.ExternalException)
        {
            this.TextBox1.Text = 
                "The Clipboard could not be accessed. Please try again.";
        }
    }
}

Private Sub Form1_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Load

    ' Initialize the DataGridView control.
    Me.DataGridView1.ColumnCount = 5
    Me.DataGridView1.Rows.Add(New String() {"A", "B", "C", "D", "E"})
    Me.DataGridView1.Rows.Add(New String() {"F", "G", "H", "I", "J"})
    Me.DataGridView1.Rows.Add(New String() {"K", "L", "M", "N", "O"})
    Me.DataGridView1.Rows.Add(New String() {"P", "Q", "R", "S", "T"})
    Me.DataGridView1.Rows.Add(New String() {"U", "V", "W", "X", "Y"})
    Me.DataGridView1.AutoResizeColumns()
    Me.DataGridView1.ClipboardCopyMode = _
        DataGridViewClipboardCopyMode.EnableWithoutHeaderText

End Sub

Private Sub CopyPasteButton_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles CopyPasteButton.Click

    If Me.DataGridView1.GetCellCount( _
        DataGridViewElementStates.Selected) > 0 Then

        Try

            ' Add the selection to the clipboard.
            Clipboard.SetDataObject( _
                Me.DataGridView1.GetClipboardContent())

            ' Replace the text box contents with the clipboard text.
            Me.TextBox1.Text = Clipboard.GetText()

        Catch ex As System.Runtime.InteropServices.ExternalException
            Me.TextBox1.Text = _
                "The Clipboard could not be accessed. Please try again."
        End Try

    End If

End Sub

Açıklamalar

Denetim, DataGridView seçilen her hücrenin metin gösterimini Pano'ya kopyalar. Bu değer, bir dizeye dönüştürülen hücre değeridir veya görüntü hücreleri için özelliğinin Description değeridir.

Değerler , , UnicodeTextHtmlve CommaSeparatedValue biçimlerinde TextPano'ya kopyalanır. Bu biçimler Not Defteri, Microsoft Excel ve Microsoft Word gibi uygulamalara içerik yapıştırmak için kullanışlıdır.

Denetim, DataGridView tüm seçili hücreleri içeren en küçük dikdörtgende bulunan hücreleri kopyalar. Seçili hücre içermeyen satırlar ve sütunlar kopyalanan verilerde temsil edilmez. Kalan satır ve sütunlardaki seçilmemiş hücreler boş yer tutucularla temsil edilir. Kopyalama moduna ve seçim moduna bağlı olarak, kopyalanan satır ve sütunların üst bilgi değerleri de kopyalanabilir.

Kullanıcılar içeriği kopyaladığında, DataGridView denetim Pano'ya bir DataObject ekler. Bu veri nesnesi yönteminden GetClipboardContent alınır. Veri nesnesini panoya program aracılığıyla eklemek istediğinizde bu yöntemi çağırabilirsiniz.

yöntemi, GetClipboardContent yöntemini çağırarak DataGridViewCell.GetClipboardContent tek tek hücrelerin değerlerini alır. Kopyalanan hücrelerin düzenini özelleştirmek veya ek veri biçimlerini desteklemek için türetilmiş sınıflarda bu yöntemlerden birini veya her ikisini geçersiz kılabilirsiniz.

Pano işlemleri ve veri biçimleri hakkında daha fazla bilgi için sınıfına Clipboard bakın.

Şunlara uygulanır

Ayrıca bkz.