{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:class=servoy sSummery}{colgroup}{column:width=80px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Property Summary{th}{tr}{tbody}{tr}{td}[Boolean]{td}{td}[#buttonsEnabled]
Set/Get the history buttons enabled.{td}{tr}{tbody}{table}\\{table:class=servoy sSummery}{colgroup}{column:width=80px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Method Summary{th}{tr}{tbody}{tr}{td}void{td}{td}[#back]\()
Navigates back in the history stack; shows the previous form (if present).{td}{tr}{tbody}{tbody}{tr}{td}void{td}{td}[#clear]\()
Clear the entire history stack.{td}{tr}{tbody}{tbody}{tr}{td}void{td}{td}[#forward]\()
Navigates forward in the history stack; shows the next form (if present).{td}{tr}{tbody}{tbody}{tr}{td}[Number]{td}{td}[#getCurrentIndex]\()
Get the current absolute index in the history stack.{td}{tr}{tbody}{tbody}{tr}{td}[String]{td}{td}[#getFormName]\(i)
Get the form name based on the specified absolute index in the history stack location.{td}{tr}{tbody}{tbody}{tr}{td}void{td}{td}[#go]\(i)
Navigates to the relative index based on current position in the history.{td}{tr}{tbody}{tbody}{tr}{td}[Boolean]{td}{td}[#removeForm]\(formName)
Removes the named form item from the history stack (and from memory) if not currently shown.{td}{tr}{tbody}{tbody}{tr}{td}[Boolean]{td}{td}[#removeIndex]\(index)
Removes an absolute index based history stack form item.{td}{tr}{tbody}{tbody}{tr}{td}[Number]{td}{td}[#size]\()
Returns the total size of the history stack.{td}{tr}{tbody}{table}\\{table:class=servoy sDetail}{colgroup}{column:width=100%}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=1}Property Details{th}{tr}{tbody:id=B4198F9E-9C57-4B03-BA4C-5673A3D41789}{tr:id=name}{td}h6.buttonsEnabled{td}{tr}{tr:id=des}{td}{sub-section:B4198F9E-9C57-4B03-BA4C-5673A3D41789_des|text=|trigger=button}{sub-section}{sub-section:B4198F9E-9C57-4B03-BA4C-5673A3D41789_des|trigger=none|class=sIndent}
Cache
index
true
refresh
100d
showRefresh
true
id
doc
title
Refresh page
showDate
true
retry
Enable
servoy sReturnTypes2100%height: 30px;2Supported ClientssWordListSmartClientsWordListWebClientsWordListNGClientsWordListMobileClientservoy sSummary12%30%58%height: 30px;3Property SummarySet/Get the history buttons enabled.servoy sSummary12%30%58%height: 30px;3Methods SummaryvoidNavigates back in the history stack; shows the previous form (if present).voidClear the entire history stack.voidNavigates forward in the history stack; shows the next form (if present).Get the current absolute index in the history stack.Get the form name based on the specified absolute index in the history stack location.voidNavigates to the relative index based on current position in the history.Removes the named form item from the history stack (and from memory) if not currently shown.Removes an absolute index based history stack form item.Returns the total size of the history stack.propertyservoy sDetail2100%height:30px2Property DetailsbuttonsEnabledname
Get the form name based on the specified absolute index in the history stack location.
{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_prs|trigger=none}i -- the absolute index
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_ret|text=|trigger=button}{sub-section}{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_ret|trigger=none|class=sIndent}[String] -- the formName{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_see|text=|trigger=button}{sub-section}{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_see|text=|trigger=button}{sub-section}{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_sam|text=|trigger=button}{sub-section}{sub-section:498AA945-55A8-4911-B263-DD7B5E023114_sam|class=sIndent|trigger=none}{code:language=javascript}
var name = history.getFormName(history.getCurrentIndex());
{code}{sub-section}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=EBF9BBAD-15C5-4D8E-AB4F-6DA1BE93516F}{tr:id=name}{td}h6.go{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}void{span}{span:id=iets|style=float: left; font-weight: bold;}go{span}{span:id=iets|style=float: left;}\(i){span}{td}{tr}{tr:id=des}{td}{sub-section:EBF9BBAD-15C5-4D8E-AB4F-6DA1BE93516F_des|text=|trigger=button}{sub-section}{sub-section:EBF9BBAD-15C5-4D8E-AB4F-6DA1BE93516F_des|trigger=none|class=sIndent}prs
Removes the named form item from the history stack (and from memory) if not currently shown.
{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_prs|trigger=none}formName -- the name of
Will return false when the form
to remove.
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_ret|text=|trigger=button}{sub-section}{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_ret|trigger=none|class=sIndent}[Boolean] -- true if successful{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_see|text=|trigger=button}{sub-section}{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_see|text=|trigger=button}{sub-section}{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_sam|text=|trigger=button}{sub-section}{sub-section:A620DE7B-2734-45E0-BDC0-C00EEA5EEF21_sam|class=sIndent|trigger=none}{code:language=javascript}
var done = history.removeForm('mypreviousform');
{code}{sub-section}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=89C449A5-4459-4539-9AD0-66229090654C}{tr:id=name}{td}h6.removeIndex{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[Boolean]{span}{span:id=iets|style=float: left; font-weight: bold;}removeIndex{span}{span:id=iets|style=float: left;}\(index){span}{td}{tr}{tr:id=des}{td}{sub-section:89C449A5-4459-4539-9AD0-66229090654C_des|text=|trigger=button}{sub-section}{sub-section:89C449A5-4459-4539-9AD0-66229090654C_des|trigger=none|class=sIndent}
can't be removed, this can happen in certain situations:
1> The form is visible,
2> The form is executing a function (is actively used),
3> There are references to this form by a global variable/array,
4> If the form has a separate foundset with edited records that can't be saved (for example autosave is false)
Removes an absolute index based history stack form item.
{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:89C449A5-4459-4539-9AD0-66229090654C_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:89C449A5-4459-4539-9AD0-66229090654C_prs|trigger=none}index -- the index of the form to remove.
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:89C449A5-4459-4539-9AD0-66229090654C_ret|text=|trigger=button}{sub-section}{sub-section:89C449A5-4459-4539-9AD0-66229090654C_ret|trigger=none|class=sIndent}[Boolean] -- true if successful{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:89C449A5-4459-4539-9AD0-66229090654C_see|text=|trigger=button}{sub-section}{sub-section:89C449A5-4459-4539-9AD0-66229090654C_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:89C449A5-4459-4539-9AD0-66229090654C_see|text=|trigger=button}{sub-section}{sub-section:89C449A5-4459-4539-9AD0-66229090654C_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:89C449A5-4459-4539-9AD0-66229090654C_sam|text=|trigger=button}{sub-section}{sub-section:89C449A5-4459-4539-9AD0-66229090654C_sam|class=sIndent|trigger=none}{code:language=javascript}
var done = history.removeIndex(history.getCurrentIndex()+1);
{code}{sub-section}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=FB669FAA-6091-4E44-8762-96FAE52ACD55}{tr:id=name}{td}h6.size{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[Number]{span}{span:id=iets|style=float: left; font-weight: bold;}size{span}{span:id=iets|style=float: left;}\(){span}{td}{tr}{tr:id=des}{td}{sub-section:FB669FAA-6091-4E44-8762-96FAE52ACD55_des|text=|trigger=button}{sub-section}{sub-section:FB669FAA-6091-4E44-8762-96FAE52ACD55_des|trigger=none|class=sIndent}prs