PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Conseil : optimisez la taille de vos fichiers HTML
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
ChangeDestination (Fonction)
En anglais : ChangeTarget
Change la destination de l'action d'un bouton.
Par défaut, la destination est défini dans l'onglet "Général" du bouton exécuté ou de la page en cours.
Attention : La fonction ChangeDestination peut être utilisée directement uniquement dans le traitement navigateur qui correspond à l'action serveur du champ :
  • code de clic navigateur pour un champ Bouton, Lien ou Image.
  • code "A chaque modification" pour les champs Sélecteur, Interrupteur, Liste ou Combo.
La fonction ChangeDestination n'a aucun effet dans les autres traitements navigateur ou dans une procédure locale navigateur même si cette procédure est appelée par un des traitements ci-dessus.
Exemple
// -- Code navigateur de clic du champ Bouton
// La destination du bouton définie dans la fenêtre de description (cadre courant)
ChangeDestination(NavigateurEnCours)
 
// -- Code serveur de clic du champ Bouton
SI VérifieNomUtilisateur(SAI_NomUtilisateur) = Faux ALORS
// Réactualise la page PAGE_Identification
PageActualise(PAGE_Identification)
SINON
// Affiche la page de bienvenue
PageAffiche(PAGE_Bienvenue)
FIN
Syntaxe
ChangeDestination(<Destination> [, <Nom de la fenêtre> [, <Options> [, <Largeur> [, <Hauteur> [, <Position horizontale> [, <Position verticale> [, <Paramètres Javascript>]]]]]]])
<Destination> : Chaîne de caractères ou constante
Nom de la frame de destination ou alias du champ iFrame destination.
<Destination> peut également prendre les valeurs suivantes :
NouveauNavigateurLa destination est un nouveau navigateur (une nouvelle fenêtre de navigateur est ouverte). Les paramètres suivants de la fonction ChangeDestination permettent de paramétrer la fenêtre du navigateur.
Ce paramètre peut également correspondre à la chaîne "_blank" (compatibilité avec WEBDEV 1.5).
FrameParentLa destination est le conteneur de la page en cours (frameset parent, navigateur parent).
Ce paramètre peut également correspondre à la chaîne "_parent" (compatibilité avec WEBDEV 1.5).
FrameEnCoursLa destination est le cadre en cours (valeur par défaut)
Ce paramètre peut également correspondre à la chaîne "_self" (compatibilité avec WEBDEV 1.5).
NavigateurEnCoursLa destination est le navigateur en cours.
Ce paramètre peut également correspondre à la chaîne "_top" (compatibilité avec WEBDEV 1.5).
<Nom de la fenêtre> : : Chaîne de caractères optionnelle
Nom de la fenêtre du nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur (ou "_blank"). Ce paramètre permet de réafficher une page dans un navigateur portant le même nom (si plusieurs navigateurs sont ouverts sur le poste de l'internaute). Ce nom est un nom unique (équivalent au nom d'une variable Javascript).
Attention : Ce nom ne doit contenir ni espace, ni caractères accentués, ni caractères spéciaux.
<Options> : Constante ou combinaison de constantes de type entier (optionnelle)
Paramètres de la fenêtre du nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur (ou "_blank") :
ONAdresseLa barre d'adresse sera affichée
ONAscenseurLes barres de défilement seront affichées
ONComplet
(Valeur par défaut)
La fenêtre du nouveau navigateur sera complète (équivalent à la combinaison de toutes les constantes précédentes)
ONDimensionLa fenêtre du nouveau navigateur sera redimensionnable
ONLienLa barre des liens sera affichée
ONMenuLa barre de menu sera affichée
ONMessageLa barre de message sera affichée
ONOutilsLa barre d'outils sera affichée
ONSimpleLa fenêtre du nouveau navigateur sera minimale (aucune combinaison de constantes).
<Largeur> : Entier optionnel
Largeur en pixels de la fenêtre du nouveau navigateur.
<Hauteur> : Entier optionnel
Hauteur en pixels de la fenêtre du nouveau navigateur.
<Position horizontale> : Entier optionnel
Position horizontale en pixels de la fenêtre du nouveau navigateur (par rapport au coin haut gauche de l'écran).
<Position verticale> : Entier optionnel
Position verticale en pixels de la fenêtre du nouveau navigateur (par rapport au coin haut gauche de l'écran).
<Paramètres Javascript> : Chaîne de caractères optionnelle
Autres paramètres Javascript à utiliser lors de l'ouverture d'un nouveau navigateur si <Destination> est égal à la constante NouveauNavigateur (ou "_blank").
Remarques

Conseil : optimisez la taille de vos fichiers HTML

Pour les fonctions PageAffiche, PageSemiDynamiqueAffiche, SiteDynamiqueAffiche et FichierAffiche, il est conseillé de changer directement la destination dans ces fonctions. En effet, le code Javascript correspondant inclus dans les fichiers HTML est plus petit.
Composante : WDJS.DLL
Version minimum requise
  • Version 9
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire