HtmlWindow Classe

Definizione

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Ereditarietà

Object

HtmlWindow

Esempio

L'esempio di codice seguente contiene due metodi.The following code example contains two methods. Il primo apre un URL in una finestra denominata displayWindow , che viene creata con una barra di stato visualizzata.The first opens a URL in a window named displayWindow, which it creates with a status bar displayed. Il secondo apre un altro URL nella stessa finestra, ma specifica che deve essere visualizzata solo la barra del percorso.The second opens another URL in the same window, but specifies that only the location bar should be displayed. Si noti che le dimensioni della finestra e i controlli visualizzati dipendono dall'URL aperto per primo.Notice that the dimensions of the window and the controls that are displayed depends on which URL is opened first. Per l'esempio di codice è necessario che il form contenga un WebBrowser controllo denominato WebBrowser1 .The code example requires that your form contains a WebBrowser control named WebBrowser1.

private void DisplayFirstUrl()
{
    if (webBrowser1.Document != null)
    {
        //If this is called first, the window will only have a status bar.
        webBrowser1.Document.Window.Open(new Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", false);
    }
}

private void DisplaySecondUrl()
{
    if (webBrowser1.Document != null)
    {
        // If this is called first, the window will only have an Address bar.
        webBrowser1.Document.Window.Open(new Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", false);
    }
}

Private Sub DisplayFirstUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have a status bar.
            .Window.Open(New Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", False)
        End With
    End If
End Sub

Private Sub DisplaySecondUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have an Address bar.
            .Window.Open(New Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", False)
        End With
    End If
End Sub

Commenti

HtmlWindow non devono essere confusi con il concetto di finestra in Windows Forms o nell'API Windows; non esiste alcuna HWND risorsa di Windows o simile che corrisponde direttamente a un'istanza di HtmlWindow .HtmlWindow should not be confused with the concept of a window in Windows Forms or the Windows API; there is no HWND or similar Windows resource that corresponds directly to an instance of HtmlWindow. Fornisce invece HtmlWindow una descrizione di alto livello della posizione di un documento sullo schermo di un utente, nonché i metodi per interagire con gli utenti in base alle richieste e alle finestre di dialogo.Rather, HtmlWindow provides high-level descriptions of a document's location on a user's screen, as well as methods for interacting with users by way of prompts and dialog boxes. HtmlWindow funge da contenitore logico per i documenti di una pagina Web e i relativi metadati, ad esempio la posizione del documento e le funzionalità del Web browser.HtmlWindow acts as a logical container for a Web page's documents and its metadata, such as the document's location and the capabilities of the Web browser.

Una pagina Web è costituita da un singolo documento o da un oggetto FRAMESET contenente uno o più FRAME elementi, ognuno dei quali ospita il proprio documento.A Web page consists of a single document, or a FRAMESET containing one or more FRAME elements, each of which hosts its own document. Gli sviluppatori Web utilizzano i frame per visualizzare pagine correlate logicamente, ad esempio una pagina di contenuto accanto a una pagina di navigazione.Web developers use framesets to show logically related pages side by side (for example, a content page next to a navigation page). Quando una pagina è costituita da un singolo documento, è possibile accedervi tramite la Document proprietà di HtmlWindow ; se la pagina usa i frame, è possibile accedere ai documenti tramite la Frames raccolta, che è costituita da uno o più HtmlWindow oggetti.When a page consists of a single document, you can access it through the Document property of HtmlWindow; if the page uses frames, you can access their documents through the Frames collection, which consists of one or more HtmlWindow objects.

Quando si ospita il WebBrowser controllo in una Windows Forms Application, è possibile scegliere di interagire con l'utente utilizzando le classi Windows Forms standard, ad esempio Form o MessageBox , oppure è possibile utilizzare i metodi HtmlWindow definiti per questo scopo.When your host the WebBrowser control in a Windows Forms application, you can choose to interact with the user using standard Windows Forms classes, such as Form or MessageBox, or you can use methods on HtmlWindow defined for this purpose. Il Alert metodo presenta una semplice finestra di dialogo con testo personalizzato e un pulsante OK ; Prompt presenta una riga di testo personalizzato e un campo di input di testo per l'utente e Confirm Visualizza una finestra di dialogo con una riga di testo personalizzato e pulsanti OK e Annulla .The Alert method presents a simple dialog box with custom text and an OK button; Prompt presents a line of custom text and a text input field to the user; and Confirm presents a dialog box with a line of custom text and OK and Cancel buttons.

È possibile utilizzare HtmlWindow per aprire nuove finestre contenenti nuovi documenti.You can use HtmlWindow to open new windows containing new documents. Open carica l'URL specificato nella finestra denominata, creandolo se non esiste già, mentre OpenNew apre sempre l'URL in una finestra appena creata.Open loads the specified URL into the named window, creating it if it does not already exist, while OpenNew always opens its URL in a newly created window.

Proprietà

Metodi

Operatori

Eventi

Si applica a

Vedi anche

• Oggetto finestrawindow Object
• Interfaccia IHTMLWindow2IHTMLWindow2 Interface