ACAPI_LibPart_GetDetails

등록된 라이브러리 파트의 상세한 파라미터들을 리턴합니다.

    GSErrCode  ACAPI_LibPart_GetDetails (
        Int32                   libInd,
        API_LibPartDetails*     details
    );

 

파라미터

libInd

[in] 라이브러리 파트의 인덱스입니다.

details

[out] 라이브러리 파트의 상세 파라미터들입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

파라미터들 중 하나 이상이 NULL입니다. 또는

호출한 라이브러리 파트가 매크로, 그림 파일 등입니다.

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

 

설명

이 함수는 라이브러리 파트의 상세 파라미터들을 가져오는 데 사용합니다. 이 파라미터들은 ArchiCAD의 파라미터 리스트 편집기 다이얼로그 박스에서 Details 버튼을 클릭하여 편집할 수 있습니다.

이 함수는 실제 라이브러리 파트들에서만 작동합니다. 대상 라이브러리 파트의 타입이 아래 리스트에 속한 것이 아닌 경우, 함수는 오류 코드를 리턴합니다. 다른 타입의 라이브러리 파트들은 단순한 그림 또는 텍스트 파일들이기 때문에 활성 라이브러리 폴더에 열거되고 등록됩니다; 그림 또는 매크로 등.

적용 가능한 타입의 라이브러리 파트들은 다음과 같습니다:

• APILib_WindowID
• APILib_DoorID
• APILib_ObjectID
• APILib_LampID
• APILib_RoomID
• APILib_LabelID

파라미터들을 변경하려면 ACAPI_LibPart_SetDetails_ParamDef 함수를 참조하십시오.

 

예제

API_LibPartDetails    details;
API_LibPart           libPart;
GSErrCode             err;

BNZeroMemory (&libPart, sizeof (API_LibPart));
libPart.typeID = APILib_ObjectID;
GS::ucscpy (libPart.docu_UName, L("Test LibPart"));
err = ACAPI_LibPart_Search (&libPart, false);
if (libPart.index != 0) {
    err = ACAPI_LibPart_GetDetails (libPart.index, &details);
}

 

요구사항

버전: API 2.1 또는 이후

헤더: ACAPinc.h

 

참고사항

API_LibPartDetails,
ACAPI_LibPart_SetDetails_ParamDef,
라이브러리 파트 관리자, API 함수