HtmlWindow.Open Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wyświetla plik w nazwanym oknie.
Przeciążenia
| Nazwa | Opis |
|---|---|
| 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)
- Źródło:
- HtmlWindow.cs
- Źródło:
- HtmlWindow.cs
- Źródło:
- HtmlWindow.cs
- Źródło:
- HtmlWindow.cs
- Źródło:
- HtmlWindow.cs
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
Lokalizator jednolitych 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: W przypadku wywołania względem okna należącego do elementu zostanie otwarte FRAME w oknie hostjącym urlString element FRAMESET. 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, heightiwidth, 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żywane z przestarzałą technologią kanałów Internet Explorer 4.0. Wartość domyślna to no.
directories: 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óby otwarcia okna mniejszego niż spowoduje to otwarcie okna zgodnie z ustawieniami domyślnymi Internet Explorer.
left: Lewa pozycja (współrzędna x) okna w stosunku do lewego górnego rogu ekranu użytkownika w pikselach. Musi być dodatnią liczbą całkowitą.
location: 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: czy można zmienić rozmiar okna 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: czy jest wyświetlany tytuł bieżącej strony. Ustawienie tej opcji no nie ma wpływu na aplikację zarządzaną. Pasek tytułu będzie zawsze wyświetlany.
toolbar: czy są widoczne przyciski paska narzędzi, takie jak Wstecz, Do przodu 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óby otwarcia okna mniejszego niż spowoduje to otwarcie okna zgodnie z ustawieniami domyślnymi 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
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 do otwarcia adresu URL w nowym oknie. Następujący 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 pasek windowOptions stanu, pasek menu, pasek narzędzi, tytuł, paski przewijania i tak dalej nie będą wyświetlane, chyba że jawnie włączysz je za pomocą polecenia windowOptions.
Jeśli plik, do którego odwołuje się url, jest plikiem HTML, plikiem tekstowym lub innym typem pliku, który może być hostowany wewnątrz Internet Explorer, zostanie wyświetlony w nazwanym oknie. Jeśli nie można wyświetlić pliku wewnątrz Internet Explorer, a okno o nazwie by target jeszcze nie istnieje, okno zostanie otwarte tylko wystarczająco długo, aby Internet Explorer pobrać zasób. Zostanie ono zamknięte natychmiast później.
Podczas tworzenia nowych okien przy użyciu Open lub OpenNew powoduje otwarcie nowego wystąpienia Internet Explorer przez model obiektów dokumentów HTML. Jeśli nie wywołasz Close we wszystkich utworzonych oknach, to wystąpienie Internet Explorer pozostanie uruchomione nawet po zakończeniu działania aplikacji.
Jeśli używasz Open metody do załadowania adresu 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)
- Źródło:
- HtmlWindow.cs
- Źródło:
- HtmlWindow.cs
- Źródło:
- HtmlWindow.cs
- Źródło:
- HtmlWindow.cs
- Źródło:
- HtmlWindow.cs
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
Lokalizator jednolitych 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 specjalnych wartości:
_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: W przypadku wywołania względem okna należącego do elementu zostanie otwarte FRAME w oknie hostjącym url element FRAMESET. 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, heightiwidth, 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żywane z przestarzałą technologią kanałów Internet Explorer 4.0. Wartość domyślna to no.
directories: 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óby otwarcia okna mniejszego niż spowoduje to otwarcie okna zgodnie z ustawieniami domyślnymi Internet Explorer.
left: Lewa pozycja (współrzędna x) okna w stosunku do lewego górnego rogu ekranu użytkownika w pikselach. Musi być dodatnią liczbą całkowitą.
location: 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: czy można zmienić rozmiar okna 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: czy jest wyświetlany tytuł bieżącej strony. Ustawienie tej opcji no nie ma wpływu na aplikację zarządzaną. Pasek tytułu będzie zawsze wyświetlany.
toolbar: czy są widoczne przyciski paska narzędzi, takie jak Wstecz, Do przodu 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óby otwarcia okna mniejszego niż spowoduje to otwarcie okna zgodnie z ustawieniami domyślnymi Internet Explorer.
- replaceEntry
- Boolean
true aby zastąpić adres URL bieżącego okna ciągiem url w historii nawigacji. Będzie to miało wpływ na działanie metod w HtmlHistory klasie.
Zwraca
Reprezentujące HtmlWindow nowe okno lub utworzone wcześniej okno o nazwie parametru target .
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 kolejny 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. Następujący 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 pasek windowOptions stanu, pasek menu, pasek narzędzi, tytuł, paski przewijania i tak dalej nie będą wyświetlane, chyba że jawnie włączysz je za pomocą polecenia windowOptions.
Jeśli plik, do którego odwołuje się url, jest plikiem HTML, plikiem tekstowym lub innym typem pliku, który może być hostowany wewnątrz Internet Explorer, zostanie wyświetlony w nazwanym oknie. Jeśli nie można wyświetlić pliku wewnątrz Internet Explorer, a okno o nazwie by target jeszcze nie istnieje, okno zostanie otwarte tylko wystarczająco długo, aby Internet Explorer pobrać zasób. Zostanie ono zamknięte natychmiast później.
Podczas tworzenia nowych okien przy użyciu Open lub OpenNew powoduje otwarcie nowego wystąpienia Internet Explorer przez model obiektów dokumentów HTML. Jeśli nie wywołasz Close we wszystkich utworzonych oknach, to wystąpienie Internet Explorer pozostanie uruchomione nawet po zakończeniu działania aplikacji.
Jeśli używasz Open metody do załadowania adresu 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.