CreateUnoValue Function

Nagbabalik ng isang bagay na kumakatawan sa isang mahigpit na nai-type na halaga na tumutukoy sa sistema ng uri ng Uno.

Ang bagay na ito ay awtomatikong na-convert sa isang Anuman ng kaukulang uri kapag naipasa kay Uno. Dapat tukuyin ang uri ng ganap na kwalipikadong pangalan ng uri ng Uno nito.

Ang LibreOffice API ay madalas na gumagamit ng Anuman uri. Ito ang katapat ng Variant uri na kilala mula sa ibang mga kapaligiran. Ang Anuman Ang uri ay mayroong isang arbitrary na uri ng Uno at ginagamit sa mga generic na interface ng Uno.

Syntax:


  CreateUnoValue(Type As String, Value As Object) As Object

Ibinalik na halaga:

Bagay

Mga Parameter:

Uri : Ang ganap na kwalipikadong pangalan ng uri ng Uno. Ang mga sinusuportahang uri ng data ay walang bisa , char , boolean , byte , maikli , unsigned short , mahaba , hindi pinirmahan mahaba , hyper , walang sign na hyper , lumutang , doble , string , uri , at anuman . Ang mga pangalan ay case sensitive at maaaring unahan ng mga square bracket upang ipahiwatig ang isang array.

Halaga : Isang mahigpit na nai-type na halaga.


   byte_sequence_object = CreateUnoValue("[]byte", Array(85, 3, 27))

Mga error code:

Kung CreateUnoValue hindi mako-convert ang halaga sa tinukoy na uri ng Uno, nangyayari ang isang error. Ang com.sun.star.script.Converter ang serbisyo ay responsable para sa conversion.

Halimbawa:

Ang function na ito ay inilaan para sa paggamit sa mga sitwasyon kung saan ang default na Basic to Uno type converting mechanism ay hindi sapat. Nangyayari ito sa pagtawag ng generic Anuman batay sa mga pamamaraan ng API, tulad ng com.sun.star.beans.XPropertySet .setPropertyValue() o com.sun.star.container.XNameContainer .insertByName() . CreateUnoValue() nagtatakda ng value object para sa hindi kilalang uri ng Uno.

Ang halimbawang ito ay gumagamit ng com.sun.star.beans.XPropertySet .addProperty() paraan upang lumikha ng isang pag-aari ng dokumento na nangangailangan ng mga default na halaga CreateUnoValue() paggamit:


  With ThisComponent.DocumentProperties.getUserDefinedProperties()
      .addProperty("FOO", com.sun.star.beans.PropertyAttribute.REMOVEABLE, CreateUnoValue("double", 23))
  End With

Maaari mo ring gamitin ang function na ito upang ipasa ang mga hindi-Any value, ngunit hindi ito inirerekomenda. Kung alam na ng Basic ang uri ng target, gamit ang CreateUnoValue() Ang function ay hahantong lamang sa mga karagdagang pagpapatakbo ng pag-convert na nagpapabagal sa Basic execution.