Developer

API Reference

IWidget_SetTextWidgetText()

Brew Release
Brew MP 1.0.2
See Also
- ITextModel
- IWidget
- AECHAR
- IWidget_GetTextWidgetText()
Description
Replaces all the text currently displayed in the text widget with the text passed in 'txt', regardless of the current selection range.
Parameters
  • pif
    []:
    [in] Pointer to the IWidget object.
  • txt
    []:
    [in] Pointer to the text that is to be placed into the text widget, or NULL if the text that currently appears in the text widget should be cleared.
Interface
Prototype
   int IWidget_SetTextWidgetText(IWidget *pif, AECHAR *txt);
Return
   AEE_SUCCESS - If the text widget is able to successfully set the text
   AEE_EFAILED - If the text could not be set.
Side Effect
Setting the text in a text widget by calling IWidget_SetTextWidgetText() will cause BREW to send an EVT_MDL_TEXT_CHANGE ModelEvent to any object that has registered as a listener with the widget's text model -- including the text widget itself, which of course triggers the text widget to be redrawn with the new text.
Comment
None
  • Follow