Метод Graphics::D rawPie(constPen*,constRect&,REAL,REAL) (gdiplusgraphics.h)

Статья
02/27/2024

Метод Graphics::D rawPie рисует круговую диаграмму.

Синтаксис

Status DrawPie(
  [in]      const Pen    *pen,
  [in, ref] const Rect & rect,
  [in]      REAL         startAngle,
  [in]      REAL         sweepAngle
);

Параметры

[in] pen

Тип: константное перо*

Указатель на перо, используемое для рисования круговой диаграммы.

[in, ref] rect

Тип: const Rect

Ссылка на прямоугольник, ограничивающий эллипс, в котором рисуется круговая диаграмма.

[in] startAngle

Тип: REAL

Реальное число, указывающее угол в градусах между осью X и начальной точкой дуги, определяющей круговую диаграмму. Положительное значение указывает поворот по часовой стрелке.

[in] sweepAngle

Тип: REAL

Реальное число, указывающее угол в градусах между начальной и конечной точками дуги, определяющей круговую диаграмму. Положительное значение указывает поворот по часовой стрелке.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

На следующем рисунке показана круговая диаграмма, нарисованная на эллипсе, ограниченном прямоугольником. На рисунке также показана горизонтальная ось эллипса и направление startAngle и sweepAngle.

Иллюстрация, показывающая эллипс с контурной круговой диаграммой; начальный угол и угол очистки помечены

Примеры

В следующем примере рисуется круговая диаграмма.


VOID Example_DrawPie(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Pen object.
   Pen blackPen(Color(255, 0, 0, 0), 3);

   // Define the pie.
   Rect ellipseRect(0, 0, 200, 100);
   REAL startAngle = 0.0f;
   REAL sweepAngle = 45.0f;

   // Draw the pie.
   graphics.DrawPie(&blackPen, ellipseRect, startAngle, sweepAngle);
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusgraphics.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll