Developer

API Reference

IWidget_GetPropInt()

Brew Release
Brew MP 1.0.2
See Also
Error Codes IWidget IWidget_GetProperty Widget Events
Description
This function is used to retrieve widget properties that are stored as integer values, copying the value into the 'pnVal' pointer passed to the function as a parameter. The function will return AEE_SUCCESS or AEE_EFAILED depending on whether or not the widget was able to retrieve the requested property.
Parameters
  • pif
    []:
    [in] Pointer to the IWidget interface object.
  • wProp
    []:
    [in] Identifies the property to be retrieved.
  • pnVal
    []:
    [out] A pointer to an int into which the widget will copy the value of the requested property.
Interface
Prototype
   int IWidget_GetPropInt(IWidget *pif, uint16 wProp, int *pnVal); 
Return
AEE_SUCCESS - If the widget is able to retrieve the requested property. AEE_EFAILED - If the property could not be retrieved.
The value of the requested integer property is returned in 'pnVal'.
Side Effect
None
Comment
Widgets may possess any number of properties, as defined in AEEWidgetProperties.h, and include attributes such as color, border width, shadowing, etc. Examples of widget properties stored as an int include PROP_ACTIVE_BORDERWIDTH, PROP_BORDERSTYLE and many others.
  • Follow