WebBrowser.StatusText プロパティ

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

WebBrowser.StatusText プロパティ

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

WebBrowser コントロールのステータス テキストを取得します。

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

Visual Basic (宣言)

Public Overridable ReadOnly
 Property StatusText As String

Visual Basic (使用法)

Dim instance As WebBrowser
Dim value As String

value = instance.StatusText

C#

public virtual string StatusText { get;
 }

C++

public:
virtual property String^ StatusText {
    String^ get ();
}

J#

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

JScript

public function get StatusText
 () : String

プロパティ値
ステータス テキスト。

例外

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

解説

このプロパティを使用して、WebBrowser コントロールの状態をステータス バーに表示できます。ステータス テキストとは、マウス ポインタをハイパーリンクに重ねたときに表示されるハイパーリンクの URLや、現在読み込み中のドキュメントの URL などの情報を含むメッセージです。StatusTextChanged イベントを処理して、StatusText プロパティの値が変化したときにステータス バーを更新します。

使用例

StatusText プロパティを使用して、Internet Explorer のステータス バーのような機能を WebBrowser コントロールに実装する方法を次のコード例に示します。この例は、フォームに webBrowser1 という名前の WebBrowser コントロールと、StatusBar1 という名前の StatusBar コントロールが存在することを前提にしています。

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

Visual Basic

' Updates the status bar with the current browser status text.
Private Sub webBrowser1_StatusTextChanged(
 _
    ByVal sender As Object,
 ByVal e As EventArgs) _
    Handles webBrowser1.StatusTextChanged

    toolStripStatusLabel1.Text = webBrowser1.StatusText

End Sub

C#

// Updates the status bar with the current browser status text.
private void webBrowser1_StatusTextChanged(object
 sender, EventArgs e)
{
    toolStripStatusLabel1.Text = webBrowser1.StatusText;
}

C++

// Updates StatusBar1 with the current browser status text.
void WebBrowser1_StatusTextChanged( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
{
   this->StatusBar1->Text = WebBrowser1->StatusText;
}

.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 名前空間
StatusTextChanged
その他の技術情報
IWebBrowser2 インターフェイス