DataGridView.ClipboardCopyMode DataGridView.ClipboardCopyMode DataGridView.ClipboardCopyMode DataGridView.ClipboardCopyMode Property

정의

사용자가 셀 텍스트 값을 Clipboard에 복사할 수 있는지 여부와 행 및 열 머리글 텍스트가 포함되어 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether users can copy cell text values to the Clipboard and whether row and column header text is included.

public:
 property System::Windows::Forms::DataGridViewClipboardCopyMode ClipboardCopyMode { System::Windows::Forms::DataGridViewClipboardCopyMode get(); void set(System::Windows::Forms::DataGridViewClipboardCopyMode value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewClipboardCopyMode ClipboardCopyMode { get; set; }
member this.ClipboardCopyMode : System.Windows.Forms.DataGridViewClipboardCopyMode with get, set
Public Property ClipboardCopyMode As DataGridViewClipboardCopyMode

속성 값

예외

이 속성을 설정할 때 지정된 값이 유효한 DataGridViewClipboardCopyMode 값이 아닙니다.The specified value when setting this property is not a valid DataGridViewClipboardCopyMode value.

예제

다음 코드 예제에서 복사를 사용 하도록 설정 하는 방법에 설명 합니다 DataGridView 제어 합니다.The following code example demonstrates how to enable copying in the DataGridView control. 이 예제는 다음 방법에서 사용할 수 있는 더 큰 예제의 일부입니다. 사용자가 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

설명

DataGridView 컨트롤 선택한 각 셀의 텍스트 표현을 클립보드에 복사 합니다.The DataGridView control copies the text representation of each selected cell to the Clipboard. 이 값은 문자열 또는 이미지 셀의 값을 변환 하는 셀 값을 Description 속성입니다.This value is the cell value converted to a string or, for image cells, the value of the Description property.

값이 클립보드에 복사 됩니다 Text, UnicodeTextHtml, 및 CommaSeparatedValue 형식입니다.Values are copied to the Clipboard in Text, UnicodeText, Html, and CommaSeparatedValue formats. 이러한 형식은 Microsoft Excel에서 메모장과 같은 애플리케이션에 콘텐츠를 붙여 넣을 때 유용 하 고 Microsoft WordMicrosoft Word입니다.These formats are useful for pasting content into applications such as Notepad, Microsoft Excel, and Microsoft WordMicrosoft Word.

DataGridView 컨트롤 선택한 모든 셀을 포함 하는 가장 작은 사각형에 포함 된 셀을 복사 합니다.The DataGridView control copies the cells contained in the smallest rectangle that includes all selected cells. 행 및 열 선택된 된 셀을 포함 하지 않는 복사 된 데이터에 표시 되지 않습니다.Rows and columns that do not contain any selected cells are not represented in the copied data. 나머지 행과 열에서 선택 되지 않은 모든 셀은 빈 자리 표시자로 표시 됩니다.Any unselected cells in the remaining rows and columns are represented by blank placeholders. 복사 모드 및 선택 모드에 따라 복사 되는 행 및 열 머리글 값 수 복사할도 합니다.Depending on the copy mode and the selection mode, header values for the copied rows and columns may be copied, as well.

사용자가 콘텐츠를 복사 하는 경우는 DataGridView 컨트롤은 추가 DataObject 클립보드로 합니다.When users copy content, the DataGridView control adds a DataObject to the Clipboard. 이 데이터 개체에서 검색 되는 GetClipboardContent 메서드.This data object is retrieved from the GetClipboardContent method. 프로그래밍 방식으로 클립보드에 데이터 개체를 추가 하려는 경우이 메서드를 호출할 수 있습니다.You can call this method when you want to programmatically add the data object to the Clipboard.

합니다 GetClipboardContent 메서드를 호출 하 여 개별 셀에 대 한 값을 검색 합니다 DataGridViewCell.GetClipboardContent 메서드.The GetClipboardContent method retrieves values for individual cells by calling the DataGridViewCell.GetClipboardContent method. 추가 데이터 형식을 지원 하기 위해 복사 된 셀의 레이아웃을 사용자 지정 파생된 클래스에서 이러한 메서드 중 하나 또는 모두를 재정의할 수 있습니다.You can override either or both of these methods in derived classes to customize the layout of copied cells or to support additional data formats.

클립보드 작업 및 데이터 형식에 대 한 자세한 내용은 참조는 Clipboard 클래스입니다.For more information about Clipboard operations and data formats, see the Clipboard class.

적용 대상

추가 정보