Dynamic Forms are forms whose structures are defined in either a .json file or a 4D object. They are regenerated each time they are run and provide a superior level of flexibility. A few notable advantages include: 

• Usability
  
  • straightforward updates
  • dynamic user modifications
  • easy reuse
  • faster searching
• Portability
  
  • simplified sharing
  • can be stored in source control

Every object defined in a dynamic form, including the form itself, has one or more properties.

The following is a simple JSON file ("HW.json", stored in the Resources folder) with text, an image and a button:

{
    "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
                }
            }
        }
    ]
}

This form can be loaded in a dialog with the following 4D code:

Which displays the form:

When creating forms from files, they must:

• comply with the JSON schema. The 4D JSON form schema can be found in the 4D program folder at: Resources/formsSchema.json. It is your responsibility to verify the validity of the .json form file. See the JSON Validate command.
• be in files with a ".json" file extension.
• be stored inside the application package, relative to the structure file.

Notes:

• Comments within .json files must be contained within the "comments" property. Standard coding characters for comments (i.e., "//", "/*", "'", etc.) will render the file invalid.
• Arrays in JSON act as collections in 4D.

All file paths can be relative or absolute. They must use '/' as path delimiter and are resolved the following way:

• A relative path must not start with '/'. It is resolved relatively to the JSON document where the path string has been found,
• An absolute path starts with '/'. For security reasons, only "/RESOURCES" is accepted as absolute path and designates the current database resources folder. For example, "/RESOURCES/templates/myfile.json" points to the file "myfile.json" located in the current database resources folder.

Notes:

• The name resolution is case sensitive.
• 4D does not resolve a path to a .json file located over the network (starting with "http/https").
• If the path is incorrect or the file is not valid per the JSON schema, an error will be generated.

Dynamic forms can contain JSON pointers. JSON pointers are automatically resolved when you call a 4D command that accepts a dynamic form as parameter (.json file path or 4D object):

• DIALOG
• Open form window
• FORM SET INPUT
• FORM SET OUTPUT
• OBJECT GET SUBFORM
• OBJECT SET SUBFORM
• FORM LOAD
• Print form

For more information about JSON pointers, please refer to the Defining JSON Pointers section.

The properties listed within this section are those which provide the foundation and structure of a form.

Property	Type	Description	Possible Values	Objects Supported
inheritedForm	string	Designates the form to inherit.	Name (string) of table or project form OR a POSIX path (string) to a .json file describing the form OR an object describing the form	form
inheritedFormTable	table	Designates the table an inherited form will use.	A table name or number	form
memorizeGeometry	boolean	Saves the form parameters when the form window is closed. See Memorization of window geometry	TRUE / FALSE	form
windowTitle	string	Used by the Open form window command for the window title.	varies	form
destination	string	Form type.	"detailScreen", "listScreen", "detailPrinter", "listPrinter"	form
pages	collection	Collection of pages (each page is an object)	Page objects	form
css	string or collection	CSS file(s) used by the form	CSS file path(s) provided as a string, a collection of strings, or a collection of objects with "path" and "media" properties	form
entryOrder	collection	Collection of form object names defining the entry order (the order in which form objects are sequentially highlighted when the user presses Tab or Ctrl/Cmd+Tab). If this property is not defined, the default entry order (based upon the object definition order for the page) is used	Form object names	form page

Markers specify precise locations on the vertical ruler of the form. Used mainly in output forms, they control the listed information and set header, break, detail and footer areas of a form.

 

Property	Type	Description	Possible Values	Objects Supported
markerBody	integer	Detail marker position	minimum: 0	form
markerBreak	integer/integer array	Break marker position(s)	minimum: 0	form
markerFooter	integer	Footer marker position	minimum: 0	form
markerHeader	integer/integer array	Header marker position(s)	integer minimum: 0; integer array minimum: 0	form

Property	Type	Description	Possible Values	Objects Supported
memorizeValue	boolean	Saves the value of the current object when memorizeGeometry is activated for the current form.	TRUE / FALSE	input, tab, checkbox, radio, popup, splitter, list box
name	string	The name of the form object. (Optional for the form)	Any name which does not belong to an already existing object	form, list box column, list box header, list box footer
text	string	The title of the form object	varies	text, groupBox, button, checkbox, radio, list box header
type	string	Mandatory. Designates the data type of the form object.	"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"	text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, Write Pro, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input, View Pro
variableCalculation	string	Allows mathematical calculations to be performed.	"none", "minimum", "maximum", "sum", "count", "average", "standardDeviation", "variance", "sumSquare"	list box footer
display	boolean	False to specify an invisible but active object	TRUE / FALSE	button, dropdown
class	string	CSS name(s)	A list of space-separated words used as class selectors in css files	text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, Write Pro, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input, View Pro

A subform is a form included in another form.

Property	Type	Description	Possible Values	Objects Supported
deletableInList	boolean	Specifies if the user can delete subrecords in a list subform.	TRUE / FALSE	subform
detailForm	string	Name of an existing detail form.	Name (string) of table or project form OR a POSIX path (string) to a .json file describing the form OR an object describing the form	subform, list box
doubleClickInEmptyAreaAction	string	Action to perform in case of a double-click on an empty line of a subform.	"addSubrecord"	subform
doubleClickInRowAction	string	Action to perform in case of a double-click on a subform record.	"editSubrecord", "displaySubrecord"	subform, list box
enterableInList	boolean	Specifies if the user can modify record data directly in the list, without having to use the associated detail form	TRUE / FALSE	subform
listForm	string	An existing list subform where you can enter, view, and modify data in other tables.	Name (string) of table or project form OR a POSIX path (string) to a .json file describing the form OR an object describing the form	subform
selectionMode	string	Designates the options for allowing users to select records.	"multiple", "single", "none"	subform, list box

Action properties provide instructions for activities to be performed.

The "events" property accepts a JSON array (collection) of strings or numbers. To call an event, enter the event's name or value (see form event constant values). For exemple, "events":["onLoad"]) or "events":[1]

Property	Type	Description	Possible Values	Objects Supported
events	String array or number array	The 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, onWindowOpeningDenied	tab, input, button, checkbox, radio, dropDown, combo, web area, 4D Write Pro, subform, plugin, splitter, buttonGrid, progress, ruler spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, list box column

Property	Type	Description	Possible Values	Objects Supported
action	string	Typical activities to be performed.	The name of a valid standard action. See Standard actions.	button, checkbox, radio, pictureButton, dropdown, picturePopup, buttonGrid, tab, list box
continuousExecution	boolean	Designates whether or not to run the method of an object while the user is tracking the control.	TRUE / FALSE	progress, ruler, stepper
dragging	string	Enables dragging function.	"none", "custom", "automatic" (excluding list, list box)	plugin, input, list, 4D Write Pro, list box
dropping	string	Enables dropping function.	"none", "custom", "automatic" (excluding list, list box)	plugin, input, list, 4D Write Pro, list box
method	string	A project method name.	The name of an existing project method	tab, input, button, checkbox, radio, dropdown, combo, webarea, 4D Write Pro, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, form, listbox, view, listbox column
movableRows	boolean	Authorizes the movement of rows during execution.	TRUE / FALSE	list box
sortable	boolean	Allows sorting column data by clicking the header.	TRUE / FALSE	list box

Property	Type	Description	Possible Values	Objects Supported
borderRadius	integer	The radius value for round rectangles.	minimum:0	rectangle
bottom	integer	Positions an object at the bottom (centered).	minimum: 0	text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input
height	integer	Designates an object's vertical size	minimum: 0	text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input
left	integer	Positions an object on the left.	minimum: 0	text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input
maxWidth	integer	Designates the largest size allowed for list box columns.	minimum: 0	list box columns
minWidth	integer	Designates the smallest size allowed for list box columns.	minimum: 0	list box columns
right	integer	Positions an object on the right.	minimum: 0	text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input
rowHeight	string	Sets the height of list box rows.	css value unit "em" or "px" (default)	list box
rowHeightAuto	boolean	Activates or disactivates automatic sizing for list box row height.	TRUE / FALSE	list box
rowHeightAutoMax	string	Designates the largest height allowed for list box rows.	css value unit "em" or "px" (default). minimum: 0	list box
rowHeightAutoMin	string	Designates the smallest height allowed for list box rows.	css value unit "em" or "px" (default). minimum: 0	list box
rowHeightSource	varies	An array defining different heights for the rows in a list box.	Name of a 4D array variable	list box
startPoint	string	Designates where a line begins.	"topLeft", "bottomLeft"	line
top	integer	Positions an object at the top (centered).	minimum: 0	text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input
width	integer	Designates an objects horizontal size	minimum: 0	form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input

Property	Type	Description	Possible Values	Objects Supported
bottomMargin	integer	Vertical margin value (in pixels).	minimum: 0	form
formSizeAnchor	string	Name of the object whose position determines the size of the form. (minimum length: 1)	Name of a 4D object	form
rightMargin	integer	Horizontal margin value (in pixels).	minimum: 0	form
windowMaxHeight	integer	Designates the largest allowable height.	minimum: 0	form
windowMaxWidth	integer	Designates the largest allowable width.	minimum: 0	form
windowMinHeight	integer	Designates the smallest allowable height.	minimum: 0	form
windowMinWidth	integer	Designates the smallest allowable width.	minimum: 0	form
windowSizingX	string	Specifies if the user can resize the form vertically.	"fixed", "variable"	form
windowSizingY	string	Specifies if the user can resize the form horizontally.	"fixed", "variable"	form

Property	Type	Description	Possible Values	Objects Supported
resizable	boolean	Designates if the size of an object can be modified by the user.	TRUE / FALSE	list box columns
sizingX	string	Specifies if the horizontal size of the object should be moved or resized when a user resizes the form.	"move","grow","fixed"	form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input
sizingY	string	Specifies if the vertical size of the object should be moved or resized when a user resizes the form.	"move","grow","fixed"	form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box, input
splitterMode	string	When a splitter object has this property, other objects to its right (vertical splitter) or below it (horizontal splitter) are pushed at the same time as the splitter, with no stop.	"resize", "move"	splitter

Property	Type	Description	Possible Values	Objects Supported
automaticInsertion	boolean	Enables automatically adding a value to a list stored in memory when a user enters a value that is not found in the choice list associated with the object.	TRUE / FALSE	combo, list box column
choiceList	list	Associates a choice list with a column of a list box.	varies	input, dropdown, combo, list box column
currentItemSource	string	The last selected item.	Object expression	list box
currentItemPositionSource	string	The position of the last selected item.	Number expression	list box
dataSource	string, or string array for hierarchical listbox column	Specifies the source of the data.	A 4D variable, field name, or an arbitrary complex language expression.	tab, input, button, checkbox, radio, dropdown, combo, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box column, list box header, list box footer, list box, view
dataSourceTypeHint	string	Indicates the variable type.	"integer", "number", "boolean", "picture", "text", date", "time", "arrayText", "collection", "object", "undefined"	tab, input, button, checkbox, radio, dropdown, combo, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, list box, list box column, listbox footer
labels	list	Associates default values or a choice list with a column of a list box.	varies	tab
list	list	List associated to a hierarchical list form object.	varies	list
listboxType	string	Designates listbox's behavior (type).	"array", "currentSelection", "namedSelection", "collection"(*)	list box
saveAs	string	Specifies if the item's value or reference should be retrieved when the item is selected in a list.	"value"; "reference"	dropdown, list box column
selectedItemsSource	string	The selected items collection.	Collection expression	list box
selectionName	string	The contents of the list box will be based on the selection specified.	Selection name	list box
table	string/integer	Used to specify the data source for a subform or list box.	Existing table names (without "[" "]" or table ID (integer minimum: 0)	subform, list box

(*) "collection" designates a list box based on a collection or an entity selection.

Property	Type	Description	Possible Values	Objects Supported
booleanFormat	string	Specifies only two possible values.	"TRUE"; "FALSE"	input, list box column
controlType	string	Specifies how the value should be rendered in a list box cell.	"input", "checkbox" (for boolean / numeric columns), "automatic", "popup" (only for boolean columns)	list box column
dateFormat	string	Controls the way dates appear when displayed or printed. Must only be selected among the 4D built-in formats.	"systemShort", "systemMedium", "systemLong", "iso8601", "rfc822", "short", "shortCentury", "abbreviated", "long", "blankIfNull" (can be combined with the other possible values)	input,  list box column, dropdown, combo, list box footer
numberFormat	string	Controls the way numbers appear when displayed or printed.	Numbers (including a decimal point or minus sign if necessary)	input, dropdown, combo, ruler, progress, list box column, list box footer
pictureFormat	string	Controls how pictures appear when displayed or printed.	"truncatedTopLeft", "scaled", "truncatedCenter", "tiled" (pictures only), "proportionalTopLeft" (excluding pictures), "proportionalCenter"(excluding pictures)	picture, input, list box, list box footer
textFormat	string	Controls the way the alphanumeric fields and variables appear when displayed or printed.	"### ####", "(###) ### ####", "### ### ####", "### ## ####", "00000", custom formats	input, combo, dropdown, list box column, list box footer
timeFormat	string	Controls the way times appear when displayed or printed. Must only be selected among the 4D built-in formats.	"systemShort", "systemMedium", "systemLong", "iso8601", "hh_mm_ss", "hh_mm", "hh_mm_am", "mm_ss", "HH_MM_SS", "HH_MM", "MM_SS", "blankIfNull" (can be combined with the other possible values)	input, dropdown, list box column, list box footer
truncateMode	string	Controls the display of values when list box columns are too narrow to show their full contents.	"withEllipsis"; "none"	list box column, list box footer
visibility	string	Allows hiding the object in the Application environment.	"visible", "hidden", "selectedRows", "unselectedRows"	common, list box column

Property	Type	Description	Possible Values	Objects Supported
contextMenu	string	Provides the user access to a standard context menu in the selected area.	"automatic", "none"	input, webArea, Write, list box column
enterable	boolean	Authorizes entry.	TRUE / FALSE	input, lis tbox column, list, stepper, ruler, progress, write
entryFilter	string	Associates an entry filter with the object or column cells. This property is not accessible if the Enterable property is not enabled.	varies	input, combo, list, list box column
focusable	boolean	Enables the object to have the focus (and can be activated by the keyboard).	TRUE / FALSE	input, button, checkbox, radio, dropdown, write, subform, plugin, ruler, list, list box
keyboardDialect	string	Associates a specific keyboard layout to a field or an enterable object using language identifiers RFC 3066 Bis.	varies	input, write
multiline	string	Designates if text that is too long to be displayed will be truncated (with or without line returns).	"automatic", "yes", "no"	input
placeholder	string	Text to be displayed (grayed out) when the value for dataSource is empty.	varies	input, combo
shortcutAccel	boolean	Specifies the system to use, Windows or Mac.	TRUE / FALSE	checkbox, radio, pictureButton
shortcutAlt	boolean	Designates the Alt key	TRUE / FALSE	checkbox, radio, pictureButton
shortcutCommand	boolean	Designates the Command key (Mac)	TRUE / FALSE	checkbox, radio, pictureButton
shortcutControl	boolean	Designates the Control key (Windows)	TRUE / FALSE	checkbox, radio, pictureButton
shortcutKey	string	The letter or name of a special meaning key.	"[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
shortcutShift	boolean	Designates the Shift key	TRUE / FALSE	checkbox, radio, pictureButton
showSelection	boolean	Keeps the selection visible within the object after it has lost the focus.	TRUE / FALSE	input, write
singleClickEdit	boolean	Enables direct passage to edit mode.	TRUE / FALSE	list box
spellcheck	boolean	Specifies if spelling will be automatically verified or not.	TRUE / FALSE	input, write

Property	Type	Description	Possible Values	Objects Supported
excludedList	list	Allows setting a list whose values cannot be entered in the column. If an excluded value is entered, it is not accepted and an error message is displayed.	varies	input, combo, list box column
max	string / number	The maximum allowed value. For numeric steppers, these properties represent seconds when the object is associated with a time type value and are ignored when it is associated with a date type value.	varies	input, progress, ruler, stepper
min	string / number	The minimum allowed value. For numeric steppers, these properties represent seconds when the object is associated with a time type value and are ignored when it is associated with a date type value.	varies	input, progress, ruler, stepper
requiredList	list	Allows setting a list where only these values can be inserted. When a required list is defined, keyboard entry is no longer possible.	varies	input, listbox column

Property	Type	Description	Possible Values	Objects Supported
defaultButton	boolean	Similar to a standard button except that it has a modified appearance, intended to indicate the recommended choice to the user.	TRUE / FALSE	button
dpi	string	Sets the screen resolution for the 4D Write Pro area contents.	0, 72, 96	4D Write Pro
hideFocusRing	boolean	During execution, a field or any enterable object is outlined by a selection rectangle when it has the focus. You can hide this rectangle with this option.	TRUE / FALSE	input, Write Pro, subform, list, list box
hideSystemHighlight	boolean	This property is added for selection type list boxes only. It is used to specify hiding highlighted records in the list box.	TRUE / FALSE	list box
labelsPlacement	string	Specifies the location of an object's displayed text.	"none", "top", "bottom", "left", "right"	tab, progress indicators, ruler
layoutMode	string	Sets the mode for displaying the 4D Write Pro document in the form area.	"embedded, "draft", "page"	Write Pro
scrollbarHorizontal	string	A tool allowing the user to move the viewing area to the left or right.	"visible", "hidden", "automatic"	input, Write Pro, subform, list, listbox
scrollbarVertical	string	A tool allowing the user to move the viewing area up and down.	"visible", "hidden", "automatic"	input, Write Pro, subform, list, listbox
showBackground	boolean	Displays/hides both background images and background color (displayed by default).	TRUE / FALSE	Write Pro
showHeaders	boolean	Enables or disactivates the visibility of the document or list box headers.	TRUE / FALSE	Write Pro, list box
showHiddenChars	boolean	Displays/hides invisible characters (hidden by default).	TRUE / FALSE	Write Pro
showHorizontalRuler	boolean	Displays/hides the horizontal ruler (displayed by default).	TRUE / FALSE	Write Pro
showVerticalRuler	boolean	Displays/hides the vertical ruler (displayed by default).	TRUE / FALSE	Write Pro
showHTMLWysiwyg	boolean	Enables/disables the HTML WYSIWYG view, in which any 4D Write Pro advanced attributes which are not compliant with all browsers are removed (disabled by default).	TRUE / FALSE	Write Pro
showFooters	boolean	Enables or disactivates the visibility of the document or list box footers.	TRUE / FALSE	Write Pro, list box
showPageFrames	boolean	Displays/hides the page frame when Page view mode is set to "Page". Default is hidden.	TRUE / FALSE	Write Pro
showReferences	boolean	Displays all inserted 4D expressions in the document as references.	TRUE / FALSE	Write Pro
userInterface	string	Displays/hides 4D View Pro user interface.	"ribbon", "toolbar", "none" (default value)	View Pro
withFormulaBar	boolean	Displays/hides 4D View Pro formula bar. For use with the Toolbar interface only.	TRUE / FALSE (default value)	View Pro
zoom	string	Sets the zoom percentage for displaying 4D Write Pro area contents. Default is 100%.	25, 50, 75, 100, 125, 150, 175, 200, 300, 400	Write Pro

Property	Type	Description	Possible Values	Objects Supported
alternateFill	color	Allows setting a different background color for odd-numbered rows/columns in the list box.	any css value; "transparent"; "automatic"	list box, list box column
borderStyle	string	Allows setting a standard style for the object border.	"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
fill	color	Defines the background color of an object.	any css value; "transparent"; "automatic"	text, rectangle, oval, input, list, list box
hideExtraBlankRows	boolean	Disactivates the visibility of extra, empty rows.	TRUE / FALSE	list box
rowFillSource	string	The name of an array or expression to apply a custom background color to each row of the list box.	RGB color values	list box, list box column
strokeDashArray	number array or string	Defines values for each line of an object. Ex. "6 1" or [6,1]	varies	line, rectangle, oval
strokeWidth	integer	Designates the thickness of a line.	integer or 0 for smallest width on a printed form	line, rectangle, oval

 

Property	Type	Description	Possible Values	Objects Supported
printFrame	string	Handles the print mode for objects whose size can vary from one record to another depending on their contents.	"fixed", "fixedMultiple", "variable"	subform, input, write

Property	Type	Description	Possible Values	Objects Supported
allowFontColorPicker	boolean	Allows user modification of the object's font or color for the current session.	TRUE / FALSE	input, list box
customBackgroundPicture	picture	Sets the picture that will be drawn in the background of the button.	sandboxed absolute or relative path. Must be used in conjunction with the style property with the "custom" option.	button, checkbox, radio
customBorderX	integer	Sets the size (in pixels) of the internal horizontal margins of an object. Must be used with the style property with the "custom" option.	varies	button, checkbox, radio
customBorderY	integer	Sets the size (in pixels) of the internal vertical margins of an object. Must be used with the style property with the "custom" option.	varies	button, checkbox, radio
customOffset	integer	Sets a custom offset value in pixels. Must be used with the style property with the "custom" option.	varies	button, checkbox, radio
fontFamily	string	Name of font used in the object.	varies	text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontSize	integer	Font size in points.	minimum: 0	text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontStyle	string	Sets the selected text to slant slightly to the right.	"normal", "italic"	text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontTheme	string	Designates a style for the object's text.	"normal", "main", "additional"	text, input
fontWeight	string	Sets the seleted text to appear darker and heavier.	"normal", "bold"	text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
metaSource	string	A meta object containing style and selection settings.	Object expression	List box
rowStrokeSource	string	Name of array or expression for managing row colors.	varies	list box, list box column
rowStyleSource	string	Name of array or expression for managing styles.	varies	list box, list box column
storeDefaultStyle	boolean	Stores the style tags with the text. Must be used with the multistyle property.	TRUE / FALSE	input
stroke	color	Font color used in the object.	any css value, "transparent", "automatic"	text, rectangle, oval, input, button, checkbox, radio, list, list box, list box column, lis tbox header, list box footer
styledText	boolean	Applies custom styles to dynamic text areas (fields or variables) in the Application environment.	TRUE / FALSE	input
textAlign	string	Horizontal location of text within the area that contains it.	"automatic", "right", "center", "justify", "left"	text, groupBox, input, list box
textAngle	string	Modifies the orientation (rotation) of the text area.	0, 90, 180, 270	text, input
textDecoration	string	Sets the selected text to have a line running beneath it.	"normal", "underline"	text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
verticalAlign	string	Vertical location of text within the area that contains it.	"automatic", "top", "middle", "bottom"	list box, list box columns, list box header, list box footer
wordwrap	string	Manages the display of contents when it exceeds the width of the object.	"automatic" (excluding list box), "normal", "none"	input, list box column, list box footer

The properties listed below are specific to the designated objects.

Property	Type	Description	Possible Values	Objects Supported
frameDelay	integer	Enables cycling through the contents of the picture button at the specified speed (in ticks).	minimum: 0	pictureButton
loopBackToFirstFrame	boolean	Pictures are displayed in a continuous loop.	TRUE / FALSE	pictureButton
switchBackWhenReleased	boolean	Displays the first picture all the time except when the user clicks the button. Displays the second picture until the mouse button is released.	TRUE / FALSE	pictureButton
switchContinuously	boolean	Allows the user to hold down the mouse button to display the pictures continuously (i.e., as an animation).	TRUE / FALSE	pictureButton
switchWhenRollover	boolean	Modifies the contents of the picture button when the mouse cursor passes over it. The initial picture is displayed when the cursor leaves the button’s area.	TRUE / FALSE	pictureButton
useLastFrameAsDisabled	boolean	Enables setting the last thumbnail as the one to display when the button is disabled.	TRUE / FALSE	pictureButton

Property	Type	Description	Possible Values	Objects Supported
columnCount	integer	Sets the number of columns in a thumbnail table.	minimum: 1	buttonGrid, pictureButton, picturePopup
popupPlacement	string	Allows displaying a symbol that appears as a triangle in the button, which indicates that there is a pop-up menu attached.	"none", "linked", "separated"	button
radioGroup	string	Enables radio buttons to be used in coordinated sets: only one button at a time can be selected in the set.	Radio group name	radio
rowCount	integer	Sets the number of rows in a thumbnail table.	minimum: 1	buttonGrid, pictureButton, picturePopup
style	string	Allows setting the general appearance of the button. See Button Style for more information.	"regular", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom","flat"	button, checkbox, radio
textPlacement	string	Allows modifying the relative location of the title in relation to the associated object. No effect if the object contains only a title (no associated picture) or a picture (no title).	"left", "right", "top", "bottom", "center"	button, checkbox, radio
threeState	boolean	Allows a check box object to accept a third state.	TRUE / FALSE	checkbox

Property	Type	Description	Possible Values	Objects Supported
graduationStep	integer	Scale display measurement.	varies	progress indicators, ruler
step	integer	Minimum interval accepted between values during use. For numeric steppers, this property represents seconds when the object is associated with a time type value and days when it is associated with a date type value.	varies	progress indicators, ruler, stepper
showGraduations	boolean	Displays/Hides the graduations next to the labels.	TRUE / FALSE	progress indicators, ruler

Property	Type	Description	Possible Values	Objects Supported
tooltip	string	Provide users with additional information about a field.	varies	tab, input, button, checkbox, radio, dropdown, combo, splitter, buttonGrid, progress, ruler, spinner (Asynchronous progress bar), stepper, list, pictureButton, picturePopup, list box header, list box footer

Property	Type	Description	Possible Values	Objects Supported
columns	column array	Contains the attributes for the list box columns.	varies	list box
highlightSet	string	Used to specify the set to be used to manage highlighted records in the list box (when the Arrays data source is selected, a Boolean array with the same name as the list box is used).	varies	list box
lockedColumnCount	integer	Number of columns that must stay permanently displayed in the left part of the list box, even when the user scrolls through the columns horizontally.	minimum: 0	list box
staticColumnCount	integer	Number of columns that cannot be moved during execution.	minimum: 0	list box

Property	Type	Description	Possible Values	Objects Supported
horizontalLineStroke	color	Defines the color of the horizontal lines in a list box (gray by default).	any css value, "'transparent", "automatic"	list box
verticalLineStroke	color	Defines the color of the vertical lines in the a box (gray by default).	any css value, "'transparent", "automatic"	list box

Property	Type	Description	Possible Values	Objects Supported
footer	object	Designates an object to be at the bottom and separate from the main body of the list box.	varies	list box column
footerHeight	string	Used to set the row height for a list box footer. You can set the unit (lines or pixels) for the height value.	pattern ^(\\d+)(px|em)?$ (positive decimal + px/em )	list box
header	object	Designates an object to be at the top and separate from the main body of the list box.	varies	list box column
headerHeight	string	Used to set the row height for a list box header. You can set the unit (lines or pixels) for the height value.	pattern ^(\\d+)(px|em)?$ (positive decimal + px/em )	list box
showFooters	boolean	Used to display or hide column or document footers.	TRUE / FALSE	write, list box
showHeaders	boolean	Used to display or hide column headers.	TRUE / FALSE	write, list box

Property	Type	Description	Possible Values	Objects Supported
icon	picture	The name, number, or the pathname of the picture.	sandboxed absolute or relative path	list box header, button, checkbox
iconFrames	integer	Sets the exact number of states present in the picture.	minimum: 1	button, checkbox, radio
iconPlacement	string	Designates the placement of an icon in relation to the form object.	"none", "left", "right"	list box header

Property	Type	Description	Possible Values	Objects Supported
methodsAccessibility	string	Instantiates a special JavaScript object ($4d) to manage calls to 4D project methods.. Must be used with the webEngine property.	"all", "none"	web area
progressSource	string	A value between 0 and 100, representing the page load completion percentage in the Web area. Automatically updated by 4D, cannot be modified manually.	varies	web area
urlSource	string	Designates the the URL loaded or being loading by the associated Web area.	varies	web area
webEngine	string	Used to choose between two rendering engines for the Web area, depending on the specifics of the application.	"embedded", "system"	web area

These properties store the page setup information for the form.