Clipboard.GetImage 메서드

정의

클립보드에서 이미지를 검색합니다.Retrieves an image from the Clipboard.

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이거나, 클립보드에 Bitmap 형식으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 없으면 null입니다.An Image representing the Clipboard image data or null if the Clipboard does not contain any data that is in the Bitmap format or can be converted to that format.

예외

클립보드를 지울 수 없는 경우.The Clipboard could not be cleared. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.This typically occurs when the Clipboard is being used by another process.

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우.The current thread is not in single-threaded apartment (STA) mode. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.Add the STAThreadAttribute to your application's Main method.

예제

다음 예제에서는이 멤버를 보여 줍니다.The following example demonstrates this member.

// 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 이 메서드를 사용 하 여 검색 하기 전에 클립보드에 이미지 데이터가 포함 되어 있는지 여부를 결정 하는 방법입니다.Use the ContainsImage method to determine whether the Clipboard contains image data before retrieving it with this method.

사용 된 SetImage 클립보드에 이미지 데이터를 추가 하는 방법입니다.Use the SetImage method to add image data to the Clipboard.

참고

Clipboard 단일 스레드 아파트 (STA) 모드를 설정 하는 스레드의 클래스 에서만 사용할 수 있습니다.The Clipboard class can only be used in threads set to single thread apartment (STA) mode. 이 클래스를 사용 하려면 프로그램 Main 표시 된 메서드가 STAThreadAttribute 특성입니다.To use this class, ensure that your Main method is marked with the STAThreadAttribute attribute.

보안

UIPermission
시스템 클립보드에 액세스 합니다.for access to the system Clipboard. 연결 된 열거형: AllClipboardAssociated enumeration: AllClipboard

적용 대상

추가 정보