VObjectInfo

Los objetos de esta clase contienen la información de la estructura de un objeto.

Se pueden ver sus propiedades, tanto los datos que contienen como información de su nombre, tipo, tabla asociada (si tiene), tipo de objeto referenciado… Para obtener el valor que contiene una propiedad primero debemos mirar el tipo de dato para usar la función adecuada. Por ejemplo si el tipo de dato es Uint16 usar la función propertyDataToInt(nProp);

También se pueden obtener otros VObjectInfo de sus subobjetos y de los objetos referenciados por sus propiedades.

Indice de funciones

Generales

String comments()

String iconPath()

String id()

String idRef()

Boolean isDataView()

Boolean isNull()

Boolean isUsed()

String name( Number lenguaje, Number pais=0 )

String name()

Number type()

De estilos

Boolean isAccessibleFromWeb()

Boolean isDelayedEdition()

Boolean isDragCopyEnabled()

Boolean isDragMoveEnabled()

Boolean isHardLock()

Boolean isInsertPoint()

Boolean isOnlyOneExpanded()

Boolean isPrivate()

Boolean isRemoteFunction()

Boolean isRunOnSimpleClick()

Boolean isVertical()

Number style()

Boolean style( estilo )

Number array styles( )

Number array styles( nTipoObjeto )

String Array stylesNames()

String Array stylesNames( nTipoObjeto )

De entrada

VTableInfo inputTable()

String inputTableIdRef()

Number inputType()

De salida

VTableInfo outputTable()

String outputTableIdRef()

Number outputType()

De propiedades

Bool equals( VObjectInfo objectInfo )

String instructionDescription()

Number propertyCount()

Variant propertyData( Number nProp )

Object propertyDataColorType()

Number propertyDataType( Number nProp )

Number propertyEditType( Number nProp )

String propertyName( Number nProp )

VObjectInfo propertyObjectInfo( Number nProp )

Number propertyObjectType( Number nProp )

De subobjetos

VObjectInfo array objectsUsed()

Number subObjectCount( Number nSubType )

VObjectInfo subObjectInfo( Number nSubType, String szIdSubObject )

VObjectInfo subObjectInfo( Number nSubType, Number nSubObject )

VObjectInfo array subObjectsNotUsed(Number nType)

Number array subObjectTypes()

De objetos padre

VObjectInfo mainObjectInfo()

VObjectInfo parentObjectInfo()

De objetos

VObjectInfo array objectsUsed()

De proyecto

VProjectInfo projectInfo()

Documentación de funciones

Funciones generales

String comments()

Devuelve el valor de la propiedad comentarios del objeto.

String iconPath()

Se trata de una senda a recursos internos de la plataforma. Devuelve la senda del icono del objeto.

Esta función, si bien es funcional en vClient, está pensada para su uso en las extensiones de Velneo vDevelop.

String id()

Devuelve el identificador de un objeto. Por ejemplo, "AUTOEXEC".

String idRef()

Devuelve el identificador con referencia de un objeto. Por ejemplo, "VJS_APP/AUTOEXEC".

Boolean isDataView()

Devuelve true si el objeto es una vista de datos.

Boolean isNull()

Devuelve true si el objeto VObjectInfo es nulo, false si contiene un objeto.

Boolean isUsed()

Devuelve true si el objeto está siendo utilizado y false en caso contrario.

String name( Number lenguaje, Number pais=0 )

Devuelve el nombre o descripción del objeto. Si no le pasamos parámetros devuelvo el nombre del idioma en curso. Si le resolvemos el idioma o el idioma y país nos devuelve del nombre para ese idioma y país.

Parámetros:

• nLenguaje: código Qt del idioma (ver enum de idiomas).

• nPais: código Qt del país (ver enum de países).

String name()

Devuelve el nombre o descripción del objeto del idioma en curso.

Number type()

Devuelve el código de tipo de objeto. Ver enum de tipos de objetos.

Funciones de estilos

Boolean isAccessibleFromWeb()

Devuelve true si el objeto tiene activado el estilo "Accesible Web" que se aplica en procesos.

Boolean isDelayedEdition()

Devuelve true si el objeto tiene activado el estilo "Retardo señal valueChanged" que se aplica en controles de edición.

Boolean isDragCopyEnabled()

Devuelve true si el objeto tiene activado el estilo "Arrastrable para copiar" que se aplica en objetos de tipo árbol visor de tabla, casillero, comboview, listview, lista QML, rejilla, rejilla avanzada y viewflow.

Boolean isDragMoveEnabled()

Devuelve true si el objeto tiene activado el estilo "Arrastrable para mover" que se aplica en objetos de tipo árbol visor de tabla, casillero, comboview, listview, lista QML, rejilla, rejilla avanzada y viewflow.

Boolean isHardLock()

Devuelve true si el objeto tiene activado el estilo "Bloqueo duro" que se aplica en objetos de tipo formulario y formulario QML.

Boolean isInsertPoint()

Devuelve true si el objeto tiene activado el estilo "Punto de inserción" que se aplica en objetos de tipo acción, formulario y formulario QML.

Boolean isOnlyOneExpanded()

Devuelve true si el objeto tiene activado el estilo "Solo una rama abierta" que se aplica en objetos de tipo árbol de tabla.

Boolean isPrivate()

Devuelve true si el objeto tiene activado el estilo "Privado" que se aplica en todos los objetos.

Boolean isRemoteFunction()

Devuelve true si el objeto tiene activado el estilo "Ejecutable en remoto" que se aplica en funciones.

Boolean isRunOnSimpleClick()

Devuelve true si el objeto tiene activado el estilo "Simple-click dispara" que se aplica en objetos de tipo árbol visor de tablas, casillero, listview, rejilla, rejilla avanzada y viewflow.

Boolean isVertical()

Devuelve true si el objeto tiene activado el estilo "Vertical" que se aplica en objetos de tipo multivista.

Number style()

Devuelve un número de 32 bits en el que cada bit se corresponde con un flag de estilo del enum de estilos de la clase VObjectInfo.

Para determinar si un estilo está activado o no podemos usar los operadores bitwase de JavaScript. Por ejemplo:

(0x00000001 == (objeto.style()
&
0x00000001)) // Devuelve true si es privado
(0x00000010 == (objeto.style()
&
0x00000010)) // Devuelve true si es un punto de inserción
(0x00000020 == (objeto.style()
&
0x00000020)) // Devuelve true si la función es ejecutable en remoto
(0x00000040 == (objeto.style()
&
0x00000040)) // Devuelve true si el proceso es accesible web

Boolean style( estilo )

Devuelve true si el objeto contiene el estilo o los estilos que le pasamos como parámetro.

Parámetros

• Estilo: es un valor del enum de estilos del objeto. Funciona como un flag y puede contener varios estilos concatenados. Por ejemplo:

obj.style( StyleCustomizable | StyleOnlyView ) //devolverá true si contiene ambos estilos.

Number array styles( )

Devuelve un array con los estilos posibles de un objeto. Ver enum de estilos.

Number array styles( nTipoObjeto )

Se trata de una función estática. Devuelve un array con los números de los estilos posibles de un tipo de objeto. Ver enum de estilos.

Parámetros

• nTipoOjbeto: código del tipo de objeto. Ver enum de tipos de objeto.

String array stylesNames()

Devuelve un array con los nombres de los estilos posibles de un objeto.

stylesNames( nTipoObjeto )

Devuelve un array de cadenas con los nombres de los estilos del tipo de objeto que se le pase como parámetro.

Parámetros

• nTipoObjeto: código del tipo de objeto. Ver enum de tipos de objeto.

Funciones de entrada

VTableInfo inputTable()

Devuelve el objeto VTableInfo correspondiente a la tabla de entrada.

Number inputType()

Devuelve el tipo de entrada. Ver enum de tipos de entrada/salida.

String inputTableIdRef()‌

Devuelve el identificador de referencia (idRef) de la tabla de entrada.

Funciones de salida

VTableInfo outputTable()

Devuelve el objeto VTableInfo correspondiente a la tabla de salida.

String outputTableIdRef()‌

Devuelve el identificador de referencia (idRef) de la tabla de salida.

Number outputType()

Devuelve el tipo de salida. Ver enum de tipos de entrada/salida.

Funciones de propiedades

Bool equals( VObjectInfo objectInfo )

Devuelve true si el objeto es igual que el que pasamos como parámetro, false si es distinto. Comprueba para ello propiedades y subobjetos.

Parámetros:

• objectInfo: objeto de la clase VObjectInfo con el que queremos comparar el objeto.

String instructionDescription()

De uso exclusivo para extensiones de Velneo vDevelop. Devuelve la descripción de la línea de instrucción.

Number propertyCount()

Devuelve el número de propiedades del control.

QVariant propertyData( Number nProp )

Devuelve el valor de la propiedad.

Parámetros:

• nProp: valor numérico que se corresponde con la posición ordinal de la propiedad del objeto o control.

Object propertyDataColorType()

Devuelve la información necesaria para determinar si el color usado en la propiedad es un color concreto o una paleta y qué nombre de paleta tiene.

Devuelve un objeto JavaScript con los siguientes campos:

• mode: valor del enumerado ColorMode.

• colorGroup: valor del enumerado de Qt.

• colorRole: valor del enumerado de Qt.

• palette: nombre de la paleta (si es definida por el usuario).

umber propertyDataType( Number nProp )

Devuelve el tipo de dato de la propiedad. Ver enum Property Data Types.

Parámetros:

• nProp: valor numérico que se corresponde con la posición ordinal de la propiedad del objeto o control.

Number propertyEditType( Number nProp )

Devuelve el tipo de editor de la propiedad. Ver enum Property Edit Types.

Parámetros:

• nProp: valor numérico que se corresponde con la posición ordinal de la propiedad del objeto o control.

String propertyName( Number nProp )

Devuelve el nombre de la propiedad.

Parámetros:

• nProp: valor numérico que se corresponde con la posición ordinal de la propiedad del objeto o control.

VObjectInfo propertyObjectInfo( Number nProp )

Devuelve un objeto de la clase VObjectInfo de la propiedad.

Parámetros:

• nProp: valor numérico que se corresponde con la posición ordinal de la propiedad del objeto o control.

Number propertyObjectType( Number nProp )

Devuelve un número que identifica el tipo de objeto de la propiedad. Ver .

Parámetros:

• nProp: valor numérico que se corresponde con la posición ordinal de la propiedad del objeto o control.

Funciones de subobjetos

Number subObjectCount( Number nSubType )

Devuelve el número de subobjetos de un objeto de un tipo.

Parámetros:

• nSubType: ver enum de tipos de objetos.

VObjectInfo subObjectInfo( Number nSubType, String szIdSubObject )

Devuelve un objeto VObjectInfo de un subobjeto de un tipo y un identificador.

Parámetros:

• nSubType: ver enum de tipos de objetos.

• szIdSubObject: identificador del subobjeto.

VObjectInfo subObjectInfo( Number nSubType, Number nSubObject )

Devuelve un objeto VObjectInfo de un subobjeto de un tipo y un número de orden del subobjeto.

Parámetros:

• nSubType: ver enum de tipos de objetos.

• szIdSubObject = número de orden del subobjeto en la lista.

VObjectInfo array subObjectsNotUsed(Number nType)

Devuelve un array de objectinfos de todos los subobjetos no usados del objeto.

Parámetros:

• nType: ver enum de tipos de objetos.

Si se especifica el tipo devuelve solo los de ese tipo, si no se pasa parámetro los devuelve todos. Ver enum de tipos de objetos.

Number array subObjectTypes()

Retorna una lista con los tipos de subobjetos del objeto. Ver enum de tipos de objetos.

Funciones de objetos padre

VObjectInfo mainObjectInfo()

Devuelve el objeto principal del sub-objeto en curso. Por ejemplo: de una parte de un índice devuelve la tabla.

VObjectInfo parentObjectInfo()

‌Devuelve el objeto padre del sub-objeto en curso. Por ejepmlo: el índice de una parte de índice, o la tabla de un índice).

Funciones de objetos

VObjectInfo Array objectsUsed()

Devuelve un array de objectInfos de los objetos o subobjetos que usan el objeto.

Funciones de proyecto

‌VProjectInfo projectInfo()‌

Devuelve el proyecto de un objeto.

Ejemplos

1. Información del objeto de la vista en curso

////////////////////////////////////////////////////////////
// Información del objeto de la vista en curso

// Se coge el root (objeto) de la vista en curso
var root = theMainWindow.currentView().root();

// Se crea el objeto VObjectInfo de la vista en curso
obj = root.objectInfo();

// Se muestra la información del objeto
msg = "El objeto en curso tiene la siguiente información:" +  "nn" + 
        "Id: " + obj.id() + "n" + 
        "IdRef: " + obj.idRef() + "n" + 
        "Name: " + obj.name() + "n" + 
        "Tipo: " + obj.type() + "n" + 
        "¿Es vista de datos? " + obj.isDataView() + "n";

// Si tiene tabla asociada se añade al mensaje
if ( obj.inputTable().name() != "" )
    msg += "n" + "Tabla asociada: " + obj.inputTable().name() + "n";

// Si tiene tabla destino se añade al mensaje
if ( obj.outputTable().name() != "" )
    msg += "n" + "Tabla destino: " + obj.outputTable().name() + "n";

// Si es una rejilla se muestra el número de columnas
if ( obj.type() == VObjectInfo.TypeGrid )
    msg += "n" + "Es una rejilla y tiene " + obj.subObjectCount( 15 ) + " columnas";

2. Guardar en un array los identificadores de una columna de una rejilla

Se trata de un manejador de evento de una rejilla.

//Obtenemos la vista actual
var root = theRoot.dataView();

// Se crea el objeto VObjectInfo de la vista en curso
obj = root.objectInfo();

//Inicalizamos array de identificadores
var arrIdsColumnas = [];

//Obtenemos el número de columnas
var numCols = obj.subObjectCount(15);

//Recorremos las columnas de la rejilla
for (var i = 0; i < numCols; i++)
{
	//Obtenemos el identificador de la columna en cursor
	var idCol = obj.subObjectInfo(15, i).id();
	
	//Añadimos el identificador a la variable array
	arrIdsColumnas.push(idCol);
}