Edit

Share via

WebBrowser.DocumentTitle Property

  • Reference

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Gets the title of the document currently displayed in the WebBrowser control.

public:
 property System::String ^ DocumentTitle { System::String ^ get(); };
[System.ComponentModel.Browsable(false)]
public string DocumentTitle { get; }
[<System.ComponentModel.Browsable(false)>]
member this.DocumentTitle : string
Public ReadOnly Property DocumentTitle As String

Property Value

String

The title of the current document, or the empty string ("") if no document is loaded.

Attributes
BrowsableAttribute

Exceptions

ObjectDisposedException

This WebBrowser instance is no longer valid.

InvalidOperationException

A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Examples

The following code example demonstrates how to use the DocumentTitle property to update the form title bar with the title of the current document. This example requires that your form contains a WebBrowser control called webBrowser1.

For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

// Updates the title bar with the current document title.
void WebBrowser1_DocumentTitleChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   this->Text = WebBrowser1->DocumentTitle;
}

// Updates the title bar with the current document title.
private void webBrowser1_DocumentTitleChanged(object sender, EventArgs e)
{
    this.Text = webBrowser1.DocumentTitle;
}

' Updates the title bar with the current document title.
Private Sub webBrowser1_DocumentTitleChanged( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles webBrowser1.DocumentTitleChanged

    Me.Text = webBrowser1.DocumentTitle

End Sub

Remarks

This property is useful, for example, when you want to display the document title in the title bar of the application. If no title has been defined for the current document, this property is set to the document location and file name.

Handle the DocumentTitleChanged event to update the title in the title bar when the WebBrowser control navigates to a new document.

Applies to

See also