APIIo_GetPointID
포인트 입력을 수행합니다.
GSErrCode ACAPI_Interface ( APIIo_GetPointID, API_GetPointType* pointInfo, RubberLineInfoProc* rubberLineInfoProc, Get3DComponentProc* get3DComponentProc );
파라미터
- pointInfo
- [in/out] 포인트 입력 동작의 파라미터들입니다.
- rubberLineInfoProc
- [in] 커스텀 피드백 드로잉을 위한 콜백 함수입니다.
- get3DComponentProc
- [in] elem 정보들을 온라인으로 가져오기 위한 콜백 함수입니다. (실시간)
리턴 값
NoError
- 함수가 성공적으로 완료되었습니다.
APIERR_BADPARS
pointInfo
가 NULL입니다.APIERR_BADPLANE
pointInfo
안에 유효하지 않은 면 정의가 있습니다.APIERR_BADWINDOW
- 애플리케이션의 현재 전면 창에서 동작을 수행할 수 없습니다.
APIERR_CANCEL
- 입력이 사용자에 의해 취소되었습니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 사용자가 포인트 하나를 그래픽으로 입력시킬 때 사용합니다.
만약 입력 프로세스가 실패하면, 함수는 APIERR_CANCEL
을 리턴합니다.
그 외에는 결과가 pointInfo
의 pos
와 neig
필드에 리턴됩니다.
액션에 대한 설명을 포함할 수 있는 프롬프트 문자열이 컨트롤 상자에 표시됩니다. 당신은 neig들 위에서의 커서 중력과 커서 모양을 제어할 수 있고 입력 면을 세트할 수 있습니다. 포인터를 당신의 rubber line 콜백 함수에게 전달하여 입력 중에 그래픽 피드백을 그릴 수 있는 가능성이 있습니다. 활용에 대한 자세한 내용은 API_GetPointType structure의 문서를 참조하십시오.
Modal 다이얼로그들이 열려 있는 동안에는 어떤 입력 동작도 호출하지 마십시오.
예제
APIIo_GetArcID와 APIIo_DrawRubberLineID 함수의 예제를 보십시오.
요구사항
- 버전: API 2.1 또는 이후
- 헤더: APIdefs_Interface.h
참고사항
API_GetPointType,
RubberLineInfoProc, APIIo_DrawRubberLineID, APIIo_GetLineID, APIIo_GetArcID, APIIo_GetPolyID,
ACAPI_Interface, API 함수