ACAPI_Notify_CatchSelectionChange

선택 변경사항들에 대한 모니터링을 on/off 합니다.

    GSErrCode  ACAPI_Notify_CatchSelectionChange (
        APISelectionChangeHandlerProc*     handlerProc
    );

 

파라미터

handlerProc

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

 

리턴 값

NoError

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

다른 공통 API 오류들에 대해서는 오류 코드들의 리스트를 보십시오.

 

설명

이 함수는 선택에서의 변경사항을 모니터링하고 싶은 애드온을 등록/등록해제하는 데 사용합니다. 그 후에 ACAPI_KeepInMemory 함수를 호출해서는 안 됩니다. 왜냐하면 API가 설치된 알림 핸들러들을 가진 애드온들이 언로드되지 않도록 보장해주기 때문입니다.
애드온의 handlerProc이 등록된 후에 당신은 선택이 변경될 때 호출 받게 될 것입니다.

 

예제

// -----------------------------------------------------------------------------
// 선택 변경 핸들러 함수
// -----------------------------------------------------------------------------
static GSErrCode __ACENV_CALL    SelectionChangeHandler (const API_Neig *selElemNeig)

{
    char    msgStr[256];

    if (selElemNeig->neigID != APINeig_None) {
        sprintf (msgStr, "Last selected element: NeigID %d; index: %d, inIndex: %d",
                 selElemNeig->neigID, selElemNeig->index, selElemNeig->inIndex);
        ACAPI_WriteReport (msgStr, false);
    } else
        ACAPI_WriteReport ("All elements deselected", false);

    return NoError;
}   // SelectionChangeHandler


// -----------------------------------------------------------------------------
// 애드온이 메모리에 로드된 후에 호출됨
// -----------------------------------------------------------------------------
GSErrCode    __ACENV_CALL    Initialize (void)

{
    // 선택에서의 변경사항을 캐치
    GSErrCode err = ACAPI_Notify_CatchSelectionChange (SelectionChangeHandler);

    return err;
}   // Initialize

 

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_KeepInMemory, APISelectionChangeHandlerProc,
알림 관리자, API 함수