APIDo_ZoomID

줌 동작을 수행합니다.

    GSErrCode ACAPI_Automate (
        APIDo_ZoomID,
        API_Box*      zoomBox,
        API_Rect*     zoomRect
    );

 

파라미터

zoomBox

[in] 줌인하고자 하는 박스입니다. (선택적인 파라미터이며 NULL일 수 있음)

zoomRect 

[in] 줌 직사각형입니다. (선택적인 파라미터이며 zoomBox의 대안입니다. NULL일 수 있음)

 

리턴 값

NoError

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

APIERR_NOPLAN

열린 프로젝트가 없습니다.

APIERR_BADDATABASE

활성 데이터베이스가 최상위 창이 아닙니다.

APIERR_BADPARS

전달된 zoomBox가 올바르지 않거나(빈 박스), zoomRect가 너무 작습니다.

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

 

설명

이 함수는 전면 창에서 줌 또는 Fit In Window 동작을 수행하고 그것을 Rebuild합니다.

만약 zoomBox 파라미터가 전달되면, 주어진 줌 요소가 설정될 것입니다. 또는 픽셀 좌표에서 줌을 정의하기 위해 직사각형을 전달할 수 있습니다. 만약 두 파라미터 모두 NULL이면, Fit In Window 커맨드가 실행될 것입니다.

데이터베이스를 Rebuild하지 않고 2D 드로잉 타입의 줌 박스를 세트하려면, APIDb_SetZoomID 데이터베이스 함수를 사용하십시오. APIDb_GetZoomID 함수로 2D 드로잉 타입 창의 현재 줌 박스를 가져올 수 있습니다.

  만약 최상위 창이 3D 모델 창이면, zoomRect 파라미터만 고려합니다. APIEnv_Get3DWindowSetsID 환경 함수로 현재 창 크기를 가져올 수 있습니다.

APIEnv_Change3DWindowSetsID 환경 함수로 3D 모델 창의 줌을 변경할 수도 있습니다.

 

예제

ACAPI_Automate (APIDo_ZoomID, NULL, NULL);  // Fit In Window

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Automate.h

 

참고사항

API_Box, API_Rect
APIDb_SetZoomID, APIDb_GetZoomID, APIDb_ReSetZoomID
APIEnv_Get3DWindowSetsID, APIEnv_Change3DWindowSetsID
ACAPI_Automate, API 함수