xref: /haiku/src/apps/deskbar/BarView.h (revision 4b918abdb02a26a770d898594eaaccc6f1726e9b)
1 /*
2 Open Tracker License
3 
4 Terms and Conditions
5 
6 Copyright (c) 1991-2000, Be Incorporated. All rights reserved.
7 
8 Permission is hereby granted, free of charge, to any person obtaining a copy of
9 this software and associated documentation files (the "Software"), to deal in
10 the Software without restriction, including without limitation the rights to
11 use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
12 of the Software, and to permit persons to whom the Software is furnished to do
13 so, subject to the following conditions:
14 
15 The above copyright notice and this permission notice applies to all licensees
16 and shall be included in all copies or substantial portions of the Software.
17 
18 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF TITLE, MERCHANTABILITY,
20 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 BE INCORPORATED BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION
23 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 
25 Except as contained in this notice, the name of Be Incorporated shall not be
26 used in advertising or otherwise to promote the sale, use or other dealings in
27 this Software without prior written authorization from Be Incorporated.
28 
29 Tracker(TM), Be(R), BeOS(R), and BeIA(TM) are trademarks or registered
30 trademarks of Be Incorporated in the United States and other countries. Other
31 brand product names are registered trademarks or trademarks of their respective
32 holders.
33 All rights reserved.
34 */
35 #ifndef BARVIEW_H
36 #define BARVIEW_H
37 
38 
39 #include <Deskbar.h>
40 #include <View.h>
41 
42 #include "NavMenu.h"
43 #include "ObjectList.h"
44 
45 
46 const uint32 kStateChanged = 'stch';
47 
48 
49 enum DeskbarShelf {
50 	B_DESKBAR_ANY_SHELF = 0,
51 	B_DESKBAR_TRAY = 1
52 };
53 
54 enum {
55 	kMiniState = 0,
56 	kExpandoState = 1,
57 	kFullState = 2
58 };
59 
60 const float kHModeHeight = 21.0f;
61 const float kMenuBarHeight = 21.0f;
62 const float kStatusHeight = 22.0f;
63 const float kHiddenDimension = 1.0f;
64 const float kMaxPreventHidingDist = 80.0f;
65 
66 
67 class BShelf;
68 class TBarApp;
69 class TBarMenuBar;
70 class TBarWindow;
71 class TExpandoMenuBar;
72 class TReplicantTray;
73 class TDragRegion;
74 class TResizeControl;
75 class TInlineScrollView;
76 class TTeamMenuItem;
77 
78 class TBarView : public BView {
79 public:
80 							TBarView(BRect frame, bool vertical, bool left,
81 								bool top, int32 state, float width);
82 							~TBarView();
83 
84 	virtual	void			AttachedToWindow();
85 	virtual	void			DetachedFromWindow();
86 
87 	virtual	void			Draw(BRect updateRect);
88 
89 	virtual	void			MessageReceived(BMessage* message);
90 
91 	virtual	void			MouseDown(BPoint where);
92 	virtual	void			MouseMoved(BPoint where, uint32 transit,
93 								const BMessage* dragMessage);
94 	virtual	void			MouseUp(BPoint where);
95 
96 			void			SaveSettings();
97 
98 			void			UpdatePlacement();
99 			void			ChangeState(int32 state, bool vertical, bool left,
100 								bool top, bool aSync = false);
101 
102 			void			RaiseDeskbar(bool raise);
103 			void			HideDeskbar(bool hide);
104 
105 	// window placement methods
106 			bool			Vertical() const { return fVertical; };
107 			bool			Left() const { return fLeft; };
108 			bool			Top() const { return fTop; };
109 			bool			AcrossTop() const { return fTop && !fVertical; };
110 			bool			AcrossBottom() const
111 								{ return !fTop && !fVertical; };
112 
113 	// window state methods
114 			bool			ExpandoState() const
115 								{ return fState == kExpandoState; };
116 			bool			FullState() const { return fState == kFullState; };
117 			bool			MiniState() const { return fState == kMiniState; };
118 			int32			State() const { return fState; };
119 
120 	// drag and drop methods
121 			void			CacheDragData(const BMessage* incoming);
122 			status_t		DragStart();
123 	static	bool			MenuTrackingHook(BMenu* menu, void* castToThis);
124 			void			DragStop(bool full = false);
125 			TrackingHookData*	GetTrackingHookData();
126 			bool			Dragging() const;
127 			const			BMessage* DragMessage() const;
128 			BObjectList<BString>*	CachedTypesList() const;
129 			bool			AppCanHandleTypes(const char* signature);
130 			void			SetDragOverride(bool);
131 			bool			DragOverride();
132 			bool			InvokeItem(const char* signature);
133 
134 			void			HandleDeskbarMenu(BMessage* targetmessage);
135 
136 			status_t		ItemInfo(int32 id, const char** name,
137 								DeskbarShelf* shelf);
138 			status_t		ItemInfo(const char* name, int32* id,
139 								DeskbarShelf* shelf);
140 
141 			bool			ItemExists(int32 id, DeskbarShelf shelf);
142 			bool			ItemExists(const char* name, DeskbarShelf shelf);
143 
144 			int32			CountItems(DeskbarShelf shelf);
145 
146 			BSize			MaxItemSize(DeskbarShelf shelf);
147 
148 			status_t		AddItem(BMessage* archive, DeskbarShelf shelf,
149 								int32* id);
150 			status_t		AddItem(BEntry* entry, DeskbarShelf shelf,
151 								int32* id);
152 
153 			void			RemoveItem(int32 id);
154 			void			RemoveItem(const char* name, DeskbarShelf shelf);
155 
156 			BRect			OffsetIconFrame(BRect rect) const;
157 			BRect			IconFrame(int32 id) const;
158 			BRect			IconFrame(const char* name) const;
159 
160 			void			GetPreferredWindowSize(BRect screenFrame,
161 								float* width, float* height);
162 			void			SizeWindow(BRect screenFrame);
163 			void			PositionWindow(BRect screenFrame);
164 
165 			void			CheckForScrolling();
166 
167 			TExpandoMenuBar*	ExpandoMenuBar() const;
168 			TBarMenuBar*		BarMenuBar() const;
169 			TDragRegion*		DragRegion() const { return fDragRegion; }
170 			TReplicantTray*		ReplicantTray() const { return fReplicantTray; }
171 
172 			float			TeamMenuItemHeight() const;
173 			float			TabHeight() const { return fTabHeight; };
174 
175 private:
176 	friend class TBarApp;
177 	friend class TDeskbarMenu;
178 	friend class PreferencesWindow;
179 
180 			status_t		SendDragMessage(const char* signature,
181 								entry_ref* ref = NULL);
182 
183 			void			PlaceDeskbarMenu();
184 			void			PlaceTray(bool vertSwap, bool leftSwap);
185 			void			PlaceApplicationBar();
186 
187 			void			_ChangeState(BMessage* message);
188 
189 			TBarApp*			fBarApp;
190 			TBarWindow*			fBarWindow;
191 			TInlineScrollView*	fInlineScrollView;
192 			TBarMenuBar*		fBarMenuBar;
193 			TExpandoMenuBar*	fExpandoMenuBar;
194 
195 			int32			fTrayLocation;
196 			TDragRegion*	fDragRegion;
197 			TResizeControl*	fResizeControl;
198 			TReplicantTray*	fReplicantTray;
199 
200 			bool			fIsRaised : 1;
201 			bool			fMouseDownOutside : 1;
202 
203 			bool			fVertical : 1;
204 			bool			fTop : 1;
205 			bool			fLeft : 1;
206 			int32			fState;
207 
208 			bigtime_t		fPulseRate;
209 			bool			fRefsRcvdOnly;
210 			BMessage*		fDragMessage;
211 			BObjectList<BString>*	fCachedTypesList;
212 			TrackingHookData		fTrackingHookData;
213 
214 			uint32			fMaxRecentDocs;
215 			uint32			fMaxRecentApps;
216 
217 			TTeamMenuItem*	fLastDragItem;
218 			BMessageFilter*	fMouseFilter;
219 
220 			float			fTabHeight;
221 };
222 
223 
224 inline TExpandoMenuBar*
225 TBarView::ExpandoMenuBar() const
226 {
227 	return fExpandoMenuBar;
228 }
229 
230 
231 inline TBarMenuBar*
232 TBarView::BarMenuBar() const
233 {
234 	return fBarMenuBar;
235 }
236 
237 
238 inline bool
239 TBarView::Dragging() const
240 {
241 	return (fCachedTypesList && fDragMessage);
242 }
243 
244 
245 inline const BMessage*
246 TBarView::DragMessage() const
247 {
248 	return fDragMessage;
249 }
250 
251 
252 inline BObjectList<BString>*
253 TBarView::CachedTypesList() const
254 {
255 	return fCachedTypesList;
256 }
257 
258 
259 #endif	// BARVIEW_H
260