ChangeForm: Difference between revisions

From NSB App Studio
Jump to navigation Jump to search
(Created page with "CHANGEFORM(''newform'') '''Description''' CHANGEFORM hides the current form and shows newForm. When the current form is hidden, its onhide() function is called. When the new...")
 
No edit summary
 
(30 intermediate revisions by 5 users not shown)
Line 1: Line 1:
CHANGEFORM(''newform'')
ChangeForm(''newForm''[, ''hideEffect''[, ''showEffect[, speed]]])


'''Description'''
== Description ==


CHANGEFORM hides the current form and shows newForm. When the current form is hidden, its onhide() function is called. When the new form shows, its onshow() function is called. The global variable NSBCurrentForm is set to newForm.
ChangeForm hides the current form and shows ''newForm''. When the current form is hidden, its onhide() function is called. When the new form shows, its onshow() function is called. The global variable [[NSBCurrentForm]] is set to ''newForm''.


'''Example'''
''newForm'' is the variable referencing the form.


<pre>
''hideEffect'' is the effect to use to hide the old form. It can be 'hide' (no effect), 'fade' or 'slide'.
 
''showEffect'' is the effect to use to show the new form. It can be 'show' (no effect), 'fade' or 'slide'. If ''showEffect'' is not specified, it will be the same as ''hideEffect''.
 
''speed'' is the time to perform the effect. It can be 'slow', 'fast' or number of milliseconds. If it is not supplied, it will take 400 milliseconds, just less than half a second.
 
== Example ==
 
<tabber>
JavaScript=
<syntaxhighlight lang="JavaScript">
//ChangeForm sample call
 
ChangeForm(Form2); 
  // or...
ChangeForm(Form1, "slide", "slide", 1000);
 
Form1.onhide = function() {
  alert("Old Form Hidden");
}


REM ChangeForm sample call
Form2.onshow = function() {
  alert("Show form " +  NSB.currentForm.id);
}
</syntaxhighlight>
|-|
BASIC=
<syntaxhighlight lang="vb.net">
Rem ChangeForm sample call


ChangeForm(Form2)                 'go to next form without transition
ChangeForm(Form2)  
'or
ChangeForm(Form2, "slide", "slide", 1000)       


Function Form1_onhide()
Function Form1_onhide()
   MsgBox "Old Form Hidden"
   console.log("Old Form Hidden")
End Function
End Function


Function Form2_onshow()
Function Form2_onshow()
   Msgbox "Show form " & NSBCurrentForm
   console.log("Show form " & NSB.currentForm.id)
End Function
End Function
</syntaxhighlight>
</tabber>
Use a variable to change forms:
<pre>
  ChangeForm(window["Form" & i])
</pre>
</pre>


'''Output'''
== Output ==
 
(msgbox showing "Old Form Hidden")


<pre>
(msgbox showing "Show form Form2")
Lowercase = a
 
Uppercase = A
== Related Items ==
</pre>
 
[[form|Form]]


'''Related Items'''
[[Category:Language Reference]]


[[form|FORM]]
[[Category:Statements - Flow of control]]

Latest revision as of 13:43, 24 July 2019

ChangeForm(newForm[, hideEffect[, showEffect[, speed]]])

Description

ChangeForm hides the current form and shows newForm. When the current form is hidden, its onhide() function is called. When the new form shows, its onshow() function is called. The global variable NSBCurrentForm is set to newForm.

newForm is the variable referencing the form.

hideEffect is the effect to use to hide the old form. It can be 'hide' (no effect), 'fade' or 'slide'.

showEffect is the effect to use to show the new form. It can be 'show' (no effect), 'fade' or 'slide'. If showEffect is not specified, it will be the same as hideEffect.

speed is the time to perform the effect. It can be 'slow', 'fast' or number of milliseconds. If it is not supplied, it will take 400 milliseconds, just less than half a second.

Example

//ChangeForm sample call

ChangeForm(Form2);  
  // or...
ChangeForm(Form1, "slide", "slide", 1000);

Form1.onhide = function() {
  alert("Old Form Hidden");
}

Form2.onshow = function() {
  alert("Show form " +  NSB.currentForm.id);
}

Rem ChangeForm sample call

ChangeForm(Form2) 
 'or
ChangeForm(Form2, "slide", "slide", 1000)        

Function Form1_onhide()
  console.log("Old Form Hidden")
End Function

Function Form2_onshow()
  console.log("Show form " & NSB.currentForm.id)
End Function

Use a variable to change forms:

  ChangeForm(window["Form" & i])

Output

(msgbox showing "Old Form Hidden")

(msgbox showing "Show form Form2")

Related Items

Form