APICustomWindowHandlerProc

애드온이 연 창들에서 이벤트들을 처리하기 위한 사용자 지원 콜백 함수입니다.

    typedef GSErrCode  APICustomWindowHandlerProc (
        short                       userRefCon,
        API_NotifyWindowEventID     notifID
    );

 

파라미터

userRefCon

[in] 커스텀 창의 레퍼런스 번호로서 APIDb_NewWindowID에게 제공됩니다.

notifID

[in] 커스텀 창에 대한 이벤트의 타입입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

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

 

설명

이 함수는 APIDb_NewWindowID로 설치될 때 호출될 것입니다.

커스텀 창에 대하여 다음 타입의 이벤트들이 나타날 것입니다:

이벤트 타입	설명
APINotifyWindow_Rebuild	사용자가 메뉴에서 Rebuild를 선택했습니다.
APINotifyWindow_Activate	당신의 창이 활성화되었습니다.
APINotifyWindow_Close	사용자가 당신의 창을 닫았습니다.

 

예제

// ============================================================================
// 커스텀 창 알림들 처리하기
// ============================================================================
static GSErrCode __ACENV_CALL    CustomWindowHandler (short userRefCon, API_NotifyWindowEventID notifID)

{
    char    msgStr[256];

    switch (notifID) {
        case APINotifyWindow_Activate:  Do_ActivateMyWindow (userRefCon);
                                        sprintf (msgStr, "APINotifyWindow_Activate %d", userRefCon);
                                        break;
        case APINotifyWindow_Rebuild:   Do_RebuildMyWindow (userRefCon);
                                        sprintf (msgStr, "APINotifyWindow_Rebuild %d", userRefCon);
                                        break;
        case APINotifyWindow_Close:     Do_CloseMyWindow (userRefCon, false);
                                        sprintf (msgStr, "APINotifyWindow_Close %d", userRefCon);
                                        break;
    }

    ACAPI_WriteReport (msgStr, false);

    DisableEnableCloseCmd ();

    return NoError;
}   // CustomWindowHandler

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Callback.h

 

참고사항

API 함수