GraphicsPathIterator::Metode CopyData (gdipluspath.h)

Artikel
08/24/2023

Metode GraphicsPathIterator::CopyData menyalin subset titik data jalur ke array PointF dan menyalin subset jenis titik jalur ke array BYTE .

Sintaks

INT CopyData(
  [out] PointF *points,
  [out] BYTE   *types,
  [in]  INT    startIndex,
  [in]  INT    endIndex
);

Parameter

[out] points

Jenis: PointF*

Penunjuk ke array yang menerima subset titik data jalur.

[out] types

Jenis: BYTE*

Penunjuk ke array yang menerima subset dari jenis titik jalur.

[in] startIndex

Jenis: INT

Bilangan bulat yang menentukan indeks awal titik dan jenis yang akan disalin.

[in] endIndex

Jenis: INT

Bilangan bulat yang menentukan indeks akhir titik dan jenis yang akan disalin.

Nilai kembali

Jenis: INT

Metode ini mengembalikan jumlah titik yang disalin. Ini sama dengan jumlah jenis yang disalin.

Keterangan

Objek GraphicsPathIterator ini dikaitkan dengan objek GraphicsPath . Objek GraphicsPath tersebut memiliki array titik dan array jenis. Setiap elemen dalam array jenis adalah byte yang menentukan jenis titik dan sekumpulan bendera untuk elemen yang sesuai dalam array titik. Kemungkinan jenis titik dan bendera tercantum dalam enumerasi PathPointType .

Anda dapat memanggil metode GraphicsPathIterator::GetCount untuk menentukan jumlah titik data di jalur.

Contoh

Contoh berikut membuat objek GraphicsPath dan menambahkan tiga baris ke jalur. Kode membuat objek GraphicsPathIterator> dan memanggil metode GraphicsPathIterator::CopyData untuk mengambil titik jalur dan jenis titik. Kemudian kode menampilkan hitungan yang dikembalikan oleh metode GraphicsPathIterator::CopyData .


#define BUFFER_SIZE 30
TCHAR numPointsCopied[BUFFER_SIZE];

// Create the points for three lines in a path.
Point pts[] = { Point(20, 20), 
                Point(100, 20), 
                Point(100, 50), 
                Point(20, 50) };
GraphicsPath path;
path.AddLines(pts, 4); // Add the lines to the path.

// Create a GraphicsPathIterator object and associate it with the path. 
GraphicsPathIterator pathIterator(&path);

// Create destination arrays, and copy the path data to them.
PointF* pCopiedPoints = new PointF[4]; 
BYTE* pTypes = new BYTE[4];
INT count = pathIterator.CopyData(pCopiedPoints, pTypes, 0, 3);

// Confirm that the points copied.
StringCchPrintf(
   numPointsCopied, BUFFER_SIZE, TEXT("%d points were copied."), count);

MessageBox(hWnd, numPointsCopied, TEXT("CopyData"), NULL);

delete[] pCopiedPoints;
delete[] pTypes;

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