CreateUnoValue Function

Returnerar ett objekt som representerar ett strikt skrivet värde som refererar till typsystemet Uno.

Det här objektet konverteras automatiskt till ett Any av motsvarande typ när det överförs till Uno. Typen måste anges av sitt fullt kvalificerade Uno-typnamn.

Symbolen Info

Collabora Office API använder ofta Any-typ. Det här är motsvarigheten till Variant-typen som är bekant från andra miljöer. Any-typen innehåller en godtycklig Uno-typ och används i generiska Uno-gränssnitt.


Syntax:

oUnoValue = CreateUnoValue( "[]byte", MyBasicValue ) ' to get a byte sequence.

If CreateUnoValue cannot be converted to the specified Uno type, and error occurs. For the conversion, the com.sun.star.script.Converter service is used.

This function is intended for use in situations where the default Basic to Uno type converting mechanism is insufficient. This can happen when you try to access generic Any based interfaces, such as XPropertySet::setPropertyValue( Name, Value ) or X???Container::insertBy???( ???, Value ), from Collabora Office Basic. The Basic runtime does not recognize these types as they are only defined in the corresponding service.

In this type of situation, Collabora Office Basic chooses the best matching type for the Basic type that you want to convert. However, if the wrong type is selected, an error occurs. You use the CreateUnoValue() function to create a value for the unknown Uno type.

You can also use this function to pass non-Any values, but this is not recommend. If Basic already knows the target type, using the CreateUnoValue() function will only lead to additional converting operations that slow down the Basic execution.

Stötta oss!