Merge branch 'master' of github.com:thepowersgang/acess2
[tpg/acess2.git] / Usermode / Libraries / libaxwin3.so_src / include_exp / axwin3 / widget.h
1 /*
2  * Acess2 GUI Version 3 (AxWin3)
3  * - By John Hodge (thePowersGang)
4  *
5  * widget.h
6  * - Server-side widget library
7  */
8 #ifndef _AXWIN3_WIDGET_H_
9 #define _AXWIN3_WIDGET_H_
10
11 #include "axwin.h"
12
13 typedef struct sAxWin3_Widget   tAxWin3_Widget;
14
15 // --- Callback types
16 typedef int     (*tAxWin3_Widget_FireCb)(tAxWin3_Widget *Widget);
17 typedef int     (*tAxWin3_Widget_KeyUpDownCb)(tAxWin3_Widget *Widget, int KeySym);
18 typedef int     (*tAxWin3_Widget_KeyFireCb)(tAxWin3_Widget *Widget, int KeySym, int Character);
19 typedef int     (*tAxWin3_Widget_MouseMoveCb)(tAxWin3_Widget *Widget, int X, int Y);
20 typedef int     (*tAxWin3_Widget_MouseBtnCb)(tAxWin3_Widget *Widget, int X, int Y, int Button, int bPressed);
21
22 // --- Windows
23 extern tHWND    AxWin3_Widget_CreateWindow(tHWND Parent, int W, int H, int RootEleFlags);
24 extern void     AxWin3_Widget_DestroyWindow(tHWND Window);
25 extern tAxWin3_Widget   *AxWin3_Widget_GetRoot(tHWND Window);
26
27 // --- Element Creation
28 extern tAxWin3_Widget   *AxWin3_Widget_AddWidget(tAxWin3_Widget *Parent, int Type, int Flags, const char *DebugName);
29 extern void     AxWin3_Widget_DelWidget(tAxWin3_Widget *Widget);
30
31 // --- Callbacks
32 extern void     AxWin3_Widget_SetFireHandler(tAxWin3_Widget *Widget, tAxWin3_Widget_FireCb Callback);
33 extern void     AxWin3_Widget_SetKeyHandler(tAxWin3_Widget *Widget, tAxWin3_Widget_KeyUpDownCb Callback);
34 extern void     AxWin3_Widget_SetKeyFireHandler(tAxWin3_Widget *Widget, tAxWin3_Widget_KeyFireCb Callback);
35 extern void     AxWin3_Widget_SetMouseMoveHandler(tAxWin3_Widget *Widget, tAxWin3_Widget_MouseMoveCb Callback);
36 extern void     AxWin3_Widget_SetMouseButtonHandler(tAxWin3_Widget *Widget, tAxWin3_Widget_MouseBtnCb Callback);
37 // --- Manipulation
38 extern void     AxWin3_Widget_SetFlags(tAxWin3_Widget *Widget, int FlagSet, int FlagMask);
39 extern void     AxWin3_Widget_SetSize(tAxWin3_Widget *Widget, int Size);
40 extern void     AxWin3_Widget_SetText(tAxWin3_Widget *Widget, const char *Text);
41 extern void     AxWin3_Widget_SetColour(tAxWin3_Widget *Widget, int Index, tAxWin3_Colour Colour);
42 // --- Inspection
43 extern char     *AxWin3_Widget_GetText(tAxWin3_Widget *Widget);
44
45 enum eElementTypes
46 {
47         ELETYPE_NONE,
48
49         ELETYPE_SUBWIN,
50
51         ELETYPE_BOX,    //!< Content box (invisible in itself)
52         ELETYPE_TEXT,   //!< Text
53         ELETYPE_IMAGE,  //!< Image
54         ELETYPE_BUTTON, //!< Push Button
55         ELETYPE_SPACER, //!< Visual Spacer (horizontal / vertical rule)
56         ELETYPE_TEXTINPUT,      //!< Text Input Field
57         ELETYPE_TEXTBOX,        //!< Text Box Input
58
59         ELETYPE_TABBAR, //!< Tab Bar
60         ELETYPE_TOOLBAR,        //!< Tool Bar
61         
62         NUM_ELETYPES
63 };
64
65 enum eElementFlags
66 {
67         /**
68          * \brief Rendered
69          * 
70          * If set, the element will be ignored in calculating sizes and
71          * rendering.
72          */
73         ELEFLAG_NORENDER    = 0x001,
74         /**
75          * \brief Element visibility
76          * 
77          * If set, the element is not drawn (but still is used for size calculations)
78          */
79         ELEFLAG_INVISIBLE   = 0x002,
80         
81         /**
82          * \brief Position an element absulutely (ignored in size calcs)
83          */
84         ELEFLAG_ABSOLUTEPOS = 0x004,
85         
86         /**
87          * \brief Fixed size element
88          */
89         ELEFLAG_FIXEDSIZE   = 0x008,
90         
91         /**
92          * \brief Element "orientation"
93          * 
94          * Vertical means that the children of this element are stacked,
95          * otherwise they list horizontally
96          */
97         ELEFLAG_VERTICAL    = 0x010,//  ELEFLAG_HORIZONTAL  = 0x000,
98         /**
99          * \brief Action for text that overflows
100          */
101         ELEFLAG_WRAP        = 0x020,//  ELEFLAG_NOWRAP      = 0x000,
102         /**
103          * \brief Cross size action
104          * 
105          * If this flag is set, the element will only be as large (across
106          * its parent) as is needed to encase the contents of the element.
107          * Otherwise, the element will expand to fill all avaliable space.
108          */
109         ELEFLAG_NOEXPAND    = 0x040,
110         
111         /**
112          * \brief With (length) size action
113          * If this flag is set, the element will only be as large as
114          * is required along it's parent
115          */
116         ELEFLAG_NOSTRETCH   = 0x080,
117         
118         /**
119          * \brief Center alignment
120          */
121         ELEFLAG_ALIGN_CENTER= 0x100,
122         /**
123          * \brief Right/Bottom alignment
124          * 
125          * If set, the element aligns to the end of avaliable space (instead
126          * of the beginning)
127          */
128         ELEFLAG_ALIGN_END       = 0x200
129 };
130
131
132 #endif
133

UCC git Repository :: git.ucc.asn.au