An os_label is a name for the location of a group of elements within a Web page. This element group name is specified in a constructor and can be modified through the name() member function. The name also can be specified within an os_hyperlink to refer to the elements within os_label .

An initial element for the os_label contents can be specified in a constructor. Elements can be added to the os_label through either the add() member function or operator<< . The os_label name typically does not affect the way in which different browsers render the contents.

Declaration


  #include <ospace/web/label.h>
class os_label : public os_element_group

Interface

Constructor

os_label( const string& name )

Constructs a label with name name .

Constructor

os_label( const string& name , const os_element& element )

Constructs a label with name name , containing a copy of element .

Constructor

os_label( const string& name , const string& text )

Constructs a label with name name , containing an os_text element created from text .

clone

/* virtual */ os_element* clone() const

Returns a base class pointer to a heap-based deep copy of the label.

name

string name() const

Returns the name.

name

os_label& name( const string& name )

Sets the name to name and returns a reference to the label.