Yate
Public Member Functions | List of all members
UIWidget Class Reference
Inheritance diagram for UIWidget:
String GenObject

Public Member Functions

 UIWidget (const char *name=0)
 
virtual ~UIWidget ()
 
const Stringname () const
 
virtual bool setParams (const NamedList &params)
 
virtual bool getOptions (NamedList &items)
 
virtual bool addTableRow (const String &item, const NamedList *data=0, bool atStart=false)
 
virtual bool setMultipleRows (const NamedList &data, const String &prefix=String::empty())
 
virtual bool updateTableRows (const NamedList *data, bool atStart=false)
 
virtual bool insertTableRow (const String &item, const String &before, const NamedList *data=0)
 
virtual bool delTableRow (const String &item)
 
virtual bool setTableRow (const String &item, const NamedList *data)
 
virtual bool getTableRow (const String &item, NamedList *data=0)
 
virtual bool clearTable ()
 
virtual bool setSelect (const String &item)
 
virtual bool getSelect (String &item)
 
virtual bool getSelect (NamedList &items)
 
virtual bool addLines (const NamedList &lines, unsigned int max, bool atStart=false)
 
virtual bool setText (const String &text, bool richText=false)
 
virtual bool getText (String &text, bool richText=false)
 
virtual bool setBusy (bool on)
 
- Public Member Functions inherited from String
 String ()
 
 String (const char *value, int len=-1)
 
 String (char value, unsigned int repeat=1)
 
 String (int32_t value)
 
 String (uint32_t value)
 
 String (int64_t value)
 
 String (uint64_t value)
 
 String (bool value)
 
 String (double value)
 
 String (const String &value)
 
 String (const String *value)
 
virtual ~String ()
 
virtual void * getObject (const String &name) const
 
const char * c_str () const
 
const char * safe () const
 
const char * safe (const char *defStr) const
 
unsigned int length () const
 
bool null () const
 
int lenUtf8 (uint32_t maxChar=0x10ffff, bool overlong=false) const
 
int fixUtf8 (const char *replace=0, uint32_t maxChar=0x10ffff, bool overlong=false)
 
bool checkBOM () const
 
bool stripBOM ()
 
unsigned int hash () const
 
void clear ()
 
char at (int index) const
 
String substr (int offs, int len=-1) const
 
StringtrimBlanks ()
 
StringtrimSpaces ()
 
virtual const StringtoString () const
 
int toInteger (int defvalue=0, int base=0, int minvalue=INT_MIN, int maxvalue=INT_MAX, bool clamp=true) const
 
int toInteger (const TokenDict *tokens, int defvalue=0, int base=0) const
 
long int toLong (long int defvalue=0, int base=0, long int minvalue=LONG_MIN, long int maxvalue=LONG_MAX, bool clamp=true) const
 
int64_t toInt64 (int64_t defvalue=0, int base=0, int64_t minvalue=LLONG_MIN, int64_t maxvalue=LLONG_MAX, bool clamp=true) const
 
double toDouble (double defvalue=0.0) const
 
bool toBoolean (bool defvalue=false) const
 
bool isBoolean () const
 
StringtoUpper ()
 
StringtoLower ()
 
char operator[] (signed int index) const
 
char operator[] (unsigned int index) const
 
 operator const char * () const
 
Stringassign (const char *value, int len=-1)
 
Stringassign (char value, unsigned int repeat=1)
 
Stringhexify (void *data, unsigned int len, char sep=0, bool upCase=false)
 
Stringoperator= (const String &value)
 
Stringoperator= (const String *value)
 
Stringoperator= (const char *value)
 
Stringoperator= (char value)
 
Stringoperator= (int32_t value)
 
Stringoperator= (uint32_t value)
 
Stringoperator= (int64_t value)
 
Stringoperator= (uint64_t value)
 
Stringoperator= (bool value)
 
Stringoperator= (double value)
 
Stringoperator+= (const char *value)
 
Stringoperator+= (char value)
 
Stringoperator+= (int32_t value)
 
Stringoperator+= (uint32_t value)
 
Stringoperator+= (int64_t value)
 
Stringoperator+= (uint64_t value)
 
Stringoperator+= (bool value)
 
Stringoperator+= (double value)
 
bool operator== (const char *value) const
 
bool operator!= (const char *value) const
 
bool operator== (const String &value) const
 
bool operator!= (const String &value) const
 
bool operator&= (const char *value) const
 
bool operator|= (const char *value) const
 
Stringoperator<< (const char *value)
 
Stringoperator<< (char value)
 
Stringoperator<< (int32_t value)
 
Stringoperator<< (uint32_t value)
 
Stringoperator<< (int64_t value)
 
Stringoperator<< (uint64_t value)
 
Stringoperator<< (bool value)
 
Stringoperator<< (double value)
 
Stringoperator>> (const char *skip)
 
Stringoperator>> (char &store)
 
Stringoperator>> (UChar &store)
 
Stringoperator>> (int &store)
 
Stringoperator>> (unsigned int &store)
 
Stringoperator>> (bool &store)
 
Stringappend (const char *value, int len)
 
Stringappend (const char *value, const char *separator=0, bool force=false)
 
Stringappend (const ObjList *list, const char *separator=0, bool force=false)
 
Stringappend (const ObjList &list, const char *separator=0, bool force=false)
 
Stringappend (double value, unsigned int decimals=3)
 
Stringprintf (const char *format,...)
 
Stringprintf (unsigned int length, const char *format,...)
 
StringappendFixed (unsigned int fixedLength, const char *str, unsigned int len=-1, char fill= ' ', int align=Left)
 
StringappendFixed (unsigned int fixedLength, const String &str, char fill= ' ', int align=Left)
 
int find (char what, unsigned int offs=0) const
 
int find (const char *what, unsigned int offs=0) const
 
int rfind (char what) const
 
int rfind (const char *what) const
 
bool startsWith (const char *what, bool wordBreak=false, bool caseInsensitive=false) const
 
bool endsWith (const char *what, bool wordBreak=false, bool caseInsensitive=false) const
 
bool startSkip (const char *what, bool wordBreak=true, bool caseInsensitive=false)
 
StringextractTo (const char *sep, String &store)
 
StringextractTo (const char *sep, bool &store)
 
StringextractTo (const char *sep, int &store, int base=0)
 
StringextractTo (const char *sep, int &store, const TokenDict *tokens, int base=0)
 
StringextractTo (const char *sep, double &store)
 
virtual bool matches (const String &value) const
 
bool matches (const Regexp &rexp)
 
int matchOffset (int index=0) const
 
int matchLength (int index=0) const
 
String matchString (int index=0) const
 
String replaceMatches (const String &templ) const
 
int matchCount () const
 
ObjListsplit (char separator, bool emptyOK=true) const
 
String msgEscape (char extraEsc=0) const
 
String msgUnescape (int *errptr=0, char extraEsc=0) const
 
String sqlEscape (char extraEsc=0) const
 
String uriEscape (char extraEsc=0, const char *noEsc=0) const
 
String uriUnescape (int *errptr=0) const
 
- Public Member Functions inherited from GenObject
 GenObject ()
 
virtual ~GenObject ()
 
virtual bool alive () const
 
virtual void destruct ()
 
NamedCountergetObjCounter () const
 
NamedCountersetObjCounter (NamedCounter *counter)
 

Additional Inherited Members

- Public Types inherited from String
enum  Align { Left = 0, Center, Right }
 
- Static Public Member Functions inherited from String
static const Stringempty ()
 
static const char * boolText (bool value)
 
static int lenUtf8 (const char *value, uint32_t maxChar=0x10ffff, bool overlong=false)
 
static bool checkBOM (const char *str)
 
static bool stripBOM (const char *&str)
 
static bool stripBOM (char *&str)
 
static unsigned int hash (const char *value, unsigned int h=0)
 
static String msgEscape (const char *str, char extraEsc=0)
 
static String msgUnescape (const char *str, int *errptr=0, char extraEsc=0)
 
static String sqlEscape (const char *str, char extraEsc=0)
 
static String uriEscape (const char *str, char extraEsc=0, const char *noEsc=0)
 
static String uriEscape (const char *str, const char *extraEsc, const char *noEsc=0)
 
static String uriUnescape (const char *str, int *errptr=0)
 
static const Stringatom (const String *&str, const char *val)
 
- Static Public Member Functions inherited from GenObject
static void * getObject (const String &name, const GenObject *obj)
 
static bool getObjCounting ()
 
static void setObjCounting (bool enable)
 
static NamedCountergetObjCounter (const String &name, bool create=true)
 
static ObjListgetObjCounters ()
 
- Protected Member Functions inherited from String
virtual void changed ()
 

Constructor & Destructor Documentation

UIWidget ( const char *  name = 0)
inlineexplicit

Constructor, creates a new widget

Parameters
nameThe widget's name
virtual ~UIWidget ( )
inlinevirtual

Destructor

Member Function Documentation

virtual bool addLines ( const NamedList lines,
unsigned int  max,
bool  atStart = false 
)
inlinevirtual

Append or insert text lines to this widget

Parameters
linesList containing the lines
maxThe maximum number of lines allowed to be displayed. Set to 0 to ignore
atStartTrue to insert, false to append
Returns
True on success
virtual bool addTableRow ( const String item,
const NamedList data = 0,
bool  atStart = false 
)
inlinevirtual

Add a row to a table

Parameters
itemName of the item to add
dataTable's columns to set
atStartTrue to insert, false to append
Returns
True if the operation was successfull
virtual bool clearTable ( )
inlinevirtual

Clear (delete all rows) a table

Returns
True if the operation was successfull
virtual bool delTableRow ( const String item)
inlinevirtual

Delete a row from a table

Parameters
itemName of the item to remove
Returns
True if the operation was successfull
virtual bool getOptions ( NamedList items)
inlinevirtual

Get widget's items

Parameters
itemsList to fill with widget's items
Returns
False on failure (e.g. not initialized)
virtual bool getSelect ( String item)
inlinevirtual

Retrieve the widget's selection

Parameters
itemString to fill with selection's contents
Returns
True if the operation was successfull
virtual bool getSelect ( NamedList items)
inlinevirtual

Retrieve widget's multiple selection

Parameters
itemsList to be to filled with selection's contents
Returns
True if the operation was successfull
virtual bool getTableRow ( const String item,
NamedList data = 0 
)
inlinevirtual

Retrieve a row from a table

Parameters
itemName of the item to retrieve
dataList to fill with table's columns contents
Returns
True if the operation was successfull
virtual bool getText ( String text,
bool  richText = false 
)
inlinevirtual

Retrieve the displayed text of this widget

Parameters
textText value
richTextTrue to retrieve formatted data
Returns
True on success
virtual bool insertTableRow ( const String item,
const String before,
const NamedList data = 0 
)
inlinevirtual

Insert a row into a table

Parameters
itemName of the item to insert
beforeName of the item to insert before
dataTable's columns to set
Returns
True if the operation was successfull
const String& name ( ) const
inline

Retrieve the standard name of this Window

Returns
Identifier of this window

References String::toString().

virtual bool setBusy ( bool  on)
inlinevirtual

Show or hide control busy state

Parameters
onTrue to show, false to hide
Returns
True if all the operations were successfull
virtual bool setMultipleRows ( const NamedList data,
const String prefix = String::empty() 
)
inlinevirtual

Append or update several table rows at once

Parameters
dataParameters to initialize the rows with
prefixPrefix to match (and remove) in parameter names
Returns
True if all the operations were successfull
virtual bool setParams ( const NamedList params)
inlinevirtual

Set widget's parameters

Parameters
paramsList of parameters
Returns
True if all parameters could be set
virtual bool setSelect ( const String item)
inlinevirtual

Set the widget's selection

Parameters
itemString containing the new selection
Returns
True if the operation was successfull
virtual bool setTableRow ( const String item,
const NamedList data 
)
inlinevirtual

Update a table's row

Parameters
itemName of the item to update
dataData to update
Returns
True if the operation was successfull
virtual bool setText ( const String text,
bool  richText = false 
)
inlinevirtual

Set the displayed text of this widget

Parameters
textText value to set
richTextTrue if the text contains format data
Returns
True on success
virtual bool updateTableRows ( const NamedList data,
bool  atStart = false 
)
inlinevirtual

Add or set one or more table row(s). Screen update is locked while changing the table. Each data list element is a NamedPointer carrying a NamedList with item parameters. The name of an element is the item to update. Set element's value to boolean value 'true' to add a new item if not found or 'false' to set an existing one. Set it to empty string to delete the item

Parameters
dataThe list of items to add/set/delete
atStartTrue to add new items at start, false to add them to the end
Returns
True if the operation was successfull

The documentation for this class was generated from the following file: