Clipboard.SetImage(Image) Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vymaže schránku a pak přidá ve Bitmap formátu .Image

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

Chcete-li Image přidat do schránky.

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází, když schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu jednovláknového apartmentu (STA). Přidejte do STAThreadAttribute metody vaší aplikace Main .

ArgumentNullException

image je null.

Příklady

Následující příklad ukazuje tohoto člena.

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

Poznámky

Chcete-li načíst data obrázku ze schránky, nejprve pomocí ContainsImage metody zjistěte, zda schránka obsahuje data obrázku před načtením pomocí GetImage metody .

Poznámka

Třídu Clipboard lze použít pouze ve vláknech nastavených na režim jednovláknového apartmentu (STA). Pokud chcete použít tuto třídu, ujistěte se, že je vaše Main metoda označená atributem STAThreadAttribute .

Platí pro