- align
- El campo align especifica la posición de
datos en un campo de longitud variable cuando la longitud de los datos es menor que la longitud
del campo.
- Tipo: AlignKind
- Ejemplo: align = left
- Valor predeterminado: left para datos de tipo carácter o de indicación de la hora, right para datos numéricos
- ¿Actualizable durante la ejecución? Sí
Los valores son los siguientes:
- left
- Colocar los datos a la izquierda del campo. Los espacios iniciales se colocan al final del campo.
- none
- No justificar los datos. Este valor solamente es válido para los datos de tipo
carácter.
- right
- Colocar los datos a la derecha del campo. Los espacios finales se colocan al principio del campo.
- autonext
- Indica si, después de que el usuario ha rellenado el ConsoleField actual, el cursor va al campo siguiente.
- Tipo: Boolean
- Ejemplo: autonext = yes
- Valor predeterminado: None
- ¿Actualizable durante la ejecución? Sí
El orden de tabulación determina cuál es el siguiente ConsoleField, como se describe en el apartado Componentes de ConsoleUI y variables relacionadas.
- binding
- Especifica el nombre de la variable a la que está enlazado el ConsoleField de forma predeterminada.
- Tipo: String
- Ejemplo: binding = "myVar"
- Valor predeterminado: None
- ¿Actualizable durante la ejecución? No.
Para obtener una visión general de los enlaces, consulte el apartado Componentes de ConsoleUI y variables relacionadas.
- caseFormat
- Especifica cómo tratar la entrada y la salida en relación con la distinción entre mayúsculas y minúsculas.
- Tipo: CaseFormatKind
- Ejemplo: caseFormat = lowerCase
- Valor predeterminado: defaultCase
- ¿Actualizable durante la ejecución? Sí
Los valores son los siguientes:
- defaultCase (valor predeterminado)
- No tiene ningún efecto sobre las mayúsculas y minúsculas
- lowerCase
- Transforma los caracteres a minúsculas, siempre que sea posible
- upperCase
- Transforma los caracteres a mayúsculas, siempre que sea posible
- color
- Especifica el color del texto en el ConsoleField.
- Tipo: ColorKind
- Ejemplo: color = red
- Valor predeterminado: white
- ¿Actualizable durante la ejecución? Sí, pero la actualización sólo tiene un efecto visuall si el ConsoleField se visualiza (u obtiene el foco) después de que se actualice el campo
Los valores son los siguientes:
- defaultColor o white (valor predeterminado)
- Blanco
- black
- Negro
- blue
- Azul
- cyan
- Cian
- green
- Verde
- magenta
- Magenta
- red
- Rojo
- yellow
- Amarillo
- comment
- Especifica el comentario, que es el texto que se visualiza en la línea de comentario específica de Window (si existe) cuando el cursor está en el ConsoleField.
- Tipo: String
- Ejemplo: "Employee name"
- Valor predeterminado: Serie vacía
- ¿Actualizable durante la ejecución? No
- commentKey
- Especifica una tecla que se utiliza para buscar el paquete de recursos que incluye el comentario, que es el texto que se visualiza en la línea de comentario específica de Window (si existe) cuando el cursor está en el ConsoleField. Si especifica a la vez comment y commentKey, se utiliza comment.
- Tipo: String
- Ejemplo: commentKey = "myKey"
- Valor predeterminado: Serie vacía
- ¿Actualizable durante la ejecución? No
El paquete de recursos se identifica mediante la variable de sistema ConsoleLib.messageResource, tal como se describe en messageResource.
- dataType
- Especifica una serie para identificar un tipo de datos. El valor se utiliza para validar que la entrada de usuario (como por ejemplo = 1.5) es compatible con una determinada clase de columna SQL. El campo sólo es relevante cuando la sentencia openUI para el ConsoleField (o ConsoleForm relacionado) incluye la propiedad isConstruct de la sentencia.
- Tipo: String
- Ejemplo: dataType = "NUMBER"
- Valor predeterminado: Serie vacía
- ¿Actualizable durante la ejecución? No
En relación con una entrada numérica, especifique el valor "NUMBER" si permite que el usuario especifique un valor de coma flotante (en cuyo caso, > 1.5 es una entrada de usuario válida); en caso contrario, especifique la serie equivalente de un enterio; por ejemplo, "INT".
- dateFormat
Indica cómo dar formato a la salida; pero sólo especifique
dateFormat si el ConsoleField acepta una fecha.
- Tipo: String o una constante del sistema relacionada con la fecha
- Ejemplo: dateFormat = isoDateFormat
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? No
Los valores válidos son los siguientes:
- "patrón"
- El valor de patrón consiste en un conjunto de caracteres, tal como se
describe en la sección Especificadores de formato de fecha, hora e indicación de la hora.
Los caracteres pueden eliminarse desde el inicio o el final de una especificación de fecha completa, pero no desde el medio.
- defaultDateFormat
- El formato de fecha especificado en el entorno local de ejecución de
Java.
- isoDateFormat
- El patrón "aaaa-MM-dd", que es el formato de fecha especificado por International
Standards Organization (ISO).
- usaDateFormat
- El patrón "MM/dd/aaaa", que es el formato de fecha estándar para EE.UU. de
IBM.
- eurDateFormat
- El patrón "dd.MM.aaaa", que es el formato de fecha estándar europeo de
IBM.
- jisDateFormat
- El patrón "aaaa-MM-dd" que es el formato de fecha estándar industrial japonés.
- systemGregorianDateFormat
- Un patrón de 8 ó 10 caracteres que incluye dd (para día del mes numérico), MM (para mes numérico) y aa
o aaaa (para año numérico), con caracteres que no sean d, M, a ni dígitos utilizados como
separadores.
El formato está en la siguiente propiedad de entorno de ejecución
Java:
vgj.datemask.gregorian.long.NLS
- NLS
- El código NLS (soporte de idioma nacional) especificado en la propiedad de entorno de ejecución
Java
vgj.nls.code. El código es uno de los que se listan en targetNLS. Inglés en mayúsculas (código ENP) no está soportado.
Para obtener más detalles acerca de vgj.nls.code, consulte el apartado
Propiedades de entorno de ejecución
Java
(detalles).
- systemJulianDateFormat
- Un patrón de 6 u 8 caracteres que incluye DDD (para día del mes numérico) y aa o aaaa (para año
numérico), con caracteres que no sean D, y ni dígitos como separadores.
El formato está en la siguiente propiedad de entorno de ejecución
Java:
vgj.datemask.julian.long.NLS
- NLS
- El código NLS (soporte de idioma nacional) especificado en la propiedad de entorno de ejecución
Java
vgj.nls.code. El código es uno de los que se listan en targetNLS. Inglés en mayúsculas (código ENP) no está soportado.
Para obtener más detalles acerca de vgj.nls.code, consulte el apartado
Propiedades de entorno de ejecución
Java
(detalles).
- editor
- Especifica el programa para la interacción de usuario con los los datos; pero sólo es relevante si el ConsoleField está enlazado a una variable de tipo LOB.
- Tipo: String
- Ejemplo: editor = "/bin/vi"
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? Sí
Puede especificar el nombre de un ejecutable que se encuentra en la PATH o LIBPATH; como alternativa, puede especificar la vía de acceso totalmente calificada de dicho ejecutable.
- help
- Especifica el texto que debe visualizarse cuando se produce la siguiente situación:
- El cursor está en el ConsoleField; y
- El usuario pulsa la tecla identificada en ConsoleLib.key_help.
- Tipo: String
- Ejemplo: help = "Actualizar el valor"
- Valor predeterminado: Serie vacía
- ¿Actualizable durante la ejecución? Sí
- helpKey
- Especifica una tecla de acceso para buscar el paquete de recursos que contiene el texto que debe visualizarse cuando se produce la siguiente situación:
- El cursor está en el ConsoleField; y
- El usuario pulsa la tecla identificada en ConsoleLib.key_help.
Si se especifica a la vez
help y
helpKey, se utiliza
help.
- Tipo: String
- Ejemplo: helpKey = "myKey"
- Valor predeterminado: Serie vacía
- ¿Actualizable durante la ejecución? Sí
El paquete de recursos se identifica mediante la variable de sistema ConsoleLib.messageResource, tal como se describe en messageResource.
- highlight
- Especifica los efectos especiales (si los hay) que se utilizan al visualizar el ConsoleField.
- Tipo: HighlightKind[]
- Ejemplo: highlight = [reverse, underline]
- Valor predeterminado: [noHighLight]
- ¿Actualizable durante la ejecución? Sí, pero la actualización sólo tiene un efecto visual si el ConsoleField se visualiza (u obtiene el foco) después de que se actualice el campo highlight
Los valores son los siguientes:
- noHighlight (valor predeterminado)
- No produce ningún efecto especial. La utilización de este valor altera temporalmente cualquier otro.
- blink
- No tiene ningún efecto
- reverse
- Invierte los colores del texto y del fondo, de forma que (por ejemplo), si la
pantalla tiene un fondo negro con letras blancas, el fondo pasa a ser blanco y el texto
pasa a ser negro.
- underline
- Coloca un subrayado debajo de las áreas afectadas. El color del subrayado es el color del texto, aunque también se haya especificado el valor reverse.
- initialValue
- Especifica el valor inicial que debe visualizarse. Si se especifica a la vez initialValue e initialValueKey, se utiliza initialValue.
- Tipo: String
- Ejemplo: initialValue = "200"
- Valor predeterminado: Serie vacía
- ¿Actualizable durante la ejecución? Sí
Si la propiedad setInitial de la sentencia openUI está establecida en true, se utiliza el valor de la propiedad initialValue del consoleField. Sin embargo, si dicha propiedad openUI es false, se mostrarán los valores actuales de las variables enlazadas y no se tendrá en cuenta el valor de la propiedad initialValue.
- initialValueKey
- Especifica una tecla de acceso para buscar el paquete de recursos que contiene el valor inicial que debe visualizarse. Si se especifica a la vez initialValue e initialValueKey, se utiliza initialValue.
- Tipo: String
- Ejemplo: initialValueKey = "myKey"
- Valor predeterminado: Serie vacía
- ¿Actualizable durante la ejecución? Sí
El paquete de recursos se identifica mediante la variable de sistema ConsoleLib.messageResource, tal como se describe en messageResource.
- inputRequired
- Indica si se impedirá al usuario alejarse del campo sin introducir un valor.
- Tipo: Boolean
- Ejemplo: inputRequired = yes
- Valor predeterminado: no
- ¿Actualizable durante la ejecución? No
- intensity
- Especifica la fuerza del font visualizado.
- Tipo: IntensityKind[]
- Ejemplo: intensity = [bold]
- Valor predeterminado: [normalIntensity]
- ¿Actualizable durante la ejecución? Sí, pero la actualización sólo tiene un efecto visual si el ConsoleField se visualiza (u obtiene el foco) después de que se actualice el campo intensity
Los valores son los siguientes:
- normalIntensity (valor predeterminado)
- No produce ningún efecto especial. La utilización de este valor altera temporalmente cualquier otro.
- bold
- Hace que el texto aparezca en negrita.
- dim
- No tiene ningún efecto en este momento. En el futuro, puede hacer que el texto aparezca con menor intensidad, según sea apropiado cuando el campo de entrada esté inhabilitado o se deba quitar el énfasis al mismo.
- invisible
- Elimina cualquier indicación de que el campo se encuentra en el formulario.
- isBoolean
- Indica si el ConsoleField representa un valor booleano. El campo isBoolean restringe los valores válidos de ConsoleField y es útil para la entrada o la salida.
El valor de un campo numérico es 0 (falso) o 1 (verdadero).
El valor de un campo de caracteres está representado por una palabra o un
subconjunto de una palabra que depende del idioma nacional, y los valores específicos están determinados por el entorno local. En Inglés, por ejemplo, un
campo booleano de tres o más caracteres tiene el valor
yes
(verdadero) o
no (falso) y el valor de un campo booleano de un
carácter tiene el valor truncado
y o
n.
- Tipo: Boolean
- Ejemplo: isBoolean = yes
- Valor predeterminado: no
- ¿Actualizable durante la ejecución? No
- lineWrap
- Indica cómo acomodar el texto en una línea nueva siempre que la acomodación es necesaria para no truncar el texto.
- Tipo: LineWrapType
- Ejemplo: value = compress
- Valor predeterminado: character
- ¿Actualizable durante la ejecución? Sí
Los valores son los siguientes:
- character (el valor por omisión)
- El texto de un campo no se dividirá en un espacio en blanco, sino en la posición de carácter donde está el límite del segmento de campo.
- compress
- Si es posible, el texto se dividirá en un espacio en blanco. Cuando el usuario abandone el consoleField (navegando a otro consoleField o pulsando Esc), el valor se asignará a la variable enlazada y se eliminarán los espacios adicionales utilizados para acomodar el texto.
- word
- Si es posible, el texto de un campo se dividirá en un espacio en blanco. Cuando el valor se asigna a la variable enlazada, se incluyen espacios adicionales para reflejar cómo se ha rellenado el valor para acomodarse a los límites de palabra.
El campo lineWrap sólo es relevante para un ConsoleField que tiene múltiples segmentos, ya que está controlado por la propiedad segments.
- masked
- Indica si cada carácter del ConsoleField se visualiza en forma de asterisco (*), según sea apropiado cuando el usuario escribe un contraseña.
- Tipo: Boolean
- Ejemplo: masked = yes
- Valor predeterminado: no
- ¿Actualizable durante la ejecución? Sí
- minimumInput
- Indica el número mínimo de caracteres en la entrada válida.
- Tipo: INT
- Ejemplo: minimumInput = 4
- Valor predeterminado: no
- ¿Actualizable durante la ejecución? No
- name
- Nombre de ConsoleField, tal como se utiliza en un contexto de programación en que el nombre se resuelve durante la ejecución. Se recomienda encarecidamente que el valor del campo name sea el mismo que el nombre de la variable.
- Tipo: String
- Ejemplo: name = "myField"
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? No
- numericFormat
Indica cómo dar formato a la salida; pero sólo especifique
numericFormat si el ConsoleField acepta un número.
- Tipo: String
- Ejemplo: numericFormat = "-###@"
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? No
Los caracteres válidos son los siguientes:
- #
- Un espacio reservado para un dígito.
- *
- Utilice un asterisco (*) como carácter de relleno para un cero inicial.
- &
- Utilice un cero como carácter de relleno para un cero inicial.
- #
- Utilice un espacio como carácter de relleno para un cero inicial.
- <
- Justifique a la izquierda el número.
- ,
- Utilice un separador numérico dependiente del entorno local a menos que la posición contenga un cero inicial.
- .
- Utilice una coma decimal dependiente del entorno local.
- -
- Utilice un signo menos (-) para los valores menores que 0; utilice un espacio para los valores mayores o iguales que 0.
- +
- Utilice un signo menos para los valores menores que 0; utilice un signo más (+) para los valores mayores o iguales que 0.
- (
- Preceda los valores negativos con un paréntesis izquierdo , según sea apropiado en la contabilidad.
- )
- Coloque un paréntesis derecho después de un valor negativo, según sea apropiado en la contabilidad.
- $
- Preceda el valor con un símbolo de moneda dependiente del entorno local.
- @
- Coloque el símbolo de moneda dependiente del entorno local después del valor.
- pattern
- Especifica el patrón para el formato de entrada y salida si el contenido de ConsoleField es de tipo carácter.
- Tipo: String
- Ejemplo: pattern = "(###) ###-####"
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? No
Los siguientes caracteres de control están disponibles:
- A es un espacio reservado para letras, y el subconjunto de caracteres que se consideran letras depende el entorno local
- # es un espacio reservado para dígitos numéricos
- X es un espacio reservado para un carácter obligatorio de cualquier clase
Los caracteres distintos a los tres anteriores se incluyen en la entrada o salida; pero para la salida, los caracteres recubiertos se pierden:
- protect
- Especifica si el ConsoleField está protegido contra la actualización de usuario.
- Tipo: Boolean
- Ejemplo: protect = yes
- Valor predeterminado: no
- ¿Actualizable durante la ejecución? No
Los valores son los siguientes:
- No (el valor por omisión)
- Establece el campo de forma que el usuario pueda sobreescribir el valor en él.
- Sí
- Establece el consoleField de forma que el usuario no pueda sobreescribir el valor en él.
Además, el cursor pasa por alto el consoleField siempre que el usuario intenta navegar al mismo, con en los casos siguientes:
- El usuario trabaja en el consoleField anterior por orden de tabulación y (a) pulsa el tabulador o (b) rellena ese consoleField anterior con contenido cuando el campo autonext está establecido en yes.
- El usuario trabaja en el consoleField siguiente por orden de tabulación y pulsa Mayúsculas Tabulador.
- El usuario utiliza las teclas de flecha para ir al consoleField siguiente o anterior.
Puede enlazar una variable a un consoleField que está protegido o no. El valor de la propiedad setInitial de openUI determina si se visualiza el valor de la variable enlazada.
Se produce un error de tiempo de ejecución si el programa intenta ir a un consoleField que está protegido.
- SQLColumnName
- Especifica el nombre de la columna de tabla de base de datos que está
asociada con el ConsoleField. El nombre se utiliza para crear criterios de búsqueda cuando la sentencia openUI para el ConsoleField (o ConsoleForm relacionado) incluye la propiedad isConstruct de la sentencia.
- Tipo: String
- Ejemplo: SQLColumnName = "ID"
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? Sí
- timeFormat
Indica cómo dar formato a la salida; pero sólo especifique
timeFormat si el ConsoleField acepta una hora.
- Tipo: String o una constante del sistema relacionada con la hora
- Ejemplo: timeFormat = isoTimeFormat
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? No
Los valores válidos son los siguientes:
- "patrón"
- El valor de patrón consiste en un conjunto de caracteres, tal como se
describe en la sección Especificadores de formato de fecha, hora e indicación de la hora.
Los caracteres pueden eliminarse desde el inicio o el final de una especificación de hora completa, pero no desde el medio.
- defaultTimeFormat
- El formato de hora especificado en el entorno local de ejecución de
Java.
- isoTimeFormat
- El patrón "HH.mm.ss", que es el formato de hora especificado por International Standards
Organization (ISO).
- usaTimeFormat
- El patrón "hh:mm AM", que es el formato de hora estándar de EE.UU. de
IBM.
- eurTimeFormat
- El patrón "HH.mm.ss", que es el formato de hora estándar europeo de
IBM.
- jisTimeFormat
- El patrón "HH:mm:ss", que es el formato de hora estándar industrial japonés.
- timestampFormat
Indica cómo dar formato a la salida; pero sólo especifique
timestampFormat si el ConsoleField acepta una indicación de la hora.
- Tipo: String o una constante del sistema relacionada con la indicación de la hora
- Ejemplo: timestampFormat = odbcTimestampFormat
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? No
Los valores válidos son los siguientes:
- "patrón"
- El valor de patrón consiste en un conjunto de caracteres, tal como se
describe en la sección Especificadores de formato de fecha, hora e indicación de la hora.
Los caracteres pueden eliminarse desde el inicio o el final de una especificación de indicación de la hora completa, pero no desde el medio.
- defaultTimestampFormat
- El formato de indicación de la hora especificado en el entorno local de ejecución de
Java.
- db2TimeStampFormat
- El patrón "aaaa-MM-dd-HH.mm.ss.ffffff", que es el formato de indicación de la hora
predeterminado de IBM
DB2.
- odbcTimestampFormat
- El patrón "aaaa-MM-dd HH:mm:ss.ffffff", que es el formato de indicación de la hora de ODBC.
- value
- El valor actual visualizado en el consoleField. El código puede establecer este valor de modo que la invocación de ConsoleLib.displayForm visualiza el valor especificado en el consoleField.
- Tipo: String
- Ejemplo: value = "View"
- Valor predeterminado: none
- ¿Actualizable durante la ejecución? Sí
- verify
- Indica si se solicita al usuario que vuelva a escribir el mismo valor después de intentar salir del ConsoleField.
- Tipo: Boolean
- Ejemplo: verify = yes
- Valor predeterminado: no
- ¿Actualizable durante la ejecución? No
Los valores son los siguientes:
- No (el valor por omisión)
- El entorno de ejecución EGL no emite una solicitud especial.
- Sí
- Cuando el usuario intenta abandonar el ConsoleField, el entorno de ejecución EGL
actúa de la manera siguiente:
- Borra el consoleField, manteniendo allí el cursor
- Muestra un mensaje para que el usuario repita la entrada
- Compara los dos valores de entrada cuando el usuario intenta volver a abandonar el consoleField
Si los valores coinciden, la variable enlazada recibe dicho valor y el proceso continúa da la forma habitual. Si los valores no coinciden, el contenido de consoleField vuelve al valor que precedía a la primera de las dos entradas de usuario, y el cursor permanece en el campo.