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이거나, 클립보드에 Bitmap 형식으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 없으면 null입니다.

예외

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)