ACAPI_Attribute_Delete
속성을 제거합니다.
GSErrCode ACAPI_Attribute_Delete (
const API_Attr_Head* attrHead
);
파라미터
- attrHead
- [in] 헤더의
typeID과index필드들이 제거할 속성을 식별합니다.
리턴 값
NoError- 함수가 성공적으로 완료되었습니다.
APIERR_BADPARS- 전달된 파라미터
(attrHead)가NULL입니다. APIERR_REFUSEDPAR- 펜, 글꼴, 솔리드 채우기, 빈 채우기, 또는 인덱스 1을 가진 속성을 제거하려고 시도했습니다.
APIERR_NOTMINE- 속성이 사용자 작업공간 밖에 있습니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 속성 헤더의 typeID와 index 필드에 의해 정의된 속성을 제거하는 데 사용합니다.
데이터베이스 안의 특정 속성들은 제거할 수 없습니다; 리턴 값들을 보십시오.
속성을 제거하는 것은 요소 데이터베이스에 어떤 변화도 주지 않는다는 것을 참고하십시오; 요소들은 누락된 속성을 참조할 것입니다. 이것은 문제가 되지 않습니다. 서버 애플리케이션들은 속성이 메뉴들에서 제거될 때 동일한 방식으로 작동합니다. 유일한 예외는 레이어 속성입니다. 어떤 레이어가 삭제되면, 거기에 있던 모든 요소들도 제거될 것입니다; 그 요소들이 어떤 데이터베이스에 있든지 상관이 없습니다. 주어진 레이어 상에 있는 요소들을 제거하기 위해 평면도와 모든 단면/입면들을 스캔하게 될 것입니다.
당신은 ACAPI_Attribute_DeleteMore 함수로 동일한 타입의 여러 속성들을 제거할 수 있습니다.
예제
API_Attribute attrib; BNZeroMemory (&attrib, sizeof (API_Attribute)); attrib.header.typeID = API_LinetypeID; attrib.header.index = 5; GSErrCode err = ACAPI_Attribute_Delete (&attrib.header);
요구사항
- 버전: API 1.3 또는 이후
- 헤더: ACAPinc.h
