#include <olectl.h>
#include "exdispid.h"

//
// BUGBUG: headerfiles are screwy!!!
//
// Any changes (renames/additions/deletions) of IIDs, DIID,
// or CLSIDs to this file needs to be reflected in nashsdk\inc\shlguid.w
//

//+-------------------------------------------------------------------------
//
//  Microsoft Windows
//  Copyright 1995 - 1996 Microsoft Corporation. All Rights Reserved.
//
//--------------------------------------------------------------------------

//=--------------------------------------------------------------------------=
// the libid for this type libray
//
[
    uuid(EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B),
    helpstring("Microsoft Internet Controls"), // VB has a maximum limit for this helpstring!
    lcid(0x0000),
    version(1.0)
]
library SHDocVw {

    // standard imports
    //
    importlib(STDOLE_TLB);


    //
    // IWebBrowser
    //


    [
        uuid(EAB22AC1-30C1-11CF-A7EB-0000C05BAE0B),
        helpstring("Web Browser interface"),
        helpcontext(0x0000),
        hidden,
        dual,
        odl
    ]
    interface IWebBrowser : IDispatch {
        //
        // Methods
        //

        [id(100), helpstring("Navigates to the previous item in the history list."), helpcontext(0x0000)]
            HRESULT GoBack();
        [id(101), helpstring("Navigates to the next item in the history list."), helpcontext(0x0000)]
            HRESULT GoForward();
        [id(102), helpstring("Go home/start page."), helpcontext(0x0000)]
            HRESULT GoHome();
        [id(103), helpstring("Go Search Page."), helpcontext(0x0000)]
            HRESULT GoSearch();

        [id(104), helpstring("Navigates to a URL or file."), helpcontext(0x0000)]
            HRESULT Navigate([in] BSTR URL,
                             [in, optional] VARIANT * Flags,
                             [in, optional] VARIANT * TargetFrameName,
                             [in, optional] VARIANT * PostData,
                             [in, optional] VARIANT * Headers);

            // Flags
            typedef
            [
                uuid(14EE5380-A378-11cf-A731-00A0C9082637),
                helpstring("Constants for WebBrowser navigation flags")
            ]
            enum BrowserNavConstants {
                [helpstring("Open in new window")]          navOpenInNewWindow = 0x0001,
                [helpstring("Exclude from history list")]   navNoHistory = 0x0002,
                [helpstring("Don't read from cache")]       navNoReadFromCache = 0x0004,
                [helpstring("Don't write from cache")]      navNoWriteToCache = 0x0008,
            } BrowserNavConstants;

        [id(DISPID_REFRESH), helpstring("Refresh the currently viewed page."), helpcontext(0x0000)]
            HRESULT Refresh();

        // The standard Refresh takes no parameters and we need some... use a new name
        [id(105), helpstring("Refresh the currently viewed page."), helpcontext(0x0000)]
            HRESULT Refresh2([in,optional] VARIANT * Level);

            // Level
            typedef
            [
                uuid(C317C261-A991-11cf-A731-00A0C9082637),
                helpstring("Constants for Refresh")
            ]
            enum RefreshConstants {                                         // must map to these in sdk\inc\docobj.h
                [helpstring("Refresh normal")]     REFRESH_NORMAL     = 0,  //== OLECMDIDF_REFRESH_NORMAL
                [helpstring("Refresh if expired")] REFRESH_IFEXPIRED  = 1,  //== OLECMDIDF_REFRESH_IFEXPIRED
                [helpstring("Refresh completely")] REFRESH_COMPLETELY = 3   //== OLECMDIDF_REFRESH_COMPLETELY
            } RefreshConstants;

        [id(106), helpstring("Stops opening a file."), helpcontext(0x0000)]
            HRESULT Stop();

        //
        // Properties
        //

        // Automation heirarchy...
        [id(200), propget, helpstring("Returns the application automation object if accessible, this automation object otherwise.."), helpcontext(0x0000)]
            HRESULT Application([out,retval] IDispatch** ppDisp);

        [id(201), propget, helpstring("Returns the automation object of the container/parent if one exists or this automation object."), helpcontext(0x0000)]
            HRESULT Parent([out,retval] IDispatch** ppDisp);

        [id(202), propget, helpstring("Returns the container/parent automation object, if any."), helpcontext(0x0000)]
            HRESULT Container([out,retval] IDispatch** ppDisp);

        [id(203), propget, helpstring("Returns the active Document automation object, if any."), helpcontext(0x0000)]
            HRESULT Document([out,retval] IDispatch** ppDisp);

        [id(204), propget, helpstring("Returns True if this is the top level object."), helpcontext(0x0000)]
            HRESULT TopLevelContainer([out, retval] boolean* pBool);

        [id(205), propget, helpstring("Returns the type of the contained document object."), helpcontext(0x0000)]
            HRESULT Type([out,retval] BSTR* pbstrType);

        // Window stuff...
        [id(206), propget, helpstring("The horizontal position (pixels) of the frame window relative to the screen/container."), helpcontext(0x0000)]
            HRESULT Left([out, retval] long *pl);
        [id(206), propput]
            HRESULT Left([in] long Left);
        [id(207), propget, helpstring("The vertical position (pixels) of the frame window relative to the screen/container."), helpcontext(0x0000)]
            HRESULT Top([out, retval] long *pl);
        [id(207), propput]
            HRESULT Top([in] long Top);
        [id(208), propget, helpstring("The horizontal dimension (pixels) of the frame window/object."), helpcontext(0x0000)]
            HRESULT Width([out, retval] long *pl);
        [id(208), propput]
            HRESULT Width([in] long Width);
        [id(209), propget, helpstring("The vertical dimension (pixels) of the frame window/object."), helpcontext(0x0000)]
            HRESULT Height([out, retval] long *pl);
        [id(209), propput]
            HRESULT Height([in] long Height);

        // WebBrowser stuff...
        [id(210), propget, helpstring("Gets the short (UI-friendly) name of the URL/file currently viewed."), helpcontext(0x0000)]
            HRESULT LocationName([out,retval] BSTR * pbstrLocationName);

        [id(211), propget, helpstring("Gets the full URL/path currently viewed."), helpcontext(0x0000)]
            HRESULT LocationURL([out,retval] BSTR * pbstrLocationURL);

        // Added a property to see if the viewer is currenly busy or not...
        [id(212), propget, helpstring("Query to see if something is still in progress."), helpcontext(0x0000)]
            HRESULT Busy([out,retval] boolean *pBool);
    };

    // event interface for IWebBrowser controls ...
    //
    [
        uuid(EAB22AC2-30C1-11CF-A7EB-0000C05BAE0B),
        helpstring("Event interface for Web Browser Control"),
        hidden
    ]
    dispinterface DWebBrowserEvents {
        properties:
        methods:

        [id(DISPID_BEFORENAVIGATE), helpstring("Fired when a new hyperlink is being navigated to."), helpcontext(0x0000)]
            void BeforeNavigate([in] BSTR URL, long Flags, BSTR TargetFrameName, VARIANT * PostData, BSTR Headers, [in, out]boolean * Cancel);

        [id(DISPID_NAVIGATECOMPLETE), helpstring("Fired when a new hyperlink is being navigated to."), helpcontext(0x0000)]
            void NavigateComplete([in] BSTR URL );

        [id(DISPID_STATUSTEXTCHANGE), helpstring("Statusbar text changed."), helpcontext(0x0000)]