Graphisoft®

API Development KitVersion: 18

ACAPI_Element_ChangeExt

현재 데이터베이스에서 창, 문, 단면, 입면, 실내 입면, ChangeMarker, 디테일, 워크시트 요소를 변경합니다.

    GSErrCode  ACAPI_Element_ChangeExt (
        API_Element*             element,
        const API_Element*       mask,
        API_ElementMemo*         memo,
        UInt32                   memoMask,
        UInt32                   nSubElems,
        API_SubElemMemoMask*     subElems,
        bool                     withdel,
        Int32                    subIndex
    );

 

파라미터

element
[in/out] 변경할 요소에 대한 레퍼런스입니다. 적절한 새 파라미터들로 채워집니다.
mask
[in] element의 관련 필드들을 마스킹하기 위한 선택적인 파라미터입니다.
memo
[in] 변경할 메모 데이터입니다. 선택적인 파라미터이며 NULL이 될 수 있습니다.
memoMask Featuring API 11
[in] memo 파라미터의 관련된 파트들을 지정합니다. 당신은 실내 입면 요소의 모든 세그먼트를 변경하기 위해 특수 마스크 값(ACAPI_ELEMENT_CHANGEEXT_ALLSEGMENTS)을 사용할 수 있습니다.
nSubElems Modified in API 12
[in] 전달된 서브 요소(마커)들의 개수입니다. (0-3)
subElems Modified in API 12
[in] 변경할 마커들을 포함하고 있습니다. (기본 마커, 층 핸들 마커, 실내 입면 공통 마커)
withdel
[in] 요소의 원래 인스턴스를 제거하거나, 그것을 보존해두고 새로운 인스턴스를 생성합니다.
subIndex Featuring API 11
[in] 변경할 단면 세그먼트의 인덱스입니다. (실내 입면 전용) 이 값은 0부터 (세그먼트 개수 - 1)까지입니다.

 

리턴 값

NoError
함수가 성공적으로 완료되었습니다.
APIERR_BADDATABASE
현재 데이터베이스가 평면도, 단면/입면, 디테일 또는 워크시트이어야 합니다.
APIERR_BADPARS
전달된 element 파라미터가 NULL입니다.
또는 요소가 그룹화되어 있고 서스펜드 그룹 모드가 OFF입니다. 또는 요소 타입이 유효하지 않거나 서버 애플리케이션에 의해 지원되지 않습니다. elementMarker->header.typeID가 API_ObjectID가 아닙니다.
APIERR_BADID
요소 레퍼런스가 유효하지 않습니다. (guid) 요소 타입은 API_WindowID, API_DoorID, API_CutPlaneID, API_ElevationID, API_InteriorElevationID, API_ChangeMarkerID, API_DetailID, 또는 API_WorksheetID이어야 합니다.
APIERR_DELETED
요소가 데이터베이스에 존재하지 않습니다.
APIERR_NOTMINE,
APIERR_LOCKEDLAY,
APIERR_HIDDENLAY,
APIERR_NOTEDITABLE
The referenced element cannot be modified.

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

 

설명

이 함수는 요소들 및 그것들과 연결된 서브 요소들을 변경하기 위한 ACAPI_Element_Change의 확장형입니다.

이 함수를 이용하면 요소의 설정 타입 파라미터들을 변경할 수 있을뿐만 아니라 기하 데이터도 변경할 수 있습니다. ACAPI_Element_ChangeParameters와 ACAPI_Element_Edit와 달리, 이것은 한 번에 하나의 요소에만 작동합니다. 리턴할 때, 요소 헤더와 elementMarker 헤더의 guid 필드가 채워집니다. 요소 연결들과 치수 체인들은 자동으로 업데이트됩니다.
더 이상 필요하지 않으면 메모 핸들들을 폐기하기 위해 ACAPI_DisposeElemMemoHdls를 호출하는 것을 잊지 마십시오.

다음 요소 타입들을 지원합니다:

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

 

요구사항

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

 

참고사항

API_Element, API_ElementMemo, API_SubElemMemoMask
ACAPI_Element_Change, ACAPI_Element_ChangeMore
ACAPI_Element_ChangeMemo, ACAPI_Element_ChangeParameters
ACAPI_Element_Edit, ACAPI_DisposeElemMemoHdls
ACAPI_Element_CreateExt, ACAPI_Element_GetDefaultsExt, ACAPI_Element_ChangeDefaultsExt
API_WindowType, API_CutPlaneType, API_ElevationType, API_InteriorElevationType, API_ChangeMarkerType, API_DetailType, API_WorksheetType
요소 관리자, API 함수