ACAPI_Attribute_DeleteMore
동일한 타입의 여러 속성들을 제거합니다.
GSErrCode ACAPI_Attribute_DeleteMore (
const API_Attr_Head* attrHead,
short* attrIndexListPtr
);
파라미터
- attrHead
- [in] 헤더의
typeID필드들이 제거할 속성들의 타입을 식별합니다. - attrIndexListPtr
- [in] 제거할 속성 인덱스들의 리스트입니다.
리턴 값
NoError- 함수가 성공적으로 완료되었습니다.
APIERR_BADPARS- 전달된 파라미터
(attrHead)가NULL입니다. APIERR_REFUSEDPAR- 펜, 글꼴, 솔리드 채우기, 빈 채우기, 또는 인덱스 1을 가진 속성을 제거하려고 시도했습니다.
APIERR_NOTMINE- 속성이 사용자 작업공간 밖에 있습니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 ACAPI_Attribute_Delete의 확장형입니다.
당신은 제거할 속성 인덱스들의 리스트를 지정할 수 있습니다.
만약 attrIndexListPtr 파라미터에 NULL을 전달하면, 이 함수는 ACAPI_Attribute_Delete처럼 작동합니다.
예제
API_Attribute attrib;
BNZeroMemory (&attrib, sizeof (API_Attribute));
attrib.header.typeID = API_LinetypeID;
short* attrIndexListPtr = (short*) BMAllocatePtr (3 * sizeof (short), ALLOCATE_CLEAR, 0);
if (attrIndexListPtr != NULL) {
attrIndexListPtr[0] = 3;
attrIndexListPtr[1] = 4;
attrIndexListPtr[2] = 5;
GSErrCode err = ACAPI_Attribute_DeleteMore (&attrib.header, attrIndexListPtr);
if (err != NoError) {
// 속성들을 제거하는 것에 실패함
}
BMKillPtr ((GSPtr *) &attrIndexListPtr);
}
요구사항
- 버전: API 11 또는 이후
- 헤더: ACAPinc.h
