# class Window | An abstract user interface window. More...
Contains pure virtuals
Full name | `TelEngine::Window`
Definition | `#include <yatecbase.h>`
Inherits | TelEngine::GenObject [public ]
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

#### Public Methods

- explicit Window (const char* id = 0)
- virtual ~Window ()
- virtual const String& toString () const
- virtual void title (const String& text)
- virtual void context (const String& text)
- virtual bool setParams (const NamedList& params)
- virtual void setOver (const Window* parent)
- virtual bool hasElement (const String& name)
- virtual bool setActive (const String& name, bool active)
- virtual bool setFocus (const String& name, bool select = false)
- virtual bool setShow (const String& name, bool visible)
- virtual bool setText (const String& name, const String& text, bool richText = false)
- virtual bool setCheck (const String& name, bool checked)
- virtual bool setSelect (const String& name, const String& item)
- virtual bool setUrgent (const String& name, bool urgent)
- virtual bool hasOption (const String& name, const String& item)
- virtual bool addOption (const String& name, const String& item, bool atStart = false, const String& text = String::empty())
- virtual bool getOptions (const String& name, NamedList* items)
- virtual bool delOption (const String& name, const String& item)
- virtual bool addLines (const String& name, const NamedList* lines, unsigned int max, bool atStart = false)
- virtual bool addTableRow (const String& name, const String& item, const NamedList* data = 0, bool atStart = false)
- virtual bool setMultipleRows (const String& name, const NamedList& data, const String& prefix = String::empty())
- virtual bool insertTableRow (const String& name, const String& item, const String& before, const NamedList* data = 0)
- virtual bool delTableRow (const String& name, const String& item)
- virtual bool setTableRow (const String& name, const String& item, const NamedList* data)
- virtual bool updateTableRow (const String& name, const String& item, const NamedList* data = 0, bool atStart = false)
- virtual bool updateTableRows (const String& name, const NamedList* data, bool atStart = false)
- virtual bool getTableRow (const String& name, const String& item, NamedList* data = 0)
- virtual bool clearTable (const String& name)
- virtual bool setBusy (const String& name, bool on)
- virtual bool getText (const String& name, String& text, bool richText = false)
- virtual bool getCheck (const String& name, bool& checked)
- virtual bool getSelect (const String& name, String& item)
- virtual bool getSelect (const String& name, NamedList& items)
- virtual bool buildMenu (const NamedList& params)
- virtual bool removeMenu (const NamedList& params)
- virtual bool setImage (const String& name, const String& image, bool fit = false)
- virtual bool setProperty (const String& name, const String& item, const String& value)
- virtual bool getProperty (const String& name, const String& item, String& value)
- inline void populate ()
- inline void init ()
- virtual void show ()
- virtual void hide ()
- virtual void size (int width, int height)
- virtual void move (int x, int y)
- virtual void moveRel (int dx, int dy)
- virtual bool related (const Window* wnd) const
- virtual void menu (int x, int y)
- virtual bool canClose ()
- inline const String& id () const
- inline const String& title () const
- inline const String& context () const
- inline bool visible () const
- inline void visible (bool yes)
- inline bool active () const
- inline bool master () const
- inline bool popup () const
- virtual bool createDialog (const String& name, const String& title, const String& alias = String::empty(), const NamedList* params = 0)
- virtual bool closeDialog (const String& name)

#### Public Static Methods

- static bool isValidParamPrefix (const String& prefix)

#### Protected Methods

- virtual void doPopulate ()
- virtual void doInit ()

#### Protected Members

- String m_id
- String m_title
- String m_context
- bool m_visible
- bool m_active
- bool m_master
- bool m_popup
- bool m_saveOnClose

## Detailed Description

A window is the basic user interface element. Everything inside is implementation specific functionality.

explicit Window (const char* id = 0) | ### Window

Constructor, creates a new windows with an ID

Parameters:

id | String identifier of the new window

~Window () | ### ~Window

[virtual]

Destructor

const String& toString () | ### toString

[const virtual]

Retrieve the standard name of this Window, used to search in lists

Returns: Identifier of this window

Reimplemented from GenObject.

void title (const String& text) | ### title

[virtual]

void context (const String& text) | ### context

[virtual]

Set the contextual information previously associated with this window

Parameters:

text | New contextual information

bool setParams (const NamedList& params) | ### setParams

[virtual]

Set window parameters or widget contents

Parameters:

params | List of parameters to set in the window and its widgets

Returns: True if all parameters could be set

void setOver (const Window* parent) | ### setOver

[pure virtual]

Force this window on top of another one which becomes its parent

Parameters:

parent | Window to force as parent of this one

bool hasElement (const String& name) | ### hasElement

[pure virtual]

Check if this window has an element by name

Parameters:

name | Name of the element to search for

Returns: True if one element with the given name exists

bool setActive (const String& name, bool active) | ### setActive

[pure virtual]

Set an element as interactive in the window

Parameters:

name | Name of the element
active | True to make interactive, false to disallow interaction

Returns: True if the operation was successfull

bool setFocus (const String& name, bool select = false) | ### setFocus

[pure virtual]

Set an element as receiving input in the window

Parameters:

name | Name of the element
select | Also select the content of the focused element

Returns: True if the operation was successfull

bool setShow (const String& name, bool visible) | ### setShow

[pure virtual]

Set the visibility of an element in the window

Parameters:

name | Name of the element
visible | True to make element visible, false to hide it

Returns: True if the operation was successfull

bool setText (const String& name, const String& text, bool richText = false) | ### setText

[pure virtual]

Set the displayed text of an element in the window

Parameters:

name | Name of the element
text | Text value to set in the element
richText | True if the text contains format data

Returns: True if the operation was successfull

bool setCheck (const String& name, bool checked) | ### setCheck

[pure virtual]

Set the checked or toggled status of an element in the window

Parameters:

name | Name of the element
checked | True to make element checked or toggled

Returns: True if the operation was successfull

bool setSelect (const String& name, const String& item) | ### setSelect

[pure virtual]

Set the selection of an item in an element in the window

Parameters:

name | Name of the element
item | Name of the item that should be selected

Returns: True if the operation was successfull

bool setUrgent (const String& name, bool urgent) | ### setUrgent

[pure virtual]

Flag an element as requiring immediate attention

Parameters:

name | Name of the element
urgent | True if the element requires immediate attention

Returns: True if the operation was successfull

bool hasOption (const String& name, const String& item) | ### hasOption

[pure virtual]

Check if an element has an item by its name

Parameters:

name | Name of the element to search for
item | Name of the item that should be searched

Returns: True if one item with the given name exists in the element

bool addOption (const String& name, const String& item, bool atStart = false, const String& text = String::empty()) | ### addOption

[pure virtual]

Add an item to an element that supports such an operation (list)

Parameters:

name | Name of the element
item | Name of the item to add
atStart | True to insert item on the first position, false to append
text | Displayed text to associate with the item (not all lists support it)

Returns: True if the operation was successfull

bool getOptions (const String& name, NamedList* items) | ### getOptions

[pure virtual]

Get an element's items

Parameters:

name | Name of the element to search for
items | List to fill with element's items

Returns: True if the element exists

bool delOption (const String& name, const String& item) | ### delOption

[pure virtual]

Remove an item from an element (list)

Parameters:

name | Name of the element
item | Name of the item to remove

Returns: True if the operation was successfull

bool addLines (const String& name, const NamedList* lines, unsigned int max, bool atStart = false) | ### addLines

[virtual]

Append or insert text lines to a widget

Parameters:

name | The name of the widget
lines | List containing the lines
max | The maximum number of lines allowed to be displayed. Set to 0 to ignore
atStart | True to insert, false to append

Returns: True on success

bool addTableRow (const String& name, const String& item, const NamedList* data = 0, bool atStart = false) | ### addTableRow

[virtual]

Add a row to a table owned by this window

Parameters:

name | Name of the element
item | Name of the item to add
data | Table's columns to set
atStart | True to insert, false to append

Returns: True if the operation was successfull

bool setMultipleRows (const String& name, const NamedList& data, const String& prefix = String::empty()) | ### setMultipleRows

[virtual]

Append or update several table rows at once

Parameters:

name | Name of the element
data | Parameters to initialize the rows with
prefix | Prefix to match (and remove) in parameter names

Returns: True if all the operations were successfull

bool insertTableRow (const String& name, const String& item, const String& before, const NamedList* data = 0) | ### insertTableRow

[virtual]

Insert a row into a table owned by this window

Parameters:

name | Name of the element
item | Name of the item to insert
before | Name of the item to insert before
data | Table's columns to set

Returns: True if the operation was successfull

bool delTableRow (const String& name, const String& item) | ### delTableRow

[virtual]

Delete a row from a table owned by this window

Parameters:

name | Name of the element
item | Name of the item to remove

Returns: True if the operation was successfull

bool setTableRow (const String& name, const String& item, const NamedList* data) | ### setTableRow

[virtual]

Update a row from a table owned by this window

Parameters:

name | Name of the element
item | Name of the item to update
data | Data to update

Returns: True if the operation was successfull

bool updateTableRow (const String& name, const String& item, const NamedList* data = 0, bool atStart = false) | ### updateTableRow

[virtual]

Set a table row or add a new one if not found

Parameters:

name | Name of the element
item | Table item to set/add
data | Optional list of parameters used to set row data
atStart | True to add item at start, false to add them to the end

Returns: True if the operation was successfull

bool updateTableRows (const String& name, const NamedList* data, bool atStart = false) | ### updateTableRows

[virtual]

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:

name | Name of the table
data | The list of items to add/set/delete
atStart | True to add new items at start, false to add them to the end

Returns: True if the operation was successfull

bool getTableRow (const String& name, const String& item, NamedList* data = 0) | ### getTableRow

[virtual]

Retrieve a row from a table owned by this window

Parameters:

name | Name of the element
item | Name of the item to retrieve
data | List to fill with table's columns contents

Returns: True if the operation was successfull

bool clearTable (const String& name) | ### clearTable

[virtual]

Clear (delete all rows) a table owned by this window

Parameters:

name | Name of the element

Returns: True if the operation was successfull

bool setBusy (const String& name, bool on) | ### setBusy

[pure virtual]

Show or hide control busy state

Parameters:

name | Name of the element
on | True to show, false to hide

Returns: True if all the operations were successfull

bool getText (const String& name, String& text, bool richText = false) | ### getText

[pure virtual]

Get an element's text

Parameters:

name | Name of the element
text | The destination string
richText | True to get the element's roch text if supported.

Returns: True if the operation was successfull

bool getCheck (const String& name, bool& checked) | ### getCheck

[pure virtual]

Get the checked state of a checkable control

Parameters:

name | Name of the element
checked | The checked state of the control

Returns: True if the operation was successfull

bool getSelect (const String& name, String& item) | ### getSelect

[pure virtual]

Retrieve an element's selection

Parameters:

name | Name of the element
item | String to fill with selection's contents

Returns: True if the operation was successfull

bool getSelect (const String& name, NamedList& items) | ### getSelect

[pure virtual]

Retrieve an element's multiple selection

Parameters:

name | Name of the element
items | List to be to filled with selection's contents

Returns: True if the operation was successfull

bool buildMenu (const NamedList& params) | ### buildMenu

[pure virtual]

Build a menu from a list of parameters. See Client::buildMenu() for more info

Parameters:

params | Menu build parameters

Returns: True on success

bool removeMenu (const NamedList& params) | ### removeMenu

[pure virtual]

Remove a menu (from UI and memory) See Client::removeMenu() for more info

Parameters:

params | Menu remove parameters

Returns: True on success

bool setImage (const String& name, const String& image, bool fit = false) | ### setImage

[pure virtual]

Set an element's image

Parameters:

name | Name of the element
image | Image to set
fit | Fit image in element (defaults to false)

Returns: True on success

bool setProperty (const String& name, const String& item, const String& value) | ### setProperty

[virtual]

Set a property for this window or for a widget owned by it

Parameters:

name | Name of the element
item | Property's name
value | Property's value

Returns: True on success

bool getProperty (const String& name, const String& item, String& value) | ### getProperty

[virtual]

Get a property from this window or from a widget owned by it

Parameters:

name | Name of the element
item | Property's name
value | Property's value

Returns: True on success

inline void populate () | ### populate

Populate the window if not already done

inline void init () | ### init

Initialize the window if not already done

void show () | ### show

[pure virtual]

Show this window

void hide () | ### hide

[pure virtual]

Hide this window

void size (int width, int height) | ### size

[pure virtual]

Resize this window

Parameters:

width | The new width
height | The new width

void move (int x, int y) | ### move

[pure virtual]

Move this window

Parameters:

x | The x coordinate of the upper left corner
y | The y coordinate of the upper left corner

void moveRel (int dx, int dy) | ### moveRel

[pure virtual]

Move this window related to its current position

Parameters:

dx | The value to be added to the current x coordinate of the upper left corner
dy | The value to be added to the current y coordinate of the upper left corner

bool related (const Window* wnd) | ### related

[const virtual]

Checkes if this window is related to the given window

Parameters:

wnd | The window to check for any relation

Returns: False if wnd is this window or a master one

void menu (int x, int y) | ### menu

[pure virtual]

bool canClose () | ### canClose

[virtual]

Check if this window can be closed

Returns: True if this window can be closed, false to prevent hiding it

inline const String& id () | ### id

[const]

Retrieve the standard name of this Window

Returns: Identifier of this window

inline const String& title () | ### title

[const]

inline const String& context () | ### context

[const]

Get the contextual information previously associated with this window

Returns: String contextual information

inline bool visible () | ### visible

[const]

Get the visibility status of this window

Returns: True if window is visible, false if it's hidden

inline void visible (bool yes) | ### visible

Set the visibility status of this window

Parameters:

yes | True if window should be visible

inline bool active () | ### active

[const]

Check if this window is the active one

Returns: True if window is active

inline bool master () | ### master

[const]

Check if this window is a master (topmost) window

Returns: True if this window is topmost

inline bool popup () | ### popup

[const]

Check if this window is a popup window

Returns: True if this window is initially hidden

bool createDialog (const String& name, const String& title, const String& alias = String::empty(), const NamedList* params = 0) | ### createDialog

[pure virtual]

Create a modal dialog

Parameters:

name | Dialog name (resource config section)
title | Dialog title
alias | Optional dialog alias (used as dialog object name)
params | Optional dialog parameters

Returns: True on success

bool closeDialog (const String& name) | ### closeDialog

[pure virtual]

Destroy a modal dialog

Parameters:

name | Dialog name

Returns: True on success

bool isValidParamPrefix (const String& prefix) | ### isValidParamPrefix

[static]

Check if a string is a parameter prefix handled by setParams(). Exact prefix match is not a valid one

Parameters:

prefix | String to check

Returns: True if the given prefix is a valid one

void doPopulate () | ### doPopulate

[protected pure virtual]

void doInit () | ### doInit

[protected pure virtual]

String m_id | ### m_id

[protected]

String m_title | ### m_title

[protected]

String m_context | ### m_context

[protected]

bool m_visible | ### m_visible

[protected]

bool m_active | ### m_active

[protected]

bool m_master | ### m_master

[protected]

bool m_popup | ### m_popup

[protected]

bool m_saveOnClose | ### m_saveOnClose

[protected]

Generated by: paulc on bussard on Fri May 8 12:37:22 2015, using kdoc 2.0a54.