HtmlWindow.Open メソッド

定義

名前付きウィンドウにファイルを表示します。

オーバーロード

名前 説明
Open(String, String, String, Boolean)

名前付きウィンドウにファイルを表示します。

Open(Uri, String, String, Boolean)

名前付きウィンドウにファイルを表示します。

Open(String, String, String, Boolean)

ソース:
HtmlWindow.cs
ソース:
HtmlWindow.cs
ソース:
HtmlWindow.cs
ソース:
HtmlWindow.cs
ソース:
HtmlWindow.cs

名前付きウィンドウにファイルを表示します。

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

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

target
String

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

_blank: urlString を新しいウィンドウで開きます。 OpenNew(String, String)の呼び出しと同じように動作します。

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

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

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

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

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

windowOptions
String

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

channelmode: Internet Explorer 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 クラスに対するメソッドの操作が有効になります。

返品

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

注釈

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

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

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

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

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

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

適用対象

Open(Uri, String, String, Boolean)

ソース:
HtmlWindow.cs
ソース:
HtmlWindow.cs
ソース:
HtmlWindow.cs
ソース:
HtmlWindow.cs
ソース:
HtmlWindow.cs

名前付きウィンドウにファイルを表示します。

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

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

target
String

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

_blank: url を新しいウィンドウで開きます。 OpenNew(String, String)の呼び出しと同じように動作します。

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

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

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

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

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

windowOptions
String

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

channelmode: Internet Explorer 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 をナビゲーション履歴の url に置き換えます。 これは、 HtmlHistory クラスのメソッドの操作に影響します。

返品

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

次のコード例には、2 つのメソッドが含まれています。

  • 1 つ目は、 displayWindowという名前のウィンドウで URL を開き、ステータス バーが表示された状態で作成されます。
  • 2 つ目は同じウィンドウに別の URL を開きますが、場所バーのみを表示することを指定します。

ウィンドウのサイズと表示されるコントロールは、最初に開かれる URL によって異なります。 このコード例では、フォームに WebBrowser という名前のWebBrowser1 コントロールが含まれている必要があります。

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 属性を使用して新しいウィンドウで URL を開くTARGET要素をクリックして開いたウィンドウを指すこともできます。 次の HTML コードでは、ユーザーがクリックすると、 orderWindow という名前の新しいウィンドウが開きます。

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

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

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

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

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

こちらもご覧ください

適用対象