Clipboard.ContainsText Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Indica se há dados de texto no Clipboard.

Sobrecargas

Name Description
ContainsText()

Indica se há dados na Área de Transferência no Text formato ou, UnicodeText dependendo do sistema operativo.
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 Text formato ou, UnicodeText dependendo do sistema operativo.

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

Devoluções

Boolean

true se houver dados de texto na Prancheta; caso contrário, false.

Exceções

ExternalException

A prancheta não pôde ser limpa. Isto ocorre tipicamente quando a Prancheta está a ser usada por outro processo.

ThreadStateException

O tópico atual não está em modo apartamento single-threaded (STA). Adicione-os STAThreadAttribute ao processo da Main sua candidatura.

Exemplos

O exemplo seguinte demonstra uma sobrecarga do ContainsText método semelhante a esta 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

Observações

Este 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, este método verifica 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 os recuperar com o GetText método.

Note

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

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

Devoluções

Boolean

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

Exceções

ExternalException

A prancheta não pôde ser limpa. Isto ocorre tipicamente quando a Prancheta está a ser usada por outro processo.

ThreadStateException

O tópico atual não está em modo apartamento single-threaded (STA). Adicione-os STAThreadAttribute ao processo da Main sua candidatura.

InvalidEnumArgumentException

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

Exemplos

O exemplo seguinte demonstra este elemento.

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

Observações

Use este método para determinar se a Área de Transferência contém dados de texto antes de os recuperar com o GetText método.

Note

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

Ver também

Aplica-se a