개요

어플리케이션에서 사용되는 시스템 트레이로써 다중 트레이를 등록할 수 있습니다.

지원 환경

생성자

Tray.init(strID, icon, tooltip);

var objApp = nexacro.getApplication() ;
var objTray = new nexacro.Tray("Tray00", objApp);

objTray.init("Tray00", "information", "Tray Tooltip");

var nIndex = objApp.addTray("Tray00", objTray);
objTray.show();

// Get Appication
var objApp = nexacro.getApplication();

// Create Object
var objTray = new nexacro.Tray("Tray00", objApp);

// Init Object    
objTray.init("Tray00", "information", "Tray ToolTip");

//Add Object to Application
var nIndex = objApp.addTray("Tray00", objTray);

// Show Object
objApp.trays["Tray00"].show();

// Remove Object from Application
objApp.removeTray("Tray00"); 
 
// Destroy Object 
objTray.destroy(); 
objTray = null;

속성

icon

작업표시줄에 표시되는 Tray 의 아이콘 이미지를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Tray.icon[= strIcon]

문법 설정

strIcon ::= <systemIcon> | <urlIcon>

참고

- 아이콘 파일의 경로는 시스템 제공 아이콘이나 Web 경로에 있는 ico 파일이 아니면 등록되지 않습니다.

items

Tray 에 등록된 TrayPopupMenu 오브젝트의 정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

Tray.items

문법 설정

var objApp = nexacro.getApplication() ;
var objItem0 = objApp.trays[0].items[0] ;

참고

- Tray 에서 사용하기위해 만들어 놓은 팝업메뉴는 Tray 에서 이벤트를 받았을때 스크립트를 통해 제어합니다.

name

Tray 의 이름을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Tray.name[= strName]

문법 설정

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

tooltip

Tray 아이콘에 마우스 포인터를 올려 놓았을 때 표시되는 풍선도움말을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Tray.tooltip[= strTooltip]

문법 설정

var objApp = nexacro.getApplication();
objApp.trays["Tray0"].tooltip = "Tray ToolTip";

참고

- 마우스 포인터가 Tray 아이콘 영역 위에서 일정시간 움직이지 않으면 풍선도움말이 표시됩니다.

메서드

addItem

Tray 의 items 속성에 TrayPopupMenu 오브젝트를 추가하는 메소드입니다.

지원 환경

문법

Tray.addItem(strID,objPopupMenu)

파라미터

var objTrayMenu = new TrayPopupMenu();
...    // TrayPopupMenu 설정
var objApp = nexacro.getApplication() ;
objApp.trays["Tray0"].addItem("item00", objTrayMenu);

반환

참고

- 이미 등록된 ID 를 추가시키려 할 경우 추가 되지 않습니다.

deleteItem

Tray 의 items 속성에 등록된 TrayPopupMenu 오브젝트를 삭제하는 메소드입니다.

지원 환경

문법

Tray.deleteItem( strID )

파라미터

var objApp = nexacro.getApplication() ;
objApp.trays["Tray0"].deleteItem("popupmenu00");

반환

destroy

스크립트에서 동적으로 생성한 Tray 를 삭제하는 메소드입니다.

지원 환경

문법

Tray.destroy()

파라미터

objTray.destroy();

반환

참고

- 동적으로 생성한 Tray 를 완전히 삭제하기 위해서는 destroy() 메소드를 호출해야 합니다.

findItem

Tray 의 items 속성에 등록된 특정 TrayPopupMenu 오브젝트의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Tray.findItem(strID)

파라미터

var objApp = nexacro.getApplication() ;
objApp.trays["Tray0"].findItem("item00");

반환

getItemCount

Tray 의 items 속성에 등록된 TrayPopupMenu 오브젝트의 갯수를 반환하는 메소드입니다.

지원 환경

문법

Tray.getItemCount()

파라미터

var objApp = nexacro.getApplication() ;
var nItemCnt = objApp.trays["Tray0"].getItemCount();

반환

hideBalloonTip

Tray에 표시된 풍선팁을 숨기는 메소드입니다.

지원 환경

문법

Tray.hideBalloonTip()

참고

메소드 호출 시 onballoontiphide 이벤트가 발생합니다.

init

스크립트로 Tray 를 동적 생성한 후에 초기화하는 메소드입니다.

지원 환경

문법

Tray.init(strID, icon, tooltip);

파라미터

var objApp = nexacro.getApplication() ;
var objTray = new nexacro.Tray("Tray00", objApp);

objTray.init("Tray00", "information", "Tray Tooltip");

var nIndex = objApp.addTray("Tray00", objTray);
objTray.show();

참고

- show() 메소드로 컴포넌트가 화면에 표시되면 초기화가 끝난 상태입니다.
  초기화가 끝난 후에 init() 메소드를 호출하면 오류가 발생하며 설정한 값은 적용되지 않습니다.

- 스크립트에서 동적으로 Tray를 생성한 후에만 사용할 수 있습니다.
  동적으로 생성한 Tray가 아닌 경우에는 오동작이 발생할수 있습니다.

- 동적으로 Tray 를 생성 시 초기값을 설정한 경우에는 init() 메소드를 다시 호출할 필요가 없습니다.

insertItem

Tray 의 items 속성의 특정 위치에 TrayPopupMenu 오브젝트를 추가하는 메소드입니다.

지원 환경

문법

Tray.insertItem(nIndex, strID, objPopupMenu)

파라미터

var objApp = nexacro.getApplication() ;
var objTrayMenu = new TrayPopupMenu();
...    // TrayPopupMenu 설정
var nIndex = objApp.trays["Tray0"].insertItem(1, "item00", objTrayMenu );

반환

참고

- 이미 등록된 ID 를 추가시키려 할 경우 추가 되지 않습니다.

show

스크립트에서 동적으로 생성한 Tray 를 작업표시줄에 표시하는 메소드입니다.

지원 환경

문법

Tray.show()

파라미터

var objApp = nexacro.getApplication() ;
var objTray = new nexacro.Tray("Tray00", objApp);

objTray.init("Tray00", "information", "Tray Tooltip");
var nIndex = objApp.addTray("Tray00", objTray);

objApp.trays["Tray00"].show();

참고

- 스크립트에서 Tray 를 동적으로 생성한 후에만 사용이 가능합니다.
   동적으로 생성한 Tray 가 아닌 경우에는 오동작이 발생할 수 있습니다.

- Application 의 addTray() 메소드를 사용하여 동적으로 생성한 Tray 를 추가한 후에 show() 메소드를 수행하여야 합니다.

- 동적으로 Tray 를 생성 시 초기값을 설정한 경우에는 init() 메소드를 다시 호출할 필요가 없습니다.

showBalloonTip

Tray 에 풍선팁을 표시하는 메소드입니다.

지원 환경

문법

Tray.showBalloonTip(strTitleIcon, strTitle, strText [, bNoSound])

파라미터

var objApp = nexacro.getApplication() ;

objApp.trays["Tray0"].showBalloonTip("information", "안내", "업데이트가 준비되었습니다.");
objApp.trays["Tray0"].showBalloonTip("information", "안내", "업데이트가 준비되었습니다.", false);

참고

풍선팁이 표시된 상태에서 showBalloonTip 메소드를 실행하면 기존 풍선팁이 숨겨지고 새로운 풍선팁이 표시됩니다.

이벤트

onballoontipclick

Tray에 표시된 풍선팁을 클릭할 때 발생하는 이벤트입니다.

지원 환경

문법

onballoontipclick(obj:nexacro.Tray,e:nexacro.ClickEventInfo);

파라미터

참고

풍선팁 클릭 시 풍선팁은 자동으로 숨겨집니다.
풍선팁을 클릭해서 숨겨지는 경우에는 onballoontiphide 이벤트가 발생하지 않습니다.

onballoontiphide

Tray에 표시된 풍선팁이 숨겨질 때 발생하는 이벤트입니다.

지원 환경

문법

onballoontiphide(obj:nexacro.Tray,e:nexacro.TrayBalloonTipHideEventInfo);

파라미터

참고

hideBalloonTip 메소드를 호출하거나 timeout에 의해 풍선팁이 숨겨질 때 이벤트가 발생합니다.

onballoontipshow

Tray에 풍선팁을 표시할 때 발생하는 이벤트입니다.

지원 환경

문법

onballoontipshow(obj:nexacro.Tray,e:nexacro.EventInfo);

파라미터

ondblclick

Tray 아이콘을 마우스 왼쪽버튼으로 더블클릭 했을 때 발생하는 이벤트입니다.

지원 환경

문법

ondblclick(obj:nexacro.Tray,e:nexacro.MouseEventInfo);

파라미터

참고

- ondblclick 이벤트는 onlbuttonup -> onlbuttonup -> ondblclick 순서로 발생합니다.

onlbuttonup

Tray 아이콘에서 마우스 왼쪽버튼을 클릭했을 때 발생하는 이벤트입니다.

지원 환경

문법

onlbuttonup(obj:nexacro.Tray,e:nexacro.MouseEventInfo);

파라미터

onrbuttonup

Tray 아이콘에서 마우스 오른쪽버튼을 클릭했을 때 발생하는 이벤트입니다.

지원 환경

문법

onrbuttonup(obj:nexacro.Tray,e:nexacro.MouseEventInfo);

파라미터