Cursor support including custom cursors

webkit/glue/webcursor.h

 // Copyright (c) 2006-2008 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef WEBKIT_GLUE_WEBCURSOR_H_
 #define WEBKIT_GLUE_WEBCURSOR_H_
 
 #include "base/gfx/point.h"
 #include "base/gfx/size.h"
 
 #include <vector>
 
 #if defined(OS_WIN)
 typedef struct HINSTANCE__* HINSTANCE;
 typedef struct HICON__* HICON;
 typedef HICON HCURSOR;
 #elif defined(OS_LINUX)
 // GdkCursorType is an enum, which we can't forward-declare.  :(
 #include <gdk/gdkcursor.h>
+#elif defined(OS_MACOSX)
+#ifdef __OBJC__
+@class NSCursor;
+#else
+class NSCursor;
+#endif
 #endif
 
 class Pickle;
 
 namespace WebCore {
 class Image;
 class PlatformCursor;
 }
 
 // This class encapsulates a cross-platform description of a cursor.  Platform
@@ skipping 32 matching lines @@
   // Initialize this from the given Windows cursor.
   void InitFromCursor(HCURSOR handle);
 #elif defined(OS_LINUX)
   // Return the stock GdkCursorType for this cursor, or GDK_CURSOR_IS_PIXMAP
   // if it's a custom cursor.
   GdkCursorType GetCursorType() const;
 
   // Return a new GdkCursor* for this cursor.  Only valid if GetCursorType
   // returns GDK_CURSOR_IS_PIXMAP.
   GdkCursor* GetCustomCursor() const;
+#elif defined(OS_MACOSX)
+  NSCursor* GetCursor() const;

[darin (slow to review), 2008/11/18 18:16:27]

Might be good to document the ownership model here.  Is this a NSCursor object
that the caller is responsible for destroying?

[pink (ping after 24hrs), 2008/11/18 18:28:12]

The usual nomenclature for Foundation/ObjC is that "getters" return an
autoreleased object, where as "create" return an object you're responsible for
releasing yourself. We can document it, but it's in line with expectations from
anyone using the code who knows the language. 

 #endif
 
  private:
   void SetCustomData(WebCore::Image* image);
 
   // WebCore::PlatformCursor type.
   int type_;
 
   gfx::Point hotspot_;
 
   // Custom cursor data, as 32-bit RGBA.
   // Platform-inspecific because it can be serialized.
   gfx::Size custom_size_;
   std::vector<char> custom_data_;
 };
 
 #endif  // WEBKIT_GLUE_WEBCURSOR_H_