src/osx/carbon/databrow.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/osx/carbon/databrow.cpp
   3 // Purpose:     Classes and functions for the Carbon data browser
   4 // Author:
   5 // Modified by:
   6 // Created:     2007-05-18
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c)
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #include "wx/wxprec.h"
  13
  14 #if wxUSE_DATAVIEWCTRL
  15 #ifndef wxUSE_GENERICDATAVIEWCTRL
  16
  17 #ifndef WX_PRECOMP
  18     #include "wx/app.h"
  19     #include "wx/toplevel.h"
  20     #include "wx/font.h"
  21     #include "wx/settings.h"
  22     #include "wx/utils.h"
  23 #endif
  24
  25 #include "wx/dataview.h"
  26 #include "wx/osx/carbon/databrow.h"
  27 #include "wx/osx/private.h"
  28 #include "wx/osx/uma.h"
  29
  30 #include <limits>
  31
  32 // ============================================================================
  33 // Variables used globally in databrow.cpp
  34 // ============================================================================
  35 DataBrowserGetContextualMenuUPP gDataBrowserTableViewGetContextualMenuUPP = NULL;
  36 DataBrowserItemCompareUPP       gDataBrowserTableViewItemCompareUPP       = NULL;
  37 DataBrowserItemDataUPP          gDataBrowserTableViewItemDataUPP          = NULL;
  38 DataBrowserItemNotificationUPP  gDataBrowserTableViewItemNotificationUPP  = NULL;
  39
  40 DataBrowserDrawItemUPP gDataBrowserTableViewDrawItemUPP = NULL;
  41 DataBrowserEditItemUPP gDataBrowserTableViewEditItemUPP = NULL;
  42 DataBrowserHitTestUPP  gDataBrowserTableViewHitTestUPP  = NULL;
  43 DataBrowserTrackingUPP gDataBrowserTableViewTrackingUPP = NULL;
  44
  45 // ============================================================================
  46 // wxMacDataBrowserTableViewControl
  47 // ============================================================================
  48
  49 pascal Boolean wxMacDataBrowserTableViewControl::DataBrowserCompareProc(ControlRef browser, DataBrowserItemID itemOneID, DataBrowserItemID itemTwoID, DataBrowserPropertyID sortProperty)
  50 {
  51   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  52
  53
  54   if (ControlPtr != NULL)
  55     return ControlPtr->DataBrowserCompareProc(itemOneID,itemTwoID,sortProperty);
  56   else
  57     return errDataBrowserPropertyNotSupported;
  58 } /* wxMacDataBrowserTableViewControl::DataBrowserCompareProc(ControlRef, DataBrowserItemID, DataBrowserItemID, DataBrowserPropertyID) */
  59
  60 pascal void wxMacDataBrowserTableViewControl::DataBrowserGetContextualMenuProc(ControlRef browser, MenuRef* menu, UInt32* helpType, CFStringRef* helpItemString, AEDesc* selection)
  61 {
  62   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  63
  64
  65   if (ControlPtr != NULL)
  66     ControlPtr->DataBrowserGetContextualMenuProc(menu,helpType,helpItemString,selection);
  67 } /* wxMacDataBrowserTableViewControl::DataBrowserGetContextualMenuProc(ControlRef, MenuRef*, UInt32*, CFStringRef*, AEDesc*) */
  68
  69 pascal OSStatus wxMacDataBrowserTableViewControl::DataBrowserGetSetItemDataProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserPropertyID propertyID, DataBrowserItemDataRef itemData, Boolean getValue)
  70 {
  71   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  72
  73
  74   if (ControlPtr != NULL)
  75     return ControlPtr->DataBrowserGetSetItemDataProc(itemID,propertyID,itemData,getValue);
  76   else
  77     return errDataBrowserPropertyNotSupported;
  78 } /* wxMacDataBrowserTableViewControl::DataBrowserGetSetItemDataProc(ControlRef, DataBrowserItemID, DataBrowserPropertyID, DataBrowserItemDataRef, Boolean) */
  79
  80 pascal void wxMacDataBrowserTableViewControl::DataBrowserItemNotificationProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserItemNotification message, DataBrowserItemDataRef itemData)
  81 {
  82   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  83
  84
  85   if (ControlPtr != NULL)
  86     ControlPtr->DataBrowserItemNotificationProc(itemID,message,itemData);
  87 } /* wxMacDataBrowserTableViewControl::DataBrowserItemNotificationProc(ControlRef, DataBrowserItemID, DataBrowserItemNotification, DataBrowserItemDataRef) */
  88
  89 pascal void wxMacDataBrowserTableViewControl::DataBrowserDrawItemProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserPropertyID propertyID, DataBrowserItemState state, Rect const* rectangle, SInt16 bitDepth, Boolean colorDevice)
  90 {
  91   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  92
  93
  94   if (ControlPtr != NULL)
  95     ControlPtr->DataBrowserDrawItemProc(itemID,propertyID,state,rectangle,bitDepth,colorDevice);
  96 } /* wxMacDataBrowserTableViewControl::DataBrowserDrawItemProc(ControlRef, DataBrowserItemID, DataBrowserPropertyID, DataBrowserItemState, Rect const*, SInt16, Boolean) */
  97
  98 pascal Boolean wxMacDataBrowserTableViewControl::DataBrowserEditItemProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserPropertyID propertyID, CFStringRef theString, Rect* maxEditTextRect, Boolean* shrinkToFit)
  99 {
 100   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
 101
 102
 103   return ((ControlPtr != NULL) && ControlPtr->DataBrowserEditItemProc(itemID,propertyID,theString,maxEditTextRect,shrinkToFit));
 104 } /* wxMacDataBrowserTableViewControl::DataBrowserEditItemProc(ControlRef, DataBrowserItemID, DataBrowserPropertyID, CFStringRef, Rect*, Boolean*) */
 105
 106 pascal Boolean wxMacDataBrowserTableViewControl::DataBrowserHitTestProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserPropertyID propertyID, Rect const* theRect, Rect const* mouseRect)
 107 {
 108   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
 109
 110
 111   return ((ControlPtr != NULL) && ControlPtr->DataBrowserHitTestProc(itemID,propertyID,theRect,mouseRect));
 112 } /* wxMacDataBrowserTableViewControl::DataBrowserHitTestProc(ControlRef, DataBrowserItemID, DataBrowserPropertyID, Rect const*, Rect const*) */
 113
 114 pascal DataBrowserTrackingResult wxMacDataBrowserTableViewControl::DataBrowserTrackingProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserPropertyID propertyID, Rect const* theRect, Point startPt, EventModifiers modifiers)
 115 {
 116   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
 117
 118
 119   if (ControlPtr != NULL)
 120     return ControlPtr->DataBrowserTrackingProc(itemID,propertyID,theRect,startPt,modifiers);
 121   else
 122     return kDataBrowserNothingHit;
 123 } /* wxMacDataBrowserTableViewControl::DataBrowserTrackingProc(ControlRef, DataBrowserItemID, DataBrowserPropertyID, Rect const*, Point, EventModifiers) */
 124
 125 wxMacDataBrowserTableViewControl::wxMacDataBrowserTableViewControl(wxWindow* peer, wxPoint const& pos, wxSize const& size, long style)
 126                                  :wxMacControl(peer)
 127 {
 128   Rect bounds = wxMacGetBoundsForControl(peer,pos,size);
 129   OSStatus err = ::CreateDataBrowserControl(MAC_WXHWND(peer->MacGetTopLevelWindowRef()),&bounds,kDataBrowserListView,&(this->m_controlRef));
 130
 131
 132   SetReferenceInNativeControl();
 133   verify_noerr(err);
 134  // setup standard callbacks:
 135   if (gDataBrowserTableViewGetContextualMenuUPP == NULL) gDataBrowserTableViewGetContextualMenuUPP = NewDataBrowserGetContextualMenuUPP(wxMacDataBrowserTableViewControl::DataBrowserGetContextualMenuProc);
 136   if (gDataBrowserTableViewItemCompareUPP       == NULL) gDataBrowserTableViewItemCompareUPP       = NewDataBrowserItemCompareUPP      (wxMacDataBrowserTableViewControl::DataBrowserCompareProc);
 137   if (gDataBrowserTableViewItemDataUPP          == NULL) gDataBrowserTableViewItemDataUPP          = NewDataBrowserItemDataUPP         (wxMacDataBrowserTableViewControl::DataBrowserGetSetItemDataProc);
 138   if (gDataBrowserTableViewItemNotificationUPP == NULL)
 139   {
 140     gDataBrowserTableViewItemNotificationUPP =
 141 #if TARGET_API_MAC_OSX
 142       (DataBrowserItemNotificationUPP) NewDataBrowserItemNotificationWithItemUPP(wxMacDataBrowserTableViewControl::DataBrowserItemNotificationProc);
 143 #else
 144       NewDataBrowserItemNotificationUPP(wxMacDataBrowserTableViewControl::DataBrowserItemNotificationProc);
 145 #endif
 146   }
 147   DataBrowserCallbacks callbacks; // variable definition
 148
 149   InitializeDataBrowserCallbacks(&callbacks,kDataBrowserLatestCallbacks);
 150   callbacks.u.v1.getContextualMenuCallback = gDataBrowserTableViewGetContextualMenuUPP;
 151   callbacks.u.v1.itemDataCallback          = gDataBrowserTableViewItemDataUPP;
 152   callbacks.u.v1.itemCompareCallback       = gDataBrowserTableViewItemCompareUPP;
 153   callbacks.u.v1.itemNotificationCallback  = gDataBrowserTableViewItemNotificationUPP;
 154   this->SetCallbacks(&callbacks);
 155
 156  // setup callbacks for customized items:
 157   if (gDataBrowserTableViewDrawItemUPP == NULL) gDataBrowserTableViewDrawItemUPP = NewDataBrowserDrawItemUPP(wxMacDataBrowserTableViewControl::DataBrowserDrawItemProc);
 158   if (gDataBrowserTableViewEditItemUPP == NULL) gDataBrowserTableViewEditItemUPP = NewDataBrowserEditItemUPP(wxMacDataBrowserTableViewControl::DataBrowserEditItemProc);
 159   if (gDataBrowserTableViewHitTestUPP  == NULL) gDataBrowserTableViewHitTestUPP  = NewDataBrowserHitTestUPP (wxMacDataBrowserTableViewControl::DataBrowserHitTestProc);
 160   if (gDataBrowserTableViewTrackingUPP == NULL) gDataBrowserTableViewTrackingUPP = NewDataBrowserTrackingUPP(wxMacDataBrowserTableViewControl::DataBrowserTrackingProc);
 161
 162   DataBrowserCustomCallbacks customCallbacks; // variable definition
 163
 164   InitializeDataBrowserCustomCallbacks(&customCallbacks,kDataBrowserLatestCallbacks);
 165   customCallbacks.u.v1.drawItemCallback = gDataBrowserTableViewDrawItemUPP;
 166   customCallbacks.u.v1.editTextCallback = gDataBrowserTableViewEditItemUPP;
 167   customCallbacks.u.v1.hitTestCallback  = gDataBrowserTableViewHitTestUPP;
 168   customCallbacks.u.v1.trackingCallback = gDataBrowserTableViewTrackingUPP;
 169   this->SetCustomCallbacks(&customCallbacks);
 170
 171  // style setting:
 172   this->EnableCellSizeModification( ((style & wxDV_VARIABLE_LINE_HEIGHT) != 0), true );
 173
 174   DataBrowserSelectionFlags flags; // variable definition
 175
 176   if (this->GetSelectionFlags(&flags) == noErr) // get default settings
 177   {
 178     if ((style & wxDV_MULTIPLE) != 0)
 179       flags &= ~kDataBrowserSelectOnlyOne;
 180     else
 181       flags |= kDataBrowserSelectOnlyOne;
 182     (void) this->SetSelectionFlags(flags);
 183   } /* if */
 184
 185   OptionBits attributes; // variable definition
 186
 187   if (this->GetAttributes(&attributes) == noErr) // get default settings
 188   {
 189     if ((style & wxDV_VERT_RULES) != 0)
 190       attributes |= kDataBrowserAttributeListViewDrawColumnDividers;
 191     else
 192       attributes &= ~kDataBrowserAttributeListViewDrawColumnDividers;
 193     if ((style & wxDV_ROW_LINES) != 0)
 194       attributes |= kDataBrowserAttributeListViewAlternatingRowColors;
 195     else
 196       attributes &= ~kDataBrowserAttributeListViewAlternatingRowColors;
 197     (void) this->SetAttributes(attributes);
 198   } /* if */
 199
 200   if ((style & wxDV_NO_HEADER) != 0)
 201     this->SetHeaderButtonHeight(0);
 202 } /* wxMacDataBrowserTableViewControl::wxMacDataBrowserTableViewControl(wxWindow*, wxPoint const&, wxSize const&, long) */
 203
 204 //
 205 // callback handling
 206 //
 207 OSStatus wxMacDataBrowserTableViewControl::SetCallbacks(DataBrowserCallbacks const* callbacks)
 208 {
 209   return ::SetDataBrowserCallbacks(this->m_controlRef,callbacks);
 210 } /* wxMacDataBrowserTableViewControl::SetCallbacks(DataBrowserCallbacks const*) */
 211
 212 OSStatus wxMacDataBrowserTableViewControl::SetCustomCallbacks(DataBrowserCustomCallbacks const* customCallbacks)
 213 {
 214   return ::SetDataBrowserCustomCallbacks(this->m_controlRef,customCallbacks);
 215 } /* xMacDataBrowserTableViewControl::SetCustomCallbacks(DataBrowserCustomCallbacks const*) */
 216
 217 //
 218 // header handling
 219 //
 220 OSStatus wxMacDataBrowserTableViewControl::GetHeaderDesc(DataBrowserPropertyID propertyID, DataBrowserListViewHeaderDesc* desc) const
 221 {
 222   desc->version = kDataBrowserListViewLatestHeaderDesc; // if this statement is missing the next call will fail (NOT DOCUMENTED!!)
 223   return ::GetDataBrowserListViewHeaderDesc(this->m_controlRef,propertyID,desc);
 224 }
 225
 226 OSStatus wxMacDataBrowserTableViewControl::SetHeaderDesc(DataBrowserPropertyID propertyID, DataBrowserListViewHeaderDesc* desc)
 227 {
 228   return ::SetDataBrowserListViewHeaderDesc(this->m_controlRef,propertyID,desc);
 229 }
 230
 231 //
 232 // layout handling
 233 //
 234 OSStatus wxMacDataBrowserTableViewControl::AutoSizeColumns()
 235 {
 236   return AutoSizeDataBrowserListViewColumns(this->m_controlRef);
 237 }
 238
 239 OSStatus wxMacDataBrowserTableViewControl::EnableCellSizeModification(bool enableHeight, bool enableWidth)
 240 {
 241   return ::SetDataBrowserTableViewGeometry(this->GetControlRef(),enableWidth,enableHeight);
 242 } /* wxMacDataBrowserTableViewControl::EnableCellSizeModification(bool, bool) */
 243
 244 OSStatus wxMacDataBrowserTableViewControl::GetAttributes(OptionBits* attributes)
 245 {
 246   return ::DataBrowserGetAttributes(this->GetControlRef(),attributes);
 247 } /* wxMacDataBrowserTableViewControl::GetAttributes(OptionBits*) */
 248
 249 OSStatus wxMacDataBrowserTableViewControl::GetColumnWidth(DataBrowserPropertyID propertyID, UInt16* width) const
 250 {
 251   return ::GetDataBrowserTableViewNamedColumnWidth(this->m_controlRef,propertyID,width);
 252 }
 253
 254 OSStatus wxMacDataBrowserTableViewControl::GetDefaultColumnWidth( UInt16 *width ) const
 255 {
 256     return GetDataBrowserTableViewColumnWidth(this->m_controlRef, width );
 257 }
 258
 259 OSStatus wxMacDataBrowserTableViewControl::GetDefaultRowHeight(UInt16* height) const
 260 {
 261   return ::GetDataBrowserTableViewRowHeight(this->m_controlRef,height);
 262 }
 263
 264 OSStatus wxMacDataBrowserTableViewControl::GetHeaderButtonHeight(UInt16 *height)
 265 {
 266   return ::GetDataBrowserListViewHeaderBtnHeight(this->m_controlRef,height);
 267 }
 268
 269 OSStatus wxMacDataBrowserTableViewControl::GetPartBounds(DataBrowserItemID item, DataBrowserPropertyID propertyID, DataBrowserPropertyPart part, Rect* bounds)
 270 {
 271   return ::GetDataBrowserItemPartBounds(this->m_controlRef,item,propertyID,part,bounds);
 272 } /* wxMacDataBrowserTableViewControl::GetPartBounds(DataBrowserItemID, DataBrowswerPropertyID, DataBrowserPropertyPart, Rect*) */
 273
 274 OSStatus wxMacDataBrowserTableViewControl::GetRowHeight(DataBrowserItemID item, UInt16* height) const
 275 {
 276   return ::GetDataBrowserTableViewItemRowHeight(this->m_controlRef,item,height);
 277 } /* wxMacDataBrowserTableViewControl::GetRowHeight(DataBrowserItemID, UInt16*) const */
 278
 279 OSStatus wxMacDataBrowserTableViewControl::GetScrollPosition( UInt32 *top , UInt32 *left ) const
 280 {
 281     return GetDataBrowserScrollPosition(this->m_controlRef, top , left );
 282 }
 283
 284 OSStatus wxMacDataBrowserTableViewControl::SetAttributes(OptionBits attributes)
 285 {
 286   return ::DataBrowserChangeAttributes(this->GetControlRef(),attributes,~attributes);
 287 } /* wxMacDataBrowserTableViewControl::SetAttributes(OptionBits) */
 288
 289 OSStatus wxMacDataBrowserTableViewControl::SetColumnWidth(DataBrowserPropertyID propertyID, UInt16 width)
 290 {
 291   return ::SetDataBrowserTableViewNamedColumnWidth(this->m_controlRef,propertyID,width);
 292 }
 293
 294 OSStatus wxMacDataBrowserTableViewControl::SetDefaultColumnWidth(UInt16 width)
 295 {
 296   return ::SetDataBrowserTableViewColumnWidth(this->m_controlRef,width);
 297 }
 298
 299 OSStatus wxMacDataBrowserTableViewControl::SetDefaultRowHeight(UInt16 height)
 300 {
 301   return ::SetDataBrowserTableViewRowHeight(this->m_controlRef,height);
 302 }
 303
 304 OSStatus wxMacDataBrowserTableViewControl::SetHasScrollBars(bool horiz, bool vert)
 305 {
 306   return ::SetDataBrowserHasScrollBars(this->m_controlRef,horiz,vert);
 307 } /* wxMacDataBrowserTableViewControl::SetHasScrollBars(bool, bool) */
 308
 309 OSStatus wxMacDataBrowserTableViewControl::SetHeaderButtonHeight(UInt16 height)
 310 {
 311   return ::SetDataBrowserListViewHeaderBtnHeight(this->m_controlRef,height);
 312 } /* wxMacDataBrowserTableViewControl::SetHeaderButtonHeight(UInt16) */
 313
 314 OSStatus wxMacDataBrowserTableViewControl::SetHiliteStyle(DataBrowserTableViewHiliteStyle hiliteStyle)
 315 {
 316   return ::SetDataBrowserTableViewHiliteStyle(this->m_controlRef,hiliteStyle);
 317 } /*wxMacDataBrowserTableViewControl::SetHiliteStyle(DataBrowserTableViewHiliteStyle)  */
 318
 319 OSStatus wxMacDataBrowserTableViewControl::SetIndent(float Indent)
 320 {
 321   return ::DataBrowserSetMetric(this->m_controlRef,kDataBrowserMetricDisclosureColumnPerDepthGap,true,Indent);
 322 } /* wxMacDataBrowserTableViewControl::SetIndent(float* Indent) */
 323
 324 OSStatus wxMacDataBrowserTableViewControl::SetRowHeight(DataBrowserItemID item, UInt16 height)
 325 {
 326   return ::SetDataBrowserTableViewItemRowHeight(this->m_controlRef,item,height);
 327 }
 328
 329 OSStatus wxMacDataBrowserTableViewControl::SetScrollPosition(UInt32 top, UInt32 left)
 330 {
 331   return ::SetDataBrowserScrollPosition(this->m_controlRef,top,left);
 332 }
 333
 334 //
 335 // column handling
 336 //
 337 OSStatus wxMacDataBrowserTableViewControl::GetColumnCount(UInt32* numColumns) const
 338 {
 339   return ::GetDataBrowserTableViewColumnCount(this->m_controlRef,numColumns);
 340 }
 341
 342 OSStatus wxMacDataBrowserTableViewControl::GetColumnIndex(DataBrowserPropertyID propertyID, DataBrowserTableViewColumnIndex* index) const
 343 {
 344   return ::GetDataBrowserTableViewColumnPosition(this->m_controlRef,propertyID,index);
 345 } /* wxMacDataBrowserTableViewControl::GetColumnIndex(DataBrowserPropertyID, DataBrowserTableViewColumnIndex*) const */
 346
 347 OSStatus wxMacDataBrowserTableViewControl::GetFreePropertyID(DataBrowserPropertyID* propertyID) const
 348 {
 349   for (*propertyID=kMinPropertyID; *propertyID<std::numeric_limits<DataBrowserPropertyID>::max(); ++(*propertyID))
 350     if (this->IsUsedPropertyID(*propertyID) == errDataBrowserPropertyNotFound)
 351       return noErr;
 352   return errDataBrowserPropertyNotSupported;
 353 } /* wxMacDataBrowserTableViewControl::GetFreePropertyID(DataBrowserPropertyID*) const */
 354
 355 OSStatus wxMacDataBrowserTableViewControl::GetPropertyFlags(DataBrowserPropertyID propertyID, DataBrowserPropertyFlags *flags) const
 356 {
 357   return ::GetDataBrowserPropertyFlags(this->m_controlRef,propertyID,flags);
 358 }
 359
 360 OSStatus wxMacDataBrowserTableViewControl::GetPropertyID(DataBrowserItemDataRef itemData, DataBrowserPropertyID* propertyID)
 361 {
 362   return ::GetDataBrowserItemDataProperty(itemData,propertyID);
 363 } /* wxMacDataBrowserTableViewControl::GetPropertyID(DataBrowserItemDataRef, DataBrowserPropertyID*) */
 364
 365 OSStatus wxMacDataBrowserTableViewControl::GetPropertyID(DataBrowserTableViewColumnIndex index, DataBrowserTableViewColumnID* propertyID)
 366 {
 367   return ::GetDataBrowserTableViewColumnProperty(this->m_controlRef,index,propertyID);
 368 } /* wxMacDataBrowserTableViewControl::GetPropertyID(DataBrowserTableViewColumnIndex, DataBrowserTableViewColumnID*) */
 369
 370 OSStatus wxMacDataBrowserTableViewControl::IsUsedPropertyID(DataBrowserPropertyID propertyID) const
 371 {
 372  // as the Mac interface does not provide a function that checks if the property id is in use or not a function is chosen that should not
 373  // lead to a large overhead for the call but returns an error code if the property id does not exist, here we use the function that returns
 374  // the column position for the property id:
 375   DataBrowserTableViewColumnIndex index;
 376
 377   return ::GetDataBrowserTableViewColumnPosition(this->m_controlRef,propertyID,&index);
 378 } /* wxMacDataBrowserTableViewControl::IsUsedPropertyId(DataBrowserPropertyID) const */
 379
 380 OSStatus wxMacDataBrowserTableViewControl::RemoveColumnByProperty(DataBrowserTableViewColumnID propertyID)
 381 {
 382   return ::RemoveDataBrowserTableViewColumn(this->m_controlRef,propertyID);
 383 } /* wxMacDataBrowserTableViewControl::RemoveColumnByProperty(DataBrowserTableViewColumnID) */
 384
 385 OSStatus wxMacDataBrowserTableViewControl::RemoveColumnByIndex(DataBrowserTableViewColumnIndex index)
 386 {
 387   DataBrowserTableViewColumnID propertyID;
 388
 389
 390   this->GetPropertyID(index,&propertyID);
 391   return ::RemoveDataBrowserTableViewColumn(this->m_controlRef,propertyID);
 392 } /* wxMacDataBrowserTableViewControl::RemoveColumnByIndex(DataBrowserTableViewColumnIndex) */
 393
 394 OSStatus wxMacDataBrowserTableViewControl::SetColumnIndex(DataBrowserPropertyID propertyID, DataBrowserTableViewColumnIndex index)
 395 {
 396   return ::SetDataBrowserTableViewColumnPosition(this->m_controlRef,propertyID,index);
 397 } /* wxMacDataBrowserTableViewControl::SetColumnIndex(DataBrowserPropertyID, DataBrowserTableViewColumnIndex) */
 398
 399 OSStatus wxMacDataBrowserTableViewControl::SetDisclosureColumn(DataBrowserPropertyID propertyID, Boolean expandableRows)
 400 {
 401   return ::SetDataBrowserListViewDisclosureColumn(this->m_controlRef,propertyID,expandableRows);
 402 }
 403
 404 OSStatus wxMacDataBrowserTableViewControl::SetPropertyFlags(DataBrowserPropertyID propertyID, DataBrowserPropertyFlags flags)
 405 {
 406   return ::SetDataBrowserPropertyFlags(this->m_controlRef,propertyID,flags);
 407 } /* wxMacDataBrowserTableViewControl::SetPropertyFlags(DataBrowserPropertyID, DataBrowserPropertyFlags) */
 408
 409 //
 410 // item handling
 411 //
 412 OSStatus wxMacDataBrowserTableViewControl::AddItems(DataBrowserItemID container, UInt32 numItems, DataBrowserItemID const* items, DataBrowserPropertyID preSortProperty)
 413 {
 414   return ::AddDataBrowserItems(this->m_controlRef,container,numItems,items,preSortProperty);
 415 } /* wxMacDataBrowserTableViewControl::AddItems(DataBrowserItemID, UInt32, DataBrowserItemID const*, DataBrowserPropertyID) */
 416
 417 OSStatus wxMacDataBrowserTableViewControl::GetFreeItemID(DataBrowserItemID* id) const
 418 {
 419   ItemCount NoOfItems;
 420
 421   OSStatus status;
 422
 423
 424   status = this->GetItemCount(&NoOfItems);
 425   wxCHECK_MSG(status == noErr,status,_("Could not retrieve number of items"));
 426   if (NoOfItems == 0)
 427   {
 428     *id = 1;
 429     return noErr;
 430   } /* if */
 431   else
 432   {
 433    // as there might be a lot of items in the data browser and mostly the data is added item by item the largest used ID number is roughly in the order of magnitude
 434    // as the number of items; therefore, start from the number of items to look for a new ID:
 435     for (*id=NoOfItems; *id<std::numeric_limits<DataBrowserItemID>::max(); ++(*id))
 436       if (this->IsUsedItemID(*id) == errDataBrowserItemNotFound)
 437         return noErr;
 438    // as the first approach was not successful, try from the beginning:
 439     for (*id=0; *id<NoOfItems; ++(*id))
 440       if (this->IsUsedItemID(*id) == errDataBrowserItemNotFound)
 441         return noErr;
 442    // sorry, data browser is full:
 443     return errDataBrowserItemNotAdded;
 444   } /* if */
 445 } /* wxMacDataBrowserTableViewControl::GetFreeItemID(DataBrowserItemID*) const */
 446
 447 OSStatus wxMacDataBrowserTableViewControl::GetItemCount(DataBrowserItemID container, Boolean recurse, DataBrowserItemState state, ItemCount* numItems) const
 448 {
 449   return GetDataBrowserItemCount(this->m_controlRef,container,recurse,state,numItems);
 450 } /* wxMacDataBrowserTableViewControl::GetItemCount(DataBrowserItemID, Boolean, DataBrowserItemState, ItemCount*) const */
 451
 452 OSStatus wxMacDataBrowserTableViewControl::GetItemID( DataBrowserTableViewRowIndex row, DataBrowserItemID * item ) const
 453 {
 454   return GetDataBrowserTableViewItemID(this->m_controlRef,row,item);
 455 }
 456
 457 OSStatus wxMacDataBrowserTableViewControl::GetItems(DataBrowserItemID container, Boolean recurse, DataBrowserItemState state, Handle items) const
 458 {
 459   return GetDataBrowserItems(this->m_controlRef,container,recurse,state,items);
 460 } /* wxMacDataBrowserTableViewControl::GetItems(DataBrowserItemID, Boolean, DataBrowserItemState, Handle) const */
 461
 462 OSStatus wxMacDataBrowserTableViewControl::GetItemRow(DataBrowserItemID item, DataBrowserTableViewRowIndex* row) const
 463 {
 464   return GetDataBrowserTableViewItemRow(this->m_controlRef,item,row);
 465 }
 466
 467 OSStatus wxMacDataBrowserTableViewControl::IsUsedItemID(DataBrowserItemID itemID) const
 468 {
 469  // as the Mac interface does not provide a function that checks if the property id is in use or not a function is chosen that should not
 470  // lead to a large overhead for the call but returns an error code if the property id does not exist, here we use the function that returns
 471  // the column position for the property id:
 472   DataBrowserTableViewColumnIndex index;
 473
 474   return ::GetDataBrowserTableViewItemRow(this->m_controlRef,itemID,&index);
 475 } /* wxMacDataBrowserTableViewControl::IsUsedItemID(DataBrowserItemID) const */
 476
 477 OSStatus wxMacDataBrowserTableViewControl::RemoveItems(DataBrowserItemID container, UInt32 numItems, DataBrowserItemID const* items, DataBrowserPropertyID preSortProperty)
 478 {
 479   return ::RemoveDataBrowserItems(this->m_controlRef,container,numItems,items,preSortProperty);
 480 }
 481
 482 OSStatus wxMacDataBrowserTableViewControl::RevealItem(DataBrowserItemID item, DataBrowserPropertyID propertyID, DataBrowserRevealOptions options) const
 483 {
 484   return ::RevealDataBrowserItem(this->m_controlRef,item,propertyID,options);
 485 } /* wxMacDataBrowserTableViewControl::RevealItem(DataBrowserItemID item, DataBrowserPropertyID propertyID, DataBrowserRevealOptions options) const */
 486
 487 OSStatus wxMacDataBrowserTableViewControl::UpdateItems(DataBrowserItemID container, UInt32 numItems, DataBrowserItemID const* items, DataBrowserPropertyID preSortProperty,
 488                                                        DataBrowserPropertyID propertyID) const
 489 {
 490   return UpdateDataBrowserItems(this->m_controlRef,container,numItems,items,preSortProperty,propertyID);
 491 }
 492
 493 //
 494 // item selection
 495 //
 496 size_t wxMacDataBrowserTableViewControl::GetSelectedItemIDs(wxArrayDataBrowserItemID& itemIDs) const
 497 {
 498   DataBrowserItemID* itemIDPtr;
 499   Handle handle(::NewHandle(0));
 500
 501   size_t NoOfItems;
 502
 503
 504   wxCHECK_MSG(this->GetItems(kDataBrowserNoItem,true,kDataBrowserItemIsSelected,handle) == noErr,0,_("Could not get selected items."));
 505   NoOfItems = static_cast<size_t>(::GetHandleSize(handle)/sizeof(DataBrowserItemID));
 506   itemIDs.Empty();
 507   itemIDs.Alloc(NoOfItems);
 508   HLock(handle);
 509   itemIDPtr = (DataBrowserItemID*) (*handle);
 510   for (size_t i=0; i<NoOfItems; ++i)
 511   {
 512     itemIDs.Add(*itemIDPtr);
 513     ++itemIDPtr;
 514   } /* for */
 515   HUnlock(handle);
 516   DisposeHandle(handle);
 517   return NoOfItems;
 518 } /* wxMacDataBrowserTableViewControl::GetSelectedItemIDs(wxArrayDataBrowserItemID&) const*/
 519
 520 OSStatus wxMacDataBrowserTableViewControl::GetSelectionAnchor(DataBrowserItemID* first, DataBrowserItemID* last) const
 521 {
 522   return ::GetDataBrowserSelectionAnchor(this->m_controlRef,first,last);
 523 } /* wxMacDataBrowserTableViewControl::GetSelectionAnchor(DataBrowserItemID*, DataBrowserItemID*) const */
 524
 525 OSStatus wxMacDataBrowserTableViewControl::GetSelectionFlags(DataBrowserSelectionFlags* flags) const
 526 {
 527   return ::GetDataBrowserSelectionFlags(this->m_controlRef,flags);
 528 } /* wxMacDataBrowserTableViewControl::GetSelectionFlags(DataBrowserSelectionFlags*) const */
 529
 530 bool wxMacDataBrowserTableViewControl::IsItemSelected(DataBrowserItemID item) const
 531 {
 532   return ::IsDataBrowserItemSelected(this->m_controlRef,item);
 533 } /* wxMacDataBrowserTableViewControl::IsItemSelected(DataBrowserItemID) const */
 534
 535 OSStatus wxMacDataBrowserTableViewControl::SetSelectionFlags(DataBrowserSelectionFlags flags)
 536 {
 537   return ::SetDataBrowserSelectionFlags(this->m_controlRef,flags);
 538 } /* wxMacDataBrowserTableViewControl::SetSelectionFlags(DataBrowserSelectionFlags) */
 539
 540 OSStatus wxMacDataBrowserTableViewControl::SetSelectedItems(UInt32 numItems, DataBrowserItemID const* items, DataBrowserSetOption operation)
 541 {
 542   return ::SetDataBrowserSelectedItems(this->m_controlRef, numItems, items, operation );
 543 } /* wxMacDataBrowserTableViewControl::SetSelectedItems(UInt32, DataBrowserItemID const*, DataBrowserSetOption) */
 544
 545 OSStatus wxMacDataBrowserTableViewControl::GetSortOrder(DataBrowserSortOrder* order) const
 546 {
 547   return ::GetDataBrowserSortOrder(this->m_controlRef,order);
 548 }
 549
 550 OSStatus wxMacDataBrowserTableViewControl::GetSortProperty(DataBrowserPropertyID* propertyID) const
 551 {
 552   return ::GetDataBrowserSortProperty(this->m_controlRef,propertyID);
 553 }
 554
 555 OSStatus wxMacDataBrowserTableViewControl::Resort(DataBrowserItemID container, Boolean sortChildren)
 556 {
 557   return ::SortDataBrowserContainer(this->m_controlRef,container,sortChildren);
 558 } /* wxMacDataBrowserTableViewControl::Resort(DataBrowserItemID, Boolean) */
 559
 560 OSStatus wxMacDataBrowserTableViewControl::SetSortOrder(DataBrowserSortOrder order)
 561 {
 562   return ::SetDataBrowserSortOrder(this->m_controlRef,order);
 563 }
 564
 565 OSStatus wxMacDataBrowserTableViewControl::SetSortProperty(DataBrowserPropertyID propertyID)
 566 {
 567   return ::SetDataBrowserSortProperty(this->m_controlRef,propertyID);
 568 }
 569
 570 //
 571 // container handling
 572 //
 573 OSStatus wxMacDataBrowserTableViewControl::CloseContainer(DataBrowserItemID containerID)
 574 {
 575   return ::CloseDataBrowserContainer(this->m_controlRef,containerID);
 576 } /* wxMacDataBrowserTableViewControl::CloseContainer(DataBrowserItemID) */
 577
 578 OSStatus wxMacDataBrowserTableViewControl::OpenContainer(DataBrowserItemID containerID)
 579 {
 580   return ::OpenDataBrowserContainer(this->m_controlRef,containerID);
 581 } /* wxMacDataBrowserTableViewControl::OpenContainer(DataBrowserItemID) */
 582
 583 IMPLEMENT_ABSTRACT_CLASS(wxMacDataBrowserTableViewControl,wxMacControl)
 584
 585 // ============================================================================
 586 // wxMacDataBrowserListViewControl
 587 // ============================================================================
 588 #pragma mark -
 589 //
 590 // column handling
 591 //
 592 OSStatus wxMacDataBrowserListViewControl::AddColumn(DataBrowserListViewColumnDesc *columnDesc, DataBrowserTableViewColumnIndex position)
 593 {
 594   return AddDataBrowserListViewColumn(this->m_controlRef,columnDesc,position);
 595 } /* wxMacDataBrowserListViewControl::AddColumn(DataBrowserListViewColumnDesc*, DataBrowserTableViewColumnIndex) */
 596
 597 // ============================================================================
 598 // wxMacDataViewDataBrowserListViewControl
 599 // ============================================================================
 600 #pragma mark -
 601 //
 602 // constructors / destructor
 603 //
 604 wxMacDataViewDataBrowserListViewControl::wxMacDataViewDataBrowserListViewControl(wxWindow* peer, wxPoint const& pos, wxSize const& size, long style)
 605                                         :wxMacDataBrowserListViewControl(peer,pos,size,style)
 606 {
 607 } /* wxMacDataViewDataBrowserListViewControl::wxMacDataViewDataBrowserListViewControl(wxWindow* , const wxPoint&, const wxSize&, long) */
 608
 609 //
 610 // callback functions (inherited from wxMacDataBrowserTableViewControl)
 611 //
 612 Boolean wxMacDataViewDataBrowserListViewControl::DataBrowserCompareProc(DataBrowserItemID itemOneID, DataBrowserItemID itemTwoID, DataBrowserPropertyID sortProperty)
 613 {
 614   DataBrowserSortOrder sortOrder;
 615
 616   DataBrowserTableViewColumnIndex modelColumnIndex;
 617
 618   wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer()));
 619
 620
 621   wxCHECK_MSG(dataViewCtrlPtr != NULL,            false,_("Pointer to data view control not set correctly."));
 622   wxCHECK_MSG(dataViewCtrlPtr->GetModel() != NULL,false,_("Pointer to model not set correctly."));
 623   if (sortProperty >= kMinPropertyID)
 624   {
 625    // variable definition and initialization:
 626     wxDataViewColumn* ColumnPtr(dataViewCtrlPtr->GetColumnPtr(sortProperty));
 627
 628     wxCHECK_MSG(ColumnPtr != NULL,false,_("Could not determine column index."));
 629     modelColumnIndex = ColumnPtr->GetModelColumn();
 630   } /* if */
 631   else
 632     modelColumnIndex = 0;
 633   this->GetSortOrder(&sortOrder);
 634   return static_cast<Boolean>(dataViewCtrlPtr->GetModel()->Compare(wxDataViewItem(reinterpret_cast<void*>(itemOneID)),wxDataViewItem(reinterpret_cast<void*>(itemTwoID)),
 635                               modelColumnIndex,sortOrder != kDataBrowserOrderDecreasing) < 0);
 636 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserCompareProc(DataBrowserItemID, DataBrowserItemID, DataBrowserPropertyID) */
 637
 638 void wxMacDataViewDataBrowserListViewControl::DataBrowserGetContextualMenuProc(MenuRef* menu, UInt32* helpType, CFStringRef* helpItemString, AEDesc* WXUNUSED(selection))
 639  // In this method we do not supply a contextual menu handler at all but only send a wxEVT_COMMAND_DATAVIEW_ITEM_CONTEXT_MENU.
 640 {
 641   wxArrayDataBrowserItemID itemIDs;
 642
 643   wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer()));
 644
 645
 646   wxCHECK_RET(dataViewCtrlPtr != NULL,_("wxWidget control pointer is not a data view pointer"));
 647  // initialize parameters so that no context menu will be displayed automatically by the native data browser:
 648   *menu           = NULL;
 649   *helpType       = kCMHelpItemNoHelp;
 650   *helpItemString = NULL;
 651  // create information for a context menu event:
 652   wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_CONTEXT_MENU,dataViewCtrlPtr->GetId());
 653
 654   dataViewEvent.SetEventObject(dataViewCtrlPtr);
 655   dataViewEvent.SetModel(dataViewCtrlPtr->GetModel());
 656  // get the item information;
 657  // theoretically more than one ID can be returned but the event can only handle one item, therefore all item related data is using the data of the first item in the array:
 658   if (this->GetSelectedItemIDs(itemIDs) > 0)
 659     dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemIDs[0])));
 660  // finally send the equivalent wxWidget event:
 661   dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 662 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserGetContextualMenuProc(MenuRef*, UInt32*, CFStringRef*, AEDesc*) */
 663
 664 OSStatus wxMacDataViewDataBrowserListViewControl::DataBrowserGetSetItemDataProc(DataBrowserItemID itemID, DataBrowserPropertyID propertyID, DataBrowserItemDataRef itemData, Boolean getValue)
 665 {
 666   if (getValue)
 667   {
 668    // variable definitions:
 669     wxDataViewCtrl* dataViewCtrlPtr;
 670
 671     dataViewCtrlPtr = dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer());
 672     wxCHECK_MSG(dataViewCtrlPtr != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 673     if (dataViewCtrlPtr->IsDeleting())
 674       return noErr; // if a delete process is running the data of editable fields cannot be saved because the associated model variable may already have been deleted
 675     else
 676     {
 677      // variable definitions:
 678       OSStatus          errorStatus;
 679       wxDataViewColumn* dataViewColumnPtr;
 680
 681       wxCHECK_MSG(dataViewCtrlPtr->GetModel() != NULL,errDataBrowserNotConfigured,_("Pointer to model not set correctly."));
 682       dataViewColumnPtr = dataViewCtrlPtr->GetColumnPtr(propertyID);
 683       wxCHECK_MSG((dataViewColumnPtr != NULL) && (dataViewColumnPtr->GetRenderer() != NULL),errDataBrowserNotConfigured,_("There is no column or renderer for the specified column index."));
 684
 685       wxDataViewItem      dvItem(reinterpret_cast<void*>(itemID));
 686       unsigned int        col = dataViewColumnPtr->GetModelColumn();
 687
 688       switch (dataViewColumnPtr->GetRenderer()->GetPropertyType())
 689       {
 690         case kDataBrowserCheckboxType:
 691           {
 692            // variable definition:
 693             ThemeButtonValue buttonValue;
 694
 695             errorStatus = ::GetDataBrowserItemDataButtonValue(itemData,&buttonValue);
 696             if (errorStatus == noErr)
 697             {
 698               if (buttonValue == kThemeButtonOn)
 699               {
 700                // variable definition and initialization:
 701                 wxVariant modifiedData(true);
 702
 703                 if (dataViewCtrlPtr->GetModel()->SetValue(modifiedData, dvItem, col) &&
 704                     dataViewCtrlPtr->GetModel()->ValueChanged(dvItem, col))
 705                     return noErr;
 706                 else
 707                     return errDataBrowserInvalidPropertyData;
 708               } /* if */
 709               else if (buttonValue == kThemeButtonOff)
 710               {
 711                // variable definition and initialization:
 712                 wxVariant modifiedData(false);
 713
 714                 if (dataViewCtrlPtr->GetModel()->SetValue(modifiedData, dvItem, col) &&
 715                     dataViewCtrlPtr->GetModel()->ValueChanged(dvItem, col))
 716                     return noErr;
 717                 else
 718                     return errDataBrowserInvalidPropertyData;
 719               } /* if */
 720               else
 721                 return errDataBrowserInvalidPropertyData;
 722             } /* if */
 723             else
 724               return errorStatus;
 725           } /* block */
 726         case kDataBrowserTextType:
 727           {
 728            // variable definitions:
 729             CFStringRef stringReference;
 730
 731             errorStatus = ::GetDataBrowserItemDataText(itemData,&stringReference);
 732             if (errorStatus == noErr)
 733             {
 734              // variable definitions and initializations:
 735 #if wxCHECK_VERSION(2,9,0)
 736               wxCFStringRef modifiedString(stringReference);
 737 #else
 738               wxMacCFStringHolder modifiedString(stringReference);
 739 #endif
 740               wxVariant           modifiedData(modifiedString.AsString());
 741
 742                 if (dataViewCtrlPtr->GetModel()->SetValue(modifiedData, dvItem, col) &&
 743                     dataViewCtrlPtr->GetModel()->ValueChanged(dvItem, col))
 744                     return noErr;
 745                 else
 746                     return errDataBrowserInvalidPropertyData;
 747             } /* if */
 748             else
 749               return errorStatus;
 750           } /* block */
 751         default:
 752           return errDataBrowserPropertyNotSupported;
 753       } /* switch */
 754     } /* if */
 755   } /* if */
 756   else
 757   {
 758     if (propertyID >= kMinPropertyID) // in case data columns set the data
 759     {
 760      // variable definitions:
 761       wxVariant         variant;
 762       wxDataViewColumn* dataViewColumnPtr;
 763       wxDataViewCtrl*   dataViewCtrlPtr;
 764
 765       dataViewCtrlPtr = dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer());
 766       wxCHECK_MSG(dataViewCtrlPtr             != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 767       wxCHECK_MSG(dataViewCtrlPtr->GetModel() != NULL,errDataBrowserNotConfigured,_("Pointer to model not set correctly."));
 768       dataViewColumnPtr = dataViewCtrlPtr->GetColumnPtr(propertyID);
 769       wxCHECK_MSG(dataViewColumnPtr                != NULL,errDataBrowserNotConfigured,_("No column for the specified column position existing."));
 770       wxCHECK_MSG(dataViewColumnPtr->GetRenderer() != NULL,errDataBrowserNotConfigured,_("No renderer specified for column."));
 771       dataViewCtrlPtr->GetModel()->GetValue(variant,wxDataViewItem(reinterpret_cast<void*>(itemID)),dataViewColumnPtr->GetModelColumn());
 772       if (!(variant.IsNull()))
 773       {
 774         dataViewColumnPtr->GetRenderer()->SetDataReference(itemData);
 775         dataViewColumnPtr->GetRenderer()->SetValue(variant);
 776         wxCHECK_MSG(dataViewColumnPtr->GetRenderer()->Render(),errDataBrowserNotConfigured,_("Rendering failed."));
 777       } /* if */
 778       return noErr;
 779     } /* if */
 780     else // react on special system requests
 781     {
 782       switch (propertyID)
 783       {
 784         case kDataBrowserContainerIsClosableProperty:
 785           {
 786            // variable definitions:
 787             wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer()));
 788
 789             wxCHECK_MSG(dataViewCtrlPtr != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 790            // initialize wxWidget event:
 791             wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSING,dataViewCtrlPtr->GetId()); // variable definition
 792
 793             dataViewEvent.SetEventObject(dataViewCtrlPtr);
 794             dataViewEvent.SetItem       (wxDataViewItem(reinterpret_cast<void*>(itemID)));
 795             dataViewEvent.SetModel      (dataViewCtrlPtr->GetModel());
 796            // finally send the equivalent wxWidget event:
 797             dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 798            // opening the container is allowed if not vetoed:
 799             return ::SetDataBrowserItemDataBooleanValue(itemData,dataViewEvent.IsAllowed());
 800           } /* block */
 801         case kDataBrowserContainerIsOpenableProperty:
 802           {
 803            // variable definitions:
 804             wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer()));
 805
 806             wxCHECK_MSG(dataViewCtrlPtr != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 807            // initialize wxWidget event:
 808             wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDING,dataViewCtrlPtr->GetId()); // variable definition
 809
 810             dataViewEvent.SetEventObject(dataViewCtrlPtr);
 811             dataViewEvent.SetItem       (wxDataViewItem(reinterpret_cast<void*>(itemID)));
 812             dataViewEvent.SetModel      (dataViewCtrlPtr->GetModel());
 813            // finally send the equivalent wxWidget event:
 814             dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 815            // opening the container is allowed if not vetoed:
 816             return ::SetDataBrowserItemDataBooleanValue(itemData,dataViewEvent.IsAllowed());
 817           } /* block */
 818         case kDataBrowserItemIsContainerProperty:
 819           {
 820            // variable definition:
 821             wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer()));
 822
 823             wxCHECK_MSG(dataViewCtrlPtr             != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 824             wxCHECK_MSG(dataViewCtrlPtr->GetModel() != NULL,errDataBrowserNotConfigured,_("Pointer to model not set correctly."));
 825             return ::SetDataBrowserItemDataBooleanValue(itemData,dataViewCtrlPtr->GetModel()->IsContainer(wxDataViewItem(reinterpret_cast<void*>(itemID))));
 826           } /* block */
 827         case kDataBrowserItemIsEditableProperty:
 828           return ::SetDataBrowserItemDataBooleanValue(itemData,true);
 829       } /* switch */
 830     } /* if */
 831   } /* if */
 832   return errDataBrowserPropertyNotSupported;
 833 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserGetSetItemDataProc(DataBrowserItemID, DataBrowserPropertyID, DataBrowserItemDataRef, Boolean) */
 834
 835 void wxMacDataViewDataBrowserListViewControl::DataBrowserItemNotificationProc(DataBrowserItemID itemID, DataBrowserItemNotification message, DataBrowserItemDataRef itemData)
 836 {
 837   wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer()));
 838
 839
 840  // check if the data view control pointer still exists because this call back function can still be called when the control has already been deleted:
 841   if (dataViewCtrlPtr != NULL)
 842     switch (message)
 843     {
 844       case kDataBrowserContainerClosed:
 845         dataViewCtrlPtr->FinishCustomItemEditing(); // stop editing of a custom item first (if necessary)
 846         {
 847          // initialize wxWidget event:
 848           wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSED,dataViewCtrlPtr->GetId()); // variable definition
 849
 850           dataViewEvent.SetEventObject(dataViewCtrlPtr);
 851           dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 852          // finally send the equivalent wxWidget event:
 853           dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 854         } /* block */
 855         break;
 856       case kDataBrowserContainerOpened:
 857         dataViewCtrlPtr->FinishCustomItemEditing(); // stop editing of a custom item first (if necessary)
 858         {
 859          // initialize wxWidget event:
 860           wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDED,dataViewCtrlPtr->GetId()); // variable definition
 861
 862           dataViewEvent.SetEventObject(dataViewCtrlPtr);
 863           dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 864          // finally send the equivalent wxWidget event:
 865           dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 866          // add children to the expanded container:
 867           dataViewCtrlPtr->AddChildrenLevel(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 868         } /* block */
 869         break;
 870       case kDataBrowserEditStarted:
 871         dataViewCtrlPtr->FinishCustomItemEditing(); // stop editing of a custom item first (if necessary)
 872         {
 873          // initialize wxWidget event:
 874           DataBrowserPropertyID propertyID;
 875           wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_EDITING_STARTED,dataViewCtrlPtr->GetId()); // variable definition
 876
 877           dataViewEvent.SetEventObject(dataViewCtrlPtr);
 878           dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 879           if (this->GetPropertyID(itemData,&propertyID) == noErr)
 880           {
 881            // variable definition and initialization:
 882             DataBrowserTableViewColumnIndex columnIndex;
 883
 884             wxCHECK_RET(this->GetColumnIndex(propertyID,&columnIndex),_("Column index not found."));
 885             dataViewEvent.SetColumn(columnIndex);
 886             dataViewEvent.SetDataViewColumn(dataViewCtrlPtr->GetColumnPtr(propertyID));
 887           } /* if */
 888          // finally send the equivalent wxWidget event:
 889           dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 890         } /* block */
 891         break;
 892       case kDataBrowserEditStopped:
 893         {
 894          // initialize wxWidget event:
 895           DataBrowserPropertyID propertyID;
 896           wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_EDITING_DONE,dataViewCtrlPtr->GetId()); // variable definition
 897
 898           dataViewEvent.SetEventObject(dataViewCtrlPtr);
 899           dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 900           if (this->GetPropertyID(itemData,&propertyID) == noErr)
 901           {
 902            // variable definition and initialization:
 903             DataBrowserTableViewColumnIndex columnIndex;
 904
 905             wxCHECK_RET(this->GetColumnIndex(propertyID,&columnIndex),_("Column index not found."));
 906             dataViewEvent.SetColumn(columnIndex);
 907             dataViewEvent.SetDataViewColumn(dataViewCtrlPtr->GetColumnPtr(propertyID));
 908           } /* if */
 909          // finally send the equivalent wxWidget event:
 910           dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 911         } /* block */
 912         break;
 913       case kDataBrowserItemAdded:
 914         dataViewCtrlPtr->FinishCustomItemEditing();
 915         break;
 916       case kDataBrowserItemDeselected:
 917         dataViewCtrlPtr->FinishCustomItemEditing();
 918         break;
 919       case kDataBrowserItemDoubleClicked:
 920         {
 921          // initialize wxWidget event:
 922           wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_ACTIVATED,dataViewCtrlPtr->GetId()); // variable definition
 923
 924           dataViewEvent.SetEventObject(dataViewCtrlPtr);
 925           dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 926          // finally send the equivalent wxWidget event:
 927           dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 928         } /* block */
 929         break;
 930       case kDataBrowserItemRemoved:
 931         dataViewCtrlPtr->FinishCustomItemEditing(); // stop editing of a custom item first (if necessary)
 932         break;
 933       case kDataBrowserItemSelected:
 934         break; // not implemented by wxWidgets; see kDataBrowserSelectionSetChanged
 935       case kDataBrowserSelectionSetChanged:
 936         {
 937          // initialize wxWidget event:
 938           wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_SELECTION_CHANGED,dataViewCtrlPtr->GetId()); // variable definition
 939
 940           dataViewEvent.SetEventObject(dataViewCtrlPtr);
 941           dataViewEvent.SetModel      (dataViewCtrlPtr->GetModel());
 942          // finally send the equivalent wxWidget event:
 943           dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 944         } /* block */
 945         break;
 946       case kDataBrowserTargetChanged: // no idea if this notification is ever sent
 947         break;
 948       case kDataBrowserUserStateChanged:
 949         {
 950          // finish custom item editing if necessary:
 951           dataViewCtrlPtr->FinishCustomItemEditing();
 952          // update column widths:
 953           for (size_t i=0; i<dataViewCtrlPtr->GetColumnCount(); ++i)
 954           {
 955            // constant definition for abbreviational purposes:
 956             wxDataViewColumn* const columnPtr = dataViewCtrlPtr->GetColumn(i);
 957            // variable definition:
 958             UInt16 columnWidth;
 959
 960             wxCHECK_RET(this->GetColumnWidth(columnPtr->GetPropertyID(),&columnWidth) == noErr,_("Column width could not be determined"));
 961             columnPtr->SetWidthVariable(columnWidth);
 962           } /* for */
 963          // update sorting orders:
 964           DataBrowserPropertyID propertyID; // variable definition
 965
 966           if ((this->GetSortProperty(&propertyID) == noErr) && (propertyID >= kMinPropertyID))
 967           {
 968             DataBrowserSortOrder            sortOrder;
 969             DataBrowserTableViewColumnIndex columnIndex;
 970
 971             if ((this->GetSortOrder(&sortOrder) == noErr) && (this->GetColumnIndex(propertyID,&columnIndex) == noErr))
 972             {
 973              // variable definition and initialization:
 974               wxDataViewColumn* columnPtr;
 975               columnPtr = dataViewCtrlPtr->GetColumn(columnIndex);
 976              // check if the sort order has changed:
 977               if (  columnPtr->IsSortOrderAscending()  && (sortOrder == kDataBrowserOrderDecreasing) ||
 978                   !(columnPtr->IsSortOrderAscending()) && (sortOrder == kDataBrowserOrderIncreasing))
 979               {
 980                 columnPtr->SetSortOrder(!(columnPtr->IsSortOrderAscending()));
 981                // initialize wxWidget event:
 982                 wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_COLUMN_SORTED,dataViewCtrlPtr->GetId()); // variable defintion
 983
 984                 dataViewEvent.SetEventObject(dataViewCtrlPtr);
 985                 dataViewEvent.SetColumn(columnIndex);
 986                 dataViewEvent.SetDataViewColumn(columnPtr);
 987                // finally send the equivalent wxWidget event:
 988                 dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 989               } /* if */
 990             } /* if */
 991           } /* if */
 992         } /* block */
 993         break;
 994     } /* switch */
 995 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserItemNotificationProc(DataBrowserItemID, DataBrowserItemNotification, DataBrowserItemDataRef) */
 996
 997 void wxMacDataViewDataBrowserListViewControl::DataBrowserDrawItemProc(DataBrowserItemID itemID, DataBrowserPropertyID propertyID, DataBrowserItemState state, Rect const* rectangle, SInt16 bitDepth, Boolean colorDevice)
 998 {
 999   DataBrowserTableViewColumnIndex columnIndex;
1000
1001   wxDataViewColumn* dataViewColumnPtr;
1002
1003   wxDataViewCtrl* dataViewCtrlPtr;
1004
1005   wxDataViewCustomRenderer* dataViewCustomRendererPtr;
1006
1007   wxVariant dataToRender;
1008
1009   dataViewCtrlPtr = dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer());
1010   wxCHECK_RET(dataViewCtrlPtr != NULL,            _("Pointer to data view control not set correctly."));
1011   wxCHECK_RET(dataViewCtrlPtr->GetModel() != NULL,_("Pointer to model not set correctly."));
1012   wxCHECK_RET(this->GetColumnIndex(propertyID,&columnIndex) == noErr,_("Could not determine column index."));
1013   dataViewColumnPtr = dataViewCtrlPtr->GetColumnPtr(propertyID);
1014   wxCHECK_RET(dataViewColumnPtr != NULL,_("No column for the specified column index existing."));
1015   dataViewCustomRendererPtr = dynamic_cast<wxDataViewCustomRenderer*>(dataViewColumnPtr->GetRenderer());
1016   wxCHECK_RET(dataViewCustomRendererPtr != NULL,_("No renderer or invalid renderer type specified for custom data column."));
1017   dataViewCtrlPtr->GetModel()->GetValue(dataToRender,wxDataViewItem(reinterpret_cast<void*>(itemID)),dataViewColumnPtr->GetModelColumn());
1018   dataViewCustomRendererPtr->SetValue(dataToRender);
1019
1020   wxDataViewItem dataitem( reinterpret_cast<void*>(itemID) );
1021   dataViewCtrlPtr->GetModel()->GetValue(dataToRender,dataitem,dataViewColumnPtr->GetModelColumn());
1022   dataViewCustomRendererPtr->SetValue(dataToRender);
1023
1024  // try to determine the content's size (drawable part):
1025   Rect      content;
1026   RgnHandle rgn(NewRgn());
1027   UInt16    headerHeight;
1028
1029   if (this->GetRegion(kControlContentMetaPart,rgn) == noErr)
1030     GetRegionBounds(rgn,&content);
1031   else
1032     GetControlBounds(m_controlRef, &content);
1033   ::DisposeRgn(rgn);
1034  // space for the header
1035   this->GetHeaderButtonHeight(&headerHeight);
1036   content.top += headerHeight;
1037  // extra space for the frame (todo: do not how to determine the space automatically from the control)
1038   content.top    += 5;
1039   content.left   += 5;
1040   content.right  -= 3;
1041   content.bottom -= 3;
1042  // extra space for the scrollbars:
1043   content.bottom -= wxSystemSettings::GetMetric(wxSYS_HSCROLL_Y);
1044   content.right  -= wxSystemSettings::GetMetric(wxSYS_VSCROLL_X);
1045
1046   wxDC *dc = dataViewCustomRendererPtr->GetDC();
1047
1048   wxRect cellrect( static_cast<int>(rectangle->left),
1049                    static_cast<int>(rectangle->top+2),
1050                    static_cast<int>(1+rectangle->right-rectangle->left),
1051                    static_cast<int>(rectangle->bottom-rectangle->top) );
1052
1053   bool is_active = IsControlActive( this->m_controlRef );
1054   if (state == kDataBrowserItemIsSelected)
1055   {
1056
1057       wxColour col( wxMacCreateCGColorFromHITheme( (is_active) ?
1058                              kThemeBrushAlternatePrimaryHighlightColor
1059                              : kThemeBrushSecondaryHighlightColor ) );
1060
1061       wxRect rect = cellrect;
1062       Rect itemrect;
1063       GetDataBrowserItemPartBounds( this->m_controlRef, itemID, propertyID,
1064          kDataBrowserPropertyEnclosingPart, &itemrect );
1065       rect.x = itemrect.left;
1066       rect.width = itemrect.right-itemrect.left+1;
1067
1068       wxBrush selBrush( col );
1069       wxPen oldpen( dc->GetPen() );
1070       wxBrush oldbrush( dc->GetBrush() );
1071       dc->SetPen( *wxTRANSPARENT_PEN );
1072       dc->SetBrush( selBrush );
1073       dc->DrawRectangle(rect);
1074       dc->SetBrush( oldbrush );
1075       dc->SetPen( oldpen );
1076   }
1077
1078   wxDataViewModel *model = dataViewCtrlPtr->GetModel();
1079   if ((columnIndex == 0) || !model->IsContainer(dataitem) || model->HasContainerColumns(dataitem))
1080   {
1081       // make sure that 'Render' can draw only in the allowed area:
1082       dc->SetClippingRegion(content.left,content.top,content.right-content.left+1,content.bottom-content.top+1);
1083       (void) (dataViewCustomRendererPtr->Render( cellrect, dc,
1084                                             ((state == kDataBrowserItemIsSelected) ? wxDATAVIEW_CELL_SELECTED : 0)));
1085       dc->DestroyClippingRegion(); // probably not necessary
1086   }
1087
1088   dataViewCustomRendererPtr->SetDC(NULL);
1089 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserDrawItemProc(DataBrowserItemID, DataBrowserPropertyID, DataBrowserItemState, Rect const*, SInt16, Boolean) */
1090
1091 Boolean wxMacDataViewDataBrowserListViewControl::DataBrowserEditItemProc(DataBrowserItemID itemID, DataBrowserPropertyID propertyID, CFStringRef theString, Rect* maxEditTextRect, Boolean* shrinkToFit)
1092 {
1093   return false;
1094 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserEditItemProc(DataBrowserItemID, DataBrowserPropertyID, CFStringRef, Rect*, Boolean*) */
1095
1096 Boolean wxMacDataViewDataBrowserListViewControl::DataBrowserHitTestProc(DataBrowserItemID WXUNUSED(itemID), DataBrowserPropertyID WXUNUSED(property), Rect const* WXUNUSED(theRect), Rect const* WXUNUSED(mouseRect))
1097 {
1098   return true;
1099 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserHitTestProc(DataBrowserItemID, DataBrowserPropertyID, Rect const*, Rect const*) */
1100
1101 DataBrowserTrackingResult wxMacDataViewDataBrowserListViewControl::DataBrowserTrackingProc(DataBrowserItemID itemID, DataBrowserPropertyID propertyID, Rect const* theRect, Point WXUNUSED(startPt), EventModifiers WXUNUSED(modifiers))
1102 {
1103   wxDataViewColumn* dataViewColumnPtr;
1104
1105   wxDataViewCtrl* dataViewCtrlPtr;
1106
1107   wxDataViewCustomRenderer* dataViewCustomRendererPtr;
1108
1109   wxDataViewItem dataViewCustomRendererItem;
1110
1111
1112   dataViewCustomRendererItem = reinterpret_cast<void*>(itemID);
1113   wxCHECK_MSG(dataViewCustomRendererItem.IsOk(),kDataBrowserNothingHit,_("Invalid data view item"));
1114   dataViewCtrlPtr = dynamic_cast<wxDataViewCtrl*>(this->GetWXPeer());
1115   wxCHECK_MSG(dataViewCtrlPtr != NULL,kDataBrowserNothingHit,_("Pointer to data view control not set correctly."));
1116   dataViewColumnPtr = dataViewCtrlPtr->GetColumnPtr(propertyID);
1117   wxCHECK_MSG(dataViewColumnPtr != NULL,kDataBrowserNothingHit,_("No column existing."));
1118   dataViewCustomRendererPtr = dynamic_cast<wxDataViewCustomRenderer*>(dataViewColumnPtr->GetRenderer());
1119   wxCHECK_MSG(dataViewCustomRendererPtr != NULL,kDataBrowserNothingHit,_("No renderer or invalid renderer type specified for custom data column."));
1120  // if the currently edited item is identical to the to be edited nothing is done (this hit should only be handled in the control itself):
1121   if (dataViewCtrlPtr->GetCustomRendererItem() == dataViewCustomRendererItem)
1122     return kDataBrowserContentHit;
1123  // an(other) item is going to be edited and therefore the current editing - if existing - has to be finished:
1124   if (dataViewCtrlPtr->GetCustomRendererPtr() != NULL)
1125   {
1126     dataViewCtrlPtr->GetCustomRendererPtr()->FinishEditing();
1127     dataViewCtrlPtr->SetCustomRendererItem(wxDataViewItem());
1128     dataViewCtrlPtr->SetCustomRendererPtr (NULL);
1129   } /* if */
1130  // check if renderer has got a valid editor control for editing; if this is the case start editing of the new item:
1131   if (dataViewCustomRendererPtr->HasEditorCtrl())
1132   {
1133    // variable definition:
1134     wxRect wxRectangle;
1135
1136     ::wxMacNativeToRect(theRect,&wxRectangle);
1137     dataViewCustomRendererPtr->StartEditing(dataViewCustomRendererItem,wxRectangle);
1138     dataViewCtrlPtr->SetCustomRendererItem(dataViewCustomRendererItem);
1139     dataViewCtrlPtr->SetCustomRendererPtr (dataViewCustomRendererPtr);
1140   } /* if */
1141   return kDataBrowserContentHit;
1142 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserTrackingProc(DataBrowserItemID, DataBrowserPropertyID, Rect const*, Point, EventModifiers) */
1143
1144 #endif // wxUSE_GENERICDATAVIEWCTRL
1145 #endif // wxUSE_DATAVIEWCTRL