DataGridView.GetClipboardContent DataGridView.GetClipboardContent DataGridView.GetClipboardContent DataGridView.GetClipboardContent Method

정의

Clipboard에 복사할 선택된 셀 내용을 나타내는 서식 있는 값을 검색합니다.Retrieves the formatted values that represent the contents of the selected cells for copying to the Clipboard.

public:
 virtual System::Windows::Forms::DataObject ^ GetClipboardContent();
public virtual System.Windows.Forms.DataObject GetClipboardContent ();
abstract member GetClipboardContent : unit -> System.Windows.Forms.DataObject
override this.GetClipboardContent : unit -> System.Windows.Forms.DataObject
Public Overridable Function GetClipboardContent () As DataObject

반환

선택한 셀의 내용을 나타내는 DataObject입니다.A DataObject that represents the contents of the selected cells.

예외

예제

다음 코드 예제에서는 프로그래밍 방식으로 선택한 항목을 추가 하는 방법에 설명 DataGridView 내용을 클립보드에 있습니다.The following code example demonstrates how to programmatically add selected DataGridView content to the Clipboard. 이 예제는 다음 방법에서 사용할 수 있는 더 큰 예제의 일부입니다. 사용자가 Windows Forms DataGridView 컨트롤에서 여러 셀을 클립보드에 복사할 수 있도록 합니다.This example is part of a larger example available in How to: Enable Users to Copy Multiple Cells to the Clipboard from the Windows Forms DataGridView Control.

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 CopyPasteButton_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.";
        }
    }
}
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 CopyPasteButton_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles CopyPasteButton.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

설명

이 메서드는 선택한 셀에서 정의한 영역을 나타내는 데이터를 검색 합니다.This method retrieves data that represents the region defined by the selected cells. 이 지역은 선택한 셀을 모두 포함 하는 가장 작은 사각형입니다.This region is the smallest rectangle that includes all of the selected cells. 이 지역의 선택한 각 셀에 대 한 값이 호출 하 여 검색 되는 DataGridViewCell.GetClipboardContent 메서드.The value for each selected cell in this region is retrieved by calling the DataGridViewCell.GetClipboardContent method. 빈 자리 표시자 값이이 지역에서 선택 되지 않은 셀에 사용 됩니다.Blank placeholder values are used for unselected cells in this region. 이 메서드는 이러한 값에는 DataObject 클립보드에 복사 하기 위한 여러 형식이 포함 됩니다.This method combines these values into a DataObject containing several formats for copying to the clipboard. 지원 되는 클립보드 형식 포함 DataFormats.Text, DataFormats.UnicodeTextDataFormats.Html, 및 DataFormats.CommaSeparatedValue합니다.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. 이 방법은 유용한 예를 들어, 사용자 지정 셀 형식의 값을 복사할 수입니다.This is useful, for example, to support copying values from custom cell types.

적용 대상

추가 정보