HtmlWindow Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rappresenta la finestra logica contenente una o più istanze di HtmlDocument.

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à

Document	Ottiene il documento HTML contenuto nella finestra.
DomWindow	Ottiene l'interfaccia non gestita di cui è stato eseguito il wrapping in questa classe.
Frames	Ottiene un riferimento a ognuno degli FRAME elementi definiti all'interno della pagina Web.
History	Ottiene un oggetto contenente gli URL visitati di recente dall'utente.
IsClosed	Ottiene un valore che indica se la finestra è aperta o chiusa.
Name	Ottiene o imposta il nome della finestra.
Opener	Ottiene un riferimento alla finestra che ha aperto la finestra corrente.
Parent	Ottiene la finestra che si trova al di sopra della finestra corrente in una pagina contenente frame.
Position	Ottiene la posizione sullo schermo dell'area client della finestra.
Size	Ottiene o imposta la dimensione della finestra corrente.
StatusBarText	Ottiene o imposta il testo visualizzato nella barra di stato di una finestra.
Url	Ottiene l'URL corrispondente all'elemento corrente visualizzato nella finestra.
WindowFrameElement	Ottiene l'elemento frame corrispondente alla finestra corrente.

Metodi

Alert(String)	Visualizza una finestra di messaggio.
AttachEventHandler(String, EventHandler)	Aggiunge un gestore eventi per l'evento HTML DOM specificato.
Close()	Chiude la finestra.
Confirm(String)	Visualizza una finestra di dialogo con un messaggio e i pulsanti Yes e No.
DetachEventHandler(String, EventHandler)	Rimuove il gestore eventi specificato.
Equals(Object)	Verifica l'uguaglianza dell'oggetto relativamente a quello corrente.
Focus()	Assegna lo stato attivo alla finestra corrente.
GetHashCode()	Svolge una funzione hash per un tipo particolare.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MoveTo(Int32, Int32)	Sposta la finestra in corrispondenza delle coordinate specificate sullo schermo.
MoveTo(Point)	Sposta la finestra in corrispondenza delle coordinate specificate sullo schermo.
Navigate(String)	Visualizza o scarica il nuovo contenuto disponibile nell'URL specificato.
Navigate(Uri)	Visualizza un nuovo documento nella finestra corrente.
Open(String, String, String, Boolean)	Visualizza un file nella finestra specificata.
Open(Uri, String, String, Boolean)	Visualizza un file nella finestra specificata.
OpenNew(String, String)	Visualizza un file in una nuova finestra.
OpenNew(Uri, String)	Visualizza un file in una nuova finestra.
Prompt(String, String)	Visualizza all'utente una finestra di dialogo in cui sono contenuti un messaggio e una casella di testo.
RemoveFocus()	Rimuove lo stato attivo dalla finestra corrente.
ResizeTo(Int32, Int32)	Modifica la dimensione della finestra in base alle dimensioni specificate.
ResizeTo(Size)	Modifica la dimensione della finestra in base alle dimensioni specificate.
ScrollTo(Int32, Int32)	Scorre la finestra fino alla posizione designata.
ScrollTo(Point)	Sposta la finestra in corrispondenza delle coordinate specificate.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Operatori

Equality(HtmlWindow, HtmlWindow)	Verifica l'uguaglianza dei due oggetti HtmlWindow.
Inequality(HtmlWindow, HtmlWindow)	Verifica la disuguaglianza dei due oggetti HtmlWindow.

Eventi

Error	Si verifica in caso di errore di runtime in uno script in esecuzione all'interno della finestra.
GotFocus	Si verifica quando la finestra corrente riceve lo stato attivo per l'input dell'utente.
Load	Si verifica quando il documento della finestra e tutti i relativi elementi sono stati inizializzati.
LostFocus	Si verifica quando la finestra ha perso lo stato attivo per l'input dell'utente.
Resize	Si verifica quando l'utente usa il mouse per modificare le dimensioni della finestra.
Scroll	Si verifica quando l'utente scorre la finestra per visualizzare il testo non presente sullo schermo.
Unload	Si verifica quando è in corso lo scaricamento della pagina corrente e sta per essere visualizzata una nuova pagina.

Vedi anche

• oggetto window
• Interfaccia IHTMLWindow2