Metode IInkStrokeDisp::SetPoints (msinkaut.h)

Artikel
02/29/2024

Mengatur titik IInkStrokeDisp menggunakan array nilai X, Y.

Sintaks

HRESULT SetPoints(
  [in]           VARIANT Points,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPointsSet
);

Parameter

[in] Points

Array titik baru untuk menggantikan titik dalam goresan yang dimulai pada indeks. Ini adalah VARIAN yang berisi array Long dengan titik yang diwakili oleh nilai alternatif formulir x0, y0, x1, y1, x2, y2, dan sebagainya.

Untuk informasi selengkapnya tentang struktur VARIAN, lihat Menggunakan Pustaka COM.

[in, optional] Index

Opsional. Indeks berbasis nol dari titik pertama dalam goresan yang akan dimodifikasi. Nilai default ISC_FirstElement, yang ditentukan dalam jenis enumerasi ItemSelectionConstants , menentukan bahwa titik pertama dalam stroke dimodifikasi.

[in, optional] Count

Opsional. Jumlah titik dalam goresan yang akan dimodifikasi. Nilai default ISC_AllElements, yang ditentukan dalam jenis enumerasi ItemSelectionConstants , menentukan bahwa semua titik dalam goresan dimodifikasi.

[out, retval] NumberOfPointsSet

Ketika metode ini kembali, berisi jumlah paket aktual yang ditetapkan.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
E_INVALIDARG	Indeks tidak valid (di luar rentang), atau parameter titik. Tidak dalam format yang benar.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .

Keterangan

Metode ini tidak mengubah jumlah titik dalam stroke. Untuk mengubah jumlah titik dalam stroke, stroke baru harus dibuat, atau stroke harus dibagi.

Metode ini tidak menyediakan untuk memotong stroke. Jika array titik berisi lebih sedikit titik daripada goresan, sisa titik dalam goresan tidak akan dimodifikasi.

Metode ini tidak menyediakan untuk memperpanjang stroke. Jika array poin berisi lebih banyak poin daripada goresan, titik tambahan tidak digunakan. Jika hitungan melebihi jumlah titik dalam array, hanya jumlah titik dalam array yang dimodifikasi.

Untuk menggambar goresan setelah memanggil SetPoints, panggil fungsi InvalidateRect .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	msinkaut.h
Pustaka	InkObj.dll

Lihat juga

Antarmuka IInkStrokeDisp

Enumerasi ItemSelectionConstants

Bagikan melalui