ACAPI_Element_GetDefaults

요소에 대한 실제 기본값 설정들을 가져옵니다.

    GSErrCode  ACAPI_Element_GetDefaults (
        API_Element*         element,
        API_ElementMemo*     memo
    );

 

파라미터

element

[in/out] 기본값이 필요한 요소입니다.

memo

[out] 이것은 라이브러리 파트 기반 요소들의 경우에만 필요합니다. (구역 스탬프 포함)

 

리턴 값

NoError

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

APIERR_BADPARS

전달된 파라미터가 NULL입니다; element

APIERR_BADID

요소 타입이 유효하지 않습니다. 또는
요소 타입이 서버 애플리케이션에 의해 지원되지 않습니다.

APIERR_REFUSEDCMD

요소 타입이 동작에 유효한 대상이 아닙니다; API_SectElemID

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

 

설명

이 함수는 하나의 요소에 대한 실제 기본 설정들을 가져오는 데 사용합니다.

요청한 타입은 헤더의 typeID와 variationID 필드로 식별합니다. 함수는 API_Element structure의 중심 부분을 Settings 다이얼로그로부터 가져온 값들로 채웁니다. 당신이 필요하다면 기하 정보 정도는 직접 채우셔야 합니다.

memo 파라미터는 라이브러리 파트 기반 요소들에 대해서만 사용합니다. (구역 스탬프 포함) 이 때 params 필드는 참조된 라이브러리 파트의 실제 파라미터 값들로 채워집니다. 획득한 핸들들을 폐기하려면 ACAPI_DisposeElemMemoHdls 함수를 호출하는 것을 잊지 마십시오.

기본 설정 값들을 변경하려면 ACAPI_Element_ChangeDefaults 함수를 사용하십시오.

당신은 새로운 인스턴스를 만들기 위해 리턴된 값들을 이용하여 요소 속성들과 파라미터들을 초기화할 수 있습니다. 더 자세한 것은 ACAPI_Element_Create 함수를 참조하십시오.

마커가 붙은 요소 타입(API_WindowType, API_DoorType, API_CutPlaneType, API_ChangeMarkerType, API_DetailType 그리고 API_WorksheetType)들의 기본 설정값들을 가져오기 위해 ACAPI_Element_GetDefaultsExt 함수를 대신 사용하십시오.

 

예제

API_Element     element;
API_ElementMemo memo;
GSErrCode       err;

BNZeroMemory (&element, sizeof (API_Element));
BNZeroMemory (&memo, sizeof (API_ElementMemo));

element.header.typeID = API_ObjectID;
element.header.variationID = APIVarId_SymbStair;
err = ACAPI_Element_GetDefaults (&element, &memo);
if (err == NoError) {
    /* 하고 싶은 작업 */
}

ACAPI_DisposeElemMemoHdls (&memo);

 

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

 

참고사항

API_Element, API_ElementMemo
ACAPI_Element_ChangeDefaults, ACAPI_Element_Create, ACAPI_DisposeElemMemoHdls
ACAPI_Element_GetDefaultsExt, ACAPI_Element_ChangeDefaultsExt
요소 관리자, API 함수