Clipboard.ContainsText 메서드

정의

텍스트 데이터가 클립보드에 있는지 여부를 나타냅니다.Indicates whether there is text data on the Clipboard.

오버로드

ContainsText()

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

ContainsText(TextDataFormat)

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

ContainsText()

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

public:
 static bool ContainsText();
public static bool ContainsText ();
static member ContainsText : unit -> bool
Public Shared Function ContainsText () As Boolean

반환

텍스트 데이터가 클립보드에 있으면 true이고, 그렇지 않으면 false입니다.true if there is text data on the Clipboard; otherwise, false.

예외

클립보드를 지울 수 없는 경우.The Clipboard could not be cleared. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.This typically occurs when the Clipboard is being used by another process.

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우.The current thread is not in single-threaded apartment (STA) mode. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.Add the STAThreadAttribute to your application's Main method.

예제

다음 예제에서는 오버 로드는 ContainsText 메서드는이 오버 로드와 비슷합니다.The following example demonstrates an overload of the ContainsText method that is similar to this overload.

// 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

설명

이 메서드는 데이터의 존재 여부 확인 합니다 UnicodeText 서식 Windows XP Home Edition, Windows XP Professional, Windows Server 2003Windows XP Home Edition, Windows XP Professional, Windows Server 2003Windows 2000Windows 2000합니다.This method checks for the presence of data in the UnicodeText format on Windows XP Home Edition, Windows XP Professional, Windows Server 2003Windows XP Home Edition, Windows XP Professional, Windows Server 2003 and Windows 2000Windows 2000. 이 메서드는 데이터의 존재 여부 확인이 고, 그렇지는 Text 형식입니다.Otherwise, this method checks for the presence of data in the Text format.

이 메서드를 사용 하 여 검색 하기 전에 클립보드에 텍스트 데이터가 포함 되어 있는지 여부를 결정 합니다 GetText 메서드.Use this method to determine whether the Clipboard contains text data before retrieving it with the GetText 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.

보안

UIPermission
시스템 클립보드에 액세스 합니다.for access to the system Clipboard. 연결 된 열거형: AllClipboardAssociated enumeration: AllClipboard

추가 정보

ContainsText(TextDataFormat)

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

public:
 static bool ContainsText(System::Windows::Forms::TextDataFormat format);
public static bool ContainsText (System.Windows.Forms.TextDataFormat format);
static member ContainsText : System.Windows.Forms.TextDataFormat -> bool
Public Shared Function ContainsText (format As TextDataFormat) As Boolean

매개 변수

format
TextDataFormat

TextDataFormat 값 중 하나입니다.One of the TextDataFormat values.

반환

format에 지정된 값의 텍스트 데이터가 클립보드에 있으면 true이고, 그렇지 않으면 false입니다.true if there is text data on the Clipboard in the value specified for format; otherwise, false.

예외

클립보드를 지울 수 없는 경우.The Clipboard could not be cleared. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.This typically occurs when the Clipboard is being used by another process.

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우.The current thread is not in single-threaded apartment (STA) mode. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.Add the STAThreadAttribute to your application's Main method.

format는 유효한 TextDataFormat 값이 아닙니다.format is not a valid TextDataFormat value.

예제

다음 예제에서는이 멤버를 보여 줍니다.The following example demonstrates this member.

// 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

설명

이 메서드를 사용 하 여 검색 하기 전에 클립보드에 텍스트 데이터가 포함 되어 있는지 여부를 결정 합니다 GetText 메서드.Use this method to determine whether the Clipboard contains text data before retrieving it with the GetText 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.

보안

UIPermission
시스템 클립보드에 액세스 합니다.for access to the system Clipboard. 연결 된 열거형: AllClipboardAssociated enumeration: AllClipboard

추가 정보

적용 대상