Main Content

event.listener 클래스

네임스페이스: event

리스너(Listener) 객체를 정의하는 클래스

설명

event.listener 클래스는 리스너 객체를 정의합니다. 리스너 객체는 이벤트가 트리거될 때 콜백 함수를 실행하여 특정 이벤트에 응답합니다. event.listener 클래스를 사용하여 리스너 객체를 생성할 수 있습니다. 핸들 addlistenerlistener 메서드를 사용하여 리스너를 생성할 수도 있습니다.

핸들 notify 메서드를 사용하여 이벤트를 트리거합니다.

event.listener 클래스는 handle 클래스입니다.

클래스 특성

ConstructOnLoad
true
HandleCompatible
true

클래스 특성에 대한 자세한 내용은 클래스 특성 항목을 참조하십시오.

생성

설명

예제

eListener = event.listener(eventSource,eventName,callbackFcn)은 지정된 소스 객체에서 지정된 이벤트 이름에 대한 리스너를 생성하고 콜백 함수에 대한 함수 핸들을 식별합니다.

eventSource가 객체 핸들의 배열인 경우 리스너는 배열에 들어 있는 모든 객체에서, 명명된 이벤트에 응답합니다.

입력 인수

모두 확장

이벤트 소스로, 핸들 객체 배열 또는 객체 핸들로 구성된 셀형 배열로 지정됩니다. 소스 객체의 클래스가 달라서 배열을 형성할 수 없을 때 셀형 배열을 사용합니다. 모든 소스 객체는 지정된 이벤트를 정의해야 합니다.

이벤트 이름으로, 이벤트의 리터럴 이름으로 지정됩니다.

콜백 함수로, 함수 핸들로 지정됩니다. 자세한 내용은 리스너 콜백 구문 항목을 참조하십시오.

속성

모두 확장

이벤트 소스 객체로, 이벤트가 트리거될 때 이 리스너가 응답하는 객체의 핸들로 지정됩니다.

특성:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

데이터형: handle object | cell array

지정된 소스 객체에서 트리거될 때 리스너가 응답하는 이벤트의 이름입니다.

특성:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

데이터형: char | string

이벤트 콜백으로, 함수 핸들로 지정됩니다. 이 함수는 이벤트가 트리거될 때 실행됩니다.

특성:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

데이터형: function_handle

콜백은 Enabledtrue(디폴트 값)로 설정된 경우에만 이벤트 발생 시 실행됩니다. 이 리스너에 대한 콜백 실행을 비활성화하려면 Enabledfalse로 설정하십시오.

특성:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

데이터형: logical

false(디폴트 값)이면 리스너는 콜백을 재귀적으로 실행하지 않습니다. 따라서 콜백이 자체 이벤트를 트리거하는 경우 리스너는 다시 응답하지 않습니다.

true인 경우 리스너 콜백은 콜백을 트리거한 것과 동일한 이벤트를 발생시킬 수 있습니다. 이 방법은 무한 재귀로 이어질 수 있으며, MATLAB® 재귀 제한에서 오류가 발생하면 이 무한 재귀는 종료됩니다.

특성:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

데이터형: logical

예제

모두 축소

EOL이라는 이름의 이벤트에 대한 리스너를 정의합니다. 리스너는 배열 textReader에 들어 있는 객체에서 트리거되는 EOLCallback이라는 이름의 콜백 함수를 갖습니다.

listenerHandle = event.listener(textReader,"EOL",@EOLCallback);

세부 정보

모두 확장

버전 내역

R2008a에 개발됨