An os_image_map is a client-side image map, or a collection of os_area objects, each of which defines a region-to-URL mapping. An os_area is inserted into an os_image_map through either the add() member function or operator<< .

When an image map is associated with an os_image through the os_image::usemap() member function, each region in the image behaves as a hyperlink. An image map is described by a name, specified in the constructor, that can be modified through the name() member function. Each os_image_map within a page must be given a unique name.

Declaration


  #include <ospace/web/imagemap.h>
class os_image_map : public os_element_group

Interface

Constructor

os_image_map( const string& name )

Constructs an empty image map with name name .

clone

/* virtual */ os_element* clone() const

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

name

string name() const

Returns the name of the image map.

name

os_image_map& name( const string& name )

Sets the name of the image map to name and returns a reference to the image map.

print

/* virtual */ void print( ostream& os ) const

Prints the image map to os .