Clipboard.SetText Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vymaže schránku a přidá do ní textová data.

Přetížení

Name	Description
SetText(String)	Vymaže schránku a pak přidá textová data v TextUnicodeText závislosti na operačním systému.
SetText(String, TextDataFormat)	Vymaže schránku a potom přidá textová data ve formátu určeném zadanou TextDataFormat hodnotou.

SetText(String)

Zdroj:

Clipboard.cs

Vymaže schránku a pak přidá textová data v TextUnicodeText závislosti na operačním systému.

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)

Parametry

text

String

Text, který chcete přidat do schránky.

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází v případě, že schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu STA (Single-Threaded Apartment). Přidejte metodu STAThreadAttributeMain aplikace.

ArgumentNullException

text je null nebo Empty.

Příklady

Následující příklad ukazuje přetížení SetText metody, která je podobná tomuto přetížení.

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

Poznámky

Tato metoda přidá textová data ve formátu UnicodeText ve formátu Windows XP Home Edition, Windows XP Professional, Windows Server 2003 a Windows 2000. Jinak tato metoda přidá textová data ve Text formátu.

Chcete-li načíst textová data ze schránky, nejprve pomocí ContainsText metody určete, zda schránka obsahuje textová data před načtením GetText pomocí metody.

Note

Třída Clipboard lze použít pouze ve vláknech nastavených na režim jednovláknového apartmentu (STA). Chcete-li použít tuto třídu, ujistěte se, že je vaše metoda Main označena atributem STAThreadAttribute.

Viz také

• TextDataFormat
• ContainsText
• GetText

SetText(String, TextDataFormat)

Zdroj:

Clipboard.cs

Vymaže schránku a potom přidá textová data ve formátu určeném zadanou TextDataFormat hodnotou.

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)

Parametry

text

String

Text, který chcete přidat do schránky.

format

TextDataFormat

Jedna z TextDataFormat hodnot.

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází v případě, že schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu STA (Single-Threaded Apartment). Přidejte metodu STAThreadAttributeMain aplikace.

ArgumentNullException

text je null nebo Empty.

InvalidEnumArgumentException

format není platná TextDataFormat hodnota.

Příklady

Následující příklad ukazuje tohoto člena.

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

Poznámky

Chcete-li načíst textová data ze schránky, nejprve pomocí ContainsText metody určete, zda schránka obsahuje textová data před načtením GetText pomocí metody.

Note

Třída Clipboard lze použít pouze ve vláknech nastavených na režim jednovláknového apartmentu (STA). Chcete-li použít tuto třídu, ujistěte se, že je vaše metoda Main označena atributem STAThreadAttribute.

Viz také

• TextDataFormat
• ContainsText
• GetText