Skip to main content

showBackgroundForm

Description

Shows a background Form again after hideBackgroundForm() hid it.

Parameters

ParameterTypeDescription
formPathStringPath of the Form to show

Returns

void

Notes

  • Works only on Forms loaded with openBackgroundForm(). It has no effect on a Form that isn't loaded.
  • Calling it on a Form that is already visible raises no error — the state stays as it is.
  • Calling openBackgroundForm() again with the same path runs this function internally.

Example

// Open the Form
$app.openBackgroundForm("alarm/watcher", null, null);

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

// Show it again
$app.showBackgroundForm("alarm/watcher");
  • $app.hideBackgroundForm(formPath) — hide the Form UI
  • $app.isBackgroundFormVisible(formPath) — check whether the Form is currently visible
  • $app.closeBackgroundForm(formPath, result) — close the Form and free its memory