Cenni preliminari sul controllo WebBrowser
Aggiornamento: novembre 2007
Il controllo WebBrowser fornisce un wrapper gestito per il controllo ActiveX WebBrowser. Il wrapper gestito consente di visualizzare pagine Web nelle applicazioni client Windows Form. È possibile utilizzare il controllo WebBrowser per duplicare le funzionalità del browser Internet Explorer nell'applicazione oppure disattivare le funzionalità predefinite di Internet Explorer e utilizzare il controllo come semplice visualizzatore di documenti HTML. Il controllo inoltre può essere utilizzato per aggiungere elementi dell'interfaccia utente basata su DHTML al form e nascondere il fatto che siano inclusi nel controllo WebBrowser. Questo approccio consente di combinare facilmente in un'unica applicazione i controlli Web e i controlli Windows Form.
Proprietà, metodi ed eventi di uso comune
Il controllo WebBrowser dispone di numerose proprietà, metodi ed eventi che possono essere utilizzati per implementare i controlli disponibili in Internet Explorer. È possibile utilizzare, ad esempio, il metodo Navigate per implementare una barra degli indirizzi e i metodi GoBack, GoForward, Stop e Refresh per implementare i pulsanti di spostamento su una barra degli strumenti. L'evento Navigated può essere gestito per aggiornare la barra degli indirizzi con il valore della proprietà Url e la barra del titolo con il valore della proprietà DocumentTitle.
Se si desidera generare contenuto personalizzato per le pagine all'interno dell'applicazione, è possibile impostare la proprietà DocumentText. Se si ha dimestichezza con il modello DOM (Document Object Model) HTML, è anche possibile modificare il contenuto della pagina Web corrente mediante la proprietà Document. Con questa proprietà, è possibile archiviare e modificare i documenti in memoria anziché spostarsi tra i vari file.
La proprietà Document consente inoltre di chiamare i metodi implementati nel codice di script delle pagine Web dal codice dell'applicazione client. Per accedere al codice dell'applicazione client dal codice di script, impostare la proprietà ObjectForScripting. L'oggetto specificato sarà accessibile al codice di script come oggetto window.external.
Nome |
Descrizione |
|---|---|
Proprietà Document |
Consente di ottenere un oggetto che fornisce accesso gestito al modello DOM (Document Object Model) HTML della pagina Web corrente. |
Evento DocumentCompleted |
Si verifica una volta completato il caricamento di una pagina Web. |
Proprietà DocumentText |
Consente di ottenere o impostare il contenuto HTML della pagina Web corrente. |
Proprietà DocumentTitle |
Consente di ottenere il titolo della pagina Web corrente. |
Metodo GoBack |
Consente di passare alla pagina precedente della cronologia. |
Metodo GoForward |
Consente di passare alla pagina successiva della cronologia. |
Metodo Navigate |
Consente di passare all'URL specificato. |
Evento Navigating |
Viene eseguito prima dell'avvio dello spostamento, consentendo l'annullamento dell'azione. |
Proprietà ObjectForScripting |
Consente di ottenere o impostare un oggetto che può essere utilizzato dal codice di script della pagina Web per comunicare con l'applicazione. |
Metodo Print |
Consente di stampare la pagina Web corrente. |
Metodo Refresh |
Consente di ricaricare la pagina Web corrente. |
Metodo Stop |
Consente di arrestare lo spostamento corrente e interrompere gli elementi di pagina dinamici, come ad esempio gli effetti audio e di animazione. |
Proprietà Url |
Consente di ottenere o impostare l'URL della pagina Web corrente. L'impostazione di questa proprietà consente di passare al nuovo URL con il controllo. |
Vedere anche
Attività
Procedura: passare a un URL con il controllo WebBrowser
Procedura: stampare con un controllo WebBrowser
Procedura: aggiungere funzionalità del browser Web a un'applicazione Windows Form
Procedura: creare un visualizzatore di documenti HTML in un'applicazione Windows Form
Concetti
Protezione dei controlli WebBrowser
Riferimenti
WebBrowserDocumentCompletedEventArgs
WebBrowserDocumentCompletedEventHandler
WebBrowserNavigatedEventHandler
WebBrowserNavigatingEventHandler