Clipboard.GetText 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

클립보드에서 텍스트 데이터를 검색합니다.

오버로드

GetText()	운영 체제에 따라 Text 또는 UnicodeText 형식의 텍스트 데이터를 클립보드에서 검색합니다.
GetText(TextDataFormat)	지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터를 클립보드에서 검색합니다.

GetText()

운영 체제에 따라 Text 또는 UnicodeText 형식의 텍스트 데이터를 클립보드에서 검색합니다.

public:
 static System::String ^ GetText();

public static string GetText ();

static member GetText : unit -> string

Public Shared Function GetText () As String

반환

String

클립보드 텍스트 데이터이거나, 운영 체제에 따라 Empty 또는 Text 형식의 데이터가 클립보드에 없으면 UnicodeText입니다.

예외

ExternalException

클립보드를 지울 수 없는 경우. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.

ThreadStateException

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.

예제

다음 예제에서는 이 오버로드와 유사한 메서드의 GetText 오버로드를 보여 줍니다.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

설명

이 메서드는 Windows XP Home Edition, Windows XP Professional, Windows Server 2003 및 Windows 2000에서 텍스트 데이터를 UnicodeText 형식으로 반환합니다. 그렇지 않으면 이 메서드는 텍스트 데이터를 형식으로 Text 반환합니다.

이 메서드를 ContainsText 사용하여 검색하기 전에 클립보드에 텍스트 데이터가 포함되어 있는지 여부를 확인하려면 메서드를 사용합니다.

메서드를 SetText 사용하여 클립보드에 텍스트 데이터를 추가합니다.

참고

Clipboard 클래스는 STA(단일 스레드 아파트) 모드로 설정된 스레드에서만 사용될 수 있습니다. 이 클래스를 사용하려면 Main 메서드가 STAThreadAttribute 특성으로 표시되었는지 확인하세요.

추가 정보

• TextDataFormat
• ContainsText
• SetText

GetText(TextDataFormat)

지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터를 클립보드에서 검색합니다.

public:
 static System::String ^ GetText(System::Windows::Forms::TextDataFormat format);

public static string GetText (System.Windows.Forms.TextDataFormat format);

static member GetText : System.Windows.Forms.TextDataFormat -> string

Public Shared Function GetText (format As TextDataFormat) As String

매개 변수

format

TextDataFormat

TextDataFormat 값 중 하나입니다.

반환

String

클립보드 텍스트 데이터이거나, 클립보드에 지정된 형식의 데이터가 없으면 Empty입니다.

예외

ExternalException

클립보드를 지울 수 없는 경우. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.

ThreadStateException

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.

InvalidEnumArgumentException

format는 유효한 TextDataFormat 값이 아닙니다.

예제

다음 예제에서는 이 멤버를 보여 줍니다.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

설명

이 메서드를 ContainsText 사용하여 검색하기 전에 클립보드에 텍스트 데이터가 포함되어 있는지 여부를 확인하려면 메서드를 사용합니다.

메서드를 SetText 사용하여 클립보드에 텍스트 데이터를 추가합니다.

참고

Clipboard 클래스는 STA(단일 스레드 아파트) 모드로 설정된 스레드에서만 사용될 수 있습니다. 이 클래스를 사용하려면 Main 메서드가 STAThreadAttribute 특성으로 표시되었는지 확인하세요.

추가 정보

• TextDataFormat
• ContainsText
• SetText