HtmlWindow.Open メソッド

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

パラメーター

戻り値

新しいウィンドウ、または パラメーターによって名前が付けられた以前に作成された 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保持します。

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

パラメーター

戻り値

新しいウィンドウ、または 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>

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

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

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

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

こちらもご覧ください

• open メソッド