src/mac/carbon/databrow.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/mac/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 #ifndef wxUSE_GENERICDATAVIEWCTRL
  13
  14 #include <ctype.h>
  15
  16 #include <stdio.h>
  17 #include <stdlib.h>
  18 #include <string.h>
  19 #include <stdarg.h>
  20
  21 #include "wx/wxprec.h"
  22
  23 #include "wx/utils.h"
  24
  25 #ifndef WX_PRECOMP
  26     #include "wx/app.h"
  27     #include "wx/toplevel.h"
  28     #include "wx/font.h"
  29 #endif
  30
  31 #include "wx/apptrait.h"
  32
  33 #include "wx/mac/uma.h"
  34
  35
  36 #ifdef __DARWIN__
  37     #include <Carbon/Carbon.h>
  38 #else
  39     #include <ATSUnicode.h>
  40     #include <TextCommon.h>
  41     #include <TextEncodingConverter.h>
  42 #endif
  43
  44 #include "wx/mac/private.h"
  45
  46 #if defined(__MWERKS__) && wxUSE_UNICODE
  47 #if __MWERKS__ < 0x4100 || !defined(__DARWIN__)
  48     #include <wtime.h>
  49 #endif
  50 #endif
  51
  52 #include <limits>
  53
  54 #include "wx/mac/carbon/databrow.h"
  55
  56 #include "wx/dataview.h"
  57
  58 // ============================================================================
  59 // wxMacDataBrowserTableViewControl
  60 // ============================================================================
  61
  62 pascal Boolean wxMacDataBrowserTableViewControl::DataBrowserCompareProc(ControlRef browser, DataBrowserItemID itemOneID, DataBrowserItemID itemTwoID, DataBrowserPropertyID sortProperty)
  63 {
  64   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  65
  66
  67   if (ControlPtr != NULL)
  68     return ControlPtr->DataBrowserCompareProc(itemOneID,itemTwoID,sortProperty);
  69   else
  70     return errDataBrowserPropertyNotSupported;
  71 } /* wxMacDataBrowserTableViewControl::DataBrowserCompareProc(ControlRef, DataBrowserItemID, DataBrowserItemID, DataBrowserPropertyID) */
  72
  73 pascal void wxMacDataBrowserTableViewControl::DataBrowserDrawItemProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserPropertyID property, DataBrowserItemState state, Rect const* rectangle, SInt16 bitDepth, Boolean colorDevice)
  74 {
  75   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  76
  77
  78   if (ControlPtr != NULL)
  79     ControlPtr->DataBrowserDrawItemProc(itemID,property,state,rectangle,bitDepth,colorDevice);
  80 } /* wxMacDataBrowserTableViewControl::DataBrowserDrawItemProc(ControlRef, DataBrowserItemID, DataBrowserPropertyID, DataBrowserItemState, Rect const*, SInt16, Boolean) */
  81
  82 pascal OSStatus wxMacDataBrowserTableViewControl::DataBrowserGetSetItemDataProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserPropertyID property, DataBrowserItemDataRef itemData, Boolean getValue)
  83 {
  84   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  85
  86
  87   if (ControlPtr != NULL)
  88     return ControlPtr->DataBrowserGetSetItemDataProc(itemID,property,itemData,getValue);
  89   else
  90     return errDataBrowserPropertyNotSupported;
  91 } /* wxMacDataBrowserTableViewControl::DataBrowserGetSetItemDataProc(ControlRef, DataBrowserItemID, DataBrowserPropertyID, DataBrowserItemDataRef, Boolean) */
  92
  93 pascal void wxMacDataBrowserTableViewControl::DataBrowserItemNotificationProc(ControlRef browser, DataBrowserItemID itemID, DataBrowserItemNotification message, DataBrowserItemDataRef itemData)
  94 {
  95   wxMacDataBrowserTableViewControl* ControlPtr(dynamic_cast<wxMacDataBrowserTableViewControl*>(wxMacControl::GetReferenceFromNativeControl(browser)));
  96
  97
  98   if (ControlPtr != NULL)
  99     ControlPtr->DataBrowserItemNotificationProc(itemID,message,itemData);
 100 } /* wxMacDataBrowserTableViewControl::DataBrowserItemNotificationProc(ControlRef, DataBrowserItemID, DataBrowserItemNotification, DataBrowserItemDataRef) */
 101
 102 DataBrowserDrawItemUPP         gDataBrowserTableViewDrawItemUPP         = NULL;
 103 DataBrowserItemCompareUPP      gDataBrowserTableViewItemCompareUPP      = NULL;
 104 DataBrowserItemDataUPP         gDataBrowserTableViewItemDataUPP         = NULL;
 105 DataBrowserItemNotificationUPP gDataBrowserTableViewItemNotificationUPP = NULL;
 106
 107 wxMacDataBrowserTableViewControl::wxMacDataBrowserTableViewControl(wxWindow* peer, wxPoint const& pos, wxSize const& size, long style)
 108                                  :wxMacControl(peer)
 109 {
 110   Rect bounds = wxMacGetBoundsForControl(peer,pos,size);
 111   OSStatus err = ::CreateDataBrowserControl(MAC_WXHWND(peer->MacGetTopLevelWindowRef()),&bounds,kDataBrowserListView,&(this->m_controlRef));
 112
 113
 114   SetReferenceInNativeControl();
 115   verify_noerr(err);
 116   if (gDataBrowserTableViewDrawItemUPP         == NULL) gDataBrowserTableViewDrawItemUPP    = NewDataBrowserDrawItemUPP   (DataBrowserDrawItemProc);
 117   if (gDataBrowserTableViewItemCompareUPP      == NULL) gDataBrowserTableViewItemCompareUPP = NewDataBrowserItemCompareUPP(wxMacDataBrowserTableViewControl::DataBrowserCompareProc);
 118   if (gDataBrowserTableViewItemDataUPP         == NULL) gDataBrowserTableViewItemDataUPP    = NewDataBrowserItemDataUPP   (wxMacDataBrowserTableViewControl::DataBrowserGetSetItemDataProc);
 119   if (gDataBrowserTableViewItemNotificationUPP == NULL)
 120   {
 121     gDataBrowserTableViewItemNotificationUPP =
 122 #if TARGET_API_MAC_OSX
 123       (DataBrowserItemNotificationUPP) NewDataBrowserItemNotificationWithItemUPP(wxMacDataBrowserTableViewControl::DataBrowserItemNotificationProc);
 124 #else
 125       NewDataBrowserItemNotificationUPP(wxMacDataBrowserTableViewControl::DataBrowserItemNotificationProc);
 126 #endif
 127   }
 128
 129   DataBrowserCallbacks       callbacks;
 130   DataBrowserCustomCallbacks customCallbacks;
 131
 132   InitializeDataBrowserCallbacks      (&callbacks,      kDataBrowserLatestCallbacks);
 133   InitializeDataBrowserCustomCallbacks(&customCallbacks,kDataBrowserLatestCallbacks);
 134
 135   callbacks.u.v1.itemDataCallback         = gDataBrowserTableViewItemDataUPP;
 136   callbacks.u.v1.itemCompareCallback      = gDataBrowserTableViewItemCompareUPP;
 137   callbacks.u.v1.itemNotificationCallback = gDataBrowserTableViewItemNotificationUPP;
 138   this->SetCallbacks(&callbacks);
 139
 140   customCallbacks.u.v1.drawItemCallback = gDataBrowserTableViewDrawItemUPP;
 141   this->SetCustomCallbacks(&customCallbacks);
 142
 143  // style setting:
 144   this->EnableCellSizeModification();
 145
 146   DataBrowserSelectionFlags flags; // variable definition
 147
 148   if (this->GetSelectionFlags(&flags) == noErr) // get default settings
 149   {
 150     if ((style & wxDV_MULTIPLE) != 0)
 151       flags &= ~kDataBrowserSelectOnlyOne;
 152     else
 153       flags |= kDataBrowserSelectOnlyOne;
 154     (void) this->SetSelectionFlags(flags);
 155   } /* if */
 156 #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
 157   OptionBits attributes; // variable definition
 158
 159   if (this->GetAttributes(&attributes) == noErr) // get default settings
 160   {
 161     if ((style & wxDV_VERT_RULES) != 0)
 162       attributes |= kDataBrowserAttributeListViewDrawColumnDividers;
 163     else
 164       attributes &= ~kDataBrowserAttributeListViewDrawColumnDividers;
 165     (void) this->SetAttributes(attributes);
 166   } /* if */
 167 #endif
 168   if ((style & wxDV_NO_HEADER) != 0)
 169     this->SetHeaderButtonHeight(0);
 170 } /* wxMacDataBrowserTableViewControl::wxMacDataBrowserTableViewControl(wxWindow*, wxPoint const&, wxSize const&, long) */
 171
 172 //
 173 // callback handling
 174 //
 175 OSStatus wxMacDataBrowserTableViewControl::SetCallbacks(DataBrowserCallbacks const* callbacks)
 176 {
 177   return ::SetDataBrowserCallbacks(this->m_controlRef,callbacks);
 178 } /* wxMacDataBrowserTableViewControl::SetCallbacks(DataBrowserCallbacks const*) */
 179
 180 OSStatus wxMacDataBrowserTableViewControl::SetCustomCallbacks(DataBrowserCustomCallbacks const* customCallbacks)
 181 {
 182   return ::SetDataBrowserCustomCallbacks(this->m_controlRef,customCallbacks);
 183 } /* xMacDataBrowserTableViewControl::SetCustomCallbacks(DataBrowserCustomCallbacks const*) */
 184
 185 //
 186 // header handling
 187 //
 188 OSStatus wxMacDataBrowserTableViewControl::GetHeaderDesc(DataBrowserPropertyID property, DataBrowserListViewHeaderDesc* desc) const
 189 {
 190   desc->version = kDataBrowserListViewLatestHeaderDesc; // if this statement is missing the next call will fail (NOT DOCUMENTED!!)
 191   return ::GetDataBrowserListViewHeaderDesc(this->m_controlRef,property,desc);
 192 }
 193
 194 OSStatus wxMacDataBrowserTableViewControl::SetHeaderDesc(DataBrowserPropertyID property, DataBrowserListViewHeaderDesc* desc)
 195 {
 196   return ::SetDataBrowserListViewHeaderDesc(this->m_controlRef,property,desc);
 197 }
 198
 199 //
 200 // layout handling
 201 //
 202 OSStatus wxMacDataBrowserTableViewControl::AutoSizeColumns()
 203 {
 204   return AutoSizeDataBrowserListViewColumns(this->m_controlRef);
 205 }
 206
 207 OSStatus wxMacDataBrowserTableViewControl::EnableCellSizeModification(bool enableHeight, bool enableWidth)
 208 {
 209   return ::SetDataBrowserTableViewGeometry(this->GetControlRef(),enableWidth,enableHeight);
 210 } /* wxMacDataBrowserTableViewControl::EnableCellSizeModification(bool, bool) */
 211
 212 #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
 213 OSStatus wxMacDataBrowserTableViewControl::GetAttributes(OptionBits* attributes)
 214 {
 215   return ::DataBrowserGetAttributes(this->GetControlRef(),attributes);
 216 } /* wxMacDataBrowserTableViewControl::GetAttributes(OptionBits*) */
 217 #endif
 218
 219 OSStatus wxMacDataBrowserTableViewControl::GetColumnWidth(DataBrowserPropertyID propertyID, UInt16* width) const
 220 {
 221   return ::GetDataBrowserTableViewNamedColumnWidth(this->m_controlRef,propertyID,width);
 222 }
 223
 224 OSStatus wxMacDataBrowserTableViewControl::GetDefaultColumnWidth( UInt16 *width ) const
 225 {
 226     return GetDataBrowserTableViewColumnWidth(this->m_controlRef, width );
 227 }
 228
 229 OSStatus wxMacDataBrowserTableViewControl::GetDefaultRowHeight(UInt16* height) const
 230 {
 231   return ::GetDataBrowserTableViewRowHeight(this->m_controlRef,height);
 232 }
 233
 234 OSStatus wxMacDataBrowserTableViewControl::GetHeaderButtonHeight(UInt16 *height)
 235 {
 236   return ::GetDataBrowserListViewHeaderBtnHeight(this->m_controlRef,height);
 237 }
 238
 239 OSStatus wxMacDataBrowserTableViewControl::GetPartBounds(DataBrowserItemID item, DataBrowserPropertyID property, DataBrowserPropertyPart part, Rect* bounds)
 240 {
 241   return ::GetDataBrowserItemPartBounds(this->m_controlRef,item,property,part,bounds);
 242 } /* wxMacDataBrowserTableViewControl::GetPartBounds(DataBrowserItemID, DataBrowswerPropertyID, DataBrowserPropertyPart, Rect*) */
 243
 244 OSStatus wxMacDataBrowserTableViewControl::GetRowHeight(DataBrowserItemID item, UInt16* height) const
 245 {
 246   return ::GetDataBrowserTableViewItemRowHeight(this->m_controlRef,item,height);
 247 } /* wxMacDataBrowserTableViewControl::GetRowHeight(DataBrowserItemID, UInt16*) const */
 248
 249 OSStatus wxMacDataBrowserTableViewControl::GetScrollPosition( UInt32 *top , UInt32 *left ) const
 250 {
 251     return GetDataBrowserScrollPosition(this->m_controlRef, top , left );
 252 }
 253
 254 #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
 255 OSStatus wxMacDataBrowserTableViewControl::SetAttributes(OptionBits attributes)
 256 {
 257   return ::DataBrowserChangeAttributes(this->GetControlRef(),attributes,~attributes);
 258 } /* wxMacDataBrowserTableViewControl::SetAttributes(OptionBits) */
 259 #endif
 260
 261 OSStatus wxMacDataBrowserTableViewControl::SetColumnWidth(DataBrowserPropertyID propertyID, UInt16 width)
 262 {
 263   return ::SetDataBrowserTableViewNamedColumnWidth(this->m_controlRef,propertyID,width);
 264 }
 265
 266 OSStatus wxMacDataBrowserTableViewControl::SetDefaultColumnWidth(UInt16 width)
 267 {
 268   return ::SetDataBrowserTableViewColumnWidth(this->m_controlRef,width);
 269 }
 270
 271 OSStatus wxMacDataBrowserTableViewControl::SetDefaultRowHeight(UInt16 height)
 272 {
 273   return ::SetDataBrowserTableViewRowHeight(this->m_controlRef,height);
 274 }
 275
 276 OSStatus wxMacDataBrowserTableViewControl::SetHasScrollBars( bool horiz, bool vert )
 277 {
 278     return SetDataBrowserHasScrollBars(this->m_controlRef, horiz, vert );
 279 }
 280
 281 OSStatus wxMacDataBrowserTableViewControl::SetHeaderButtonHeight(UInt16 height)
 282 {
 283     return SetDataBrowserListViewHeaderBtnHeight(this->m_controlRef, height );
 284 }
 285
 286 OSStatus wxMacDataBrowserTableViewControl::SetHiliteStyle( DataBrowserTableViewHiliteStyle hiliteStyle )
 287 {
 288     return SetDataBrowserTableViewHiliteStyle(this->m_controlRef, hiliteStyle );
 289 }
 290
 291 OSStatus wxMacDataBrowserTableViewControl::SetRowHeight(DataBrowserItemID item, UInt16 height)
 292 {
 293   return ::SetDataBrowserTableViewItemRowHeight(this->m_controlRef,item,height);
 294 }
 295
 296 OSStatus wxMacDataBrowserTableViewControl::SetScrollPosition(UInt32 top, UInt32 left)
 297 {
 298   return ::SetDataBrowserScrollPosition(this->m_controlRef,top,left);
 299 }
 300
 301 //
 302 // column handling
 303 //
 304 OSStatus wxMacDataBrowserTableViewControl::GetColumnCount(UInt32* numColumns) const
 305 {
 306   return ::GetDataBrowserTableViewColumnCount(this->m_controlRef,numColumns);
 307 }
 308
 309 OSStatus wxMacDataBrowserTableViewControl::GetColumnIndex(DataBrowserPropertyID propertyID, DataBrowserTableViewColumnIndex* index) const
 310 {
 311   return ::GetDataBrowserTableViewColumnPosition(this->m_controlRef,propertyID,index);
 312 } /* wxMacDataBrowserTableViewControl::GetColumnIndex(DataBrowserPropertyID, DataBrowserTableViewColumnIndex*) const */
 313
 314 OSStatus wxMacDataBrowserTableViewControl::GetFreePropertyID(DataBrowserPropertyID* propertyID) const
 315 {
 316   for (*propertyID=kMinPropertyID; *propertyID<std::numeric_limits<DataBrowserPropertyID>::max(); ++(*propertyID))
 317     if (this->IsUsedPropertyID(*propertyID) == errDataBrowserPropertyNotFound)
 318       return noErr;
 319   return errDataBrowserPropertyNotSupported;
 320 } /* wxMacDataBrowserTableViewControl::GetFreePropertyID(DataBrowserPropertyID*) const */
 321
 322 OSStatus wxMacDataBrowserTableViewControl::GetPropertyFlags(DataBrowserPropertyID propertyID, DataBrowserPropertyFlags *flags) const
 323 {
 324   return ::GetDataBrowserPropertyFlags(this->m_controlRef,propertyID,flags);
 325 }
 326
 327 OSStatus wxMacDataBrowserTableViewControl::GetPropertyID(DataBrowserItemDataRef itemData, DataBrowserPropertyID* propertyID)
 328 {
 329   return ::GetDataBrowserItemDataProperty(itemData,propertyID);
 330 } /* wxMacDataBrowserTableViewControl::GetPropertyID(DataBrowserItemDataRef, DataBrowserPropertyID*) */
 331
 332 OSStatus wxMacDataBrowserTableViewControl::GetPropertyID(DataBrowserTableViewColumnIndex index, DataBrowserTableViewColumnID* propertyID)
 333 {
 334   return ::GetDataBrowserTableViewColumnProperty(this->m_controlRef,index,propertyID);
 335 } /* wxMacDataBrowserTableViewControl::GetPropertyID(DataBrowserTableViewColumnIndex, DataBrowserTableViewColumnID*) */
 336
 337 OSStatus wxMacDataBrowserTableViewControl::IsUsedPropertyID(DataBrowserPropertyID propertyID) const
 338 {
 339  // 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
 340  // 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
 341  // the column position for the property id:
 342   DataBrowserTableViewColumnIndex index;
 343
 344   return ::GetDataBrowserTableViewColumnPosition(this->m_controlRef,propertyID,&index);
 345 } /* wxMacDataBrowserTableViewControl::IsUsedPropertyId(DataBrowserPropertyID) const */
 346
 347 OSStatus wxMacDataBrowserTableViewControl::RemoveColumn(DataBrowserTableViewColumnIndex index)
 348 {
 349   DataBrowserTableViewColumnID propertyID;
 350
 351
 352   this->GetPropertyID(index,&propertyID);
 353   return ::RemoveDataBrowserTableViewColumn(this->m_controlRef,propertyID);
 354 } /* wxMacDataBrowserTableViewControl::RemoveColumn(DataBrowserTableViewColumnIndex) */
 355
 356 OSStatus wxMacDataBrowserTableViewControl::SetColumnIndex(DataBrowserPropertyID propertyID, DataBrowserTableViewColumnIndex index)
 357 {
 358   return ::SetDataBrowserTableViewColumnPosition(this->m_controlRef,propertyID,index);
 359 } /* wxMacDataBrowserTableViewControl::SetColumnIndex(DataBrowserPropertyID, DataBrowserTableViewColumnIndex) */
 360
 361 OSStatus wxMacDataBrowserTableViewControl::SetDisclosureColumn(DataBrowserPropertyID propertyID, Boolean expandableRows)
 362 {
 363   return ::SetDataBrowserListViewDisclosureColumn(this->m_controlRef,propertyID,expandableRows);
 364 }
 365
 366 OSStatus wxMacDataBrowserTableViewControl::SetPropertyFlags(DataBrowserPropertyID propertyID, DataBrowserPropertyFlags flags)
 367 {
 368   return ::SetDataBrowserPropertyFlags(this->m_controlRef,propertyID,flags);
 369 } /* wxMacDataBrowserTableViewControl::SetPropertyFlags(DataBrowserPropertyID, DataBrowserPropertyFlags) */
 370
 371 //
 372 // item handling
 373 //
 374 OSStatus wxMacDataBrowserTableViewControl::AddItems(DataBrowserItemID container, UInt32 numItems, DataBrowserItemID const* items, DataBrowserPropertyID preSortProperty)
 375 {
 376   return ::AddDataBrowserItems(this->m_controlRef,container,numItems,items,preSortProperty);
 377 } /* wxMacDataBrowserTableViewControl::AddItems(DataBrowserItemID, UInt32, DataBrowserItemID const*, DataBrowserPropertyID) */
 378
 379 OSStatus wxMacDataBrowserTableViewControl::GetFreeItemID(DataBrowserItemID* id) const
 380 {
 381   ItemCount NoOfItems;
 382
 383
 384   verify_noerr(this->GetItemCount(&NoOfItems));
 385   if (NoOfItems == 0)
 386   {
 387     *id = 1;
 388     return noErr;
 389   } /* if */
 390   else
 391   {
 392    // 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
 393    // as the number of items; therefore, start from the number of items to look for a new ID:
 394     for (*id=NoOfItems; *id<std::numeric_limits<DataBrowserItemID>::max(); ++(*id))
 395       if (this->IsUsedItemID(*id) == errDataBrowserItemNotFound)
 396         return noErr;
 397    // as the first approach was not successful, try from the beginning:
 398     for (*id=0; *id<NoOfItems; ++(*id))
 399       if (this->IsUsedItemID(*id) == errDataBrowserItemNotFound)
 400         return noErr;
 401    // sorry, data browser is full:
 402     return errDataBrowserItemNotAdded;
 403   } /* if */
 404 } /* wxMacDataBrowserTableViewControl::GetFreeItemID(DataBrowserItemID*) const */
 405
 406 OSStatus wxMacDataBrowserTableViewControl::GetItemCount(DataBrowserItemID container, Boolean recurse, DataBrowserItemState state, ItemCount* numItems) const
 407 {
 408   return GetDataBrowserItemCount(this->m_controlRef,container,recurse,state,numItems);
 409 } /* wxMacDataBrowserTableViewControl::GetItemCount(DataBrowserItemID, Boolean, DataBrowserItemState, ItemCount*) const */
 410
 411 OSStatus wxMacDataBrowserTableViewControl::GetItemID( DataBrowserTableViewRowIndex row, DataBrowserItemID * item ) const
 412 {
 413   return GetDataBrowserTableViewItemID(this->m_controlRef,row,item);
 414 }
 415
 416 OSStatus wxMacDataBrowserTableViewControl::GetItems(DataBrowserItemID container, Boolean recurse, DataBrowserItemState state, Handle items) const
 417 {
 418   return GetDataBrowserItems(this->m_controlRef,container,recurse,state,items);
 419 } /* wxMacDataBrowserTableViewControl::GetItems(DataBrowserItemID, Boolean, DataBrowserItemState, Handle) const */
 420
 421 OSStatus wxMacDataBrowserTableViewControl::GetItemRow(DataBrowserItemID item, DataBrowserTableViewRowIndex* row) const
 422 {
 423   return GetDataBrowserTableViewItemRow(this->m_controlRef,item,row);
 424 }
 425
 426 OSStatus wxMacDataBrowserTableViewControl::IsUsedItemID(DataBrowserItemID itemID) const
 427 {
 428  // 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
 429  // 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
 430  // the column position for the property id:
 431   DataBrowserTableViewColumnIndex index;
 432
 433   return ::GetDataBrowserTableViewItemRow(this->m_controlRef,itemID,&index);
 434 } /* wxMacDataBrowserTableViewControl::IsUsedItemID(DataBrowserItemID) const */
 435
 436 OSStatus wxMacDataBrowserTableViewControl::RemoveItems(DataBrowserItemID container, UInt32 numItems, DataBrowserItemID const* items, DataBrowserPropertyID preSortProperty)
 437 {
 438   return ::RemoveDataBrowserItems(this->m_controlRef,container,numItems,items,preSortProperty);
 439 }
 440
 441 OSStatus wxMacDataBrowserTableViewControl::RevealItem(DataBrowserItemID item, DataBrowserPropertyID propertyID, DataBrowserRevealOptions options) const
 442 {
 443   return ::RevealDataBrowserItem(this->m_controlRef,item,propertyID,options);
 444 } /* wxMacDataBrowserTableViewControl::RevealItem(DataBrowserItemID item, DataBrowserPropertyID propertyID, DataBrowserRevealOptions options) const */
 445
 446 OSStatus wxMacDataBrowserTableViewControl::UpdateItems(DataBrowserItemID container, UInt32 numItems, DataBrowserItemID const* items, DataBrowserPropertyID preSortProperty,
 447                                                        DataBrowserPropertyID propertyID) const
 448 {
 449   return UpdateDataBrowserItems(this->m_controlRef,container,numItems,items,preSortProperty,propertyID);
 450 }
 451
 452 //
 453 // item selection
 454 //
 455 size_t wxMacDataBrowserTableViewControl::GetSelectedItemIDs(wxArrayDataBrowserItemID& itemIDs) const
 456 {
 457   DataBrowserItemID* itemIDPtr;
 458   Handle handle(::NewHandle(0));
 459
 460   size_t NoOfItems;
 461
 462
 463   wxCHECK_MSG(this->GetItems(kDataBrowserNoItem,true,kDataBrowserItemIsSelected,handle) == noErr,0,_("Could not get selected items."));
 464   NoOfItems = static_cast<size_t>(::GetHandleSize(handle)/sizeof(DataBrowserItemID));
 465   itemIDs.Empty();
 466   itemIDs.Alloc(NoOfItems);
 467   HLock(handle);
 468   itemIDPtr = (DataBrowserItemID*) (*handle);
 469   for (size_t i=0; i<NoOfItems; ++i)
 470   {
 471     itemIDs.Add(*itemIDPtr);
 472     ++itemIDPtr;
 473   } /* for */
 474   HUnlock(handle);
 475   DisposeHandle(handle);
 476   return NoOfItems;
 477 } /* wxMacDataBrowserTableViewControl::GetSelectedItemIDs(wxArrayDataBrowserItemID&) const*/
 478
 479 OSStatus wxMacDataBrowserTableViewControl::GetSelectionAnchor(DataBrowserItemID* first, DataBrowserItemID* last) const
 480 {
 481   return ::GetDataBrowserSelectionAnchor(this->m_controlRef,first,last);
 482 } /* wxMacDataBrowserTableViewControl::GetSelectionAnchor(DataBrowserItemID*, DataBrowserItemID*) const */
 483
 484 OSStatus wxMacDataBrowserTableViewControl::GetSelectionFlags(DataBrowserSelectionFlags* flags) const
 485 {
 486   return ::GetDataBrowserSelectionFlags(this->m_controlRef,flags);
 487 } /* wxMacDataBrowserTableViewControl::GetSelectionFlags(DataBrowserSelectionFlags*) const */
 488
 489 bool wxMacDataBrowserTableViewControl::IsItemSelected(DataBrowserItemID item) const
 490 {
 491   return ::IsDataBrowserItemSelected(this->m_controlRef,item);
 492 } /* wxMacDataBrowserTableViewControl::IsItemSelected(DataBrowserItemID) const */
 493
 494 OSStatus wxMacDataBrowserTableViewControl::SetSelectionFlags(DataBrowserSelectionFlags flags)
 495 {
 496   return ::SetDataBrowserSelectionFlags(this->m_controlRef,flags);
 497 } /* wxMacDataBrowserTableViewControl::SetSelectionFlags(DataBrowserSelectionFlags) */
 498
 499 OSStatus wxMacDataBrowserTableViewControl::SetSelectedItems(UInt32 numItems, DataBrowserItemID const* items, DataBrowserSetOption operation)
 500 {
 501   return ::SetDataBrowserSelectedItems(this->m_controlRef, numItems, items, operation );
 502 } /* wxMacDataBrowserTableViewControl::SetSelectedItems(UInt32, DataBrowserItemID const*, DataBrowserSetOption) */
 503
 504 OSStatus wxMacDataBrowserTableViewControl::GetSortOrder(DataBrowserSortOrder* order) const
 505 {
 506   return ::GetDataBrowserSortOrder(this->m_controlRef,order);
 507 }
 508
 509 OSStatus wxMacDataBrowserTableViewControl::GetSortProperty(DataBrowserPropertyID* propertyID) const
 510 {
 511   return ::GetDataBrowserSortProperty(this->m_controlRef,propertyID);
 512 }
 513
 514 OSStatus wxMacDataBrowserTableViewControl::Resort(DataBrowserItemID container, Boolean sortChildren)
 515 {
 516   return ::SortDataBrowserContainer(this->m_controlRef,container,sortChildren);
 517 } /* wxMacDataBrowserTableViewControl::Resort(DataBrowserItemID, Boolean) */
 518
 519 OSStatus wxMacDataBrowserTableViewControl::SetSortOrder(DataBrowserSortOrder order)
 520 {
 521   return ::SetDataBrowserSortOrder(this->m_controlRef,order);
 522 }
 523
 524 OSStatus wxMacDataBrowserTableViewControl::SetSortProperty(DataBrowserPropertyID propertyID)
 525 {
 526   return ::SetDataBrowserSortProperty(this->m_controlRef,propertyID);
 527 }
 528
 529 IMPLEMENT_ABSTRACT_CLASS(wxMacDataBrowserTableViewControl,wxMacControl)
 530
 531 // ============================================================================
 532 // wxMacDataBrowserListViewControl
 533 // ============================================================================
 534 #pragma mark -
 535 //
 536 // column handling
 537 //
 538 OSStatus wxMacDataBrowserListViewControl::AddColumn(DataBrowserListViewColumnDesc *columnDesc, DataBrowserTableViewColumnIndex position)
 539 {
 540   return AddDataBrowserListViewColumn(this->m_controlRef,columnDesc,position);
 541 } /* wxMacDataBrowserListViewControl::AddColumn(DataBrowserListViewColumnDesc*, DataBrowserTableViewColumnIndex) */
 542
 543 // ============================================================================
 544 // wxMacDataViewDataBrowserListViewControl
 545 // ============================================================================
 546 #pragma mark -
 547 //
 548 // constructors / destructor
 549 //
 550 wxMacDataViewDataBrowserListViewControl::wxMacDataViewDataBrowserListViewControl(wxWindow* peer, wxPoint const& pos, wxSize const& size, long style)
 551                                         :wxMacDataBrowserListViewControl(peer,pos,size,style)
 552 {
 553 } /* wxMacDataViewDataBrowserListViewControl::wxMacDataViewDataBrowserListViewControl(wxWindow* , const wxPoint&, const wxSize&, long) */
 554
 555 //
 556 // callback functions (inherited from wxMacDataBrowserTableViewControl)
 557 //
 558 Boolean wxMacDataViewDataBrowserListViewControl::DataBrowserCompareProc(DataBrowserItemID itemOneID, DataBrowserItemID itemTwoID, DataBrowserPropertyID sortProperty)
 559 {
 560   DataBrowserSortOrder sortOrder;
 561
 562   DataBrowserTableViewColumnIndex columnIndex;
 563
 564   wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 565
 566
 567   wxCHECK_MSG(dataViewCtrlPtr != NULL,            false,_("Pointer to data view control not set correctly."));
 568   wxCHECK_MSG(dataViewCtrlPtr->GetModel() != NULL,false,_("Pointer to model not set correctly."));
 569   if (sortProperty >= kMinPropertyID)
 570   {
 571     wxCHECK_MSG(this->GetColumnIndex(sortProperty,&columnIndex) == noErr,false,_("Could not determine column index."));
 572   } /* if */
 573   else
 574     columnIndex = 0;
 575   this->GetSortOrder(&sortOrder);
 576   return static_cast<Boolean>(dataViewCtrlPtr->GetModel()->Compare(wxDataViewItem(reinterpret_cast<void*>(itemOneID)),wxDataViewItem(reinterpret_cast<void*>(itemTwoID)),
 577                               columnIndex,sortOrder != kDataBrowserOrderDecreasing) < 0);
 578 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserCompareProc(DataBrowserItemID, DataBrowserItemID, DataBrowserPropertyID) */
 579
 580 void wxMacDataViewDataBrowserListViewControl::DataBrowserDrawItemProc(DataBrowserItemID itemID, DataBrowserPropertyID propertyID, DataBrowserItemState state, Rect const* rectangle, SInt16 bitDepth, Boolean colorDevice)
 581 {
 582   DataBrowserTableViewColumnIndex columnIndex;
 583
 584   wxDataViewColumn* dataViewColumnPtr;
 585
 586   wxDataViewCtrl* dataViewCtrlPtr;
 587
 588   wxDataViewCustomRenderer* dataViewCustomRendererPtr;
 589
 590   wxVariant dataToRender;
 591
 592
 593   dataViewCtrlPtr = dynamic_cast<wxDataViewCtrl*>(this->GetPeer());
 594   wxCHECK_RET(dataViewCtrlPtr != NULL,                               _("Pointer to data view control not set correctly."));
 595   wxCHECK_RET(dataViewCtrlPtr->GetModel() != NULL,                   _("Pointer to model not set correctly."));
 596   wxCHECK_RET(this->GetColumnIndex(propertyID,&columnIndex) == noErr,_("Could not determine column index."));
 597   dataViewColumnPtr = dataViewCtrlPtr->GetColumn(columnIndex);
 598   wxCHECK_RET(dataViewColumnPtr != NULL,_("No column for the specified column index existing."));
 599   dataViewCustomRendererPtr = dynamic_cast<wxDataViewCustomRenderer*>(dataViewColumnPtr->GetRenderer());
 600   wxCHECK_RET(dataViewCustomRendererPtr != NULL,_("No renderer or invalid renderer type specified for custom data column."));
 601   dataViewCtrlPtr->GetModel()->GetValue(dataToRender,wxDataViewItem(reinterpret_cast<void*>(itemID)),columnIndex);
 602   dataViewCustomRendererPtr->SetValue(dataToRender);
 603
 604  // try to determine the content's size (drawable part):
 605   Rect      content;
 606   RgnHandle rgn(NewRgn());
 607   UInt16    headerHeight;
 608
 609   if (this->GetRegion(kControlContentMetaPart,rgn) == noErr)
 610     GetRegionBounds(rgn,&content);
 611   else
 612     this->GetRect(&content);
 613   ::DisposeRgn(rgn);
 614  // space for the header
 615   this->GetHeaderButtonHeight(&headerHeight);
 616   content.top += headerHeight;
 617  // extra space for the frame (todo: do not how to determine the space automatically from the control)
 618   content.top    += 5;
 619   content.left   += 5;
 620   content.right  -= 3;
 621   content.bottom -= 3;
 622  // extra space for the scrollbars:
 623   content.bottom -= wxSystemSettings::GetMetric(wxSYS_HSCROLL_Y);
 624   content.right  -= wxSystemSettings::GetMetric(wxSYS_VSCROLL_X);
 625
 626  // make sure that 'Render' can draw only in the allowed area:
 627   dataViewCustomRendererPtr->GetDC()->SetClippingRegion(content.left,content.top,content.right-content.left+1,content.bottom-content.top+1);
 628   (void) (dataViewCustomRendererPtr->Render(wxRect(static_cast<int>(rectangle->left),static_cast<int>(rectangle->top),
 629                                                    static_cast<int>(1+rectangle->right-rectangle->left),static_cast<int>(1+rectangle->bottom-rectangle->top)),
 630                                             dataViewCustomRendererPtr->GetDC(),((state == kDataBrowserItemIsSelected) ? wxDATAVIEW_CELL_SELECTED : 0)));
 631   dataViewCustomRendererPtr->GetDC()->DestroyClippingRegion(); // probably not necessary
 632 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserDrawItemProc(DataBrowserItemID, DataBrowserPropertyID, DataBrowserItemState, Rect const*, SInt16, Boolean) */
 633
 634 OSStatus wxMacDataViewDataBrowserListViewControl::DataBrowserGetSetItemDataProc(DataBrowserItemID itemID, DataBrowserPropertyID propertyID, DataBrowserItemDataRef itemData, Boolean getValue)
 635 {
 636   if (getValue)
 637   {
 638    // variable definitions:
 639     wxDataViewCtrl* dataViewCtrlPtr;
 640
 641     dataViewCtrlPtr = dynamic_cast<wxDataViewCtrl*>(this->GetPeer());
 642     wxCHECK_MSG(dataViewCtrlPtr != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 643     if (dataViewCtrlPtr->IsDeleting())
 644       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
 645     else
 646     {
 647      // variable definitions:
 648       DataBrowserTableViewColumnIndex columnIndex;
 649       OSStatus                        errorStatus;
 650       wxDataViewColumn*               dataViewColumnPtr;
 651
 652       wxCHECK_MSG(dataViewCtrlPtr->GetModel() != NULL,errDataBrowserNotConfigured,_("Pointer to model not set correctly."));
 653       errorStatus = this->GetColumnIndex(propertyID,&columnIndex);
 654       wxCHECK_MSG(errorStatus == noErr,errorStatus,_("Could not determine column index"));
 655       dataViewColumnPtr = dataViewCtrlPtr->GetColumn(columnIndex);
 656       wxCHECK_MSG((dataViewColumnPtr != NULL) && (dataViewColumnPtr->GetRenderer() != NULL),errDataBrowserNotConfigured,_("There is no column or renderer for the specified column index."));
 657       switch (dataViewColumnPtr->GetRenderer()->GetPropertyType())
 658       {
 659         case kDataBrowserCheckboxType:
 660           {
 661            // variable definition:
 662             ThemeButtonValue buttonValue;
 663
 664             errorStatus = ::GetDataBrowserItemDataButtonValue(itemData,&buttonValue);
 665             if (errorStatus == noErr)
 666             {
 667               if (buttonValue == kThemeButtonOn)
 668               {
 669                // variable definition and initialization:
 670                 wxVariant modifiedData(true);
 671
 672                 return (dataViewCtrlPtr->GetModel()->SetValue(modifiedData,wxDataViewItem(reinterpret_cast<void*>(itemID)),static_cast<unsigned int>(columnIndex)) ? OSStatus(noErr) : OSStatus(errDataBrowserNotConfigured));
 673               } /* if */
 674               else if (buttonValue == kThemeButtonOff)
 675               {
 676                // variable definition and initialization:
 677                 wxVariant modifiedData(false);
 678
 679                 return (dataViewCtrlPtr->GetModel()->SetValue(modifiedData,wxDataViewItem(reinterpret_cast<void*>(itemID)),static_cast<unsigned int>(columnIndex)) ? OSStatus(noErr) : OSStatus(errDataBrowserNotConfigured));
 680               } /* if */
 681               else
 682                 return errDataBrowserInvalidPropertyData;
 683             } /* if */
 684             else
 685               return errorStatus;
 686           } /* block */
 687         case kDataBrowserTextType:
 688           {
 689            // variable definitions:
 690             CFStringRef stringReference;
 691
 692             errorStatus = ::GetDataBrowserItemDataText(itemData,&stringReference);
 693             if (errorStatus == noErr)
 694             {
 695              // variable definitions and initializations:
 696               wxMacCFStringHolder modifiedString(stringReference);
 697               wxVariant           modifiedData(modifiedString.AsString());
 698
 699               if (dataViewCtrlPtr->GetModel()->SetValue(modifiedData,wxDataViewItem(reinterpret_cast<void*>(itemID)),static_cast<unsigned int>(columnIndex)))
 700                 return noErr;
 701               else
 702                 return errDataBrowserNotConfigured;
 703             } /* if */
 704             else
 705               return errorStatus;
 706           } /* block */
 707         default:
 708           return errDataBrowserPropertyNotSupported;
 709       } /* switch */
 710     } /* if */
 711   } /* if */
 712   else
 713   {
 714     if (propertyID >= kMinPropertyID) // in case data columns set the data
 715     {
 716      // variable definitions:
 717       DataBrowserTableViewColumnIndex columnIndex;
 718       OSStatus                        errorStatus;
 719       wxVariant                       variant;
 720       wxDataViewColumn*               dataViewColumnPtr;
 721       wxDataViewCtrl*                 dataViewCtrlPtr;
 722
 723       dataViewCtrlPtr = dynamic_cast<wxDataViewCtrl*>(this->GetPeer());
 724       wxCHECK_MSG(dataViewCtrlPtr             != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 725       wxCHECK_MSG(dataViewCtrlPtr->GetModel() != NULL,errDataBrowserNotConfigured,_("Pointer to model not set correctly."));
 726       errorStatus = this->GetColumnIndex(propertyID,&columnIndex);
 727       wxCHECK_MSG(errorStatus == noErr,errorStatus,_("Column index does not exist."));
 728       dataViewColumnPtr = dataViewCtrlPtr->GetColumn(columnIndex);
 729       wxCHECK_MSG(dataViewColumnPtr                != NULL,errDataBrowserNotConfigured,_("No column for the specified column position existing."));
 730       wxCHECK_MSG(dataViewColumnPtr->GetRenderer() != NULL,errDataBrowserNotConfigured,_("No renderer specified for column."));
 731       dataViewCtrlPtr->GetModel()->GetValue(variant,wxDataViewItem(reinterpret_cast<void*>(itemID)),dataViewColumnPtr->GetModelColumn());
 732       dataViewColumnPtr->GetRenderer()->SetDataReference(itemData);
 733       dataViewColumnPtr->GetRenderer()->SetValue(variant);
 734       wxCHECK_MSG(dataViewColumnPtr->GetRenderer()->Render(),errDataBrowserNotConfigured,_("Rendering failed."));
 735       return noErr;
 736     } /* if */
 737     else // react on special system requests
 738       switch (propertyID)
 739       {
 740         case kDataBrowserContainerIsClosableProperty:
 741           {
 742            // variable definitions:
 743             wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 744
 745             wxCHECK_MSG(dataViewCtrlPtr != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 746            // initialize wxWidget event:
 747             wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSING,dataViewCtrlPtr->GetId()); // variable definition
 748
 749             dataViewEvent.SetEventObject(dataViewCtrlPtr);
 750             dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 751            // finally send the equivalent wxWidget event:
 752             dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 753            // opening the container is allowed if not vetoed:
 754             return ::SetDataBrowserItemDataBooleanValue(itemData,dataViewEvent.IsAllowed());
 755           } /* block */
 756           return noErr;
 757         case kDataBrowserContainerIsOpenableProperty:
 758           {
 759            // variable definitions:
 760             wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 761
 762             wxCHECK_MSG(dataViewCtrlPtr != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 763            // initialize wxWidget event:
 764             wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDING,dataViewCtrlPtr->GetId()); // variable definition
 765
 766             dataViewEvent.SetEventObject(dataViewCtrlPtr);
 767             dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 768            // finally send the equivalent wxWidget event:
 769             dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 770            // opening the container is allowed if not vetoed:
 771             return ::SetDataBrowserItemDataBooleanValue(itemData,dataViewEvent.IsAllowed());
 772           } /* block */
 773         case kDataBrowserItemIsContainerProperty:
 774           {
 775            // variable definition:
 776             wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 777
 778             wxCHECK_MSG(dataViewCtrlPtr             != NULL,errDataBrowserNotConfigured,_("Pointer to data view control not set correctly."));
 779             wxCHECK_MSG(dataViewCtrlPtr->GetModel() != NULL,errDataBrowserNotConfigured,_("Pointer to model not set correctly."));
 780             return ::SetDataBrowserItemDataBooleanValue(itemData,dataViewCtrlPtr->GetModel()->IsContainer(wxDataViewItem(reinterpret_cast<void*>(itemID))));
 781           } /* block */
 782         case kDataBrowserItemIsEditableProperty:
 783           return ::SetDataBrowserItemDataBooleanValue(itemData,true);
 784       } /* switch */
 785   } /* if */
 786   return errDataBrowserPropertyNotSupported;
 787 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserGetSetItemDataProc(DataBrowserItemID, DataBrowserPropertyID, DataBrowserItemDataRef, Boolean) */
 788
 789 void wxMacDataViewDataBrowserListViewControl::DataBrowserItemNotificationProc(DataBrowserItemID itemID, DataBrowserItemNotification message, DataBrowserItemDataRef WXUNUSED(itemData))
 790 {
 791   switch (message)
 792   {
 793     case kDataBrowserContainerClosed:
 794       {
 795        // variable definitions:
 796         wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 797
 798         if (dataViewCtrlPtr != NULL) // can become NULL when the window is being deleted (wxWidget has already disposed the data before receiving this event
 799         {
 800          // initialize wxWidget event:
 801           wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSED,dataViewCtrlPtr->GetId()); // variable definition
 802
 803           dataViewEvent.SetEventObject(dataViewCtrlPtr);
 804           dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 805          // finally send the equivalent wxWidget event:
 806           dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 807         } /* if */
 808       } /* block */
 809       break;
 810     case kDataBrowserContainerOpened:
 811       {
 812        // variable definitions:
 813         wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 814
 815         wxCHECK_RET(dataViewCtrlPtr != NULL,_("Pointer to data view control not set correctly."));
 816         dataViewCtrlPtr->AddChildrenLevel(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 817        // initialize wxWidget event:
 818         wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDED,dataViewCtrlPtr->GetId()); // variable definition
 819
 820         dataViewEvent.SetEventObject(dataViewCtrlPtr);
 821         dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 822        // finally send the equivalent wxWidget event:
 823         dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 824       } /* block */
 825       break;
 826     case kDataBrowserItemAdded:
 827       {
 828        // variable definitions:
 829         wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 830
 831         wxCHECK_RET(dataViewCtrlPtr != NULL,_("Pointer to data view control not set correctly."));
 832        // initialize wxWidget event:
 833         wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_MODEL_ITEM_ADDED,dataViewCtrlPtr->GetId()); // variable definition
 834
 835         dataViewEvent.SetEventObject(dataViewCtrlPtr);
 836         dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 837        // finally send the equivalent wxWidget event:
 838         dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 839       } /* block */
 840       break;
 841     case kDataBrowserItemDoubleClicked:
 842       {
 843        // variable definitions:
 844         wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 845
 846         wxCHECK_RET(dataViewCtrlPtr != NULL,_("Pointer to data view control not set correctly."));
 847        // initialize wxWidget event:
 848         wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_ACTIVATED,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 kDataBrowserItemRemoved:
 857       {
 858        // variable definitions:
 859         wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 860
 861         if (dataViewCtrlPtr != NULL) // can become NULL when the window is being deleted (wxWidget has already disposed the data before receiving this event
 862         {
 863          // initialize wxWidget event:
 864           wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_MODEL_ITEM_DELETED,dataViewCtrlPtr->GetId()); // variable definition
 865
 866           dataViewEvent.SetEventObject(dataViewCtrlPtr);
 867           dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 868          // finally send the equivalent wxWidget event:
 869           dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 870         } /* if */
 871       } /* block */
 872       break;
 873     case kDataBrowserItemSelected:
 874       {
 875        // variable definitions:
 876         wxDataViewCtrl* dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 877
 878         wxCHECK_RET(dataViewCtrlPtr != NULL,_("Pointer to data view control not set correctly."));
 879        // initialize wxWidget event:
 880         wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_ITEM_SELECTED,dataViewCtrlPtr->GetId()); // variable definition
 881
 882         dataViewEvent.SetEventObject(dataViewCtrlPtr);
 883         dataViewEvent.SetItem(wxDataViewItem(reinterpret_cast<void*>(itemID)));
 884        // finally send the equivalent wxWidget event:
 885         dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 886       } /* block */
 887       break;
 888     case kDataBrowserUserStateChanged:
 889       {
 890         DataBrowserPropertyID propertyID;
 891
 892         if ((this->GetSortProperty(&propertyID) == noErr) && (propertyID >= kMinPropertyID))
 893         {
 894           DataBrowserSortOrder            sortOrder;
 895           DataBrowserTableViewColumnIndex columnIndex;
 896
 897           if ((this->GetSortOrder(&sortOrder) == noErr) && (this->GetColumnIndex(propertyID,&columnIndex) == noErr))
 898           {
 899            // variable definition and initialization:
 900             wxDataViewColumn* columnPtr;
 901             wxDataViewCtrl*   dataViewCtrlPtr(dynamic_cast<wxDataViewCtrl*>(this->GetPeer()));
 902
 903             wxCHECK_RET(dataViewCtrlPtr != NULL,_("Pointer to data vie wcontrol not set correctly."));
 904             columnPtr = dataViewCtrlPtr->GetColumn(columnIndex);
 905            // check if the sort order has changed:
 906             if (  columnPtr->IsSortOrderAscending()  && (sortOrder == kDataBrowserOrderDecreasing) ||
 907                 !(columnPtr->IsSortOrderAscending()) && (sortOrder == kDataBrowserOrderIncreasing))
 908             {
 909               columnPtr->SetSortOrder(!(columnPtr->IsSortOrderAscending()));
 910              // initialize wxWidget event:
 911               wxDataViewEvent dataViewEvent(wxEVT_COMMAND_DATAVIEW_COLUMN_SORTED,dataViewCtrlPtr->GetId()); // variable defintion
 912
 913               dataViewEvent.SetEventObject(dataViewCtrlPtr);
 914               dataViewEvent.SetColumn(columnIndex);
 915               dataViewEvent.SetDataViewColumn(columnPtr);
 916              // finally send the equivalent wxWidget event:
 917               dataViewCtrlPtr->GetEventHandler()->ProcessEvent(dataViewEvent);
 918             } /* if */
 919           } /* if */
 920         } /* if */
 921       } /* block */
 922       break;
 923   } /* switch */
 924 } /* wxMacDataViewDataBrowserListViewControl::DataBrowserItemNotificationProc(DataBrowserItemID, DataBrowserItemNotification, DataBrowserItemDataRef) */
 925
 926
 927 #endif
 928  // wxUSE_GENERICDATAVIEWCTRL