次の方法で共有


HtmlWindow.Open メソッド

定義

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

オーバーロード

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: 新しいウィンドウで開きます urlStringOpenNew(String, String) を呼び出した場合と同じ動作を実行します。

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

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

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

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

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

windowOptions
String

形式 name=valueの次のオプションの 0 個以上で構成されるコンマ区切りの文字列。 任意の整数をleft受け取る 、topheight、および 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 クラスのメソッドの操作に影響を及ぼします。

戻り値

新しいウィンドウ、または パラメーターによって名前が付けられた以前に作成された 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: 新しいウィンドウで開きます urlOpenNew(String, String) を呼び出した場合と同じ動作を実行します。

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

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

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

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

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

windowOptions
String

形式 name=valueの次のオプションの 0 個以上で構成されるコンマ区切りの文字列。 任意の整数をleft受け取る 、topheight、および 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 を url ナビゲーション履歴の に置き換えます。 これは、 クラスのメソッドの操作に影響します HtmlHistory

戻り値

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

こちらもご覧ください

適用対象