1 /* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*-
3 menuframe.c for the Openbox window manager
4 Copyright (c) 2006 Mikael Magnusson
5 Copyright (c) 2003-2007 Dana Jansens
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 See the COPYING file for a copy of the GNU General Public License.
20 #include "menuframe.h"
30 #include "obt/keyboard.h"
31 #include "obrender/theme.h"
34 #define MAX_MENU_WIDTH 400
36 #define ITEM_HEIGHT (ob_rr_theme->menu_font_height + 2*PADDING)
38 #define FRAME_EVENTMASK (ButtonPressMask |ButtonMotionMask | EnterWindowMask |\
40 #define ENTRY_EVENTMASK (EnterWindowMask | LeaveWindowMask | \
41 ButtonPressMask | ButtonReleaseMask | \
44 GList
*menu_frame_visible
;
45 GHashTable
*menu_frame_map
;
47 static RrAppearance
*a_sep
;
48 static guint submenu_show_timer
= 0;
49 static guint submenu_hide_timer
= 0;
51 static ObMenuEntryFrame
* menu_entry_frame_new(ObMenuEntry
*entry
,
53 static void menu_entry_frame_free(ObMenuEntryFrame
*self
);
54 static void menu_frame_update(ObMenuFrame
*self
);
55 static gboolean
submenu_show_timeout(gpointer data
);
56 static void menu_frame_hide(ObMenuFrame
*self
);
58 static gboolean
submenu_hide_timeout(gpointer data
);
60 static Window
createWindow(Window parent
, gulong mask
,
61 XSetWindowAttributes
*attrib
)
63 return XCreateWindow(obt_display
, parent
, 0, 0, 1, 1, 0,
64 RrDepth(ob_rr_inst
), InputOutput
,
65 RrVisual(ob_rr_inst
), mask
, attrib
);
68 static void client_dest(ObClient
*client
, gpointer data
)
72 /* menus can be associated with a client, so null those refs since
73 we are disappearing now */
74 for (it
= menu_frame_visible
; it
; it
= g_list_next(it
)) {
75 ObMenuFrame
*f
= it
->data
;
76 if (f
->client
== client
)
81 void menu_frame_startup(gboolean reconfig
)
85 a_sep
= RrAppearanceCopy(ob_rr_theme
->a_clear
);
86 RrAppearanceAddTextures(a_sep
, ob_rr_theme
->menu_sep_width
);
87 for (i
= 0; i
< ob_rr_theme
->menu_sep_width
; ++i
) {
88 a_sep
->texture
[i
].type
= RR_TEXTURE_LINE_ART
;
89 a_sep
->texture
[i
].data
.lineart
.color
=
90 ob_rr_theme
->menu_sep_color
;
95 client_add_destroy_notify(client_dest
, NULL
);
96 menu_frame_map
= g_hash_table_new(g_int_hash
, g_int_equal
);
99 void menu_frame_shutdown(gboolean reconfig
)
101 RrAppearanceFree(a_sep
);
103 if (reconfig
) return;
105 client_remove_destroy_notify(client_dest
);
106 g_hash_table_destroy(menu_frame_map
);
109 ObMenuFrame
* menu_frame_new(ObMenu
*menu
, guint show_from
, ObClient
*client
)
112 XSetWindowAttributes attr
;
114 self
= g_slice_new0(ObMenuFrame
);
115 self
->obwin
.type
= OB_WINDOW_CLASS_MENUFRAME
;
117 self
->selected
= NULL
;
118 self
->client
= client
;
119 self
->direction_right
= TRUE
;
120 self
->show_from
= show_from
;
122 attr
.event_mask
= FRAME_EVENTMASK
;
123 self
->window
= createWindow(obt_root(ob_screen
),
126 /* make it a popup menu type window */
127 OBT_PROP_SET32(self
->window
, NET_WM_WINDOW_TYPE
, ATOM
,
128 OBT_PROP_ATOM(NET_WM_WINDOW_TYPE_POPUP_MENU
));
130 XSetWindowBorderWidth(obt_display
, self
->window
, ob_rr_theme
->mbwidth
);
131 XSetWindowBorder(obt_display
, self
->window
,
132 RrColorPixel(ob_rr_theme
->menu_border_color
));
134 self
->a_items
= RrAppearanceCopy(ob_rr_theme
->a_menu
);
136 window_add(&self
->window
, MENUFRAME_AS_WINDOW(self
));
137 stacking_add(MENUFRAME_AS_WINDOW(self
));
142 void menu_frame_free(ObMenuFrame
*self
)
145 while (self
->entries
) {
146 menu_entry_frame_free(self
->entries
->data
);
147 self
->entries
= g_list_delete_link(self
->entries
, self
->entries
);
150 stacking_remove(MENUFRAME_AS_WINDOW(self
));
151 window_remove(self
->window
);
153 RrAppearanceFree(self
->a_items
);
155 XDestroyWindow(obt_display
, self
->window
);
157 g_slice_free(ObMenuFrame
, self
);
161 ObtIC
* menu_frame_ic(ObMenuFrame
*self
)
163 /* menus are always used through a grab right now, so they can always use
164 the grab input context */
165 return grab_input_context();
168 static ObMenuEntryFrame
* menu_entry_frame_new(ObMenuEntry
*entry
,
171 ObMenuEntryFrame
*self
;
172 XSetWindowAttributes attr
;
174 self
= g_slice_new0(ObMenuEntryFrame
);
178 menu_entry_ref(entry
);
180 attr
.event_mask
= ENTRY_EVENTMASK
;
181 self
->window
= createWindow(self
->frame
->window
, CWEventMask
, &attr
);
182 self
->text
= createWindow(self
->window
, 0, NULL
);
183 g_hash_table_insert(menu_frame_map
, &self
->window
, self
);
184 g_hash_table_insert(menu_frame_map
, &self
->text
, self
);
185 if ((entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
) ||
186 (entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
)) {
187 self
->icon
= createWindow(self
->window
, 0, NULL
);
188 g_hash_table_insert(menu_frame_map
, &self
->icon
, self
);
190 if (entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
) {
191 self
->bullet
= createWindow(self
->window
, 0, NULL
);
192 g_hash_table_insert(menu_frame_map
, &self
->bullet
, self
);
195 XMapWindow(obt_display
, self
->window
);
196 XMapWindow(obt_display
, self
->text
);
198 window_add(&self
->window
, MENUFRAME_AS_WINDOW(self
->frame
));
203 static void menu_entry_frame_free(ObMenuEntryFrame
*self
)
206 window_remove(self
->window
);
208 XDestroyWindow(obt_display
, self
->text
);
209 XDestroyWindow(obt_display
, self
->window
);
210 g_hash_table_remove(menu_frame_map
, &self
->text
);
211 g_hash_table_remove(menu_frame_map
, &self
->window
);
212 if ((self
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
) ||
213 (self
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
)) {
214 XDestroyWindow(obt_display
, self
->icon
);
215 g_hash_table_remove(menu_frame_map
, &self
->icon
);
217 if (self
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
) {
218 XDestroyWindow(obt_display
, self
->bullet
);
219 g_hash_table_remove(menu_frame_map
, &self
->bullet
);
222 menu_entry_unref(self
->entry
);
223 g_slice_free(ObMenuEntryFrame
, self
);
227 void menu_frame_move(ObMenuFrame
*self
, gint x
, gint y
)
229 RECT_SET_POINT(self
->area
, x
, y
);
230 self
->monitor
= screen_find_monitor_point(x
, y
);
231 XMoveWindow(obt_display
, self
->window
, self
->area
.x
, self
->area
.y
);
234 static void menu_frame_place_topmenu(ObMenuFrame
*self
, const GravityPoint
*pos
,
235 gint
*x
, gint
*y
, gint monitor
,
236 gboolean user_positioned
)
240 screen_apply_gravity_point(x
, y
, self
->area
.width
, self
->area
.height
,
241 pos
, screen_physical_area_monitor(monitor
));
246 if (config_menu_middle
) {
250 *y
-= self
->area
.height
/ 2;
252 /* try to the right of the cursor */
253 menu_frame_move_on_screen(self
, myx
, *y
, &dx
, &dy
);
254 self
->direction_right
= TRUE
;
256 /* try to the left of the cursor */
257 myx
= *x
- self
->area
.width
;
258 menu_frame_move_on_screen(self
, myx
, *y
, &dx
, &dy
);
259 self
->direction_right
= FALSE
;
262 /* if didnt fit on either side so just use what it says */
264 menu_frame_move_on_screen(self
, myx
, *y
, &dx
, &dy
);
265 self
->direction_right
= TRUE
;
275 /* try to the bottom right of the cursor */
276 menu_frame_move_on_screen(self
, myx
, myy
, &dx
, &dy
);
277 self
->direction_right
= TRUE
;
278 if (dx
!= 0 || dy
!= 0) {
279 /* try to the bottom left of the cursor */
280 myx
= *x
- self
->area
.width
;
282 menu_frame_move_on_screen(self
, myx
, myy
, &dx
, &dy
);
283 self
->direction_right
= FALSE
;
285 if (dx
!= 0 || dy
!= 0) {
286 /* try to the top right of the cursor */
288 myy
= *y
- self
->area
.height
;
289 menu_frame_move_on_screen(self
, myx
, myy
, &dx
, &dy
);
290 self
->direction_right
= TRUE
;
292 if (dx
!= 0 || dy
!= 0) {
293 /* try to the top left of the cursor */
294 myx
= *x
- self
->area
.width
;
295 myy
= *y
- self
->area
.height
;
296 menu_frame_move_on_screen(self
, myx
, myy
, &dx
, &dy
);
297 self
->direction_right
= FALSE
;
299 if (dx
!= 0 || dy
!= 0) {
300 /* if didnt fit on either side so just use what it says */
303 menu_frame_move_on_screen(self
, myx
, myy
, &dx
, &dy
);
304 self
->direction_right
= TRUE
;
311 static void menu_frame_place_submenu(ObMenuFrame
*self
, gint
*x
, gint
*y
)
313 gint overlapx
, overlapy
;
316 overlapx
= ob_rr_theme
->menu_overlap_x
;
317 overlapy
= ob_rr_theme
->menu_overlap_y
;
318 bwidth
= ob_rr_theme
->mbwidth
;
320 if (self
->direction_right
)
321 *x
= self
->parent
->area
.x
+ self
->parent
->area
.width
-
324 *x
= self
->parent
->area
.x
- self
->area
.width
+ overlapx
+ bwidth
;
326 *y
= self
->parent
->area
.y
+ self
->parent_entry
->area
.y
;
327 if (config_menu_middle
)
328 *y
-= (self
->area
.height
- (bwidth
* 2) - ITEM_HEIGHT
) / 2;
333 void menu_frame_move_on_screen(ObMenuFrame
*self
, gint x
, gint y
,
336 const Rect
*a
= NULL
;
337 Rect search
= self
->area
;
338 gint pos
, half
, monitor
;
341 RECT_SET_POINT(search
, x
, y
);
344 monitor
= self
->parent
->monitor
;
346 monitor
= screen_find_monitor(&search
);
348 a
= screen_physical_area_monitor(monitor
);
350 half
= g_list_length(self
->entries
) / 2;
351 pos
= g_list_index(self
->entries
, self
->selected
);
353 /* if in the bottom half then check this stuff first, will keep the bottom
354 edge of the menu visible */
356 *dx
= MAX(*dx
, a
->x
- x
);
357 *dy
= MAX(*dy
, a
->y
- y
);
359 *dx
= MIN(*dx
, (a
->x
+ a
->width
) - (x
+ self
->area
.width
));
360 *dy
= MIN(*dy
, (a
->y
+ a
->height
) - (y
+ self
->area
.height
));
361 /* if in the top half then check this stuff last, will keep the top
362 edge of the menu visible */
364 *dx
= MAX(*dx
, a
->x
- x
);
365 *dy
= MAX(*dy
, a
->y
- y
);
369 static void menu_entry_frame_render(ObMenuEntryFrame
*self
)
371 RrAppearance
*item_a
, *text_a
;
374 ObMenuFrame
*frame
= self
->frame
;
376 switch (self
->entry
->type
) {
377 case OB_MENU_ENTRY_TYPE_NORMAL
:
378 case OB_MENU_ENTRY_TYPE_SUBMENU
:
379 item_a
= (self
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
&&
380 !self
->entry
->data
.normal
.enabled
?
382 (self
== self
->frame
->selected
?
383 ob_rr_theme
->a_menu_disabled_selected
:
384 ob_rr_theme
->a_menu_disabled
) :
386 (self
== self
->frame
->selected
?
387 ob_rr_theme
->a_menu_selected
:
388 ob_rr_theme
->a_menu_normal
));
391 case OB_MENU_ENTRY_TYPE_SEPARATOR
:
392 if (self
->entry
->data
.separator
.label
) {
393 item_a
= ob_rr_theme
->a_menu_title
;
394 th
= ob_rr_theme
->menu_title_height
;
396 item_a
= ob_rr_theme
->a_menu_normal
;
397 th
= ob_rr_theme
->menu_sep_width
+
398 2*ob_rr_theme
->menu_sep_paddingy
;
402 g_assert_not_reached();
405 RECT_SET_SIZE(self
->area
, self
->frame
->inner_w
, th
);
406 XResizeWindow(obt_display
, self
->window
,
407 self
->area
.width
, self
->area
.height
);
408 item_a
->surface
.parent
= self
->frame
->a_items
;
409 item_a
->surface
.parentx
= self
->area
.x
;
410 item_a
->surface
.parenty
= self
->area
.y
;
411 RrPaint(item_a
, self
->window
, self
->area
.width
, self
->area
.height
);
413 switch (self
->entry
->type
) {
414 case OB_MENU_ENTRY_TYPE_NORMAL
:
415 text_a
= (self
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
&&
416 !self
->entry
->data
.normal
.enabled
?
418 (self
== self
->frame
->selected
?
419 ob_rr_theme
->a_menu_text_disabled_selected
:
420 ob_rr_theme
->a_menu_text_disabled
) :
422 (self
== self
->frame
->selected
?
423 ob_rr_theme
->a_menu_text_selected
:
424 ob_rr_theme
->a_menu_text_normal
));
425 text_a
->texture
[0].data
.text
.string
= self
->entry
->data
.normal
.label
;
426 if (self
->entry
->data
.normal
.shortcut
&&
427 (self
->frame
->menu
->show_all_shortcuts
||
428 self
->entry
->data
.normal
.shortcut_always_show
||
429 self
->entry
->data
.normal
.shortcut_position
> 0))
431 text_a
->texture
[0].data
.text
.shortcut
= TRUE
;
432 text_a
->texture
[0].data
.text
.shortcut_pos
=
433 self
->entry
->data
.normal
.shortcut_position
;
435 text_a
->texture
[0].data
.text
.shortcut
= FALSE
;
437 case OB_MENU_ENTRY_TYPE_SUBMENU
:
438 text_a
= (self
== self
->frame
->selected
?
439 ob_rr_theme
->a_menu_text_selected
:
440 ob_rr_theme
->a_menu_text_normal
);
441 sub
= self
->entry
->data
.submenu
.submenu
;
442 text_a
->texture
[0].data
.text
.string
= sub
? sub
->title
: "";
443 if (sub
&& sub
->shortcut
&& (self
->frame
->menu
->show_all_shortcuts
||
444 sub
->shortcut_always_show
||
445 sub
->shortcut_position
> 0))
447 text_a
->texture
[0].data
.text
.shortcut
= TRUE
;
448 text_a
->texture
[0].data
.text
.shortcut_pos
= sub
->shortcut_position
;
450 text_a
->texture
[0].data
.text
.shortcut
= FALSE
;
452 case OB_MENU_ENTRY_TYPE_SEPARATOR
:
453 if (self
->entry
->data
.separator
.label
!= NULL
) {
454 text_a
= ob_rr_theme
->a_menu_text_title
;
455 text_a
->texture
[0].data
.text
.string
=
456 self
->entry
->data
.separator
.label
;
459 text_a
= ob_rr_theme
->a_menu_text_normal
;
462 g_assert_not_reached();
465 switch (self
->entry
->type
) {
466 case OB_MENU_ENTRY_TYPE_NORMAL
:
467 XMoveResizeWindow(obt_display
, self
->text
,
468 self
->frame
->text_x
, PADDING
,
470 ITEM_HEIGHT
- 2*PADDING
);
471 text_a
->surface
.parent
= item_a
;
472 text_a
->surface
.parentx
= self
->frame
->text_x
;
473 text_a
->surface
.parenty
= PADDING
;
474 RrPaint(text_a
, self
->text
, self
->frame
->text_w
,
475 ITEM_HEIGHT
- 2*PADDING
);
477 case OB_MENU_ENTRY_TYPE_SUBMENU
:
478 XMoveResizeWindow(obt_display
, self
->text
,
479 self
->frame
->text_x
, PADDING
,
480 self
->frame
->text_w
- ITEM_HEIGHT
,
481 ITEM_HEIGHT
- 2*PADDING
);
482 text_a
->surface
.parent
= item_a
;
483 text_a
->surface
.parentx
= self
->frame
->text_x
;
484 text_a
->surface
.parenty
= PADDING
;
485 RrPaint(text_a
, self
->text
, self
->frame
->text_w
- ITEM_HEIGHT
,
486 ITEM_HEIGHT
- 2*PADDING
);
488 case OB_MENU_ENTRY_TYPE_SEPARATOR
:
489 if (self
->entry
->data
.separator
.label
!= NULL
) {
490 /* labeled separator */
491 XMoveResizeWindow(obt_display
, self
->text
,
492 ob_rr_theme
->paddingx
, ob_rr_theme
->paddingy
,
493 self
->area
.width
- 2*ob_rr_theme
->paddingx
,
494 ob_rr_theme
->menu_title_height
-
495 2*ob_rr_theme
->paddingy
);
496 text_a
->surface
.parent
= item_a
;
497 text_a
->surface
.parentx
= ob_rr_theme
->paddingx
;
498 text_a
->surface
.parenty
= ob_rr_theme
->paddingy
;
499 RrPaint(text_a
, self
->text
,
500 self
->area
.width
- 2*ob_rr_theme
->paddingx
,
501 ob_rr_theme
->menu_title_height
-
502 2*ob_rr_theme
->paddingy
);
506 /* unlabeled separator */
507 XMoveResizeWindow(obt_display
, self
->text
, 0, 0,
509 ob_rr_theme
->menu_sep_width
+
510 2*ob_rr_theme
->menu_sep_paddingy
);
512 a_sep
->surface
.parent
= item_a
;
513 a_sep
->surface
.parentx
= 0;
514 a_sep
->surface
.parenty
= 0;
515 for (i
= 0; i
< ob_rr_theme
->menu_sep_width
; ++i
) {
516 a_sep
->texture
[i
].data
.lineart
.x1
=
517 ob_rr_theme
->menu_sep_paddingx
;
518 a_sep
->texture
[i
].data
.lineart
.y1
=
519 ob_rr_theme
->menu_sep_paddingy
+ i
;
520 a_sep
->texture
[i
].data
.lineart
.x2
=
521 self
->area
.width
- ob_rr_theme
->menu_sep_paddingx
- 1;
522 a_sep
->texture
[i
].data
.lineart
.y2
=
523 ob_rr_theme
->menu_sep_paddingy
+ i
;
526 RrPaint(a_sep
, self
->text
, self
->area
.width
,
527 ob_rr_theme
->menu_sep_width
+
528 2*ob_rr_theme
->menu_sep_paddingy
);
532 g_assert_not_reached();
535 if (((self
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
) ||
536 (self
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
)) &&
537 self
->entry
->data
.normal
.icon
)
541 XMoveResizeWindow(obt_display
, self
->icon
,
542 PADDING
, frame
->item_margin
.top
,
543 ITEM_HEIGHT
- frame
->item_margin
.top
544 - frame
->item_margin
.bottom
,
545 ITEM_HEIGHT
- frame
->item_margin
.top
546 - frame
->item_margin
.bottom
);
548 clear
= ob_rr_theme
->a_clear_tex
;
549 RrAppearanceClearTextures(clear
);
550 clear
->texture
[0].type
= RR_TEXTURE_IMAGE
;
551 clear
->texture
[0].data
.image
.image
=
552 self
->entry
->data
.normal
.icon
;
553 clear
->texture
[0].data
.image
.alpha
=
554 self
->entry
->data
.normal
.icon_alpha
;
555 clear
->surface
.parent
= item_a
;
556 clear
->surface
.parentx
= PADDING
;
557 clear
->surface
.parenty
= frame
->item_margin
.top
;
558 RrPaint(clear
, self
->icon
,
559 ITEM_HEIGHT
- frame
->item_margin
.top
560 - frame
->item_margin
.bottom
,
561 ITEM_HEIGHT
- frame
->item_margin
.top
562 - frame
->item_margin
.bottom
);
563 XMapWindow(obt_display
, self
->icon
);
564 } else if (self
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
&&
565 self
->entry
->data
.normal
.mask
)
570 XMoveResizeWindow(obt_display
, self
->icon
,
571 PADDING
, frame
->item_margin
.top
,
572 ITEM_HEIGHT
- frame
->item_margin
.top
573 - frame
->item_margin
.bottom
,
574 ITEM_HEIGHT
- frame
->item_margin
.top
575 - frame
->item_margin
.bottom
);
577 clear
= ob_rr_theme
->a_clear_tex
;
578 RrAppearanceClearTextures(clear
);
579 clear
->texture
[0].type
= RR_TEXTURE_MASK
;
580 clear
->texture
[0].data
.mask
.mask
=
581 self
->entry
->data
.normal
.mask
;
583 c
= (self
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
&&
584 !self
->entry
->data
.normal
.enabled
?
586 (self
== self
->frame
->selected
?
587 self
->entry
->data
.normal
.mask_disabled_selected_color
:
588 self
->entry
->data
.normal
.mask_disabled_color
) :
590 (self
== self
->frame
->selected
?
591 self
->entry
->data
.normal
.mask_selected_color
:
592 self
->entry
->data
.normal
.mask_normal_color
));
593 clear
->texture
[0].data
.mask
.color
= c
;
595 clear
->surface
.parent
= item_a
;
596 clear
->surface
.parentx
= PADDING
;
597 clear
->surface
.parenty
= frame
->item_margin
.top
;
598 RrPaint(clear
, self
->icon
,
599 ITEM_HEIGHT
- frame
->item_margin
.top
600 - frame
->item_margin
.bottom
,
601 ITEM_HEIGHT
- frame
->item_margin
.top
602 - frame
->item_margin
.bottom
);
603 XMapWindow(obt_display
, self
->icon
);
605 XUnmapWindow(obt_display
, self
->icon
);
607 if (self
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
) {
608 RrAppearance
*bullet_a
;
609 XMoveResizeWindow(obt_display
, self
->bullet
,
610 self
->frame
->text_x
+ self
->frame
->text_w
-
611 ITEM_HEIGHT
+ PADDING
, PADDING
,
612 ITEM_HEIGHT
- 2*PADDING
,
613 ITEM_HEIGHT
- 2*PADDING
);
614 bullet_a
= (self
== self
->frame
->selected
?
615 ob_rr_theme
->a_menu_bullet_selected
:
616 ob_rr_theme
->a_menu_bullet_normal
);
617 bullet_a
->surface
.parent
= item_a
;
618 bullet_a
->surface
.parentx
=
619 self
->frame
->text_x
+ self
->frame
->text_w
- ITEM_HEIGHT
+ PADDING
;
620 bullet_a
->surface
.parenty
= PADDING
;
621 RrPaint(bullet_a
, self
->bullet
,
622 ITEM_HEIGHT
- 2*PADDING
,
623 ITEM_HEIGHT
- 2*PADDING
);
624 XMapWindow(obt_display
, self
->bullet
);
626 XUnmapWindow(obt_display
, self
->bullet
);
631 /*! this code is taken from the menu_frame_render. if that changes, this won't
633 static gint
menu_entry_frame_get_height(ObMenuEntryFrame
*self
,
634 gboolean first_entry
,
643 t
= self
->entry
->type
;
645 /* this is the More... entry, it's NORMAL type */
646 t
= OB_MENU_ENTRY_TYPE_NORMAL
;
649 case OB_MENU_ENTRY_TYPE_NORMAL
:
650 case OB_MENU_ENTRY_TYPE_SUBMENU
:
651 h
+= ob_rr_theme
->menu_font_height
;
653 case OB_MENU_ENTRY_TYPE_SEPARATOR
:
654 if (self
->entry
->data
.separator
.label
!= NULL
) {
655 h
+= ob_rr_theme
->menu_title_height
+
656 (ob_rr_theme
->mbwidth
- PADDING
) * 2;
658 /* if the first entry is a labeled separator, then make its border
659 overlap with the menu's outside border */
661 h
-= ob_rr_theme
->mbwidth
;
662 /* if the last entry is a labeled separator, then make its border
663 overlap with the menu's outside border */
665 h
-= ob_rr_theme
->mbwidth
;
667 h
+= ob_rr_theme
->menu_sep_width
+
668 2*ob_rr_theme
->menu_sep_paddingy
- PADDING
* 2;
676 void menu_frame_render(ObMenuFrame
*self
)
679 gint tw
, th
; /* temps */
681 gboolean has_icon
= FALSE
;
685 /* find text dimensions */
687 STRUT_SET(self
->item_margin
, 0, 0, 0, 0);
692 e
= self
->entries
->data
;
693 ob_rr_theme
->a_menu_text_normal
->texture
[0].data
.text
.string
= "";
694 tw
= RrMinWidth(ob_rr_theme
->a_menu_text_normal
);
699 RrMargins(ob_rr_theme
->a_menu_normal
, &l
, &t
, &r
, &b
);
700 STRUT_SET(self
->item_margin
,
701 MAX(self
->item_margin
.left
, l
),
702 MAX(self
->item_margin
.top
, t
),
703 MAX(self
->item_margin
.right
, r
),
704 MAX(self
->item_margin
.bottom
, b
));
705 RrMargins(ob_rr_theme
->a_menu_selected
, &l
, &t
, &r
, &b
);
706 STRUT_SET(self
->item_margin
,
707 MAX(self
->item_margin
.left
, l
),
708 MAX(self
->item_margin
.top
, t
),
709 MAX(self
->item_margin
.right
, r
),
710 MAX(self
->item_margin
.bottom
, b
));
711 RrMargins(ob_rr_theme
->a_menu_disabled
, &l
, &t
, &r
, &b
);
712 STRUT_SET(self
->item_margin
,
713 MAX(self
->item_margin
.left
, l
),
714 MAX(self
->item_margin
.top
, t
),
715 MAX(self
->item_margin
.right
, r
),
716 MAX(self
->item_margin
.bottom
, b
));
717 RrMargins(ob_rr_theme
->a_menu_disabled_selected
, &l
, &t
, &r
, &b
);
718 STRUT_SET(self
->item_margin
,
719 MAX(self
->item_margin
.left
, l
),
720 MAX(self
->item_margin
.top
, t
),
721 MAX(self
->item_margin
.right
, r
),
722 MAX(self
->item_margin
.bottom
, b
));
725 /* render the entries */
727 for (it
= self
->entries
; it
; it
= g_list_next(it
)) {
728 RrAppearance
*text_a
;
731 /* if the first entry is a labeled separator, then make its border
732 overlap with the menu's outside border */
733 if (it
== self
->entries
&&
734 e
->entry
->type
== OB_MENU_ENTRY_TYPE_SEPARATOR
&&
735 e
->entry
->data
.separator
.label
)
737 h
-= ob_rr_theme
->mbwidth
;
740 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_SEPARATOR
&&
741 e
->entry
->data
.separator
.label
)
743 e
->border
= ob_rr_theme
->mbwidth
;
746 RECT_SET_POINT(e
->area
, 0, h
+e
->border
);
747 XMoveWindow(obt_display
, e
->window
,
748 e
->area
.x
-e
->border
, e
->area
.y
-e
->border
);
749 XSetWindowBorderWidth(obt_display
, e
->window
, e
->border
);
750 XSetWindowBorder(obt_display
, e
->window
,
751 RrColorPixel(ob_rr_theme
->menu_border_color
));
753 text_a
= (e
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
&&
754 !e
->entry
->data
.normal
.enabled
?
756 (e
== self
->selected
?
757 ob_rr_theme
->a_menu_text_disabled_selected
:
758 ob_rr_theme
->a_menu_text_disabled
) :
760 (e
== self
->selected
?
761 ob_rr_theme
->a_menu_text_selected
:
762 ob_rr_theme
->a_menu_text_normal
));
763 switch (e
->entry
->type
) {
764 case OB_MENU_ENTRY_TYPE_NORMAL
:
765 text_a
->texture
[0].data
.text
.string
= e
->entry
->data
.normal
.label
;
766 tw
= RrMinWidth(text_a
);
767 tw
= MIN(tw
, MAX_MENU_WIDTH
);
768 th
= ob_rr_theme
->menu_font_height
;
770 if (e
->entry
->data
.normal
.icon
||
771 e
->entry
->data
.normal
.mask
)
774 case OB_MENU_ENTRY_TYPE_SUBMENU
:
775 sub
= e
->entry
->data
.submenu
.submenu
;
776 text_a
->texture
[0].data
.text
.string
= sub
? sub
->title
: "";
777 tw
= RrMinWidth(text_a
);
778 tw
= MIN(tw
, MAX_MENU_WIDTH
);
779 th
= ob_rr_theme
->menu_font_height
;
781 if (e
->entry
->data
.normal
.icon
||
782 e
->entry
->data
.normal
.mask
)
785 tw
+= ITEM_HEIGHT
- PADDING
;
787 case OB_MENU_ENTRY_TYPE_SEPARATOR
:
788 if (e
->entry
->data
.separator
.label
!= NULL
) {
789 ob_rr_theme
->a_menu_text_title
->texture
[0].data
.text
.string
=
790 e
->entry
->data
.separator
.label
;
791 tw
= RrMinWidth(ob_rr_theme
->a_menu_text_title
) +
792 2*ob_rr_theme
->paddingx
;
793 tw
= MIN(tw
, MAX_MENU_WIDTH
);
794 th
= ob_rr_theme
->menu_title_height
+
795 (ob_rr_theme
->mbwidth
- PADDING
) *2;
798 th
= ob_rr_theme
->menu_sep_width
+
799 2*ob_rr_theme
->menu_sep_paddingy
- 2*PADDING
;
803 g_assert_not_reached();
811 /* if the last entry is a labeled separator, then make its border
812 overlap with the menu's outside border */
813 it
= g_list_last(self
->entries
);
814 e
= it
? it
->data
: NULL
;
815 if (e
&& e
->entry
->type
== OB_MENU_ENTRY_TYPE_SEPARATOR
&&
816 e
->entry
->data
.separator
.label
)
818 h
-= ob_rr_theme
->mbwidth
;
821 self
->text_x
= PADDING
;
826 w
+= ITEM_HEIGHT
+ PADDING
;
827 self
->text_x
+= ITEM_HEIGHT
+ PADDING
;
834 XResizeWindow(obt_display
, self
->window
, w
, h
);
838 RrPaint(self
->a_items
, self
->window
, w
, h
);
840 for (it
= self
->entries
; it
; it
= g_list_next(it
))
841 menu_entry_frame_render(it
->data
);
843 w
+= ob_rr_theme
->mbwidth
* 2;
844 h
+= ob_rr_theme
->mbwidth
* 2;
846 RECT_SET_SIZE(self
->area
, w
, h
);
851 static void menu_frame_update(ObMenuFrame
*self
)
857 menu_pipe_execute(self
->menu
);
858 menu_find_submenus(self
->menu
);
860 self
->selected
= NULL
;
862 /* start at show_from */
863 mit
= g_list_nth(self
->menu
->entries
, self
->show_from
);
865 /* go through the menu's and frame's entries and connect the frame entries
866 to the menu entries */
867 for (fit
= self
->entries
; mit
&& fit
;
868 mit
= g_list_next(mit
), fit
= g_list_next(fit
))
870 ObMenuEntryFrame
*f
= fit
->data
;
871 f
->entry
= mit
->data
;
874 /* if there are more menu entries than in the frame, add them */
876 ObMenuEntryFrame
*e
= menu_entry_frame_new(mit
->data
, self
);
877 self
->entries
= g_list_append(self
->entries
, e
);
878 mit
= g_list_next(mit
);
881 /* if there are more frame entries than menu entries then get rid of
884 GList
*n
= g_list_next(fit
);
885 menu_entry_frame_free(fit
->data
);
886 self
->entries
= g_list_delete_link(self
->entries
, fit
);
890 /* * make the menu fit on the screen */
892 /* calculate the height of the menu */
894 for (fit
= self
->entries
; fit
; fit
= g_list_next(fit
))
895 h
+= menu_entry_frame_get_height(fit
->data
,
896 fit
== self
->entries
,
897 g_list_next(fit
) == NULL
);
898 /* add the border at the top and bottom */
899 h
+= ob_rr_theme
->mbwidth
* 2;
901 a
= screen_physical_area_monitor(self
->monitor
);
905 gboolean last_entry
= TRUE
;
907 /* take the height of our More... entry into account */
908 h
+= menu_entry_frame_get_height(NULL
, FALSE
, TRUE
);
910 /* start at the end of the entries */
911 flast
= g_list_last(self
->entries
);
913 /* pull out all the entries from the frame that don't
914 fit on the screen, leaving at least 1 though */
915 while (h
> a
->height
&& g_list_previous(flast
) != NULL
) {
916 /* update the height, without this entry */
917 h
-= menu_entry_frame_get_height(flast
->data
, FALSE
, last_entry
);
919 /* destroy the entry we're not displaying */
921 flast
= g_list_previous(flast
);
922 menu_entry_frame_free(tmp
->data
);
923 self
->entries
= g_list_delete_link(self
->entries
, tmp
);
925 /* only the first one that we see is the last entry in the menu */
930 ObMenuEntry
*more_entry
;
931 ObMenuEntryFrame
*more_frame
;
932 /* make the More... menu entry frame which will display in this
934 if self->menu->more_menu is NULL that means that this is already
935 More... menu, so just use ourself.
937 more_entry
= menu_get_more((self
->menu
->more_menu
?
938 self
->menu
->more_menu
:
940 /* continue where we left off */
942 g_list_length(self
->entries
));
943 more_frame
= menu_entry_frame_new(more_entry
, self
);
944 /* make it get deleted when the menu frame goes away */
945 menu_entry_unref(more_entry
);
947 /* add our More... entry to the frame */
948 self
->entries
= g_list_append(self
->entries
, more_frame
);
952 menu_frame_render(self
);
955 static gboolean
menu_frame_is_visible(ObMenuFrame
*self
)
957 return !!(g_list_find(menu_frame_visible
, self
));
960 static gboolean
menu_frame_show(ObMenuFrame
*self
)
964 /* determine if the underlying menu is already visible */
965 for (it
= menu_frame_visible
; it
; it
= g_list_next(it
)) {
966 ObMenuFrame
*f
= it
->data
;
967 if (f
->menu
== self
->menu
)
971 if (self
->menu
->update_func
)
972 if (!self
->menu
->update_func(self
, self
->menu
->data
))
976 if (menu_frame_visible
== NULL
) {
977 /* no menus shown yet */
979 /* grab the pointer in such a way as to pass through "owner events"
980 so that we can get enter/leave notifies in the menu. */
981 if (!grab_pointer(TRUE
, FALSE
, OB_CURSOR_POINTER
))
983 if (!grab_keyboard()) {
989 menu_frame_update(self
);
991 menu_frame_visible
= g_list_prepend(menu_frame_visible
, self
);
993 if (self
->menu
->show_func
)
994 self
->menu
->show_func(self
, self
->menu
->data
);
999 gboolean
menu_frame_show_topmenu(ObMenuFrame
*self
, const GravityPoint
*pos
,
1000 gint monitor
, gboolean mouse
,
1001 gboolean user_positioned
)
1006 if (menu_frame_is_visible(self
))
1008 if (!menu_frame_show(self
))
1011 if (self
->menu
->place_func
) {
1014 self
->menu
->place_func(self
, &x
, &y
, mouse
, self
->menu
->data
);
1016 menu_frame_place_topmenu(self
, pos
, &x
, &y
, monitor
,
1020 menu_frame_move(self
, x
, y
);
1022 XMapWindow(obt_display
, self
->window
);
1024 if (screen_pointer_pos(&px
, &py
)) {
1025 ObMenuEntryFrame
*e
= menu_entry_frame_under(px
, py
);
1026 if (e
&& e
->frame
== self
)
1033 /*! Stop hiding an open submenu.
1034 @child The OnMenuFrame of the submenu to be hidden
1036 static void remove_submenu_hide_timeout(ObMenuFrame
*child
)
1038 if (submenu_hide_timer
) g_source_remove(submenu_hide_timer
);
1041 gboolean
menu_frame_show_submenu(ObMenuFrame
*self
, ObMenuFrame
*parent
,
1042 ObMenuEntryFrame
*parent_entry
)
1047 if (menu_frame_is_visible(self
))
1050 self
->monitor
= parent
->monitor
;
1051 self
->parent
= parent
;
1052 self
->parent_entry
= parent_entry
;
1054 /* set up parent's child to be us */
1055 if ((parent
->child
) != self
) {
1057 menu_frame_hide(parent
->child
);
1058 parent
->child
= self
;
1059 parent
->child_entry
= parent_entry
;
1062 if (!menu_frame_show(self
)) {
1063 parent
->child
= NULL
;
1064 parent
->child_entry
= NULL
;
1068 menu_frame_place_submenu(self
, &x
, &y
);
1069 menu_frame_move_on_screen(self
, x
, y
, &dx
, &dy
);
1072 /*try the other side */
1073 self
->direction_right
= !self
->direction_right
;
1074 menu_frame_place_submenu(self
, &x
, &y
);
1075 menu_frame_move_on_screen(self
, x
, y
, &dx
, &dy
);
1077 menu_frame_move(self
, x
+ dx
, y
+ dy
);
1079 XMapWindow(obt_display
, self
->window
);
1081 if (screen_pointer_pos(&px
, &py
)) {
1082 ObMenuEntryFrame
*e
= menu_entry_frame_under(px
, py
);
1083 if (e
&& e
->frame
== self
)
1090 static void menu_frame_hide(ObMenuFrame
*self
)
1092 ObMenu
*const menu
= self
->menu
;
1093 GList
*it
= g_list_find(menu_frame_visible
, self
);
1094 gulong ignore_start
;
1099 if (menu
->hide_func
)
1100 menu
->hide_func(self
, menu
->data
);
1103 menu_frame_hide(self
->child
);
1106 remove_submenu_hide_timeout(self
);
1108 self
->parent
->child
= NULL
;
1109 self
->parent
->child_entry
= NULL
;
1111 self
->parent
= NULL
;
1112 self
->parent_entry
= NULL
;
1114 menu_frame_visible
= g_list_delete_link(menu_frame_visible
, it
);
1116 if (menu_frame_visible
== NULL
) {
1117 /* last menu shown */
1122 ignore_start
= event_start_ignore_all_enters();
1123 XUnmapWindow(obt_display
, self
->window
);
1124 event_end_ignore_all_enters(ignore_start
);
1126 menu_frame_free(self
);
1128 if (menu
->cleanup_func
)
1129 menu
->cleanup_func(menu
, menu
->data
);
1132 void menu_frame_hide_all(void)
1136 if (config_submenu_show_delay
&& submenu_show_timer
)
1137 /* remove any submenu open requests */
1138 g_source_remove(submenu_show_timer
);
1139 if ((it
= g_list_last(menu_frame_visible
)))
1140 menu_frame_hide(it
->data
);
1143 ObMenuFrame
* menu_frame_under(gint x
, gint y
)
1145 ObMenuFrame
*ret
= NULL
;
1148 for (it
= menu_frame_visible
; it
; it
= g_list_next(it
)) {
1149 ObMenuFrame
*f
= it
->data
;
1151 if (RECT_CONTAINS(f
->area
, x
, y
)) {
1159 ObMenuEntryFrame
* menu_entry_frame_under(gint x
, gint y
)
1162 ObMenuEntryFrame
*ret
= NULL
;
1165 if ((frame
= menu_frame_under(x
, y
))) {
1166 x
-= ob_rr_theme
->mbwidth
+ frame
->area
.x
;
1167 y
-= ob_rr_theme
->mbwidth
+ frame
->area
.y
;
1169 for (it
= frame
->entries
; it
; it
= g_list_next(it
)) {
1170 ObMenuEntryFrame
*e
= it
->data
;
1172 if (RECT_CONTAINS(e
->area
, x
, y
)) {
1181 static gboolean
submenu_show_timeout(gpointer data
)
1183 g_assert(menu_frame_visible
);
1184 menu_entry_frame_show_submenu((ObMenuEntryFrame
*)data
);
1188 static void submenu_show_dest(gpointer data
)
1190 submenu_show_timer
= 0;
1193 static gboolean
submenu_hide_timeout(gpointer data
)
1195 g_assert(menu_frame_visible
);
1196 menu_frame_hide((ObMenuFrame
*)data
);
1200 static void submenu_hide_dest(gpointer data
)
1202 submenu_hide_timer
= 0;
1205 void menu_frame_select(ObMenuFrame
*self
, ObMenuEntryFrame
*entry
,
1208 ObMenuEntryFrame
*old
= self
->selected
;
1209 ObMenuFrame
*oldchild
= self
->child
;
1210 ObMenuEntryFrame
*oldchild_entry
= self
->child_entry
;
1212 /* if the user selected a separator, ignore it and reselect what we had
1214 if (entry
&& entry
->entry
->type
== OB_MENU_ENTRY_TYPE_SEPARATOR
)
1218 (!old
|| old
->entry
->type
!= OB_MENU_ENTRY_TYPE_SUBMENU
))
1221 /* if the user left this menu but we have a submenu open, move the
1222 selection back to that submenu */
1223 if (!entry
&& oldchild_entry
)
1224 entry
= oldchild_entry
;
1226 if (config_submenu_show_delay
&& submenu_show_timer
)
1227 /* remove any submenu open requests */
1228 g_source_remove(submenu_show_timer
);
1230 self
->selected
= entry
;
1233 menu_entry_frame_render(old
);
1235 if (oldchild_entry
) {
1236 /* There is an open submenu */
1237 if (oldchild_entry
== self
->selected
) {
1238 /* The open submenu has been reselected, so stop hiding the
1240 remove_submenu_hide_timeout(oldchild
);
1242 else if (oldchild_entry
== old
) {
1243 /* The open submenu was selected and is no longer, so hide the
1245 if (immediate
|| config_submenu_hide_delay
== 0)
1246 menu_frame_hide(oldchild
);
1247 else if (config_submenu_hide_delay
> 0) {
1248 if (submenu_hide_timer
) g_source_remove(submenu_hide_timer
);
1249 submenu_hide_timer
=
1250 g_timeout_add_full(G_PRIORITY_DEFAULT
,
1251 config_submenu_hide_delay
,
1252 submenu_hide_timeout
, oldchild
, submenu_hide_dest
);
1257 if (self
->selected
) {
1258 menu_entry_frame_render(self
->selected
);
1260 if (self
->selected
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
) {
1261 /* only show if the submenu isn't already showing */
1262 if (oldchild_entry
!= self
->selected
) {
1263 if (immediate
|| config_submenu_show_delay
== 0)
1264 menu_entry_frame_show_submenu(self
->selected
);
1265 else if (config_submenu_show_delay
> 0) {
1266 if (submenu_show_timer
)
1267 g_source_remove(submenu_show_timer
);
1268 submenu_show_timer
=
1269 g_timeout_add_full(G_PRIORITY_DEFAULT
,
1270 config_submenu_show_delay
,
1271 submenu_show_timeout
,
1272 self
->selected
, submenu_show_dest
);
1275 /* hide the grandchildren of this menu. and move the cursor to
1277 else if (immediate
&& self
->child
&& self
->child
->child
) {
1278 menu_frame_hide(self
->child
->child
);
1279 menu_frame_select(self
->child
, NULL
, TRUE
);
1285 void menu_entry_frame_show_submenu(ObMenuEntryFrame
*self
)
1289 if (!self
->entry
->data
.submenu
.submenu
) return;
1291 f
= menu_frame_new(self
->entry
->data
.submenu
.submenu
,
1292 self
->entry
->data
.submenu
.show_from
,
1293 self
->frame
->client
);
1294 /* pass our direction on to our child */
1295 f
->direction_right
= self
->frame
->direction_right
;
1297 if (!menu_frame_show_submenu(f
, self
->frame
, self
))
1301 void menu_entry_frame_execute(ObMenuEntryFrame
*self
, guint state
)
1303 if (self
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
&&
1304 self
->entry
->data
.normal
.enabled
)
1306 /* grab all this shizzle, cuz when the menu gets hidden, 'self'
1308 ObMenuEntry
*entry
= self
->entry
;
1309 ObMenuExecuteFunc func
= self
->frame
->menu
->execute_func
;
1310 gpointer data
= self
->frame
->menu
->data
;
1311 GSList
*acts
= self
->entry
->data
.normal
.actions
;
1312 ObClient
*client
= self
->frame
->client
;
1313 ObMenuFrame
*frame
= self
->frame
;
1314 guint mods
= obt_keyboard_only_modmasks(state
);
1316 /* release grabs before executing the shit */
1317 if (!(mods
& ControlMask
)) {
1318 event_cancel_all_key_grabs();
1323 func(entry
, frame
, client
, state
, data
);
1325 actions_run_acts(acts
, OB_USER_ACTION_MENU_SELECTION
,
1326 state
, -1, -1, 0, OB_FRAME_CONTEXT_NONE
, client
);
1330 void menu_frame_select_previous(ObMenuFrame
*self
)
1332 GList
*it
= NULL
, *start
;
1334 if (self
->entries
) {
1335 start
= it
= g_list_find(self
->entries
, self
->selected
);
1337 ObMenuEntryFrame
*e
;
1339 it
= it
? g_list_previous(it
) : g_list_last(self
->entries
);
1345 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
)
1347 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
)
1352 menu_frame_select(self
, it
? it
->data
: NULL
, FALSE
);
1355 void menu_frame_select_next(ObMenuFrame
*self
)
1357 GList
*it
= NULL
, *start
;
1359 if (self
->entries
) {
1360 start
= it
= g_list_find(self
->entries
, self
->selected
);
1362 ObMenuEntryFrame
*e
;
1364 it
= it
? g_list_next(it
) : self
->entries
;
1370 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
)
1372 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
)
1377 menu_frame_select(self
, it
? it
->data
: NULL
, FALSE
);
1380 void menu_frame_select_first(ObMenuFrame
*self
)
1384 if (self
->entries
) {
1385 for (it
= self
->entries
; it
; it
= g_list_next(it
)) {
1386 ObMenuEntryFrame
*e
= it
->data
;
1387 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
)
1389 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
)
1393 menu_frame_select(self
, it
? it
->data
: NULL
, FALSE
);
1396 void menu_frame_select_last(ObMenuFrame
*self
)
1400 if (self
->entries
) {
1401 for (it
= g_list_last(self
->entries
); it
; it
= g_list_previous(it
)) {
1402 ObMenuEntryFrame
*e
= it
->data
;
1403 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_SUBMENU
)
1405 if (e
->entry
->type
== OB_MENU_ENTRY_TYPE_NORMAL
)
1409 menu_frame_select(self
, it
? it
->data
: NULL
, FALSE
);