Clipboard.SetText Methode

Definitie

Naamruimte:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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

Public Shared Sub SetText (text As String)

Parameters

text: String

De tekst die moet worden toegevoegd aan het Klembord.

Uitzonderingen

ExternalException

Het Klembord kan niet worden gewist. Dit gebeurt meestal wanneer het Klembord wordt gebruikt door een ander proces.

ThreadStateException

De huidige thread bevindt zich niet in sta-modus (single threaded apartment). Voeg de STAThreadAttribute methode van Main uw toepassing toe.

ArgumentNullException

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

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