Skip to main content

hideBackgroundForm

Description​

Hides a background form's UI. The form stays in memory, so you can show it again at any time with showBackgroundForm().

Parameters​

ParameterTypeDescription
formPathStringPath of the form to hide

Returns​

void

Notes​

  • Only the UI is hidden — the form instance stays in memory, so its state and data remain intact.
  • To remove the form completely, use closeBackgroundForm().
  • Passing the path of a form that isn't loaded raises no error; the call is ignored.

Example​

// Hide the form
$app.hideBackgroundForm("alarm/watcher");

// Show it again later
$app.showBackgroundForm("alarm/watcher");
  • $app.showBackgroundForm(formPath) — Show a hidden form again
  • $app.closeBackgroundForm(formPath, result) — Close the form and release its memory
  • $app.isBackgroundFormVisible(formPath) — Check whether the form is currently visible