Configurer l'IDE

Général

Cette section regroupe les options qui influent sur le comportement général de l'IDE.

Ne lancer qu'un éditeur
Si cette option est activée, l'IDE ne pourra être exécuté qu'une seule fois, et toute exécution ultérieure activera l'IDE déjà ouvert. Par exemple cliquer sur un fichier .pb dans l'explorateur ouvrira le fichier dans un nouvel onglet au lieu de lancer une nouvelle instance de l'IDE.

Désactiver l'écran de démarrage
Désactive l'écran "PureBasic" qui est affiché lors du démarrage de l'IDE.

Mémoriser la position des fenêtres
Enregistre la position et la taille des fenêtres de l'IDE lorsqu'elles sont fermées. Pour avoir les fenêtres toujours ouvertes avec les mêmes dimensions, il faudra les placer à l'endroit désiré, activer cette option, puis quitter l'IDE (pour enregistrer les options). Au prochain démarrage, désactiver cette option et les fenêtres utiliseront la taille et la position précédemment enregistrées.

Afficher le contenu lors de l'utilisation des splitters
Si l'ordinateur de développement est rapide, cette option peut être activée, sinon déplacer les splitters peut entrainer un scintillement désagréable.

Recharger automatiquement les derniers fichiers ouverts
Recharge automatiquement tous les fichiers qui étaients ouverts lorsque l'IDE a quitté pour la dernière fois.

Afficher le chemin complet dans le titre de l'IDE
Si cette option est activée, le titre de la fenêtre principale de l'IDE affichera le chemin complet du fichier en cours d'édition, sinon seul le nom de fichier sera affiché.

Nb de fichiers récents
Nombre de fichiers récents à afficher dans le sous-menu "Fichiers récents" du menu "Fichier".

Nb de recherches récentes
Détermine le nombre de mots récents qui seront mémorisés dans les commandes "Rechercher/Remplacer" et "Rechercher dans les fichiers".

Éditeur visuel
Permet de choisir un autre programme pour éditer des interfaces graphiques en PureBasic, lorsque que l'on utilise le menu ou le bouton de la barre d'outils.

Général - Langue

Permet de changer la langue utilisée par l'IDE. La liste déroulante affiche les langues disponibles et des informations relatives à la traduction (ex: la personne qui a fait la traduction et la date).

Général - Raccourcis claviers

Dans cette section il est possible de paramétrer absolument tous les raccourcis pour les commandes de l'IDE. Créer un nouveau raccourci, selectionné le champ de saisie du raccourci, taper directement le raccourci souhaité sur le clavier puis cliquer sur "Appliquer".

A noter que les touches Tab et Shift+Tab sont réservées pour l'indentation des blocs de code et ne peuvent pas être modifiées. De plus certaines combinaisons de touches peuvent avoir un sens particulier pour l'OS et ne pourront pas être utilisées.

Général - Thèmes

Cette section permet de visualiser les thèmes disponibles pour l'IDE et d'en sélectionner un. Par défaut, deux thèmes sont à disposition.

Davantage de thèmes peuvent être facilement ajoutés en créant un fichier zip contenant les images (au format PNG) et un fichier "Theme.prefs" qui décrit le thème. Le fichier zip doit ensuite être copié dans le répertoire "Themes" de PureBasic pour être reconnu par l'IDE. Le fichier "SilkTheme.zip" peut être utilisé comme base pour créer un nouveau thème.

Afficher les icônes dans le menu
Permet d'afficher ou de cacher les icônes dans les menus de l'IDE.

Afficher la barre d'outils principale
Permet d'afficher ou de cacher la barre d'outils principale, pour gagner un peu de place dans la fenêtre d'édition.

Général - Barre d'outils

La barre d'outils est entièrement paramètrable. Pour changer la position des icônes, utiliser les boutons de la section "Position". Pour modifier un bouton ou en ajouter un nouveau, utiliser les boutons de la section "Configuration de l'élément" (les nouveaux éléments sont toujours ajoutés en fin de liste).

Types des éléments:
Séparateur : une barre verticale de séparation.
Espacement : un espace vide de la taille d'une icône.
Icône standard : permet de choisir une icône système (fournie par l'OS) dans la liste déroulante.
Icône de l'IDE : permet de choisir une icône propre à l'IDE dans la liste déroulante.
Fichier icône : permet de choisir une icône à partir d'un fichier spécifié dans le champ à droite (les fichiers PNG sont acceptés sur toutes les plateformes, ainsi que les fichiers icône sous Windows).

Si le type de l'élément n'est pas un "Séparateur" ni un "Espacement", alors il est possible de lui associer une action lorsque le bouton sera pressé:
Elément d'un menu : exécutera la commande correspondante à l'élément du menu spécifié dans la liste déroulante.
Lancer un outil : exécutera l'outil externe spécifié dans la liste déroulante.

La section "Configurations de la barre d'outils" contient les deux configurations de base de la barre d'outils qu'il est possible de choisir et de modifier à convenance.

Editeur

Paramètres qui influent sur l'édition des codes sources

Enregistrement automatique avant 'Compiler/Exécuter'
Enregistre le code source en cours d'édition avant chaque 'Compiler/Exécuter'. A noter que les fichiers inclus ne sont jamais enregistrés automatiquement.

Enregistrement automatique avant 'Créer un exécutable'
Enregistre le code source en cours d'édition avant de créer un fichier exécutable.

Enregistrement automatique de toutes les sources ouvertes
Enregistre toutes les sources et pas seulement la source en cours avec l'une des options de sauvegarde automatique .

Mémoriser la position du curseur
Enregistre la position du curseur ainsi que l'état de tous les replis pour le fichier en cours d'édition.

Mémoriser la position des marqueurs
Enregistre la position des marqueurs pour le fichier en cours d'édition.

Toujours cacher le journal d'erreurs
Le journal d'erreurs est montré ou caché en fonction de la configuration de chaque code source. Cette option permet de s'assurer que le journal d'erreurs ne sera jamais affiché si l'utilisateur le souhaite. La partie du menu concernant le journal d'erreur est aussi supprimée.

Enregistrer les options
Permet de déterminer où les options propres à chaque fichier doivent être enregistrées:

à la fin du fichier source
Enregistre les options dans un bloc de commentaire à la fin du fichier. Lorsqu'un fichier contenant ce type de commentaires est ouvert par l'IDE, ils resteront invisibles.

dans un fichier <nomdufichier>.pb.cfg
Crée un fichier .pb.cfg pour chaque fichier enregistré qui contient ces informations.

dans un fichier project.cfg pour chaque répertoire
Crée un fichier nommé project.cfg dans chaque répertoire ou des fichiers PureBasic sont enregistrés. Ce fichier contiendra les options de tous les fichiers du répertoire.

nulle part
Les options ne sont pas enregistrées du tout. Quand les fichiers seront ouverts, ils utiliseront toujours les valeurs par défaut.

Valeur d'une tabulation
Permet de spécifier le nombre d'espace qui seront insérés à chaque tabulation.

Utiliser les vraies tabulations (Ascii 9)
Si cette option est activée, les tabulations utiliseront le caractère 'tab' au lieu des espaces. A noter que si cette option est activée, le champ "Valeur d'une tabulation" défini la taille de la tabulation affichée.

Répertoire par défaut
Défini le répertoire par défaut qui sera utilisé par les commandes "Ouvrir" et "Enregistrer" si aucun fichier n'est ouvert, ou que le fichier en cours d'édition n'a pas encore été enregistré. Il est conseillé de mettre le répertoire où sont principalement stockés les codes sources.

Editeur - Valeurs par défauts

Cette page permet de définir les options de compilation qui seront utilisées par défaut quand un nouveau code source est créé avec l'IDE.
Pour une explication détaillée de chaque option, voir "Options de compilation".

Editeur - Polices/Marges

Utiliser "Sélectionner une police" pour changer la police de caractère utilisée pour l'affichage du code source. Pour assurer une bonne lisibilité du code, la police doit être de taille fixe (c'est à dire que tous les caractères ont la même largeur), si possible même pour les lettres en gras.

Activer la coloration syntaxique
Active ou désactive la coloration des codes sources. Le désactiver rend l'IDE légèrement plus rapide, mais bien moins convivial.

Afficher les mot clefs en gras
Si la police de caractère n'affiche pas les lettres en gras avec la même taille que les lettres normales, il est conseillé de désactiver cette option.

Activer la correction de la casse
Corrige automatiquement les mots clefs PureBasic, les fonctions PureBasic et API ainsi que les constantes prédéfinies pour qu'ils soient exactement comme définis initialement (ex: 'openwindow()' sera automatiquement changé en 'OpenWindow()').

Activer les marqueurs de parenthèses
Active le marquage des parenthèses lorsque le curseur se trouve sur une parenthèse. Cela permet de vérifier rapidement s'il y a le bon nombre de parenthèse, et de savoir à quelle parenthèse fermante correspond la parenthèse ouvrante (et vice-versa).

Activer les marqueurs de mots-clés
Permet de souligner tous les mots-clés en rapport avec le mot-clé actuellement sous le curseur.

Afficher la numérotation des lignes
Affiche ou cache la numérotation des lignes située à gauche de la zone d'édition.

Activer les marqueurs
Active ou désactive la fonctionnalité "Marqueur" du menu d'édition.

Activer la possibilité de replier le code
Active ou désactive la possibilité de replier ou non le code. Si les "replis" et les "marqueurs" sont désactivés, alors la colonne à gauche de la zone d'édition dédiée aux symboles sera cachée.

Editeur - Couleurs

Cette partie permet de modifier les couleurs utilisées par la coloration syntaxique ainsi que les marqueurs du débogueur. Des configurations prédéfinies sont disponibles dans la liste déroulante en bas de la fenêtre (une fois appliquées, elles sont modifiables). Chaque couleur peut être désactivée en utilisant les cases à cocher.

Note : Le modèle de couleur 'Accessibility' a (indépendamment des couleurs à fort contraste) un réglage spécial pour utiliser toujours la couleur système pour la sélection dans l'éditeur. Ceci permet aux applications qui permettent de lire un écran de mieux détecter le texte sélectionné.

Editor - Colors - Custom Keywords

In this section, a list of custom keywords can be defined. These keywords can have a special color assigned to them in the coloring options and the IDE will apply case-correction to them if this feature is enabled. This allows for applying a special color to special keywords by preprocessor tools or macro sets, or to simply have some PB keywords colored differently.

Note that these keywords take precedence above all other coloring in the IDE, so this allows to change the color or case correction even for PureBasic keywords.

The keywords can be either entered directly in the preferences or specified in a textfile with one keyword per line. (or both)

Editeur - Replis

Il est possible d'ajouter des mots clefs pour marquer le début et la fin d'un bloc repliable dans le code source. Un nombre illimité de mots clefs peuvent être saisis. Les mots qui sont dans les commentaires sont ignorés sauf si le mot clef employé a pour initiale le symbole commentaire (comme le mot clef par défaut ";{").
Un mot clef ne peut pas contenir d'espace.

Editeur - Auto-complétion

Afficher toute la liste des mots auto-complétables
Affiche toujours toute la liste des mots qui sont gérés par l'auto-complétion, mais choisi tout le même le mot le plus proche.

Afficher tous les mots commencant par le 1er caractère
Affiche uniquement les mots qui commencent par le premier caractère saisi. Le mot le plus proche est tout de même sélectionné.

Afficher seulement les mots commençant par le terme saisi
Affiche seulement les mots commençant par le terme saisi. Si aucun mot ne correspond, la liste ne sera pas affichée du tout.

Largeur de la liste / Hauteur de la liste
La dimension de la liste d'auto-complétion peut être définie ici (en pixels). Note : C'est les valeurs maximum. La fenêtre de la liste peut être plus petite s'il y a très peu d'éléments à afficher.

Ajout des parenthèses aux fonctions/tableaux/listes
Ajoute automatiquement la parenthèse ouvrante "(" après charque fonction, tableau ou liste insérée par l'auto-complétion. Les fonctions sans paramètres et les listes chainées auront automatiquement les double parenthèses "()" ajoutées.

Ajout d'un espace après les mots-clefs PureBasic suivis d'une expression
Quand un mot clef PureBasic ne peut pas être utilisé tout seul (tel que If, For, While etc.) et nécessite une expression, un espace sera automatiquement ajouté lors de l'auto-complétion.

Ajout du mot clef de fermeture si Tabulation/Entrée est appuyée deux fois
Si la touche 'Entrée' ou 'Tabulation' est appuyée deux fois, le mot clef de fermeture sera automatiquement inséré (ex: "EndSelect" pour "Select", "EndIf " pour "If") après le mot clef lui-même (et après le curseur, dont il possible de continuer l'édition immédiatement après l'auto-complétion).

Afficher automatiquement la fenêtre de complétion pour les champs de structure
Affiche automatiquement la liste d'auto-complétion quand le curseur est juste après une variable associée à une structure ou à une interface et que la touche "\" est entrée. La liste contiendra tous les champs qui composent la structure ou l'interface. Si cette option est désactivée, la liste peut toujours être affichée manuellement en utilisant le raccourci clavier associé (par défaut Ctrl+Espace).

Afficher automatiquement la fenêtre de complétion des fonctions
Affiche automatiquement la liste d'auto-complétion après qu'un nombre de caractères aient été entrés et qu'un ou plusieurs mots peuvent correspondre. Si cette option est désactivée, la liste peut toujours être affichée manuellement en utilisant le raccourci clavier associé (par défaut Ctrl+Espace).

Désactiver l'affichage de la liste dans les commentaires
Désactive l'affichage de la liste d'auto-complétion lorsque que le curseur se situe dans un commentaire.

Désactiver l'affichage de la liste dans les chaînes
Désactive l'affichage de la liste d'auto-complétion lorsque que le curseur se situe dans une chaîne de caractères (entre "").

Caractères requis avant l'affichage de la liste
Permet le configurer le nombre minimum de caractères saisis avant que la liste ne soit automatiquement affichée.

Editeur - Auto-complétion - Eléments affichés

Permet d'ajuster avec précision quels éléments seront affichés dans la liste d'auto-complétion.

Eléments du code source
Eléments défini dans le code source actuel, ou dans les autres sources ouverts (voir ci-dessous).

Eléments prédéfinis
Eléments qui sont prédéfinis par PureBasic, comme les mots-clés, les fonctions ou les constantes.

Ajouter les éléments: du code source courant seulement
Les éléments ajoutés dans la liste de complétion sont seulement récupérés du code source courant.

Ajouter les éléments: du projet courant (si présent)
Les éléments ajoutés dans la liste de complétion sont récupérés à partir du projet courant, s'il y en a un. Les autres code sources du projet n'ont pas à être obligatoirement ouverts dans l'IDE pour que ce soit fonctionnel.

Ajouter les éléments: du projet courant ou de tous les fichiers (si aucun)
Les éléments ajoutés dans la liste de complétion sont récupérés à partir du projet courant, s'il y en a un. Si le code source courant n'appartient pas au projet courant, tous les éléments des codes sources ouverts seront pris en compte.

Ajouter les éléments: de tous les fichiers ouverts
Les éléments ajoutés dans la liste de complétion sont récupérés à partir de tous les fichiers ouverts dans l'IDE.

Débogueur

Permet de paramétrer le comportement du débogueur intégré ou indépendant. Le débogueur en ligne de commande ne se configure que par l'intermédiaire du terminal.

Type de débogueur
Sélectionne le type du débogueur à utiliser lorsqu'un programme est compilé dans l'IDE.

Enregistrer la position des fenêtres du débogueur
Même fonction que l'option "Mémoriser la position des fenêtres" de la section "Général", mais appliquée aux fenêtres du débogueur.

Garder les fenêtres du débogueur en premier plan
Toutes les fenêtres de débuggage seront au toujours premier plan, même devant les autres applications. Cela peut faciliter le débuggage des applications prenant toute la surface du bureau.

Mettre les fenêtres du débogueur au premier plan quand une est sélectionnée
Avec cette option activée, lorsqu'une fenêtre de débuggage est activée à l'aide de la souris ou du clavier, les autres fenêtres ouvertes sont automatiquement ramenées au premier plan.

Ajouter l'heure dans le rapport d'activité
Ajoute l'heure de chaque évènement dans le rapport d'activité.

Arrêter l'exécution au démarrage du programme
Chaque programme sera stoppé au début de son exécution, pour donner la possibilité de dérouler le programme pas à pas (sans avoir besoin de mettre un point d'arrêt au début de chaque source).

Arrêter l'exécution avant l'arrêt du programme
Chaque programme sera stoppé juste avant de quitter réellement. Cela permet par exemple d'utiliser les outils de débuggage pour examiner les variables ou la memoire avant que le programme ne quitte.

Arrêter le programme après une erreur
Si le programme rencontre une erreur, il sera alors terminé automatiquement et toutes les fenêtres du débogueur seront fermées. Cela permet d'éditer le code immédiatement après une erreur, mais ce n'est plus possible d'examiner le programme pour essayer de déterminer la cause de l'erreur.

Garder les marqueurs d'erreurs après la fin du programme
N'efface pas les marqueurs d'erreurs quand le programme se termine. Cela permet de voir plus clairement ou l'erreur est survenue lors du retour à l'édition du code. Les marqueurs peuvent ensuite être enlevés à l'aide de la commande "Effacer les marqueurs d'erreurs" du sous-menu "Rapport d'activité".

Effacer le rapport d'activité à chaque exécution
Efface le rapport d'activité à chaque fois qu'un programme est exécuté. Cela assure que le rapport ne deviendra pas trop conséquent (cette option est aussi disponible quand le débogueur en ligne de commande est sélectionné).

Delai maximum pour le lancement du débogueur
Indique le temps maximum, en millisecondes, qui sera donné au programme pour s'initialiser. Ce delai évite que le débogueur ne bloque indéfiniment si l'exécutable à déboguer ne peut pas se lancer, pour une raison ou pour une autre.

Débogueur - Configuration des outils

Cela permet de contrôler l'affichage et le comportement des outils intégrés au débogueur. Les options "Afficher les valeurs en hexadecimal" change l'affichage des octets, word ou long du format décimal (base 10) au format hexadécimal (base 16).

Fenêtre de débogage – Ajouter l'heure
Ajoute l'heure à chaque ligne affichée dans la fenêtre de débogage.

Fenêtre de débogage - Affiche les messages de débogage dans le rapport d'activité
Avec cette option activée, une commande Debug dans le code n'ouvrira pas la fenêtre du débogueur, mais affichera les messages de débogage dans le rapport d'activité.

Fenêtre de débogage – Utilise une police personnalisée
Une police personnalisée peut être sélectionnée pour l'affichage dans la fenêtre de débogage. Ce qui permet de choisir une petite police pour afficher plus de données ou de choisir une police avec une taille proportionnelle quand c'est nécessaire.

Profileur - Lancer le profileur au démarrage du programme
Détermine si le profileur commencera l'enregistrement des données au démarrage du programme.

Débogueur ASM – Actualiser automatiquement l'état de la pile
Met à jour automatiquement l'état de la pile à chaque "Pas" ou "Stop" effectués. Si cette option est désactivée, un bouton "Actualiser" sera affiché dans la fenêtre ASM.

Observateur de mémoire – Voir les tableaux en une seule colonne
Si la zone de mémoire est affichée en mode "tableau", cette option indique si ce tableau sera multi-colonnes (avec 16 octets par colonne) ou seulement avec une colonne.

Débogueur - Fenêtres ouvertes

Les fenêtres cochées sur cette page seront ouvertes automatiquement à chaque fois qu'un programme sera lancé avec le débogueur.

Palette d'outils

Gère la configuration des outils internes qui peuvent être affichés dans le panneau latéral. Chaque outil qui est dans la liste des "Outils affichés" sera affiché dans la palette d'outil. Les outils qui ne sont pas présents dans cette liste sont accessibles à partir du menu "Outils". Ils seront ouverts dans une fenêtre indépendante.
Il est préférable de ne mettre que les outils qui sont utilisés très fréquemment dans la palette d'outil, et de mettre le plus utilisé en premier, car c'est celui qui est affiché le premier lorsque l'IDE démarre.

En sélectionnant un outil dans l'une des deux listes, un panneau de configuration spécifique à cet outil (si il y en a un) apparaîtra dans la partie "Configuration".

Les outils suivants peuvent être configurés:

Exploreur
Il est possible de choisir entre un affichage en mode liste ou en mode hierarchique (arbre) et de mémoriser ou non le dernier répertoire affiché (s'il n'est pas mémorisé, alors le "Répertoire par défaut" défini dans les options "Général" sera utilisé)

Palette de couleur
Le nombre de couleurs mémorisables affichées dans la palette de couleur est configurable.

Navigateur de procédures
"Trier les procédures par nom": trie la liste des procédures par ordre alphabétique (par défaut, les procédures apparaissent dans l'ordre de leurs déclarations)
"Grouper les marqueurs": groupe les marqueurs (";-") entre eux.
"Afficher les arguments des procédures": Affiche le nom de la procédure et tous ses paramètres.

Visualisateur de variables
L'option "Afficher les éléments de tous les fichiers ouverts" détermine si la liste doit contenir les éléments du fichier en cours d'édition, ou de tous les fichiers actuellement ouverts par l'IDE.
De plus, il est possible de sélectionner le type d'éléments qui seront affichés dans le visualisateur de variables.

Palette d'outils - Options

L'apparence de la palette d'outil en elle même peut être configurée dans cette section: le côté qui sera utilisé pour afficher la palette (à droite ou à gauche de la zone d'édition), la police de caractères, ainsi que la couleur de fond et d'avant plan utilisée par les outils affichés. La police et les couleurs optionnelles peuvent être désactivées pour utiliser les valeurs par défaut de l'OS.

Ignorer la couleur/police dans les fenêtres indépendantes
Si cette option est activée, les options de couleur/police ne seront appliquées que si l'outil est affiché dans la palette d'outils (ceux ouverts via le menu "Outils" utiliseront la couleur/police par défaut).

Cacher automatiquement la palette d'outils
Pour gagner un peu de place, la palette d'outils peut se cacher automatiquement si la souris ne se trouve pas au dessus d'elle. Pour la faire réapparaître, il suffit de déplacer la souris sur la zone située sur le côté de la zone d'édition.

Délai en millisecondes avant de cacher la palette
Défini un délai (en ms), après lequel la palette d'outils sera cachée si la souris n'est plus au dessus d'elle.

Importer/Exporter

Il est possible d'importer et d'exporter la configuration de l'IDE dans un format indépendant, et de l'importer dans un autre IDE (sous un autre OS par exemple, ou pour le partager avec d'autres utilisateurs).

Pour réaliser une exportation, il faut sélectionner le type des paramètres à exporter, saisir un nom de fichier et cliquer sur le bouton "Enregistrer"

Pour importer des paramètres, il suffit de choisir le nom du fichier et de cliquer sur "Ouvrir". Les paramètres disponibles seront alors affichés, il faudra décocher les paramètres indésirables puis cliquer sur "Importer".

Pour que les nouveaux paramètres prennent effet, il faudra appuyer sur le bouton "Appliquer".

Note: il est possible d'importer les fichiers 'styles' de l'éditeur jaPBe, mais seul les paramètres concernant les couleurs seront importés.