source: mainline/uspace/lib/ui/private/window.h@ 1af103e

ticket/834-toolchain-update topic/fix-logger-deadlock topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 1af103e was 1af103e, checked in by Jiri Svoboda <jiri@…>, 3 years ago

System menu (WIP)

The system menu provides browsable, keyboard-accessible access to window
management functions (such as closing, minimizing, maximizing, resizing,
moving).

  • Property mode set to 100644
File size: 4.1 KB
RevLine 
[f7a90df]1/*
[46a47c0]2 * Copyright (c) 2023 Jiri Svoboda
[f7a90df]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 Window structure
34 *
35 */
36
37#ifndef _UI_PRIVATE_WINDOW_H
38#define _UI_PRIVATE_WINDOW_H
39
[252d03c]40#include <adt/list.h>
[fa01c05]41#include <errno.h>
[d6c4d40]42#include <congfx/console.h>
[f7a90df]43#include <display.h>
44#include <gfx/context.h>
[f03d1308]45#include <io/kbd_event.h>
[d284ce9]46#include <io/pos_event.h>
[25f26600]47#include <memgfx/memgc.h>
[8ce56a6]48#include <memgfx/xlategc.h>
[1af103e]49#include <types/common.h>
[77ffa01]50#include <types/ui/cursor.h>
51#include <types/ui/window.h>
[f7a90df]52
53/** Actual structure of window.
54 *
55 * This is private to libui.
56 */
57struct ui_window {
58 /** Containing user interface */
59 struct ui *ui;
[252d03c]60 /** Link to @c ui->windows */
61 link_t lwindows;
[d284ce9]62 /** Callbacks */
63 struct ui_window_cb *cb;
64 /** Callback argument */
65 void *arg;
[f7a90df]66 /** Display window */
67 display_window_t *dwindow;
68 /** Window GC */
69 gfx_context_t *gc;
[2ab8ab3]70 /** Window bitmap (if client-side rendering) */
71 gfx_bitmap_t *bmp;
72 /** Window memory GC (if client-side rendering) */
73 mem_gc_t *mgc;
[8ce56a6]74 /** Translating GC (if full screen & server-side rendering) */
75 xlate_gc_t *xgc;
[2ab8ab3]76 /** Real window GC (if client-side rendering) */
77 gfx_context_t *realgc;
[2d879f7]78 /** Window rectangle */
79 gfx_rect_t rect;
[35cffea]80 /** Normal window rectangle (when not maximized) */
81 gfx_rect_t normal_rect;
[3c3657c]82 /** Display position (if fullscreen mode) */
83 gfx_coord2_t dpos;
[66a2becf]84 /** Application area bitmap */
85 gfx_bitmap_t *app_bmp;
[25f26600]86 /** Application area memory GC */
87 mem_gc_t *app_mgc;
[66a2becf]88 /** Application area GC */
89 gfx_context_t *app_gc;
[2ab8ab3]90 /** Dirty rectangle */
91 gfx_rect_t dirty_rect;
[f7a90df]92 /** UI resource. Ideally this would be in ui_t. */
93 struct ui_resource *res;
94 /** Window decoration */
95 struct ui_wdecor *wdecor;
[1af103e]96 /** System menu */
97 struct ui_menu *sysmenu;
[b71c0fc]98 /** Top-level control in the application area */
99 struct ui_control *control;
[2d879f7]100 /** Current cursor */
101 ui_stock_cursor_t cursor;
[b48e680f]102 /** Window placement */
103 ui_wnd_placement_t placement;
[f7a90df]104};
105
[35cffea]106/** Size change operation */
107typedef enum {
108 /** Resize window */
109 ui_wsc_resize,
110 /** Maximize window */
111 ui_wsc_maximize,
112 /** Unmaximize window */
113 ui_wsc_unmaximize
114} ui_wnd_sc_op_t;
115
[db3895d]116extern display_stock_cursor_t wnd_dcursor_from_cursor(ui_stock_cursor_t);
[1af103e]117extern void ui_window_send_sysmenu(ui_window_t *, sysarg_t);
[06176e1]118extern void ui_window_send_minimize(ui_window_t *);
[35cffea]119extern void ui_window_send_maximize(ui_window_t *);
120extern void ui_window_send_unmaximize(ui_window_t *);
[fa01c05]121extern void ui_window_send_close(ui_window_t *);
[46a47c0]122extern void ui_window_send_focus(ui_window_t *, unsigned);
[fa01c05]123extern void ui_window_send_kbd(ui_window_t *, kbd_event_t *);
124extern errno_t ui_window_send_paint(ui_window_t *);
125extern void ui_window_send_pos(ui_window_t *, pos_event_t *);
[46a47c0]126extern void ui_window_send_unfocus(ui_window_t *, unsigned);
[35cffea]127extern errno_t ui_window_size_change(ui_window_t *, gfx_rect_t *,
128 ui_wnd_sc_op_t);
[d284ce9]129
[f7a90df]130#endif
131
132/** @}
133 */
Note: See TracBrowser for help on using the repository browser.