SHDocVw.IWebBrowser.Navigate

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure Navigate(const URL: WideString; const Flags: OleVariant;  const TargetFrameName: OleVariant; const PostData: OleVariant; const Headers: OleVariant); safecall;

C++

virtual HRESULT __safecall Navigate(const System::WideString URL, const System::OleVariant &Flags, const System::OleVariant &TargetFrameName, const System::OleVariant &PostData, const System::OleVariant &Headers) = 0 ;

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
SHDocVw.pas
SHDocVw.hpp
SHDocVw IWebBrowser

Description

La méthode Navigate va sur une ressource identifiée par un chemin d'accès ou une URL.

Utilisez la méthode Navigate pour trouver une ressource spécifique et la télécharger. La méthode Navigate peut envoyer un message HTTP à l'URL spécifiée et afficher le résultat ou afficher simplement le résultat d'un fichier spécifié.

URL spécifie le nom de chemin UNC d'un fichier ou le localisateur uniforme de ressources d'une ressource Internet que le navigateur Web doit afficher.

Flags est un ensemble de valeurs qui spécifient s'il faut ajouter la ressource à l'historique, s'il faut lire depuis ou écrire dans le cache et s'il faut afficher la ressource dans une nouvelle fenêtre. Il peut être la somme de zéro ou plusieurs des valeurs suivantes.



Constante Valeur Signification

navOpenInNewWindow

1

Ouvre la ressource ou le fichier dans une nouvelle fenêtre.

navNoHistory

2

N'ajoute pas la ressource ou le fichier à la liste d'historique La nouvelle page remplace la page actuelle dans la liste.

navNoReadFromCache

4

Ne lit pas depuis le cache disque pour ce déplacement.

navNoWriteToCache

8

N'écrit pas les résultats de ce déplacement dans le cache disque.

navAllowAutosearch

16

Si la navigation échoue, le navigateur Web tente de se positionner en utilisant les domaines racine courants (.com, .edu, etc.). Si ceci échoue encore, l'URL est transmise au moteur de recherche.



TargetFrameName est le nom du cadre dans lequel afficher la ressource ou NULL si la ressource ne doit pas être affichée dans un cadre nommé.

PostData contient les données envoyées au serveur quand la méthode Navigate est utilisée pour générer un message HTTP POST. Si PostData contient NULL, Navigate génère un message HTTP GET. PostData n'est pas pris en compte si URL ne spécifie par une URL HTTP.

Headers contient tous les en-têtes envoyés aux serveurs quand l'URL représente une URL HTTP. Les en-têtes HTTP spécifient l'action qui est demandée au serveur, le type de données, etc. Voir l'objet TWebRequest dont les propriétés représentent la plupart des en-têtes courants.

Remarque :  Pour aller à un emplacement qui ne peut être spécifié par une URL (par exemple une liste d'identificateurs d'éléments), utilisez la méthode Navigate2.

Voir aussi