Clipboard.GetImage Methode
Definition
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.
Ruft ein Bild aus der Zwischenablage ab.
public:
static System::Drawing::Image ^ GetImage();public static System.Drawing.Image GetImage();public static System.Drawing.Image? GetImage();static member GetImage : unit -> System.Drawing.ImagePublic Shared Function GetImage () As ImageGibt zurück
Eine Image Darstellung der Bilddaten der Zwischenablage oder null wenn die Zwischenablage keine Daten enthält, die sich Bitmap im Format befinden oder in dieses Format konvertiert werden können.
Ausnahmen
Die Zwischenablage konnte nicht gelöscht werden. Dies tritt in der Regel auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.
Der aktuelle Thread befindet sich nicht im Sta-Modus (Single Threaded Apartment). Fügen Sie die STAThreadAttribute Methode Ihrer Anwendung Main hinzu.
Beispiele
Im folgenden Beispiel wird dieses Element 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 die ContainsImage Methode, um zu bestimmen, ob die Zwischenablage Bilddaten enthält, bevor Sie sie mit dieser Methode abrufen.
Verwenden Sie die SetImage Methode, um der Zwischenablage Bilddaten hinzuzufügen.
Note
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 die Main-Methode mit dem STAThreadAttribute-Attribut markiert ist.
