WebBrowser.DocumentTitle Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает название документа, отображаемого в текущий момент в элементе управления 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
Значение свойства
Название текущего документа, или пустая строка (""), если никакой документ не загружен.
- Атрибуты
Исключения
Данный экземпляр WebBrowser больше не действителен.
Не удается получить ссылку на реализацию интерфейса IWebBrowser2
из базового элемента управления ActiveX WebBrowser
.
Примеры
В следующем примере кода показано, как использовать DocumentTitle свойство для обновления заголовка формы с помощью заголовка текущего документа. В этом примере требуется, чтобы форма содержала WebBrowser элемент управления с именем webBrowser1
.
Полный пример кода см. в разделе Практическое руководство. Добавление возможностей веб-браузера в приложение 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
Комментарии
Это свойство полезно, например, если требуется отобразить заголовок документа в строке заголовка приложения. Если для текущего документа не определен заголовок, этому свойству присваивается расположение документа и имя файла.
DocumentTitleChanged Обработка события для обновления заголовка в строке заголовка при переходе WebBrowser элемента управления к новому документу.