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
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org 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 Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef _HEADBAR_HXX
#define _HEADBAR_HXX
#include "svtools/svtdllapi.h"
#include <tools/link.hxx>
#include <vcl/window.hxx>
/*************************************************************************
Beschreibung
============
class HeaderBar
Diese Klasse dient zur Anzeige einer Ueberschiftszeile. Diese kann Texte,
Images oder beides anzeigen. Man kann die Items in der Groesse aendern,
verschieben oder anklicken. In vielen Faellen macht es zum Beispiel Sinn,
dieses Control mit einer SvTabListBox zu verbinden.
--------------------------------------------------------------------------
WinBits
WB_BORDER Oben und unten wird ein Border gezeichnet
WB_BOTTOMBORDER Unten wird ein Border gezeichnet
WB_BUTTONSTYLE Die Items sehen aus wie Buttons, ansonsten sind sie flach
WB_3DLOOK 3D-Darstellung
WB_DRAG Items koennen verschoben werden
WB_STDHEADERBAR WB_BUTTONSTYLE | WB_BOTTOMBORDER
--------------------------------------------------------------------------
ItemBits
HIB_LEFT Inhalt wird im Item linksbuendig ausgegeben
HIB_CENTER Inhalt wird im Item zentriert ausgegeben
HIB_RIGHT Inhalt wird im Item rechtsbuendig ausgegeben
HIB_TOP Inhalt wird im Item an der oberen Kante ausgegeben
HIB_VCENTER Inhalt wird im Item vertikal zentiert ausgegeben
HIB_BOTTOM Inhalt wird im Item an der unteren Kante ausgegeben
HIB_LEFTIMAGE Bei Text und Image, wird Image links vom Text ausgegeben
HIB_RIGHTIMAGE Bei Text und Image, wird Image rechts vom Text ausgegeben
HIB_FIXED Item laesst sich nicht in der Groesse aendern
HIB_FIXEDPOS Item laesst sich nicht verschieben
HIB_CLICKABLE Item laesst sich anklicken
(Select-Handler wird erst bei MouseButtonUp gerufen)
HIB_FLAT Item wird flach dargestellt, auch wenn WB_BUTTONSTYLE gesetzt ist
HIB_DOWNARROW Es wird ein Pfeil nach unter hinter dem Text ausgegeben,
welcher zum Beispiel angezeigt werden sollte, wenn nach
diesem Item eine dazugehoerende Liste absteigend sortiert
ist. Der Status des Pfeils kann mit SetItemBits()
gesetzt/zurueckgesetzt werden.
HIB_UPARROW Es wird ein Pfeil nach oben hinter dem Text ausgegeben,
welcher zum Beispiel angezeigt werden sollte, wenn nach
diesem Item eine dazugehoerende Liste aufsteigend sortiert
ist.Der Status des Pfeils kann mit SetItemBits()
gesetzt/zurueckgesetzt werden.
HIB_USERDRAW Zu diesem Item wird auch der UserDraw-Handler gerufen.
HIB_STDSTYLE (HIB_LEFT | HIB_LEFTIMAGE | HIB_VCENTER | HIB_CLICKABLE)
--------------------------------------------------------------------------
Handler
Select() Wird gerufen, wenn Item angeklickt wird. Wenn
HIB_CLICKABLE beim Item gesetzt ist und nicht HIB_FLAT,
wird der Handler erst im MouseButtonUp-Handler gerufen,
wenn die Maus ueber dem Item losgelassen wurde. Dann
verhaellt sich der Select-Handler wie bei einem
ToolBox-Button.
DoubleClick() Dieser Handler wird gerufen, wenn ein Item
doppelt geklickt wird. Ob das Item oder der
Trenner angeklickt wurden, kann mit IsItemMode()
abgefragt werden. Wenn ein Trenner doppelt angeklickt
wird, sollte normalerweise die optimale Spaltenbreite
berechnet werden und diese gesetzt werden.
StartDrag() Dieser Handler wird gerufen, wenn Draggen gestartet
wird, bzw. wenn ein Item angeklickt wurde.
In diesem Handler sollte spaetestens mit SetDragSize()
die Groesse der Size-Linie gesetzt werden, wenn
IsItemMode() FALSE zurueckliefert.
Drag() Dieser Handler wird gerufen, wenn gedraggt wird. Wenn
mit SetDragSize() keine Groesse gesetzt wird, kann
dieser Handler dafuer benutzt werden, um die
Linie im angrenzenden Fenster selber zu zeichnen. Mit
GetDragPos() kann die aktuelle Drag-Position abgefragt
werden. Mit IsItemMode() sollte in diesem Fall
abgefragt werden, ob auch ein Trenner gedraggt wird.
EndDrag() Dieser Handler wird gerufen, wenn ein Drag-Vorgang
beendet wurde. Wenn im EndDrag-Handler GetCurItemId()
0 zurueckliefert, wurde der Drag-Vorgang abgebrochen.
Wenn dies nicht der Fall ist und IsItemMode() FALSE
zurueckliefert, sollte von dem gedraggten Item
die neue Groesse mit GetItemSize() abgefragt werden
und entsprechend im dazugehoerigem Control uebernommen
werden. Wenn IsItemMode() TRUE, GetCurItemId() eine Id
und IsItemDrag() TRUE zurueckliefert, wurde dieses
Item verschoben. Es sollte dann mit GetItemPos() die
neue Position abgefragt werden und auch die Daten
im dazugehoerigem Control angepasst werden. Ansonsten
koennte auch mit GetItemDragPos() die Position abgefragt
werden, an welche Stelle das Item verschoben wurde.
Weitere Methoden, die fuer die Handler wichtig sind.
GetCurItemId() Liefert die Id vom Item zurueck, fuer welches gerade
der Handler gerufen wurde. Liefert nur eine gueltige
Id in den Handlern Select(), DoubleClick(), StartDrag(),
Drag() und EndDrag(). Im EndDrag-Handler leifert
diese Methode die Id vom gedraggten Item zurueck oder
0, wenn der Drag-Vorgang abgebrochen wurde.
GetItemDragPos() Liefert die Position zurueck, an der ein Item verschoben
wird bzw. wurde. HEADERBAR_ITEM_NOTFOUND wird
zurueckgeliefert, wenn der Vorgang abgebrochen wurde
oder wenn kein ItemDrag aktiv ist.
IsItemMode() Mit dieser Methode kann abgefragt werden, ob fuer ein
Item oder einen Trenner der Handler gerufen wurde.
TRUE - Handler wurde fuer das Item gerufen
FALSE - Handler wurde fuer den Trenner gerufen
IsItemDrag() Mit dieser Methode kann abgefragt werden, ob ein
Item gedragt oder selektiert wurde.
TRUE - Item wird verschoben
FALSE - Item wird selektiert
SetDragSize() Mit dieser Methode wird gesetzt, wir gross der
Trennstrich sein soll, der vom Control gemalt wird.
Dies sollte so gross sein, wie das angrenzende Fenster
hoch ist. Die Hoehe vom HeaderBar wird automatisch
dazugerechnet.
--------------------------------------------------------------------------
Weitere Methoden
SetOffset() Mit dieser Methode wird der Offset gesetzt, ab dem
die Items ausgegeben werden. Dies wird benoetigt,
wenn das dazugehoerige Fenster gescrollt wird.
CalcWindowSizePixel() Mit dieser Methode kann man die Hoehe des Fensters
berechnen, damit der Inhalt der Items ausgegeben
werden kann.
--------------------------------------------------------------------------
Tips und Tricks:
1) KontextMenu
Wenn ein kontextsensitives PopupMenu anzeigt werden soll, muss der
Command-Handler ueberlagert werden. Mit GetItemId() und bei
Uebergabe der Mausposition kann ermittelt werden, ob der Mausclick
ueber einem bzw. ueber welchem Item durchgefuehrt wurde.
2) Letztes Item
Wenn man ButtonStyle gesetzt hat, sieht es besser aus, wenn man am
Ende noch ein leeres Item setzt, was den restlichen Platz einnimmt.
Dazu fuegt man ein Item mit einem leeren String ein und uebergibt als
Groesse HEADERBAR_FULLSIZE. Bei diesem Item sollte man dann auch
nicht HIB_CLICKABLE setzen und dafuer HIB_FIXEDPOS.
*************************************************************************/
class Accelerator;
class ImplHeadItem;
typedef ::std::vector< ImplHeadItem* > ImplHeadItemList;
// -----------
// - WinBits -
// -----------
#define WB_BOTTOMBORDER ((WinBits)0x0400)
#define WB_BUTTONSTYLE ((WinBits)0x0800)
#define WB_STDHEADERBAR (WB_BUTTONSTYLE | WB_BOTTOMBORDER)
// ---------------------
// - HeaderBarItemBits -
// ---------------------
typedef USHORT HeaderBarItemBits;
// ----------------------------
// - Bits fuer HeaderBarItems -
// ----------------------------
#define HIB_LEFT ((HeaderBarItemBits)0x0001)
#define HIB_CENTER ((HeaderBarItemBits)0x0002)
#define HIB_RIGHT ((HeaderBarItemBits)0x0004)
#define HIB_TOP ((HeaderBarItemBits)0x0008)
#define HIB_VCENTER ((HeaderBarItemBits)0x0010)
#define HIB_BOTTOM ((HeaderBarItemBits)0x0020)
#define HIB_LEFTIMAGE ((HeaderBarItemBits)0x0040)
#define HIB_RIGHTIMAGE ((HeaderBarItemBits)0x0080)
#define HIB_FIXED ((HeaderBarItemBits)0x0100)
#define HIB_FIXEDPOS ((HeaderBarItemBits)0x0200)
#define HIB_CLICKABLE ((HeaderBarItemBits)0x0400)
#define HIB_FLAT ((HeaderBarItemBits)0x0800)
#define HIB_DOWNARROW ((HeaderBarItemBits)0x1000)
#define HIB_UPARROW ((HeaderBarItemBits)0x2000)
#define HIB_USERDRAW ((HeaderBarItemBits)0x4000)
#define HIB_STDSTYLE (HIB_LEFT | HIB_LEFTIMAGE | HIB_VCENTER | HIB_CLICKABLE)
// -------------------
// - HeaderBar-Types -
// -------------------
#define HEADERBAR_APPEND ((USHORT)0xFFFF)
#define HEADERBAR_ITEM_NOTFOUND ((USHORT)0xFFFF)
#define HEADERBAR_FULLSIZE ((long)1000000000)
#define HEADERBAR_TEXTOFF 2
// -------------
// - HeaderBar -
// -------------
class SVT_DLLPUBLIC HeaderBar : public Window
{
private:
ImplHeadItemList* mpItemList;
long mnBorderOff1;
long mnBorderOff2;
long mnOffset;
long mnDX;
long mnDY;
long mnDragSize;
long mnStartPos;
long mnDragPos;
long mnMouseOff;
USHORT mnCurItemId;
USHORT mnItemDragPos;
BOOL mbDragable;
BOOL mbDrag;
BOOL mbItemDrag;
BOOL mbOutDrag;
BOOL mbButtonStyle;
BOOL mbItemMode;
Link maStartDragHdl;
Link maDragHdl;
Link maEndDragHdl;
Link maSelectHdl;
Link maDoubleClickHdl;
Link maCreateAccessibleHdl;
::com::sun::star::uno::Reference<
::com::sun::star::accessibility::XAccessible >
mxAccessible;
#ifdef _SV_HEADBAR_CXX
using Window::ImplInit;
SVT_DLLPRIVATE void ImplInit( WinBits nWinStyle );
SVT_DLLPRIVATE void ImplInitSettings( BOOL bFont, BOOL bForeground, BOOL bBackground );
SVT_DLLPRIVATE long ImplGetItemPos( USHORT nPos ) const;
SVT_DLLPRIVATE Rectangle ImplGetItemRect( USHORT nPos ) const;
using Window::ImplHitTest;
SVT_DLLPRIVATE USHORT ImplHitTest( const Point& rPos, long& nMouseOff, USHORT& nPos ) const;
SVT_DLLPRIVATE void ImplInvertDrag( USHORT nStartPos, USHORT nEndPos );
SVT_DLLPRIVATE void ImplDrawItem( OutputDevice* pDev,
USHORT nPos, BOOL bHigh, BOOL bDrag,
const Rectangle& rItemRect,
const Rectangle* pRect,
ULONG nFlags );
SVT_DLLPRIVATE void ImplDrawItem( USHORT nPos, BOOL bHigh = FALSE,
BOOL bDrag = FALSE,
const Rectangle* pRect = NULL );
SVT_DLLPRIVATE void ImplUpdate( USHORT nPos,
BOOL bEnd = FALSE, BOOL bDirect = FALSE );
SVT_DLLPRIVATE void ImplStartDrag( const Point& rPos, BOOL bCommand );
SVT_DLLPRIVATE void ImplDrag( const Point& rPos );
SVT_DLLPRIVATE void ImplEndDrag( BOOL bCancel );
#endif
public:
HeaderBar( Window* pParent, WinBits nWinBits = WB_STDHEADERBAR );
HeaderBar( Window* pParent, const ResId& rResId );
~HeaderBar();
virtual void MouseButtonDown( const MouseEvent& rMEvt );
virtual void MouseMove( const MouseEvent& rMEvt );
virtual void Tracking( const TrackingEvent& rTEvt );
virtual void Paint( const Rectangle& rRect );
virtual void Draw( OutputDevice* pDev, const Point& rPos, const Size& rSize, ULONG nFlags );
virtual void Resize();
virtual void Command( const CommandEvent& rCEvt );
virtual void RequestHelp( const HelpEvent& rHEvt );
virtual void StateChanged( StateChangedType nStateChange );
virtual void DataChanged( const DataChangedEvent& rDCEvt );
virtual void UserDraw( const UserDrawEvent& rUDEvt );
virtual void StartDrag();
virtual void Drag();
virtual void EndDrag();
virtual void Select();
virtual void DoubleClick();
void InsertItem( USHORT nItemId, const Image& rImage,
long nSize, HeaderBarItemBits nBits = HIB_STDSTYLE,
USHORT nPos = HEADERBAR_APPEND );
void InsertItem( USHORT nItemId, const XubString& rText,
long nSize, HeaderBarItemBits nBits = HIB_STDSTYLE,
USHORT nPos = HEADERBAR_APPEND );
void InsertItem( USHORT nItemId,
const Image& rImage, const XubString& rText,
long nSize, HeaderBarItemBits nBits = HIB_STDSTYLE,
USHORT nPos = HEADERBAR_APPEND );
void RemoveItem( USHORT nItemId );
void MoveItem( USHORT nItemId, USHORT nNewPos );
void Clear();
void SetOffset( long nNewOffset = 0 );
long GetOffset() const { return mnOffset; }
inline void SetDragSize( long nNewSize = 0 ) { mnDragSize = nNewSize; }
long GetDragSize() const { return mnDragSize; }
USHORT GetItemCount() const;
USHORT GetItemPos( USHORT nItemId ) const;
USHORT GetItemId( USHORT nPos ) const;
USHORT GetItemId( const Point& rPos ) const;
Rectangle GetItemRect( USHORT nItemId ) const;
USHORT GetCurItemId() const { return mnCurItemId; }
long GetDragPos() const { return mnDragPos; }
USHORT GetItemDragPos() const { return mnItemDragPos; }
BOOL IsItemMode() const { return mbItemMode; }
BOOL IsItemDrag() const { return mbItemDrag; }
void SetItemSize( USHORT nItemId, long nNewSize );
long GetItemSize( USHORT nItemId ) const;
void SetItemBits( USHORT nItemId, HeaderBarItemBits nNewBits );
HeaderBarItemBits GetItemBits( USHORT nItemId ) const;
void SetItemData( USHORT nItemId, void* pNewData );
void* GetItemData( USHORT nItemId ) const;
void SetItemImage( USHORT nItemId, const Image& rImage );
Image GetItemImage( USHORT nItemId ) const;
void SetItemText( USHORT nItemId, const XubString& rText );
XubString GetItemText( USHORT nItemId ) const;
void SetHelpText( USHORT nItemId, const XubString& rText );
XubString GetHelpText( USHORT nItemId ) const;
void SetHelpId( USHORT nItemId, ULONG nHelpId );
ULONG GetHelpId( USHORT nItemId ) const;
Size CalcWindowSizePixel() const;
inline void SetHelpText( const String& rText ) { Window::SetHelpText( rText ); }
inline const String& GetHelpText() const { return Window::GetHelpText(); }
inline void SetHelpId( ULONG nId ) { Window::SetHelpId( nId ); }
inline ULONG GetHelpId() const { return Window::GetHelpId(); }
inline void SetStartDragHdl( const Link& rLink ) { maStartDragHdl = rLink; }
inline const Link& GetStartDragHdl() const { return maStartDragHdl; }
inline void SetDragHdl( const Link& rLink ) { maDragHdl = rLink; }
inline const Link& GetDragHdl() const { return maDragHdl; }
inline void SetEndDragHdl( const Link& rLink ) { maEndDragHdl = rLink; }
inline const Link& GetEndDragHdl() const { return maEndDragHdl; }
inline void SetSelectHdl( const Link& rLink ) { maSelectHdl = rLink; }
inline const Link& GetSelectHdl() const { return maSelectHdl; }
inline void SetDoubleClickHdl( const Link& rLink ) { maDoubleClickHdl = rLink; }
inline const Link& GetDoubleClickHdl() const { return maDoubleClickHdl; }
inline void SetCreateAccessibleHdl( const Link& rLink ) { maCreateAccessibleHdl = rLink; }
inline const Link& GetCreateAccessibleHdl() const { return maCreateAccessibleHdl; }
inline BOOL IsDragable() const { return mbDragable; }
/** Creates and returns the accessible object of the header bar. */
virtual ::com::sun::star::uno::Reference<
::com::sun::star::accessibility::XAccessible > CreateAccessible();
void SetAccessible( ::com::sun::star::uno::Reference< ::com::sun::star::accessibility::XAccessible > );
};
#endif // _HEADBAR_HXX
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
