Graphics::D rawPie(constPen*,constRect&,REAL,REAL) (gdiplusgraphics.h)

El método Graphics::D rawPie dibuja un gráfico circular.

Sintaxis

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

Parámetros

[in] pen

Tipo: const Pen*

Puntero a un lápiz que se usa para dibujar el gráfico circular.

[in, ref] rect

Tipo: const Rect

Referencia a un rectángulo que enlaza la elipse en la que se va a dibujar el gráfico circular.

[in] startAngle

Tipo: REAL

Número real que especifica el ángulo, en grados, entre el eje x y el punto inicial del arco que define el gráfico circular. Un valor positivo especifica la rotación en sentido de las agujas del reloj.

[in] sweepAngle

Tipo: REAL

Número real que especifica el ángulo, en grados, entre los puntos inicial y final del arco que define el circular. Un valor positivo especifica la rotación en sentido de las agujas del reloj.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

En la ilustración siguiente se muestra el gráfico circular que se dibuja en la elipse que está limitada por el rectángulo. La ilustración también muestra el eje horizontal de la elipse y la dirección del startAngle y el sweepAngle.

Ilustración en la que se muestra una elipse con un gráfico circular; el ángulo inicial y el ángulo de barrido están etiquetados

Ejemplos

En el ejemplo siguiente se dibuja un gráfico circular.


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);
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado gdiplusgraphics.h (include Gdiplus.h)
Library Gdiplus.lib
Archivo DLL Gdiplus.dll

Consulte también

Métodos DrawLines

Métodos FillPie

Elementos gráficos

Curvas abiertas y cerradas

Rect