WebBrowser.DocumentCompleted WebBrowser.DocumentCompleted WebBrowser.DocumentCompleted WebBrowser.DocumentCompleted Event

定義

WebBrowser コントロールでドキュメントの読み込みが終了したときに発生します。Occurs when the WebBrowser control finishes loading a document.

public:
 event System::Windows::Forms::WebBrowserDocumentCompletedEventHandler ^ DocumentCompleted;
public event System.Windows.Forms.WebBrowserDocumentCompletedEventHandler DocumentCompleted;
member this.DocumentCompleted : System.Windows.Forms.WebBrowserDocumentCompletedEventHandler 
Public Custom Event DocumentCompleted As WebBrowserDocumentCompletedEventHandler 

このイベントを使用して、ドキュメントが完全に読み込まれた後に印刷する方法を次のコード例に示します。The following code example demonstrates the use of this event to print a document after it has fully loaded.

private void PrintHelpPage()
{
    // Create a WebBrowser instance. 
    WebBrowser webBrowserForPrinting = new WebBrowser();

    // Add an event handler that prints the document after it loads.
    webBrowserForPrinting.DocumentCompleted +=
        new WebBrowserDocumentCompletedEventHandler(PrintDocument);

    // Set the Url property to load the document.
    webBrowserForPrinting.Url = new Uri(@"\\myshare\help.html");
}

private void PrintDocument(object sender,
    WebBrowserDocumentCompletedEventArgs e)
{
    // Print the document now that it is fully loaded.
    ((WebBrowser)sender).Print();

    // Dispose the WebBrowser now that the task is complete. 
    ((WebBrowser)sender).Dispose();
}
Private Sub PrintHelpPage()

    ' Create a WebBrowser instance. 
    Dim webBrowserForPrinting As New WebBrowser()

    ' Add an event handler that prints the document after it loads.
    AddHandler webBrowserForPrinting.DocumentCompleted, New _
        WebBrowserDocumentCompletedEventHandler(AddressOf PrintDocument)

    ' Set the Url property to load the document.
    webBrowserForPrinting.Url = New Uri("\\myshare\help.html")

End Sub

Private Sub PrintDocument(ByVal sender As Object, _
    ByVal e As WebBrowserDocumentCompletedEventArgs)

    Dim webBrowserForPrinting As WebBrowser = CType(sender, WebBrowser)

    ' Print the document now that it is fully loaded.
    webBrowserForPrinting.Print()
    MessageBox.Show("print")

    ' Dispose the WebBrowser now that the task is complete. 
    webBrowserForPrinting.Dispose()

End Sub

注釈

コントロールWebBrowserは、次のいずれかのプロパティが設定されるか、メソッドが呼び出されるたびに、新しいドキュメントに移動します。The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:

新しいドキュメントの読み込みが終了したときに通知を受信するイベントを処理します。DocumentCompletedHandle the DocumentCompleted event to receive notification when the new document finishes loading. イベントが発生すると、新しいドキュメントが完全に読み込まれます。つまりDocument、、 DocumentText、またはDocumentStreamプロパティを使用して、そのコンテンツにアクセスできます。 DocumentCompletedWhen the DocumentCompleted event occurs, the new document is fully loaded, which means you can access its contents through the Document, DocumentText, or DocumentStream property.

ナビゲーションを開始する前に通知を受信Navigatingするには、イベントを処理します。To receive notification before navigation begins, handle the Navigating event. このイベントを処理すると、特定の条件が満たされていない場合 (ユーザーがフォームを完全に入力していない場合など) にナビゲーションをキャンセルできます。Handling this event lets you cancel navigation if certain conditions have not been met, for example, when the user has not completely filled out a form. コントロールがWebBrowserナビゲーションを終了し、新しい場所でドキュメントの読み込みを開始したときに通知を受信するイベントを処理します。NavigatedHandle the Navigated event to receive notification when the WebBrowser control finishes navigation and has begun loading the document at the new location.

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。For more information about handling events, see Handling and Raising Events.

セキュリティ

SecurityPermission
直前の呼び出し元がこのコントロールを使用できるようにします。for immediate callers to use this control. 要求の値LinkDemand:、名前付きアクセス許可セット: FullTrustDemand value: LinkDemand; Named Permission Sets: FullTrust.

適用対象

こちらもご覧ください