The root form will be updated if the inserted form is visible, either at the top of the stack or at a position that is above the topmost visible form -- again, for example, when the new form is inserted behind a popup.
- pif:[in] A pointer to an IRootForm object.
- f:[in] Pointer to the form to be inserted into the form stack.
- pr:[in] Pointer to a position within the form stack where the new form will be inserted. The new form will be inserted immediately before the form pointed to by 'pr'. The insertion location may be passed as a constant that identifies a relative position within the form stack, as follows. FORM_DEFAULT - Allow BREW to place the inserted form at its default location. When inserting a form, this places the new form at the top of the form stack. FORM_LAST - The new form should be inserted at the last form on the form stack -- i.e. this places the form at the top of the form stack as the most recent form. FORM_FIRST - The new form should be inserted at the first form on the form stack -- i.e. this places the form at the bottom of the form stack as the oldest form.
int IRootForm_InsertForm(IRootForm *pif, IForm *f, IForm *pr);
AEE_SUCCESS -- Form was successfully inserted into the form stack. AEE_EBADPARM -- Form pointer passed in 'pr' either does not exist, or refers to a form that is not in the root form's form stack. AEE_ENOMEMORY -- Form stack could not grow to accommodate a new form.