개요
컴포넌트에 선언된 이벤트의 원형 오브젝트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
- 일반적으로 Composite Component 와 같은 사용자 컴포넌트에 이벤트를 선언할 때 내부적으로 사용되는 오브젝트입니다. - 컴포넌트의 모든 이벤트는 EventObject 를 사용하여 선언됩니다. 컴포넌트에 선언된 이벤트에 addEventHandler() 와 같은 메소드로 핸들러 함수를 동록하여 이벤트를 정의합니다. - 이벤트 및 이벤트 핸들러의 종류는 각 컴포넌트의 Event 항목을 참조하시기 바랍니다.
속성
length
이벤트에 정의된 이벤트 핸들러 함수의 갯수를 갖는 읽기전용 속성입니다.
지원 환경
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 |
문법 설정
var nCnt = this.Button00.onclick.length; |
참고
- 이벤트 핸들러 함수는 넥사크로 스튜디오에서 정의하거나 addEventHandler() 와 같은 메소드를 사용하여 정의할 수 있습니다.
name
EventObject 의 이름을 설정하는 속성입니다.
지원 환경
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 |
문법 설정
strName | EventObject 의 이름을 설정합니다. | |
|---|---|---|
참고
- name 속성은 사용자가 지정한 Object 의 이름으로 논리적으로 중복이 가능합니다.
메서드
fireEvent
이벤트에 정의된 핸들러 함수를 호출하여 이벤트를 발생시키는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
EventObject.fireEvent( objFireComp, objEventInfo [, bCancelable] )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
objFireComp | Object | 이벤트 핸들러 함수에 전달할 컴포넌트를 설정합니다. 일반적으로 이벤트가 발생할 컴포넌트를 동일하게 설정합니다. | |
objEvent | Object | 이벤트 핸들러 함수에 전달할 EventInfo 오브젝트를 설정합니다. | |
bCancelable | Boolean | 이벤트 핸들러 함수의 반환값에 따라 함수실행을 중지시킬 지 여부를 설정합니다. true 설정 시 핸들러 함수에서 false 를 반환하면 핸들러 함수실행을 모두 중지합니다. true 설정 시 핸들러 함수에서 true 를 반환하면 다음 핸들러 함수를 실행합니다. false 설정 시 핸들러 함수에서 true/false 값을 반환하면 다음 핸들러 함수를 실행합니다. 값 생략 시 false 로 적용됩니다. | |
var objEventInfo = new ClickEventInfo(); var bRtn = this.Button00.onclick.fireEvent( this.Button00, objEventInfo, true ); | |||
반환
Type | Description |
|---|---|
Boolean | bCancelable 파라미터가 true 이고 핸들러 함수 실행중 false 가 반환되었다면 false 를 반환합니다. bCancelable 파라미터가 true 이고 핸들러 함수 실행중 false 가 반환되지 않았다면 true 를 반환합니다. bCancelable 파라미터가 false 이면 마지막 핸들러 함수에서 반환한 값을 반환합니다. bCancelable 파라미터가 false 이고 마지막 핸들러 함수에서 값을 반환하지 않으면 빈값을 반환합니다. |
참고
- Composite Component 와 같은 사용자 컴포넌트에서 이벤트를 발생시킬 때 사용하는 메소드입니다. - 이벤트에 두개 이상의 핸들러 함수가 정의되었다면 정의된 순서대로 핸들러 함수를 실행합니다. - 일반적으로 fireEvent() 메소드의 반환값은 핸들러 함수에서 이벤트를 취소했다는 정보를 받으려 할 때 사용합니다. bCancelable 파라미터가 true 이고 핸들러 함수 실행중 false 가 반환되었을 경우입니다.
활용 예제