ACAPI_Element_SolidLink_Create

새로운 Solid Operation Link를 정의합니다.

    GSErrCode  ACAPI_Element_SolidLink_Create (
        API_Guid                 guid_Target,
        API_Guid                 guid_Operator,
        API_SolidOperationID     operation,
        GSFlags                  linkFlags
    );

 

파라미터

guid_Target 

[in] 대상 요소를 식별합니다.

guid_Operator 

[in] 연산자 요소를 식별합니다.

operation

[in] 연산 타입입니다.

linkFlags

[in] Linking 옵션입니다. (ACAPI_Element_SolidLink_GetFlags를 보십시오)

 

리턴 값

NoError

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

APIERR_REFUSEDCMD

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

APIERR_BADDATABASE, APIERR_NOTMINE

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

APIERR_BADINDEX

전달된 ID들 중 하나 또는 둘이 유효하지 않습니다. 또는 두 ID가 동일합니다.

APIERR_BADPARS

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

APIERR_REFUSEDPAR

핫링크된 요소들을 함께 링크하는 것은 허용되지 않습니다.

APIERR_LINKEXIST

요소들이 이미 서로 링크되어 있습니다.

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

 

설명

이 함수는 두 건설 요소들 간의 새로운 Solid Operation Link를 정의합니다.

 

예제

처음 벽으로부터 처음 슬래브를 빼면, 새로운 표면들이 슬래브의 속성들을 상속합니다:

GSErrCode SolidLink (const API_Guid& guidTarget, const API_Guid& guid_Operator)
{
    GSErrCode err;

    err = ACAPI_OpenUndoableSession ("Substract Slab from Wall");

    if (err == NoError) {
        err = ACAPI_Element_SolidLink_Create (guid_Target, guid_Operator, APISolid_Substract, APISolidFlag_OperatorAttrib);
        if (err == APIERR_LINKEXIST)
            ACAPI_WriteReport ("Solid Link already exists between the elements", true);
        else if (err != NoError)
            ACAPI_WriteReport ("ACAPI_Element_SolidLink_Create has failed", true);
    }

    ACAPI_CloseUndoableSession ();

    return err;
}

 

요구사항

버전: API 4.2 또는 이후

헤더: ACAPinc.h

 

참고사항

API_SolidOperationID
ACAPI_Element_SolidLink_Remove
ACAPI_Element_SolidLink_GetTime
ACAPI_Element_SolidLink_GetOperation
ACAPI_Element_SolidLink_GetFlags
ACAPI_Element_SolidLink_GetTargets
ACAPI_Element_SolidLink_GetOperators
API 함수