Este es el sitio web histórico de la documentación de 4D. La documentación se está trasladando progresivamente a developer.4d.com

Inicio

 
4D v19
Formularios dinámicos

Formularios dinámicos  


 

Formularios dinámicos son formularios cuyas estructuras se definen en un archivo .json o en un objeto 4D. Se regeneran cada vez que se ejecutan y ofrecen un nivel superior de flexibilidad. Algunas ventajas notables incluyen:

  • Usabilidad
    • actualizaciones sencillas
    • modificaciones dinámicas del usuario
    • fácil reutilización
    • búsqueda más rápida
  • Portabilidad
    • intercambio simplificado
    • puede ser almacenado en control de fuente

Cada objeto definido en un formulario dinámico, incluido el formulario en sí, tiene una o más propiedades. Consulte Directorio de páginas para ver rápidamente sus descripciones.

El siguiente es un archivo JSON simple ("HW.json", almacenado en la carpeta Recursos) con texto, una imagen y un botón:

{
    "windowTitle": "Hello World",
    "windowMinWidth": 220,
    "windowMinHeight": 80,
    "method": "HWexample",
    "pages": [
        null,
        {
            "objects": {
                "text": {
                "type": "text",
                "text": "Hello World!",
                "textAlign": "center",
                "left": 50,
                "top": 120,
                "width": 120,
                "height": 80
                },
                "image": {
                "type": "picture",
                "pictureFormat": "scaled",
                "picture": "/RESOURCES/Images/HW.png",
                "alignment":"center", 
                "left": 70,
                "top": 20, 
                "width":75, 
                "height":75        
                },
                "button": {
                "type": "button",
                "text": "OK",
                "action": "Cancel",
                "left": 60,
                "top": 160,
                "width": 100,
                "height": 20
                }
            }
        }
    ]
}

Este formulario se puede cargar en un diálogo con el siguiente código 4D:

 Open form window("/RESOURCES/HW.json")
 DIALOG("/RESOURCES/HW.json")

Que muestra:

Al crear formularios a partir de archivos, deben:

  • cumplir con el esquema JSON. El esquema de formulario JSON 4D se puede encontrar en la carpeta del programa 4D: Resources/formsSchema.json. Es su responsabilidad verificar la validez del archivo de formulario .json. Ver el comando JSON Validate.
  • estar en archivos con una extensión de archivo ".json".
  • almacenarse dentro del paquete de la aplicación, relativo al archivo de estructura.

Notas:

  • Los comentarios dentro de los archivos .json deben estar dentro de la propiedad "comentarios". Los caracteres de codificación estándar para comentarios (es decir, "//", "/ *", "'", etc.) renderizarán el archivo inválido.
  • Los arrays en JSON actúan como las colecciones en 4D.

Todas las rutas de archivos pueden ser relativas o absolutas. Deben utilizar '/' como delimitador de ruta y se resuelven de la siguiente manera:

  • Una ruta relativa no debe comenzar por '/'. Se resuelve relativamente al documento JSON donde se ha encontrado la cadena de ruta,
  • Una ruta absoluta comienza con '/'. Por razones de seguridad, solo se acepta "/RESOURCES" como ruta absoluta y se designa la carpeta de recursos de la base actual. Por ejemplo, "/RESOURCES/templates/myfile.json" apunta al archivo "myfile.json" ubicado en la carpeta de recursos de la base actual.

Notas:

  • La resolución del nombre es sensible a mayúsculas y minúsculas
  • 4D no resuelve una ruta a un archivo .json ubicado en la red (a partir de "http/https").
  • Si la ruta es incorrecta o el archivo no es válido por el esquema JSON, se generará un error.         

Los formularios dinámicos pueden contener punteros JSON. Los punteros JSON se resuelven automáticamente cuando llama uno de los comandos 4D que aceptan un formulario dinámico como parámetro (ruta del archivo .json u objeto 4D):

Para más información sobre los punteros JSON, consulte la sección Definir punteros JSON.

Las propiedades listadas en esta sección son aquellas que ofrecen la base y la estructura de un formulario.

PropiedadTipoDescripciónValores posiblesObjetos soportados
inheritedFormcadenaDesigna el formulario a heredar.Nombre (cadena) de tabla o formulario de proyecto O una ruta POSIX (cadena) a un archivo .json que describe el formulario O un objeto que describe el formularioformulario
inheritedFormTabletablaDesigna la tabla que usará un formulario heredado.Un nombre de tabla o númeroformulario
memorizeGeometrybooleanoGuarda los parámetros del formulario cuando se cierra la ventana del formulario. Ver Memorización de la geometría de las ventanasTRUE / FALSEformulario
windowTitlecadenaUtilizado por el comando Open form window para el título de la ventana.variesformulario
destinationcadenaForm type."detailScreen", "listScreen", "detailPrinter", "listPrinter"formulario
pagescolecciónColección de páginas (cada página es un objeto)Objetos de la páginaformulario
csscadena o colecciónArchivo(s) CSS utilizado por el formularioRuta(s) del archivo CSS ofrecido como una cadena, una colección de cadenas, o una colección de objetos con propiedades "path" y "media"form
entryOrdercolecciónColección de nombres de objetos de formulario que definen el orden de entrada (el orden en el que los objetos de formulario se resaltan secuencialmente cuando el usuario presiona Tab o Ctrl/Cmd+Tab. Si esta propiedad no está definida, se utiliza el orden de entrada predeterminado (basado en el orden de definición de objeto para la página).Nombres de objeto de formularioPágina de formulario

Los marcadores especifican ubicaciones precisas en la regla vertical del formulario. Usados principalmente en formularios de salida, controlan la información listada y establecen áreas de encabezado, ruptura, detalle y pie de página de un formulario.

PropiedadTipoDescripciónValores posiblesObjetos soportados
markerBodyenteroEl área entre la línea de control 1 del encabezado del formulario y la línea de ruptura del formulariomínimo: 0formulario
markerBreakentero/array entero Designa áreas para mostrar información que no forma parte de los registros, o líneas/elementos gráficos que concluyen la visualización de la pantalla. mínimo: 0formulario
markerFooterenteroEl área entre la línea Ruptura de formulario 1 y la línea Pie de formulariomínimo: 0formulario
markerHeaderenter/array enteroEl área sobre la línea 1 del encabezado del formulario.mínimo entero: 0; mínimo array entero: 0formulario
Objetos  

PropiedadTipoDescripciónValores posiblesObjetos soportados
memorizeValuebooleanoGuarda el valor del objeto actual cuando memorizeGeometry está activado para el formulario actual.TRUE / FALSEinput, tab, checkbox, radio, popup, splitter, list box 
namecadenaEl nombre del objeto de formulario. (Opcional para el formulario)Todo nombre que no pertenezca a un objeto ya existenteformulario, columna list box, encabezado list box, pie list box
textcadenaEl título del objeto de formulariovariatexto, groupBox, botón, casilla de selección, radio, encabezado list box
typecadenaObligatorio. Designa el tipo de datos del objeto de formulario."text", "rectangle", "groupBox", "tab", "line", "button", "checkbox", "radio", "dropdown", "combo", "webArea", "write", "subform", "plugin", "splitter", "buttonGrid", "progress", "ruler", "spinner", "stepper", "list", "pictureButton", "picturePopup", "listbox", "input", "view" texto, rectángulo, área de grupo, pestaña, línea, botón, casilla de selección, botón radio, lista desplegable, combo box, área Web, área 4D Write Pro, subformulario, plug-in, separador, rejilla de botones, termómetro, regla, indicador de progreso asíncrono (spinner), stepper, lista, botón imagen, popup menu imagen, list box, área de entrada (input), View Pro  
variableCalculationcadenaPermite realizar cálculos matemáticos."none", "minimum", "maximum", "sum", "count", "average", "standardDeviation", "variance", "sumSquare"pie de list box
displaybooleanoFalse para especificar un objeto invisible pero activoTRUE / FALSEbotón, menú desplegrable
classcadenaNombre CSSUna lista de palabras separadas por espacios utilizadas como un selector de clase en archivos csstexto, rectángulo, área de grupo, pestaña, línea, botón, casilla de selección, botón radio, lista desplegable, combo box, área web, Write Pro, subformulario, plugin, separador, rejilla de botones, termómetro, regla, indicador de progresión asíncrono (spinner), stepper, lista, botón imagen, Popup menú imagen, list box, área de entrada(input), View Pro

Un subformulario es un formulario incluido en otro formulario.

PropiedadTipoDescripciónValores posiblesObjetos soportados
deletableInListbooleanoEspecifica si el usuario puede eliminar los subregistros en un subformulario lista.TRUE / FALSE subformulario
detailFormcadenaNombre de un formulario detallado existente. Nombre (cadena) de tabla o formulario proyecto O una ruta POSIX (cadena) a un archivo .json que describe el formulario O un objeto que describe el formulariosubformulario, list box
doubleClickInEmptyAreaActioncadenaAcción a realizar en caso de hacer doble clic en una línea vacía de un subformulario."addSubrecord"subformulario
doubleClickInRowActioncadenaAcción a realizar en caso de hacer doble clic en un registro de subformulario."editSubrecord", "displaySubrecord"subformulario, list box
enterableInListbooleanoEspecifica si el usuario puede modificar los datos del registro directamente en la lista, sin tener que utilizar el formulario detallado asociadoTRUE / FALSE  subformulario
listFormcadenaUn subformulario listado existente donde puede introducir, ver y modificar datos en otras tablas.Nombre (cadena) de tabla o formulario proyecto O una ruta POSIX (cadena) a un archivo .json que describe el formulario O un objeto que describe el formulariosubformulario
selectionModecadenaDesigna las opciones para permitir a los usuarios seleccionar registros."multiple", "single", "none"subformulario, list box 

Acción  

Las propiedades de acción ofrecen instrucciones para las actividades que se realizarán.

Eventos  

Para llamar a un evento, ingrese el título del evento en la propiedad "events" en cameLlúsculas, entre corchetes, rodeado de comillas y con la primera letra de la primera palabra en minúsculas (por ejemplo, "events": ["onLoad"], "events": [1]).

PropiedadTipoDescripciónValores posiblesObjetos soportados
eventsString array or number arrayThe event(s) to listen for in order to trigger an action.onActivate, onAfterEdit, onAfterKeystroke, onAfterSort, onAlternateClick, onBeforeDataEntry, onBeforeKeystroke, onBeginDragOver, onBeginURLLoading, onBoundVariableChange, onClick, onCloseBox, onCloseDetail, onCollapse, onColumnMove, onColumnResize, onDataChange, onDeactivate, onDeleteAction, onDisplayDetail, onDoubleClick, onDragOver, onDrop, onEndURLLoading, onExpand, onFooterClick, onGettingFocus, onHeader, onHeaderClick, onLoad, onLoadRecord, onLongClick, onLosingFocus, onMenuSelect, onMouseEnter, onMouseLeave, onMouseMove, onMouseUp, onOpenDetail, onOpenExternalLink, onOutsideCall, onPagechange, onPluginArea, onPrintingBreak, onPrintingDetail, onPrintingFooter, onResize, onRowMove, onScroll, onSelectionChange, onTimer, onUnload, onURLFiltering, onURLLoadingError, onURLResourceLoading, onValidate, onVPReady, onWindowOpeningDeniedtab, input, button, checkbox, radio, dropDown, combo, web area, write, subform, plugin, splitter, buttonGrid, progress, ruler spinner, stepper, list, pictureButton, picturePopup, list box, list box column
Acción  

PropiedadTipoDescripciónValores posiblesObjetos soportados
actioncadenaActividades típicas a realizar.El nombre de una acción estándar válida. Ver Acciones estándar.button, checkbox, radio, pictureButton, dropdown, picturePopup, buttonGrid, tab, list box
continuousExecutionbooleanoDesigna si se ejecutará o no el método de un objeto mientras el usuario está rastreando el control.TRUE / FALSEprogress, ruler, stepper
draggingcadenaActiva la función de arrastrar."none", "custom", "automatic" (excluyendo list, list box)plugin, input, list, write, list box
droppingcadenaActiva la función de soltar."none", "custom", "automatic" (excluyendo list, list box)plugin, input, list, write, list box
methodcadenaUn nombre de método proyecto.El nombre de un método proyecto existentetab, input, button, checkbox, radio, dropdown, combo, webarea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, form, listbox, view, listbox column
movableRowsbooleanoAutoriza el movimiento de filas durante la ejecución.TRUE / FALSElist box
sortablebooleanoPermite ordenar los datos de columna haciendo clic en el encabezado.TRUE / FALSElist box

PropiedadTipoDescripciónValores posiblesObjetos soportados
borderRadiusenteroEl valor del radio para los rectángulos redondos.mínimo:0rectángulo
bottomenteroPosiciona un objeto en la parte inferior (centrado).mínimo: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
heightenteroDesigna el tamaño vertical de un objetomínimo: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
leftenteroPosiciona un objeto a la izquierda.mínimo: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
maxWidthenteroDesigna el tamaño más grande permitido para las columnas del list box.mínimo: 0columnas del list box
minWidthenteroDesigna el tamaño más pequeño permitido para las columnas del list box.mínimo: 0columnas del list box
rightenteroPosiciona un objeto a la derecha.mínimo: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
rowHeightcadenaDefine el alto de las filas del list box.unidad de valor css "em" o "px" (por defecto)list box
rowHeightAutobooleanoActiva o desactiva el tamaño automático para el alto de la fila del list box.TRUE / FALSElist box
rowHeightAutoMaxcadenaDesigna la altura más alta permitida para las filas del list box.unidad de valor css "em" o "px" (por defecto). mínimo: 0list box
rowHeightAutoMincadenaDesigna la altura más pequeña permitida para las filas del list box.unidad de valor css "em" o "px" (por defecto). mínimo: 0list box
rowHeightSourcevariaUn array que define las alturas diferentes para las filas en un list box.Nombre de una variable array 4Dlist box
startPointcadenaDesigna dónde comienza una línea."topLeft", "bottomLeft"line
topenteroPosiciona un objeto en la parte superior (centrado).mínimo: 0texto, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
widthenteroDesigna un tamaño horizontal de objetosmínimo: 0form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input

PropiedadTipoDescripciónValores posiblesObjetos soportados
bottomMarginenteroValores de margen vertical (en píxeles).mínimo: 0formulario
formSizeAnchorcadenaNombre del objeto cuya posición determina el tamaño del formulario (longitud mínima: 1)Nombre de un objeto 4Dformulario
rightMarginenteroValor de margen horizontal (en píxeles).mínimo: 0formulario
windowMaxHeightenteroDesigna la altura máxima permitida.mínimo: 0formulario
windowMaxWidthenteroDesigna el ancho máximo permitido.mínimo: 0 formulario
windowMinHeightenteroDesigna la altura mínima permitida.mínimo: 0 formulario
windowMinWidthenteroDesigna el ancho mínimo permitido.mínimo: 0 formulario
windowSizingXcadenaEspecifica si el usuario puede cambiar el tamaño del formulario de forma vertical."fixed", "variable"formulario
windowSizingYcadenaEspecifica si el usuario puede cambiar el tamaño del formulario horizontalmente."fixed", "variable"formulario

PropiedadTipoDescripciónValores posiblesObjetos soportados
resizablebooleanoDesigna si el tamaño de un objeto puede ser modificado por el usuario.TRUE / FALSEcolumnas del list box
sizingXcadenaEspecifica si el tamaño horizontal del objeto se debe mover o redimensionar cuando un usuario cambia el tamaño del formulario."move","grow","fixed"form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
sizingYcadenaEspecifica si el tamaño vertical del objeto se debe mover o cambiar de tamaño cuando un usuario redimensiona el formulario."move","grow","fixed"form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
splitterModecadenaCuando un objeto separador tiene esta propiedad, otros objetos a la derecha (vertical) o debajo (separador horizontal) se presionan al mismo tiempo que el separador, sin detenerse."resize", "move"splitter 

Valor  

Propiedad TipoDescripciónValores posiblesObjetos soportados
automaticInsertionbooleanoPermite agregar automáticamente un valor a una lista almacenada en la memoria cuando un usuario ingresa un valor que no se encuentra en la lista de opciones asociada con el objeto. TRUE / FALSEcombo, columna de list box
choiceListlistaAsocia una lista de opciones con una columna de un list box. varíainput, dropdown, combo, columna de list box
currentItemSourcecadenaEl último elemento seleccionado.Expresión de objetolist box
currentItemPositionSourcecadenaPosición del último elemento seleccionado.Expresión de númerolist box
dataSourcecadena, o array cadena para columna de listbox jerárquicaEspecifica la fuente de datos.Una variable 4D, nombre de campo o una expresión de lenguaje compleja arbitraria.tab, input, button, checkbox, radio, dropdown, combo, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box column, list box header, list box footer, list box, view
dataSourceTypeHintcadenaSe usa como una sugerencia para escribir una variable asociada automática cuando fuendeDatos no se especifica o para elegir la propiedad de formato de visualización apropiada (textFormat, numberFormat, timeFormat, dateFormat, pictureFormat, booleanFormat)."integer", "number", "boolean", "picture", "text", date", "time", "arrayText", "object", "undefined"tab, input, button, checkbox, radio, dropdown, combo, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, list box, list box column, listbox footer
labelslistAsocia los valores por defecto o una lista de opciones con una columna de un list box.variatab
listlistLista asociada a un objeto de formulario de lista jerárquica.varialista
listboxTypecadenaDesigna el comportamiento de listbox (tipo)."array", "currentSelection", "namedSelection", "collection" (*) list box
selectionNamecadenaEl contenido del list box se basará en la selección especificada.nombre de la selecciónlist box
saveAscadenaEspecifica si el valor o la referencia del elemento se debe recuperar cuando el elemento se selecciona en una lista."value"; "reference"dropdown, list box column
selectedItemsSourcecadenaLa colección de elementos seleccionados.Expresión de colecciónlist box
tablecadena/enteroSe utiliza para especificar la fuente de datos para un subformulario o list box. Nombres de tablas existentes (sin "[" "]" o ID de tabla (entero mínimo: 0)subformulario, list box

(*) "colección" designa un list box basado en una colección o una selección de entidades.

PropiedadTipoDescripciónValores posiblesObjetos soportados
booleanFormatcadenaEspecifica solo dos valores posibles."TRUE"; "FALSE"input, columna de list box
controlTypecadenaEspecifica cómo se debe renderizar el valor en una celda del list box."input", "checkbox" (for boolean / numeric columns), "automatic", "popup" (solo para columnas booleanas)columna de list box
dateFormatcadenaControla la forma en que aparecen las fechas cuando se muestran o imprimen. Solo se debe seleccionar entre los formatos integrados 4D."systemShort", "systemMedium", "systemLong", "iso8601", "rfc822", "short", "shortCentury", "abbreviated", "long", "blankIfNull" (se puede combinar con los otros valores posibles) input,  list box column, dropdown, combo, list box footer
numberFormatcadenaControla la forma en que aparecen los números cuando se muestran o imprimen.Números (incluido un punto decimal o signo menos si es necesario)input, dropdown, combo, ruler, progress, list box column, list box footer
pictureFormatcadenaControla cómo aparecen las imágenes cuando se muestran o se imprimen."truncatedTopLeft", "scaled", "truncatedCenter", "tiled" (solo imágenes), "proportionalTopLeft" (excluyendo imágenes), "proportionalCenter"(excluding pictures)picture, input, list box, list box footer
textFormatcadenaControla la forma en que aparecen y se imprimen los campos alfanuméricos y las variables."### ####", "(###) ### ####", "### ### ####", "### ## ####", "00000", custom formatsinput, combo, dropdown, list box column, list box footer
timeFormatcadenaControla el modo en que las horas aparecen cuando se muestran o se imprimen. Solo se debe seleccionar entre los formatos integrados 4D."systemShort", "systemMedium", "systemLong", "iso8601", "hh_mm_ss", "hh_mm", "hh_mm_am", "mm_ss", "HH_MM_SS", "HH_MM", "MM_SS", "blankIfNull" (se puede combinar con los otros valores posibles) input, dropdown, list box column, list box footer
truncateModecadenaControla la visualización de valores cuando las columnas del list box son demasiado angostas para mostrar su contenido completo."withEllipsis"; "none"columna de list box, pie de list box
visibilitycadenaPermite ocultar el objeto en el entorno de la aplicación."visible", "hidden", "selectedRows", "unselectedRows"common, list box column 
Entrada  

PropiedadTipoDescripciónValores posiblesObjetos soportados
contextMenucadenaOfrece al usuario acceso a un menú contextual estándar en el área seleccionada."automatic", "none"input, webArea, Write, columna de list box
enterablebooleanoAutoriza la entrada.TRUE / FALSEinput, lis tbox column, list, stepper, ruler, progress, write
entryFiltercadenaAsocia un filtro de entrada con el objeto o las celdas de la columna. Esta propiedad no es accesible si la propiedad Editable no está activada.variainput, combo, list, list box column
focusablebooleanoPermite que el objeto tenga el foco (y puede ser activado por el teclado).TRUE / FALSEinput, button, checkbox, radio, dropdown, write, subform, plugin, ruler, list, list box
keyboardDialectcadenaAsocia una disposición de teclado específica a un campo o un objeto editable utilizando identificadores de lenguaje RFC 3066 Bis.variainput, write
multilinecadenaDesigna si el texto que es demasiado largo para mostrarse se truncará (con o sin retornos de línea)."automatic", "yes", "no"input
placeholdercadenaTexto a mostrar (atenuado) cuando el valor de fuenteDatos está vacío.variesinput, combo
shortcutAccelbooleanoEspecifica el sistema a utilizar, Windows o Mac.TRUE / FALSEcheckbox, radio, pictureButton
shortcutAltbooleanoDesigna la tecla AltTRUE / FALSEcheckbox, radio, pictureButton
shortcutCommandbooleanoDesigna la tecla Comando (Mac)TRUE / FALSEcheckbox, radio, pictureButton
shortcutControlbooleanoDesigna la tecla Control (Windows)TRUE / FALSEcheckbox, radio, pictureButton
shortcutKeycadenaLa letra o el nombre de una llave de significado especial."[F1]" -> "[F15]", "[Return]", "[Enter]", "[Backspace]", "[Tab]", "[Esc]", "[Del]", "[Home]", "[End]", "[Help]", "[Page up]", "[Page down]", "[left arrow]", "[right arrow]", "[up arrow]", "[down arrow]"checkbox, radio, pictureButton
shortcutShiftbooleanoDesigna la tecla MayúsTRUE / FALSEcheckbox, radio, pictureButton
showSelectionbooleanoMantiene la selección visible dentro del objeto después de haber perdido el foco. TRUE / FALSEinput, write
singleClickEditbooleanoActiva el paso directo al modo de edición.TRUE / FALSElist box
spellcheckbooleanoEspecifica si la ortografía se verificará automáticamente o no.TRUE / FALSEinput, write

PropiedadTipoDescripciónValores posiblesObjetos soportados
excludedListlistaPermite configurar una lista cuyos valores no pueden ingresarse en la columna. Si se ingresa un valor excluido, no se acepta y se muestra un mensaje de error.variainput, combo, list box column
maxcadena/ númeroEl valor máximo permitido. Para los paso a paso numéricos, estas propiedades representan segundos cuando el objeto está asociado con un valor de tipo tiempo y se ignoran cuando se asocia con un valor de tipo fecha.variainput, progress, ruler, stepper
mincadena/ númeroEl valor mínimo permitido. Para los paso a paso numéricos, estas propiedades representan segundos cuando el objeto está asociado con un valor de tipo de tiempo y se ignoran cuando se asocia con un valor de tipo de fecha.variainput, progress, ruler, stepper
requiredListlistPermite configurar una lista donde solo se pueden insertar estos valores. Cuando se define una lista requerida, la entrada del teclado ya no es posible.variesinput, listbox column

Look  

PropiedadTipoDescripciónValores posiblesObjetos soportados
defaultButtonbooleanoSimilar a un botón estándar excepto que tiene una apariencia modificada, con la intención de indicar la opción recomendada para el usuario.TRUE / FALSEbotón
dpicadenaDefine la resolución de la pantalla para los contenidos del área 4D Write Pro.0, 72, 96write
hideFocusRingbooleanoDurante la ejecución, un campo de selección o cualquier objeto editable se delimita mediante un rectángulo de selección cuando tiene el foco. Puede ocultar este rectángulo con esta opción.TRUE / FALSEinput, Write Pro, subform, list, list box
hideSystemHighlightbooleanoEsta propiedad se agrega solo para list boxes de tipos de selección. Se usa para especificar la ocultación de los registros resaltados en el list box.TRUE / FALSElist box
labelsPlacementcadenaEspecifica la ubicación del texto que se muestra en un objeto."none", "top", "bottom", "left", "right"tab, progress indicators, ruler
layoutModecadenaDefine el modo para mostrar el documento 4D Write Pro en el área del formulario."embedded, "draft", "page"Write Pro
scrollbarHorizontalcadenaUna herramienta que permite al usuario mover el área de visualización hacia la izquierda o hacia la derecha."visible", "hidden", "automatic"input, Write Pro, subform, list, listbox
scrollbarVerticalcadenaUna herramienta que permite al usuario mover el área de visualización hacia arriba y hacia abajo."visible", "hidden", "automatic"input, Write Pro, subform, list, listbox
showBackgroundbooleanoMuestra/oculta las imágenes de fondo y el color de fondo (se muestran de forma predeterminada).TRUE / FALSEWrite Pro
showHeadersbooleanoActiva o desactiva la visibilidad del documento o de los encabezados de columna del list box.TRUE / FALSEWrite Pro, list box
showHiddenCharsbooleanoMuestra/oculta caracteres invisibles (ocultos por defecto).TRUE / FALSEWrite Pro
showHorizontalRulerbooleanoMuestra/oculta la regla horizontal (mostrados por defecto). TRUE / FALSEWrite Pro
showVerticalRulerbooleanoMuestra/oculta la regla vertical (mostrados por defecto).TRUE / FALSEWrite Pro
showHTMLWysiwygbooleanoActiva/desactiva la vista HTML WYSIWYG, en la que se eliminan todos los atributos avanzados de 4D Write Pro que no son compatibles con todos los navegadores (desactivado de forma predeterminada). TRUE / FALSEWrite Pro
showFootersbooleanoActiva o desactiva la visibilidad del documento o pies de página de la columna list box.TRUE / FALSEWrite Pro, list box
showPageFramesbooleanoMuestra/oculta el marco de página cuando el modo de vista de página está configurado en "Página". Por defecto está oculto.TRUE / FALSEWrite Pro
showReferencesbooleanoMuestra todas las expresiones 4D insertadas en el documento como referencias.TRUE / FALSEWrite Pro
userInterfacestringDisplays/hides 4D View Pro user interface."ribbon", "toolbar", "none" (default value)View Pro
withFormulaBarbooleanoMuestra/oculta la barra de fórmulas 4D View Pro. Para utilizar con la interfaz Toolbar únicamente.TRUE / FALSE (valor por defecto)View Pro
zoomstringDefine el porcentaje de zoom para mostrar los contenidos del área 4D Write Pro. El valor por defecto es 100%.25, 50, 75, 100, 125, 150, 175, 200, 300, 400Write Pro

PropiedadTipoDescripciónValores posiblesObjetos soportados
alternateFillcolorPermite definir un color de fondo diferente para las filas/columnas impares en el list box. todo valor css; "transparent"; "automatic"list box, columna de list box
borderStylecadenaPermite definir un estilo estándar para el borde del objeto del list box. "system", "none", "solid", "dotted", "raised", "sunken", "double"text, input, web area, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, button, pictureButton, picturePopup, list box
fillcolorDefine el color de fondo de un objeto.todo valor css; "transparent"; "automatic"text, rectangle, oval, input, list, list box
hideExtraBlankRowsbooleanoDesactiva la visibilidad de filas adicionales, vacías.TRUE / FALSElist box
rowFillSourcevariableEl nombre de un array o expresión para aplicar un color de fondo personalizado a cada fila del list box. Valores de color RGBlist box, list box column
strokeDashArrayarray número o cadenaDefine valores para cada línea de un objeto. Ej. "6 1" or [6,1]varialínea, rectángulo, ovalo
strokeWidthenteroDesigna el grosor de una línea.entero o 0 para el ancho más pequeño en un formulario impresolínea, rectángulo, ovalo

PropiedadTipoDescripciónValores posiblesObjetos Soportados
printFramecadenaManeja el modo de impresión para los objetos cuyo tamaño puede variar de un registro a otro dependiendo de su contenido. "fixed", "fixedMultiple", "variable"subformulario, input, write

PropiedadTipoDescripciónValores posiblesObjetos soportados
allowFontColorPickerbooleanoPermite al usuario modificar la fuente o el color del objeto para la sesión actual.TRUE / FALSEinput, list box
customBackgroundPictureimagenDefine la imagen que se dibujará en el fondo del botón.sandboxed absoluto o ruta relativa. Debe usarse junto con la propiedad estilo con la opción "personalizada".button, checkbox, radio
customBorderXenteroDefine  el tamaño (en píxeles) de los márgenes horizontales internos de un objeto. Se debe usar con la propiedad estilo con la opción "personalizada".variabutton, checkbox, radio
customBorderYenteroDefine  el tamaño (en píxeles) de los márgenes verticales internos de un objeto. Se debe usar con la propiedad estilo con la opción "personalizada".variabutton, checkbox, radio
customOffsetentero Define  un valor de desplazamiento personalizado en píxeles. Se debe usar con la propiedad estilo con la opción "personalizada".variesbutton, checkbox, radio
fontFamilycadenaNombre de la fuente utilizada en el objeto.variatext, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontSize enteroTamaño de fuente en puntos.mínimo: 0text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontStylecadenaDefine que el texto seleccionado se incline ligeramente hacia la derecha."normal", "italic"text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontThemecadenaDesigna un estilo para el texto del objeto."normal", "main", "additional"text, input
fontWeightcadenaDefine  que el texto seleccionado aparezca más oscuro y más pesado."normal", "bold"text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
rowStrokeSourcecadenaNombre del array o expresión para administrar los colores de la fila.varíalist box, columna de list box
rowStyleSourcecadenaNombre del array o expresión para gestionar estilos.varialist box, columna de list box
storeDefaultStylebooleanoAlmacena las etiquetas de estilo con el texto. Se debe usar con la propiedad multistyle.TRUE / FALSEinput
strokecolorColor de fuente utilizado en el objeto.todo valor css, "transparent", "automatic"text, rectangle, oval, input, button, checkbox, radio, list, list box, list box column, lis tbox header, list box footer
styledTextbooleanoAplica estilos personalizados a áreas de texto dinámico (campos o variables) en el entorno Aplicación.TRUE / FALSEinput
textAligncadenaUbicación horizontal del texto dentro del área que lo contiene."automatic", "right", "center", "justify", "left"text, groupBox, input, list box
textAnglecadenaModifica la orientación (rotación) del área de texto.0, 90, 180, 270 texto, input
textDecorationcadenaDefine el texto seleccionado para tener una línea ejecutándose debajo de él."normal", "underline"text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
verticalAligncadenaUbicación vertical del texto dentro del área que lo contiene."automatic", "top", "middle", "bottom"list box, list box columns, list box header, list box footer
wordwrapcadenaAdministra la visualización del contenido cuando excede el ancho del objeto."automatic" (excluyendo el list box), "normal", "none"input, list box column, list box footer

Las propiedades que figuran a continuación son específicas de los objetos designados

PropiedadTipoDescripciónValores posiblesObjetos soportados
frameDelayenteroPermite ciclar a través del contenido del botón de imagen a la velocidad especificada (en tics).mínimo: 0pictureButton
loopBackToFirstFramebooleanoLas imágenes se muestran en un bucle continuo.TRUE / FALSEpictureButton
switchBackWhenReleasedbooleanoMuestra la primera imagen todo el tiempo, excepto cuando el usuario hace clic en el botón. Muestra la segunda imagen hasta que se suelta el botón del ratón.TRUE / FALSEpictureButton
switchContinuouslybooleanoPermite al usuario mantener presionado el botón del ratón para mostrar las imágenes continuamente (es decir, como una animación). TRUE / FALSEpictureButton
switchWhenRolloverbooleanoModifica el contenido del botón de imagen cuando el cursor del ratón pasa sobre él. La imagen inicial se muestra cuando el cursor abandona el área del botón. TRUE / FALSEpictureButton
useLastFrameAsDisabledbooleanoPermite configurar la última miniatura como la que se mostrará cuando el botón esté desactivado.TRUE / FALSEpictureButton

PropiedadTipoDescripciónValores posiblesObjetos soportados
columnCountenteroDefine el número de columnas en una tabla de miniaturas.mínimo: 1buttonGrid, pictureButton, picturePopup
popupPlacementcadenaPermite mostrar un símbolo que aparece como un triángulo en el botón, lo que indica que hay un menú emergente adjunto."none", "linked", "separated"button
radioGroupcadenaPermite que los botones de radio se usen en conjuntos coordinados: solo se puede seleccionar un botón a la vez en el conjunto. nombre de grupo radioradio
rowCountenteroDefine el número de filas en una tabla de miniaturas.mínimo: 1buttonGrid, pictureButton, picturePopup
stylecadenaPermite configurar el aspecto general del botón. Ver Estilo de botón para más información."regular", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom"button, checkbox, radio
textPlacementcadenaPermite modificar la ubicación relativa del título en relación con el objeto asociado. No tiene efecto si el objeto contiene solo un título (sin imagen asociada) o una imagen (sin título)."left", "right", "top", "bottom", "center"button, ckeckbox, radio
threeStatebooleanoPermite un objeto casilla de selección para aceptar un tercer estado.TRUE / FALSEcasilla de selección

PropiedadTipoDescripciónValores posiblesObjetos soportados
graduationStepenteroMedida de visualización.variesindicadores de progreso, regla
stepenteroIntervalo mínimo aceptado entre los valores durante el uso. Para los botón paso a paso numéricos, esta propiedad representa los segundos cuando el objeto está asociado con un valor de tipo de tiempo y días cuando está asociado con un valor de tipo de fecha.variaindicadores de progreso, regla, botón paso a paso
showGraduationsbooleanoMuestra/Oculta las graduaciones junto a las etiquetas.TRUE / FALSEindicadores de progreso, regla
Ayuda  

PropiedadTipoDescripciónValores posiblesObjetos soportados
tooltipcadenaOfrece a los usuarios información adicional sobre un campo.variostab, input, button, checkbox, radio, dropdown, combo, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box header, list box footer 

PropiedadTipoDescripciónValores posiblesObjetos Soportados
columnsarray de columnasContiene los atributos para las columnas del list box. varialist box
highlightSetcadenaSe utiliza para especificar el conjunto que se utilizará para administrar los registros resaltados en el list box (cuando se selecciona la fuente de datos Arrays, se usa un array booleano con el mismo nombre que el list box).varialist box
lockedColumnCountenteroNúmero de columnas que deben permanecer permanentemente en la parte izquierda del list box, incluso cuando el usuario se desplaza horizontalmente por las columnas.
horizontally.mínimo: 0list box
staticColumnCountenteroNúmero de columnas que no se pueden mover durante la ejecución.mínimo: 0list box

PropiedadTipoDescripciónValores posiblesObjetos soportados
horizontalLineStrokecolorDefine el color de las líneas horizontales en un list box (gris por defecto). todo  valor css, "'transparent", "automatic"list box
verticalLineStrokecolorDefine el color de las líneas verticales en el recuadro a (gris por defecto).todo valor css, "'transparent", "automatic"list box

PropiedadTipoDescripciónValores posiblesObjetos soportados
footerobjetoDesigna un objeto que debe estar en la parte inferior y separado del cuerpo principal del list box.variaColumna del list box
footerHeightcadenaSe usa para definir el alto de la fila para un encabezado o pie de list box. Puede definir la unidad (líneas o píxeles) para el valor de altura.pattern ^(\\d+)(px|em)?$ (positive decimal + px/em )list box
headerobjetoDesigna un objeto para estar en la parte superior y separado del cuerpo principal del list box.varíaColumna del list box
headerHeightcadenaSe usa para definir el alto de la fila para un encabezado o pie de list box. Puede definir la unidad (líneas o píxeles) para el valor de altura.pattern ^(\\d+)(px|em)?$ (positive decimal + px/em )list box
showFootersbooleano / objetoSe usa para mostrar u ocultar los pies de página de la columna. Esta propiedad es booleana para los list boxes y un objeto para las columnas del list box.TRUE / FALSEwrite, list box
showHeadersbooleanoSe usa para mostrar u ocultar encabezados de columna. Esta propiedad es booleana para los list boxes y un objeto para las columnas del list box.TRUE / FALSEwrite, list box
Imagen  

PropiedadTipoDescripciónValores posiblesObjetos soportados
iconimagenEl nombre, número o ruta de acceso a la imagen.sandboxed absoluta o relativa pathlist box header, button, checkbox
iconFramesenteroDefine e el número exacto de estados presentes en la imagen.mínimo: 1button, checkbox, radio
iconPlacementcadenaDesigna la ubicación de un icono en relación con el objeto del formulario."none", "left", "right"encabezado list box
Plugin  

PropiedadTipoDescripciónValores posiblesObjetos soportados
pluginAreaKindcadenaDescribe el tipo de plug-in.varianplug-in 
customPropertiescadena/objetoPropiedades específicas del plug-in, pasadas al plugin como una cadena JSON si es un objeto, o como un búfer binario si es una cadena codificada de base64varianplug-in

PropiedadTipoDescripciónValores posiblesObjetos soportados
methodsAccessibilitycadenaInstancia un objeto JavaScript especial ($4d) para administrar las llamadas a los métodos de proyecto 4D. Se debe usar con la propiedad webEngine."all", "none"Área web
progressSourcecadenaUn valor entre 0 y 100, que representa el porcentaje de finalización de carga de la página en el área web. Actualizada automáticamente por 4D, no se puede modificar manualmente. variaÁrea web
urlSourcecadenaDesigna la URL cargada o en proceso de carga por el área web asociada.varíaÁrea web
webEnginecadenaSe usa para elegir entre dos motores de renderizado para el área web, dependiendo de los detalles de la aplicación."embedded", "system"Área web 

Estas propiedades almacenan la información de configuración del formulario.

PropiedadTipoDescripciónValores posiblesObjetos soportados
paperNamecadenaNombre del formato del documento"A4", "US Letter"...formulario
paperWidthcadenaUtilizado si un documento llamado paperName no se encuentra. Requiere un sufijo de unidad: pt, in, mm, cm.ex: "210mm"formulario
paperHeightcadenaUtilizado si un documento llamado paperName no se encuentra. Requiere un sufijo de unidad: pt, in, mm, cm.ex: "297mm"formulario
orientationcadenaOrientación del documento"landscape" (por defecto es "portrait")formulario
scalenúmero Porcentaje de escala de página (100 significa sin escala)minimo: 0formulario



Ver también 

Introducción

 
PROPIEDADES 

Producto: 4D
Tema: Creación de formularios

 
CONTENIDO DE LA PÁGINA 
 
HISTORIA 

Creado por: 4D v16 R6

 
ARTICLE USAGE

Manual de Diseño ( 4D v19)