GetPath 함수(wingdi.h)

아티클
08/27/2023

GetPath 함수는 선의 엔드포인트를 정의하는 좌표와 지정된 디바이스 컨텍스트로 선택된 경로에 있는 곡선의 제어점을 검색합니다.

구문

int GetPath(
  [in]  HDC     hdc,
  [out] LPPOINT apt,
  [out] LPBYTE  aj,
  [in]  int     cpt
);

매개 변수

[in] hdc

닫힌 경로를 포함하는 디바이스 컨텍스트에 대한 핸들입니다.

[out] apt

선 엔드포인트 및 곡선 제어점을 논리적 좌표로 수신하는 POINT 구조체 배열에 대한 포인터입니다.

[out] aj

꼭짓점 형식을 수신하는 바이트 배열에 대한 포인터입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

형식	Description
PT_MOVETO	lpPoints 매개 변수의 해당 지점이 연결되지 않은 그림을 시작하게 지정합니다.
PT_LINETO	lpPoints의 이전 지점과 해당 지점이 줄의 엔드포인트임을 지정합니다.
PT_BEZIERTO	lpPoints의 해당 지점이 베지어 곡선의 제어점 또는 끝점이 되도록 지정합니다. PT_BEZIERTO 값은 항상 3 집합에서 발생합니다. 바로 앞에 있는 경로의 점은 베지어 곡선의 시작점을 정의합니다. 처음 두 PT_BEZIERTO 지점은 제어점이고, 세 번째 PT_BEZIERTO 지점은 끝점(하드 코드된 경우)입니다.

PT_LINETO 또는 PT_BEZIERTO 값은 비트 연산자 OR을 사용하여 다음 값과 결합하여 해당 지점이 그림의 마지막 지점이고 그림을 닫아야 함을 나타낼 수 있습니다.

플래그	설명
PT_CLOSEFIGURE	해당 선 또는 곡선을 그린 후 그림이 자동으로 닫히게 되도록 지정합니다. 이 그림은 선 또는 곡선 엔드포인트에서 마지막 PT_MOVETO 해당하는 지점으로 선을 그려 닫습니다.

[in] cpt

lpPoints에서 가리키는 배열에 저장할 수 있는 POINT 구조체의 총 수입니다. 이 값은 lpTypes가 가리키는 배열에 배치할 수 있는 바이트 수와 동일해야 합니다.

반환 값

nSize 매개 변수가 0이 아닌 경우 반환 값은 열거된 포인트 수입니다. nSize가 0이면 반환 값은 경로의 총 포인트 수이며 GetPath는 버퍼에 아무 것도 쓰지 않습니다. nSize가 0이 아니고 경로의 포인트 수보다 작은 경우 반환 값은 1입니다.

설명

hdc 매개 변수로 식별되는 디바이스 컨텍스트에는 닫힌 경로가 포함되어야 합니다.

경로의 점이 논리적 좌표로 반환됩니다. 지점은 디바이스 좌표의 경로에 저장되므로 GetPath 는 현재 변환의 역방향을 사용하여 디바이스 좌표에서 논리 좌표로 점을 변경합니다.

GetPath 전에 FlattenPath 함수를 호출하여 경로의 모든 곡선을 선 세그먼트로 변환할 수 있습니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll