IInkExtendedProperties::Tambahkan metode (msinkaut.h)

Artikel
03/08/2023

Membuat dan menambahkan objek IInkExtendedProperty ke koleksi IInkExtendedProperties .

Sintaks

HRESULT Add(
  [in]          BSTR                 Guid,
  [in]          VARIANT              Data,
  [out, retval] IInkExtendedProperty **InkExtendedProperty
);

Parameter

[in] Guid

Nama objek IInkExtendedProperty baru. Nama ini dinyatakan sebagai BSTR yang mewakili pengidentifikasi unik global (GUID) dalam format berikut:

{dfc71f44-354b-4ca1-93d7-7459410b6343} (Termasuk kurung kurawal)

Untuk informasi selengkapnya tentang jenis data BSTR, lihat Menggunakan Pustaka COM.

[in] Data

Data untuk objek IInkExtendedProperty baru.

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

[out, retval] InkExtendedProperty

Ketika metode ini kembali, berisi penunjuk ke properti baru yang diperluas.

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	Pengguna tidak menentukan data.
CO_E_CLASSSTRING	Format GUID tidak valid.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
TPC_E_INVALID_STROKE	Goresan tidak valid.

Keterangan

Catatan Anda tidak dapat menyimpan objek IInkExtendedProperty kosong. Objek harus berisi data sebelum dapat disimpan. Misalnya, jika Anda mencoba menambahkan properti yang diperluas ke goresan untuk digunakan nanti, pengecualian akan dilemparkan jika properti yang diperluas tidak berisi data.

Jenis berikut dapat diterima:

Byte atau array CHAR
Array bilangan bulat, float, bilangan bulat besar, ganda, tanggal, atau desimal
Boolean (tetapi bukan array Boolean)
BSTR (tetapi bukan array BSTR)
Array Varian. Semua array varian yang diteruskan sebagai IInkExtendedProperty harus dari jenis yang sama dan semuanya numerik. Misalnya, array varian BSTRS, array array, VT_NULL, dan VT_EMPTY tidak didukung.

Catatan Jika Anda memanggil metode ini dengan parameter Guid yang diatur ke GUID yang sudah ada di koleksi IInkExtendedProperties , data baru akan menggantikan properti yang diperluas yang ada untuk GUID tersebut alih-alih menambahkan elemen kedua.

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 IInkExtendedProperties

Koleksi InkStrokes

Bagikan melalui