00001 /* 00002 * ============================================================================== 00003 * Name : BrCtlDownloadObserver.h 00004 * Part of : WebKit \ BrowserControl 00005 * Interface : Browser Control API 00006 * Description : Handle download events 00007 * Version : 3.0 00008 * 00009 * Copyright (c) 2006, Nokia Corporation 00010 * All rights reserved. 00011 * 00012 * Redistribution and use in source and binary forms, with or without 00013 * modification, are permitted provided that the following conditions 00014 * are met: 00015 * 00016 * * Redistributions of source code must retain the above copyright 00017 * notice, this list of conditions and the following disclaimer. 00018 * * Redistributions in binary form must reproduce the above copyright 00019 * notice, this list of conditions and the following disclaimer in 00020 * the documentation and/or other materials provided with the 00021 * distribution. 00022 * * Neither the name of the Nokia Corporation nor the names of its 00023 * contributors may be used to endorse or promote products derived 00024 * from this software without specific prior written permission. 00025 * 00026 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 00027 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 00028 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 00029 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 00030 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00031 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00032 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 00033 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 00034 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 00035 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 00036 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 00037 * DAMAGE. 00038 * 00039 * Please see file patentlicense.txt for further grants. 00040 * ============================================================================== 00041 */ 00042 00043 00044 #ifndef BRCTLDOWNLOADOBSERVER_H 00045 #define BRCTLDOWNLOADOBSERVER_H 00046 00047 // INCLUDES 00048 #include <e32std.h> 00049 #include <e32base.h> 00050 #include <BrCtlDefs.h> 00051 00052 // CONSTANTS 00053 00054 // MACROS 00055 00060 enum TBrCtlDownloadEvent 00061 { 00067 EDownloadEventStarted, 00072 EDownloadEventCompleted, 00077 EDownloadEventProgress, 00081 EDownloadEventCanceled, 00085 EDownloadEventError, 00090 EDownloadEventPaused, 00095 EDownloadEventResumed, 00102 EDownloadEventPausable 00103 }; 00104 00105 // FORWARD DECLARATIONS 00106 class CBrCtlInterface; 00107 00122 class MBrCtlDownloadObserver 00123 { 00124 public: // New functions 00137 virtual TBool NewDownloadL(TUint aTransactionID, 00138 const TDesC& aFileName, 00139 const TDesC& aContentType, 00140 const TDesC& aUrl) = 0; 00141 00156 virtual void ResumeDownloadL(TUint aTransactionID, 00157 TUint aLength, 00158 const TDesC& aFileName, 00159 const TDesC& aContentType, 00160 const TDesC& aUrl) = 0; 00161 00162 00163 00180 virtual void HandleDownloadEventL(TUint aTransactionID, 00181 TBrCtlDownloadEvent aDownloadEvent, 00182 TUint aValue) = 0; 00183 00184 }; 00185 00186 // BRCTLDOWNLOADOBSERVER_H 00187 #endif 00188 00189 // End of File