src/cocoa/listbox.mm

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/cocoa/listbox.mm
   3 // Purpose:     wxListBox
   4 // Author:      David Elliott
   5 // Modified by:
   6 // Created:     2003/03/18
   7 // Id:          $Id$
   8 // Copyright:   (c) 2003 David Elliott
   9 // Licence:     wxWidgets licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #include "wx/wxprec.h"
  13
  14 #if wxUSE_LISTBOX
  15
  16 #include "wx/listbox.h"
  17
  18 #ifndef WX_PRECOMP
  19     #include "wx/log.h"
  20     #include "wx/app.h"
  21 #endif //WX_PRECOMP
  22
  23 #include "wx/cocoa/string.h"
  24 #include "wx/cocoa/autorelease.h"
  25 #include "wx/cocoa/ObjcRef.h"
  26 #include "wx/cocoa/private/scrollview.h"
  27 #include "wx/cocoa/NSTableDataSource.h"
  28
  29 #import <Foundation/NSArray.h>
  30 #import <Foundation/NSEnumerator.h>
  31 #import <AppKit/NSTableView.h>
  32 #import <AppKit/NSTableColumn.h>
  33 #import <AppKit/NSScrollView.h>
  34 #import <AppKit/NSCell.h>
  35
  36
  37 // ============================================================================
  38 // helper functions
  39 // ============================================================================
  40
  41 static CGFloat _TableColumnMaxWidthForItems(NSTableColumn *tableColumn, NSArray *items)
  42 {
  43     wxAutoNSAutoreleasePool pool;
  44
  45     NSCell *dataCell = [[[tableColumn dataCell] copy] autorelease];
  46     CGFloat width = 0.0f;
  47     NSEnumerator *itemEnum = [items objectEnumerator];
  48     NSString *item;
  49     while( (item = [itemEnum nextObject]) != nil )
  50     {
  51         [dataCell setStringValue: item];
  52         NSSize itemSize = [dataCell cellSize];
  53         CGFloat itemWidth = itemSize.width;
  54         if(itemWidth > width)
  55             width = itemWidth;
  56     }
  57     return width;
  58 }
  59
  60 static void _SetWidthOfTableColumnToFitItems(NSTableColumn *tableColumn, NSArray *items)
  61 {
  62     CGFloat width = _TableColumnMaxWidthForItems(tableColumn, items);
  63     [tableColumn setWidth:width];
  64     [tableColumn setMinWidth:width];
  65 }
  66
  67 // ============================================================================
  68 // class wxListBox
  69 // ============================================================================
  70
  71 IMPLEMENT_DYNAMIC_CLASS(wxListBox, wxControlWithItems)
  72 BEGIN_EVENT_TABLE(wxListBox, wxListBoxBase)
  73 END_EVENT_TABLE()
  74 WX_IMPLEMENT_COCOA_OWNER(wxListBox,NSTableView,NSControl,NSView)
  75
  76 bool wxListBox::Create(wxWindow *parent, wxWindowID winid,
  77             const wxPoint& pos,
  78             const wxSize& size,
  79             const wxArrayString& choices,
  80             long style,
  81             const wxValidator& validator,
  82             const wxString& name)
  83 {
  84     wxCArrayString chs(choices);
  85
  86     return Create(parent, winid, pos, size, chs.GetCount(), chs.GetStrings(),
  87                   style, validator, name);
  88 }
  89
  90 bool wxListBox::Create(wxWindow *parent, wxWindowID winid,
  91             const wxPoint& pos,
  92             const wxSize& size,
  93             int n, const wxString choices[],
  94             long style,
  95             const wxValidator& validator,
  96             const wxString& name)
  97 {
  98 /*
  99 wxLB_SINGLE
 100 Single-selection list.
 101
 102 wxLB_MULTIPLE
 103 Multiple-selection list: the user can toggle multiple items on and off.
 104
 105 wxLB_EXTENDED
 106 Extended-selection list: the user can select multiple items using the SHIFT key and the mouse or special key combinations.
 107
 108 wxLB_HSCROLL
 109 Create horizontal scrollbar if contents are too wide (Windows only).
 110
 111 wxLB_ALWAYS_SB
 112 Always show a vertical scrollbar.
 113
 114 wxLB_NEEDED_SB
 115 Only create a vertical scrollbar if needed.
 116
 117 wxLB_SORT
 118 The listbox contents are sorted in alphabetical order.
 119 */
 120     wxAutoNSAutoreleasePool pool;
 121     if(!CreateControl(parent,winid,pos,size,style,validator,name))
 122         return false;
 123
 124     // Provide the data
 125     m_cocoaItems = wxGCSafeRetain([NSMutableArray arrayWithCapacity:n]);
 126     for(int i=0; i < n; i++)
 127     {
 128         [m_cocoaItems addObject: wxNSStringWithWxString(choices[i])];
 129     }
 130     // Remove everything
 131     m_itemClientData.Clear();
 132     // Initialize n elements to NULL
 133     m_itemClientData.SetCount(n,NULL);
 134
 135     SetNSTableView([[NSTableView alloc] initWithFrame: MakeDefaultNSRect(size)]);
 136     [m_cocoaNSView release];
 137     [GetNSTableView() setHeaderView: nil];
 138
 139     // Set up the data source
 140     m_cocoaDataSource = [[WX_GET_OBJC_CLASS(wxCocoaNSTableDataSource) alloc] init];
 141     [GetNSTableView() setDataSource:m_cocoaDataSource];
 142
 143     // Add the single column
 144     NSTableColumn *tableColumn = [[NSTableColumn alloc] initWithIdentifier:nil];
 145     [GetNSTableView() addTableColumn: tableColumn];
 146     [tableColumn release];
 147
 148     [GetNSTableView() sizeToFit];
 149     // Finish
 150     if(m_parent)
 151         m_parent->CocoaAddChild(this);
 152     // NSTableView does WEIRD things with sizes.  Wrapping it in an
 153     // NSScrollView seems to be the only reasonable solution.
 154     CocoaCreateNSScrollView();
 155     SetInitialFrameRect(pos,size);
 156
 157     [m_wxCocoaScrollView->GetNSScrollView() setHasVerticalScroller:YES];
 158     // Pre-10.3: Always show vertical scroller, never show horizontal scroller
 159     // Post-10.3: Show scrollers dynamically (turn them both on, set auto-hide)
 160     if([m_wxCocoaScrollView->GetNSScrollView() respondsToSelector:@selector(setAutohidesScrollers:)])
 161     {
 162         [m_wxCocoaScrollView->GetNSScrollView() setHasHorizontalScroller:YES];
 163         [m_wxCocoaScrollView->GetNSScrollView() setAutohidesScrollers:YES];
 164     }
 165
 166     // Set up extended/multiple selection flags
 167     if ((style & wxLB_EXTENDED) || (style & wxLB_MULTIPLE))
 168         //diff is that mult requires shift down for multi selection
 169         [GetNSTableView() setAllowsMultipleSelection:true];
 170
 171     [GetNSTableView() setAllowsColumnSelection:false];
 172     _SetWidthOfTableColumnToFitItems(tableColumn, m_cocoaItems);
 173     return true;
 174 }
 175
 176 wxSize wxListBox::DoGetBestSize() const
 177 {
 178     wxSize size = wxControlWithItems::DoGetBestSize();
 179     // Limit best size to 100x100. It can be smaller if none of the items are very
 180     // wide or if there aren't many items, but anything bigger than 100x100 ought
 181     // to be asked for by the programmer. The 100x100 size is based on being barely
 182     // enough for a scroller to be usable.
 183     if(size.GetWidth() > 100)
 184         size.SetWidth(100);
 185     if(size.GetHeight() > 100)
 186         size.SetHeight(100);
 187     return size;
 188 }
 189
 190 wxListBox::~wxListBox()
 191 {
 192     [GetNSTableView() setDataSource: nil];
 193     [m_cocoaDataSource release];
 194     wxGCSafeRelease(m_cocoaItems);
 195     m_cocoaItems = nil;
 196     DisassociateNSTableView(GetNSTableView());
 197 }
 198
 199 bool wxListBox::_WxCocoa_GetNeedsUpdate()
 200 {
 201     return m_needsUpdate;
 202 }
 203
 204 void wxListBox::_WxCocoa_SetNeedsUpdate(bool needsUpdate)
 205 {
 206     m_needsUpdate = needsUpdate;
 207 }
 208
 209 void wxListBox::OnInternalIdle()
 210 {
 211     wxControlWithItems::OnInternalIdle();
 212     if(_WxCocoa_GetNeedsUpdate())
 213     {
 214         _SetWidthOfTableColumnToFitItems([[GetNSTableView() tableColumns] objectAtIndex:0], m_cocoaItems);
 215         [GetNSTableView() tile];
 216         [GetNSTableView() reloadData];
 217         _WxCocoa_SetNeedsUpdate(false);
 218     }
 219 }
 220
 221 int wxListBox::CocoaDataSource_numberOfRows()
 222 {
 223     return [m_cocoaItems count];
 224 }
 225
 226 struct objc_object* wxListBox::CocoaDataSource_objectForTableColumn(
 227         WX_NSTableColumn tableColumn, int rowIndex)
 228 {
 229     return [m_cocoaItems objectAtIndex:rowIndex];
 230 }
 231
 232 // pure virtuals from wxListBoxBase
 233 bool wxListBox::IsSelected(int n) const
 234 {
 235     return [GetNSTableView() isRowSelected: n];
 236 }
 237
 238 void wxListBox::DoSetSelection(int n, bool select)
 239 {
 240     if(select)
 241         [GetNSTableView() selectRow: n byExtendingSelection:NO];
 242     else
 243         [GetNSTableView() deselectRow: n];
 244 }
 245
 246 int wxListBox::GetSelections(wxArrayInt& aSelections) const
 247 {
 248     aSelections.Clear();
 249     NSEnumerator *enumerator = [GetNSTableView() selectedRowEnumerator];
 250     while(NSNumber *num = [enumerator nextObject])
 251     {
 252         aSelections.Add([num intValue]);
 253     }
 254     return [GetNSTableView() numberOfSelectedRows];
 255 }
 256
 257 int wxListBox::DoInsertItems(const wxArrayStringsAdapter & items, unsigned int pos, void **clientData, wxClientDataType type)
 258 {
 259     wxAutoNSAutoreleasePool pool;
 260
 261     const unsigned int numItems = items.GetCount();
 262     for ( unsigned int i = 0; i < numItems; ++i, ++pos )
 263     {
 264         [m_cocoaItems insertObject: wxNSStringWithWxString(items[i])
 265             atIndex: pos];
 266         m_itemClientData.Insert(NULL, pos);
 267         AssignNewItemClientData(pos, clientData, i, type);
 268     }
 269
 270     _WxCocoa_SetNeedsUpdate(true);
 271     return pos - 1;
 272 }
 273
 274 void wxListBox::DoSetFirstItem(int n)
 275 {
 276     [m_cocoaItems exchangeObjectAtIndex:0 withObjectAtIndex:n];
 277     void* pOld = m_itemClientData[n];
 278     m_itemClientData[n] = m_itemClientData[0];
 279     m_itemClientData[0] = pOld;
 280     _WxCocoa_SetNeedsUpdate(true);
 281 }
 282
 283
 284 // pure virtuals from wxItemContainer
 285     // deleting items
 286 void wxListBox::DoClear()
 287 {
 288     [m_cocoaItems removeAllObjects];
 289     m_itemClientData.Clear();
 290     _WxCocoa_SetNeedsUpdate(true);
 291 }
 292
 293 void wxListBox::DoDeleteOneItem(unsigned int n)
 294 {
 295     [m_cocoaItems removeObjectAtIndex:n];
 296     m_itemClientData.RemoveAt(n);
 297     _WxCocoa_SetNeedsUpdate(true);
 298 }
 299
 300     // accessing strings
 301 unsigned int wxListBox::GetCount() const
 302 {
 303     return (unsigned int)[m_cocoaItems count];
 304 }
 305
 306 wxString wxListBox::GetString(unsigned int n) const
 307 {
 308     return wxStringWithNSString([m_cocoaItems objectAtIndex:n]);
 309 }
 310
 311 void wxListBox::SetString(unsigned int n, const wxString& s)
 312 {
 313     wxAutoNSAutoreleasePool pool;
 314     [m_cocoaItems removeObjectAtIndex:n];
 315     [m_cocoaItems insertObject: wxNSStringWithWxString(s) atIndex: n];
 316     _WxCocoa_SetNeedsUpdate(true);
 317 }
 318
 319 int wxListBox::FindString(const wxString& s, bool bCase) const
 320 {
 321     // FIXME: use wxItemContainerImmutable::FindString for bCase parameter
 322     wxAutoNSAutoreleasePool pool;
 323     return [m_cocoaItems indexOfObject:wxNSStringWithWxString(s)];
 324 }
 325
 326     // selection
 327 int wxListBox::GetSelection() const
 328 {
 329     return [GetNSTableView() selectedRow];
 330 }
 331
 332 void wxListBox::DoSetItemClientData(unsigned int n, void* clientData)
 333 {
 334     m_itemClientData[n] = clientData;
 335 }
 336
 337 void* wxListBox::DoGetItemClientData(unsigned int n) const
 338 {
 339     return m_itemClientData[n];
 340 }
 341
 342 #endif // wxUSE_LISTBOX