Home | History | Annotate | Download | only in loader 
      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