ACAPI_LibPart_Register

라이브러리 파트를 등록합니다.

    GSErrCode  ACAPI_LibPart_Register (
        API_LibPart*     libPart
    );

파라미터

libPart: [in/out] 라이브러리 파트의 파라미터들입니다;
라이브러리 파트의 타입, 소유자 서명, 파일 서술자는 반드시 typeID, ownerID, fileDef 필드를 설정하여 각각 초기화되어야 합니다. 다른 값들은 ArchiCAD에 의해 채워지고 리턴될 것입니다.

리턴 값

NoError: 함수가 성공적으로 완료되었습니다.
APIERR_BADPARS: libPart가 NULL입니다. 또는 유효하지 않은 데이터를 참조합니다.

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

설명

이 함수는 새로운 라이브러리 파트를 등록하는 데 사용합니다.

당신은 모든 종류의 라이브러리 파트를 등록할 수 있습니다. 그러나 이 함수는 기본적으로 매크로 및 그림을 처리하기 위해 구현되었습니다. 이러한 타입의 라이브러리 파트들은 API의 도움 없이 생성될 수 있는 단순한 텍스트 및 그림 파일들입니다. 만약 당신이 새로운 매크로를 생성하고 싶다면, 당신은 단지 파일 시스템 어딘가에 간단한 텍스트 파일을 생성하고 그것을 매크로로 등록해야 합니다.

만약 함수가 성공적으로 완료되면, ArchiCAD에 의해 레퍼런스 인덱스가 libPart->index 파라미터에 리턴됩니다. 이 값을 사용하면 차후 동작에서 등록된 라이브러리 파트를 참조할 수 있습니다.

실제 ArchiCAD 라이브러리 파트들을 생성하는 과정은 훨씬 더 복잡합니다. 비록 파일 포맷이 public이지만, 객체, 램프, 문 등 종류의 라이브러리 파트를 생성할 때 API 함수들을 사용하는 것을 적극 권장합니다. 이 경우 당신은 그것을 등록해서는 안 됩니다. 왜냐하면 ACAPI_LibPart_Save 함수가 그것을 하기 때문입니다.

예제

IO::Location     fileLoc ("C:\\temp\\MyLibpart.gsm");
API_LibPart      libPart;
GSErrCode        err;

BNZeroMemory (&libPart, sizeof (API_LibPart));
libPart.typeID   = APILib_ObjectID;
libPart.location = &fileLoc;
err = ACAPI_LibPart_Register (&libPart);

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

참고사항

API_LibPart,
ACAPI_LibPart_Save,
ACAPI_LibPart_RegisterAll,
라이브러리 파트 관리자, API 함수