Graphisoft®

API Development KitVersion: 18

APIEnv_ChangeNavigatorItemID

주어진 Project Navigator 항목을 변경합니다.

    GSErrCode ACAPI_Environment (
        APIEnv_ChangeNavigatorItemID,
        API_NavigatorItem*     navigatorItem
    );

 

파라미터

navigatorItem
[in] guid로 식별되는 네비게이터 항목입니다.

 

리턴 값

APIERR_BADPARS
지정한 네비게이터 항목이 Public View Map 또는 My View Map에 존재하지 않습니다. (팀워크 모드)
APIERR_NOTMINE
당신은 항목을 변경할 권한을 갖고 있지 않습니다.
NoError
함수가 성공적으로 완료되었습니다.

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

 

설명

Project Navigator 항목의 이름 또는 ID를 변경하기 위해 이 함수를 사용하십시오. View Map 항목들만 변경할 수 있습니다.

 

예제

API_NavigatorItem navItem;
BNZeroMemory (&navItem, sizeof(API_NavigatorItem));
navItem.mapId = API_PublicViewMap;    //for performance
if (ACAPI_Environment (APIEnv_GetNavigatorItemID, guid, &navItem)== NoError) {
    //name
    if (navItem.customName) {
        navItem.customName = false;
    } else {
        navItem.customName = true;
        CHCopyC ("Name from API", navItem.name);
    }

    //uiId
    if (navItem.customUiId) {
        navItem.customUiId = false;
    } else {
        navItem.customUiId = true;
        CHCopyC ("ID from API", navItem.uiId);
    }

    err = ACAPI_Environment (APIEnv_ChangeNavigatorItemID, &navItem);
}

 

요구사항

버전: API 18 또는 이후
헤더: APIdefs_Environment.h

 

참고사항

ACAPI_Environment,
API 함수