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

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();

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 geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

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

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

Observação

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

• TextDataFormat
• Text
• UnicodeText
• GetText
• SetText

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

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

ExternalException

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.

ThreadStateException

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

InvalidEnumArgumentException

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

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

Observação

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

• TextDataFormat
• GetText
• SetText