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 della posizione. Si noti che le dimensioni della finestra e i controlli visualizzati dipendono innanzitutto dall'URL aperto. 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 Forms o l'API Windows; non esiste alcuna HWND risorsa di Windows o simile che corrisponde direttamente a un'istanza di HtmlWindow. Invece, HtmlWindow fornisce descrizioni di alto livello 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 il percorso 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 i set di fotogrammi 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 usa fotogrammi, è possibile accedere ai documenti tramite la Frames raccolta, costituita da uno o più HtmlWindow oggetti.

Quando il WebBrowser controllo viene ospitato in un'applicazione Windows Forms, è possibile scegliere di interagire con l'utente usando classi Windows Forms 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 Confirm e 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 l'URL in una finestra appena creata.

Proprietà

Metodi

Operatori

Eventi

Si applica a

Vedi anche

• oggetto window
• Interfaccia IHTMLWindow2