Constants Summary | |
---|---|
String | EMPTY_FOUNDSET Constant used for form namedFoundset property. |
Number | LIST_VIEW The constants to set or get the view property of a JSForm. |
Number | LOCKED_LIST_VIEW The constants to set or get the view property of a JSForm. |
Number | LOCKED_RECORD_VIEW The constants to set or get the view property of a JSForm. |
Number | LOCKED_TABLE_VIEW The constants to set or get the view property of a JSForm. |
Number | RECORD_VIEW The constants to set or get the view property of a JSForm. |
Number | SELECTION_MODE_DEFAULT Constant used for form selectionMode property. |
Number | SELECTION_MODE_MULTI Constant used for form selectionMode property. |
Number | SELECTION_MODE_SINGLE Constant used for form selectionMode property. |
String | SEPARATE_FOUNDSET Constant used for form namedFoundset property. |
Property Summary | |
---|---|
String | borderType The type, color and style of border of the component. |
String | dataSource The names of the database server and table that this form is linked to. |
String | defaultPageFormat The default page format for the form. |
Number | encapsulation Get or set the encapsulation level for the form. |
JSForm | extendsForm A JSForm instance representing the super form of this form, if this form has a super form. |
String | initialSort The default sort order only when the form loads. |
String | name The name of the form. |
String | namedFoundSet Property that tells the form to use a named foundset instead of the default foundset. |
Object | navigator The navigator (previously named "controller") that is used to control/navigate to the form. |
JSMethod | onDeleteAllRecordsCmd The method that overrides the Servoy menu item Select > Delete All. |
JSMethod | onDeleteRecordCmd The method that overrides the Servoy menu item Select > Delete Record (or keyboard shortcut). |
JSMethod | onDrag The method that is triggered when (non Design Mode) dragging occurs. |
JSMethod | onDragEnd The method that is triggered when (non Design Mode) dragging end occurs. |
JSMethod | onDragOver The method that is triggered when (non Design Mode) dragging over a component occurs. |
JSMethod | onDrop The method that is triggered when (non Design Mode) dropping occurs. |
JSMethod | onDuplicateRecordCmd The method that overrides the Servoy menu item Select > Duplicate Record (or keyboard shortcut). |
JSMethod | onElementFocusGained The method that is triggered when focus is gained by a component inside the form. |
JSMethod | onElementFocusLost The method that gets triggered when focus is lost by a component inside the form. |
JSMethod | onFindCmd The method that overrides the Servoy menu item Select > Find (or keyboard shortcut) in Data (ready) mode. |
JSMethod | onHide The method that is triggered when another form is being activated. |
JSMethod | onInvertRecordsCmd The method that overrides the Servoy menu item Select > Invert Records. |
JSMethod | onLoad The method that is triggered when a form is loaded/reloaded from the repository; used to alter elements, set globals, hide toolbars, etc; onShow method can also be assigned. |
JSMethod | onNewRecordCmd The method that overrides the Servoy menu item Select > New Record (or keyboard shortcut). |
JSMethod | onNextRecordCmd The method that overrides the Servoy menu item Select > Next Record. |
JSMethod | onOmitRecordCmd The method that overrides the Servoy menu item Select > Omit Record. |
JSMethod | onPreviousRecordCmd The method that overrides the Servoy menu item Select > Previous Record. |
JSMethod | onPrintPreviewCmd The method that overrides the Servoy menu item File > Print Preview. |
JSMethod | onRecordEditStart The method that is triggered when a user clicks into a column on the form. |
JSMethod | onRecordEditStop The method that is triggered when a record is being saved. |
JSMethod | onRecordSelection The method that is triggered each time a record is selected. |
JSMethod | onRender The method that is executed when the component is rendered. |
JSMethod | onResize The method that gets triggered when resize occurs. |
JSMethod | onSearchCmd The method that overrides the Servoy menu item Select > Search (or keyboard shortcut) in Find mode. |
JSMethod | onShow The method that is triggered EVERY TIME the form is displayed; an argument must be passed to the method if this is the first time the form is displayed. |
JSMethod | onShowAllRecordsCmd The method that overrides the Servoy menu item Select > Show All (or keyboard shortcut). |
JSMethod | onShowOmittedRecordsCmd The method that overrides the Servoy menu item Select > Show Omitted Records. |
JSMethod | onSortCmd The method that overrides the Servoy menu item Select > Sort. |
JSMethod | onUnLoad The method that is triggered when a form is unloaded from the repository. |
Number | paperPrintScale The percentage value the printed page is enlarged or reduced to; the size of the printed form is inversely proportional. |
Number | scrollbars Scrollbar options for the vertical and horizontal scrollbars. |
Number | selectionMode Returns the value of the form's selectionMode property. |
String | serverName Get the server name used by this form. |
Boolean | showInMenu When set, the form is displayed under the Window menu. |
String | styleClass The Cascading Style Sheet (CSS) class name applied to the form. |
String | styleName The name of the Servoy style that is being used on the form. |
String | tableName The [name of the table/SQL view]. |
String | titleText The text that displays in the title bar of the form window. |
Boolean | transparent When set, the form is transparent. |
Number | view The default form view mode. |
Number | width The width of the form in pixels. |
Method Summary | |
---|---|
JSBean | getBean(name) Returns a JSBean that has the given name. |
JSBean[] | getBeans() Returns all JSBeans of this form. |
JSBean[] | getBeans(returnInheritedElements) Returns all JSBeans of this form. |
JSPart | getBodyPart() Retrieves the Body part of the form. |
JSButton | getButton(name) Returns a JSButton that has the given name. |
JSButton[] | getButtons() Returns all JSButtons of this form, including the ones without a name. |
JSButton[] | getButtons(returnInheritedElements) Returns all JSButtons of this form, including the ones without a name. |
JSComponent | getComponent(name) Returns a JSComponent that has the given name; if found it will be a JSField, JSLabel, JSButton, JSPortal, JSBean or JSTabPanel. |
JSComponent[] | getComponents() Returns a array of all the JSComponents that a form has; they are of type JSField,JSLabel,JSButton,JSPortal,JSBean or JSTabPanel. |
JSComponent[] | getComponents(returnInheritedElements) Returns a array of all the JSComponents that a form has; they are of type JSField,JSLabel,JSButton,JSPortal,JSBean or JSTabPanel. |
Object | getDesignTimeProperty() Get a design-time property of a form. |
String[] | getDesignTimePropertyNames() Get the design-time properties of a form. |
JSField | getField(name) The field with the specified name. |
JSField[] | getFields() Returns all JSField objects of this form, including the ones without a name. |
JSField[] | getFields(returnInheritedElements) Returns all JSField objects of this form, including the ones without a name. |
JSPart | getFooterPart() Retrieves the Footer part of the form. |
JSPart | getHeaderPart() Retrieves the Header part of the form. |
JSLabel | getLabel(name) Returns a JSLabel that has the given name. |
JSLabel[] | getLabels() Returns all JSLabels of this form (not including its super form), including the ones without a name. |
JSLabel[] | getLabels(returnInheritedElements) Returns all JSLabels of this form (optionally including it super forms labels), including the ones without a name. |
JSPart | getLeadingGrandSummaryPart() Retrieves the Leading Grand Summary part of the form. |
JSPart[] | getLeadingSubSummaryParts() Gets an array of the Leading Subsummary parts of the form, ordered by their height from top == 0 to bottom. |
JSMethod | getMethod(name) Gets an existing form method for the given name. |
JSMethod[] | getMethods() Returns all existing form methods for this form. |
JSMethod[] | getMethods(returnInheritedElements) Returns all existing form methods for this form. |
JSPart | getPart(type) Gets a part of the form from the given type (see JSPart constants). |
JSPart | getPart(type, height) Gets a part of the form from the given type (see JSPart constants). |
Number | getPartYOffset(type) Returns the Y offset of a given part (see JSPart) of the form. |
Number | getPartYOffset(type, height) Returns the Y offset of a given part (see JSPart) of the form. |
JSPart[] | getParts() Gets all the parts from the form (not including the parts of the parent form), ordered by there height (lowerbound) property, from top == 0 to bottom. |
JSPart[] | getParts(returnInheritedElements) Gets all the parts from the form (optionally also from the parent form), ordered by there height (lowerbound) property, from top == 0 to bottom. |
JSPortal | getPortal(name) Returns a JSPortal that has the given name. |
JSPortal[] | getPortals() Returns all JSPortal objects of this form (not including the ones from the parent form), including the ones without a name. |
JSPortal[] | getPortals(returnInheritedElements) Returns all JSPortal objects of this form (optionally also the ones from the parent form), including the ones without a name. |
JSTabPanel | getTabPanel(name) Returns a JSTabPanel that has the given name. |
JSTabPanel[] | getTabPanels() Returns all JSTabPanels of this form (not including the ones from the parent form), including the ones without a name. |
JSTabPanel[] | getTabPanels(returnInheritedElements) Returns all JSTabPanels of this form (optionally the ones from the parent form), including the ones without a name. |
JSPart | getTitleFooterPart() Retrieves the Title Footer part of the form. |
JSPart | getTitleHeaderPart() Retrieves the Title Header part of the form. |
JSPart | getTrailingGrandSummaryPart() Retrieves the Trailing Grand Summary part of the form. |
JSPart[] | getTrailingSubSummaryParts() Gets an array of the Trailing Subsummary parts of the form, ordered by their height from top == 0 to bottom. |
UUID | getUUID() Returns the UUID of this form. |
JSVariable | getVariable(name) Gets an existing form variable for the given name. |
JSVariable[] | getVariables() An array consisting of all form variables for this form. |
JSVariable[] | getVariables(returnInheritedElements) An array consisting of all form variables for this form. |
JSBean | newBean(name, className, x, y, width, height) Creates a new JSBean object on the form - including the name of the JSBean object; the classname the JSBean object is based on, the "x" and "y" position of the JSBean object in pixels, as well as the width and height of the JSBean object in pixels. |
JSButton | newButton(txt, x, y, width, height, action) Creates a new button on the form with the given text, place, size and JSMethod as the onAction event triggered action. |
JSField | newCalendar(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of CALENDAR - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSField | newCheck(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of CHECK (checkbox) - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSField | newComboBox(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of COMBOBOX - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSField | newField(dataprovider, type, x, y, width, height) Creates a new JSField object on the form - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSPart | newFooterPart(height) Creates a new Footer part on the form. |
JSPart | newHeaderPart(height) Creates a new Header part on the form. |
JSField | newHtmlArea(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of HTML_AREA - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSField | newImageMedia(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of IMAGE_MEDIA - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSLabel | newLabel(txt, x, y, width, height) Creates a new JSLabel object on the form - including the text of the label, the "x" and "y" position of the label object in pixels, the width and height of the label object in pixels. |
JSLabel | newLabel(txt, x, y, width, height, action) Creates a new JSLabel object on the form - including the text of the label, the "x" and "y" position of the label object in pixels, the width and height of the label object in pixels and a JSMethod action such as the method for an onAction event. |
JSPart | newLeadingGrandSummaryPart(height) Creates a new Leading Grand Summary part on the form. |
JSPart | newLeadingSubSummaryPart(height) Creates a new Leading Subsummary part on the form. |
JSField | newListBox(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of LISTBOX - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSMethod | newMethod(code) Creates a new form JSMethod - based on the specified code. |
JSField | newMultiSelectListBox(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of MULTISELECT_LISTBOX - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSPart | newPart(type, height) Creates a new part on the form. |
JSField | newPassword(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of PASSWORD - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSPortal | newPortal(name, relation, x, y, width, height) Creates a new JSPortal object on the form - including the name of the JSPortal object; the relation the JSPortal object is based on, the "x" and "y" position of the JSPortal object in pixels, as well as the width and height of the JSPortal object in pixels. |
JSField | newRadios(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of RADIOS (radio buttons) - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSField | newRtfArea(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of RTF_AREA (enables more than one line of text to be displayed in a field) - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSField | newSpinner(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of SPINNER - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSTabPanel | newTabPanel(name, x, y, width, height) Creates a new JSTabPanel object on the form - including the name of the JSTabPanel object, the "x" and "y" position of the JSTabPanel object in pixels, as well as the width and height of the JSTabPanel object in pixels. |
JSField | newTextArea(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of TEXT_AREA - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSField | newTextField(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of TEXT_FIELD - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSPart | newTitleFooterPart(height) Creates a new Title Footer part on the form. |
JSPart | newTitleHeaderPart(height) Creates a new Title Header part on the form. |
JSPart | newTrailingGrandSummaryPart(height) Creates a new Trailing Grand Summary part on the form. |
JSPart | newTrailingSubSummaryPart(height) Creates a new Trailing Subsummary part on the form. |
JSField | newTypeAhead(dataprovider, x, y, width, height) Creates a new JSField object on the form with the displayType of TYPE_AHEAD - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels. |
JSVariable | newVariable(name, type) Creates a new form JSVariable - based on the name of the variable object and the number type, uses the SolutionModel JSVariable constants. |
JSVariable | newVariable(name, type, defaultValue) Creates a new form JSVariable - based on the name of the variable object , the type and it's default value , uses the SolutionModel JSVariable constants. |
Object | putDesignTimeProperty() Set a design-time property of a form. |
Boolean | removeBean(name) Removes a JSBean that has the specified name. |
Boolean | removeButton(name) Removes a JSButton that has the specified name. |
Boolean | removeComponent(name) Removes a component (JSLabel, JSButton, JSField, JSPortal, JSBean, JSTabpanel) that has the given name. |
Object | removeDesignTimeProperty() Clear a design-time property of a form. |
Boolean | removeField(name) Removes a JSField that has the given name. |
Boolean | removeLabel(name) Removes a JSLabel that has the given name. |
Boolean | removeMethod(name) Removes a form JSMethod - based on the specified code. |
Boolean | removePart(type) Removes a JSPart of the given type. |
Boolean | removePart(type, height) Removes a JSPart of the given type. |
Boolean | removePortal(name) Removes a JSPortal that has the given name. |
Boolean | removeTabPanel(name) Removes a JSTabPanel that has the given name. |
Boolean | removeVariable(name) Removes a form JSVariable - based on the name of the variable object. |
Constants Details |
---|
EMPTY_FOUNDSET |
Constant used for form namedFoundset property. The form that uses empty namedFoundset will initially have an empty (cleared) foundset.
|
Returns |
Sample// form with empty foundset var frmEmpty = solutionModel.newForm('products_empty', 'example_data', 'products', null, true, 640, 480); frmEmpty.newLabel("Empty FoundSet",10,10,200,20); frmEmpty.newField('categoryid',JSField.TEXT_FIELD,10,40,200,20); frmEmpty.newField('productname',JSField.TEXT_FIELD,10,70,200,20); frmEmpty.namedFoundSet = JSForm.EMPTY_FOUNDSET; |
LIST_VIEW |
The constants to set or get the view property of a JSForm.
They are as follows: JSForm.LIST_VIEW, JSForm.LOCKED_LIST_VIEW, JSForm.LOCKED_RECORD_VIEW, JSForm.LOCKED_TABLE_VIEW, JSForm.RECORD_VIEW. |
Returns |
Samplevar myListViewForm = solutionModel.newForm('newForm1', myDatasource, myStyleName, false, 800, 600); myListViewForm.view = JSForm.LIST_VIEW; var myLockedListViewForm = solutionModel.newForm('newForm2', myDatasource, myStyleName, false, 800, 600); myLockedListViewForm.view = JSForm.LOCKED_LIST_VIEW; var myLockedRecordViewForm = solutionModel.newForm('newForm3', myDatasource, myStyleName, false, 800, 600); myLockedRecordViewForm.view = JSForm.LOCKED_RECORD_VIEW; var myLockedTableViewForm = solutionModel.newForm('newForm4', myDatasource, myStyleName, false, 800, 600); myLockedTableViewForm.view = JSForm.LOCKED_TABLE_VIEW; var myRecordViewForm = solutionModel.newForm('newForm5', myDatasource, myStyleName, false, 800, 600); myRecordViewForm.view = JSForm.RECORD_VIEW; |
LOCKED_LIST_VIEW |
The constants to set or get the view property of a JSForm.
They are as follows: JSForm.LIST_VIEW, JSForm.LOCKED_LIST_VIEW, JSForm.LOCKED_RECORD_VIEW, JSForm.LOCKED_TABLE_VIEW, JSForm.RECORD_VIEW. |
Returns |
Samplevar myListViewForm = solutionModel.newForm('newForm1', myDatasource, myStyleName, false, 800, 600); myListViewForm.view = JSForm.LIST_VIEW; var myLockedListViewForm = solutionModel.newForm('newForm2', myDatasource, myStyleName, false, 800, 600); myLockedListViewForm.view = JSForm.LOCKED_LIST_VIEW; var myLockedRecordViewForm = solutionModel.newForm('newForm3', myDatasource, myStyleName, false, 800, 600); myLockedRecordViewForm.view = JSForm.LOCKED_RECORD_VIEW; var myLockedTableViewForm = solutionModel.newForm('newForm4', myDatasource, myStyleName, false, 800, 600); myLockedTableViewForm.view = JSForm.LOCKED_TABLE_VIEW; var myRecordViewForm = solutionModel.newForm('newForm5', myDatasource, myStyleName, false, 800, 600); myRecordViewForm.view = JSForm.RECORD_VIEW; |
LOCKED_RECORD_VIEW |
The constants to set or get the view property of a JSForm.
They are as follows: JSForm.LIST_VIEW, JSForm.LOCKED_LIST_VIEW, JSForm.LOCKED_RECORD_VIEW, JSForm.LOCKED_TABLE_VIEW, JSForm.RECORD_VIEW. |
Returns |
Samplevar myListViewForm = solutionModel.newForm('newForm1', myDatasource, myStyleName, false, 800, 600); myListViewForm.view = JSForm.LIST_VIEW; var myLockedListViewForm = solutionModel.newForm('newForm2', myDatasource, myStyleName, false, 800, 600); myLockedListViewForm.view = JSForm.LOCKED_LIST_VIEW; var myLockedRecordViewForm = solutionModel.newForm('newForm3', myDatasource, myStyleName, false, 800, 600); myLockedRecordViewForm.view = JSForm.LOCKED_RECORD_VIEW; var myLockedTableViewForm = solutionModel.newForm('newForm4', myDatasource, myStyleName, false, 800, 600); myLockedTableViewForm.view = JSForm.LOCKED_TABLE_VIEW; var myRecordViewForm = solutionModel.newForm('newForm5', myDatasource, myStyleName, false, 800, 600); myRecordViewForm.view = JSForm.RECORD_VIEW; |
LOCKED_TABLE_VIEW |
The constants to set or get the view property of a JSForm.
They are as follows: JSForm.LIST_VIEW, JSForm.LOCKED_LIST_VIEW, JSForm.LOCKED_RECORD_VIEW, JSForm.LOCKED_TABLE_VIEW, JSForm.RECORD_VIEW. |
Returns |
Samplevar myListViewForm = solutionModel.newForm('newForm1', myDatasource, myStyleName, false, 800, 600); myListViewForm.view = JSForm.LIST_VIEW; var myLockedListViewForm = solutionModel.newForm('newForm2', myDatasource, myStyleName, false, 800, 600); myLockedListViewForm.view = JSForm.LOCKED_LIST_VIEW; var myLockedRecordViewForm = solutionModel.newForm('newForm3', myDatasource, myStyleName, false, 800, 600); myLockedRecordViewForm.view = JSForm.LOCKED_RECORD_VIEW; var myLockedTableViewForm = solutionModel.newForm('newForm4', myDatasource, myStyleName, false, 800, 600); myLockedTableViewForm.view = JSForm.LOCKED_TABLE_VIEW; var myRecordViewForm = solutionModel.newForm('newForm5', myDatasource, myStyleName, false, 800, 600); myRecordViewForm.view = JSForm.RECORD_VIEW; |
RECORD_VIEW |
The constants to set or get the view property of a JSForm.
They are as follows: JSForm.LIST_VIEW, JSForm.LOCKED_LIST_VIEW, JSForm.LOCKED_RECORD_VIEW, JSForm.LOCKED_TABLE_VIEW, JSForm.RECORD_VIEW. |
Returns |
Samplevar myListViewForm = solutionModel.newForm('newForm1', myDatasource, myStyleName, false, 800, 600); myListViewForm.view = JSForm.LIST_VIEW; var myLockedListViewForm = solutionModel.newForm('newForm2', myDatasource, myStyleName, false, 800, 600); myLockedListViewForm.view = JSForm.LOCKED_LIST_VIEW; var myLockedRecordViewForm = solutionModel.newForm('newForm3', myDatasource, myStyleName, false, 800, 600); myLockedRecordViewForm.view = JSForm.LOCKED_RECORD_VIEW; var myLockedTableViewForm = solutionModel.newForm('newForm4', myDatasource, myStyleName, false, 800, 600); myLockedTableViewForm.view = JSForm.LOCKED_TABLE_VIEW; var myRecordViewForm = solutionModel.newForm('newForm5', myDatasource, myStyleName, false, 800, 600); myRecordViewForm.view = JSForm.RECORD_VIEW; |
SELECTION_MODE_DEFAULT |
Constant used for form selectionMode property. It means that the foundset's multiSelect property is used.
|
Returns |
Samplevar myForm = solutionModel.getForm('my_form_name'); myForm.selectionMode = JSForm.SELECTION_MODE_DEFAULT; |
SELECTION_MODE_MULTI |
Constant used for form selectionMode property. It means that the form will force multiSelect to true on the foundset it uses.
|
Returns |
Samplevar myForm = solutionModel.getForm('my_form_name'); myForm.selectionMode = JSForm.SELECTION_MODE_MULTI; |
SELECTION_MODE_SINGLE |
Constant used for form selectionMode property. It means that the form will force multiSelect to false on the foundset it uses.
|
Returns |
Samplevar myForm = solutionModel.getForm('my_form_name'); myForm.selectionMode = JSForm.SELECTION_MODE_SINGLE; |
SEPARATE_FOUNDSET |
Constant used for form namedFoundset property. The form that uses a separate namedFoundset will initially have an separate (not shared with other forms) foundset.
|
Returns |
Sample// form with separate foundset var frmSeparate = solutionModel.newForm('products_separate', 'example_data', 'products', null, true, 640, 480); frmSeparate.newLabel("Separate FoundSet",10,10,200,20); frmSeparate.newField('categoryid',JSField.TEXT_FIELD,10,40,200,20); frmSeparate.newField('productname',JSField.TEXT_FIELD,10,70,200,20); frmSeparate.namedFoundSet = JSForm.SEPARATE_FOUNDSET; forms['products_separate'].controller.find(); forms['products_separate'].categoryid = '=2'; forms['products_separate'].controller.search(); |
Property Details |
---|
borderType |
The type, color and style of border of the component.
|
Returns |
Sample//HINT: To know exactly the notation of this property set it in the designer and then read it once out through the solution model. var field = form.newField('my_table_text', JSField.TEXT_FIELD, 10, 10, 100, 20); field.borderType = solutionModel.createLineBorder(1,'#ff0000'); |
dataSource |
The names of the database server and table that this form is linked to.
|
Returns |
Samplevar myForm = solutionModel.newForm('newForm', 'db:/a_server/a_table', 'aStyleName', false, 800, 600) myForm.dataSource = 'db:/anotherServerName/anotherTableName' |
defaultPageFormat |
The default page format for the form.
|
Returns |
Samplevar form = solutionModel.getForm("someForm"); application.output(form.defaultPageFormat); form.defaultPageFormat = solutionModel.createPageFormat(612,792,72,72,72,72,SM_ORIENTATION.PORTRAIT,SM_UNITS.PIXELS) |
encapsulation |
Get or set the encapsulation level for the form. Encapsulation is one of constants JSForm.DEFAULT_ENCAPSULATION, JSForm.PRIVATE_ENCAPSULATION, JSForm.MODULE_PRIVATE_ENCAPSULATION, |
Returns |
Samplevar myForm = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); myForm.encapsulation = JSForm.HIDE_CONTROLLER_ENCAPSULATION; |
extendsForm |
A JSForm instance representing the super form of this form, if this form has a super form.
|
Returns |
Samplevar subForm = solutionModel.newForm('childForm',myDatasource,null,true,800,600); var superForm = solutionModel.newForm('childForm',myDatasource,null,true,800,600); subForm.extendsForm = superForm; |
initialSort |
The default sort order only when the form loads.
This is applied each time an internal SQL query is being executed (find, find-all, open form); and is only executed when no other manual sort has been performed on the foundset. |
Returns |
Samplevar form = solutionModel.newForm('myForm',myDatasource,null,true,800,600); form.initialSort = "column1 desc, column2 asc, column3 asc"; |
name |
The name of the form.
|
Returns |
Samplevar form = solutionModel.newForm('myForm',myDatasource,null,true,800,600); var formName = form.name; application.output(formName); |
namedFoundSet |
Property that tells the form to use a named foundset instead of the default foundset. The namedFoundset can be based on a global relation; in this case namedFoundset is the relation's name. |
Returns |
Sample// form with separate foundset var frmSeparate = solutionModel.newForm('products_separate', 'db:/example_data/products', null, true, 640, 480); frmSeparate.newLabel("Separate FoundSet",10,10,200,20); frmSeparate.newField('categoryid',JSField.TEXT_FIELD,10,40,200,20); frmSeparate.newField('productname',JSField.TEXT_FIELD,10,70,200,20); frmSeparate.namedFoundSet = JSForm.SEPARATE_FOUNDSET; forms['products_separate'].controller.find(); forms['products_separate'].categoryid = '=2'; forms['products_separate'].controller.search(); // form with empty foundset var frmEmpty = solutionModel.newForm('products_empty', 'db:/example_data/products', null, true, 640, 480); frmEmpty.newLabel("Empty FoundSet",10,10,200,20); frmEmpty.newField('categoryid',JSField.TEXT_FIELD,10,40,200,20); frmEmpty.newField('productname',JSField.TEXT_FIELD,10,70,200,20); frmEmpty.namedFoundSet = JSForm.EMPTY_FOUNDSET; // form with an initial foundset based on a global relation var frmGlobalRel = solutionModel.newForm("categories_related", solutionModel.getForm("categories")); frmGlobalRel.namedFoundSet = "g2_to_category_name"; // form with an initial foundset based on a global relation var frmGlobalRel = solutionModel.newForm("categories_related", solutionModel.getForm("categories")); frmGlobalRel.namedFoundSet = solutionModel.getRelation("g1_to_categories"); |
navigator |
The navigator (previously named "controller") The following options are available: |
Returns |
Samplevar aForm = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); // you can also use SM_DEFAULTS.INGORE to just reuse the navigator that is already set, or SM_DEFAULTS.DEFAULT to have the default servoy navigator. // here we assign an other new form as the navigator. var aNavigator = solutionModel.newForm('navForm', myDatasource, null, false, 800, 600); // set the navigators navigator to NONE aNavigator.navigator = SM_DEFAULTS.NONE; // Hide the navigator on the form. myListViewForm.navigator = aNavigator; application.output(myListViewForm.navigator.name); |
onDeleteAllRecordsCmd |
The method that overrides the Servoy menu item Select > Delete All.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onNewRecordCmd = form.newMethod('function onNewRecordCmd(event) { application.output("onNewRecordCmd intercepted on " + event.getFormName()); }'); form.onDuplicateRecordCmd = form.newMethod('function onDuplicateRecordCmd(event) { application.output("onDuplicateRecordCmd intercepted on " + event.getFormName()); }'); form.onDeleteRecordCmd = form.newMethod('function onDeleteRecordCmd(event) { application.output("onDeleteRecordCmd intercepted on " + event.getFormName()); }'); form.onDeleteAllRecordsCmd = form.newMethod('function onDeleteAllRecordsCmd(event) { application.output("onDeleteAllRecordsCmd intercepted on " + event.getFormName()); }'); |
onDeleteRecordCmd |
The method that overrides the Servoy menu item Select > Delete Record (or keyboard shortcut).
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onNewRecordCmd = form.newMethod('function onNewRecordCmd(event) { application.output("onNewRecordCmd intercepted on " + event.getFormName()); }'); form.onDuplicateRecordCmd = form.newMethod('function onDuplicateRecordCmd(event) { application.output("onDuplicateRecordCmd intercepted on " + event.getFormName()); }'); form.onDeleteRecordCmd = form.newMethod('function onDeleteRecordCmd(event) { application.output("onDeleteRecordCmd intercepted on " + event.getFormName()); }'); form.onDeleteAllRecordsCmd = form.newMethod('function onDeleteAllRecordsCmd(event) { application.output("onDeleteAllRecordsCmd intercepted on " + event.getFormName()); }'); |
onDrag |
The method that is triggered when (non Design Mode) dragging occurs.
|
Returns |
Sampleform.onDrag = form.newMethod('function onDrag(event) { application.output("onDrag intercepted from " + event.getSource()); }'); form.onDragEnd = form.newMethod('function onDragEnd(event) { application.output("onDragEnd intercepted from " + event.getSource()); }'); form.onDragOver = form.newMethod('function onDragOver(event) { application.output("onDragOver intercepted from " + event.getSource()); }'); form.onDrop = form.newMethod('function onDrop(event) { application.output("onDrop intercepted from " + event.getSource()); }'); |
onDragEnd |
The method that is triggered when (non Design Mode) dragging end occurs.
|
Returns |
Sampleform.onDrag = form.newMethod('function onDrag(event) { application.output("onDrag intercepted from " + event.getSource()); }'); form.onDragEnd = form.newMethod('function onDragEnd(event) { application.output("onDragEnd intercepted from " + event.getSource()); }'); form.onDragOver = form.newMethod('function onDragOver(event) { application.output("onDragOver intercepted from " + event.getSource()); }'); form.onDrop = form.newMethod('function onDrop(event) { application.output("onDrop intercepted from " + event.getSource()); }'); |
onDragOver |
The method that is triggered when (non Design Mode) dragging over a component occurs.
|
Returns |
Sampleform.onDrag = form.newMethod('function onDrag(event) { application.output("onDrag intercepted from " + event.getSource()); }'); form.onDragEnd = form.newMethod('function onDragEnd(event) { application.output("onDragEnd intercepted from " + event.getSource()); }'); form.onDragOver = form.newMethod('function onDragOver(event) { application.output("onDragOver intercepted from " + event.getSource()); }'); form.onDrop = form.newMethod('function onDrop(event) { application.output("onDrop intercepted from " + event.getSource()); }'); |
onDrop |
The method that is triggered when (non Design Mode) dropping occurs.
|
Returns |
Sampleform.onDrag = form.newMethod('function onDrag(event) { application.output("onDrag intercepted from " + event.getSource()); }'); form.onDragEnd = form.newMethod('function onDragEnd(event) { application.output("onDragEnd intercepted from " + event.getSource()); }'); form.onDragOver = form.newMethod('function onDragOver(event) { application.output("onDragOver intercepted from " + event.getSource()); }'); form.onDrop = form.newMethod('function onDrop(event) { application.output("onDrop intercepted from " + event.getSource()); }'); |
onDuplicateRecordCmd |
The method that overrides the Servoy menu item Select > Duplicate Record (or keyboard shortcut).
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onNewRecordCmd = form.newMethod('function onNewRecordCmd(event) { application.output("onNewRecordCmd intercepted on " + event.getFormName()); }'); form.onDuplicateRecordCmd = form.newMethod('function onDuplicateRecordCmd(event) { application.output("onDuplicateRecordCmd intercepted on " + event.getFormName()); }'); form.onDeleteRecordCmd = form.newMethod('function onDeleteRecordCmd(event) { application.output("onDeleteRecordCmd intercepted on " + event.getFormName()); }'); form.onDeleteAllRecordsCmd = form.newMethod('function onDeleteAllRecordsCmd(event) { application.output("onDeleteAllRecordsCmd intercepted on " + event.getFormName()); }'); |
onElementFocusGained |
The method that is triggered when focus is gained by a component inside the form.
|
Returns |
Sampleform.onElementFocusGained = form.newMethod('function onElementFocusGained(event) { application.output("onElementFocusGained intercepted from " + event.getSource()); }'); form.onElementFocusLost = form.newMethod('function onElementFocusLost(event) { application.output("onElementFocusLost intercepted from " + event.getSource()); }'); |
onElementFocusLost |
The method that gets triggered when focus is lost by a component inside the form.
|
Returns |
Sampleform.onElementFocusGained = form.newMethod('function onElementFocusGained(event) { application.output("onElementFocusGained intercepted from " + event.getSource()); }'); form.onElementFocusLost = form.newMethod('function onElementFocusLost(event) { application.output("onElementFocusLost intercepted from " + event.getSource()); }'); |
onFindCmd |
The method that overrides the Servoy menu item Select > Find (or keyboard shortcut) in Data (ready) mode.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onFindCmd = form.newMethod('function onFindCmd(event) { application.output("onFindCmd intercepted on " + event.getFormName()); }'); form.onSearchCmd = form.newMethod('function onSearchCmd(event) { application.output("onSearchCmd intercepted on " + event.getFormName()); }'); form.onShowAllRecordsCmd = form.newMethod('function onShowAllRecordsCmd(event) { application.output("onShowAllRecordsCmd intercepted on " + event.getFormName()); }'); |
onHide |
The method that is triggered when another form is being activated.
NOTE: If the onHide method returns false, the form can be prevented from hiding. For example, when using onHide with showFormInDialog, the form will not close by clicking the dialog close box (X). |
Returns |
Sampleform.onShow = form.newMethod('function onShow(firstShow, event) { application.output("onShow intercepted on " + event.getFormName() + ". first show? " + firstShow); return false; }'); form.onHide = form.newMethod('function onHide(event) { application.output("onHide blocked on " + event.getFormName()); return false; }'); |
onInvertRecordsCmd |
The method that overrides the Servoy menu item Select > Invert Records.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onOmitRecordCmd = form.newMethod('function onOmitRecordCmd(event) { application.output("onOmitRecordCmd intercepted on " + event.getFormName()); }'); form.onShowOmittedRecordsCmd = form.newMethod('function onShowOmittedRecordsCmd(event) { application.output("onShowOmittedRecordsCmd intercepted on " + event.getFormName()); }'); form.onInvertRecordsCmd = form.newMethod('function onInvertRecordsCmd(event) { application.output("onInvertRecordsCmd intercepted on " + event.getFormName()); }'); |
onLoad |
The method that is triggered when a form is loaded/reloaded from the repository; used to alter elements, set globals, hide toolbars,
etc; onShow method can also be assigned. NOTE: onShow should be used to access current foundset dataproviders; onLoad cannot be used because the foundset data is not loaded until after the form is loaded. Also calls to loadRecords() should be done in the onShow method and not in the onLoad method If you call loadRecords() in the onShow method, you may want to set the namedFoundSet property of the form to 'empty' to prevent the first default form query. NOTE: the onLoad event bubbles down, meaning that the onLoad is first fired on the parent then on a tab in a tabpanel (and in tab of that tab panels if you are 3 deep) |
Returns |
Sampleform.onLoad = form.newMethod('function onLoad(event) { application.output("onLoad intercepted on " + event.getFormName()); }'); form.onUnLoad = form.newMethod('function onUnLoad(event) { application.output("onUnLoad intercepted on " + event.getFormName()); }'); |
onNewRecordCmd |
The method that overrides the Servoy menu item Select > New Record (or keyboard shortcut).
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onNewRecordCmd = form.newMethod('function onNewRecordCmd(event) { application.output("onNewRecordCmd intercepted on " + event.getFormName()); }'); form.onDuplicateRecordCmd = form.newMethod('function onDuplicateRecordCmd(event) { application.output("onDuplicateRecordCmd intercepted on " + event.getFormName()); }'); form.onDeleteRecordCmd = form.newMethod('function onDeleteRecordCmd(event) { application.output("onDeleteRecordCmd intercepted on " + event.getFormName()); }'); form.onDeleteAllRecordsCmd = form.newMethod('function onDeleteAllRecordsCmd(event) { application.output("onDeleteAllRecordsCmd intercepted on " + event.getFormName()); }'); |
onNextRecordCmd |
The method that overrides the Servoy menu item Select > Next Record.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onPreviousRecordCmd = form.newMethod('function onPreviousRecordCmd(event) { application.output("onPreviousRecordCmd intercepted on " + event.getFormName()); }'); form.onNextRecordCmd = form.newMethod('function onNextRecordCmd(event) { application.output("onNextRecordCmd intercepted on " + event.getFormName()); }'); |
onOmitRecordCmd |
The method that overrides the Servoy menu item Select > Omit Record.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onOmitRecordCmd = form.newMethod('function onOmitRecordCmd(event) { application.output("onOmitRecordCmd intercepted on " + event.getFormName()); }'); form.onShowOmittedRecordsCmd = form.newMethod('function onShowOmittedRecordsCmd(event) { application.output("onShowOmittedRecordsCmd intercepted on " + event.getFormName()); }'); form.onInvertRecordsCmd = form.newMethod('function onInvertRecordsCmd(event) { application.output("onInvertRecordsCmd intercepted on " + event.getFormName()); }'); |
onPreviousRecordCmd |
The method that overrides the Servoy menu item Select > Previous Record.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onPreviousRecordCmd = form.newMethod('function onPreviousRecordCmd(event) { application.output("onPreviousRecordCmd intercepted on " + event.getFormName()); }'); form.onNextRecordCmd = form.newMethod('function onNextRecordCmd(event) { application.output("onNextRecordCmd intercepted on " + event.getFormName()); }'); |
onPrintPreviewCmd |
The method that overrides the Servoy menu item File > Print Preview.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onPrintPreviewCmd = form.newMethod('function onPrintPreviewCmd(event) { application.output("onPrintPreviewCmd intercepted on " + event.getFormName()); }'); |
onRecordEditStart |
The method that is triggered when a user clicks into a column on the form.
NOTE: There is a small "e" displayed in the lower left side of the Servoy Client screen in the status area at the bottom of the window when the record is being edited. |
Returns |
Sampleform.onRecordEditStart = form.newMethod('function onRecordEditStart(event) { application.output("onRecordEditStart intercepted on " + event.getFormName()); }'); form.onRecordEditStop = form.newMethod('function onRecordEditStop(record, event) { application.output("onRecordEditStop intercepted on " + event.getFormName() + ". record is: " + record); }'); form.onRecordSelection = form.newMethod('function onRecordSelection(event) { application.output("onRecordSelection intercepted on " + event.getFormName()); }'); |
onRecordEditStop |
The method that is triggered when a record is being saved.
A record is saved when a user clicks out of it (for example on an empty part of the layout or to another form). When the method returns false (for example as part of a validation), the user cannot leave the record, for example in a table view a user cannot move to another record when the callback returns false. |
Returns |
Sampleform.onRecordEditStart = form.newMethod('function onRecordEditStart(event) { application.output("onRecordEditStart intercepted on " + event.getFormName()); }'); form.onRecordEditStop = form.newMethod('function onRecordEditStop(record, event) { application.output("onRecordEditStop intercepted on " + event.getFormName() + ". record is: " + record); }'); form.onRecordSelection = form.newMethod('function onRecordSelection(event) { application.output("onRecordSelection intercepted on " + event.getFormName()); }'); |
onRecordSelection |
The method that is triggered each time a record is selected.
If a form is in List view or Special table view - when the user clicks on it. In Record view - after the user navigates to another record using the slider or clicks up or down for next/previous record. NOTE: Data and Servoy tag values are returned when the onRecordSelection method is executed. |
Returns |
Sampleform.onRecordEditStart = form.newMethod('function onRecordEditStart(event) { application.output("onRecordEditStart intercepted on " + event.getFormName()); }'); form.onRecordEditStop = form.newMethod('function onRecordEditStop(record, event) { application.output("onRecordEditStop intercepted on " + event.getFormName() + ". record is: " + record); }'); form.onRecordSelection = form.newMethod('function onRecordSelection(event) { application.output("onRecordSelection intercepted on " + event.getFormName()); }'); |
onRender |
The method that is executed when the component is rendered.
|
Returns |
Sampleform.onRender = form.newMethod('function onRender(event) { event.getElement().bgcolor = \'#00ff00\' }'); |
onResize |
The method that gets triggered when resize occurs.
|
Returns |
Sampleform.onResize = form.newMethod('function onResize(event) { application.output("onResize intercepted on " + event.getFormName()); }'); |
onSearchCmd |
The method that overrides the Servoy menu item Select > Search (or keyboard shortcut) in Find mode.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onFindCmd = form.newMethod('function onFindCmd(event) { application.output("onFindCmd intercepted on " + event.getFormName()); }'); form.onSearchCmd = form.newMethod('function onSearchCmd(event) { application.output("onSearchCmd intercepted on " + event.getFormName()); }'); form.onShowAllRecordsCmd = form.newMethod('function onShowAllRecordsCmd(event) { application.output("onShowAllRecordsCmd intercepted on " + event.getFormName()); }'); |
onShow |
The method that is triggered EVERY TIME the form is displayed; an argument must be passed to the method if this is the first time the form is displayed. NOTE: onShow can be used to access current foundset dataproviders; onLoad cannot be used because the foundset data is not loaded until after the form is loaded. NOTE: the onShow event bubbles down, meaning that the onShow event of a form displayed in a tabPanel is fired after the onShow event of the parent. |
Returns |
Sampleform.onShow = form.newMethod('function onShow(firstShow, event) { application.output("onShow intercepted on " + event.getFormName() + ". first show? " + firstShow); return false; }'); form.onHide = form.newMethod('function onHide(event) { application.output("onHide blocked on " + event.getFormName()); return false; }'); |
onShowAllRecordsCmd |
The method that overrides the Servoy menu item Select > Show All (or keyboard shortcut).
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onFindCmd = form.newMethod('function onFindCmd(event) { application.output("onFindCmd intercepted on " + event.getFormName()); }'); form.onSearchCmd = form.newMethod('function onSearchCmd(event) { application.output("onSearchCmd intercepted on " + event.getFormName()); }'); form.onShowAllRecordsCmd = form.newMethod('function onShowAllRecordsCmd(event) { application.output("onShowAllRecordsCmd intercepted on " + event.getFormName()); }'); |
onShowOmittedRecordsCmd |
The method that overrides the Servoy menu item Select > Show Omitted Records.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onOmitRecordCmd = form.newMethod('function onOmitRecordCmd(event) { application.output("onOmitRecordCmd intercepted on " + event.getFormName()); }'); form.onShowOmittedRecordsCmd = form.newMethod('function onShowOmittedRecordsCmd(event) { application.output("onShowOmittedRecordsCmd intercepted on " + event.getFormName()); }'); form.onInvertRecordsCmd = form.newMethod('function onInvertRecordsCmd(event) { application.output("onInvertRecordsCmd intercepted on " + event.getFormName()); }'); |
onSortCmd |
The method that overrides the Servoy menu item Select > Sort.
This property is automatically set to "DEFAULT" (no override) when the form is created. |
Returns |
Sampleform.onSortCmd = form.newMethod('function onSortCmd(dataProviderID, asc, event) { application.output("onSortCmd intercepted on " + event.getFormName() + ". data provider: " + dataProviderID + ". asc: " + asc); }'); |
onUnLoad |
The method that is triggered when a form is unloaded from the repository.
NOTE: Forms can be prevented from being removed from memory by referencing the form object in a global variable or inside an array inside a global variable. Do take care using this technique. Forms take up memory and if too many forms are in memory and cannot be unloaded, there is a possibility of running out of memory. |
Returns |
Sampleform.onLoad = form.newMethod('function onLoad(event) { application.output("onLoad intercepted on " + event.getFormName()); }'); form.onUnLoad = form.newMethod('function onUnLoad(event) { application.output("onUnLoad intercepted on " + event.getFormName()); }'); |
paperPrintScale |
The percentage value the printed page is enlarged or reduced to; the size of the printed form
is inversely proportional. For example, if the paperPrintScale is 50, the printed form will be enlarged 200%. |
Returns |
Samplevar form = solutionModel.newForm('myForm',myDatasource,null,true,800,600); if (form.paperPrintScale < 100) form.paperPrintScale = 100; |
scrollbars |
Scrollbar options for the vertical and horizontal scrollbars. Each of the
vertical and horizontal scrollbars can be configured to display all the time, to display only when needed or to never display. |
Returns |
Samplevar form = solutionModel.newForm('myForm',myDatasource,null,true,1000,600); form.scrollbars = SM_SCROLLBAR.VERTICAL_SCROLLBAR_NEVER; forms['newForm1'].controller.show(); |
selectionMode |
Returns the value of the form's selectionMode property. Can be one of SELECTION_MODE_DEFAULT, SELECTION_MODE_SINGLE or SELECTION_MODE_MULTI. |
Since 6.1
|
Returns |
Samplevar myForm = solutionModel.getForm('my_form_name'); if (myForm.selectionMode == JSForm.SELECTION_MODE_MULTI) myForm.selectionMode = JSForm.SELECTION_MODE_DEFAULT; |
serverName |
Get the server name used by this form.
|
Returns |
Samplevar form = solutionModel.newForm('myForm',myDatasource,null,true,800,600); form.serverName = 'anotherServerName'; var theServerName = form.serverName; application.output(theServerName); |
showInMenu |
When set, the form is displayed under the Window menu.
If it is not set, the form will be 'hidden'. NOTE: This is only applicable for Servoy Client. Servoy Developer always shows all forms so that developers have access to all forms within a solution during development. |
Returns |
Samplevar aForm = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var anotherForm= solutionModel.newForm('newForm2', myDatasource, null, true, 800, 600); //using 'anotherForm' as navigator for aForm anotherForm.showInMenu = false; anotherForm.navigator = null; aForm.navigator = anotherForm; application.output(aForm.navigator.name); |
styleClass |
The Cascading Style Sheet (CSS) class name applied to the form.
|
Returns |
Samplevar aForm = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); if (aForm.styleClass == null) aForm.styleClass = someStyleClass; else application.output("The Cascading Style Sheet (CSS) class name applied to this form is " + aForm.styleClass); |
styleName |
The name of the Servoy style that is being used on the form.
|
Returns |
Samplevar aForm = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); if (aForm.styleName == null) aForm.styleName = someServoyStyleName; else application.output("The name of the Servoy style that is being used on the form is " + aForm.styleName); |
tableName |
The [name of the table/SQL view].[the name of the database server connection] the form is based on.
|
Returns |
Samplevar aForm = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); aForm.tableName = 'anotherTableOfMine' if (forms['newForm1'].controller.find()) { columnTextDataProvider = '=aSearchedValue' columnNumberDataProvider = '>10'; forms['newForm1'].controller.search() } |
titleText |
The text that displays in the title bar of the form window.
NOTE: Data tags and Servoy tags can be used as part of the title text. |
Returns |
Samplevar myForm = solutionModel.newForm('newForm', 'db:/a_server/a_table', 'aStyleName', false, 800, 600) forms['newForm'].controller.show(); if (myForm.titleText == null) { myForm.titleText = "My new title text should be really cool!" forms['newForm'].controller.recreateUI(); } else application.output("My text text is already cool"); |
transparent |
When set, the form is transparent.
|
Returns |
Samplevar form = solutionModel.newForm('myForm',myDatasource,null,true,1000,800); if (form.transparent == false) { var style = solutionModel.newStyle('myStyle','form { background-color: yellow; }'); style.text = style.text + 'field { background-color: blue; }'; form.styleName = 'myStyle'; } var field = form.newField('columnTextDataProvider',JSField.TEXT_FIELD,100,100,100,50); forms['myForm'].controller.show(); |
view |
The default form view mode. The view can be changed using a method at runtime. The following views are available: NOTE: Only Table View (locked) uses asynchronized related data loading. |
Returns |
Samplevar myForm = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); myForm.view = JSForm.RECORD_VIEW; forms['newForm1'].controller.show(); |
width |
The width of the form in pixels.
|
Returns |
Samplevar myForm = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); forms['newForm1'].controller.show(); myForm.width = 120; forms['newForm1'].controller.recreateUI(); |
Method Details |
---|
getBean |
JSBean getBean (name) |
Returns a JSBean that has the given name.
|
Parameters {String} name - the specified name of the bean
|
Returns JSBean - a JSBean object
|
Samplevar btn = myForm.getBean("mybean"); application.output(mybean.className); |
getBeans |
JSBean[] getBeans () |
Returns all JSBeans of this form.
|
Returns JSBean[] - the list of all JSbuttons on this forms
|
Samplevar beans = myForm.getBeans(); for (var b in beans) { if (beans[b].name != null) application.output(beans[b].name); } |
getBeans |
JSBean[] getBeans (returnInheritedElements) |
Returns all JSBeans of this form.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from parent form
|
Returns JSBean[] - the list of all JSbuttons on this forms
|
Samplevar beans = myForm.getBeans(); for (var b in beans) { if (beans[b].name != null) application.output(beans[b].name); } |
getBodyPart |
JSPart getBodyPart () |
Retrieves the Body part of the form.
|
Returns JSPart - A JSPart instance corresponding to the Body part of the form.
|
Sampleform.getBodyPart().background = 'blue'; |
getButton |
JSButton getButton (name) |
Returns a JSButton that has the given name.
|
Parameters {String} name - the specified name of the button
|
Returns JSButton - a JSButton object
|
Samplevar btn = myForm.getButton("hello"); application.output(btn.text); |
getButtons |
JSButton[] getButtons () |
Returns all JSButtons of this form, including the ones without a name.
|
Returns JSButton[] - the list of all JSbuttons on this forms
|
Samplevar buttons = myForm.getButtons(); for (var b in buttons) { if (buttons[b].name != null) application.output(buttons[b].name); else application.output(buttons[b].text + " has no name "); } |
getButtons |
JSButton[] getButtons (returnInheritedElements) |
Returns all JSButtons of this form, including the ones without a name.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from parent form
|
Returns JSButton[] - the list of all JSbuttons on this forms
|
Samplevar buttons = myForm.getButtons(); for (var b in buttons) { if (buttons[b].name != null) application.output(buttons[b].name); else application.output(buttons[b].text + " has no name "); } |
getComponent |
JSComponent getComponent (name) |
Returns a JSComponent that has the given name; if found it will be a JSField, JSLabel, JSButton, JSPortal, JSBean or JSTabPanel.
|
Parameters {String} name - the specified name of the component
|
Returns JSComponent - a JSComponent object (might be a JSField, JSLabel, JSButton, JSPortal, JSBean or JSTabPanel)
|
Samplevar frm = solutionModel.getForm("myForm"); var cmp = frm.getComponent("componentName"); application.output("Component type and name: " + cmp); |
getComponents |
JSComponent[] getComponents () |
Returns a array of all the JSComponents that a form has; they are of type JSField,JSLabel,JSButton,JSPortal,JSBean or JSTabPanel.
|
Returns JSComponent[] - an array of all the JSComponents on the form.
|
Samplevar form = solutionModel.getForm("myForm"); var components = form.getComponents(); for (var i in components) application.output("Component type and name: " + components[i]); |
getComponents |
JSComponent[] getComponents (returnInheritedElements) |
Returns a array of all the JSComponents that a form has; they are of type JSField,JSLabel,JSButton,JSPortal,JSBean or JSTabPanel.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from the parent form
|
Returns JSComponent[] - an array of all the JSComponents on the form.
|
Samplevar form = solutionModel.getForm("myForm"); var components = form.getComponents(); for (var i in components) application.output("Component type and name: " + components[i]); |
getDesignTimeProperty |
Object getDesignTimeProperty () |
Get a design-time property of a form.
|
Returns |
Samplevar frm = solutionModel.getForm('orders') var prop = frm.getDesignTimeProperty('myprop') |
getDesignTimePropertyNames |
String[] getDesignTimePropertyNames () |
Get the design-time properties of a form.
|
Returns String[]
|
Samplevar frm = solutionModel.getForm('orders') var propNames = frm.getDesignTimePropertyNames() |
getField |
JSField getField (name) |
The field with the specified name.
|
Parameters {String} name - the specified name of the field
|
Returns JSField - a JSField object
|
Samplevar form = solutionModel.getForm("myForm"); var field = form.getField("myField"); application.output(field.dataProviderID); |
getFields |
JSField[] getFields () |
Returns all JSField objects of this form, including the ones without a name.
|
Returns JSField[] - all JSField objects of this form
|
Samplevar frm = solutionModel.getForm("myForm"); var fields = frm.getFields(); for (var f in fields) { var fname = fields[f].name; if (fname != null) application.output(fname); } |
getFields |
JSField[] getFields (returnInheritedElements) |
Returns all JSField objects of this form, including the ones without a name.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from the parent form
|
Returns JSField[] - all JSField objects of this form
|
Samplevar frm = solutionModel.getForm("myForm"); var fields = frm.getFields(); for (var f in fields) { var fname = fields[f].name; if (fname != null) application.output(fname); } |
getFooterPart |
JSPart getFooterPart () |
Retrieves the Footer part of the form.
|
Returns JSPart - A JSPart instance corresponding to the Footer part of the form.
|
Sampleform.getFooterPart().background = 'magenta'; |
getHeaderPart |
JSPart getHeaderPart () |
Retrieves the Header part of the form.
|
Returns JSPart - A JSPart instance corresponding to the Header part of the form.
|
Sampleform.getHeaderPart().background = 'orange'; |
getLabel |
JSLabel getLabel (name) |
Returns a JSLabel that has the given name.
|
Parameters {String} name - the specified name of the label
|
Returns JSLabel - a JSLabel object (or null if the label with the specified name does not exist)
|
Samplevar frm = solutionModel.getForm("myForm"); var label = frm.getLabel("myLabel"); application.output(label.text); |
getLabels |
JSLabel[] getLabels () |
Returns all JSLabels of this form (not including its super form), including the ones without a name.
|
Returns JSLabel[] - all JSLabels on this form
|
Samplevar frm = solutionModel.getForm("myForm"); var labels = frm.getLabels(); for (var i in labels) { var lname = labels[i].name; if (lname != null) application.output(lname); } |
getLabels |
JSLabel[] getLabels (returnInheritedElements) |
Returns all JSLabels of this form (optionally including it super forms labels), including the ones without a name.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from parent form
|
Returns JSLabel[] - all JSLabels on this form
|
Samplevar frm = solutionModel.getForm("myForm"); var labels = frm.getLabels(); for (var i in labels) { var lname = labels[i].name; if (lname != null) application.output(lname); } |
getLeadingGrandSummaryPart |
JSPart getLeadingGrandSummaryPart () |
Retrieves the Leading Grand Summary part of the form.
|
Returns JSPart - A JSPart instance corresponding to the Leading Grand Summary part of the form.
|
Sampleform.getLeadingGrandSummaryPart().background = 'yellow'; |
getLeadingSubSummaryParts |
JSPart[] getLeadingSubSummaryParts () |
Gets an array of the Leading Subsummary parts of the form, ordered by their height from top == 0 to bottom.
|
Returns JSPart[] - An array of JSPart instances corresponding to the Leading Subsummary parts of the form.
|
Sampleform.getLeadingSubSummaryParts()[0].background = 'green'; |
getMethod |
JSMethod getMethod (name) |
Gets an existing form method for the given name.
|
Parameters {String} name - the specified name of the method
|
Returns JSMethod - a JSMethod object (or null if the method with the specified name does not exist)
|
Samplevar frm = solutionModel.getForm("myForm"); var method = frm.getMethod("myMethod"); application.output(method.code); |
getMethods |
JSMethod[] getMethods () |
Returns all existing form methods for this form.
|
Returns JSMethod[] - all form methods for the form
|
Samplevar frm = solutionModel.getForm("myForm"); var methods = frm.getMethods(); for (var m in methods) application.output(methods[m].getName()); |
getMethods |
JSMethod[] getMethods (returnInheritedElements) |
Returns all existing form methods for this form.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from the parent form
|
Returns JSMethod[] - all form methods for the form
|
Samplevar frm = solutionModel.getForm("myForm"); var methods = frm.getMethods(); for (var m in methods) application.output(methods[m].getName()); |
getPart |
JSPart getPart (type) |
Gets a part of the form from the given type (see JSPart constants).
|
Parameters {Number} type - The type of the part to retrieve.
|
Returns JSPart - A JSPart instance representing the retrieved form part.
|
Sampleform.getPart(JSPart.HEADER).background = 'red'; form.getPart(JSPart.LEADING_SUBSUMMARY, 160).background = 'red'; |
getPart |
JSPart getPart (type, height) |
Gets a part of the form from the given type (see JSPart constants).
Use the height if you want to get a specific LEADING_SUBSUMMARY or TRAILING_SUBSUMMARY. |
Parameters |
Returns JSPart - A JSPart instance representing the retrieved form part.
|
Sampleform.getPart(JSPart.HEADER).background = 'red'; form.getPart(JSPart.LEADING_SUBSUMMARY, 160).background = 'red'; |
getPartYOffset |
Number getPartYOffset (type) |
Returns the Y offset of a given part (see JSPart) of the form. This will include
all the super forms parts if this form extends a form. |
Parameters {Number} type - The type of the part whose Y offset will be returned.
|
Returns Number - A number holding the Y offset of the specified form part.
|
Sample// get the subform var form = solutionModel.getForm('SubForm'); // get the start offset of the body var height = form.getPartYOffset(JSPart.BODY); // place a new button based on the start offset. form.newButton('mybutton',50,50+height,80,20,solutionModel.getGlobalMethod('globals', 'test')); |
getPartYOffset |
Number getPartYOffset (type, height) |
Returns the Y offset of a given part (see JSPart) of the form. This will include
all the super forms parts if this form extends a form. Use the height parameter for targetting one of multiple subsummary parts. |
Parameters |
Returns Number - A number holding the Y offset of the specified form part.
|
Sample// get the subform var form = solutionModel.getForm('SubForm'); // get the start offset of the body var height = form.getPartYOffset(JSPart.BODY); // place a new button based on the start offset. form.newButton('mybutton',50,50+height,80,20,solutionModel.getGlobalMethod('globals', 'test')); |
getParts |
JSPart[] getParts () |
Gets all the parts from the form (not including the parts of the parent form), ordered by there height (lowerbound) property, from top == 0 to bottom.
|
Returns JSPart[] - An array of JSPart instances corresponding to the parts of the form.
|
Samplevar allParts = form.getParts() for (var i=0; i<allParts.length; i++) { if (allParts[i].getPartType() == JSPart.BODY) application.output('body Y offset: ' + allParts[i].getPartYOffset()); } |
getParts |
JSPart[] getParts (returnInheritedElements) |
Gets all the parts from the form (optionally also from the parent form), ordered by there height (lowerbound) property, from top == 0 to bottom.
|
Parameters {Boolean} returnInheritedElements - true to also return the parts from parent form
|
Returns JSPart[] - An array of JSPart instances corresponding to the parts of the form.
|
Samplevar allParts = form.getParts() for (var i=0; i<allParts.length; i++) { if (allParts[i].getPartType() == JSPart.BODY) application.output('body Y offset: ' + allParts[i].getPartYOffset()); } |
getPortal |
JSPortal getPortal (name) |
Returns a JSPortal that has the given name.
|
Parameters {String} name - the specified name of the portal
|
Returns JSPortal - a JSPortal object
|
Samplevar frm = solutionModel.getForm("myForm"); var portal = frm.getPortal("myPortal"); portal.initialSort = 'my_table_text desc'; |
getPortals |
JSPortal[] getPortals () |
Returns all JSPortal objects of this form (not including the ones from the parent form), including the ones without a name.
|
Returns JSPortal[] - an array of all JSPortal objects on this form
|
Samplevar frm = solutionModel.getForm("myForm"); var portals = frm.getPortals(); for (var i in portals) { var p = portals[i]; if (p.name != null) application.output(p.name); else application.output("unnamed portal detected"); } |
getPortals |
JSPortal[] getPortals (returnInheritedElements) |
Returns all JSPortal objects of this form (optionally also the ones from the parent form), including the ones without a name.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from parent form
|
Returns JSPortal[] - an array of all JSPortal objects on this form
|
Samplevar frm = solutionModel.getForm("myForm"); var portals = frm.getPortals(); for (var i in portals) { var p = portals[i]; if (p.name != null) application.output(p.name); else application.output("unnamed portal detected"); } |
getTabPanel |
JSTabPanel getTabPanel (name) |
Returns a JSTabPanel that has the given name.
|
Parameters {String} name - the specified name of the tabpanel
|
Returns JSTabPanel - a JSTabPanel object
|
Samplevar frm = solutionModel.getForm("myForm"); var tabPanel = frm.getTabPanel("myTabPanel"); var tabs = tabPanel.getTabs(); for (var i=0; i<tabs.length; i++) application.output("Tab " + i + " has text " + tabs[i].text); |
getTabPanels |
JSTabPanel[] getTabPanels () |
Returns all JSTabPanels of this form (not including the ones from the parent form), including the ones without a name.
|
Returns JSTabPanel[] - an array of all JSTabPanel objects on this form
|
Samplevar frm = solutionModel.getForm("myForm"); var tabPanels = frm.getTabPanels(); for (var i in tabPanels) { var tp = tabPanels[i]; if (tp.name != null) application.output("Tab " + tp.name + " has text " + tp.text); else application.output("Tab with text " + tp.text + " has no name"); } |
getTabPanels |
JSTabPanel[] getTabPanels (returnInheritedElements) |
Returns all JSTabPanels of this form (optionally the ones from the parent form), including the ones without a name.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from parent form
|
Returns JSTabPanel[] - an array of all JSTabPanel objects on this form
|
Samplevar frm = solutionModel.getForm("myForm"); var tabPanels = frm.getTabPanels(); for (var i in tabPanels) { var tp = tabPanels[i]; if (tp.name != null) application.output("Tab " + tp.name + " has text " + tp.text); else application.output("Tab with text " + tp.text + " has no name"); } |
getTitleFooterPart |
JSPart getTitleFooterPart () |
Retrieves the Title Footer part of the form.
|
Returns JSPart - A JSPart instance corresponding to the Title Footer part of the form.
|
Sampleform.getTitleFooterPart().background = 'gray'; |
getTitleHeaderPart |
JSPart getTitleHeaderPart () |
Retrieves the Title Header part of the form.
|
Returns JSPart - A JSPart instance corresponding to the Title Header part of the form.
|
Sampleform.getTitleHeaderPart().background = 'red'; |
getTrailingGrandSummaryPart |
JSPart getTrailingGrandSummaryPart () |
Retrieves the Trailing Grand Summary part of the form.
|
Returns JSPart - A JSPart instance corresponding to the Trailing Grand Summary part of the form.
|
Sampleform.getTrailingGrandSummaryPart().background = 'yellow'; |
getTrailingSubSummaryParts |
JSPart[] getTrailingSubSummaryParts () |
Gets an array of the Trailing Subsummary parts of the form, ordered by their height from top == 0 to bottom.
|
Returns JSPart[] - An array of JSPart instances corresponding to the Trailing Subsummary parts of the form.
|
Sampleform.getTrailingSubSummaryParts()[0].background = 'green'; |
getUUID |
UUID getUUID () |
Returns the UUID of this form.
|
Returns |
Samplevar form_UUID = myForm.getUUID(); application.output(form_UUID.toString()); |
getVariable |
JSVariable getVariable (name) |
Gets an existing form variable for the given name.
|
Parameters {String} name - the specified name of the variable
|
Returns JSVariable - a JSVariable object
|
Samplevar frm = solutionModel.getForm("myForm"); var fvariable = frm.getVariable("myVarName"); application.output(fvariable.name + " has the default value of " + fvariable.defaultValue); |
getVariables |
JSVariable[] getVariables () |
An array consisting of all form variables for this form.
|
Returns JSVariable[] - an array of all variables on this form
|
Samplevar frm = solutionModel.getForm("myForm"); var variables = frm.getVariables(); for (var i in variables) application.output(variables[i].name); |
getVariables |
JSVariable[] getVariables (returnInheritedElements) |
An array consisting of all form variables for this form.
|
Parameters {Boolean} returnInheritedElements - true to also return the elements from the parent form
|
Returns JSVariable[] - an array of all variables on this form
|
Samplevar frm = solutionModel.getForm("myForm"); var variables = frm.getVariables(); for (var i in variables) application.output(variables[i].name); |
newBean |
JSBean newBean (name, className, x, y, width, height) |
Creates a new JSBean object on the form - including the name of the JSBean object; the classname the JSBean object is based on, the "x" and "y" position of the JSBean object in pixels, as well as the width and height of the JSBean object in pixels.
|
Parameters {String} name - the specified name of the JSBean object
{String} className - the class name of the JSBean object {Number} x - the horizontal "x" position of the JSBean object in pixels {Number} y - the vertical "y" position of the JSBean object in pixels {Number} width - the width of the JSBean object in pixels {Number} height - the height of the JSBean object in pixels |
Returns JSBean - a JSBean object
|
Samplevar form = solutionModel.newForm('newForm1', 'db:/server1/table1', null, true, 800, 600); var bean = form.newBean('bean','com.servoy.extensions.beans.dbtreeview.DBTreeView',200,200,300,300); forms['newForm1'].controller.show(); |
newButton |
JSButton newButton (txt, x, y, width, height, action) |
Creates a new button on the form with the given text, place, size and JSMethod as the onAction event triggered action.
|
Parameters {String} txt - the text on the button
{Number} x - the x coordinate of the button location on the form {Number} y - the y coordinate of the button location on the form {Number} width - the width of the button {Number} height - the height of the button {Object} action - the method assigned to handle an onAction event |
Returns JSButton - a new JSButton object
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var method = form.newMethod('function onAction(event) { application.output("onAction intercepted on " + event.getFormName()); }'); var button = form.newButton('myButton', 10, 10, 100, 30, method); application.output("The new button: " + button.name + " has the following onAction event handling method assigned " + button.onAction.getName()); |
newCalendar |
JSField newCalendar (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of CALENDAR - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object on the form with the displayType of CALENDAR
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var calendar = form.newCalendar(myDataProvider, 100, 100, 200, 200); forms['newForm1'].controller.show(); |
newCheck |
JSField newCheck (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of CHECK (checkbox) - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object on the form with the displayType of CHECK (checkbox)
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var calendar = form.newCheck(myDataProvider, 100, 100, 200, 200); forms['newForm1'].controller.show(); |
newComboBox |
JSField newComboBox (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of COMBOBOX - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object on the form with the displayType of COMBOBOX
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var calendar = form.newComboBox(myDataProvider, 100, 100, 200, 200); forms['newForm1'].controller.show(); |
newField |
JSField newField (dataprovider, type, x, y, width, height) |
Creates a new JSField object on the form - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} type - the display type of the JSField object (see the Solution Model -> JSField node for display types) {Number} x - the horizontal "x" position of the JSField object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object (of the specified display type)
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var variable = form.newVariable('myVar', JSVariable.TEXT); variable.defaultValue = "'This is a default value (with triple quotes)!'"; var field = form.newField(variable, JSField.TEXT_FIELD, 100, 100, 200, 200); forms['newForm1'].controller.show(); |
newFooterPart |
JSPart newFooterPart (height) |
Creates a new Footer part on the form.
|
Parameters {Number} height - The height of the new part
|
Returns JSPart - A JSFooter instance corresponding to the newly created Footer form part.
|
Samplevar footer = form.newFooterPart(440); |
newHeaderPart |
JSPart newHeaderPart (height) |
Creates a new Header part on the form.
|
Parameters {Number} height - The height of the new part
|
Returns JSPart - A JSPart instance corresponding to the newly created Header form part.
|
Samplevar header = form.newHeaderPart(80); |
newHtmlArea |
JSField newHtmlArea (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of HTML_AREA - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a JSField object on the form with the displayType of HTML_AREA
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var textProvider = form.newVariable('myVar',JSVariable.TEXT); textProvider.defaultValue = "'This is a triple quoted text!'"; var htmlArea = myListViewForm.newHtmlArea(textProvider,100,100,100,100); forms['newForm1'].controller.show(); |
newImageMedia |
JSField newImageMedia (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of IMAGE_MEDIA - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object on the form with the displayType of IMAGE_MEDIA
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var myMediaVar = form.newVariable("media", JSVariable.MEDIA); var imageMedia = form.newImageMedia(myMediaVar,100,100,200,200) forms['newForm1'].controller.show(); |
newLabel |
JSLabel newLabel (txt, x, y, width, height) |
Creates a new JSLabel object on the form - including the text of the label, the "x" and "y" position of the label object in pixels, the width and height of the label object in pixels.
|
Parameters {String} txt - the specified text of the label object
{Number} x - the horizontal "x" position of the label object in pixels {Number} y - the vertical "y" position of the label object in pixels {Number} width - the width of the label object in pixels {Number} height - the height of the label object in pixels |
Returns JSLabel - a JSLabel object
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var label = form.newLabel('The text on the label', 140, 140, 50, 20); forms['newForm1'].controller.show(); |
newLabel |
JSLabel newLabel (txt, x, y, width, height, action) |
Creates a new JSLabel object on the form - including the text of the label, the "x" and "y" position of the label object in pixels, the width and height of the label object in pixels and a JSMethod action such as the method for an onAction event.
|
Parameters {String} txt - the specified text of the label object
{Number} x - the horizontal "x" position of the label object in pixels {Number} y - the vertical "y" position of the label object in pixels {Number} width - the width of the label object in pixels {Number} height - the height of the label object in pixels {Object} action - the event action JSMethod of the label object |
Returns JSLabel - a JSLabel object
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var label = form.newLabel('The text on the label', 140, 140, 50, 20); forms['newForm1'].controller.show(); |
newLeadingGrandSummaryPart |
JSPart newLeadingGrandSummaryPart (height) |
Creates a new Leading Grand Summary part on the form.
|
Parameters {Number} height - The height of the new part
|
Returns JSPart - A JSPart instance corresponding to the newly created Leading Grand Summary form part.
|
Samplevar leadingGrandSummary = form.newLeadingGrandSummaryPart(120); |
newLeadingSubSummaryPart |
JSPart newLeadingSubSummaryPart (height) |
Creates a new Leading Subsummary part on the form.
|
Parameters {Number} height - The height of the new part
|
Returns JSPart - A JSPart instance corresponding to the newly created Leading Subsummary form part.
|
Samplevar leadingSubsummary = form.newLeadingSubSummaryPart(160); |
newListBox |
JSField newListBox (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of LISTBOX - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object on the form with the displayType of LISTBOX
|
Samplevar form = solutionModel.newForm('newForm1', 'myServer', 'myTable', null, true, 800, 600); var list = form.newListBox(myDataProvider, 100, 100, 200, 200); forms['newForm1'].controller.show(); |
newMethod |
JSMethod newMethod (code) |
Creates a new form JSMethod - based on the specified code.
|
Parameters {String} code - the specified code for the new method
|
Returns JSMethod - a new JSMethod object for this form
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var method = form.newMethod('function aMethod(event){application.output("Hello world!");}'); var button = myListViewForm.newButton('Show message!',50,50,100,30,method); forms['newForm1'].controller.show(); |
newMultiSelectListBox |
JSField newMultiSelectListBox (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of MULTISELECT_LISTBOX - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object on the form with the displayType of MULTISELECT_LISTBOX
|
Samplevar form = solutionModel.newForm('newForm1', 'myServer', 'myTable', null, true, 800, 600); var calendar = form.newMultiSelectListBox(myDataProvider, 100, 100, 200, 200); forms['newForm1'].controller.show(); |
newPart |
JSPart newPart (type, height) |
Creates a new part on the form. The type of the new part (use one of the JSPart constants)
and its height must be specified. |
Parameters |
Returns JSPart - A JSPart instance corresponding to the newly created form part.
|
Samplevar form = solutionModel.newForm('myForm', 'db:/example_data/my_table', null, false, 1200, 800); var header = form.newPart(JSPart.HEADER, 100); header.background = 'yellow'; var body = form.newPart(JSPart.BODY, 700); body.background = 'green'; var footer = form.newPart(JSPart.FOOTER, 800); footer.background = 'orange'; |
newPassword |
JSField newPassword (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of PASSWORD - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object on the form with the displayType of PASSWORD
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var pass = form.newPassword(scopes.globals.aVariable, 100, 100, 70, 30); forms['newForm1'].controller.show(); |
newPortal |
JSPortal newPortal (name, relation, x, y, width, height) |
Creates a new JSPortal object on the form - including the name of the JSPortal object; the relation the JSPortal object is based on, the "x" and "y" position of the JSPortal object in pixels, as well as the width and height of the JSPortal object in pixels.
|
Parameters {String} name - the specified name of the JSPortal object
{Object} relation - the relation of the JSPortal object {Number} x - the horizontal "x" position of the JSPortal object in pixels {Number} y - the vertical "y" position of the JSPortal object in pixels {Number} width - the width of the JSPortal object in pixels {Number} height - the height of the JSPortal object in pixels |
Returns JSPortal - a JSPortal object
|
Samplevar form = solutionModel.newForm('newForm1', 'db:/server1/table1', null, true, 800, 600); var relation = solutionModel.newRelation('parentToChild','db:/server1/table1','db:/server2/table2',JSRelation.INNER_JOIN); relation.newRelationItem('another_parent_table_id', '=', 'another_child_table_parent_id'); var portal = form.newPortal('portal',relation,200,200,300,300); portal.newField('someColumn',JSField.TEXT_FIELD,200,200,120); forms['newForm1'].controller.show(); |
newRadios |
JSField newRadios (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of RADIOS (radio buttons) - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a JSField object with the displayType of RADIOS (radio buttons)
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var vlist = solutionModel.newValueList('options',JSValueList.CUSTOM_VALUES); vlist.customValues = "value1\nvalue2\nvalue3"; var radios = form.newRadios('columnDataProvider',100,100,200,200); radios.valuelist = vlist; |
newRtfArea |
JSField newRtfArea (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of RTF_AREA (enables more than one line of text to be displayed in a field) - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a JSField object with the displayType of RTF_AREA
|
Samplevar form = solutionModel.newForm('newForm1',myDatasource,null,true,800,600); var rtf_area = form.newRtfArea('columnDataProvider',100,100,100,100); forms['newForm1'].controller.show(); |
newSpinner |
JSField newSpinner (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of SPINNER - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a new JSField object on the form with the displayType of SPINNER
|
Samplevar form = solutionModel.newForm('newForm1', 'myServer', 'myTable', null, true, 800, 600); var spinner = form.newSpinner(myDataProvider, 10, 460, 100, 20); forms['newForm1'].controller.show(); |
newTabPanel |
JSTabPanel newTabPanel (name, x, y, width, height) |
Creates a new JSTabPanel object on the form - including the name of the JSTabPanel object, the "x" and "y" position of the JSTabPanel object in pixels, as well as the width and height of the JSTabPanel object in pixels.
|
Parameters {String} name - the specified name of the JSTabPanel object
{Number} x - the horizontal "x" position of the JSTabPanel object in pixels {Number} y - the vertical "y" position of the JSTabPanel object in pixels {Number} width - the width of the JSTabPanel object in pixels {Number} height - the height of the JSTabPanel object in pixels |
Returns JSTabPanel - a JSTabPanel object
|
Samplevar form = solutionModel.newForm('parentForm','db:/server1/parent_table',null,false,640,480); var childOne = solutionModel.newForm('childOne','db:/server1/child_table',null,false,400,300); childOne.newField('child_table_text', JSField.TEXT_FIELD,10,10,100,20); var parentToChild = solutionModel.newRelation('parentToChild','db:/server1/parent_table','db:/server1/child_table',JSRelation.INNER_JOIN); parentToChild.newRelationItem('parent_table_id','=','child_table_parent_id'); var childTwo = solutionModel.newForm('childTwo','db:/server1/my_table',null,false,400,300); childTwo.newField('my_table_image', JSField.IMAGE_MEDIA,10,10,100,100); var tabPanel = form.newTabPanel('tabs',10,10,620,460); tabPanel.newTab('tab1','Child One',childOne,parentToChild); tabPanel.newTab('tab2','Child Two',childTwo); forms['parentForm'].controller.show(); |
newTextArea |
JSField newTextArea (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of TEXT_AREA - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSTabPanel object in pixels {Number} y - the vertical "y" position of the JSTabPanel object in pixels {Number} width - the width of the JSTabPanel object in pixels {Number} height - the height of the JSTabPanel object in pixels |
Returns JSField - a JSField object with the displayType of TEXT_AREA
|
Samplevar form = solutionModel.newForm('newForm1',myDatasource,null,true,800,600); var globalVar = solutionModel.newGlobalVariable('globals', 'myGlobal',JSVariable.TEXT); globalVar.defaultValue = "'Type your text in here'"; var textArea = form.newTextArea(globalVar,100,100,300,150); forms['newForm1'].controller.show(); |
newTextField |
JSField newTextField (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of TEXT_FIELD - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a JSField object with the displayType of TEXT_FIELD
|
Samplevar form = solutionModel.newForm('newForm1',myDatasource,null,true,800,600); //choose the dataprovider or jsvariable you want for the Text Field var x = null; //global jsvariable as the dataprovider //x = solutionModel.newGlobalVariable('globals', 'myGlobal',JSVariable.TEXT); //x.defaultValue = "'Text from a global variable'"; //or a form jsvariable as the dataprovider //x = form.newVariable('myFormVar',JSVariable.TEXT); //x.defaultValue = "'Text from a form variable'"; var textField = form.newTextField(x,100,100,200,50); //or a column data provider as the dataprovider //textField.dataProviderID = columnTextDataProvider; forms['newForm1'].controller.show(); |
newTitleFooterPart |
JSPart newTitleFooterPart (height) |
Creates a new Title Footer part on the form.
|
Parameters {Number} height - The height of the new part
|
Returns JSPart - A JSPart instance corresponding to the newly created Title Footer form part.
|
Samplevar titleFooter = form.newTitleFooterPart(500); |
newTitleHeaderPart |
JSPart newTitleHeaderPart (height) |
Creates a new Title Header part on the form.
|
Parameters {Number} height - The height of the new part
|
Returns JSPart - A JSPart instance corresponding to the newly created Title Header form part.
|
Samplevar titleHeader = form.newTitleHeaderPart(40); |
newTrailingGrandSummaryPart |
JSPart newTrailingGrandSummaryPart (height) |
Creates a new Trailing Grand Summary part on the form.
|
Parameters {Number} height - The height of the new part
|
Returns JSPart - A JSPart instance corresponding to the newly created Trailing Grand Summary form part.
|
Samplevar trailingGrandSummary = form.newTrailingGrandSummaryPart(400); |
newTrailingSubSummaryPart |
JSPart newTrailingSubSummaryPart (height) |
Creates a new Trailing Subsummary part on the form.
|
Parameters {Number} height - The height of the new part
|
Returns JSPart - A JSPart instance corresponding to the newly created Trailing Subsummary form part.
|
Samplevar trailingSubsummary = form.newTrailingSubSummaryPart(360); |
newTypeAhead |
JSField newTypeAhead (dataprovider, x, y, width, height) |
Creates a new JSField object on the form with the displayType of TYPE_AHEAD - including the dataprovider/JSVariable of the JSField object, the "x" and "y" position of the JSField object in pixels, as well as the width and height of the JSField object in pixels.
|
Parameters {Object} dataprovider - the specified dataprovider name/JSVariable of the JSField object
{Number} x - the horizontal "x" position of the JSfield object in pixels {Number} y - the vertical "y" position of the JSField object in pixels {Number} width - the width of the JSField object in pixels {Number} height - the height of the JSField object in pixels |
Returns JSField - a JSField object with the displayType of TYPE_AHEAD
|
Samplevar form = solutionModel.newForm('newForm1',myDatasource,null,true,800,600); var vlist = solutionModel.newValueList('options',JSValueList.CUSTOM_VALUES); vlist.customValues = "value1\nvalue2\nvalue3"; var typeAhead = form.newTypeAhead(columnTextDataProvider,100,100,300,200); typeAhead.valuelist = vlist; forms['newForm1'].controller.show(); |
newVariable |
JSVariable newVariable (name, type) |
Creates a new form JSVariable - based on the name of the variable object and the number type, uses the SolutionModel JSVariable constants.
|
Parameters |
Returns JSVariable - a JSVariable object
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var variable = form.newVariable('myVar', JSVariable.TEXT , "'This is a default value (with triple quotes)!'"); //or variable = form.newVariable('myVar', JSVariable.TEXT) //variable.defaultValue = "'This is a default value (with triple quotes)!'" // setting the default value after the variable is created requires form recreation //variable.defaultValue = "{a:'First letter',b:'Second letter'}" var field = form.newField(variable, JSField.TEXT_FIELD, 100, 100, 200, 200); forms['newForm1'].controller.show(); |
newVariable |
JSVariable newVariable (name, type, defaultValue) |
Creates a new form JSVariable - based on the name of the variable object , the type and it's default value , uses the SolutionModel JSVariable constants. This method does not require the form to be destroyed and recreated. Use this method if you want to change the form's model without destroying the runtime form</b> |
Parameters |
Returns JSVariable - a JSVariable object
|
Samplevar form = solutionModel.newForm('newForm1', myDatasource, null, true, 800, 600); var variable = form.newVariable('myVar', JSVariable.TEXT , "'This is a default value (with triple quotes)!'"); //or variable = form.newVariable('myVar', JSVariable.TEXT) //variable.defaultValue = "'This is a default value (with triple quotes)!'" // setting the default value after the variable is created requires form recreation //variable.defaultValue = "{a:'First letter',b:'Second letter'}" var field = form.newField(variable, JSField.TEXT_FIELD, 100, 100, 200, 200); forms['newForm1'].controller.show(); |
putDesignTimeProperty |
Object putDesignTimeProperty () |
Set a design-time property of a form.
|
Returns |
Samplevar frm = solutionModel.getForm('orders') frm.putDesignTimeProperty('myprop', 'lemon') |
removeBean |
Boolean removeBean (name) |
Removes a JSBean that has the specified name. Returns true if removal was successful, false otherwise.
|
Parameters {String} name - the specified name of the JSBean to be removed
|
Returns Boolean - true if the JSBean has been removed; false otherwise
|
Samplevar form = solutionModel.getForm('myform'); form.removeBean('mybean') |
removeButton |
Boolean removeButton (name) |
Removes a JSButton that has the specified name. Returns true if removal was successful, false otherwise.
|
Parameters {String} name - the specified name of the JSButton to be removed
|
Returns Boolean - true if the JSButton has been removed; false otherwise
|
Samplevar form = solutionModel.newForm('newFormX',myDatasource,null,true,800,600); var b1 = form.newButton('This is button1',100,100,200,50,null); b1.name = 'b1'; var jsmethod = form.newMethod("function removeMe(event) { var form = solutionModel.getForm('newFormX'); if (form.removeButton('b1') == true) application.output('Button has been removed ok'); else application.output('Button could not be deleted'); forms['newFormX'].controller.recreateUI();}"); var b2 = form.newButton('Click here to remove button1',100,230,200,50,jsmethod); b2.name = 'b2'; forms['newFormX'].controller.show(); |
removeComponent |
Boolean removeComponent (name) |
Removes a component (JSLabel, JSButton, JSField, JSPortal, JSBean, JSTabpanel) that has the given name. It is the same as calling "if(!removeLabel(name) && !removeButton(name) ....)".
Returns true if removal was successful, false otherwise. |
Parameters {String} name - the specified name of the component to be deleted
|
Returns Boolean - true if component has been successfully deleted; false otherwise
|
Samplevar form = solutionModel.newForm('newFormX','db:/server1/parent_table',null,true,1000,750); var jsbutton = form.newButton('JSButton to delete',100,100,200,50,null); jsbutton.name = 'jsb'; var jslabel = form.newLabel('JSLabel to delete',100,200,200,50,null); jslabel.name = 'jsl'; jslabel.transparent = false; jslabel.background = 'green'; var jsfield = form.newField('scopes.globals.myGlobalVariable',JSField.TEXT_FIELD,100,300,200,50); jsfield.name = 'jsf'; var relation = solutionModel.newRelation('parentToChild','db:/server1/parent_table','db:/server1/child_table',JSRelation.INNER_JOIN); relation.newRelationItem('parent_table_id', '=', 'child_table_id'); var jsportal = form.newPortal('jsp',relation,100,400,300,300); jsportal.newField('child_table_id',JSField.TEXT_FIELD,200,200,120); var childOne = solutionModel.newForm('childOne','db:/server1/child_table',null,false,400,300); childOne.newField('child_table_id', JSField.TEXT_FIELD,10,10,100,20); var childTwo = solutionModel.newForm('childTwo','server1','other_table',null,false,400,300); childTwo.newField('some_table_id', JSField.TEXT_FIELD,10,10,100,100); var jstabpanel = form.newTabPanel('jst',450,30,620,460); jstabpanel.newTab('tab1','Child One',childOne,relation); jstabpanel.newTab('tab2','Child Two',childTwo); var jsmethod = form.newMethod("function removeMe(event) { var form = solutionModel.getForm('newFormX');\n if ((form.removeComponent('jsb') == true) && (form.removeComponent('jsl') == true) && (form.removeComponent('jsf') == true) && (form.removeComponent('jsp') == true) & (form.removeComponent('jst') == true)) application.output('Components removed ok'); else application.output('Some component(s) could not be deleted'); forms['newFormX'].controller.recreateUI();}"); var removerButton = form.newButton('Click here to remove form components',450,500,250,50,jsmethod); removerButton.name = 'remover'; forms['newFormX'].controller.show(); |
removeDesignTimeProperty |
Object removeDesignTimeProperty () |
Clear a design-time property of a form.
|
Returns |
Samplevar frm = solutionModel.getForm('orders') frm.removeDesignTimeProperty('myprop') |
removeField |
Boolean removeField (name) |
Removes a JSField that has the given name. Returns true if removal was successful, false otherwise.
|
Parameters {String} name - the specified name of the JSField to remove
|
Returns Boolean - true is the JSField has been successfully removed; false otherwise
|
Samplevar form = solutionModel.newForm('newFormX',myDatasource,null,true,800,600); var jsfield = form.newField(scopes.globals.myGlobalVariable,JSField.TEXT_FIELD,100,300,200,50); jsfield.name = 'jsf'; var jsmethod = form.newMethod("function removeMe(event) { var form = solutionModel.getForm('newFormX');\n if (form.removeComponent('jsf') == true) application.output('Field has been removed ok'); else application.output('Field could not be deleted'); forms['newFormX'].controller.recreateUI();}"); var removerButton = form.newButton('Click here to remove the field',450,500,250,50,jsmethod); removerButton.name = 'remover'; forms['newFormX'].controller.show(); |
removeLabel |
Boolean removeLabel (name) |
Removes a JSLabel that has the given name. Returns true if removal successful, false otherwise
|
Parameters {String} name - the specified name of the JSLabel to be removed
|
Returns Boolean - true if the JSLabel with the given name has successfully been removed; false otherwise
|
Samplevar form = solutionModel.newForm('newFormX',myDatasource,null,true,1000,750); var jslabel = form.newLabel('JSLabel to delete',100,200,200,50,null); jslabel.name = 'jsl'; jslabel.transparent = false; jslabel.background = 'green'; var jsmethod = form.newMethod("function removeMe(event) { var form = solutionModel.getForm('newFormX'); if (form.removeComponent('jsl') == true) application.output('Label has been removed'); else application.output('Label could not be deleted'); forms['newFormX'].controller.recreateUI();}"); var removerButton = form.newButton('Click here to remove the green label',450,500,250,50,jsmethod); removerButton.name = 'remover'; forms['newFormX'].controller.show(); |
removeMethod |
Boolean removeMethod (name) |
Removes a form JSMethod - based on the specified code.
|
Parameters {String} name - the specified name of the method
|
Returns Boolean - true if method was removed successfully , false otherwise
|
Samplevar form = solutionModel.newForm('newForm1', null, null, true, 800, 600); var hello = form.newMethod('function aMethod(event){application.output("Hello world!");}'); var removeMethod = form.newMethod('function removeMethod(event){ \ solutionModel.getForm(event.getFormName()).removeMethod("aMethod"); \ forms[event.getFormName()].controller.recreateUI();\ }'); var button1 = form.newButton('Call method!',50,50,120,30,hello); var button2 = form.newButton('Remove Mehtod!',200,50,120,30,removeMethod); forms['newForm1'].controller.show(); |
removePart |
Boolean removePart (type) |
Removes a JSPart of the given type.
|
Parameters {Number} type - The type of the part that should be removed.
|
Returns Boolean - True if the part is successfully removed, false otherwise.
|
Sampleform.removePart(JSPart.HEADER); form.removePart(JSPart.LEADING_SUBSUMMARY, 160); |
removePart |
Boolean removePart (type, height) |
Removes a JSPart of the given type. The height parameter is for removing one of multiple subsummary parts.
|
Parameters |
Returns Boolean - True if the part is successfully removed, false otherwise.
|
Sampleform.removePart(JSPart.HEADER); form.removePart(JSPart.LEADING_SUBSUMMARY, 160); |
removePortal |
Boolean removePortal (name) |
Removes a JSPortal that has the given name. Returns true if removal was successful, false otherwise.
|
Parameters {String} name - the specified name of the JSPortal to be removed
|
Returns Boolean - true if the JSPortal has successfully been removed; false otherwise
|
Samplevar form = solutionModel.newForm('newFormX',myDatasource,null,true,800,600); var relation = solutionModel.newRelation('parentToChild','db:/server1/myTable','db:/server1/myOtherTable',JSRelation.INNER_JOIN); relation.newRelationItem('parent_table_id', '=', 'child_table_id'); var jsportal = form.newPortal('jsp',relation,100,400,300,300); jsportal.newField('child_table_id',JSField.TEXT_FIELD,200,200,120); var jsmethod = form.newMethod("function removeMe(event) { var form = solutionModel.getForm('newFormX');\n if (form.removeComponent('jsp') == true) application.output('Portal removed ok'); else application.output('Portal could not be deleted'); forms['newFormX'].controller.recreateUI();}"); var removerButton = form.newButton('Click here to remove the portal',450,500,250,50,jsmethod); removerButton.name = 'remover'; forms['newFormX'].controller.show(); |
removeTabPanel |
Boolean removeTabPanel (name) |
Removes a JSTabPanel that has the given name. Returns true if removal was successful, false otherwise.
|
Parameters {String} name - the specified name of the JSTabPanel to be removed
|
Returns Boolean - true is the JSTabPanel has been successfully removed, false otherwise
|
Samplevar form = solutionModel.newForm('newFormX','db:/server1/parent_table',null,false,800,600); var childOne = solutionModel.newForm('childOne','db:/server1/child_table',null,false,400,300); childOne.newField('child_table_text', JSField.TEXT_FIELD,10,10,100,20); var parentToChild = solutionModel.newRelation('parentToChild','db:/server1/parent_table','db:/server1/child_table',JSRelation.INNER_JOIN); parentToChild.newRelationItem('parent_table_id','=','child_table_id'); var childTwo = solutionModel.newForm('childTwo','db:/server1/another_table',null,false,400,300); childTwo.newField('columnDataProvider', JSField.TEXT_FIELD,10,10,100,100); var tabPanel = form.newTabPanel('jst',10,10,620,460); tabPanel.newTab('tab1','Child One',childOne,parentToChild); tabPanel.newTab('tab2','Child Two',childTwo); var jsmethod = form.newMethod("function removeMe(event) { var form = solutionModel.getForm('newFormX');\n if (form.removeComponent('jst') == true)\n application.output('TabPanel has been removed ok');\n else\n application.output('TabPanel could not be deleted');\n forms['newFormX'].controller.recreateUI();\n}"); var removerButton = form.newButton('Click here to remove the tab panel',450,500,250,50,jsmethod); removerButton.name = 'remover'; forms['newFormX'].controller.show(); |
removeVariable |
Boolean removeVariable (name) |
Removes a form JSVariable - based on the name of the variable object.
|
Parameters {String} name - the specified name of the variable
|
Returns Boolean - true if removed, false otherwise (ex: no var with that name)
|
Samplevar form = solutionModel.newForm('newForm1', null, null, true, 800, 600); var variable = form.newVariable('myVar', JSVariable.TEXT); variable.defaultValue = "'This is a default value (with triple quotes)!'"; //variable.defaultValue = "{a:'First letter',b:'Second letter'}" var field = form.newField(variable, JSField.TEXT_FIELD, 100, 100, 200, 200); forms['newForm1'].controller.show(); variable = form.removeVariable('myVar'); application.sleep(4000); forms['newForm1'].controller.recreateUI(); |