HtmlWindow クラス

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

HtmlDocument のインスタンスを 1 つ以上格納する論理的なウィンドウを表します。

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

継承

Object

HtmlWindow

例

次のコード例には、2 つのメソッドが含まれています。 最初の では、 という名前 displayWindowのウィンドウに URL が開き、ステータス バーが表示されて作成されます。 2 つ目は同じウィンドウに別の URL を開きますが、場所バーのみを表示することを指定します。 ウィンドウのサイズと表示されるコントロールは、最初に開かれる URL によって異なります。 このコード例では、フォームに という名前WebBrowser1のコントロールがWebBrowser含まれている必要があります。

private void DisplayFirstUrl()
{
    if (webBrowser1.Document != null)
    {
        //If this is called first, the window will only have a status bar.
        webBrowser1.Document.Window.Open(new Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", false);
    }
}

private void DisplaySecondUrl()
{
    if (webBrowser1.Document != null)
    {
        // If this is called first, the window will only have an Address bar.
        webBrowser1.Document.Window.Open(new Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", false);
    }
}

Private Sub DisplayFirstUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have a status bar.
            .Window.Open(New Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", False)
        End With
    End If
End Sub

Private Sub DisplaySecondUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have an Address bar.
            .Window.Open(New Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", False)
        End With
    End If
End Sub

注釈

HtmlWindowは、Windows フォームまたは Windows API のウィンドウの概念と混同しないでください。のインスタンスに直接対応するまたは同様の HtmlWindowWindows リソースはありませんHWND。 代わりに、 では、 HtmlWindow ユーザーの画面上でのドキュメントの場所の概要と、プロンプトやダイアログ ボックスを使用してユーザーと対話するためのメソッドが提供されます。 HtmlWindow は、Web ページのドキュメントとそのメタデータ (ドキュメントの場所や Web ブラウザーの機能など) の論理コンテナーとして機能します。

Web ページは、1 つのドキュメント、または FRAMESET 1 つ以上 FRAME の要素を含む で構成され、それぞれが独自のドキュメントをホストします。 Web 開発者はフレームセットを使用して、論理的に関連するページを並べて表示します (ナビゲーション ページの横にあるコンテンツ ページなど)。 ページが 1 つのドキュメントで構成されている場合は、 の プロパティをDocument使用してページにアクセスできます。ページでフレームが使用されている場合は、1 つ以上HtmlWindowのオブジェクトで構成されるコレクションを通じてFramesドキュメントにアクセスHtmlWindowできます。

Windows フォーム アプリケーションでコントロールをWebBrowserホストする場合は、 や MessageBoxなどのForm標準の Windows フォーム クラスを使用してユーザーと対話するか、この目的で定義されている のメソッドをHtmlWindow使用できます。 メソッドは Alert 、ユーザー設定のテキストと [OK] ボタンを含む単純なダイアログ ボックスを表示し、 Prompt ユーザーにユーザー設定テキストの行とテキスト入力フィールドを表示し Confirm 、ユーザー設定テキストの行と [OK] ボタンと [キャンセル ] ボタンを含むダイアログ ボックスを表示します。

を使用 HtmlWindow して、新しいドキュメントを含む新しいウィンドウを開くことができます。 Open は、指定された URL を名前付きウィンドウに読み込み、まだ存在しない場合は作成します OpenNew が、新しく作成されたウィンドウでは常にその URL を開きます。

プロパティ

Document	ウィンドウに格納されている HTML ドキュメントを取得します。
DomWindow	このクラスによってラップされたアンマネージ インターフェイスを取得します。
Frames	Web ページ内で定義されている FRAME 各要素への参照を取得します。
History	ユーザーが最近表示した URL を格納するオブジェクトを取得します。
IsClosed	このウィンドウが開いているか閉じているかを示す値を取得します。
Name	ウィンドウの名前を取得または設定します。
Opener	現在のウィンドウを開いたウィンドウへの参照を取得します。
Parent	フレームを含むページにおいて、現在のウィンドウの上位にあるウィンドウを取得します。
Position	画面におけるウィンドウのクライアント領域の位置を取得します。
Size	現在のウィンドウのサイズを取得または設定します。
StatusBarText	ウィンドウのステータス バーに表示されるテキストを取得または設定します。
Url	ウィンドウに表示されている現在の項目に対応する URL を取得します。
WindowFrameElement	このウィンドウに対応するフレーム要素を取得します。

メソッド

Alert(String)	メッセージ ボックスを表示します。
AttachEventHandler(String, EventHandler)	指定した HTML DOM イベントのイベント ハンドラーを追加します。
Close()	ウィンドウを閉じます。
Confirm(String)	yes/no の応答を求めるメッセージとボタンを含むダイアログ ボックスを表示します。
DetachEventHandler(String, EventHandler)	指定したイベント ハンドラーを削除します。
Equals(Object)	指定したオブジェクトと現在のオブジェクトとを比較し、等しいかどうかをテストします。
Focus()	現在のウィンドウにフォーカスを設定します。
GetHashCode()	特定の型についてハッシュ関数として機能します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MoveTo(Int32, Int32)	画面上の指定した座標にウィンドウを移動します。
MoveTo(Point)	画面上の指定した座標にウィンドウを移動します。
Navigate(String)	指定した URL にある新しいコンテンツを表示またはダウンロードします。
Navigate(Uri)	現在のウィンドウに新しいドキュメントを表示します。
Open(String, String, String, Boolean)	指定したウィンドウにファイルを表示します。
Open(Uri, String, String, Boolean)	指定したウィンドウにファイルを表示します。
OpenNew(String, String)	新しいウィンドウにファイルを表示します。
OpenNew(Uri, String)	新しいウィンドウにファイルを表示します。
Prompt(String, String)	メッセージとテキスト ボックスをユーザーに表示するダイアログ ボックスを表示します。
RemoveFocus()	現在のウィンドウからフォーカスを移します。
ResizeTo(Int32, Int32)	ウィンドウのサイズを指定した寸法に変更します。
ResizeTo(Size)	ウィンドウのサイズを指定した寸法に変更します。
ScrollTo(Int32, Int32)	指定した位置までウィンドウをスクロールします。
ScrollTo(Point)	ウィンドウを指定された座標に移動します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

演算子

Equality(HtmlWindow, HtmlWindow)	2 つの HtmlWindow オブジェクトが等しいかどうかをテストします。
Inequality(HtmlWindow, HtmlWindow)	2 つの HtmlWindow オブジェクトが等しくないかどうかをテストします。

イベント

Error	ウィンドウ内で実行されているスクリプトがランタイム エラーを検出すると発生します。
GotFocus	現在のウィンドウがユーザーの入力フォーカスを得ると発生します。
Load	ウィンドウのドキュメントとそのすべての要素の初期化が終了すると発生します。
LostFocus	ウィンドウがユーザーの入力フォーカスを失うと発生します。
Resize	ユーザーがマウスを使用してウィンドウの寸法を変更すると発生します。
Scroll	ユーザーがウィンドウをスクロールして、画面に表示されていなかったテキストを表示すると発生します。
Unload	現在のページがアンロード中で、新しいページが表示される直前に発生します。

こちらもご覧ください

• window オブジェクト
• IHTMLWindow2 インターフェイス