TaskObject.<Nombre de la tarea>

ObtenerFormulario

Sintaxis:

ObtenerFormulario(<Formulario>, <Propietario>, <ClaveUnica>)

Parámetros:

Tipo: Cadena, ObjetoMetadata: Formulario.
Nombre del formulario tal como se especifica en el Administrador de Configuración, o el objeto de descripción de metadatos del formulario requerido. Si no se especifica el parámetro, se utiliza el formulario principal (según la configuración del diseñador).

Tipo: Formulario; Control.
Un objeto que será el propietario del formulario abierto.

Tipo: Arbitrario.
Este parámetro se puede utilizar para establecer una clave con un valor que se utilizará para buscar formularios que ya han sido abiertos. Al buscar, se comprueban los valores de las propiedades de los formularios abiertos con los valores correspondientes de los parámetros del método. Si se encuentra un formulario abierto (todos los parámetros son concurrentes), se devolverá en lugar de un nuevo formulario. Si se requiere abrir nuevas instancias de otros formularios desde un formulario (con el mismo propietario), entonces el valor de este parámetro debe ser único (dentro de los valores correspondientes de las propiedades de los formularios abiertos) en cada llamada del método. El valor del parámetro se asigna a una propiedad del formulario UniqueKey que se está abriendo. Cabe señalar que al obtener el formulario del “objeto”, el sistema obtiene un formulario para una instancia específica del objeto, teniendo en cuenta la combinación de los parámetros pasados, mientras que para los fines de una “referencia” siempre hay solo un objeto en la base de datos, y el formulario obtenido es uno y el mismo (para la misma combinación de parámetros).

Valor devuelto:

Tipo: Formulario, Indefinido.
Indefinido – si se establece la bandera de cancelación de creación de formulario en el controlador OnCreateAtServer.

Descripción:

Obtiene un formulario de la tarea que contiene este objeto de script.

Disponibilidad:

Cliente grueso.

Nota:

Antes de que se ejecute el método, se analizan los parámetros de llamada y, si es necesario, la llamada se delega al contexto global.

Disponible desde:

Disponible desde la versión 8.0.