Documentación de Velneo
21
21
  • Introducción
  • Velneo 21
    • ¿Qué es velneo?
    • Requerimientos de Velneo
    • Funcionalidades comunes a los componentes de Velneo
      • Conexión con Velneo vServer
      • Cambiar el estilo de visualización
      • Ver u ocultar barras de herramientas
      • Mensajería interna entre usuarios
      • Soporte de alta resolución (HighDPI)
      • Carpetas de trabajo de los componentes de Velneo
      • Numeración de versiones de Velneo
  • Velneo vDevelop
    • ¿Qué es Velneo vDevelop?
    • Interfaz de Velneo vDevelop
    • Lista de teclas aceleradoras de Velneo vDevelop
    • Soluciones y proyectos
    • Control y edición de proyectos
    • Herencia
    • Proyectos objetos y editores
      • Objeto
      • Proyecto de datos
        • Tabla
          • Campo
          • Enlace
          • Indice
          • Plural
          • Actualización
          • Trigger
          • Traspaso de campo
        • Tabla estática
        • Indice complejo
        • Variable
      • Proyecto de aplicación
        • Marco
        • Acción
        • Menú
        • Toolbar
        • Rejilla
          • Propiedades de columna
        • Formulario
          • Controles de visualización
            • Texto estático
            • Nombre de campo
            • Visor HTML
            • Dibujo
            • Imagen SVG
            • Caja de grupo
            • Menú arbolado
            • Barra de progreso
            • Reloj
            • Manómetro
            • Termómetro
          • Controles de edición
            • Edición alfabética
            • Edición numérica
            • Data catcher edit
            • Objeto dibujo
            • Edición fecha/hora
            • Edición fecha
            • Edición hora
            • Caja de texto
            • Caja de texto enriquecido
            • Edición fórmula
            • Edición senda fichero
            • Edición senda directorio
          • Controles de entrada
            • Botón
            • Botón de radio
            • Botón de check
            • ComboBox
            • ListBox
            • Deslizador
            • Rueda
            • Dial
            • Calendario
          • Contenedores
            • Separador de formularios
            • Splitter
            • Pila de formularios
            • Caja de formularios
            • Vista de datos
          • Layout
          • Tree widget
          • Controles SVG
          • Fichas de extensión
        • Búsqueda
        • Localizador
        • Lupa
        • Arbol visor de tablas
        • Casillero
        • Multivista
        • Bloc de formularios
        • Informe
          • Agrupamiento
          • Sección
          • Editor de informes
          • Cálculo
        • Informe personalizable
          • Diseñando un informe personalizable básico
          • Diseño avanzado
          • Diseñando un informe personalizable
          • Añadiendo orígenes de datos
          • Añadiendo elementos al informe
          • Características avanzadas
          • Etiquetas
          • Asistente de scripts
        • Impresora lógica
        • Cesta
        • Dispositivo serie
        • Imagen SVG
        • Control SVG
        • ViewFlow
        • Rejilla avanzada
        • Alternador de lista
        • ListView
        • ComboView
        • Formulario QML
        • Lista QML
        • Toolbar
        • Protocolo TCP-IP
        • Librería externa
        • Conexión de evento
        • Manejador de evento
        • Drop
        • Inserción
      • Objetos de proyectos de aplicación y datos
        • Dibujo
        • Constante
        • Proceso
          • Comandos de base de datos
            • API
            • Bases de datos externas
            • Búsquedas
            • Campos (grupo de comandos)
            • Cestas
            • Fichas
            • Fichas seleccionadas
            • Listas
            • Tablas
            • Tubos
          • Básicos
            • Controles de flujo
            • Debug
            • Ejecución
            • Salida/retornos
            • Scripts (grupo de comandos)
            • Transacciones (comandos)
            • Variables
          • Comunicación
            • Internet
            • Protocolo TCP
            • Puerto serie
            • SDV
          • Interfaz
            • Acciones (comandos)
            • Control
            • Diálogos
            • Formularios - comandos
            • Localizadores
            • Objeto - grupo de comandos
            • Ventana principal
            • Vista de datos - comandos
          • Sistema
            • Comandos de Sistema
            • Configuración
            • Directorios
            • Ficheros
        • Cola
        • Función
        • Variable local
        • Tubo de ficha
        • Tubo de lista
        • Esquema de tablas
        • Fichero adjunto
      • Editores
        • Editor de imágenes
        • Selector de fuentes
        • Asistente de fórmulas
          • Operadores
          • Funciones estándar
            • Funciones API
            • Funciones básicas
            • Funciones de cadenas
              • Expresiones regulares
            • Funciones científicas
            • Funciones de Cliente-servidor
            • Funciones de color
            • Funciones de códigos
            • Funciones de directorios
            • Funciones de fechas
            • Funciones de ficha en curso
            • Funciones de horas
            • Funciones de Internet
            • Funciones de juegos de caracteres
              • Codecs
            • Funciones numéricas
            • Funciones de sistema
            • Funciones de tiempo
            • Funciones trigonométricas
          • Funciones de dll
          • Funciones de proceso
          • Campos
          • Constantes
          • Variables globales
          • Variables locales
          • Variables del sistema
          • Verificador de fórmulas
          • Conversión automática de datos
          • Introducción de datos literales
          • Secuencias de escape en cadenas de caracteres
          • Funciones de campo
    • Inspectores
    • Scripts
      • Lenguajes
        • JavaScript
          • Procesos JavaScript
          • Fórmulas JavaScript
          • Clases
            • Funciones globales
            • Objetos
            • VAbstractBrowser
            • VAbstractDataView
            • VAbstractListDataView
            • VAdvandedGridListDataView
            • VAlternatorListDataView
            • VApp
            • VBoundFieldComboBox
            • VBoundFieldEdit
            • VBoundFieldEditBrowser
            • VBoundFieldListBox
            • VByteArray
            • VCheckBox
            • VClockWidget
            • VComboBox
            • VComboListDataView
            • VCoverFlowListDataView
            • VCWebView
            • VDataCatcherEdit
            • VDataCatcherEditBrowser
            • VDataViewDialog
            • VDateEdit
            • VDateEditBrowser
            • VDateTimeEdit
            • VDateTimeEditBrowser
            • VDial
            • VDir
            • VExtension
            • VFile
            • VFileInfo
            • VFilePathEditBrowser
            • VFinder
            • VFont
            • VFormBlockListDataView
            • VFormDataView
            • VFormulaEditBrowser
            • VGaugeWidget
            • VGridListDataView
            • VGroupBox
            • VImage
            • VImageEdit
            • VImageWidget
            • VInstancesList
            • VInstance
            • VInstances
            • VItemRegisterPattern
            • VLabel
            • VLineEdit
            • VLineEditBrowser
            • VListBox
            • VListDataView
            • VLogin
            • VMainWindow
            • VMdiView
            • VMultiDataView
            • VNumberSpinBox
            • VNumberSpinBoxBrowser
            • VObjectInfo
            • VObjectInstance
            • VProcess
            • VProgressBar
            • VProjectInfo
            • VPushButton
            • VQmlFormDataView
            • VQmlListDataView
            • VQmlListModel
            • VQuery
            • VRadioButton
            • VRegister
            • VRegisterList
            • VReportListDataView
            • VRequest
            • VResponse
            • VRoot
            • VScreen
            • VServerAdmin
            • VSettings
            • VSlider
            • VSlotListDataView
            • VSolutionInfo
            • VSplitter
            • VSqlDatabase
            • VSSLCertificate
            • VSSLInfo
            • VSSLSessionCipher
            • VStackedWidget
            • VSvgButton
            • VSvgSlideSwitch
            • VSvgToggleSwitch
            • VSvgWidget
            • VSysInfo
            • VTableInfo
            • VTabWidget
            • VTextEdit
            • VTextFile
            • VThermometerWidget
            • VThumbWheel
            • VTimeEdit
            • VTimeEditBrowser
            • VToolBox
            • VTreeItem
            • VTreeItemRegister
            • VTreeListDataView
            • VTreeMenu
            • VTreeMultiTableListDataView
            • VTreeWidget
            • VUser
            • VUserGroup
            • VUserGroupList
            • VUserList
            • VXmlReader
            • VXmlWriter
            • Widget
            • XMLHttpRequest
        • QML
          • Tipos QML
          • QML1 vs QML2
          • Migrar aplicaciones de QML 1 a QML 2
          • Funciones específicas de QML
    • Depuración
      • Depuración de procesos de Velneo
      • Depuración de procesos JavaScript
    • Extensiones de Velneo vDevelop
    • Acceso directo a una solución desde vDevelop
    • Buenas prácticas
      • Buenas prácticas de organización
        • Solución
        • Proyecto de datos
        • Proyecto de aplicación
      • Buenas prácticas de codificación
        • Diccionario de abreviaturas
        • No te olvides nunca. Escribes y mantienes código. Documenta bien
        • Diseña los formularios como si no existiesen los layouts
      • Buenas prácticas de rendimiento
        • Arquitectura
          • Listas de registros
          • Lista de resultados de una búsqueda
          • Las cestas
          • Las variables globales
          • La caché de fichas
          • Programa en cloud
        • Base de datos
          • Tablas en memoria vs tablas en disco
          • Optimizar migraciones de datos
          • Búsquedas en el servidor ¿Cuándo y Cómo?
          • Campos fórmula vs campos en disco
          • Reduce el número de índices
          • Indices condicionados vs búsquedas complejas
          • ¿Cuándo usar tablas de extensión?
          • Indices de trozos y palabras
          • ¿Cuándo usar cada tipo de campo alfa?
          • ¿Cúando usar índices complejos?
          • Actualizaciones vs triggers
          • Puntero indirecto real vs virtual
          • Campos alfa vs campos objeto texto
          • Uso de fórmulas JavaScript en campos
          • Evitar filtrar y ordenar
        • Formularios
          • Condiciones de visible y activo
          • Carga de subformularios en pestaña, caja o pila
        • Procesos
          • 1º, 2º y 3º plano ¿Cuándo usar cada uno?
          • Bloqueo blando vs bloqueo duro
          • Pasar información del cliente al servidor
          • ¿Cómo optimizar transacciones grandes?
          • ¿Cómo gestionar las transacciones?
          • Grabaciones optimizadas para el usuario
        • Rejillas
          • Campos punteros a singular
          • Totales
          • Condiciones de activo, visible y color en columna
          • Campos de tipo objeto
        • Conoce los límites
      • Buenas prácticas para el desarrollo en equipo
  • Velneo vAdmin
    • ¿Qué es Velneo vAdmin?
    • Gestión de usuarios
    • Gestión de aplicaciones
      • Soluciones
      • Instancias
      • Disco
    • Monitorización
    • Tareas
    • Acceso directo
  • Velneo vClient
    • ¿Qué es Velneo vClient?
    • Movilidad
    • Funcionalidades de Velneo vClient
      • Accesos directos y VRL
      • Cambiar idioma
      • Panel de procesos en 2º plano
      • Manejo de rejillas
      • Manejo de cestas de la compra
      • Refrescos
      • Caché local
      • Edición de campos enlazados a maestro
      • Asignar impresoras lógicas
      • Actualización automática
      • Personalización de la ventana de conexión de Velneo vClient
      • Instalador personalizado de Velneo vClient
      • Uso de la rejilla avanzada
      • Ordenación de listas
      • Captura de imágenes desde cámara
  • Velneo vServer
    • ¿Qué es Velneo vServer?
    • Instalación y configuración
      • Activación de la licencia
      • Línea de comandos de Velneo vServer
      • Parámetros configurables de Velneo vServer
      • Estructura de directorios
    • Iniciar Velneo vServer
    • Funcionalidades
      • Protocolo VATP
      • Protocolo VATPS
      • Refrescos terciarios
      • Sistema transaccional
      • Sistema de bloqueos
      • Tecnología bigkey
      • Hilo de control
      • Cómputo del consumo de puestos
    • vPacker
  • Velneo vInstallBuilder
    • ¿Qué es Velneo vInstall Builder?
    • Configurar una instalación
    • Probar una instalación
    • Crear el instalable
    • Accesos directos
  • Velneo vModApache
    • ¿Qué es Velneo vModApache?
    • Instalación y configuración
    • Nomenclatura de objetos en urls
    • Uso de ficheros adjuntos
  • Velneo vDataClient
    • ¿Qué es Velneo vDataClient?
    • Iniciar Velneo vDataClient
    • Interfaz de Velneo vDataClient
    • Procesos
    • Utilidades
    • Acceso directo a una instancia de datos
  • Velneo vTranslator
    • ¿Qué es Velneo vTranslator?
    • Importación y exportación basada en XLIFF
    • Acceso directo a una solución
  • Velneo ODBC Driver
    • ¿Qué es velneo ODBC Driver?
    • Referencia de comandos SQL
  • Velneo vVersion
    • ¿Qué es Velneo vVersion?
  • Velneo vERP
    • ¿Qué es Velneo vERP?
    • Manual del programador
    • Documentación del ApiRest
  • Velneo vTutor
    • ¿Qué es vTutor?
    • Tutores de objetos básicos
      • Tutor de marcos
      • Tutor de formularios
      • Tutor de rejillas
      • Tutor de árboles visores de tablas arboladas
      • Tutor de búsquedas
      • Tutor de informes
      • Tutor de cestas
      • Tutor de localizador básico
    • Tutores de objetos avanzados
      • Tutor de alternadores de lista
      • Tutor de impresión de informes
      • Tutor de tubos de ficha y de lista
      • Tutor de grabación de fichas
      • Tutor de comboview
      • Tutor de eventos
      • Tutor de drag and drop
      • Tutor de TCP/IP
    • Tutores de controles
      • Tutor de botones de menú
      • Tutor de controles SVG
      • Tutor de edición numérica
      • Tutor de vistas de datos de lista
      • Tutor de visor html dinámico
    • Tutores de procesos y manejadores de evento avanzados
      • Tutor de procesos
      • Tutor de importación y exportación de ficheros ASCII
      • Tutor de comandos de interfaz y acciones
    • Tutores de scripts
      • QML: Hola mundo
      • QML: tutorial básico
      • QML: Tutor de vistas
  • Velneo cloud
    • ¿Qué es Velneo Cloud?
    • Copias de seguridad
    • Velneo cloud API
      • Uso de Velneo cloud API
    • Explorador de archivos cloud sFTP
    • TCP en Velneo cloud
    • SLA
Con tecnología de GitBook
En esta página
  • Identificador
  • Nombre
  • Estilos
  • Comentarios
  • Tipo
  • Array
  • Dimensiones
  • Decimales
  • Signo
  • Mínimo
  • Máximo
  • Ámbito de las variables locales
  • Variables locales especiales
  • EVENT_PARAMS
  • EVENT_SENDER_ID
  • EVENT_SENDER_COL

¿Te fue útil?

  1. Velneo vDevelop
  2. Proyectos objetos y editores
  3. Objetos de proyectos de aplicación y datos

Variable local

La Variable local definible dentro de un objeto. Se trata de una variable local al objeto en el que ha sido declarada, y solamente será accesible desde ese objeto o desde otros sub-objetos del mismo. La persistencia de este tipo de variables es en memoria.

Identificador

Etiqueta alfanumérica que identifica de forma unívoca a la variable. Este identificador será el que usemos en fórmulas y para referenciarlo en otras propiedades.

El identificador constará de mayúsculas y números exclusivamente. Al identificar de forma unívoca una variable no puede haber duplicidad.

NOTA: Dado que en las fórmulas las variables locales no llevan una marca inicial que las identifique, su identificador nunca podrá comenzar por un número, ya que el intérprete de fórmulas tomaría ese primer carácter como un número y no como parte del identificador de una variable local.

Nombre

Etiqueta alfanumérica que servirá como descriptor de la variable. Se usará para presentar información de la misma en objetos e inspectores.

Podemos definir una etiqueta por cada idioma presente en el proyecto.

Estilos

Podemos definir el estilo privado que limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.

Comentarios

Esta propiedad nos permite documentar el uso de la variable local.

Tipo

Permite definir el tipo de dato que va a manejar la variable local. Los tipos disponibles son:

Alfabético

Usado para datos alfanuméricos.

Numérico

Usado para datos numéricos. Se mantiene la precisión numérica hasta el sexto decimal.

Fecha

Usado para datos de tipo fecha. Por defecto admite el formato de fecha ISO 8601. El carácter de separación puede ser el guión o la barra.

Hora

Usado para introducir horas en formato HH:MM:SS. No almacena milisegundos.

Tiempo

Usado para introducir tiempos que son la unión de una fecha y una hora con el formato DD:MM:AA HH:MM:SS.sss

Booleano

Es un tipo lógico que permite definir el contenido como 1 ó 0 (Sí o No).

NOTA: Debemos asegurarnos de que el tipo de dato seleccionado se corresponda con el tipo de valor a almacenar. Por ejemplo, si vamos a manejar datos alfabéticos, la variable tendremos que definirla como alfabética ya que, si la definimos como numérica, al asignarle una cadena, no guardaría nada.

Array

Esta propiedad nos permite hacer que la variable local sea un array unidimensional.

Dimensiones

Esta propiedad solamente estará activa cuando el valor de la propiedad array sea verdadero. Nos permite declarar el número de ítems que tendrá el array.

Para conocer cómo podemos leer una posición concreta de una variable local de array, consultar el capítulo de la ayuda del asistente de fórmulas dedicado a las variables locales.

Para conocer cómo podremos añadir, insertar o eliminar ítems de una variable local de array, consultar el capítulo dedicado al grupo de comandos de instrucción de procesos de variables

Decimales

Esta propiedad solamente estará activa cuando el valor de la propiedad tipo sea numérico. Nos permite declarar el número de decimales de la variable. Podrá especificar hasta 6 decimales que son los que se garantiza su precisión.

Signo

Esta propiedad solamente estará activa cuando el valor de la propiedad tipo sea numérico. Define si la variable de tipo numérico tiene signo.

Mínimo

Esta propiedad solamente estará activa cuando el valor de la propiedad tipo sea numérico. Permite establecer el rango límite mínimo válido para la entrada de valores.

Máximo

Esta propiedad solamente estará activa cuando el valor de la propiedad tipo sea numérico. Permite establecer el rango límite máximo válido para la entrada de valores.

Ámbito de las variables locales

La norma general es que las variables son locales al objeto donde se definen y solamente están accesibles desde éste, aunque existan otros objetos que tengan declarados variables locales idénticas.

En un formulario del mismo.

Por ejemplo, podremos usar una variable local definida en el formulario en un evento de interfaz del mismo.

En un formulario podemos usar controles que agrupan o contienen otros objetos. Por ejemplo, podemos incrustar una rejilla, aunque se llamen de la misma forma.

De igual modo un formulario no es un subobjeto de una tabla, por lo tanto, las variables locales definidas en ambos objetos son locales a cada uno de ellos y no hay, por tanto, interacción entre ambos.

Por último, mencionar que en Velneo.

Variables locales especiales

Existe una serie de identificadores reservados para usos específicos. Es lo que llamamos “variables locales especiales”. Podremos crearlas o bien manualmente en el objeto, o bien seleccionando el objeto y ejecutando la opción “crear variables locales eventos” del menú “objetos”. En función del objeto, se crearán unas variables locales u otras.

Estas son:

EVENT_PARAMS

Debe ser declarada como alfabética de tipo array.

En el cuadro siguiente se muestran las distintas señales y qué es lo que devuelven en cada posición del array:

Posición array->

0

1

2

3

4

5

6

7

8

Señal

Nº de comando

Dato 1

Dato 2

Dato 3

Dato 4

Dato 5

Dato 6

Dato 7

Dato 8

Gana foco

0

–

–

–

–

–

–

–

–

Pierde foco

1

–

–

–

–

–

–

–

–

Tecla pulsada

2

Tecla

Shift?

Control?

Alt?

Texto

–

–

–

Tecla soltada

3

Tecla

Shift?

Control?

Alt?

Texto

–

–

–

Ratón: Botón doble-click

4

Botón

Shift?

Control?

Alt?

Pos x

Pos y

Pos x global

Pos y global

Ratón: Botón pulsado

5

Botón

Shift?

Control?

Alt?

Pos x

Pos y

Pos x global

Pos y global

Ratón: Botón soltado

6

Botón

Shift?

Control?

Alt?

Pos x

Pos y

Pos x global

Pos y global

Ratón: Movimiento

7

Botón

Shift?

Control?

Alt?

Pos x

Pos y

Pos x global

Pos y global

Ventana movida

8

Old pos x

Old pos y

Pos x

Pos y

–

–

–

–

Ventana redimensionada

9

Old ancho

Old alto

New ancho

New alto

–

–

–

–

Item: Cambio de seleccionado

10

Pundir select

–

–

–

–

–

–

–

Inicializado

11

–

–

–

–

–

–

–

–

Timer

12

–

–

–

–

–

–

–

–

Botón pulsado

13

–

–

–

–

–

–

–

–

Acción disparada

14

–

–

–

–

–

–

–

–

Item: Activado

15

Index: Fila

Index: Columna

–

–

–

–

–

–

Item: Simple-click

16

Index: Fila

Index: Columna

–

–

–

–

–

–

Item: Doble-click

17

Index: Fila

Index: Columna

–

–

–

–

–

–

Drop finalizado

18

–

–

–

–

–

–

–

–

Edición iniciada

19

–

–

–

–

–

–

–

–

Edición aceptada

20

–

–

–

–

–

–

–

–

Edición cancelada

21

–

–

–

–

–

–

–

–

ValueChanged

22

–

–

–

–

–

–

–

–

Pre-inicialización

23

–

–

–

–

–

–

–

–

Link clicked

24

Url del enlace

–

–

–

–

–

–

–

Load started

25

–

–

–

–

–

–

–

–

Load progress

26

% cargado

–

–

–

–

–

–

–

Load finished

27

–

–

–

–

–

–

–

–

Url changed

28

Nueva URL

–

–

–

–

–

–

–

Item: pre cambio de seleccionado

29

–

–

–

–

–

–

–

–

Contents changed

30

–

–

–

–

–

–

–

–

On close

31

On show

32

–

–

–

–

–

–

–

–

On hide

33

–

–

–

–

–

–

–

–

Pre edición aceptada

34

–

–

–

–

–

–

–

–

Pre edición cancelada

35

–

–

–

–

–

–

–

–

Vista activada

36

–

–

–

–

–

–

–

–

Vista añadida

37

–

–

–

–

–

–

–

–

Pre-vista cerrada

38

-

-

-

-

-

-

-

-

Vista cerrada

39

-

-

-

-

-

-

-

-

Podremos leer el contenido del array desde cualquier fórmula, siguiendo la siguiente sintaxis: EVENT_PARAMS[posición], donde el parámetro posición identifica la posición del array que se desee leer. Este dato podrá ser tanto una constante como una variable. Como puede verse en el esquema anterior, en un array la primera posición es la 0.

Es conveniente saber que los códigos de las teclas de control y de función multiplataforma devuelven números bastante elevados que provoca un formateo de la cadena devuelta si la imprimimos, y dará la impresión de ser el mismo, aunque realmente no sea así. Si al dato devuelto le aplicamos un formato mediante el uso de la función numberToString, si se pulsa F1 devolverá el valor 16777264, si se pulsa F2 devolverá el valor el valor 16777265 y así sucesivamente.

Si queremos conocer qué columnas de una rejilla han producido una señal cuando se realiza la conexión de eventos en rejillas, podremos declarar en la rejilla las siguientes variables locales alfabéticas:

EVENT_SENDER_ID

Contiene el identificador del control que envía la señal. Estará vacía si el que envía la señal es la propia rejilla.

EVENT_SENDER_COL

Específica para columnas de rejillas, cuando son editables. Permite obtener información de la columna en la que estamos posicionados cuando se lanza la señal. Estará vacía en todos los eventos salvo los de columna editable de rejilla.

Última actualización hace 5 años

¿Te fue útil?

NOTA: No podemos dar a una variable local el nombre de una ya que las variables de sistema son como variables locales y sus nombres son reservados, así que no se pueden usar para nombrar variables locales propias.

Permite leer las señales emitidas en los que éstas disparen.

manejadores de eventos
variable del sistema