Clipboard.SetText Método
Definição
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.
Limpa a Área de Transferência e adiciona dados de textos a ela.
Sobrecargas
| SetText(String) |
Limpa a área de transferência e, em seguida, adiciona dados de texto no formato Text ou UnicodeText, dependendo do sistema operacional. |
| SetText(String, TextDataFormat) |
Limpa a Área de Transferência e adiciona dados de texto no formato indicado pelo valor TextDataFormat especificado. |
SetText(String)
Limpa a área de transferência e, em seguida, adiciona dados de texto no formato Text ou UnicodeText, dependendo do sistema operacional.
public:
static void SetText(System::String ^ text);public static void SetText (string text);static member SetText : string -> unitPublic Shared Sub SetText (text As String)Parâmetros
- text
- String
O texto a ser adicionado à Área de Transferência.
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.
text é null ou Empty.
Exemplos
O exemplo a seguir demonstra uma sobrecarga do SetText 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 adiciona dados de texto no UnicodeText formato no Windows XP Home Edition, Windows XP Professional, Windows Server 2003 e Windows 2000. Caso contrário, esse método adiciona dados de texto no Text formato .
Para recuperar dados de texto da Área de Transferência, primeiro use o ContainsText 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 como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .
Confira também
Aplica-se a
SetText(String, TextDataFormat)
Limpa a Área de Transferência e adiciona dados de texto no formato indicado pelo valor TextDataFormat especificado.
public:
static void SetText(System::String ^ text, System::Windows::Forms::TextDataFormat format);public static void SetText (string text, System.Windows.Forms.TextDataFormat format);static member SetText : string * System.Windows.Forms.TextDataFormat -> unitPublic Shared Sub SetText (text As String, format As TextDataFormat)Parâmetros
- text
- String
O texto a ser adicionado à Área de Transferência.
- format
- TextDataFormat
Um dos valores de TextDataFormat.
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.
text é null ou Empty.
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
Para recuperar dados de texto da Área de Transferência, primeiro use o ContainsText 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 como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .
