ACAPI_ElementGroup_Create

요소 그룹을 생성합니다.

    GSErrCode  ACAPI_ElementGroup_Create (
        const GS::Array<API_Guid>&    elemGuids,
        API_Guid*                     groupGuid = NULL,
        const API_Guid*               parentGroupGuid = NULL
    );

 

파라미터

elemGuids 

[in] 그룹화할 요소들의 유일 ID들의 배열입니다.

groupGuid 

[out] 새로 생성된 그룹의 유일 ID입니다.

parentGroupGuid 

[in] 새로 생성된 그룹의 부모 그룹의 유일 ID를 설정하기 위한 선택적인 파라미터입니다. (이것으로 그룹 트리를 만들 수 있음)

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다. 새로운 요소 그룹이 생성되었습니다.

APIERR_REFUSEDCMD

함수는 반드시 undoable이어야 합니다. 열린 undoable session이 없습니다.

APIERR_BADID

1개 이상의 전달된 ID들이 유효하지 않습니다.

APIERR_BADPARS

유효하지 않은 값이 파라미터들에게 전달되었습니다. (NULL 포인트, 빈 ID 리스트, 등)

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

 

설명

이 함수는 간단한 요소 그룹을 생성합니다. 이것은 단지 일부 요소들의 컨테이너에 불과합니다. 전달된 요소들은 동일한 층에 있어야 합니다.

 

요구사항

버전: API 18 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_ElementGroup_SetUserData
ACAPI_ElementGroup_GetUserData
ACAPI_ElementGroup_GetGroup
ACAPI_ElementGroup_GetRootGroup
ACAPI_ElementGroup_GetGroupedElems
ACAPI_ElementGroup_GetAllGroupedElems
API 함수