PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

PV

  • 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 pendant un délai défini. Lorsque le délai est écoulé, la fenêtre système se ferme automatiquement.
Remarques :
  • Cette fenêtre d'avertissement est bloquante tant que le délai n'est pas écoulé. Pour continuer l'exécution de l'application, l'utilisateur doit cliquer sur le bouton "OK".
    WINDEVAndroid Pour ne pas bloquer l'application, utilisez la fonction ErreurAvecDélaiAsynchrone.
  • WINDEV WINDEV permet d'appliquer le gabarit de votre projet à cette boîte de dialogue. Pour plus de détails, consultez Personnaliser les boîtes de dialogue.
Nouveauté 28
Android Cette fonction est désormais disponible pour les applications Android.
Java Cette fonction est désormais disponible pour les applications Java.
Exemple
// Affiche "Une erreur a été détectée" dans une fenêtre d'erreur
// Cette fenêtre d'erreur se fermera automatiquement après 10 secondes.
ErreurAvecDélai(1000, "Une erreur a été détectée")
// Affiche la dernière erreur dans une fenêtre d'erreur
// Cette fenêtre d'erreur se fermera automatiquement après 5 secondes.
ErreurAvecDélai(500)
Syntaxe

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

ErreurAvecDélai(<Délai> , <Texte> [, <Ligne 2> [... [, <Ligne n>]]])
<Délai> : Entier ou Durée
Délai (exprimé en centièmes de seconde) avant la fermeture automatique de la fenêtre d'erreur. Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de centièmes de seconde,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 s ou 10 ms).
<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.

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

ErreurAvecDélai(<Délai avant fermeture>)
<Délai avant fermeture> : Entier ou Durée
Délai (exprimé en centièmes de seconde) avant la fermeture automatique de la fenêtre d'erreur. Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de centièmes de seconde,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 s ou 10 ms).
Remarques

Caractéristiques de la boîte de dialogue

  • Le titre de la boîte de dialogue correspond au titre de la fenêtre en cours. Pour modifier ce titre, 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.
Pour personnaliser cette boîte de dialogue (ainsi que toutes les boîtes de dialogue système de votre application), cochez l'option "Personnaliser les fenêtres système (Info, OuiNon, Confirmer, Dialogue)" dans l'onglet "Style" de la description du projet. Pour plus de détails, consultez Personnaliser les boîtes de dialogue.

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 :
ErreurAvecDélai(500, "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 à :
ErreurAvecDélai(500, "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 :
ErreurAvecDélai(500,
[
Une erreur a été détectée lors de la saisie de l'adresse.
 
Merci de modifier les données concernant le client.
])

Afficher le dernier message d'erreur rencontré

L'utilisation de la fonction ErreurAvecDélai en précisant uniquement le délai (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 :
ErreurAvecDélai(500)

est équivalent à :
ErreurAvecDélai(500, ErreurInfo())
Attention : La fonction ErreurAvecDélai 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 la fonction ErreurAvecDélai.

Divers

  • Les timers (fonction TimerSys) ne sont pas stoppés lors de l'appel de cette fonction.
  • Les événements Windows ne sont pas stoppés lors de l'appel à cette fonction.
  • Le libellé du bouton s'affiche dans la langue utilisée par Windows sur le poste en cours.
  • Equivalence : La fonction ErreurAvecDélai est équivalente à la fonction Erreur utilisée avec la fonction DélaiAvantFermeture :
    Le code suivant :
    ErreurAvecDélai(1000, "Une erreur a été détectée")

    est équivalent à :
    DélaiAvantFermeture(1000)
    Erreur("Une erreur a été détectée")
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 ErreurAvecDélai 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 : wd280obj.dll
Version minimum requise
  • Version 18
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire