HtmlWindow.Open メソッド

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定したウィンドウにファイルを表示します。

オーバーロード

Open(String, String, String, Boolean)	指定したウィンドウにファイルを表示します。
Open(Uri, String, String, Boolean)	指定したウィンドウにファイルを表示します。

Open(String, String, String, Boolean)

指定したウィンドウにファイルを表示します。

public:
 System::Windows::Forms::HtmlWindow ^ Open(System::String ^ urlString, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow Open (string urlString, string target, string windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow? Open (string urlString, string target, string windowOptions, bool replaceEntry);

member this.Open : string * string * string * bool -> System.Windows.Forms.HtmlWindow

Public Function Open (urlString As String, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

パラメーター

urlString: String

読み込むファイルの場所を記述する URL。

target: String

リソースを開くウィンドウの名前。これは、開発者が指定した名前、または次の特殊な値のいずれかです。

_blank: 新しいウィンドウで開きます urlString 。 OpenNew(String, String) を呼び出した場合と同じ動作を実行します。

_media: メディアバーで開きます urlString 。

_parent: 現在のウィンドウを作成したウィンドウで開きます urlString 。

_search: 検索バーで開きます urlString 。

_self: 現在のウィンドウで開きます urlString 。

_top: 要素に属するウィンドウにFRAME対して呼び出された場合は、その FRAMESETをホストするウィンドウでが開きますurlString。それ以外の場合は、と同じように _self動作します。

windowOptions: String

形式 name=valueの次のオプションの 0 個以上で構成されるコンマ区切りの文字列。任意の整数をleft受け取る、top、height、および width オプションを除き、各オプションは、または 10または no を有効な値として受け取りますyes。

channelmode: インターネットエクスプローラー 4.0 の非推奨のチャネルテクノロジで使用されます。既定値は no です。

directories: ウィンドウにディレクトリナビゲーションボタンを表示するかどうか。既定値は yes です。

height: ウィンドウのクライアント領域の高さ (ピクセル単位)。最小値は 100 です。これよりも小さいウィンドウを開こうとすると、Internet Explorer の既定値に従ってウィンドウが開かれます。

left: ユーザーの画面の左上隅を基準とした、ウィンドウの左側 (x 座標) の相対位置 (ピクセル単位)。正の整数にする必要があります。

location: ユーザーがウィンドウを新しい URL に移動できるようにするアドレスバーを表示するかどうか。既定値は yes です。

menubar: 新しいウィンドウにメニューを表示するかどうか。既定値は yes です。

resizable: ユーザーがウィンドウのサイズを変更できるかどうか。既定値は yes です。

scrollbars: ウィンドウに水平スクロールバーと垂直スクロールバーがあるかどうか。既定値は yes です。

status: ウィンドウの下部にステータスバーがあるかどうか。既定値は yes です。

titlebar: 現在のページのタイトルが表示されるかどうか。このオプションをに no 設定しても、マネージドアプリケーション内では有効になりません。タイトルバーは常に表示されます。

toolbar: [戻る]、[ 進む]、[ 停止 ] などのツールバーボタンが表示されるかどうか。既定値は yes です。

top: ユーザーの画面の左上隅を基準とした、ウィンドウの上端 (y 座標) の位置 (ピクセル単位)。正の整数にする必要があります。

width: ウィンドウのクライアント領域の幅 (ピクセル単位)。最小値は 100 です。これよりも小さいウィンドウを開こうとすると、Internet Explorer の既定値に従ってウィンドウが開かれます。

replaceEntry: Boolean

true ナビゲーション履歴で現在のウィンドウの URL を urlString に置き換えます。これは、HtmlHistory クラスのメソッドの操作に影響を及ぼします。

戻り値

HtmlWindow

新しいウィンドウ、またはパラメーターによって名前が付けられた以前に作成された target ウィンドウ。

注釈

パラメーターには target 、の以前の呼び出しの結果として作成されたウィンドウに名前を Open付けることができます。パラメーターは、ハイパーリンク (A 要素) または FORM 属性を使用 TARGET して新しいウィンドウでその URL を開く要素をクリックして開いたウィンドウを指すこともできます。次の HTML コードは、ユーザーがクリックしたときにという名前 orderWindow の新しいウィンドウを開きます。

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

パラメーターにオプションを windowOptions 指定すると、含まれていないオプションは自動的に無効になります。つまり、ステータスバーのみを指定 windowOptions する場合は、を使用して明示的に有効 windowOptionsにしない限り、メニューバー、ツールバー、タイトル、スクロールバーなどが表示されません。

によってurl参照されるファイルが、インターネットエクスプローラー内でホストできる HTML ファイル、テキストファイル、またはその他のファイルの種類である場合は、名前付きウィンドウに表示されます。インターネットエクスプローラー内にファイルを表示できず、target によって名前が付けられたウィンドウがまだ存在しない場合、インターネットエクスプローラーがリソースをダウンロードするのに十分な時間だけウィンドウが開きます。その直後に閉じられます。

または OpenNewを使用して新しいウィンドウをOpen作成すると、HTML ドキュメントオブジェクトモデルによってインターネットエクスプローラーの新しいインスタンスが開きます。作成したすべてのウィンドウでを呼び出Closeさない場合、アプリケーションが終了した後でも、インターネットエクスプローラーのこのインスタンスは実行されたままになります。

を使用 Open して既存のウィンドウに URL を読み込む場合、 windowOptions は無視されます。このウィンドウは、の最初の呼び出しによって最初に指定されたディメンション、外観、および画面の場所を Open保持します。

適用対象

Open(Uri, String, String, Boolean)

指定したウィンドウにファイルを表示します。

public:
 System::Windows::Forms::HtmlWindow ^ Open(Uri ^ url, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow Open (Uri url, string target, string windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow? Open (Uri url, string target, string windowOptions, bool replaceEntry);

member this.Open : Uri * string * string * bool -> System.Windows.Forms.HtmlWindow

Public Function Open (url As Uri, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

パラメーター

url: Uri

読み込むファイルの場所を記述する URL。

target: String

リソースを開くウィンドウの名前。これは、開発者が指定した名前、または次の特殊な値のいずれかです。

_blank: 新しいウィンドウで開きます url 。 OpenNew(String, String) を呼び出した場合と同じ動作を実行します。

_media: メディアバーで開きます url 。

_parent: 現在のウィンドウを作成したウィンドウで開きます url 。

_search: 検索バーで開きます url 。

_self: 現在のウィンドウで開きます url 。

_top: 要素に属するウィンドウにFRAME対して呼び出された場合は、その FRAMESETをホストするウィンドウでが開きますurl。それ以外の場合は、と同じように _self動作します。

windowOptions: String

channelmode: インターネットエクスプローラー 4.0 の非推奨のチャネルテクノロジで使用されます。既定値は no です。

directories: ウィンドウにディレクトリナビゲーションボタンを表示するかどうか。既定値は yes です。

left: ユーザーの画面の左上隅を基準とした、ウィンドウの左側 (x 座標) の相対位置 (ピクセル単位)。正の整数にする必要があります。

location: ユーザーがウィンドウを新しい URL に移動できるようにするアドレスバーを表示するかどうか。既定値は yes です。

menubar: 新しいウィンドウにメニューを表示するかどうか。既定値は yes です。

resizable: ユーザーがウィンドウのサイズを変更できるかどうか。既定値は yes です。

scrollbars: ウィンドウに水平スクロールバーと垂直スクロールバーがあるかどうか。既定値は yes です。

status: ウィンドウの下部にステータスバーがあるかどうか。既定値は yes です。

toolbar: [戻る]、[ 進む]、[ 停止 ] などのツールバーボタンが表示されるかどうか。既定値は yes です。

top: ユーザーの画面の左上隅を基準とした、ウィンドウの上端 (y 座標) の位置 (ピクセル単位)。正の整数にする必要があります。

replaceEntry: Boolean

true を使用して、現在のウィンドウの URL を url ナビゲーション履歴のに置き換えます。これは、クラスのメソッドの操作に影響します HtmlHistory 。

戻り値

HtmlWindow

新しいウィンドウ、または HtmlWindow パラメーターで指定された以前に作成されたウィンドウを表す target。

例

次のコード例には、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

注釈

パラメーターには target 、への以前の呼び出しの結果として作成されたウィンドウに名前を Open付けることができます。パラメーターは、ハイパーリンク (A 要素) または FORM 属性を使用 TARGET して新しいウィンドウで URL を開く要素をクリックして開いたウィンドウを指すこともできます。次の HTML コードは、ユーザーがクリックしたときにという名前 orderWindow の新しいウィンドウを開きます。

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

によってurl参照されるファイルが、インターネットエクスプローラー内でホストできる HTML ファイル、テキストファイル、またはその他のファイルの種類である場合は、名前付きウィンドウに表示されます。インターネットエクスプローラー内にファイルを表示できず、target という名前のウィンドウがまだ存在しない場合、インターネットエクスプローラーがリソースをダウンロードするのに十分な時間だけウィンドウが開きます。その後すぐに閉じます。

または OpenNewを使用して新しいウィンドウをOpen作成すると、HTML ドキュメントオブジェクトモデルによってインターネットエクスプローラーの新しいインスタンスが開きます。作成したすべてのウィンドウでを呼び出Closeさない場合は、アプリケーションが終了しても、インターネットエクスプローラーのこのインスタンスは実行されたままになります。

を使用 Open して既存のウィンドウに URL を読み込む場合、 windowOptions は無視されます。最初にを呼び出すと、ウィンドウは最初にディメンション、外観、および画面の場所を Open保持します。

こちらもご覧ください

open メソッド

適用対象

HtmlWindow.Open メソッド

定義

オーバーロード

Open(String, String, String, Boolean)

パラメーター

戻り値

注釈

適用対象

Open(Uri, String, String, Boolean)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース