HtmlWindow.Open Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Wyświetla plik w nazwanym oknie.

Przeciążenia

Open(String, String, String, Boolean)

Wyświetla plik w nazwanym oknie.
Open(Uri, String, String, Boolean)

Wyświetla plik w nazwanym oknie.

Open(String, String, String, Boolean)

Wyświetla plik w nazwanym oknie.

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

Parametry

urlString
String

Ujednolicony lokalizator zasobów opisujący lokalizację pliku do załadowania.

target
String

Nazwa okna, w którym ma być otwarty zasób. Może to być nazwa podana przez dewelopera lub jedna z następujących wartości specjalnych:

_blank: otwiera się urlString w nowym oknie. Działa tak samo jak wywołanie metody OpenNew(String, String).

_media: otwiera się urlString na pasku Multimediów.

_parent: otwiera się urlString w oknie, które utworzyło bieżące okno.

_search: otwiera się urlString na pasku wyszukiwania.

_self: otwiera się urlString w bieżącym oknie.

_top: Jeśli jest wywoływane względem okna należącego do elementu, zostanie otwarte urlString w oknie hostjącym FRAME jego FRAMESETelement . W przeciwnym razie działa tak samo jak _self.

windowOptions
String

Ciąg rozdzielany przecinkami składający się z zera lub większej liczby poniższych opcji w formularzu name=value. leftZ wyjątkiem opcji , top, heighti width , które przyjmują dowolne liczby całkowite, każda opcja akceptuje yes wartości lub 1, i lub no0jako prawidłowe wartości.

channelmode: używany z przestarzałą technologią kanałów programu Internet Explorer 4.0. Wartość domyślna to no.

directories: określa, czy okno powinno wyświetlać przyciski nawigacji katalogów. Wartość domyślna to yes.

height: wysokość obszaru klienta okna w pikselach. Wartość minimalna to 100; próba otwarcia okna mniejszego niż spowoduje to otwarcie okna zgodnie z ustawieniami domyślnymi programu Internet Explorer.

left: lewa pozycja (współrzędna x) okna względem lewego górnego rogu ekranu użytkownika w pikselach. Musi być dodatnią liczbą całkowitą.

location: określa, czy ma być wyświetlany pasek adresowy, który umożliwia użytkownikom przechodzenie do nowego adresu URL. Wartość domyślna to yes.

menubar: czy mają być wyświetlane menu w nowym oknie. Wartość domyślna to yes.

resizable: określa, czy rozmiar okna może być zmieniany przez użytkownika. Wartość domyślna to yes.

scrollbars: czy okno ma poziome i pionowe paski przewijania. Wartość domyślna to yes.

status: czy okno ma pasek stanu u dołu. Wartość domyślna to yes.

titlebar: określa, czy jest wyświetlany tytuł bieżącej strony. Ustawienie tej opcji no na wartość nie ma wpływu w aplikacji zarządzanej. Pasek tytułu będzie zawsze wyświetlany.

toolbar: czy są widoczne przyciski paska narzędzi, takie jak Wstecz, Prześlij dalej i Zatrzymaj . Wartość domyślna to yes.

top: położenie górnej (współrzędnej y) okna względem lewego górnego rogu ekranu użytkownika w pikselach. Musi być dodatnią liczbą całkowitą.

width: szerokość obszaru klienta okna w pikselach. Wartość minimalna to 100; próba otwarcia okna mniejszego niż spowoduje to otwarcie okna zgodnie z ustawieniami domyślnymi programu Internet Explorer.

replaceEntry
Boolean

true aby zastąpić adres URL bieżącego okna ciągiem urlString w historii nawigacji. Będzie to miało wpływ na działanie metod w HtmlHistory klasie .

Zwraca

HtmlWindow

Nowe okno lub wcześniej utworzone okno o nazwie parametru target .

Uwagi

Parametr target może nazwać okno, które zostało utworzone w wyniku poprzedniego wywołania metody Open. Parametr może również wskazywać otwarte okno, klikając hiperlink (A element) lub FORM element, który używa atrybutu TARGET , aby otworzyć jego adres URL w nowym oknie. Poniższy kod HTML otworzy nowe okno o nazwie orderWindow po kliknięciu go przez użytkownika:

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

Jeśli podasz jakiekolwiek opcje dla parametru windowOptions , każda opcja nieuwzględniana zostanie automatycznie wyłączona. Innymi słowy, jeśli określisz tylko za windowOptions pomocą paska stanu, pasek menu, pasek narzędzi, tytuł, paski przewijania i tak dalej nie będą wyświetlane, chyba że jawnie je włączysz za pomocą metody windowOptions.

Jeśli plik, url do którego odwołuje się plik HTML, plik tekstowy lub inny typ pliku, który może być hostowany w programie Internet Explorer, zostanie wyświetlony w nazwanym oknie. Jeśli nie można wyświetlić pliku w programie Internet Explorer, a okno o nazwie by target jeszcze nie istnieje, okno zostanie otwarte tylko na tyle długo, aby program Internet Explorer mógł pobrać zasób; zamknie się natychmiast potem.

Podczas tworzenia nowych okien przy użyciu polecenia Open lub OpenNewpowoduje otwarcie nowego wystąpienia programu Internet Explorer przez model obiektów dokumentu HTML. Jeśli nie wywołasz Close wszystkich utworzonych okien, to wystąpienie programu Internet Explorer pozostanie uruchomione nawet po zakończeniu działania aplikacji.

Jeśli użyjesz Open polecenia , aby załadować adres URL w istniejącym oknie, windowOptions zostanie zignorowane. Okno zachowa wymiary, wygląd i lokalizację ekranu po raz pierwszy nadaną jej przez początkowe wywołanie metody Open.

Dotyczy

Open(Uri, String, String, Boolean)

Wyświetla plik w nazwanym oknie.

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

Parametry

url
Uri

Ujednolicony lokalizator zasobów opisujący lokalizację pliku do załadowania.

target
String

Nazwa okna, w którym ma być otwarty zasób. Może to być nazwa podana przez dewelopera lub jedna z następujących wartości specjalnych:

_blank: otwiera się url w nowym oknie. Działa tak samo jak wywołanie metody OpenNew(String, String).

_media: otwiera się url na pasku Multimediów.

_parent: otwiera się url w oknie, które utworzyło bieżące okno.

_search: otwiera się url na pasku wyszukiwania.

_self: otwiera się url w bieżącym oknie.

_top: Jeśli jest wywoływane względem okna należącego do elementu, zostanie otwarte url w oknie hostjącym FRAME jego FRAMESETelement . W przeciwnym razie działa tak samo jak _self.

windowOptions
String

Ciąg rozdzielany przecinkami składający się z zera lub większej liczby poniższych opcji w formularzu name=value. leftZ wyjątkiem opcji , top, heighti width , które przyjmują dowolne liczby całkowite, każda opcja akceptuje yes wartości lub 1, i lub no0jako prawidłowe wartości.

channelmode: używany z przestarzałą technologią kanałów programu Internet Explorer 4.0. Wartość domyślna to no.

directories: określa, czy okno powinno wyświetlać przyciski nawigacji katalogów. Wartość domyślna to yes.

height: wysokość obszaru klienta okna w pikselach. Wartość minimalna to 100; próba otwarcia okna mniejszego niż spowoduje to otwarcie okna zgodnie z ustawieniami domyślnymi programu Internet Explorer.

left: lewa pozycja (współrzędna x) okna względem lewego górnego rogu ekranu użytkownika w pikselach. Musi być dodatnią liczbą całkowitą.

location: określa, czy ma być wyświetlany pasek adresowy, który umożliwia użytkownikom przechodzenie do nowego adresu URL. Wartość domyślna to yes.

menubar: czy mają być wyświetlane menu w nowym oknie. Wartość domyślna to yes.

resizable: określa, czy rozmiar okna może być zmieniany przez użytkownika. Wartość domyślna to yes.

scrollbars: czy okno ma poziome i pionowe paski przewijania. Wartość domyślna to yes.

status: czy okno ma pasek stanu u dołu. Wartość domyślna to yes.

titlebar: określa, czy jest wyświetlany tytuł bieżącej strony. Ustawienie tej opcji no na wartość nie ma wpływu w aplikacji zarządzanej. Pasek tytułu będzie zawsze wyświetlany.

toolbar: czy są widoczne przyciski paska narzędzi, takie jak Wstecz, Prześlij dalej i Zatrzymaj . Wartość domyślna to yes.

top: położenie górnej (współrzędnej y) okna względem lewego górnego rogu ekranu użytkownika w pikselach. Musi być dodatnią liczbą całkowitą.

width: szerokość obszaru klienta okna w pikselach. Minimalna wartość to 100; próby otwarcia okna mniejszego niż spowoduje to otwarcie okna zgodnie z wartościami domyślnymi programu Internet Explorer.

replaceEntry
Boolean

true aby zastąpić adres URL bieżącego okna ciągiem url w historii nawigacji. Wpłynie to na działanie metod w HtmlHistory klasie.

Zwraca

HtmlWindow

Reprezentujące HtmlWindow nowe okno lub wcześniej utworzone okno o nazwie przez target parametr .

Przykłady

Poniższy przykład kodu zawiera dwie metody:

  • Pierwszy otwiera adres URL w oknie o nazwie displayWindow, który zostanie utworzony z wyświetlonym paskiem stanu.
  • Drugi otwiera inny adres URL w tym samym oknie, ale określa, że powinien być wyświetlany tylko pasek lokalizacji.

Zwróć uwagę, że wymiary okna i wyświetlane kontrolki zależą od tego, który adres URL jest otwierany jako pierwszy. Przykładowy kod wymaga, aby formularz zawierał kontrolkę WebBrowser o nazwie 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

Uwagi

Parametr target może nazwać okno, które zostało utworzone w wyniku poprzedniego wywołania metody Open. Parametr może również wskazywać otwarte okno, klikając hiperlink (A element) lub FORM element, który używa atrybutu TARGET do otwarcia adresu URL w nowym oknie. Poniższy kod HTML otworzy nowe okno o nazwie orderWindow po kliknięciu go przez użytkownika:

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

Jeśli podasz jakiekolwiek opcje parametru windowOptions , każda opcja nieuwzględniana jest automatycznie wyłączona. Innymi słowy, jeśli określisz tylko za pomocą windowOptions paska stanu, pasek menu, pasek narzędzi, tytuł, paski przewijania i tak dalej nie będzie wyświetlany, chyba że jawnie włączysz je za pomocą metody windowOptions.

Jeśli plik, url do którego odwołuje się plik HTML, plik tekstowy lub inny typ pliku, który może być hostowany w programie Internet Explorer, zostanie wyświetlony w nazwanym oknie. Jeśli nie można wyświetlić pliku w programie Internet Explorer, a okno o nazwie by target jeszcze nie istnieje, okno zostanie otwarte tylko wystarczająco długo, aby program Internet Explorer mógł pobrać zasób; zamknie się natychmiast potem.

Podczas tworzenia nowych okien przy użyciu programu Open lub OpenNewpowoduje otwarcie nowego wystąpienia programu Internet Explorer przez model obiektów dokumentów HTML. Jeśli nie wywołasz Close wszystkich utworzonych okien, to wystąpienie programu Internet Explorer pozostanie uruchomione nawet po zakończeniu działania aplikacji.

Jeśli używasz polecenia Open do załadowania adresu URL w istniejącym oknie, windowOptions zostanie zignorowane. Okno zachowa wymiary, wygląd i lokalizację ekranu po raz pierwszy nadaną mu przez początkowe wywołanie metody Open.

Zobacz też

Dotyczy