This function sets the theme basename for the form, identifying the base name within the current theme file from which a form will apply theme data.
A single theme file may contain many sets of theme data, each set rooted at a basename. The standard forms will look for theme entries under sub-names of the basename to locate properties and other resources required to apply the theme.
By changing the theme basename, a form is indicating where in the theme file the form framework should root its searches for theme data to be applied to this specific form.
Changing the theme basename will trigger a FORMITEM_THEME_BASENAME form event to be sent to listening objects to notify them that the theme basename has changed.
The RootForm is amongst those objects listening and will update at least the title, background and softkey properties based on the new theme basename.
int IForm_SetThemeBaseName(IForm *pif, char *name);
- AEE_SUCCESS : If the form is able to successfully set the theme basename to be applied by the form. AEE_EFAILED : If the theme basename could not be set.
- Calling IForm_SetThemeBaseName() will send an EVT_WDG_SETPROPERTY event to the form, requesting
that the FID_THEME_BASENAME property be set.
Successfully applying the form theme basename will cause a FORMITEM_THEME_BASENAME form event to be sent to any listening objects.