ACAPI_Element_Delete
여러 개의 요소들을 제거합니다.
GSErrCode ACAPI_Element_Delete (
API_Elem_Head** elemHead,
Int32 nItem
);
파라미터
- elemHead
- [in] 이 파라미터는 제거될 요소들을 식별합니다.
- nItem
- [in] 제거될 요소들의 수입니다.
리턴 값
NoError- 함수가 성공적으로 완료되었습니다.
APIERR_BADDATABASE- 현재 데이터베이스가 동작에 적절하지 않습니다.
APIERR_MEMFULL- 동작을 완료하기 위한 메모리가 부족합니다.
APIERR_NOTMINE- 다른 사용자에게 속한 요소를 지우려는 동작을 시도했습니다. 팀워크 모드에서 주로 발생합니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
당신은 elemHead로 식별되는 여러 개의 (nItem) 요소들을 제거하기 위해 이 함수를 사용할 수 있습니다.
만약 elemHead가 NULL이면 이 함수는 선택한 것들 중에서 작동합니다.
어떤 이유로든 제거할 수 없는 요소가 최소 1개 이상 존재할 경우, 전체 커맨드는 종료됩니다. 그러한 경우는 다음과 같습니다:
- 잠겨 있는 경우,
- 잠긴 레이어에 있는 경우,
- 어떤 그룹의 일부이며, 그룹화 일시중지(suspend group)가 OFF인 경우
- 사용자 작업공간에 있지 않습니다, 그외.
다음 참고사항은 매우 중요합니다:
- 대상 요소들의 리스트가 다른 그룹 멤버들에 의해 자동으로 확장될 것입니다; 만약 어떤 그룹 멤버가 집합 안에 있으며 그룹화 일시중지(suspend group)가 OFF인 경우.
- 모든 링크된 요소들이 제거될 것입니다; 연관 라벨, 치수 등.
이 함수는 평면 데이터베이스에 레퍼런스들을 가지고 있을 수도 있는 단면/입면 데이터베이스에서도 작동한다는 것을 참고하십시오;
이것들을 가상 심볼이라고 하는데, API_SectElemID 요소 타입으로 식별됩니다.
ArchiCAD 6.50 R2/V2부터는 이 요소들을 단면 데이터베이스에서 직접 제거할 수 있습니다. 다만 단면 창이 가장 앞에 있는 창이어야 합니다.
요구사항
- 버전: API 1.3 또는 이후
- 헤더: ACAPinc.h
