Freigeben über

Clipboard.ContainsImage Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
Clipboard.cs
Quelle:
Clipboard.cs
Quelle:
Clipboard.cs

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 -> bool
Public Shared Function ContainsImage () As Boolean

Gibt zurück

Boolean

true, wenn Bilddaten in der Zwischenablage gespeichert sind, andernfalls false.

Ausnahmen

ExternalException

Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.

ThreadStateException

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.

Gilt für:

Weitere Informationen