Clipboard Clipboard Clipboard Clipboard Class

정의

시스템 클립보드에서 데이터를 배치하고 검색하는 메서드를 제공합니다.Provides methods to place data on and retrieve data from the system Clipboard. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class Clipboard sealed
public sealed class Clipboard
type Clipboard = class
Public NotInheritable Class Clipboard
상속
ClipboardClipboardClipboardClipboard

예제

다음 코드 예제에서는 Clipboard 방법에서 데이터를 배치 하 고 시스템 클립보드에서 검색 합니다.The following code example uses Clipboard methods to place data on and retrieve it from the system Clipboard. 이 코드에서는 가정 button1, button2textBox1, 및 textBox2 만들고 폼에 배치 합니다.This code assumes button1, button2, textBox1, and textBox2 have been created and placed on the form.

합니다 button1_Click 메서드 호출 SetDataObject 텍스트 상자에서 선택한 텍스트를 사용 하 여 시스템 클립보드에 넣습니다.The button1_Click method calls SetDataObject to take selected text from the text box and place it on the system Clipboard.

button2_Click 메서드 호출 GetDataObject 시스템 클립보드에서에서 데이터를 검색 합니다.The button2_Click method calls GetDataObject to retrieve data from the system Clipboard. 코드를 사용 하 여 IDataObject 하 고 DataFormats 반환 되는 데이터를 추출 하에 데이터를 표시 하 고 textBox2입니다.The code uses IDataObject and DataFormats to extract the data returned and displays the data in textBox2.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Takes the selected text from a text box and puts it on the clipboard.
      if ( !textBox1->SelectedText->Equals( "" ) )
      {
         Clipboard::SetDataObject( textBox1->SelectedText );
      }
      else
      {
         textBox2->Text = "No text selected in textBox1";
      }
   }

   void button2_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Declares an IDataObject to hold the data returned from the clipboard.
      // Retrieves the data from the clipboard.
      IDataObject^ iData = Clipboard::GetDataObject();
      
      // Determines whether the data is in a format you can use.
      if ( iData->GetDataPresent( DataFormats::Text ) )
      {
         // Yes it is, so display it in a text box.
         textBox2->Text = (String^)(iData->GetData( DataFormats::Text ));
      }
      else
      {
         // No it is not.
         textBox2->Text = "Could not retrieve data off the clipboard.";
      }
   }
private void button1_Click(object sender, System.EventArgs e) {
    // Takes the selected text from a text box and puts it on the clipboard.
    if(textBox1.SelectedText != "")
       Clipboard.SetDataObject(textBox1.SelectedText);
    else
       textBox2.Text = "No text selected in textBox1";
 }
 
 private void button2_Click(object sender, System.EventArgs e) {
    // Declares an IDataObject to hold the data returned from the clipboard.
    // Retrieves the data from the clipboard.
    IDataObject iData = Clipboard.GetDataObject();
 
    // Determines whether the data is in a format you can use.
    if(iData.GetDataPresent(DataFormats.Text)) {
       // Yes it is, so display it in a text box.
       textBox2.Text = (String)iData.GetData(DataFormats.Text); 
    }
    else {
       // No it is not.
       textBox2.Text = "Could not retrieve data off the clipboard.";
    }
 }
 
Private Sub button1_Click(sender As Object, e As System.EventArgs)
    ' Takes the selected text from a text box and puts it on the clipboard.
    If textBox1.SelectedText <> "" Then
        Clipboard.SetDataObject(textBox1.SelectedText)
    Else
        textBox2.Text = "No text selected in textBox1"
    End If
End Sub
 
Private Sub button2_Click(sender As Object, e As System.EventArgs)
    ' Declares an IDataObject to hold the data returned from the clipboard.
    ' Retrieves the data from the clipboard.
    Dim iData As IDataObject = Clipboard.GetDataObject()
    
    ' Determines whether the data is in a format you can use.
    If iData.GetDataPresent(DataFormats.Text) Then
        ' Yes it is, so display it in a text box.
        textBox2.Text = CType(iData.GetData(DataFormats.Text), String)
    Else
        ' No it is not.
        textBox2.Text = "Could not retrieve data off the clipboard."
    End If
End Sub

설명

사용 하는 미리 정의 된 형식 목록에 대 한 합니다 Clipboard 클래스를 참조 하십시오는 DataFormats 클래스입니다.For a list of predefined formats to use with the Clipboard class, see the DataFormats class.

호출 SetDataObject 현재 내용을 대체를 클립보드에 데이터를 삽입할 합니다.Call SetDataObject to put data on the Clipboard, replacing its current contents. 클립보드에 데이터의 영구 복사본을 배치를 설정 합니다 copy 매개 변수를 true입니다.To place a persistent copy of the data on the Clipboard, set the copy parameter to true.

참고

여러 형식으로 클립보드에 데이터 배치를 사용 합니다 DataObject 클래스 또는 IDataObject 구현 합니다.To place data on the Clipboard in multiple formats, use the DataObject class or an IDataObject implementation. 대상 애플리케이션을 모를 수 있는 형식 요구 사항에서 데이터를 검색할 수는 가능성을 최대화 하기 위해 여러 형식으로 클립보드에 데이터를 배치 합니다.Place data on the Clipboard in multiple formats to maximize the possibility that a target application, whose format requirements you might not know, can successfully retrieve the data.

호출 GetDataObject 클립보드에서 데이터를 검색 합니다.Call GetDataObject to retrieve data from the Clipboard. 구현 하는 개체와 데이터는 IDataObject 인터페이스입니다.The data is returned as an object that implements the IDataObject interface. 지정한 메서드를 사용 하 여 IDataObject 의 필드와 DataFormats 개체에서 데이터를 추출 하 합니다.Use the methods specified by IDataObject and fields in DataFormats to extract the data from the object. 검색 데이터의 형식을 모르는 경우 호출 합니다 GetFormats 메서드는 IDataObject 모든 형식의 목록을 해당 데이터를 가져오려면 인터페이스에 저장 됩니다.If you do not know the format of the data you retrieved, call the GetFormats method of the IDataObject interface to get a list of all formats that data is stored in. 호출을 GetData 메서드는 IDataObject 인터페이스 및 애플리케이션이 사용할 수 있는 형식을 지정 합니다.Then call the GetData method of the IDataObject interface, and specify a format that your application can use.

.NET Framework 2.0.NET Framework 2.0, Clipboard 클래스 쉽게 시스템 클립보드를 사용 하는 추가 메서드를 제공 합니다.In .NET Framework 2.0.NET Framework 2.0, the Clipboard class provides additional methods that make it easier to work with the system Clipboard. 호출 된 Clear 클립보드에서 모든 데이터를 제거 하는 방법입니다.Call the Clear method to remove all data from the Clipboard. 특정 형식의 데이터를 클립보드에 추가할 기존 데이터를 바꾸는 호출 합니다 Set 형식을 메서드를 같은 SetText, 호출 또는 SetData 형식을 지정 하는 방법입니다.To add data of a particular format to the Clipboard, replacing the existing data, call the appropriate SetFormat method, such as SetText, or call the SetData method to specify the format. 특정 형식의 데이터를 클립보드에서 검색 하려면 먼저 호출 합니다 Contains 형식을 메서드 (같은 ContainsText) 클립보드의 데이터에 포함 되는지 여부를 확인 하려면 서식을 지정 하 고 호출 하는 메서드를 적절 한 Get 형식을 메서드 (같은 GetText) 클립보드 포함 하는 경우 데이터를 검색 하려면.To retrieve data of a particular format from the Clipboard, first call the appropriate ContainsFormat method (such as ContainsText) method to determine whether the Clipboard contains data in that format, and then call the appropriate GetFormat method (such as GetText) to retrieve the data if the Clipboard contains it. 이러한 작업의 형식을 지정을 호출 합니다 ContainsDataGetData 메서드 대신 합니다.To specify the format in these operations, call the ContainsData and GetData methods instead.

참고

모든 Windows 기반 애플리케이션 다른 애플리케이션으로 전환 하는 경우 해당 내용이 변경 될 수 있으므로 시스템 클립보드를 공유 합니다.All Windows-based applications share the system Clipboard, so the contents are subject to change when you switch to another application.

개체를 클립보드에 배치할 수 있도록 serializable 이어야 합니다.An object must be serializable for it to be put on the Clipboard. 클립보드 메서드에 순차 불가능 한 개체를 전달 하는 경우 메서드가 예외를 throw 하지 않고 실패 합니다.If you pass a non-serializable object to a Clipboard method, the method will fail without throwing an exception. 참조 System.Runtime.Serialization serialization에 대 한 자세한 내용은 합니다.See System.Runtime.Serialization for more information on serialization. 대상 애플리케이션 특정 데이터 형식에 필요한 경우 데이터 serialization 프로세스에 추가 된 헤더에는 애플리케이션에서 데이터를 인식 하지 못할 수 있습니다.If your target application requires a very specific data format, the headers added to the data in the serialization process may prevent the application from recognizing your data. 를 유지 하기 위해 데이터 형식으로 데이터를 추가 Byte 배열을 MemoryStream 전달를 MemoryStreamSetData 메서드.To preserve your data format, add your data as a Byte array to a MemoryStream and pass the MemoryStream to the SetData method.

Clipboard 단일 스레드 아파트 (STA) 모드를 설정 하는 스레드의 클래스 에서만 사용할 수 있습니다.The Clipboard class can only be used in threads set to single thread apartment (STA) mode. 이 클래스를 사용 하려면 프로그램 Main 표시 된 메서드가 STAThreadAttribute 특성입니다.To use this class, ensure that your Main method is marked with the STAThreadAttribute attribute.

클립보드를 사용 하 여 메타 파일 형식을 사용 하는 경우에 특별 한 고려 사항 할 수 있습니다.Special considerations may be necessary when using the metafile format with the Clipboard. 현재 구현에서 제한으로 인해는 DataObject 이전 메타 파일 형식을 사용 하는 애플리케이션에서 클래스를 사용 하는.NET Framework 메타 파일 형식을 인식할 수 없습니다.Due to a limitation in the current implementation of the DataObject class, the metafile format used by the .NET Framework may not be recognized by applications that use an older metafile format. 이 경우에 Win32 클립보드 Api (애플리케이션 프로그래밍 인터페이스)를 사용 하 여 상호 운용 해야 합니다.In this case, you must interoperate with the Win32 Clipboard application programming interfaces (APIs).

메서드

Clear() Clear() Clear() Clear()

클립보드에서 데이터를 모두 제거합니다.Removes all data from the Clipboard.

ContainsAudio() ContainsAudio() ContainsAudio() ContainsAudio()

WaveAudio 형식의 데이터가 클립보드에 있는지 여부를 나타냅니다.Indicates whether there is data on the Clipboard in the WaveAudio format.

ContainsData(String) ContainsData(String) ContainsData(String) ContainsData(String)

지정된 형식으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 클립보드에 있는지 여부를 나타냅니다.Indicates whether there is data on the Clipboard that is in the specified format or can be converted to that format.

ContainsFileDropList() ContainsFileDropList() ContainsFileDropList() ContainsFileDropList()

FileDrop 형식으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 클립보드에 있는지 여부를 나타냅니다.Indicates whether there is data on the Clipboard that is in the FileDrop format or can be converted to that format.

ContainsImage() ContainsImage() ContainsImage() ContainsImage()

Bitmap 형식으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 클립보드에 있는지 여부를 나타냅니다.Indicates whether there is data on the Clipboard that is in the Bitmap format or can be converted to that format.

ContainsText() ContainsText() ContainsText() ContainsText()

운영 체제에 따라 Text 또는 UnicodeText 형식의 데이터가 클립보드에 있는지 여부를 나타냅니다.Indicates whether there is data on the Clipboard in the Text or UnicodeText format, depending on the operating system.

ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat)

지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터가 클립보드에 있는지 여부를 나타냅니다.Indicates whether there is text data on the Clipboard in the format indicated by the specified TextDataFormat value.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAudioStream() GetAudioStream() GetAudioStream() GetAudioStream()

클립보드에서 오디오 스트림을 검색합니다.Retrieves an audio stream from the Clipboard.

GetData(String) GetData(String) GetData(String) GetData(String)

클립보드에서 지정된 형식의 데이터를 검색합니다.Retrieves data from the Clipboard in the specified format.

GetDataObject() GetDataObject() GetDataObject() GetDataObject()

현재 시스템 클립보드에 있는 데이터를 검색합니다.Retrieves the data that is currently on the system Clipboard.

GetFileDropList() GetFileDropList() GetFileDropList() GetFileDropList()

클립보드에서 파일 이름의 컬렉션을 검색합니다.Retrieves a collection of file names from the Clipboard.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetImage() GetImage() GetImage() GetImage()

클립보드에서 이미지를 검색합니다.Retrieves an image from the Clipboard.

GetText() GetText() GetText() GetText()

운영 체제에 따라 Text 또는 UnicodeText 형식의 텍스트 데이터를 클립보드에서 검색합니다.Retrieves text data from the Clipboard in the Text or UnicodeText format, depending on the operating system.

GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat)

지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터를 클립보드에서 검색합니다.Retrieves text data from the Clipboard in the format indicated by the specified TextDataFormat value.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[])

클립보드를 지운 다음 Byte 형식의 WaveAudio 배열을 Stream으로 변환한 다음 클립보드에 추가합니다.Clears the Clipboard and then adds a Byte array in the WaveAudio format after converting it to a Stream.

SetAudio(Stream) SetAudio(Stream) SetAudio(Stream) SetAudio(Stream)

클립보드를 지운 다음 Stream 형식으로 WaveAudio을 추가합니다.Clears the Clipboard and then adds a Stream in the WaveAudio format.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

클립보드를 지운 다음 지정된 형식으로 데이터를 추가합니다.Clears the Clipboard and then adds data in the specified format.

SetDataObject(Object) SetDataObject(Object) SetDataObject(Object) SetDataObject(Object)

클립보드를 지운 다음 비영구 데이터를 넣습니다.Clears the Clipboard and then places nonpersistent data on it.

SetDataObject(Object, Boolean) SetDataObject(Object, Boolean) SetDataObject(Object, Boolean) SetDataObject(Object, Boolean)

클립보드를 지운 다음 해당 클립보드에 데이터를 배치하고 해당 애플리케이션을 끝낼 때 데이터가 클립보드에 남아 있어야 하는지 여부를 지정합니다.Clears the Clipboard and then places data on it and specifies whether the data should remain after the application exits.

SetDataObject(Object, Boolean, Int32, Int32) SetDataObject(Object, Boolean, Int32, Int32) SetDataObject(Object, Boolean, Int32, Int32) SetDataObject(Object, Boolean, Int32, Int32)

클립보드를 지운 다음 시도 횟수 사이의 간격을 지정하여 지정된 횟수만큼 시스템 클립보드에 데이터를 배치하려고 시도하고 애플리케이션을 끝낸 후 선택적으로 클립보드에 데이터를 그대로 둡니다.Clears the Clipboard and then attempts to place data on it the specified number of times and with the specified delay between attempts, optionally leaving the data on the Clipboard after the application exits.

SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection)

클립보드를 지운 다음 FileDrop 형식의 파일 이름 컬렉션을 추가합니다.Clears the Clipboard and then adds a collection of file names in the FileDrop format.

SetImage(Image) SetImage(Image) SetImage(Image) SetImage(Image)

클립보드를 지운 다음 Image 형식으로 Bitmap를 추가합니다.Clears the Clipboard and then adds an Image in the Bitmap format.

SetText(String) SetText(String) SetText(String) SetText(String)

클립보드를 지운 다음 운영 체제에 따라 Text 또는 UnicodeText 형식의 텍스트 데이터를 클립보드에 추가합니다.Clears the Clipboard and then adds text data in the Text or UnicodeText format, depending on the operating system.

SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat)

클립보드를 지운 다음 지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터를 클립보드에 추가합니다.Clears the Clipboard and then adds text data in the format indicated by the specified TextDataFormat value.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

적용 대상

추가 정보