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. Il primo apre un URL in una finestra denominata displayWindow, che crea con una barra di stato visualizzata. Il secondo apre un altro URL nella stessa finestra, ma specifica che deve essere visualizzata solo la barra di posizione. Si noti che le dimensioni della finestra e i controlli visualizzati dipendono dall'URL aperto per primo. L'esempio di codice richiede che il modulo contenga un WebBrowser controllo denominato 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 deve essere confuso con il concetto di una finestra in Windows Form o l'API Windows; non esiste alcuna HWND risorsa di Windows o simile che corrisponde direttamente a un'istanza di HtmlWindow. HtmlWindow Fornisce invece descrizioni generali della posizione di un documento sullo schermo di un utente, nonché metodi per interagire con gli utenti tramite prompt e finestre di dialogo. 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.

Una pagina Web è costituita da un singolo documento o da un FRAMESET oggetto contenente uno o più FRAME elementi, ognuno dei quali ospita il proprio documento. Gli sviluppatori Web usano frameset per visualizzare le pagine correlate logicamente affiancate (ad esempio, una pagina del contenuto accanto a una pagina di spostamento). Quando una pagina è costituita da un singolo documento, è possibile accedervi tramite la Document proprietà di HtmlWindow. Se la pagina utilizza frame, è possibile accedere ai documenti tramite l'insieme Frames , costituito da uno o più HtmlWindow oggetti.

Quando il WebBrowser controllo viene ospitato in un'applicazione Windows Form, è possibile scegliere di interagire con l'utente usando classi Windows Form standard, ad esempio Form o MessageBox, oppure è possibile usare metodi per HtmlWindow questo scopo. 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 all'utente e Confirm presenta una finestra di dialogo con una riga di testo personalizzato e pulsanti OK e Annulla .

È possibile usare HtmlWindow per aprire nuove finestre contenenti nuovi documenti. Open carica l'URL specificato nella finestra denominata, creandolo se non esiste già, mentre OpenNew apre sempre il relativo URL in una finestra appena creata.

Vedi anche

• Oggetto window
• Interfaccia IHTMLWindow2