WEBBROWSER

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple

Gestion du contrôle Web browser, y compris la navigation.

Support WebVue - Non. Renvoie un code d'erreur si exécuté dans ce contexte.

Mode

Mnémonique

Syntaxe

Support WebVue

1 NAVIGATE 1 Non
2 BACK 2 Non
3 FORWARD 2 Non
4 REFRESH 2 Non
5 GETSOURCEINFO 3 Non
6 PRINTTOPDF 4 Non
7 OPENDEVTOOLS 2 Non
8 CLEAR 5 Non
10 SNAPSHOT 6 Non
11 EXECUTESCRIPT 7 Non
12 LOADCONTENT 8 Non
13 MUTE 5 Non
14 ENABLENAVIGATION 5 Non
15 GETZOOMFACTOR 2 Non
16 SETZOOMFACTOR 9 Non
17 SETTRACE 10 Non

 

Propriétés communes à plusieurs modes

Argument

Définition

Window Nom de la fenêtre qui contient le contrôle Web browser. Type STR.
Branch Branche (si elle existe) de la fenêtre. Utiliser "*" pour indiquer la branche courante du programme. Type STR.
Identity Identifiant du contrôle Web browser dans la fenêtre spécifiée. Type STR.

Syntaxe 1

LongVal = WEBBROWSER(Mode, Window, Branch, Identity, Uri);

Type de retour : LONG

Argument

Définition

Uri

Identifiant uniforme de ressource. Tapez STR.
Exemples : https://example.com, file://C:\MyFolder\MyFile.pdf ou file://MyFile. df
La syntaxe du système de fichiers avec un chemin absolu ou relatif est également supportée, par exemple C:/MyFolder/MyFile. df
Si le chemin est relatif, il est relatif au dossier TP.

Exécution

Mode

Mnémonique

Action

1

NAVIGATE Charge et affiche le contenu correspondant à l'Uri.
Retour : 1 si OK, 0 sinon.

Syntaxe 2

LongVal = WEBBROWSER(Mode, Window, Branch, Identity);

Type de retour : LONG.

Exécution

Mode

Mnémonique

Action

2

BACK Navigue vers la page précédente dans l'historique de navigation.
Retour : 1 si OK, 0 sinon.
3 FORWARD Navigue vers la page suivante dans l'historique de navigation.
Retour : 1 si OK, 0 sinon.
4 REFRESH Recharge le document de niveau supérieur actuel.
Retour : 1 si OK, 0 sinon.
7 OPENDEVTOOLS Ouvre les outils de développement.
Retour : 1 si OK, 0 sinon.
15 GETZOOMFACTOR Renvoie le facteur de zoom actuel en pourcentage. Plage 25 à 500.
Le facteur de zoom par défaut est de 100 (100%).

Syntaxe 3

StrVal = WEBBROWSER(Mode, Window, Branch, Identity[, Info]);

Type de retour : STR.

Argument

Définition

Info

Type d'information à retourner. Type INTEGER.
0 pour l'Uri du contenu (par défaut)
1 pour le titre du document

Exécution

Mode

Mnémonique

Action

5 GETSOURCEINFO Retourne l'information demandée si OK, une chaîne vide sinon.

Syntaxe 4

LongVal = WEBBROWSER(Mode, Window, Branch, Identity, Filename [, Overwrite]);

Type de retour : LONG

Argument

Définition

Filename Nom du fichier Pdf à imprimer. Type STR.
Overwrite

Flag pour écraser le fichier s'il existe déjà. Type INTEGER

0 - Ne pas écraser (par défaut)

1 - Ecraser

Exécution

Mode

Mnémonique

Action

6

PRINTTOPDF

Imprime le contenu dans un fichier Pdf en utilisant les paramètres de l'imprimante par défaut.
Retour : Toujours 1.

Syntaxe 5

LongVal = WEBBROWSER(Mode, Window, Branch, Identity[, Action]);

Type de retour : LONG.

Argument

Définition

Action Flag. Voir ci-dessous pour plus de détails en fonction du mode. 0 par défaut. Type INTEGER

Exécution

Mode

Mnémonique

Action

8

CLEAR

Efface les données de navigation
Action = 0 - Vide le cache
Action = 1 - Vide les cookies
Retour : 1 si OK, 0 sinon.

13 MUTE Désactive ou active le son
Action = 0 - Désactive le son
Action = 1 - Active le son
Retour : 1 si OK, 0 sinon.
14 ENABLENAVIGATION Active ou désactive la navigation
Action = 0 - Désactive la navigation
Action = 1 - Active la navigation
Retour : 1 si OK, 0 sinon.
Le dossier cache et données utilisateur est commun à toutes les instances du contrôle Web browser pour une installation donnée du logiciel PcVue. Effacer le cache ou supprimer les cookies dans une instance du Web browser affectera toutes les instances.

Syntaxe 6

LongVal = WEBBROWSER(Mode, Window, Branch, Identity, Filename);

Type de retour : LONG

Argument

Définition

Filename

Nom du fichier. Si le nom du fichier est relatif, il est relatif au dossier TP du projet. Type STR.

Exécution

Mode

Mnémonique

Action

10 SNAPSHOT Prend une capture d'écran du contenu du contrôle Web browser et l'enregistre sous forme d'image jpg dans un fichier nommé Filename.
Retour : 1 si OK, 0 sinon.

Syntaxe 7

LongVal = WEBBROWSER(Mode, Window, Branch, Identity, Script);

Type de retour : LONG

Argument

Définition

Script Une chaîne de caractères contenant un fragment de JavaScript inline. Type STR.
Par exemple : "document.body.style.backgroundcolor = 'salmon'".

Exécution

Mode

Mnémonique

Action

11

EXECUTESCRIPT

Exécute le JavaScript Script.
Retour : 1 si OK, 0 sinon.

Syntaxe 8

LongVal = WEBBROWSER(Mode, Window, Branch, Identity, Content);  

Type de retour : LONG.

Argument

Définition

Content Contenu Web à afficher. Type STR.

Exécution

Mode

Mnémonique

Action

12

LOADCONTENT

Charge et affiche le contenu web passé avec l'argument Content.
Retour : 1 si OK, 0 sinon.

Syntaxe 9

LongVal = WEBBROWSER(Mode, Window, Branch, Identity, ZoomFactor);

Type de retour : LONG.

Argument

Définition

ZoomFactor Le facteur de zoom du navigateur en pourcentage. Plage 25 à 500. Type INTEGER.
Le facteur de zoom par défaut est 100 (100%).

Exécution

Mode

Mnémonique

Action

16

SETZOOMFACTOR

Définit le facteur de zoom du navigateur.
Retour : 1 si OK, 0 sinon.

Syntaxe 10

LongVal = WEBBROWSER(Mode, Window, Branch, Identity, Level);

Type de retour : LONG

Argument

Définition

Level Niveau de trace. Type INTEGER

Exécution

Mode

Mnémonique

Action

17

SETTRACE

Définit dynamiquement le niveau de trace du contrôle Web browser.
0 – Aucune trace
1 – Traces configurées
2 – Mode Verbeux
Retour : 1 si OK, 0 sinon.

Exemple

Pour un exemple, sélectionnez le lien Exemple ci-dessus.