DataGridViewCell.GetClipboardContent Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera sformatowaną wartość komórki w celu skopiowania do obiektu 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

Parametry

rowIndex: Int32

Indeks zerowy wiersza zawierającego komórkę.

firstCell: Boolean

true aby wskazać, że komórka znajduje się w pierwszej kolumnie regionu zdefiniowanego przez zaznaczone komórki; w przeciwnym razie , false.

lastCell: Boolean

true aby wskazać, że komórka jest ostatnią kolumną regionu zdefiniowanego przez zaznaczone komórki; w przeciwnym razie , false.

inFirstRow: Boolean

true aby wskazać, że komórka znajduje się w pierwszym wierszu regionu zdefiniowanego przez zaznaczone komórki; w przeciwnym razie , false.

inLastRow: Boolean

true aby wskazać, że komórka znajduje się w ostatnim wierszu regionu zdefiniowanego przez zaznaczone komórki; w przeciwnym razie , false.

format: String

Bieżący ciąg formatu komórki.

Zwraca

Object

Obiekt Object reprezentujący wartość komórki do skopiowania do obiektu Clipboard.

Wyjątki

ArgumentOutOfRangeException

rowIndex jest mniejsza niż 0 lub większa lub równa liczbie wierszy w kontrolce.

InvalidOperationException

Wartość właściwości komórki DataGridView to null.

-lub-

ColumnIndex wartość jest mniejsza niż 0, co oznacza, że komórka jest komórką nagłówka wiersza.

Exception

Formatowanie nie powiodło się i nie ma procedury obsługi dla DataError zdarzenia DataGridView kontrolki lub program obsługi ustawił ThrowException właściwość na true. Obiekt wyjątku może być zwykle rzutowy do typu FormatException.

Uwagi

Ta metoda jest wywoływana DataGridView.GetClipboardContent przez metodę w celu pobrania wartości sformatowanej w Schowku, która reprezentuje wartość komórki.

Wartość komórki jest najpierw pobierana w formacie wyświetlania GetEditedFormattedValue z metody . Może to spowodować zdarzenie DataGridView.CellFormatting sformatowania wartości i DataGridView.DataError zdarzenia, jeśli formatowanie nie powiedzie się.

Parametry związane z pozycją tej metody wskazują, gdzie ta komórka znajduje się w tabeli danych reprezentujących region zdefiniowany przez zaznaczone komórki w kontrolce DataGridView . W zależności od położenia komórki dodatkowe informacje o formatowaniu mogą być zwracane przez tę metodę wraz z wartością komórki sformatowaną w formacie wyświetlania. Na przykład format HTML komórki w pierwszej kolumnie wiersza będzie zawierać tag wskazujący początek wiersza.

Obsługiwane formaty Schowka obejmują DataFormats.Text: , DataFormats.UnicodeText, DataFormats.Htmli DataFormats.CommaSeparatedValue.

Aby uzyskać więcej informacji, zobacz klasę Clipboard .

Uwagi dotyczące dziedziczenia

Zastąpij tę metodę, aby zapewnić dostosowane wartości Schowka. Można na przykład zastąpić tę metodę w celu obsługi kopiowania wartości z niestandardowych typów komórek.

Dotyczy