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

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

Синтаксис

Status DrawPie(
  [in] const Pen *pen,
  [in] INT       x,
  [in] INT       y,
  [in] INT       width,
  [in] INT       height,
  [in] REAL      startAngle,
  [in] REAL      sweepAngle
);

Параметры

[in] pen

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

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

[in] x

Тип: INT

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

[in] y

Тип: INT

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

[in] width

Тип: INT

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

[in] height

Тип: INT

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

[in] startAngle

Тип: REAL

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

[in] sweepAngle

Тип: REAL

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

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

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

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

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

Комментарии

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

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

Примеры

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


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

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

   // Define the pie.
   int x = 0;
   int y = 0;
   int width = 200;
   int height = 100;
   REAL startAngle = 0.0f;
   REAL sweepAngle = 45.0f;

   // Draw the pie.
   graphics.DrawPie(&blackPen, x, y, width, height, startAngle, sweepAngle);
}

Требования

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

См. также раздел

Методы FillPie

Графика

Незамкнутые и замкнутые кривые

Rect