DataGridViewCell.GetClipboardContent Yöntem

Tanım

öğesine kopyalanacak Clipboardhücrenin biçimlendirilmiş değerini alır.

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

Parametreler

rowIndex
Int32

Hücreyi içeren satırın sıfır tabanlı dizini.

firstCell
Boolean

true hücrenin seçilen hücreler tarafından tanımlanan bölgenin ilk sütununda olduğunu belirtmek için; aksi takdirde , false.

lastCell
Boolean

true hücrenin seçilen hücreler tarafından tanımlanan bölgenin son sütunu olduğunu belirtmek için; aksi takdirde , false.

inFirstRow
Boolean

true hücrenin seçilen hücreler tarafından tanımlanan bölgenin ilk satırında olduğunu belirtmek için; aksi takdirde , false.

inLastRow
Boolean

true hücrenin seçilen hücreler tarafından tanımlanan bölgenin son satırında olduğunu belirtmek için; aksi takdirde , false.

format
String

Hücrenin geçerli biçim dizesi.

Döndürülenler

öğesine Object kopyalanacak Clipboardhücrenin değerini temsil eden bir.

Özel durumlar

rowIndex 0'dan küçük veya denetimdeki satır sayısından büyük veya buna eşit.

Hücrenin DataGridView özelliğinin değeri şeklindedir null.

-veya-

ColumnIndex 0'dan küçüktür ve hücrenin bir satır üst bilgi hücresi olduğunu gösterir.

Biçimlendirme başarısız oldu ve denetimin DataErrorDataGridView olayı için işleyici yok veya işleyici özelliğini olarak trueayarladıThrowException. Özel durum nesnesi genellikle türüne FormatExceptionyayınlanabilir.

Açıklamalar

Bu yöntem, hücre değerini temsil eden Pano biçimli bir değeri almak için yöntemi tarafından DataGridView.GetClipboardContent çağrılır.

Hücre değeri ilk olarak yönteminden GetEditedFormattedValue görüntüleme biçiminde alınır. Bu, değeri biçimlendirmek için olayı ve DataGridView.DataError biçimlendirme başarısız olursa olayı tetiklerDataGridView.CellFormatting.

Bu yöntemin konumla ilgili parametreleri, bu hücrenin denetimdeki seçili hücreler DataGridView tarafından tanımlanan bölgeyi temsil eden veri tablosunda nerede bulunduğunu gösterir. Hücrenin konumuna bağlı olarak, bu yöntem tarafından görüntülenen biçimlendirilmiş hücre değeriyle birlikte ek biçimlendirme bilgileri döndürülebilir. Örneğin, satırın ilk sütunundaki bir hücrenin HTML biçimi, satırın başlangıcını gösteren etiketi içerir.

Desteklenen Pano biçimleri , DataFormats.UnicodeText, DataFormats.Htmlve DataFormats.CommaSeparatedValuebiçimlerini içerirDataFormats.Text.

Daha fazla bilgi için sınıfına Clipboard bakın.

Devralanlara Notlar

Özelleştirilmiş Pano değerleri sağlamak için bu yöntemi geçersiz kılın. Örneğin, özel hücre türlerinden değer kopyalamayı desteklemek için bu yöntemi geçersiz kılabilirsiniz.

Şunlara uygulanır

Ayrıca bkz.