ACAPI_Element_GetQuantities

요소의 수량 파라미터들의 정보를 리턴합니다.

    GSErrCode  ACAPI_Element_GetQuantities (
        API_Guid                   elemGuid,
        const API_QuantityPar*     params,
        API_Quantities*            quantities,
        const API_Quantity*        mask
    );

 

파라미터

elemGuid

[in] 요소의 guid입니다.

params

[in] 입력 파라미터들입니다.

quantities

[Out] 선택적인 수량 파라미터들입니다.

mask

[In] quantities의 관련 필드들을 마스킹하기 위한 선택적인 파라미터입니다. (기본적으로 NULL입니다)
성능을 향상시키기 위해 mask 파라미터로 필요한 데이터를 선택할 수 있습니다. 이 기능은 필수 데이터에 대한 필터링된 접근을 제공합니다; 함수는 모든 데이터를 변환하는 대신 관심 있는 것들만 리턴합니다.

 

리턴 값

NoError

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

APIERR_BADPARS

quantities가 NULL입니다.

APIERR_BADID

올바르지 않은 elemGuid를 지정했습니다.

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

 

설명

이 함수는 요소의 수량 파라미터들을 가져오는 데 사용합니다. 수량들은 다음과 같습니다: 표면(면적), 부피, 둘레, 길이, 그 외 여러 가지 파라미터들입니다. 이것은 모든 건설 요소들에게 적용됩니다.

예제

API_Quantity      quantity, mask;
API_Quantities    quantities;
API_QuantityPar   params;
char              s[256] = { '\0' };
GSErrCode         err;

ACAPI_ELEMENT_QUANTITY_MASK_CLEAR (mask);
ACAPI_ELEMENT_QUANTITY_MASK_SET (mask, wall, surface1);
ACAPI_ELEMENT_QUANTITY_MASK_SET (mask, wall, volume);

quantities.quantityData = &quantity;
params.minOpeningSize = EPS;
err = ACAPI_Element_GetQuantities (elemGuid, &params, &quantities, &mask);
if (!err) {
    sprintf (s, "surface1: %.2lf  volume: %.2lf", quantity.wall.surface1, quantity.wall.volume);
    ACAPI_WriteReport (s, true);
}

 

요구사항

버전: API 15.0 또는 이후

헤더: ACAPinc.h

 

참고사항

API_ElemTypeID, API_QuantityPar, API_CWallComponent,
요소 관리자, API 함수,
API_CompositeQuantity, API_ElemPartQuantity, API_ElemPartCompositeQuantity,
API_BeamQuantity, API_WallQuantity, API_ColumnQuantity, API_WindowQuantity, API_DoorQuantity, API_SkylightQuantity, API_ObjectQuantity, API_LightQuantity, API_SlabQuantity, API_RoofQuantity, API_MeshQuantity, API_ZoneAllQuantity, API_HatchQuantity, API_CurtainWallQuantity, API_CWFrameQuantity, API_CWPanelQuantity, API_CWJunctionQuantity, API_CWAccessoryQuantity, API_ShellQuantity, API_MorphQuantity