Clipboard.SetImage(Image) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Löscht die Zwischenablage und fügt dann ein Image im Bitmap-Format hinzu.

public:
 static void SetImage(System::Drawing::Image ^ image);

public static void SetImage (System.Drawing.Image image);

static member SetImage : System.Drawing.Image -> unit

Public Shared Sub SetImage (image As Image)

Parameter

image: Image

Das Image, das der Zwischenablage hinzugefügt werden soll.

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.

ArgumentNullException

image ist null.

Beispiele

Im folgenden Beispiel wird dieser Member 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 zum Abrufen von Bilddaten aus der Zwischenablage zunächst die ContainsImage -Methode, um zu bestimmen, 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: