base/mac/sdk_forward_declarations.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // This file contains forward declarations for items in later SDKs than the
   6 // default one with which Chromium is built (currently 10.6).
   7 // If you call any function from this header, be sure to check at runtime for
   8 // respondsToSelector: before calling these functions (else your code will crash
   9 // on older OS X versions that chrome still supports).
  10
  11 #ifndef BASE_MAC_SDK_FORWARD_DECLARATIONS_H_
  12 #define BASE_MAC_SDK_FORWARD_DECLARATIONS_H_
  13
  14 #import <AppKit/AppKit.h>
  15 #import <CoreWLAN/CoreWLAN.h>
  16 #import <ImageCaptureCore/ImageCaptureCore.h>
  17 #import <IOBluetooth/IOBluetooth.h>
  18
  19 #include "base/base_export.h"
  20
  21 #if !defined(MAC_OS_X_VERSION_10_7) || \
  22     MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_7
  23
  24 enum {
  25   NSEventPhaseNone        = 0, // event not associated with a phase.
  26   NSEventPhaseBegan       = 0x1 << 0,
  27   NSEventPhaseStationary  = 0x1 << 1,
  28   NSEventPhaseChanged     = 0x1 << 2,
  29   NSEventPhaseEnded       = 0x1 << 3,
  30   NSEventPhaseCancelled   = 0x1 << 4
  31 };
  32 typedef NSUInteger NSEventPhase;
  33
  34 enum {
  35   NSFullScreenWindowMask = 1 << 14,
  36 };
  37
  38 enum {
  39   NSApplicationPresentationFullScreen = 1 << 10,
  40 };
  41
  42 enum {
  43   NSWindowCollectionBehaviorFullScreenPrimary = 1 << 7,
  44   NSWindowCollectionBehaviorFullScreenAuxiliary = 1 << 8,
  45 };
  46
  47 enum {
  48   NSEventSwipeTrackingLockDirection = 0x1 << 0,
  49   NSEventSwipeTrackingClampGestureAmount = 0x1 << 1,
  50 };
  51 typedef NSUInteger NSEventSwipeTrackingOptions;
  52
  53 enum {
  54   NSWindowAnimationBehaviorDefault = 0,
  55   NSWindowAnimationBehaviorNone = 2,
  56   NSWindowAnimationBehaviorDocumentWindow = 3,
  57   NSWindowAnimationBehaviorUtilityWindow = 4,
  58   NSWindowAnimationBehaviorAlertPanel = 5
  59 };
  60 typedef NSInteger NSWindowAnimationBehavior;
  61
  62 enum {
  63   NSWindowDocumentVersionsButton = 6,
  64   NSWindowFullScreenButton,
  65 };
  66 typedef NSUInteger NSWindowButton;
  67
  68 @interface NSEvent (LionSDK)
  69 + (BOOL)isSwipeTrackingFromScrollEventsEnabled;
  70
  71 - (NSEventPhase)momentumPhase;
  72 - (NSEventPhase)phase;
  73 - (BOOL)hasPreciseScrollingDeltas;
  74 - (CGFloat)scrollingDeltaX;
  75 - (CGFloat)scrollingDeltaY;
  76 - (void)trackSwipeEventWithOptions:(NSEventSwipeTrackingOptions)options
  77           dampenAmountThresholdMin:(CGFloat)minDampenThreshold
  78                                max:(CGFloat)maxDampenThreshold
  79                       usingHandler:(void (^)(CGFloat gestureAmount,
  80                                              NSEventPhase phase,
  81                                              BOOL isComplete,
  82                                              BOOL *stop))trackingHandler;
  83
  84 - (BOOL)isDirectionInvertedFromDevice;
  85
  86 @end
  87
  88 @interface NSApplication (LionSDK)
  89 - (void)disableRelaunchOnLogin;
  90 @end
  91
  92 @interface CALayer (LionSDK)
  93 - (CGFloat)contentsScale;
  94 - (void)setContentsScale:(CGFloat)contentsScale;
  95 @end
  96
  97 @interface NSScreen (LionSDK)
  98 - (CGFloat)backingScaleFactor;
  99 - (NSRect)convertRectToBacking:(NSRect)aRect;
 100 @end
 101
 102 @interface NSWindow (LionSDK)
 103 - (CGFloat)backingScaleFactor;
 104 - (NSWindowAnimationBehavior)animationBehavior;
 105 - (void)setAnimationBehavior:(NSWindowAnimationBehavior)newAnimationBehavior;
 106 - (void)toggleFullScreen:(id)sender;
 107 - (void)setRestorable:(BOOL)flag;
 108 - (NSRect)convertRectFromScreen:(NSRect)aRect;
 109 @end
 110
 111 @interface NSCursor (LionSDKDeclarations)
 112 + (NSCursor*)IBeamCursorForVerticalLayout;
 113 @end
 114
 115 @interface NSAnimationContext (LionSDK)
 116 + (void)runAnimationGroup:(void (^)(NSAnimationContext *context))changes
 117         completionHandler:(void (^)(void))completionHandler;
 118 @property(copy) void(^completionHandler)(void);
 119 @end
 120
 121 @interface NSView (LionSDK)
 122 - (NSSize)convertSizeFromBacking:(NSSize)size;
 123 - (void)setWantsBestResolutionOpenGLSurface:(BOOL)flag;
 124 @end
 125
 126 @interface NSObject (ICCameraDeviceDelegateLionSDK)
 127 - (void)deviceDidBecomeReadyWithCompleteContentCatalog:(ICDevice*)device;
 128 - (void)didDownloadFile:(ICCameraFile*)file
 129                   error:(NSError*)error
 130                 options:(NSDictionary*)options
 131             contextInfo:(void*)contextInfo;
 132 @end
 133
 134 @interface NSScroller (LionSDK)
 135 + (NSInteger)preferredScrollerStyle;
 136 @end
 137
 138 @interface CWInterface (LionSDK)
 139 - (BOOL)associateToNetwork:(CWNetwork*)network
 140                   password:(NSString*)password
 141                      error:(NSError**)error;
 142 - (NSSet*)scanForNetworksWithName:(NSString*)networkName
 143                             error:(NSError**)error;
 144 @end
 145
 146 enum CWChannelBand {
 147   kCWChannelBandUnknown = 0,
 148   kCWChannelBand2GHz = 1,
 149   kCWChannelBand5GHz = 2,
 150 };
 151
 152 @interface CWChannel : NSObject
 153 @property(readonly) CWChannelBand channelBand;
 154 @end
 155
 156 enum {
 157    kCWSecurityNone = 0,
 158    kCWSecurityWEP = 1,
 159    kCWSecurityWPAPersonal = 2,
 160    kCWSecurityWPAPersonalMixed = 3,
 161    kCWSecurityWPA2Personal = 4,
 162    kCWSecurityPersonal = 5,
 163    kCWSecurityDynamicWEP = 6,
 164    kCWSecurityWPAEnterprise = 7,
 165    kCWSecurityWPAEnterpriseMixed = 8,
 166    kCWSecurityWPA2Enterprise = 9,
 167    kCWSecurityEnterprise = 10,
 168    kCWSecurityUnknown = NSIntegerMax,
 169 };
 170
 171 typedef NSInteger CWSecurity;
 172
 173 @interface CWNetwork (LionSDK)
 174 @property(readonly) CWChannel* wlanChannel;
 175 @property(readonly) NSInteger rssiValue;
 176 - (BOOL)supportsSecurity:(CWSecurity)security;
 177 @end
 178
 179 @interface IOBluetoothHostController (LionSDK)
 180 - (NSString*)nameAsString;
 181 - (BluetoothHCIPowerState)powerState;
 182 @end
 183
 184 enum {
 185   kBluetoothFeatureLESupportedController = (1 << 6L),
 186 };
 187
 188 @protocol IOBluetoothDeviceInquiryDelegate
 189 - (void)deviceInquiryStarted:(IOBluetoothDeviceInquiry*)sender;
 190 - (void)deviceInquiryDeviceFound:(IOBluetoothDeviceInquiry*)sender
 191                           device:(IOBluetoothDevice*)device;
 192 - (void)deviceInquiryComplete:(IOBluetoothDeviceInquiry*)sender
 193                         error:(IOReturn)error
 194                       aborted:(BOOL)aborted;
 195 @end
 196
 197 @interface IOBluetoothL2CAPChannel (LionSDK)
 198 @property(readonly) BluetoothL2CAPMTU outgoingMTU;
 199 @end
 200
 201 @interface IOBluetoothDevice (LionSDK)
 202 - (NSString*)addressString;
 203 - (unsigned int)classOfDevice;
 204 - (BluetoothConnectionHandle)connectionHandle;
 205 - (BluetoothHCIRSSIValue)rawRSSI;
 206 - (NSArray*)services;
 207 - (IOReturn)performSDPQuery:(id)target uuids:(NSArray*)uuids;
 208 @end
 209
 210 BASE_EXPORT extern "C" NSString* const NSWindowWillEnterFullScreenNotification;
 211 BASE_EXPORT extern "C" NSString* const NSWindowWillExitFullScreenNotification;
 212 BASE_EXPORT extern "C" NSString* const NSWindowDidEnterFullScreenNotification;
 213 BASE_EXPORT extern "C" NSString* const NSWindowDidExitFullScreenNotification;
 214 BASE_EXPORT extern "C" NSString* const
 215     NSWindowDidChangeBackingPropertiesNotification;
 216
 217 @protocol NSWindowDelegateFullScreenAdditions
 218 - (void)windowDidFailToEnterFullScreen:(NSWindow*)window;
 219 - (void)windowDidFailToExitFullScreen:(NSWindow*)window;
 220 @end
 221
 222 BASE_EXPORT extern "C" NSString* const CBAdvertisementDataServiceDataKey;
 223
 224 enum {
 225   CBPeripheralStateDisconnected = 0,
 226   CBPeripheralStateConnecting,
 227   CBPeripheralStateConnected,
 228 };
 229 typedef NSInteger CBPeripheralState;
 230
 231 @interface CBPeripheral : NSObject
 232 @property(readonly, nonatomic) CFUUIDRef UUID;
 233 @property(retain, readonly) NSString* name;
 234 @property(readonly) BOOL isConnected;
 235 @end
 236
 237 enum {
 238   CBCentralManagerStateUnknown = 0,
 239   CBCentralManagerStateResetting,
 240   CBCentralManagerStateUnsupported,
 241   CBCentralManagerStateUnauthorized,
 242   CBCentralManagerStatePoweredOff,
 243   CBCentralManagerStatePoweredOn,
 244 };
 245 typedef NSInteger CBCentralManagerState;
 246
 247 @protocol CBCentralManagerDelegate;
 248
 249 @interface CBCentralManager : NSObject
 250 @property(readonly) CBCentralManagerState state;
 251 - (id)initWithDelegate:(id<CBCentralManagerDelegate>)delegate
 252                  queue:(dispatch_queue_t)queue;
 253 - (void)scanForPeripheralsWithServices:(NSArray*)serviceUUIDs
 254                                options:(NSDictionary*)options;
 255 - (void)stopScan;
 256 @end
 257
 258 @protocol CBCentralManagerDelegate<NSObject>
 259 - (void)centralManagerDidUpdateState:(CBCentralManager*)central;
 260 - (void)centralManager:(CBCentralManager*)central
 261     didDiscoverPeripheral:(CBPeripheral*)peripheral
 262         advertisementData:(NSDictionary*)advertisementData
 263                      RSSI:(NSNumber*)RSSI;
 264 @end
 265
 266 @interface CBUUID : NSObject
 267 @property(nonatomic, readonly) NSData* data;
 268 + (CBUUID*)UUIDWithString:(NSString*)theString;
 269 @end
 270
 271 #endif  // MAC_OS_X_VERSION_10_7
 272
 273 #if !defined(MAC_OS_X_VERSION_10_8) || \
 274     MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_8
 275
 276 enum {
 277   NSEventPhaseMayBegin    = 0x1 << 5
 278 };
 279
 280 @interface NSColor (MountainLionSDK)
 281 - (CGColorRef)CGColor;
 282 @end
 283
 284 @interface NSUUID : NSObject
 285 - (NSString*)UUIDString;
 286 @end
 287
 288 #endif  // MAC_OS_X_VERSION_10_8
 289
 290
 291 #if !defined(MAC_OS_X_VERSION_10_9) || \
 292     MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_9
 293
 294 // NSProgress is public API in 10.9, but a version of it exists and is usable
 295 // in 10.8.
 296
 297 @interface NSProgress : NSObject
 298
 299 - (instancetype)initWithParent:(NSProgress*)parentProgressOrNil
 300                       userInfo:(NSDictionary*)userInfoOrNil;
 301 @property (copy) NSString* kind;
 302
 303 @property int64_t totalUnitCount;
 304 @property int64_t completedUnitCount;
 305
 306 @property (getter=isCancellable) BOOL cancellable;
 307 @property (getter=isPausable) BOOL pausable;
 308 @property (readonly, getter=isCancelled) BOOL cancelled;
 309 @property (readonly, getter=isPaused) BOOL paused;
 310 @property (copy) void (^cancellationHandler)(void);
 311 @property (copy) void (^pausingHandler)(void);
 312 - (void)cancel;
 313 - (void)pause;
 314
 315 - (void)setUserInfoObject:(id)objectOrNil forKey:(NSString*)key;
 316 - (NSDictionary*)userInfo;
 317
 318 @property (readonly, getter=isIndeterminate) BOOL indeterminate;
 319 @property (readonly) double fractionCompleted;
 320
 321 - (void)publish;
 322 - (void)unpublish;
 323
 324 @end
 325
 326 @interface NSScreen (MavericksSDK)
 327 + (BOOL)screensHaveSeparateSpaces;
 328 @end
 329
 330 // NSAppearance is a new class in the 10.9 SDK. New classes cannot be
 331 // forward-declared because they also require an @implementation, which would
 332 // produce conflicting linkage. Instead, just declare the necessary pieces of
 333 // the interface as a protocol, and treat objects of this type as id.
 334 @protocol CrNSAppearance<NSObject>
 335 + (id<NSObject>)appearanceNamed:(NSString*)name;
 336 @end
 337
 338 @interface NSView (MavericksSDK)
 339 - (void)setCanDrawSubviewsIntoLayer:(BOOL)flag;
 340 - (id<CrNSAppearance>)effectiveAppearance;
 341 @end
 342
 343 enum {
 344   NSWindowOcclusionStateVisible = 1UL << 1,
 345 };
 346 typedef NSUInteger NSWindowOcclusionState;
 347
 348 @interface NSWindow (MavericksSDK)
 349 - (NSWindowOcclusionState)occlusionState;
 350 @end
 351
 352
 353 BASE_EXPORT extern "C" NSString* const
 354     NSWindowDidChangeOcclusionStateNotification;
 355
 356 enum {
 357   NSWorkspaceLaunchWithErrorPresentation = 0x00000040
 358 };
 359
 360 @interface CBPeripheral (MavericksSDK)
 361 @property(readonly, nonatomic) NSUUID* identifier;
 362 @end
 363
 364 BASE_EXPORT extern "C" NSString* const CBAdvertisementDataIsConnectable;
 365
 366 #else  // !MAC_OS_X_VERSION_10_9
 367
 368 typedef enum {
 369    kCWSecurityModeOpen = 0,
 370    kCWSecurityModeWEP,
 371    kCWSecurityModeWPA_PSK,
 372    kCWSecurityModeWPA2_PSK,
 373    kCWSecurityModeWPA_Enterprise,
 374    kCWSecurityModeWPA2_Enterprise,
 375    kCWSecurityModeWPS,
 376    kCWSecurityModeDynamicWEP
 377 } CWSecurityMode;
 378
 379 @interface CWNetwork (SnowLeopardSDK)
 380 @property(readonly) NSNumber* rssi;
 381 @property(readonly) NSNumber* securityMode;
 382 @end
 383
 384 BASE_EXPORT extern "C" NSString* const kCWSSIDDidChangeNotification;
 385
 386 #endif  // MAC_OS_X_VERSION_10_9
 387
 388 #if !defined(MAC_OS_X_VERSION_10_10) || \
 389     MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_10
 390
 391 @interface NSUserActivity : NSObject
 392
 393 @property (readonly, copy) NSString* activityType;
 394 @property (copy) NSDictionary* userInfo;
 395 @property (copy) NSURL* webpageURL;
 396
 397 - (instancetype)initWithActivityType:(NSString*)activityType;
 398 - (void)becomeCurrent;
 399 - (void)invalidate;
 400
 401 @end
 402
 403 BASE_EXPORT extern "C" NSString* const NSUserActivityTypeBrowsingWeb;
 404
 405 BASE_EXPORT extern "C" NSString* const NSAppearanceNameVibrantDark;
 406
 407 @interface CBUUID (YosemiteSDK)
 408 - (NSString*)UUIDString;
 409 @end
 410
 411 #endif  // MAC_OS_X_VERSION_10_10
 412
 413 #endif  // BASE_MAC_SDK_FORWARD_DECLARATIONS_H_