DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) Method

定義

Clipboard にコピーするセルの書式指定済みの値を取得します。Retrieves the formatted value of the cell to copy to the 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 Int32 Int32 Int32

セルを含む行の、0 から始まるインデックス番号。The zero-based index of the row containing the cell.

firstCell
Boolean Boolean Boolean Boolean

選択したセルによって定義される領域の最初の列にセルがある場合は true。それ以外の場合は falsetrue to indicate that the cell is in the first column of the region defined by the selected cells; otherwise, false.

lastCell
Boolean Boolean Boolean Boolean

選択したセルによって定義される領域の最後の列にセルがある場合は true。それ以外の場合は falsetrue to indicate that the cell is the last column of the region defined by the selected cells; otherwise, false.

inFirstRow
Boolean Boolean Boolean Boolean

選択したセルによって定義される領域の最初の行にセルがある場合は true。それ以外の場合は falsetrue to indicate that the cell is in the first row of the region defined by the selected cells; otherwise, false.

inLastRow
Boolean Boolean Boolean Boolean

選択したセルによって定義される領域の最後の行にセルがある場合は true。それ以外の場合は falsetrue to indicate that the cell is in the last row of the region defined by the selected cells; otherwise, false.

format
String String String String

セルの現在の書式指定文字列。The current format string of the cell.

戻り値

Object にコピーするセルの値を表す ClipboardAn Object that represents the value of the cell to copy to the Clipboard.

例外

rowIndex が 0 未満か、コントロールに含まれている行数以上です。rowIndex is less than 0 or greater than or equal to the number of rows in the control.

セルの DataGridView プロパティの値が null です。The value of the cell's DataGridView property is null.

- または --or- ColumnIndex が 0 未満です。これは、セルが行ヘッダーのセルであることを示します。ColumnIndex is less than 0, indicating that the cell is a row header cell.

書式指定が失敗し、DataError コントロールの DataGridView イベントのハンドラーが定義されていないか、ハンドラーで ThrowException プロパティが true に設定されました。Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. 通常、例外オブジェクトは型 FormatException にキャストできます。The exception object can typically be cast to type FormatException.

注釈

このメソッドは、セルのDataGridView.GetClipboardContent値を表すクリップボード形式の値を取得するために、メソッドによって呼び出されます。This method is called by the DataGridView.GetClipboardContent method to retrieve a Clipboard-formatted value that represents the cell value.

セル値は、最初にGetEditedFormattedValueメソッドから表示形式で取得されます。The cell value is first retrieved in its display format from the GetEditedFormattedValue method. これにより、 DataGridView.CellFormatting書式設定が失敗した場合DataGridView.DataErrorに、イベントが発生して値とイベントが書式設定されることがあります。This may raise the DataGridView.CellFormatting event to format the value and the DataGridView.DataError event if formatting is unsuccessful.

このメソッドの位置に関連するパラメーターは、 DataGridViewコントロールで選択されているセルによって定義された領域を表すデータのテーブル内のセルの位置を示します。The position-related parameters of this method indicate where this cell is located in the table of data representing the region defined by the selected cells in the DataGridView control. セルの位置によっては、このメソッドから追加の書式設定情報が表示形式のセル値と共に返される場合があります。Depending on the cell's position, additional formatting information may be returned by this method along with the display-formatted cell value. たとえば、行の最初の列のセルの HTML 形式には、行の先頭を示すタグが含まれます。For example, the HTML format for a cell in the first column of a row will include the tag that indicates the beginning of a row.

サポートされているDataFormats.TextクリップボードDataFormats.Html形式にDataFormats.CommaSeparatedValueは、 DataFormats.UnicodeText、、、およびがあります。The supported Clipboard formats include DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, and DataFormats.CommaSeparatedValue.

詳細については、Clipboard クラスを参照してください。For more information, see the Clipboard class.

注意 (継承者)

カスタマイズされたクリップボードの値を提供するには、このメソッドをオーバーライドします。Override this method to provide customized Clipboard values. たとえば、カスタムセル型からの値のコピーをサポートするために、このメソッドをオーバーライドすることができます。For example, you could override this method to support copying values from custom cell types.

適用対象

こちらもご覧ください