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 ("") w przypadku załadowania dokumentu.

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 bazowego formantu ActiveX WebBrowser .

Przykłady

Poniższy przykład kodu pokazuje, jak za pomocą DocumentTitle właściwości zaktualizować pasek tytułu formularza z 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ługa DocumentTitleChanged zdarzenia w celu zaktualizowania tytułu na pasku tytułu po WebBrowser przejściu kontrolki do nowego dokumentu.

Dotyczy

Zobacz też