转自:http://msdn.microsoft.com/en-us/library/aa752084
目的留个备份,方便我以后去MSDN上找用法。
Controls an instance of Windows Internet Explorer through automation.
Members Table
The following table lists the members exposed by the InternetExplorer object.
Events
Event Description BeforeNavigate Fires before navigation occurs in the given object (on either a window or frameset element). BeforeNavigate2 Fires before navigation occurs in the given object (on either a window element or a frameset element). CommandStateChange Fires when the enabled state of a command changes. DocumentComplete Fires when a document is completely loaded and initialized. DownloadBegin Fires when a navigation operation begins. DownloadComplete Fires when a navigation operation finishes, is halted, or fails. FileDownload Fires to indicate that a file download is about to occur. If a file download dialog box can be displayed, this event fires prior to the appearance of the dialog box. NavigateComplete Fires after a navigation to a link is completed on either a window element or a frameSet element. NavigateComplete2 Fires after a navigation to a link is completed on a window element or a frameSet element. NavigateError Fires when an error occurs during navigation. NewProcess Creates a new process to handle the navigation. NewWindow Fires when a new window is to be created. NewWindow2 Fires when a new window is to be created. NewWindow3 Raised when a new window is to be created. Extends NewWindow2 with additional information about the new window. OnFullScreen Fires when the FullScreen property is changed. OnMenuBar Fires when the MenuBar property is changed. OnQuit Fires before the Internet Explorer application quits. OnStatusBar Fires when the StatusBar property is changed. OnTheaterMode Fires when the TheaterMode property is changed. OnToolBar Fires when the ToolBar property is changed. OnVisible Fires when the Visible property of the object is changed. PrintTemplateInstantiation Fires when a print template is instantiated. PrintTemplateTeardown Fires when a print template is destroyed. PrivacyImpactedStateChange Fired when an event occurs that impacts privacy, or when a user navigates away from a URL that has impacted privacy. ProgressChange Fires when the progress of a download operation is updated on the object. PropertyChange Fires when the PutProperty method of the object changes the value of a property. RedirectXDomainBlocked Fired when a cross-domain redirect request is blocked. SetPhishingFilterStatus Fires to indicate the progress and status of Microsoft Phishing Filter analysis of the current webpage. SetSecureLockIcon Fires when there is a change in encryption level. StatusTextChange Fires when the status bar text of the object has changed. ThirdPartyUrlBlocked Fired when a third-party URL is blocked. TitleChange Fires when the title of a document in the object becomes available or changes. UpdatePageStatus Not implemented. WindowActivate Not implemented. WindowMove Not implemented. WindowResize Not implemented. WindowStateChanged Fires when the visibility state of a content window, such as the browser window or a tab, changes. Methods
Method Description ClientToWindow Computes the full size of the browser window when given the specified width and height of the content area. ExecWB Executes a command and returns the status of the command execution using the IOleCommandTarget interface. GetProperty Gets the value associated with a user-defined property name. GoBack Navigates backward one item in the history list. GoForward Navigates forward one item in the history list. GoHome Navigates to the current home or start page. GoSearch Navigates to the current search page. Navigate Navigates to a resource identified by a URL or to a file identified by a full path. Navigate2 Navigates the browser to a location that might not be expressed as a URL, such as a pointer to an item identifier list (PIDL) for an entity in the Windows Shell namespace. PutProperty Associates a user-defined name/value pair with the object. QueryStatusWB Queries the object for the status of commands using the IOleCommandTarget interface. Quit Closes the object. Refresh Reloads the file that is currently displayed in the object. Refresh2 Reloads the file that is currently displayed with the specified refresh level. ShowBrowserBar Shows or hides a specified browser bar. Stop Cancels a pending navigation or download, and stops dynamic page elements, such as background sounds and animations. Properties
Property Description AddressBar Sets or gets a value that indicates whether the address bar of the object is visible or hidden. Application Gets the automation object for the application that is hosting the WebBrowser Control. Busy Gets a value that indicates whether the object is engaged in a navigation or downloading operation. Container Gets an object reference to a container. Document Gets the automation object of the active document, if any. FullName Retrieves the fully qualified path of the Internet Explorer executable. FullScreen Sets or gets a value that indicates whether Internet Explorer is in full-screen mode or normal window mode. Height Sets or gets the height of the object. HWND Gets the handle of the Internet Explorer main window. Left Sets or gets the coordinate of the left edge of the object. LocationName Retrieves the path or title of the resource that is currently displayed. LocationURL Gets the URL of the resource that is currently displayed. MenuBar Sets or gets a value that indicates whether the Internet Explorer menu bar is visible. Name Retrieves the frame name or application name of the object. Offline Sets or gets a value that indicates whether the object is operating in offline mode. Parent Gets the parent of the object. Path Retrieves the system folder of the Internet Explorer executable. ReadyState Gets the ready state of the object. RegisterAsBrowser Sets or gets a value that indicates whether the object is registered as a top-level browser window. RegisterAsDropTarget Sets or gets a value that indicates whether the object is registered as a drop target for navigation. Resizable Sets or gets a value that indicates whether the object can be resized. Silent Sets or gets a value that indicates whether the object can display dialog boxes. StatusBar Sets or gets a value that indicates whether the status bar for the object is visible. StatusText Sets or gets the text in the status bar for the object. TheaterMode Sets or gets whether the object is in theater mode. ToolBar Sets or gets whether toolbars for the object are visible. Top Sets or gets the coordinate of the top edge of the object. TopLevelContainer Gets a value that indicates whether the object is a top-level container. Type Gets the user type name of the contained document object. Visible Sets or gets a value that indicates whether the object is visible or hidden. Width Sets or gets the width of the object.
Remarks
Internet Explorer 8. On Windows Vista, to create an instance of Internet Explorer running at a medium integrity level, pass
CLSID_InternetExplorerMedium
(defined in exdisp.idl) to CoCreateInstance. The resulting InternetExplorerMedium object supports the same events, methods, and properties as the InternetExplorer object.
Examples
The following example uses CreateObject in Microsoft Visual Basic to launch an instance of Internet Explorer.
Dim IE As SHDocVw.InternetExplorer Set IE = CreateObject("InternetExplorer.Application")The following C# example launches an instance of Internet Explorer and navigates to a Web page. The code also demonstrates how to create an event handler to listen for the BeforeNavigate2 event. The project requires a reference to the Microsoft Internet Controls (SHDocVw) type library.
using System; using System.Collections.Generic; using System.Text; namespace ConsoleApplication1 { class EventHandlers { public void OnBeforeNavigate2(object sender, ref object URL, ref object Flags, ref object Target, ref object PostData, ref object Headers, ref bool Cancel) { Console.WriteLine("BeforeNavigate2 fired!"); } } class Program { static void Main(string[] args) { EventHandlers e = new EventHandlers(); SHDocVw.InternetExplorer IE = new SHDocVw.InternetExplorer(); object Empty = 0; object URL = "http://www.live.com"; // override BeforeNavigate2 event IE.BeforeNavigate2 += new SHDocVw.DWebBrowserEvents2_BeforeNavigate2EventHandler( e.OnBeforeNavigate2); IE.Visible = true; IE.Navigate2(ref URL, ref Empty, ref Empty, ref Empty, ref Empty); System.Threading.Thread.Sleep(5000); IE.Quit(); } } }
Object Information
CLSID CLSID_InternetExplorer Minimum availability Internet Explorer 4.0 Minimum operating systems Windows 98, Windows CE 4.0