1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
#ifndef __DW_IMAGE_HH__
#define __DW_IMAGE_HH__
#include "core.hh"
namespace dw {
/**
* \brief Represents a list of client-side image maps.
*
* All image maps of a HTML page (in the future, also image maps from
* different HTML pages) are stored in a list, which is passed to the
* image, so that it is possible to deal with maps, which are defined
* after the image within the HTML page.
*
* Maps are referred by instances of object::Object. These keys are
* typically URLs, so the type representing URLS should be derived from
* object::Object.
*
* \todo Some methods within the key class have to be implemented, this
* is not clear at this time.
*/
class ImageMapsList
{
private:
class ImageMap: public lout::object::Object {
private:
class ShapeAndLink: public lout::object::Object {
public:
core::Shape *shape;
int link;
~ShapeAndLink () { if (shape) delete shape; };
};
lout::container::typed::List <ShapeAndLink> *shapesAndLinks;
int defaultLink;
public:
ImageMap ();
~ImageMap ();
void add (core::Shape *shape, int link);
void setDefaultLink (int link) { defaultLink = link; };
int link (int x, int y);
};
lout::container::typed::HashTable <lout::object::Object, ImageMap>
*imageMaps;
ImageMap *currentMap;
public:
ImageMapsList ();
~ImageMapsList ();
void startNewMap (lout::object::Object *key);
void addShapeToCurrentMap (core::Shape *shape, int link);
void setCurrentMapDefaultLink (int link);
int link (lout::object::Object *key, int x, int y);
};
/**
* \brief Displays an instance of dw::core::Imgbuf.
*
* The dw::core::Imgbuf is automatically scaled, when needed, but dw::Image
* does not keep a reference on the root buffer.
*
*
* <h3>Signals</h3>
*
* For image maps, dw::Image uses the signals defined in
* dw::core::Widget::LinkReceiver. For client side image maps, -1 is
* passed for the coordinates, for server side image maps, the respective
* coordinates are used. See section "Image Maps" below.
*
*
* <h3>%Image Maps</h3>
*
* <h4>Client Side %Image Maps</h4>
*
* You must first create a list of image maps (dw::ImageMapList), which can
* be used for multiple images. The caller is responsible for freeing the
* dw::ImageMapList.
*
* Adding a map is done by dw::ImageMapsList::startNewMap. The key is an
* instance of a sub class of object::Object. In the context of HTML, this is
* a URL, which defines this map globally, by combining the URL of the
* document, this map is defined in, with the value of the attribute "name" of
* the \<MAP\> element, as a fragment.
*
* dw::ImageMapsList::addShapeToCurrentMap adds a shape to the current
* map. The \em link argument is a number, which is later passed to
* the dw::core::Widget::LinkReceiver.
*
* This map list is then, together with the key for the image, passed to
* dw::Image::setUseMap. For HTML, a URL with the value of the "ismap"
* attribute of \<IMG\> should be used.
*
* dw::Image will search the correct map, when needed. If it is not found
* at this time, but later defined, it will be found and used later. This is
* the case, when an HTML \<MAP\> is defined below the \<IMG\> in the
* document.
*
* Currently, only maps defined in the same document as the image may be
* used, since the dw::ImageMapsList is stored in the HTML link block, and
* contains only the image maps defined in the document.
*
* <h4>Server Side %Image Maps</h4>
*
* To use images for server side image maps, you must call
* dw::Image::setIsMap, and the dw::Image::style must contain a valid link
* (dw::core::style::Style::x_link). After this, motions and clicks are
* delegated to dw::core::Widget::LinkReceiver.
*
* \sa\ref dw-images-and-backgrounds
*/
class Image: public core::Widget
{
private:
char *altText;
core::Imgbuf *buffer;
int altTextWidth;
bool clicking;
int currLink;
ImageMapsList *mapList;
Object *mapKey;
bool isMap;
protected:
void sizeRequestImpl (core::Requisition *requisition);
void sizeAllocateImpl (core::Allocation *allocation);
void draw (core::View *view, core::Rectangle *area);
bool buttonPressImpl (core::EventButton *event);
bool buttonReleaseImpl (core::EventButton *event);
void enterNotifyImpl (core::EventCrossing *event);
void leaveNotifyImpl (core::EventCrossing *event);
bool motionNotifyImpl (core::EventMotion *event);
//core::Iterator *iterator (Content::Type mask, bool atEnd);
public:
static int CLASS_ID;
Image(const char *altText);
~Image();
core::Iterator *iterator (core::Content::Type mask, bool atEnd);
inline core::Imgbuf *getBuffer () { return buffer; }
void setBuffer (core::Imgbuf *buffer, bool resize = false);
void drawRow (int row);
void setIsMap ();
void setUseMap (ImageMapsList *list, Object *key);
};
} // namespace dw
#endif // __DW_IMAGE_HH__
|
