APIIo_GetLineID

라인 입력을 수행합니다.

    GSErrCode ACAPI_Interface (
        APIIo_GetLineID,
        API_GetLineType*        lineInfo,
        RubberLineInfoProc*     rubberLineInfoProc
    );

 

파라미터

lineInfo

[in/out] 라인 입력 동작의 파라미터들입니다.

rubberLineInfoProc

[in] 커스텀 피드백 드로잉에 대한 콜백 함수입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

lineInfo가 NULL입니다.

APIERR_BADPLANE

lineInfo 안에 유효하지 않은 평면 정의가 있습니다.

APIERR_BADWINDOW

애플리케이션의 현재 전면 창에서 동작을 수행할 수 없습니다.

APIERR_CANCEL

사용자가 입력을 취소했습니다.

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

 

설명

이 함수는 사용자에게 라인을 그래픽으로 입력하도록 시키는 데 사용합니다.

만약 입력 프로세스가 실패하면, 이 함수는 APIERR_CANCEL을 리턴합니다. 그 외에는 결과가 lineInfo의 필드들 안에 리턴됩니다; pos와 neig.

라인의 시작점을 직접 정의할 수 있습니다. 또는 APIIo_GetPointID 인터페이스 함수를 이용하여 그래픽으로 입력할 수도 있습니다.

컨트롤 박스에 표시되는 프롬프트 문자열은 액션에 대한 지시사항들을 포함할 수 있습니다. 당신은 neig들 위의 커서 중력(gravity)와 커서 형태를 제어할 수 있고 입력 평면을 세트할 수 있습니다. 포인터를 당신의 rubber line 콜백 함수에 전달함으로써 입력하는 동안 고유의 그래픽 피드백을 그릴 수 있는 가능성이 있습니다. 활용에 대한 더 자세한 것들은 API_GetLineType structure의 문서를 참조하십시오.

모달 다이얼로그들이 열려 있는 동안 어떤 입력 동작이라도 호출하지 마십시오.

 

예제

APIIo_GetArcID와 APIIo_DrawRubberLineID 함수들의 예제들을 보십시오.

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Interface.h

 

참고사항

API_GetLineType,
RubberLineInfoProc, APIIo_DrawRubberLineID, APIIo_GetPointID, APIIo_GetArcID, APIIo_GetPolyID,
ACAPI_Interface, API 함수