]>
Commit | Line | Data |
---|---|---|
1 | ///////////////////////////////////////////////////////////////////////////// | |
2 | // Name: minifram.h | |
3 | // Purpose: interface of wxMiniFrame | |
4 | // Author: wxWidgets team | |
5 | // Licence: wxWindows licence | |
6 | ///////////////////////////////////////////////////////////////////////////// | |
7 | ||
8 | /** | |
9 | @class wxMiniFrame | |
10 | ||
11 | A miniframe is a frame with a small title bar. | |
12 | It is suitable for floating toolbars that must not take up too much screen area. | |
13 | ||
14 | An example of mini frame can be seen in the @ref page_samples_dialogs | |
15 | using the "Mini frame" command of the "Generic dialogs" submenu. | |
16 | ||
17 | @beginStyleTable | |
18 | @style{wxICONIZE} | |
19 | Display the frame iconized (minimized) (Windows only). | |
20 | @style{wxCAPTION} | |
21 | Puts a caption on the frame. | |
22 | @style{wxMINIMIZE} | |
23 | Identical to wxICONIZE. | |
24 | @style{wxMINIMIZE_BOX} | |
25 | Displays a minimize box on the frame (Windows and Motif only). | |
26 | @style{wxMAXIMIZE} | |
27 | Displays the frame maximized (Windows only). | |
28 | @style{wxMAXIMIZE_BOX} | |
29 | Displays a maximize box on the frame (Windows and Motif only). | |
30 | @style{wxCLOSE_BOX} | |
31 | Displays a close box on the frame. | |
32 | @style{wxSTAY_ON_TOP} | |
33 | Stay on top of other windows (Windows only). | |
34 | @style{wxSYSTEM_MENU} | |
35 | Displays a system menu (Windows and Motif only). | |
36 | @style{wxRESIZE_BORDER} | |
37 | Displays a resizable border around the window. | |
38 | @endStyleTable | |
39 | ||
40 | @remarks | |
41 | This class has miniframe functionality under Windows and GTK, i.e. the presence | |
42 | of mini frame will not be noted in the task bar and focus behaviour is different. | |
43 | On other platforms, it behaves like a normal frame. | |
44 | ||
45 | @library{wxcore} | |
46 | @category{managedwnd} | |
47 | ||
48 | @see wxMDIParentFrame, wxMDIChildFrame, wxFrame, wxDialog | |
49 | */ | |
50 | class wxMiniFrame : public wxFrame | |
51 | { | |
52 | public: | |
53 | /** | |
54 | Default ctor. | |
55 | */ | |
56 | wxMiniFrame(); | |
57 | ||
58 | /** | |
59 | Constructor, creating the window. | |
60 | ||
61 | @param parent | |
62 | The window parent. This may be @NULL. If it is non-@NULL, the frame will | |
63 | always be displayed on top of the parent window on Windows. | |
64 | @param id | |
65 | The window identifier. It may take a value of -1 to indicate a default value. | |
66 | @param title | |
67 | The caption to be displayed on the frame's title bar. | |
68 | @param pos | |
69 | The window position. The value wxDefaultPosition indicates a default position, | |
70 | chosen by either the windowing system or wxWidgets, depending on platform. | |
71 | @param size | |
72 | The window size. The value wxDefaultSize indicates a default size, chosen by | |
73 | either the windowing system or wxWidgets, depending on platform. | |
74 | @param style | |
75 | The window style. See wxMiniFrame. | |
76 | @param name | |
77 | The name of the window. This parameter is used to associate a name with | |
78 | the item, allowing the application user to set Motif resource values for | |
79 | individual windows. | |
80 | ||
81 | @remarks The frame behaves like a normal frame on non-Windows platforms. | |
82 | ||
83 | @see Create() | |
84 | */ | |
85 | wxMiniFrame(wxWindow* parent, wxWindowID id, | |
86 | const wxString& title, | |
87 | const wxPoint& pos = wxDefaultPosition, | |
88 | const wxSize& size = wxDefaultSize, | |
89 | long style = wxCAPTION | wxRESIZE_BORDER, | |
90 | const wxString& name = wxFrameNameStr); | |
91 | ||
92 | /** | |
93 | Destructor. Destroys all child windows and menu bar if present. | |
94 | */ | |
95 | virtual ~wxMiniFrame(); | |
96 | ||
97 | /** | |
98 | Used in two-step frame construction. | |
99 | See wxMiniFrame() for further details. | |
100 | */ | |
101 | bool Create(wxWindow* parent, wxWindowID id, const wxString& title, | |
102 | const wxPoint& pos = wxDefaultPosition, | |
103 | const wxSize& size = wxDefaultSize, | |
104 | long style = wxCAPTION | wxRESIZE_BORDER, | |
105 | const wxString& name = wxFrameNameStr); | |
106 | }; | |
107 |