GraphicsPathIterator::NextSubpath(constGraphicsPath*,BOOL*) metode (gdipluspath.h)

Metode GraphicsPathIterator::NextSubpath mendapatkan gambar berikutnya (subpath) dari jalur terkait iterator ini.

Sintaks

INT NextSubpath(
  [out] const GraphicsPath *path,
  [out] BOOL               *isClosed
);

Parameter

[out] path

Jenis: GraphicsPath*

Penunjuk ke objek GraphicsPath . Metode ini mengatur titik data objek GraphicsPath ini agar sesuai dengan titik data dari gambar yang diambil.

[out] isClosed

Jenis: BOOL*

Penunjuk ke BOOL yang menerima nilai yang menunjukkan apakah gambar yang diambil ditutup. Jika gambar ditutup, nilai yang diterima adalah TRUE; jika tidak, nilai yang diterima adalah FALSE.

Nilai kembali

Jenis: INT

Metode ini mengembalikan jumlah titik data dalam gambar yang diambil. Jika tidak ada lagi angka untuk diambil, metode ini mengembalikan 0.

Keterangan

Pertama kali Anda memanggil metode GraphicsPathIterator::NextSubpath dari iterator, metode ini mendapatkan gambar pertama (subpath) dari jalur terkait iterator tersebut. Kedua kalinya, ia mendapatkan angka kedua, dan sebagainya. Setiap kali Anda memanggil GraphicsPathIterator::NextSubpath, itu mengembalikan jumlah titik data dalam gambar yang diambil. Ketika tidak ada angka yang tersisa, ia mengembalikan 0.

Contoh

Contoh berikut membuat objek GraphicsPath dan menambahkan lima gambar (juga disebut subpath) ke jalur. Kode meneruskan alamat objek GraphicsPath ke konstruktor GraphicsPathIterator untuk membuat iterator yang terkait dengan jalur. Kode memanggil metode GraphicsPathIterator::NextSubpath iterator dua kali untuk mengambil gambar kedua (subpath) dari jalur. Kemudian kode memanggil metode DrawPath dari objek Grafis untuk menggambar subjalur individual tersebut.

VOID NextSubpathExample(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);

   // Get the second subpath by calling NextSubpath twice.
   GraphicsPath subpath;
   BOOL isClosed;
   INT count;
   count = iterator.NextSubpath(&subpath, &isClosed);
   count = iterator.NextSubpath(&subpath, &isClosed);

   // The variable "count" now holds the number of 
   // data points in the second subpath.

   // Draw the retrieved subpath.
   Pen bluePen(Color(255, 0, 0, 255));
   graphics.DrawPath(&bluePen, &subpath);
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdipluspath.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll

Lihat juga

Membuat dan Menggambar Jalur

GetPathData

GraphicsPath

GraphicsPathIterator

GraphicsPathIterator::GetSubpathCount

GraphicsPathIterator::Metode NextMarker

NextSubpath

Jalan