Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

"value": Sets the initialization value for the current element.

Subfile Settings

"display subfile record number": This property identifies tells the scrollbar position when the subfile is first displayed."position at top": When this property is set to true, the subfile record identified by the "subfile record number" property will display in the top row of the gridsystem when to display grid records. It represents the SFLDSP keyword.

  • Possible choices: "true", "false"

"display control record": This property tells the system when to display the subfile control record. It represents the SFLDSPCTL keyword.

  • Possible choices: "true", "false"

"place cursorinitialize subfile": When this property is set to true, the cursor is placed in the subfile record identified by the contents of the "subfile record number" property. The cursor is positioned at the first input-capable field in the subfile recordThis property tells the system to initialize all records within the subfile. It represents the SFLINZ keyword.

  • Possible choices: "true", "false"

"subfile endrecords not active": This property is used to indicate that a subfile with a paging bar has loaded all of its recordscan be used together with the "initialize subfile" property to initialize a subfile with no active records. It represents the SFLRNA keyword.

  • Possible choices: "true", "false"

"delete subfile next changed": This property is used to forces the user to correct program-detected typing errors in subfile records. The program can cause a record to be changed so that a get-next-changed operation must read the record again': This property tells the system when to delete the subfile area. It represents the SFLDLT keyword.

  • Possible choices: "true", "false"

"cursor record numberclear subfile": This property can be bound to a numeric field, which will return the relative record number of the record on which the cursor is located."cursor progression": This property determines the tab order for input elements within the subfiletells the system when to clear all records from the subfile. It represents the SFLCLR keyword.

  • Possible choices: "left to righttrue", "top to bottomfalse"

"subfile return rrnsize": This property can be bound to a numeric fieldrepresents the SFLSIZ keyword, which will return specifies the relative record number of the top visible record within a grid.

"subfile changed": Specifies a response indicator that is set on if the input data within the subfile is modified.

Font and Text

"font family": The font face for the text inside the grid. To define a different font for each grid column, select <i>Other...</i> and specify a comma separated list of fonts.

  • Possible choices: "Arial", "Consolas", "Courier New", "Fantasy", "Georgia", "Monospace", "Tahoma", "Times New Roman", "Sans-Serif", "Serif", "Trebuchet MS", "Verdana", "Other..."

"font size": The size of the text inside the grid. To specify a different font size for each grid column, select <i>Other...</i> and specify a comma separated list of font sizes.

...

records that can be placed into the subfile. However, if you program places a record with a relative record number larger than the SFLSIZ value into the subfile, the subfile is automatically extended to contain it (up to a maximum of 9999 records). If this property is not specified, the subfile page value plus one is used. The subfile page value is determined from the "number of rows" property minus the header row if it is present.

"subfile record number": This property identifies the scrollbar position when the subfile is first displayed. It represents the SFLRCDNBR keyword.

"position at top": When this property is set to true, the subfile record identified by the "subfile record number" property will display in the top row of the grid.

  • Possible choices: "true", "false"

"place cursor": When this property is set to true, the cursor is placed in the subfile record identified by the contents of the "subfile record number" property. The cursor is positioned at the first input-capable field in the subfile record.

  • Possible choices: "true", "false"

"subfile end": This property is used to indicate that a subfile with a paging bar has loaded all of its records. It represents the SFLEND keyword.

  • Possible choices: "true", "false"

"subfile next changed": This property is used to forces the user to correct program-detected typing errors in subfile records. The program can cause a record to be changed so that a get-next-changed operation must read the record again.

  • Possible choices: "true", "false"

"cursor record number": This property can be bound to a numeric field, which will return the relative record number of the record on which the cursor is located.

"cursor progression": This property determines the tab order for input elements within the subfile. It represents the SFLCSRPRG keyword.

  • Possible choices: "left to right", "top to bottom"

"subfile return rrn": This property can be bound to a numeric field, which will return the relative record number of the top visible record within a grid. It represents the SFLSCROLL keyword.

"subfile changed": Specifies a response indicator that is set on if the input data within the subfile is modified.

Message Subfile Settings

"subfile message key": This property specifies a field that is used to select messages from a program message queue for display. Your program places a message reference key in this field. The property represents the SFLMSGKEY keyword on a subfile record format.

"subfile program message queue": This property specifies a field that contains the name of the program message queue used to build a message subfile. It represents the SFLPGMQ keyword on a subfile record format.

"subfile control program message queue": This property specifies a field that contains the name of the program message queue used to build a message subfile when used in conjunction with the subfile initialize property. It represents the SFLPGMQ keyword on a subfile control record format.

Font and Text

"font family": The font face for the text inside the grid. To define a different font for each grid column, select <i>Other...</i> and specify a comma separated list of fonts.

  • Possible choices: "Arial", "Consolas", "Courier New", "Fantasy", "Georgia", "Monospace", "Tahoma", "Times New Roman", "Sans-Serif", "Serif", "Trebuchet MS", "Verdana", "Other..."

"font size": The size of the text inside the grid. To specify a different font size for each grid column, select <i>Other...</i> and specify a comma separated list of font sizes.

  • Possible choices: "8px", "9px", "10px", "11px", "12px", "13px", "14px", "15px", "16px", "17px", "18px", "19px", "20px", "21px", "22px", "23px", "24px", "25px", "26px", "27px", "28px", "29px", "30px", "Other..."

...

"row selection": Determines if rows within the grid can be selected by the user with a click of the mouse. <br/><br/>Possible values are: <br/><br/><b>none</b> - rows cannot be selected <br/><br/><b>single</b> - only one row can be selected <br/><br/><b>multiple (simple)</b> - multiple rows can be selected by simply clicking on the rows <br/><br/><b>multiple (extended)</b> - multiple rows can be selected with the use of the Shift and Ctrl keys

  • Possible choices: "none", "single", "multiple (simple)", "multiple (extended)"

"selection field": This property must be bound to an indicator or a character field, which will be used to both set and return the selected state on each record. If a character field is specified, the selection value property will be used to populate the field when a row is selected.

"selection value": Specifies the value used to populate the selection field when a grid row is selected.

"selection image": Defines a repeating cell background image for row selection.

"column widths": Specifies a comma separated list of column widths for this grid.

"scrollbar": Determines the type of vertical scrollbar used to scroll through records within the grid. A sliding scrollbar scrolls freely, while a paging scrollbar scrolls one page of records at a time only.

  • Possible choices: "none", "sliding", "paging"

"scroll tool tip": Determines if the row number or the row number range should be displayed in a tool tip when the user scrolls through the data in the grid.

  • Possible choices: "none", "row number", "row range"

"sortable columns": Enables column sorting. If set to true, the user will be able to click on the column headings to resort the data.

  • Possible choices: "true", "false"

"default sort order": Specifies the default order for sortable columns. When the user clicks a column, the default sort order is used initially. To provide a different sort order for each grid column, select <i>Other...</i> and specify a comma separated list. Entries in the list can be abbreviated using the letter A for Ascending and D for Descending.

  • Possible choices: "Ascending", "Descending", "Other..."

"initial sort column": This property specifies the column used to for inital sorting(simple)</b> - multiple rows can be selected by simply clicking on the rows <br/><br/><b>multiple (extended)</b> - multiple rows can be selected with the use of the Shift and Ctrl keys

  • Possible choices: "none", "single", "multiple (simple)", "multiple (extended)"

"selection field": This property must be bound to an indicator or a character field, which will be used to both set and return the selected state on each record. If a character field is specified, the selection value property will be used to populate the field when a row is selected.

"selection value": Specifies the value used to populate the selection field when a grid row is selected.

"selection image": Defines a repeating cell background image for row selection.

"column widths": Specifies a comma separated list of column widths for this grid.

"scrollbar": Determines the type of vertical scrollbar used to scroll through records within the grid. A sliding scrollbar scrolls freely, while a paging scrollbar scrolls one page of records at a time only.

  • Possible choices: "none", "sliding", "paging"

"scroll tool tip": Determines if the row number or the row number range should be displayed in a tool tip when the user scrolls through the data in the grid.

  • Possible choices: "none", "row number", "row range"

"propagate scroll events": When this property is false (which is the default) the grid handles any scroll wheel or swipe events sent to it so that they scroll the grid, but not the window that the grid is placed inside. If you enable this property, these events will be propagated, which allows mouse wheel and swipe events to scroll the grid's parent window.

  • Possible choices: "true", "false"

"sortable columns": Enables column sorting. If set to true, the user will be able to click on the column headings to resort the data.

  • Possible choices: "true", "false"

"default sort order": Specifies the default order for sortable columns. When the user clicks a column, the default sort order is used initially. To provide a different sort order for each grid column, select <i>Other...</i> and specify a comma separated list. Entries in the list can be abbreviated using the letter A for Ascending and D for Descending.

  • Possible choices: "Ascending", "Descending", "Other..."

"initial sort column": This property specifies the column used to for inital sorting. Each grid column is identified by a sequential index, starting with 0 for the first column, 1 for the second column, and so on. If the property is omitted or set to blanks, sorting is not initiated when the grid is first rendered.

"initial sort field": This property specifies the field name used to identify the column for initial sorting. If this property and the "initial sort column" property are omitted or set to blanks, sorting is not initiated when the grid is first rendered.

"column sort response": Specifies a response variable for server-side sorting. If omitted, client-side sorting is used. The response is a numeric value that represents a column in the grid. Each grid column is identified by a sequential index, starting with 0 for the first column, 1 for the second column, and so on. If the property is omitted or set to blanks, sorting is not initiated when the grid is first rendered.

"initial sort field": This property specifies the field name used to identify the column for initial sorting. If this property and the "initial sort column" property are omitted or set to blanks, sorting is not initiated when the grid is first rendered.

"column sort response": Specifies a response variable It is the responsibility of the program to keep track of the sort direction, and to display an up or down arrow in the appropriate column using the "initial sort column" and "default sort order" properties.

"Field Name Sort Response": Specifies a response variable to receive a field name used for server-side sorting. If omitted, client-side sorting is used. The response is a numeric value that represents a column in the grid. Each grid column is identified by a sequential index, starting with 0 for the first column, 1 for the second column, and so onrepresents the name of the field bound to the first widget in a column of the grid. It is the responsibility of the program to keep track of the sort direction, and to display an up or down arrow in the appropriate column using the "initial sort columnfield" and "default sort order" properties.

...

  • Possible choices: "true", "false"

"initial page number": Specifies the initial page number to use when the page number is displayed within the paging bar. If not specified, page number 1 is used.

"show bar": Displays a bar at the bottom of the grid even if no paging bar elements are selected to be displayed. This can be used to show miscellaneous information such as column totals.

...

  • Possible choices: "true", "false"

"csv xlsx export": Displays a link allowing the user to export grid data to Excel using the XLSX format.

  • Possible choices: "true","false"

"export file name": Defines the name of the download file used to export grid data to CSV formator XLSX formats. The .xlsx or .csv extension is automatically appended to the name. If omitted, the record format name is used.

...

"database file": Database file to use for a grid that is tied directly to a database. You can specify a 'database file' or 'library/database file'. If library is omitted, the session's library list is used."database fields": A set of database field names library list is used.

"database fields": A set of database field names to use to retrieve the data for a database-driven grid. The field names should be comma separated.

"selection criteria": Optional expression identifying which records should be retrieved from the database file.

"order by": Optional expression identifying which fields determine the order of the records retrieved from the database file.

"custom sql": Specifies an sql statement to use to retrieve the data records for a database-driven grid. The field names should be comma separated.

"selection criteria": Optional expression identifying which records should be retrieved from the database file.

"order by": Optional expression identifying which fields determine the order of the records retrieved from the database file.

"custom sql": Specifies an sql statement to use to retrieve the records for a database-driven gridallow any select statement": Allows any valid SELECT SQL statement. If this is false (default), a row count is retrieved by running SELECT COUNT( *) FROM (your-custom-sql-property), so your "custom sql" property must work with that syntax. This prevents the use of common table expressions, the optimize clause, and a few other things. If set to true, the row count will be determined by running your statement as-is and looping through all rows to count them. Note: False performs better, but true allows a wider variety of SQL statements.

"parameter value": Value for parameter marker in "selection criteria" or "custom sql" property. Parameter markers are specified using a question mark. Profound UI will accept values from the client for any parameter marker values which are not bound to program fields. Parameter markers are numbered in order of occurence, from left to right. To specify multiple parameter marker values, right-click the property and select Add Another Parameter Value.Value.

"data url": Sets the url to a Web service that returns JSON data for a database-driven grid.

"data transform function": The name of a JavaScript to be called to process the results of the "data url" : Sets the url to a Web service that returns JSON data for a database-driven gridprogram. This can be used to transform data from the program into the format expected by the grid widget.

Position

"left": Represents the x-coordinate of the current element.

...

"tool tip": Defines the text to appear in a tool tip when the user hovers the mouse over this elementhovers the mouse over this element.

"user defined data": Specifies user-defined general purpose data associated with the widget. To provide multiple user defined data values, right-click the property and select Add Another User Defined Value.

"visibility": Determines whether the element is visible or hidden.

  • Possible choices: "hidden", "visible"

Events

"ondbload": Initiates a client-side script when database data is loaded for a database-driven widget. An object named response will be defined that contains:

  • success: boolean true/false
  • id: the widget id
  • error: an object with "id", "text" and "text2" fields containing the error.

"onfilterchange": Initiates a client-side script when the filter has changed. 

...