Fix sending of wxEVT_COMMAND_LIST_COL_DRAGGING events in wxMSW wxListCtrl.
[wxWidgets.git] / src / msw / listctrl.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/listctrl.cpp
3 // Purpose: wxListCtrl
4 // Author: Julian Smart
5 // Modified by: Agron Selimaj
6 // Created: 04/01/98
7 // RCS-ID: $Id$
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 // ============================================================================
13 // declarations
14 // ============================================================================
15
16 // ----------------------------------------------------------------------------
17 // headers
18 // ----------------------------------------------------------------------------
19
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
22
23 #ifdef __BORLANDC__
24 #pragma hdrstop
25 #endif
26
27 #if wxUSE_LISTCTRL
28
29 #include "wx/listctrl.h"
30
31 #ifndef WX_PRECOMP
32 #include "wx/msw/wrapcctl.h" // include <commctrl.h> "properly"
33 #include "wx/app.h"
34 #include "wx/intl.h"
35 #include "wx/log.h"
36 #include "wx/settings.h"
37 #include "wx/dcclient.h"
38 #include "wx/textctrl.h"
39 #endif
40
41 #include "wx/imaglist.h"
42 #include "wx/vector.h"
43
44 #include "wx/msw/private.h"
45
46 #if defined(__WXWINCE__) && !defined(__HANDHELDPC__)
47 #include <ole2.h>
48 #include <shellapi.h>
49 #if _WIN32_WCE < 400
50 #include <aygshell.h>
51 #endif
52 #endif
53
54 // Currently gcc and watcom don't define NMLVFINDITEM, and DMC only defines
55 // it by its old name NM_FINDTIEM.
56 //
57 #if defined(__VISUALC__) || defined(__BORLANDC__) || defined(NMLVFINDITEM)
58 #define HAVE_NMLVFINDITEM 1
59 #elif defined(__DMC__) || defined(NM_FINDITEM)
60 #define HAVE_NMLVFINDITEM 1
61 #define NMLVFINDITEM NM_FINDITEM
62 #endif
63
64 // ----------------------------------------------------------------------------
65 // private functions
66 // ----------------------------------------------------------------------------
67
68 // convert our state and mask flags to LV_ITEM constants
69 static void wxConvertToMSWFlags(long state, long mask, LV_ITEM& lvItem);
70
71 // convert wxListItem to LV_ITEM
72 static void wxConvertToMSWListItem(const wxListCtrl *ctrl,
73 const wxListItem& info, LV_ITEM& lvItem);
74
75 // convert LV_ITEM to wxListItem
76 static void wxConvertFromMSWListItem(HWND hwndListCtrl,
77 wxListItem& info,
78 /* const */ LV_ITEM& lvItem);
79
80 // convert our wxListItem to LV_COLUMN
81 static void wxConvertToMSWListCol(HWND hwndList,
82 int col,
83 const wxListItem& item,
84 LV_COLUMN& lvCol);
85
86 namespace
87 {
88
89 // replacement for ListView_GetSubItemRect() which provokes warnings like
90 // "the address of 'rc' will always evaluate as 'true'" when used with mingw32
91 // 4.3+
92 //
93 // this function does no error checking on item and subitem parameters, notice
94 // that subitem 0 means the whole item so there is no way to retrieve the
95 // rectangle of the first subitem using this function, in particular notice
96 // that the index is *not* 1-based, in spite of what MSDN says
97 inline bool
98 wxGetListCtrlSubItemRect(HWND hwnd, int item, int subitem, int flags, RECT& rect)
99 {
100 rect.top = subitem;
101 rect.left = flags;
102 return ::SendMessage(hwnd, LVM_GETSUBITEMRECT, item, (LPARAM)&rect) != 0;
103 }
104
105 inline bool
106 wxGetListCtrlItemRect(HWND hwnd, int item, int flags, RECT& rect)
107 {
108 return wxGetListCtrlSubItemRect(hwnd, item, 0, flags, rect);
109 }
110
111 } // anonymous namespace
112
113 // ----------------------------------------------------------------------------
114 // private helper classes
115 // ----------------------------------------------------------------------------
116
117 // We have to handle both fooW and fooA notifications in several cases
118 // because of broken comctl32.dll and/or unicows.dll. This class is used to
119 // convert LV_ITEMA and LV_ITEMW to LV_ITEM (which is either LV_ITEMA or
120 // LV_ITEMW depending on wxUSE_UNICODE setting), so that it can be processed
121 // by wxConvertToMSWListItem().
122 #if wxUSE_UNICODE
123 #define LV_ITEM_NATIVE LV_ITEMW
124 #define LV_ITEM_OTHER LV_ITEMA
125
126 #define LV_CONV_TO_WX cMB2WX
127 #define LV_CONV_BUF wxMB2WXbuf
128 #else // ANSI
129 #define LV_ITEM_NATIVE LV_ITEMA
130 #define LV_ITEM_OTHER LV_ITEMW
131
132 #define LV_CONV_TO_WX cWC2WX
133 #define LV_CONV_BUF wxWC2WXbuf
134 #endif // Unicode/ANSI
135
136 class wxLV_ITEM
137 {
138 public:
139 // default ctor, use Init() later
140 wxLV_ITEM() { m_buf = NULL; m_pItem = NULL; }
141
142 // init without conversion
143 void Init(LV_ITEM_NATIVE& item)
144 {
145 wxASSERT_MSG( !m_pItem, wxT("Init() called twice?") );
146
147 m_pItem = &item;
148 }
149
150 // init with conversion
151 void Init(const LV_ITEM_OTHER& item)
152 {
153 // avoid unnecessary dynamic memory allocation, jjust make m_pItem
154 // point to our own m_item
155
156 // memcpy() can't work if the struct sizes are different
157 wxCOMPILE_TIME_ASSERT( sizeof(LV_ITEM_OTHER) == sizeof(LV_ITEM_NATIVE),
158 CodeCantWorkIfDiffSizes);
159
160 memcpy(&m_item, &item, sizeof(LV_ITEM_NATIVE));
161
162 // convert text from ANSI to Unicod if necessary
163 if ( (item.mask & LVIF_TEXT) && item.pszText )
164 {
165 m_buf = new LV_CONV_BUF(wxConvLocal.LV_CONV_TO_WX(item.pszText));
166 m_item.pszText = (wxChar *)m_buf->data();
167 }
168 }
169
170 // ctor without conversion
171 wxLV_ITEM(LV_ITEM_NATIVE& item) : m_buf(NULL), m_pItem(&item) { }
172
173 // ctor with conversion
174 wxLV_ITEM(LV_ITEM_OTHER& item) : m_buf(NULL)
175 {
176 Init(item);
177 }
178
179 ~wxLV_ITEM() { delete m_buf; }
180
181 // conversion to the real LV_ITEM
182 operator LV_ITEM_NATIVE&() const { return *m_pItem; }
183
184 private:
185 LV_CONV_BUF *m_buf;
186
187 LV_ITEM_NATIVE *m_pItem;
188 LV_ITEM_NATIVE m_item;
189
190 wxDECLARE_NO_COPY_CLASS(wxLV_ITEM);
191 };
192
193 ///////////////////////////////////////////////////////
194 // Problem:
195 // The MSW version had problems with SetTextColour() et
196 // al as the wxListItemAttr's were stored keyed on the
197 // item index. If a item was inserted anywhere but the end
198 // of the list the text attributes (colour etc) for
199 // the following items were out of sync.
200 //
201 // Solution:
202 // Under MSW the only way to associate data with a List
203 // item independent of its position in the list is to
204 // store a pointer to it in its lParam attribute. However
205 // user programs are already using this (via the
206 // SetItemData() GetItemData() calls).
207 //
208 // However what we can do is store a pointer to a
209 // structure which contains the attributes we want *and*
210 // a lParam -- and this is what wxMSWListItemData does.
211 //
212 // To conserve memory, a wxMSWListItemData is
213 // only allocated for a LV_ITEM if text attributes or
214 // user data(lparam) are being set.
215 class wxMSWListItemData
216 {
217 public:
218 wxMSWListItemData() : attr(NULL), lParam(0) {}
219 ~wxMSWListItemData() { delete attr; }
220
221 wxListItemAttr *attr;
222 LPARAM lParam; // real user data
223
224 wxDECLARE_NO_COPY_CLASS(wxMSWListItemData);
225 };
226
227 #if wxUSE_EXTENDED_RTTI
228 WX_DEFINE_FLAGS( wxListCtrlStyle )
229
230 wxBEGIN_FLAGS( wxListCtrlStyle )
231 // new style border flags, we put them first to
232 // use them for streaming out
233 wxFLAGS_MEMBER(wxBORDER_SIMPLE)
234 wxFLAGS_MEMBER(wxBORDER_SUNKEN)
235 wxFLAGS_MEMBER(wxBORDER_DOUBLE)
236 wxFLAGS_MEMBER(wxBORDER_RAISED)
237 wxFLAGS_MEMBER(wxBORDER_STATIC)
238 wxFLAGS_MEMBER(wxBORDER_NONE)
239
240 // old style border flags
241 wxFLAGS_MEMBER(wxSIMPLE_BORDER)
242 wxFLAGS_MEMBER(wxSUNKEN_BORDER)
243 wxFLAGS_MEMBER(wxDOUBLE_BORDER)
244 wxFLAGS_MEMBER(wxRAISED_BORDER)
245 wxFLAGS_MEMBER(wxSTATIC_BORDER)
246 wxFLAGS_MEMBER(wxBORDER)
247
248 // standard window styles
249 wxFLAGS_MEMBER(wxTAB_TRAVERSAL)
250 wxFLAGS_MEMBER(wxCLIP_CHILDREN)
251 wxFLAGS_MEMBER(wxTRANSPARENT_WINDOW)
252 wxFLAGS_MEMBER(wxWANTS_CHARS)
253 wxFLAGS_MEMBER(wxFULL_REPAINT_ON_RESIZE)
254 wxFLAGS_MEMBER(wxALWAYS_SHOW_SB )
255 wxFLAGS_MEMBER(wxVSCROLL)
256 wxFLAGS_MEMBER(wxHSCROLL)
257
258 wxFLAGS_MEMBER(wxLC_LIST)
259 wxFLAGS_MEMBER(wxLC_REPORT)
260 wxFLAGS_MEMBER(wxLC_ICON)
261 wxFLAGS_MEMBER(wxLC_SMALL_ICON)
262 wxFLAGS_MEMBER(wxLC_ALIGN_TOP)
263 wxFLAGS_MEMBER(wxLC_ALIGN_LEFT)
264 wxFLAGS_MEMBER(wxLC_AUTOARRANGE)
265 wxFLAGS_MEMBER(wxLC_USER_TEXT)
266 wxFLAGS_MEMBER(wxLC_EDIT_LABELS)
267 wxFLAGS_MEMBER(wxLC_NO_HEADER)
268 wxFLAGS_MEMBER(wxLC_SINGLE_SEL)
269 wxFLAGS_MEMBER(wxLC_SORT_ASCENDING)
270 wxFLAGS_MEMBER(wxLC_SORT_DESCENDING)
271 wxFLAGS_MEMBER(wxLC_VIRTUAL)
272
273 wxEND_FLAGS( wxListCtrlStyle )
274
275 IMPLEMENT_DYNAMIC_CLASS_XTI(wxListCtrl, wxControl,"wx/listctrl.h")
276
277 wxBEGIN_PROPERTIES_TABLE(wxListCtrl)
278 wxEVENT_PROPERTY( TextUpdated , wxEVT_COMMAND_TEXT_UPDATED , wxCommandEvent )
279
280 wxPROPERTY_FLAGS( WindowStyle , wxListCtrlStyle , long , SetWindowStyleFlag , GetWindowStyleFlag , EMPTY_MACROVALUE , 0 /*flags*/ , wxT("Helpstring") , wxT("group")) // style
281 wxEND_PROPERTIES_TABLE()
282
283 wxBEGIN_HANDLERS_TABLE(wxListCtrl)
284 wxEND_HANDLERS_TABLE()
285
286 wxCONSTRUCTOR_5( wxListCtrl , wxWindow* , Parent , wxWindowID , Id , wxPoint , Position , wxSize , Size , long , WindowStyle )
287
288 /*
289 TODO : Expose more information of a list's layout etc. via appropriate objects (a la NotebookPageInfo)
290 */
291 #else
292 IMPLEMENT_DYNAMIC_CLASS(wxListCtrl, wxControl)
293 #endif
294
295 IMPLEMENT_DYNAMIC_CLASS(wxListView, wxListCtrl)
296 IMPLEMENT_DYNAMIC_CLASS(wxListItem, wxObject)
297
298 IMPLEMENT_DYNAMIC_CLASS(wxListEvent, wxNotifyEvent)
299
300 BEGIN_EVENT_TABLE(wxListCtrl, wxControl)
301 EVT_PAINT(wxListCtrl::OnPaint)
302 END_EVENT_TABLE()
303
304 // ============================================================================
305 // implementation
306 // ============================================================================
307
308 // ----------------------------------------------------------------------------
309 // wxListCtrl construction
310 // ----------------------------------------------------------------------------
311
312 void wxListCtrl::Init()
313 {
314 m_imageListNormal =
315 m_imageListSmall =
316 m_imageListState = NULL;
317 m_ownsImageListNormal =
318 m_ownsImageListSmall =
319 m_ownsImageListState = false;
320
321 m_colCount = 0;
322 m_count = 0;
323 m_textCtrl = NULL;
324
325 m_hasAnyAttr = false;
326 }
327
328 bool wxListCtrl::Create(wxWindow *parent,
329 wxWindowID id,
330 const wxPoint& pos,
331 const wxSize& size,
332 long style,
333 const wxValidator& validator,
334 const wxString& name)
335 {
336 if ( !CreateControl(parent, id, pos, size, style, validator, name) )
337 return false;
338
339 if ( !MSWCreateControl(WC_LISTVIEW, wxEmptyString, pos, size) )
340 return false;
341
342 // explicitly say that we want to use Unicode because otherwise we get ANSI
343 // versions of _some_ messages (notably LVN_GETDISPINFOA) in MSLU build
344 wxSetCCUnicodeFormat(GetHwnd());
345
346 // We must set the default text colour to the system/theme color, otherwise
347 // GetTextColour will always return black
348 SetTextColour(GetDefaultAttributes().colFg);
349
350 if ( InReportView() )
351 MSWSetExListStyles();
352
353 return true;
354 }
355
356 void wxListCtrl::MSWSetExListStyles()
357 {
358 // for comctl32.dll v 4.70+ we want to have some non default extended
359 // styles because it's prettier (and also because wxGTK does it like this)
360 if ( wxApp::GetComCtl32Version() >= 470 )
361 {
362 ::SendMessage
363 (
364 GetHwnd(), LVM_SETEXTENDEDLISTVIEWSTYLE, 0,
365 // LVS_EX_LABELTIP shouldn't be used under Windows CE where it's
366 // not defined in the SDK headers
367 #ifdef LVS_EX_LABELTIP
368 LVS_EX_LABELTIP |
369 #endif
370 LVS_EX_FULLROWSELECT |
371 LVS_EX_SUBITEMIMAGES |
372 // normally this should be governed by a style as it's probably not
373 // always appropriate, but we don't have any free styles left and
374 // it seems better to enable it by default than disable
375 LVS_EX_HEADERDRAGDROP
376 );
377 }
378 }
379
380 WXDWORD wxListCtrl::MSWGetStyle(long style, WXDWORD *exstyle) const
381 {
382 WXDWORD wstyle = wxControl::MSWGetStyle(style, exstyle);
383
384 wstyle |= LVS_SHAREIMAGELISTS | LVS_SHOWSELALWAYS;
385
386 #if wxDEBUG_LEVEL
387 size_t nModes = 0;
388
389 #define MAP_MODE_STYLE(wx, ms) \
390 if ( style & (wx) ) { wstyle |= (ms); nModes++; }
391 #else // !wxDEBUG_LEVEL
392 #define MAP_MODE_STYLE(wx, ms) \
393 if ( style & (wx) ) wstyle |= (ms);
394 #endif // wxDEBUG_LEVEL/!wxDEBUG_LEVEL
395
396 MAP_MODE_STYLE(wxLC_ICON, LVS_ICON)
397 MAP_MODE_STYLE(wxLC_SMALL_ICON, LVS_SMALLICON)
398 MAP_MODE_STYLE(wxLC_LIST, LVS_LIST)
399 MAP_MODE_STYLE(wxLC_REPORT, LVS_REPORT)
400
401 wxASSERT_MSG( nModes == 1,
402 wxT("wxListCtrl style should have exactly one mode bit set") );
403
404 #undef MAP_MODE_STYLE
405
406 if ( style & wxLC_ALIGN_LEFT )
407 wstyle |= LVS_ALIGNLEFT;
408
409 if ( style & wxLC_ALIGN_TOP )
410 wstyle |= LVS_ALIGNTOP;
411
412 if ( style & wxLC_AUTOARRANGE )
413 wstyle |= LVS_AUTOARRANGE;
414
415 if ( style & wxLC_NO_SORT_HEADER )
416 wstyle |= LVS_NOSORTHEADER;
417
418 if ( style & wxLC_NO_HEADER )
419 wstyle |= LVS_NOCOLUMNHEADER;
420
421 if ( style & wxLC_EDIT_LABELS )
422 wstyle |= LVS_EDITLABELS;
423
424 if ( style & wxLC_SINGLE_SEL )
425 wstyle |= LVS_SINGLESEL;
426
427 if ( style & wxLC_SORT_ASCENDING )
428 {
429 wstyle |= LVS_SORTASCENDING;
430
431 wxASSERT_MSG( !(style & wxLC_SORT_DESCENDING),
432 wxT("can't sort in ascending and descending orders at once") );
433 }
434 else if ( style & wxLC_SORT_DESCENDING )
435 wstyle |= LVS_SORTDESCENDING;
436
437 #if !( defined(__GNUWIN32__) && !wxCHECK_W32API_VERSION( 1, 0 ) )
438 if ( style & wxLC_VIRTUAL )
439 {
440 int ver = wxApp::GetComCtl32Version();
441 if ( ver < 470 )
442 {
443 wxLogWarning(_("Please install a newer version of comctl32.dll\n(at least version 4.70 is required but you have %d.%02d)\nor this program won't operate correctly."),
444 ver / 100, ver % 100);
445 }
446
447 wstyle |= LVS_OWNERDATA;
448 }
449 #endif // ancient cygwin
450
451 return wstyle;
452 }
453
454 void wxListCtrl::UpdateStyle()
455 {
456 if ( GetHwnd() )
457 {
458 // The new window view style
459 DWORD dwStyleNew = MSWGetStyle(m_windowStyle, NULL);
460
461 // some styles are not returned by MSWGetStyle()
462 if ( IsShown() )
463 dwStyleNew |= WS_VISIBLE;
464
465 // Get the current window style.
466 DWORD dwStyleOld = ::GetWindowLong(GetHwnd(), GWL_STYLE);
467
468 // we don't have wxVSCROLL style, but the list control may have it,
469 // don't change it then
470 dwStyleNew |= dwStyleOld & (WS_HSCROLL | WS_VSCROLL);
471
472 // Only set the window style if the view bits have changed.
473 if ( dwStyleOld != dwStyleNew )
474 {
475 ::SetWindowLong(GetHwnd(), GWL_STYLE, dwStyleNew);
476
477 // if we switched to the report view, set the extended styles for
478 // it too
479 if ( !(dwStyleOld & LVS_REPORT) && (dwStyleNew & LVS_REPORT) )
480 MSWSetExListStyles();
481 }
482 }
483 }
484
485 void wxListCtrl::FreeAllInternalData()
486 {
487 const unsigned count = m_internalData.size();
488 for ( unsigned n = 0; n < count; n++ )
489 delete m_internalData[n];
490
491 m_internalData.clear();
492 }
493
494 void wxListCtrl::DeleteEditControl()
495 {
496 if ( m_textCtrl )
497 {
498 m_textCtrl->UnsubclassWin();
499 m_textCtrl->SetHWND(0);
500 delete m_textCtrl;
501 m_textCtrl = NULL;
502 }
503 }
504
505 wxListCtrl::~wxListCtrl()
506 {
507 FreeAllInternalData();
508
509 DeleteEditControl();
510
511 if (m_ownsImageListNormal)
512 delete m_imageListNormal;
513 if (m_ownsImageListSmall)
514 delete m_imageListSmall;
515 if (m_ownsImageListState)
516 delete m_imageListState;
517 }
518
519 // ----------------------------------------------------------------------------
520 // set/get/change style
521 // ----------------------------------------------------------------------------
522
523 // Add or remove a single window style
524 void wxListCtrl::SetSingleStyle(long style, bool add)
525 {
526 long flag = GetWindowStyleFlag();
527
528 // Get rid of conflicting styles
529 if ( add )
530 {
531 if ( style & wxLC_MASK_TYPE)
532 flag = flag & ~wxLC_MASK_TYPE;
533 if ( style & wxLC_MASK_ALIGN )
534 flag = flag & ~wxLC_MASK_ALIGN;
535 if ( style & wxLC_MASK_SORT )
536 flag = flag & ~wxLC_MASK_SORT;
537 }
538
539 if ( add )
540 flag |= style;
541 else
542 flag &= ~style;
543
544 SetWindowStyleFlag(flag);
545 }
546
547 // Set the whole window style
548 void wxListCtrl::SetWindowStyleFlag(long flag)
549 {
550 if ( flag != m_windowStyle )
551 {
552 wxControl::SetWindowStyleFlag(flag);
553
554 UpdateStyle();
555
556 Refresh();
557 }
558 }
559
560 // ----------------------------------------------------------------------------
561 // accessors
562 // ----------------------------------------------------------------------------
563
564 /* static */ wxVisualAttributes
565 wxListCtrl::GetClassDefaultAttributes(wxWindowVariant variant)
566 {
567 wxVisualAttributes attrs = GetCompositeControlsDefaultAttributes(variant);
568
569 // common controls have their own default font
570 attrs.font = wxGetCCDefaultFont();
571
572 return attrs;
573 }
574
575 // Sets the foreground, i.e. text, colour
576 bool wxListCtrl::SetForegroundColour(const wxColour& col)
577 {
578 if ( !wxWindow::SetForegroundColour(col) )
579 return false;
580
581 ListView_SetTextColor(GetHwnd(), wxColourToRGB(col));
582
583 return true;
584 }
585
586 // Sets the background colour
587 bool wxListCtrl::SetBackgroundColour(const wxColour& col)
588 {
589 if ( !wxWindow::SetBackgroundColour(col) )
590 return false;
591
592 // we set the same colour for both the "empty" background and the items
593 // background
594 COLORREF color = wxColourToRGB(col);
595 ListView_SetBkColor(GetHwnd(), color);
596 ListView_SetTextBkColor(GetHwnd(), color);
597
598 return true;
599 }
600
601 // Gets information about this column
602 bool wxListCtrl::GetColumn(int col, wxListItem& item) const
603 {
604 LV_COLUMN lvCol;
605 wxZeroMemory(lvCol);
606
607 lvCol.mask = LVCF_WIDTH;
608
609 if ( item.m_mask & wxLIST_MASK_TEXT )
610 {
611 lvCol.mask |= LVCF_TEXT;
612 lvCol.pszText = new wxChar[513];
613 lvCol.cchTextMax = 512;
614 }
615
616 if ( item.m_mask & wxLIST_MASK_FORMAT )
617 {
618 lvCol.mask |= LVCF_FMT;
619 }
620
621 if ( item.m_mask & wxLIST_MASK_IMAGE )
622 {
623 lvCol.mask |= LVCF_IMAGE;
624 }
625
626 bool success = ListView_GetColumn(GetHwnd(), col, &lvCol) != 0;
627
628 // item.m_subItem = lvCol.iSubItem;
629 item.m_width = lvCol.cx;
630
631 if ( (item.m_mask & wxLIST_MASK_TEXT) && lvCol.pszText )
632 {
633 item.m_text = lvCol.pszText;
634 delete[] lvCol.pszText;
635 }
636
637 if ( item.m_mask & wxLIST_MASK_FORMAT )
638 {
639 switch (lvCol.fmt & LVCFMT_JUSTIFYMASK) {
640 case LVCFMT_LEFT:
641 item.m_format = wxLIST_FORMAT_LEFT;
642 break;
643 case LVCFMT_RIGHT:
644 item.m_format = wxLIST_FORMAT_RIGHT;
645 break;
646 case LVCFMT_CENTER:
647 item.m_format = wxLIST_FORMAT_CENTRE;
648 break;
649 default:
650 item.m_format = -1; // Unknown?
651 break;
652 }
653 }
654
655 // the column images were not supported in older versions but how to check
656 // for this? we can't use _WIN32_IE because we always define it to a very
657 // high value, so see if another symbol which is only defined starting from
658 // comctl32.dll 4.70 is available
659 #ifdef NM_CUSTOMDRAW // _WIN32_IE >= 0x0300
660 if ( item.m_mask & wxLIST_MASK_IMAGE )
661 {
662 item.m_image = lvCol.iImage;
663 }
664 #endif // LVCOLUMN::iImage exists
665
666 return success;
667 }
668
669 // Sets information about this column
670 bool wxListCtrl::SetColumn(int col, const wxListItem& item)
671 {
672 LV_COLUMN lvCol;
673 wxConvertToMSWListCol(GetHwnd(), col, item, lvCol);
674
675 return ListView_SetColumn(GetHwnd(), col, &lvCol) != 0;
676 }
677
678 // Gets the column width
679 int wxListCtrl::GetColumnWidth(int col) const
680 {
681 return ListView_GetColumnWidth(GetHwnd(), col);
682 }
683
684 // Sets the column width
685 bool wxListCtrl::SetColumnWidth(int col, int width)
686 {
687 if ( m_windowStyle & wxLC_LIST )
688 col = 0;
689
690 if ( width == wxLIST_AUTOSIZE)
691 width = LVSCW_AUTOSIZE;
692 else if ( width == wxLIST_AUTOSIZE_USEHEADER)
693 width = LVSCW_AUTOSIZE_USEHEADER;
694
695 return ListView_SetColumnWidth(GetHwnd(), col, width) != 0;
696 }
697
698 // ----------------------------------------------------------------------------
699 // columns order
700 // ----------------------------------------------------------------------------
701
702 int wxListCtrl::GetColumnIndexFromOrder(int order) const
703 {
704 const int numCols = GetColumnCount();
705 wxCHECK_MSG( order >= 0 && order < numCols, -1,
706 wxT("Column position out of bounds") );
707
708 wxArrayInt indexArray(numCols);
709 if ( !ListView_GetColumnOrderArray(GetHwnd(), numCols, &indexArray[0]) )
710 return -1;
711
712 return indexArray[order];
713 }
714
715 int wxListCtrl::GetColumnOrder(int col) const
716 {
717 const int numCols = GetColumnCount();
718 wxASSERT_MSG( col >= 0 && col < numCols, wxT("Column index out of bounds") );
719
720 wxArrayInt indexArray(numCols);
721 if ( !ListView_GetColumnOrderArray(GetHwnd(), numCols, &indexArray[0]) )
722 return -1;
723
724 for ( int pos = 0; pos < numCols; pos++ )
725 {
726 if ( indexArray[pos] == col )
727 return pos;
728 }
729
730 wxFAIL_MSG( wxT("no column with with given order?") );
731
732 return -1;
733 }
734
735 // Gets the column order for all columns
736 wxArrayInt wxListCtrl::GetColumnsOrder() const
737 {
738 const int numCols = GetColumnCount();
739
740 wxArrayInt orders(numCols);
741 if ( !ListView_GetColumnOrderArray(GetHwnd(), numCols, &orders[0]) )
742 orders.clear();
743
744 return orders;
745 }
746
747 // Sets the column order for all columns
748 bool wxListCtrl::SetColumnsOrder(const wxArrayInt& orders)
749 {
750 const int numCols = GetColumnCount();
751
752 wxCHECK_MSG( orders.size() == (size_t)numCols, false,
753 wxT("wrong number of elements in column orders array") );
754
755 return ListView_SetColumnOrderArray(GetHwnd(), numCols, &orders[0]) != 0;
756 }
757
758
759 // Gets the number of items that can fit vertically in the
760 // visible area of the list control (list or report view)
761 // or the total number of items in the list control (icon
762 // or small icon view)
763 int wxListCtrl::GetCountPerPage() const
764 {
765 return ListView_GetCountPerPage(GetHwnd());
766 }
767
768 // Gets the edit control for editing labels.
769 wxTextCtrl* wxListCtrl::GetEditControl() const
770 {
771 // first check corresponds to the case when the label editing was started
772 // by user and hence m_textCtrl wasn't created by EditLabel() at all, while
773 // the second case corresponds to us being called from inside EditLabel()
774 // (e.g. from a user wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT handler): in this
775 // case EditLabel() did create the control but it didn't have an HWND to
776 // initialize it with yet
777 if ( !m_textCtrl || !m_textCtrl->GetHWND() )
778 {
779 HWND hwndEdit = ListView_GetEditControl(GetHwnd());
780 if ( hwndEdit )
781 {
782 wxListCtrl * const self = const_cast<wxListCtrl *>(this);
783
784 if ( !m_textCtrl )
785 self->m_textCtrl = new wxTextCtrl;
786 self->InitEditControl((WXHWND)hwndEdit);
787 }
788 }
789
790 return m_textCtrl;
791 }
792
793 // Gets information about the item
794 bool wxListCtrl::GetItem(wxListItem& info) const
795 {
796 LV_ITEM lvItem;
797 wxZeroMemory(lvItem);
798
799 lvItem.iItem = info.m_itemId;
800 lvItem.iSubItem = info.m_col;
801
802 if ( info.m_mask & wxLIST_MASK_TEXT )
803 {
804 lvItem.mask |= LVIF_TEXT;
805 lvItem.pszText = new wxChar[513];
806 lvItem.cchTextMax = 512;
807 }
808 else
809 {
810 lvItem.pszText = NULL;
811 }
812
813 if (info.m_mask & wxLIST_MASK_DATA)
814 lvItem.mask |= LVIF_PARAM;
815
816 if (info.m_mask & wxLIST_MASK_IMAGE)
817 lvItem.mask |= LVIF_IMAGE;
818
819 if ( info.m_mask & wxLIST_MASK_STATE )
820 {
821 lvItem.mask |= LVIF_STATE;
822 wxConvertToMSWFlags(0, info.m_stateMask, lvItem);
823 }
824
825 bool success = ListView_GetItem((HWND)GetHWND(), &lvItem) != 0;
826 if ( !success )
827 {
828 wxLogError(_("Couldn't retrieve information about list control item %d."),
829 lvItem.iItem);
830 }
831 else
832 {
833 // give NULL as hwnd as we already have everything we need
834 wxConvertFromMSWListItem(NULL, info, lvItem);
835 }
836
837 if (lvItem.pszText)
838 delete[] lvItem.pszText;
839
840 return success;
841 }
842
843 // Sets information about the item
844 bool wxListCtrl::SetItem(wxListItem& info)
845 {
846 const long id = info.GetId();
847 wxCHECK_MSG( id >= 0 && id < GetItemCount(), false,
848 wxT("invalid item index in SetItem") );
849
850 LV_ITEM item;
851 wxConvertToMSWListItem(this, info, item);
852
853 // we never update the lParam if it contains our pointer
854 // to the wxMSWListItemData structure
855 item.mask &= ~LVIF_PARAM;
856
857 // check if setting attributes or lParam
858 if ( info.HasAttributes() || (info.m_mask & wxLIST_MASK_DATA) )
859 {
860 // get internal item data
861 wxMSWListItemData *data = MSWGetItemData(id);
862
863 if ( !data )
864 {
865 // need to allocate the internal data object
866 data = new wxMSWListItemData;
867 m_internalData.push_back(data);
868 item.lParam = (LPARAM) data;
869 item.mask |= LVIF_PARAM;
870 }
871
872
873 // user data
874 if ( info.m_mask & wxLIST_MASK_DATA )
875 data->lParam = info.m_data;
876
877 // attributes
878 if ( info.HasAttributes() )
879 {
880 const wxListItemAttr& attrNew = *info.GetAttributes();
881
882 // don't overwrite the already set attributes if we have them
883 if ( data->attr )
884 data->attr->AssignFrom(attrNew);
885 else
886 data->attr = new wxListItemAttr(attrNew);
887 }
888 }
889
890
891 // we could be changing only the attribute in which case we don't need to
892 // call ListView_SetItem() at all
893 if ( item.mask )
894 {
895 if ( !ListView_SetItem(GetHwnd(), &item) )
896 {
897 wxLogDebug(wxT("ListView_SetItem() failed"));
898
899 return false;
900 }
901 }
902
903 // we need to update the item immediately to show the new image
904 bool updateNow = (info.m_mask & wxLIST_MASK_IMAGE) != 0;
905
906 // check whether it has any custom attributes
907 if ( info.HasAttributes() )
908 {
909 m_hasAnyAttr = true;
910
911 // if the colour has changed, we must redraw the item
912 updateNow = true;
913 }
914
915 if ( updateNow )
916 {
917 // we need this to make the change visible right now
918 RefreshItem(item.iItem);
919 }
920
921 return true;
922 }
923
924 long wxListCtrl::SetItem(long index, int col, const wxString& label, int imageId)
925 {
926 wxListItem info;
927 info.m_text = label;
928 info.m_mask = wxLIST_MASK_TEXT;
929 info.m_itemId = index;
930 info.m_col = col;
931 if ( imageId > -1 )
932 {
933 info.m_image = imageId;
934 info.m_mask |= wxLIST_MASK_IMAGE;
935 }
936 return SetItem(info);
937 }
938
939
940 // Gets the item state
941 int wxListCtrl::GetItemState(long item, long stateMask) const
942 {
943 wxListItem info;
944
945 info.m_mask = wxLIST_MASK_STATE;
946 info.m_stateMask = stateMask;
947 info.m_itemId = item;
948
949 if (!GetItem(info))
950 return 0;
951
952 return info.m_state;
953 }
954
955 // Sets the item state
956 bool wxListCtrl::SetItemState(long item, long state, long stateMask)
957 {
958 // NB: don't use SetItem() here as it doesn't work with the virtual list
959 // controls
960 LV_ITEM lvItem;
961 wxZeroMemory(lvItem);
962
963 wxConvertToMSWFlags(state, stateMask, lvItem);
964
965 const bool changingFocus = (stateMask & wxLIST_STATE_FOCUSED) &&
966 (state & wxLIST_STATE_FOCUSED);
967
968 // for the virtual list controls we need to refresh the previously focused
969 // item manually when changing focus without changing selection
970 // programmatically because otherwise it keeps its focus rectangle until
971 // next repaint (yet another comctl32 bug)
972 long focusOld;
973 if ( IsVirtual() && changingFocus )
974 {
975 focusOld = GetNextItem(-1, wxLIST_NEXT_ALL, wxLIST_STATE_FOCUSED);
976 }
977 else
978 {
979 focusOld = -1;
980 }
981
982 if ( !::SendMessage(GetHwnd(), LVM_SETITEMSTATE,
983 (WPARAM)item, (LPARAM)&lvItem) )
984 {
985 wxLogLastError(wxT("ListView_SetItemState"));
986
987 return false;
988 }
989
990 if ( focusOld != -1 )
991 {
992 // no need to refresh the item if it was previously selected, it would
993 // only result in annoying flicker
994 if ( !(GetItemState(focusOld,
995 wxLIST_STATE_SELECTED) & wxLIST_STATE_SELECTED) )
996 {
997 RefreshItem(focusOld);
998 }
999 }
1000
1001 // we expect the selection anchor, i.e. the item from which multiple
1002 // selection (such as performed with e.g. Shift-arrows) starts, to be the
1003 // same as the currently focused item but the native control doesn't update
1004 // it when we change focus and leaves at the last item it set itself focus
1005 // to, so do it explicitly
1006 if ( changingFocus && !HasFlag(wxLC_SINGLE_SEL) )
1007 {
1008 ListView_SetSelectionMark(GetHwnd(), item);
1009 }
1010
1011 return true;
1012 }
1013
1014 // Sets the item image
1015 bool wxListCtrl::SetItemImage(long item, int image, int WXUNUSED(selImage))
1016 {
1017 return SetItemColumnImage(item, 0, image);
1018 }
1019
1020 // Sets the item image
1021 bool wxListCtrl::SetItemColumnImage(long item, long column, int image)
1022 {
1023 wxListItem info;
1024
1025 info.m_mask = wxLIST_MASK_IMAGE;
1026 info.m_image = image;
1027 info.m_itemId = item;
1028 info.m_col = column;
1029
1030 return SetItem(info);
1031 }
1032
1033 // Gets the item text
1034 wxString wxListCtrl::GetItemText(long item) const
1035 {
1036 wxListItem info;
1037
1038 info.m_mask = wxLIST_MASK_TEXT;
1039 info.m_itemId = item;
1040
1041 if (!GetItem(info))
1042 return wxEmptyString;
1043 return info.m_text;
1044 }
1045
1046 // Sets the item text
1047 void wxListCtrl::SetItemText(long item, const wxString& str)
1048 {
1049 wxListItem info;
1050
1051 info.m_mask = wxLIST_MASK_TEXT;
1052 info.m_itemId = item;
1053 info.m_text = str;
1054
1055 SetItem(info);
1056 }
1057
1058 // Gets the internal item data
1059 wxMSWListItemData *wxListCtrl::MSWGetItemData(long itemId) const
1060 {
1061 LV_ITEM it;
1062 it.mask = LVIF_PARAM;
1063 it.iItem = itemId;
1064
1065 if ( !ListView_GetItem(GetHwnd(), &it) )
1066 return NULL;
1067
1068 return (wxMSWListItemData *) it.lParam;
1069 }
1070
1071 // Gets the item data
1072 wxUIntPtr wxListCtrl::GetItemData(long item) const
1073 {
1074 wxListItem info;
1075
1076 info.m_mask = wxLIST_MASK_DATA;
1077 info.m_itemId = item;
1078
1079 if (!GetItem(info))
1080 return 0;
1081 return info.m_data;
1082 }
1083
1084 // Sets the item data
1085 bool wxListCtrl::SetItemPtrData(long item, wxUIntPtr data)
1086 {
1087 wxListItem info;
1088
1089 info.m_mask = wxLIST_MASK_DATA;
1090 info.m_itemId = item;
1091 info.m_data = data;
1092
1093 return SetItem(info);
1094 }
1095
1096 wxRect wxListCtrl::GetViewRect() const
1097 {
1098 wxRect rect;
1099
1100 // ListView_GetViewRect() can only be used in icon and small icon views
1101 // (this is documented in MSDN and, indeed, it returns bogus results in
1102 // report view, at least with comctl32.dll v6 under Windows 2003)
1103 if ( HasFlag(wxLC_ICON | wxLC_SMALL_ICON) )
1104 {
1105 RECT rc;
1106 if ( !ListView_GetViewRect(GetHwnd(), &rc) )
1107 {
1108 wxLogDebug(wxT("ListView_GetViewRect() failed."));
1109
1110 wxZeroMemory(rc);
1111 }
1112
1113 wxCopyRECTToRect(rc, rect);
1114 }
1115 else if ( HasFlag(wxLC_REPORT) )
1116 {
1117 const long count = GetItemCount();
1118 if ( count )
1119 {
1120 GetItemRect(wxMin(GetTopItem() + GetCountPerPage(), count - 1), rect);
1121
1122 // extend the rectangle to start at the top (we include the column
1123 // headers, if any, for compatibility with the generic version)
1124 rect.height += rect.y;
1125 rect.y = 0;
1126 }
1127 }
1128 else
1129 {
1130 wxFAIL_MSG( wxT("not implemented in this mode") );
1131 }
1132
1133 return rect;
1134 }
1135
1136 // Gets the item rectangle
1137 bool wxListCtrl::GetItemRect(long item, wxRect& rect, int code) const
1138 {
1139 return GetSubItemRect( item, wxLIST_GETSUBITEMRECT_WHOLEITEM, rect, code) ;
1140 }
1141
1142 bool wxListCtrl::GetSubItemRect(long item, long subItem, wxRect& rect, int code) const
1143 {
1144 // ListView_GetSubItemRect() doesn't do subItem error checking and returns
1145 // true even for the out of range values of it (even if the results are
1146 // completely bogus in this case), so we check item validity ourselves
1147 wxCHECK_MSG( subItem == wxLIST_GETSUBITEMRECT_WHOLEITEM ||
1148 (subItem >= 0 && subItem < GetColumnCount()),
1149 false, wxT("invalid sub item index") );
1150
1151 // use wxCHECK_MSG against "item" too, for coherency with the generic implementation:
1152 wxCHECK_MSG( item >= 0 && item < GetItemCount(), false,
1153 wxT("invalid item in GetSubItemRect") );
1154
1155 int codeWin;
1156 if ( code == wxLIST_RECT_BOUNDS )
1157 codeWin = LVIR_BOUNDS;
1158 else if ( code == wxLIST_RECT_ICON )
1159 codeWin = LVIR_ICON;
1160 else if ( code == wxLIST_RECT_LABEL )
1161 codeWin = LVIR_LABEL;
1162 else
1163 {
1164 wxFAIL_MSG( wxT("incorrect code in GetItemRect() / GetSubItemRect()") );
1165 codeWin = LVIR_BOUNDS;
1166 }
1167
1168 RECT rectWin;
1169 if ( !wxGetListCtrlSubItemRect
1170 (
1171 GetHwnd(),
1172 item,
1173 subItem == wxLIST_GETSUBITEMRECT_WHOLEITEM ? 0 : subItem,
1174 codeWin,
1175 rectWin
1176 ) )
1177 {
1178 return false;
1179 }
1180
1181 wxCopyRECTToRect(rectWin, rect);
1182
1183 // there is no way to retrieve the first sub item bounding rectangle using
1184 // wxGetListCtrlSubItemRect() as 0 means the whole item, so we need to
1185 // truncate it at first column ourselves
1186 if ( subItem == 0 && code == wxLIST_RECT_BOUNDS )
1187 rect.width = GetColumnWidth(0);
1188
1189 return true;
1190 }
1191
1192
1193
1194
1195 // Gets the item position
1196 bool wxListCtrl::GetItemPosition(long item, wxPoint& pos) const
1197 {
1198 POINT pt;
1199
1200 bool success = (ListView_GetItemPosition(GetHwnd(), (int) item, &pt) != 0);
1201
1202 pos.x = pt.x; pos.y = pt.y;
1203 return success;
1204 }
1205
1206 // Sets the item position.
1207 bool wxListCtrl::SetItemPosition(long item, const wxPoint& pos)
1208 {
1209 return (ListView_SetItemPosition(GetHwnd(), (int) item, pos.x, pos.y) != 0);
1210 }
1211
1212 // Gets the number of items in the list control
1213 int wxListCtrl::GetItemCount() const
1214 {
1215 return m_count;
1216 }
1217
1218 wxSize wxListCtrl::GetItemSpacing() const
1219 {
1220 const int spacing = ListView_GetItemSpacing(GetHwnd(), (BOOL)HasFlag(wxLC_SMALL_ICON));
1221
1222 return wxSize(LOWORD(spacing), HIWORD(spacing));
1223 }
1224
1225 #if WXWIN_COMPATIBILITY_2_6
1226
1227 int wxListCtrl::GetItemSpacing(bool isSmall) const
1228 {
1229 return ListView_GetItemSpacing(GetHwnd(), (BOOL) isSmall);
1230 }
1231
1232 #endif // WXWIN_COMPATIBILITY_2_6
1233
1234 void wxListCtrl::SetItemTextColour( long item, const wxColour &col )
1235 {
1236 wxListItem info;
1237 info.m_itemId = item;
1238 info.SetTextColour( col );
1239 SetItem( info );
1240 }
1241
1242 wxColour wxListCtrl::GetItemTextColour( long item ) const
1243 {
1244 wxColour col;
1245 wxMSWListItemData *data = MSWGetItemData(item);
1246 if ( data && data->attr )
1247 col = data->attr->GetTextColour();
1248
1249 return col;
1250 }
1251
1252 void wxListCtrl::SetItemBackgroundColour( long item, const wxColour &col )
1253 {
1254 wxListItem info;
1255 info.m_itemId = item;
1256 info.SetBackgroundColour( col );
1257 SetItem( info );
1258 }
1259
1260 wxColour wxListCtrl::GetItemBackgroundColour( long item ) const
1261 {
1262 wxColour col;
1263 wxMSWListItemData *data = MSWGetItemData(item);
1264 if ( data && data->attr )
1265 col = data->attr->GetBackgroundColour();
1266
1267 return col;
1268 }
1269
1270 void wxListCtrl::SetItemFont( long item, const wxFont &f )
1271 {
1272 wxListItem info;
1273 info.m_itemId = item;
1274 info.SetFont( f );
1275 SetItem( info );
1276 }
1277
1278 wxFont wxListCtrl::GetItemFont( long item ) const
1279 {
1280 wxFont f;
1281 wxMSWListItemData *data = MSWGetItemData(item);
1282 if ( data && data->attr )
1283 f = data->attr->GetFont();
1284
1285 return f;
1286 }
1287
1288 // Gets the number of selected items in the list control
1289 int wxListCtrl::GetSelectedItemCount() const
1290 {
1291 return ListView_GetSelectedCount(GetHwnd());
1292 }
1293
1294 // Gets the text colour of the listview
1295 wxColour wxListCtrl::GetTextColour() const
1296 {
1297 COLORREF ref = ListView_GetTextColor(GetHwnd());
1298 wxColour col(GetRValue(ref), GetGValue(ref), GetBValue(ref));
1299 return col;
1300 }
1301
1302 // Sets the text colour of the listview
1303 void wxListCtrl::SetTextColour(const wxColour& col)
1304 {
1305 ListView_SetTextColor(GetHwnd(), PALETTERGB(col.Red(), col.Green(), col.Blue()));
1306 }
1307
1308 // Gets the index of the topmost visible item when in
1309 // list or report view
1310 long wxListCtrl::GetTopItem() const
1311 {
1312 return (long) ListView_GetTopIndex(GetHwnd());
1313 }
1314
1315 // Searches for an item, starting from 'item'.
1316 // 'geometry' is one of
1317 // wxLIST_NEXT_ABOVE/ALL/BELOW/LEFT/RIGHT.
1318 // 'state' is a state bit flag, one or more of
1319 // wxLIST_STATE_DROPHILITED/FOCUSED/SELECTED/CUT.
1320 // item can be -1 to find the first item that matches the
1321 // specified flags.
1322 // Returns the item or -1 if unsuccessful.
1323 long wxListCtrl::GetNextItem(long item, int geom, int state) const
1324 {
1325 long flags = 0;
1326
1327 if ( geom == wxLIST_NEXT_ABOVE )
1328 flags |= LVNI_ABOVE;
1329 if ( geom == wxLIST_NEXT_ALL )
1330 flags |= LVNI_ALL;
1331 if ( geom == wxLIST_NEXT_BELOW )
1332 flags |= LVNI_BELOW;
1333 if ( geom == wxLIST_NEXT_LEFT )
1334 flags |= LVNI_TOLEFT;
1335 if ( geom == wxLIST_NEXT_RIGHT )
1336 flags |= LVNI_TORIGHT;
1337
1338 if ( state & wxLIST_STATE_CUT )
1339 flags |= LVNI_CUT;
1340 if ( state & wxLIST_STATE_DROPHILITED )
1341 flags |= LVNI_DROPHILITED;
1342 if ( state & wxLIST_STATE_FOCUSED )
1343 flags |= LVNI_FOCUSED;
1344 if ( state & wxLIST_STATE_SELECTED )
1345 flags |= LVNI_SELECTED;
1346
1347 return (long) ListView_GetNextItem(GetHwnd(), item, flags);
1348 }
1349
1350
1351 wxImageList *wxListCtrl::GetImageList(int which) const
1352 {
1353 if ( which == wxIMAGE_LIST_NORMAL )
1354 {
1355 return m_imageListNormal;
1356 }
1357 else if ( which == wxIMAGE_LIST_SMALL )
1358 {
1359 return m_imageListSmall;
1360 }
1361 else if ( which == wxIMAGE_LIST_STATE )
1362 {
1363 return m_imageListState;
1364 }
1365 return NULL;
1366 }
1367
1368 void wxListCtrl::SetImageList(wxImageList *imageList, int which)
1369 {
1370 int flags = 0;
1371 if ( which == wxIMAGE_LIST_NORMAL )
1372 {
1373 flags = LVSIL_NORMAL;
1374 if (m_ownsImageListNormal) delete m_imageListNormal;
1375 m_imageListNormal = imageList;
1376 m_ownsImageListNormal = false;
1377 }
1378 else if ( which == wxIMAGE_LIST_SMALL )
1379 {
1380 flags = LVSIL_SMALL;
1381 if (m_ownsImageListSmall) delete m_imageListSmall;
1382 m_imageListSmall = imageList;
1383 m_ownsImageListSmall = false;
1384 }
1385 else if ( which == wxIMAGE_LIST_STATE )
1386 {
1387 flags = LVSIL_STATE;
1388 if (m_ownsImageListState) delete m_imageListState;
1389 m_imageListState = imageList;
1390 m_ownsImageListState = false;
1391 }
1392 (void) ListView_SetImageList(GetHwnd(), (HIMAGELIST) imageList ? imageList->GetHIMAGELIST() : 0, flags);
1393 }
1394
1395 void wxListCtrl::AssignImageList(wxImageList *imageList, int which)
1396 {
1397 SetImageList(imageList, which);
1398 if ( which == wxIMAGE_LIST_NORMAL )
1399 m_ownsImageListNormal = true;
1400 else if ( which == wxIMAGE_LIST_SMALL )
1401 m_ownsImageListSmall = true;
1402 else if ( which == wxIMAGE_LIST_STATE )
1403 m_ownsImageListState = true;
1404 }
1405
1406 // ----------------------------------------------------------------------------
1407 // Operations
1408 // ----------------------------------------------------------------------------
1409
1410 // Arranges the items
1411 bool wxListCtrl::Arrange(int flag)
1412 {
1413 UINT code = 0;
1414 if ( flag == wxLIST_ALIGN_LEFT )
1415 code = LVA_ALIGNLEFT;
1416 else if ( flag == wxLIST_ALIGN_TOP )
1417 code = LVA_ALIGNTOP;
1418 else if ( flag == wxLIST_ALIGN_DEFAULT )
1419 code = LVA_DEFAULT;
1420 else if ( flag == wxLIST_ALIGN_SNAP_TO_GRID )
1421 code = LVA_SNAPTOGRID;
1422
1423 return (ListView_Arrange(GetHwnd(), code) != 0);
1424 }
1425
1426 // Deletes an item
1427 bool wxListCtrl::DeleteItem(long item)
1428 {
1429 if ( !ListView_DeleteItem(GetHwnd(), (int) item) )
1430 {
1431 wxLogLastError(wxT("ListView_DeleteItem"));
1432 return false;
1433 }
1434
1435 m_count--;
1436 wxASSERT_MSG( m_count == ListView_GetItemCount(GetHwnd()),
1437 wxT("m_count should match ListView_GetItemCount"));
1438
1439 // the virtual list control doesn't refresh itself correctly, help it
1440 if ( IsVirtual() )
1441 {
1442 // we need to refresh all the lines below the one which was deleted
1443 wxRect rectItem;
1444 if ( item > 0 && GetItemCount() )
1445 {
1446 GetItemRect(item - 1, rectItem);
1447 }
1448 else
1449 {
1450 rectItem.y =
1451 rectItem.height = 0;
1452 }
1453
1454 wxRect rectWin = GetRect();
1455 rectWin.height = rectWin.GetBottom() - rectItem.GetBottom();
1456 rectWin.y = rectItem.GetBottom();
1457
1458 RefreshRect(rectWin);
1459 }
1460
1461 return true;
1462 }
1463
1464 // Deletes all items
1465 bool wxListCtrl::DeleteAllItems()
1466 {
1467 return ListView_DeleteAllItems(GetHwnd()) != 0;
1468 }
1469
1470 // Deletes all items
1471 bool wxListCtrl::DeleteAllColumns()
1472 {
1473 while ( m_colCount > 0 )
1474 {
1475 if ( ListView_DeleteColumn(GetHwnd(), 0) == 0 )
1476 {
1477 wxLogLastError(wxT("ListView_DeleteColumn"));
1478
1479 return false;
1480 }
1481
1482 m_colCount--;
1483 }
1484
1485 wxASSERT_MSG( m_colCount == 0, wxT("no columns should be left") );
1486
1487 return true;
1488 }
1489
1490 // Deletes a column
1491 bool wxListCtrl::DeleteColumn(int col)
1492 {
1493 bool success = (ListView_DeleteColumn(GetHwnd(), col) != 0);
1494
1495 if ( success && (m_colCount > 0) )
1496 m_colCount --;
1497 return success;
1498 }
1499
1500 // Clears items, and columns if there are any.
1501 void wxListCtrl::ClearAll()
1502 {
1503 DeleteAllItems();
1504 if ( m_colCount > 0 )
1505 DeleteAllColumns();
1506 }
1507
1508 void wxListCtrl::InitEditControl(WXHWND hWnd)
1509 {
1510 m_textCtrl->SetHWND(hWnd);
1511 m_textCtrl->SubclassWin(hWnd);
1512 m_textCtrl->SetParent(this);
1513
1514 // we must disallow TABbing away from the control while the edit contol is
1515 // shown because this leaves it in some strange state (just try removing
1516 // this line and then pressing TAB while editing an item in listctrl
1517 // inside a panel)
1518 m_textCtrl->SetWindowStyle(m_textCtrl->GetWindowStyle() | wxTE_PROCESS_TAB);
1519 }
1520
1521 wxTextCtrl* wxListCtrl::EditLabel(long item, wxClassInfo* textControlClass)
1522 {
1523 wxCHECK_MSG( textControlClass->IsKindOf(CLASSINFO(wxTextCtrl)), NULL,
1524 "control used for label editing must be a wxTextCtrl" );
1525
1526 // ListView_EditLabel requires that the list has focus.
1527 SetFocus();
1528
1529 // create m_textCtrl here before calling ListView_EditLabel() because it
1530 // generates wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT event from inside it and
1531 // the user handler for it can call GetEditControl() resulting in an on
1532 // demand creation of a stock wxTextCtrl instead of the control of a
1533 // (possibly) custom wxClassInfo
1534 DeleteEditControl();
1535 m_textCtrl = (wxTextCtrl *)textControlClass->CreateObject();
1536
1537 WXHWND hWnd = (WXHWND) ListView_EditLabel(GetHwnd(), item);
1538 if ( !hWnd )
1539 {
1540 // failed to start editing
1541 delete m_textCtrl;
1542 m_textCtrl = NULL;
1543
1544 return NULL;
1545 }
1546
1547 // if GetEditControl() hasn't been called, we need to initialize the edit
1548 // control ourselves
1549 if ( !m_textCtrl->GetHWND() )
1550 InitEditControl(hWnd);
1551
1552 return m_textCtrl;
1553 }
1554
1555 // End label editing, optionally cancelling the edit
1556 bool wxListCtrl::EndEditLabel(bool cancel)
1557 {
1558 // m_textCtrl is not always ready, ie. in EVT_LIST_BEGIN_LABEL_EDIT
1559 HWND hwnd = ListView_GetEditControl(GetHwnd());
1560 if ( !hwnd )
1561 return false;
1562
1563 if ( cancel )
1564 ::SetWindowText(hwnd, wxEmptyString); // dubious but better than nothing
1565
1566 // we shouldn't destroy the control ourselves according to MSDN, which
1567 // proposes WM_CANCELMODE to do this, but it doesn't seem to work
1568 //
1569 // posting WM_CLOSE to it does seem to work without any side effects
1570 ::PostMessage(hwnd, WM_CLOSE, 0, 0);
1571
1572 return true;
1573 }
1574
1575 // Ensures this item is visible
1576 bool wxListCtrl::EnsureVisible(long item)
1577 {
1578 return ListView_EnsureVisible(GetHwnd(), (int) item, FALSE) != FALSE;
1579 }
1580
1581 // Find an item whose label matches this string, starting from the item after 'start'
1582 // or the beginning if 'start' is -1.
1583 long wxListCtrl::FindItem(long start, const wxString& str, bool partial)
1584 {
1585 LV_FINDINFO findInfo;
1586
1587 findInfo.flags = LVFI_STRING;
1588 if ( partial )
1589 findInfo.flags |= LVFI_PARTIAL;
1590 findInfo.psz = str.wx_str();
1591
1592 // ListView_FindItem() excludes the first item from search and to look
1593 // through all the items you need to start from -1 which is unnatural and
1594 // inconsistent with the generic version - so we adjust the index
1595 if (start != -1)
1596 start --;
1597 return ListView_FindItem(GetHwnd(), start, &findInfo);
1598 }
1599
1600 // Find an item whose data matches this data, starting from the item after
1601 // 'start' or the beginning if 'start' is -1.
1602 long wxListCtrl::FindItem(long start, wxUIntPtr data)
1603 {
1604 // we can't use ListView_FindItem() directly as we don't store the data
1605 // pointer itself in the control but rather our own internal data, so first
1606 // we need to find the right value to search for (and there can be several
1607 // of them)
1608 int idx = wxNOT_FOUND;
1609 const unsigned count = m_internalData.size();
1610 for ( unsigned n = 0; n < count; n++ )
1611 {
1612 if ( m_internalData[n]->lParam == (LPARAM)data )
1613 {
1614 LV_FINDINFO findInfo;
1615 findInfo.flags = LVFI_PARAM;
1616 findInfo.lParam = (LPARAM)wxPtrToUInt(m_internalData[n]);
1617
1618 int rc = ListView_FindItem(GetHwnd(), start, &findInfo);
1619 if ( rc != -1 )
1620 {
1621 if ( idx == wxNOT_FOUND || rc < idx )
1622 {
1623 idx = rc;
1624 if ( idx == start + 1 )
1625 {
1626 // we can stop here, we don't risk finding a closer
1627 // match
1628 break;
1629 }
1630 }
1631 //else: this item is after the previously found one
1632 }
1633 }
1634 }
1635
1636 return idx;
1637 }
1638
1639 // Find an item nearest this position in the specified direction, starting from
1640 // the item after 'start' or the beginning if 'start' is -1.
1641 long wxListCtrl::FindItem(long start, const wxPoint& pt, int direction)
1642 {
1643 LV_FINDINFO findInfo;
1644
1645 findInfo.flags = LVFI_NEARESTXY;
1646 findInfo.pt.x = pt.x;
1647 findInfo.pt.y = pt.y;
1648 findInfo.vkDirection = VK_RIGHT;
1649
1650 if ( direction == wxLIST_FIND_UP )
1651 findInfo.vkDirection = VK_UP;
1652 else if ( direction == wxLIST_FIND_DOWN )
1653 findInfo.vkDirection = VK_DOWN;
1654 else if ( direction == wxLIST_FIND_LEFT )
1655 findInfo.vkDirection = VK_LEFT;
1656 else if ( direction == wxLIST_FIND_RIGHT )
1657 findInfo.vkDirection = VK_RIGHT;
1658
1659 return ListView_FindItem(GetHwnd(), start, &findInfo);
1660 }
1661
1662 // Determines which item (if any) is at the specified point,
1663 // giving details in 'flags' (see wxLIST_HITTEST_... flags above)
1664 long
1665 wxListCtrl::HitTest(const wxPoint& point, int& flags, long *ptrSubItem) const
1666 {
1667 LV_HITTESTINFO hitTestInfo;
1668 hitTestInfo.pt.x = (int) point.x;
1669 hitTestInfo.pt.y = (int) point.y;
1670
1671 long item;
1672 #ifdef LVM_SUBITEMHITTEST
1673 if ( ptrSubItem && wxApp::GetComCtl32Version() >= 470 )
1674 {
1675 item = ListView_SubItemHitTest(GetHwnd(), &hitTestInfo);
1676 *ptrSubItem = hitTestInfo.iSubItem;
1677 }
1678 else
1679 #endif // LVM_SUBITEMHITTEST
1680 {
1681 item = ListView_HitTest(GetHwnd(), &hitTestInfo);
1682 }
1683
1684 flags = 0;
1685
1686 if ( hitTestInfo.flags & LVHT_ABOVE )
1687 flags |= wxLIST_HITTEST_ABOVE;
1688 if ( hitTestInfo.flags & LVHT_BELOW )
1689 flags |= wxLIST_HITTEST_BELOW;
1690 if ( hitTestInfo.flags & LVHT_TOLEFT )
1691 flags |= wxLIST_HITTEST_TOLEFT;
1692 if ( hitTestInfo.flags & LVHT_TORIGHT )
1693 flags |= wxLIST_HITTEST_TORIGHT;
1694
1695 if ( hitTestInfo.flags & LVHT_NOWHERE )
1696 flags |= wxLIST_HITTEST_NOWHERE;
1697
1698 // note a bug or at least a very strange feature of comtl32.dll (tested
1699 // with version 4.0 under Win95 and 6.0 under Win 2003): if you click to
1700 // the right of the item label, ListView_HitTest() returns a combination of
1701 // LVHT_ONITEMICON, LVHT_ONITEMLABEL and LVHT_ONITEMSTATEICON -- filter out
1702 // the bits which don't make sense
1703 if ( hitTestInfo.flags & LVHT_ONITEMLABEL )
1704 {
1705 flags |= wxLIST_HITTEST_ONITEMLABEL;
1706
1707 // do not translate LVHT_ONITEMICON here, as per above
1708 }
1709 else
1710 {
1711 if ( hitTestInfo.flags & LVHT_ONITEMICON )
1712 flags |= wxLIST_HITTEST_ONITEMICON;
1713 if ( hitTestInfo.flags & LVHT_ONITEMSTATEICON )
1714 flags |= wxLIST_HITTEST_ONITEMSTATEICON;
1715 }
1716
1717 return item;
1718 }
1719
1720
1721 // Inserts an item, returning the index of the new item if successful,
1722 // -1 otherwise.
1723 long wxListCtrl::InsertItem(const wxListItem& info)
1724 {
1725 wxASSERT_MSG( !IsVirtual(), wxT("can't be used with virtual controls") );
1726
1727 LV_ITEM item;
1728 wxConvertToMSWListItem(this, info, item);
1729 item.mask &= ~LVIF_PARAM;
1730
1731 // check whether we need to allocate our internal data
1732 bool needInternalData = (info.m_mask & wxLIST_MASK_DATA) ||
1733 info.HasAttributes();
1734 if ( needInternalData )
1735 {
1736 item.mask |= LVIF_PARAM;
1737
1738 wxMSWListItemData * const data = new wxMSWListItemData;
1739 m_internalData.push_back(data);
1740 item.lParam = (LPARAM)data;
1741
1742 if ( info.m_mask & wxLIST_MASK_DATA )
1743 data->lParam = info.m_data;
1744
1745 // check whether it has any custom attributes
1746 if ( info.HasAttributes() )
1747 {
1748 // take copy of attributes
1749 data->attr = new wxListItemAttr(*info.GetAttributes());
1750
1751 // and remember that we have some now...
1752 m_hasAnyAttr = true;
1753 }
1754 }
1755
1756 const long rv = ListView_InsertItem(GetHwnd(), & item);
1757
1758 // failing to insert the item is really unexpected
1759 wxCHECK_MSG( rv != -1, rv, "failed to insert an item in wxListCtrl" );
1760
1761 m_count++;
1762 wxASSERT_MSG( m_count == ListView_GetItemCount(GetHwnd()),
1763 wxT("m_count should match ListView_GetItemCount"));
1764
1765 return rv;
1766 }
1767
1768 long wxListCtrl::InsertItem(long index, const wxString& label)
1769 {
1770 wxListItem info;
1771 info.m_text = label;
1772 info.m_mask = wxLIST_MASK_TEXT;
1773 info.m_itemId = index;
1774 return InsertItem(info);
1775 }
1776
1777 // Inserts an image item
1778 long wxListCtrl::InsertItem(long index, int imageIndex)
1779 {
1780 wxListItem info;
1781 info.m_image = imageIndex;
1782 info.m_mask = wxLIST_MASK_IMAGE;
1783 info.m_itemId = index;
1784 return InsertItem(info);
1785 }
1786
1787 // Inserts an image/string item
1788 long wxListCtrl::InsertItem(long index, const wxString& label, int imageIndex)
1789 {
1790 wxListItem info;
1791 info.m_image = imageIndex;
1792 info.m_text = label;
1793 info.m_mask = wxLIST_MASK_IMAGE | wxLIST_MASK_TEXT;
1794 info.m_itemId = index;
1795 return InsertItem(info);
1796 }
1797
1798 // For list view mode (only), inserts a column.
1799 long wxListCtrl::InsertColumn(long col, const wxListItem& item)
1800 {
1801 LV_COLUMN lvCol;
1802 wxConvertToMSWListCol(GetHwnd(), col, item, lvCol);
1803
1804 if ( !(lvCol.mask & LVCF_WIDTH) )
1805 {
1806 // always give some width to the new column: this one is compatible
1807 // with the generic version
1808 lvCol.mask |= LVCF_WIDTH;
1809 lvCol.cx = 80;
1810 }
1811
1812 long n = ListView_InsertColumn(GetHwnd(), col, &lvCol);
1813 if ( n != -1 )
1814 {
1815 m_colCount++;
1816 }
1817 else // failed to insert?
1818 {
1819 wxLogDebug(wxT("Failed to insert the column '%s' into listview!"),
1820 lvCol.pszText);
1821 }
1822
1823 return n;
1824 }
1825
1826 long wxListCtrl::InsertColumn(long col,
1827 const wxString& heading,
1828 int format,
1829 int width)
1830 {
1831 wxListItem item;
1832 item.m_mask = wxLIST_MASK_TEXT | wxLIST_MASK_FORMAT;
1833 item.m_text = heading;
1834 if ( width > -1 )
1835 {
1836 item.m_mask |= wxLIST_MASK_WIDTH;
1837 item.m_width = width;
1838 }
1839 item.m_format = format;
1840
1841 return InsertColumn(col, item);
1842 }
1843
1844 // scroll the control by the given number of pixels (exception: in list view,
1845 // dx is interpreted as number of columns)
1846 bool wxListCtrl::ScrollList(int dx, int dy)
1847 {
1848 if ( !ListView_Scroll(GetHwnd(), dx, dy) )
1849 {
1850 wxLogDebug(wxT("ListView_Scroll(%d, %d) failed"), dx, dy);
1851
1852 return false;
1853 }
1854
1855 return true;
1856 }
1857
1858 // Sort items.
1859
1860 // fn is a function which takes 3 long arguments: item1, item2, data.
1861 // item1 is the long data associated with a first item (NOT the index).
1862 // item2 is the long data associated with a second item (NOT the index).
1863 // data is the same value as passed to SortItems.
1864 // The return value is a negative number if the first item should precede the second
1865 // item, a positive number of the second item should precede the first,
1866 // or zero if the two items are equivalent.
1867
1868 // data is arbitrary data to be passed to the sort function.
1869
1870 // Internal structures for proxying the user compare function
1871 // so that we can pass it the *real* user data
1872
1873 // translate lParam data and call user func
1874 struct wxInternalDataSort
1875 {
1876 wxListCtrlCompare user_fn;
1877 wxIntPtr data;
1878 };
1879
1880 int CALLBACK wxInternalDataCompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort)
1881 {
1882 wxInternalDataSort * const internalData = (wxInternalDataSort *) lParamSort;
1883
1884 wxMSWListItemData *data1 = (wxMSWListItemData *) lParam1;
1885 wxMSWListItemData *data2 = (wxMSWListItemData *) lParam2;
1886
1887 long d1 = (data1 == NULL ? 0 : data1->lParam);
1888 long d2 = (data2 == NULL ? 0 : data2->lParam);
1889
1890 return internalData->user_fn(d1, d2, internalData->data);
1891
1892 }
1893
1894 bool wxListCtrl::SortItems(wxListCtrlCompare fn, wxIntPtr data)
1895 {
1896 wxInternalDataSort internalData;
1897 internalData.user_fn = fn;
1898 internalData.data = data;
1899
1900 // WPARAM cast is needed for mingw/cygwin
1901 if ( !ListView_SortItems(GetHwnd(),
1902 wxInternalDataCompareFunc,
1903 (WPARAM) &internalData) )
1904 {
1905 wxLogDebug(wxT("ListView_SortItems() failed"));
1906
1907 return false;
1908 }
1909
1910 return true;
1911 }
1912
1913
1914
1915 // ----------------------------------------------------------------------------
1916 // message processing
1917 // ----------------------------------------------------------------------------
1918
1919 bool wxListCtrl::MSWShouldPreProcessMessage(WXMSG* msg)
1920 {
1921 if ( msg->message == WM_KEYDOWN )
1922 {
1923 // Only eat VK_RETURN if not being used by the application in
1924 // conjunction with modifiers
1925 if ( msg->wParam == VK_RETURN && !wxIsAnyModifierDown() )
1926 {
1927 // we need VK_RETURN to generate wxEVT_COMMAND_LIST_ITEM_ACTIVATED
1928 return false;
1929 }
1930 }
1931 return wxControl::MSWShouldPreProcessMessage(msg);
1932 }
1933
1934 bool wxListCtrl::MSWCommand(WXUINT cmd, WXWORD id_)
1935 {
1936 const int id = (signed short)id_;
1937 if (cmd == EN_UPDATE)
1938 {
1939 wxCommandEvent event(wxEVT_COMMAND_TEXT_UPDATED, id);
1940 event.SetEventObject( this );
1941 ProcessCommand(event);
1942 return true;
1943 }
1944 else if (cmd == EN_KILLFOCUS)
1945 {
1946 wxCommandEvent event(wxEVT_KILL_FOCUS, id);
1947 event.SetEventObject( this );
1948 ProcessCommand(event);
1949 return true;
1950 }
1951 else
1952 return false;
1953 }
1954
1955 // utility used by wxListCtrl::MSWOnNotify and by wxDataViewHeaderWindowMSW::MSWOnNotify
1956 int WXDLLIMPEXP_CORE wxMSWGetColumnClicked(NMHDR *nmhdr, POINT *ptClick)
1957 {
1958 // find the column clicked: we have to search for it ourselves as the
1959 // notification message doesn't provide this info
1960
1961 // where did the click occur?
1962 #if defined(__WXWINCE__) && !defined(__HANDHELDPC__) && _WIN32_WCE < 400
1963 if ( nmhdr->code == GN_CONTEXTMENU )
1964 {
1965 *ptClick = ((NMRGINFO*)nmhdr)->ptAction;
1966 }
1967 else
1968 #endif //__WXWINCE__
1969 if ( !::GetCursorPos(ptClick) )
1970 {
1971 wxLogLastError(wxT("GetCursorPos"));
1972 }
1973
1974 // we need to use listctrl coordinates for the event point so this is what
1975 // we return in ptClick, but for comparison with Header_GetItemRect()
1976 // result below we need to use header window coordinates
1977 POINT ptClickHeader = *ptClick;
1978 if ( !::ScreenToClient(nmhdr->hwndFrom, &ptClickHeader) )
1979 {
1980 wxLogLastError(wxT("ScreenToClient(listctrl header)"));
1981 }
1982
1983 if ( !::ScreenToClient(::GetParent(nmhdr->hwndFrom), ptClick) )
1984 {
1985 wxLogLastError(wxT("ScreenToClient(listctrl)"));
1986 }
1987
1988 const int colCount = Header_GetItemCount(nmhdr->hwndFrom);
1989 for ( int col = 0; col < colCount; col++ )
1990 {
1991 RECT rect;
1992 if ( Header_GetItemRect(nmhdr->hwndFrom, col, &rect) )
1993 {
1994 if ( ::PtInRect(&rect, ptClickHeader) )
1995 {
1996 return col;
1997 }
1998 }
1999 }
2000
2001 return wxNOT_FOUND;
2002 }
2003
2004 bool wxListCtrl::MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result)
2005 {
2006
2007 // prepare the event
2008 // -----------------
2009
2010 wxListEvent event(wxEVT_NULL, m_windowId);
2011 event.SetEventObject(this);
2012
2013 wxEventType eventType = wxEVT_NULL;
2014
2015 NMHDR *nmhdr = (NMHDR *)lParam;
2016
2017 // if your compiler is as broken as this, you should really change it: this
2018 // code is needed for normal operation! #ifdef below is only useful for
2019 // automatic rebuilds which are done with a very old compiler version
2020 #ifdef HDN_BEGINTRACKA
2021
2022 // check for messages from the header (in report view)
2023 HWND hwndHdr = ListView_GetHeader(GetHwnd());
2024
2025 // is it a message from the header?
2026 if ( nmhdr->hwndFrom == hwndHdr )
2027 {
2028 HD_NOTIFY *nmHDR = (HD_NOTIFY *)nmhdr;
2029
2030 event.m_itemIndex = -1;
2031
2032 bool ignore = false;
2033 switch ( nmhdr->code )
2034 {
2035 // yet another comctl32.dll bug: under NT/W2K it sends Unicode
2036 // TRACK messages even to ANSI programs: on my system I get
2037 // HDN_BEGINTRACKW and HDN_ENDTRACKA!
2038 //
2039 // work around is to simply catch both versions and hope that it
2040 // works (why should this message exist in ANSI and Unicode is
2041 // beyond me as it doesn't deal with strings at all...)
2042 //
2043 // another problem is that HDN_TRACK is not sent at all by header
2044 // with HDS_FULLDRAG style which is used by default by wxListCtrl
2045 // under recent Windows versions (starting from at least XP) so we
2046 // need to use HDN_ITEMCHANGING instead of it
2047 case HDN_BEGINTRACKA:
2048 case HDN_BEGINTRACKW:
2049 eventType = wxEVT_COMMAND_LIST_COL_BEGIN_DRAG;
2050 // fall through
2051
2052 case HDN_ITEMCHANGING:
2053 if ( eventType == wxEVT_NULL )
2054 {
2055 if ( !nmHDR->pitem || !(nmHDR->pitem->mask & HDI_WIDTH) )
2056 {
2057 // something other than the width is being changed,
2058 // ignore it
2059 ignore = true;
2060 break;
2061 }
2062
2063 // also ignore the events sent when the width didn't really
2064 // change: this is not just an optimization but also gets
2065 // rid of a useless and unexpected DRAGGING event which
2066 // would otherwise be sent after the END_DRAG one as we get
2067 // an HDN_ITEMCHANGING after HDN_ENDTRACK for some reason
2068 if ( nmHDR->pitem->cxy == GetColumnWidth(nmHDR->iItem) )
2069 {
2070 ignore = true;
2071 break;
2072 }
2073
2074 eventType = wxEVT_COMMAND_LIST_COL_DRAGGING;
2075 }
2076 // fall through
2077
2078 case HDN_ENDTRACKA:
2079 case HDN_ENDTRACKW:
2080 if ( eventType == wxEVT_NULL )
2081 eventType = wxEVT_COMMAND_LIST_COL_END_DRAG;
2082
2083 event.m_item.m_width = nmHDR->pitem->cxy;
2084 event.m_col = nmHDR->iItem;
2085 break;
2086
2087 #if defined(__WXWINCE__) && !defined(__HANDHELDPC__) && _WIN32_WCE < 400
2088 case GN_CONTEXTMENU:
2089 #endif //__WXWINCE__
2090 case NM_RCLICK:
2091 {
2092 POINT ptClick;
2093
2094 eventType = wxEVT_COMMAND_LIST_COL_RIGHT_CLICK;
2095 event.m_col = wxMSWGetColumnClicked(nmhdr, &ptClick);
2096 event.m_pointDrag.x = ptClick.x;
2097 event.m_pointDrag.y = ptClick.y;
2098 }
2099 break;
2100
2101 case HDN_GETDISPINFOW:
2102 // letting Windows XP handle this message results in mysterious
2103 // crashes in comctl32.dll seemingly because of bad message
2104 // parameters
2105 //
2106 // I have no idea what is the real cause of the bug (which is,
2107 // just to make things interesting, impossible to reproduce
2108 // reliably) but ignoring all these messages does fix it and
2109 // doesn't seem to have any negative consequences
2110 return true;
2111
2112 default:
2113 ignore = true;
2114 }
2115
2116 if ( ignore )
2117 return wxControl::MSWOnNotify(idCtrl, lParam, result);
2118 }
2119 else
2120 #endif // defined(HDN_BEGINTRACKA)
2121 if ( nmhdr->hwndFrom == GetHwnd() )
2122 {
2123 // almost all messages use NM_LISTVIEW
2124 NM_LISTVIEW *nmLV = (NM_LISTVIEW *)nmhdr;
2125
2126 const int iItem = nmLV->iItem;
2127
2128
2129 // If we have a valid item then check if there is a data value
2130 // associated with it and put it in the event.
2131 if ( iItem >= 0 && iItem < GetItemCount() )
2132 {
2133 wxMSWListItemData *internaldata =
2134 MSWGetItemData(iItem);
2135
2136 if ( internaldata )
2137 event.m_item.m_data = internaldata->lParam;
2138 }
2139
2140 bool processed = true;
2141 switch ( nmhdr->code )
2142 {
2143 case LVN_BEGINRDRAG:
2144 eventType = wxEVT_COMMAND_LIST_BEGIN_RDRAG;
2145 // fall through
2146
2147 case LVN_BEGINDRAG:
2148 if ( eventType == wxEVT_NULL )
2149 {
2150 eventType = wxEVT_COMMAND_LIST_BEGIN_DRAG;
2151 }
2152
2153 event.m_itemIndex = iItem;
2154 event.m_pointDrag.x = nmLV->ptAction.x;
2155 event.m_pointDrag.y = nmLV->ptAction.y;
2156 break;
2157
2158 // NB: we have to handle both *A and *W versions here because some
2159 // versions of comctl32.dll send ANSI messages even to the
2160 // Unicode windows
2161 case LVN_BEGINLABELEDITA:
2162 case LVN_BEGINLABELEDITW:
2163 {
2164 wxLV_ITEM item;
2165 if ( nmhdr->code == LVN_BEGINLABELEDITA )
2166 {
2167 item.Init(((LV_DISPINFOA *)lParam)->item);
2168 }
2169 else // LVN_BEGINLABELEDITW
2170 {
2171 item.Init(((LV_DISPINFOW *)lParam)->item);
2172 }
2173
2174 eventType = wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT;
2175 wxConvertFromMSWListItem(GetHwnd(), event.m_item, item);
2176 event.m_itemIndex = event.m_item.m_itemId;
2177 }
2178 break;
2179
2180 case LVN_ENDLABELEDITA:
2181 case LVN_ENDLABELEDITW:
2182 {
2183 wxLV_ITEM item;
2184 if ( nmhdr->code == LVN_ENDLABELEDITA )
2185 {
2186 item.Init(((LV_DISPINFOA *)lParam)->item);
2187 }
2188 else // LVN_ENDLABELEDITW
2189 {
2190 item.Init(((LV_DISPINFOW *)lParam)->item);
2191 }
2192
2193 // was editing cancelled?
2194 const LV_ITEM& lvi = (LV_ITEM)item;
2195 if ( !lvi.pszText || lvi.iItem == -1 )
2196 {
2197 // EDIT control will be deleted by the list control
2198 // itself so prevent us from deleting it as well
2199 DeleteEditControl();
2200
2201 event.SetEditCanceled(true);
2202 }
2203
2204 eventType = wxEVT_COMMAND_LIST_END_LABEL_EDIT;
2205 wxConvertFromMSWListItem(NULL, event.m_item, item);
2206 event.m_itemIndex = event.m_item.m_itemId;
2207 }
2208 break;
2209
2210 case LVN_COLUMNCLICK:
2211 eventType = wxEVT_COMMAND_LIST_COL_CLICK;
2212 event.m_itemIndex = -1;
2213 event.m_col = nmLV->iSubItem;
2214 break;
2215
2216 case LVN_DELETEALLITEMS:
2217 eventType = wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS;
2218 event.m_itemIndex = -1;
2219 break;
2220
2221 case LVN_DELETEITEM:
2222 if ( m_count == 0 )
2223 {
2224 // this should be prevented by the post-processing code
2225 // below, but "just in case"
2226 return false;
2227 }
2228
2229 eventType = wxEVT_COMMAND_LIST_DELETE_ITEM;
2230 event.m_itemIndex = iItem;
2231
2232 // delete the associated internal data
2233 if ( wxMSWListItemData *data = MSWGetItemData(iItem) )
2234 {
2235 const unsigned count = m_internalData.size();
2236 for ( unsigned n = 0; n < count; n++ )
2237 {
2238 if ( m_internalData[n] == data )
2239 {
2240 m_internalData.erase(m_internalData.begin() + n);
2241 delete data;
2242 data = NULL;
2243 break;
2244 }
2245 }
2246
2247 wxASSERT_MSG( !data, "invalid internal data pointer?" );
2248 }
2249 break;
2250
2251 case LVN_INSERTITEM:
2252 eventType = wxEVT_COMMAND_LIST_INSERT_ITEM;
2253 event.m_itemIndex = iItem;
2254 break;
2255
2256 case LVN_ITEMCHANGED:
2257 // we translate this catch all message into more interesting
2258 // (and more easy to process) wxWidgets events
2259
2260 // first of all, we deal with the state change events only and
2261 // only for valid items (item == -1 for the virtual list
2262 // control)
2263 if ( nmLV->uChanged & LVIF_STATE && iItem != -1 )
2264 {
2265 // temp vars for readability
2266 const UINT stOld = nmLV->uOldState;
2267 const UINT stNew = nmLV->uNewState;
2268
2269 event.m_item.SetId(iItem);
2270 event.m_item.SetMask(wxLIST_MASK_TEXT |
2271 wxLIST_MASK_IMAGE |
2272 wxLIST_MASK_DATA);
2273 GetItem(event.m_item);
2274
2275 // has the focus changed?
2276 if ( !(stOld & LVIS_FOCUSED) && (stNew & LVIS_FOCUSED) )
2277 {
2278 eventType = wxEVT_COMMAND_LIST_ITEM_FOCUSED;
2279 event.m_itemIndex = iItem;
2280 }
2281
2282 if ( (stNew & LVIS_SELECTED) != (stOld & LVIS_SELECTED) )
2283 {
2284 if ( eventType != wxEVT_NULL )
2285 {
2286 // focus and selection have both changed: send the
2287 // focus event from here and the selection one
2288 // below
2289 event.SetEventType(eventType);
2290 (void)HandleWindowEvent(event);
2291 }
2292 else // no focus event to send
2293 {
2294 // then need to set m_itemIndex as it wasn't done
2295 // above
2296 event.m_itemIndex = iItem;
2297 }
2298
2299 eventType = stNew & LVIS_SELECTED
2300 ? wxEVT_COMMAND_LIST_ITEM_SELECTED
2301 : wxEVT_COMMAND_LIST_ITEM_DESELECTED;
2302 }
2303 }
2304
2305 if ( eventType == wxEVT_NULL )
2306 {
2307 // not an interesting event for us
2308 return false;
2309 }
2310
2311 break;
2312
2313 case LVN_KEYDOWN:
2314 {
2315 LV_KEYDOWN *info = (LV_KEYDOWN *)lParam;
2316 WORD wVKey = info->wVKey;
2317
2318 // get the current selection
2319 long lItem = GetNextItem(-1,
2320 wxLIST_NEXT_ALL,
2321 wxLIST_STATE_SELECTED);
2322
2323 // <Enter> or <Space> activate the selected item if any (but
2324 // not with any modifiers as they have a predefined meaning
2325 // then)
2326 if ( lItem != -1 &&
2327 (wVKey == VK_RETURN || wVKey == VK_SPACE) &&
2328 !wxIsAnyModifierDown() )
2329 {
2330 eventType = wxEVT_COMMAND_LIST_ITEM_ACTIVATED;
2331 }
2332 else
2333 {
2334 eventType = wxEVT_COMMAND_LIST_KEY_DOWN;
2335
2336 // wxCharCodeMSWToWX() returns 0 if the key is an ASCII
2337 // value which should be used as is
2338 int code = wxCharCodeMSWToWX(wVKey);
2339 event.m_code = code ? code : wVKey;
2340 }
2341
2342 event.m_itemIndex =
2343 event.m_item.m_itemId = lItem;
2344
2345 if ( lItem != -1 )
2346 {
2347 // fill the other fields too
2348 event.m_item.m_text = GetItemText(lItem);
2349 event.m_item.m_data = GetItemData(lItem);
2350 }
2351 }
2352 break;
2353
2354 case NM_DBLCLK:
2355 // if the user processes it in wxEVT_COMMAND_LEFT_CLICK(), don't do
2356 // anything else
2357 if ( wxControl::MSWOnNotify(idCtrl, lParam, result) )
2358 {
2359 return true;
2360 }
2361
2362 // else translate it into wxEVT_COMMAND_LIST_ITEM_ACTIVATED event
2363 // if it happened on an item (and not on empty place)
2364 if ( iItem == -1 )
2365 {
2366 // not on item
2367 return false;
2368 }
2369
2370 eventType = wxEVT_COMMAND_LIST_ITEM_ACTIVATED;
2371 event.m_itemIndex = iItem;
2372 event.m_item.m_text = GetItemText(iItem);
2373 event.m_item.m_data = GetItemData(iItem);
2374 break;
2375
2376 #if defined(__WXWINCE__) && !defined(__HANDHELDPC__) && _WIN32_WCE < 400
2377 case GN_CONTEXTMENU:
2378 #endif //__WXWINCE__
2379 case NM_RCLICK:
2380 // if the user processes it in wxEVT_COMMAND_RIGHT_CLICK(),
2381 // don't do anything else
2382 if ( wxControl::MSWOnNotify(idCtrl, lParam, result) )
2383 {
2384 return true;
2385 }
2386
2387 // else translate it into wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK event
2388 LV_HITTESTINFO lvhti;
2389 wxZeroMemory(lvhti);
2390
2391 #if defined(__WXWINCE__) && !defined(__HANDHELDPC__) && _WIN32_WCE < 400
2392 if ( nmhdr->code == GN_CONTEXTMENU )
2393 {
2394 lvhti.pt = ((NMRGINFO*)nmhdr)->ptAction;
2395 }
2396 else
2397 #endif //__WXWINCE__
2398 {
2399 ::GetCursorPos(&(lvhti.pt));
2400 }
2401
2402 ::ScreenToClient(GetHwnd(), &lvhti.pt);
2403 if ( ListView_HitTest(GetHwnd(), &lvhti) != -1 )
2404 {
2405 if ( lvhti.flags & LVHT_ONITEM )
2406 {
2407 eventType = wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK;
2408 event.m_itemIndex = lvhti.iItem;
2409 event.m_pointDrag.x = lvhti.pt.x;
2410 event.m_pointDrag.y = lvhti.pt.y;
2411 }
2412 }
2413 break;
2414
2415 #ifdef NM_CUSTOMDRAW
2416 case NM_CUSTOMDRAW:
2417 *result = OnCustomDraw(lParam);
2418
2419 return *result != CDRF_DODEFAULT;
2420 #endif // _WIN32_IE >= 0x300
2421
2422 case LVN_ODCACHEHINT:
2423 {
2424 const NM_CACHEHINT *cacheHint = (NM_CACHEHINT *)lParam;
2425
2426 eventType = wxEVT_COMMAND_LIST_CACHE_HINT;
2427
2428 // we get some really stupid cache hints like ones for
2429 // items in range 0..0 for an empty control or, after
2430 // deleting an item, for items in invalid range -- filter
2431 // this garbage out
2432 if ( cacheHint->iFrom > cacheHint->iTo )
2433 return false;
2434
2435 event.m_oldItemIndex = cacheHint->iFrom;
2436
2437 const long iMax = GetItemCount();
2438 event.m_itemIndex = cacheHint->iTo < iMax ? cacheHint->iTo
2439 : iMax - 1;
2440 }
2441 break;
2442
2443 #ifdef HAVE_NMLVFINDITEM
2444 case LVN_ODFINDITEM:
2445 // this message is only used with the virtual list control but
2446 // even there we don't want to always use it: in a control with
2447 // sufficiently big number of items (defined as > 1000 here),
2448 // accidentally pressing a key could result in hanging an
2449 // application waiting while it performs linear search
2450 if ( IsVirtual() && GetItemCount() <= 1000 )
2451 {
2452 NMLVFINDITEM* pFindInfo = (NMLVFINDITEM*)lParam;
2453
2454 // no match by default
2455 *result = -1;
2456
2457 // we only handle string-based searches here
2458 //
2459 // TODO: what about LVFI_PARTIAL, should we handle this?
2460 if ( !(pFindInfo->lvfi.flags & LVFI_STRING) )
2461 {
2462 return false;
2463 }
2464
2465 const wxChar * const searchstr = pFindInfo->lvfi.psz;
2466 const size_t len = wxStrlen(searchstr);
2467
2468 // this is the first item we should examine, search from it
2469 // wrapping if necessary
2470 const int startPos = pFindInfo->iStart;
2471 const int maxPos = GetItemCount();
2472 wxCHECK_MSG( startPos <= maxPos, false,
2473 wxT("bad starting position in LVN_ODFINDITEM") );
2474
2475 int currentPos = startPos;
2476 do
2477 {
2478 // wrap to the beginning if necessary
2479 if ( currentPos == maxPos )
2480 {
2481 // somewhat surprisingly, LVFI_WRAP isn't set in
2482 // flags but we still should wrap
2483 currentPos = 0;
2484 }
2485
2486 // does this item begin with searchstr?
2487 if ( wxStrnicmp(searchstr,
2488 GetItemText(currentPos), len) == 0 )
2489 {
2490 *result = currentPos;
2491 break;
2492 }
2493 }
2494 while ( ++currentPos != startPos );
2495
2496 if ( *result == -1 )
2497 {
2498 // not found
2499 return false;
2500 }
2501
2502 SetItemState(*result,
2503 wxLIST_STATE_SELECTED | wxLIST_STATE_FOCUSED,
2504 wxLIST_STATE_SELECTED | wxLIST_STATE_FOCUSED);
2505 EnsureVisible(*result);
2506 return true;
2507 }
2508 else
2509 {
2510 processed = false;
2511 }
2512 break;
2513 #endif // HAVE_NMLVFINDITEM
2514
2515 case LVN_GETDISPINFO:
2516 if ( IsVirtual() )
2517 {
2518 LV_DISPINFO *info = (LV_DISPINFO *)lParam;
2519
2520 LV_ITEM& lvi = info->item;
2521 long item = lvi.iItem;
2522
2523 if ( lvi.mask & LVIF_TEXT )
2524 {
2525 wxString text = OnGetItemText(item, lvi.iSubItem);
2526 wxStrlcpy(lvi.pszText, text.c_str(), lvi.cchTextMax);
2527 }
2528
2529 // see comment at the end of wxListCtrl::GetColumn()
2530 #ifdef NM_CUSTOMDRAW
2531 if ( lvi.mask & LVIF_IMAGE )
2532 {
2533 lvi.iImage = OnGetItemColumnImage(item, lvi.iSubItem);
2534 }
2535 #endif // NM_CUSTOMDRAW
2536
2537 // even though we never use LVM_SETCALLBACKMASK, we still
2538 // can get messages with LVIF_STATE in lvi.mask under Vista
2539 if ( lvi.mask & LVIF_STATE )
2540 {
2541 // we don't have anything to return from here...
2542 lvi.stateMask = 0;
2543 }
2544
2545 return true;
2546 }
2547 // fall through
2548
2549 default:
2550 processed = false;
2551 }
2552
2553 if ( !processed )
2554 return wxControl::MSWOnNotify(idCtrl, lParam, result);
2555 }
2556 else
2557 {
2558 // where did this one come from?
2559 return false;
2560 }
2561
2562 // process the event
2563 // -----------------
2564
2565 event.SetEventType(eventType);
2566
2567 // fill in the item before passing it to the event handler if we do have a
2568 // valid item index and haven't filled it yet (e.g. for LVN_ITEMCHANGED)
2569 if ( event.m_itemIndex != -1 && !event.m_item.GetMask() )
2570 {
2571 wxListItem& item = event.m_item;
2572
2573 item.SetId(event.m_itemIndex);
2574 item.SetMask(wxLIST_MASK_TEXT | wxLIST_MASK_IMAGE | wxLIST_MASK_DATA);
2575 GetItem(item);
2576 }
2577
2578 bool processed = HandleWindowEvent(event);
2579
2580 // post processing
2581 // ---------------
2582 switch ( nmhdr->code )
2583 {
2584 case LVN_DELETEALLITEMS:
2585 // always return true to suppress all additional LVN_DELETEITEM
2586 // notifications - this makes deleting all items from a list ctrl
2587 // much faster
2588 *result = TRUE;
2589
2590 // also, we may free all user data now (couldn't do it before as
2591 // the user should have access to it in OnDeleteAllItems() handler)
2592 FreeAllInternalData();
2593
2594 // the control is empty now, synchronize the cached number of items
2595 // with the real one
2596 m_count = 0;
2597 return true;
2598
2599 case LVN_ENDLABELEDITA:
2600 case LVN_ENDLABELEDITW:
2601 // logic here is inverted compared to all the other messages
2602 *result = event.IsAllowed();
2603
2604 // EDIT control will be deleted by the list control itself so
2605 // prevent us from deleting it as well
2606 DeleteEditControl();
2607
2608 return true;
2609 }
2610
2611 if ( processed )
2612 *result = !event.IsAllowed();
2613
2614 return processed;
2615 }
2616
2617 // ----------------------------------------------------------------------------
2618 // custom draw stuff
2619 // ----------------------------------------------------------------------------
2620
2621 // see comment at the end of wxListCtrl::GetColumn()
2622 #ifdef NM_CUSTOMDRAW // _WIN32_IE >= 0x0300
2623
2624 static RECT GetCustomDrawnItemRect(const NMCUSTOMDRAW& nmcd)
2625 {
2626 RECT rc;
2627 wxGetListCtrlItemRect(nmcd.hdr.hwndFrom, nmcd.dwItemSpec, LVIR_BOUNDS, rc);
2628
2629 RECT rcIcon;
2630 wxGetListCtrlItemRect(nmcd.hdr.hwndFrom, nmcd.dwItemSpec, LVIR_ICON, rcIcon);
2631
2632 // exclude the icon part, neither the selection background nor focus rect
2633 // should cover it
2634 rc.left = rcIcon.right;
2635
2636 return rc;
2637 }
2638
2639 static
2640 bool HandleSubItemPrepaint(LPNMLVCUSTOMDRAW pLVCD, HFONT hfont, int colCount)
2641 {
2642 NMCUSTOMDRAW& nmcd = pLVCD->nmcd;
2643
2644 HDC hdc = nmcd.hdc;
2645 HWND hwndList = nmcd.hdr.hwndFrom;
2646 const int col = pLVCD->iSubItem;
2647 const DWORD item = nmcd.dwItemSpec;
2648
2649 // the font must be valid, otherwise we wouldn't be painting the item at all
2650 SelectInHDC selFont(hdc, hfont);
2651
2652 // get the rectangle to paint
2653 int subitem = colCount ? col + 1 : col;
2654 RECT rc;
2655 wxGetListCtrlSubItemRect(hwndList, item, subitem, LVIR_BOUNDS, rc);
2656 rc.left += 6;
2657
2658 // get the image and text to draw
2659 wxChar text[512];
2660 LV_ITEM it;
2661 wxZeroMemory(it);
2662 it.mask = LVIF_TEXT | LVIF_IMAGE;
2663 it.iItem = item;
2664 it.iSubItem = col;
2665 it.pszText = text;
2666 it.cchTextMax = WXSIZEOF(text);
2667 ListView_GetItem(hwndList, &it);
2668
2669 HIMAGELIST himl = ListView_GetImageList(hwndList, LVSIL_SMALL);
2670 if ( himl && ImageList_GetImageCount(himl) )
2671 {
2672 if ( it.iImage != -1 )
2673 {
2674 ImageList_Draw(himl, it.iImage, hdc, rc.left, rc.top,
2675 nmcd.uItemState & CDIS_SELECTED ? ILD_SELECTED
2676 : ILD_TRANSPARENT);
2677 }
2678
2679 // notice that even if this item doesn't have any image, the list
2680 // control still leaves space for the image in the first column if the
2681 // image list is not empty (presumably so that items with and without
2682 // images align?)
2683 if ( it.iImage != -1 || it.iSubItem == 0 )
2684 {
2685 int wImage, hImage;
2686 ImageList_GetIconSize(himl, &wImage, &hImage);
2687
2688 rc.left += wImage + 2;
2689 }
2690 }
2691
2692 ::SetBkMode(hdc, TRANSPARENT);
2693
2694 UINT fmt = DT_SINGLELINE |
2695 #ifndef __WXWINCE__
2696 DT_WORD_ELLIPSIS |
2697 #endif // __WXWINCE__
2698 DT_NOPREFIX |
2699 DT_VCENTER;
2700
2701 LV_COLUMN lvCol;
2702 wxZeroMemory(lvCol);
2703 lvCol.mask = LVCF_FMT;
2704 if ( ListView_GetColumn(hwndList, col, &lvCol) )
2705 {
2706 switch ( lvCol.fmt & LVCFMT_JUSTIFYMASK )
2707 {
2708 case LVCFMT_LEFT:
2709 fmt |= DT_LEFT;
2710 break;
2711
2712 case LVCFMT_CENTER:
2713 fmt |= DT_CENTER;
2714 break;
2715
2716 case LVCFMT_RIGHT:
2717 fmt |= DT_RIGHT;
2718 break;
2719 }
2720 }
2721 //else: failed to get alignment, assume it's DT_LEFT (default)
2722
2723 DrawText(hdc, text, -1, &rc, fmt);
2724
2725 return true;
2726 }
2727
2728 static void HandleItemPostpaint(NMCUSTOMDRAW nmcd)
2729 {
2730 if ( nmcd.uItemState & CDIS_FOCUS )
2731 {
2732 RECT rc = GetCustomDrawnItemRect(nmcd);
2733
2734 // don't use the provided HDC, it's in some strange state by now
2735 ::DrawFocusRect(WindowHDC(nmcd.hdr.hwndFrom), &rc);
2736 }
2737 }
2738
2739 // pLVCD->clrText and clrTextBk should contain the colours to use
2740 static void HandleItemPaint(LPNMLVCUSTOMDRAW pLVCD, HFONT hfont)
2741 {
2742 NMCUSTOMDRAW& nmcd = pLVCD->nmcd; // just a shortcut
2743
2744 const HWND hwndList = nmcd.hdr.hwndFrom;
2745 const int item = nmcd.dwItemSpec;
2746
2747 // unfortunately we can't trust CDIS_SELECTED, it is often set even when
2748 // the item is not at all selected for some reason (comctl32 6), but we
2749 // also can't always trust ListView_GetItem() as it could return the old
2750 // item status if we're called just after the (de)selection, so remember
2751 // the last item to gain selection and also check for it here
2752 for ( int i = -1;; )
2753 {
2754 i = ListView_GetNextItem(hwndList, i, LVNI_SELECTED);
2755 if ( i == -1 )
2756 {
2757 nmcd.uItemState &= ~CDIS_SELECTED;
2758 break;
2759 }
2760
2761 if ( i == item )
2762 {
2763 nmcd.uItemState |= CDIS_SELECTED;
2764 break;
2765 }
2766 }
2767
2768 // same thing for CDIS_FOCUS (except simpler as there is only one of them)
2769 //
2770 // NB: cast is needed to work around the bug in mingw32 headers which don't
2771 // have it inside ListView_GetNextItem() itself (unlike SDK ones)
2772 if ( ::GetFocus() == hwndList &&
2773 ListView_GetNextItem(
2774 hwndList, static_cast<WPARAM>(-1), LVNI_FOCUSED) == item )
2775 {
2776 nmcd.uItemState |= CDIS_FOCUS;
2777 }
2778 else
2779 {
2780 nmcd.uItemState &= ~CDIS_FOCUS;
2781 }
2782
2783 if ( nmcd.uItemState & CDIS_SELECTED )
2784 {
2785 int syscolFg, syscolBg;
2786 if ( ::GetFocus() == hwndList )
2787 {
2788 syscolFg = COLOR_HIGHLIGHTTEXT;
2789 syscolBg = COLOR_HIGHLIGHT;
2790 }
2791 else // selected but unfocused
2792 {
2793 syscolFg = COLOR_WINDOWTEXT;
2794 syscolBg = COLOR_BTNFACE;
2795
2796 // don't grey out the icon in this case neither
2797 nmcd.uItemState &= ~CDIS_SELECTED;
2798 }
2799
2800 pLVCD->clrText = ::GetSysColor(syscolFg);
2801 pLVCD->clrTextBk = ::GetSysColor(syscolBg);
2802 }
2803 //else: not selected, use normal colours from pLVCD
2804
2805 HDC hdc = nmcd.hdc;
2806 RECT rc = GetCustomDrawnItemRect(nmcd);
2807
2808 ::SetTextColor(hdc, pLVCD->clrText);
2809 ::FillRect(hdc, &rc, AutoHBRUSH(pLVCD->clrTextBk));
2810
2811 // we could use CDRF_NOTIFYSUBITEMDRAW here but it results in weird repaint
2812 // problems so just draw everything except the focus rect from here instead
2813 const int colCount = Header_GetItemCount(ListView_GetHeader(hwndList));
2814 for ( int col = 0; col < colCount; col++ )
2815 {
2816 pLVCD->iSubItem = col;
2817 HandleSubItemPrepaint(pLVCD, hfont, colCount);
2818 }
2819
2820 HandleItemPostpaint(nmcd);
2821 }
2822
2823 static WXLPARAM HandleItemPrepaint(wxListCtrl *listctrl,
2824 LPNMLVCUSTOMDRAW pLVCD,
2825 wxListItemAttr *attr)
2826 {
2827 if ( !attr )
2828 {
2829 // nothing to do for this item
2830 return CDRF_DODEFAULT;
2831 }
2832
2833
2834 // set the colours to use for text drawing
2835 pLVCD->clrText = attr->HasTextColour()
2836 ? wxColourToRGB(attr->GetTextColour())
2837 : wxColourToRGB(listctrl->GetTextColour());
2838 pLVCD->clrTextBk = attr->HasBackgroundColour()
2839 ? wxColourToRGB(attr->GetBackgroundColour())
2840 : wxColourToRGB(listctrl->GetBackgroundColour());
2841
2842 // select the font if non default one is specified
2843 if ( attr->HasFont() )
2844 {
2845 wxFont font = attr->GetFont();
2846 if ( font.GetEncoding() != wxFONTENCODING_SYSTEM )
2847 {
2848 // the standard control ignores the font encoding/charset, at least
2849 // with recent comctl32.dll versions (5 and 6, it uses to work with
2850 // 4.something) so we have to draw the item entirely ourselves in
2851 // this case
2852 HandleItemPaint(pLVCD, GetHfontOf(font));
2853 return CDRF_SKIPDEFAULT;
2854 }
2855
2856 ::SelectObject(pLVCD->nmcd.hdc, GetHfontOf(font));
2857
2858 return CDRF_NEWFONT;
2859 }
2860
2861 return CDRF_DODEFAULT;
2862 }
2863
2864 WXLPARAM wxListCtrl::OnCustomDraw(WXLPARAM lParam)
2865 {
2866 LPNMLVCUSTOMDRAW pLVCD = (LPNMLVCUSTOMDRAW)lParam;
2867 NMCUSTOMDRAW& nmcd = pLVCD->nmcd;
2868 switch ( nmcd.dwDrawStage )
2869 {
2870 case CDDS_PREPAINT:
2871 // if we've got any items with non standard attributes,
2872 // notify us before painting each item
2873 //
2874 // for virtual controls, always suppose that we have attributes as
2875 // there is no way to check for this
2876 if ( IsVirtual() || m_hasAnyAttr )
2877 return CDRF_NOTIFYITEMDRAW;
2878 break;
2879
2880 case CDDS_ITEMPREPAINT:
2881 // get a message for each subitem
2882 return CDRF_NOTIFYITEMDRAW;
2883
2884 case CDDS_SUBITEM | CDDS_ITEMPREPAINT:
2885 const int item = nmcd.dwItemSpec;
2886 const int column = pLVCD->iSubItem;
2887
2888 // we get this message with item == 0 for an empty control, we
2889 // must ignore it as calling OnGetItemAttr() would be wrong
2890 if ( item < 0 || item >= GetItemCount() )
2891 break;
2892 // same for columns
2893 if ( column < 0 || column >= GetColumnCount() )
2894 break;
2895
2896 return HandleItemPrepaint(this, pLVCD, DoGetItemColumnAttr(item, column));
2897 }
2898
2899 return CDRF_DODEFAULT;
2900 }
2901
2902 #endif // NM_CUSTOMDRAW supported
2903
2904 // Necessary for drawing hrules and vrules, if specified
2905 void wxListCtrl::OnPaint(wxPaintEvent& event)
2906 {
2907 const int itemCount = GetItemCount();
2908 const bool drawHRules = HasFlag(wxLC_HRULES);
2909 const bool drawVRules = HasFlag(wxLC_VRULES);
2910
2911 if (!InReportView() || !(drawHRules || drawVRules) || !itemCount)
2912 {
2913 event.Skip();
2914 return;
2915 }
2916
2917 wxPaintDC dc(this);
2918
2919 wxControl::OnPaint(event);
2920
2921 // Reset the device origin since it may have been set
2922 dc.SetDeviceOrigin(0, 0);
2923
2924 wxPen pen(wxSystemSettings::GetColour(wxSYS_COLOUR_3DLIGHT));
2925 dc.SetPen(pen);
2926 dc.SetBrush(* wxTRANSPARENT_BRUSH);
2927
2928 wxSize clientSize = GetClientSize();
2929 wxRect itemRect;
2930
2931 if (drawHRules)
2932 {
2933 const long top = GetTopItem();
2934 for ( int i = top; i < top + GetCountPerPage() + 1; i++ )
2935 {
2936 if (GetItemRect(i, itemRect))
2937 {
2938 int cy = itemRect.GetTop();
2939 if (i != 0) // Don't draw the first one
2940 {
2941 dc.DrawLine(0, cy, clientSize.x, cy);
2942 }
2943 // Draw last line
2944 if (i == itemCount - 1)
2945 {
2946 cy = itemRect.GetBottom();
2947 dc.DrawLine(0, cy, clientSize.x, cy);
2948 break;
2949 }
2950 }
2951 }
2952 }
2953
2954 if (drawVRules)
2955 {
2956 wxRect firstItemRect;
2957 GetItemRect(0, firstItemRect);
2958
2959 if (GetItemRect(itemCount - 1, itemRect))
2960 {
2961 // this is a fix for bug 673394: erase the pixels which we would
2962 // otherwise leave on the screen
2963 static const int gap = 2;
2964 dc.SetPen(*wxTRANSPARENT_PEN);
2965 dc.SetBrush(wxBrush(GetBackgroundColour()));
2966 dc.DrawRectangle(0, firstItemRect.GetY() - gap,
2967 clientSize.GetWidth(), gap);
2968
2969 dc.SetPen(pen);
2970 dc.SetBrush(*wxTRANSPARENT_BRUSH);
2971
2972 const int numCols = GetColumnCount();
2973 wxVector<int> indexArray(numCols);
2974 if ( !ListView_GetColumnOrderArray(GetHwnd(),
2975 numCols,
2976 &indexArray[0]) )
2977 {
2978 wxFAIL_MSG( wxT("invalid column index array in OnPaint()") );
2979 return;
2980 }
2981
2982 int x = itemRect.GetX();
2983 for (int col = 0; col < numCols; col++)
2984 {
2985 int colWidth = GetColumnWidth(indexArray[col]);
2986 x += colWidth ;
2987 dc.DrawLine(x-1, firstItemRect.GetY() - gap,
2988 x-1, itemRect.GetBottom());
2989 }
2990 }
2991 }
2992 }
2993
2994 WXLRESULT
2995 wxListCtrl::MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam)
2996 {
2997 switch ( nMsg )
2998 {
2999 #ifdef WM_PRINT
3000 case WM_PRINT:
3001 // we should bypass our own WM_PRINT handling as we don't handle
3002 // PRF_CHILDREN flag, so leave it to the native control itself
3003 return MSWDefWindowProc(nMsg, wParam, lParam);
3004 #endif // WM_PRINT
3005
3006 case WM_CONTEXTMENU:
3007 // because this message is propagated upwards the child-parent
3008 // chain, we get it for the right clicks on the header window but
3009 // this is confusing in wx as right clicking there already
3010 // generates a separate wxEVT_COMMAND_LIST_COL_RIGHT_CLICK event
3011 // so just ignore them
3012 if ( (HWND)wParam == ListView_GetHeader(GetHwnd()) )
3013 return 0;
3014 //else: break
3015 }
3016
3017 return wxControl::MSWWindowProc(nMsg, wParam, lParam);
3018 }
3019
3020 // ----------------------------------------------------------------------------
3021 // virtual list controls
3022 // ----------------------------------------------------------------------------
3023
3024 wxString wxListCtrl::OnGetItemText(long WXUNUSED(item), long WXUNUSED(col)) const
3025 {
3026 // this is a pure virtual function, in fact - which is not really pure
3027 // because the controls which are not virtual don't need to implement it
3028 wxFAIL_MSG( wxT("wxListCtrl::OnGetItemText not supposed to be called") );
3029
3030 return wxEmptyString;
3031 }
3032
3033 int wxListCtrl::OnGetItemImage(long WXUNUSED(item)) const
3034 {
3035 wxCHECK_MSG(!GetImageList(wxIMAGE_LIST_SMALL),
3036 -1,
3037 wxT("List control has an image list, OnGetItemImage or OnGetItemColumnImage should be overridden."));
3038 return -1;
3039 }
3040
3041 int wxListCtrl::OnGetItemColumnImage(long item, long column) const
3042 {
3043 if (!column)
3044 return OnGetItemImage(item);
3045
3046 return -1;
3047 }
3048
3049 wxListItemAttr *wxListCtrl::OnGetItemAttr(long WXUNUSED_UNLESS_DEBUG(item)) const
3050 {
3051 wxASSERT_MSG( item >= 0 && item < GetItemCount(),
3052 wxT("invalid item index in OnGetItemAttr()") );
3053
3054 // no attributes by default
3055 return NULL;
3056 }
3057
3058 wxListItemAttr *wxListCtrl::DoGetItemColumnAttr(long item, long column) const
3059 {
3060 if ( IsVirtual() )
3061 return OnGetItemColumnAttr(item, column);
3062
3063 wxMSWListItemData * const data = MSWGetItemData(item);
3064 return data ? data->attr : NULL;
3065 }
3066
3067 void wxListCtrl::SetItemCount(long count)
3068 {
3069 wxASSERT_MSG( IsVirtual(), wxT("this is for virtual controls only") );
3070
3071 if ( !::SendMessage(GetHwnd(), LVM_SETITEMCOUNT, (WPARAM)count,
3072 LVSICF_NOSCROLL | LVSICF_NOINVALIDATEALL) )
3073 {
3074 wxLogLastError(wxT("ListView_SetItemCount"));
3075 }
3076 m_count = count;
3077 wxASSERT_MSG( m_count == ListView_GetItemCount(GetHwnd()),
3078 wxT("m_count should match ListView_GetItemCount"));
3079 }
3080
3081 void wxListCtrl::RefreshItem(long item)
3082 {
3083 RefreshItems(item, item);
3084 }
3085
3086 void wxListCtrl::RefreshItems(long itemFrom, long itemTo)
3087 {
3088 ListView_RedrawItems(GetHwnd(), itemFrom, itemTo);
3089 }
3090
3091 // ----------------------------------------------------------------------------
3092 // wxWin <-> MSW items conversions
3093 // ----------------------------------------------------------------------------
3094
3095 static void wxConvertFromMSWListItem(HWND hwndListCtrl,
3096 wxListItem& info,
3097 LV_ITEM& lvItem)
3098 {
3099 wxMSWListItemData *internaldata =
3100 (wxMSWListItemData *) lvItem.lParam;
3101
3102 if (internaldata)
3103 info.m_data = internaldata->lParam;
3104
3105 info.m_mask = 0;
3106 info.m_state = 0;
3107 info.m_stateMask = 0;
3108 info.m_itemId = lvItem.iItem;
3109
3110 long oldMask = lvItem.mask;
3111
3112 bool needText = false;
3113 if (hwndListCtrl != 0)
3114 {
3115 if ( lvItem.mask & LVIF_TEXT )
3116 needText = false;
3117 else
3118 needText = true;
3119
3120 if ( needText )
3121 {
3122 lvItem.pszText = new wxChar[513];
3123 lvItem.cchTextMax = 512;
3124 }
3125 lvItem.mask |= LVIF_TEXT | LVIF_IMAGE | LVIF_PARAM;
3126 ::SendMessage(hwndListCtrl, LVM_GETITEM, 0, (LPARAM)& lvItem);
3127 }
3128
3129 if ( lvItem.mask & LVIF_STATE )
3130 {
3131 info.m_mask |= wxLIST_MASK_STATE;
3132
3133 if ( lvItem.stateMask & LVIS_CUT)
3134 {
3135 info.m_stateMask |= wxLIST_STATE_CUT;
3136 if ( lvItem.state & LVIS_CUT )
3137 info.m_state |= wxLIST_STATE_CUT;
3138 }
3139 if ( lvItem.stateMask & LVIS_DROPHILITED)
3140 {
3141 info.m_stateMask |= wxLIST_STATE_DROPHILITED;
3142 if ( lvItem.state & LVIS_DROPHILITED )
3143 info.m_state |= wxLIST_STATE_DROPHILITED;
3144 }
3145 if ( lvItem.stateMask & LVIS_FOCUSED)
3146 {
3147 info.m_stateMask |= wxLIST_STATE_FOCUSED;
3148 if ( lvItem.state & LVIS_FOCUSED )
3149 info.m_state |= wxLIST_STATE_FOCUSED;
3150 }
3151 if ( lvItem.stateMask & LVIS_SELECTED)
3152 {
3153 info.m_stateMask |= wxLIST_STATE_SELECTED;
3154 if ( lvItem.state & LVIS_SELECTED )
3155 info.m_state |= wxLIST_STATE_SELECTED;
3156 }
3157 }
3158
3159 if ( lvItem.mask & LVIF_TEXT )
3160 {
3161 info.m_mask |= wxLIST_MASK_TEXT;
3162 info.m_text = lvItem.pszText;
3163 }
3164 if ( lvItem.mask & LVIF_IMAGE )
3165 {
3166 info.m_mask |= wxLIST_MASK_IMAGE;
3167 info.m_image = lvItem.iImage;
3168 }
3169 if ( lvItem.mask & LVIF_PARAM )
3170 info.m_mask |= wxLIST_MASK_DATA;
3171 if ( lvItem.mask & LVIF_DI_SETITEM )
3172 info.m_mask |= wxLIST_SET_ITEM;
3173 info.m_col = lvItem.iSubItem;
3174
3175 if (needText)
3176 {
3177 if (lvItem.pszText)
3178 delete[] lvItem.pszText;
3179 }
3180 lvItem.mask = oldMask;
3181 }
3182
3183 static void wxConvertToMSWFlags(long state, long stateMask, LV_ITEM& lvItem)
3184 {
3185 if (stateMask & wxLIST_STATE_CUT)
3186 {
3187 lvItem.stateMask |= LVIS_CUT;
3188 if (state & wxLIST_STATE_CUT)
3189 lvItem.state |= LVIS_CUT;
3190 }
3191 if (stateMask & wxLIST_STATE_DROPHILITED)
3192 {
3193 lvItem.stateMask |= LVIS_DROPHILITED;
3194 if (state & wxLIST_STATE_DROPHILITED)
3195 lvItem.state |= LVIS_DROPHILITED;
3196 }
3197 if (stateMask & wxLIST_STATE_FOCUSED)
3198 {
3199 lvItem.stateMask |= LVIS_FOCUSED;
3200 if (state & wxLIST_STATE_FOCUSED)
3201 lvItem.state |= LVIS_FOCUSED;
3202 }
3203 if (stateMask & wxLIST_STATE_SELECTED)
3204 {
3205 lvItem.stateMask |= LVIS_SELECTED;
3206 if (state & wxLIST_STATE_SELECTED)
3207 lvItem.state |= LVIS_SELECTED;
3208 }
3209 }
3210
3211 static void wxConvertToMSWListItem(const wxListCtrl *ctrl,
3212 const wxListItem& info,
3213 LV_ITEM& lvItem)
3214 {
3215 if ( ctrl->InReportView() )
3216 {
3217 wxASSERT_MSG( 0 <= info.m_col && info.m_col < ctrl->GetColumnCount(),
3218 "wxListCtrl column index out of bounds" );
3219 }
3220 else // not in report view
3221 {
3222 wxASSERT_MSG( info.m_col == 0, "columns only exist in report view" );
3223 }
3224
3225 lvItem.iItem = (int) info.m_itemId;
3226
3227 lvItem.iImage = info.m_image;
3228 lvItem.stateMask = 0;
3229 lvItem.state = 0;
3230 lvItem.mask = 0;
3231 lvItem.iSubItem = info.m_col;
3232
3233 if (info.m_mask & wxLIST_MASK_STATE)
3234 {
3235 lvItem.mask |= LVIF_STATE;
3236
3237 wxConvertToMSWFlags(info.m_state, info.m_stateMask, lvItem);
3238 }
3239
3240 if (info.m_mask & wxLIST_MASK_TEXT)
3241 {
3242 lvItem.mask |= LVIF_TEXT;
3243 if ( ctrl->HasFlag(wxLC_USER_TEXT) )
3244 {
3245 lvItem.pszText = LPSTR_TEXTCALLBACK;
3246 }
3247 else
3248 {
3249 // pszText is not const, hence the cast
3250 lvItem.pszText = (wxChar *)info.m_text.wx_str();
3251 if ( lvItem.pszText )
3252 lvItem.cchTextMax = info.m_text.length();
3253 else
3254 lvItem.cchTextMax = 0;
3255 }
3256 }
3257 if (info.m_mask & wxLIST_MASK_IMAGE)
3258 lvItem.mask |= LVIF_IMAGE;
3259 }
3260
3261 static void wxConvertToMSWListCol(HWND hwndList,
3262 int col,
3263 const wxListItem& item,
3264 LV_COLUMN& lvCol)
3265 {
3266 wxZeroMemory(lvCol);
3267
3268 if ( item.m_mask & wxLIST_MASK_TEXT )
3269 {
3270 lvCol.mask |= LVCF_TEXT;
3271 lvCol.pszText = (wxChar *)item.m_text.wx_str(); // cast is safe
3272 }
3273
3274 if ( item.m_mask & wxLIST_MASK_FORMAT )
3275 {
3276 lvCol.mask |= LVCF_FMT;
3277
3278 if ( item.m_format == wxLIST_FORMAT_LEFT )
3279 lvCol.fmt = LVCFMT_LEFT;
3280 else if ( item.m_format == wxLIST_FORMAT_RIGHT )
3281 lvCol.fmt = LVCFMT_RIGHT;
3282 else if ( item.m_format == wxLIST_FORMAT_CENTRE )
3283 lvCol.fmt = LVCFMT_CENTER;
3284 }
3285
3286 if ( item.m_mask & wxLIST_MASK_WIDTH )
3287 {
3288 lvCol.mask |= LVCF_WIDTH;
3289 if ( item.m_width == wxLIST_AUTOSIZE)
3290 lvCol.cx = LVSCW_AUTOSIZE;
3291 else if ( item.m_width == wxLIST_AUTOSIZE_USEHEADER)
3292 lvCol.cx = LVSCW_AUTOSIZE_USEHEADER;
3293 else
3294 lvCol.cx = item.m_width;
3295 }
3296
3297 // see comment at the end of wxListCtrl::GetColumn()
3298 #ifdef NM_CUSTOMDRAW // _WIN32_IE >= 0x0300
3299 if ( item.m_mask & wxLIST_MASK_IMAGE )
3300 {
3301 if ( wxApp::GetComCtl32Version() >= 470 )
3302 {
3303 lvCol.mask |= LVCF_IMAGE;
3304
3305 // we use LVCFMT_BITMAP_ON_RIGHT because the images on the right
3306 // seem to be generally nicer than on the left and the generic
3307 // version only draws them on the right (we don't have a flag to
3308 // specify the image location anyhow)
3309 //
3310 // we don't use LVCFMT_COL_HAS_IMAGES because it doesn't seem to
3311 // make any difference in my tests -- but maybe we should?
3312 if ( item.m_image != -1 )
3313 {
3314 // as we're going to overwrite the format field, get its
3315 // current value first -- unless we want to overwrite it anyhow
3316 if ( !(lvCol.mask & LVCF_FMT) )
3317 {
3318 LV_COLUMN lvColOld;
3319 wxZeroMemory(lvColOld);
3320 lvColOld.mask = LVCF_FMT;
3321 if ( ListView_GetColumn(hwndList, col, &lvColOld) )
3322 {
3323 lvCol.fmt = lvColOld.fmt;
3324 }
3325
3326 lvCol.mask |= LVCF_FMT;
3327 }
3328
3329 lvCol.fmt |= LVCFMT_BITMAP_ON_RIGHT | LVCFMT_IMAGE;
3330 }
3331
3332 lvCol.iImage = item.m_image;
3333 }
3334 //else: it doesn't support item images anyhow
3335 }
3336 #endif // _WIN32_IE >= 0x0300
3337 }
3338
3339 #endif // wxUSE_LISTCTRL