AngleArc 함수(wingdi.h)

아티클
03/04/2024

AngleArc 함수는 선 세그먼트와 호를 그립니다. 선 세그먼트는 현재 위치에서 호의 시작 부분으로 그려집니다. 원의 경계를 따라 호가 그려지고 지정된 반지름과 가운데가 그려집니다. 호 길이는 지정된 시작 및 스윕 각도에 의해 정의됩니다.

구문

BOOL AngleArc(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] DWORD r,
  [in] FLOAT StartAngle,
  [in] FLOAT SweepAngle
);

매개 변수

[in] hdc

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

[in] x

원 가운데의 x 좌표를 논리 단위로 지정합니다.

[in] y

원 가운데의 y 좌표를 논리 단위로 지정합니다.

[in] r

원의 반경(논리 단위)을 지정합니다. 이 값은 양수여야 합니다.

[in] StartAngle

x축을 기준으로 시작 각도를 도 단위로 지정합니다.

[in] SweepAngle

시작 각도를 기준으로 스윕 각도를 도 단위로 지정합니다.

반환 값

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

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

설명

AngleArc 함수는 현재 위치를 호의 끝점으로 이동합니다.

이 함수에서 그린 호는 현재 변환 및 매핑 모드에 따라 타원형으로 보일 수 있습니다. 호를 그리기 전에 AngleArc 는 현재 위치에서 호의 시작 부분으로 선 세그먼트를 그립니다.

호는 지정된 반경을 사용하여 지정된 중심점 주위에 가상 원을 생성하여 그려집니다. 원의 시작점은 원의 x축에서 시작 각도의 각도 수만큼 시계 반대 방향으로 측정하여 결정됩니다. 끝점은 마찬가지로 스윕 각도의 각도 수로 시작점에서 시계 반대 방향으로 측정하여 배치됩니다.

스윕 각도가 360도보다 크면 호가 여러 번 스윕됩니다.

이 함수는 현재 펜을 사용하여 선을 그립니다. 그림이 채워지지 않았습니다.

예제

예제는 원형 차트 그리기를 참조하세요.

요구 사항

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