Graphisoft®

API Development KitVersion: 18

APIDb_GetDocumentFrom3DDatabasesID

모든 문서 3D 데이터베이스들의 유일 ID들의 리스트를 리턴합니다.

    GSErrCode ACAPI_Database (
        APIDb_GetDocumentFrom3DDatabasesID,
        API_DatabaseUnId**     databaseUnIds
    );

 

파라미터

databaseUnIds
[out] 문서 3D 데이터베이스 유일 ID들의 리스트입니다. 이것은 핸들이 아니라는 것을 참고하십시오; 이것은 포인터의 주소입니다. 아래 예제를 보십시오.

 

리턴 값

NoError
함수가 성공적으로 완료되었습니다.
APIERR_BADPARS
dbUnIDsNULL입니다.
APIERR_NOPLAN
도면 데이터베이스가 존재하지 않습니다.

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

 

설명

이 함수는 모든 문서 3D 데이터베이스들의 데이터베이스 유일 ID들을 리턴하는 데 사용합니다. 현재 이것은 이러한 종류의 데이터베이스들에게 접근하는 유일한 방법입니다. 왜냐하면 그것들은 마커들을 갖고 있지 않기 때문입니다.

APIDb_ChangeCurrentDatabase 함수를 호출하여 다른 데이터베이스들 중 하나로 전환할 수 있습니다.

 

예제

Attribute Manager 애드온이 문서 3D 데이터베이스들로부터 사용되는 모든 속성들을 모으기 위해 이 함수를 사용합니다.

API_DatabaseUnId    *document3Ds = NULL;
GSErrCode           err;

err = ACAPI_Database (APIDb_GetDocumentFrom3DDatabasesID, (void *) &document3Ds, NULL);
if (err == NoError) {
    // 정보를 처리함
}
if (details != NULL)
    BMpFree (reinterpret_cast<GSPtr>(document3Ds));

 

요구사항

버전: API 12.0 또는 이후
헤더: APIdefs_Database.h

 

참고사항

API_DatabaseUnId
APIDb_GetDetailDatabasesID, APIDb_GetLayoutDatabasesID, APIDb_GetMasterLayoutDatabasesID, APIDb_ChangeCurrentDatabase
ACAPI_Database, API 함수