Clipboard.ContainsText Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Wskazuje, czy w Schowku znajdują się dane tekstowe.

Przeciążenia

ContainsText()	Wskazuje, czy w schowku znajdują się dane w Text formacie lub UnicodeText w zależności od systemu operacyjnego.
ContainsText(TextDataFormat)	Wskazuje, czy w Schowku znajdują się dane tekstowe w formacie wskazanym przez określoną TextDataFormat wartość.

ContainsText()

Wskazuje, czy w schowku znajdują się dane w Text formacie lub UnicodeText w zależności od systemu operacyjnego.

public:
 static bool ContainsText();

public static bool ContainsText ();

static member ContainsText : unit -> bool

Public Shared Function ContainsText () As Boolean

Zwraca

Boolean

true jeśli w Schowku znajdują się dane tekstowe; w przeciwnym razie , false.

Wyjątki

ExternalException

Nie można wyczyścić schowka. Zwykle występuje to, gdy schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowy (STA). Dodaj element STAThreadAttribute do metody aplikacji Main .

Przykłady

W poniższym przykładzie pokazano przeciążenie ContainsText metody podobnej do tego przeciążenia.

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

Uwagi

Ta metoda sprawdza obecność danych w UnicodeText formacie Windows XP Home Edition, Windows XP Professional, Windows Server 2003 i Windows 2000. W przeciwnym razie ta metoda sprawdza obecność danych w Text formacie.

Użyj tej metody, aby określić, czy Schowek zawiera dane tekstowe przed pobraniem go za GetText pomocą metody .

Uwaga

Klasa Clipboard może być używana tylko w wątkach ustawionych na tryb pojedynczego wątku (STA). Aby użyć tej klasy, upewnij się, że Main metoda jest oznaczona atrybutem STAThreadAttribute .

Zobacz też

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

ContainsText(TextDataFormat)

Wskazuje, czy w Schowku znajdują się dane tekstowe w formacie wskazanym przez określoną TextDataFormat wartość.

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

Parametry

format

TextDataFormat

TextDataFormat Jedna z wartości.

Zwraca

Boolean

true jeśli w Schowku znajdują się dane tekstowe w wartości określonej dla format; w przeciwnym razie false.

Wyjątki

ExternalException

Nie można wyczyścić Schowka. Zwykle dzieje się tak, gdy Schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowy (STA). Dodaj element STAThreadAttribute do metody aplikacji Main .

InvalidEnumArgumentException

format jest nieprawidłową TextDataFormat wartością.

Przykłady

W poniższym przykładzie pokazano ten element członkowski.

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

Uwagi

Użyj tej metody, aby określić, czy Schowek zawiera dane tekstowe przed pobraniem ich za GetText pomocą metody .

Uwaga

Klasę Clipboard można używać tylko w wątkach ustawionych na tryb apartamentów pojedynczego wątku (STA). Aby użyć tej klasy, upewnij się, że metoda Main jest oznaczona atrybutem STAThreadAttribute .

Zobacz też

• TextDataFormat
• GetText
• SetText