Clipboard.ContainsText 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
텍스트 데이터가 클립보드에 있는지 여부를 나타냅니다.
오버로드
| ContainsText() |
운영 체제에 따라 Text 또는 UnicodeText 형식의 데이터가 클립보드에 있는지 여부를 나타냅니다. |
| ContainsText(TextDataFormat) |
지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터가 클립보드에 있는지 여부를 나타냅니다. |
ContainsText()
운영 체제에 따라 Text 또는 UnicodeText 형식의 데이터가 클립보드에 있는지 여부를 나타냅니다.
public:
static bool ContainsText();public static bool ContainsText ();static member ContainsText : unit -> boolPublic Shared Function ContainsText () As Boolean반환
텍스트 데이터가 클립보드에 있으면 true이고, 그렇지 않으면 false입니다.
예외
클립보드를 지울 수 없는 경우. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.
현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.
예제
다음 예제에서는 이 오버로드와 유사한 메서드의 ContainsText 오버로드를 보여 줍니다.
// 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 확인합니다.
이 메서드를 사용하여 클립보드에 텍스트 데이터가 포함되어 있는지 여부를 확인한 후 메서드를 사용하여 GetText 검색합니다.
참고
클래스는 Clipboard STA(단일 스레드 아파트) 모드로 설정된 스레드에서만 사용할 수 있습니다. 이 클래스를 사용하려면 메서드가 Main 특성으로 STAThreadAttribute 표시되어 있는지 확인합니다.
추가 정보
적용 대상
ContainsText(TextDataFormat)
지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터가 클립보드에 있는지 여부를 나타냅니다.
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 -> boolPublic Shared Function ContainsText (format As TextDataFormat) As Boolean매개 변수
- format
- TextDataFormat
TextDataFormat 값 중 하나입니다.
반환
format에 지정된 값의 텍스트 데이터가 클립보드에 있으면 true이고, 그렇지 않으면 false입니다.
예외
클립보드를 지울 수 없는 경우. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.
현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.
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
설명
이 메서드를 사용하여 클립보드에 텍스트 데이터가 포함되어 있는지 여부를 확인한 후 메서드를 사용하여 GetText 검색합니다.
참고
클래스는 Clipboard STA(단일 스레드 아파트) 모드로 설정된 스레드에서만 사용할 수 있습니다. 이 클래스를 사용하려면 메서드가 Main 특성으로 STAThreadAttribute 표시되어 있는지 확인합니다.