WebBrowser.DocumentTitle Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém o título do documento exibido no momento no controle WebBrowser.

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

Valor da propriedade

String

O título do documento atual ou a cadeia de caracteres vazia ("") se nenhum documento for carregado.

Atributos

BrowsableAttribute

Exceções

ObjectDisposedException

Essa instância WebBrowser não é mais válida.

InvalidOperationException

Uma referência a uma implementação da interface IWebBrowser2 não pôde ser recuperada do controle WebBrowser do ActiveX subjacente.

Exemplos

O exemplo de código a seguir demonstra como usar a DocumentTitle propriedade para atualizar a barra de título do formulário com o título do documento atual. Este exemplo requer que seu formulário contenha um WebBrowser controle chamado webBrowser1.

Para obter o exemplo de código completo, consulte Como adicionar recursos do navegador da Web a um aplicativo Windows Forms.

// 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

Comentários

Essa propriedade é útil, por exemplo, quando você deseja exibir o título do documento na barra de título do aplicativo. Se nenhum título tiver sido definido para o documento atual, essa propriedade será definida como o local do documento e o nome do arquivo.

Manipule o DocumentTitleChanged evento para atualizar o título na barra de título quando o WebBrowser controle navegar para um novo documento.

Confira também

• DocumentTitleChanged
• Controle WebBrowser
• IWebBrowser2 Interface