Developer

API Reference

IRootForm_ApplyWProps()

Brew Release
Brew MP 1.0.2
See Also
IRootForm_GetThemeFile() IResFile
Description
This utility function applies a named set of widget properties to a specified widget using the current theme file. Usually the properties for a widget specific to a form is prefixed by the basename of the form.
An example of applying properties to a widget.
   const char *pBaseName;
   if (AEE_SUCCESS == IForm_GetThemeBaseName(me->piForm, &pBaseName)) {
      IRootForm_ApplyWProps(me->piRoot, me->piTitle, pBaseName, "Title", "Properties");
   }
Parameters
  • pif
    []:
    [in] Pointer to the IRootForm interface object.
  • piw
    []:
    [in] Pointer to the widget to apply properties to
Interface
Prototype
   int IRootForm_ApplyWProps(IRootForm *pif, IWidget *piw, ...); 
Return
   AEE_SUCCESS: Properties found and applied to widget
   AEE_EFAILED: Invalid params or properties not found
Side Effect
None
Comment
This function is a wrapper around IRootForm_ApplyWPropsV which takes varargs. This function in turn sets the FID_WPROPS form property.
Several forms have default theme properties that will be applied if they exist in the current theme file and appropriate widgets are assigned to the form. Each of these entries will be appended to the current theme base name.
Dialogs (AEEDialog.h).
      "Dialog.Background.Image" (Background image widget)
      "Dialog.Background.Properties" (Background widget properties)
      "Dialog.Properties" (Main widget properties)
      "Dialog.Title.Properties" (Title widget properties)
      "Dialog.Content.Properties" (Static dialog content properties)
      "Dialog.ProgressBar.Properties" (Progress dialog progress bar properties)

Lists (AEEListForm.bid).
      "List.Scrollbar.Properties" (Scrollbar widget properties)
      "List.Properties" (List widget properties)
      "List.Item.Properties" (List item widget properties)

Popups (AEEIPopupMenu.h).
      "Backdrop.Properties" (Backdrop widget properties)
      "List.Scrollbar.Properties" (Scrollbar widget properties)
      "List.Properties" (List widget properties)
      "List.Item.Properties" (List item widget properties)

Default Forms (AEEIForm.h, AEEIRootForm.h).
      "Background.Image" (Default form image widget)
      "Properties" (Default form properties)
      "Title.Properties" (Title widget properties)
      "Softkeys.Properties" (Softkey widget properties)
      "Background.Properties" (Background widget properties)

  • Follow