Język

Clipboard.ContainsText Metoda

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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

Przeciążenia

Nazwa Opis
ContainsText()

Wskazuje, czy w schowku znajdują się dane w formacie lub Text w UnicodeText 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()

Źródło:
Clipboard.cs
Źródło:
Clipboard.cs
Źródło:
Clipboard.cs
Źródło:
Clipboard.cs
Źródło:
Clipboard.cs

Wskazuje, czy w schowku znajdują się dane w formacie lub Text w UnicodeText 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 formacie UnicodeText w 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 .

Note

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

Zobacz też

Dotyczy

ContainsText(TextDataFormat)

Źródło:
Clipboard.cs
Źródło:
Clipboard.cs
Źródło:
Clipboard.cs
Źródło:
Clipboard.cs
Źródło:
Clipboard.cs

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

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 go za GetText pomocą metody .

Note

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

Zobacz też

Dotyczy