윈도우 관리

윈도우를 조작하려면 먼저 윈도우 인스턴스를 얻어야 합니다. 다음 중 하나에서 윈도우 인스턴스를 얻을 수 있습니다.

• 윈도우를 만드는 데 사용되는 기본 윈도우 생성자:

  var win:NativeWindow = new NativeWindow(initOptions);

• 윈도우 스테이지의 nativeWindow 속성:

  var win:NativeWindow = stage.nativeWindow;

• 윈도우에 있는 표시 객체의 stage 속성:

  var win:NativeWindow = displayObject.stage.nativeWindow;

• 윈도우에서 전달하는 기본 윈도우 이벤트의 target 속성:

  private function onNativeWindowEvent(event:NativeWindowBoundsEvent):void 
  { 
      var win:NativeWindow = event.target as NativeWindow; 
  }

• 윈도우에 표시되는 HTML 페이지의 nativeWindow 속성:

  var win:NativeWindow = htmlLoader.window.nativeWindow;

• NativeApplication 객체의 activeWindow 및 openedWindows 속성:

  var nativeWin:NativeWindow = NativeApplication.nativeApplication.activeWindow; 
  var firstWindow:NativeWindow = NativeApplication.nativeApplication.openedWindows[0];

  NativeApplication.nativeApplication.activeWindow 는 응용 프로그램의 활성 윈도우를 참조합니다. 그러나 활성 윈도우가 이 AIR 응용 프로그램의 윈도우가 아닌 경우 null 을 반환합니다. NativeApplication.nativeApplication.openedWindows 배열에는 AIR 응용 프로그램에서 닫히지 않은 모든 윈도우가 포함됩니다.

Flex mx:WindowedApplication 및 mx:Window 객체가 표시 객체이기 때문에 다음과 같이 stage 속성을 사용하여 MXML 파일에서 응용 프로그램 윈도우를 쉽게 참조할 수 있습니다.

<?xml version="1.0" encoding="utf-8"?> 
<mx:WindowedApplication xmlns:mx="http://www.adobe.com/2006/mxml" applicationComplete="init();"> 
    <mx:Script> 
        <![CDATA[ 
            import flash.display.NativeWindow; 
 
            public function init():void{ 
                var appWindow:NativeWindow = this.stage.nativeWindow; 
                //set window properties 
                appWindow.visible = true; 
            } 
        ]]> 
    </mx:Script> 
</WindowedApplication

윈도우를 활성화하려면 NativeWindow activate() 메서드를 호출합니다. 윈도우를 활성화하면 윈도우가 맨 앞에 배치되고 키보드 및 마우스 포커스를 갖게 되며 필요한 경우 윈도우를 복원하거나 visible 속성을 true 로 설정하여 윈도우를 표시할 수 있습니다. 윈도우를 활성화할 때 응용 프로그램에서 다른 윈도우의 순서는 변경되지 않습니다. activate() 메서드를 호출하면 윈도우에서 activate 이벤트를 전달합니다.

활성화하지 않고 숨겨진 윈도우를 표시하려면 visible 속성을 true 로 설정합니다. 이렇게 하면 윈도우가 맨 앞에 배치되지만 윈도우에 포커스가 할당되지 않습니다.

윈도우를 숨기려면 visible 속성을 false 로 설정합니다. 윈도우를 숨기면 윈도우, 관련 작업 표시줄 아이콘 및 Mac OS X에서는 Windows 메뉴의 항목이 표시되지 않습니다.

윈도우의 가시성을 변경하면 해당 윈도우가 소유한 모든 윈도우의 가시성 또한 변경됩니다. 예를 들어 특정 윈도우를 숨기는 경우 이 윈도우가 소유한 모든 윈도우도 숨겨집니다.

AIR에서는 윈도우의 표시 순서를 직접 변경하는 몇 가지 방법을 제공합니다. 윈도우를 표시 순서의 앞이나 뒤로 이동하거나 다른 윈도우의 위나 아래로 이동할 수 있습니다. 이와 동시에 사용자가 윈도우를 활성화하여 윈도우의 순서를 재배열할 수 있습니다.

alwaysInFront 속성을 true 로 설정하여 다른 윈도우 앞에 윈도우를 유지할 수 있습니다. 두 개 이상의 윈도우에 이 설정이 있으면 이러한 윈도우의 표시 순서가 서로 정렬되지만 이러한 윈도우는 alwaysInFront 가 false로 설정된 윈도우 위에 항상 정렬됩니다.

또한 AIR 응용 프로그램이 활성화되어 있지 않은 경우에도 최상위 그룹의 윈도우가 다른 응용 프로그램의 윈도우 위에 표시됩니다. 이 비헤이비어는 사용자에게 방해가 될 수 있기 때문에 필요하고 적절한 경우에만 alwaysInFront 를 true 로 설정해야 합니다. 이러한 설정이 적합한 예는 다음과 같습니다.

• 도구 설명, 팝업 목록, 사용자 정의 메뉴 또는 콤보 상자와 같은 컨트롤의 임시 팝업 윈도우. 이러한 윈도우는 포커스를 잃으면 닫혀야 하기 때문에 사용자가 다른 윈도우를 보지 못하게 차단하는 불편을 방지할 수 있습니다.

• 매우 긴급한 오류 메시지 및 경고. 사용자가 시기 적절하게 응답하지 않으면 취소할 수 없는 변경이 발생할 수 있는 경우 경고 윈도우를 맨 앞에 배치하는 것이 적절할 수 있습니다. 그러나 대부분의 오류와 경고는 일반 윈도우 표시 순서로 처리될 수 있습니다.

• 잠시 사용되는 토스트 스타일 윈도우

특정 윈도우가 다른 여러 윈도우를 소유한 경우 이러한 윈도우는 항상 해당 윈도우 앞에 정렬됩니다. 다른 윈도우를 소유한 윈도우에서 orderToFront() 를 호출하거나 alwaysInFront 를 true 로 설정하면 소유된 윈도우가 소유 윈도우와 함께 다른 윈도우들 앞에 다시 정렬되지만 소유된 윈도우는 여전히 소유 윈도우 앞에 표시됩니다.

소유된 윈도우에서 윈도우 정렬 메서드를 호출하는 작업은 동일한 윈도우에 소유된 윈도우 간에 정상적으로 작동하지만 전체 소유된 윈도우 그룹의 순서 또한 해당 그룹 외부의 윈도우와 비교해 변경될 수 있습니다. 예를 들여 소유된 윈도우에서 orderToFront() 를 호출하면 해당 윈도우와 소유 윈도우, 그리고 이 윈도우에서 소유한 다른 모든 윈도우가 윈도우 표시 순서의 맨 앞으로 이동합니다.

NativeWindow 클래스는 다른 윈도우에 상대적으로 윈도우의 표시 순서를 설정하기 위한 다음 속성과 메서드를 제공합니다.

Linux 운영 체제에서는 윈도우 표시 순서와 관련하여 윈도우 관리자마다 서로 다른 규칙이 적용됩니다.

• 일부 윈도우 관리자에서 유틸리티 윈도우는 항상 일반 윈도우 앞에 표시됩니다.

• 일부 윈도우 관리자에서 alwaysInFront 가 true 로 설정된 전체 화면 윈도우는 항상 alwaysInFront 가 동일하게 true 로 설정된 다른 윈도우 앞에 표시됩니다.

윈도우를 닫으려면 NativeWindow.close() 메서드를 사용합니다.

윈도우를 닫으면 윈도우의 내용이 언로드되지만 다른 객체가 이 내용에 대한 참조를 가진 경우 내용 객체가 삭제되지 않습니다. NativeWindow.close() 메서드는 비동기적으로 실행되며 윈도우에 포함된 응용 프로그램이 닫는 과정 중에 계속 실행됩니다. close 메서드는 닫기 작업이 완료되면 close 이벤트를 전달합니다. NativeWindow 객체는 기술적으로 유효하지만 닫힌 윈도우에 대한 속성과 메서드에 액세스하는 경우 대부분 IllegalOperationError가 생성됩니다. 닫힌 윈도우는 다시 열 수 없습니다. 윈도우의 closed 속성을 확인하여 윈도우가 닫혔는지 테스트할 수 있습니다. 윈도우를 숨기려면 NativeWindow.visible 속성을 false 로 설정합니다.

Nativeapplication.autoExit 속성이 기본값인 true 이면 마지막 윈도우가 닫힐 때 응용 프로그램이 종료됩니다.

소유 윈도우가 있는 모든 윈도우는 해당 소유 윈도우가 닫히면 모두 닫힙니다. 소유된 윈도우는 closing 이벤트를 전달하지 않기 때문에 클로저를 방지할 수 없습니다. close 이벤트가 전달됩니다.

윈도우에서 시스템 크롬을 사용하는 경우 적절한 이벤트를 수신하고 해당 이벤트의 기본 비헤이비어를 취소하여 윈도우와 사용자의 상호 작용을 취소할 수 있습니다. 예를 들어 사용자가 시스템 크롬 닫기 버튼을 클릭하면 closing 이벤트가 전달됩니다. 등록된 리스너에서 이벤트의 preventDefault() 메서드를 호출하면 윈도우가 닫히지 않습니다.

윈도우에서 시스템 크롬을 사용하지 않는 경우에는 의도한 변경의 알림 이벤트가 변경이 수행되기 전에 자동으로 전달되지 않습니다. 따라서 윈도우를 닫기 위한 메서드를 호출하여 윈도우 상태를 변경하거나 윈도우 경계 속성을 설정하면 변경을 취소할 수 없습니다. 윈도우를 변경하기 전에 응용 프로그램의 구성 요소에 알리려면 응용 프로그램 논리에서는 윈도우의 dispatchEvent() 메서드를 사용하여 관련 알림 이벤트를 전달할 수 있습니다.

예를 들어 다음 논리에서는 윈도우 닫기 버튼에 대한 취소 가능한 이벤트 핸들러를 구현합니다.

public function onCloseCommand(event:MouseEvent):void{ 
    var closingEvent:Event = new Event(Event.CLOSING,true,true); 
    dispatchEvent(closing); 
    if(!closingEvent.isDefaultPrevented()){ 
        win.close(); 
    } 
} 

리스너에서 이벤트 preventDefault() 메서드를 호출하는 경우 dispatchEvent() 메서드는 false 를 반환합니다. 그러나 다른 이유로도 false 를 반환할 수 있으므로 isDefaultPrevented() 메서드를 명시적으로 사용하여 변경을 취소해야 할지 여부를 테스트하는 것이 좋습니다.

윈도우를 최대화하려면 NativeWindow maximize() 메서드를 사용합니다.

myWindow.maximize(); 

윈도우를 최소화하려면 NativeWindow minimize() 메서드를 사용합니다.

myWindow.minimize(); 

윈도우를 복원하려면(즉, 이전의 최소화되었거나 최대화된 크기로 되돌리려면) NativeWindow restore() 메서드를 사용합니다.

myWindow.restore(); 

소유 윈도우가 있는 윈도우는 소유 윈도우가 최소화되거나 복원되면 함께 최소화되고 복원됩니다. 소유된 윈도우는 소유 윈도우가 최소화되어 함께 최소화된 경우에 아무런 이벤트도 전달하지 않습니다.

Linux 운영 체제에서는 윈도우 표시 상태 설정과 관련하여 윈도우 관리자마다 서로 다른 규칙이 적용됩니다.

• 일부 윈도우 관리자에서는 유틸리티 윈도우를 최대화할 수 없습니다.

• 윈도우 크기가 최대로 설정된 경우에는 일부 윈도우에서 윈도우를 최대화할 수 없습니다. 일부 다른 윈도우 관리자는 표시 상태를 최대화된 상태로 설정하지만 윈도우 크기를 조절하지 않습니다. 이러한 두 경우 모두 표시 상태 변경 이벤트가 전달되지 않습니다.

• 일부 윈도우 관리자에서는 윈도우 maximizable 또는 minimizable 설정이 유지되지 않습니다.

아래의 간단한 MXML 응용 프로그램에서는 Window maximize() , minimize() , restore() 및 close() 메서드를 보여 줍니다.

<?xml version="1.0" encoding="utf-8"?> 
 
<mx:WindowedApplication  
    xmlns:mx="http://www.adobe.com/2006/mxml"  
    layout="vertical"> 
     
     
    <mx:Script> 
    <![CDATA[ 
    public function minimizeWindow():void 
    { 
        this.stage.nativeWindow.minimize(); 
    } 
 
    public function maximizeWindow():void 
    { 
        this.stage.nativeWindow.maximize(); 
    }           
     
    public function restoreWindow():void 
    { 
        this.stage.nativeWindow.restore(); 
    }           
 
    public function closeWindow():void 
    { 
        this.stage.nativeWindow.close(); 
    } 
    ]]> 
    </mx:Script> 
 
    <mx:VBox> 
        <mx:Button label="Minimize" click="minimizeWindow()"/> 
        <mx:Button label="Restore" click="restoreWindow()"/> 
        <mx:Button label="Maximize" click="maximizeWindow()"/> 
        <mx:Button label="Close" click="closeWindow()"/> 
    </mx:VBox> 
 
</mx:WindowedApplication>

아래의 Flash용 ActionScript 예제에서는 NativeWindow minimize() , maximize() , restore() 및 close() 메서드를 트리거하는 클릭 가능한 네 가지 텍스트 필드를 만듭니다.

package 
{ 
    import flash.display.Sprite; 
    import flash.events.MouseEvent; 
    import flash.text.TextField; 
     
    public class MinimizeExample extends Sprite 
    { 
        public function MinimizeExample():void  
        { 
            var minTextBtn:TextField = new TextField(); 
            minTextBtn.x = 10; 
            minTextBtn.y = 10; 
            minTextBtn.text = "Minimize"; 
            minTextBtn.background = true; 
            minTextBtn.border = true; 
            minTextBtn.selectable = false; 
            addChild(minTextBtn); 
            minTextBtn.addEventListener(MouseEvent.CLICK, onMinimize); 
         
            var maxTextBtn:TextField = new TextField(); 
            maxTextBtn.x = 120; 
            maxTextBtn.y = 10; 
            maxTextBtn.text = "Maximize"; 
            maxTextBtn.background = true; 
            maxTextBtn.border = true; 
            maxTextBtn.selectable = false; 
            addChild(maxTextBtn); 
            maxTextBtn.addEventListener(MouseEvent.CLICK, onMaximize); 
         
            var restoreTextBtn:TextField = new TextField(); 
            restoreTextBtn.x = 230; 
            restoreTextBtn.y = 10; 
            restoreTextBtn.text = "Restore"; 
            restoreTextBtn.background = true; 
            restoreTextBtn.border = true; 
            restoreTextBtn.selectable = false; 
            addChild(restoreTextBtn); 
            restoreTextBtn.addEventListener(MouseEvent.CLICK, onRestore); 
             
            var closeTextBtn:TextField = new TextField(); 
            closeTextBtn.x = 340; 
            closeTextBtn.y = 10; 
            closeTextBtn.text = "Close Window"; 
            closeTextBtn.background = true; 
            closeTextBtn.border = true; 
            closeTextBtn.selectable = false; 
            addChild(closeTextBtn); 
            closeTextBtn.addEventListener(MouseEvent.CLICK, onCloseWindow); 
        } 
        function onMinimize(event:MouseEvent):void 
        { 
            this.stage.nativeWindow.minimize(); 
        } 
        function onMaximize(event:MouseEvent):void 
        { 
            this.stage.nativeWindow.maximize(); 
        } 
        function onRestore(event:MouseEvent):void 
        { 
            this.stage.nativeWindow.restore(); 
        } 
        function onCloseWindow(event:MouseEvent):void 
        { 
            this.stage.nativeWindow.close(); 
        } 
    } 
}

윈도우에서 시스템 크롬을 사용하는 경우 시스템 크롬은 윈도우 크기 조절과 바탕 화면 위의 이동을 위한 드래그 컨트롤을 제공합니다. 윈도우에서 시스템 크롬을 사용하지 않는 경우에는 사용자가 윈도우 크기를 조절하고 이동할 수 있도록 사용자 고유의 컨트롤을 추가해야 합니다.

다음 예제에서는 윈도우에서 크기 조절 및 이동 작업을 시작하는 방법을 보여 줍니다.

package 
{ 
    import flash.display.Sprite; 
    import flash.events.MouseEvent; 
    import flash.display.NativeWindowResize; 
 
    public class NativeWindowResizeExample extends Sprite 
    { 
        public function NativeWindowResizeExample():void 
        { 
            // Fills a background area. 
            this.graphics.beginFill(0xFFFFFF); 
            this.graphics.drawRect(0, 0, 400, 300); 
            this.graphics.endFill(); 
     
            // Creates a square area where a mouse down will start the resize. 
            var resizeHandle:Sprite =  
                createSprite(0xCCCCCC, 20, this.width - 20, this.height - 20); 
            resizeHandle.addEventListener(MouseEvent.MOUSE_DOWN, onStartResize); 
     
            // Creates a square area where a mouse down will start the move. 
            var moveHandle:Sprite = createSprite(0xCCCCCC, 20, this.width - 20, 0); 
            moveHandle.addEventListener(MouseEvent.MOUSE_DOWN, onStartMove); 
        } 
     
        public function createSprite(color:int, size:int, x:int, y:int):Sprite 
        { 
            var s:Sprite = new Sprite(); 
            s.graphics.beginFill(color); 
            s.graphics.drawRect(0, 0, size, size); 
            s.graphics.endFill(); 
            s.x = x; 
            s.y = y; 
            this.addChild(s);     
            return s;         
        } 
     
        public function onStartResize(event:MouseEvent):void 
        { 
            this.stage.nativeWindow.startResize(NativeWindowResize.BOTTOM_RIGHT); 
        } 
 
        public function onStartMove(event:MouseEvent):void 
        { 
            this.stage.nativeWindow.startMove(); 
        } 
    } 
}