HtmlWindow.Open Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Visualizza un file nella finestra denominata.

Overload

Nome Descrizione
Open(String, String, String, Boolean)

Visualizza un file nella finestra denominata.
Open(Uri, String, String, Boolean)

Visualizza un file nella finestra denominata.

Open(String, String, String, Boolean)

Visualizza un file nella finestra denominata.

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

Parametri

urlString
String

Uniform Resource Locator che descrive il percorso del file da caricare.

target
String

Nome della finestra in cui aprire la risorsa. Può trattarsi di un nome fornito dallo sviluppatore o di uno dei valori speciali seguenti:

_blank: si apre urlString in una nuova finestra. Funziona come una chiamata a OpenNew(String, String).

_media: si apre urlString nella barra multimediale.

_parent: apre urlString nella finestra che ha creato la finestra corrente.

_search: si apre urlString nella barra di ricerca.

_self: si apre urlString nella finestra corrente.

_top: se viene chiamato su una finestra appartenente a un FRAME elemento, viene aperta urlString nella finestra che ospita il relativo FRAMESEToggetto . In caso contrario, agisce come _self.

windowOptions
String

Stringa delimitata da virgole costituita da zero o più delle opzioni seguenti nel formato name=value. Ad eccezione delle leftopzioni , heighttop, e width , che accettano numeri interi arbitrari, ogni opzione accetta yes o 1, e no o 0, come valori validi.

channelmode: usato con la tecnologia dei canali deprecati di Internet Explorer 4.0. Il valore predefinito è no.

directories: indica se la finestra deve visualizzare i pulsanti di spostamento della directory. Il valore predefinito è yes.

height: altezza in pixel dell'area client della finestra. Il minimo è 100; tenta di aprire una finestra più piccola di questa causerà l'apertura della finestra in base alle impostazioni predefinite Internet Explorer.

left: posizione sinistra (coordinata x) della finestra, rispetto all'angolo superiore sinistro dello schermo dell'utente, in pixel. Deve essere un intero positivo.

location: indica se visualizzare la barra degli indirizzi, che consente agli utenti di spostarsi nella finestra in un nuovo URL. Il valore predefinito è yes.

menubar: indica se visualizzare i menu nella nuova finestra. Il valore predefinito è yes.

resizable: indica se la finestra può essere ridimensionata dall'utente. Il valore predefinito è yes.

scrollbars: indica se la finestra dispone di barre di scorrimento orizzontali e verticali. Il valore predefinito è yes.

status: indica se la finestra ha una barra di stato nella parte inferiore. Il valore predefinito è yes.

titlebar: indica se viene visualizzato il titolo della pagina corrente. L'impostazione di questa opzione su no non ha alcun effetto all'interno di un'applicazione gestita. La barra del titolo verrà sempre visualizzata.

toolbar: indica se i pulsanti della barra degli strumenti, ad esempio Indietro, Avanti e Arresta sono visibili. Il valore predefinito è yes.

top: posizione superiore (coordinata y) della finestra, in pixel rispetto all'angolo superiore sinistro dello schermo dell'utente. Deve essere un intero positivo.

width: larghezza in pixel dell'area client della finestra. Il minimo è 100; tenta di aprire una finestra più piccola di questa causerà l'apertura della finestra in base alle impostazioni predefinite Internet Explorer.

replaceEntry
Boolean

true per sostituire l'URL della finestra corrente con urlString nella cronologia di navigazione. In questo modo verrà applicata l'operazione dei metodi nella HtmlHistory classe .

Valori restituiti

HtmlWindow

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

Commenti

Il target parametro può denominare 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 tramite che si desidera una barra di windowOptions stato, la barra dei menu, la barra degli strumenti, il titolo, le barre di scorrimento e così via non verranno visualizzate 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 si aprirà solo a lungo per Internet Explorer per scaricare la risorsa. Verrà chiusa immediatamente dopo.

Quando si creano nuove finestre usando Open o OpenNew, il modello a oggetti documento HTML apre una nuova istanza di Internet Explorer. Se non si chiama Close in 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, windowOptions la finestra manterrà le dimensioni, l'aspetto e la posizione dello schermo prima assegnata dalla chiamata iniziale a Open.

Si applica a

Open(Uri, String, String, Boolean)

Visualizza un file nella finestra denominata.

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

Parametri

url
Uri

Uniform Resource Locator che descrive il percorso del file da caricare.

target
String

Nome della finestra in cui aprire la risorsa. Può trattarsi di un nome fornito dallo sviluppatore o di uno dei valori speciali seguenti:

_blank: si apre url in una nuova finestra. Funziona come una chiamata a OpenNew(String, String).

_media: si apre url nella barra multimediale.

_parent: apre url nella finestra che ha creato la finestra corrente.

_search: si apre url nella barra di ricerca.

_self: si apre url nella finestra corrente.

_top: se viene chiamato su una finestra appartenente a un FRAME elemento, viene aperta url nella finestra che ospita il relativo FRAMESEToggetto . In caso contrario, agisce come _self.

windowOptions
String

Stringa delimitata da virgole costituita da zero o più delle opzioni seguenti nel formato name=value. Ad eccezione delle leftopzioni , heighttop, e width , che accettano numeri interi arbitrari, ogni opzione accetta yes o 1, e no o 0, come valori validi.

channelmode: usato con la tecnologia dei canali deprecati di Internet Explorer 4.0. Il valore predefinito è no.

directories: indica se la finestra deve visualizzare i pulsanti di spostamento della directory. Il valore predefinito è yes.

height: altezza in pixel dell'area client della finestra. Il minimo è 100; tenta di aprire una finestra più piccola di questa causerà l'apertura della finestra in base alle impostazioni predefinite Internet Explorer.

left: posizione sinistra (coordinata x) della finestra, rispetto all'angolo superiore sinistro dello schermo dell'utente, in pixel. Deve essere un intero positivo.

location: indica se visualizzare la barra degli indirizzi, che consente agli utenti di spostarsi nella finestra in un nuovo URL. Il valore predefinito è yes.

menubar: indica se visualizzare i menu nella nuova finestra. Il valore predefinito è yes.

resizable: indica se la finestra può essere ridimensionata dall'utente. Il valore predefinito è yes.

scrollbars: indica se la finestra dispone di barre di scorrimento orizzontali e verticali. Il valore predefinito è yes.

status: indica se la finestra ha una barra di stato nella parte inferiore. Il valore predefinito è yes.

titlebar: indica se viene visualizzato il titolo della pagina corrente. L'impostazione di questa opzione su no non ha alcun effetto all'interno di un'applicazione gestita. La barra del titolo verrà sempre visualizzata.

toolbar: indica se i pulsanti della barra degli strumenti, ad esempio Indietro, Avanti e Arresta sono visibili. Il valore predefinito è yes.

top: posizione superiore (coordinata y) della finestra, in pixel rispetto all'angolo superiore sinistro dello schermo dell'utente. Deve essere un intero positivo.

width: larghezza in pixel dell'area client della finestra. Il minimo è 100; tenta di aprire una finestra più piccola di questa causerà l'apertura della finestra in base alle impostazioni predefinite Internet Explorer.

replaceEntry
Boolean

true per sostituire l'URL della finestra corrente con url nella cronologia di navigazione. Ciò influirà sull'operazione dei metodi nella HtmlHistory classe .

Valori restituiti

HtmlWindow

Oggetto HtmlWindow che rappresenta la nuova finestra o la finestra creata in precedenza denominata dal target parametro .

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 di posizione.

Si noti che le dimensioni della finestra e i controlli visualizzati dipendono dall'URL aperto per primo. 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ò denominare 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 tramite che si desidera una barra di windowOptions stato, la barra dei menu, la barra degli strumenti, il titolo, le barre di scorrimento e così via non verranno visualizzate 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 si aprirà solo a lungo per Internet Explorer per scaricare la risorsa. Verrà chiusa immediatamente dopo.

Quando si creano nuove finestre usando Open o OpenNew, il modello a oggetti documento HTML apre una nuova istanza di Internet Explorer. Se non si chiama Close in 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, windowOptions la finestra manterrà le dimensioni, l'aspetto e la posizione dello schermo prima assegnata dalla chiamata iniziale a Open.

Vedi anche

Si applica a