1 /* 2 Copyright (C) 1998 Lars Knoll (knoll (at) mpi-hd.mpg.de) 3 Copyright (C) 2001 Dirk Mueller <mueller (at) kde.org> 4 Copyright (C) 2004, 2005, 2006, 2007, 2008 Apple Inc. All rights reserved. 5 6 This library is free software; you can redistribute it and/or 7 modify it under the terms of the GNU Library General Public 8 License as published by the Free Software Foundation; either 9 version 2 of the License, or (at your option) any later version. 10 11 This library is distributed in the hope that it will be useful, 12 but WITHOUT ANY WARRANTY; without even the implied warranty of 13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 14 Library General Public License for more details. 15 16 You should have received a copy of the GNU Library General Public License 17 along with this library; see the file COPYING.LIB. If not, write to 18 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 19 Boston, MA 02110-1301, USA. 20 21 This class provides all functionality needed for loading images, style sheets and html 22 pages from the web. It has a memory cache for these objects. 23 */ 24 25 #ifndef CachedResourceClient_h 26 #define CachedResourceClient_h 27 28 #include <wtf/FastAllocBase.h> 29 30 #if ENABLE(XBL) 31 namespace XBL { 32 class XBLDocument; 33 } 34 #endif 35 36 namespace WebCore { 37 38 class CachedCSSStyleSheet; 39 class CachedFont; 40 class CachedResource; 41 class CachedImage; 42 class String; 43 class Image; 44 class IntRect; 45 class KURL; 46 47 /** 48 * @internal 49 * 50 * a client who wants to load stylesheets, images or scripts from the web has to 51 * inherit from this class and overload one of the 3 functions 52 * 53 */ 54 class CachedResourceClient : public FastAllocBase 55 { 56 public: 57 virtual ~CachedResourceClient() { } 58 59 // Called whenever a frame of an image changes, either because we got more data from the network or 60 // because we are animating. If not null, the IntRect is the changed rect of the image. 61 virtual void imageChanged(CachedImage*, const IntRect* = 0) { }; 62 63 // Called to find out if this client wants to actually display the image. Used to tell when we 64 // can halt animation. Content nodes that hold image refs for example would not render the image, 65 // but RenderImages would (assuming they have visibility: visible and their render tree isn't hidden 66 // e.g., in the b/f cache or in a background tab). 67 virtual bool willRenderImage(CachedImage*) { return false; } 68 69 virtual void setCSSStyleSheet(const String& /* href */, const KURL& /* baseURL */, const String& /* charset */, const CachedCSSStyleSheet*) { } 70 virtual void setXSLStyleSheet(const String& /* href */, const KURL& /* baseURL */, const String& /* sheet */) { } 71 72 virtual void fontLoaded(CachedFont*) {}; 73 74 #if ENABLE(XBL) 75 virtual void setXBLDocument(const String& /*URL*/, XBL::XBLDocument*) { } 76 #endif 77 78 virtual void notifyFinished(CachedResource*) { } 79 }; 80 81 } 82 83 #endif 84