Graphisoft®

API Development KitVersion: 18

ACAPI_Element_CreateExt

현재 데이터베이스에 지정된 마커와 함께 새로운 창, 문, 스카이라이트, 단면, 입면, 실내 입면, ChangeMarker, 디테일, 워크시트, 또는 커튼 월 요소를 배치합니다.

    GSErrCode  ACAPI_Element_CreateExt (
        API_Element*             element,
        API_ElementMemo*         memo,
        UInt32                   nSubElems,
        API_SubElemMemoMask*     subElems
    );

 

파라미터

element
[in/out] 원하는 요소가 가리킨 structure 안에 생성될 것입니다. element->header.typeID은 반드시 생성될 요소의 타입을 지정해야 합니다. API_WindowID, API_DoorID, API_CutPlaneID, API_ElevationID, API_InteriorElevationID, API_ChangeMarkerID, API_DetailID, API_WorksheetID 또는 API_CurtainWallID가 될 수 있습니다.
memo
[in] 원하는 요소의 메모 필드가 가리킨 structure로부터 생성될 것입니다. (만약 메모 필드가 필요한 경우)
nSubElems Modified in API 12
[in] 전달된 서브 요소들의 개수입니다.
API_SubElemMemoMask Modified in API 12
[in] 서브요소 / 마커 관련 정보입니다.

 

리턴 값

NoError
함수가 성공적으로 완료되었습니다.
APIERR_BADDATABASE
현재 데이터베이스가 동작에 적절하지 않습니다.
APIERR_BADPARS
element 파라미터가 NULL이거나, 요소 타입이 유효하거나,
요소 타입이 서버 애플리케이션에 의해 지원되지 않습니다. elementMarker->header.typeID가 API_ObjectID가 아닙니다.
APIERR_REFUSEDPAR
element->header.typeID 파라미터가 올바르지 않습니다. 만약 당신이 표시할 수 없는 창에다가 무언가를 생성하려고 한다면 이것이 발생할 수도 있습니다. 예를 들면, 단면 창에 절단면을 생성하는 경우입니다.
APIERR_INVALFLOOR
element->header.floorInd 파라미터가 범위 밖입니다.

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

 

설명

생성될 요소의 타입은 요소 헤더의 typeID로 정의합니다. 리턴할 때, 헤더의 guid 필드가 채워집니다. 더 이상 필요하지 않을 때 핸들들을 폐기하기 위해 ACAPI_DisposeElemMemoHdls를 호출하는 것을 잊지 마십시오.

서로 다른 파라미터들의 의미는 아래 표에 설명되어 있습니다:

element memo elementMarker memoMarker elementMarker2 memoMarker2
API_WindowType
API_DoorType		 addpar 창/문 마커 객체 마커 객체 파라미터들 - -
API_SkylightType  Featuring API 15 addpar 창/문 마커 객체 마커 객체 파라미터들 - -
API_CutPlaneType 절단면 좌표들 평면도에서의 단면 마커 객체 단면 마커 객체 파라미터들 단면에서의 층 핸들 마커 객체 층 핸들 마커 객체 파라미터들
API_ChangeMarkerType 폴리곤 데이터 (선택사항) ChangeMarker 마커 객체 마커 객체 파라미터들 - -
API_DetailType
API_WorksheetType		 폴리곤 데이터 (선택사항) 디테일 드로잉/워크시트 마커 객체 마커 객체 파라미터들 - -

더 자세한 것과 사용법에 대해서는 ACAPI_Element_Create의 설명을 보십시오.

 

요구사항

버전: API 4.3 또는 이후
헤더: ACAPinc.h

 

참고사항

API_Element, API_ElementMemo, API_SubElemMemoMask
ACAPI_Element_Create, ACAPI_DisposeElemMemoHdls
ACAPI_Element_GetDefaultsExt, ACAPI_Element_ChangeDefaultsExt
API_WindowType, API_SkylightType, API_CutPlaneType
API_ElevationType, API_InteriorElevationType, API_ChangeMarkerType, API_DetailType, API_WorksheetType
요소 관리자, API 함수