AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Sintaxis WLanguage / Procedimientos WLanguage
  • Presentación
  • Documentación automática
  • Ajustes
  • ¿Qué se incluye en los comentarios?
  • Observación: borrado de parámetros
  • Entrada predictiva
  • Entrada asistida en los procedimientos y métodos de la clase
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
Para simplificar el mantenimiento o el uso del código existente por parte de otros desarrolladores, WINDEV, WEBDEV y WINDEV Mobile proponen una documentación automatic para los procedimientos (o métodos de clase).
Esta documentación de automatic corresponde a un set de comentarios. Estos comentarios se generan:
  • Cuando se crea una nueva Procedure o método.
    Puede elegir si desea generar comentarios en la ventana que se muestra al crear un procedimiento o método (opción "Generar un comentario de encabezado"). Los comentarios generados se ajustarán a la Parámetros de la documentación de automatic.
  • A través de Comentarios (que se encuentra en la esquina superior derecha de la ventana de código de Procedure). Este icono se utiliza para generar o eliminar un conjunto de comentarios para la actual Procedure.
También es posible:
  • Sincronizar automáticamente los comentarios generados según la sintaxis de los procedimientos. Modificando la sintaxis se actualizan automáticamente los comentarios de associated (durante la copia de seguridad).
  • Utilizar la entrada asistida al escribir la llamada a los procedimientos o métodos documentados.. Para obtener más información, consulte Entrada predictiva.
Documentación automática

Ajustes

Para configurar la documentación de automatic:
  1. En la pestaña "Inicio", en el grupo "Entorno", despliegue "Opciones" y seleccione "Opciones del editor de código".
  2. Visualice la pestaña "Doc.
Opciones de edición
Importante: Cada bloque de comentarios debe cumplir con el formato que se presenta a continuación. Especialmente, la description de cada parámetro así como la description de valor de retorno debe hacerse en una sola Line. De lo contrario, pueden aparecer desviaciones.

¿Qué se incluye en los comentarios?

Los comentarios de una función o Procedure pueden contener los siguientes elementos:
  • Resumen: la correspondiente comment es la siguiente:
    Resumen
  • Encabezado para describir el Procedure: la correspondiente comment es la siguiente:
    Cabecera de description
  • Sintaxis de llamada: la correspondiente comment es la siguiente:
    Sintaxis
  • Detalles de los parámetros: el comment correspondiente es el siguiente:
    Detalles de los parámetros
  • automatic timer: el comentario correspondiente se utiliza para describir el temporizador automatic definido para la función o para el Procedure:
    automatic timer
  • Gestión automática de errores y excepciones: la comment correspondiente se utiliza para describir el modo de gestión de los errores y excepciones (definido mediante el enlace "Si error" de la barra de encabezamiento de Procedure). Por ejemplo:
    Errores y excepciones
  • Observación: el comment correspondiente es el siguiente:
    Nota
  • Ejemplo: el comment correspondiente es el siguiente:
    Ejemplo
  • Marca que indica que el procedimiento debe documentarse: el comment correspondiente es el siguiente:
    Mark

Observación: borrado de parámetros

Si se especifica un parámetro en la sintaxis Procedure, si se elimina, el reference al parámetro sigue siendo Visible en la sección "Detalles de los parámetros" de los comentarios.
El texto tecleado por el desarrollador en relación con el parámetro debe ser borrado manualmente por el desarrollador (limita los riesgos de borrado por "error").
La opción "Sincronizar los comentarios con la sintaxis de los procedimientos" sirve para mantener actualizados los comentarios independientemente de las modificaciones realizadas.
Entrada predictiva

Entrada asistida en los procedimientos y métodos de la clase

Si los parámetros de un procedimiento han sido documentados y si la entrada asistida está disponible en el editor de código, al escribir la llamada al procedimiento, la sintaxis y la description de los parámetros se muestran en un tooltip. Por ejemplo:
  1. Documentación de la Procedure
    Documentación de la Procedure
  2. Aportación asistida en la Procedure
    Tooltip (entrada asistida)
El mecanismo de entrada asistida para los procedimientos y métodos es idéntico al mecanismo utilizado para las funciones de WLanguage.. Para más detalles sobre los parámetros de entrada asistida en WINDEV, WEBDEV o WINDEV Mobile, véase Entrada asistida para las funciones WLanguage.
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 04/07/2023

Señalar un error o enviar una sugerencia | Ayuda local