IBM Lotus Symphony


Função CreateUnoValue [Runtime]

Devolve um objecto que representa um valor escrito e que se refere ao sistema de escrita Uno.

Este objecto é automaticamente convertido num Any do tipo correspondente quando transferido para Uno. O tipo terá de ser especificado pelo respectivo nome de tipo Uno completo.

ícone de Nota A API do Lotus® Symphony™ utiliza frequentemente o tipo Any. É o equivalente do tipo de variante conhecido noutros ambientes. O tipo Any suporta um tipo Uno arbitrário e é utilizado em interfaces genéricas Uno.

Sintaxe:

oUnoValue = CreateUnoValue( "[]byte", MyBasicValue ) para obter uma sequência de bytes.

Se CreateUnoValue não puder ser convertido no tipo de Uno especificado, ocorre um erro. Para a conversão, é utilizado o serviço TypeConverter.

Esta função utiliza-se em situações em que o mecanismo de conversão de tipo do Basic predefinido para Uno é insuficiente. Isto pode acontecer quando se tenta aceder a interfaces genéricas baseadas em Any, tais como XPropertySet::setPropertyValue( Name, Value ) ou X???Container::insertBy???( ???, Value ), do Lotus Symphony Basic. O tempo de execução do Basic não reconhece estes tipos visto que só são definidos no serviço correspondente.

Neste tipo de situação, o Lotus Symphony Basic selecciona o tipo que mais se assemelhe ao tipo de Basic que pretende converter. No entanto, se for seleccionado o tipo errado, ocorre um erro. Pode utilizar a função CreateUnoValue() para criar um valor para o tipo Uno desconhecido.

É também possível utilizar esta função para transferir valores que não sejam Any, mas isto não é recomendado. Se o Basic já está familiarizado com o tipo pretendido, utilizar a função CreateUnoValue() só levará a mais operações de conversão que tornarão mais lenta a execução do Basic.


Comentários sobre o produto | Documentação adicional | Marcas comerciais