Aracılığıyla paylaş

HtmlWindow.Open Yöntem

  • Başvuru

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

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)

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);
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ükecek 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 FRAMESETbarındıran pencerede açılırurlString. Aksi takdirde, ile aynı şekilde _selfdavranı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 1ve no veya 0kabul ederyes.

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

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

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ışmak, pencerenin Internet Explorer varsayılanlarına göre açılmasına neden olur.

left: Kullanıcının ekranının sol üst köşesine göre piksel cinsinden pencerenin 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. yes varsayılan değerdir.

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

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

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

status: Pencerenin alt kısmında durum çubuğu olup olmadığı. yes varsayılan değerdir.

titlebar: Geçerli sayfanın başlığının görüntülenip görüntülenmeyeceği. Bu seçeneğin no olarak 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ığı. yes varsayılan değerdir.

top: Kullanıcının ekranının sol üst köşesine göre piksel cinsinden pencerenin ü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ışmak, pencerenin Internet Explorer varsayılanlarına göre açılmasına neden olur.

replaceEntry
Boolean

true öğesini seçin urlString . 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 öğesine yapılan önceki bir çağrının Opensonucu olarak oluşturulmuş bir pencereyi adlandırabilir. Parametresi ayrıca bir köprüye (A öğesi) veya url'sini yeni bir pencerede açmak için özniteliğini TARGET kullanan bir FORM öğ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, durum çubuğunu yalnızca bu ş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.

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

veya OpenNewkullanarak Open yeni pencereler oluşturduğunuzda, HTML Belge Nesne Modeli'nin internet explorer'ın yeni bir örneğini açmasına neden olur. Oluşturduğunuz tüm pencerelerde arama Close yapmazsanız, uygulamanız çıktıktan sonra bile bu Internet Explorer örneği çalışır durumda kalır.

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

Şunlara uygulanır

Open(Uri, String, String, Boolean)

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);
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ükecek 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 FRAMESETbarındıran pencerede açılırurl. Aksi takdirde, ile aynı şekilde _selfdavranı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 1ve no veya 0kabul ederyes.

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

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

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ışmak, pencerenin Internet Explorer varsayılanlarına göre açılmasına neden olur.

left: Kullanıcının ekranının sol üst köşesine göre piksel cinsinden pencerenin 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. yes varsayılan değerdir.

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

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

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

status: Pencerenin alt kısmında durum çubuğu olup olmadığı. yes varsayılan değerdir.

titlebar: Geçerli sayfanın başlığının görüntülenip görüntülenmeyeceği. Bu seçeneğin no olarak 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ığı. yes varsayılan değerdir.

top: Kullanıcının ekranının sol üst köşesine göre piksel cinsinden pencerenin ü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ışmak, pencerenin Internet Explorer varsayılanlarına göre açılmasına neden olur.

replaceEntry
Boolean

true öğesini seçin url . Bu, sınıfındaki yöntemlerin HtmlHistory çalışmasını etkiler.

Döndürülenler

HtmlWindow

HtmlWindow Yeni pencereyi veya parametresi tarafından target adlandırılan önceden oluşturulmuş pencereyi temsil eden 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ı WebBrowser1bir denetim içermesini WebBrowser 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 öğesine yapılan önceki bir çağrının Opensonucu olarak oluşturulmuş bir pencereyi adlandırabilir. Parametresi ayrıca bir köprüye (A öğesi) veya url'sini yeni bir pencerede açmak için özniteliğini TARGET kullanan bir FORM öğ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, durum çubuğunu yalnızca bu ş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.

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

veya OpenNewkullanarak Open yeni pencereler oluşturduğunuzda, HTML Belge Nesne Modeli'nin internet explorer'ın yeni bir örneğini açmasına neden olur. Oluşturduğunuz tüm pencerelerde arama Close yapmazsanız, uygulamanız çıktıktan sonra bile bu Internet Explorer örneği çalışır durumda kalır.

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

Ayrıca bkz.

Şunlara uygulanır