Clipboard.SetText 메서드

정의

클립보드를 지우고 텍스트 데이터를 추가합니다.

오버로드

Name Description
SetText(String)

클립보드를 지운 다음 운영 체제에 Text 따라 텍스트 데이터를 또는 UnicodeText 형식으로 추가합니다.

SetText(String, TextDataFormat)

클립보드를 지우고 지정된 TextDataFormat 값으로 표시된 형식으로 텍스트 데이터를 추가합니다.

SetText(String)

Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs

클립보드를 지운 다음 운영 체제에 Text 따라 텍스트 데이터를 또는 UnicodeText 형식으로 추가합니다.

public:
 static void SetText(System::String ^ text);
public static void SetText(string text);
static member SetText : string -> unit
Public Shared Sub SetText (text As String)

매개 변수

text
String

클립보드에 추가할 텍스트입니다.

예외

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

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

text is null 또는 Empty.

예제

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

// 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 사용하여 검색하기 전에 GetText 클립보드에 텍스트 데이터가 포함되어 있는지 여부를 확인합니다.

메모

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

추가 정보

적용 대상

SetText(String, TextDataFormat)

Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs

클립보드를 지우고 지정된 TextDataFormat 값으로 표시된 형식으로 텍스트 데이터를 추가합니다.

public:
 static void SetText(System::String ^ text, System::Windows::Forms::TextDataFormat format);
public static void SetText(string text, System.Windows.Forms.TextDataFormat format);
static member SetText : string * System.Windows.Forms.TextDataFormat -> unit
Public Shared Sub SetText (text As String, format As TextDataFormat)

매개 변수

text
String

클립보드에 추가할 텍스트입니다.

format
TextDataFormat

값 중 TextDataFormat 하나입니다.

예외

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

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

text is null 또는 Empty.

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 사용하여 검색하기 전에 GetText 클립보드에 텍스트 데이터가 포함되어 있는지 여부를 확인합니다.

메모

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

추가 정보

적용 대상