WebNSPasteboardExtras.h 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. /*
  2. * Copyright (C) 2005, 2006, 2007 Apple 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. #import <Foundation/Foundation.h>
  29. @class DOMElement;
  30. @class WebArchive;
  31. @class WebHTMLView;
  32. #ifdef __cplusplus
  33. extern "C" {
  34. #endif
  35. extern NSString *WebURLPboardType;
  36. extern NSString *WebURLNamePboardType;
  37. @interface NSPasteboard (WebExtras)
  38. // Returns the array of types that _web_writeURL:andTitle: handles.
  39. + (NSArray *)_web_writableTypesForURL;
  40. // Returns the array of types that _web_writeImage handles.
  41. + (NSArray *)_web_writableTypesForImageIncludingArchive:(BOOL)hasArchive;
  42. // Returns the array of drag types that _web_bestURL handles; note that the presence
  43. // of one or more of these drag types on the pasteboard is not a guarantee that
  44. // _web_bestURL will return a non-nil result.
  45. + (NSArray *)_web_dragTypesForURL;
  46. // Finds the best URL from the data on the pasteboard, giving priority to http and https URLs
  47. - (NSURL *)_web_bestURL;
  48. // Writes the URL to the pasteboard with the passed types.
  49. - (void)_web_writeURL:(NSURL *)URL andTitle:(NSString *)title types:(NSArray *)types;
  50. // Sets the text on the NSFindPboard. Returns the new changeCount for the NSFindPboard.
  51. + (int)_web_setFindPasteboardString:(NSString *)string withOwner:(id)owner;
  52. // Writes a file wrapper to the pasteboard as an RTFD attachment.
  53. // NSRTFDPboardType must be declared on the pasteboard before calling this method.
  54. - (void)_web_writeFileWrapperAsRTFDAttachment:(NSFileWrapper *)wrapper;
  55. // Writes an image, URL and other optional types to the pasteboard.
  56. - (void)_web_writeImage:(NSImage *)image
  57. element:(DOMElement*)element
  58. URL:(NSURL *)URL
  59. title:(NSString *)title
  60. archive:(WebArchive *)archive
  61. types:(NSArray *)types
  62. source:(WebHTMLView *)source;
  63. - (id)_web_declareAndWriteDragImageForElement:(DOMElement *)element
  64. URL:(NSURL *)URL
  65. title:(NSString *)title
  66. archive:(WebArchive *)archive
  67. source:(WebHTMLView *)source;
  68. - (void)_web_writePromisedRTFDFromArchive:(WebArchive*)archive containsImage:(BOOL)containsImage;
  69. @end
  70. #ifdef __cplusplus
  71. }
  72. #endif