A top-level page is a clipboard page that is usually created through the Page-New method. Applications create many top-level pages during the course of operations, and activities can create top-level pages. Most top-level pages are named, and have an associated class.
An embedded page is a clipboard page that has the value of a property of mode Page. Any page on the clipboard that is not a top-level page is an embedded page.
A recursive page structure is used. Pages contain properties that can have single or multiple pages as their values. For example, the Obj-Browse method creates an array of embedded pages (all of the same class) that contain its results.
To emphasize that a custom class in your application is intended to be used only for embedded pages, create a class derived from the Embed- base class and use pattern inheritance. An example is the standard Embed-Access-Privilege class.
However, an embedded page may have a class derived from any class, including Data-, Assign-, Work-, Data-Party-Person, and so on. The class is recorded in the property.
Typically, the name of an embedded page is a property name. Accordingly, you cannot rename an embedded page.