HtmlWindow 클래스

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

하나 이상의 HtmlDocument 인스턴스를 포함하는 논리 창을 나타냅니다.

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

상속

Object

HtmlWindow

예제

다음 코드 예제에는 두 가지 메서드가 포함되어 있습니다. 첫 번째는 이름이 지정된 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

설명

HtmlWindowWindows Forms 또는 Windows API의 창 개념과 혼동해서는 안 됩니다. 인스턴스HtmlWindow에 직접 해당하는 Windows 리소스가 없거나 HWND 이와 유사합니다. 대신, HtmlWindow 사용자 화면에서 문서의 위치에 대한 개략적인 설명과 프롬프트 및 대화 상자를 통해 사용자와 상호 작용하는 방법을 제공합니다. HtmlWindow 는 웹 페이지의 문서 및 해당 메타데이터(예: 문서의 위치 및 웹 브라우저의 기능)에 대한 논리적 컨테이너로 작동합니다.

웹 페이지는 단일 문서 또는 FRAMESET 하나 이상의 FRAME 요소를 포함하는 문서로 구성되며, 각 요소는 자체 문서를 호스팅합니다. 웹 개발자는 프레임 세트를 사용하여 논리적으로 관련된 페이지를 나란히 표시합니다(예: 탐색 페이지 옆의 콘텐츠 페이지). 페이지가 단일 문서로 구성된 경우 해당 속성을 HtmlWindow통해 Document 액세스할 수 있습니다. 페이지에서 프레임을 사용하는 경우 하나 이상의 HtmlWindow 개체로 구성된 컬렉션을 통해 Frames 문서에 액세스할 수 있습니다.

때 호스트는 WebBrowser 컨트롤 Windows Forms 애플리케이션에서 같은 표준 Windows Forms 클래스를 사용 하 여 사용자와 상호 작용 하도록 선택할 수 있습니다 Form 또는 MessageBox에서 메서드를 사용할 수 있습니다 또는 HtmlWindow 이 목적을 위해 정의 합니다. 이 메서드는 Alert 사용자 지정 텍스트와 확인 단추 Prompt 가 있는 간단한 대화 상자를 제공하고, 사용자 지정 텍스트 줄과 텍스트 입력 필드를 사용자에게 제공하고, 사용자 지정 텍스트 줄과 Confirm 확인 및 취소 단추가 있는 대화 상자를 제공합니다.

새 문서가 포함된 새 창을 여는 데 사용할 HtmlWindow 수 있습니다. Open 는 지정된 URL을 명명된 창에 로드하고, URL이 아직 OpenNew 없는 경우 새로 만든 창에서 URL을 항상 엽니다.

속성

Document	창에 포함된 HTML 문서를 가져옵니다.
DomWindow	이 클래스에서 래핑하는 관리되지 않는 인터페이스를 가져옵니다.
Frames	웹 페이지 내에 정의된 각 FRAME 요소에 대한 참조를 가져옵니다.
History	사용자가 가장 최근에 열어 본 URL을 포함하는 개체를 가져옵니다.
IsClosed	이 창이 열려 있는지 또는 닫혀 있는지를 나타내는 값을 가져옵니다.
Name	창의 이름을 가져오거나 설정합니다.
Opener	현재 창을 연 창에 대한 참조를 가져옵니다.
Parent	프레임을 포함하는 페이지에서 현재 창 위에 있는 창을 가져옵니다.
Position	화면에서 창의 클라이언트 영역 위치를 가져옵니다.
Size	현재 창의 크기를 가져오거나 설정합니다.
StatusBarText	창의 상태 표시줄에 표시되는 텍스트를 가져오거나 설정합니다.
Url	창에 표시된 현재 항목에 해당하는 URL을 가져옵니다.
WindowFrameElement	이 창에 해당하는 프레임 요소를 가져옵니다.

메서드

Alert(String)	메시지 상자를 표시합니다.
AttachEventHandler(String, EventHandler)	명명된 HTML DOM 이벤트에 대한 이벤트 처리기를 추가합니다.
Close()	창을 닫습니다.
Confirm(String)	예/아니요 응답을 받도록 메시지와 단추가 있는 대화 상자를 표시합니다.
DetachEventHandler(String, EventHandler)	명명된 이벤트 처리기를 제거합니다.
Equals(Object)	현재 개체와 해당 개체가 같은지를 테스트합니다.
Focus()	현재 창에 포커스를 둡니다.
GetHashCode()	특정 유형에 대한 해시 함수로 사용합니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MoveTo(Int32, Int32)	화면의 지정된 좌표로 창을 이동합니다.
MoveTo(Point)	화면의 지정된 좌표로 창을 이동합니다.
Navigate(String)	지정된 URL에 있는 새 콘텐츠를 표시하거나 다운로드합니다.
Navigate(Uri)	현재 창에 새 문서를 표시합니다.
Open(String, String, String, Boolean)	명명된 창에 파일을 표시합니다.
Open(Uri, String, String, Boolean)	명명된 창에 파일을 표시합니다.
OpenNew(String, String)	새 창에 파일을 표시합니다.
OpenNew(Uri, String)	새 창에 파일을 표시합니다.
Prompt(String, String)	사용자에게 메시지와 텍스트 상자를 표시하는 대화 상자를 보여 줍니다.
RemoveFocus()	현재 창에서 포커스를 해제합니다.
ResizeTo(Int32, Int32)	창의 크기를 지정된 크기로 변경합니다.
ResizeTo(Size)	창의 크기를 지정된 크기로 변경합니다.
ScrollTo(Int32, Int32)	창을 지정된 위치로 스크롤합니다.
ScrollTo(Point)	지정된 좌표로 창을 이동합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

연산자

Equality(HtmlWindow, HtmlWindow)	두 HtmlWindow 개체가 같은지 테스트합니다.
Inequality(HtmlWindow, HtmlWindow)	두 HtmlWindow 개체가 다른지 비교합니다.

이벤트

Error	창 내부에서 실행 중인 스크립트에 런타임 오류가 발생하면 발생합니다.
GotFocus	현재 창에서 사용자 입력 포커스를 받으면 발생합니다.
Load	창의 문서와 모든 해당 요소의 초기화가 완료되면 발생합니다.
LostFocus	사용자 입력 포커스가 창을 벗어난 경우 발생합니다.
Resize	사용자가 마우스를 사용하여 창의 크기를 변경할 때 발생합니다.
Scroll	사용자가 화면 밖의 텍스트를 보기 위해 창을 스크롤하면 발생합니다.
Unload	현재 페이지를 언로드하고 있고 새 페이지를 표시하기 직전에 발생합니다.

추가 정보

• window 개체
• IHTMLWindow2 인터페이스