include/wx/osx/cocoa/dataview.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/osx/carbon/dataview.h
   3 // Purpose:     wxDataViewCtrl native implementation header for carbon
   4 // Author:
   5 // Id:          $Id: dataview.h 57374 2009-01-27
   6 // Copyright:   (c) 2009
   7 // Licence:     wxWindows licence
   8 /////////////////////////////////////////////////////////////////////////////
   9
  10 #ifndef _WX_DATAVIEWCTRL_COCOOA_H_
  11 #define _WX_DATAVIEWCTRL_COCOOA_H_
  12
  13 #include "wx/defs.h"
  14
  15 #if wxUSE_GUI
  16
  17 #ifdef __OBJC__
  18   #import <Cocoa/Cocoa.h>
  19 #endif
  20
  21 #include "wx/osx/core/dataview.h"
  22 #include "wx/osx/private.h"
  23
  24 // Forward declaration
  25 class wxCocoaDataViewControl;
  26
  27 // ============================================================================
  28 // wxPointerObject
  29 // ============================================================================
  30 //
  31 // This is a helper class to store a pointer in an object. This object just
  32 // stores the pointer but does not take any ownership.
  33 // To pointer objects are equal if the containing pointers are equal. This
  34 // means also that the hash value of a pointer object depends only on the
  35 // stored pointer.
  36 //
  37 @interface wxPointerObject : NSObject
  38 {
  39   void* pointer;
  40 }
  41
  42  //
  43  // object initialization
  44  //
  45   -(id) initWithPointer:(void*)initPointer;
  46
  47  //
  48  // access to pointer
  49  //
  50   -(void*) pointer;
  51   -(void)  setPointer:(void*)newPointer;
  52
  53 @end
  54
  55 // ============================================================================
  56 // wxSortDescriptorObject
  57 // ============================================================================
  58 //
  59 // This is a helper class to use native sorting facilities.
  60 //
  61 @interface wxSortDescriptorObject : NSSortDescriptor<NSCopying>
  62 {
  63   wxDataViewColumn* columnPtr; // pointer to the sorting column
  64
  65   wxDataViewModel* modelPtr; // pointer to model
  66 }
  67
  68  //
  69  // initialization
  70  //
  71   -(id) initWithModelPtr:(wxDataViewModel*)initModelPtr sortingColumnPtr:(wxDataViewColumn*)initColumnPtr ascending:(BOOL)sortAscending;
  72
  73  //
  74  // access to variables
  75  //
  76   -(wxDataViewColumn*) columnPtr;
  77   -(wxDataViewModel*) modelPtr;
  78
  79   -(void) setColumnPtr:(wxDataViewColumn*)newColumnPtr;
  80   -(void) setModelPtr:(wxDataViewModel*)newModelPtr;
  81
  82 @end
  83
  84 // ============================================================================
  85 // wxDataViewColumnNativeData
  86 // ============================================================================
  87 class wxDataViewColumnNativeData
  88 {
  89 public:
  90 //
  91 // constructors / destructor
  92 //
  93   wxDataViewColumnNativeData(void) : m_NativeColumnPtr(NULL)
  94   {
  95   }
  96   wxDataViewColumnNativeData(NSTableColumn* initNativeColumnPtr) : m_NativeColumnPtr(initNativeColumnPtr)
  97   {
  98   }
  99
 100 //
 101 // data access methods
 102 //
 103   NSTableColumn* GetNativeColumnPtr() const
 104   {
 105     return m_NativeColumnPtr;
 106   }
 107
 108   void SetNativeColumnPtr(NSTableColumn* newNativeColumnPtr)
 109   {
 110     m_NativeColumnPtr = newNativeColumnPtr;
 111   }
 112
 113 protected:
 114 private:
 115 //
 116 // variables
 117 //
 118   NSTableColumn* m_NativeColumnPtr; // this class does not take over ownership of the pointer nor retains it
 119 };
 120
 121 // ============================================================================
 122 // wxDataViewRendererNativeData
 123 // ============================================================================
 124 class wxDataViewRendererNativeData
 125 {
 126 public:
 127 //
 128 // constructors / destructor
 129 //
 130   wxDataViewRendererNativeData(void) : m_Object(NULL), m_ColumnCell(NULL)
 131   {
 132       Init();
 133   }
 134   wxDataViewRendererNativeData(NSCell* initColumnCell) : m_Object(NULL), m_ColumnCell([initColumnCell retain])
 135   {
 136       Init();
 137   }
 138   wxDataViewRendererNativeData(NSCell* initColumnCell, id initObject) : m_Object([initObject retain]), m_ColumnCell([initColumnCell retain])
 139   {
 140       Init();
 141   }
 142
 143   ~wxDataViewRendererNativeData()
 144   {
 145     [m_ColumnCell release];
 146     [m_Object     release];
 147
 148     [m_origFont release];
 149     [m_origTextColour release];
 150   }
 151
 152  //
 153  // data access methods
 154  //
 155   NSCell* GetColumnCell() const
 156   {
 157     return m_ColumnCell;
 158   }
 159   NSTableColumn* GetColumnPtr() const
 160   {
 161     return m_TableColumnPtr;
 162   }
 163   id GetItem() const
 164   {
 165     return m_Item;
 166   }
 167   NSCell* GetItemCell() const
 168   {
 169     return m_ItemCell;
 170   }
 171   id GetObject() const
 172   {
 173     return m_Object;
 174   }
 175
 176   void SetColumnCell(NSCell* newCell)
 177   {
 178     [newCell retain];
 179     [m_ColumnCell release];
 180     m_ColumnCell = newCell;
 181   }
 182   void SetColumnPtr(NSTableColumn* newColumnPtr)
 183   {
 184     m_TableColumnPtr = newColumnPtr;
 185   }
 186   void SetItem(id newItem)
 187   {
 188     m_Item = newItem;
 189   }
 190   void SetItemCell(NSCell* newCell)
 191   {
 192     m_ItemCell = newCell;
 193   }
 194   void SetObject(id newObject)
 195   {
 196     [newObject retain];
 197     [m_Object release];
 198     m_Object = newObject;
 199   }
 200
 201   // The original cell font and text colour stored here are NULL by default and
 202   // are only initialized to the values retrieved from the cell when we change
 203   // them from wxCocoaOutlineView:willDisplayCell:forTableColumn:item: which
 204   // calls our SaveOriginalXXX() methods before changing the cell attributes.
 205   //
 206   // This allows us to avoid doing anything for the columns without any
 207   // attributes but still be able to restore the correct attributes for the
 208   // ones that do.
 209   NSFont *GetOriginalFont() const { return m_origFont; }
 210   NSColor *GetOriginalTextColour() const { return m_origTextColour; }
 211
 212   void SaveOriginalFont(NSFont *font)
 213   {
 214       m_origFont = [font retain];
 215   }
 216
 217   void SaveOriginalTextColour(NSColor *textColour)
 218   {
 219       m_origTextColour = [textColour retain];
 220   }
 221
 222 private:
 223   void Init()
 224   {
 225       m_origFont = NULL;
 226       m_origTextColour = NULL;
 227   }
 228
 229   id m_Item;   // item NOT owned by renderer
 230   id m_Object; // object that can be used by renderer for storing special data (owned by renderer)
 231
 232   NSCell* m_ColumnCell; // column's cell is owned by renderer
 233   NSCell* m_ItemCell;   // item's cell is NOT owned by renderer
 234
 235   NSTableColumn* m_TableColumnPtr; // column NOT owned by renderer
 236
 237   // we own those if they're non-NULL
 238   NSFont *m_origFont;
 239   NSColor *m_origTextColour;
 240 };
 241
 242 // ============================================================================
 243 // wxCocoaOutlineDataSource
 244 // ============================================================================
 245 //
 246 // This class implements the data source delegate for the outline view.
 247 // As only an informal protocol exists this class inherits from NSObject only.
 248 //
 249 // As mentioned in the documentation for NSOutlineView the native control does
 250 // not own any data. Therefore, it has to be done by the data source.
 251 // Unfortunately, wxWidget's data source is a C++ data source but
 252 // NSOutlineDataSource requires objects as data. Therefore, the data (or better
 253 // the native item objects) have to be stored additionally in the native data
 254 // source.
 255 // NSOutlineView requires quick access to the item objects and quick linear
 256 // access to an item's children. This requires normally a hash type of storage
 257 // for the item object itself and an array structure for each item's children.
 258 // This means that basically two times the whole structure of wxWidget's model
 259 // class has to be stored.
 260 // This implementation is using a compromise: all items that are in use by the
 261 // control are stored in a set (from there they can be easily retrieved) and
 262 // owned by the set. Furthermore, children of the last parent are stored
 263 // in a linear list.
 264 //
 265 @interface wxCocoaOutlineDataSource : NSObject
 266 {
 267   NSArray* sortDescriptors; // descriptors specifying the sorting (currently the array only holds one object only)
 268
 269   NSMutableArray* children; // buffered children
 270
 271   NSMutableSet* items; // stores all items that are in use by the control
 272
 273   wxCocoaDataViewControl* implementation;
 274
 275   wxDataViewModel* model;
 276
 277   wxPointerObject* currentParentItem; // parent of the buffered children; the object is owned
 278 }
 279
 280  //
 281  // methods of informal protocol:
 282  //
 283   -(BOOL)            outlineView:(NSOutlineView*)outlineView acceptDrop:(id<NSDraggingInfo>)info item:(id)item childIndex:(NSInteger)index;
 284   -(id)              outlineView:(NSOutlineView*)outlineView child:(NSInteger)index ofItem:(id)item;
 285   -(id)              outlineView:(NSOutlineView*)outlineView objectValueForTableColumn:(NSTableColumn*)tableColumn byItem:(id)item;
 286   -(BOOL)            outlineView:(NSOutlineView*)outlineView isItemExpandable:(id)item;
 287   -(NSInteger)       outlineView:(NSOutlineView*)outlineView numberOfChildrenOfItem:(id)item;
 288   -(NSDragOperation) outlineView:(NSOutlineView*)outlineView validateDrop:(id<NSDraggingInfo>)info proposedItem:(id)item proposedChildIndex:(NSInteger)index;
 289   -(BOOL)            outlineView:(NSOutlineView*)outlineView writeItems:(NSArray*)items toPasteboard:(NSPasteboard*)pasteboard;
 290
 291  //
 292  // buffer for items handling
 293  //
 294   -(void)             addToBuffer:(wxPointerObject*)item;
 295   -(void)             clearBuffer;
 296   -(wxPointerObject*) getDataViewItemFromBuffer:(wxDataViewItem const&)item;  // returns the item in the buffer that has got the same pointer as "item",
 297   -(wxPointerObject*) getItemFromBuffer:(wxPointerObject*)item;               // if such an item does not exist nil is returned
 298   -(BOOL)             isInBuffer:(wxPointerObject*)item;
 299   -(void)             removeFromBuffer:(wxPointerObject*)item;
 300
 301  //
 302  // buffered children handling
 303  //
 304   -(void)             appendChild:(wxPointerObject*)item;
 305   -(void)             clearChildren;
 306   -(wxPointerObject*) getChild:(NSUInteger)index;
 307   -(NSUInteger)       getChildCount;
 308   -(void)             removeChild:(NSUInteger)index;
 309
 310  //
 311  // buffer handling
 312  //
 313   -(void) clearBuffers;
 314
 315  //
 316  // sorting
 317  //
 318   -(NSArray*) sortDescriptors;
 319   -(void)     setSortDescriptors:(NSArray*)newSortDescriptors;
 320
 321  //
 322  // access to wxWidget's variables
 323  //
 324   -(wxPointerObject*)        currentParentItem;
 325   -(wxCocoaDataViewControl*) implementation;
 326   -(wxDataViewModel*)        model;
 327   -(void)                    setCurrentParentItem:(wxPointerObject*)newCurrentParentItem;
 328   -(void)                    setImplementation:(wxCocoaDataViewControl*)newImplementation;
 329   -(void)                    setModel:(wxDataViewModel*)newModel;
 330
 331  //
 332  // other methods
 333  //
 334   -(void) bufferItem:(wxPointerObject*)parentItem withChildren:(wxDataViewItemArray*)dataViewChildrenPtr;
 335
 336 @end
 337
 338 // ============================================================================
 339 // wxCustomCell
 340 // ============================================================================
 341 //
 342 // This is a cell that is used for custom renderers.
 343 //
 344 @interface wxCustomCell : NSTextFieldCell
 345 {
 346 }
 347
 348  //
 349  // other methods
 350  //
 351   -(NSSize) cellSize;
 352
 353 @end
 354
 355 // ============================================================================
 356 // wxImageTextCell
 357 // ============================================================================
 358 //
 359 // As the native cocoa environment does not have a cell displaying an icon/
 360 // image and text at the same time, it has to be implemented by the user.
 361 // This implementation follows the implementation of Chuck Pisula in Apple's
 362 // DragNDropOutline sample application.
 363 // Although in wxDataViewCtrl icons are used on OSX icons do not exist for
 364 // display. Therefore, the cell is also called wxImageTextCell.
 365 // Instead of displaying images of any size (which is possible) this cell uses
 366 // a fixed size for displaying the image. Larger images are scaled to fit
 367 // into their reserved space. Smaller or not existing images use the fixed
 368 // reserved size and are scaled if necessary.
 369 //
 370 @interface wxImageTextCell : NSTextFieldCell
 371 {
 372 @private
 373   CGFloat xImageShift;    // shift for the image in x-direction from border
 374   CGFloat spaceImageText; // space between image and text ("belongs" to the image)
 375
 376   NSImage* image; // the image itself
 377
 378   NSSize imageSize; // largest size of the image; default size is (16, 16)
 379
 380   NSTextAlignment cellAlignment; // the text alignment is used to align the whole
 381                                  // cell (image and text)
 382 }
 383
 384  //
 385  // alignment
 386  //
 387   -(NSTextAlignment) alignment;
 388   -(void) setAlignment:(NSTextAlignment)newAlignment;
 389
 390  //
 391  // image access
 392  //
 393   -(NSImage*) image;
 394   -(void) setImage:(NSImage*)newImage;
 395
 396  //
 397  // size access
 398  //
 399   -(NSSize) imageSize;
 400   -(void) setImageSize:(NSSize) newImageSize;
 401
 402  //
 403  // other methods
 404  //
 405   -(NSSize) cellSize;
 406
 407 @end
 408
 409 // ============================================================================
 410 // wxCocoaOutlineView
 411 // ============================================================================
 412 @interface wxCocoaOutlineView : NSOutlineView
 413 {
 414 @private
 415   BOOL isEditingCell; // flag indicating if a cell is currently being edited
 416
 417   wxCocoaDataViewControl* implementation;
 418 }
 419
 420  //
 421  // access to wxWidget's implementation
 422  //
 423   -(wxCocoaDataViewControl*) implementation;
 424   -(void)                    setImplementation:(wxCocoaDataViewControl*) newImplementation;
 425
 426 @end
 427
 428 // ============================================================================
 429 // wxCocoaDataViewControl
 430 // ============================================================================
 431 //
 432 // This is the internal interface class between wxDataViewCtrl (wxWidget) and
 433 // the native source view (Mac OS X cocoa).
 434 //
 435 class wxCocoaDataViewControl : public wxWidgetCocoaImpl, public wxDataViewWidgetImpl
 436 {
 437 public:
 438  //
 439  // constructors / destructor
 440  //
 441   wxCocoaDataViewControl(wxWindow* peer, wxPoint const& pos, wxSize const& size, long style);
 442   ~wxCocoaDataViewControl();
 443
 444  //
 445  // column related methods (inherited from wxDataViewWidgetImpl)
 446  //
 447   virtual bool              ClearColumns       ();
 448   virtual bool              DeleteColumn       (wxDataViewColumn* columnPtr);
 449   virtual void              DoSetExpanderColumn(wxDataViewColumn const* columnPtr);
 450   virtual wxDataViewColumn* GetColumn          (unsigned int pos) const;
 451   virtual int               GetColumnPosition  (wxDataViewColumn const* columnPtr) const;
 452   virtual bool              InsertColumn       (unsigned int pos, wxDataViewColumn* columnPtr);
 453
 454  //
 455  // item related methods (inherited from wxDataViewWidgetImpl)
 456  //
 457   virtual bool         Add          (wxDataViewItem const& parent, wxDataViewItem const& item);
 458   virtual bool         Add          (wxDataViewItem const& parent, wxDataViewItemArray const& items);
 459   virtual void         Collapse     (wxDataViewItem const& item);
 460   virtual void         EnsureVisible(wxDataViewItem const& item, wxDataViewColumn const* columnPtr);
 461   virtual void         Expand       (wxDataViewItem const& item);
 462   virtual unsigned int GetCount     () const;
 463   virtual wxRect       GetRectangle (wxDataViewItem const& item, wxDataViewColumn const* columnPtr);
 464   virtual bool         IsExpanded   (wxDataViewItem const& item) const;
 465   virtual bool         Reload       ();
 466   virtual bool         Remove       (wxDataViewItem const& parent, wxDataViewItem const& item);
 467   virtual bool         Remove       (wxDataViewItem const& parent, wxDataViewItemArray const& item);
 468   virtual bool         Update       (wxDataViewColumn const* columnPtr);
 469   virtual bool         Update       (wxDataViewItem const& parent, wxDataViewItem const& item);
 470   virtual bool         Update       (wxDataViewItem const& parent, wxDataViewItemArray const& items);
 471
 472  //
 473  // model related methods
 474  //
 475   virtual bool AssociateModel(wxDataViewModel* model); // informs the native control that a model is present
 476
 477  //
 478  // selection related methods (inherited from wxDataViewWidgetImpl)
 479  //
 480   virtual int  GetSelections(wxDataViewItemArray& sel)   const;
 481   virtual bool IsSelected   (wxDataViewItem const& item) const;
 482   virtual void Select       (wxDataViewItem const& item);
 483   virtual void SelectAll    ();
 484   virtual void Unselect     (wxDataViewItem const& item);
 485   virtual void UnselectAll  ();
 486
 487  //
 488  // sorting related methods
 489  //
 490   virtual wxDataViewColumn* GetSortingColumn () const;
 491   virtual void              Resort           ();
 492
 493  //
 494  // other methods (inherited from wxDataViewWidgetImpl)
 495  //
 496   virtual void DoSetIndent (int indent);
 497   virtual void HitTest     (wxPoint const& point, wxDataViewItem& item, wxDataViewColumn*& columnPtr) const;
 498   virtual void SetRowHeight(wxDataViewItem const& item, unsigned int height);
 499   virtual void OnSize      ();
 500
 501  //
 502  // other methods
 503  //
 504   wxDataViewCtrl* GetDataViewCtrl() const
 505   {
 506     return dynamic_cast<wxDataViewCtrl*>(GetWXPeer());
 507   }
 508
 509 //
 510 // drag & drop helper methods
 511 //
 512   wxDataFormat           GetDnDDataFormat(wxDataObjectComposite* dataObjects);
 513   wxDataObjectComposite* GetDnDDataObjects(NSData* dataObject) const; // create the data objects from the native dragged object
 514 protected:
 515 private:
 516 //
 517 // variables
 518 //
 519   wxCocoaOutlineDataSource* m_DataSource;
 520
 521   wxCocoaOutlineView* m_OutlineView;
 522 };
 523
 524 typedef wxCocoaDataViewControl* wxCocoaDataViewControlPointer;
 525
 526
 527 #endif // wxUSE_GUI
 528 #endif // _WX_DATAVIEWCTRL_COCOOA_H_