Clipboard.ContainsText Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Indica se há dados de texto na Área de Transferência.
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
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;
}
' 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.
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);
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
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;
}
' 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.
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 |