Compartir a través de

Personalizar el Asistente para documentación

  • Artículo

Además de las opciones que puede elegir al ejecutar el Asistente para documentación, puede personalizar otras opciones fuera del asistente.

Sangría en estructuras CASE

De forma predeterminada, el asistente busca una sangría en una estructura CASE, como se muestra a continuación:

DO CASE
CASE case1=1
   case2=2
CASE case3=3
   case4=4
ENDCASE

Algunos programadores prefieren aplicar una sangría adicional (un nivel más) a las líneas entre DO CASE y ENDCASE, como muestra este ejemplo:

DO CASE
   CASE case1=1
      case2=2
   CASE case3=3
      case4=4
ENDCASE

Si aplica sangría a las estructuras CASE como en el segundo ejemplo, debe especificarlo en Fdkeywrd.dbf. Para especificar esta preferencia en Fdkeywrd.dbf, cambie el valor del campo Código del registro ENDCASE a "UU".

Comandos para el asistente

Puede colocar directivas especiales en los archivos de código para indicar al Asistente para documentación que realice determinadas tareas al analizar el código.

Puede colocar directivas en:

  • El archivo del programa principal del proyecto, para indicar al asistente cómo debe analizar todos los archivos de código del proyecto.
  • Los archivos de código individuales, para indicar al asistente cómo debe analizar archivos específicos.

La sintaxis de las directivas comienza con un asterisco, para que Visual FoxPro los trate como comentarios y los pase por alto al compilar los programas. Las directivas no distinguen entre mayúsculas y minúsculas. La sintaxis de estas directivas es la siguiente:

*# document directive

Es aconsejable colocar las directivas cerca del comienzo del archivo del programa principal, para que el Asistente para documentación las encuentre cuando comience el análisis.

A continuación se describen las directivas del Asistente para documentación.

  • *# document ACTIONCHARS "abcdef"
    De forma predeterminada, cuando el asistente crea un Diagrama de acción o un Diagrama de árbol, utiliza seis caracteres que aparecen como líneas rectas y esquinas si se utilizan las páginas de códigos ASCII 1250 o ANSI 1252 en FoxFont. No todos estos caracteres están asignados a caracteres de línea cuando se ven en otras páginas de códigos. Los seis caracteres predeterminados y sus correspondientes caracteres FoxFont son los que se indican a continuación como a, b, c, d, e y f.
    abcdef Valor Chr( ) predeterminado Cómo se ve en FoxFont
    a 32 (espacio)
    b 196
    c 179
    d 218
    e 192
    f 195

Sugerencia   Cuando utilice otras páginas de códigos, inserte el siguiente código en el archivo del programa principal para garantizar que las líneas de los diagramas se asignen a caracteres similares a líneas (el primer carácter de la cadena de caracteres que aparece entre comillas es un espacio en blanco):

*# document ACTIONCHARS " -|+++"

Nota   Si desea ver una lista con las páginas de códigos compatibles, consulte Páginas de códigos compatibles con Visual FoxPro.

  • *# document XREF cMode
    Activa las referencias cruzadas de variables. El valor predeterminado es activado (ON).

    cMode Descripción
    ON Activa las referencias cruzadas de variables
    OFF Desactiva las referencias cruzadas de variables
    SUSPENDER Desactiva las referencias cruzadas de variables en el archivo actual, hasta que el Asistente para documentación encuentre la siguiente aparición de:

    *# document XREF ON

  • *# document EXPANDKEYWORDS cMode
    Activa la expansión de las palabras clave. Por ejemplo, "DEFI WIND" se expandiría a "DEFINE WINDOW". El valor predeterminado es OFF.

    Precaución   No todas las palabras clave de Visual FoxPro comienzan con una cadena única de cuatro caracteres. Por ejemplo, "REPL" puede ser la abreviatura de "REPLACE" o "REPLICATE". Extreme las precauciones si incluye esta directiva y elige sobrescribir los archivos existentes.

    cMode Descripción
    ON Activa la expansión de palabras clave
    OFF Desactiva la expansión de palabras clave
    SUSPENDER Desactiva la expansión de palabras clave en el archivo actual, hasta la siguiente aparición de:

    *# document EXPANDKEYWORDS ON

  • *# document XREFKEYWORDS cMode
    Esta directiva corresponde a la opción Referencia cruzada de palabras clave del "Paso 6 – Finalizar" del Asistente para documentación. El valor predeterminado es OFF.

    cMode Descripción
    ON Activa las referencias cruzadas de palabras clave
    OFF Desactiva las referencias cruzadas de palabras clave
    SUSPENDER Desactiva las referencias cruzadas de palabras clave para el archivo actual, hasta la siguiente aparición de:

    *# document XREFKEYWORDS ON

  • *# document ARRAYBRACKETS cMode
    El valor predeterminado es OFF.

    cMode Descripción
    ON El Asistente para documentación supone que se usan corchetes para las matrices y paréntesis para las funciones y métodos.
    OFF El Asistente para documentación trata los corchetes y paréntesis como matrices.

  • *# document ACTIONINDENTLENGTH nSpace
    nSpace es el número de caracteres espacio que desea que el Asistente para documentación use para la sangría. El valor mínimo permitido es 2.

Vea también

Asistente para documentación | Introducción a los asistentes | Páginas de códigos compatibles con Visual FoxPro | Asistente para documentación: paso 1 – Elegir archivo de origen | Asistente para documentación: paso 2 – Definir uso de mayúsculas | Asistente para documentación: paso 3 – Definir sangrías | Asistente para documentación: paso 4 – Agregar encabezados | Asistente para documentación: paso 5 – Seleccionar informes | Asistente para documentación: paso 6 - Finalizar