HtmlWindow.Open Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Adlandırılmış pencerede bir dosya görüntüler.

Aşırı Yüklemeler

Name	Description
Open(String, String, String, Boolean)	Adlandırılmış pencerede bir dosya görüntüler.
Open(Uri, String, String, Boolean)	Adlandırılmış pencerede bir dosya görüntüler.

Open(String, String, String, Boolean)

Kaynak:

HtmlWindow.cs

Adlandırılmış pencerede bir dosya görüntüler.

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);

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

Parametreler

urlString

String

Yüklenecek dosyanın konumunu açıklayan Tekdüzen Kaynak Bulucu.

target

String

Kaynağın açıldığı pencerenin adı. Bu, geliştirici tarafından sağlanan bir ad veya aşağıdaki özel değerlerden biri olabilir:

_blank: Yeni bir pencerede açılır urlString . çağrısıyla OpenNew(String, String)aynı şekilde çalışır.

_media: Medya çubuğunda açılır urlString .

_parent: Geçerli pencereyi oluşturan pencerede açılır urlString .

_search: Arama çubuğunda açılır urlString .

_self: Geçerli pencerede açılır urlString .

_top: Bir öğeye ait bir pencereye FRAME karşı çağrılırsa, öğesini barındıran urlStringpencerede açılırFRAMESET. Aksi takdirde, ile _selfaynı şekilde davranır.

windowOptions

String

biçimindeki name=valueaşağıdaki seçeneklerden sıfır veya daha fazlasını içeren virgülle ayrılmış bir dize. leftRastgele tamsayılar alan , top, heightve width seçenekleri dışında, her seçenek geçerli değerler olarak veya yesve 1 veya nodeğerlerini kabul eder0.

channelmode: Internet Explorer 4.0'ın kullanım dışı kanallar teknolojisiyle kullanılır. Varsayılan no değeridir.

directories: Pencerenin dizin gezinti düğmelerini görüntüleyip görüntülemeyeceği. Varsayılan yes değeridir.

height: Pencerenin istemci alanının piksel cinsinden yüksekliği. En düşük değer 100'dür; bundan daha küçük bir pencere açmaya çalışırsa, pencere Internet Explorer varsayılan değerlerine göre açılır.

left: Pencerenin, kullanıcı ekranının sol üst köşesine göre piksel cinsinden sol (x koordinatı) konumu. Pozitif bir tamsayı olmalıdır.

location: Kullanıcıların pencerede yeni bir URL'ye gitmelerini sağlayan Adres çubuğunun görüntülenip görüntülenmeyeceği. Varsayılan yes değeridir.

menubar: Menülerin yeni pencerede görüntülenip görüntülenmeyeceği. Varsayılan yes değeridir.

resizable: Pencerenin kullanıcı tarafından yeniden boyutlandırılıp boyutlandırılamayacağı. Varsayılan yes değeridir.

scrollbars: Pencerenin yatay ve dikey kaydırma çubukları olup olmadığı. Varsayılan yes değeridir.

status: Pencerenin altta durum çubuğu olup olmadığı. Varsayılan yes değeridir.

titlebar: Geçerli sayfanın başlığının görüntülenip görüntülenmeyeceği. Bu seçeneğin olarak no ayarlanmasının yönetilen uygulama içinde hiçbir etkisi yoktur; başlık çubuğu her zaman görünür.

toolbar: Geri, İleri ve Durdur gibi araç çubuğu düğmelerinin görünür olup olmadığı. Varsayılan yes değeridir.

top: Pencerenin, kullanıcı ekranının sol üst köşesine göre piksel cinsinden üst (y koordinatı) konumu. Pozitif bir tamsayı olmalıdır.

width: Pencerenin istemci alanının piksel cinsinden genişliği. En düşük değer 100'dür; bundan daha küçük bir pencere açmaya çalışırsa, pencere Internet Explorer varsayılan değerlerine göre açılır.

replaceEntry

Boolean

true gezinti geçmişinde geçerli pencerenin URL'sini ile urlString değiştirmek için. Bu, sınıfındaki yöntemlerin HtmlHistory çalışmasını etkiler.

Döndürülenler

HtmlWindow

Yeni pencere veya parametresi tarafından target adlandırılan önceden oluşturulmuş pencere.

Açıklamalar

parametresi, target önceki bir çağrısının Opensonucu olarak oluşturulan bir pencereyi adlandırabilir. Parametresi ayrıca bir köprüye (A öğe) veya url'sini yeni bir pencerede açmak için özniteliğini FORM kullanan bir TARGET öğeye tıklayarak açılan bir pencereye işaret edebilir. Aşağıdaki HTML kodu, kullanıcı tıkladığında adlı orderWindow yeni bir pencere açar:

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

Parametresi için windowOptions herhangi bir seçenek belirtirseniz, dahil edilmeyen seçenekler otomatik olarak devre dışı bırakılır. Başka bir deyişle, yalnızca durum çubuğunu istediğiniz şekilde windowOptions belirtirseniz, menü çubuğu, araç çubuğu, başlık, kaydırma çubukları vb. ile açıkça etkinleştirmediğiniz windowOptionssürece görüntülenmez.

url tarafından başvuruda bulunılan dosya bir HTML dosyası, metin dosyası veya Internet Explorer içinde barındırılabilir başka bir dosya türüyse, adlandırılmış pencerede görüntülenir. Dosya Internet Explorer içinde görüntülenemiyorsa ve hedef tarafından adlandırılan pencere zaten yoksa, pencere yalnızca Internet Explorer kaynağı indirmesi için yeterince uzun süre açılır; daha sonra hemen kapatılır.

Open veya OpenNew kullanarak yeni pencereler oluşturduğunuzda, HTML Belge Nesne Modeli'nin yeni bir Internet Explorer örneği açmasına neden olur. Oluşturduğunuz tüm pencerelerde Close çağırmazsanız, uygulamanız kapatıldıktan sonra bile bu Internet Explorer örneği çalışmaya devam eder.

Url'yi var olan bir pencereye yüklemek için kullanırsanız Open yoksayılır windowOptions ; pencere, ilk çağrısıyla Openverilen boyutları, görünümü ve ekran konumunu korur.

Open(Uri, String, String, Boolean)

Kaynak:

HtmlWindow.cs

Adlandırılmış pencerede bir dosya görüntüler.

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);

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

Parametreler

url

Uri

Yüklenecek dosyanın konumunu açıklayan Tekdüzen Kaynak Bulucu.

target

String

Kaynağın açıldığı pencerenin adı. Bu, geliştirici tarafından sağlanan bir ad veya aşağıdaki özel değerlerden biri olabilir:

_blank: Yeni bir pencerede açılır url . çağrısıyla OpenNew(String, String)aynı şekilde çalışır.

_media: Medya çubuğunda açılır url .

_parent: Geçerli pencereyi oluşturan pencerede açılır url .

_search: Arama çubuğunda açılır url .

_self: Geçerli pencerede açılır url .

_top: Bir öğeye ait bir pencereye FRAME karşı çağrılırsa, öğesini barındıran urlpencerede açılırFRAMESET. Aksi takdirde, ile _selfaynı şekilde davranır.

windowOptions

String

biçimindeki name=valueaşağıdaki seçeneklerden sıfır veya daha fazlasını içeren virgülle ayrılmış bir dize. leftRastgele tamsayılar alan , top, heightve width seçenekleri dışında, her seçenek geçerli değerler olarak veya yesve 1 veya nodeğerlerini kabul eder0.

channelmode: Internet Explorer 4.0'ın kullanım dışı kanallar teknolojisiyle kullanılır. Varsayılan no değeridir.

directories: Pencerenin dizin gezinti düğmelerini görüntüleyip görüntülemeyeceği. Varsayılan yes değeridir.

height: Pencerenin istemci alanının piksel cinsinden yüksekliği. En düşük değer 100'dür; bundan daha küçük bir pencere açmaya çalışırsa, pencere Internet Explorer varsayılan değerlerine göre açılır.

left: Pencerenin, kullanıcı ekranının sol üst köşesine göre piksel cinsinden sol (x koordinatı) konumu. Pozitif bir tamsayı olmalıdır.

location: Kullanıcıların pencerede yeni bir URL'ye gitmelerini sağlayan Adres çubuğunun görüntülenip görüntülenmeyeceği. Varsayılan yes değeridir.

menubar: Menülerin yeni pencerede görüntülenip görüntülenmeyeceği. Varsayılan yes değeridir.

resizable: Pencerenin kullanıcı tarafından yeniden boyutlandırılıp boyutlandırılamayacağı. Varsayılan yes değeridir.

scrollbars: Pencerenin yatay ve dikey kaydırma çubukları olup olmadığı. Varsayılan yes değeridir.

status: Pencerenin altta durum çubuğu olup olmadığı. Varsayılan yes değeridir.

titlebar: Geçerli sayfanın başlığının görüntülenip görüntülenmeyeceği. Bu seçeneğin olarak no ayarlanmasının yönetilen uygulama içinde hiçbir etkisi yoktur; başlık çubuğu her zaman görünür.

toolbar: Geri, İleri ve Durdur gibi araç çubuğu düğmelerinin görünür olup olmadığı. Varsayılan yes değeridir.

top: Pencerenin, kullanıcı ekranının sol üst köşesine göre piksel cinsinden üst (y koordinatı) konumu. Pozitif bir tamsayı olmalıdır.

width: Pencerenin istemci alanının piksel cinsinden genişliği. En düşük değer 100'dür; bundan daha küçük bir pencere açmaya çalışırsa, pencere Internet Explorer varsayılan değerlerine göre açılır.

replaceEntry

Boolean

true gezinti geçmişinde geçerli pencerenin URL'sini ile url değiştirmek için. Bu, sınıfındaki HtmlHistory yöntemlerin çalışmasını etkiler.

Döndürülenler

HtmlWindow

HtmlWindow Yeni pencereyi veya parametresi tarafından adlandırılan önceden oluşturulmuş pencereyi temsil eden target bir pencere.

Örnekler

Aşağıdaki kod örneği iki yöntem içerir:

• İlki, durum çubuğu görüntülenmiş olarak oluşturduğu adlı displayWindowpencerede bir URL açar.
• İkincisi aynı pencerede başka bir URL açar, ancak yalnızca konum çubuğunun görüntülenmesi gerektiğini belirtir.

Pencerenin boyutlarının ve görüntülenen denetimlerin ilk olarak hangi URL'nin açıldığına bağlı olduğuna dikkat edin. Kod örneği, formunuzun adlı WebBrowserbir WebBrowser1 denetim içermesini gerektirir.

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

Açıklamalar

parametresi, target önceki bir çağrısının Opensonucu olarak oluşturulan bir pencereyi adlandırabilir. Parametresi ayrıca bir köprüye (A öğe) veya url'sini yeni bir pencerede açmak için özniteliğini FORM kullanan bir TARGET öğeye tıklayarak açılan bir pencereye işaret edebilir. Aşağıdaki HTML kodu, kullanıcı tıkladığında adlı orderWindow yeni bir pencere açar:

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

Parametresi için windowOptions herhangi bir seçenek belirtirseniz, dahil edilmeyen seçenekler otomatik olarak devre dışı bırakılır. Başka bir deyişle, yalnızca durum çubuğunu istediğiniz şekilde windowOptions belirtirseniz, menü çubuğu, araç çubuğu, başlık, kaydırma çubukları vb. ile açıkça etkinleştirmediğiniz windowOptionssürece görüntülenmez.

url tarafından başvuruda bulunılan dosya bir HTML dosyası, metin dosyası veya Internet Explorer içinde barındırılabilir başka bir dosya türüyse, adlandırılmış pencerede görüntülenir. Dosya Internet Explorer içinde görüntülenemiyorsa ve hedef tarafından adlandırılan pencere zaten yoksa, pencere yalnızca Internet Explorer kaynağı indirmesi için yeterince uzun süre açılır; daha sonra hemen kapatılır.

Open veya OpenNew kullanarak yeni pencereler oluşturduğunuzda, HTML Belge Nesne Modeli'nin yeni bir Internet Explorer örneği açmasına neden olur. Oluşturduğunuz tüm pencerelerde Close çağırmazsanız, uygulamanız kapatıldıktan sonra bile bu Internet Explorer örneği çalışmaya devam eder.

Url'yi var olan bir pencereye yüklemek için kullanırsanız Open yoksayılır windowOptions ; pencere, ilk çağrısıyla Openverilen boyutları, görünümü ve ekran konumunu korur.

Ayrıca bkz.

• open Yöntemi