cb64849031f8dc13ecde8ddb3deb9f6b54fdd3a2
[org.ibex.core.git] / src / org / xwt / SpecialBoxProperty.java
1 // Copyright 2002 Adam Megacz, see the COPYING file for licensing [GPL]
2 package org.xwt;
3
4 import org.mozilla.javascript.*;
5 import org.xwt.util.*;
6 import java.util.*;
7 import java.net.*;
8 import java.text.*;
9
10 /** 
11  *  A helper class for properties of Box which require special
12  *  handling.
13  *
14  *  To avoid excessive use of String.equals(), the Box.get() and
15  *  Box.put() methods employ a Hash keyed on property names that
16  *  require special handling. The value stored in the Hash is an
17  *  instance of an anonymous subclass of SpecialBoxProperty, which knows
18  *  how to handle get()s and put()s for that property name. There
19  *  should be one anonymous subclass of SpecialBoxProperty for each
20  *  specially-handled property on Box.
21  */
22 class SpecialBoxProperty {
23
24     SpecialBoxProperty() { }
25     private static final int NUMINTS = Box.NUMINTS;
26     private static final int dmax = Box.dmax;
27     private static final int dmin = Box.dmin;
28     private static final int cmin = Box.cmin;
29     private static final int abs = Box.abs;
30     private static final int pos = Box.pos;
31     private static final int size = Box.size;
32     private static final int oldpos = Box.oldpos;
33     private static final int oldsize = Box.oldsize;
34     private static final int pad = Box.pad;
35
36     /** stores instances of SpecialBoxProperty; keyed on property name */
37     static Hash specialBoxProperties = new Hash(200, 3);
38
39     /** this method defines the behavior when the property is get()ed from b */
40     Object get(Box b) { return null; }
41
42     /** this method defines the behavior when the property is put() to b */
43     void put(Box b, Object value) { }
44
45     /** this method defines the behavior when the property is put() to b, allows a single SpecialBoxProperty to serve multiple properties */
46     void put(String name, Box b, Object value) { put(b, value); }
47
48     // 'ye olde IBM CGA colours', as defined in the XWT reference
49     static final int black = 0xFF000000;
50     static final int blue = 0xFF000088;
51     static final int green = 0xFF008800;
52     static final int cyan = 0xFF008888;
53     static final int red = 0xFF880000;
54     static final int magenta = 0xFF880088;
55     static final int brown = 0xFF888800;
56     static final int lightGray = 0xFFBDBEBD;
57     static final int darkGray = 0xFF242424;
58     static final int brightBlue = 0xFF0000FF;
59     static final int brightGreen = 0xFF00FF00;
60     static final int brightCyan = 0xFF00FFFF;
61     static final int brightRed = 0xFFFF0000;
62     static final int pink = 0xFFFF00FF;
63     static final int yellow = 0xFFFFFF00;
64     static final int white = 0xFFFFFFFF;
65
66     static {
67
68         specialBoxProperties.put("color", new SpecialBoxProperty() {
69                 public Object get(Box b) {
70                     if ((b.color & 0xFF000000) == 0) return null;
71                     String red = Integer.toHexString((b.color & 0x00FF0000) >> 16);
72                     String green = Integer.toHexString((b.color & 0x0000FF00) >> 8);
73                     String blue = Integer.toHexString(b.color & 0x000000FF);
74                     if (red.length() < 2) red = "0" + red;
75                     if (blue.length() < 2) blue = "0" + blue;
76                     if (green.length() < 2) green = "0" + green;
77                     return "#" + red + green + blue;
78                 }
79                 public void put(Box b, Object value) {
80                     int newcolor = b.color;
81                     String s = value == null ? null : value.toString();
82                     if (value == null) newcolor = 0x00000000;
83                     else if (s.length() > 0 && s.charAt(0) == '#')
84                         newcolor = 0xFF000000 |
85                             (Integer.parseInt(s.substring(1, 3), 16) << 16) |
86                             (Integer.parseInt(s.substring(3, 5), 16) << 8) |
87                             Integer.parseInt(s.substring(5, 7), 16);
88                     else if (s.equals("black")) newcolor = black;
89                     else if (s.equals("blue")) newcolor = blue;
90                     else if (s.equals("green")) newcolor = green;
91                     else if (s.equals("cyan")) newcolor = cyan;
92                     else if (s.equals("red")) newcolor = red;
93                     else if (s.equals("magenta")) newcolor = magenta;
94                     else if (s.equals("brown")) newcolor = brown;
95                     else if (s.equals("lightGray")) newcolor = lightGray;
96                     else if (s.equals("darkGray")) newcolor = darkGray;
97                     else if (s.equals("brightBlue")) newcolor = brightBlue;
98                     else if (s.equals("brightGreen")) newcolor = brightGreen;
99                     else if (s.equals("brightCyan")) newcolor = brightCyan;
100                     else if (s.equals("brightRed")) newcolor = brightRed;
101                     else if (s.equals("pink")) newcolor = pink;
102                     else if (s.equals("yellow")) newcolor = yellow;
103                     else if (s.equals("white")) newcolor = white;
104                     else if (Log.on) Log.log(this, "invalid color " + s);
105
106                     if (newcolor == b.color) return;
107                     b.color = newcolor;
108                     b.dirty();
109                 } });
110         
111         
112         specialBoxProperties.put("textcolor", new SpecialBoxProperty() {
113                 public Object get(Box b) {
114                     if ((b.textcolor & 0xFF000000) == 0) return null;
115                     String red = Integer.toHexString((b.textcolor & 0x00FF0000) >> 16);
116                     String green = Integer.toHexString((b.textcolor & 0x0000FF00) >> 8);
117                     String blue = Integer.toHexString(b.textcolor & 0x000000FF);
118                     if (red.length() < 2) red = "0" + red;
119                     if (blue.length() < 2) blue = "0" + blue;
120                     if (green.length() < 2) green = "0" + green;
121                     return "#" + red + green + blue;
122                 }
123                 public void put(Box b, Object value) {
124                     int newtextcolor = b.color;
125                     if (value == null) return;
126                     String s = value.toString();
127                     if (s.length() > 0 && s.charAt(0) == '#')
128                         newtextcolor = 0xFF000000 |
129                             (Integer.parseInt(s.substring(1, 3), 16) << 16) |
130                             (Integer.parseInt(s.substring(3, 5), 16) << 8) |
131                             Integer.parseInt(s.substring(5, 7), 16);
132                     else if (s.equals("black")) newtextcolor = black;
133                     else if (s.equals("blue")) newtextcolor = blue;
134                     else if (s.equals("green")) newtextcolor = green;
135                     else if (s.equals("cyan")) newtextcolor = cyan;
136                     else if (s.equals("red")) newtextcolor = red;
137                     else if (s.equals("magenta")) newtextcolor = magenta;
138                     else if (s.equals("brown")) newtextcolor = brown;
139                     else if (s.equals("lightGray")) newtextcolor = lightGray;
140                     else if (s.equals("darkGray")) newtextcolor = darkGray;
141                     else if (s.equals("brightBlue")) newtextcolor = brightBlue;
142                     else if (s.equals("brightGreen")) newtextcolor = brightGreen;
143                     else if (s.equals("brightCyan")) newtextcolor = brightCyan;
144                     else if (s.equals("brightRed")) newtextcolor = brightRed;
145                     else if (s.equals("pink")) newtextcolor = pink;
146                     else if (s.equals("yellow")) newtextcolor = yellow;
147                     else if (s.equals("white")) newtextcolor = white;
148                     else if (Log.on) Log.log(this, "invalid textcolor " + s);
149
150                     if (newtextcolor == b.textcolor) return;
151                     b.textcolor = newtextcolor;
152                     b.dirty();
153                 } });
154         
155         specialBoxProperties.put("text", new SpecialBoxProperty() {
156                 public Object get(Box b) { return b.text; }
157                 public void put(Box b, Object value) {
158                     String t = value == null ? "null" : value.toString();
159                     if (t.equals(b.text)) return;
160
161                     for(int i=0; i<t.length(); i++)
162                         if (Character.isISOControl(t.charAt(i))) {
163                             if (Log.on) Log.log(this, 
164                                                 "ISO Control characters are not permitted in box text strings; offending character is ASCII " +
165                                                ((int)t.charAt(i)));
166                             /* FIXME: reinstate
167                             return;
168                             */
169                         }
170
171                     // FIXME: don't know why this is needed
172                     b.dirty();
173
174                     b.text = t;
175                     b.textupdate();
176                     b.dirty();
177                 } });
178         
179         specialBoxProperties.put("thisbox", new SpecialBoxProperty() {
180                 public Object get(Box b) { return b; }
181                 public void put(Box b, Object value) {
182                     if (value == null) b.remove();
183                     else if (value.equals("window") || value.equals("frame")) {
184                         if (b.redirect != b && Log.on)
185                             Log.log(this, "WARNING: you have created a surface whose root box's redirect is not itself " +
186                                     "-- this isn't usually a good idea");
187                         Platform.createSurface(b, value.equals("frame"), true);
188                     } else if (Log.on) Log.log(this, "put invalid value to 'thisbox' property: " + value);
189                 }
190             });
191
192         specialBoxProperties.put("orient", new SpecialBoxProperty() {
193                 public Object get(Box b) {
194                     if (b.redirect == null) return "horizontal";
195                     else if (b.redirect != b) return get(b.redirect);
196                     else if (b.o == 1) return "vertical";
197                     else return "horizontal";
198                 }
199                 public void put(Box b, Object value) {
200                     if (value == null) return;
201                     if (b.redirect == null) return;
202                     if (b.redirect != b) {
203                         put(b.redirect, value);
204                         return;
205                     }
206                     if (value.equals("vertical")) {
207                         if (b.o == 1) return;
208                         b.o = 1;
209                         b.xo = 0;
210                     } else if (value.equals("horizontal")) {
211                         if (b.o == 0) return;
212                         b.o = 0;
213                         b.xo = 1;
214                     } else if (Log.on)
215                         Log.log(this, "invalid value put to orient property: " + value);
216                     b.mark_for_prerender();
217                     b.sync_cmin_to_children();
218                 } });
219
220         specialBoxProperties.put("static", new SpecialBoxProperty() {
221                 public Object get(Box b) {
222                     String cfsn = JSObject.getCurrentFunctionSourceName();
223                     for(int i=0; i<cfsn.length() - 1; i++)
224                         if (cfsn.charAt(i) == '.' && (cfsn.charAt(i+1) == '_' || Character.isDigit(cfsn.charAt(i+1)))) {
225                             cfsn = cfsn.substring(0, i);
226                             break;
227                         }
228                     return Static.getStatic(cfsn);
229                 }
230                 public void put(Box b, Object value) { }
231             });
232
233         specialBoxProperties.put("sizetoimage", new SpecialBoxProperty() {
234                 public Object get(Box b) { return b.sizetoimage ? Boolean.TRUE : Boolean.FALSE; }
235                 public void put(Box b, Object value) {
236                     if (stob(value)) {
237                         if (b.sizetoimage) return;
238                         b.sizetoimage = true;
239                         b.syncSizeToImage();
240                     } else {
241                         b.sizetoimage = false;
242                     }
243                 } });
244         
245         specialBoxProperties.put("fixedaspect", new SpecialBoxProperty() {
246                 public Object get(Box b) { return b.sizetoimage ? Boolean.TRUE : Boolean.FALSE; }
247                 public void put(Box b, Object value) {
248                     boolean newval = stob(value);
249                     if (newval == b.fixedaspect) return;
250                     b.fixedaspect = newval;
251                     b.dirty();
252                 } });
253         
254         specialBoxProperties.put("shrink", new SpecialBoxProperty() {
255                 public Object get(Box b) { return (b.vshrink && b.hshrink) ? Boolean.TRUE : Boolean.FALSE; }
256                 public void put(Box b, Object value) {
257                     boolean newshrink = stob(value);
258                     if (b.hshrink == newshrink && b.vshrink == newshrink) return;
259                     b.hshrink = b.vshrink = newshrink;
260                     if (b.hshrink) b.set(b.dmax, 0, Box.max(b.cmin(0), b.textdim(0) + 2 * b.pad(0), b.dmin(0)));
261                     if (b.vshrink) b.set(b.dmax, 1, Box.max(b.cmin(1), b.textdim(1) + 2 * b.pad(1), b.dmin(1)));
262                 } });
263         
264         specialBoxProperties.put("hshrink", new SpecialBoxProperty() {
265                 public Object get(Box b) { return new Boolean(b.hshrink); }
266                 public void put(Box b, Object value) {
267                     boolean newshrink = stob(value);
268                     if (b.hshrink == newshrink) return;
269                     b.hshrink = newshrink;
270                     if (b.hshrink) b.set(b.dmax, 0, Box.max(b.cmin(0), b.textdim(0) + 2 * b.pad(0), b.dmin(0)));
271                 }
272             });
273         
274         specialBoxProperties.put("vshrink", new SpecialBoxProperty() {
275                 public Object get(Box b) { return b.vshrink ? Boolean.TRUE : Boolean.FALSE; }
276                 public void put(Box b, Object value) {
277                     boolean newshrink = stob(value);
278                     if (b.vshrink == newshrink) return;
279                     b.vshrink = newshrink;
280                     if (b.vshrink) b.set(b.dmax, 1, Box.max(b.cmin(1), b.textdim(1) + 2 * b.pad(1), b.dmin(1)));
281                 }
282             });
283         
284         specialBoxProperties.put("x", new SpecialBoxProperty() {
285                 public Object get(Box b) {
286                     if (b.surface == null) return new Integer(0);
287                     if (b.invisible) return new Integer(0);
288                     return new Integer(b.abs(0));
289                 }
290                 public void put(Box b, Object value) {
291                     if (b.getParent() == null && b.surface != null) {
292                         b.surface.setLocation(stoi(value), b.abs(1));
293                         b.surface.centerSurfaceOnRender = false;
294                     }
295                     b.set(abs, 0, stosh(value));
296                 }
297             });
298         
299         specialBoxProperties.put("y", new SpecialBoxProperty() {
300                 public Object get(Box b) {
301                     if (b.surface == null) return new Integer(0);
302                     if (b.invisible) return new Integer(0);
303                     return new Integer(b.abs(1));
304                 }
305                 public void put(Box b, Object value) {
306                     if (b.getParent() == null && b.surface != null) {
307                         b.surface.setLocation(b.abs(0), stoi(value));
308                         b.surface.centerSurfaceOnRender = false;
309                     }
310                     b.set(abs, 1, stosh(value));
311                 }
312             });
313
314         specialBoxProperties.put("width", new SpecialBoxProperty() {
315                 public Object get(Box b) { return new Integer(b.size(0)); }
316                 public void put(Box b, Object value) {
317                     if (b.sizetoimage) return;
318                     if (b.getParent() == null && b.surface != null) {
319                         b.set(size, 0, Box.max(Surface.scarPicture.getWidth(), stosh(value)));
320                         b.mark_for_prerender();
321                     } else {
322                         b.set(dmax, 0, stosh(value));
323                         b.set(dmin, 0, stosh(value));
324                     }
325                 } });
326         
327         specialBoxProperties.put("height", new SpecialBoxProperty() {
328                 public Object get(Box b) { return new Integer(b.size(1)); }
329                 public void put(Box b, Object value) {
330                     if (b.sizetoimage) return;
331                     if (b.getParent() == null && b.surface != null) {
332                         b.set(size, 1, Box.max(Surface.scarPicture.getHeight(), stosh(value)));
333                         b.mark_for_prerender();
334                     } else {
335                         b.set(dmax, 1, stosh(value));
336                         b.set(dmin, 1, stosh(value));
337                     }
338                 } });
339
340         specialBoxProperties.put("flex", new SpecialBoxProperty() {
341                 public Object get(Box b) { return new Double(b.flex); }
342                 public void put(Box b, Object value) {
343                     if (value == null) return;
344                     int newflex = stoi(value);
345                     if (newflex == b.flex) return;
346                     b.flex = newflex;
347                     b.mark_for_prerender();
348                 } });
349         
350         specialBoxProperties.put("tile", new SpecialBoxProperty() {
351                 public Object get(Box b) { return b.tile ? Boolean.TRUE : Boolean.FALSE; }
352                 public void put(Box b, Object value) {
353                     boolean newtile = stob(value);
354                     if (newtile == b.tile) return;
355                     b.tile = newtile;
356                     b.dirty();
357                 } });
358         
359         specialBoxProperties.put("align", new SpecialBoxProperty() {
360                 public Object get(Box b) {
361                     if (b.align == -1) return "topleft";
362                     else if (b.align == 1) return "bottomright";
363                     else return "center";
364                 }
365                 public void put(Box b, Object value) {
366                     String s = value == null ? "" : value.toString();
367                     byte newalign = b.align;
368                     if (s.equals("topleft")) newalign = -1;
369                     else if (s.equals("bottomright")) newalign = 1;
370                     else if (s.equals("center")) newalign = 0;
371                     else if (Log.on) Log.log(this, "invalid value put to align property: " + value);
372                     if (newalign == b.align) return;
373                     b.align = newalign;
374                     if (b.getParent() != null) b.getParent().mark_for_prerender();
375                 } });
376         
377         specialBoxProperties.put("invisible", new SpecialBoxProperty() {
378                 public Object get(Box b) { return b.invisible ? Boolean.TRUE : Boolean.FALSE; }
379                 public void put(Box b, Object value) {
380                     boolean newinvisible = stob(value);
381                     if (newinvisible == b.invisible) return;
382                     b.invisible = newinvisible;
383                     if (b.getParent() == null) {
384                         if (b.surface != null) b.surface.setInvisible(newinvisible);
385                     } else {
386                         b.dirty();
387                         b.getParent().mark_for_prerender();
388                         b.getParent().sync_cmin_to_children();
389                         b.getParent().dirty(b.pos(0), b.pos(1), b.size(0), b.size(1));
390                         b.getParent().dirty(b.oldpos(0), b.oldpos(1), b.oldsize(0), b.oldsize(1));
391                     }
392                 }});
393         
394         specialBoxProperties.put("absolute", new SpecialBoxProperty() {
395                 public Object get(Box b) { return b.absolute ? Boolean.TRUE : Boolean.FALSE; }
396                 public void put(Box b, Object value) {
397                     boolean newabsolute = stob(value);
398                     if (newabsolute == b.absolute) return;
399                     b.absolute = newabsolute;
400                     if (b.getParent() != null) {
401                         b.getParent().mark_for_prerender();
402                         b.getParent().sync_cmin_to_children();
403                     }
404                 } });
405         
406         specialBoxProperties.put("image", new SpecialBoxProperty() {
407                 public Object get(Box b) { return b.image == null ? null : Box.imageToNameMap.get(b.image); }
408                 public void put(Box b, Object value) { b.setImage(value == null ? null : value.toString()); }
409             });
410
411         specialBoxProperties.put("border", new SpecialBoxProperty() {
412                 public Object get(Box b) { return b.border == null ? null : Box.imageToNameMap.get(b.border); }
413                 public void put(Box b, Object value) { b.setBorder(value == null ? null : value.toString()); }
414             });
415
416         specialBoxProperties.put("font", new SpecialBoxProperty() {
417                 public Object get(Box b) { return b.font; }
418                 public void put(Box b, Object value) {
419                     if (value == null) value = Platform.getDefaultFont();
420                     b.font = value.toString();
421                     b.textupdate();
422                     b.dirty();
423                 } });
424         
425         specialBoxProperties.put("globalx", new SpecialBoxProperty() {
426                 public Object get(Box b) { return new Integer(b.getParent() == null || b.surface == null ? 0 : b.pos(0)); }
427                 public void put(Box b, Object value) {
428                     if (b.surface == null || b.getParent() == null) return;
429                     b.put("x", null, new Integer(stoi(value) - stoi(get(b.getParent()))));
430                 }
431             });
432         
433         specialBoxProperties.put("globaly", new SpecialBoxProperty() {
434                 public Object get(Box b) { return new Integer(b.getParent() == null || b.surface == null ? 0 : b.pos(1)); }
435                 public void put(Box b, Object value) {
436                     if (b.surface == null || b.getParent() == null) return;
437                     b.put("y", null, new Integer(stoi(value) - stoi(get(b.getParent()))));
438                 }
439             });
440         
441         specialBoxProperties.put("cursor", new SpecialBoxProperty() {
442                 public Object get(Box b) { return b.cursor; } 
443                 public void put(Box b, Object value) {
444                     b.cursor = (String)value;
445                     if (b.surface == null) return;
446
447                     // see if we need to update the surface cursor
448                     String tempcursor = b.surface.cursor;
449                     b.Move(b.surface.mousex, b.surface.mousey, b.surface.mousex, b.surface.mousey);
450                     if (b.surface.cursor != tempcursor) b.surface.syncCursor();
451                 } 
452             });
453         
454         specialBoxProperties.put("mousex", new SpecialBoxProperty() {
455                 public Object get(Box b) { return new Integer(b.surface == null ? 0 : b.surface.mousex - b.pos(0)); }
456             });
457         
458         specialBoxProperties.put("mousey", new SpecialBoxProperty() {
459                 public Object get(Box b) { return new Integer(b.surface == null ? 0 : b.surface.mousey - b.pos(1)); }
460             });
461         
462         specialBoxProperties.put("xwt", new SpecialBoxProperty() {
463                 public Object get(Box b) { return XWT.singleton; }
464             });
465         
466         specialBoxProperties.put("mouseinside", new SpecialBoxProperty() {
467                 public Object get(Box b) { return b.mouseinside ? Boolean.TRUE : Boolean.FALSE; }
468             });
469         
470         specialBoxProperties.put("numchildren", new SpecialBoxProperty() {
471                 public Object get(Box b) {
472                     if (b.redirect == null) return new Integer(0);
473                     if (b.redirect != b) return get(b.redirect);
474                     return new Integer(b.numChildren());
475                 } });
476         
477         SpecialBoxProperty mouseEventHandler = new SpecialBoxProperty() {
478                 public void put(String name, Box b, Object value) {
479                     if (b.surface == null) return;
480                     if (b.getParent() == null) {
481                         if (b.surface.boxContainingMouse != null && b.surface.boxContainingMouse.getParent() != null)
482                             b.surface.boxContainingMouse.put(name, b.surface.boxContainingMouse, value);
483                     } else {
484                         // check siblings
485                         for(Box c = b.prevSibling(); c != null; c = c.prevSibling())
486                             if (c.inside(c.surface.mousex, c.surface.mousey)) {
487                                 c.put(name, c, value);
488                                 return;
489                             }
490                         // move up a level
491                         if (b.getParent() != null && b.getParent().getParent() != null)
492                             b.getParent().put(name, b.getParent(), value);
493                     }
494                 }};
495
496         specialBoxProperties.put("Press1", mouseEventHandler);
497         specialBoxProperties.put("Press2", mouseEventHandler);
498         specialBoxProperties.put("Press3", mouseEventHandler);
499         specialBoxProperties.put("Release1", mouseEventHandler);
500         specialBoxProperties.put("Release2", mouseEventHandler);
501         specialBoxProperties.put("Release3", mouseEventHandler);
502         specialBoxProperties.put("Click1", mouseEventHandler);
503         specialBoxProperties.put("Click2", mouseEventHandler);
504         specialBoxProperties.put("Click3", mouseEventHandler);
505         specialBoxProperties.put("DoubleClick1", mouseEventHandler);
506         specialBoxProperties.put("DoubleClick2", mouseEventHandler);
507         specialBoxProperties.put("DoubleClick3", mouseEventHandler);
508
509         specialBoxProperties.put("root", new SpecialBoxProperty() {
510                 public Object get(Box b) {
511                     if (b.surface == null) return null;
512                     else if (b.getRoot() == null) return null;
513                     else return b.getRoot().getRootProxy();
514                 } });
515
516         specialBoxProperties.put("Minimized", new SpecialBoxProperty() {
517                 public Object get(Box b) {
518                     if (b.getParent() == null && b.surface != null) return b.surface.minimized ? Boolean.TRUE : Boolean.FALSE;
519                     else return null;
520                 }
521                 public void put(Box b, Object value) {
522                     if (b.surface == null) return;
523                     boolean val = stob(value);
524                     if (b.getParent() == null && b.surface.minimized != val) b.surface.setMinimized(val);
525                 }
526             });
527
528         specialBoxProperties.put("Maximized", new SpecialBoxProperty() {
529                 public Object get(Box b) {
530                     if (b.getParent() == null && b.surface != null) return b.surface.maximized ? Boolean.TRUE : Boolean.FALSE;
531                     else return null;
532                 }
533                 public void put(Box b, Object value) {
534                     if (b.surface == null) return;
535                     boolean val = stob(value);
536                     if (b.getParent() == null && b.surface.maximized != val) b.surface.setMaximized(val);
537                 }
538             });
539
540         specialBoxProperties.put("toback", new SpecialBoxProperty() {
541                 public void put(Box b, Object value) {
542                     if (b.getParent() == null && stob(value) && b.surface != null) b.surface.toBack();
543                 }
544             });
545
546         specialBoxProperties.put("tofront", new SpecialBoxProperty() {
547                 public void put(Box b, Object value) {
548                     if (b.getParent() == null && stob(value) && b.surface != null) b.surface.toFront();
549                 }
550             });
551
552         specialBoxProperties.put("hscar", new SpecialBoxProperty() {
553                 public void put(Box b, Object value) {
554                     if (b.getParent() == null && b.surface != null) {
555                         b.surface.hscar = stoi(value);
556                         b.surface.dirty(0, 0, b.surface.width, b.surface.height);
557                         b.surface.Refresh();
558                     }
559                 }
560             });
561
562         specialBoxProperties.put("vscar", new SpecialBoxProperty() {
563                 public void put(Box b, Object value) {
564                     if (b.getParent() == null && b.surface != null) {
565                         b.surface.vscar = stoi(value);
566                         b.surface.dirty(0, 0, b.surface.width, b.surface.height);
567                         b.surface.Refresh();
568                     }
569                 }
570             });
571
572         specialBoxProperties.put("Close", new SpecialBoxProperty() {
573                 public void put(Box b, Object value) {
574                     if (b.getParent() == null && b.surface != null) b.surface.dispose();
575                 }
576             });
577
578         // these are all do-nothings; just to prevent space from getting taken up in the params Hash.
579         specialBoxProperties.put("KeyPressed", new SpecialBoxProperty());
580         specialBoxProperties.put("KeyReleased", new SpecialBoxProperty());
581         specialBoxProperties.put("PosChange", new SpecialBoxProperty());
582         specialBoxProperties.put("SizeChange", new SpecialBoxProperty());
583
584         specialBoxProperties.put("hpad", new SpecialBoxProperty() {
585                 public Object get(Box b) {
586                     if (b.redirect == null) return new Integer(0);
587                     if (b.redirect != b) return get(b.redirect);
588                     return new Integer(b.pad(0));
589                 }
590                 public void put(Box b, Object value) {
591                     if (b.redirect == null) return;
592                     if (b.redirect != b) { put(b.redirect, value); return; }
593                     short newval = stosh(value);
594                     if (newval == b.pad(0)) return;
595                     b.set(pad, 0, newval);
596                 }
597             });
598
599         specialBoxProperties.put("vpad", new SpecialBoxProperty() {
600                 public Object get(Box b) {
601                     if (b.redirect == null) return new Integer(0);
602                     if (b.redirect != b) return get(b.redirect);
603                     return new Integer(b.pad(1));
604                 }
605                 public void put(Box b, Object value) {
606                     if (b.redirect == null) return;
607                     if (b.redirect != b) { put(b.redirect, value); return; }
608                     short newval = stosh(value);
609                     if (newval == b.pad(1)) return;
610                     b.set(pad, 1, newval);
611                 }
612             });
613
614         specialBoxProperties.put("indexof", new SpecialBoxProperty() {
615                 public Object get(Box b) { return b.indexof(); }
616             });
617
618         specialBoxProperties.put("minwidth", new SpecialBoxProperty() {
619                 public Object get(Box b) { return new Integer(b.dmin(0)); }
620                 public void put(Box b, Object value) {
621                     if (b.sizetoimage) return;
622                     b.set(dmin, 0, stosh(value));
623                 }
624             });
625
626         specialBoxProperties.put("maxwidth", new SpecialBoxProperty() {
627                 public Object get(Box b) { return new Integer(b.dmax(0)); }
628                 public void put(Box b, Object value) {
629                     if (b.sizetoimage) return;
630                     b.set(dmax, 0, stosh(value));
631                 }
632             });
633
634         specialBoxProperties.put("minheight", new SpecialBoxProperty() {
635                 public Object get(Box b) { return new Integer(b.dmin(1)); }
636                 public void put(Box b, Object value) {
637                     if (b.sizetoimage) return;
638                     b.set(dmin, 1, stosh(value));
639                 }
640             });
641
642         specialBoxProperties.put("maxheight", new SpecialBoxProperty() {
643                 public Object get(Box b) { return new Integer(b.dmax(1)); }
644                 public void put(Box b, Object value) {
645                     if (b.sizetoimage) return;
646                     b.set(dmax, 1, stosh(value));
647                 }
648             });
649     }
650
651         
652     /** helper that converts a String to a boolean according to JavaScript coercion rules */
653     public static boolean stob(Object o) {
654         if (o == null) return false;
655         return Boolean.TRUE.equals(o) || "true".equals(o);
656     }
657
658     /** helper that converts a String to an int according to JavaScript coercion rules */
659     public static int stoi(Object o) {
660         if (o == null) return 0;
661         if (o instanceof Integer) return ((Integer)o).intValue();
662
663         String s;
664         if (!(o instanceof String)) s = o.toString();
665         else s = (String)o;
666
667         try { return Integer.parseInt(s.indexOf('.') == -1 ? s : s.substring(0, s.indexOf('.'))); }
668         catch (NumberFormatException e) { return 0; }
669     }
670         
671     /** helper that converts a String to a short according to JavaScript coercion rules */
672     public static short stosh(Object o) {
673         if (o == null) return 0;
674         if (o instanceof Number) return ((Number)o).shortValue();
675
676         String s;
677         if (!(o instanceof String)) s = o.toString();
678         else s = (String)o;
679
680         try { return Short.parseShort(s.indexOf('.') == -1 ? s : s.substring(0, s.indexOf('.'))); }
681         catch (NumberFormatException e) { return 0; }
682     }
683         
684 }
685
686         
687