WebBrowser.DocumentTitle プロパティ

.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

C#

public string DocumentTitle { get;
 }

C++

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

J#

/** @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

C#

// 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;
}

.NET Framework のセキュリティ

• SecurityPermission  (このコントロールを使用する直接の呼び出し元に必要なアクセス許可)。要求値 : LinkDemand、名前付きアクセス許可セット、FullTrust。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebBrowser クラス
WebBrowser メンバ
System.Windows.Forms 名前空間
DocumentTitleChanged
その他の技術情報
IWebBrowser2 インターフェイス