HtmlWindow.Open Metodo

  • Riferimento

Definizione

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

Visualizza un file nella finestra specificata.

Overload

Open(String, String, String, Boolean)

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

Visualizza un file nella finestra specificata.

Open(String, String, String, Boolean)

Visualizza un file nella finestra specificata.

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

urlString
String

URL che descrive il percorso del file da caricare.

target
String

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

_blank: apre urlString in una nuova finestra. È equivalente a una chiamata al metodo OpenNew(String, String).

_media: si apre urlString nella barra dei supporti.

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

_search: si apre urlString nella barra di ricerca.

_self: apre urlString nella finestra corrente.

_top: se viene chiamato su una finestra appartenente a un FRAME elemento, viene visualizzata 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, ewidth, che accettano interi arbitrari, ogni opzione accetta yes o 1, e no0, 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 valore minimo è 100. Se si tenta di aprire una finestra più piccola, quest'ultima verrà aperta usando le impostazioni predefinite di Internet Explorer.

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

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

menubar: se nella nuova finestra devono essere visualizzati i menu. Il valore predefinito è yes.

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

scrollbars: indica se la finestra ha barre di scorrimento orizzontale e verticale. 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 non no ha alcun effetto all'interno di un'applicazione gestita. Verrà sempre visualizzata la barra del titolo.

toolbar: se i pulsanti della barra degli strumenti, ad esempio Back, Forward e Stop sono visibili. Il valore predefinito è yes.

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

width: larghezza dell'area client della finestra, in pixel. Il valore minimo è 100. Se si tenta di aprire una finestra più piccola, quest'ultima verrà aperta usando le impostazioni predefinite di Internet Explorer.

replaceEntry
Boolean

true per sostituire l'URL della finestra corrente con urlString nella cronologia di spostamento. Questa impostazione influirà sul funzionamento dei metodi sulla classe HtmlHistory.

Restituisce

HtmlWindow

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.

Si applica a

Open(Uri, String, String, Boolean)

Visualizza un file nella finestra specificata.

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

url
Uri

URL che descrive il percorso del file da caricare.

target
String

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

_blank: apre url in una nuova finestra. È equivalente a una chiamata al metodo OpenNew(String, String).

_media: si apre url nella barra dei supporti.

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

_search: si apre url nella barra di ricerca.

_self: apre url nella finestra corrente.

_top: se viene chiamato su una finestra appartenente a un FRAME elemento, viene visualizzata 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, ewidth, che accettano interi arbitrari, ogni opzione accetta yes o 1, e no0, 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 valore minimo è 100. Se si tenta di aprire una finestra più piccola, quest'ultima verrà aperta usando le impostazioni predefinite di Internet Explorer.

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

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

menubar: se nella nuova finestra devono essere visualizzati i menu. Il valore predefinito è yes.

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

scrollbars: indica se la finestra ha barre di scorrimento orizzontale e verticale. 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 non no ha alcun effetto all'interno di un'applicazione gestita. Verrà sempre visualizzata la barra del titolo.

toolbar: se i pulsanti della barra degli strumenti, ad esempio Back, Forward e Stop sono visibili. Il valore predefinito è yes.

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

width: larghezza dell'area client della finestra, in pixel. Il valore minimo è 100. Se si tenta di aprire una finestra più piccola, quest'ultima verrà aperta usando le impostazioni predefinite di Internet Explorer.

replaceEntry
Boolean

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

Restituisce

HtmlWindow

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

Si applica a