DataGridView.ClipboardCopyMode Properti

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur nilai yang menunjukkan apakah pengguna dapat menyalin nilai teks sel ke Clipboard dan apakah teks header baris dan kolom disertakan.

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

Nilai Properti

DataGridViewClipboardCopyMode

Salah DataGridViewClipboardCopyMode satu nilai. Default adalah EnableWithAutoHeaderText.

Atribut: BrowsableAttribute

Pengecualian

InvalidEnumArgumentException

Nilai yang ditentukan saat mengatur properti ini bukan nilai yang valid DataGridViewClipboardCopyMode .

Contoh

Contoh kode berikut menunjukkan cara mengaktifkan penyalinan DataGridView dalam kontrol. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia di Cara: Mengaktifkan Pengguna menyalin Beberapa Sel ke Clipboard dari kontrol Formulir Windows DataGridView.

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

Keterangan

Kontrol DataGridView menyalin representasi teks dari setiap sel yang dipilih ke Clipboard. Nilai ini adalah nilai sel yang dikonversi menjadi string atau, untuk sel gambar, nilai Description properti .

Nilai disalin ke Clipboard dalam Textformat , UnicodeText, Html, dan CommaSeparatedValue . Format ini berguna untuk menempelkan konten ke dalam aplikasi seperti Notepad, Microsoft Excel, dan Microsoft Word.

Kontrol DataGridView menyalin sel yang terkandung dalam persegi terkecil yang mencakup semua sel yang dipilih. Baris dan kolom yang tidak berisi sel terpilih tidak diwakili dalam data yang disalin. Sel yang tidak dipilih di baris dan kolom yang tersisa diwakili oleh tempat penampung kosong. Bergantung pada mode salin dan mode pemilihan, nilai header untuk baris dan kolom yang disalin juga dapat disalin.

Saat pengguna menyalin konten, DataGridView kontrol menambahkan DataObject ke Clipboard. Objek data ini diambil dari GetClipboardContent metode . Anda dapat memanggil metode ini ketika Anda ingin menambahkan objek data secara terprogram ke Clipboard.

Metode mengambil GetClipboardContent nilai untuk sel individual dengan memanggil DataGridViewCell.GetClipboardContent metode . Anda dapat mengganti salah satu atau kedua metode ini di kelas turunan untuk menyesuaikan tata letak sel yang disalin atau untuk mendukung format data tambahan.

Untuk informasi selengkapnya tentang operasi Clipboard dan format data, lihat Clipboard kelas .

Berlaku untuk

Bagikan melalui