Clipboard.ContainsText Método

Definição

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

Sobrecargas

ContainsText()

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

ContainsText(TextDataFormat)

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

ContainsText()

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

public static bool ContainsText ();

Retornos

Boolean

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

Exceções

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

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do 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;
}

Comentários

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

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

Nota

A Clipboard classe só pode ser usada em threads definidos para o modo STA (apartamento de thread único). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo.

Confira também

Aplica-se a

.NET Framework 4.8 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

ContainsText(TextDataFormat)

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

public static bool ContainsText (System.Windows.Forms.TextDataFormat format);

Parâmetros

format
TextDataFormat

Um dos valores de TextDataFormat.

Retornos

Boolean

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

Exceções

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

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

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

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;
}

Comentários

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

Nota

A Clipboard classe só pode ser usada em threads definidos para o modo STA (apartamento de thread único). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo.

Confira também

Aplica-se a

.NET Framework 4.8 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7