ACAPI_Element_Merge_GetMergedElements

배열 안에 주어진 요소의 합병된 요소들을 가져옵니다.

    GSErrCode  ACAPI_Element_GetMergedElements (
        const API_Guid&          guid_Element,
        GS::Array<API_Guid>*     guid_MergedElements
    );

 

파라미터

guid_Element

[in] 요소 GUID입니다.

guid_MergedElements

[out] 주어진 요소와 함께 합병된 요소들의 GUID들의 배열입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADDATABASE, APIERR_NOTMINE

함수가 현재 데이터베이스에서 작동할 수 없습니다.

APIERR_BADINDEX

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

APIERR_BADPARS

유효하지 않은 값이 guid_Element 파라미터에 전달되었습니다.

APIERR_BADELEMENTTYPE

주어진 요소가 건설 요소가 아닙니다.

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

 

설명

이 함수는 주어진 요소와 함께 합병된 요소들을 가져옵니다.

 

예제

GSErrCode Do_GetMergedElements (const API_Guid& guid_Element)
{
    GSErrCode           err = NoError;
    GS::Array<API_Guid> guid_MergedElements;

    err = ACAPI_Element_Merge_GetMergedElements (guid_Element, &guid_MergedElements);
    if (err != NoError)
        return err;
    for (UIndex i = 0; i < guid_MergedElements.GetSize (); i++) {
        char    str[256];
        sprintf (str, "  Element: %s  is merged with Element: %s",
                    (const char *) APIGuid2GSGuid (guid_Element).ToUniString ().ToCStr (),
                    (const char *) APIGuid2GSGuid (guid_MergedElements [i]).ToUniString ().ToCStr ());
        WriteReport (str);
    }

    return err;
}

 

요구사항

버전: API 18 또는 이후

헤더: ACAPinc.h

 

참고사항

ACAPI_Element_Merge_Elements
ACAPI_Element_Merge_Remove
API 함수