WebBrowser.DocumentTitle プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebBrowser.DocumentTitle プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

WebBrowser コントロールに現在表示されているドキュメントのタイトルを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 DocumentTitle As String

Visual Basic (使用法)

Dim instance As WebBrowser
Dim value As String

value = instance.DocumentTitle

public string DocumentTitle { get;
 }

C++

public:
property String^ DocumentTitle {
    String^ get ();
}

/** @property */
public String get_DocumentTitle ()

JScript

public function get DocumentTitle
 () : String

プロパティ値
現在のドキュメントのタイトル。ドキュメントが読み込まれていない場合は、空の文字列 ("")。

例外

例外の種類	条件
ObjectDisposedException	この WebBrowser インスタンスは無効になっています。
InvalidOperationException	IWebBrowser2 の実装への参照を、基になる ActiveX WebBrowser から取得できませんでした。

解説

たとえばアプリケーションのタイトルバーにドキュメントのタイトルを表示する場合などに、このプロパティが役立ちます。現在のドキュメントにタイトルが定義されていない場合には、このプロパティはドキュメントの場所とファイル名に設定されます。

DocumentTitleChanged イベントを処理して、WebBrowser コントロールが新しいドキュメントに移動したときにタイトルバーのタイトルを更新します。

使用例

DocumentTitle プロパティを使用して、フォームのタイトルバーを現在のドキュメントのタイトルに更新する方法を次のコード例に示します。この例は、フォームに webBrowser1 という WebBrowser コントロールが存在することを前提にしています。

コード全体については、「方法 : Windows フォームアプリケーションに Web ブラウザの機能を追加する」を参照してください。

Visual Basic

' 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

// Updates the title bar with the current document title.
private void webBrowser1_DocumentTitleChanged(object
 sender, EventArgs e)
{
    this.Text = webBrowser1.DocumentTitle;
}

C++

// Updates the title bar with the current document title.
void WebBrowser1_DocumentTitleChanged( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
{
   this->Text = WebBrowser1->DocumentTitle;
}