APIDo_OpenID

새로운 프로젝트 파일을 엽니다.

    GSErrCode ACAPI_Automate (
        APIDo_OpenID,
        API_FileOpenPars*     fileOpenPars
    );

 

파라미터

fileOpenPars

[in] 프로젝트 파일 하나를 열기 위한 파라미터들입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

openPars 또는 openPars->file이 NULL입니다. 또는 openPars->file이 유효한 위치가 아닙니다. 또는 openPars->libGiven이 true일 때 openPars->archiveLib이 NULL입니다.

APIERR_BADID

openPars->fileTypeID가 알려지지 않은 파일 타입입니다.

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

 

설명

이 함수는 기존 프로젝트 파일을 열기 위해 사용합니다.

이것은 알림 레벨로부터 호출될 수 없습니다; 만약 다른 애드온들이 실행 중이면 이 커맨드는 거부됩니다. 이 함수를 호출하면 이벤트 상의 다른 애드온들에게 알림을 보낼 수도 있습니다. 호출자 애드온은 아무런 알림도 받지 않습니다. 더 자세한 것은 알림 관리자를 보십시오.

 

예제

API_FileOpenPars openPars;
BNZeroMemory (&openPars, sizeof (API_FileOpenPars));
openPars.fileTypeID   = APIFType_PlanFile;
openPars.useStoredLib = true;

IO::Location folderLoc;
API_SpecFolderID specID = API_ApplicationFolderID;
ACAPI_Environment (APIEnv_GetSpecFolderID, &specID, &folderLoc);
folderLoc.AppendToLocal ("ArchiCAD Examples");
folderLoc.AppendToLocal ("Residential House");
openPars.file = new IO::Location (folderLoc, "Residential House.pla");

GSErrCode err = ACAPI_Automate (APIDo_OpenID, &openPars, NULL);
if (err != NoError)
    ACAPI_WriteReport ("Cannot open the file", true);

delete openPars.file;

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Automate.h

 

참고사항

API_FileOpenPars, ACAPI_Automate
알림 관리자, API 함수