WebBrowser.Navigated イベント
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文Dim instance As WebBrowser Dim handler As WebBrowserNavigatedEventHandler AddHandler instance.Navigated, handler
public: event WebBrowserNavigatedEventHandler^ Navigated { void add (WebBrowserNavigatedEventHandler^ value); void remove (WebBrowserNavigatedEventHandler^ value); }
解説次のいずれかのプロパティが設定される、またはメソッドが呼び出されると、WebBrowser コントロールは必ず新しいドキュメントに移動します。
Navigated イベントを使用すると、WebBrowser コントロールが新しいドキュメントに移動したときに、通知が送られます。Navigated イベントが発生すると、新しいドキュメントの読み込みが開始されます。つまり、Document プロパティ、DocumentText プロパティ、または DocumentStream プロパティを使用して、読み込まれたコンテンツにアクセスできます。DocumentCompleted イベントを処理すると、WebBrowser コントロールで新しいドキュメントの読み込みが終了したときに通知が送られます。
Navigating イベントを処理することで、ナビゲーションが開始される前に通知を受け取ることもできます。このイベントを処理すると、たとえばユーザーがフォームへの入力を完了していない場合など、特定の条件が満たされなかった場合にナビゲーションをキャンセルできます。
使用例Navigated イベントのハンドラを使用して WebBrowser コントロールにアドレス バーを実装する方法を次のコード例に示します。この例では、webBrowser1 という名前の WebBrowser コントロール、TextBoxAddress という名前の TextBox コントロール、および ButtonGo という名前の Button コントロールがフォームに含まれていることを前提としています。テキスト ボックスに URL を入力し、Enter キーを押すか [移動] ボタンをクリックすると、WebBrowser コントロールが、指定された URL に移動します。ハイパーリンクをクリックして移動した場合、テキスト ボックスが自動的に更新され、現在の URL が表示されます。
コード全体については、「方法 : Windows フォーム アプリケーションに Web ブラウザの機能を追加する」を参照してください。
' Navigates to the URL in the address box when ' the ENTER key is pressed while the ToolStripTextBox has focus. Private Sub toolStripTextBox1_KeyDown( _ ByVal sender As Object, ByVal e As KeyEventArgs) _ Handles toolStripTextBox1.KeyDown If (e.KeyCode = Keys.Enter) Then Navigate(toolStripTextBox1.Text) End If End Sub ' Navigates to the URL in the address box when ' the Go button is clicked. Private Sub goButton_Click( _ ByVal sender As Object, ByVal e As EventArgs) _ Handles goButton.Click Navigate(toolStripTextBox1.Text) End Sub ' Navigates to the given URL if it is valid. Private Sub Navigate(ByVal address As String) If String.IsNullOrEmpty(address) Then Return If address.Equals("about:blank") Then Return If Not address.StartsWith("http://") And _ Not address.StartsWith("https://") Then address = "http://" & address End If Try webBrowser1.Navigate(New Uri(address)) Catch ex As System.UriFormatException Return End Try End Sub ' Updates the URL in TextBoxAddress upon navigation. Private Sub webBrowser1_Navigated(ByVal sender As Object, _ ByVal e As WebBrowserNavigatedEventArgs) _ Handles webBrowser1.Navigated toolStripTextBox1.Text = webBrowser1.Url.ToString() End Sub
// Navigates to the URL in the address box when // the ENTER key is pressed while the ToolStripTextBox has focus. private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e) { if (e.KeyCode == Keys.Enter) { Navigate(toolStripTextBox1.Text); } } // Navigates to the URL in the address box when // the Go button is clicked. private void goButton_Click(object sender, EventArgs e) { Navigate(toolStripTextBox1.Text); } // Navigates to the given URL if it is valid. private void Navigate(String address) { if (String.IsNullOrEmpty(address)) return; if (address.Equals("about:blank")) return; if (!address.StartsWith("http://") && !address.StartsWith("https://")) { address = "http://" + address; } try { webBrowser1.Navigate(new Uri(address)); } catch (System.UriFormatException) { return; } } // Updates the URL in TextBoxAddress upon navigation. private void webBrowser1_Navigated(object sender , WebBrowserNavigatedEventArgs e) { toolStripTextBox1.Text = webBrowser1.Url.ToString(); }
// Navigates to the URL in the address text box when // the ENTER key is pressed while the text box has focus. void TextBoxAddress_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e ) { if ( e->KeyCode == System::Windows::Forms::Keys::Enter && !this->TextBoxAddress->Text->Equals( "" ) ) { this->WebBrowser1->Navigate( this->TextBoxAddress->Text ); } } // Navigates to the URL in the address text box when // the Go button is clicked. void ButtonGo_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ ) { if ( !this->TextBoxAddress->Text->Equals( "" ) ) { this->WebBrowser1->Navigate( this->TextBoxAddress->Text ); } } // Updates the URL in TextBoxAddress upon navigation. void WebBrowser1_Navigated( Object^ /*sender*/, System::Windows::Forms::WebBrowserNavigatedEventArgs^ /*e*/ ) { this->TextBoxAddress->Text = this->WebBrowser1->Url->ToString(); }
.NET Framework のセキュリティプラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からWebBrowser.Navigated イベントを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からWebBrowser.Navigated イベント
を検索
- WebBrowser.Navigated イベントのページへのリンク
