RemovePage

RemovePage

RemovePage(windowID, notebookID), RemovePage(windowID), RemovePage(, notebookID), RemovePage

Parameter:  Bezeichner eines Windows und eines Notebooks

Entfernt die übergebene Notebook-Seite aus dem Notebook.
Die windowID bezieht sich auf das äußerste Fenster, in welchem sich das Notebook befindet, notebookID ist der Bezeichner des Notebooks, aus welchem die Seite entfernt werden soll.

RemovePage ohne notebookID bezieht sich immer auf das erste (und meist einzige)  Notebook im Window

Falls die Notebook-Seite per STRING entfernt wird, dann wird die erste Notebook-Seite des Notebooks mit diesem Namen entfernt. Falls unter dem angegebenen Namen keine Notebook-Seite gefunden wurde, dann tut RemovePage nichts.

Falls die Notebook-Seite per CX_WIDGET entfernt wird, dann muss dieses Widget-Objekt auch eine Notebook-Seite dieses Notebooks sein. Das heißt also, dass das Widget-Objekt entweder von AddPage, GetPage oder CX_WIDGET։։Children (auf dem Notebook) stammen muss. Falls das Widget nicht Teil des Notebooks selbst ist, wird eine Fehlermeldung ausgegeben.

Nachdem die Notebook-Seite entfernt wurde, ist das Widget der Notebook-Seite "geschlossen" - CX_WIDGET։։IsOpen liefert also FALSE.

Code-Beispiel:

Window(EditWin, 100, 200, 50, 10, "EditWin") {
  Notebook(notebook) {
    //       v- "InitialPage" cannot be used for AddPage (not a toplevel window)
    Window(InitialPage, 0, 0, 0, 0, "Initial") 
    {}
  }
}

// Only used as notebook page, so position and size can be ignored
Window(OverviewPage, 0, 0, 0, 0, "Overview")
{
  //...
}




Var(page)
// Add window "OverviewPage" as new page into the notebook from EditWin
"OverviewPage" AddPage(EditWin, notebook) -> page

// Set the page as active page (if not already)
GetPage(EditWin, notebook) page @ ifnot {
  page SetPage(EditWin, notebook)
}

// Remove the newly added page
page RemovePage(EditWin, notebook)

// The page is now marked as closed window
page Call(IsOpen) // -> FALSE

Verwandte Themen

• AddPage
• GetPage
• SetPage