Clipboard.SetImage(Image) 메서드

정의

클립보드를 지운 다음 Image 형식으로 Bitmap를 추가합니다.Clears the Clipboard and then adds an Image in the Bitmap format.

public:
 static void SetImage(System::Drawing::Image ^ image);
public static void SetImage (System.Drawing.Image image);
static member SetImage : System.Drawing.Image -> unit

매개 변수

image
Image

클립보드에 추가할 Image입니다.The Image to add to the Clipboard.

예외

클립보드를 지울 수 없는 경우.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.

imagenull인 경우image is null.

예제

다음 예제에서는이 멤버를 보여 줍니다.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 검색 하기 전에 클립보드에 이미지 데이터가 포함 되어 있는지 여부를 결정 하는 방법의 GetImage 메서드.To retrieve image data from the Clipboard, first use the ContainsImage method to determine whether the Clipboard contains image data before retrieving it with the GetImage method.

참고

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
데이터를 추가 하기 위한는 Bitmap 시스템 클립보드 형식입니다.for adding data in the Bitmap format to the system Clipboard. 연결 된 열거형: AllClipboardAssociated enumeration: AllClipboard

적용 대상

추가 정보