ACAPI_ActivatePropertyHandler

애드온의 프로퍼티 핸들러를 활성화 혹은 비활성화합니다.

    GSErrCode  ACAPI_ActivatePropertyHandler (
        short     strResID,
        bool      active
    );

 

파라미터

strResID

[in] 이 커맨드가 실행된 프로퍼티 핸들러가 무엇인지 알려줍니다.

active

[in] 프로퍼티 핸들러를 켭니다/끕니다.

 

리턴 값

NoError

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

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

 

설명

ArchiCAD에서는 오직 하나의 프로퍼티 핸들러만 활성화 될 수 있습니다. 이 커맨드를 실행할 때 다이얼로그가 나타나기 때문에 이 함수의 리턴 값은 사용자의 결정에 따라 달라지게 됩니다. 함수가 리턴할 때, 당신은 그에 따라 당신의 메뉴 항목들을 조정해야 합니다.

 

예제

if (ACAPI_ActivatePropertyHandler (stringResID, !checkedAssignProperty) == NoError) {

    checkedAssignProperty = !checkedAssignProperty;

    API_MenuItemRef mir;
    Int32           flags;

    BNZeroMemory (&mir, sizeof (API_MenuItemRef));
    mir.menuResID = menuResID;
    mir.itemIndex = 1;
    ACAPI_Interface (APIIo_GetMenuItemFlagsID, &mir, &flags);
    if (checkedAssignProperty)
        flags = flags | API_MenuItemChecked;
    else
        flags = flags & !API_MenuItemChecked;

    ACAPI_Interface (APIIo_SetMenuItemFlagsID, &mir, &flags);
}

 

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_Register_PropertyHandler, ACAPI_Install_PropertyHandler, API 함수