APIDb_GetWorksheetDatabasesID

모든 디테일 데이터베이스들의 유일 ID들의 리스트를 리턴합니다.

    GSErrCode ACAPI_Database (
        APIDb_GetWorksheetDatabasesID,
        API_DatabaseUnId**     dbUnIDs
    );

 

파라미터

dbUnIDs

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

 

리턴 값

NoError

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

APIERR_BADPARS

dbUnIDs가 NULL입니다.

APIERR_NOPLAN

도면 데이터베이스가 존재하지 않습니다.

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

 

설명

이 함수는 모든 워크시트 데이터베이스들의 데이터베이스 유일 ID들을 리턴하는 데 사용합니다. 독립적인 워크시트들도 포함됩니다. 현재 이것은 독립적인 워크시트들에게 접근할 수 있는 유일한 방법입니다.

독립적인 워크시트들은 평면도, 단면/입면 상에 있는 해당 마커를 갖고 있지 않습니다.

하나의 워크시트 데이터베이스가 다수의 워크시트 마커들에게 속할 수도 있습니다. (즉, 동일한 마커를 여러 번 배치하면 그것들은 모두 동일한 워크시트 데이터베이스를 참조하게 됩니다)

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

 

예제

Attribute Manager 애드온은 이 함수를 이용하여 디테일 데이터베이스들로부터 사용되는 모든 속성들을 수집합니다.

API_DatabaseUnId    *worksheets = NULL;
GSErrCode           err;

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

 

요구사항

버전: API 6.1 또는 이후

헤더: APIdefs_Database.h

 

참고사항

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