PolyDraw 함수(wingdi.h)

아티클
03/08/2023

PolyDraw 함수는 선 세그먼트 및 베지어 곡선 집합을 그립니다.

구문

BOOL PolyDraw(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const BYTE  *aj,
  [in] int         cpt
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] apt

각 선 세그먼트에 대한 엔드포인트와 각 Bézier 곡선의 엔드포인트 및 제어점을 논리적 단위로 포함하는 POINT 구조의 배열에 대한 포인터입니다.

[in] aj

lppt 배열의 각 지점을 사용하는 방법을 지정하는 배열에 대한 포인터입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

유형	의미
PT_MOVETO	이 점이 연결되지 않은 그림을 시작하게 지정합니다. 이 점은 새로운 현재 위치가 됩니다.
PT_LINETO	현재 위치에서 이 지점까지 선이 그려지도록 지정합니다. 그러면 새 현재 위치가 됩니다.
PT_BEZIERTO	이 점이 베지어 곡선의 제어점 또는 끝점임을 지정합니다. PT_BEZIERTO 형식은 항상 3 집합에서 발생합니다. 현재 위치는 베지어 곡선의 시작점을 정의합니다. 처음 두 PT_BEZIERTO 지점은 제어점이고 세 번째 PT_BEZIERTO 지점은 끝점입니다. 끝점은 새 현재 위치가 됩니다. 연속 PT_BEZIERTO 지점이 3개 없는 경우 오류가 발생합니다.

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

값	의미
PT_CLOSEFIGURE	이 지점에 대한 PT_LINETO 또는 PT_BEZIERTO 형식이 완료된 후 그림이 자동으로 닫히게 되도록 지정합니다. 이 지점에서 가장 최근 PT_MOVETO 또는 MoveToEx 지점까지 선이 그려집니다. 이 값은 비트 연산자 OR을 사용하여 선의 PT_LINETO 형식 또는 Bézier 곡선에 대한 끝점의 PT_BEZIERTO 형식과 결합됩니다. 현재 위치는 닫는 줄의 끝점으로 설정됩니다.

값

의미

PT_CLOSEFIGURE

이 지점에 대한 PT_LINETO 또는 PT_BEZIERTO 형식이 완료된 후 그림이 자동으로 닫히게 되도록 지정합니다. 이 지점에서 가장 최근 PT_MOVETO 또는 MoveToEx 지점까지 선이 그려집니다.

이 값은 비트 연산자 OR을 사용하여 선의 PT_LINETO 형식 또는 Bézier 곡선에 대한 끝점의 PT_BEZIERTO 형식과 결합됩니다.

현재 위치는 닫는 줄의 끝점으로 설정됩니다.

[in] cpt

lpbTypes 배열의 바이트 수와 동일한 lppt 배열의 총 포인트 수입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

설명

PolyDraw 함수는 MoveToEx, LineTo 및 PolyBezierTo 함수에 대한 연속 호출 대신 사용할 수 있습니다. 선과 곡선은 현재 펜을 사용하여 그려지고 그림은 채워지지 않습니다. BeginPath를 호출하여 시작된 활성 경로가 있는 경우 PolyDraw는 경로에 를 추가합니다.

lppt 배열 및 lpbTypes 배열에 포함된 점은 각 점이 MoveTo, LineTo 또는 PolyBezierTo 작업의 일부인지 여부를 나타냅니다. 수치를 닫을 수도 있습니다.

이 함수는 현재 위치를 업데이트합니다.

요구 사항


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