Método GraphicsPath::GetPathPoints(PointF*,INT) (gdipluspath.h)

Artículo
02/26/2024

El método GraphicsPath::GetPathPoints obtiene la matriz de puntos de esta ruta de acceso. La matriz contiene los puntos de conexión y los puntos de control de las líneas y splines bézier que se usan para dibujar la ruta de acceso.

Sintaxis

Status GetPathPoints(
  PointF *points,
  INT    count
);

Parámetros

points

Puntero a una matriz de objetos PointF que recibe los puntos de datos. Debe asignar memoria para esta matriz. Puede llamar al método GraphicsPath::GetPointCount para determinar el tamaño necesario de la matriz. El tamaño, en bytes, debe ser el valor devuelto de GraphicsPath::GetPointCount multiplicado por sizeof(PointF).

count

Entero que especifica el número de elementos de la matriz de puntos. Establezca este parámetro igual al valor devuelto del método GraphicsPath::GetPointCount .

Valor devuelto

Type:Status

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

Un objeto GraphicsPath tiene una matriz de puntos y una matriz de tipos. Cada elemento de la matriz de tipos es un byte que especifica el tipo de punto y un conjunto de marcas para el elemento correspondiente en la matriz de puntos. Los posibles tipos y marcas de punto se muestran en la enumeración PathPointType.

Ejemplos

En el ejemplo siguiente se crea y dibuja una ruta de acceso que tiene una línea, un rectángulo, una elipse y una curva. El código llama al método GraphicsPath::GetPointCount de la ruta de acceso para determinar el número de puntos de datos almacenados en la ruta de acceso. El código asigna un búfer lo suficientemente grande como para recibir la matriz de puntos de datos y pasa la dirección de ese búfer al método GraphicsPath::GetPathPoints . Por último, el código dibuja cada uno de los puntos de datos de la ruta de acceso.

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

   // Create a path that has a line, a rectangle, an ellipse, and a curve.
   GraphicsPath path;

   PointF points[] = {
      PointF(200, 200),
      PointF(250, 240),
      PointF(200, 300),
      PointF(300, 310),
      PointF(250, 350)};

   path.AddLine(20, 100, 150, 200);
   path.AddRectangle(Rect(40, 30, 80, 60));
   path.AddEllipse(Rect(200, 30, 200, 100));
   path.AddCurve(points, 5);

   // Draw the path.
   Pen pen(Color(255, 0, 0, 255));
   graphics.DrawPath(&pen, &path);

   // Get the path points.
   INT count = path.GetPointCount();
   PointF* dataPoints = new PointF[count];  
   path.GetPathPoints(dataPoints, count);

   // Draw the path's data points.
   SolidBrush brush(Color(255, 255, 0, 0));
   for(INT j = 0; j < count; ++j)
   {
      graphics.FillEllipse(
         &brush, 
         dataPoints[j].X - 3.0f, 
         dataPoints[j].Y - 3.0f,
         6.0f,
         6.0f);
   }
   delete [] dataPoints; 
}
Color(255, 255, 0,  0)