Page History

{hidden}
DO NOT EDIT THE CONTENT OF THIS PAGE DIRECTLY, UNLESS YOU KNOW WHAT YOU'RE DOING.
		THE STRUCTURE OF THE CONTENT IS VITAL IN BEING ABLE TO EXTRACT CHANGES FROM THE PAGE AND MERGE THEM BACK INTO SERVOY SOURCE{hidden}
{sub-section:description|text=}{sub-section}\\ 

{table:id=|class=servoy sSummary}{colgroup}{column:width=80px|padding=0px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Command Summary{th}{tr}{table}\\ 

{table:id=|class=servoy sSummary}{colgroup}{column:width=80px|padding=0px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Event Summary{th}{tr}{tbody}{tr}{td}[Boolean]{td}{td}[#onHide]
The method that is triggered when another form is being activated.{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#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.{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#onRecordSelection]
The method that is triggered each time a record is selected.{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#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.{td}{tr}{tbody}{table}\\ 

{table:id=|class=servoy sSummary}{colgroup}{column:width=80px|padding=0px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Property Summary{th}{tr}{tbody}{tr}{td}[String]{td}{td}[#dataSource]
The names of the database server and table that this form is linked to.{td}{tr}{tbody}{tbody}{tr}{td}[Number]{td}{td}[#encapsulation]
The encapsulation mode for the form (see JSForm constants for encapsulation mode constants).{td}{tr}{tbody}{tbody}{tr}{td}[String]{td}{td}[#name]
The name of the form.{td}{tr}{tbody}{tbody}{tr}{td}[Number]{td}{td}[#navigator]
The navigator (previously named "controller")
that is used to control/navigate to the form.{td}{tr}{tbody}{table}\\ 

{table:id=command|class=servoy sDetail}{colgroup}{column:width=100%|padding=0px}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=1}Command Details{th}{tr}{table}\\ 

{table:id=event|class=servoy sDetail}{colgroup}{column:width=100%|padding=0px}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=1}Event Details{th}{tr}{tbody:id=onHide|class=node}{tr:id=name}{td}h6.onHide{td}{tr}{builder-show:permission=edit}{tr:id=des}{td}{sub-section:onHide_des|trigger=button|text=}{sub-section}{sub-section:onHide_des|trigger=none|class=sIndent}TheReplace 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).with description{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:onHide_snc|trigger=button|text=}{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-sub-section:onHide_snc|trigger=button|text=}{sub-section}{sub-section:onHide_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:onHide_prs|trigger=button|text=}{sub-section}{sub-section:onHide_prs|trigger=none|class=sIndent}\{[JSEvent]} event -- the event that triggered the action
{sub-section}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:onHide_ret|trigger=button|text=}{sub-section}{sub-section:onHide_ret|trigger=none|class=sIndent}[Boolean]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:onHide_see|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onHide_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:onHide_link|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onHide_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:onHide_sam|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onHide_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=onLoad|class=node}{tr:id=name}{td}h6.onLoad{td}{tr}{builder-show:permission=edit}{tr:id=des}{td}{sub-section:onLoad_des|trigger=button|text=}{sub-section}{sub-section:onLoad_des|trigger=none|class=sIndent}TheReplace 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){sub-sectionwith description{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:onLoad_snc|trigger=button|text=}{sub-section}{sub-section:onLoad_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:onLoad_prs|trigger=button|text=}{sub-section}{sub-section:onLoad_prs|trigger=none|class=sIndent}\{[JSEvent]} event -- the event that triggered the action
{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:onLoad_ret|trigger=button|text=}{sub-section}{sub-section:onLoad_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:onLoad_see|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onLoad_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:onLoad_link|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onLoad_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:onLoad_sam|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onLoad_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=onRecordSelection|class=node}{tr:id=name}{td}h6.onRecordSelection{td}{tr}{builder-show:permission=edit}{tr:id=sncdes}{td}*Since*\\td}{sub-section:onLoadonRecordSelection_sncdes|trigger=button|text=}{sub-section}{sub-section:onLoadonRecordSelection_sncdes|trigger=none|class=sIndent} Replace with version infodescription{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prssnc}{td}*ParametersSince*\\{sub-section:onLoadonRecordSelection_prssnc|trigger=button|text=}{sub-section}{sub-section:onLoadonRecordSelection_prssnc|trigger=none|class=sIndent}\{[JSEvent]} event -- the event that triggered the action
 Replace with version info{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=retprs}{td}*ReturnsParameters*\\{sub-section:onLoadonRecordSelection_retprs|trigger=button|text=}{sub-section}{sub-section:onLoadonRecordSelection_retprs|trigger=none|class=sIndent}\{[JSEvent]} event -- the event that triggered the action
{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=seeret}{td}*Also seeReturns*\\{sub-section:onLoadonRecordSelection_seeret|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onLoadonRecordSelection_seeret|trigger=none|class=sIndent}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=linksee}{td}*ExternalAlso linkssee*\\{sub-section:onLoadonRecordSelection_linksee|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onLoadonRecordSelection_linksee|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=samlink}{td}*External links*Sample*\\{sub-section:onLoadonRecordSelection_samlink|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onLoadonRecordSelection_samlink|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{trbuilder-show:classpermission=lastDetailRowedit}{td}{td}{tr}{tbody}{tbody:id=onRecordSelection|class=nodesam}{tr:id=name}{td}h6.onRecordSelection{td}{tr}{tr:id=des}{td}{td}*Sample*\\{sub-section:onRecordSelection_dessam|trigger=button|text=}{sub-section-section}{div:class=sIndent}{sub-section:onRecordSelection_dessam|trigger=none|class=sIndent}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.}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=onShow|class=node}{tr:id=name}{td}h6.onShow{td}{tr}{builder-show:permission=edit}{tr:id=des}{td}{sub-section:onShow_des|trigger=button|text=}{sub-section}{sub-section:onShow_des|trigger=none|class=sIndent}Replace with description{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:onRecordSelectiononShow_snc|trigger=button|text=}{sub-section}{sub-section:onRecordSelectiononShow_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:onRecordSelectiononShow_prs|trigger=button|text=}{sub-section}{sub-section:onRecordSelectiononShow_prs|trigger=none|class=sIndent}class=sIndent}\{[Boolean]} firstShow -- form is shown first time after load
\{[JSEvent]} event -- the event that triggered the action
{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:onRecordSelectiononShow_ret|trigger=button|text=}{sub-section}{sub-section:onRecordSelectiononShow_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:onRecordSelectiononShow_see|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onRecordSelectiononShow_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:onRecordSelectiononShow_link|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onRecordSelectiononShow_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:onRecordSelectiononShow_sam|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onRecordSelectiononShow_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{table}\\ 

{table:id=property|class=servoy sDetail}{colgroup}{column:width=100%|padding=0px}{column}{colgroup}{tr:class=lastDetailRow}{td}{tdstyle=height: 30px;}{th:colspan=1}Property Details{th}{tr}{tbody}{tbody:id=onShowdataSource|class=node}{tr:id=name}{td}h6.onShowdataSource{td}{tr}{tr:id=des}{td}{sub-section:onShow_des|trigger=button|text=}{sub-section}{sub-section:onShow_des|trigger=none|class=sIndent}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.builder-show:permission=edit}{tr:id=des}{td}{sub-section:dataSource_des|trigger=button|text=}{sub-section}{sub-section:dataSource_des|trigger=none|class=sIndent}Replace with description{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:onShowdataSource_snc|trigger=button|text=}{sub-section}{sub-section:onShowdataSource_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:onShowdataSource_prs|trigger=button|text=}{sub-section}{sub-section:onShowdataSource_prs|trigger=none|class=sIndent}\{[Boolean]} firstShow -- form is shown first time after load
\{[JSEvent]} event -- the event that triggered the action
{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:onShowdataSource_ret|trigger=button|text=}{sub-section}{sub-section:onShowdataSource_ret|trigger=none|class=sIndent}[String]{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:onShowdataSource_see|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onShowdataSource_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:onShowdataSource_link|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onShowdataSource_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:onShowdataSource_sam|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:onShowdataSource_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{table}\\ 

{table:id=property|class=servoy sDetail}{colgroup}{column:width=100%|padding=0px}{column}{colgroup}{td}{tr}{builder-show}{tr:style=height: 30px;}{th:colspan=1}Property Details{thclass=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=dataSourceencapsulation|class=node}{tr:id=name}{td}h6.dataSourceencapsulation{td}{tr}{builder-show:permission=edit}{tr:id=des}{td}{sub-section:dataSourceencapsulation_des|trigger=button|text=}{sub-section}{sub-section:dataSource_des|trigger=none|class=sIndent}The names of the database server and table that this form is linked to.encapsulation_des|trigger=none|class=sIndent}Replace with description{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:dataSourceencapsulation_snc|trigger=button|text=}{sub-section}{sub-section:dataSourceencapsulation_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:dataSourceencapsulation_prs|trigger=button|text=}{sub-section}{sub-section:dataSourceencapsulation_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{tr:id=ret}{td}*Returns*\\{sub-section:dataSourceencapsulation_ret|trigger=button|text=}{sub-section}{sub-section:dataSourceencapsulation_ret|trigger=none|class=sIndent}[String]Number] -- the encapsulation mode/level for the form{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:dataSourceencapsulation_see|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:dataSourceencapsulation_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:dataSourceencapsulation_link|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:dataSourceencapsulation_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:dataSourceencapsulation_sam|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:dataSourceencapsulation_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=encapsulationname|class=node}{tr:id=name}{td}h6.encapsulationname{td}{tr}{builder-show:permission=edit}{tr:id=des}{td}{sub-section:encapsulationname_des|trigger=button|text=}{sub-section}{sub-section:encapsulationname_des|trigger=none|class=sIndent}TheReplace encapsulation mode for the form (see JSForm constants for encapsulation mode constants).with description{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:encapsulationname_snc|trigger=button|text=}{sub-section}{sub-section:encapsulationname_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:encapsulationname_prs|trigger=button|text=}{sub-section}{sub-section:encapsulationname_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{tr:id=ret}{td}*Returns*\\{sub-section:encapsulationname_ret|trigger=button|text=}{sub-section}{sub-section:encapsulationname_ret|trigger=none|class=sIndent}[Number] -- the encapsulation mode/level for the form[String]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:encapsulationname_see|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:encapsulationname_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:encapsulationname_link|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:encapsulationname_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:encapsulationname_sam|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:encapsulationname_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=namenavigator|class=node}{tr:id=name}{td}h6.namenavigator{td}{tr}{builder-show:permission=edit}{tr:id=des}{td}{sub-section:namenavigator_des|trigger=button|text=}{sub-section}{sub-section:namenavigator_des|trigger=none|class=sIndent}TheReplace name of the form.with description{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:namenavigator_snc|trigger=button|text=}{sub-section}{sub-section:namenavigator_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:namenavigator_prs|trigger=button|text=}{sub-section}{sub-section:namenavigator_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{tr:id=ret}{td}*Returns*\\{sub-section:namenavigator_ret|trigger=button|text=}{sub-section}{sub-section:namenavigator_ret|trigger=none|class=sIndent}[StringNumber]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:namenavigator_see|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:namenavigator_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:namenavigator_link|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:namenavigator_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:namenavigator_sam|trigger=button|text=}{sub-section}{div:class=sIndent}{sub-section:namenavigator_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{table}