summaryrefslogtreecommitdiff
path: root/svtools/inc/ivctrl.hxx
blob: 73b7dd3fa90ab3a517520107f7115a1c984597ca (plain)
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
/* -*- 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 _ICNVW_HXX
#define _ICNVW_HXX

#include "svtools/svtdllapi.h"
#include <tools/string.hxx>
#include <vcl/ctrl.hxx>
#include <tools/link.hxx>
#include <vcl/image.hxx>
#include <vcl/seleng.hxx>

class SvPtrarr;
class ResId;
class Point;
class SvxIconChoiceCtrl_Impl;
class Image;

#define ICNVIEW_FLAG_POS_LOCKED		0x0001
#define ICNVIEW_FLAG_SELECTED		0x0002
#define ICNVIEW_FLAG_FOCUSED		0x0004
#define ICNVIEW_FLAG_IN_USE			0x0008
#define ICNVIEW_FLAG_CURSORED	   	0x0010 // Rahmen um Image
#define ICNVIEW_FLAG_POS_MOVED   	0x0020 // per D&D verschoben aber nicht gelockt
#define ICNVIEW_FLAG_DROP_TARGET	0x0040 // im QueryDrop gesetzt
#define ICNVIEW_FLAG_BLOCK_EMPHASIS	0x0080 // Emphasis nicht painten
#define ICNVIEW_FLAG_USER1			0x0100
#define ICNVIEW_FLAG_USER2			0x0200
#define ICNVIEW_FLAG_PRED_SET		0x0400 // Predecessor wurde umgesetzt

enum SvxIconChoiceCtrlTextMode
{
    IcnShowTextFull = 1,		// BoundRect nach unten aufplustern
    IcnShowTextShort,      		// Abkuerzung mit "..."
    IcnShowTextSmart,			// Text komplett anzeigen, wenn moeglich (n.i.)
    IcnShowTextDontKnow			// Einstellung der View
};

enum SvxIconChoiceCtrlPositionMode
{
    IcnViewPositionModeFree = 0,			    // freies pixelgenaues Positionieren
    IcnViewPositionModeAutoArrange = 1,         // automatisches Ausrichten
    IcnViewPositionModeAutoAdjust = 2,   		// automatisches Anordnen
    IcnViewPositionModeLast = IcnViewPositionModeAutoAdjust
};

class SvxIconChoiceCtrlEntry
{
    Image aImage;
    Image aImageHC;

    String aText;
    String aQuickHelpText;
    void*  pUserData;

    friend class SvxIconChoiceCtrl_Impl;
    friend class IcnCursor_Impl;
    friend class EntryList_Impl;
    friend class IcnGridMap_Impl;

    Rectangle 				aRect;				// Bounding-Rect des Entries
    Rectangle 				aGridRect;			// nur gesetzt im Grid-Modus
    ULONG					nPos;

    // die Eintragsposition in der Eintragsliste entspricht der beim Insert vorgegebenen
    // [Sortier-]Reihenfolge (->Reihenfolge der Anker in der Ankerliste!). Im AutoArrange-Modus
    // kann die sichtbare Reihenfolge aber anders sein. Die Eintraege werden deshalb dann
    // verkettet
    SvxIconChoiceCtrlEntry*			pblink;		// backward (linker Nachbar)
    SvxIconChoiceCtrlEntry*			pflink;     // forward  (rechter Nachbar)

    SvxIconChoiceCtrlTextMode 		eTextMode;
    USHORT 					nX,nY;		// fuer Tastatursteuerung
    USHORT					nFlags;

    void					ClearFlags( USHORT nMask ) { nFlags &= (~nMask); }
    void					SetFlags( USHORT nMask ) { nFlags |= nMask; }
    void					AssignFlags( USHORT _nFlags ) { nFlags = _nFlags; }

    // setzt den linken Nachbarn (A <-> B  ==>  A <-> this <-> B)
    void					SetBacklink( SvxIconChoiceCtrlEntry* pA )
                            {
                                pA->pflink->pblink = this;  	// X <- B
                                this->pflink = pA->pflink; 		// X -> B
                                this->pblink = pA;  			// A <- X
                                pA->pflink = this;  			// A -> X
                            }
    // loest eine Verbindung (A <-> this <-> B  ==>  A <-> B)
    void					Unlink()
                            {
                                this->pblink->pflink = this->pflink;
                                this->pflink->pblink = this->pblink;
                                this->pflink = 0;
                                this->pblink = 0;
                            }

public:
                            SvxIconChoiceCtrlEntry( USHORT nFlags = 0 );
                            SvxIconChoiceCtrlEntry( const String& rText, const Image& rImage, USHORT nFlags = 0 );
                            SvxIconChoiceCtrlEntry( const String& rText, const Image& rImage, const Image& rImageHC, USHORT nFlags = 0 );
                            ~SvxIconChoiceCtrlEntry () {}

    void					SetImage ( const Image& rImage ) { aImage = rImage; }
    void					SetImageHC ( const Image& rImage ) { aImageHC = rImage; }
    Image					GetImage () const { return aImage; }
    Image					GetImageHC () const { return aImageHC; }
    void					SetText ( const String& rText ) { aText = rText; }
    String					GetText () const { return aText; }
    String SVT_DLLPUBLIC                    GetDisplayText() const;
    void					SetQuickHelpText( const String& rText ) { aQuickHelpText = rText; }
    String					GetQuickHelpText() const { return aQuickHelpText; }
    void					SetUserData ( void* _pUserData ) { pUserData = _pUserData; }
    void*					GetUserData () { return pUserData; }

    const Rectangle &       GetBoundRect() const { return aRect; }

    void					SetFocus ( BOOL bSet )
                                     { nFlags = ( bSet ? nFlags | ICNVIEW_FLAG_FOCUSED : nFlags & ~ICNVIEW_FLAG_FOCUSED ); }

    SvxIconChoiceCtrlTextMode 		GetTextMode() const { return eTextMode; }
    USHORT					GetFlags() const { return nFlags; }
    BOOL					IsSelected() const { return (BOOL)((nFlags & ICNVIEW_FLAG_SELECTED) !=0); }
    BOOL					IsFocused() const { return (BOOL)((nFlags & ICNVIEW_FLAG_FOCUSED) !=0); }
    BOOL					IsInUse() const { return (BOOL)((nFlags & ICNVIEW_FLAG_IN_USE) !=0); }
    BOOL					IsCursored() const { return (BOOL)((nFlags & ICNVIEW_FLAG_CURSORED) !=0); }
    BOOL					IsDropTarget() const { return (BOOL)((nFlags & ICNVIEW_FLAG_DROP_TARGET) !=0); }
    BOOL					IsBlockingEmphasis() const { return (BOOL)((nFlags & ICNVIEW_FLAG_BLOCK_EMPHASIS) !=0); }
    BOOL					WasMoved() const { return (BOOL)((nFlags & ICNVIEW_FLAG_POS_MOVED) !=0); }
    void					SetMoved( BOOL bMoved );
    BOOL					IsPosLocked() const { return (BOOL)((nFlags & ICNVIEW_FLAG_POS_LOCKED) !=0); }
    void					LockPos( BOOL bLock );
    // Nur bei AutoArrange gesetzt. Den Kopf der Liste gibts per SvxIconChoiceCtrl::GetPredecessorHead
    SvxIconChoiceCtrlEntry*			GetSuccessor() const { return pflink; }
    SvxIconChoiceCtrlEntry*			GetPredecessor() const { return pblink; }

//	sal_Unicode				GetMnemonicChar() const;
};

enum SvxIconChoiceCtrlColumnAlign
{
    IcnViewAlignLeft = 1,
    IcnViewAlignRight,
    IcnViewAlignCenter
};

class SvxIconChoiceCtrlColumnInfo
{
    String					aColText;
    Image					aColImage;
    long					nWidth;
    SvxIconChoiceCtrlColumnAlign	eAlignment;
    USHORT 					nSubItem;

public:
                            SvxIconChoiceCtrlColumnInfo( USHORT nSub, long nWd,
                                SvxIconChoiceCtrlColumnAlign eAlign ) :
                                nWidth( nWd ), eAlignment( eAlign ), nSubItem( nSub ) {}
                            SvxIconChoiceCtrlColumnInfo( const SvxIconChoiceCtrlColumnInfo& );

    void					SetText( const String& rText ) { aColText = rText; }
    void					SetImage( const Image& rImg ) { aColImage = rImg; }
    void					SetWidth( long nWd ) { nWidth = nWd; }
    void					SetAlignment( SvxIconChoiceCtrlColumnAlign eAlign ) { eAlignment = eAlign; }
    void					SetSubItem( USHORT nSub) { nSubItem = nSub; }

    const String& 			GetText() const { return aColText; }
    const Image&			GetImage() const { return aColImage; }
    long					GetWidth() const { return nWidth; }
    SvxIconChoiceCtrlColumnAlign	GetAlignment() const { return eAlignment; }
    USHORT					GetSubItem() const { return nSubItem; }
};

//###################################################################################################################################
/*
    Window-Bits:
        WB_ICON				// Text unter dem Icon
        WB_SMALL_ICON		// Text rechts neben Icon, beliebige Positionierung
        WB_DETAILS			// Text rechts neben Icon, eingeschraenkte Posit.
        WB_BORDER
        WB_NOHIDESELECTION	// Selektion inaktiv zeichnen, wenn kein Fokus
        WB_NOHSCROLL
        WB_NOVSCROLL
        WB_NOSELECTION
        WB_SMART_ARRANGE 	// im Arrange die Vis-Area beibehalten
        WB_ALIGN_TOP		// Anordnung zeilenweise von links nach rechts
        WB_ALIGN_LEFT 		// Anordnung spaltenweise von oben nach unten
        WB_NODRAGSELECTION	// Keine Selektion per Tracking-Rect
        WB_NOCOLUMNHEADER	// keine Headerbar in Detailsview (Headerbar not implemented)
        WB_NOPOINTERFOCUS	// Kein GrabFocus im MouseButtonDown
        WB_HIGHLIGHTFRAME	// der unter der Maus befindliche Eintrag wird hervorgehoben
        WB_NOASYNCSELECTHDL	// Selektionshandler synchron aufrufen, d.h. Events nicht sammeln
*/

#define WB_ICON					WB_RECTSTYLE
#define WB_SMALLICON       		WB_SMALLSTYLE
#define WB_DETAILS				WB_VCENTER
#define WB_NOHSCROLL			WB_SPIN
#define WB_NOVSCROLL			WB_DRAG
#define WB_NOSELECTION			WB_REPEAT
#define WB_NODRAGSELECTION		WB_PATHELLIPSIS
#define WB_SMART_ARRANGE		WB_PASSWORD
#define WB_ALIGN_TOP			WB_TOP
#define WB_ALIGN_LEFT			WB_LEFT
#define WB_NOCOLUMNHEADER		WB_CENTER
#define WB_HIGHLIGHTFRAME		WB_INFO
#define WB_NOASYNCSELECTHDL		WB_NOLABEL

class MnemonicGenerator;

class SVT_DLLPUBLIC SvtIconChoiceCtrl : public Control
{
    friend class SvxIconChoiceCtrl_Impl;

    Link					_aClickIconHdl;
    Link					_aDocRectChangedHdl;
    Link					_aVisRectChangedHdl;
    KeyEvent*				_pCurKeyEvent;
    SvxIconChoiceCtrl_Impl*	_pImp;
    BOOL					_bAutoFontColor;

protected:

    virtual void    	KeyInput( const KeyEvent& rKEvt );
    virtual BOOL		EditedEntry( SvxIconChoiceCtrlEntry*, const XubString& rNewText, BOOL bCancelled );
    virtual void		DocumentRectChanged();
    virtual void		VisibleRectChanged();
    virtual BOOL		EditingEntry( SvxIconChoiceCtrlEntry* pEntry );
    virtual void    	Command( const CommandEvent& rCEvt );
    virtual void    	Paint( const Rectangle& rRect );
    virtual void    	MouseButtonDown( const MouseEvent& rMEvt );
    virtual void    	MouseButtonUp( const MouseEvent& rMEvt );
    virtual void    	MouseMove( const MouseEvent& rMEvt );
    virtual void    	Resize();
    virtual void    	GetFocus();
    virtual void    	LoseFocus();
    virtual void		ClickIcon();
    virtual void 		StateChanged( StateChangedType nType );
    virtual void 		DataChanged( const DataChangedEvent& rDCEvt );
    virtual void		RequestHelp( const HelpEvent& rHEvt );
    virtual void		DrawEntryImage(
                            SvxIconChoiceCtrlEntry* pEntry,
                            const Point& rPos,
                            OutputDevice& rDev );

    virtual String		GetEntryText(
                            SvxIconChoiceCtrlEntry* pEntry,
                            BOOL bInplaceEdit );

    virtual void		FillLayoutData() const;

    void				CallImplEventListeners(ULONG nEvent, void* pData);

public:

                        SvtIconChoiceCtrl( Window* pParent, WinBits nWinStyle = WB_ICON | WB_BORDER );
                        SvtIconChoiceCtrl( Window* pParent, const ResId& rResId );
    virtual 			~SvtIconChoiceCtrl();

    void				SetStyle( WinBits nWinStyle );
    WinBits				GetStyle() const;

    BOOL				SetChoiceWithCursor ( BOOL bDo = TRUE );

    void 				SetUpdateMode( BOOL bUpdateMode );
    void				SetFont( const Font& rFont );
    void				SetPointFont( const Font& rFont );

    void            	SetClickHdl( const Link& rLink ) { _aClickIconHdl = rLink; }
    const Link&     	GetClickHdl() const { return _aClickIconHdl; }

    using OutputDevice::SetBackground;
    void				SetBackground( const Wallpaper& rWallpaper );

    void				ArrangeIcons();


    SvxIconChoiceCtrlEntry*	InsertEntry( ULONG nPos = LIST_APPEND,
                                     const Point* pPos = 0,
                                     USHORT nFlags = 0 );
    SvxIconChoiceCtrlEntry*	InsertEntry( const String& rText, const Image& rImage,
                                     ULONG nPos = LIST_APPEND,
                                     const Point* pPos = 0,
                                     USHORT nFlags = 0 );
    SvxIconChoiceCtrlEntry*	InsertEntry( const String& rText, const Image& rImage, const Image& rImageHC,
                                     ULONG nPos = LIST_APPEND,
                                     const Point* pPos = 0,
                                     USHORT nFlags = 0 );

    /** creates automatic mnemonics for all icon texts in the control
    */
    void				CreateAutoMnemonics( void );

    /** creates automatic mnemonics for all icon texts in the control

    @param _rUsedMnemonics
        a <type>MnemonicGenerator</type> at which some other mnemonics are already registered.
        This can be used if the control needs to share the "mnemonic space" with other elements,
        such as a menu bar.
    */
    void				CreateAutoMnemonics( MnemonicGenerator& _rUsedMnemonics );

    void				RemoveEntry( SvxIconChoiceCtrlEntry* pEntry );

    BOOL				DoKeyInput( const KeyEvent& rKEvt );

    BOOL				IsEntryEditing() const;
    void				Clear();

    ULONG					GetEntryCount() const;
    SvxIconChoiceCtrlEntry*	GetEntry( ULONG nPos ) const;
    ULONG					GetEntryListPos( SvxIconChoiceCtrlEntry* pEntry ) const;
    using Window::SetCursor;
    void					SetCursor( SvxIconChoiceCtrlEntry* pEntry );
    SvxIconChoiceCtrlEntry*	GetCursor() const;

    // Neu-Berechnung gecachter View-Daten und Invalidierung im Fenster
    void					InvalidateEntry( SvxIconChoiceCtrlEntry* pEntry );

    // bHit==FALSE: Eintrag gilt als getroffen, wenn Position im BoundRect liegt
    //     ==TRUE : Bitmap oder Text muss getroffen sein
    SvxIconChoiceCtrlEntry*	GetEntry( const Point& rPosPixel, BOOL bHit = FALSE ) const;
    // Gibt den naechsten ueber pCurEntry liegenden Eintrag (ZOrder)
    SvxIconChoiceCtrlEntry*	GetNextEntry( const Point& rPosPixel, SvxIconChoiceCtrlEntry* pCurEntry, BOOL  ) const;
    // Gibt den naechsten unter pCurEntry liegenden Eintrag (ZOrder)
    SvxIconChoiceCtrlEntry*	GetPrevEntry( const Point& rPosPixel, SvxIconChoiceCtrlEntry* pCurEntry, BOOL  ) const;

    // in dem ULONG wird die Position in der Liste des gefunden Eintrags zurueckgegeben
    SvxIconChoiceCtrlEntry*	GetSelectedEntry( ULONG& rPos ) const;

    void						SetEntryTextMode( SvxIconChoiceCtrlTextMode eMode, SvxIconChoiceCtrlEntry* pEntry = 0 );
    SvxIconChoiceCtrlTextMode	GetEntryTextMode( const SvxIconChoiceCtrlEntry* pEntry = 0 ) const;

    // offene asynchron abzuarbeitende Aktionen ausfuehren. Muss vor dem Speichern von
    // Eintragspositionen etc. gerufen werden
    void				Flush();


    virtual BOOL		HasBackground() const;
    virtual BOOL		HasFont() const;
    virtual BOOL		HasFontTextColor() const;
    virtual BOOL		HasFontFillColor() const;

    void				SetFontColorToBackground ( BOOL bDo = TRUE ) { _bAutoFontColor = bDo; }
    BOOL				AutoFontColor () { return _bAutoFontColor; }

    Point				GetLogicPos( const Point& rPosPixel ) const;
    Point		   		GetPixelPos( const Point& rPosLogic ) const;
    void				SetSelectionMode( SelectionMode eMode );

    BOOL				HandleShortCutKey( const KeyEvent& rKeyEvent );

    Rectangle			GetBoundingBox( SvxIconChoiceCtrlEntry* pEntry ) const;
    Rectangle			GetEntryCharacterBounds( const sal_Int32 _nEntryPos, const sal_Int32 _nCharacterIndex ) const;

    void				SetNoSelection();

    // ACCESSIBILITY ==========================================================

    /** Creates and returns the accessible object of the Box. */
    virtual ::com::sun::star::uno::Reference<
        ::com::sun::star::accessibility::XAccessible > CreateAccessible();
};

#endif // _ICNVW_HXX

/* vim:set shiftwidth=4 softtabstop=4 expandtab: */