ChangeForm

From NSB App Studio
Jump to navigation Jump to search

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

Description

Visual effects added in AppStudio 5.

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.

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 (Basic)

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])

Example (JavaScript)

//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);
}

Output

(msgbox showing "Old Form Hidden")

(msgbox showing "Show form Form2")

Related Items

Form