1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
/*
Crystal Space Windowing System: dialog window class
Copyright (C) 1998,1999 by Andrew Zabolotny <bit@eltech.ru>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#ifndef __CSDIALOG_H__
#define __CSDIALOG_H__
#include "cscomp.h"
/**
* Possible dialog frame styles<p>
* Dialog can have no frame (default) or can have a horizontal or vertical
* "frame" which is used for horizontal and vertical toolbars.
*/
enum csDialogFrameStyle
{
/// Dialog has no frame (default)
csdfsNone,
/// Dialog has two 3D horizontal lines at top and bottom (like menu bar)
csdfsHorizontal,
/// Dialog has two 3D vertical lines at left and right
csdfsVertical,
/// Dialog has a 3D frame around perimeter
csdfsAround,
/// Dialog's frame and background are defined entirely by a bitmap
csdfsBitmap
};
/**
* The Dialog class is a single-colored canvas which contains a
* number of child controls. The dialog can perform a number of
* operations on its childs such as switching between them using
* Tab/ShiftTab key, activating the default button when Enter is
* pressed etc.
* <p>
* Other uses for csDialog class are for floating toolbars. They
* can be even resizeable; to create a floating toolbar you should
* create a stand-alone dialog object, setting his DragStyle to
* CS_DRAG_MOVEABLE and, possibly, CS_DRAG_SIZEABLE. In this case
* dialog will act as a standalone window; it would be good if you
* specify its frame style to csdfsAround: in this case it will
* look like a usual window but without titlebar.
*/
class csDialog : public csComponent
{
protected:
/// Dialog frame style
csDialogFrameStyle FrameStyle;
/// Automatical grid placement parameters
int GridX, GridY;
/// Automatically snap dialog size to grid?
bool SnapSizeToGrid;
/// First component
csComponent *first;
/// Border width and height
int BorderWidth, BorderHeight;
/// Dialog transparency (if CSS_TRANSPARENT is set)
uint8 Alpha, OverlayAlpha;
/// Frame bitmap, if there is one
csPixmap *FrameBitmap, *OverlayBitmap;
/// Set if this component should delete the frame bitmap when it is done
bool delFrameBitmap, delOverlayBitmap;
public:
/// Create dialog object
csDialog (csComponent *iParent, csDialogFrameStyle iFrameStyle = csdfsNone);
/// Destroy a dialog object
virtual ~csDialog();
/// Handle input events
virtual bool HandleEvent (iEvent &Event);
/**
* Enable/disable(dx<0||dy<0) automatic control placement in a grid fashion.
* DeltaX and DeltaY is the horizontal and vertical distance between controls;
* SnapSize tells dialog object whenever dialog size should snap when it
* is resized to the maximal x/y coordinates of all controls.
*/
void SetAutoGrid (int iDeltaX, int iDeltaY, bool iSnapSize)
{ GridX = iDeltaX; GridY = iDeltaY; SnapSizeToGrid = iSnapSize; }
/// Do auto-placement work if enabled
virtual bool SetRect (int xmin, int ymin, int xmax, int ymax);
/// Return the recommended minimal size of dialog
virtual void SuggestSize (int &w, int &h);
/// Return border width and height
void GetBorderSize (int &w, int &h)
{ w = BorderWidth; h = BorderHeight; }
/// Set border width and height
void SetBorderSize (int w, int h);
/// Fix dialog size when resizing
virtual void FixSize (int &newW, int &newH);
/// Query dialog border style
inline csDialogFrameStyle GetFrameStyle ()
{ return FrameStyle; }
/// Change dialog border style
void SetFrameStyle (csDialogFrameStyle iFrameStyle);
/// Get the name of the skip slice for this component
virtual char *GetSkinName ()
{ return "Dialog"; }
/// Set dialog transparency level (0 - opaque, 255 - fully transparent)
void SetAlpha (uint8 iAlpha);
/// Set dialog overlay transparency level (0 - opaque, 255 - fully transparent)
void SetOverlayAlpha (uint8 iAlpha);
/// Query dialog transparency level
uint8 GetAlpha ()
{ return GetState (CSS_TRANSPARENT) ? Alpha : 0; }
/// Query dialog overlay transparency level
uint8 GetOverlayAlpha ()
{ return GetState (CSS_TRANSPARENT) ? OverlayAlpha : 0; }
/// Set the bitmap for the frame (only useful if the framestyle is csdfsBitmap)
void SetFrameBitmap(csPixmap *iFrameBitmap, bool iDelFrameBitmap);
/// Set the bitmap for the overlay (only useful if the framestyle is csdfsBitmap)
void SetOverlayBitmap(csPixmap *iOverlayBitmap, bool iDelOverlayBitmap);
/// Get the frame bitmap
csPixmap *GetFrameBitmap()
{ return FrameBitmap; }
/// Get the overlay bitmap
csPixmap *GetOverlayBitmap()
{ return OverlayBitmap; }
protected:
/// Adjust focused control by switching back or forth if it is disabled
void AdjustFocused (bool forward);
/// Used by SuggestSize
static bool do_topleft (csComponent *comp, void *param);
/// Place all dialog items in correspondence to GridX, GridY and SnapSizeToGrid
bool PlaceItems ();
};
#endif // __CSDIALOG_H__
|
