/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
 *
 * The contents of this file are subject to the Netscape Public License
 * Version 1.0 (the "NPL"); you may not use this file except in
 * compliance with the NPL.  You may obtain a copy of the NPL at
 * http://www.mozilla.org/NPL/
 *
 * Software distributed under the NPL is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
 * for the specific language governing rights and limitations under the
 * NPL.
 *
 * The Initial Developer of this code under the NPL is Netscape
 * Communications Corporation.  Portions created by Netscape are
 * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
 * Reserved.
 */

#include "nsISupports.idl"

interface nsIObserver;

/*------------------------- nsIStreamTransferOperation -------------------------
| This interface is provided to enable the JavaScript portion of the standard  |
| implementation of nsIStreamTransfer to communicate with the underlying       |
| C++ code that performs the actual network/file I/O.                          |
|                                                                              |
| Thus, it is only of interest to the implementor's of the code in             |
| downloadProgress.xul/downloadProgress.js.                                    |
------------------------------------------------------------------------------*/
[scriptable, uuid(E2200F90-3E23-11d3-806A-00600811A9C3)]
interface nsIStreamTransferOperation : nsISupports {
    readonly attribute string source;
    readonly attribute string target;

    attribute nsIObserver observer;

    void Start();
    void Stop();
};

%{C++
#define NS_DECL_ISTREAMTRANSFEROPERATION     \
    NS_IMETHOD GetSource( char** );          \
    NS_IMETHOD GetTarget( char** );          \
    NS_IMETHOD GetObserver( nsIObserver** ); \
    NS_IMETHOD SetObserver( nsIObserver* );  \
    NS_IMETHOD Start( void );                \
    NS_IMETHOD Stop( void );
%}
