Partager via


Clipboard.GetImage Méthode

Définition

Récupère une image du Presse-papiers.

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

Retours

Image représentant les données image du Presse-papiers ou null si le Presse-papiers ne contient pas de données au format Bitmap ou qui peuvent être converties dans ce format.

Exceptions

Le Presse-papiers n'a pas pu être effacé. Cela se produit en général lorsque le Presse-papiers est utilisé par un autre processus.

Le thread actuel n'est pas en mode thread cloisonné (STA, Single-Threaded Apartment). Ajoutez STAThreadAttribute à la méthode Main de votre application.

Exemples

L’exemple suivant illustre ce membre.

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

Remarques

Utilisez la ContainsImage méthode pour déterminer si le Presse-papiers contient des données d’image avant de les récupérer avec cette méthode.

Utilisez la SetImage méthode pour ajouter des données d’image au Presse-papiers.

Notes

La Clipboard classe ne peut être utilisée que dans les threads définis en mode STA (Single Thread Apartment). Pour utiliser cette classe, vérifiez que votre Main méthode est marquée avec l’attribut STAThreadAttribute .

S’applique à

Voir aussi