GraphicsPathIterator：：NextSubpath (INT，INT，BOOL*) 方法 (gdipluspath.h)

项目
08/24/2023

GraphicsPathIterator：：NextSubpath 方法获取此迭代器关联路径中) (下一个子路径的起始索引和结束索引。

语法

INT NextSubpath(
  INT  *startIndex,
  INT  *endIndex,
  BOOL *isClosed
);

parameters

startIndex

指向接收起始索引的 INT 的指针。

endIndex

指向接收结束索引的 INT 的指针。

isClosed

指向 BOOL 的指针，该 BOOL 接收一个值，该值指示获取的数字是否关闭。如果数字关闭，则收到的值为 TRUE;否则，收到的值为 FALSE。

返回值

此方法返回下一图中的数据点数。如果路径中没有更多数字，则此方法返回 0。

注解

首次调用迭代 器的 GraphicsPathIterator：：NextSubpath 方法时，它会获取该迭代器关联路径) 第一个图形 (子路径的索引。第二次，它获取第二个数字的索引，依此进行。每次调用 GraphicsPathIterator：：NextSubpath 时，它都会返回检索其索引的图中的数据点数。如果没有剩余数字，则返回 0。

示例

以下示例创建一个 GraphicsPath 对象，并将五个图形添加到路径。代码将该 GraphicsPath 对象的地址传递给 GraphicsPathIterator 构造函数，以创建与路径关联的迭代器。代码调用迭代器的 GraphicsPathIterator：：NextSubpath 方法三次，以获取路径第三个图形的起始索引和结束索引。然后，代码调用迭代器的 GraphicsPathIterator：：CopyData 方法来检索第三个图形的数据点。

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

   // Create a graphics path with five figures (subpaths).
   GraphicsPath path;

   path.AddRectangle(Rect(20, 20, 60, 30));   // Subpath count is 1.

   path.AddLine(100, 20, 160, 50);            // Subpath count is 2.
   path.AddArc(180, 20, 60, 30, 0.0f, 180.0f);

   path.AddRectangle(Rect(260, 20, 60, 30));  // Subpath count is 3.

   path.AddLine(340, 20, 400, 50);            // Subpath count is 4.
   path.AddArc(340, 20, 60, 30, 0.0f, 180.0f);
   path.CloseFigure();
  
   path.AddRectangle(Rect(420, 20, 60, 30));  // Subpath count is 5.

   // Create an iterator, and associate it with the path.
   GraphicsPathIterator iterator(&path);

   // Call NextSubpath three times to get the starting and ending
   // indices for the third figure.
   INT start;
   INT end;
   BOOL isClosed;
   INT count;
   count = iterator.NextSubpath(&start, &end, &isClosed);
   count = iterator.NextSubpath(&start, &end, &isClosed);
   count = iterator.NextSubpath(&start, &end, &isClosed);

   // Get the third figure's data points.
   PointF* points = new PointF[count];
   BYTE* types = new BYTE[count];
   iterator.CopyData(points, types, start, end);

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

   delete points;
   delete types;
}