Clipboard  - AS3

이 Clipboard 객체에 사용 가능한 데이터 형식의 이름을 포함하는 문자열의 배열입니다.

표준 형식의 이름에 대한 문자열 상수는 ClipboardFormats 클래스에서 정의됩니다. 응용 프로그램에서 정의한 다른 문자열도 형식 이름으로 사용되어 데이터를 객체로 전송할 수 있습니다.

관련 API 요소

 var availableFormats:Array = Clipboard.generalClipboard.formats;

운영 체제 클립보드입니다.

시스템 클립보드에 붙여넣은 모든 데이터는 다른 응용 프로그램에서 사용할 수 있습니다. 웹 브라우저에서 실행 중인 보안되지 않은 원격 코드가 여기에 포함될 수 있습니다.

참고: Flash Player 10 응용 프로그램에서 클립보드의 붙여넣기 작업을 처음 실행하는 경우 사용자 이벤트(예: 붙어넣기 명령에 대한 키보드 단축키 또는 컨텍스트 메뉴에서 붙여넣기 명령을 마우스로 클릭)가 필요합니다. Clipboard.getData()는 InteractiveObject가 수신했고 붙여넣기 이벤트를 실행하는 경우에만 클립보드의 내용을 반환합니다. 다른 상황에서는 Clipboard.getData() 호출이 제대로 수행되지 않습니다. AIR에서는 응용 프로그램 샌드박스 외부 내용에도 같은 제한 사항이 적용됩니다.

generalClipboard 객체는 자동으로 생성됩니다. 이 속성에 Clipboard의 또 다른 인스턴스를 할당할 수 없습니다. 대신 getData() 및 setData() 메서드를 사용하여 기존 객체에서 데이터를 읽고 씁니다.

모든 형식으로 된 이전 데이터가 지워지지 않도록 클립보드에 새 데이터를 쓰기 전에 항상 클립보드를 지워야 합니다.

generalClipboard 객체는 AIR NativeDragManager에 전달할 수 없습니다. AIR 응용 프로그램에서 기본 드래그 앤 드롭 작업에 대해 새 Clipboard 객체를 만드십시오.

 import flash.desktop.ClipboardFormats;
 
 var copy:String = "A string to copy to the system clipboard.";
 Clipboard.generalClipboard.clear();
 Clipboard.generalClipboard.setData(ClipboardFormats.TEXT_FORMAT, copy);

 import flash.desktop.ClipboardFormats;
 
 var pasteData:String  = Clipboard.generalClipboard.getData(ClipboardFormats.TEXT_FORMAT) as String;

파일 프로미스 클립보드 형식이 클라이언트 시스템에서 지원되는지 여부를 나타냅니다.

빈 Clipboard 객체를 만듭니다.

Adobe AIR에서 기본 드래그 앤 드롭 동작의 데이터를 유지하려면 Clipboard 객체를 만듭니다. Clipboard 객체는 하나의 드래그 앤 드롭 동작에 대해서만 사용할 수 있으며 다시 사용할 수 없습니다.

복사하여 붙여넣기 작업에 대해 Clipboard 객체를 만들지 마십시오. 대신에 단일 Clipboard.generalClipboard 객체를 사용하십시오.

관련 API 요소

 import flash.desktop.Clipboard;
 
 var clipboard:Clipboard = new Clipboard();

이 Clipboard 객체에서 데이터 표현을 모두 삭제합니다.

 Clipboard.generalClipboard.clear();

지정된 형식에 대한 데이터 표현을 삭제합니다.

매개 변수

 import flash.desktop.ClipboardFormats;
 
 Clipboard.generalClipboard.clearData(ClipboardFormats.TEXT_FORMAT);

지정된 형식의 데이터가 있을 경우 클립보드 데이터를 가져옵니다.

Flash Player에서는 getData()를 paste 이벤트 핸들러에서 호출해야 합니다. AIR에서는 이 제한이 응용 프로그램 보안 샌드박스 외부의 내용에만 적용됩니다.

표준 데이터 형식에 액세스할 때는 데이터가 해당 Flash 데이터 유형의 새 객체로 반환됩니다.

응용 프로그램에서 정의된 형식에 액세스할 때는 transferMode 매개 변수의 값이 원본 객체에 대한 참조가 반환되는지 또는 원본 객체의 직렬화된 복사본이 포함된 익명 객체가 반환되는지를 결정합니다. originalPreferred 또는 clonePreferred 모드가 지정된 경우 원하는 버전을 사용할 수 없으면 Flash Player 또는 AIR에서 대체 버전을 반환합니다. originalOnly 또는 cloneOnly 모드가 지정되어 있으면 요청된 버전을 사용할 수 없는 경우 Flash Player 또는 AIR에서 null을 반환합니다.

매개 변수

관련 API 요소

 import flash.desktop.ClipboardFormats;

 var pasteData:String = Clipboard.generalClipboard.getData(ClipboardFormats.TEXT_FORMAT) as String;

지정된 형식의 데이터가 이 Clipboard 객체에 있는지 여부를 확인합니다.

표준 형식 이름을 참조하려면 ClipboardFormats 클래스에 있는 상수를 사용합니다.

매개 변수

관련 API 요소

if(Clipboard.generalClipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)){
    //do something 
}

지정된 데이터 형식으로 전송할 정보의 표현을 추가합니다.

Adobe AIR의 응용 프로그램 샌드박스에서는 setData()를 언제든지 호출할 수 있습니다. 다른 컨텍스트에서는 키 누르기나 마우스 클릭과 같은 사용자 생성 이벤트에 대한 응답으로만 setData()를 호출할 수 있습니다.

같은 정보의 여러 가지 표현을 서로 다른 형식으로 클립보드에 추가할 수 있습니다. 그러면 다른 구성 요소나 응용 프로그램이 사용 가능한 데이터를 더욱 잘 활용할 수 있습니다. 예를 들어 이미지를 이미지 편집 응용 프로그램에서 사용할 비트맵 데이터로, URL로, 기본 파일 시스템에 전송할 인코딩된 PNG 파일로 추가할 수 있습니다.

데이터 매개 변수는 지정된 형식에 대해 적절한 데이터 유형이어야 합니다.

사용자 정의 형식 이름은 "air:" 또는 "flash:"로 시작될 수 없습니다. 사용자 정의 형식을 사용할 때 이름 충돌을 방지하려면 응용 프로그램 ID 또는 패키지 이름을 형식의 접두어로 사용하는 것이 좋습니다(예: "com.example.applicationName.dataPacket").

응용 프로그램 내에서 또는 응용 프로그램 간에 전송할 때는 serializable 매개 변수가 참조 및 복사본을 모두 사용할 수 있는지 아니면 객체에 대한 참조만 사용할 수 있는지를 결정합니다. 데이터 객체의 참조 및 복사본을 모두 사용할 수 있도록 하려면 serializable을 true로 설정하십시오. 객체 참조만 사용할 수 있도록 하려면 serializable을 false로 설정하십시오. 객체 참조는 현재 응용 프로그램 내에서만 유효합니다. 따라서 serializable을 false로 설정하면 다른 Flash Player 또는 AIR 응용 프로그램에서도 해당 형식의 데이터를 사용할 수 없습니다. 구성 요소에서는 해당 형식의 데이터에 액세스할 때 적절한 클립보드 전송 모드를 설정하여 객체의 참조 또는 복사본을 가져올 수 있습니다.

참고: 데이터를 붙여넣거나 지원되는 응용 프로그램 외부로 드래그할 때는 표준 형식이 항상 기본 형식으로 변환됩니다. 따라서 serializable 매개 변수의 값은 Flash 기반 응용 프로그램이 아닌 응용 프로그램으로 전달되는 표준 형식 데이터의 가용성에는 영향을 주지 않습니다.

한 형식에 대해 데이터의 렌더링을 지연하려면 setDataHandler() 메서드를 대신 사용하십시오. setData() 및 setDataHandler() 메서드를 모두 사용하여 같은 형식 이름으로 데이터 표현을 추가하는 경우에는 핸들러 함수가 호출되지 않습니다.

참고: Mac OS에서 format 매개 변수를 ClipboardFormats.URL_FORMAT으로 설정하면 유효한 URL일 때만 URL이 전송됩니다. 그렇지 않을 경우 Clipboard 객체가 비어 있게 되며 getData()를 호출하면 null이 반환됩니다.

매개 변수

관련 API 요소

 import flash.desktop.ClipboardFormats;
 
 var htmlString:String = "<html><body>Body content</body></html>";
 Clipboard.generalClipboard.setData(ClipboardFormats.TEXT_FORMAT, urlString);
 Clipboard.generalClipboard.setData(ClipboardFormats.HTML_FORMAT, urlString);

전송할 데이터를 생성하는 핸들러 함수에 대한 참조를 추가합니다.

핸들러 함수를 사용하여 데이터가 실제로 액세스될 때까지 데이터의 생성 또는 렌더링을 지연합니다.

핸들러 함수는 지정된 형식에 대해 적절한 데이터 유형을 반환해야 합니다.

핸들러 함수는 지정된 형식의 데이터를 읽을 때만 호출됩니다. 경우에 따라 드롭이 발생하기 전에 운영 체제가 함수를 호출하기도 합니다. 예를 들어 핸들러 함수를 사용하여 AIR 응용 프로그램에서 파일 시스템으로 드래그한 파일의 데이터를 제공할 때 드래그 동작이 AIR 응용 프로그램을 떠나는 즉시 운영 체제는 데이터 핸들러 함수를 호출하며, 이로 인해 일반적으로 파일 데이터를 다운로드하거나 만들 때 원치 않는 일시 정지가 발생합니다. 대신 URLFilePromise를 사용하여 이러한 작업을 수행할 수 있습니다.

응용 프로그램에서 데이터 보호 조치를 취하지 않는 한, 기본 데이터가 변경되어 핸들러가 추가되었을 때와 데이터를 읽을 때 서로 다를 수 있습니다. 클립보드에서 핸들러 함수로 표시되는 데이터를 두 번 이상 읽을 때 발생하는 비헤이비어는 보장할 수 없습니다. 클립보드는 첫 번째 함수에서 생성된 데이터를 반환하거나 해당 함수를 다시 호출할 수 있습니다. 둘 모두 의존할 수 있는 비헤이비어는 아닙니다.

Adobe AIR의 응용 프로그램 샌드박스에서는 setDataHandler()를 언제든지 호출할 수 있습니다. 다른 컨텍스트에서는 키 누르기나 마우스 클릭과 같은 사용자 생성 이벤트에 대한 응답으로만 setDataHandler()를 호출할 수 있습니다.

이 Clipboard 객체에 데이터를 직접 추가하려면 setData() 메서드를 대신 사용하십시오. setData() 및 setDataHandler() 메서드를 모두 같은 형식 이름으로 호출하는 경우에는 핸들러 함수가 호출되지 않습니다.

참고: Mac OS에서 format 매개 변수를 ClipboardFormats.URL_FORMAT으로 설정하면 핸들러 함수가 유효한 URL을 반환할 때만 URL이 전송됩니다. 그렇지 않을 경우 Clipboard 객체가 비어 있게 되며 getData()를 호출하면 null이 반환됩니다.

매개 변수

관련 API 요소

 import flash.desktop.ClipboardFormats;
 
 Clipboard.generalClipboard.setDataHandler(ClipboardFormats.TEXT_FORMAT, randomNumberGenerator);

 public function randomNumberGenerator():String{
     return Math.random().toString();
 }

1. 데이터(이 경우 문자열)를 Clipboard.generalClipboard에 작성합니다.
2. Clipboard.generalClipboard에서 클립보드 내용을 읽습니다.

참고: 클립보드 데이터에 액세스할 때 적용되는 보안 제한 사항으로 인해 이 예제는 Flash Player에서 작동하지 않습니다. Flash Player에서는 Clipboard 객체의 getData() 메서드만 paste 이벤트 핸들러에서 호출할 수 있습니다.

package
{
    import flash.display.Sprite;
    import flash.desktop.Clipboard;
    import flash.desktop.ClipboardFormats;
    import flash.desktop.ClipboardTransferMode;

    public class ClipboardExample extends Sprite
    {
        public function ClipboardExample()
        {
            var sally:String = "Sally";
            var person:String;
            
            copy(sally);
            person = paste();
            trace(person); //traces: "Sally"
        }

        private function copy(text:String):void 
        {
            Clipboard.generalClipboard.clear();
            Clipboard.generalClipboard.setData(ClipboardFormats.TEXT_FORMAT, text);
        }
        
        private function paste():String
        {
            if(Clipboard.generalClipboard.hasFormat(ClipboardFormats.TEXT_FORMAT))
            {
                return String(Clipboard.generalClipboard.getData(ClipboardFormats.TEXT_FORMAT));
            } 
            else 
            {
                return null;
            }
        }
        
    }
}