DataGridViewCell.GetClipboardContent Metode

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.

Mengambil nilai sel yang diformat untuk disalin ke Clipboard.

protected:
 virtual System::Object ^ GetClipboardContent(int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, System::String ^ format);

protected virtual object GetClipboardContent (int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format);

protected virtual object? GetClipboardContent (int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format);

abstract member GetClipboardContent : int * bool * bool * bool * bool * string -> obj
override this.GetClipboardContent : int * bool * bool * bool * bool * string -> obj

Protected Overridable Function GetClipboardContent (rowIndex As Integer, firstCell As Boolean, lastCell As Boolean, inFirstRow As Boolean, inLastRow As Boolean, format As String) As Object

Parameter

rowIndex: Int32

Indeks baris berbasis nol yang berisi sel.

firstCell: Boolean

true untuk menunjukkan bahwa sel berada di kolom pertama dari wilayah yang ditentukan oleh sel yang dipilih; jika tidak, false.

lastCell: Boolean

true untuk menunjukkan bahwa sel adalah kolom terakhir dari wilayah yang ditentukan oleh sel yang dipilih; jika tidak, false.

inFirstRow: Boolean

true untuk menunjukkan bahwa sel berada di baris pertama wilayah yang ditentukan oleh sel yang dipilih; jika tidak, false.

inLastRow: Boolean

true untuk menunjukkan bahwa sel berada di baris terakhir wilayah yang ditentukan oleh sel yang dipilih; jika tidak, false.

format: String

String format sel saat ini.

Mengembalikan

Object

Yang Object mewakili nilai sel untuk disalin ke Clipboard.

Pengecualian

ArgumentOutOfRangeException

rowIndex kurang dari 0 atau lebih besar dari atau sama dengan jumlah baris dalam kontrol.

InvalidOperationException

Nilai properti sel DataGridView adalah null.

-atau-

ColumnIndex kurang dari 0, menunjukkan bahwa sel tersebut adalah sel header baris.

Exception

Pemformatan gagal dan tidak ada handler untuk DataError peristiwa kontrol atau handler mengatur properti ke ThrowExceptiontrue.DataGridView Objek pengecualian biasanya dapat dilemparkan ke jenis FormatException.

Keterangan

Metode ini dipanggil oleh DataGridView.GetClipboardContent metode untuk mengambil nilai berformat Clipboard yang mewakili nilai sel.

Nilai sel pertama kali diambil dalam format tampilannya dari GetEditedFormattedValue metode . Ini dapat meningkatkan DataGridView.CellFormatting peristiwa untuk memformat nilai dan DataGridView.DataError peristiwa jika pemformatan tidak berhasil.

Parameter terkait posisi dari metode ini menunjukkan di mana sel ini berada dalam tabel data yang mewakili wilayah yang ditentukan oleh sel yang dipilih dalam DataGridView kontrol. Bergantung pada posisi sel, informasi pemformatan tambahan dapat dikembalikan oleh metode ini bersama dengan nilai sel berformat tampilan. Misalnya, format HTML untuk sel di kolom pertama baris akan menyertakan tag yang menunjukkan awal baris.

Format Clipboard yang didukung meliputi DataFormats.Text, , DataFormats.UnicodeText DataFormats.Html, dan DataFormats.CommaSeparatedValue.

Untuk informasi selengkapnya, lihat Clipboard kelas.

Catatan Bagi Inheritor

Ambil alih metode ini untuk menyediakan nilai Papan Klip yang disesuaikan. Misalnya, Anda dapat mengambil alih metode ini untuk mendukung penyalinan nilai dari jenis sel kustom.

Berlaku untuk

Bagikan melalui