Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
logiciel:programmation:python:boa:help:aideboa [2020/10/24 16:18] adminlogiciel:programmation:python:boa:help:aideboa [2022/08/13 22:27] (Version actuelle) – modification externe 127.0.0.1
Ligne 1: Ligne 1:
 ====== Guide de démarrage pour Boa Constructor ====== ====== Guide de démarrage pour Boa Constructor ======
  
-====== Installation et présentation de Boa constructor ======+===== Installation et présentation de Boa constructor =====
  
 Boa s'exécute sous Windows ou sous UNIX avec GTK+. Boa s'exécute sous Windows ou sous UNIX avec GTK+.
Ligne 7: Ligne 7:
 Téléchargement : [[http://sourceforge.net/projects/boa-constructor/files/Boa-Constructor/]] Téléchargement : [[http://sourceforge.net/projects/boa-constructor/files/Boa-Constructor/]]
  
-===== Pré-requis =====+==== Pré-requis ====
  
 Il faut avoir installé : Il faut avoir installé :
Ligne 19: Ligne 19:
 Le programme d'installation standard pour Windows installe les bibliothèques **wxWidgets** et l'environnement **wxPython**. Le programme d'installation standard pour Windows installe les bibliothèques **wxWidgets** et l'environnement **wxPython**.
  
-===== Installation =====+==== Installation ====
  
-==== Sous Windows ====+=== Sous Windows ===
  
 Deux possibilités : Deux possibilités :
Ligne 27: Ligne 27:
   * ou à partir du fichier source zip de Boa : l'extraire dans un répertoire (par exemple ..\site-packages\boa) et créer sur le bureau un raccourci vers le fichier boa.py. Pour lancer Boa, double-cliquer sur ce raccourci.   * ou à partir du fichier source zip de Boa : l'extraire dans un répertoire (par exemple ..\site-packages\boa) et créer sur le bureau un raccourci vers le fichier boa.py. Pour lancer Boa, double-cliquer sur ce raccourci.
  
-==== Sous UNIX ====+=== Sous UNIX ===
  
   * installer le paquet **Boa**   * installer le paquet **Boa**
Ligne 35: Ligne 35:
     * Dans le shell, lancer boa avec la commande <code>boa.py</code>     * Dans le shell, lancer boa avec la commande <code>boa.py</code>
  
-==== A partir de CVS ====+=== A partir de CVS ===
  
 Voir le guide d'installation de Boa [[http://wiki.wxpython.org/BoaInstallGuide]] sur la page wiki de wxPython. Voir le guide d'installation de Boa [[http://wiki.wxpython.org/BoaInstallGuide]] sur la page wiki de wxPython.
  
-===== Présentation de l'EDI Boa =====+==== Présentation de l'EDI Boa ====
  
 Quand on le lance, l'EDI affiche ceci  : Quand on le lance, l'EDI affiche ceci  :
Ligne 59: Ligne 59:
     * **Explorateur** - permet de naviguer dans le système de fichiers, donne accès à la démo wxPython (via un plug-in), permet de modifier les préférences de Boa, et il y aura des onglets supplémentaires, un pour chaque fichier sur lequel on travaille.     * **Explorateur** - permet de naviguer dans le système de fichiers, donne accès à la démo wxPython (via un plug-in), permet de modifier les préférences de Boa, et il y aura des onglets supplémentaires, un pour chaque fichier sur lequel on travaille.
  
-===== La fenêtre de la palette =====+==== La fenêtre de la palette ====
  
 C'est la fenêtre principale du programme Boa : sa fermeture termine le programme. C'est la fenêtre principale du programme Boa : sa fermeture termine le programme.
Ligne 69: Ligne 69:
 {{logiciel:programmation:python:boa:help:boa2.png?800|}} {{logiciel:programmation:python:boa:help:boa2.png?800|}}
  
-==== La barre d'outils et ses icônes ====+=== La barre d'outils et ses icônes ===
  
 La barre d'outils permet d'accéder aux autres fenêtres de Boa. En survolant les différentes icônes avec la souris, des bulles d'aide expliquent ce que font les boutons. La barre d'outils permet d'accéder aux autres fenêtres de Boa. En survolant les différentes icônes avec la souris, des bulles d'aide expliquent ce que font les boutons.
Ligne 89: Ligne 89:
   - aide de Python   - aide de Python
  
-==== Les onglets ====+=== Les onglets ===
  
 Les onglets fournissent des composants regroupés logiquement, pour construire les applications. Les onglets fournissent des composants regroupés logiquement, pour construire les applications.
Ligne 103: Ligne 103:
 Boa ouvre le code source de la nouvelle application et le nouveau formulaire dans la fenêtre de l'éditeur. Boa ouvre le code source de la nouvelle application et le nouveau formulaire dans la fenêtre de l'éditeur.
  
-===== La fenêtre de l'éditeur =====+==== La fenêtre de l'éditeur ====
  
 C'est l'une des trois fenêtres de Boa. Si on la ferme, on peut la rouvrir avec le bouton {{logiciel:programmation:python:boa:help:editoricon.png|palette - icône éditeur}} de la palette. C'est l'une des trois fenêtres de Boa. Si on la ferme, on peut la rouvrir avec le bouton {{logiciel:programmation:python:boa:help:editoricon.png|palette - icône éditeur}} de la palette.
Ligne 190: Ligne 190:
   * <key>ALT-O</key> (uniquement disponible avec le plug-in ErrOutShortcut) montre le notebook avec les tracebacks, sorties, les erreurs et onglets Tâches ou s'il est visible, il le cache.   * <key>ALT-O</key> (uniquement disponible avec le plug-in ErrOutShortcut) montre le notebook avec les tracebacks, sorties, les erreurs et onglets Tâches ou s'il est visible, il le cache.
  
-===== La fenêtre de l'éditeur graphique =====+==== La fenêtre de l'éditeur graphique ====
  
 On accède à la fenêtre de l'Éditeur graphique par le bouton Éditeur graphique {{logiciel:programmation:python:boa:help:designer.jpg|Éditeur graphique}} sur la barre d'outils de la fenêtre de l'éditeur. L'éditeur graphique ne peut être démarré que si le fichier actif est un formulaire (wx.Panel, wx.Frame etc) ou un fichier de type Dialog. On accède à la fenêtre de l'Éditeur graphique par le bouton Éditeur graphique {{logiciel:programmation:python:boa:help:designer.jpg|Éditeur graphique}} sur la barre d'outils de la fenêtre de l'éditeur. L'éditeur graphique ne peut être démarré que si le fichier actif est un formulaire (wx.Panel, wx.Frame etc) ou un fichier de type Dialog.
Ligne 212: Ligne 212:
 <note>Vous pourriez déposer les contrôles de l'onglet Divers (données), sur l'onglet Affichage des données et pour tout conteneur de type sizer (onglet conteneurs / Mise en page), sur la vue Sizer.</note> <note>Vous pourriez déposer les contrôles de l'onglet Divers (données), sur l'onglet Affichage des données et pour tout conteneur de type sizer (onglet conteneurs / Mise en page), sur la vue Sizer.</note>
  
-===== La fenêtre Inspecteur de propriétés =====+==== La fenêtre Inspecteur de propriétés ====
  
 L'Inspecteur affiche toujours la configuration du composant actuellement sélectionné. L'Inspecteur contient 4 pages, la page du constructeur ('Constr'), la page Propriétés ('Props'), la page Événements ('Evts') et la Page objets ('Objs'). L'Inspecteur affiche toujours la configuration du composant actuellement sélectionné. L'Inspecteur contient 4 pages, la page du constructeur ('Constr'), la page Propriétés ('Props'), la page Événements ('Evts') et la Page objets ('Objs').
Ligne 221: Ligne 221:
 |{{logiciel:programmation:python:boa:help:boa5d.png|Inspecteur - Objets}}|La page ** Objets** permet de naviguer à travers les composants dans un autre format pour le volet de l'éditeur graphique. C'est particulièrement utile pour des éléments invisibles ou qui se chevauchent. Certains composants comme le wxStatusBar ne traitent pas les événements de clic (sur MSW) : il faut donc les choisir dans la page des Objets.| |{{logiciel:programmation:python:boa:help:boa5d.png|Inspecteur - Objets}}|La page ** Objets** permet de naviguer à travers les composants dans un autre format pour le volet de l'éditeur graphique. C'est particulièrement utile pour des éléments invisibles ou qui se chevauchent. Certains composants comme le wxStatusBar ne traitent pas les événements de clic (sur MSW) : il faut donc les choisir dans la page des Objets.|
  
-===== Gestion de l'application =====+==== Gestion de l'application ====
  
 Quand le module en cours d'édition est une application, l'éditeur offre une vue spéciale de l'application. Cette vue application permet de suivre facilement les fichiers dans l'application et d'ajouter de nouveaux modules, dialogues et autres types de fichiers à la demande. Quand le module en cours d'édition est une application, l'éditeur offre une vue spéciale de l'application. Cette vue application permet de suivre facilement les fichiers dans l'application et d'ajouter de nouveaux modules, dialogues et autres types de fichiers à la demande.
Ligne 237: Ligne 237:
 <note>Le Panel1 répertorié comme un module ci-dessus n'est pas le même que le Panel1 contenu dans Frame1 !</note> <note>Le Panel1 répertorié comme un module ci-dessus n'est pas le même que le Panel1 contenu dans Frame1 !</note>
  
-===== A propos de l'utilisation de l'explorateur =====+==== A propos de l'utilisation de l'explorateur ====
  
 La deuxième page de l'éditeur notebook contient une page appelée l'Explorateur. On utilise cette page pour trouver les différentes sources de données, y compris le système de fichiers, CVS, Zope, WebDAV, comptes SSH, FTP. La deuxième page de l'éditeur notebook contient une page appelée l'Explorateur. On utilise cette page pour trouver les différentes sources de données, y compris le système de fichiers, CVS, Zope, WebDAV, comptes SSH, FTP.
Ligne 255: Ligne 255:
 <note>La démo de wxPython s'affiche dans l'Explorateur comme cela a été activé par le Plug-ins.</note> <note>La démo de wxPython s'affiche dans l'Explorateur comme cela a été activé par le Plug-ins.</note>
  
-===== Utilisation de l'aide =====+==== Utilisation de l'aide ====
  
 L'EDI Boa fournit des liens vers différents fichiers d'aide de l'EDI. L'EDI Boa fournit des liens vers différents fichiers d'aide de l'EDI.
Ligne 292: Ligne 292:
     * Ou envoyer la question à [[wxPython-users@lists.wxwidgets.org]] si elle n'est pas spécifique à Boa     * Ou envoyer la question à [[wxPython-users@lists.wxwidgets.org]] si elle n'est pas spécifique à Boa
  
-====== Tutoriel - Créer votre première application ======+===== Tutoriel - Créer votre première application =====
  
 Cette section présente un bref didacticiel pour familiariser avec l'EDI Boa constructor. Ce tutoriel guide étape par étape à travers le processus de construction d'un éditeur de texte simple, appelé Notebook. Après avoir travaillé ce tutoriel, on ensait assez pour être productif avec Boa Constructor. Cette section présente un bref didacticiel pour familiariser avec l'EDI Boa constructor. Ce tutoriel guide étape par étape à travers le processus de construction d'un éditeur de texte simple, appelé Notebook. Après avoir travaillé ce tutoriel, on ensait assez pour être productif avec Boa Constructor.
Ligne 305: Ligne 305:
   * Concevoir des boîtes de dialogue.   * Concevoir des boîtes de dialogue.
  
-===== Création d'une nouvelle application =====+==== Création d'une nouvelle application ====
  
   * Décider d'un répertoire destiné à contenir l'application. Si nécessaire, créer le répertoire.   * Décider d'un répertoire destiné à contenir l'application. Si nécessaire, créer le répertoire.
Ligne 325: Ligne 325:
 Un clic sur le bouton de lancement (jaune) montre le résultat de la programmation, c'est-à-dire juste un cadre vide. Un clic sur le bouton de lancement (jaune) montre le résultat de la programmation, c'est-à-dire juste un cadre vide.
  
-===== Utilisation de l'éditeur graphique pour mettre le titre =====+==== Utilisation de l'éditeur graphique pour mettre le titre ====
  
   * Sélectionner l'onglet Frame1 dans l'éditeur pour s'assurer que nous éditons le cadre.   * Sélectionner l'onglet Frame1 dans l'éditeur pour s'assurer que nous éditons le cadre.
Ligne 340: Ligne 340:
   * L'éditeur indique que le code source est modifié par des astérisques sur l'onglet Bloc-notes, il faut donc appuyer sur le bouton Enregistrer.   * L'éditeur indique que le code source est modifié par des astérisques sur l'onglet Bloc-notes, il faut donc appuyer sur le bouton Enregistrer.
  
-===== Ajouter une barre d'état =====+==== Ajouter une barre d'état ====
  
 Le premier composant que nous allons ajouter à l'application sera une barre d'état. Une barre d'état donne des informations sur un programme lors de son exécution. Nous allons utiliser la barre d'état pour indiquer à l'utilisateur ce qui se passe lorsque des actions lentes se produisent, de donner des messages d'aide simples ou toute autre information à montrer. Le premier composant que nous allons ajouter à l'application sera une barre d'état. Une barre d'état donne des informations sur un programme lors de son exécution. Nous allons utiliser la barre d'état pour indiquer à l'utilisateur ce qui se passe lorsque des actions lentes se produisent, de donner des messages d'aide simples ou toute autre information à montrer.
Ligne 376: Ligne 376:
   * Enregistrer les modifications du code source en utilisant le bouton Enregistrer de la barre d'outils de l'éditeur.   * Enregistrer les modifications du code source en utilisant le bouton Enregistrer de la barre d'outils de l'éditeur.
  
-===== Ajouter une barre de menus =====+==== Ajouter une barre de menus ====
  
 La composante suivante que nous allons ajouter à l'application est une barre de menus, un élément courant pour les programmes Windows. Notre barre de menu contiendra deux entrées, Fichier et Aide. La sélection de l'une d'elles va afficher un menu déroulant dans lequel l'utilisateur peut sélectionner une option. La composante suivante que nous allons ajouter à l'application est une barre de menus, un élément courant pour les programmes Windows. Notre barre de menu contiendra deux entrées, Fichier et Aide. La sélection de l'une d'elles va afficher un menu déroulant dans lequel l'utilisateur peut sélectionner une option.
Ligne 434: Ligne 434:
 {{logiciel:programmation:python:boa:help:boa24e.png|Frame1}} {{logiciel:programmation:python:boa:help:boa24e.png|Frame1}}
  
-===== Ajout du contrôle texte =====+==== Ajout du contrôle texte ====
  
 Nous allons maintenant ajouter un contrôle texte pour l'édition à notre cadre. Ce contrôle est appelé wx.TextCtrl. Nous allons maintenant ajouter un contrôle texte pour l'édition à notre cadre. Ce contrôle est appelé wx.TextCtrl.
Ligne 462: Ligne 462:
   * Il y a également la fonctionnalité couper / coller et le marquage par défaut à la souris.   * Il y a également la fonctionnalité couper / coller et le marquage par défaut à la souris.
  
-===== Ajout de fonctionnalités au menu Fichier =====+==== Ajout de fonctionnalités au menu Fichier ====
  
 La tâche suivante consiste à interagir avec l'utilisateur pour implémenter les fonctionnalités du menu. Les boîtes de dialogue sont utilisées pour recueillir l'entrée de l'utilisateur. Les boîtes de dialogue sont modales, c'est à dire qu'on ne peut pas utiliser les autres fenêtres de l'application en cours jusqu'à ce que le dialogue soit fermé. La tâche suivante consiste à interagir avec l'utilisateur pour implémenter les fonctionnalités du menu. Les boîtes de dialogue sont utilisées pour recueillir l'entrée de l'utilisateur. Les boîtes de dialogue sont modales, c'est à dire qu'on ne peut pas utiliser les autres fenêtres de l'application en cours jusqu'à ce que le dialogue soit fermé.
Ligne 567: Ligne 567:
 {{logiciel:programmation:python:boa:help:boa26.png?800|Éditeur}} {{logiciel:programmation:python:boa:help:boa26.png?800|Éditeur}}
  
-===== Créer une fenêtre de dialogue =====+==== Créer une fenêtre de dialogue ====
  
 Les boîtes de dialogue sont utilisées pour interagir avec l'utilisateur et récupérer des entrées spécifiques. Dans les sections précédentes, nous avons utilisé la boîte de dialogue pré-intégrée wx.FileDialog. Nous allons maintenant développer notre propre boîte de dialogue pour l'option A propos du menu. Les boîtes de dialogue sont utilisées pour interagir avec l'utilisateur et récupérer des entrées spécifiques. Dans les sections précédentes, nous avons utilisé la boîte de dialogue pré-intégrée wx.FileDialog. Nous allons maintenant développer notre propre boîte de dialogue pour l'option A propos du menu.
Ligne 627: Ligne 627:
   * Concevez vos propres boîtes de dialogue.   * Concevez vos propres boîtes de dialogue.
  
-===== Création d'une fenêtre d'application en utilisant sizers =====+==== Création d'une fenêtre d'application en utilisant sizers ====
  
 **Sizers** est un excellent moyen d'obtenir une configuration graphique agréable et propre. C'est pratique quand on ignore l'espace dont a besoin un contrôle ou celui qu'il peut utiliser (c'est par exemple le cas quand on internationalise une application (I18N) ou pour des contrôles comme les listes ou les grilles auxquels on veut donner autant d'espace que possible (ou au contraire aussi peu d'espace que possible). **Sizers** est un excellent moyen d'obtenir une configuration graphique agréable et propre. C'est pratique quand on ignore l'espace dont a besoin un contrôle ou celui qu'il peut utiliser (c'est par exemple le cas quand on internationalise une application (I18N) ou pour des contrôles comme les listes ou les grilles auxquels on veut donner autant d'espace que possible (ou au contraire aussi peu d'espace que possible).
Ligne 705: Ligne 705:
 For coding guide lines you might also want to consult the wxPython style guide  [[http://wiki.wxpython.org/index.cgi/wxPython_Style_Guide]]. For coding guide lines you might also want to consult the wxPython style guide  [[http://wiki.wxpython.org/index.cgi/wxPython_Style_Guide]].
  
-====== Other Useful Items ======+===== Other Useful Items =====
  
-===== Setting Preferences =====+==== Setting Preferences ====
  
 The Boa Constructor tool provides a number of features which can be customised by you. The Boa Constructor tool provides a number of features which can be customised by you.
Ligne 719: Ligne 719:
 |{{logiciel:programmation:python:boa:help:boa31b.png|General}}|{{logiciel:programmation:python:boa:help:boa31c.png|Platform}}|{{logiciel:programmation:python:boa:help:boa31d.png|Key bindings}}| |{{logiciel:programmation:python:boa:help:boa31b.png|General}}|{{logiciel:programmation:python:boa:help:boa31c.png|Platform}}|{{logiciel:programmation:python:boa:help:boa31d.png|Key bindings}}|
  
-==== Help books ====+=== Help books ===
  
 Boa by default includs its help books and the ones for wxPython and Python. Boa by default includs its help books and the ones for wxPython and Python.
Ligne 727: Ligne 727:
 {{logiciel:programmation:python:boa:help:boa31e.png|Help book}} {{logiciel:programmation:python:boa:help:boa31e.png|Help book}}
  
-==== Bookmarks ====+=== Bookmarks ===
  
 If you like to add additional bookmarks just right mouse click on the folder you like to add within the Explorer. If you like to add additional bookmarks just right mouse click on the folder you like to add within the Explorer.
  
-==== Transport ====+=== Transport ===
  
 Adding additional transports works similar to the bookmarks, select the transport type on the left hand side of the Explorer view, e.g. 'Zope' and then right mouse click in the right hand side and select 'New' and then complete the information in the Inspector. Adding additional transports works similar to the bookmarks, select the transport type on the left hand side of the Explorer view, e.g. 'Zope' and then right mouse click in the right hand side and select 'New' and then complete the information in the Inspector.
Ligne 737: Ligne 737:
 {{logiciel:programmation:python:boa:help:boa31f.png|Transport}} {{logiciel:programmation:python:boa:help:boa31f.png|Transport}}
  
-==== Module Info ====+=== Module Info ===
  
 You might want to change the following section in the file 'prefs.rc' stored in your user preference directory, on a Windows system this is by default in 'driveletter:\Documents and Settings\username\.boa-constructor'. You might want to change the following section in the file 'prefs.rc' stored in your user preference directory, on a Windows system this is by default in 'driveletter:\Documents and Settings\username\.boa-constructor'.
Ligne 809: Ligne 809:
 </code> </code>
  
-====== Main frames ======+===== Main frames =====
  
 These are the main frames in Boa: These are the main frames in Boa:
Ligne 821: Ligne 821:
 |Help|Boa, wxWidgets & Python help.| |Help|Boa, wxWidgets & Python help.|
  
-====== Other sections: ======+===== Other sections: =====
  
   * Key definitions   * Key definitions
Ligne 841: Ligne 841:
   * Glossary   * Glossary
  
-====== Main windows ======+===== Main windows =====
  
-===== Palette =====+==== Palette ====
  
 Creation starts here. From the first page titled Newyou can create new modules, after clicking on one un nouveau module s'ouvre dans l'éditeur. The other pages work more on the principal of cocking your cursor like in Delphi. By clicking on e.g. wxStaticText, it becomesdepressed.While an object is selected on the Palette any click in a éditeur graphique will create that object in the container or the container of the object that you clicked on of thet éditeur graphique. Creation starts here. From the first page titled Newyou can create new modules, after clicking on one un nouveau module s'ouvre dans l'éditeur. The other pages work more on the principal of cocking your cursor like in Delphi. By clicking on e.g. wxStaticText, it becomesdepressed.While an object is selected on the Palette any click in a éditeur graphique will create that object in the container or the container of the object that you clicked on of thet éditeur graphique.
Ligne 855: Ligne 855:
 Objects created from the ’Utilities’ DataView. palette page should be created in the Zope objects created should be created in the Zope Explorer’s list view. Objects created from the ’Utilities’ DataView. palette page should be created in the Zope objects created should be created in the Zope Explorer’s list view.
  
-===== Inspector =====+==== Inspector ====
  
 {{logiciel:programmation:python:boa:help:inspectoricon.png|}} {{logiciel:programmation:python:boa:help:inspectoricon.png|}}
Ligne 865: Ligne 865:
 Whena property is selected in the inspector, an associated Property Editor will open in the Inspector for that property. Le type le plus courant de l'éditeur est un contrôle de texte used for editing strings and other builtins. Whena property is selected in the inspector, an associated Property Editor will open in the Inspector for that property. Le type le plus courant de l'éditeur est un contrôle de texte used for editing strings and other builtins.
  
-==== Pages ====+=== Pages ===
  
 These are the pages in the inspector: These are the pages in the inspector:
Ligne 874: Ligne 874:
 |Parent|This page shows the parent/child relationship of container controls. By selecting a different item the Inspector and l'éditeur graphique will change their selection to the newly selected item.| |Parent|This page shows the parent/child relationship of container controls. By selecting a different item the Inspector and l'éditeur graphique will change their selection to the newly selected item.|
  
-==== Éditeur ====+=== Éditeur ===
  
 {{logiciel:programmation:python:boa:help:editoricon.png|}} {{logiciel:programmation:python:boa:help:editoricon.png|}}
Ligne 882: Ligne 882:
 For each module the views supported by the module will be hosted on a second level notebook. Any actions applicable to the view like refreshing the source code or adding a module will be accessible by right clicking on the view or selecting from the ’Edit’ menu. Most of these options are also available from the toolbar. Usually a default action will be triggered by double clicking on a view. For each module the views supported by the module will be hosted on a second level notebook. Any actions applicable to the view like refreshing the source code or adding a module will be accessible by right clicking on the view or selecting from the ’Edit’ menu. Most of these options are also available from the toolbar. Usually a default action will be triggered by double clicking on a view.
  
-=== Modules ===+== Modules ==
  
 These are the supported modules: These are the supported modules:
Ligne 894: Ligne 894:
 |Other filetypes|Text − Plain text file, .txt and CAPS filenames Config| |Other filetypes|Text − Plain text file, .txt and CAPS filenames Config|
  
-==== Éditeur graphique ====+=== Éditeur graphique ===
  
 {{logiciel:programmation:python:boa:help:designerbutton.png|}} {{logiciel:programmation:python:boa:help:designerbutton.png|}}