HtmlWindow.Open Metodo

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

Parametri

Restituisce

Nuova finestra o finestra creata in precedenza denominata dal target parametro .

Commenti

Il target parametro può assegnare un nome a una finestra creata come risultato di una chiamata precedente a Open. Il parametro può anche puntare a una finestra aperta facendo clic su un collegamento ipertestuale (A elemento) o un FORM elemento che usa l'attributo per aprire il TARGET relativo URL in una nuova finestra. Il codice HTML seguente aprirà una nuova finestra denominata orderWindow quando l'utente lo fa clic:

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

Se si specificano opzioni per il windowOptions parametro, qualsiasi opzione non inclusa viene disabilitata automaticamente. In altre parole, se si specifica solo in base alla quale si vuole una barra di windowOptions stato, la barra dei menu, la barra degli strumenti, il titolo, le barre di scorrimento e così via non verrà visualizzata a meno che non vengano abilitate in modo esplicito tramite windowOptions.

Se il file a cui fa riferimento url è un file HTML, un file di testo o un altro tipo di file che può essere ospitato all'interno di Internet Explorer, verrà visualizzato nella finestra denominata. Se il file non può essere visualizzato all'interno di Internet Explorer e la finestra denominata per destinazione non esiste già, la finestra aprirà solo a lungo per Internet Explorer per scaricare la risorsa; verrà chiuso immediatamente dopo.

Quando si creano nuove finestre usando Open o OpenNew, viene generato il modello a oggetti documento HTML per aprire una nuova istanza di Internet Explorer. Se non si chiama Close su tutte le finestre create, questa istanza di Internet Explorer rimarrà in esecuzione anche dopo la chiusura dell'applicazione.

Se si usa Open per caricare un URL in una finestra esistente, verrà ignorato; la finestra manterrà le dimensioni, windowOptions l'aspetto e la posizione della schermata prima data dalla chiamata iniziale a Open.

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

Parametri

Restituisce

Oggetto HtmlWindow che rappresenta la nuova finestra oppure la finestra creata precedentemente specificata dal parametro target.

Esempio

L'esempio di codice seguente contiene due metodi:

• Il primo apre un URL in una finestra denominata displayWindow, che crea con una barra di stato visualizzata.
• Il secondo apre un altro URL nella stessa finestra, ma specifica che deve essere visualizzata solo la barra della posizione.

Si noti che le dimensioni della finestra e i controlli visualizzati dipendono innanzitutto dall'URL aperto. L'esempio di codice richiede che il modulo contenga un WebBrowser controllo denominato 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

Commenti

Il target parametro può assegnare un nome a una finestra creata come risultato di una chiamata precedente a Open. Il parametro può anche puntare a una finestra aperta facendo clic su un collegamento ipertestuale (A elemento) o un FORM elemento che usa l'attributo per aprire il TARGET relativo URL in una nuova finestra. Il codice HTML seguente aprirà una nuova finestra denominata orderWindow quando l'utente lo fa clic:

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

Se si specificano opzioni per il windowOptions parametro, qualsiasi opzione non inclusa viene disabilitata automaticamente. In altre parole, se si specifica solo in base alla quale si vuole una barra di windowOptions stato, la barra dei menu, la barra degli strumenti, il titolo, le barre di scorrimento e così via non verrà visualizzata a meno che non vengano abilitate in modo esplicito tramite windowOptions.

Se il file a cui fa riferimento url è un file HTML, un file di testo o un altro tipo di file che può essere ospitato all'interno di Internet Explorer, verrà visualizzato nella finestra denominata. Se il file non può essere visualizzato all'interno di Internet Explorer e la finestra denominata per destinazione non esiste già, la finestra aprirà solo a lungo per Internet Explorer per scaricare la risorsa; verrà chiuso immediatamente dopo.

Quando si creano nuove finestre usando Open o OpenNew, viene generato il modello a oggetti documento HTML per aprire una nuova istanza di Internet Explorer. Se non si chiama Close su tutte le finestre create, questa istanza di Internet Explorer rimarrà in esecuzione anche dopo la chiusura dell'applicazione.

Se si usa Open per caricare un URL in una finestra esistente, verrà ignorato; la finestra manterrà le dimensioni, windowOptions l'aspetto e la posizione della schermata prima data dalla chiamata iniziale a Open.

Vedi anche

• open, metodo