ACAPI_Element_GetMoreQuantities  

동일한 타입의 여러 요소들의 수량 파라미터들의 정보를 리턴합니다.

    GSErrCode  ACAPI_Element_GetMoreQuantities (
        const GS::Array<API_Guid>*     elemGuids,
        const API_QuantityPar*         params,
        GS::Array<API_Quantities>*     quantities,
        const API_Quantity*            mask
    );

 

파라미터

elemGuids

[in] 요소들의 guid들입니다.

params

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

quantities

[Out] 선택적인 수량 파라미터들입니다. 각 guid마다 배열 중 하나에 들어 있습니다.
API_Quantities의 멤버 포인터들은 동일한 패턴으로 채워져야 합니다.

mask

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

 

리턴 값

NoError

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

APIERR_BADPARS

quantities가 NULL이거나 quantities가 elemGuids와 동일한 크기가 아닙니다.

APIERR_BADID

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

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

 

설명

이 함수는 동일한 타입의 여러 요소들의 수량 파라미터들을 가져오는 데 사용합니다. 수량들은 다음과 같습니다: 표면(면적), 부피, 둘레, 길이, 그 외 여러 가지 파라미터들입니다. 이것은 모든 건설 요소들에게 적용됩니다. elemGuids와 quantities 배열들은 동일한 크기를 갖고 있어야 합니다.

예제

API_Quantity              quantity, mask;
GS::Array<API_Quantities> quantities;
GS::Array<API_Guid>       elemGuids;
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.SetSize (1);
quantities[0].quantityData = &quantity;
elemGuids.Push (elemGuid);
params.minOpeningSize = EPS;
err = ACAPI_Element_GetMoreQuantities (&elemGuids, &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