4D Doc Center : FORM GET NAMES

4D v13.4

FORM GET NAMES


FORM GET NAMES ( {tabla ;} arrayNoms {; filtro}{; *} )

Parámetro	Tipo	Descripción
tabla	Tabla	Referencia de tabla
arrayNoms	Array texto	Array de nombres de formulario
filtro	Texto	Filtro de nombres
*	Operador	Si se pasa = el comando se aplica a la base local cuando se ejecuta desde un componente (parámetro ignorado fuera de este contexto)

Descripción

El comando FORM GET NAMES llena el array arrayNoms con los nombres de los formularios de la aplicación.

Si pasa el parámetro tabla, el comando devuelve los nombres de los formularios tabla asociados a esta tabla. Si omite este parámetro, el comando devuelve los nombres de los formularios proyecto de la base.

Puede limitar esta lista de formularios pasando una cadena de comparación en el parámetro filtro: en este caso, sólo se devuelven los formularios cuyos nombres corresponden al filtro. Puede utilizar el carácter @ para definir los filtros de tipo "comienza por", "termina en" o "contiene". Si pasa una cadena vacía, se ignora el parámetro filtro.

Si el comando se ejecuta desde un componente, devuelve por defecto los nombres de los formularios proyecto del componente. Si pasa el parámetro *, el array contendrá los formularios de la base local.

Nota: los formularios ubicados en la papelera no se listan.

Ejemplo

Ejemplos de uso típico:

  // Lista de todos los formularios proyecto de la base

 FORM GET NAMES(arr_Names)

 

  // Lista de formularios de la tabla [Empleados]

 FORM GET NAMES([Empleados] ;arr_Names)

 

  // Lista de formularios "input" de la tabla [Empleados]

 FORM GET NAMES([Empleados] ;arr_Names;"input_@")

 

  // Lista de formularios proyecto especificos de la base

 FORM GET NAMES(arr_Names;"dialogue_@")

 

  // Lista de formularios tabla desde un componente

  // Un puntero es necesario porque se desconoce el nombre de la tabla

 FORM GET NAMES(tablePtr->;arr_Names;*)