PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Caractéristiques de la boîte de dialogue
  • Saut de ligne dans la boîte de dialogue
  • Afficher le dernier message d'erreur rencontré
  • Divers
  • Application en arrière-plan : Spécificité à partir de Android 10
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
Affiche un message d'erreur personnalisé dans une fenêtre d'erreur système.
Message d'erreur
Remarques :
  • Cette fenêtre d'avertissement est bloquante. Pour continuer l'exécution de l'application, l'utilisateur doit cliquer sur le bouton "OK".
    Versions 25 et supérieures
    AndroidiPhone/iPad Pour ne pas bloquer l'application, utilisez la fonction ErreurAsynchrone.
    Nouveauté 25
    AndroidiPhone/iPad Pour ne pas bloquer l'application, utilisez la fonction ErreurAsynchrone.
    AndroidiPhone/iPad Pour ne pas bloquer l'application, utilisez la fonction ErreurAsynchrone.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Nouveauté 16
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Versions 22 et supérieures
AndroidJava La syntaxe 2 est désormais disponible.
Nouveauté 22
AndroidJava La syntaxe 2 est désormais disponible.
AndroidJava La syntaxe 2 est désormais disponible.
Exemple
Windows MobileAndroidiPhone/iPadJavaCode Utilisateur (MCU)
TitreSuivant("Erreur : Client inconnu")
Erreur("Ce code client n'existe pas. Vous devez d'abord le créer")
PHPAjax
Erreur("Vous devez indiquer votre nom.")
Syntaxe

Afficher un message d'erreur personnalisé Masquer les détails

Erreur(<Texte> [, <Ligne 2> [... [, <Ligne n>]]])
<Texte> : Chaîne de caractères (avec guillemets)
Texte à afficher.
<Ligne 2> : Chaînes de caractères optionnelles (avec guillemets)
Texte affiché sur les lignes suivantes.
<Ligne n> : Chaînes de caractères optionnelles (avec guillemets)
Texte affiché sur les lignes suivantes.
Universal Windows 10 AppWindows MobileiPhone/iPadCode Utilisateur (MCU)Ajax

Afficher le message d'erreur de la dernière fonction WLangage utilisée

Erreur()
Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJavaCode Utilisateur (MCU)Ajax

Afficher le message d'erreur de la dernière fonction WLangage utilisée

Erreur()
Remarques

Caractéristiques de la boîte de dialogue

  • Le titre de la boîte de dialogue correspond au titre de la fenêtre (ou page) en cours.
    AndroidiPhone/iPad Pour respecter les spécifications du système, le titre de la boîte de dialogue est vide par défaut. Pour définir ce titre, utilisez la fonction TitreSuivant.
  • Pour modifier ou définir le titre de la boîte de dialogue, utilisez la fonction TitreSuivant.
  • Le message est cadré à gauche.
  • Le libellé du bouton dépend de la langue d'exécution de Windows.
  • Le nombre maximum de caractères affichés est limité à 4096. Si une chaîne plus grande est passée en paramètre, elle sera tronquée.
  • L'icône affichée (croix blanche) ne peut pas être modifiée.

Saut de ligne dans la boîte de dialogue

La chaîne prédéfinie RC (Retour Chariot) peut être utilisée pour forcer le passage à la ligne suivante. Par exemple :
Erreur("Une erreur a été détectée lors de la saisie de l'adresse. " + RC + ...
"Merci de modifier les données concernant le client.")

est équivalent à :
Erreur("Une erreur a été détectée lors de la saisie de l'adresse. ", ...
"Merci de modifier les données concernant le client.")
Il est également possible d'utiliser la syntaxe des chaînes multilignes. Par exemple :
Erreur(
[
Une erreur a été détectée lors de la saisie de l'adresse.
 
Merci de modifier les données concernant le client.
])
Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJavaCode Utilisateur (MCU)Ajax

Afficher le dernier message d'erreur rencontré

L'utilisation de la fonction Erreur sans aucun paramètre (syntaxe 2) permet d'afficher directement le message d'erreur correspondant à la dernière fonction WLangage ayant déclenché une erreur.
Dans ce cas, le code suivant :
Erreur()
est équivalent à :
Erreur(ErreurInfo())
Attention : La fonction Erreur doit être utilisée immédiatement après l'appel à la fonction qui a échoué. En effet, l'appel à une fonction du WLangage peut ré-initialiser et modifier le compte-rendu de Erreur.

Divers

  • Les timers (fonction TimerSys) ne sont pas stoppés lors de l'appel de cette fonction.
  • Windows MobileJava La fonction DélaiAvantFermeture limite le temps d'affichage de toutes les boîtes de dialogue. La boîte de dialogue est automatiquement fermée. Pour les boîtes de question ou de confirmation, la réponse attendue correspond au bouton par défaut.
  • Le libellé du bouton s'affiche dans la langue utilisée par Windows sur le poste en cours.
  • iPhone/iPad Cette fonction ne doit pas être utilisée :
    • dans l'événement "Modification de la taille" des fenêtres. Dans le cas contraire, l'application sera bloquée.
    • dans l'événement "Changement d'orientation" des fenêtres.
    • dans l'événement "Mise au premier-plan" associé au projet.
      Remarque : La fonction peut par contre être utilisée dans l'événement "Mise au premier plan" d'une fenêtre.
    • dans un thread.
Versions 25 et supérieures
Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction Erreur peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Nouveauté 25
Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction Erreur peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction Erreur peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Classification Métier / UI : Code UI
Composante : wd260obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire