Clipboard.GetImage Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Recupera un'immagine dagli Appunti.

public:
 static System::Drawing::Image ^ GetImage();

public static System.Drawing.Image GetImage ();

public static System.Drawing.Image? GetImage ();

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

Public Shared Function GetImage () As Image

Restituisce

Image

Classe Image che rappresenta i dati di immagine degli Appunti o null se gli Appunti non contengono dati nel formato Bitmap specificato o che possano essere convertiti in tale formato.

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.

ThreadStateException

Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.

Esempio

Nell'esempio seguente viene illustrato questo membro.

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

Commenti

Utilizzare il ContainsImage metodo per determinare se gli Appunti contengono dati di immagine prima di recuperarli con questo metodo.

Usare il SetImage metodo per aggiungere dati di immagine agli Appunti.

Nota

La Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .

Si applica a

Share via