DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Boîtes de dialogue
  • 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 WatchMac CatalystUniversal Windows 10 App
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".
    AndroidiPhone/iPad Pour ne pas bloquer l'application, utilisez la fonction ErreurAsynchrone.
Exemple
AndroidiPhone/iPad
TitreSuivant("Erreur : Client inconnu")
Erreur("Ce code client n'existe pas. Vous devez d'abord le créer")
Syntaxe

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

Erreur(<Texte> [, <Ligne 2> [... [, <Ligne n>]]])
<Texte> : Chaîne de caractères
Texte à afficher.
<Ligne 2> : Chaîne de caractères optionnelle
Texte affiché sur la seconde ligne.
<Ligne n> : Chaîne de caractères optionnelle
Texte affiché sur la Nième ligne.
Universal Windows 10 AppAndroidiPhone/iPad

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 AppAndroidiPhone/iPad

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.
  • 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.
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 : wd290obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 27/02/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale