Documentación de Velneo
29
29
  • Introducción
  • Velneo
    • Requerimientos de Velneo
    • Notas de la versión
    • Funcionalidades comunes a los componentes de Velneo
      • Instalación
      • 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
      • Certificado de firma digital para componentes de Windows
    • Tipos de archivo generados por Velneo
    • Velneo Web
      • Plataformas y navegadores compatibles
      • Acceso a recursos del sistema
      • Siempre https
      • Funcionamiento de vatp por websocket
      • CORS para llamadas xmlhttprequest
  • Velneo vDevelop
    • ¿Qué es Velneo vDevelop?
    • Interfaz de Velneo vDevelop
      • Menú Soluciones
      • Menú Proyectos
      • Menú Objetos
      • Menú Scripts
      • Menú Edición
      • Menú Ver
      • Menú Componentes
      • Menú Ayuda
    • Lista de teclas aceleradoras de Velneo vDevelop
    • Soluciones y proyectos
    • Control y edición de proyectos
    • Herencia
    • Inspectores
    • Proyectos objetos y editores
      • Proyecto de datos
      • Proyecto de aplicación
        • Crear CSS para aplicar a objetos en edición
      • Objeto
      • Objetos de proyecto de datos
        • Indice complejo
        • Tabla
          • Actualización
          • Campo
          • Enlace
          • Indice
          • Plural
          • Traspaso de campo
          • Trigger
        • Tabla estática
        • Variable
      • Objetos de proyecto de aplicación
        • Acción
        • Alternador de lista
        • Arbol visor de tablas
        • Bloc de formularios
        • Casillero
        • Cesta
        • ComboView
        • Control SVG
        • Dispositivo serie
        • 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
            • Caja de texto
            • Caja de texto enriquecido
            • Data catcher edit
            • Edición alfabética
            • Edición fecha
            • Edición fecha/hora
            • Edición fórmula
            • Edición hora
            • Edición numérica
            • Edición senda fichero
            • Edición senda directorio
            • Objeto dibujo
          • Controles de entrada
            • Botón
            • Botón de check
            • Botón de radio
            • Calendario
            • ComboBox
            • Deslizador
            • Dial
            • ListBox
            • Rueda
          • Contenedores
            • Área de scroll
            • Caja de formularios
            • Pila de formularios
            • Separador de formularios
            • Splitter
            • Vista de datos
          • Layout
          • Tree widget
          • Controles SVG
          • Extensión de ficha
        • Formulario QML
        • Gráfico
        • Imagen SVG
        • Impresora lógica
        • Informe
          • Editor de informes
          • Agrupamiento
          • Sección
          • 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
          • Impresión de gráficos
          • Opciones html
        • ListView
        • Lista QML
        • Localizador
        • Marco
        • Menú
        • Multivista
        • Protocolo TCP-IP
        • Reemplazo
        • Rejilla
          • Propiedades de columna de rejilla
        • Rejilla avanzada
          • Propiedades de columna de rejilla avanzada
        • Toolbar
        • ViewFlow
        • Sub-objetos de vistas de datos
          • Conexión de evento
          • Drop
          • Inserción
          • Manejador de evento
      • Objetos comunes a proyecto de datos y de aplicación
        • Búsqueda
        • Cola
        • Constante
        • Dibujo
        • Esquema de tablas
        • Fichero adjunto
        • Función
        • Librería externa
        • Lupa
        • Proceso
          • Indice de comandos de instrucción de 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
              • Ejemplo de CSS
            • Diálogos
            • Formularios - comandos
            • Localizadores
            • Objeto - grupo de comandos
            • Ventana principal
            • Vista de datos - comandos
          • Sistema
            • Comandos de Sistema
            • Configuración
            • Directorios
            • Ficheros
        • Tubo de ficha
        • Tubo de lista
        • Variable local
      • Editores
        • 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 JSON
            • 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
          • Funciones de campo
          • 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
          • Composición de sendas en fórmulas
          • Operar con datos de tipo fecha, hora y tiempo
        • Editor de imágenes
        • Selector de fuentes
    • Scripts
      • Lenguajes
        • JavaScript
          • Procesos JavaScript
          • Fórmulas JavaScript
          • Clases
            • Funciones globales
            • Objetos
            • VAbstractBrowser
            • VAbstractDataView
            • VAbstractListDataView
            • VAdvandedGridListDataView
            • VAlternatorListDataView
            • VApp
            • VBoundFieldComboBox
            • VBoundFieldEdit
            • VBoundFieldEditBrowser
            • VBoundFieldListBox
            • VByteArray
            • VCheckBox
            • VClipboard
            • VClockWidget
            • VComboBox
            • VComboListDataView
            • VCoverFlowListDataView
            • VCWebView
            • VDataCatcherEdit
            • VDataCatcherEditBrowser
            • VDataView
            • 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
            • VMimeData
            • VMultiDataView
            • VNumberSpinBox
            • VNumberSpinBoxBrowser
            • VObjectInfo
            • VObjectInstance
            • VProcess
            • VProgressBar
            • VProjectInfo
            • VPushButton
            • VQmlFormDataView
            • VQmlListDataView
            • VQmlListModel
            • VQuery
            • VRadioButton
            • VRegister
            • VRegisterList
            • VReportListDataView
            • VRequest
            • VResponse
            • VRoot
            • VScreen
            • VScrollArea
            • 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
          • Funciones específicas de QML
    • Depuración
      • Depuración de procesos de Velneo
      • Depuración de procesos JavaScript
      • Monitor de vClient
    • Extensiones de Velneo vDevelop
    • Acceso directo a una solución desde vDevelop
    • Buenas prácticas
      • Buenas prácticas de organización
        • Proyectos
        • Organización de carpetas
        • Proyecto de datos
        • Proyecto de aplicación
      • Buenas prácticas de codificación
        • Identificadores
        • Teclas aceleradoras
        • Documenta
        • 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
        • Formularios
          • Condiciones de visible y activo
          • Carga de subformularios en pestaña, caja o pila
        • Base de datos
          • Campos
          • Indices
          • Actualizaciones
          • Eventos de tabla o triggers
          • Variables globales y constantes
          • 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
          • 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?
        • Procesos y funciones y eventos
          • 1º, 2º, 3º y 4º 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
        • Carga de registros en objetos de lista
          • Rejillas
            • Campos punteros a singular
            • Totales
            • Condiciones de activo, visible y color en columna
            • Campos de tipo objeto
        • Conoce los límites
      • Imágenes
      • Buenas prácticas para el desarrollo en equipo
    • Análisis de bases de datos para aplicaciones de Velneo
      • Un centro de enseñanza
      • Facturas de un cliente
      • Repartos de obras de teatro
      • Galería de arte
      • Gestión de un colegio
      • Instalación de lunas para vehículos
      • Libros y autores
      • Tienda de discos
      • Últimos pedidos de un proveedor
      • Existencias por almacén y precios por cliente
      • Generación de tickets para un quiosco
      • Navegación por facturas
  • Velneo vDevelop Web
  • Velneo vAdmin
    • ¿Qué es Velneo vAdmin?
    • Gestión de usuarios
    • Gestión de aplicaciones
      • Soluciones
      • Instancias
      • Disco
    • Monitorización
      • Lista de comandos
    • Tareas
    • Acceso directo
    • Velneo vAdmin Web
  • 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
        • Submenú de filtros
      • Uso de la rejilla avanzada
      • Manejo de cestas
      • Refrescos
      • Caché local
      • Edición de campos enlazados a maestro
      • Edición de campos de tipo fecha
      • Capturar imagen desde una cámara
      • Asignar impresoras lógicas
      • Actualización automática
      • Personalización de la ventana de conexión de Velneo vClient
      • Instalador personalizado de Velneo vClient
      • Ordenación de listas
  • 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 y detener Velneo vServer
    • Funcionalidades
      • Protocolo VATP
      • Protocolo VATPS
      • Multi-hilo
      • Integridad referencial
      • Refrescos terciarios
      • Sistema transaccional
      • Sistema de bloqueos
      • Tecnología bigkey
      • Hilo de control
    • Mensajes de log de sistema
    • vPacker
  • Velneo vInstallBuilder
    • ¿Qué es Velneo vInstallBuilder?
    • 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
    • Caché local de Velneo vModApache
  • 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 de la ApiRest
    • Novedades de la versión
  • Velneo vTutor
    • ¿Qué es vTutor?
    • Tutores de objetos básicos
      • Tutor de árboles visores de tablas arboladas
      • Tutor de búsquedas
      • Tutor de cestas
      • Tutor de formularios
      • Tutor de informes
      • Tutor de localizador básico
      • Tutor de marcos
      • Tutor de rejillas
      • Tutor de rejillas avanzadas
    • Tutores de objetos avanzados
      • Tutor de alternadores de lista
      • Tutor de comboview
      • Tutor de drag and drop
      • Tutor de eventos
      • Tutor de tablas de extensión y extensiones de ficha
      • Tutor de grabación de fichas
      • Tutor de gráficos
      • Tutor de impresión de informes
      • Tutor de lupas
      • Tutor de protocolo TCP/IP
      • Tutor de reemplazo
    • Tutores de controles
      • Tutor de botones de menú
      • Tutor de controles SVG
      • Tutor de edición numérica
      • Tutor de visor html dinámico
      • Tutor de vistas de datos de lista
    • Tutores de procesos y manejadores de evento avanzados
      • Tutor de cambio de marco
      • Tutor de comandos de interfaz y acciones
      • Tutor de importación y exportación de ficheros ASCII
      • Tutor de portapapeles
      • Tutor de procesos
      • Tutor de SDV
    • Tutores de scripts
      • QML: hola mundo
      • QML: tutor básico
      • QML: tutor de vistas
      • Tutor de XMLHttpRequest (webServices)
  • Velneo cloud
    • ¿Qué es Velneo Cloud?
    • Panel de control vServer cloud
      • URC
      • vServer
      • Apache
      • SFTP
      • Usuarios
    • Copias de seguridad
    • Velneo cloud API
      • Uso de Velneo cloud API
    • Explorador de archivos cloud sFTP
    • TCP en Velneo cloud
    • Velneo vModApache en cloud
    • SLA
    • Hora de los servidores en el cloud de Velneo
    • ¿Qué puedo hacer si tengo una incidencia en mi servidor cloud?
Con tecnología de GitBook
En esta página
  • Evento de post inicializado
  • Evento onshow
  • Eventos de ganancia de foco
  • Eventos de acción disparada
  • Evento value changed
  • Evento de cambio de ítem seleccionado

¿Te fue útil?

  1. Velneo vTutor
  2. Tutores de objetos avanzados

Tutor de eventos

Última actualización hace 4 años

¿Te fue útil?

Este tutor es un ejemplo de cómo manejar eventos en los objetos visuales de nuestras aplicaciones. Podremos programar que se dispare un cuando en un objeto visual se dispare una señal determinada, por ejemplo, ejecutar una serie de instrucciones cuando un control concreto de un formulario pierda el foco.

Un manejador de evento es un contenedor de instrucciones, similar al , pero que no tiene entidad por sí solo sino que depende de un objeto principal. Es decir, se trata de un subobjeto de un objeto de interfaz.

Para configurar qué señal disparará un evento usaremos otro subobjeto, llamado . En este se configura qué señal disparará un manejador de evento determinado. Una conexión de evento puede estar asociada al objeto de interfaz o a un subobjeto del mismo. Por ejemplo, podremos configurar una conexión de evento para que dispare un manejador de evento cuando se abra un formulario, o configurar una para que se dispare cuando gane el foco un control concreto del formulario.

Como decíamos más arriba, el manejador de evento es un subobjeto de un objeto de interfaz. Al tratarse de un subobjeto, éste tendrá acceso al resto de los subobjetos del objeto principal. Por ejemplo, si en un declaramos una variable local, desde un manejador de evento podremos consultar su valor.

Para ampliar información sobre cómo se declarar un manejador de evento y otra información sobre el mismo hacer clic .

En este tutor veremos distintas señales de ejemplo; no todas. Todos los eventos que se disparan generarán un mensaje que se mostrará en el formulario. Para ampliar información sobre cómo se declara una conexión de evento así com conocer todas las señales disponibles hacer clic .

Todo se ha programado en el formulario TUT_EVE del proyecto de aplicación de vTutor. Que encontraremos dentro de la carpeta tutores/avanzados/eventos.

Como se observar, entre otros controles, contiene una rejilla, un control de edición, un botón y un control donde se muestran los mensajes que se vayan emitiendo desde los distintos manejadores de evento que se han programado.

A continuación iremos explicando cada uno de los manejadores y conexiones de evento programados.

Evento de post inicializado

Se trata de una señal que se dispara después de inicializarse el objeto. En este caso lo que haremos será disparar un manejador de evento tras haberse inicializado el formulario. Para ello hemos programado el manejador de evento siguiente, al que hemos llamado POS_INI:

Rem ( Aumentamos un 1 a la variable usada como contador )
Set ( CNT, CNT + 1 )
Rem ( Concatenamos a la variable que muestra los mensajes una línea que indica qué señal se ha disparado )
Set ( MSJ, "" + MSJ + CNT + ". Post inicializado formulario." + "<br>" )

Y hemos declarado la conexión de evento siguiente:

La propiedad control vacía indica que esta conexión de evento estará asociada al formulario directamente.

En la propiedad señal indicaremos qué señal debe disparar el evento. En este caso hemos seleccionado la señal post inicializado. Esta señal será disparada una vez se haya inicializado el objeto asociado (el formulario). Se disparará una única vez al abrirlo.

Evento onshow

Se trata de una señal que se dispara cuando se muestra el objeto de interfaz o un control concreto del mismo. Si el objeto está en pantalla pero abrimos otro encima, al cerrar el nuevo objeto abierto y volver al anterior también se disparará el evento.

Para ello hemos programado el manejador al que hemos llamado ON_SHOW. Es idéntico al anterior, solamente cambia el texto que se añade a la variable que usamos para mostrar los mensajes.

Y hemos declarado la conexión de evento siguiente:

En la propiedad control hemos seleccionado el control que hará que se dispare la conexión de evento, en este caso la rejilla.

Y como señal hemos seleccionado el valor on show.

Eventos de ganancia de foco

Hemos creado varios manejadores de evento de ganancia de foco, uno por cada control del formulario (rejilla, botón, control de edición y control de mensajes). Explicaremos solamente uno de ellos, pues todos se programan igual. Lo explicaremos con la rejilla. Se ha creado el manejador de evento llamado ON_FOCUS_REJ:

Rem ( Aumentamos un 1 a la variable usada como contador )
Set ( CNT, CNT + 1 )
Rem ( Concatenamos a la variable que muestra los mensajes una línea que indica qué señal se ha disparado )
Set ( MSJ, "" + MSJ + CNT + ". Gana foco rejilla." + "<br>" )

Como podemos observar el casi idéntico al anterior y solamente cambia el texto que se añade a la variable que usamos para mostrar los mensajes.

Y se ha creado la siguiente conexión de evento:

En la propiedad control hemos seleccionado el control que hará que se dispare la conexión de evento, en este caso la rejilla.

Y como señal hemos seleccionado el valor gana foco.

Eventos de acción disparada

Se trata de ejecutar un manejador de evento cuando se dispare una acción. La acción debe ser disparada en el ámbito del objeto, es decir, un formulario solamente atrapará las señal si la acción es disparada desde el propio formulario; una rejilla solamente atrapará la señal cuando la acción es disparada, por ejemplo, desde la toolbar asociada a la misma.

En este caso hemos programado el manejador de evento llamado ACC_DIS, como en casos anteriores, simplemente concatena un texto a la variable local que se usa para mostrar los mensajes.

Y hemos creado la conexión de evento siguiente:

Como se puede observar, en la propiedad señal hemos establecido al valor acción disparada. Al hacerlo aparece una nueva propiedad llamada acción disparada en la que seleccionaremos la acción explicada anteriormente.

Por último, hemos añadido un botón al formulario que dispara la acción.

Evento value changed

Se trata de una señal que se dispara cuando cambia el contenido de un control de edición del formulario. La señal solamente se dispara cuando el usuario final interactúa directamente con el control, no cuando modificamos el contenido del campo o variable editado por proceso o desde un manejador de evento.

Para ello hemos programado el manejador al que hemos llamado VAL_CHG_ED_TXT. Como en ejemplos anteriores, solamente cambia el texto que se añade a la variable que usamos para mostrar los mensajes.

Y hemos declarado la conexión de evento siguiente:

Como podemos observar, en la propiedad señal hemos seleccionado el valor value changed y la señal está asociada al control de edición de texto que está bajo la rejilla.

Tal y como está programado en este momento, la señal se dispararía por cada pulsación de teclado que el usuario. Si queremos que no se dispara por cada pulsación sino que espere unos milisegundos para dispararse, entonces debemos editar el control de edición asociado y activarle el estilo retardo señal valueChanged:

Evento de cambio de ítem seleccionado

Rem ( Aumentamos un 1 a la variable usada como contador )
Set ( CNT, CNT + 1 )
Rem ( Leemos el registro seleccionado en la rejilla )
Interfaz: procesar ( CLT, Todas )
    Leer ficha seleccionada
        Rem ( Concatenamos a la variable que muestra los mensajes una línea que indica qué registro se ha seleccionado )
        Set ( MSJ, "" + MSJ + CNT + ". Registro seleccionado: "  + #ID + " - " + #NAME + ".<br>" )

En el manejador evento nos posicionamos sobre la rejilla, leemos el registro seleccionado y modificamos la variable que usamos para los mensajes con los datos del mismo.

En este caso también es necesario crear una (que hemos llamado TUT_EVE_ACC). La acción debe tener asignado el valor disparar señal en la propiedad comando.

Se trata de un evento específico para objetos de lista, por ejemplo, para . Se trata de disparar un manejador de evento cada vez que cambie el ítem seleccionado en la rejilla. Para ello hemos programado el manejador de evento llamado CAM_SEL_REJ:

acción
rejillas
manejador de evento
proceso
conexión de evento
formulario
aquí
aquí