Brew MP 1.0.2
This function will set the background image to be displayed on a form, identifying the image
as a resource stored in a BREW resource file, and storing a pointer to this image in the form's
FID_BACKGROUND property. The form framework will load the specified image resource and assign
a pointer to this image as the background property on the form. For example, an application
that wishes to display a picture of a ecstatically happy cupie doll looking at a giant ice
cream cone in the background widget of a form could store this picture as an image resource in
a particular resource file. The application could then set the background of a form to be this
rather strange image by calling IForm_SetResBGImage(), identifying the resource file name and
ID of the image to be assigned to the form's FID_BACKGROUND property. The form framework will
comply by loading the image, assigning a pointer to this image as the form's background property,
then notifying all listening objects that the background has changed.
[in] Pointer to the IForm interface object.
[in] Identifies the name of the resource file that contains the resource that contains
the background image.
[in] Identifies the resource that contains the image to be displayed in the form's
int IForm_SetResBGImage(IForm *pif, const char *resFile, uint16 resid);
AEE_SUCCESS : If the form is able to set the background image. Note, however, that this
does NOT mean that BREW was able to successfully retrieve the image from the
resource file. Applications should be certain that 'resfile' is a valid BREW
resource file and that resource 'resid' actually exists.
AEE_EFAILED : If the background could not be set.
Calling IForm_SetResBGImage() will send an EVT_WDG_SETPROPERTY event to the form, requesting
that the FID_BACKGROUND property be set.