WebGadget()

Syntaxe

Resultat = WebGadget(#Gadget, x, y, Largeur, Hauteur, URL$ [, Options])

Crée un WebGadget (Navigateur Internet) dans la GadgetList. Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. #Gadget est le numéro du gadget renvoyé par la fonction EventGadget(). x et y représentent la position du WebGadget dans la fenêtre, Largeur et Hauteur, ses dimensions.

Le paramètre facultatif 'Options' peut être une combinaison des constantes suivantes:

  #PB_Web_Mozilla: Utilise l'ActiveX Mozilla à la place de IE (Windows seulement).

This function fails if the required components for the WebGadget cannot be loaded. See below for the requirements for the WebGadget on each OS.

Remarks

The following components are required to use the WebGadget on each OS. These components are required to use the WebGadget, not only for the compilation of the program.

Windows

Sur Microsoft Windows, ce gadget utilise l'object ActiveX Internet Explorer 4.0+. IE 4.0 ou plus se doit d'être présent sur le système (déjà présent sur Win98/Me et Win2000/XP). Si IE n'est pas présent, WebGadget renvoie 0. Le fichier ATL.dll, présent dans le répertoire PureBasic\Compilers\ est nécessaire (à mettre dans le même répertoire que l'exécutable).

omme alternative, l'ActiveX Mozilla peut être utilisée à la place d'Internet Explorer (http://www.iol.ie/~locka/mozilla/mozilla.htm) si l'option #PB_Web_Mozilla est spécifiée (l'ActiveX Mozilla doit être installée séparément car elle n'est pas fournie avec FireFox ou la suite Mozilla). Le fichier ATL.dll est aussi nécessaire.

Linux

The WebGadget uses the WebKitGtk library on Linux. The package with this library is named 'libwebkit'. Some distributions may include an old version of this package which is named 'WebKitGtk'. If your distribution does not include a package for this library, the sources can be downloaded from the WebKitGtk home page.

Mac OSX

The WebGadget uses the WebKit component on Mac OSX. This component comes with the operating system. There are no further requirements.

- SetGadgetText(): Change l'URL.
- GetGadgetText(): Renvoie l'URL actuelle.
- SetGadgetState(): Effectue une action sur le gadget. 'Etat' peut prendre une des valeurs suivantes:

  #PB_Web_Back   : Retour en arrière dans la navigation.
  #PB_Web_Forward: Avance d'un pas dans la navigation.
  #PB_Web_Stop   : Arrête le chargement de la page.
  #PB_Web_Refresh: Recharge la page actuelle.

Note: Les fonctionnalités suivantes ne fonctionnent pas avec l'ActiveX Mozilla sur windows (option #PB_Web_Mozilla)

- SetGadgetItemText(): avec #PB_Web_HtmlCode comme 'Element' le code html peut être inséré dans le Gadget.
- GetGadgetItemText(): Les constantes suivantes peuvent être utilisées pour obtenir une information:

  #PB_Web_HtmlCode     : Renvoie le code html du gadget.
  #PB_Web_PageTitle    : Renvoie le titre de la page affichée.
  #PB_Web_StatusMessage: Renvoie le message actuel de la barre d'état.
  #PB_Web_SelectedText : Renvoie le texte sélectionné à l'intérieur du gadget.

- SetGadgetAttribute(): Définit les attributs suivants:

  #PB_Web_ScrollX       : Fixe la position de la barre de défilement horizontale .
  #PB_Web_ScrollY       : Fixe la position de la barre de défilement verticale.
  #PB_Web_BlockPopups   : Bloque les fenêtres popup(Valeur=1 pour bloquer et 0 pour débloquer). #PB_EventType_PopupWindow est renvoyé si cet attribut est validé. 
  #PB_Web_BlockPopupMenu: Bloque le menu popup standard. #PB_EventType_PopupMenu est renvoyé si cet attribut est validé.
  #PB_Web_NavigationCallback: Définit une callback pour contrôler (et désactiver) la navigation.

La callback de la navigation doit avoir le format suivant :

  Procedure NavigationCallback(Gadget, Url$)
    ;
    ; Renvoie #True pour autoriser cette navigation ou #False pour la refuser.
    ;
    ProcedureReturn #True
  EndProcedure

- GetGadgetAttribute(): Pour obtenir les attributs suivants :

  #PB_Web_ScrollX       : Renvoie la position de la barre de défilement horizontale.
  #PB_Web_ScrollY       : Renvoie la position de la barre de défilement verticale.
  #PB_Web_Busy          : Renvoie une valeur différente de zéro si le gadget est occupé à charger une page.
  #PB_Web_Progress      : Renvoie la progression actuelle (parfois estimé) après un évènement #PB_EventType_DownloadProgress.
  #PB_Web_ProgressMax   : Renvoie la progression actuelle maximum (parfois estimé) après un évènement #PB_EventType_DownloadProgress .
  #PB_Web_BlockPopups   : Renvoie la valeur actuelle de l'attribut de blocage des fenêtres popup.
  #PB_Web_BlockPopupMenu: Renvoie la valeur actuelle de l'attribut de blocage du menu popup.
  #PB_Web_NavigationCallback: Renvoie la valeur actuelle de la callback (si elle existe).

Notes: Les fenêtres popups et les menus popups ne sont pas supportés pour le WebGadget sous Linux. Cependant, le #PB_Web_BlockPopups peut encore être défini pour activer l'évènement #PB_EventType_PopupWindow. La même chose s'applique à #PB_Web_BlockPopupMenu.

Les évènements suivants sont supportés par EventType() pour ce gadget:

  #PB_EventType_TitleChange     : Le titre de la page a changé.
  #PB_EventType_StatusChange    : Le message de la barre d'état a changé.
  #PB_EventType_DownloadStart   : Le téléchargement d'une page a commencé.
  #PB_EventType_DownloadProgress: L'information de progression du téléchargement est disponible avec GetGadgetAttribute().
  #PB_EventType_DownloadEnd     : Le téléchargement d'une page s'est terminé (fini ou annulé).
  #PB_EventType_PopupWindow     : Une fenêtre popup vient d'être bloquée.
  #PB_EventType_PopupMenu       : Le menu popup vient d'être bloqué (utile pour afficher un menu personnalisé).

Exemple

  If OpenWindow(0,0,0,600,300,"WebGadget",#PB_Window_SystemMenu|#PB_Window_ScreenCentered) 
    WebGadget(0,10,10,580,280,"http://www.purebasic.com")
    ; Note: si vous désirez utiliser un fichier local, changez le dernier paramètre en "file://" + chemin + nomdufichier
    Repeat 
    Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

OS Supportés

Tous