1// Copyright (c) 2009 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#ifndef CHROME_BROWSER_UI_COCOA_URL_DROP_TARGET_H_ 6#define CHROME_BROWSER_UI_COCOA_URL_DROP_TARGET_H_ 7#pragma once 8 9#import <Cocoa/Cocoa.h> 10 11@protocol URLDropTarget; 12@protocol URLDropTargetController; 13 14// Object which coordinates the dropping of URLs on a given view, sending data 15// and updates to a controller. 16@interface URLDropTargetHandler : NSObject { 17 @private 18 NSView<URLDropTarget>* view_; // weak 19} 20 21// Returns an array of drag types that can be handled. 22+ (NSArray*)handledDragTypes; 23 24// Initialize the given view, which must implement the |URLDropTarget| (below), 25// to accept drops of URLs. 26- (id)initWithView:(NSView<URLDropTarget>*)view; 27 28// The owner view should implement the following methods by calling the 29// |URLDropTargetHandler|'s version, and leave the others to the default 30// implementation provided by |NSView|/|NSWindow|. 31- (NSDragOperation)draggingEntered:(id<NSDraggingInfo>)sender; 32- (NSDragOperation)draggingUpdated:(id<NSDraggingInfo>)sender; 33- (void)draggingExited:(id<NSDraggingInfo>)sender; 34- (BOOL)performDragOperation:(id<NSDraggingInfo>)sender; 35 36@end // @interface URLDropTargetHandler 37 38// Protocol which views that are URL drop targets and use |URLDropTargetHandler| 39// must implement. 40@protocol URLDropTarget 41 42// Returns the controller which handles the drop. 43- (id<URLDropTargetController>)urlDropController; 44 45// The following, which come from |NSDraggingDestination|, must be implemented 46// by calling the |URLDropTargetHandler|'s implementations. 47- (NSDragOperation)draggingEntered:(id<NSDraggingInfo>)sender; 48- (NSDragOperation)draggingUpdated:(id<NSDraggingInfo>)sender; 49- (void)draggingExited:(id<NSDraggingInfo>)sender; 50- (BOOL)performDragOperation:(id<NSDraggingInfo>)sender; 51 52@end // @protocol URLDropTarget 53 54// Protocol for the controller which handles the actual drop data/drop updates. 55@protocol URLDropTargetController 56 57// The given URLs (an |NSArray| of |NSString|s) were dropped in the given view 58// at the given point (in that view's coordinates). 59- (void)dropURLs:(NSArray*)urls inView:(NSView*)view at:(NSPoint)point; 60 61// The given text was dropped in the given view at the given point (in that 62// view's coordinates). 63- (void)dropText:(NSString*)text inView:(NSView*)view at:(NSPoint)point; 64 65// Dragging is in progress over the owner view (at the given point, in view 66// coordinates) and any indicator of location -- e.g., an arrow -- should be 67// updated/shown. 68- (void)indicateDropURLsInView:(NSView*)view at:(NSPoint)point; 69 70// Dragging is over, and any indicator should be hidden. 71- (void)hideDropURLsIndicatorInView:(NSView*)view; 72 73@end // @protocol URLDropTargetController 74 75#endif // CHROME_BROWSER_UI_COCOA_URL_DROP_TARGET_H_ 76