개요

Tray 의 PopupMenu 오브젝트입니다. 
시스템이 제공하는 API PopupMenu를 사용합니다.

지원 환경

속성

captioncolumn

innerdataset 속성에 설정된 DataSet 의 Column 중 팝업메뉴 아이템의 텍스트가 정의된 Column 을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- innerdataset 속성에 설정된 DataSet 의 Column 만 설정할 수 있습니다.

- captioncolumn 속성에 설정된 Column 의 데이터가 각 팝업메뉴 아이템에 텍스트로 표시됩니다.

- 설정된 Column 의 데이터값이 "-" 이면 아이템 간의 구분선으로 처리되며, 구분선은 CSS 관련 속성이 적용되지 않습니다.

- innerdataset, idcolumn, levelcolumn, captioncolumn 속성을 모두 설정해야 메뉴 아이템이 정상적으로 표시됩니다.

checkboxcolumn

체크이미지를 서브메뉴 아이템에 표시할지 여부가 정의된 Column 을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- innerdataset 속성에 설정된 DataSet 의 Column 만 설정할 수 있습니다.

- Column 의 데이터가 true 로 처리되면 체크이미지가 표시됩니다.

- Column 에 데이터가 없거나 false 로 처리되면 체크이미지가 표시되지 않습니다.
   이 때, iconcolumn 속성이 설정되어 있다면 아이콘이 표시됩니다.

- innerdataset, idcolumn, levelcolumn, captioncolumn 속성을 모두 설정해야 메뉴 아이템이 정상적으로 표시됩니다.

enablecolumn

innerdataset 속성에 설정된 DataSet 의 Column 중 팝업메뉴 아이템의 활성화 여부가 정의된 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- enablecolumn 속성에 설정된 Column의 데이터가 "false"이면 팝업메뉴 아이템이 비활성화 되어 선택할 수 없습니다.

- enablecolumn 속성에 설정된 Column에 데이터가 없거나 enablecolumn 속성값을 설정하지 않으면 팝업메뉴 아이템이 활성화 됩니다.

- innerdataset 속성에 설정된 DataSet 의 Column만 설정할 수 있습니다.

- innerdataset, idcolumn, levelcolumn, captioncolumn 속성을 모두 설정해야 메뉴 아이템이 정상적으로 표시됩니다.

hotkeycolumn

innerdataset 속성에 설정된 DataSet 의 Column 중 메뉴 아이템의 단축키가 정의된 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- hotkeycolumn 속성에 설정된 Column 에 정의된 단축키가 입력되면 onmenuclick 이벤트가 발생합니다.
  단축키 입력 시 수행할 동작을 onmenuclick 이벤트에 정의하여야 합니다.

- innerdataset 속성에 설정된 DataSet 의 Column만 설정할 수 있습니다.

- innerdataset, idcolumn, levelcolumn, captioncolumn 속성을 모두 설정해야 메뉴 아이템이 정상적으로 표시됩니다.

활용 예제

• 단축키로 메뉴 실행하기

iconcolumn

팝업메뉴 아이템에 표시되는 아이콘의 정보가 정의된 Column 을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- 시스템에서 지원하는 아이콘 이미지 파일 형식은 비트맵(*.bmp) 입니다.
   Column 에 정의된 값으로 URL 경로의 웹이미지만 사용할 수 있습니다.

- innerdataset 속성에 설정된 DataSet 의 Column 만 설정할 수 있습니다.

- checkboxcolumn 속성이 설정되지 않았거나 false 로 처리될 때 아이템에 아이콘이 표시됩니다.

- innerdataset, idcolumn, levelcolumn, captioncolumn 속성을 모두 설정해야 메뉴 아이템이 정상적으로 표시됩니다.

id

TrayPopupMenu의 고유 식별자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

TrayPopupMenu.id

문법 설정

참고

-  addChild나 insertChild 메소드를 사용하여 컴포넌트를 등록할때 parent 가 자식컴포넌트를 구별하기 위한 고유한 key값입니다.

- 속성명이나 메소드명과 같은 예약어를 id 속성값으로 설정할 경우 오류가 발생할 수 있습니다.

- 컴포넌트의 속성은 아니지만 편의를 위하여 넥사크로 스튜디오에서 설정할 수 있는 기능이 제공됩니다.

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

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

idcolumn

innerdataset 속성에 설정된 DataSet 의 Column 중 팝업메뉴 아이템의 ID가 정의된 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- 시스템이 제공하는 API Menu 를 사용하기 때문에 id 는 innerdataset 의 Row 인덱스로 설정됩니다.
  값을 설정할 수는 있으나 실제 id 로 동작하지는 않습니다.

- innerdataset 속성에 설정된 DataSet 의 Column만 설정할 수 있습니다.

- innerdataset, idcolumn, levelcolumn, captioncolumn 속성을 모두 설정해야 메뉴 아이템이 정상적으로 표시됩니다.

innerdataset

Tray 의 팝업메뉴 아이템이 정의된 DataSet 의 ID를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- innerdataset 속성값에 해당하는 DataSet 이 존재하지 않으면 메뉴 아이템이 표시되지 않습니다.

- innerdataset, idcolumn, levelcolumn, captioncolumn 속성을 모두 설정해야 메뉴 아이템이 정상적으로 표시됩니다.

활용 예제

• 공휴일 지정하기

levelcolumn

innerdataset 속성에 설정된 DataSet 의 Column 중 팝업메뉴 아이템의 상/하위 관계가 정의된 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- 서브메뉴가 표시되기 위해서는 levelcolumn 에 설정된 Column의 데이터가 트리구조로 정의되어 있어야 합니다.
  최상위 메뉴 아이템은 "0" 레벨로 시작하며 레벨값이 증가하면 단계적으로 하위 메뉴로 표시됩니다.
  즉, "0" 레벨 데이터는 다음에 "0" 레벨 데이터가 정의될 때까지 정의된 모든 데이터의 상위메뉴가 됩니다.

- innerdataset 속성에 설정된 DataSet 의 Column만 설정할 수 있습니다.

- innerdataset, idcolumn, levelcolumn, captioncolumn 속성을 모두 설정해야 메뉴 아이템이 정상적으로 표시됩니다.

userdatacolumn

innerdataset 속성에 설정된 DataSet의 Column 중 사용자 데이터를 처리하기 위한 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- innerdataset 속성에 설정된 DataSet 의 Column만 설정할 수 있습니다.

- 팝업메뉴 아이템 별로 처리해야 하는 데이터를 저장하기 위해 사용합니다.

메서드

trackPopup

Tray 의 팝업메뉴를 마우스 커서 위치에 표시하는 메소드입니다.

지원 환경

문법

TrayPopupMenu.trackPopup()

파라미터

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

이벤트

oninnerdatachanged

TrayPopupMenu 의 innerdataset 속성에 바인딩된 DataSet 에서 데이터 변경이 된 후 발생하는 이벤트입니다.

지원 환경

문법

oninnerdatachanged(obj:nexacro.TrayPopupMenu,e:nexacro.InnerdataChangedEventInfo);

파라미터

참고

- innerdataset 속성에 바인딩된 DataSet 의 Data 가 변경되면 oninnerdatachanged 이벤트가 발생합니다.
  일반적으로 DataSet 에서 onvaluechanged 이벤트가 발생한 후 변경된 값이 바인딩된 객체에 영향을 미칠때 이벤트가 발생합니다.
  예를 들어 DataSet 의 Data 변경에 의해 TrayPopupMenu 의 아이템 길이가 변경되면 이벤트가 발생합니다.

- 컴포넌트 크기가 innerdataset 속성에 바인딩된 DataSet 값에 의해 변경되어 화면의 재배열이 필요할 경우 해당 이벤트에 정의합니다.

onmenuclick

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

지원 환경

문법

onmenuclick(obj:nexacro.TrayPopupMenu,e:nexacro.MenuClickEventInfo);

파라미터

참고

- 메뉴 아이템 영역 내에서 마우스의 lbuttondown 액션과 lbuttonup 액션이 발생되어야 합니다.

- 하위 메뉴가 있는 아이템은 마우스 클릭을 해도 onmenuclick 이벤트가 발생되지 않습니다