1 /*

     2  * Copyright (C) 2005, 2006 Apple Computer, Inc.  All rights reserved.

     3  *

     4  * Redistribution and use in source and binary forms, with or without

     5  * modification, are permitted provided that the following conditions

     6  * are met:

     7  *

     8  * 1.  Redistributions of source code must retain the above copyright

     9  *     notice, this list of conditions and the following disclaimer. 

    10  * 2.  Redistributions in binary form must reproduce the above copyright

    11  *     notice, this list of conditions and the following disclaimer in the

    12  *     documentation and/or other materials provided with the distribution. 

    13  * 3.  Neither the name of Apple Computer, Inc. ("Apple") nor the names of

    14  *     its contributors may be used to endorse or promote products derived

    15  *     from this software without specific prior written permission. 

    16  *

    17  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY

    18  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

    19  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

    20  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY

    21  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

    22  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

    23  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

    24  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

    25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF

    26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    27  */

    28 

    29 #import <AppKit/AppKit.h>

    30 

    31 #define WebDragImageAlpha 0.75f

    32 

    33 @class DOMElement;

    34 @class WebFrameView;

    35 @class WebView;

    36 

    37 @interface NSView (WebExtras)

    38 

    39 // Returns the nearest enclosing view of the given class, or nil if none.

    40 - (NSView *)_web_superviewOfClass:(Class)viewClass;

    41 - (WebFrameView *)_web_parentWebFrameView;

    42 - (WebView *)_webView;

    43 

    44 // returns whether a drag should begin starting with mouseDownEvent; if the time

    45 // passes expiration or the mouse moves less than the hysteresis before the mouseUp event,

    46 // returns NO, else returns YES.

    47 - (BOOL)_web_dragShouldBeginFromMouseDown:(NSEvent *)mouseDownEvent

    48                            withExpiration:(NSDate *)expiration

    49                               xHysteresis:(float)xHysteresis

    50                               yHysteresis:(float)yHysteresis;

    51 

    52 // Calls _web_dragShouldBeginFromMouseDown:withExpiration:xHysteresis:yHysteresis: with

    53 // the default values for xHysteresis and yHysteresis

    54 - (BOOL)_web_dragShouldBeginFromMouseDown:(NSEvent *)mouseDownEvent

    55                            withExpiration:(NSDate *)expiration;

    56 

    57 // Convenience method. Returns NSDragOperationCopy if _web_bestURLFromPasteboard doesn't return nil.

    58 // Returns NSDragOperationNone otherwise.

    59 - (NSDragOperation)_web_dragOperationForDraggingInfo:(id <NSDraggingInfo>)sender;

    60 

    61 // Resizes and applies alpha to image and drags it.

    62 - (void)_web_DragImageForElement:(DOMElement *)element

    63                          rect:(NSRect)rect

    64                         event:(NSEvent *)event

    65                    pasteboard:(NSPasteboard *)pasteboard 

    66                        source:(id)source

    67                        offset:(NSPoint *)dragImageOffset;

    68 

    69 - (BOOL)_web_firstResponderIsSelfOrDescendantView;

    70 

    71 - (NSRect)_web_convertRect:(NSRect)aRect toView:(NSView *)aView;

    72 

    73 @end