4D Doc Center : Utilizar los métodos de objeto

4D v14.3

Utilizar los métodos de objeto

Puede asociar un método a cualquier objeto activo de un formulario. Los métodos asociados a objetos individuales de un formulario se llaman métodos de objeto.

Los siguientes son algunos de los usos más comunes de los métodos de objeto:

Hacer cumplir las restricciones de entrada de datos,
Inicializar y manejar los objetos de interfaz tales como pestañas, menús desplegables, listas desplegables, list box, combo box, listas jerárquicas y menús desplegables.
Definir la acción que se realiza cuando se hace clic o doble clic en un objeto,
Manejar operaciones de arrastrar y soltar.

Estos son algunos ejemplos simples de operaciones realizadas en los datos.

El siguiente método calcula un total basado en los datos de otros dos campos:

Linea Total:=[Productos]Precio *[Ordenes]Cantidad

Este es un método que pasa a mayúsculas los caracteres en un campo Nombre:

[Clientes]Nombre:=Uppercase([Clientes]Nombre)

El siguiente método concatena valores de un campo Nombre y un campo Apellido y los asigna una variable llamada vNombre:

vNombre:=[Empleados]Nombre+" "+[Empleados]Apellido

Como cada método de objeto está asociado a su objeto, usted crea métodos de objeto desde el editor de formularios. Para mayor información sobre cómo usar el editor de métodos, consulte la sección Editar métodos.

Los eventos de objetos

Los métodos de objeto se ejecutan cuando se producen ciertos eventos. Por ejemplo, la acción asociada a una pestaña tiene sentido sólo cuando un usuario hace clic en la pestaña. En un área de desplazamiento, puede ejecutar el método sólo cuando el usuario hace doble clic en un elemento.
En la sección “Eventos” de la Lista de propiedades puede definir los eventos que ejecutarán el método del objeto para un objeto particular. La lista contiene todos los eventos de formulario pertinentes para el objeto seleccionado. Algunos eventos sólo están disponibles para tipos de objetos específicos. Igualmente existen eventos adicionales que sólo se generan a nivel de formulario. Para una descripción detallada de todos los eventos de formulario, consulte el comando Evento formulario en el manual de Lenguaje 4D.

Seleccione un evento haciendo clic en la casilla de selección asociada. Para seleccionar o deseleccionar todos los eventos de una vez, presione la tecla Ctrl (Windows) o Comando (Mac OS) mientras hace clic en cualquier evento.

Si necesita ejecutar diferentes instrucciones para varios eventos diferentes, utilice una instrucción Case of...Else...End case en su método y pruebe para cada evento seleccionado en la sección Eventos. Para probar un evento, utilice la función Evento formulario y las constantes del tema Eventos de formulario . Un ejemplo de estructura de método de objeto se ve así:

 Case of

    :(Form event=On Load)

  //Ubique el código a ejecutar cuando se abra el formulario

 

    :(Form event=On Data Change)

  //Ubique el código a ejecutar cuando los contenidos del objeto se modifiquen

 

    :(Form event=On Validate)

  //Ubique el código a ejecutar cuando el formulario se valide

 End case

Crear un método de objeto

Para crear un método de objeto:

En el editor de formularios, seleccione el objeto al cual quiere asociar un método.
Haga clic en el botón Editar ubicado al lado de la línea Método del objeto (tema “Acción”) en la Lista de propiedades.
O
Elija Método del objeto del menú Objeto.
O
Haga clic derecho en el objeto y elija Método de objeto en el menú contextual.
O
Mantenga presionada la tecla Alt (Windows) u Opción (Mac OS) y haga clic en el campo u objeto.
4D muestra una nueva ventana del editor de métodos, vacía por defecto. El nombre del método es “Método de Objeto:” seguido por el nombre del objeto o campo.
Escriba el método como se describió en el capítulo Editar métodos luego cierre la ventana y grabe su trabajo.
El método ahora se asocia con el campo u objeto activo. Puede visualizar los objetos asociados a un método desplegando las marcas “Método de objeto”:

Puede visualizar o modificar un método en cualquier momento.

Abrir un método objeto

Para abrir un método objeto:

En el editor de formularios, seleccione el objeto cuyo método quiere abrir.
Haga clic en el botón Editar.. ubicado junto a la línea Método de objeto (tema "Acción") en la lista de propiedades.
O
Elija Método del objeto en el menú Objeto.
O
Haga clic derecho en el objeto y elija el comando Método del objeto en el menú contextual.
O
Mantenga presionada la tecla Alt (Windows) u Opción (Mac OS) y haga clic en el objeto al cual está asociado el método.
El editor de métodos aparece con su método, listo para que modifique el código.

Borrar un método objeto

Puede borrar un método de objeto en cualquier momento. Para hacerlo, seleccione el objeto al cual el método está asociado y luego elija Suprimir método del objeto del menú Objeto.