Clipboard.SetText Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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

Přetížení

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

SetText(String)

Vymaže schránku a pak přidá textová data ve formátu nebo UnicodeText v Text 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ý se má 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 jednovláknového panelu (STA). Přidejte do STAThreadAttribute metody aplikace Main parametr .

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 v UnicodeText systémech Windows XP Home Edition, Windows XP Professional, Windows Server 2003 a Windows 2000. V opačném případě tato metoda přidá textová data ve Text formátu.

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

Poznámka

Třídu 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 Main metoda označena atributem STAThreadAttribute .

Viz také

• TextDataFormat
• ContainsText
• GetText

SetText(String, TextDataFormat)

Vymaže schránku a pak 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ý se má 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 jednovláknového panelu (STA). Přidejte do STAThreadAttribute metody aplikace Main parametr .

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 použijte metodu ContainsText k určení, zda schránka obsahuje textová data před načtením pomocí GetText metody .

Poznámka

Třídu 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 Main metoda označena atributem STAThreadAttribute .

Viz také

• TextDataFormat
• ContainsText
• GetText