ACAPI_Notify_CatchViewEvent

Project Navigator 변경사항이 발생하면 당신의 애드온이 알림을 받을지 여부를 등록 또는 등록 해제합니다.

    GSErrCode  ACAPI_Notify_CatchViewEvent (
        GSFlags                      eventTypes,
        API_NavigatorMapID           mapId,
        APIViewEventHandlerProc*     handlerProc
    );

 

파라미터

eventTypes

[in] 서로 다른 API_NotifyViewEventID 값들의 조합입니다. 당신이 관심 있는 Project Navigator 이벤트들의 타입을 지정합니다.

mapId

[in] 당신이 관심 있는 Project Navigator Map을 지정합니다.

handlerProc

[in] Project Navigator 변경사항이 발생할 때 알림이 전송되면 호출되는 콜백 프로시저입니다. 여기에 NULL을 지정하는 것은 당신이 더 이상 알림이 필요하지 않다는 것을 의미합니다.

 

리턴 값

NoError

요청한 동작을 성공적으로 완료했습니다.

APIERR_BADPARS

eventTypes 파라미터가 유효하지 않습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 지정한 맵에서 Project Navigator 항목들의 변경사항을 API 도구 애드온이 캐치하도록 해줍니다. Navigator 항목이 삽입, 변경, 제거, 또는 열릴 때마다 서버 애플리케이션은 예전에 이 이벤트에 대해 등록된 애드온이 제공한 handlerProc를 호출합니다.

만약 더이상 지정한 맵의 Project Navigator 이벤트들을 캐치할 필요가 없다면, handlerProc 파라미터에 NULL을 전달하여 요구하는 맵에 대한 ACAPI_Notify_CatchViewEvent를 호출하여 등록을 해제하는 것을 기억하시기 바랍니다.

 

예제

ACAPI_Notify_CatchViewEvent (APINotifyView_Inserted | APINotifyView_Deleted | APINotifyView_Modified, API_PublicViewMap, ViewNotificationHandlerProc);
ACAPI_Notify_CatchViewEvent (API_AllViewNotificationMask, API_MyViewMap, NULL);

 

요구사항

버전: API 10 또는 이후

헤더: ACAPinc.h

 

참고사항

API_NavigatorMapID, APIViewEventHandlerProc
알림 관리자, API 함수