Clipboard.GetImage Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает изображения из буфера обмена.

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

Возвращаемое значение

Image

Объект Image, представляющий графические данные буфера обмена, или значение null, если буфер обмена не содержит никаких данных в формате Bitmap или данных, которые могут быть преобразованы в этот формат.

Исключения

ExternalException

Не удалось очистить буфер обмена. Обычно это происходит, когда буфер обмена используется другим процессом.

ThreadStateException

Текущий поток не выполняется в режиме апартмента с одним потоком (STA). Добавьте STAThreadAttribute в метод Main своего приложения.

Примеры

В следующем примере демонстрируется этот элемент.

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

Комментарии

Используйте метод , ContainsImage чтобы определить, содержит ли буфер обмена данные изображения, прежде чем извлекать их с помощью этого метода.

Используйте метод , SetImage чтобы добавить данные изображения в буфер обмена.

Примечание

Класс Clipboard можно использовать только в потоках в режиме контейнера с одним потоком (STA). Чтобы использовать этот класс, убедитесь, что метод Main отмечен атрибутом STAThreadAttribute.

См. также раздел

• Image
• Bitmap
• ContainsImage()
• SetImage(Image)