source: mainline/uspace/lib/ui/include/ui/menu.h@ 5de852c

serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 5de852c was 5de852c, checked in by Jiri Svoboda <jiri@…>, 4 years ago

Coordinate keyboard event delivery between application and UI framework

If an application sets its own keyboard event handler, it needs to call
ui_window_def_kbd() to deliver events to the window's UI control tree.
Menubar should be able to capture these events so that they are not
accidentally acted upon by the application keyboard handler.

  • Property mode set to 100644
File size: 2.5 KB
Line 
1/*
2 * Copyright (c) 2022 Jiri Svoboda
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup libui
30 * @{
31 */
32/**
33 * @file Menu
34 */
35
36#ifndef _UI_MENU_H
37#define _UI_MENU_H
38
39#include <errno.h>
40#include <gfx/coord.h>
41#include <io/kbd_event.h>
42#include <io/pos_event.h>
43#include <stdbool.h>
44#include <types/ui/menu.h>
45#include <types/ui/menubar.h>
46#include <types/ui/event.h>
47
48extern errno_t ui_menu_create(ui_menu_bar_t *, const char *, ui_menu_t **);
49extern void ui_menu_destroy(ui_menu_t *);
50extern ui_menu_t *ui_menu_first(ui_menu_bar_t *);
51extern ui_menu_t *ui_menu_next(ui_menu_t *);
52extern ui_menu_t *ui_menu_last(ui_menu_bar_t *);
53extern ui_menu_t *ui_menu_prev(ui_menu_t *);
54extern const char *ui_menu_caption(ui_menu_t *);
55extern void ui_menu_get_rect(ui_menu_t *, gfx_coord2_t *, gfx_rect_t *);
56extern errno_t ui_menu_open(ui_menu_t *, gfx_rect_t *);
57extern void ui_menu_close(ui_menu_t *);
58extern bool ui_menu_is_open(ui_menu_t *);
59extern errno_t ui_menu_paint(ui_menu_t *, gfx_coord2_t *);
60extern ui_evclaim_t ui_menu_kbd_event(ui_menu_t *, kbd_event_t *);
61extern ui_evclaim_t ui_menu_pos_event(ui_menu_t *, gfx_coord2_t *,
62 pos_event_t *);
63
64#endif
65
66/** @}
67 */
Note: See TracBrowser for help on using the repository browser.