WebBrowser.DocumentTitle Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Titel des Dokuments ab, das WebBrowser derzeit im Steuerelement angezeigt wird.
public:
property System::String ^ DocumentTitle { System::String ^ get(); };[System.ComponentModel.Browsable(false)]
public string DocumentTitle { get; }[<System.ComponentModel.Browsable(false)>]
member this.DocumentTitle : stringPublic ReadOnly Property DocumentTitle As StringEigenschaftswert
Der Titel des aktuellen Dokuments oder die leere Zeichenfolge ("") wenn kein Dokument geladen wird.
- Attribute
Ausnahmen
Diese WebBrowser Instanz ist nicht mehr gültig.
Ein Verweis auf eine Implementierung der IWebBrowser2 Schnittstelle konnte nicht aus dem zugrunde liegenden ActiveX-Steuerelement WebBrowser abgerufen werden.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die DocumentTitle Eigenschaft verwendet wird, um die Formulartitelleiste mit dem Titel des aktuellen Dokuments zu aktualisieren. In diesem Beispiel muss das Formular ein WebBrowser Steuerelement enthalten, das aufgerufen wird webBrowser1.
Das vollständige Codebeispiel finden Sie unter 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
Hinweise
Diese Eigenschaft ist beispielsweise hilfreich, wenn Sie den Dokumenttitel in der Titelleiste der Anwendung anzeigen möchten. Wenn kein Titel für das aktuelle Dokument definiert wurde, wird diese Eigenschaft auf den Dokumentspeicherort und dateinamen festgelegt.
Behandeln Sie das DocumentTitleChanged Ereignis, um den Titel in der Titelleiste zu aktualisieren, wenn das WebBrowser Steuerelement zu einem neuen Dokument navigiert.
