Clipboard.ContainsText Método

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Indica se há dados de texto na Área de Transferência.

Sobrecargas

Nome Description
ContainsText()

Indica se há dados na Área de Transferência no formato ou Text no UnicodeText formato, dependendo do sistema operacional.
ContainsText(TextDataFormat)

Indica se há dados de texto na Área de Transferência no formato indicado pelo valor especificado TextDataFormat .

ContainsText()

Origem:
Clipboard.cs
Origem:
Clipboard.cs
Origem:
Clipboard.cs
Origem:
Clipboard.cs
Origem:
Clipboard.cs

Indica se há dados na Área de Transferência no formato ou Text no UnicodeText formato, dependendo do sistema operacional.

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

Retornos

Boolean

true se houver dados de texto na Área de Transferência; caso contrário, false.

Exceções

ExternalException

Não foi possível limpar a área de transferência. Isso normalmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

O thread atual não está no modo STA (apartamento de thread único). Adicione o STAThreadAttribute método do Main aplicativo.

Exemplos

O exemplo a seguir demonstra uma sobrecarga do ContainsText método semelhante a essa sobrecarga.

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

Comentários

Esse método verifica a presença de dados no formato UnicodeText no Windows XP Home Edition, Windows XP Professional, Windows Server 2003 e Windows 2000. Caso contrário, esse método verificará a presença de dados no Text formato.

Use esse método para determinar se a Área de Transferência contém dados de texto antes de recuperá-los com o GetText método.

Note

A classe Clipboard só pode ser usada em threads configurados no modo STA (Single Thread Apartment). Para usar essa classe, verifique se o método Main está marcado com o atributo STAThreadAttribute.

Confira também

Aplica-se a

ContainsText(TextDataFormat)

Origem:
Clipboard.cs
Origem:
Clipboard.cs
Origem:
Clipboard.cs
Origem:
Clipboard.cs
Origem:
Clipboard.cs

Indica se há dados de texto na Área de Transferência no formato indicado pelo valor especificado 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 -> bool
Public Shared Function ContainsText (format As TextDataFormat) As Boolean

Parâmetros

format
TextDataFormat

Um dos TextDataFormat valores.

Retornos

Boolean

true se houver dados de texto na Área de Transferência no valor especificado para format; caso contrário, false.

Exceções

ExternalException

Não foi possível limpar a área de transferência. Isso normalmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

O thread atual não está no modo STA (apartamento de thread único). Adicione o STAThreadAttribute método do Main aplicativo.

InvalidEnumArgumentException

format não é um valor válido TextDataFormat .

Exemplos

O exemplo a seguir demonstra esse membro.

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

Comentários

Use esse método para determinar se a Área de Transferência contém dados de texto antes de recuperá-los com o GetText método.

Note

A classe Clipboard só pode ser usada em threads configurados no modo STA (Single Thread Apartment). Para usar essa classe, verifique se o método Main está marcado com o atributo STAThreadAttribute.

Confira também

Aplica-se a