Clipboard.ContainsText 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 wordt aangegeven of er tekstgegevens op het Klembord staan.
Overloads
| Name | Description |
|---|---|
| ContainsText() |
Hiermee wordt aangegeven of er gegevens op het Klembord in de Text of UnicodeText indeling staan, afhankelijk van het besturingssysteem. |
| ContainsText(TextDataFormat) |
Hiermee wordt aangegeven of er tekstgegevens op het Klembord staan in de indeling die wordt aangegeven door de opgegeven TextDataFormat waarde. |
ContainsText()
Hiermee wordt aangegeven of er gegevens op het Klembord in de Text of UnicodeText indeling staan, afhankelijk van het besturingssysteem.
public:
static bool ContainsText();public static bool ContainsText();static member ContainsText : unit -> boolPublic Shared Function ContainsText () As BooleanRetouren
true als er tekstgegevens op het Klembord staan; anders, false.
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.
Voorbeelden
In het volgende voorbeeld ziet u een overbelasting van de ContainsText 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 wordt gecontroleerd op de aanwezigheid van gegevens in de indeling UnicodeText op Windows XP Home Edition, Windows XP Professional, Windows Server 2003 en Windows 2000. Anders wordt met deze methode gecontroleerd op de aanwezigheid van gegevens in de Text indeling.
Gebruik deze methode om te bepalen of het Klembord tekstgegevens bevat voordat u deze met de GetText methode opvraagt.
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
ContainsText(TextDataFormat)
Hiermee wordt aangegeven of er tekstgegevens op het Klembord staan in de indeling die wordt aangegeven door de opgegeven TextDataFormat waarde.
public:
static bool ContainsText(System::Windows::Forms::TextDataFormat format);public static bool ContainsText(System.Windows.Forms.TextDataFormat format);static member ContainsText : System.Windows.Forms.TextDataFormat -> boolPublic Shared Function ContainsText (format As TextDataFormat) As BooleanParameters
- format
- TextDataFormat
Een van de TextDataFormat waarden.
Retouren
trueals er tekstgegevens op het Klembord staan in de opgegeven waarde voorformat; anders. false
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.
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
Gebruik deze methode om te bepalen of het Klembord tekstgegevens bevat voordat u deze met de GetText methode opvraagt.
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.