## Utiliser les boîtes de dialogues à partir de Scribus

fileDialog(...)
  `fileDialog("titre", ["filtre", "nomDefaut",possedeApercu, estEnregistre])
  -> chaîne avec nom de fichier`

  Affiche une boîte de dialogue Ouvrir un fichier portant le titre "titre". Les fichiers sont filtrés par la chaîne "filtre". Vous pouvez aussi donner un nom de fichier ou un chemin par défaut, mais laissez cette chaîne vide lorsque vous ne voulez pas l'utiliser. Une valeur True pour 'possedeApercu' déclenche l'affichage d'une vue réduire dans la boîte FileSelect. Quand le paramètre estEnregistre est mis à True, le dialogue se comporte comme un dialogue "Enregistrer sous", sinon il se comporte comme un dialogue "Ouvrir". Quand le paramètre 'isdir' a une valeur True, la boîte de dialogue s'ouvre et retourne uniquement les répertoires. La valeur par défaut de tous les paramètres optionnels est False.

  Le filtre, si spécifié, prend la forme 'commentaire (*.type *.type2 ...)'. Par exemple 'Images (*.png *.xpm *.jpg)'.

  Reportez-vous à la documentation de QFileDialog dans Qt pour plus de détails sur les filtres.

  Exemple : fileDialog('Ouvrir', 'CSV files (*.csv)')
  Exemple : fileDialog('Enregistrer le rapport', nomDefaut='report.txt', estEnregistre=True)

getGuiLanguage(...)
  `getGuiLanguage() -> chaîne`

  Retourne une chaîne contenant la valeur de -lang.

messagebarText(...)
  `messagebarText("chaîne")`

  Écrit "chaîne" dans la barre de message de Scribus (ligne d'état). Le texte doit être encodé en UTF8 ou en une chaîne 'unicode' (recommandé).

messageBox(...)
  `messageBox("titre", "message", icone=ICON_NONE, bouton1=BUTTON_OK|BUTTONOPT_DEFAULT, bouton2=BUTTON_NONE, bouton3=BUTTON_NONE) -> nombre entier`

  Affiche une boîte de message contenant le "titre", le message "message", une icône "icone" et jusqu'à 3 boutons. Par défaut, aucune icône n'est utilisée et un seul bouton, OK, est affiché. Seuls les arguments titre et message sont requis, mais on recommande de définir une icône et un ou plusieurs boutons appropriés. Le message texte peut contenir des marqueurs de type HTML simples.

  Retourne le numéro du bouton que l'utilisateur a enfoncé. Les numéros de boutons commencent à 1.

  Pour les paramètres d'icône et de bouton, certaines constantes prédéfinies sont disponibles et portent les mêmes noms que dans la documentation Qt. Ce sont les constantes BUTTON_* et ICON_* définies dans ce module. Il y a également deux constantes supplémentaires qui peuvent être combinées par un OU aux constantes de bouton :

  - BUTTONOPT_DEFAULT - Appuyer sur Entrée enfonce ce bouton.
  - BUTTONOPT_ESCAPE - Appuyer sur Esc enfonce ce bouton.

  Exemples d'utilisation :

      result = messageBox('Le script a échoué', 'Ce script fonctionne seulement lorsqu'un cadre de texte est sélectionné.'
      ICON_ERROR)result = messageBox('Singes!',
      'Quelque chose s'est passé! <i>Était-ce un singe? </i>',
                          ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
                          BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)

  Les constantes de boutons et d'icônes suivantes sont définies : BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO, BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL, ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.

newDocDialog(...)
  `newDocDialog() -> booléen`

  Affiche la boîte dialogue "Nouveau document". Crée un nouveau document si l'utilisateur accepte les paramètres. Ne crée pas de document si l'utilisateur appuie sur Annuler. Retourne la valeur True si un document a été créé.

statusMessage(...)
  `messagebarText("chaîne")`

  Écrit "chaîne" dans la barre de message de Scribus (ligne d'état). Le texte doit être encodé en UTF8 ou en une chaîne 'unicode' (recommandé).

progressReset(...)
  `progressReset()`

  Élimine les réglages précédents de la barre de progression de Scribus. La fonction est appelée avant l'utilisation de la nouvelle barre de progression. Voir progressSet.

progressSet(...)
  `progressSet(nr)`

  Établit la position de la barre de progression à "nr", c'est-à-dire une valeur relative à la valeur précédente de progressTotal. La barre de progression utilise le concept d'étapes; il suffit d'indiquer le nombre total d'étapes et le nombre d'étapes déjà effectuées, puis la fonction affichera le pourcentage d'avancement. Vous pouvez spécifier le nombre total d'étapes avec progressTotal(). Le nombre courant d'étapes est indiqué avec progressSet(). La barre de progression peut être remise à zéro avec progressReset(). [compte tenu de l'information provenant de la documentation QT de Trolltech]

progressTotal(...)
  `progressTotal(max)`

  Établit le nombre maximal d'étapes de la barre de progression au nombre spécifié. Voir progressSet.

valueDialog(...)
  `valueDialog(titre, message [,valeurDefaut]) -> chaîne`

  Affiche la boîte de dialogue "Demande d'une chaîne" et retourne la valeur recherchée sous forme d'une chaîne de paramètres: titre de la fenêtre, texte dans la fenêtre et valeur par "défaut" optionnelle.

  Exemple: valueDialog('titre', 'texte dans la fenêtre', 'optionnel')