Udostępnij za pośrednictwem


DataGridViewCell.GetClipboardContent Metoda

Definicja

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

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

Wyjątki

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

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.

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

Zobacz też