IBM Lotus Symphony


Funktionen CreateUnoValue [Runtime]

Returnerer et objekt, der repræsenterer en værdi med en defineret type, som refererer til UNO-typesystemet.

Objektet konverteres automatisk til en Any med den tilsvarende type, når det overføres til UNO. Typen skal angives med dens fuldstændige UNO-typenavn.

Ikonen Note I API'et til Lotus® Symphony™ benyttes typen Any ofte. Den svarer til typen Variant, som kendes fra andre miljøer. Typen Any indeholder én vilkårlig UNO-type og bruges i generiske UNO-grænseflader.

Syntaks:

oUnoValue = CreateUnoValue( "[]byte", MinBasicVaerdi ) for at få en bytesekvens.

Der opstår en fejl, hvis CreateUnoValue ikke kan konverteres til den angivne UNO-type. Servicen TypeConverter bruges til konverteringen.

Funktionen er beregnet til at blive anvendt i situationer, hvor standardfunktionen til konvertering mellem Basic- og UNO-typer ikke er tilstrækkelig. Det kan forekomme, når du forsøger at få adgang til generiske Any-baserede grænseflader, f.eks. XPropertySet::setPropertyValue( Navn, Vaerdi ) eller X???Container::insertBy???( ???, Vaerdi ), fra Lotus Symphony Basic. Disse typer kendes ikke i Basic-runtimemiljøet, da de kun er defineret i den tilhørende service.

I disse situationer vælger Lotus Symphony Basic den type, der kommer tættest på den Basic-type, du vil konvertere. Der opstår imidlertid en fejl, hvis den forkerte type vælges. Du kan bruge funktionen CreateUnoValue() til at oprette en værdi for den ukendte UNO-type.

Du kan også bruge funktionen til at overføre værdier med en anden type end Any, men det anbefales ikke. Hvis Basic allerede kender måltypen, medfører brugen af funktionen CreateUnoValue() overflødige konverteringsfunktioner, som gør Basic-kørslen langsommere.


Produktfeedback | Yderligere dokumentation | Varemærker