Clipboard.ContainsImage Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt an, ob sich in der Zwischenablage Daten im Bitmap-Format oder Daten befinden, die in dieses Format konvertiert werden können.
public:
static bool ContainsImage();public static bool ContainsImage ();static member ContainsImage : unit -> boolPublic Shared Function ContainsImage () As BooleanGibt zurück
true, wenn Bilddaten in der Zwischenablage gespeichert sind, andernfalls false.
Ausnahmen
Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.
Der aktuelle Thread befindet sich nicht im STA-Modus (Singlethread-Apartment). Fügen Sie der Main-Methode der Anwendung das STAThreadAttribute hinzu.
Beispiele
Im folgenden Beispiel wird dieses Element veranschaulicht.
// Demonstrates SetImage, ContainsImage, and GetImage.
public System.Drawing.Image SwapClipboardImage(
System.Drawing.Image replacementImage)
{
System.Drawing.Image returnImage = null;
if (Clipboard.ContainsImage())
{
returnImage = Clipboard.GetImage();
Clipboard.SetImage(replacementImage);
}
return returnImage;
}
' Demonstrates SetImage, ContainsImage, and GetImage.
Public Function SwapClipboardImage( _
ByVal replacementImage As System.Drawing.Image) _
As System.Drawing.Image
Dim returnImage As System.Drawing.Image = Nothing
If Clipboard.ContainsImage() Then
returnImage = Clipboard.GetImage()
Clipboard.SetImage(replacementImage)
End If
Return returnImage
End Function
Hinweise
Verwenden Sie diese Methode, um zu ermitteln, ob die Zwischenablage Bilddaten enthält, bevor Sie sie mit der GetImage -Methode abrufen.
Hinweis
Die Clipboard-Klasse kann nur in Threads verwendet werden, die auf den STA-Modus (Single Thread Apartment) festgelegt sind. Um diese Klasse zu verwenden, stellen Sie sicher, dass Ihre Main-Methode mit dem STAThreadAttribute-Attribut gekennzeichnet ist.
