This method is deprecated due the use of the currently mod1 incompatible IWIDGET_SetText. For more information, please see that method. Although no replacement is currently provided, in future releases a mod1 compatible function under the name IWidget_SetTitle will be available.
- piw:Pointer to the IWidget object.
- pwText: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 value model of the title widget should free the memory of the text that is being set. When TRUE, the value model will free the memory pointed to by 'pwText' when the model is released. When FALSE, the model will leave memory management to the calling application.
int IWidget_SetTitle(IWidget *piw, const AECHAR *pwText, boolean bFree);
AEE_SUCCESS - If the title widget is able to successfully set the text. AEE_EFAILED - If the text could not be set.