This method is currently deprecated due to the use of memory management functions not compatible with mod1 modules. In the future, a mod1 compatible (IEnv based) function will be provided as IWidget_SetText.
- piWidget:Pointer to the IWidget object.
- pwszTxt:Pointer to the text that is to be displayed in the widget. This pointer will be stored in the value model.
- bFree:Indicates whether or not the widget's value model is responsible for freeing the text. When 'bFree' is TRUE, the value model will free the text memory when the model is destroyed, or when it is replaced with new text. When FALSE, the caller is responsible for managing the text memory. For widgets that contain a model other than a value model, when 'bFree' is TRUE, this routine frees the memory passed in pwszTxt.
int IWIDGET_SetText(IWidget* piWidget, const AECHAR* pwszTxt, boolean bFree);
AEE_SUCCESS - If the static widget is able to successfully set the text. AEE_EFAILED - If the text could not be set.