DO FORM (Comando)
Ejecuta un formulario o un conjunto de formularios compilado que se ha creado con el Diseñador de formularios.
DO FORM FormName | ? [NAME VarName [LINKED]] [WITH cParameterList]
[TO VarName] [NOREAD] [NOSHOW]
Parámetros
FormName
Especifica el nombre del formulario o conjunto de formularios que se van a ejecutar.?
Muestra el cuadro de diálogo Ejecutar, en el que podrá elegir un formulario o un conjunto de formularios para ejecutar.NAME VarName [LINKED]
Especifica una variable o un elemento de matriz con el que puede hacer referencia al formulario o al conjunto de formularios. Si especifica una variable que no existe, Microsoft Visual FoxPro la crea automáticamente. Si especifica un elemento de matriz, la matriz debe existir antes de que ejecute DO FORM. Si ya existe la variable o el elemento de matriz que especifica, se sobrescribe su contenido.Si omite la cláusula NAME, Visual FoxPro crea una variable de tipo Object con el mismo nombre que el archivo del formulario o el conjunto de formularios.
Incluya LINKED para vincular el formulario a la variable asociada a él, de forma que se libere el formulario cuando la variable esté fuera de alcance. Si no incluye LINKED, un formulario podrá seguir activo, incluso si no tiene ninguna variable de objeto asociada a él.
WITH cParameterList
Especifica los parámetros que se transfieren al formulario o al conjunto de formularios.Si se ejecuta un conjunto de formularios, los parámetros se transfieren al método Init del conjunto de formularios si la propiedad WindowType del conjunto de formularios está establecida como Sin modo (0) o Modal (1). Los parámetros se transfieren al método Load si la propiedad WindowType del conjunto de formularios está establecida como Read (2) o ReadModal (3).
TO VarName
Especifica una variable para contener un valor devuelto del formulario. Si la variable no existe, Visual FoxPro la crea automáticamente. Use el comando RETURN en el procedimiento de evento Unload del formulario para especificar el valor devuelto. Si no incluye un valor de retorno, se devolverá el valor predeterminado de verdadero (.T.). Para poder usar TO, la propiedad WindowType del formulario debe estar establecida como 1 (Modal).NOREAD
Especifica que se crea y muestra el conjunto de formularios, pero los controles no se activan hasta que se ejecuta READ. NOREAD se pasa por alto si la propiedad WindowType del objeto FormSet no está establecida como 2 (Lectura).NOSHOW
Especifica que no se llame al método Show del formulario cuando se esté ejecutando el formulario. Al incluir NOSHOW y ejecutar el formulario, el formulario no estará visible hasta que se establezca en verdadero (.T.) la propiedad Visible del formulario o hasta que se llame al método Show del formulario.
Observaciones
DO FORM ejecuta el método Show para el formulario o el conjunto de formularios.
Las configuraciones Read (2) y ReadModal (3) de la propiedad WindowType se incluyen por razones de compatibilidad con versiones anteriores y sólo están disponibles para aquellos formularios convertidos desde versiones anteriores de FoxPro.
Ejemplo
El ejemplo siguiente ejecuta el ejemplo de control de cronómetro (Swatch.scx).
DO FORM (HOME(2) + 'Solution\Controls\Timer\Swatch.scx')