Clipboard.SetImage(Image) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Czyści schowek, a następnie dodaje element Image w Bitmap formacie.

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)

Parametry

image: Image

Element Image do dodania do Schowka.

Wyjątki

ExternalException

Nie można wyczyścić schowka. Zwykle występuje to, gdy schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowego mieszkania (STA). Dodaj metodę STAThreadAttribute do metody aplikacji Main .

ArgumentNullException

image to null.

Przykłady

W poniższym przykładzie pokazano ten element członkowski.

// 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

Uwagi

Aby pobrać dane obrazu ze Schowka, najpierw użyj ContainsImage metody , aby określić, czy Schowek zawiera dane obrazu przed pobraniem GetImage go za pomocą metody .

Uwaga

Klasa Clipboard może być używana tylko w wątkach ustawionych na tryb pojedynczego wątku (STA). Aby użyć tej klasy, upewnij się, że Main metoda jest oznaczona atrybutem STAThreadAttribute .

Dotyczy