MultiCombo

개요

MultiCombo는 미리 설정된 아이템 리스트에서 여러 개의 아이템을 선택하기 위한 용도로 사용되는 컴포넌트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




컴포넌트 구조

컴포넌트, 내부 컨텐츠 크기

edittype 속성값이 "text" 또는 "count" 일 때 MultiCombo 컴포넌트와 내부 콘텐츠 크기를 결정하는 기준입니다.

MultiCombo Component

Width

MultiCombo 컴포넌트의 width 속성값이 적용됩니다.

내부 콘텐츠의 Width 보다 작을 경우 내부 콘텐츠가 잘려서 표시됩니다.

Height

MultiCombo 컴포넌트의 height 속성값이 적용됩니다.

내부 콘텐츠의 Height 보다 작을 경우 내부 콘텐츠가 잘려서 표시됩니다.

multicombotext Control

Left

0으로 적용됩니다.

Top

0으로 적용됩니다.

Width

MultiCombo 컴포넌트의 Width에서 dropbutton 컨트롤의 Width를 뺀 값이 적용됩니다.

Height

MultiCombo 컴포넌트의 Height 가 적용됩니다.

dropbutton Control

Left

MultiCombo 컴포넌트의 Width 에서 dropbutton 컨트롤의 Width 를 뺀 값이 적용됩니다.

Top

0 으로 적용됩니다.

Width

buttonsize 속성값이 적용됩니다.

buttonsize 속성값이 없으면 MultiCombo 컴포넌트의 Height 가 적용됩니다.

Height

MultiCombo 컴포넌트의 Height 가 적용됩니다.

multicomboedit Control(type 속성값이 "dropdown"일 때)

-

type 속성값이 "dropdown"일 경우, 표시되지 않습니다.

multicomboedit Control(type 속성값이 "dropdown"이 아닐 때)

Left

0으로 적용됩니다.

Top

0으로 적용됩니다.

Width

MultiCombo 컴포넌트의 Width가 적용됩니다.

Height

textsize + padding값이 적용됩니다.

checkboxset Control

Left

MultiCombo 컴포넌트의 left 속성값이 적용됩니다.

MultiCombo 컴포넌트의 오른쪽에 multicombolist 컨트롤이 표시될 공간이 없다면 왼쪽 공간에 맞게 재계산되어 적용됩니다.

Top

MultiCombo 컴포넌트의 bottom 속성값이 적용됩니다.

MultiCombo 컴포넌트의 아래쪽에 multicombolist 컨트롤이 표시될 공간이 없다면 위쪽 공간에 맞게 재계산되어 적용됩니다.


  • dropdown이 아닌 경우, multicomboedit의 Height가 추가되어 적용됩니다.

  • selectallcheckbox가 있으면 selectallcheckbox의 Height로 추가되어 적용됩니다.

Width

checkboxsetitem 컨트롤의 Width 가 적용됩니다.

multicombolist 컨트롤이 표시될 공간의 너비보다 클 경우 자동으로 재계산되어 적용됩니다.


  • selectallcheckbox가 있으면 selectallcheckbox의 Width와 비교하여 큰 값으로 적용됩니다.

Height

MultiCombo 컴포넌트의 displayrowcount 속성값에 checkboxsetitem 컨트롤의 Height를 곱한 값이 적용됩니다.

MultiCombo 컴포넌트의 displayrowcount 속성값이 없으면 checkboxsetitem 컨트롤의 개수에 checkboxsetitem 컨트롤의 Height를 곱한 값이 적용됩니다.

checkboxsetitem Control

Left

0 으로 적용됩니다.

Top

checkboxsetitem 컨트롤의 갯수와 checkboxsetitem 컨트롤의 Height 에 따라 각 아이템별로 계산된 값이 적용됩니다.

Width

checkboxsetitem 에 표시되는 텍스트 중 가장 긴 텍스트에 맞게 계산된 값이 적용됩니다.

Height

MultiCombo 컴포넌트의 itemheight 속성값이 적용됩니다.

MultiCombo 컴포넌트의 itemheight 속성값이 없으면 텍스트 크기에 맞게 계산된 값이 적용됩니다.

selectallcheckbox Control

Left

0으로 적용됩니다.

Top

0으로 적용됩니다.

Dropdown이 아닌 경우, multicomboedit의 Height가 추가되어 적용됩니다.

Width

적용된 fontsize에 따라서 크기가 적용됩니다.

Multicombolist의 크기보다 작으면 popupsize만큼 크기가 적용됩니다.

Height

MultiCombo 컴포넌트의 selectallcheckboxheight 속성값이 적용됩니다.

MultiCombo 컴포넌트의 selectallcheckboxheight 속성값이 없으면 텍스트 크기에 맞게 계산된 값이 적용됩니다.

edittype 속성값이 "singletag" 또는 "multitag"일 때 MultiCombo 컴포넌트와 내부 콘텐츠 크기를 결정하는 기준입니다.

tagboxedit Control(type 속성값이 "dropdown"일 때)

-

type 속성값이 "dropdown"일 경우, 표시되지 않습니다.

tagboxedit Control(type 속성값이 "dropdown"이 아닐 때)

Left

0으로 적용됩니다.

아이템을 선택한 경우 마지막 tagboxitem의 left+width값이 적용됩니다.

edit_left + edit_width가 tagbox의 width를 초과하였을 때 다시 0으로 적용됩니다.

Top

0으로 적용됩니다.

아이템을 선택한 경우 마지막 tagboxitem의 top값이 적용됩니다.

edit_left + edit_width가 tagbox의 width를 초과하였을 때 마지막 tagboxitem의 top+height값이 적용됩니다.

Width

multitagtagbox의 width값의 1/3이 적용됩니다.

Height

textsize + padding값이 적용됩니다.

dropbutton Control

Left

MultiCombo 컴포넌트의 Width 에서 dropbutton 컨트롤의 Width 를 뺀 값이 적용됩니다.

Top

0으로 적용됩니다.

Width

buttonsize 속성값이 적용됩니다.

buttonsize 속성값이 없으면 MultiCombo 컴포넌트의 Height 가 적용됩니다.

Height

MultiCombo 컴포넌트의 Height 가 적용됩니다.

multicombotagbox Control

Left

0 으로 적용됩니다.

Top

0 으로 적용됩니다.

Width

MultiCombo 컴포넌트의 Width 에서 dropbutton 컨트롤의 Width 를 뺀 값이 적용됩니다.

Height

MultiCombo 컴포넌트의 Height 가 적용됩니다.

tagboxitem Control

Left

0으로 적용됩니다.

아이템을 선택한 경우 tag_width + marginsize를 누적하며 계산하여 적용됩니다.


  • multitag인 경우 누적된 width+tagwidth+marginsize(=5)가 tagbox 크기를 초과하면 다시 0으로 적용됩니다.

Top

0으로 적용됩니다.


  • multitag인 경우 누적된 width+tagwidth+marginsize(=5)가 tagbox 크기를 초과할 때마다

tag_height+marginsize(=5) 값을 누적하며 계산하여 적용됩니다.

Width

tagtext 컨트롤의 Width와 tagbutton 컨트롤의 Width와 tagboxitem 컨트롤의 padding.left/right + border.width 값을 더한 값이 적용됩니다.

Height

tagtext 컨트롤의 Height와 tagboxitem 컨트롤의 padding.top/bottom + border.width 값을 더한 값이 적용됩니다.

tagtext Control

Left

0 으로 적용됩니다.

Top

0 으로 적용됩니다.

Width

텍스트 크기에 맞게 계산된 값이 적용됩니다.

Height

텍스트 크기에 맞게 계산된 값이 적용됩니다.

tagbutton Control

Left

tagtext 컨트롤의 Width 와 multicombotag 컨트롤의 padding 값을 더한 값이 적용됩니다.

Top

0 으로 적용됩니다.

Width

tagtext 컨트롤의 Height 가 적용됩니다.

Height

tagtext 컨트롤의 Height 가 적용됩니다.

Basic Key Action

Action

Key

Description

포커스 이동

Tab

Tab 이동 순서에 따라 다음 컴포넌트로 포커스가 이동합니다.

MultiComboList 열기

Alt + 아래방향키 또는 Option + 아래방향키

MultiComboList 가 표시됩니다.

아이템 이동

상하방향키

아이템 항목을 이동합니다.

이동된 위치의 아이템을 결정하려면 Ctrl + Space 를 입력하여야 합니다.

아이템 이동취소

ESC

아이템 항목을 이동했을 때 원래 위치로 이동을 취소합니다.

Ctrl + Space 입력으로 이동된 위치의 아이템이 결정된 상태에서는 위치이동을 취소할 수 없습니다.

아이템 결정

Enter

이동된 위치의 아이템을 선택 결정하여 value 속성에 반영합니다.

아이템 선택/선택취소

Ctrl + Space

하나의 아이템을 선택하거나 선택 취소합니다.

전체 선택/선택취소

Alt + A

전체 아이템을 선택하거나 선택 취소합니다.

영역 선택/선택취소

Shift + 상하방향키

연속된 영역의 아이템을 선택하거나 선택 취소합니다.

스크롤 이동(페이지)

PageUp/PageDown

MultiComboList에 vscrollbar가 활성화됐을 때 페이지 단위(화면에 표시되는 아이템 개수)로 스크롤합니다.

이동된 위치의 아이템을 결정하려면 Ctrl + Space 키를 입력해야 합니다.

스크롤 이동(최상단/최하단)

Home/End

MultiComboList에 vscrollbar가 활성화됐을 때 최상단 또는 최하단으로 스크롤합니다.

이동된 위치의 아이템을 결정하려면 Enter 키를 입력해야 합니다.

type 속성값이 "dropdown"일때만 스크롤 동작에 반영되며 그 외의 경우에는 multicomboedit 캐럿 위치에 반영됩니다.

tagboxitem 선택

좌우방향키

type 속성값이 "dropdown"인 경우, tagboxitem 선택이 안되어 있을 때 좌 방향키를 누르면 마지막에 추가된 tagboxitem이 선택됩니다.

type 속성값이 "dropdown"이 아닌 경우, 편집영역에 포커스가 있고 caret 위치가 0인 상태에서 좌 방향키를 누르면 마지막에 추가된 tagboxitem이 선택됩니다.


아래와 같은 동작 제약이 있습니다.

- 편집 영역의 caret 위치가 0이 아닌 경우엔 동작하지 않습니다.

- 마지막 tagboxitem가 선택되어 있는 상태에서 우 방향키를 누르면 tagboxitem 선택이 해제되며 편집영역에 포커스가 들어갑니다.


편집영역에 포커스가 들어갈 때와 다른 컴포넌트로 포커스가 이동할 때 선택된 tagboxitem이 있다면 tagboxitem 선택이 해제됩니다.

tagboxitem 삭제

Delete

현재 선택되어 있는 tagboxitem을 삭제합니다.

삭제 후 다음 tagboxitem이 선택됩니다.

마지막 tagboxitem을 삭제했을 때는 선택된 tagboxitem의 이전 tagboxitem이 선택됩니다.

Accessibility Key Action

Action

Key

Description

포커스 이동

Tab

Tab 이동 순서에 따라 다음 컴포넌트로 포커스가 이동합니다.

선택상자 이동

상하방향키

Tab Order 가 이전/다음인 컴포넌트로 선택상자가 이동합니다.

MultiComboList 열기

Alt + 아래방향키 또는 Option + 아래방향키

MultiComboList 가 표시됩니다.

아이템 이동

Ctrl + 상하방향키

아이템 항목을 이동합니다.

이동된 위치의 아이템을 결정하려면 Enter 를 입력하여야 합니다.

아이템 이동취소

ESC

아이템 항목을 이동했을 때 원래 위치로 이동을 취소합니다.

Enter 입력으로 이동된 위치의 아이템이 결정된 상태에서는 위치이동을 취소할 수 없습니다.

아이템 결정

Enter

이동된 위치의 아이템을 선택 결정하여 value 속성에 반영합니다.

아이템 선택/선택취소

Ctrl + Space

하나의 아이템을 선택하거나 선택 취소합니다.

전체 선택/선택취소

Shift + A

전체 아이템을 선택하거나 선택 취소합니다.

영역 선택/선택취소

Shift + 상하방향키

연속된 영역의 아이템을 선택하거나 선택 취소합니다.

스크롤 이동(페이지)

PageUp/PageDown

MultiComboList에 vscrollbar가 활성화됐을 때 페이지 단위(화면에 표시되는 아이템 개수)로 스크롤합니다.

이동된 위치의 아이템을 결정하려면 Enter 키를 입력해야 합니다.

스크롤 이동(최상단/최하단)

Home/End

MultiComboList에 vscrollbar가 활성화됐을 때 최상단 또는 최하단으로 스크롤합니다.

이동된 위치의 아이템을 결정하려면 Enter 키를 입력해야 합니다.

type 속성값이 "dropdown"일때만 스크롤 동작에 반영되며 그 외의 경우에는 multicomboedit 캐럿 위치에 반영됩니다.

생성자

MultiCombo.init( strName, vLeft, vTop , vWidth, vHeight [, vRight, vBottom, [vMinWidth, [vMaxWidth, [vMinHeight, [vMaxHeight]]]]] )

Parameters

Type

Description

strName

String

MultiCombo 의 ID를 문자열로 설정합니다.

vLeft

String, Number

MultiCombo 의 left 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 right 속성값을 기준으로 MultiCombo 의 left 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 left 가 결정됩니다.

vTop

String, Number

MultiCombo 의 top 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 bottom 속성값을 기준으로 MultiCombo 의 top 이 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 top 이 결정됩니다.

vWidth

String, Number

MultiCombo 의 width 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트값은 무시되고 pixel 값으로 MultiCombo 의 width 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 width 가 결정됩니다.

vHeight

String, Number

MultiCombo 의 height 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트값은 무시되고 pixel 값으로 MultiCombo 의 height 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 height 가 결정됩니다.

vRight

String, Number

MultiCombo 의 right 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


vLeft, vWidth 값을 모두 설정했을 경우 vRight 값은 무시됩니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 left 속성값을 기준으로 MultiCombo 의 right 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 right 가 결정됩니다.

vBottom

String, Number

MultiCombo 의 bottom 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


vTop, vHeight 값을 모두 설정했을 경우 vBottom 값은 무시됩니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 top 속성값을 기준으로 MultiCombo 의 bottom 이 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 bottom 이 결정됩니다.

vMinWidth

String, Number

MultiCombo 이(가) 화면에 표시되는 최소 너비값을 pixel 단위의 숫자로 설정합니다.

vMaxWidth

String, Number

MultiCombo 이(가) 화면에 표시되는 최대 너비값을 pixel 단위의 숫자로 설정합니다.


vMinWidth 보다 작은 값을 설정하면 vMinWidth 값으로 설정됩니다.

vMinHeight

String, Number

MultiCombo 이(가) 화면에 표시되는 최소 높이값을 pixel 단위의 숫자로 설정합니다.

vMaxHeight

String, Number

MultiCombo 이(가) 화면에 표시되는 최대 높이값을 pixel 단위의 숫자로 설정합니다.


vMinHeight 보다 작은 값을 설정하면 vMinHeight 값으로 설정됩니다.

var objComp = new MultiCombo();

objComp.init( "MultiCombo00", 30, 120, 196, 46 );
objComp.init( "MultiCombo00", 30, 120, 196, 46, null, null );
objComp.init( "MultiCombo00", null, null, 300, "400px", "80%", 300 );
objComp.init( "MultiCombo00", 0, 0, 200, 100, null, null, 300, 500, 200, 500 );
objComp.init( "MultiCombo00", "MultiCombo22:10", 300, null, null, "MultiCombo33:10", "20%", 300, 500, 200, 500 );
// Create Object  
var objMultiCombo = new MultiCombo();  
objMultiCombo.init("MultiCombo", 30, 120, 196, 46, null, null);
objMultiCombo.init("MultiCombo", null, null, 300, "400px", "80%", 300);
or
var objMultiCombo = new MultiCombo("MultiCombo", 30, 120, 196, 46, null, null);
var objMultiCombo = new MultiCombo("MultiCombo", null, null, 300, "400px", "80%", 300);
 
// Add Object to Parent Form  
this.addChild("MultiCombo", objMultiCombo); 
 
// Insert Object to Parent Form  
this.insertChild(1, "MultiCombo", objMultiCombo); 
 
// Remove Object form Parent Form  
this.removeChild("MultiCombo"); 
 
// Show Object  
objMultiCombo.show(); 
 
// Destroy Object  
objMultiCombo.destroy(); 
objMultiCombo = null;

Status

Name

Type

Description

disabled

status

컴포넌트가 비활성화된 상태

readonly

status

컴포넌트가 읽기 전용인 상태

mouseover

status

마우스 커서가 컴포넌트 또는 컴포넌트의 특정 아이템 위에 있는 상태

focused

status

컴포넌트가 포커스를 받은 상태

enabled

status

컴포넌트가 활성화된 상태

Control

Name

TypeName

dropbutton

nexacro.Button

multicombolist

nexacro.MultiComboListControl

multicombotext

nexacro.Edit

multicombotagbox

nexacro.MultiComboTagBoxControl

속성

acceptvaluetype

MultiCombo 에서 InnerDataset 에 없는 코드값을 스크립트로 value 속성에 설정할 때 처리방식을 결정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.acceptvaluetype[= enumAccept]

문법 설정

enumAccept ::= 'allowinvalid' | 'ignoreinvalid'
this.MultiCombo00.acceptvaluetype = "ignoreinvalid";

"allowinvalid"

index 속성이 -1 로 변경되어 선택된 아이템이 없는 상태가 됩니다.

value 속성은 설정된 값으로 변경됩니다.

text 속성은 빈값으로 변경됩니다.

"ignoreinvalid"

index, value, text 속성을 변경하지 않고 기존값을 유지합니다.

참고

- acceptvaluetype 속성값을 설정하지 않으면 allowinvalid 로 적용됩니다.

- MultiCombo 에 바인드 된 DataSet 의 데이터값이 value 속성에 설정되는 경우는 적용되지 않습니다.

accessibilityaction

MultiCombo에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 action 정보를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☑ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☑ StringResource

문법

MultiCombo.accessibilityaction[= strAction]

문법 설정

this.MultiCombo00.accessibilityaction = "Accessibility Action Message"; 
this.MultiCombo00.accessibilityaction = "Select by direction key";

strAction

accessibilitydescreadtype 속성값에 "action"이 포함된 경우 스크린 리더의 음성 출력 대상으로 포함할 값을 설정합니다.

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 컴포넌트에 선택상자 이동 시 사용자가 추가적인 정보를 얻기 위해 필요한 동작을 안내하는 용도로 사용합니다. 
  예를 들어 컴포넌트 특성에 따라 다음과 같이 속성값을 설정할 수 있습니다.
  
  - CheckBox 컴포넌트의 경우 아래와 같은 안내문을 accessibilityaction 속성값으로 설정할 수 있습니다.
  "선택 상태를 전환하려면 스페이스 바를 누릅니다."
  
  - WebBrowser, WebView 컴포넌트의 경우 스크린 리더 사용자를 위한 안내문을 accessibilityaction 속성값으로 설정할 수 있습니다.
  "웹 브라우저 컴포넌트 내 콘텐츠를 이용하기 위해서는 가상커서를 해제해 주세요."
  그리고 WebBrowser, WebView 컴포넌트를 벗어났을 때 필요한 안내문을 accessibilityleavemessage 속성값으로 설정합니다.
  "가상커서를 설정해 주세요"

accessibilitydesclevel

MultiCombo 에 선택상자 이동 시 하위 컴포넌트의 접근성 출력여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☑ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.accessibilitydesclevel[= enumLevel]

문법 설정

enumLevel ::= 'all' | 'self' | 'child' | 'none'
this.MultiCombo00.accessibilitydesclevel = "all";

"all"

MultiCombo 와 자식 컴포넌트에 대한 접근성을 모두 출력합니다.

"self"

MultiCombo 의 접근성만 출력하고 자식 컴포넌트의 접근성은 출력하지 않습니다.

"child"

MultiCombo 의 접근성은 출력하지 않고, 자식 컴포넌트의 접근성은 출력합니다.

"none"

MultiCombo 와 자식 컴포넌트에 대한 접근성을 모두 출력하지 않습니다.

참고

- accessibilitydesclevel 속성값을 설정하지 않으면 "all" 로 적용됩니다.

- Button 과 같이 자식 컴포넌트가 없는 컴포넌트는 "all" 또는 "child" 로 설정 시 "self" 로 적용됩니다.

- Div 와 같은 컨테이너 컴포넌트는 "child" 설정 시 실제 컨텐츠의 접근성만을 출력합니다.

- accessibilitydesclevel 속성은 선택상자의 이동에 영향을 주지 않으므로 방향키로 선택상자가 MultiCombo 에 이동되게 하지 않으려면 accessibilityenable 속성을 설정하여야 합니다.

accessibilitydescription

MultiCombo에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 description 정보를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☑ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☑ StringResource

문법

MultiCombo.accessibilitydescription[= strDescription]

문법 설정

this.MultiCombo00.accessibilitydescription = "Option";

strDescription

accessibilitydescreadtype 속성값에 "description"이 포함된 경우 스크린 리더의 음성 출력 대상으로 포함할 값을 설정합니다.

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

accessibilityenable

MultiCombo 에 선택상자 이동 시 접근성 관련 속성값 출력여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☑ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.accessibilityenable[= bEnable]

문법 설정

bEnable ::= 'true' | 'false'
this.MultiCombo00.accessibilityenable = false;

true

MultiCombo 에 선택상자가 이동되면 접근성 관련 속성값을 출력합니다.


방향키 또는 제스처로 선택상자 이동 시 Static 과 같이 포커스를 갖지 않는 컴포넌트에도 선택상자가 이동됩니다.

false

MultiCombo 에 선택상자가 이동되어도 접근성 관련 속성값을 출력하지 않습니다.


데스크탑 환경에서 방향키로 선택상자가 MultiCombo 에 이동되지 않습니다.

모바일 환경에서 제스처로 선택상자가 MultiCombo 에 이동되지 않습니다.

참고

- accessibilityenable 속성값을 설정하지 않으면 true 로 적용됩니다.

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 선택상자 이동 시 컴포넌트의 ARIA-LABEL + Status + Role 순서로 정보가 조합되어 접근성으로 출력됩니다.
   각 정보의 조합순서는 스크린 리더의 종류에 따라 달라질 수 있습니다.
   > ARIA-LABEL : Environment 의 accessibilitydescreadtype 속성에 설정된 속성값이 반영됩니다.
   > Status : MultiCombo 의 현재 상태가 반영됩니다.
   > Role : accessibilityrole 속성값이 반영됩니다. accessibilityrole 속성값을 설정하지 않으면 MultiCombo 의 고유 Role 이 반영됩니다.

- accessibilityenable 속성값이 false 일 때 데스크탑 환경에서 방향키 외의 방법으로 선택상자를 MultiCombo 로 이동시키면 스크린 리딩 프로그램에서 임의의 값을 출력할 수 있습니다.


◆ 컨테이너 컴포넌트 선택상자 이동 제약

아래와 같은 환경에서 컨테이너 컴포넌트로 선택상자가 이동하지 않고 컨테이너 컴포넌트 내에 배치된 컴포넌트로 이동합니다.
- Android, iOS/iPadOS 운영체제에서 실행 시 (Div, PopupDiv, TabpageControl, View)
- Windows 운영체제에서 센스리더 가상커서 사용 시 (Div, PopupDiv, View)

accessibilitylabel

MultiCombo에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 label 정보를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☑ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☑ StringResource

문법

MultiCombo.accessibilitylabel[= strLabel]

문법 설정

this.MultiCombo00.accessibilitylabel = "OK Button"; 
this.MultiCombo00.accessibilitylabel = "[@static00]"; 
this.MultiCombo00.accessibilitylabel = "[@static00][@static01]"; 
this.MultiCombo00.accessibilitylabel = "[@static00][@static01] OK Button";

strLabel

accessibilitydescreadtype 속성값에 "label"이 포함된 경우 스크린 리더의 음성 출력 대상으로 포함할 값을 설정합니다.

문자열로 설정하거나 부모가 같은 컴포넌트의 accessibilitylabel 속성값을 참조할 수 있습니다.

다른 컴포넌트 참조 시에는 "[@ComponentID]" 형식으로 컴포넌트의 id를 대괄호와 "@" 문자를 사용하여 설정합니다.

참조하는 참조값에 해당하는 컴포넌트를 찾을 수 없는 경우에는 참조값 자체가 문자열로 처리됩니다.

참고

- enableaccessibility 속성값이 true인 경우만 적용되는 속성입니다.

- accessibilitydescreadtype 속성값에 "label"이 포함되었으나 accessibilitylabel 속성값을 설정하지 않으면 스크린 리더의 음성 출력 대상에 포함하지 않습니다.

accessibilityrole

MultiCombo에 선택상자 이동 시 스크린 리더가 읽어주는 Role 정보를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☑ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.accessibilityrole[= enumRole]

문법 설정

enumRole ::= 'none' | 'alert' | 'application' | 'button' | 'calendar' | 'chart' | 'checkbox' | 'columnheader' | 'combobox' | 'datepicker' | 'edit' | 'fileupload' | 'form' | 'frame' | 'grid' | 'gridcell' | 'groupbox' | 'heading' | 'heading1' | 'heading2' | 'heading3' | 'heading4' | 'heading5' | 'heading6' | 'image' | 'link' | 'listbox' | 'menubar' | 'progressbar' | 'radio' | 'rowheader' | 'scrollbar' | 'spin' | 'static' | 'statusbar' | 'tab' | 'tabpage' | 'textarea' | 'titlebar' | 'toolbar' | 'tooltip' | 'treegrid' | 'treeitem' | 'webbrowser'
this.MultiCombo00.accessibilityrole = "none"; 
this.MultiCombo00.accessibilityrole = "button";

enumRole

- "none": 스크린 리더에서 Role 정보를 처리하지 않습니다.


- 속성값을 설정하지 않으면 컴포넌트/오브젝트에 따라 기본 accessibilityrole 값이 적용됩니다.

"application": Application, MainFrame

"button": Button, FileDownload

"calendar": Calendar

"checkbox": CheckBox

"combobox": ComboBox

"edit": Edit, MaskEdit

"frame": FrameSet, ChildFrame

"fileupload": FileUpload

"form": Form, Div

"groupbox": GroupBox

"image": ImageViewer, Sketch

"listbox": ListBox

"menubar": Menu

"progressbar": ProgressBar

"radio": Radio

"spin": Spin

"static": Static

"tab": Tab

"tabpage": TabPage

"textarea": TextArea

"webbrowser": WebBrower


- Grid 컴포넌트의 경우 하위 오브젝트까지 Role을 적용합니다.

"grid": Grid

"gridcell": Grid Cell

"columnheader": Grid Column Head

"rowheader": Grid Row Head

"treegrid": TreeGrid

"treeitem": TreeItem, TreeCell


- 기능에 따라 컴포넌트 또는 오브젝트의 하위 오브젝트 영역에 아래와 같은 Role이 적용됩니다.

"alert": Alert, Confirm, UserConfirm

"chart": Chart

"datepicker": DatePicker

"link": Link

"scrollbar": ScrollBar

"statusbar": StatusBar

"titlebar": TitleBar

"toolbar": ToolBar

"tooltip": Tooltip


- "heading" 또는 "heading1"부터 "heading6" 사이의 값으로 속성값을 설정하면 role, aria-level 값을 처리합니다.

예를 들어 속성값을 "heading3"으로 설정하면 Generate되는 코드 태그에 role="heading", aria-level="3" 형식으로 값을 처리합니다.

속성값을 "heading"으로 설정 시에는 "heading1"을 설정한 것과 같은 동작을 처리합니다.

accessibilityheadingnexthotkey, accessibilityheadingprevhotkey 속성값으로 설정한 단축키로 이동 시 사용할 수 있습니다.

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- accessibilityenable 속성값을 설정하지 않으면 MultiCombo의 기본 Role 로 적용됩니다.

- 추가적인 속성값이 필요한 Role 설정 시 MultiCombo에 해당 속성이 없으면 스크린 리더에 따라 정상적으로 정보를 읽지 못할 수 있습니다.

autoselect

MultiCombo 컴포넌트의 편집영역이 활성화될 때 텍스트를 전체선택 할지 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.autoselect[= bAutoselect]

문법 설정

bAutoselect ::= true | false
this.MultiCombo00.autoselect = true;
this.MultiCombo00.autoselect = false;

true

편집영역이 활성화될 때 텍스트가 전체선택 됩니다.

false

편집영역이 활성화될 때 텍스트가 선택되지 않습니다.

참고

- autoselect 속성값을 설정하지 않으면 false로 적용됩니다.

- type 속성이 "dropdown" 이외의 값 일 때 적용되는 속성입니다.


◆ WRE 제약

- 마우스 또는 터치에 의해 편집영역이 활성화될 때는 텍스트 전체선택이 정상동작합니다.
  그러나 setFocus() 메서드에 의해 편집영역이 활성화될 때는 텍스트 전체선택이 되지 않을 수 있습니다.

autoskip

MultiCombo 컴포넌트의 아이템이 선택되었을 때 포커스를 자동으로 이동시킬지 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.autoskip[= bAutoskip]

문법 설정

bAutoskip ::= true | false
this.MultiCombo00.autoskip = true;
this.MultiCombo00.autoskip = false;

true

MultiCombo 컴포넌트의 아이템이 선택되었을 때 포커스를 다음 컴포넌트로 이동시킵니다.

false

MultiCombo 컴포넌트의 아이템이 선택되어도 포커스를 이동시키지 않습니다.

참고

- autoskip 속성값을 설정하지 않으면 false로 적용됩니다.

- 엔터키나 마우스로 리스트를 선택완료하면 MultiCombo 컴포넌트의 아이템이 선택된 것으로 처리합니다.

background

MultiCombo 의 배경 영역을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.background[= strbackground]

문법 설정

strBackground ::= [<bg-image> | <linear-gradient>] [<background-origin> [<background-clip>]] [<background-color>]

<bg-image> ::= 'none' | <imageurl> [<repeat-style>] [<position>]
   <imageurl> ::= 'URL(' <Theme-Image> | <Web-Image> ')'
   <repeat-style> ::= 'repeat-x' | 'repeat-y' | 'repeat' | 'no-repeat'
   <position> ::= <horizontal-position> <vertical-position> ['/' <background-size>]
      <horizontal-position> ::= 'left' | 'center' | 'right' | <pos-percentage> '%'
      <vertical-position> ::= 'top' | 'center' | 'bottom' | <pos-percentage> '%'
      <background-size> ::= 'auto' | 'cover' | 'contain' | (<length> 'px' | <percentage> '%') {1,2}

<linear-gradient> ::= 'linear-gradient(' [<angle> , ] <color-stop> ')'
   <angle> ::= 'to left' | 'to right' | 'to top' | 'to bottom' | 'to left top' | 'to left bottom' | 'to right top' | 'to right bottom'
   <color-stop> ::= <startcolor-stop> [<listcolor-stop>] <endcolor-stop>
      <startcolor-stop> ::= <color> [<percentage>'%']
      <endcolor-stop> ::= <color> [<percentage>'%']
      <listcolor-stop> ::= <color> [<percentage>'%"] [,<listcolor-stop>]*
         <color> ::= <NamedColor> | <NumericColor>

<background-origin> ::= 'border-box' | 'padding-box'
<background-clip> ::= 'border-box' | 'padding-box'
<background-color> ::= <NamedColor> | <NumericColor>
* XCSS
background : #ffffaa;
background : "URL('./images/smiley.gif')" no-repeat center center #ffffaa;
background : "URL('./images/smiley.gif')" no-repeat center center /auto #ffffaa;
background : "URL('./images/smiley.gif')" no-repeat center center /15px 15% #ffffaa;
background : linear-gradient( red , blue , yellow );
background : linear-gradient( #FF0000 , rgb(0,0,255) , rgb(255,255,0));
background : "URL('./images/smiley.gif')" border-box border-box #ffffaa;

* Script ( normal property )
this.MultiCombo00.background = "#ffffaa";
this.MultiCombo00.background = ""URL('./images/smiley.gif')" no-repeat center center #ffffaa";
this.MultiCombo00.background = ""URL('./images/smiley.gif')" no-repeat center center /auto #ffffaa";
this.MultiCombo00.background = ""URL('./images/smiley.gif')" no-repeat center center /15px 15% #ffffaa";
this.MultiCombo00.background = "linear-gradient( red , blue , yellow )";
this.MultiCombo00.background = "linear-gradient( #FF0000 , rgb(0,0,255) , rgb(255,255,0))";
this.MultiCombo00.background = ""URL('./images/smiley.gif')" border-box border-box #ffffaa";

<bg-image>

배경에 표시될 이미지를 "'none' | <imageurl> [<repeat-style>] [<position>]" 형식으로 설정합니다.


<background-color> 값이 설정되어 있으면 배경색 위로 이미지가 표시됩니다.


"none" 으로 설정하면 이미지를 설정하지 않습니다.

<imageurl> 값으로 이미지를 설정할 수 있습니다.

<repeat-style> 값으로 이미지의 반복표시 방향을 설정할 수 있습니다.

<position> 값으로 이미지의 표시위치를 설정할 수 있습니다.


그라데이션과 배경이미지를 동시에 설정할 수 없습니다.

<imageurl>

배경에 표시될 이미지를 "'URL(' <Theme-Image> | <Web-Image> ')'" 형식으로 설정합니다.


"URL ( [이미지경로] )" 형식으로 테마 또는 웹의 이미지를 설정합니다.

<Theme-Image>

테마에 선언된 이미지를 "theme://images\이미지명" 형식으로 설정합니다.


테마에 해당 이미지가 등록되어 있어야 합니다.

<Web-Image>

웹의 이미지를 "http://경로/이미지명", "https://경로/파일명" 형식으로 설정합니다.


웹에 접근 가능한 환경이어야 합니다.

<repeat-style>

배경에 표시될 이미지의 반복표시 방향을 설정합니다.


"repeat-x" 설정 시 이미지가 가로 방향으로 반복표시 됩니다.

"repeat-y" 설정 시 이미지가 세로 방향으로 반복표시 됩니다.

"repeat" 설정 시 이미지가 가로,세로 방향으로 모두 반복표시 됩니다.

"no-repeat" 설정 시 이미지가 반복표시 되지 않습니다.


값을 설정하지 않으면 "repeat" 로 적용됩니다.

<horizontal-position>

배경에 표시될 이미지의 가로 위치를 설정합니다.


"left" 설정 시 MultiCombo 의 왼쪽면과 이미지의 왼쪽면이 정렬되어 표시됩니다.

"center" 설정 시 MultiCombo 의 중앙과 이미지의 중앙이 정렬되어 표시됩니다.

"right" 설정 시 MultiCombo 의 오른쪽면과 이미지의 오른쪽면이 정렬되어 표시됩니다.

<pos-percentage> '%' 형식으로 설정 시 이미지의 위치가 비율로 설정됩니다.


<vertical-position> 값을 설정하고, <horizontal-position> 값을 설정하지 않으면 <horizontal-position> 은 "center" 로 적용됩니다.

<vertical-position> 값과 <horizontal-position> 값을 모두 설정하지 않으면 <horizontal-position> 은 "left" 로 적용됩니다.

<vertical-position>

배경에 표시될 이미지의 세로 위치를 설정합니다.


"top" 설정 시 MultiCombo 의 윗쪽면과 이미지의 윗쪽면이 정렬되어 표시됩니다.

"center" 설정 시 MultiCombo 의 중앙과 이미지의 중앙이 정렬되어 표시됩니다.

"bottom" 설정 시 MultiCombo 의 아랫쪽면과 이미지의 아랫쪽면이 정렬되어 표시됩니다.

<pos-percentage> '%' 형식으로 설정 시 이미지의 위치가 비율로 설정됩니다.


<horizontal-position> 값을 설정하고, <vertical-position> 값을 설정하지 않으면 <vertical-position> 은 "center" 로 적용됩니다.

<vertical-position> 값과 <horizontal-position> 값을 모두 설정하지 않으면 <vertical-position> 은 "top" 으로 적용됩니다.

<pos-percentage>

배경에 표시될 이미지의 가로/세로 위치를 비율로 설정합니다.


<horizontal-position> 에 "0%" 설정 시 "left" 와 같은 위치로 적용됩니다.

<horizontal-position> 에 "50%" 설정 시 "center" 와 같은 위치로 적용됩니다.

<horizontal-position> 에 "100%" 설정 시 "right" 과 같은 위치로 적용됩니다.

<vertical-position> 에 "0%" 설정 시 "top" 와 같은 위치로 적용됩니다.

<vertical-position> 에 "50%" 설정 시 "center" 와 같은 위치로 적용됩니다.

<vertical-position> 에 "100%" 설정 시 "bottom" 과 같은 위치로 적용됩니다.


0 보다 작거나 100 보다 큰 값을 설정 시 MultiCombo 의 영역을 벗어난 가상의 위치로 적용됩니다.


값 설정 시 "%" 단위를 생략할 수 없습니다.

<background-size>

배경에 표시될 이미지의 크기를 설정합니다.

- auto: 원본 이미지 크기를 유지합니다.

- cover: 이미지 비율을 유지하는 한도 내에서 배경에 빈 공간이 없도록 가장 크게 설정합니다.

width 또는 height 길이가 긴 쪽은 잘려서 표시될 수 있습니다.

- contain: 이미지가 잘리지 않고 비율을 유지하는 한도 내에서 가장 크게 설정합니다.

- <length> | <percentage>: 이미지의 width, height 크기 또는 컴포넌트 대비 비율을 설정합니다.

width 값만 설정하면 원본 이미지 비율에 따라 height 크기를 자동으로 처리합니다.

height 값만 설정할 수는 없습니다.

음수값은 설정할 수 없습니다.

<linear-gradient>

배경에 표시될 그라데이션을 "'linear-gradient(' [<angle> , ] <color-stop> ')'" 형식으로 설정합니다.


<background-color> 값이 설정되어 있으면 배경색 위로 그라데이션이 표시됩니다.


"linear-gradient ( [방향, 색상값, 색상값, ...] )" 형식으로 그라데이션 방향과 색상을 설정할 수 있습니다.


그라데이션과 배경이미지를 동시에 설정할 수 없습니다.

<angle>

그라데이션의 표시 방향을 설정합니다.


"to left" 설정 시 오른쪽에서 왼쪽 방향으로 그라데이션이 표시됩니다.

"to right" 설정 시 왼쪽에서 오른쪽 방향으로 그라데이션이 표시됩니다.

"to top" 설정 시 아래쪽에서 윗쪽 방향으로 그라데이션이 표시됩니다.

"to bottom" 설정 시 윗쪽에서 아래쪽 방향으로 그라데이션이 표시됩니다.

"to left top" 설정 시 오른쪽 아래 방향에서 왼쪽 윗 방향으로 그라데이션이 표시됩니다.

"to left bottom" 설정 시 오른쪽 윗 뱡향에서 왼쪽 아래 방향으로 그라데이션이 표시됩니다.

"to right top" 설정 시 왼쪽 아래 방향에서 오른쪽 윗 방향으로 그라데이션이 표시됩니다.

"to right bottom" 설정 시 왼쪽 윗 방향에서 오른쪽 아래 방향으로 그라데이션이 표시됩니다.


값을 설정하지 않으면 "to bottom"으로 적용됩니다.

<color-stop>

그라데이션의 시작점, 끝점, 중간점의 색을 "<startcolor-stop> [<listcolor-stop>] <endcolor-stop>" 형식으로 설정합니다.


<angle> 값에 설정된 방향에 따라 시작점과 끝점의 위치가 결정됩니다.

예를 들어 <angle> 값이 "to left" 이면 MultiCombo 의 right 위치가 시작점이 되고, left 위치가 끝점이 됩니다.

<angle> 값이 "to right" 이면 MultiCombo 의 left 위치가 시작점이 되고, right 위치가 끝점이 됩니다.


<listcolor-stop> 에 그라데이션 중간점의 색을 한개 이상 설정할 수 있으며 <percentage> 값 생략 시 균등하게 표시됩니다.

<startcolor-stop>

그라데이션의 시작점 색을 "<color> [<percentage>'%']" 형식으로 설정합니다.


<angle> 값에 설정된 방향에 따라 시작점 위치가 결정됩니다.

시작점의 <percentage> 값을 "0" 이상으로 설정 시 "시작점~설정값"까지 동일한 색상으로 표시됩니다.

<endcolor-stop>

그라데이션의 끝점 색을 "<color> [<percentage>'%']" 형식으로 설정합니다.


<angle> 값에 설정된 방향에 따라 끝점 위치가 결정됩니다.

끝점의 <percentage> 값을 "100" 이하로 설정 시 "설정값~끝점"까지 동일한 색상으로 표시됩니다.

<listcolor-stop>

그라데이션의 중간점 색을 "<color> [<percentage>'%"] [,<listcolor-stop>]*" 형식으로 설정합니다.


시작점과 끝점 사이에 적용될 중간색을 ","로 구분하여 여러개 설정할 수 있습니다.

뒤에 선언된 색의 <percentage> 값은 먼저 선언된 색의 <percentage> 값보다 커야 합니다.

<color>

그라데이션 색상을 색상이름 또는 색상코드로 설정합니다.

<percentage>

<color> 에 해당하는 색이 적용될 위치를 비율값으로 설정합니다.


<angle> 값에 의해 결정된 시작점이 "0%" 로 적용됩니다.

<angle> 값에 의해 결정된 끝점이 "100%" 로 적용됩니다.


0 보다 작거나 100 보다 큰 값을 설정 시 MultiCombo 의 영역을 벗어난 가상의 위치로 적용됩니다.

예를 들어 "150%" 설정 시 시작점에서 끝점까지 거리의 반만큼 끝점에서 벗어난 위치에 <color> 값이 적용됩니다.


<percentage> 값을 생략하면 균등한 위치에 <color> 값이 적용됩니다.

값 설정 시 "%" 단위를 생략할 수 없습니다.

<background-origin>

배경으로 처리될 기준영역을 설정합니다.


"border-box" 설정 시 Border 를 포함한 영역이 배경영역으로 처리됩니다.


"padding-box" 설정 시 Border 의 안쪽 영역이 배경영역으로 처리됩니다.

"padding-box" 설정 시 그라데이션의 시작점, 끝점과 배경이미지의 반복 기준위치가 Border 안쪽 영역으로 처리됩니다.


값을 설정하지 않으면 "padding-box" 로 적용됩니다.

<background-clip>

배경이 실제로 표시될 영역을 설정합니다.


"border-box" 설정 시 Border 를 포함한 영역에 배경이 표시됩니다.

"padding-box" 설정 시 Border 의 안쪽 영역에 배경이 표시됩니다.


값을 설정하지 않으면 <background-origin> 에 설정한 값이 동일하게 적용됩니다.

<background-origin> 값도 설정하지 않았을 경우 "border-box" 로 적용됩니다.

<background-color>

배경에 표시될 색을 색상이름 또는 색상코드로 설정합니다.


<bg-image> 또는 <linear-gradient> 값이 설정되어 있다면 배경색은 배경이미지 또는 그라데이션 아래에 표시됩니다.

<bg-image> 에 적용된 이미지에 투명으로 적용된 부분이 있거나 이미지가 MultiCombo 영역보다 작다면 해당 영역에 배경색이 표시됩니다.


그라데이션과 배경이미지를 동시에 설정할 수 없습니다.

<NamedColor>

"red","blue" 와 같이 미리 정의된 색상이름을 문자열로 설정합니다.

<NumericColor>

표시할 색의 색상코드입니다.


"#" 기호로 시작하는 6자리 hexadecimal 값으로 색상코드를 설정할 수 있습니다. (ex-"#FF00FF")

red, green, blue 값을 인자로 하는 "rgb()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"rgb(255,0,255)")

red, green, blue, alpha 값을 인자로 하는 "rgba()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"rgba(255,0,255,0.3)")

hue, saturation, lightness 값을 인자로 하는 "hsl()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"hsl(120,50%,50%)")

hue, saturation, lightness, alpha 값을 인자로 하는 "hsla()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"hsla(120,50%,50%,0.8)")

참고

- background 속성값을 설정하지 않으면 undefined 가 설정되고, "transparent" 로 동작합니다.

- TypeDefinition 영역의 Services 에 정의된 사용자 Prefix 는 테마 또는 XCSS 에서 이미지경로로 사용할 수 없습니다.
   사용자 Prefix 는 스크립트 또는 넥사크로 스튜디오에서 속성값으로 설정 시 사용할 수 있습니다.

- 배경의 기준영역과 표시영역은 <background-origin>, <background-clip> 값으로 각각 설정합니다.

- 배경 이미지를 중앙에 위치시키려면 <position> 값을 "center" 또는 "center center" 로 설정하여야 합니다.

- 배경이미지와 배경색을 모두 설정하면 배경색 위에 이미지가 표시됩니다.
   그라데이션과 배경색을 모두 설정하면 배경색 위에 그라데이션이 표시됩니다.

- 그라데이션과 배경이미지를 동시에 설정할 수 없습니다.
   두 값을 동시에 설정 시 오동작이 발생할 수 있습니다.

border-radius

MultiCombo 의 모서리 모양을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.borderRadius[= strborderradius]

문법 설정

strborderradius ::= <horizontal-radius>{4} ['/' <vertical-radius>{4}]
* XCSS
border-radius : 10px;
border-radius : 5px 6px 10px / 5px 10px;

* Script ( normal property )
this.MultiCombo00.borderRadius = "10px";
this.MultiCombo00.borderRadius = "5px 6px 10px / 5px 10px";

<horizontal-radius>

모서리를 둥글게 표시하기 위한 가로크기를 설정합니다.


pixel 단위로 입력하며 스페이스를 구분자로 4개값까지 설정할 수 있습니다.


값을 1회 입력 시 top-left/top-right/bottom-right/bottom-left 모서리의 가로크기로 모두 동일한 값이 적용됩니다.

값을 2회 입력 시 top-left/bottom-right, top-right/bottom-left 모서리의 가로크기로 첫번째 값부터 각각 적용됩니다.

값을 3회 입력 시 top-left, top-right/bottom-left, bottom-right 모서리의 가로크기로 첫번째 값부터 각각 적용됩니다.

값을 4회 입력 시 top-left, top-right, bottom-right, bottom-left 모서리의 가로크기로 첫번째 값부터 각각 적용됩니다.

<vertical-radius>

모서리를 둥글게 표시하기 위한 세로크기를 설정합니다.


pixel 단위로 입력하며 스페이스를 구분자로 4개값까지 설정할 수 있습니다.


값을 1회 입력 시 top-left/top-right/bottom-right/bottom-left 모서리의 세로크기로 모두 동일한 값이 적용됩니다.

값을 2회 입력 시 top-left/bottom-right, top-right/bottom-left 모서리의 세로크기로 첫번째 값부터 각각 적용됩니다.

값을 3회 입력 시 top-left, top-right/bottom-left, bottom-right 모서리의 세로크기로 첫번째 값부터 각각 적용됩니다.

값을 4회 입력 시 top-left, top-right, bottom-right, bottom-left 모서리의 세로크기로 첫번째 값부터 각각 적용됩니다.

참고

- border-radius 속성값을 설정하지 않으면 undefined 가 설정되고, "0px" 로 동작합니다. 

- 스크립트로 접근 시 속성명은 "borderRadius" 를 사용해야 합니다.

- <horizontal-radius>와 <vertical-radius>는 "/" 문자로 구분하여 입력합니다.

- Calendar, Combo 와 같이 하위 컨트롤이 존재하는 컴포넌트는 하위컨트롤에도 border-radius 속성을 설정해야 정상적으로 모서리가 표시됩니다.


◆ NRE 제약

- border-radius 속성을 설정하면 모든 테두리가 같은 색으로 적용됩니다.
   -nexa-border 속성에서 top 에 적용된 색이 모든 테두리에 적용됩니다.

bottom

MultiCombo 을(를) 표시하기 위한 하단 좌표값을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.bottom[= nBottom]

문법 설정

nBottom ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']
this.MultiCombo00.bottom = 10; 
this.MultiCombo00.bottom = "10px"; 
this.MultiCombo00.bottom = "10%"; 
this.MultiCombo00.bottom = "Button00:10px"; 
this.MultiCombo00.bottom = "Button00:10%";

<strCompID>

MultiCombo 의 좌표값을 상대적으로 적용하기 위해 기준이 되는 컴포넌트의 ID 를 설정합니다.


기준 컴포넌트는 MultiCombo 와 부모(Parent)가 동일하여야 합니다.

또한, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.


값을 설정하지 않거나 잘못된 값을 설정하면 부모(Parent) 를 기준으로 좌표값이 적용됩니다.

<nVal>

MultiCombo 의 하단 좌표값을 절대 길이 단위("px"), 비율 단위("%"), 상대 길이 단위("em", "rem")의 숫자로 설정합니다.


  • <strCompID> 값을 생략했을 때 :

- "px": 부모(Parent)의 bottom 속성값을 기준으로 MultiCombo의 하단 위치 설정

- "%": 부모(Parent)의 height 속성값을 기준으로 MultiCombo의 하단 위치 결정

- "em": 컴포넌트의 font-size 속성값을 기준으로 MultiCombo의 하단 위치 결정

- "rem": MainFrame font-size 속성값을 기준으로 MultiCombo의 하단 위치 결정


  • <strCompID> 값을 설정했을 때 :

- "px": <strCompID>의 top 속성값을 기준으로 MultiCombo의 하단 위치 결정

- "%": <strCompID>의 height 속성값을 기준으로 MultiCombo의 하단 위치 결정

<strCompID> 값 설정 시 "em", "rem" 단위는 지원하지 않습니다.

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 좌표값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

box-shadow

MultiCombo 에 그림자 효과를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.boxShadow[= strbshadow]

문법 설정

strbshadow ::= 'none' | [<inset>] <offset> [<blur>'px'] [<spread>'px'] [<color>]

<offset> ::= <horizontal>'px' <vertical>'px'
<color> ::= <NamedColor> | <NumericColor>
* XCSS
box-shadow : 10px 10px 10px #888888;
box-shadow : inset 10px 10px 10px 5px #888888

* Script ( normal property )
this.MultiCombo00.boxShadow  = "10px 10px 10px #888888";
this.MultiCombo00.boxShadow  = "inset 10px 10px 10px 5px #888888";

<inset>

그림자 효과가 컴포넌트 안쪽에 표시됩니다.

생략 시에는 outset으로 동작합니다.

NRE는 지원하지 않습니다.

<offset>

그림자 효과가 표시되는 위치를 설정합니다.


MultiCombo 의 좌상단 위치를 기준으로 그림자 효과가 표시될 위치를 가로/세로 픽셀값으로 설정합니다.

<horizontal>

그림자 효과가 표시되는 가로 위치를 설정합니다.


음수로 설정 시 컴포넌트의 왼쪽에 그림자 효과가 표시됩니다.

pixel 단위로 입력하며 "px" 단위를 생략할 수 없습니다.

<vertical>

그림자 효과가 표시되는 세로 위치를 설정합니다.


음수로 설정 시 컴포넌트의 윗쪽에 그림자 효과가 표시됩니다.

pixel 단위로 입력하며 "px" 단위를 생략할 수 없습니다.

<blur>

그림자 효과에 blur를 설정합니다.

음수로 설정 시 blur가 적용되지 않습니다.

pixel 단위로 입력하며 "px" 단위를 생략할 수 없습니다.

<spread>

그림자를 확장하거나 축소합니다.

양수로 설정 시에는 그림자를 확장하고 음수로 설정 시에는 그림자를 축소합니다.

NRE는 지원하지 않습니다.

<color>

그림자 효과의 색을 색상이름 또는 색상코드로 설정할 수 있습니다.


값을 입력하지 않으면 브라우저별로 다르게 동작하거나 오동작할 수 있습니다.

<NamedColor>

"red","blue" 와 같이 미리 정의된 색상이름을 문자열로 설정합니다.

<NumericColor>

표시할 색의 색상코드입니다.


"#" 기호로 시작하는 6자리 hexadecimal 값으로 색상코드를 설정할 수 있습니다. (ex-"#FF00FF")

red, green, blue 값을 인자로 하는 "rgb()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"rgb(255,0,255)")

red, green, blue, alpha 값을 인자로 하는 "rgba()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"rgba(255,0,255,0.3)")

hue, saturation, lightness 값을 인자로 하는 "hsl()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"hsl(120,50%,50%)")

hue, saturation, lightness, alpha 값을 인자로 하는 "hsla()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"hsla(120,50%,50%,0.8)")

참고

- box-shadow 속성값을 설정하지 않으면 undefined 가 설정되고, "none" 으로 동작합니다.

- 스크립트로 접근 시 속성명은 "boxShadow" 를 사용해야 합니다.

- <blur> 값을 크게 설정하면 시스템 자원 요구량이 많아져 성능 저하의 원인이 됩니다.

- <inset>, <spread> 값은 NRE를 지원하지 않습니다. 
  넥사크로 스튜디오 디자인 창에서도 속성값 설정 시 변경된 디자인을 확인할 수 없습니다.


◆ web runtime environment 제약

- XCSS 를 사용하지 않고 rgba(), hsl(), hsla() 메소드를 속성에 직접 설정할 경우 브라우저 버전에 따라 적용되지 않을 수 있습니다.

buttonsize

MultiCombo 컴포넌트의 드롭다운 버튼 크기를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.buttonsize[= strSize]

문법 설정

strSize ::= <strWidth> [<strHeight>]
this.MultiCombo00.buttonsize = "20";
this.MultiCombo00.buttonsize = "40 20";

<strWidth>

드롭다운 버튼의 너비를 pixel 단위의 문자열로 설정합니다.

<strHeight>

드롭다운 버튼의 높이를 pixel 단위의 문자열로 설정합니다.


값을 생략할 경우 <strWidth> 값이 적용됩니다.

참고

- buttonsize 속성값을 설정하지 않으면 undefined로 적용됩니다.
  undefined 설정 시 MultiCombo 컴포넌트의 height 속성값이 적용됩니다.

- <strWidth> 값이 MultiCombo 컴포넌트의 width 속성값보다 클 경우 MultiCombo 컴포넌트의 너비에 맞게 드롭다운 버튼이 표시됩니다.

- <strWidth> 값과 <strHeight> 값은 공백문자로 구분하여 문자열로 설정합니다.

codecolumn

MultiCombo 컴포넌트에서 아이템의 코드값으로 사용될 Column을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.codecolumn[= strColumnID]

문법 설정

this.MultiCombo00.codecolumn = "codecolumn";

strColumnID

innerdataset 속성에 설정된 Dataset 오브젝트의 Column 중 코드값으로 사용할 Column의 ID를 문자열로 설정합니다.

참고

- codecolumn 속성값을 설정하지 않으면 내부적으로 datacolumn 속성값을 사용합니다.

- codecolumn 속성에 설정된 Column의 값은 아이템 리스트에 표시되지 않고 각 아이템의 코드값으로 처리됩니다.

- MultiCombo 컴포넌트에서 선택된 아이템의 코드값은 value 속성에 설정됩니다.

color

MultiCombo 에 표시되는 텍스트의 색상을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.color[= strcolor]

문법 설정

strcolor ::= <NamedColor> | <NumericColor>
* XCSS
color : #999999;
color : rgb ( 255, 0, 0 );
color : red;

* Script ( normal property )
this.MultiCombo00.color = "#999999";
this.MultiCombo00.color = "rgb(255,0,0)";
this.MultiCombo00.color = "red";

<NamedColor>

"red","blue" 와 같이 미리 정의된 색상이름을 문자열로 설정합니다.

<NumericColor>

표시할 색의 색상코드입니다.


"#" 기호로 시작하는 6자리 hexadecimal 값으로 색상코드를 설정할 수 있습니다. (ex-"#FF00FF")

red, green, blue 값을 인자로 하는 "rgb()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"rgb(255,0,255)")

red, green, blue, alpha 값을 인자로 하는 "rgba()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"rgba(255,0,255,0.3)")

hue, saturation, lightness 값을 인자로 하는 "hsl()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"hsl(120,50%,50%)")

hue, saturation, lightness, alpha 값을 인자로 하는 "hsla()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"hsla(120,50%,50%,0.8)")

참고

- color 속성값을 설정하지 않으면 undefined 가 설정되고, "#000000" 으로 동작합니다.


◆ web runtime environment 제약

- XCSS 를 사용하지 않고 rgba(), hsl(), hsla() 메소드를 속성에 직접 설정할 경우 브라우저 버전에 따라 적용되지 않을 수 있습니다.

counttextformat

MultiCombo 컴포넌트의 edittype 속성값이 "count"일 때 선택된 아이템 개수를 표시할 텍스트를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.counttextformat[= strExpr]

문법 설정

this.MultiCombo00.counttextformat = "[#]개 아이템을 선택했습니다.";
this.MultiCombo00.counttextformat = "[*]개 아이템 중에서 [#]개를 선택했습니다.";

strExpr

선택된 아이템 개수를 표시할 텍스트를 설정합니다.


값 설정 시 전체 아이템 개수와 선택한 아이템 개수를 아래 기호로 설정할 수 있습니다.

[*] : 전체 아이템 개수

[#] : 선택한 아이템 개수

참고

- counttextformat 속성값을 설정하지 않으면 "[#] item(s) selected"으로 적용됩니다.

활용 예제

cssclass

MultiCombo 의 Style 을 XCSS 파일에 정의된 class 로 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.cssclass[= strcssclass]

문법 설정

strcssclass ::= <ClassName> [ , &ltClassName> ]*
this.MultiCombo00.cssclass = "TestClass"; 
this.MultiCombo00.cssclass = "TestClass,TestClass2";

<ClassName>

XCSS 에 정의된 classname 을 설정합니다.

참고

- XCSS 에 정의된 ".classname" 형식에서 "." 를 제외하고 "classname" 만 설정합니다.

- Style 에 적용되는 방식은 XCSS Attribute 지정과 동일하게 XCSS 내의 순서대로 적용됩니다.

- Status 를 적용하고자 할 경우는 "classname" 에 Status 를 붙여서 사용합니다.

- ',' 를 사용하여 class 를 다중으로 지정하게 되면 class 가 중첩되어 적용됩니다.
   중첩된 class 의 내용에 중복이 있다면 XCSS 내의 순서상 마지막으로 기술된 것이 적용됩니다.


◆ web runtime environment 제약

- web runtime environment 는 cssclass 명의 첫문자가 숫자일 경우 속성값이 적용되지 않으므로 주의하여야 합니다.

cursor

MultiCombo 영역에서 표시될 마우스 포인터의 종류를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.cursor[= strCursor]

문법 설정

strCursor ::= 'none' | 'auto' | 'default' | 'copy' | 'crosshair' | 'help' | 'move' | 'not-allowed' | 'pointer' | 'progress' | 'text' | 'wait' | 'ew-resize' | 'e-resize' | 'w-resize' | 'ns-resize' | 'n-resize' | 's-resize' | 'nesw-resize' | 'ne-resize' | 'sw-resize' | 'nwse-resize' | 'nw-resize' | 'se-resize'
* XCSS
cursor : default;

* Script ( normal property )
this.MultiCombo00.cursor = "default";

"none"

마우스 포인터를 표시하지 않습니다.


  • macOS NRE는 지원하지 않습니다.

"auto"

컴포넌트의 특성에 맞는 포인터가 표시됩니다.


Edit계열 컴포넌트는 "text" 포인터가 표시됩니다.

그외 계열 컴포넌트는 "arrow" 포인터가 표시됩니다.

"default"

시스템의 기본 포인터가 표시됩니다.


일반적으로 "arrow" 포인터가 표시됩니다.

"copy"

화살표와 작은 십자("+") 모양의 포인터가 표시됩니다.


  • macOS NRE는 지원하지 않습니다.

"crosshair"

십자("+") 모양의 포인터가 표시됩니다.


  • macOS NRE 는 지원하지 않습니다.

"help"

화살표와 작은 물음표 모양의 포인터가 표시됩니다.


  • Safari 브라우저는 물음표 모양의 포인터가 표시됩니다.

  • macOS NRE 는 지원하지 않습니다.

"move"

십자 화살표 모양의 포인터가 표시됩니다.


  • macOS NRE 는 지원하지 않습니다.

"not-allowed"

금지 표지판 모양의 포인터가 표시됩니다.


  • Safari 브라우저는 화살표와 금지 표지판 모양의 포인터가 표시됩니다.

  • macOS NRE 는 지원하지 않습니다.

"pointer"

손모양의 포인터가 표시됩니다.


  • macOS NRE 는 지원하지 않습니다.

"progress"

OS 또는 환경에 따라 다른 형태의 포인터가 표시됩니다.


원, 화살표와 모래시계, 화살표와 원 등 다양한 형태로 표시됩니다.


  • macOS NRE 는 지원하지 않습니다.

"text"

아이("I") 모양의 포인터가 표시됩니다.

"wait"

OS 또는 환경에 따라 다른 형태의 포인터가 표시됩니다.


원, 모래시계, 시계 등 다양한 형태로 표시됩니다.

"ew-resize"

수평으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

"e-resize"

수평으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

"w-resize"

수평으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

"ns-resize"

수직으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.


  • macOS NRE는 지원하지 않습니다.

"n-resize"

수직으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

"s-resize"

수직으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

"nesw-resize"

사선("/")으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

"ne-resize"

사선("/")으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

"sw-resize"

사선("/")으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

"nwse-resize"

역사선("＼")으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.


  • macOS NRE는 지원하지 않습니다.

"nw-resize"

역사선("＼")으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.


  • macOS NRE 는 지원하지 않습니다.

"se-resize"

역사선("＼")으로 된 양쪽 화살표 모양의 포인터가 표시됩니다.

참고

- cursor 속성값을 설정하지 않으면 undefined 가 설정되고 "auto" 로 동작합니다.

- disable 상태인 서브컨트롤이 있는 컴포넌트의 경우 마우스 포인터는 서브컨트롤 영역에서
   서브컨트롤의 disable status값이 적용되지 않고, 컴포넌트의 enable status 설정값이 적용됩니다.
   서브컨트롤과 컴포넌트가 모두 disable 상태일 때는 parent 의 enable status 설정값이 적용됩니다.

datacolumn

MultiCombo 컴포넌트에서 아이템의 데이터값으로 사용될 Column을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.datacolumn[= strColumnID]

문법 설정

this.MultiCombo00.datacolumn = "datacolumn";

strColumnID

innerdataset 속성에 설정된 Dataset 오브젝트의 Column 중 데이터값으로 사용할 Column의 ID를 문자열로 설정합니다.

참고

- datacolumn 속성값을 설정하지 않으면 내부적으로 codecolumn 속성값을 사용합니다.

- datacolumn 속성에 설정된 Column의 값은 아이템 리스트에 표시되며 각 아이템의 데이터값으로 처리됩니다.

- MultiCombo 컴포넌트에서 선택된 아이템의 데이터값은 text 속성값에 설정됩니다.

displaynulltext

MultiCombo 의 value 속성값이 null 또는 undefined 일 때 MultiCombo 에 표시될 대체 문자열을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☑ StringResource

문법

MultiCombo.displaynulltext[= strText]

문법 설정

this.MultiCombo00.displaynulltext = "no value";

strText

value 속성값이 null 일 때 MultiCombo 에 표시될 대체 문자열을 설정합니다.

참고

- value 속성값이 null 또는 undefined 이고, MultiCombo 에 포커스가 없을 때 대체 문자열이 표시됩니다.
   value 속성에 값이 있거나 빈문자열("Empty String")인 경우는 대체 문자열이 표시되지 않습니다.

- 최초 value 속성값이 null 일 때 편집창에 입력중인 값을 모두 지우면 value 속성은 null 값을 유지합니다.
   최초 value 속성값이 null 이 아닐 때 편집창에 입력된 값을 모두 지우면 value 속성은 빈문자열("Empty String")값을 갖습니다.

- value 속성값을 null 로 재설정 하려면 바인드 된 데이터 또는 value 속성값을 스크립트로 수정하여야 합니다.

displayrowcount

MultiCombo 컴포넌트의 아이템 리스트에 표시될 아이템의 최대 개수를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.displayrowcount[= nRowNum]

문법 설정

nRowNum

아이템 리스트에 표시될 아이템의 개수를 숫자로 설정합니다.


undefined를 설정하면 아이템 리스트가 표시되는 공간에 맞게 자동으로 개수가 설정됩니다.

참고

- displayrowcount 속성값을 설정하지 않으면 undefined로 적용됩니다.

- displayrowcount 속성값 보다 아이템의 개수가 작으면 아이템 개수에 맞게 리스트가 표시됩니다.

- displayrowcount 속성값 보다 아이템의 개수가 많으면 아이템 리스트에 스크롤이 표시됩니다.

- MultiCombo 컴포넌트 하단에 아이템 3개를 표시할 공간이 없다면 아이템 리스트가 MultiCombo 컴포넌트 상단에 표시됩니다.
  상/하단 모두 아이템 3개를 표시할 공간이 없다면 더 넓은 방향으로 리스트가 표시됩니다.

dropbutton

MultiCombo 컴포넌트의 서브컨트롤인 드롭버튼(DropButton) 오브젝트를 갖는 속성입니다

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☑ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.dropbutton // get

문법 설정

var objButton = this.MultiCombo00.dropbutton;

edittype

MultiCombo 컴포넌트에서 선택된 아이템의 표시 방식을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.edittype[= enumMode]

문법 설정

enumMode ::= "text" | "singletag" | "multitag" | "count"
this.MultiCombo00.edittype = "singletag";

"text"

선택된 아이템을 텍스트로 표시합니다.

"singletag"

선택된 아이템을 한 줄의 태그로 표시합니다.

"multitag"

선택된 아이템을 여러 줄의 태그로 표시합니다.

"count"

선택된 아이템을 개수로 표시합니다.

참고

- edittype 속성값을 설정하지 않으면 "text"로 적용됩니다.

활용 예제

enable

MultiCombo 의 사용가능 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.enable[= benable]

문법 설정

benable ::= 'true' | 'false'
this.MultiCombo00.enable = true; 
this.MultiCombo00.enable = false;

true

MultiCombo 을(를) 사용할 수 있게 설정합니다.

false

MultiCombo 을(를) 사용할 수 없게 설정합니다.


하위 컨트롤이 있을 경우 하위 컨트롤에 "disabled" Status 가 적용됩니다.

참고

- enable 속성값을 설정하지 않으면 true 로 적용됩니다.

- enable 속성값이 false 이면 컴포넌트가 화면에 표시되지만 포커스나 입력을 받을 수 없습니다.

- Div 와 같은 컨테이너 컴포넌트의 enable 속성값을 false 로 설정하면 자식 컴포넌트도 모두 Disable 됩니다.

enableevent

MultiCombo 에서 이벤트를 발생시킬지 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.enableevent[= bEvent]

문법 설정

bEvent ::= 'true' | 'false'
this.MultiCombo00.enableevent = true;  

this.MultiCombo00.enableevent = false;

true

MultiCombo 에서 이벤트가 발생하도록 설정합니다.

false

MultiCombo 에서 이벤트가 발생하지 않도록 설정합니다.

참고

- enableevent 속성을 false 로 설정하면 이벤트 발생으로 인한 처리속도 지연과 화면 깜빡임을 방지할 수 있습니다.

flexgrow

Layout 컨테이너 내 Main Axis(type 속성값이 "horizontal"이면 수평축, type 속성값이 "vertical"이면 수직축) 여백을 설정한 비율만큼 나누어 컴포넌트의 크기를 재조정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.flexgrow[= fVal]

문법 설정

fVal

컴포넌트의 크기를 재조정할 비율을 설정합니다.

참고

- flexgrow 속성값을 설정하지 않으면 undefined로 설정되고 0 값으로 동작합니다.
  속성값이 0이면 크기를 재조정하지 않습니다.
    
- Layout 컨테이너 내 배치된 컴포넌트 중 flexgrow 속성값이 0보다 큰 값으로 설정된 컴포넌트를 대상으로 Main Axis의 여백을 설정한 비율만큼 나누어 크기에 적용합니다.

- maxwidth, maxheight 속성값을 설정한 경우에는 해당 크기보다 크게 크기가 조정되지는 않습니다.


◆ fittocontents 속성과 같이 사용하는 경우

아래와 같은 경우 컴포넌트의 flexgrow 속성값이 무시되고 fittocontents 속성만 적용됩니다.

- Layout 오브젝트 또는 Panel 컴포넌트의 type 속성값이 "horizontal"이고
  컴포넌트의 fittocontents 속성값이 "width" 또는 "both"일 때
- Layout 오브젝트 또는 Panel 컴포넌트의 type 속성값이 "vertical"이고
  컴포넌트의 fittocontents 속성값이 "height" 또는 "both"일 때

flexshrink

Layout 컨테이너 내 Main Axis(type 속성값이 "horizontal"이면 수평축, type 속성값이 "vertical"이면 수직축)에 컴포넌트가 배치되는 영역이 컨테이너 영역을 초과하지 않도록 설정한 비율만큼 나누어 컴포넌트의 크기를 재조정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.flexshrink[= fVal]

문법 설정

fVal

컴포넌트의 크기를 재조정할 비율을 설정합니다.

참고

- flexshrink 속성값을 설정하지 않으면 undefined로 설정되고 1 값으로 동작합니다.
  속성값이 0이면 크기를 재조정하지 않습니다.
    
- Layout 컨테이너 내 배치된 컴포넌트 중 flexshrink 속성값이 0보다 큰 값으로 설정된 컴포넌트를 대상으로 Main Axis의 초과 영역을 설정한 비율만큼 나누어 크기에 적용합니다.

- minwidth, minheight 속성값을 설정한 경우에는 해당 크기보다 작게 크기가 조정되지는 않습니다.


◆ fittocontents 속성과 같이 사용하는 경우

아래와 같은 경우 컴포넌트의 flexshrink 속성값이 무시되고 fittocontents 속성만 적용됩니다.

- Layout 오브젝트 또는 Panel 컴포넌트의 type 속성값이 "horizontal"이고
  컴포넌트의 fittocontents 속성값이 "width" 또는 "both"일 때
- Layout 오브젝트 또는 Panel 컴포넌트의 type 속성값이 "vertical"이고
  컴포넌트의 fittocontents 속성값이 "height" 또는 "both"일 때

font

MultiCombo 에서 사용하는 폰트를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.font[= strfont]

문법 설정

strfont ::= [<font-style>] [<font-weight>] <font-size> ['/'<line-height>] <font-family>

<font-style> ::= 'normal' | 'italic'
<font-weight> ::= 'normal' | 'bold' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900'
<font-size> ::= <nSize> 'px'|'pt'|'em'|'rem'
<line-height> ::= 'normal' | <nValue> | <nPixel>'px' | <nPercent>'%'
<font-family> ::= <font-name> [',' <font-name>]*
* XCSS
font : bold 12pt/30px arial, sans-serif;

* Script ( normal property )
this.MultiCombo00.font = "bold 12pt/30px arial, sans-serif";

<font-style>

폰트의 스타일을 설정합니다.


"normal" 설정 시 스타일이 적용되지 않습니다.

"italic" 설정 시 기울임 스타일이 적용됩니다.

<font-weight>

폰트의 굵기를 설정합니다.


"normal" 설정 시 굵기가 적용되지 않습니다.

"bold" 설정 시 굵은 폰트가 적용됩니다.


"100"~"900" 로 설정 시 설정한 굵기로 폰트가 적용됩니다.

"100"~"900" 로 설정 시 굵기에 해당하는 폰트가 정의되어 있어야 합니다.

<font-size>

폰트 크기의 단위는 아래와 같이 절대 길이 단위와 상대 길이 단위로 설정할 수 있습니다.

단위를 지정하지 않으면 속성값이 적용되지 않습니다.

- 절대 길이 단위: pixel("px"), point("pt")

- 상대 길이 단위: "em", "rem"


폰트 크기 단위를 "em", "rem"으로 설정한 경우에는 아래와 같이 폰트 크기가 계산됩니다.

- "em": 상위 컴포넌트 font-size 기준으로 상대적인 크기를 설정

- "rem": MainFrame font-size 기준으로 상대적인 크기를 설정

<nSize>

폰트 크기 단위에 따라 정수 또는 소수로 설정합니다.

음수값은 설정할 수 없습니다.

- "px", "pt": 정수

- "em", "rem": 정수 또는 소수

<line-height>

텍스트가 여러줄로 표시되는 경우 줄 사이의 간격을 설정합니다.


음수값을 설정할 수 없습니다.


"normal" 설정 시 줄 사이의 간격을 설정하지 않습니다.

"normal" 설정 시 웹브라우저마다 줄 사이의 간격이 다르게 적용됩니다.

"normal" 설정 시 Nexacro Runtime Environment는 폰트 크기에 곱할 값(<nValue>값)이 "1.15" 일 때와 동일하게 동작합니다.

<nValue>

폰트 크기에 곱할 값을 설정합니다.


계산 결과값이 줄 사이 간격으로 적용됩니다.

<nPixel>

줄 사이의 간격을 pixel 단위의 숫자로 설정합니다.


"px" 단위를 생략할 수 없습니다.

<nPercent>

폰트 크기에 곱할 비율값을 설정합니다.


계산 결과값이 줄 사이 간격으로 적용됩니다.

"%" 단위를 생략할 수 없습니다.

<font-family>

폰트 이름을 리스트로 설정합니다.


콤마(",")로 구분하여 폰트 이름을 여러개 설정할 수 있습니다.

먼저 선언된 폰트가 우선적으로 적용됩니다.

선언된 폰트가 시스템에 없을 경우 선언된 순서대로 사용 가능한 폰트를 적용합니다.

선언된 폰트가 모두 없을 경우 시스템 기본 폰트가 적용됩니다.

<font-name>

폰트의 이름을 설정합니다.

참고

- font 속성값을 설정하지 않으면 undefined 가 설정되고, "12pt/normal Verdana" 로 동작합니다.

- font 속성의 폰트 크기가 변경되면 <line-height> 에 적용된 값에 따라 줄간격이 변경될 수 있습니다.

- <font-weight> 를 수치로 설정 시 "400" 값이 일반적인 굵기로 적용되고, "700" 값이 "bold" 로 적용됩니다.
   폰트에 수치값에 해당하는 폰트굵기가 없다면 "400" 과 "700" 중 가까운 값으로 표시됩니다.

- UserFont 사용 시 환경별로 지원하는 포맷정보는 "Appendix > Supported UserFont" 항목을 참고하세요.


◆ WRE 제약

- -nexa-text-align 속성값이 "right" 일 때 font 속성에 "italic" 을 설정하면 마지막 텍스트의 기울어진 부분이 잘려서 표시될 수 있습니다.
   웹브라우저에서 텍스트영역을 일반글자 기준으로 처리한 후 기울임을 적용하면서 발생하는 문제입니다.

height

MultiCombo 을(를) 표시하기 위한 높이를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.height[= nHeight]

문법 설정

nHeight ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']
this.MultiCombo00.height = 10; 
this.MultiCombo00.height = "10px"; 
this.MultiCombo00.height = 10%"; 
this.MultiCombo00.height = Button00:10%";

<strCompID>

MultiCombo 의 높이를 상대적으로 적용하기 위해 기준이 되는 컴포넌트의 ID 를 설정합니다.


기준 컴포넌트는 MultiCombo 와 부모(Parent)가 동일하여야 합니다.

또한, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.


값을 설정하지 않거나 잘못된 값을 설정하면 부모(Parent) 를 기준으로 높이가 적용됩니다.

<nVal>

MultiCombo 의 높이를 절대 길이 단위("px"), 비율 단위("%"), 상대 길이 단위("em", "rem")의 숫자로 설정합니다.



  • <strCompID> 값을 생략했을 때 :

- "px": MultiCombo의 높이 설정

- "%": 부모(Parent)의 height 속성값을 기준으로 MultiCombo의 높이 결정

- "em": 컴포넌트의 font-size 속성값을 기준으로 MultiCombo의 높이 결정

- "rem": MainFrame font-size 속성값을 기준으로 MultiCombo의 높이 결정


  • <strCompID> 값을 설정했을 때 :

- "px": <strCompID> 값은 무시되고 설정값이 MultiCombo의 높이 결정

- "%": <strCompID>의 height 속성값을 기준으로 MultiCombo의 높이 결정

<strCompID> 값 설정 시 "em", "rem" 단위는 지원하지 않습니다.

참고

- 높이값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 높이값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

hotkey

MultiCombo 의 기본 액션을 수행하기 위한 단축키를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.hotkey[= strHotkey]

문법 설정

this.MultiCombo00.hotkey = "G"; 
this.MultiCombo00.hotkey = "CTRL+A"; 
this.MultiCombo00.hotkey = "CTRL+ALT+X";

strHotkey

수식키(CTRL, ALT, SHIFT)와 일반키의 조합으로 설정합니다.

수식키는 중복으로 조합하여 설정할 수 있습니다.

각 키는 "+" 를 사용하여 조합을 설정합니다.

참고

(1) 컴포넌트 기본 액션

hotkey 속성값 설정 시 컴포넌트의 기본 액션이 수행됩니다. 컴포넌트 기본 액션은 다음과 같습니다.
- onclick : Button, CheckBox
- 포커스 이동 (접근성 설정 시) : GroupBox, Static
- onsetfocus : 나머지 Frame 오브젝트 및 컴포넌트
* GroupBox, Static 컴포넌트는 접근성 설정 환경이 아닌 경우 hotkey 속성은 처리되지 않습니다.

(2) 예외 조건

(2-1) 같은 hotkey 속성값을 가진 컴포넌트가 있을 때
Form 내에 같은 hotkey 속성값을 가진 컴포넌트가 2개 이상 있는 경우 components 속성 인덱스 순서에 따라 먼저 생성된 컴포넌트의 hotkey 속성만 처리됩니다.

(2-2) 단축키가 설정된 입력장치를 사용할 때
단축키 설정 기능이 있는 입력장치를 사용하는 경우 입력장치에서 설정된 단축키와 같은 값을 hotkey 속성값으로 설정하면 hotkey 속성은 처리되지 않습니다.
예를 들어 "CTRL+M" 키 입력을 ENTER 키 입력으로 변환해 처리하는 키보드를 사용한다면 hotkey 속성값을 "CTRL+M"으로 설정하고 해당 키를 입력해도 기본 액션이 수행되지 않습니다.

(2-3) 상위 프레임 또는 Form이 활성화되지 않았을 때
hotkey 속성은 상위 프레임 또는 Form이 활성화된 경우에만 동작합니다. 

(2-4) enable 속성값이 false 일 때
컴포넌트의 enable 속성값이 false이면 hotkey 속성은 처리되지 않습니다.

(2-5) hotkeycolumn 속성값을 설정했을 때
Menu 컴포넌트의 hotkey 속성값과 hotkeycolumn 속성값을 같은 속성값으로 설정하면 hotkeycolumn 속성은 처리되지 않습니다.

활용 예제

id

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.id

문법 설정

id

MultiCombo를 구별할 수 있는 유일값을 갖습니다.

참고

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

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

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

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

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

imemode

MultiCombo 의 기본 입력 언어를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☐ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.imemode[= enumImemode]

문법 설정

enumImemode ::= 'none' | 'alpha' | 'alpha,full' | 'hangul' | 'hangul,full' | 'katakana' | 'katakana,full' | 'hiragana' | 'direct'
this.Edit00.imemode = "none";

"none"

기본 입력 언어를 변경하지 않고 현재 시스템에 설정된 언어를 유지합니다.


imemode 속성값을 설정하지 않으면 기본으로 적용됩니다.

"alpha"

입력언어를 영문으로 설정합니다.


IME 가 동아시아 입력기(한글/일본어/한자) 일 경우만 적용됩니다.

"alpha,full"

입력언어를 영문 전각으로 설정합니다.


IME 가 동아시아 입력기(한글/일본어/한자) 일 경우만 적용됩니다.

"hangul"

입력언어를 한글로 설정합니다.


IME 가 한글 입력기일 경우만 적용됩니다.

"hangul,full"

입력언어를 한글 전각으로 설정합니다.


IME 가 한글 입력기일 경우만 적용됩니다.

"katakana"

입력언어를 일본어 가나로 설정합니다.


IME 가 일본어 입력기일 경우만 적용됩니다.

"katakana,full"

입력언어를 일본어 가나 전각으로 설정합니다.


IME 가 일본어 입력기일 경우만 적용됩니다.

"hiragana"

입력언어를 일본어 히라가나 전각으로 설정합니다.


IME 가 일본어 입력기일 경우만 적용됩니다.

"direct"

입력언어를 일본어 직접입력으로 설정합니다.


IME 가 IME2002의 일본어 입력기일 경우만 적용됩니다.

IME 가 IME2007과 2010 일 경우는 "alpha"로 적용됩니다.

참고

- imemode 속성값을 설정하지 않으면 "none" 으로 적용됩니다.

- 컴포넌트가 포커스를 받을 때 IME 가 재설정됩니다.

- 일부 환경에서만 지원하는 속성이므로 상단의 지원환경을 확인하시기 바랍니다.
   > Windows NRE, Android NRE에서만 지원하는 속성입니다.
   > macOS NRE, iOS/iPadOS NRE, WRE에서는 지원하지 않는 속성입니다.

index

MultiCombo 컴포넌트의 아이템 중 선택된 아이템의 인덱스를 갖는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.index[= strIndex]

문법 설정

this.MultiCombo00.index = "0,1,2";

strIndex

선택할 아이템의 인덱스를 1개 이상 콤마(,) 구분자를 사용해 설정합니다.


- 인덱스는 0부터 시작하며 (아이템 개수 - 1)까지 설정할 수 있습니다.

- index 속성에서 설정할 수 있는 범위를 넘어선 값이 포함된 경우 해당 값을 제외하고 반영합니다.

예를 들어 설정할 수 있는 인덱스 범위가 0~4인 경우 index 속성값을 "0,5"로 설정하면 범위를 벗어난 값은 제외하고 "0"으로 반영됩니다.

- undefined 또는 빈 문자열로 값 설정 시 설정값을 무시하고 이전값을 유지합니다.

- 속성값을 "-1"로 설정하면 선택된 아이템이 없는 상태가 됩니다.

참고

- index 속성값을 설정하지 않으면 "-1"로 적용됩니다.

- index 속성값 변경에 의해 선택된 아이템이 변경될 경우 value, text 속성값도 해당 아이템에 맞게 변경됩니다.

- 스크립트나 Dataset 오브젝트 바인딩에 의해 선택된 아이템이 변경되어도 화면에 반영되지 않습니다.
  따라서 화면에 남아 있는 선택표시와 실제 index 속성값에 차이가 있을 수 있으니 주의하셔야 합니다.

- index  또는 value 속성에 Dataset 오브젝트가 바인딩되어 있다면 컴포넌트 생성 시 넥사크로 스튜디오에서 설정한 index 속성값은 무시됩니다.

활용 예제

initvalueid

MultiCombo 에 적용될 InitValue 의 ID 를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.initvalueid[= strValueID]

문법 설정

strValueID

InitValueDefinition 영역에 정의된 InitValue 파일에서 MultiCombo 에 적용할 항목의 ID 를 문자열로 설정합니다.

참고

- MultiCombo 가 화면에 표시된 후에는 속성값을 설정하거나 변경 할 수 없습니다.
   MultiCombo 를 동적으로 생성 시 show() 메소드 실행 전에 속성값을 설정하여야 합니다.

- Screen 별로 Environment 의 initvaluefileid 속성을 각각 설정하면 Screen 에 따라 다른 초기값을 설정할 수 있습니다.

- InitValueDefinition 영역에 한 개 이상의 InitValue 파일을 정의할 수 있고,
   InitValue 파일에는 컴포넌트별로 여러개의 초기값 정의를 할 수 있습니다.

innerdataset

MultiCombo 컴포넌트의 아이템 리스트를 구성할 Dataset 오브젝트의 ID를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.innerdataset[= strDatasetID]

문법 설정

this.MultiCombo00.innerdataset = "Dataset00";

strDatasetID

아이템 리스트를 구성할 Dataset 오브젝트의 ID를 문자열로 설정합니다.

참고

- innerdataset, codecolumn, datacolumn 속성을 모두 설정해야 아이템 리스트가 정상적으로 표시됩니다.

- innerdataset 속성에 설정된 Dataset 오브젝트에 데이터가 없을 경우 아이템 리스트가 표시되지 않습니다.

- innerdataset 속성값에 해당하는 Dataset 오브젝트가 존재하지 않으면 아이템 리스트가 표시되지 않습니다.

- innerdataset 속성은 bind 구문을 사용하여 설정할 수 없습니다.

활용 예제

itemheight

MultiCombo 컴포넌트의 아이템 리스트에서 각 행의 높이를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.itemheight[= nHeight]

문법 설정

this.MultiCombo00.itemheight = 20;

nHeight

각 아이템이 표시되는 행의 높이를 pixel 단위의 숫자로 설정합니다.

참고

- itemheight 속성을 설정하지 않으면 글자 크기를 기준으로 행의 높이를 자동 계산합니다.

layoutorder

Layout 컨테이너 내 Main Axis(type 속성값이 "horizontal"이면 수평축, type 속성값이 "vertical"이면 수직축)에 컴포넌트가 배치되는 순서를 설정합니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.layoutorder[= nVal]

문법 설정

nVal

컴포넌트의 배치 순서를 설정합니다.

참고

- layoutorder 속성값을 설정하지 않으면 0으로 설정됩니다.

- 속성값이 음수인 경우에는 0으로 설정됩니다.

- 같은 값으로 2개 이상의 컴포넌트의 속성값을 설정할 수 있습니다. 
  속성값이 같은 경우에는 생성 순서(Z-Order)에 따라 배치 순서가 달라집니다.

left

MultiCombo 을(를) 표시하기 위한 좌측 좌표값을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.left[= nLeft]

문법 설정

nLeft ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']
this.MultiCombo00.left = 10; 
this.MultiCombo00.left = "10px"; 
this.MultiCombo00.left = "10%"; 
this.MultiCombo00.left = "Button00:10px"; 
this.MultiCombo00.left = "Button00:10%";

<strCompID>

MultiCombo 의 좌표값을 상대적으로 적용하기 위해 기준이 되는 컴포넌트의 ID 를 설정합니다.


기준 컴포넌트는 MultiCombo 와 부모(Parent)가 동일하여야 합니다.

또한, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.


값을 설정하지 않거나 잘못된 값을 설정하면 부모(Parent) 를 기준으로 좌표값이 적용됩니다.

<nVal>

MultiCombo 의 좌측 좌표값을 절대 길이 단위("px"), 비율 단위("%"), 상대 길이 단위("em", "rem")의 숫자로 설정합니다.


  • <strCompID> 값을 생략했을 때 :

- "px": 부모(Parent)의 left 속성값을 기준으로 MultiCombo의 좌측 위치 설정

- "%": 부모(Parent)의 width 속성값을 기준으로 MultiCombo의 좌측 위치 결정

- "em": 컴포넌트의 font-size 속성값을 기준으로 MultiCombo의 좌측 위치 결정

- "rem": MainFrame font-size 속성값을 기준으로 MultiCombo의 좌측 위치 결정


  • <strCompID> 값을 설정했을 때 :

- "px": <strCompID>의 right 속성값을 기준으로 MultiCombo의 좌측 위치 결정

- "%": <strCompID>의 width 속성값을 기준으로 MultiCombo의 좌측 위치 결정

<strCompID> 값 설정 시 "em", "rem" 단위는 지원하지 않습니다.

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 좌표값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

letter-spacing

MultiCombo 에 표시되는 문자의 간격(자간)을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.letterSpacing[= strspace]

문법 설정

strspace ::= 'normal' | <nVal> ['px']
* XCSS
letter-spacing : 2px ;

* Script ( normal property )
this.MultiCombo00.letterSpacing = "2px";

"normal"

문자 사이의 간격(자간)을 설정하지 않습니다.

<nVal>

문자 사이의 간격(자간)을 pixel 단위로 설정합니다.


스크립트 작성 시에는 "px" 단위 표기를 생략할 수 있습니다.

(XCSS 작성 시에는 "px" 단위를 포함해 작성해야 합니다).

참고

- letter-spacing 속성값을 설정하지 않으면 undefined 가 설정되고, "normal" 로 동작합니다.

- 스크립트로 접근 시 속성명은 "letterSpacing"을 사용해야 합니다.

maxheight

MultiCombo 이(가) 화면에 표시되는 최대 높이를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.maxheight[= nMaxHeight]

문법 설정

nMaxHeight ::= <nVal> ['px']
this.MultiCombo00.maxheight = 20; 
this.MultiCombo00.maxheight = "20px";

<nVal>

MultiCombo 이(가) 화면에 표시되는 높이의 최대값을 pixel 단위의 숫자로 설정합니다.

참고

- height 속성값이 maxheight 보다 크면 화면에 표시되는 MultiCombo 의 높이는 maxheight 속성값으로 적용됩니다.
  표시되는 높이만 적용되고 height 속성값은 변경되지 않습니다.

- maxheight 속성값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- maxheight 속성값을 minheight 속성값보다 작게 설정하면 minheight 속성값이 maxheight 속성값으로 설정됩니다.

- Position 관련 속성(left, top 등)에 기준컴포넌트를 설정하여 MultiCombo 의 높이가 상대적으로 설정될 경우에도 적용되는 속성입니다.
   maxheight > height > top(상대값) > bottom(상대값) > top(절대값) > bottom(절대값) 순서로 설정값이 적용됩니다.
   이 때, height, top, bottom 값 중 먼저 2개가 설정되면 나머지는 무시됩니다.

- fittocontents 속성이 있는 컴포넌트는 속성값에 의해 높이가 자동 설정될 때도 적용되는 속성입니다.

maxwidth

MultiCombo 이(가) 화면에 표시되는 최대 너비를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.maxwidth[= nMaxWidth]

문법 설정

nMaxWidth ::= <nVal> ['px']
this.MultiCombo00.maxwidth = 20; 
this.MultiCombo00.maxwidth = "20px";

<nVal>

MultiCombo 이(가) 화면에 표시되는 너비의 최대값을 pixel 단위의 숫자로 설정합니다.

참고

- width 속성값이 maxwidth 보다 크면 화면에 표시되는 MultiCombo 의 너비는 maxwidth 속성값으로 적용됩니다.
  표시되는 너비만 적용되고 width 속성값은 변경되지 않습니다.

- maxwidth 속성값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- maxwidth 속성값을 minwidth 속성값보다 작게 설정하면 minwidth 속성값이 maxwidth 속성값으로 설정됩니다.

- Position 관련 속성(left, top 등)에 기준컴포넌트를 설정하여 MultiCombo 의 너비가 상대적으로 설정될 경우에도 적용되는 속성입니다.
   maxwidth > width > left(상대값) > right(상대값) > left(절대값) > right(절대값) 순서로 설정값이 적용됩니다.
   이 때, width, left, right 값 중 먼저 2개가 설정되면 나머지는 무시됩니다.

- fittocontents 속성이 있는 컴포넌트는 속성값에 의해 너비가 자동 설정될 때도 적용되는 속성입니다.

minheight

MultiCombo 이(가) 화면에 표시되는 최소 높이를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.minheight[= nMinHeight]

문법 설정

nMinHeight ::= <nVal> ['px']
this.MultiCombo00.minheight = 20; 
this.MultiCombo00.minheight = "20px";

<nVal>

MultiCombo 이(가) 화면에 표시되는 높이의 최소값을 pixel 단위의 숫자로 설정합니다.

참고

- height 속성값이 minheight 보다 작다면 화면에 표시되는 MultiCombo 의 높이는 minheight 속성값으로 적용됩니다.
  표시되는 높이만 적용되고 height 속성값은 변경되지 않습니다.

- minheight 속성값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- minheight 속성값을 maxheight 속성값보다 크게 설정하면 maxheight 속성값이 minheight 속성값으로 설정됩니다.

- Position 관련 속성(left, top 등)에 기준컴포넌트를 설정하여 MultiCombo 의 높이가 상대적으로 설정될 경우에도 적용되는 속성입니다.
   minheight > height > top(상대값) > bottom(상대값) > top(절대값) > bottom(절대값) 순서로 설정값이 적용됩니다.
   이 때, height, top, bottom 값 중 먼저 2개가 설정되면 나머지는 무시됩니다.

- fittocontents 속성이 있는 컴포넌트는 속성값에 의해 높이가 자동 설정될 때도 적용되는 속성입니다.

minwidth

MultiCombo 이(가) 화면에 표시되는 최소 너비를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.minwidth[= nMinWidth]

문법 설정

nMinWidth ::= <nVal> ['px']
this.MultiCombo00.minwidth = 20; 
this.MultiCombo00.minwidth = "20px";

<nVal>

MultiCombo 이(가) 화면에 표시되는 너비의 최소값을 pixel 단위의 숫자로 설정합니다.

참고

- width 속성값이 minwidth 보다 작으면 화면에 표시되는 MultiCombo 의 너비는 minwidth 속성값으로 적용됩니다.
  표시되는 너비만 적용되고 width 속성값은 변경되지 않습니다.

- minwidth 속성값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- minwidth 속성값을 maxwidth 속성값보다 크게 설정하면 maxwidth 속성값이 minwidth 속성값으로 설정됩니다.

- Position 관련 속성(left, top 등)에 기준컴포넌트를 설정하여 MultiCombo 의 너비가 상대적으로 설정될 경우에도 적용되는 속성입니다.
   minwidth > width > left(상대값) > right(상대값) > left(절대값) > right(절대값) 순서로 설정값이 적용됩니다.
   이 때, width, left, right 값 중 먼저 2개가 설정되면 나머지는 무시됩니다.

- fittocontents 속성이 있는 컴포넌트는 속성값에 의해 너비가 자동 설정될 때도 적용되는 속성입니다.

multicomboedit

MultiCombo 컴포넌트의 서브컨트롤인 편집영역(multicomboedit) 오브젝트를 갖는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☑ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.multicomboedit // get

문법 설정

var edit = thisMultiCombo00.multicomboedit;

multicombolist

MultiCombo 컴포넌트의 서브컨트롤인 아이템 리스트(multicombolist) 오브젝트를 갖는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☑ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.multicombolist // get

문법 설정

var listbox = thisMultiCombo00.multicombolist;

참고

- 아이템 리스트(multicombolist)가 최초 한번 표시된 후에 접근할 수 있습니다.

name

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.name[= strName]

문법 설정

strName

컴포넌트의 이름을 설정합니다.

참고

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

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

-nexa-border

MultiCombo 의 테두리를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.border[= strborder]

문법 설정

strborder ::= <line-width> <line-style> <color> [,<line-width> <line-style> <color>]{3}

<line-width> ::= 'thin' | 'medium' | 'thick' | <nWidth> 'px'
<line-style> ::= 'none' | 'hidden' | 'dotted' | 'dashed' | 'solid' | 'double' | 'groove' | 'ridge' | 'inset' | 'outset'
<color> ::= <NamedColor> | <NumericColor>

1회 입력 : top/right/bottom/left 에 모두 적용됩니다.
2회 입력 : top/bottom, right/left 에 첫번째 값부터 각각 적용됩니다.
3회 입력 : top, right/left, bottom 에 첫번째 값부터 각각 적용됩니다.
4회 입력 : top, right, bottom, left 에 첫번째 값부터 각각 적용됩니다.

* 2회~4회 입력은 border-radius 속성값이 설정되지 않은 경우만 적용됩니다.
* XCSS
-nexa-border : 1px solid #999999;
-nexa-border : 1px solid #999999, 1px solid #999999, 1px solid #999999, 1px solid #999999;

* Script ( normal property )
this.MultiCombo00.border = "1px solid #999999";
this.MultiCombo00.border = "1px solid #999999, 1px solid #999999, 1px solid #999999, 1px solid #999999";

<line-width>

테두리 선의 두께를 설정합니다.


"thin" 설정 시 1 pixel 두께로 테두리가 표시됩니다.

"medium" 설정 시 3 pixel 두께로 테두리가 표시됩니다.

"thick" 설정 시 5 pixel 두께로 테두리가 표시됩니다.


<nWidth> 설정 시 <nWidth> pixel 두께로 테두리가 표시됩니다.

<nWidth>

테두리 선의 두께를 pixel 단위로 설정합니다.

"px" 단위는 생략할 수 없습니다.

<line-style>

테두리 선의 스타일을 설정합니다.


"none" 설정 시 테두리가 표시되지 않습니다.

"hidden" 설정 시 테두리가 표시되지 않습니다.

"dotted" 설정 시 테두리가 점선으로 표시됩니다.

"dashed" 설정 시 테두리가 긴 점선으로 표시됩니다.

"solid" 설정 시 테두리가 실선으로 표시됩니다.

"double" 설정 시 테두리가 두줄로 표시됩니다.

"groove" 설정 시 테두리가 들어간 것처럼 보이게 입체적으로 표시됩니다.

"ridge" 설정 시 테두리가 올라온 것처럼 보이게 입체적으로 표시됩니다.

"inset" 설정 시 컴포넌트가 들어간 것처럼 보이게 테두리가 입체적으로 표시됩니다.

"outset" 설정 시 컴포넌트가 올라온 것처럼 보이게 테두리가 입체적으로 표시됩니다.

<color>

테두리 색상을 색상이름 또는 색상코드로 설정합니다.

<NamedColor>

"red","blue" 와 같이 미리 정의된 색상이름을 문자열로 설정합니다.

<NumericColor>

표시할 색의 색상코드입니다.


"#" 기호로 시작하는 6자리 hexadecimal 값으로 색상코드를 설정할 수 있습니다. (ex-"#FF00FF")

red, green, blue 값을 인자로 하는 "rgb()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"rgb(255,0,255)")

red, green, blue, alpha 값을 인자로 하는 "rgba()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"rgba(255,0,255,0.3)")

hue, saturation, lightness 값을 인자로 하는 "hsl()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"hsl(120,50%,50%)")

hue, saturation, lightness, alpha 값을 인자로 하는 "hsla()" 메소드로 색상코드를 설정할 수 있습니다. (ex-"hsla(120,50%,50%,0.8)")

참고

- -nexa-border 속성값을 설정하지 않으면 undefined 가 설정되고, "medium none #999999" 로 동작합니다.

- <line-style> 이 "double" 일 때 두 줄을 다른 색으로 설정할 수 없습니다.
   <color> 에 설정된 색이 두 줄에 모두 적용됩니다.

- 스크립트로 접근 시 속성명은 "border"를 사용해야 합니다.


◆ Nexacro Runtime Environment 제약

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 top > right > bottom > left 순으로 겹쳐서 표시됩니다.

- <line-style> 에 "double","groove","ridge","inset","outset" 값을 설정해도 적용되지 않습니다.

- <line-width> 에 "thin","medium","thick" 값을 설정해도 적용되지 않습니다.


◆ Web Runtime Environment 제약

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 웹브라우저에 따라 테두리가 겹쳐지는 순서가 다르게 처리될 수 있습니다.

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 border-radius 속성값이 설정되어 있으면 
   두께는 각 테두리 별로 따로 적용되고, 색상은 top 에 설정된 색이 적용됩니다.

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 border-radius 속성값이 설정되어 있어도
   일부 브라우저는 각 테두리의 색상이나 두께가 각각 적용됩니다.

- XCSS 를 사용하지 않고 rgba(), hsl(), hsla() 메소드를 속성에 직접 설정할 경우 브라우저 버전에 따라 적용되지 않을 수 있습니다.

-nexa-edge

MultiCombo 의 테두리(Border) 안쪽에 표시될 Edge 이미지를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.edge[= stredge]

문법 설정

stredge ::= 'none' | <image> [<fixedwidth>'px' <fixedheight>'px']

<image> ::= 'URL("' <Theme-Image> | <Web-Image> '")'
* XCSS
-nexa-edge : "URL('./images/border.png')" 5px 5px;

* Script ( normal property )
this.MultiCombo00.edge = "URL('./images/border.png')" 5px 5px;

"none"

edge 이미지를 설정하지 않습니다.

<image>

'URL ("[이미지위치]")' 형식으로 테마 또는 웹의 이미지를 설정합니다.


테두리(border) 안쪽에 edge 형태로 이미지가 표시됩니다.

<Theme-Image>

테마에 선언된 이미지를 "theme://images\이미지명" 형식으로 설정합니다.


테마에 해당 이미지가 등록되어 있어야 합니다.

<Web-Image>

웹의 이미지를 "http://경로/이미지명", "https://경로/파일명" 형식으로 설정합니다.


웹에 접근 가능한 환경이어야 합니다.

<fixedwidth>

이미지가 고정되어 표시될 왼쪽/오른쪽 영역의 크기를 pixel 단위로 설정합니다.

"0px" 설정 시 왼쪽/오른쪽 영역을 고정하지 않습니다.


값을 설정하지 않으면 "0px" 로 적용됩니다.

<fixedheight>

이미지가 고정되어 표시될 위쪽/아래쪽 영역의 크기를 pixel 단위로 설정합니다.

"0px" 설정 시 위쪽/아래쪽 영역을 고정하지 않습니다.


값을 설정하지 않으면 "0px" 로 적용됩니다.

참고

- -nexa-edge 속성값을 설정하지 않으면 undefined 가 설정되고, "none" 으로 동작합니다.

- 스크립트로 접근 시 속성명은 "edge" 를 사용해야 합니다.

- MultiCombo 내부에 테두리 형태로 이미지를 표시하고자 할 때 사용하는 속성입니다.

- -nexa-edge 속성값을 설정하면 이미지의 상/하/좌/우 일정 영역(<fixedwidth>,<fixedheight> 값)을 고정하고 안쪽 사각형 영역을 Stretch 하여 처리합니다.

- background 속성에 의해 배경색 또는 이미지가 설정되어 있어도 -nexa-edge 속성에 설정된 이미지가 제일 위에 표시됩니다.

- TypeDefinition 영역의 Services 에 정의된 사용자 Prefix 는 테마 또는 XCSS 에서 이미지경로로 사용할 수 없습니다.
   사용자 Prefix 는 스크립트 또는 넥사크로 스튜디오에서 속성값으로 설정 시 사용할 수 있습니다.


◆ WRE 제약

- <fixedwidth>,<fixedheight> 값이 이미지 사이즈의 1/2 을 초과할 경우 브라우저별로 보이는 형태가 다를 수 있습니다.

- CSS3 스펙을 지원하지 않는 브라우저 버전에서는 정상적으로 표시되지 않을 수 있습니다.

-nexa-padding

MultiCombo 영역의 안쪽 여백을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.padding[= strpadding]

문법 설정

strpadding ::= <npadding>'px'{4}
* XCSS
-nexa-padding : 5px 5px 5px 5px;

* Script ( normal property )
this.MultiCombo00.padding = "5px 5px 5px 5px";

<npadding>

MultiCombo 영역의 안쪽 여백을 pixel 단위로 설정합니다.


값을 1회 입력 시 top/right/bottom/left 에 모두 동일한 값이 적용됩니다.

값을 2회 입력 시 top/bottom, right/left 에 첫번째 값부터 각각 적용됩니다.

값을 3회 입력 시 top, right/left, bottom 에 첫번째 값부터 각각 적용됩니다.

값을 4회 입력 시 top, right, bottom, left 에 첫번째 값부터 각각 적용됩니다.


"px" 단위를 생략할 수 없습니다.

참고

- -nexa-padding 속성값을 설정하지 않으면 undefined 가 설정되고, "0px" 로 동작합니다.

- 스크립트로 접근 시 속성명은 "padding" 을 사용해야 합니다.

- -nexa-padding 속성은 내부 컨텐츠영역과 MultiCombo 사이의 여백으로 적용됩니다.

- Div 와 같이 자식을 가질 수 있는 컴포넌트에서 -nexa-padding 속성은 자식 컴포넌트의 위치에 영향을 주지 않습니다.

-nexa-rtl-background-image

MultiCombo 의 rtl 속성이 true 로 적용될 때 배경에 표시될 이미지를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.-nexa-rtl-background-image

문법 설정

strRtlBgImage ::= "URL(' " <Theme-Image> | <Web-Image> " ')"
* XCSS
-nexa-rtl-background-image : URL("http://localhost/Test.jpg");
-nexa-rtl-background-image : URL("theme://images/Test.jpg");

strRtlBgImage

"URL ('<이미지위치>')" 형식으로 테마 또는 웹의 이미지 경로를 문자열로 설정합니다.


background 속성에 설정된 값 중 이미지만 설정한 이미지로 대체됩니다.

background 속성에 설정된 이미지 이외의 값은 동일하게 적용됩니다.

<Theme-Image>

테마에 정의된 이미지를 "theme://images/이미지명" 형식으로 설정합니다.


테마에 해당 이미지가 등록되어 있어야 합니다.

<Web-Image>

웹의 이미지를 "http://경로/이미지명", "https://경로/이미지명" 형식으로 설정합니다.


웹에 접근 가능한 환경이어야 합니다.

참고

- rtl 속성에 의해 표시기준이 변경되면 반전된 이미지를 적용하려 할 때 사용하는 속성입니다.

- XCSS 에서만 설정할 수 있는 속성으로 스크립트로 값을 변경할 수 없습니다.
   XCSS 에 -nexa-rtl-background-image 속성값을 설정하지 않으면 background 속성에 설정된 이미지가 적용됩니다.

- TypeDefinition 영역의 Services 에 정의된 사용자 Prefix 는 테마 또는 XCSS 에서 이미지경로로 사용할 수 없습니다.

- 배경이미지가 적용되는 영역은 컴포넌트의 클라이언트 영역입니다.

- background 속성에 배경색이 설정되어 있을 경우 배경색 위에 이미지가 표시됩니다.

- 그라데이션과 배경이미지를 동시에 설정할 수 없습니다.
   background 속성에 그라데이션이 설정되어 있을 경우 오동작이 발생할 수 있습니다.

-nexa-rtl-edge-image

MultiCombo 의 rtl 속성이 true 로 적용될 때 테두리(Border) 안쪽에 표시될 Edge 이미지를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.-nexa-rtl-edge-image

문법 설정

strRtlEgImage ::= "URL(' " <Theme-Image> | <Web-Image> " ')"
* XCSS
-nexa-rtl-edge-image : URL("http://localhost/Test.jpg");
-nexa-rtl-edge-image : URL("theme://images/Test.jpg")

strRtlEgImage

"URL ('<이미지위치>')" 형식으로 테마 또는 웹의 이미지 경로를 문자열로 설정합니다.


-nexa-edge 속성에 설정된 값 중 이미지만 설정한 이미지로 대체됩니다.

-nexa-edge 속성에 설정된 이미지 이외의 값은 동일하게 적용됩니다.

<Theme-Image>

테마에 정의된 이미지를 "theme://images/이미지명" 형식으로 설정합니다.


테마에 해당 이미지가 등록되어 있어야 합니다.

<Web-Image>

웹의 이미지를 "http://경로/이미지명", "https://경로/이미지명" 형식으로 설정합니다.


웹에 접근 가능한 환경이어야 합니다.

참고

- rtl 속성에 의해 표시기준이 변경되면 반전된 이미지를 적용하려 할 때 사용하는 속성입니다.

- XCSS 에서만 설정할 수 있는 속성으로 스크립트로 값을 변경할 수 없습니다.
   XCSS 에 -nexa-rtl-edge-image 속성값을 설정하지 않으면 -nexa-edge 속성에 설정된 이미지가 적용됩니다.

- TypeDefinition 영역의 Services 에 정의된 사용자 Prefix 는 테마 또는 XCSS 에서 이미지경로로 사용할 수 없습니다.

- 배경이미지가 적용되는 영역은 컴포넌트의 클라이언트 영역입니다.

- background 또는 -nexa-rtl-background-image 속성에 의해 배경색 또는 이미지가 설정되어 있어도 -nexa-rtl-edge-image 속성에 설정된 이미지가 제일 위에 표시됩니다.


◆ web runtime environment 제약

- CSS3 스펙을 지원하지 않는 브라우저 버전에서는 정상적으로 표시되지 않을 수 있습니다.

opacity

MultiCombo 영역의 투명도를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.opacity[= stropacity]

문법 설정

* XCSS
opacity : 0.8;
opacity : 80%;

* Script ( normal property )
this.MultiCombo00.opacity = "0.8";
this.MultiCombo00.opacity = 0.8;
this.MultiCombo00.opacity = "80%";

strOpacity

0.0 ~ 1.0 사이의 값 또는 0.0% ~ 100.0% 사이의 값을 지정합니다.

0(또는 0%)을 설정하면 완전 투명, 1(또는 100%)을 설정하면 완전 불투명으로 처리됩니다.

1 이상의 값은 1로, 0 이하의 값은 0으로 처리됩니다. 마찬가지로 100% 이상의 값은 100%로, 0% 이하의 값은 0%로 처리됩니다.


XCSS는 숫자 또는 퍼센트 값으로만 설정할 수 있습니다.

Script는 숫자 또는 문자(숫자, 퍼센트 값)로 설정할 수 있습니다.

참고

- opacity 속성값을 설정하지 않으면 undefined 가 설정되고, 1 로 동작합니다.

- Div 와 같이 자식 컴포넌트를 가질 수 있는 컴포넌트에 opacity 속성을 적용하면 자식 컴포넌트도 함께 적용됩니다.

- 부모와 자식 컴포넌트에 각각 opacity 속성이 설정되어 있으면 자식 컴포넌트의 투명도는 부모의 투명도에 추가적으로 적용됩니다.
   예를 들어 부모의 opacity가 0.5 이고 자식의 opacity가 0.4 이면 결과적으로 자식 컴포넌트는 0.2 의 투명도가 적용됩니다.

parent

MultiCombo 의 부모 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.parent

문법 설정

var objParent = this.MultiCombo00.parent;

참고

- parent 속성은 일반적으로 컴포넌트가 속한 Form을 갖습니다.

- MultiCombo 이(가) Div 와 같은 컨테이너 컴포넌트에 자식으로 존재한다면 parent 속성은 해당 컨테이너 컴포넌트를 갖습니다.

- Calendar 와 같이 서브컨트롤이 존재하는 컴포넌트에서 서브컨트롤의 parent 속성은 해당 컴포넌트를 갖습니다.

popupsize

화면에 팝업으로 표시되는 아이템 리스트의 크기를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.popupsize[= strSize]

문법 설정

strSize ::= <strWidth> [<strHeight>]
this.MultiCombo00.popupsize  = "120 250";

strWidth

아이템 리스트의 너비를 Pixel 단위의 문자열로 설정합니다.


값을 생략할 수 없습니다.

strHeight

아이템 리스트의 높이를 Pixel 단위의 문자열로 설정합니다.


값을 생략할 경우 아이템 리스트의 높이가 자동으로 적용됩니다.

참고

- popupsize 속성값을 설정하지 않으면 undefined로 적용됩니다.
   undefined 설정 시 아이템 리스트의 너비와 높이가 자동으로 적용됩니다.

- popupsize 속성에 너비값을 아이템의 텍스트 길이보다 작게 설정할 경우 텍스트가 잘려서 표시됩니다.

popuptype

MultiCombo 컴포넌트의 아이템 리스트가 표시되는 방식을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.popuptype[= enumType]

문법 설정

enumType ::= "none" | "normal" | "center"
this.MultiCombo00.popuptype  = "normal";

"none"

아이템 리스트를 화면에 표시하지 않습니다.

"normal"

아이템 리스트가 표시되는 일반적인 규칙을 따릅니다.

"center"

Application이 실행 중인 화면의 중앙에 아이템 리스트가 표시됩니다

참고

- popuptype 속성값을 설정하지 않으면 "normal"로 적용됩니다.

- 모바일환경 같은 특별한 경우에 제한적으로 사용해야 하는 속성입니다.

- 다중 모니터의 경우 MultiCombo 컴포넌트가 표시되고 있는 모니터를 기준으로 아이템 리스트가 표시됩니다.

positionstep

부모 오브젝트가 화면분할기능을 사용할 때 MultiCombo 이(가) 표시될 화면의 인덱스를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.positionstep[= nStep]

문법 설정

this.MultiCombo00.positionstep = 0; 
this.MultiCombo00.positionstep = -1;

nStep

MultiCombo 이(가) 표시될 분할화면의 인덱스를 설정합니다.

"-1" 로 설정하면 모든 분할화면에 MultiCombo 이(가) 표시됩니다.


분할화면의 인덱스는 "0" 부터 시작합니다.

참고

- positionstep 에 설정된 인덱스값과 일치하는 분할화면에만 컴포넌트가 표시됩니다.

- 분할화면에 표시되지 않는 컴포넌트의 visible 속성값은 "false"로 변경되지 않습니다.

활용 예제

readonly

MultiCombo 컴포넌트에서 아이템 변경을 허용할지 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.readonly[= bReadOnly]

문법 설정

bReadOnly ::= true | false

true

MultiCombo 컴포넌트에서 선택된 아이템을 변경할 수 없으며 아이템 리스트가 표시되지 않습니다.

MultiCombo 컴포넌트에 표시된 텍스트를 선택하여 내용을 복사하는 것은 가능합니다.


하위 컨트롤에 "readonly" Status 가 적용됩니다.

"readonly" Status 가 없는 하위 컨트롤은 "disabled" Status 가 적용됩니다.

false

MultiCombo 컴포넌트에서 선택된 아이템을 변경할 수 있습니다.

참고

- readonly 속성값을 설정하지 않으면 false로 적용됩니다.


◆ Android WRE 제약

- Android WRE는 편집영역의 선택과 복사 기능에 대한 정확한 동작을 보장하지 않습니다.

readonlycolumn

MultiCombo 컴포넌트에서 아이템 readonly 여부 설정 시 사용될 Column을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.readonlycolumn[= strColumnID]

문법 설정

this.MultiCombo00.readonlycolumn = "Column0";

strColumnID

innerdataset 속성에 설정된 Dataset 오브젝트의 Column 중 아이템 readonly 여부를 설정할 Column의 ID를 문자열로 설정합니다.

참고

- MultiCombo 컴포넌트의 readonly 속성값이 false인 경우 개별 아이템의 readonly 여부를 설정합니다.
  MultiCombo 컴포넌트의 readonly 속성값이 true인 경우에는 모든 아이템이 readonly로 처리됩니다.

true / false

Column type

Row data

false

STRING

"0", "-0", "false", "NaN", 빈 값, Null

INT, FLOAT, BIGDECIMAL

0, -0, 빈 값, Null

true


false로 처리되는 값 이외의 모든 값

활용 예제

right

MultiCombo 를 표시하기 위한 우측 좌표값을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.right[= nRight]

문법 설정

nRight ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']
this.MultiCombo00.right = 10; 
this.MultiCombo00.right = "10px"; 
this.MultiCombo00.right = "10%"; 
this.MultiCombo00.right = "Button00:10px"; 
this.MultiCombo00.right = "Button00:10%";

<strCompID>

MultiCombo 의 좌표값을 상대적으로 적용하기 위해 기준이 되는 컴포넌트의 ID 를 설정합니다.


기준 컴포넌트는 MultiCombo 와 부모(Parent)가 동일하여야 합니다.

또한, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.


값을 설정하지 않거나 잘못된 값을 설정하면 부모(Parent) 를 기준으로 좌표값이 적용됩니다.

<nVal>

MultiCombo 의 우측 좌표값을 절대 길이 단위("px"), 비율 단위("%"), 상대 길이 단위("em", "rem")의 숫자로 설정합니다.


  • <strCompID> 값을 생략했을 때 :

- "px": 부모(Parent)의 right 속성값을 기준으로 MultiCombo의 우측 위치 설정

- "%": 부모(Parent)의 width 속성값을 기준으로 MultiCombo의 우측 위치 결정

- "em": 컴포넌트의 font-size 속성값을 기준으로 MultiCombo의 우측 위치 결정

- "rem": MainFrame font-size 속성값을 기준으로 MultiCombo의 우측 위치 결정


  • <strCompID> 값을 설정했을 때 :

- "px": <strCompID>의 left 속성값을 기준으로 MultiCombo의 우측 위치 결정

- "%": <strCompID>의 width 속성값을 기준으로 MultiCombo의 우측 위치 결정

<strCompID> 값 설정 시 "em", "rem" 단위는 지원하지 않습니다.

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 좌표값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

rtl

MultiCombo 에서 내부 컨텐츠 또는 컴포넌트의 표시 기준을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.rtl

문법 설정

bRtl ::= undefined | 'true' | 'false'
var vRtl = this.MultiCombo00.rtl;

undefined

undefined 설정 시 상위 컴포넌트의 rtl 속성값이 적용됩니다.


사용자가 rtl 속성값을 설정하지 않거나 삭제했을 경우 undefined 가 설정됩니다.

true

MultiCombo 의 내부 컨텐츠 또는 컴포넌트가 표시되는 기준을 오른쪽으로 설정합니다.

MultiCombo 의 내부 좌표계의 기준을 오른쪽으로 설정합니다.

MultiCombo 의 텍스트 표시 기준을 오른쪽으로 설정합니다.

수직스크롤바가 있을 경우 왼쪽에 표시됩니다.

false

MultiCombo 의 내부 컨텐츠 또는 컴포넌트가 표시되는 기준을 왼쪽으로 설정합니다.

MultiCombo 의 내부 좌표계의 기준을 왼쪽으로 설정합니다.

MultiCombo 의 텍스트 표시 기준을 왼쪽으로 설정합니다.

수직스크롤바가 있을 경우 오른쪽에 표시됩니다.

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 아랍권 같이 화면의 표시기준이 오른쪽인 환경에서 컨텐츠의 표시 기준을 변경하기 위해 설정하는 속성입니다.

- MultiCombo 부터 Environment 까지 상위의 모든 rtl 속성값이 undefined 이면
   Environment 의 locale 속성에 설정된 국가 및 언어 설정값을 기준으로 rtl 속성이 적용됩니다.
   Environment 의 locale 속성값을 설정하지 않았을 경우 시스템의 국가 및 언어 설정값이 적용됩니다.

scrollbarbarminsize

아이템 리스트에 표시되는 스크롤바의 트랙바(TrackBar) 최소크기를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.scrollbarbarminsize[= nSize]

문법 설정

this.MultiCombo00.scrollbarbarminsize = 20;

nSize

스크롤바의 트랙바 최소크기를 pixel 단위의 숫자로 설정합니다.


음수값은 설정할 수 없습니다.

참고

- scrollbarbarminsize 속성값을 설정하지 않으면 undefined 가 설정되고 트랙바 크기에 맞는 적당한 값으로 동작합니다.

- scrollbartrackbarsize 속성값이 설정되어 있으면 scrollbarbarminsize 속성값은 무시됩니다.

- 아이템 리스트의 크기 변경에 의해 트랙바의 크기가 자동변경될 때 scrollbarbarminsize 속성값 미만으로 작아지지 않습니다.

- 트랙바가 표시되는 영역보다 scrollbarbarminsize 속성값을 크게 설정해도 트랙바는 표시영역까지만 표현됩니다.

scrollbarbaroutsize

아이템 리스트의 스크롤바에서 트랙바(TrackBar)가 사라지는 기준 크기를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.scrollbarbaroutsize[= nSize]

문법 설정

this.MultiCombo00.scrollbarbaroutsize( 50 );

nSize

스크롤바의 트랙바가 사라지는 기준 크기를 pixel 단위의 숫자로 설정합니다.


음수값은 설정할 수 없습니다.

참고

- scrollbarbaroutsize 속성값을 설정하지 않으면 undefined 가 설정되고 트랙바 크기에 맞는 적당한 값으로 동작합니다.

- 아이템 리스트의 크기가 변경되어 스크롤바가 줄어들 때 트랙바를 표시할 공간이 scrollbarbaroutsize 속성값보다 작아지면 트랙바를 표시하지 않습니다.

scrollbardecbuttonsize

아이템 리스트에 표시되는 스크롤바의 감소 버튼(DecButton) 높이를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.scrollbardecbuttonsize[= nHeight]

문법 설정

this.MultiCombo00.scrollbardecbuttonsize = 30;

nHeight

스크롤바의 감소버튼(DecButton) 높이를 pixel 단위의 숫자로 설정합니다.


음수값이나 아이템리스트의 높이보다 큰 값을 설정할 수 없습니다.

참고

- scrollbardecbuttonsize 속성값을 설정하지 않으면 scrollbarsize에 적용된 값이 적용됩니다.

- 감소 버튼(DecButton)의 높이는 scrollbardecbuttonsize 속성으로 설정하고 너비는 scrollbarsize 속성으로 설정합니다.

scrollbarincbuttonsize

아이템 리스트에 표시되는 스크롤바의 증가 버튼(IncButton) 높이를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.scrollbarincbuttonsize[= nHeight]

문법 설정

this.MultiCombo00.scrollbarincbuttonsize = 30;

nHeight

스크롤바의 증가 버튼(IncButton) 높이를 pixel 단위의 숫자로 설정합니다.


음수값이나 아이템 리스트의 높이보다 큰 값을 설정할 수 없습니다.

참고

- scrollbarincbuttonsize 속성값을 설정하지 않으면 scrollbarsize에 적용된 값이 적용됩니다.

- 증가 버튼(IncButton)의 높이는 scrollbarincbuttonsize 속성으로 설정하고 너비는 scrollbarsize 속성으로 설정합니다.

scrollbarsize

아이템 리스트에 표시되는 스크롤바의 너비를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.scrollbarsize[= nWidth]

문법 설정

this.MultiCombo00.scrollbarsize = 20;

nWidth

스크롤바의 너비를 숫자로 설정합니다.

참고

- scrollbarsize 속성값을 변경하면 스크롤바 내부버튼의 높이와 너비가 같이 변경됩니다.

scrollbartrackbarsize

아이템 리스트에 표시되는 스크롤바의 트랙바(TrackBar) 크기를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.scrollbartrackbarsize[= nSize]

문법 설정

this.MultiCombo00.scrollbartrackbarsize = 20;

nSize

스크롤바의 트랙바 크기를 pixel 단위의 숫자로 설정합니다.


-1 을 설정하면 아이템 리스트 크기와 아이템의 개수에 따라 트랙바 크기가 자동으로 조절됩니다.

-2 이하의 음수값은 설정할 수 없습니다.

참고

- scrollbartrackbarsize 속성값을 설정하지 않으면 undefined 가 설정되고 -1로 동작합니다.

- scrollbartrackbarsize 속성을 설정하면 아이템 리스트 크기와 아이템 개수에 관계없이 트랙바 크기가 고정되어 표시됩니다.

scrollindicatorsize

MultiCombo 에 표시되는 스크롤 인디케이터바의 크기를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.scrollindicatorsize[= nSize]

문법 설정

this.MultiCombo00.scrollindicatorsize = 30;

nSize

스크롤 인디케이터바의 크기를 pixel 단위의 숫자로 설정합니다.

참고

- scrollindicatorsize 속성값은 수직스크롤바의 너비와 수평스크롤바의 높이에 동일하게 적용됩니다.

- MultiCombo 에 스크롤 인디케이터바가 아닌 스크롤바가 표시될 경우 scrollbarsize 속성으로 크기를 설정하여야 합니다.

selectallcheckboxheight

MultiCombo 컴포넌트의 아이템 리스트에서 selectallcheckbox의 높이를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.selectallcheckboxheight[= nHeight]

문법 설정

this.MultiCombo00.selectallcheckboxheight = 20;

nHeight

selectallcheckbox의 높이를 pixel 단위의 숫자로 설정합니다.

참고

- selectallcheckboxheight 속성을 설정하지 않으면 글자 크기를 기준으로 selectallcheckbox의 높이를 자동 계산합니다.

showselectallcheckbox

아이템 리스트 상단에 아이템 전체를 선택 또는 선택해제하는 체크박스의 표시 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.showselectallcheckbox[= bSelectall]

문법 설정

bSelectall ::= true | false
this.MultiCombo00.showselectallcheckbox = true;
this.MultiCombo00.showselectallcheckbox = false;

true

아이템 전체를 선택 또는 선택해제하는 체크박스를 아이템 리스트 상단에 표시합니다.

false

아이템 전체를 선택 또는 선택해제하는 체크박스를 아이템 리스트 상단에 표시하지 않습니다.

참고

- showselectallcheckbox 속성값을 설정하지 않으면 false로 적용됩니다.

tablecellarea

Layout 컨테이너 내 가상의 Table Cell 영역 내에서 컴포넌트가 배치되는 영역을 설정합니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tablecellarea[= strArea]

문법 설정

strArea ::= <rowstart> <rowend> '/' <columnstart> <columnend> | <strArea>

<strPosition> ::= <rowstart> <rowend> '/' <columnstart> <columnend>

<strPosition>

컴포넌트를 배치할 Cell 좌표를 설정합니다.


rowstart, rowend 또는 columnstart, columnend 구분은 공백문자를 사용합니다.

rowstart, rowend 또는 columnstart, columnend 가 같은(하나의 Cell 영역만 설정) 경우에는 하나의 값만 표기할 수 있습니다.

예를 들어 0 / 0 또는 0 0 / 0 0 으로 설정할 수 있습니다.

<strArea>

컴포넌트를 배치할 tabletemplatearea 속성에서 설정한 Cell 이름을 설정합니다.

참고

- 유효하지 않은 값을 설정한 경우에는 layoutorder, tabledirection 속성값에 따라 배치됩니다.

- 같은 영역에 2개 이상의 컴포넌트를 배치할 수 있습니다.

- row와 column의 start, end는 반대 방향으로 설정할 수 있습니다.
  예를 들어 "2 0 / 2 0"과 "0 2 / 0 2"은 같은 영역으로 처리합니다.

활용 예제

taborder

탭키 입력으로 컴포넌트간 포커스를 이동할 때 MultiCombo 의 순서를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.taborder[= nTabOrder]

문법 설정

nTabOrder

0 이상의 정수로 설정합니다.

참고

- taborder 속성값이 작은 컴포넌트에 포커스가 먼저 이동되고, 속성값이 클수록 나중에 포커스가 이동됩니다.

- taborder 속성값이 동일한 컴포넌트는 폼에 먼저 생성된 컴포넌트에 포커스가 먼저 이동됩니다.

- 스크립트로 taborder 속성값 변경 시 포커스 이동 순서가 변경됩니다.

- Div 와 같은 컨테이너 컴포넌트는 자식 컴포넌트 레벨에서 포커스 이동 순서가 별도로 정의됩니다.

활용 예제

tabstop

탭키 입력으로 컴포넌트간 포커스를 이동할 때 MultiCombo 이(가) 포커스를 받을 지 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tabstop[= bTabStop]

문법 설정

bTabStop ::= 'true' | 'false'

"true"

MultiCombo 이(가) 탭키 입력에 의한 포커스를 받습니다.

"false"

MultiCombo 이(가) 탭키 입력에 의한 포커스를 받지 않습니다.

참고

- tabstop 속성값이 "false"인 경우 taborder 속성값과 관계없이 포커스가 해당 컴포넌트를 건너뜁니다.

- tabstop 속성값에 관계없이 마우스로 직접 포커스를 주거나, setfocus() 메소드 사용 시 포커스를 갖습니다.

- Div 와 같은 컨테이너 컴포넌트에서 포커스를 받을 수 있는 자식 컴포넌트가 존재하면 해당 컴포넌트가 포커스를 갖습니다.

tagboxitemhorizontalgap

MultiCombo 컴포넌트의 multicombotagbox에서 tagboxitem 간의 수평 간격을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tagboxitemhorizontalgap [=nGap]

문법 설정

this.MultiCombo00.tagboxitemhorizontalgap = 5;

nGap

tagboxitem 간의 간격을 pixel 단위의 숫자로 설정합니다.

참고

- tagboxitemhorizontalgap 속성값을 설정하지 않으면 undefined로 적용됩니다.
  undefined 설정 시 5px로 적용됩니다.

- tagboxitem과 tagboxedit 사이의 간격에도 적용됩니다.

tagboxitemverticalgap

MultiCombo 컴포넌트의 multicombotagbox에서 tagboxitem 간의 수직 간격을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tagboxitemverticalgap [=nGap]

문법 설정

this.MultiCombo00.tagboxitemverticalgap = 5;

nGap

tagboxitem 간의 간격을 pixel 단위의 숫자로 설정합니다.

참고

- tagboxitemverticalgap 속성값을 설정하지 않으면 undefined로 적용됩니다.
  undefined 설정 시 5px로 적용됩니다.

tagboxscrollbarsize

multicombotagbox에 표시되는 스크롤바의 너비를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tagboxscrollbarsize[= nWidth]

문법 설정

this.MultiCombo00.tagboxscrollbarsize = 20;

nWidth

스크롤바의 너비를 숫자로 설정합니다.

참고

- tagboxscrollbarsize 속성값을 변경하면 스크롤바 내부버튼의 높이와 너비가 같이 변경됩니다.

tagboxscrollbartype

multicombotagbox에 스크롤바가 표시되는 형식을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tagboxscrollbartype[= strBartype]

문법 설정

strBartype ::= <desktype> | <mobiletype>

<desktype> ::= 'default' | 'none' | 'fixed' | 'auto'
<mobiletype> ::= 'default' | 'none' | 'indicator' | 'autoindicator'
this.MultiCombo00.tagboxscrollbartype = "none";
this.MultiCombo00.tagboxscrollbartype = "default";

"default"

Desktop 환경인 경우 "auto"로 적용됩니다.

Mobile 환경인 경우 "autoindicator"로 적용됩니다.

"none"

스크롤바 또는 인디케이터바를 표시하지 않습니다.

"fixed"

스크롤바를 항상 표시합니다.

"auto"

스크롤바가 필요할 때 자동으로 표시합니다.

"indicator"

스크롤 인디케이터바가 필요할 때 자동으로 표시합니다.

"autoindicator"

스크롤이 동작될 때만 인디케이터바가 표시되었다가 스크롤이 종료되면 사라집니다.

참고

- tagboxscrollbartype 속성값을 설정하지 않으면 "default"로 적용됩니다.

- edittype 속성값이 "singletag"인 경우에는 가로 스크롤바, "multitag"인 경우에는 세로 스크롤바만 표시됩니다.

tagboxscrollindicatorsize

multicombotagbox에 표시되는 스크롤 인디케이터바의 크기를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tagboxscrollindicatorsize[= nSize]

문법 설정

this.MultiCombo00.tagboxscrollindicatorsize = 30;

nSize

스크롤 인디케이터바의 크기를 pixel 단위의 숫자로 설정합니다.

참고

- tagboxscrollindicatorsize 속성값은 수직스크롤바의 너비와 수평스크롤바의 높이에 동일하게 적용됩니다.

- 스크롤 인디케이터바가 아닌 스크롤바가 표시될 경우 tagboxscrollbarsize 속성으로 크기를 설정하여야 합니다.

tagbuttonsize

MultiCombo 컴포넌트 tagbutton의 크기를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tagbuttonsize [= strSize]

문법 설정

strSize ::= <strWidth> [<strHeight>]
this.MultiCombo00.tagbuttonsize = "20";
this.MultiCombo00.tagbuttonsize = "40 20";

<strWidth>

tagbutton의 너비를 pixel 단위의 문자열로 설정합니다.

<strHeight>

tagbutton의 높이를 pixel 단위의 문자열로 설정합니다.


값을 생략할 경우 <strWidth> 값이 적용됩니다.

참고

- tagbuttonsize 속성값을 설정하지 않으면 undefined로 적용됩니다.
  undefined 설정 시 tagtext 글자 크기를 기준으로 자동 계산되어 적용됩니다.

- <strWidth> 값과 <strHeight> 값은 공백문자로 구분하여 문자열로 설정합니다.

text

MultiCombo 컴포넌트에서 선택된 아이템의 데이터값을 갖는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.text[= strText]

문법 설정

this.MultiCombo00.text = "data00,data01";

strText

아이템 리스트 중에서 선택할 아이템의 데이터값을 1개 이상 구분자를 사용해 설정합니다.

구분자는 textseparator 속성값을 적용합니다.

참고

- index 속성값을 설정하지 않았거나  -1로 설정된 경우에는 empty string("") 값을 반환합니다.

- value 또는 index 속성값 변경에 의해 선택된 아이템이 변경될 경우 text 속성값도 해당 아이템에 맞게 변경됩니다.

- datacolumn 속성값으로 설정한 Column의 데이터가 text 속성값으로 설정됩니다.

textseparator

MultiCombo 컴포넌트에서 2개 이상의 text 속성값 설정 시 구분자로 사용할 값을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.textseparator[= strTextSeparator]

문법 설정

this.MultiCombo00.textseparator = ";";

strTextSeparator

구분자를 설정합니다.

참고

- textseparator 속성값을 설정하지 않으면 ","로 적용됩니다.

tooltiptext

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☐ Android

☐ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☑ StringResource

문법

MultiCombo.tooltiptext[= strToolTipText]

문법 설정

this.MultiCombo00.tooltiptext = "This is ToolTip Text"; this.MultiCombo00.tooltiptext = "";          // 풍선 도움말이 표시되지 않습니다. 

this.MultiCombo00.tooltiptext = null;        // 상위 컴포넌트의 풍선 도움말이 표시됩니다.

strToolTipText

풍선도움말에 표시할 텍스트를 설정합니다.


빈문자열(EmptyString) 설정 시 풍선도움말이 표시되지 않습니다.

null 또는 undefined 설정 시 상위컴포넌트(Form, Div 등)의 풍선도움말이 표시됩니다.

참고

- tooltiptext 속성값을 설정하지 않으면 undefined 로 적용됩니다.

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

- 풍선도움말이 표시된 상태에서 tooltiptext 속성값을 변경하면 풍선도움말이 사라집니다.


◆ Desktop WRE 제약

- 풍선도움말은 브라우저의 기능을 활용하므로 브라우저 사양에 따라 스타일에 차이가 있을 수 있습니다.
   NRE는 Chrome 의 스타일과 동일하게 적용됩니다.

tooltiptype

MultiCombo 에서 풍선도움말이 표시될 위치와 방식을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☐ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☐ Android

☐ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.tooltiptype[= enumTooltipType]

문법 설정

enumTooltipType ::= 'default' | 'hover' | 'inplace' | 'default,mouseleave' | 'hover,mouseleave' | 'inplace,mouseleave'
this.MultiCombo00.tooltiptype = "hover";

"default"

마우스 포인터의 오른쪽 하단 위치에 풍선도움말을 표시합니다.


마우스 포인터가 MultiCombo 영역내에 위치하고 일정시간이 경과하면 풍선도움말이 사라집니다.

"hover"

마우스 포인터의 오른쪽 하단 위치에 풍선도움말을 표시합니다.


마우스 포인터가 MultiCombo 영역내에 멈춰서 일정시간이 경과하면 풍선도움말이 사라집니다.

MultiCombo 영역 내에서 마우스 포인터를 이동한 후 멈추면 풍선도움말의 위치가 변경되거나 사라진 풍선도움말이 다시 표시됩니다.

"inplace"

MultiCombo 의 좌측상단 안쪽에 풍선도움말을 표시합니다.


마우스 포인터가 MultiCombo 영역내에 위치하고 일정시간이 경과하면 풍선도움말이 사라집니다.

"default,mouseleave"

마우스 포인터의 오른쪽 하단 위치에 풍선도움말을 표시합니다.


마우스 포인터가 MultiCombo 영역에 있으면 풍선도움말이 사라지지 않습니다.

"hover,mouseleave"

마우스 포인터의 오른쪽 하단 위치에 풍선도움말을 표시합니다.


마우스 포인터가 MultiCombo 영역에 있으면 풍선도움말이 사라지지 않습니다.

MultiCombo 영역 내에서 마우스 포인터를 이동한 후 멈추면 풍선도움말의 위치가 변경됩니다.

"inplace,mouseleave"

MultiCombo 의 좌측상단 안쪽에 풍선도움말을 표시합니다.


마우스 포인터가 MultiCombo 영역에 있으면 풍선도움말이 사라지지 않습니다.

참고

- tooltiptype 속성값을 설정하지 않으면 "default" 로 적용됩니다.

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

- 풍선도움말이 표시된 상태에서 tooltiptext 속성값을 변경하면 tooltiptype 속성값에 관계없이 풍선도움말이 사라집니다.

- 표시되었다가 사라진 풍선도움말은 마우스 포인터가 MultiCombo 영역을 나갔다가 들어오면 다시 표시됩니다.

- 마우스 포인터가 MultiCombo 영역에서 벗어나면 풍선도움말이 사라집니다.

- 풍선도움말의 크기는 풍선도움말에 표시되는 텍스트의 길이와 크기에 맞춰 자동으로 조정됩니다.

- 풍선도움말에 표시되는 텍스트의 글꼴과 크기는 변경하실 수 없습니다.

top

MultiCombo 을(를) 표시하기 위한 상단 좌표값을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.top[= nTop]

문법 설정

nTop ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']
this.MultiCombo00.top = 10; 
this.MultiCombo00.top = "10px"; 
this.MultiCombo00.top = "10%"; 
this.MultiCombo00.top = "Button00:10px"; 
this.MultiCombo00.top = "Button00:10%";

<strCompID>

MultiCombo 의 좌표값을 상대적으로 적용하기 위해 기준이 되는 컴포넌트의 ID 를 설정합니다.


기준 컴포넌트는 MultiCombo 와 부모(Parent)가 동일하여야 합니다.

또한, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.


값을 설정하지 않거나 잘못된 값을 설정하면 부모(Parent) 를 기준으로 좌표값이 적용됩니다.

<nVal>

MultiCombo의 상단 좌표값을 절대 길이 단위("px"), 비율 단위("%"), 상대 길이 단위("em", "rem")의 숫자로 설정합니다.


  • <strCompID> 값을 생략했을 때 :

- "px": 부모(Parent)의 top 속성값을 기준으로 MultiCombo의 상단 위치 설정

- "%": 부모(Parent)의 height 속성값을 기준으로 MultiCombo의 상단 위치 결정

- "em": 컴포넌트의 font-size 속성값을 기준으로 MultiCombo의 상단 위치 결정

- "rem": MainFrame font-size 속성값을 기준으로 MultiCombo의 상단 위치 결정


  • <strCompID> 값을 설정했을 때 :

- "px": <strCompID>의 bottom 속성값을 기준으로 MultiCombo의 상단 위치 결정

- "%": <strCompID>의 height 속성값을 기준으로 MultiCombo의 상단 위치 결정

<strCompID> 값 설정 시 "em", "rem" 단위는 지원하지 않습니다.

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 좌표값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

type

MultiCombo 컴포넌트가 동작하는 방법을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.type[= enumType]

문법 설정

enumType ::= 'dropdown' | 'search' | 'filter' | 'filterlike' | 'caseisearch' | 'caseifilter' | 'caseifilterlike'
this.MultiCombo00.type = "caseifilter";

"dropdown"

아이템 리스트에 전체 아이템이 모두 표시됩니다.


MultiCombo 컴포넌트의 편집창에 문자를 입력할 수 없습니다.

"search"

MultiCombo 컴포넌트의 편집창에 문자열 입력 시 검색기능이 활성화됩니다.


편집창에 입력된 문자열로 시작하는 첫 번째 아이템이 선택된 아이템 리스트가 표시됩니다.

편집창에 입력된 문자열로 시작하는 아이템이 없을 경우 아이템 리스트가 표시되지 않습니다.


아이템 리스트에는 전체 아이템이 모두 표시됩니다.

아이템 검색 시 대소문자를 구별합니다.

"filter"

MultiCombo 컴포넌트의 편집창에 문자열 입력 시 필터기능이 활성화됩니다.


편집창에 입력된 문자열로 시작하는 아이템만 있는 아이템 리스트가 표시됩니다.

편집창에 입력된 문자열로 시작하는 아이템이 없을 경우 아이템 리스트가 표시되지 않습니다.


문자를 추가로 입력하면 아이템 리스트가 자동으로 갱신됩니다.

아이템 필터 시 대소문자를 구별합니다.

"filterlike"

MultiCombo 컴포넌트의 편집창에 문자열 입력 시 필터기능이 활성화됩니다.


편집창에 입력된 문자열이 포함된 아이템만 있는 아이템 리스트가 표시됩니다.

편집창에 입력된 문자열이 포함된 아이템이 없을 경우 아이템 리스트가 표시되지 않습니다.


문자를 추가로 입력하면 아이템 리스트가 자동으로 갱신됩니다.

아이템 필터 시 대소문자를 구별합니다.

"caseisearch"

MultiCombo 컴포넌트의 편집창에 문자열 입력 시 검색기능이 활성화됩니다.


"search" 값과 동일하게 동작하며 아이템 검색 시 대소문자를 구별하지 않습니다.

"caseifilter"

MultiCombo 컴포넌트의 편집창에 문자열 입력 시 필터기능이 활성화됩니다.


"filter" 값과 동일하게 동작하며 아이템 필터 시 대소문자를 구별하지 않습니다.

"caseifilterlike"

MultiCombo 컴포넌트의 편집창에 문자열 입력 시 필터기능이 활성화됩니다.


"filterlike" 값과 동일하게 동작하며 아이템 필터 시 대소문자를 구별하지 않습니다.

참고

- type 속성값을 설정하지 않으면 "dropdown"으로 적용됩니다.

- type 속성값에 관계없이 MultiCombo 컴포넌트의 드롭버튼(DropButton) 클릭 시 전체 아이템이 있는 아이템 리스트가 표시됩니다.

- type 속성을 "dropdown" 이외의 값으로 설정하면 검색/필터 기능이 활성화됩니다.
  검색/필터 기능은 사용자의 입력을 돕기 위한 기능으로 아이템 후보값을 편집 영역과 리스트 창을 통해 표시합니다.

- 아이템 리스트에서 마우스나 키보드에 의해 아이템을 선택하면 입력이 종료된 것으로 처리합니다.

- readonly 속성값이 true 이면 아이템 리스트가 표시되지 않습니다.

◆ iOS/iPad NRE/WRE 제약

- 일본어 입력 시 확정되지 않은 상태에서는 필터 또는 검색 기능이 활성화되지 않으며 확정 시점에 활성화됩니다.

usecontextmenu

MultiCombo 의 편집영역에서 오른쪽 마우스 클릭 시 기본팝업메뉴의 표시 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.usecontextmenu[= bUseContextMenu]

문법 설정

bUseContextMenu ::= 'true' | 'false'
this.MultiCombo00.usecontextmenu = true;

true

편집영역에서 오른쪽 마우스 클릭 시 기본팝업메뉴가 표시됩니다.

false

편집영역에서 오른쪽 마우스 클릭 시 기본팝업메뉴가 표시되지 않습니다.

참고

- usecontextmenu 속성값을 설정하지 않으면 true 로 적용됩니다.

- Environment 의 usecontextmenu 속성값이 "none" 또는 "form" 인 경우 MultiCombo 의 usecontextmenu 속성은 false 로 동작합니다.

- 기본팝업메뉴란 마우스 오른쪽 버튼 클릭하거나 터치를 일정시간 유지할 때 시스템에 의해 표시되는 자동 메뉴를 의미합니다.

- 기본팝업메뉴는 oncontextmenu 이벤트가 발생한 후에 표시됩니다.

- 기본팝업메뉴를 일시적으로 표시하지 않으려면 oncontextmenu 이벤트에서 preventDefault() 를 실행하여 Default Action 을 취소하거나
   환경에 따라 onrbuttondown, onrbuttonup 이벤트에서 preventDefault() 를 실행하여 oncontextmenu 이벤트 발생을 취소할 수 있습니다.

- 일반적으로 onrbuttondown -> onrbuttonup -> oncontextmenu 순서로 이벤트가 발생하지만
   예외적으로 아래 환경은 onrbuttondown -> oncontextmenu -> onrbuttonup 순서로 이벤트가 발생합니다.
   : Safari 브라우저, macOS 환경의 전체 웹브라우저, Mobile 전체환경


◆ iOS 제약

- iOS 는 기본팝업메뉴를 제어할 수 없는 제약으로 지원하지 않습니다.

usesoftkeyboard

MultiCombo 가 포커스를 가질 때 키패드의 표시 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☐ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.usesoftkeyboard[= bUseKeyboard]

문법 설정

bUseKeyboard ::= true | false
this.MultiCombo00.usesoftkeyboard = false;

true

MultiCombo 가 포커스를 가질 때 키패드가 자동으로 표시됩니다.

false

MultiCombo 가 포커스를 가질 때 키패드가 표시되지 않습니다.

참고

- usesoftkeyboard 속성값을 설정하지 않으면 true로 적용됩니다.

- type 속성값이 "dropdown" 일 때는 속성값에 관계없이 키패드가 항상 표시되지 않습니다.


◆ Windows NRE 제약

- Windows NRE는 OS 가 Windows 10 이상이고, 연결된 키보드가 없을 때만 적용됩니다.

value

MultiCombo 컴포넌트에서 선택된 아이템의 코드값을 갖는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.value[= strValue]

문법 설정

this.MultiCombo00.value  = "00,01,02";

strValue

아이템 리스트 중에서 선택할 아이템의 코드값을 1개 이상 구분자를 사용해 설정합니다.

구분자는 Environment 오브젝트의 multivalueseparator 속성값을 적용합니다.

참고

- value 속성값을 설정하지 않으면 undefined로 적용됩니다.

- MultiCombo 컴포넌트에서 선택된 아이템의 코드값이 value 속성값으로 설정됩니다.

- MultiCombo 컴포넌트에 Dataset 오브젝트를 바인딩하면 기본적으로 연동되는 속성입니다.

- index 또는 text 속성값 변경에 의해 선택된 아이템이 변경될 경우 value 속성값도 해당 아이템에 맞게 변경됩니다.

visible

MultiCombo 이(가) 화면에 표시될지 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.visible[= bVisible]

문법 설정

bVisible ::= 'true' | 'false'
this.MultiCombo00.visible = true; 
this.MultiCombo00.visible = false;

"true"

MultiCombo 을(를) 화면에 표시합니다.

"false"

MultiCombo 을(를) 화면에 표시하지 않습니다.

참고

- visible 속성값을 변경하는 즉시 컴포넌트의 표시 여부가 화면에 반영됩니다.

- visible 속성값이 "false"이면 컴포넌트가 화면에 표시되지 않고, 포커스를 받을 수 없으므로 입력이나 사용이 불가능합니다.

- Div 와 같은 컨테이너 컴포넌트의 visible 속성값을 "false"로 설정하면 자식 컴포넌트도 함께 화면에 표시되지 않습니다.

- visible 속성값이 "false"이어도 컴포넌트는 존재하기 때문에 스크립트로 제어가 가능합니다.

- 넥사크로 스튜디오에서는 visible 속성값을 'false'로 설정해도 디자인화면에서 사라지지 않습니다.

width

MultiCombo 을(를) 표시하기 위한 너비를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.width[= nWidth]

문법 설정

nWidth ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']
this.MultiCombo00.width = 10; this.MultiCombo00.width = "10px"; 
this.MultiCombo00.width = "10%"; 
this.MultiCombo00.width = "Button00:10%";

<strCompID>

MultiCombo 의 너비를 상대적으로 적용하기 위해 기준이 되는 컴포넌트의 ID 를 설정합니다.


기준 컴포넌트는 MultiCombo 와 부모(Parent)가 동일하여야 합니다.

또한, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.


값을 설정하지 않거나 잘못된 값을 설정하면 부모(Parent) 를 기준으로 너비가 적용됩니다.

<nVal>

MultiCombo 의 너비를 절대 길이 단위("px"), 비율 단위("%"), 상대 길이 단위("em", "rem")의 숫자로 설정합니다.


  • <strCompID> 값을 생략했을 때 :

- "px": MultiCombo의 너비 설정

- "%": 부모(Parent)의 width 속성값을 기준으로 MultiCombo의 너비 결정

- "em": 컴포넌트의 font-size 속성값을 기준으로 MultiCombo의 너비 결정

- "rem": MainFrame font-size 속성값을 기준으로 MultiCombo의 너비 결정


  • <strCompID> 값을 설정했을 때 :

- "px": <strCompID> 값은 무시되고 설정값이 MultiCombo의 너비 결정

- "%": <strCompID>의 width 속성값을 기준으로 MultiCombo의 너비 결정

<strCompID> 값 설정 시 "em", "rem" 단위는 지원하지 않습니다.

참고

- 너비값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 너비값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

word-spacing

MultiCombo 에 표시되는 텍스트의 단어 사이 간격을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

MultiCombo.wordSpacing[= strwordspacing]

문법 설정

strWordSpacing ::= 'normal' | <nVal>'px'
* XCSS
word-spacing : 30px;

* Script ( normal property )
this.MultiCombo00.wordSpacing = "30px";

"normal"

텍스트의 단어 사이 간격을 설정하지 않습니다.


현재 font 에 맞는 기본형태로 텍스트가 표시됩니다.

<nVal>

pixel 단위로 텍스트의 단어 사이 간격을 설정합니다.

참고

- word-spacing 속성값을 설정하지 않으면 undefined 가 설정되고, "normal" 로 동작합니다.

- 스크립트로 접근 시 속성명은 "wordSpacing"을 사용해야 합니다.

메서드

addEvent

MultiCombo 에 특정 이벤트를 선언하여 추가하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.addEvent( strEventID )

파라미터

Parameters

Type

Description

strEventID

String

MultiCombo 에 추가할 이벤트의 ID 를 문자열로 설정합니다.

var bResult = this.MultiCombo00.addEvent( "onmove" );

반환

Type

Description

Boolean

이벤트 추가에 성공하면 true 를 반환합니다.


이벤트 추가에 실패하거나 선언되어 있는 이벤트 ID 설정 시 false 를 반환합니다.

참고

- Composite Component 와 같은 사용자 컴포넌트에 특정 이벤트를 추가할 때 사용하는 메소드입니다.

- MultiCombo 에서 특정 이벤트를 제거하려면 removeEvent() 메소드를 사용하여야 합니다.

addEventHandler

MultiCombo 의 특정 이벤트에 핸들러 함수를 추가하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.addEventHandler( strEventID, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수가 추가될 이벤트의 ID를 설정합니다.

objFunc

Object

이벤트 발생 시 수행될 핸들러 함수를 설정합니다.

objTarget

Object

핸들러 함수가 정의된 영역을 설정합니다.

this.MultiCombo00_onmove = function( obj:nexacro.MultiCombo,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MultiCombo00.addEventHandler( "onmove", this.MultiCombo00_onmove, this);

반환

Type

Description

Number

이벤트에 추가된 핸들러 함수의 인덱스를 반환합니다.

동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다.

정상적으로 추가되지 않은 경우에는 -1 을 반환합니다.

addEventHandlerLookup

함수를 검색하여 MultiCombo 의 특정 이벤트에 핸들러 함수로 추가하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수가 추가될 이벤트의 ID를 설정합니다.

strFunc

String

이벤트 발생 시 수행될 핸들러 함수의 이름을 문자열로 설정합니다.

objTarget

Object

핸들러 함수를 검색할 영역을 설정합니다.

해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다.

this.MultiCombo00_onmove = function( obj:nexacro.MultiCombo,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MultiCombo00.addEventHandlerLookup( "onmove", "MultiCombo00_onmove", this);

반환

Type

Description

Number

이벤트에 추가된 핸들러 함수의 인덱스를 반환합니다.

동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다.

정상적으로 추가되지 않은 경우에는 "-1"을 반환합니다.

참고

- strFunc 이름의 함수를 objTarget 영역부터 상위로 올라가며 검색합니다.
  검색된 함수가 있다면 이벤트에 핸들러 함수로 추가합니다.

bringToFront

부모가 동일한 컴포넌트 중 MultiCombo 이(가) 화면의 제일 앞에 표시되게 합니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.bringToFront()

파라미터

this.MultiCombo.bringToFront();

참고

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- bringToFront() 메소드는 MultiCombo 을(를) 가장 나중에 표시되게 순서를 바꿉니다.
  따라서 화면에 표시될때는 제일 앞에 표시되게 됩니다.

bringToPrev

부모가 동일한 컴포넌트 중 MultiCombo 이(가) 화면에 한단계 앞에 표시되게 합니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.bringToPrev()

파라미터

this.MultiCombo.bringToPrev();

참고

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- bringToPrev() 메소드는 MultiCombo 을(를) 한단계 나중에 표시되는 컴포넌트와 순서를 바꿉니다.
  따라서 화면에 표시될때는 원래 순서보다 한단계 앞에 표시되게 됩니다.

clearEventHandler

특정 이벤트에 등록된 핸들러 함수를 모두 제거하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.clearEventHandler( strEventID )

파라미터

Parameters

Type

Description

strEventID

String

모든 핸들러 함수를 제거할 이벤트의 ID를 설정합니다.

var nCnt = this.MultiCombo00.clearEventHandler( "onmove" );

반환

Type

Description

Number

특정 이벤트에서 제거된 핸들러 함수의 갯수를 반환합니다.

참고

- 특정 핸들러 함수만 제거하려면 removeEventHandler() 메소드를 사용하여야 합니다.

clearSelect

MultiCombo 컴포넌트에서 선택된 아이템의 선택상태를 모두 해제하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.clearSelect()

파라미터

this.MultiCombo00.clearSelect() ;

destroy

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.destroy()

파라미터

var bSucc = this.MultiCombo00.destroy();

반환

Type

Description

Boolean

MultiCombo 이(가) 정상적으로 삭제되면 true 를 반환합니다.


MultiCombo 이(가) 정상적으로 삭제되지 않으면 false 를 반환합니다.

참고

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

dropdown

MultiCombo 컴포넌트의 아이템 리스트를 화면에 표시하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.dropdown()

파라미터

this.MultiCombo00.dropdown();

참고

- MultiCombo 컴포넌트의 visible 속성값이 false 이거나 enable 속성값이 false 이면 메서드가 동작하지 않습니다.

- 화면에 아이템 리스트가 표시되어 있다면 메서드가 동작하지 않습니다.

- type 속성값이 "search" 또는 "filter" 일 때 검색 기능이 활성화된 상태에서 dropdown() 메서드를 실행하면
  자동으로 표시되어 있던 검색된 아이템 리스트가 닫히고, 전체 아이템이 있는 리스트가 화면에 표시됩니다.


◆ Mobile 제약

- Android 에서 입력패드가 표시되어 있을 때는 dropdown() 메서드가 곧바로 적용되지 않습니다.

findEventHandler

MultiCombo 의 특정 이벤트에서 핸들러 함수를 찾아 인덱스를 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.findEventHandler( strEventID, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 찾을 이벤트의 ID를 설정합니다.

objFunc

Object

찾으려고 하는 핸들러 함수를 설정합니다.

objTarget

Object

찾으려고 하는 핸들러 함수가 정의된 영역을 설정합니다.

this.MultiCombo00_onmove = function( obj:nexacro.MultiCombo,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };

var nIndex = this.MultiCombo00.findEventHandler( "onmove", this.MultiCombo00_onmove, this );

반환

Type

Description

Number

특정 이벤트에서 찾은 핸들러 함수의 인덱스를 반환합니다.


특정 이벤트에 찾으려는 핸들러 함수가 존재하지 않으면 -1 을 반환합니다.

참고

- 핸들러 함수의 인덱스는 0 부터 시작합니다.

getCaretPos

MultiCombo 컴포넌트의 편집영역에서 캐럿이 위치한 인덱스를 반환하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getCaretPos()

파라미터

var nCaretpos = this.MultiCombo00.getCaretPos();

반환

Type

Description

Number

캐럿이 위치한 인덱스를 반환합니다.

읽기 전용 상태이거나 MultiCombo 컴포넌트에 포커스가 없으면 "-1"을 반환합니다.


첫 번째 위치의 인덱스는 0입니다.

참고

- type 속성값이 "search" 또는 "filter"이고 편집영역에 캐럿이 표시되고 있어야 합니다.

getCount

MultiCombo 컴포넌트에 표시되는 전체 아이템의 개수를 반환하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getCount()

파라미터

var nCount = this.MultiCombo00.getCount();

반환

Type

Description

Number

MultiCombo 컴포넌트에 표시되는 전체 아이템의 개수를 반환합니다.

참고

- innerdataset 속성에 설정된 Dataset 오브젝트가 필터링되어 있다면 필터링된 결과만 아이템 개수에 포함됩니다.

getEventHandler

MultiCombo 의 특정 이벤트에서 지정된 인덱스에 해당하는 핸들러 함수를 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getEventHandler( strEventID, nIdx )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 얻을 이벤트의 ID를 설정합니다.

nIdx

Number

얻으려고 하는 핸들러 함수의 인덱스를 설정합니다.


핸들러 함수의 인덱스는 0 부터 시작합니다.

var objFunc = MultiCombo00.getEventHandler( "onmove", 0 );

반환

Type

Description

Object

지정된 인덱스의 핸들러 함수 오브젝트를 반환합니다.


지정된 인덱스에 핸들러 함수가 존재하지 않는다면 null 을 반환합니다.

getInnerDataset

MultiCombo 컴포넌트의 innerdataset 속성에 설정되어 있는 Dataset 오브젝트를 반환하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getInnerDataset()

파라미터

var objDataset = this.MultiCombo00.getInnerDataset();

반환

Type

Description

Object

innerdataset 속성에 설정되어 있는 Dataset 오브젝트를 반환합니다.

getOffsetBottom

부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 bottom 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getOffsetBottom();

파라미터

var nBottom = this.MultiCombo.getOffsetBottom();

반환

Type

Description

Number

부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 bottom 값을 픽셀단위의 숫자로 반환합니다.

참고

- 화면에 표시된 부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 bottom 값을 동적으로 계산합니다.

getOffsetHeight

MultiCombo 의 높이를 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getOffsetHeight();

파라미터

var nHeight = this.MultiCombo.getOffsetHeight();

반환

Type

Description

Number

MultiCombo 의 높이를 픽셀단위의 숫자로 변환하여 반환합니다.

참고

- 화면에 표시된 MultiCombo 의 높이를 동적으로 계산합니다.

활용 예제

getOffsetLeft

부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 left 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getOffsetLeft();

파라미터

var nleft = this.MultiCombo.getOffsetLeft();

반환

Type

Description

Number

부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 left 값을 픽셀단위의 숫자로 반환합니다.

참고

- 화면에 표시된 부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 left 값을 동적으로 계산합니다.

getOffsetRight

부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 right 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getOffsetRight();

파라미터

var nRight = this.MultiCombo.getOffsetRight();

반환

Type

Description

Number

부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 right 값을 픽셀단위의 숫자로 반환합니다.

참고

- 화면에 표시된 부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 right 값을 동적으로 계산합니다.

getOffsetTop

부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 top 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getOffsetTop();

파라미터

var nTop = this.MultiCombo.getOffsetTop();

반환

Type

Description

Number

부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 top 값을 픽셀단위의 숫자로 반환합니다.

참고

- 화면에 표시된 부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 top 값을 동적으로 계산합니다.

getOffsetWidth

MultiCombo 의 너비를 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getOffsetWidth();

파라미터

var nWidth = this.MultiCombo.getOffsetWidth();

반환

Type

Description

Number

MultiCombo 의 너비를 픽셀단위의 숫자로 변환하여 반환합니다.

참고

- 화면에 표시된 MultiCombo 의 너비를 동적으로 계산합니다.

활용 예제

getPixelBottom

MultiCombo 의 bottom 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getPixelBottom();

파라미터

var nbottom = this.MultiCombo.getPixelBottom();

반환

Type

Description

Number

MultiCombo 의 bottom 속성값을 픽셀단위로 반환합니다.


bottom 속성값을 설정하지 않았을 경우 null 을 반환합니다.

참고

- bottom 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelHeight

MultiCombo 의 height 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getPixelHeight();

파라미터

var nheight = this.MultiCombo.getPixelHeight();

반환

Type

Description

Number

MultiCombo 의 height 속성값을 픽셀단위로 반환합니다.


height 속성값을 설정하지 않았을 경우 null 을 반환합니다.

참고

- height 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelLeft

MultiCombo 의 left 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getPixelLeft();

파라미터

var nleft = this.MultiCombo.getPixelLeft();

반환

Type

Description

Number

MultiCombo 의 left 속성값을 픽셀단위로 반환합니다.


left 속성값을 설정하지 않았을 경우 null 을 반환합니다.

참고

- left 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelRight

MultiCombo 의 right 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getPixelRight();

파라미터

var nright = this.MultiCombo.getPixelRight();

반환

Type

Description

Number

MultiCombo 의 right 속성값을 픽셀단위로 반환합니다.


right 속성값을 설정하지 않았을 경우 null 을 반환합니다.

참고

- right 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelTop

MultiCombo 의 top 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getPixelTop();

파라미터

var ntop = this.MultiCombo.getPixelTop();

반환

Type

Description

Number

MultiCombo 의 top 속성값을 픽셀단위로 반환합니다.


top 속성값을 설정하지 않았을 경우 null 을 반환합니다.

참고

- top 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelWidth

MultiCombo 의 width 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getPixelWidth();

파라미터

var nwidth = this.MultiCombo.getPixelWidth();

반환

Type

Description

Number

MultiCombo 의 width 속성값을 픽셀단위로 반환합니다.


width 속성값을 설정하지 않았을 경우 null 을 반환합니다.

참고

- width 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getSelect

MultiCombo 컴포넌트에서 인수로 전달된 인덱스의 아이템이 선택상태인지 반환하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getSelect( nIndex );

파라미터

Parameters

Type

Description

nIndex

Number

선택상태를 확인하려는 아이템의 인덱스를 숫자로 설정합니다.

인덱스는 0부터 시작합니다.

var bSelect = this.MultiCombo00.getSelect( 0 );

반환

Type

Description

Boolean

nIndex에 해당하는 아이템이 선택된 상태이면 true를 반환합니다.

nIndex에 해당하는 아이템이 선택된 상태가 아니면 false를 반환합니다.

잘못된 nIndex 값을 설정하면 -1을 반환합니다.

getSelectedCount

MultiCombo 컴포넌트의 아이템 중 선택상태인 아이템의 개수를 반환하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getSelectedCount();

파라미터

var nCount = this.MultiCombo00.getSelectedCount();

반환

Type

Description

Number

선택상태인 아이템의 전체 개수를 반환합니다.

getSelectedItems

MultiCombo 컴포넌트의 아이템 중 선택상태인 아이템의 인덱스를 배열로 반환하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getSelectedItems();

파라미터

var arrIdx = this.MultiCombo00.getSelectedItems();

반환

Type

Description

Array

선택상태인 아이템의 인덱스를 배열로 반환합니다.

getSelectedText

MultiCombo 컴포넌트의 텍스트 편집 영역에서 선택한 텍스트를 반환하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.getSelectedText()

파라미터

var strText = this.MultiCombo00.getSelectedText();

반환

Type

Description

String

- 편집영역에서 선택한 텍스트를 반환합니다.

- 선택된 텍스트가 없을 경우 빈값을 반환합니다.

- 텍스트 편집 영역의 상태를 확인할 수 없는 경우 빈값을 반환합니다.

참고

- MultiCombo 컴포넌트의 텍스트 편집 영역에 포커스가 있고 캐럿이 표시된 상태에서만 정상적으로 값을 반환합니다.

- 화면에 표시되고 선택할 수 있는 문자(예: 마스크 문자, 공백 문자, 숫자 기호)를 포함합니다.
  
- 컴포넌트의 속성에 따라 선택한 텍스트 영역을 처리할 수 없는 경우 메서드 실행 시 빈값을 반환합니다.
  - 텍스트 편집 영역이 비활성화된 경우
    Calendar 컴포넌트의 type 속성값이 "monthonly"인 경우
    Calendar 컴포넌트의 popuptype 속성값이 "normal" 또는 "system"이고 모바일 환경에서 실행한 경우
    Spin 컴포넌트의 type 속성값이 "spinonly"인 경우
  - 웹 표준 스펙에서 지원하지 않는 경우
    WRE 환경에서 TextField 컴포넌트의 inputtype 속성값이 "email" 또는 "number"인 경우

init

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.init( strName, vLeft, vTop , vWidth, vHeight [, vRight, vBottom, [vMinWidth, [vMaxWidth, [vMinHeight, [vMaxHeight]]]]] )

파라미터

Parameters

Type

Description

strName

String

MultiCombo 의 ID를 문자열로 설정합니다.

vLeft

String, Number

MultiCombo 의 left 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 right 속성값을 기준으로 MultiCombo 의 left 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 left 가 결정됩니다.

vTop

String, Number

MultiCombo 의 top 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 bottom 속성값을 기준으로 MultiCombo 의 top 이 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 top 이 결정됩니다.

vWidth

String, Number

MultiCombo 의 width 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트값은 무시되고 pixel 값으로 MultiCombo 의 width 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 width 가 결정됩니다.

vHeight

String, Number

MultiCombo 의 height 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트값은 무시되고 pixel 값으로 MultiCombo 의 height 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 height 가 결정됩니다.

vRight

String, Number

MultiCombo 의 right 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


vLeft, vWidth 값을 모두 설정했을 경우 vRight 값은 무시됩니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 left 속성값을 기준으로 MultiCombo 의 right 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 right 가 결정됩니다.

vBottom

String, Number

MultiCombo 의 bottom 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


vTop, vHeight 값을 모두 설정했을 경우 vBottom 값은 무시됩니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 top 속성값을 기준으로 MultiCombo 의 bottom 이 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 bottom 이 결정됩니다.

vMinWidth

String, Number

MultiCombo 이(가) 화면에 표시되는 최소 너비값을 pixel 단위의 숫자로 설정합니다.

vMaxWidth

String, Number

MultiCombo 이(가) 화면에 표시되는 최대 너비값을 pixel 단위의 숫자로 설정합니다.


vMinWidth 보다 작은 값을 설정하면 vMinWidth 값으로 설정됩니다.

vMinHeight

String, Number

MultiCombo 이(가) 화면에 표시되는 최소 높이값을 pixel 단위의 숫자로 설정합니다.

vMaxHeight

String, Number

MultiCombo 이(가) 화면에 표시되는 최대 높이값을 pixel 단위의 숫자로 설정합니다.


vMinHeight 보다 작은 값을 설정하면 vMinHeight 값으로 설정됩니다.

var objComp = new MultiCombo();

objComp.init( "MultiCombo00", 30, 120, 196, 46 );
objComp.init( "MultiCombo00", 30, 120, 196, 46, null, null );
objComp.init( "MultiCombo00", null, null, 300, "400px", "80%", 300 );
objComp.init( "MultiCombo00", 0, 0, 200, 100, null, null, 300, 500, 200, 500 );
objComp.init( "MultiCombo00", "MultiCombo22:10", 300, null, null, "MultiCombo33:10", "20%", 300, 500, 200, 500 );

참고

- 인수값에 기준 컴포넌트를 포함하면 MultiCombo 의 위치는 기준 컴포넌트를 기준으로 상대적으로 결정됩니다.
  vLeft, vTop, vWidth, vHeight, vRight, vBottom 값에 기준 컴포넌트를 포함할 때는 "ID:Value" 형태로 설정하여야 합니다.

- 기준 컴포넌트는 MultiCombo 와(과) 부모(Parent)가 동일하여야 하며, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.
  기준 컴포넌트를 설정하지 않거나 잘못된 값을 설정하면 부모(Parent)를 기준으로 좌표값이 적용됩니다.

- 인수값에 기준 컴포넌트 또는 단위를 포함할 경우 문자열로 설정하여야 합니다.

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

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

- 동적으로 생성한 컴포넌트를 컨테이너 컴포넌트에 추가하기 위해서는 addChild() 메소드나 insertChild() 메소드를 사용하여야 합니다.

insertEventHandler

MultiCombo 의 특정 이벤트에 핸들러 함수를 지정한 위치에 삽입하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.insertEventHandler( strEventID, nIndex, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수가 삽입될 이벤트의 ID 를 설정합니다.

nIndex

Number

핸들러 함수가 삽입될 위치를 인덱스로 설정합니다.


-1 값 설정 시 마지막에 추가됩니다.

이벤트에 설정된 핸들러 함수의 갯수보다 큰 값을 설정한 경우 마지막에 추가됩니다.

NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 설정됩니다.

objFunc

Object

이벤트 발생 시 수행될 핸들러 함수를 설정합니다.

objTarget

Object

핸들러 함수가 정의된 영역을 설정합니다.

this.MultiCombo00_onmove = function( obj:nexacro.MultiCombo,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };

var nIndex = this.MultiCombo00.insertEventHandler( "onmove", 0, this.MultiCombo00_onmove, this);

반환

Type

Description

Number

이벤트에 삽입된 핸들러 함수의 인덱스를 반환합니다.

동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다.


핸들러 함수가 정상적으로 삽입되지 않은 경우에는 -1 을 반환합니다.

참고

- 첫번째 핸들러 함수의 인덱스는 0 입니다.

isDropdown

MultiCombo 컴포넌트의 아이템 리스트가 화면에 표시되어 있는지 여부를 반환하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.isDropdown()

파라미터

var bVal = this.MultiCombo00.isDropdown();

반환

Type

Description

Boolean

화면에 아이템 리스트가 표시되어 있으면 true를 반환합니다.

화면에 아이템 리스트가 표시되어 있지 않으면 false를 반환합니다.

참고

- MultiCombo 컴포넌트의 검색기능에 의해 자동으로 아이템 리스트가 표시되어도 true를 반환합니다.

move

MultiCombo 의 위치와 크기를 변경하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.move( vLeft, vTop [, vWidth, vHeight [, vRight, vBottom]] )

파라미터

Parameters

Type

Description

vLeft

String, Number

MultiCombo 의 left 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 right 속성값을 기준으로 MultiCombo 의 left 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 left 가 결정됩니다.

vTop

String, Number

MultiCombo 의 top 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 bottom 속성값을 기준으로 MultiCombo 의 top 이 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 top 이 결정됩니다.

vWidth

String, Number

MultiCombo 의 width 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트값은 무시되고 pixel 값으로 MultiCombo 의 width 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 width 가 결정됩니다.

vHeight

String, Number

MultiCombo 의 height 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트값은 무시되고 pixel 값으로 MultiCombo 의 height 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 height 가 결정됩니다.

vRight

String, Number

MultiCombo 의 right 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


vLeft, vWidth 값을 모두 설정했을 경우 vRight 값은 무시됩니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 left 속성값을 기준으로 MultiCombo 의 right 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 right 가 결정됩니다.

vBottom

String, Number

MultiCombo 의 bottom 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.


vTop, vHeight 값을 모두 설정했을 경우 vBottom 값은 무시됩니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트의 top 속성값을 기준으로 MultiCombo 의 bottom 이 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 bottom 이 결정됩니다.

this.MultiCombo00.move(10,10);
this.MultiCombo00.move(10,10,100,100);
this.MultiCombo00.move(null, null, 300, "400px", "80%", 300 );

참고

- 인수값에 기준 컴포넌트를 포함하면 MultiCombo 의 위치는 기준 컴포넌트를 기준으로 상대적으로 결정됩니다.
  vLeft, vTop, vWidth, vHeight, vRight, vBottom 값에 기준 컴포넌트를 포함할 때는 "ID:Value" 형태로 설정하여야 합니다.

- 기준 컴포넌트는 MultiCombo 와(과) 부모(Parent)가 동일하여야 하며, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.
  기준 컴포넌트를 설정하지 않거나 잘못된 값을 설정하면 부모(Parent)를 기준으로 좌표값이 적용됩니다.

- 인수값에 기준 컴포넌트 또는 단위를 포함할 경우 문자열로 설정하여야 합니다.

moveToNext

부모가 동일한 컴포넌트 중 인수로 전달된 컴포넌트보다 MultiCombo 이(가) 화면에 한단계 뒤에 표시되게 합니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.moveToNext( objComp )
MultiCombo.moveToNext( strComp )

파라미터

Parameters

Type

Description

objComp

Object

기준이 되는 컴포넌트를 오브젝트로 설정합니다.

strComp

String

기준이 되는 컴포넌트의 ID를 문자열로 설정합니다.

this.MultiCombo.moveToNext( this.Button00 );
this.MultiCombo.moveToNext( "Button00" );

참고

- 인수로 전달되는 기준 컴포넌트와 MultiCombo 은(는) 부모가 동일하여야 합니다.

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- moveToNext() 메소드는 기준 컴포넌트보다 MultiCombo 이(가) 한단계 먼저 표시되게 순서를 바꿉니다.
  따라서 화면에 표시될때는 기준 컴포넌트보다 한단계 뒤에 표시되게 됩니다.

moveToPrev

부모가 동일한 컴포넌트 중 인수로 전달된 컴포넌트보다 MultiCombo 이(가) 화면에 한단계 앞에 표시되게 합니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.moveToPrev( objComp )
MultiCombo.moveToPrev( strComp )

파라미터

Parameters

Type

Description

objComp

Object

기준이 되는 컴포넌트를 오브젝트로 설정합니다.

strComp

String

기준이 되는 컴포넌트의 ID를 문자열로 설정합니다.

this.MultiCombo.moveToPrev( this.Button00 );
this.MultiCombo.moveToPrev( "Button00" );

참고

- 인수로 전달되는 기준 컴포넌트와 MultiCombo 은(는) 부모가 동일하여야 합니다.

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- moveToPrev() 메소드는 기준 컴포넌트보다 MultiCombo 이(가) 한단계 나중에 표시되게 순서를 바꿉니다.
  따라서 화면에 표시될때는 기준 컴포넌트보다 한단계 앞에 표시되게 됩니다.

removeEvent

MultiCombo 에 선언된 특정 이벤트를 삭제하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.removeEvent( strEventID )

파라미터

Parameters

Type

Description

strEventID

String

MultiCombo 에서 삭제할 이벤트의 ID 를 문자열로 설정합니다.

var bResult = this.MultiCombo00.removeEvent( "onmove" );

반환

Type

Description

Boolean

이벤트 삭제에 성공하면 true 를 반환합니다.


이벤트 삭제에 실패하거나 선언되지 않은 이벤트 ID 설정 시 false 를 반환합니다.

참고

- Composite Component 와 같은 사용자 컴포넌트에서 특정 이벤트를 삭제할 때 사용하는 메소드입니다.

- 이벤트에 핸들러 함수가 정의되어 있을 경우 이벤트를 삭제할 수 없습니다.

- MultiCombo 에 특정 이벤트를 추가하려면 addEvent() 메소드를 사용하여야 합니다.

- MultiCombo 에 기본으로 선언되어 있는 이벤트 삭제 시 오동작 할 수 있으므로 주의하여야 합니다.

removeEventHandler

MultiCombo 의 특정 이벤트에서 핸들러 함수를 제거하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.removeEventHandler( strEventID, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 제거할 이벤트의 ID를 설정합니다.

objFunc

Object

제거할 핸들러 함수를 설정합니다.

objTarget

Object

제거할 핸들러 함수가 정의된 영역을 설정합니다.

this.MultiCombo00_onmove = function( obj:nexacro.MultiCombo,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MultiCombo00.removeEventHandler( "onmove", this.MultiCombo00_onmove, this);

반환

Type

Description

Number

핸들러 함수 제거에 성공하면 1 을 반환합니다.


핸들러 함수 제거에 실패하면 0 을 반환합니다.

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

removeEventHandlerLookup

MultiCombo 의 특정 이벤트에서 검색된 함수와 동일한 핸들러 함수를 제거하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.removeEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 제거할 이벤트의 ID를 설정합니다.

strFunc

String

제거할 핸들러 함수의 이름을 문자열로 설정합니다.

objTarget

Object

제거할 핸들러 함수가 정의된 영역을 설정합니다.

해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다.

this.MultiCombo00_onmove = function( obj:nexacro.MultiCombo,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MultiCombo00.removeEventHandlerLookup( "onmove", "MultiCombo00_onmove", this);

반환

Type

Description

Number

핸들러 함수 제거에 성공하면 1 을 반환합니다.


핸들러 함수 제거에 실패하면 0 을 반환합니다.

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

resize

MultiCombo 의 크기를 변경하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.resize( vWidth, vHeight )

파라미터

Parameters

Type

Description

vWidth

String, Number

MultiCombo 의 width 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.

음수값을 설정할 수 없습니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트값은 무시되고 pixel 값으로 MultiCombo 의 width 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 width 속성값을 기준으로 MultiCombo 의 width 가 결정됩니다.

vHeight

String, Number

MultiCombo 의 height 속성값을 pixel 또는 비율("%") 단위의 숫자로 설정합니다.

음수값을 설정할 수 없습니다.


  • 값에 기준 컴포넌트를 포함하여 설정했을 때 :

pixel 단위로 설정 시 기준 컴포넌트값은 무시되고 pixel 값으로 MultiCombo 의 height 가 결정됩니다.

비율("%") 단위로 설정 시 기준 컴포넌트의 height 속성값을 기준으로 MultiCombo 의 height 가 결정됩니다.

this.MultiCombo00.resize( 100,100 );

참고

- MultiCombo 의 left 속성값이 null 이 아니면 resize() 메소드 실행 후 MultiCombo 의 우측 위치가 변경됩니다.
  또한, 메소드 실행 후 right 속성값은 null 이 됩니다.

- MultiCombo 의 left 속성값이 null 이면 resize() 메소드 실행 후 MultiCombo 의 좌측 위치가 변경됩니다.
  또한, 메소드 실행 후 left 속성값은 null 로 유지됩니다.

- MultiCombo 의 top 속성값이 null 이 아니면 resize() 메소드 실행 후 MultiCombo 의 하단 위치가 변경됩니다.
  또한, 메소드 실행 후 bottom 속성값은 null 이 됩니다.

- MultiCombo 의 top 속성값이 null 이면 resize() 메소드 실행 후 MultiCombo 의 상단 위치가 변경됩니다.
  또한, 메소드 실행 후 top 속성값은 null 로 유지됩니다.

- 인수값에 기준 컴포넌트를 포함하면 MultiCombo 의 위치는 기준 컴포넌트를 기준으로 상대적으로 결정됩니다.
  vWidth, vHeight 값에 기준 컴포넌트를 포함할 때는 "ID:Value" 형태로 설정하여야 합니다.

- 기준 컴포넌트는 MultiCombo 와(과) 부모(Parent)가 동일하여야 하며, Form 로딩 시 MultiCombo 보다 먼저 생성되어야 합니다.
  기준 컴포넌트를 설정하지 않거나 잘못된 값을 설정하면 부모(Parent)를 기준으로 좌표값이 적용됩니다.

- 인수값에 기준 컴포넌트 또는 단위를 포함할 경우 문자열로 설정하여야 합니다.

sendToBack

부모가 동일한 컴포넌트 중 MultiCombo 이(가) 화면의 제일 뒤에 표시되게 합니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.sendToBack()

파라미터

this.MultiCombo.sendToBack();

참고

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- sendToBack() 메소드는 MultiCombo 을(를) 가장 먼저 표시되게 순서를 바꿉니다.
  따라서 화면에 표시될때는 제일 뒤에 표시되게 됩니다

sendToNext

부모가 동일한 컴포넌트 중 MultiCombo 이(가) 화면에 한단계 뒤에 표시되게 합니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.sendToNext()

파라미터

this.MultiCombo.sendToNext();

참고

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- sendToNext() 메소드는 MultiCombo 을(를) 한단계 먼저 표시되는 컴포넌트와 순서를 바꿉니다.
  따라서 화면에 표시될때는 원래 순서보다 한단계 뒤에 표시되게 됩니다.

setEventHandler

MultiCombo 의 특정 이벤트에서 첫번째 핸들러 함수를 변경하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setEventHandler( strEventID, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 변경할 이벤트의 ID를 설정합니다.

objFunc

Object

기존 핸들러 함수를 대체할 함수를 설정합니다.

objTarget

Object

대체할 핸들러 함수가 정의된 영역을 설정합니다.

this.MultiCombo00_onmove = function( obj:nexacro.MultiCombo,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };
var nIndex = this.MultiCombo00.setEventHandler( "onmove", this.MultiCombo00_onmove, this );

반환

Type

Description

Number

첫번째 핸들러 함수 변경에 성공하면 0 을 반환합니다.


첫번째 핸들러 함수 변경에 실패하면 -1 을 반환합니다.

참고

- 인덱스가 0 번인 핸들러 함수를 새로운 함수로 대체합니다.

- 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 새로운 함수를 핸들러 함수로 추가합니다.

setEventHandlerLookup

MultiCombo 의 특정 이벤트에서 첫번째 핸들러 함수를 검색된 함수로 변경하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 변경할 이벤트의 ID를 설정합니다.

strFunc

Object

기존 핸들러 함수를 대체할 함수의 이름을 문자열로 설정합니다.

objTarget

Object

대체할 핸들러 함수를 검색할 영역을 설정합니다.

해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다.

this.MultiCombo00_onmove = function( obj:nexacro.MultiCombo,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MultiCombo00.setEventHandlerLookup( "onmove", "MultiCombo00_onmove", this);

반환

Type

Description

Number

첫번째 핸들러 함수 변경에 성공하면 0 을 반환합니다.


첫번째 핸들러 함수 변경에 실패하면 -1 을 반환합니다.

참고

- 인덱스가 0 번인 핸들러 함수를 검색된 함수로 대체합니다.

- 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 검색된 함수를 핸들러 함수로 추가합니다.

setFocus

MultiCombo 에 포커스를 주는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setFocus( [bMoveScroll [, bInnerFocus]] )

파라미터

Parameters

Type

Description

bMoveScroll

Boolean

부모 컴포넌트에 스크롤이 있을 경우 MultiCombo 기준으로 스크롤을 이동할지 설정합니다.


true 설정 시 MultiCombo 이(가) 화면에 표시되도록 스크롤을 이동시킵니다.

false 설정 시 MultiCombo 의 위치에 관계없이 스크롤을 이동시키지 않습니다.


값을 설정하지 않으면 true 로 동작합니다.

bInnerFocus

Boolean

MultiCombo 이(가) 컨테이너 컴포넌트 일 때 자식 컴포넌트에게 포커스를 이동할지 설정합니다.


true 설정 시 자식 컴포넌트 중 포커스를 받을 수 있는 첫번째 컴포넌트가 포커스 됩니다.

false 설정 시 MultiCombo 에 포커스 됩니다.


MultiCombo 이(가) 컨테이너 컴포넌트 일 때 값을 설정하지 않으면 true 로 동작합니다.

var objBefComp = this.MultiCombo00.setFocus();
var objBefComp = this.MultiCombo00.setFocus( true );
var objBefComp = this.MultiCombo00.setFocus( true, false );

반환

Type

Description

Object

MultiCombo 이(가) 포커스되기 전에 포커스를 가졌던 컴포넌트를 반환합니다.


포커스를 가진 컴포넌트가 없었거나 메소드 수행이 실패하는 경우에는 null 을 반환합니다.

참고

- setFocus() 메소드는 enableaccessibility 속성값에 관계없이 파라미터값을 기준으로 동작합니다.

- MultiCombo 이(가) 컨테이너 컴포넌트가 아니거나 자식 컴포넌트 중 포커스를 가질 수 있는 컴포넌트가
   존재하지 않을 경우에는 bInnerFocus 파라미터값에 관계없이 MultiCombo 에 포커스 됩니다.

활용 예제

setInnerDataset

MultiCombo 컴포넌트의 innerdataset 속성에 인수로 전달된 DataSet 오브젝트를 설정하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setInnerDataset( objDataset )

파라미터

Parameters

Type

Description

objDataset

Object

innerdataset 속성에 설정할 Dataset 오브젝트입니다.

this.MultiCombo00.setInnerDataset( this.Dataset00 ) ;

참고

- innerdataset 속성에 Dataset 오브젝트 설정 후 codecolumn, datacolumn 속성을 설정하여야 MultiCombo 컴포넌트에 데이터가 정상 반영됩니다.

setOffsetBottom

부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 bottom 값을 픽셀단위로 설정하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setOffsetBottom( nBottom );

파라미터

Parameters

Type

Description

nBottom

Number

부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 bottom 값을 픽셀단위의 숫자로 설정합니다.

this.MultiCombo.setOffsetBottom( 10 );

참고

- 메소드 실행 전 MultiCombo 에 설정된 초기 속성에 따라 메소드 실행 후 설정되는 속성이 달라집니다.
   > MultiCombo 에 top, height 속성이 설정되어 있었다면 메소드 실행 후 top, height 속성이 설정됩니다.
   > MultiCombo 에 top, bottom 속성이 설정되어 있었다면 메소드 실행 후 top, height 속성이 설정됩니다.
   > MultiCombo 에 height, bottom 속성이 설정되어 있었다면 메소드 실행 후 height, bottom 속성이 설정됩니다.

setOffsetHeight

MultiCombo 의 높이를 픽셀단위로 설정하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setOffsetHeight( nHeight );

파라미터

Parameters

Type

Description

nHeight

Number

MultiCombo 의 높이를 픽셀단위의 숫자로 설정합니다.

this.MultiCombo.setOffsetHeight( 10 );

참고

- 메소드 실행 전 MultiCombo 에 설정된 초기 속성에 따라 메소드 실행 후 설정되는 속성이 달라집니다.
   > MultiCombo 에 top, height 속성이 설정되어 있었다면 메소드 실행 후 top, height 속성이 설정됩니다.
   > MultiCombo 에 top, bottom 속성이 설정되어 있었다면 메소드 실행 후 top, height 속성이 설정됩니다.
   > MultiCombo 에 height, bottom 속성이 설정되어 있었다면 메소드 실행 후 height, bottom 속성이 설정됩니다.

setOffsetLeft

부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 left 값을 픽셀단위로 설정하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setOffsetLeft( nLeft );

파라미터

Parameters

Type

Description

nLeft

Number

부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 left 값을 픽셀단위의 숫자로 설정합니다

this.MultiCombo.setOffsetLeft( 10 );

참고

- 메소드 실행 전 MultiCombo 에 설정된 초기 속성에 따라 메소드 실행 후 설정되는 속성이 달라집니다.
   > MultiCombo 에 left, width 속성이 설정되어 있었다면 메소드 실행 후 left, width 속성이 설정됩니다.
   > MultiCombo 에 left, right 속성이 설정되어 있었다면 메소드 실행 후 left, right 속성이 설정됩니다.
   > MultiCombo 에 width, right 속성이 설정되어 있었다면 메소드 실행 후 left, width 속성이 설정됩니다.

setOffsetRight

부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 right 값을 픽셀단위로 설정하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setOffsetRight( nRight );

파라미터

Parameters

Type

Description

nRight

Number

부모 컴포넌트의 Left 위치를 기준으로 MultiCombo 의 right 값을 픽셀단위의 숫자로 설정합니다.

this.MultiCombo.setOffsetRight( 600 );

참고

- 메소드 실행 전 MultiCombo 에 설정된 초기 속성에 따라 메소드 실행 후 설정되는 속성이 달라집니다.
   > MultiCombo 에 left, width 속성이 설정되어 있었다면 메소드 실행 후 left, width 속성이 설정됩니다.
   > MultiCombo 에 left, right 속성이 설정되어 있었다면 메소드 실행 후 left, width 속성이 설정됩니다.
   > MultiCombo 에 width, right 속성이 설정되어 있었다면 메소드 실행 후 width, right 속성이 설정됩니다.

setOffsetTop

부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 top 값을 픽셀단위로 설정하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setOffsetTop( nTop );

파라미터

Parameters

Type

Description

nTop

Number

부모 컴포넌트의 Top 위치를 기준으로 MultiCombo 의 top 값을 픽셀단위의 숫자로 설정합니다.

this.MultiCombo.setOffsetTop( 10 );

참고

- 메소드 실행 전 MultiCombo 에 설정된 초기 속성에 따라 메소드 실행 후 설정되는 속성이 달라집니다.
   > MultiCombo 에 top, height 속성이 설정되어 있었다면 메소드 실행 후 top, height 속성이 설정됩니다.
   > MultiCombo 에 top, bottom 속성이 설정되어 있었다면 메소드 실행 후 top, bottom 속성이 설정됩니다.
   > MultiCombo 에 height, bottom 속성이 설정되어 있었다면 메소드 실행 후 top, height 속성이 설정됩니다.

setOffsetWidth

MultiCombo 의 너비를 픽셀단위로 설정하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setOffsetWidth( nWidth );

파라미터

Parameters

Type

Description

nWidth

Number

MultiCombo 의 너비를 픽셀단위의 숫자로 설정합니다.

this.MultiCombo.setOffsetWidth( 10 );

참고

- 메소드 실행 전 MultiCombo 에 설정된 초기 속성에 따라 메소드 실행 후 설정되는 속성이 달라집니다.
   > MultiCombo 에 left, width 속성이 설정되어 있었다면 메소드 실행 후 left, width 속성이 설정됩니다.
   > MultiCombo 에 left, right 속성이 설정되어 있었다면 메소드 실행 후 left, width 속성이 설정됩니다.
   > MultiCombo 에 width, right 속성이 설정되어 있었다면 메소드 실행 후 width, right 속성이 설정됩니다.

setSelect

MultiCombo 컴포넌트에서 특정 아이템의 선택상태를 설정하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setSelect( nIndex, bSelect );

파라미터

Parameters

Type

Description

nIndex

Number

선택상태를 설정할 아이템의 인덱스를 숫자로 설정합니다.

-1 설정 시 bSelect 값에 관계없이 전체 아이템의 선택상태를 해제합니다.

bSelect

Boolean

아이템의 선택상태를 Boolean 값으로 설정합니다.

true 설정 시 아이템이 선택상태로 설정됩니다.

false 설정 시 아이템의 선택상태가 해제됩니다.

this.MultiCombo00.setSelect( 0, false );

setSelectedText

MultiCombo 컴포넌트의 편집영역에서 현재 선택되어 있는 텍스트를 전달된 인수값으로 변경하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setSelectedText( strText )

파라미터

Parameters

Type

Description

strText

String

편집영역에 선택되어 있는 텍스트를 대체할 문자열을 설정합니다.

var strOldText = this.MultiCombo00.setSelectedText( "Character string to change." );

반환

Type

Description

String

편집영역에 선택되어 있던 텍스트를 문자열로 반환합니다.

참고

- type 속성값이 "search" 또는 "filter"이고 텍스트 편집이 가능한 상태여야 합니다.

- 편집영역에 선택된 텍스트가 없으면 setSelectedText() 메서드는 동작하지 않습니다.

setSelectItems

MultiCombo 컴포넌트에서 여러 개의 아이템을 선택하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setSelectItems(items,  bSelect);

파라미터

Parameters

Type

Description

items

Array

선택상태를 설정할 아이템의 인덱스 배열을 설정합니다.

bSelect

Boolean

아이템의 선택상태를 Boolean 값으로 설정합니다.

true 설정 시 아이템이 선택상태로 설정됩니다.

false 설정 시 아이템의 선택상태가 해제됩니다.

this.MultiCombo00.setSelectItems([0,2], true);

setSelectRange

MultiCombo 컴포넌트에서 지정된 인덱스 범위의 아이템 영역을 선택하는 메서드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.setSelectRange(startIndex, endIndex, bSelect);

파라미터

Parameters

Type

Description

startIndex

Number

선택상태를 설정할 아이템의 시작 인덱스를 숫자로 설정합니다.

endIndex

Number

선택상태를 설정할 아이템의 마지막 인덱스를 숫자로 설정합니다.

bSelect

Boolean

아이템의 선택상태를 Boolean 값으로 설정합니다.

true 설정 시 아이템이 선택상태로 설정됩니다.

false 설정 시 아이템의 선택상태가 해제됩니다.

this.MultiCombo00.setSelectRange(0, 2, true)

show

스크립트로 동적 생성한 MultiCombo 을(를) 화면에 표시하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.show()

파라미터

this.MultiCombo00.show();

참고

- show() 메소드는 컴포넌트가 폼 또는 컨테이너 컴포넌트의 자식 컴포넌트로 등록된 상태에서 사용이 가능합니다.
  자식 컴포넌트로 등록된 상태가 아닌 경우에는 오동작이 발생할 수 있습니다.

- 컴포넌트를 컨테이너에 추가하기 위해서는 addChild() 메소드나 insertChild() 메소드를 사용하여야 합니다.

updateToDataset

MultiCombo 의 value 속성값을 바인딩 되어 있는 DataSet 에 즉시 반영시키는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

MultiCombo.updateToDataset()

파라미터

var bSucc = this.MultiCombo00.updateToDataset();

반환

Type

Description

Boolean

반영에 성공하면 "true"를 반환합니다.


반영에 실패하면 "false"를 반환합니다.

참고

- MultiCombo 의 value 속성이 DataSet 에 바인딩 되어 있어야 합니다.

- MultiCombo 의 value 속성값이 바인딩 되어있는 Dataset 의 값과 같으면 Dataset 에 값이 반영되지 않고 "false"를 반환합니다.

활용 예제

이벤트

canitemchange

MultiCombo 컴포넌트에서 아이템을 변경할 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

canitemchange(obj:nexacro.MultiCombo,e:nexacro.ItemChangeEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

ItemChangeEventInfo

Event Object.

참고

- Dataset 오브젝트가 바인딩되어 있다면 Dataset 오브젝트에 변경된 아이템이 적용되기 전에 이벤트가 발생합니다.

- 사용자의 입력에 의해 아이템이 변경되었을 때만 canitemchange 이벤트가 발생합니다.
  스크립트에 의해 아이템이 변경되었을 때는 이벤트가 발생하지 않습니다.

- 검색기능을 이용해 키보드로 아이템을 변경하는 경우는 엔터키로 아이템을 선택하거나 포커스가 MultiCombo 컴포넌트에서 나갈 때 이벤트가 발생합니다.

oncloseup

화면에 표시된 아이템 리스트가 닫힐 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

oncloseup(obj:nexacro.MultiCombo,e:nexacro.ComboCloseUpEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

ComboCloseUpEventInfo

Event Object.

참고

- 화면에 표시된 아이템 리스트를 닫는 방법은 아래와 같습니다.
  1. 마우스로 아이템 리스트 영역이 아닌 부분을 선택했을 경우.
  2. 키보드로 Esc 키를 누를 경우.

- MultiCombo 컴포넌트의 아이템이 변경되면 canitemchange -> onitemchanged -> oncloseup 순서로 이벤트가 발생합니다.

oncontextmenu

MultiCombo 영역에서 오른쪽 마우스 버튼을 클릭하거나 터치를 일정시간 유지할 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

oncontextmenu(obj:nexacro.MultiCombo,e:nexacro.ContextMenuEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

ContextMenuEventInfo

Event Object.

참고

- 모바일 환경에서는 터치를 일정시간 유지하면 oncontextmenu 이벤트가 발생합니다.

- MultiCombo 컴포넌트는 마우스 우클릭이나 터치에 의해 표시되는 기본팝업메뉴가 제공되지 않습니다.

ondevicebuttonup

모바일 에서 디바이스 버튼을 눌렀을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☐ Windows

☐ macOS

☐ Edge

☐ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




문법

ondevicebuttonup(obj:nexacro.MultiCombo,e:nexacro.DeviceButtonEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

DeviceButtonEventInfo

Event Object.

반환

Type

Description

Boolean

true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.

반환값을 생략하면 false로 적용됩니다.

참고

- 디바이스 버튼을 눌렀다 뗄 때 이벤트가 발생합니다.

- 버튼 형식은 MENU(1),  CANCEL(2) 2종류 입니다.

- 일부 기종에서 CANCEL 버튼을 long press 해야 MENU key event가 발생합니다.

ondrag

MultiCombo 영역 내에서 마우스 왼쪽버튼으로 드래그를 수행했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ondrag(obj:nexacro.MultiCombo,e:nexacro.DragEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

DragEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 드래그 상태가 되고 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 드래그 상태가 취소되고 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- MultiCombo 영역 내에서 마우스의 LButtonDown 후 LButtonUp 액션 없이 마우스 이동 시 ondrag 이벤트가 발생합니다.

- 이벤트의 리턴값을 true 로 하여 드래그 상태가 발생해도 아래와 같은 이유로 드래그 상태가 중단될 수 있습니다.
   > 넥사크로 내부에서 alert(), confirm(), showModal() 메소드가 실행되어 포커스가 바뀌는 경우.
   > OS 내 다른 어플리케이션으로 포커스가 바뀌는 경우.
   > 이벤트가 시작된 컴포넌트가 삭제되는 경우 등

- 에디트 계열 컴포넌트에서 마우스로 드래그 시 화면의 문자열을 선택할 지 드래그 상태를 발생시킬지 여부는 이벤트의 리턴값으로 결정됩니다.

ondragenter

MultiCombo 영역 내로 드래그 상태의 마우스 포인터가 들어왔을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ondragenter(obj:nexacro.MultiCombo,e:nexacro.DragEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

DragEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- 드래그 상태를 유지하고 있으면 MultiCombo 영역으로 마우스 포인터가 들어올 때마다 이벤트가 발생합니다.

ondragleave

MultiCombo 영역 밖으로 드래그 상태의 마우스 포인터가 나갈 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ondragleave(obj:nexacro.MultiCombo,e:nexacro.DragEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

DragEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- 드래그 상태를 유지하고 있으면 MultiCombo 영역에서 마우스 포인터가 나갈 때마다 이벤트가 발생합니다.

ondragmove

MultiCombo 영역 내에서 드래그 상태의 마우스 포인터가 움직일 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ondragmove(obj:nexacro.MultiCombo,e:nexacro.DragEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

DragEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- 드래그 상태를 유지하고 있으면 MultiCombo 영역 내에서 마우스 포인터가 움직일 때마다 이벤트가 발생합니다.

ondrop

MultiCombo 영역 내에서 드래그 상태의 마우스 버튼을 떼었을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ondrop(obj:nexacro.MultiCombo,e:nexacro.DragEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

DragEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- MultiCombo 영역 내에서 드래그 상태인 마우스의 LButtonUp 액션 발생 시 ondrop 이벤트가 발생합니다.

- 넥사크로에서 발생한 드래그 또는 어플리케이션 외부에서 파일을 드래그 했을 때 ondrop 이벤트를 발생시킬 수 있습니다.

- 드래그 상태가 발생해도 아래와 같은 이유로 드래그 상태가 중단될 수 있습니다.
   > 넥사크로 내부에서 alert(), confirm(), showModal() 메소드가 실행되어 포커스가 바뀌는 경우.
   > OS 내 다른 어플리케이션으로 포커스가 바뀌는 경우.
   > 이벤트가 시작된 컴포넌트가 삭제되는 경우 등

ondropdown

MultiCombo 컴포넌트의 아이템 리스트가 화면에 표시될 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ondropdown(obj:nexacro.MultiCombo,e:nexacro.EventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

EventInfo

Event Object.

반환

Type

Description

Boolean

이벤트의 리턴값으로 true를 반환하면 아이템 리스트가 화면에 표시됩니다.

이벤트의 리턴값으로 false를 반환하면 아이템 리스트가 표시되지 않습니다.


이벤트의 리턴값을 생략하면 true로 적용됩니다.

참고

- MultiCombo 컴포넌트의 dropdown() 메서드로 아이템 리스트가 화면에 표시되어도 ondropdown 이벤트가 발생합니다.

- MultiCombo 컴포넌트의 검색기능에 의해 자동으로 아이템 리스트가 표시되어도 ondropdown 이벤트가 발생합니다.

oneditclick

MultiCombo 컴포넌트의 텍스트 편집 영역에서 마우스 왼쪽 버튼을 클릭했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

oneditclick(obj:nexacro.MultiCombo,e:nexacro.EditClickEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

EditClickEventInfo

Event Object.

참고

- 컴포넌트의 텍스트 편집 영역에서 마우스 왼쪽 버튼을 클릭했을 때 발생합니다.
  onlbuttondown 이벤트와 onlbuttonup 이벤트가 차례로 발생한 뒤, oneditclick 이벤트가 발생합니다.
  단, 텍스트 편집 영역에서 마우스로 드래그하여 텍스트를 선택하는 경우, oneditclick 이벤트 대신 ondrag 이벤트가 발생합니다.

oninnerdatachanged

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

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

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

InnerdataChangedEventInfo

Event Object.

참고

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

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

oninput

MultiCombo 에서 입력을 시도할 때 발생하는 이벤트 입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

oninput(obj:nexacro.MultiCombo,e:nexacro.InputEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

InputEventInfo

Event Object.

참고

- 조합문자 입력시 oninput 이벤트가 한번 이상 발생할 수 있습니다.


◆ web runtime environment 제약

- 동일한 입력에 대해 브라우저의 특성에 따라 oninput 이벤트 발생횟수가 다를 수 있습니다.

- 조합문자 입력확정 동작에서 oninput 이벤트가 발생하지 않는 브라우저가 있을 수 있습니다.
   조합문자 입력확정 동작은 입력시도로 볼 수 없기 때문에 oninput 이벤트의 발생을 보장하지 않습니다.

onitemchanged

MultiCombo 컴포넌트에서 아이템이 변경된 후 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onitemchanged(obj:nexacro.MultiCombo,e:nexacro.ItemChangeEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

ItemChangeEventInfo

Event Object.

참고

- 사용자의 입력에 의해 아이템이 변경되었을 때만 onitemchanged 이벤트가 발생합니다.
  스크립트에 의해 아이템이 변경되었을 때는 이벤트가 발생하지 않습니다.

- index, value, text 속성값이 한 개 이상 변경되면 onitemchanged 이벤트가 발생합니다.

- Dataset 오브젝트가 바인딩되어 있다면 변경된 아이템이 Dataset 오브젝트에 적용된 후 onitemchanged 이벤트가 발생합니다.

- MultiCombo 컴포넌트의 아이템이 변경되면 canitemchange -> onitemchanged -> oncloseup 순서로 이벤트가 발생합니다.

onitemclick

아이템 리스트에서 아이템을 클릭했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onitemclick(obj:nexacro.MultiCombo,e:nexacro.ItemClickEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

ItemClickEventInfo

Event Object.

참고

- 아이템 리스트에서 마우스 왼쪽 버튼을 Down&Up 하면 이벤트가 발생합니다.

- 마우스 선택으로 아이템이 변경되었다면 onitemclick -> canitemchange 순서로 이벤트가 발생합니다.

onkeydown

MultiCombo 에 포커스가 있는 상태에서 키보드의 키가 눌렸을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




문법

onkeydown(obj:nexacro.MultiCombo,e:nexacro.KeyEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

KeyEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트의 리턴값으로 "true"를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트의 리턴값으로 "false"를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트의 리턴값을 생략하면 "false"로 적용됩니다.

onkeyup

MultiCombo 에 포커스가 있는 상태에서 눌렸던 키보드가 떼어질 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onkeyup(obj:nexacro.MultiCombo,e:nexacro.KeyEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

KeyEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- Tab 키 입력으로 포커스가 변경된 경우는 onkeyup 이벤트가 발생하지 않으며 이벤트가 상위로 전파되지 않습니다.


◆ Mobile WRE 제약

- 일부 모바일 웹브라우저에서 e.keycode 속성에 입력값이 정상적으로 전달되지 않을 수 있습니다.
   또한 키보드 관련 이벤트의 순서가 바뀌어 발생할 수 있습니다.

onkillfocus

MultiCombo 에서 포커스가 나갈  때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onkillfocus(obj:nexacro.MultiCombo,e:nexacro.KillFocusEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

KillFocusEventInfo

Event Object.

참고

- 서로 다른 애플리케이션 단위로 포커스가 이동할 때는 포커스 관련 이벤트가 발생하지 않습니다.

- showModal(), open() 등의 메소드로 팝업된 Frame 으로 포커스가 이동하는 경우 MultiCombo 에서 포커스 관련 이벤트가 발생하지 않습니다.
   또한, alert(), confirm() 메소드로 표시된 팝업으로 포커스가 이동하는 경우도 MultiCombo 에서 포커스 관련 이벤트가 발생하지 않습니다.

onlbuttondown

MultiCombo 영역 내에서 마우스 왼쪽버튼을 눌렀을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onlbuttondown(obj:nexacro.MultiCombo,e:nexacro.MouseEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MouseEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- NRE는 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- MultiCombo 영역 내에서 마우스의 LButtonDown 액션이 발생하면 이벤트가 발생합니다.


◆ WRE 제약

- WRE는 이벤트의 리턴값과 관계없이 상위 컴포넌트로 이벤트가 전파됩니다.

onlbuttonup

MultiCombo 영역 내에서 눌렸던 마우스 왼쪽버튼을 떼었을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

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

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MouseEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- NRE는 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- onlbuttonup 이벤트는 마우스의 왼쪽버튼을 떼었을 때 마우스의 위치와 관계없이 onlbuttondown 이벤트가 발생했던 컴포넌트에서 발생합니다.


◆ WRE 제약

- WRE는 이벤트의 리턴값과 관계없이 상위 컴포넌트로 이벤트가 전파됩니다.

onmouseenter

MultiCombo 영역 내로 마우스 포인터가 들어왔을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onmouseenter(obj:nexacro.MultiCombo,e:nexacro.MouseEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MouseEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- NRE는 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.


◆ WRE 제약

- WRE는 이벤트의 리턴값과 관계없이 상위 컴포넌트로 이벤트가 전파됩니다.

- onmouseenter 이벤트 발생 후 onmousemove 이벤트가 발생합니다.
  https://www.w3.org/TR/DOM-Level-3-Events/#events-mouseevent-event-order


◆ iPad 운영체제 제약 (블루투스 마우스 사용 시)

- iPadOS 14 이상 버전에서 블루투스 마우스 사용 시 onmouseenter 이벤트를 지원합니다.
  iPadOS 14 미만 버전은 onmouseenter 이벤트를 지원하지 않습니다.

onmouseleave

MultiCombo 영역 밖으로 마우스 포인터가 나갈 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onmouseleave(obj:nexacro.MultiCombo,e:nexacro.MouseEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MouseEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- NRE는 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.


◆ WRE 제약

- WRE는 이벤트의 리턴값과 관계없이 상위 컴포넌트로 이벤트가 전파됩니다.


◆ iPad 운영체제 제약 (블루투스 마우스 사용 시)

- iPadOS 14 이상 버전에서 블루투스 마우스 사용 시 onmouseleave 이벤트를 지원합니다.
  iPadOS 14 미만 버전은 onmouseleave 이벤트를 지원하지 않습니다.

onmousemove

MultiCombo 영역 내에서 마우스 포인터가 움직일 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onmousemove(obj:nexacro.MultiCombo,e:nexacro.MouseEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MouseEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- NRE는 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.


◆ WRE 제약

- WRE는 이벤트의 리턴값과 관계없이 상위 컴포넌트로 이벤트가 전파됩니다.


◆ iPad 운영체제 제약 (블루투스 마우스 사용 시)

- iPadOS 14 이상 버전에서 블루투스 마우스 사용 시 onmousemove 이벤트를 지원합니다.
  iPadOS 14 미만 버전은 onmousemove 이벤트를 지원하지 않습니다.

onmousewheel

MultiCombo 영역 내에서 마우스의 휠버튼을 회전했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onmousewheel(obj:nexacro.MultiCombo,e:nexacro.MouseWheelEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MouseWheelEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 휠버튼 회전값이 무시되고, 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 휠버튼 회전값이 처리되고, 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- 이벤트의 리턴값과 스크롤 조건에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- MultiCombo 에서 마우스의 휠버튼 회전값을 처리할 필요가 없을 때 상위 컴포넌트로 휠버튼 회전값과 이벤트가 전파됩니다.
   즉, MultiCombo 에서 스크롤이 이동될 때는 상위로 이벤트가 전파되지 않고, 스크롤이 처음이나 마지막 상태일 때 상위로 이벤트가 전파됩니다.

- Control 키를 누른 상태에서 휠버튼을 회전시키면 환경에 따라 아래와 같이 Zoom 이 발생합니다.
   > Windows NRE 는 window 화면단위로 50%~200% 범위 내에서 10% 단위로 Zoom 이 변경됩니다.
   > Desktop WRE는 웹 브라우저에서 지원하는 범위/간격에 따라 Zoom이 변경됩니다.

- Zoom 상태에서도 MultiCombo 에서 이벤트가 발생하고 리턴값에 따라 상위로 전파되므로 스크립트 작성 시 주의하여야 합니다.
   이 때, 스크롤은 처리되지 않으며 e.ctrlkey 속성값이 true 로 설정됩니다.

onmove

MultiCombo 의 위치가 이동했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onmove(obj:nexacro.MultiCombo,e:nexacro.MoveEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MoveEventInfo

Event Object.

onrbuttondown

MultiCombo 영역 내에서 마우스 오른쪽버튼을 눌렀을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onrbuttondown(obj:nexacro.MultiCombo,e:nexacro.MouseEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MouseEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- NRE는 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.


◆ WRE 제약

- WRE는 이벤트의 리턴값과 관계없이 상위 컴포넌트로 이벤트가 전파됩니다.

- WRE에서 마우스 오른쪽버튼은 기본팝업메뉴 표시에 사용되므로 일반적으로 onrbuttondown 이벤트를 정의하지 않습니다.

Default Action

- onrbuttondown 이벤트 종료 후 이벤트가 발생한 컴포넌트로 포커스가 이동됩니다.
  단, GroupBox, Static 컴포넌트는 포커스가 이동하지 않습니다.

- 일반적으로 onrbuttondown -> onrbuttonup -> oncontextmenu 순서로 이벤트가 발생하지만
   예외적으로 아래 환경은 onrbuttondown -> oncontextmenu -> onrbuttonup 순서로 이벤트가 발생하므로 주의하여야 합니다.
   : Safari 브라우저, macOS 환경의 전체 웹브라우저, Mobile 전체환경

onrbuttonup

MultiCombo 영역 내에서 마우스 오른쪽버튼을 떼었을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

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

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

MouseEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- NRE는 이벤트의 리턴값에 따라 상위 컴포넌트로 이벤트가 전파됩니다.

- onrbuttonup 이벤트는 onrbuttondown 이벤트와 관계없이 마우스 오른쪽버튼을 떼었을 때 마우스가 위치한 컴포넌트에서 발생합니다.


◆ WRE 제약

- WRE는 이벤트의 리턴값과 관계없이 상위 컴포넌트로 이벤트가 전파됩니다.

- WRE에서 마우스 오른쪽버튼은 기본팝업메뉴 표시에 사용되므로 일반적으로 onrbuttonup 이벤트를 정의하지 않습니다.

Default Action

- onrbuttonup 이벤트 종료 후 oncontextmenu 이벤트가 발생합니다.
   예외적으로 아래 환경은 onrbuttondown -> oncontextmenu -> onrbuttonup 순서로 이벤트가 발생하므로 주의하여야 합니다.
   : Safari 브라우저, macOS 환경의 전체 웹브라우저, Mobile 전체환경

onsetfocus

MultiCombo 에 포커스가 들어올 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




문법

onsetfocus(obj:nexacro.MultiCombo,e:nexacro.SetFocusEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

SetFocusEventInfo

Event Object.

참고

- 서로 다른 애플리케이션을 이동할 때는 포커스 관련 이벤트가 발생하지 않습니다.

- showMoadl(), open() 메소드에 의해 표시된 프레임으로 포커스가 이동되어도 포커스 관련 이벤트가 발생하지 않습니다.

- alert(), confirm() 메소드에 의해 표시된 팝업창으로 포커스가 이동되어도 포커스 관련 이벤트가 발생하지 않습니다.

onsize

MultiCombo 의 크기가 변경됐을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

onsize(obj:nexacro.MultiCombo,e:nexacro.SizeEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

SizeEventInfo

Event Object.

ontouchend

MultiCombo 영역 내에서 터치를 떼었을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ontouchend(obj:nexacro.MultiCombo,e:nexacro.TouchEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

TouchEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- Environment 의 enabletouchevent 속성값이 true 인 경우에만 이벤트가 발생합니다.

ontouchmove

MultiCombo 영역 내에서 터치 상태를 유지하며 움직일 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ontouchmove(obj:nexacro.MultiCombo,e:nexacro.TouchEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

TouchEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- Environment 의 enabletouchevent 속성값이 true 인 경우에만 이벤트가 발생합니다.

ontouchstart

MultiCombo 영역 내에서 터치가 시작될 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




문법

ontouchstart(obj:nexacro.MultiCombo,e:nexacro.TouchEventInfo);

파라미터

Parameters

Type

Description

obj

MultiCombo

Event가 발생한 Object.

e

TouchEventInfo

Event Object.

반환

Type

Description

Boolean

이벤트에서 리턴값으로 true 를 반환하면 상위 컴포넌트로 이벤트가 전파되지 않습니다.

이벤트에서 리턴값으로 false 를 반환하면 상위 컴포넌트로 이벤트가 전파됩니다.


이벤트에서 리턴값을 생략하면 false 로 적용됩니다.

참고

- Environment 의 enabletouchevent 속성값이 true 인 경우에만 이벤트가 발생합니다.