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(Uniform Resource Locator)입니다.

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, heightwidth 옵션을 제외하고 각 옵션은 또는 1및 또는 0no 유효한 값으로 허용합니다yes.

channelmode: 인터넷 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 특성을 사용하여 TARGET 새 창에서 해당 URL을 여는 요소를 클릭하여 열린 창을 가리킬 수도 있습니다. 다음 HTML 코드는 사용자가 클릭할 때 라는 orderWindow 새 창을 엽니다.

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

매개 변수에 대한 windowOptions 옵션을 제공하는 경우 포함되지 않은 옵션은 자동으로 비활성화됩니다. 즉, 상태 막대를 원하는 방식으로 windowOptions 만 지정하는 경우 를 통해 windowOptions명시적으로 사용하도록 설정하지 않으면 메뉴 모음, 도구 모음, 제목, 스크롤 막대 등이 표시되지 않습니다.

에서 참조하는 url 파일이 인터넷 Explorer 내에서 호스트될 수 있는 HTML 파일, 텍스트 파일 또는 기타 파일 형식인 경우 명명된 창에 표시됩니다. 인터넷 Explorer 내에 파일을 표시할 수 없고 대상에 의해 명명된 창이 아직 없으면 인터넷 Explorer 리소스를 다운로드할 수 있을 만큼 창이 열리고 그 후에 즉시 닫힙니다.

또는 를 OpenNew사용하여 Open 새 창을 만들면 HTML 문서 개체 모델이 인터넷 Explorer 새 instance 열립니다. 호출 하지 않으면 Close 모든 사용자가 만든 windows에서 Internet Explorer의이 인스턴스 계속 실행 됩니다 애플리케이션이 종료 된 후에 합니다.

를 사용하여 Open 기존 창 windowOptions 에서 URL을 로드하는 경우 는 무시됩니다. 창은 에 대한 초기 호출 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(Uniform Resource Locator)입니다.

target
String

리소스를 열 창의 이름입니다. 개발자가 지정하는 이름이거나 다음과 같은 특수 값 중 하나일 수 있습니다.

_blank: 새 창에서 열립니다 url . OpenNew(String, String)에 대한 호출과 동일하게 작동합니다.

_media: 미디어 표시줄에서 열립니다 url .

_parent: 현재 창을 만든 창에서 열립니다 url .

_search: 검색 창에서 열립니다 url .

_self: 현재 창에서 열립니다 url .

_top: 요소에 속한 FRAME 창에 대해 호출되면 해당 FRAMESET를 호스트하는 창에서 열립니다url. 그렇지 않으면 과 동일하게 _self작동합니다.

windowOptions
String

형식 name=value의 다음 옵션 중 0개 이상으로 구성된 쉼표로 구분된 문자열입니다. 임의 정수로 left사용하는 , top, heightwidth 옵션을 제외하고 각 옵션은 또는 1및 또는 0no 유효한 값으로 허용합니다yes.

channelmode: 인터넷 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 매개 변수에 의해 명명된 이전에 만든 창입니다.

예제

다음 코드 예제에는 두 가지 메서드가 포함되어 있습니다.

  • 첫 번째는 라는 displayWindow창에서 URL을 엽니다. 이 창은 상태 표시줄을 표시하여 만듭니다.
  • 두 번째 는 동일한 창에서 다른 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 파일이 인터넷 Explorer 내에서 호스트될 수 있는 HTML 파일, 텍스트 파일 또는 기타 파일 형식인 경우 명명된 창에 표시됩니다. 인터넷 Explorer 내에 파일을 표시할 수 없고 대상에 의해 명명된 창이 아직 없으면 인터넷 Explorer 리소스를 다운로드할 수 있을 만큼 창이 열리고 그 후에 즉시 닫힙니다.

또는 를 OpenNew사용하여 Open 새 창을 만들면 HTML 문서 개체 모델이 인터넷 Explorer 새 instance 열립니다. 호출 하지 않으면 Close 모든 사용자가 만든 windows에서 Internet Explorer의이 인스턴스 계속 실행 됩니다 애플리케이션이 종료 된 후에 합니다.

를 사용하여 Open 기존 창 windowOptions 에서 URL을 로드하는 경우 는 무시됩니다. 창은 에 대한 초기 호출 Open을 통해 먼저 지정된 차원, 모양 및 화면 위치를 유지합니다.

추가 정보

적용 대상