Clipboard.SetText Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wist u het Klembord en voegt u er tekstgegevens aan toe.
Overloads
| Name | Description |
|---|---|
| SetText(String) |
Hiermee wist u het Klembord en voegt u tekstgegevens toe in de Text of UnicodeText indeling, afhankelijk van het besturingssysteem. |
| SetText(String, TextDataFormat) |
Hiermee wist u het Klembord en voegt u tekstgegevens toe in de indeling die wordt aangegeven met de opgegeven TextDataFormat waarde. |
SetText(String)
Hiermee wist u het Klembord en voegt u tekstgegevens toe in de Text of UnicodeText indeling, afhankelijk van het besturingssysteem.
public:
static void SetText(System::String ^ text);public static void SetText(string text);static member SetText : string -> unitPublic Shared Sub SetText (text As String)Parameters
- text
- String
De tekst die moet worden toegevoegd aan het Klembord.
Uitzonderingen
Het Klembord kan niet worden gewist. Dit gebeurt meestal wanneer het Klembord wordt gebruikt door een ander proces.
De huidige thread bevindt zich niet in sta-modus (single threaded apartment). Voeg de STAThreadAttribute methode van Main uw toepassing toe.
text is null of Empty.
Voorbeelden
In het volgende voorbeeld ziet u een overbelasting van de SetText methode die vergelijkbaar is met deze overbelasting.
// 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
Opmerkingen
Met deze methode worden tekstgegevens toegevoegd in de indeling UnicodeText op Windows XP Home Edition, Windows XP Professional, Windows Server 2003 en Windows 2000. Anders voegt deze methode tekstgegevens toe in de Text indeling.
Als u tekstgegevens wilt ophalen van het Klembord, gebruikt u eerst de ContainsText methode om te bepalen of het Klembord tekstgegevens bevat voordat u deze met de GetText methode ophaalt.
Note
De Clipboard klasse kan alleen worden gebruikt in threads die zijn ingesteld op de STA-modus (Single Thread Apartment). Als u deze klasse wilt gebruiken, moet u ervoor zorgen dat uw Main methode is gemarkeerd met het kenmerk STAThreadAttribute.
Zie ook
Van toepassing op
SetText(String, TextDataFormat)
Hiermee wist u het Klembord en voegt u tekstgegevens toe in de indeling die wordt aangegeven met de opgegeven TextDataFormat waarde.
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)Parameters
- text
- String
De tekst die moet worden toegevoegd aan het Klembord.
- format
- TextDataFormat
Een van de TextDataFormat waarden.
Uitzonderingen
Het Klembord kan niet worden gewist. Dit gebeurt meestal wanneer het Klembord wordt gebruikt door een ander proces.
De huidige thread bevindt zich niet in sta-modus (single threaded apartment). Voeg de STAThreadAttribute methode van Main uw toepassing toe.
text is null of Empty.
format is geen geldige TextDataFormat waarde.
Voorbeelden
In het volgende voorbeeld ziet u dit lid.
// 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
Opmerkingen
Als u tekstgegevens wilt ophalen van het Klembord, gebruikt u eerst de ContainsText methode om te bepalen of het Klembord tekstgegevens bevat voordat u deze met de GetText methode ophaalt.
Note
De Clipboard klasse kan alleen worden gebruikt in threads die zijn ingesteld op de STA-modus (Single Thread Apartment). Als u deze klasse wilt gebruiken, moet u ervoor zorgen dat uw Main methode is gemarkeerd met het kenmerk STAThreadAttribute.