field

El objeto field describe un contenedor interactivo capaz de capturar y mostrar contenido de datos.

En cuanto a los objetos disponibles en la Biblioteca de objetos de Designer, el objeto field es la definición XML base para los siguientes objetos:

Códigos de barras
Botón
Campo de fecha y hora
Campo decimal
Campo de firma
Botón de envío por correo electrónico
Botón Enviar HTTP
Campo de imagen
Campo numérico
Código de barras de formularios impresos
Campo de contraseña
Botón Imprimir
Botón Restablecer
Campo de texto

Puede definir mensajes de validación personalizados. Un solo campo puede contener un máximo de tres mensajes, uno para la prueba de la secuencia de comandos, otro para la prueba de la imagen y otro para la prueba de valor nulo. Cuando se especifiquen, acceda a ellos a través de la sintaxis siguiente:

field.validate.message.scriptTest.value 
field.validate.message.formatTest.value 
field.validate.message.nullTest.value

También puede acceder a estos mensajes de validación con sus propiedades de método abreviado:

field.validationMessage 
field.formatMessage 
field.mandatoryMessage

Cuando los valores no se rellenan, el procesador crea un mensaje predeterminado.

Un campo puede contar como máximo con una prueba de validación en caso de estado de error en cualquier momento. Las pruebas de validación se evalúan en el orden siguiente y la evaluación se detiene con la primera prueba que falle:

Jerarquía de objetos

Modelo

Objetos secundarios

Clase principal

clase container

Propiedades

Nombre	Descripción	Tipo	Acceso
{default}	Representa el valor real almacenado por un objeto.	Varía	Lectura/escritura
access	Controla el acceso del usuario al contenido de un contenedor, como un subformulario.	Cadena	Lectura/escritura
accessKey	Especifica una tecla aceleradora utilizada por una aplicación interactiva para mover la selección al elemento de un campo concreto.	Cadena	Lectura/escritura
anchorType	Especifica la ubicación del punto de ancla que se coloca utilizando una estrategia de presentación colocada.	Cadena	Lectura/escritura
borderColor	Especifica el valor de color de borde de este campo.	Cadena	Lectura/escritura
borderWidth	Especifica el ancho de borde de este campo.	Cadena	Lectura/escritura
colSpan	Especifica el número de columnas distribuidas por este objeto cuando se utiliza en un subformulario con un tipo de presentación de filas.	Cadena	Lectura/escritura
editValue	Especifica el valor de edición del campo.	Cadena	Lectura/escritura
errorText	Devuelve el mensaje de validación para la primera prueba de validación errónea o una cadena vacía siempre y cuando este campo haya superado todas las pruebas de validación.	Cadena	Lectura
fillColor	El valor de color de fondo de este campo.	Cadena	Lectura/escritura
fontColor	Especifica el valor de color de primer plano del campo. Es el equivalente de la expresión font.fill.color.value.	Cadena	Lectura/escritura
formatMessage	Especifica la cadena del mensaje de validación de formato para este campo.	Cadena	Lectura/escritura
formattedValue	Especifica el valor formateado del campo.	Cadena	Lectura/escritura
h	Una medición del alto para la presentación.	Cadena	Lectura/escritura
hAlign	Especifica la alineación de texto horizontal.	Cadena	Lectura/escritura
length	Especifica el número de objetos de la lista.	Entero	Lectura
locale	Especifica el idioma, la moneda y el formato de fecha/hora que deben usarse para el contenido del objeto.	Cadena	Lectura/escritura
mandatory	Especifica el valor nullTest del campo.	Cadena	Lectura/escritura
mandatoryMessage	Especifica la cadena de mensaje obligatoria para este campo.	Cadena	Lectura/escritura
maxH	Especifica el alto máximo para fines de presentación.	Cadena	Lectura/escritura
maxW	Especifica el ancho máximo para fines de presentación.	Cadena	Lectura/escritura
minH	Especifica el alto mínimo para fines de presentación.	Cadena	Lectura/escritura
minW	Especifica el ancho mínimo para fines de presentación.	Cadena	Lectura/escritura
parentSubform	Especifica el subformulario principal (página) de este campo.	Objeto	Lectura
presence	Indica la visibilidad de un objeto.	Cadena	Lectura/escritura
rawValue	Especifica el valor sin formato del objeto actual.	Varía	Lectura/escritura
relevant	Controla si un objeto de formulario se incluye cuando se imprime el formulario.	Cadena	Lectura/escritura
rotate	Gira el objeto el ángulo especificado en torno a su punto de ancla.	Cadena	Lectura/escritura
selectedIndex	El índice del primer elemento seleccionado.	Entero	Lectura/escritura
use	Invoca un prototipo.	Cadena	Lectura/escritura
usehref	Invoca un prototipo externo.	Cadena	Lectura/escritura
validationMessage	Especifica la cadena de mensaje validada para este campo.	Cadena	Lectura/escritura
vAlign	Especifica la alineación de texto vertical.	Cadena	Lectura/escritura
w	Medición que especifica el ancho para la presentación.	Cadena	Lectura/escritura
x	Indica la coordenada x del punto de ancla del contenedor en relación con la esquina superior izquierda del contenedor principal cuando se coloca con posición variable.	Cadena	Lectura/escritura
y	Especifica la coordenada Y del punto de ancla del contenedor en relación con la esquina superior izquierda del contenedor principal cuando se coloca con posición variable.	Cadena	Lectura/escritura

Métodos

Nombre	Descripción	Devuelve
addItem	Agrega nuevos elementos al campo de formulario actual. Por ejemplo, este método agrega nuevos elementos a una lista desplegable.	Vacío
boundItem	Obtiene el valor de enlace de un elemento concreto de visualización específico de una lista desplegable o cuadro de lista.	Cadena
clearItems	Quita todos los elementos del campo. Por ejemplo, quita todos los elementos contenidos dentro de una lista desplegable o un cuadro de lista.	Vacío
deleteItem	Elimina el elemento especificado.	Booleano
execCalculate	Ejecuta cualquier secuencia de comandos en el suceso calculate del objeto especificado así como cualquier objeto secundario.	Vacío
execEvent	Ejecuta la secuencia de comandos de suceso del objeto.	Vacío
execInitialize	Ejecuta cualquier secuencia de comandos en el suceso initialize del objeto especificado así como cualquier objeto secundario.	Vacío
execValidate	Ejecuta cualquier secuencia de comandos en el suceso validate del objeto especificado así como cualquier objeto secundario.	Vacío
getDisplayItem	Recupera el texto de visualización del elemento para el índice del elemento especificado.	Cadena
getItemState	Devuelve el estado de selección del elemento especificado.	Booleano
getSaveItem	Recupera el valor de los datos para el índice del elemento especificado.	Cadena
setItemState	Define el estado de selección del elemento especificado.	Vacío
setItems	Agrega nuevos elementos y valores al campo de formulario actual. Por ejemplo, este método agrega nuevos elementos y valores como argumentos a una lista desplegable.	Vacío