DataGridViewCell.GetClipboardContent メソッド

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

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);
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

パラメーター

rowIndex
Int32

セルを含む行の 0 から始まるインデックス。

firstCell
Boolean

true セルが選択したセルによって定義された領域の最初の列にあることを示す場合。それ以外の場合は false。

lastCell
Boolean

true セルが選択したセルによって定義された領域の最後の列であることを示す場合。それ以外の場合は false。

inFirstRow
Boolean

true セルが選択したセルによって定義された領域の最初の行にあることを示す場合。それ以外の場合は false。

inLastRow
Boolean

true セルが選択したセルによって定義された領域の最後の行にあることを示す場合。それ以外の場合は false。

format
String

セルの現在の書式指定文字列。

返品

Object

Clipboardにコピーするセルの値を表すObject。

例外

ArgumentOutOfRangeException

rowIndex が 0 未満か、コントロール内の行数以上です。

InvalidOperationException

セルの DataGridView プロパティの値が null。

-または-

ColumnIndex が 0 未満の場合は、セルが行ヘッダー セルであることを示します。

Exception

書式設定に失敗し、DataError コントロールのDataGridView イベントのハンドラーが存在しないか、ハンドラーによって ThrowException プロパティがtrueに設定されました。 例外オブジェクトは通常、 FormatException型にキャストできます。

注釈

このメソッドは、セル値を表すクリップボード形式の値を取得するために、 DataGridView.GetClipboardContent メソッドによって呼び出されます。

セルの値は、最初に GetEditedFormattedValue メソッドから表示形式で取得されます。 これにより、 DataGridView.CellFormatting イベントが発生して値が書式設定され、書式設定が失敗した場合は DataGridView.DataError イベントが発生する可能性があります。

このメソッドの位置関連パラメーターは、このセルが、 DataGridView コントロール内の選択したセルによって定義された領域を表すデータのテーブル内の場所を示します。 セルの位置によっては、表示形式のセル値と共に、このメソッドによって追加の書式設定情報が返される場合があります。 たとえば、行の最初の列のセルの HTML 形式には、行の先頭を示すタグが含まれます。

サポートされているクリップボード形式には、 DataFormats.Text、 DataFormats.UnicodeText、 DataFormats.Html、および DataFormats.CommaSeparatedValueが含まれます。

詳細については、Clipboard クラスを参照してください。

注意 (継承者)

カスタマイズされたクリップボード値を指定するには、このメソッドをオーバーライドします。 たとえば、カスタム セル型からの値のコピーをサポートするには、このメソッドをオーバーライドできます。

適用対象

こちらもご覧ください