1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Generic list control
4 // Author: Robert Roebling
7 // Copyright: (c) 1998 Robert Roebling, Julian Smart and Markus Holzem
8 // Licence: wxWindows licence
9 /////////////////////////////////////////////////////////////////////////////
11 #ifndef __LISTCTRLH_G__
12 #define __LISTCTRLH_G__
15 #pragma interface "listctrl.h"
19 #include "wx/object.h"
20 #include "wx/generic/imaglist.h"
21 #include "wx/control.h"
23 #include "wx/textctrl.h"
24 #include "wx/dcclient.h"
25 #include "wx/scrolwin.h"
26 #include "wx/settings.h"
28 #if wxUSE_DRAG_AND_DROP
29 class WXDLLEXPORT wxDropTarget
;
32 //-----------------------------------------------------------------------------
34 //-----------------------------------------------------------------------------
36 class WXDLLEXPORT wxListItem
;
37 class WXDLLEXPORT wxListEvent
;
38 class WXDLLEXPORT wxListCtrl
;
40 //-----------------------------------------------------------------------------
42 //-----------------------------------------------------------------------------
44 class WXDLLEXPORT wxListHeaderData
;
45 class WXDLLEXPORT wxListItemData
;
46 class WXDLLEXPORT wxListLineData
;
48 class WXDLLEXPORT wxListHeaderWindow
;
49 class WXDLLEXPORT wxListMainWindow
;
51 class WXDLLEXPORT wxListRenameTimer
;
52 class WXDLLEXPORT wxListTextCtrl
;
54 //-----------------------------------------------------------------------------
56 //-----------------------------------------------------------------------------
58 // type of compare function for wxListCtrl sort operation
59 typedef int (*wxListCtrlCompare
)(long item1
, long item2
, long sortData
);
61 //-----------------------------------------------------------------------------
63 //-----------------------------------------------------------------------------
65 #define wxLC_ICON 0x0004
66 #define wxLC_SMALL_ICON 0x0008
67 #define wxLC_LIST 0x0010
68 #define wxLC_REPORT 0x0020
69 #define wxLC_ALIGN_TOP 0x0040
70 #define wxLC_ALIGN_LEFT 0x0080
71 #define wxLC_AUTOARRANGE 0x0100 // not supported in wxGLC
72 #define wxLC_USER_TEXT 0x0200 // not supported in wxGLC (how does it work?)
73 #define wxLC_EDIT_LABELS 0x0400
74 #define wxLC_NO_HEADER 0x0800
75 #define wxLC_NO_SORT_HEADER 0x1000 // not supported in wxGLC
76 #define wxLC_SINGLE_SEL 0x2000
77 #define wxLC_SORT_ASCENDING 0x4000
78 #define wxLC_SORT_DESCENDING 0x8000 // not supported in wxGLC
80 #define wxLC_MASK_TYPE (wxLC_ICON | wxLC_SMALL_ICON | wxLC_LIST | wxLC_REPORT)
81 #define wxLC_MASK_ALIGN (wxLC_ALIGN_TOP | wxLC_ALIGN_LEFT)
82 #define wxLC_MASK_SORT (wxLC_SORT_ASCENDING | wxLC_SORT_DESCENDING)
84 // Omitted because (a) too much detail (b) not enough style flags
85 // #define wxLC_NO_SCROLL
86 // #define wxLC_NO_LABEL_WRAP
87 // #define wxLC_OWNERDRAW_FIXED
88 // #define wxLC_SHOW_SEL_ALWAYS
90 // Mask flags to tell app/GUI what fields of wxListItem are valid
91 #define wxLIST_MASK_STATE 0x0001
92 #define wxLIST_MASK_TEXT 0x0002
93 #define wxLIST_MASK_IMAGE 0x0004
94 #define wxLIST_MASK_DATA 0x0008
95 #define wxLIST_SET_ITEM 0x0010
96 #define wxLIST_MASK_WIDTH 0x0020
97 #define wxLIST_MASK_FORMAT 0x0040
99 // State flags for indicating the state of an item
100 #define wxLIST_STATE_DONTCARE 0x0000
101 #define wxLIST_STATE_DROPHILITED 0x0001 // not supported in wxGLC
102 #define wxLIST_STATE_FOCUSED 0x0002
103 #define wxLIST_STATE_SELECTED 0x0004
104 #define wxLIST_STATE_CUT 0x0008 // not supported in wxGLC
106 // Hit test flags, used in HitTest // wxGLC suppots 20 and 80
107 #define wxLIST_HITTEST_ABOVE 0x0001 // Above the client area.
108 #define wxLIST_HITTEST_BELOW 0x0002 // Below the client area.
109 #define wxLIST_HITTEST_NOWHERE 0x0004 // In the client area but below the last item.
110 #define wxLIST_HITTEST_ONITEMICON 0x0020 // On the bitmap associated with an item.
111 #define wxLIST_HITTEST_ONITEMLABEL 0x0080 // On the label (string) associated with an item.
112 #define wxLIST_HITTEST_ONITEMRIGHT 0x0100 // In the area to the right of an item.
113 #define wxLIST_HITTEST_ONITEMSTATEICON 0x0200 // On the state icon for a tree view item that is in a user-defined state.
114 #define wxLIST_HITTEST_TOLEFT 0x0400 // To the right of the client area.
115 #define wxLIST_HITTEST_TORIGHT 0x0800 // To the left of the client area.
117 #define wxLIST_HITTEST_ONITEM (wxLIST_HITTEST_ONITEMICON | wxLIST_HITTEST_ONITEMLABEL | wxLIST_HITTEST_ONITEMSTATEICON)
121 // Flags for GetNextItem // always wxLIST_NEXT_ALL in wxGLC
123 wxLIST_NEXT_ABOVE
, // Searches for an item above the specified item
124 wxLIST_NEXT_ALL
, // Searches for subsequent item by index
125 wxLIST_NEXT_BELOW
, // Searches for an item below the specified item
126 wxLIST_NEXT_LEFT
, // Searches for an item to the left of the specified item
127 wxLIST_NEXT_RIGHT
// Searches for an item to the right of the specified item
130 // Alignment flags for Arrange // always wxLIST_ALIGN_LEFT in wxGLC
132 wxLIST_ALIGN_DEFAULT
,
135 wxLIST_ALIGN_SNAP_TO_GRID
138 // Column format // always wxLIST_FORMAT_LEFT in wxGLC
142 wxLIST_FORMAT_CENTRE
,
143 wxLIST_FORMAT_CENTER
= wxLIST_FORMAT_CENTRE
146 // Autosize values for SetColumnWidth
148 wxLIST_AUTOSIZE
= -1, // width of longest item
149 wxLIST_AUTOSIZE_USEHEADER
= -2 // always 80 in wxGLC
152 // Flag values for GetItemRect
159 // Flag values for FindItem // not supported by wxGLC
167 //-----------------------------------------------------------------------------
169 //-----------------------------------------------------------------------------
171 class WXDLLEXPORT wxListItem
: public wxObject
173 DECLARE_DYNAMIC_CLASS(wxListItem
)
176 long m_mask
; // Indicates what fields are valid
177 long m_itemId
; // The zero-based item position
178 int m_col
; // Zero-based column, if in report mode
179 long m_state
; // The state of the item
180 long m_stateMask
; // Which flags of m_state are valid (uses same flags)
181 wxString m_text
; // The label/header text
182 int m_image
; // The zero-based index into an image list
183 long m_data
; // App-defined data
184 wxColour
*m_colour
; // only wxGLC, not supported by Windows ;->
187 int m_format
; // left, right, centre
188 int m_width
; // width of column
193 //-----------------------------------------------------------------------------
194 // wxListItemData (internal)
195 //-----------------------------------------------------------------------------
197 class WXDLLEXPORT wxListItemData
: public wxObject
204 int m_width
,m_height
;
209 wxListItemData( const wxListItem
&info
);
210 void SetItem( const wxListItem
&info
);
211 void SetText( const wxString
&s
);
212 void SetImage( int image
);
213 void SetData( long data
);
214 void SetPosition( int x
, int y
);
215 void SetSize( int width
, int height
);
216 void SetColour( wxColour
*col
);
217 bool HasImage() const;
218 bool HasText() const;
219 bool IsHit( int x
, int y
) const;
220 void GetText( wxString
&s
);
221 int GetX( void ) const;
222 int GetY( void ) const;
223 int GetWidth() const;
224 int GetHeight() const;
225 int GetImage() const;
226 void GetItem( wxListItem
&info
);
227 wxColour
*GetColour();
230 DECLARE_DYNAMIC_CLASS(wxListItemData
);
233 //-----------------------------------------------------------------------------
234 // wxListHeaderData (internal)
235 //-----------------------------------------------------------------------------
237 class WXDLLEXPORT wxListHeaderData
: public wxObject
239 DECLARE_DYNAMIC_CLASS(wxListHeaderData
);
252 wxListHeaderData( const wxListItem
&info
);
253 void SetItem( const wxListItem
&item
);
254 void SetPosition( int x
, int y
);
255 void SetWidth( int w
);
256 void SetFormat( int format
);
257 void SetHeight( int h
);
258 bool HasImage() const;
259 bool HasText() const;
260 bool IsHit( int x
, int y
) const;
261 void GetItem( wxListItem
&item
);
262 void GetText( wxString
&s
);
263 int GetImage() const;
264 int GetWidth() const;
265 int GetFormat() const;
268 //-----------------------------------------------------------------------------
269 // wxListLineData (internal)
270 //-----------------------------------------------------------------------------
272 class WXDLLEXPORT wxListLineData
: public wxObject
274 DECLARE_DYNAMIC_CLASS(wxListLineData
);
279 wxRect m_bound_label
;
281 wxRect m_bound_hilight
;
284 wxBrush
*m_hilightBrush
;
286 wxListMainWindow
*m_owner
;
288 void DoDraw( wxDC
*dc
, bool hilight
, bool paintBG
);
292 wxListLineData( wxListMainWindow
*owner
, int mode
, wxBrush
*hilightBrush
);
293 void CalculateSize( wxDC
*dc
, int spacing
);
294 void SetPosition( wxDC
*dc
, int x
, int y
, int window_width
);
295 void SetColumnPosition( int index
, int x
);
296 void GetSize( int &width
, int &height
);
297 void GetExtent( int &x
, int &y
, int &width
, int &height
);
298 void GetLabelExtent( int &x
, int &y
, int &width
, int &height
);
299 long IsHit( int x
, int y
);
300 void InitItems( int num
);
301 void SetItem( int index
, const wxListItem
&info
);
302 void GetItem( int index
, wxListItem
&info
);
303 void GetText( int index
, wxString
&s
);
304 void SetText( int index
, const wxString s
);
305 int GetImage( int index
);
306 void GetRect( wxRect
&rect
);
307 void Hilight( bool on
);
308 void ReverseHilight();
309 void DrawRubberBand( wxDC
*dc
, bool on
);
310 void Draw( wxDC
*dc
);
311 bool IsInRect( int x
, int y
, const wxRect
&rect
);
313 void AssignRect( wxRect
&dest
, int x
, int y
, int width
, int height
);
314 void AssignRect( wxRect
&dest
, const wxRect
&source
);
317 //-----------------------------------------------------------------------------
318 // wxListHeaderWindow (internal)
319 //-----------------------------------------------------------------------------
321 class WXDLLEXPORT wxListHeaderWindow
: public wxWindow
323 DECLARE_DYNAMIC_CLASS(wxListHeaderWindow
)
326 wxListMainWindow
*m_owner
;
327 wxCursor
*m_currentCursor
;
328 wxCursor
*m_resizeCursor
;
335 wxListHeaderWindow();
336 ~wxListHeaderWindow();
337 wxListHeaderWindow( wxWindow
*win
, wxWindowID id
, wxListMainWindow
*owner
,
338 const wxPoint
&pos
= wxDefaultPosition
, const wxSize
&size
= wxDefaultSize
,
339 long style
= 0, const wxString
&name
= "columntitles" );
340 void DoDrawRect( wxDC
*dc
, int x
, int y
, int w
, int h
);
341 void OnPaint( wxPaintEvent
&event
);
343 void OnMouse( wxMouseEvent
&event
);
344 void OnSetFocus( wxFocusEvent
&event
);
346 DECLARE_EVENT_TABLE()
349 //-----------------------------------------------------------------------------
350 // wxListRenameTimer (internal)
351 //-----------------------------------------------------------------------------
353 class WXDLLEXPORT wxListRenameTimer
: public wxTimer
356 wxListMainWindow
*m_owner
;
359 wxListRenameTimer( wxListMainWindow
*owner
);
363 //-----------------------------------------------------------------------------
364 // wxListTextCtrl (internal)
365 //-----------------------------------------------------------------------------
367 class WXDLLEXPORT wxListTextCtrl
: public wxTextCtrl
369 DECLARE_DYNAMIC_CLASS(wxListTextCtrl
);
374 wxListMainWindow
*m_owner
;
375 wxString m_startValue
;
379 wxListTextCtrl( wxWindow
*parent
, const wxWindowID id
,
380 bool *accept
, wxString
*res
, wxListMainWindow
*owner
,
381 const wxString
&value
= "",
382 const wxPoint
&pos
= wxDefaultPosition
, const wxSize
&size
= wxDefaultSize
,
384 # if defined(__VISAGECPP__)
385 int style
= 0, const wxValidator
* validator
= wxDefaultValidator
,
387 int style
= 0, const wxValidator
& validator
= wxDefaultValidator
,
390 const wxString
&name
= "wxListTextCtrlText" );
391 void OnChar( wxKeyEvent
&event
);
392 void OnKillFocus( wxFocusEvent
&event
);
394 DECLARE_EVENT_TABLE()
397 //-----------------------------------------------------------------------------
398 // wxListMainWindow (internal)
399 //-----------------------------------------------------------------------------
401 class WXDLLEXPORT wxListMainWindow
: public wxScrolledWindow
403 DECLARE_DYNAMIC_CLASS(wxListMainWindow
);
409 wxListLineData
*m_current
;
410 wxListLineData
*m_currentEdit
;
412 wxBrush
*m_hilightBrush
;
413 wxColour
*m_hilightColour
;
414 int m_xScroll
,m_yScroll
;
416 wxImageList
*m_small_image_list
;
417 wxImageList
*m_normal_image_list
;
419 int m_normal_spacing
;
423 wxTimer
*m_renameTimer
;
425 wxString m_renameRes
;
432 wxListMainWindow( wxWindow
*parent
, wxWindowID id
,
433 const wxPoint
&pos
= wxDefaultPosition
, const wxSize
&size
= wxDefaultSize
,
434 long style
= 0, const wxString
&name
= "listctrl" );
436 void RefreshLine( wxListLineData
*line
);
437 void OnPaint( wxPaintEvent
&event
);
438 void HilightAll( bool on
);
439 void SendNotify( wxListLineData
*line
, wxEventType command
);
440 void FocusLine( wxListLineData
*line
);
441 void UnfocusLine( wxListLineData
*line
);
442 void SelectLine( wxListLineData
*line
);
443 void DeselectLine( wxListLineData
*line
);
444 void DeleteLine( wxListLineData
*line
);
446 void EditLabel( long item
);
447 void Edit( long item
) { EditLabel(item
); } // deprecated
448 void OnRenameTimer();
449 void OnRenameAccept();
451 void OnMouse( wxMouseEvent
&event
);
453 void OnArrowChar( wxListLineData
*newCurrent
, bool shiftDown
);
454 void OnChar( wxKeyEvent
&event
);
455 void OnKeyDown( wxKeyEvent
&event
);
456 void OnSetFocus( wxFocusEvent
&event
);
457 void OnKillFocus( wxFocusEvent
&event
);
458 void OnSize( wxSizeEvent
&event
);
459 void OnScroll(wxScrollWinEvent
& event
) ;
461 void DrawImage( int index
, wxDC
*dc
, int x
, int y
);
462 void GetImageSize( int index
, int &width
, int &height
);
463 int GetIndexOfLine( const wxListLineData
*line
);
464 int GetTextLength( wxString
&s
); // should be const
466 void SetImageList( wxImageList
*imageList
, int which
);
467 void SetItemSpacing( int spacing
, bool isSmall
= FALSE
);
468 int GetItemSpacing( bool isSmall
= FALSE
);
469 void SetColumn( int col
, wxListItem
&item
);
470 void SetColumnWidth( int col
, int width
);
471 void GetColumn( int col
, wxListItem
&item
);
472 int GetColumnWidth( int vol
);
473 int GetColumnCount();
474 int GetCountPerPage();
475 void SetItem( wxListItem
&item
);
476 void GetItem( wxListItem
&item
);
477 void SetItemState( long item
, long state
, long stateMask
);
478 int GetItemState( long item
, long stateMask
);
480 void GetItemRect( long index
, wxRect
&rect
);
481 bool GetItemPosition( long item
, wxPoint
& pos
);
482 int GetSelectedItemCount();
483 void SetMode( long mode
);
484 long GetMode() const;
485 void CalculatePositions();
486 void RealizeChanges();
487 long GetNextItem( long item
, int geometry
, int state
);
488 void DeleteItem( long index
);
489 void DeleteAllItems();
490 void DeleteColumn( int col
);
491 void DeleteEverything();
492 void EnsureVisible( long index
);
493 long FindItem( long start
, const wxString
& str
, bool partial
= FALSE
);
494 long FindItem( long start
, long data
);
495 long HitTest( int x
, int y
, int &flags
);
496 void InsertItem( wxListItem
&item
);
497 // void AddItem( wxListItem &item );
498 void InsertColumn( long col
, wxListItem
&item
);
499 // void AddColumn( wxListItem &item );
500 void SortItems( wxListCtrlCompare fn
, long data
);
502 DECLARE_EVENT_TABLE()
505 //-----------------------------------------------------------------------------
507 //-----------------------------------------------------------------------------
509 class WXDLLEXPORT wxListCtrl
: public wxControl
511 DECLARE_DYNAMIC_CLASS(wxListCtrl
);
515 wxListCtrl( wxWindow
*parent
, wxWindowID id
= -1,
516 const wxPoint
&pos
= wxDefaultPosition
, const wxSize
&size
= wxDefaultSize
,
518 # if defined(__VISAGECPP__)
519 long style
= wxLC_ICON
, const wxValidator
* validator
= wxDefaultValidator
,
521 long style
= wxLC_ICON
, const wxValidator
& validator
= wxDefaultValidator
,
524 const wxString
&name
= "listctrl" )
526 Create(parent
, id
, pos
, size
, style
, validator
, name
);
529 bool Create( wxWindow
*parent
, wxWindowID id
= -1,
530 const wxPoint
&pos
= wxDefaultPosition
, const wxSize
&size
= wxDefaultSize
,
532 # if defined(__VISAGECPP__)
533 long style
= wxLC_ICON
, const wxValidator
* validator
= wxDefaultValidator
,
535 long style
= wxLC_ICON
, const wxValidator
& validator
= wxDefaultValidator
,
538 const wxString
&name
= "listctrl" );
539 void OnSize( wxSizeEvent
&event
);
540 bool GetColumn( int col
, wxListItem
& item
) const;
541 bool SetColumn( int col
, wxListItem
& item
);
542 int GetColumnWidth( int col
) const;
543 bool SetColumnWidth( int col
, int width
);
544 int GetCountPerPage() const; // not the same in wxGLC as in Windows, I think
545 bool GetItem( wxListItem
& info
) const;
546 bool SetItem( wxListItem
& info
) ;
547 long SetItem( long index
, int col
, const wxString
& label
, int imageId
= -1 );
548 int GetItemState( long item
, long stateMask
) const;
549 bool SetItemState( long item
, long state
, long stateMask
);
550 bool SetItemImage( long item
, int image
, int selImage
);
551 wxString
GetItemText( long item
) const;
552 void SetItemText( long item
, const wxString
& str
);
553 long GetItemData( long item
) const;
554 bool SetItemData( long item
, long data
);
555 bool GetItemRect( long item
, wxRect
& rect
, int code
= wxLIST_RECT_BOUNDS
) const;
556 bool GetItemPosition( long item
, wxPoint
& pos
) const;
557 bool SetItemPosition( long item
, const wxPoint
& pos
); // not supported in wxGLC
558 int GetItemCount() const;
559 int GetColumnCount() const;
560 void SetItemSpacing( int spacing
, bool isSmall
= FALSE
);
561 int GetItemSpacing( bool isSmall
) const;
562 int GetSelectedItemCount() const;
563 // wxColour GetTextColour() const; // wxGLC has colours for every Item (see wxListItem)
564 // void SetTextColour(const wxColour& col);
565 long GetTopItem() const;
566 void SetSingleStyle( long style
, bool add
= TRUE
) ;
567 void SetWindowStyleFlag( long style
);
568 void RecreateWindow() {}
569 long GetNextItem( long item
, int geometry
= wxLIST_NEXT_ALL
, int state
= wxLIST_STATE_DONTCARE
) const;
570 wxImageList
*GetImageList( int which
) const;
571 void SetImageList( wxImageList
*imageList
, int which
);
572 bool Arrange( int flag
= wxLIST_ALIGN_DEFAULT
); // always wxLIST_ALIGN_LEFT in wxGLC
575 bool DeleteItem( long item
);
576 bool DeleteAllItems();
577 bool DeleteAllColumns();
578 bool DeleteColumn( int col
);
580 void EditLabel( long item
) { Edit(item
); }
581 void Edit( long item
);
583 bool EnsureVisible( long item
);
584 long FindItem( long start
, const wxString
& str
, bool partial
= FALSE
);
585 long FindItem( long start
, long data
);
586 long FindItem( long start
, const wxPoint
& pt
, int direction
); // not supported in wxGLC
587 long HitTest( const wxPoint
& point
, int& flags
);
588 long InsertItem(wxListItem
& info
);
589 long InsertItem( long index
, const wxString
& label
);
590 long InsertItem( long index
, int imageIndex
);
591 long InsertItem( long index
, const wxString
& label
, int imageIndex
);
592 long InsertColumn( long col
, wxListItem
& info
);
593 long InsertColumn( long col
, const wxString
& heading
, int format
= wxLIST_FORMAT_LEFT
,
595 bool ScrollList( int dx
, int dy
);
596 bool SortItems( wxListCtrlCompare fn
, long data
);
597 bool Update( long item
);
598 void OnIdle( wxIdleEvent
&event
);
600 // We have to hand down a few functions
602 bool SetBackgroundColour( const wxColour
&colour
);
603 bool SetForegroundColour( const wxColour
&colour
);
604 bool SetFont( const wxFont
&font
);
606 #if wxUSE_DRAG_AND_DROP
607 void SetDropTarget( wxDropTarget
*dropTarget
)
608 { m_mainWin
->SetDropTarget( dropTarget
); }
609 wxDropTarget
*GetDropTarget() const
610 { return m_mainWin
->GetDropTarget(); }
613 bool SetCursor( const wxCursor
&cursor
)
614 { return m_mainWin
? m_mainWin
->wxWindow::SetCursor(cursor
) : FALSE
; }
615 wxColour
GetBackgroundColour() const
616 { return m_mainWin
? m_mainWin
->GetBackgroundColour() : wxColour(); }
617 wxColour
GetForegroundColour() const
618 { return m_mainWin
? m_mainWin
->GetForegroundColour() : wxColour(); }
619 bool DoPopupMenu( wxMenu
*menu
, int x
, int y
)
620 { return m_mainWin
->PopupMenu( menu
, x
, y
); }
622 { m_mainWin
->SetFocus(); }
626 wxImageList
*m_imageListNormal
;
627 wxImageList
*m_imageListSmall
;
628 wxImageList
*m_imageListState
; // what's that ?
629 wxListHeaderWindow
*m_headerWin
;
630 wxListMainWindow
*m_mainWin
;
632 DECLARE_EVENT_TABLE()
637 #endif // __LISTCTRLH_G__