Clipboard.GetText Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Načte textová data ze schránky.

Přetížení

GetText()	Načte textová data ze schránky ve Text formátu nebo UnicodeText v závislosti na operačním systému.
GetText(TextDataFormat)	Načte textová data ze schránky ve formátu určeném zadanou TextDataFormat hodnotou.

GetText()

Načte textová data ze schránky ve Text formátu nebo UnicodeText v závislosti na operačním systému.

public:
 static System::String ^ GetText();

public static string GetText ();

static member GetText : unit -> string

Public Shared Function GetText () As String

Návraty

String

Textová data schránky nebo Empty pokud schránka neobsahuje data ve Text formátu nebo UnicodeText v závislosti na operačním systému.

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází, když schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu jednovláknového apartmentu (STA). Přidejte do STAThreadAttribute metody vaší aplikace Main .

Příklady

Následující příklad ukazuje přetížení GetText 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 vrátí textová data ve formátu v UnicodeText systémech Windows XP Home Edition, Windows XP Professional, Windows Server 2003 a Windows 2000. Jinak tato metoda vrátí textová data ve Text formátu .

Použijte metodu ContainsText k určení, zda schránka obsahuje textová data před načtením pomocí této metody.

K přidání textových SetText dat do schránky použijte metodu .

Poznámka

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

Viz také

• TextDataFormat
• ContainsText
• SetText

GetText(TextDataFormat)

Načte textová data ze schránky ve formátu určeném zadanou TextDataFormat hodnotou.

public:
 static System::String ^ GetText(System::Windows::Forms::TextDataFormat format);

public static string GetText (System.Windows.Forms.TextDataFormat format);

static member GetText : System.Windows.Forms.TextDataFormat -> string

Public Shared Function GetText (format As TextDataFormat) As String

Parametry

format

TextDataFormat

Jedna z TextDataFormat hodnot.

Návraty

String

Textová data schránky nebo Empty pokud schránka neobsahuje data v zadaném formátu.

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází, když schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu jednovláknového apartmentu (STA). Přidejte do STAThreadAttribute metody vaší aplikace Main .

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

Použijte metodu ContainsText k určení, zda schránka obsahuje textová data před načtením pomocí této metody.

K přidání textových SetText dat do schránky použijte metodu .

Poznámka

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

Viz také

• TextDataFormat
• ContainsText
• SetText