GraphicsPathIterator::NextMarker(INT,INT) 메서드(gdipluspath.h)

아티클
08/24/2023

GraphicsPathIterator::NextMarker 메서드는 이 반복기의 연결된 경로에 있는 다음 표식으로 구분된 섹션의 시작 인덱스와 끝 인덱스를 가져옵니다.

구문

INT NextMarker(
  INT *startIndex,
  INT *endIndex
);

매개 변수

startIndex

시작 인덱스를 수신하는 INT 에 대한 포인터입니다.

endIndex

끝 인덱스를 수신하는 INT 에 대한 포인터입니다.

반환 값

이 메서드는 검색된 섹션의 데이터 포인트 수를 반환합니다. 검색할 표식으로 구분된 섹션이 더 이상 없으면 이 메서드는 0을 반환합니다.

설명

경로에는 선과 곡선을 정의하는 데이터 요소의 배열이 있습니다. 경로의 SetMarker 메서드를 호출하여 배열의 특정 지점을 표식으로 지정할 수 있습니다. 이러한 표식 지점은 경로를 섹션으로 나눕니다.

반복 기의 GraphicsPathIterator::NextMarker 메서드를 처음 호출할 때 해당 반복기의 연결된 경로에 대한 첫 번째 표식으로 구분된 섹션을 가져옵니다. 두 번째로 두 번째 섹션을 가져옵니다. GraphicsPathIterator::NextSubpath를 호출할 때마다 검색된 섹션의 데이터 요소 수를 반환합니다. 남은 섹션이 없으면 0을 반환합니다.

예제

다음 예제에서는 GraphicsPath 개체를 만들고 경로에 5개의 그림을 추가합니다. SetMarker 메서드에 대한 호출은 경로에 두 개의 마커를 배치합니다. 첫 번째 표식은 그림의 끝에 있고 두 번째 표식은 그림의 중간에 있습니다. 이 코드는 GraphicsPath 개체의 주소를 GraphicsPathIterator 생성자에 전달하여 경로와 연결된 반복기를 만듭니다. 그런 다음, 코드는 반복기의 GraphicsPathIterator::NextMarker 메서드를 두 번 호출하여 경로의 두 번째 표식으로 구분된 섹션의 시작 및 끝 인덱스를 가져옵니다. 마지막으로 코드는 경로의 두 번째 표식으로 구분된 섹션에 속하는 데이터 요소를 그립니다.

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

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

   path.AddRectangle(Rect(20, 20, 60, 30));

   path.SetMarker();                          // first marker
   path.AddLine(100, 20, 160, 50);
   path.AddArc(180, 20, 60, 30, 0, 180);

   path.AddRectangle(Rect(260, 20, 60, 30));
   path.AddLine(340, 20, 400, 50);
   path.SetMarker();                          // second marker
   path.AddArc(340, 20, 60, 30, 0, 180);
   path.CloseFigure();
  
   path.AddRectangle(Rect(420, 20, 60, 30));

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

   // Get the second marker-delimited section by calling NextMarker twice.
   INT start;
   INT end;
   INT count;
   count = iterator.NextMarker(&start, &end);
   count = iterator.NextMarker(&start, &end);

   // Get the data points of the second marker-delimited section.
   PointF* points = new PointF[count];
   BYTE* types = new BYTE[count];
   iterator.CopyData(points, types, start, end);

   // Draw the data points of the second marker-delimited section.
   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;
}