Esporta (0) Stampa
Espandi tutto

Classe HtmlWindow

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

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public sealed class HtmlWindow
public final class HtmlWindow
public final class HtmlWindow
Non applicabile.

L'oggetto HtmlWindow non deve essere confuso con il concetto di finestra di Windows Form o dell'API Win32. Non esiste, infatti, alcun HWND né risorsa Windows simile che corrisponda direttamente a un'istanza di HtmlWindow. In HtmlWindow, al contrario, vengono forniti una descrizione generale della posizione di un documento sullo schermo e alcuni metodi per l'interazione con gli utenti mediante l'utilizzo di messaggi 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 browser Web.

Una pagina Web è costituita da un unico documento oppure da un elemento FRAMESET contenente uno o più elementi FRAME, ciascuno dei quali contiene il proprio documento. Gli sviluppatori Web utilizzano pagine con frame per visualizzare in modalità affiancata pagine correlate logicamente, ad esempio una pagina di contenuto accanto a una pagina di spostamento. Se una pagina è costituita da un unico documento, è possibile accedere alla pagina mediante la proprietà Document di HtmlWindow. Se la pagina utilizza frame, è possibile accedere ai relativi documenti mediante l'insieme Frames, costituito da uno o più oggetti HtmlWindow.

Quando si aggiunge il controllo WebBrowser in un'applicazione Windows Form, è possibile scegliere di interagire con l'utente utilizzando le classi standard di Windows Form, ad esempio Form o MessageBox, oppure utilizzare gli appositi metodi definiti in HtmlWindow. Il metodo Alert visualizza una semplice finestra di dialogo contenente un testo personalizzato e un pulsante OK, il metodo Prompt visualizza una riga di testo personalizzato e un campo per l'immissione di testo da parte dell'utente, mentre il metodo Confirm visualizza una finestra di dialogo contenente una riga di testo personalizzato e i pulsanti OK e Annulla.

È possibile utilizzare HtmlWindow per aprire nuove finestre contenenti i nuovi documenti. Il metodo Open carica l'URL specificato nella finestra indicata, creandone una nuova se non esiste già, mentre il metodo OpenNew apre sempre l'URL in una nuova finestra.

Nell'esempio di codice riportato di seguito sono contenuti due metodi. Il primo apre un URL in una finestra denominata displayWindow, in cui viene visualizzata automaticamente una barra di stato. Il secondo apre un altro URL nella stessa finestra, ma specifica che deve essere visualizzata soltanto la barra di posizione. Le dimensioni della finestra e dei controlli visualizzati dipendono dall'URL che viene aperto per primo. Per eseguire l'esempio di codice è necessario che nel form sia presente un controllo WebBrowser 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);
    }
}

System.Object
  System.Windows.Forms.HtmlWindow

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft