Fungsi CreateUnoValue

Mengembalikan objek yang mewakili nilai yang diketik semata-mata mengacu pada sistem jenis Uno.

Objek ini secara otomatis dikonversi ke salah satu dari jenis yang sesuai ketika diteruskan ke Uno. Jenis harus ditentukan oleh nama jenis Uno yang sepenuhnya memenuhi syarat.

Ikon Catatan

API LibreOffice sering menggunakan tipe Apa saja. Ini adalah bagian dari tipe Varian yang diketahui dari lingkungan lain. Jenis Apa saja yang memegang satu jenis Uno yang semaunya dan digunakan dalam antarmuka Uno umum.


Sintaksis:


oUnoValue = CreateUnoValue( "[]byte", MyBasicValue ) ' untuk mendapatkan urutan bita.

Jika CreateUnoValue tidak dapat dikonversi ke tipe Uno yang ditentukan, dan terjadi galat. Untuk konversi, layanan TypeConverter digunakan.

Fungsi ini dimaksudkan untuk digunakan dalam situasi di mana mekanisme konversi tipe Basic ke Uno standar tidak cukup. Ini dapat terjadi ketika Anda mencoba mengakses antarmuka berbasis Any generik, seperti XPropertySet::setPropertyValue( Nama, Nilai ) atau X???Container::insertBy??? ( ???, Nilai), dari LibreOffice Dasar. Basic runtime tidak mengenali tipe-tipe ini karena mereka hanya didefinisikan dalam layanan yang sesuai.

Dalam situasi seperti ini, LibreOffice Dasar memilih tipe pencocokan terbaik untuk tipe Dasar yang ingin Anda konversi. Namun, jika jenis yang salah dipilih, kesalahan terjadi. Anda menggunakan fungsi CreateUnoValue() untuk membuat nilai untuk tipe Uno yang tidak diketahui.

Anda juga dapat menggunakan fungsi ini untuk memberikan nilai-nilai non-Apa saja, tetapi ini tidak direkomendasikan. Jika Utama sudah mengetahui tipe target, menggunakan fungsi MembuatNilaiUno() hanya akan mengarah pada operasi konversi tambahan yang memperlambat eksekusi Utama.