DataGridViewClipboardCopyMode 列挙体

.NET Framework クラス ライブラリ リファレンス

DataGridViewClipboardCopyMode 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

DataGridView コントロールからクリップボードに内容をコピーするかどうかを示す定数を定義します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Enumeration DataGridViewClipboardCopyMode

Visual Basic (使用法)

Dim instance As DataGridViewClipboardCopyMode

C#

public enum DataGridViewClipboardCopyMode

C++

public enum class DataGridViewClipboardCopyMode

J#

public enum DataGridViewClipboardCopyMode

JScript

public enum DataGridViewClipboardCopyMode

メンバ

	メンバ名	説明
	Disable	クリップボードへのコピーは無効です。
	EnableAlwaysIncludeHeaderText	選択されたセルのテキスト値をクリップボードにコピーできます。選択されたセルを含む行および列のヘッダー テキストも含まれます。
	EnableWithAutoHeaderText	選択されたセルのテキスト値をクリップボードにコピーできます。選択されたセルを含む行または列の行ヘッダーまたは列ヘッダー テキストは、DataGridView.SelectionMode プロパティが RowHeaderSelect または ColumnHeaderSelect に設定されており、1 つ以上のヘッダーが選択されている場合にのみ含まれます。
	EnableWithoutHeaderText	選択されたセルのテキスト値をクリップボードにコピーできます。ヘッダー テキストは含まれません。

解説

この列挙体は、ClipboardCopyMode プロパティで使用され、ユーザーが選択されたセルのテキスト値をクリップボードにコピーできるかどうか、および行ヘッダーと列ヘッダーのテキストを含めるかどうかを示します。

使用例

DataGridView コントロールでコピーを有効にする方法を次のコード例に示します。コード例全体については、「方法 : ユーザーが、Windows フォーム DataGridView コントロールからクリップボードに複数のセルをコピーできるようにする」を参照してください。

Visual Basic

Private Sub Form1_Load(ByVal
 sender As Object, _
    ByVal e As System.EventArgs) Handles
 Me.Load

    ' Initialize the DataGridView control.
    Me.DataGridView1.ColumnCount = 5
    Me.DataGridView1.Rows.Add(New String()
 {"A", "B", "C",
 "D", "E"})
    Me.DataGridView1.Rows.Add(New String()
 {"F", "G", "H",
 "I", "J"})
    Me.DataGridView1.Rows.Add(New String()
 {"K", "L", "M",
 "N", "O"})
    Me.DataGridView1.Rows.Add(New String()
 {"P", "Q", "R",
 "S", "T"})
    Me.DataGridView1.Rows.Add(New String()
 {"U", "V", "W",
 "X", "Y"})
    Me.DataGridView1.AutoResizeColumns()
    Me.DataGridView1.ClipboardCopyMode = _
        DataGridViewClipboardCopyMode.EnableWithoutHeaderText

End Sub

Private Sub PasteButton_Click(ByVal
 sender As Object, _
    ByVal e As System.EventArgs) Handles
 PasteButton.Click

    If Me.DataGridView1.GetCellCount( _
        DataGridViewElementStates.Selected) > 0 Then

        Try

            ' Add the selection to the clipboard.
            Clipboard.SetDataObject( _
                Me.DataGridView1.GetClipboardContent())

            ' Replace the text box contents with the clipboard text.
            Me.TextBox1.Text = Clipboard.GetText()

        Catch ex As System.Runtime.InteropServices.ExternalException
            Me.TextBox1.Text = _
                "The Clipboard could not be accessed. Please try
 again."
        End Try

    End If

End Sub

C#

private void Form1_Load(object sender, System.EventArgs
 e)
{
    // Initialize the DataGridView control.
    this.DataGridView1.ColumnCount = 5;
    this.DataGridView1.Rows.Add(new string[]
 { "A", "B", "C", "D", "E" });
    this.DataGridView1.Rows.Add(new string[]
 { "F", "G", "H", "I", "J" });
    this.DataGridView1.Rows.Add(new string[]
 { "K", "L", "M", "N", "O" });
    this.DataGridView1.Rows.Add(new string[]
 { "P", "Q", "R", "S", "T" });
    this.DataGridView1.Rows.Add(new string[]
 { "U", "V", "W", "X", "Y" });
    this.DataGridView1.AutoResizeColumns();
    this.DataGridView1.ClipboardCopyMode = 
        DataGridViewClipboardCopyMode.EnableWithoutHeaderText;
}

private void PasteButton_Click(object sender,
 System.EventArgs e)
{
    if (this.DataGridView1
        .GetCellCount(DataGridViewElementStates.Selected) > 0)
    {
        try
        {
            // Add the selection to the clipboard.
            Clipboard.SetDataObject(
                this.DataGridView1.GetClipboardContent());
            
            // Replace the text box contents with the clipboard text.
            this.TextBox1.Text = Clipboard.GetText();
        }
        catch (System.Runtime.InteropServices.ExternalException)
        {
            this.TextBox1.Text = 
                "The Clipboard could not be accessed. Please try
 again.";
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Windows.Forms 名前空間
Clipboard クラス
DataGridView クラス
DataGridView.ClipboardCopyMode プロパティ