Metode IInkStrokeDisp::SetPoints (msinkaut.h)

  • Artikel

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