Udostępnij za pośrednictwem

WebBrowser.DocumentTitle Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera tytuł dokumentu aktualnie wyświetlanego w kontrolce 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

Wartość właściwości

String

Tytuł bieżącego dokumentu lub pusty ciąg (""), jeśli dokument nie zostanie załadowany.

Atrybuty
BrowsableAttribute

Wyjątki

ObjectDisposedException

To WebBrowser wystąpienie nie jest już prawidłowe.

InvalidOperationException

Nie można pobrać odwołania do implementacji interfejsu IWebBrowser2 z bazowej kontrolki ActiveX WebBrowser .

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą DocumentTitle właściwości zaktualizować pasek tytułu formularza tytułem bieżącego dokumentu. Ten przykład wymaga, aby formularz zawierał kontrolkę WebBrowser o nazwie webBrowser1.

Pełny przykład kodu można znaleźć w temacie How to: Add Web Browser Capabilities to a Windows Forms Application (Instrukcje: dodawanie funkcji przeglądarki internetowej do aplikacji 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

Uwagi

Ta właściwość jest przydatna, na przykład wtedy, gdy chcesz wyświetlić tytuł dokumentu na pasku tytułu aplikacji. Jeśli dla bieżącego dokumentu nie zdefiniowano żadnego tytułu, ta właściwość jest ustawiona na lokalizację dokumentu i nazwę pliku.

Obsłuż zdarzenie, DocumentTitleChanged aby zaktualizować tytuł na pasku tytułu, gdy kontrolka WebBrowser przejdzie do nowego dokumentu.

Dotyczy

Zobacz też