Paramètres des boîtes de dialogue

Le package org.eclipse.jface.dialogs fournit une classe utilitaire, DialogSettings, pour le stockage et l'extraction des valeurs saisies. Vous pouvez utiliser cette classe pour enregistrer et extraire des types de données primitifs et des valeurs de chaînes associées aux noms de clés. Les paramètres sont chargés et sauvegardés dans un fichier XML.

AbstractUIPlugin fournit le support pour les paramètres des boîtes de dialogue de taille importante stockés dans un fichier XML dans le répertoire de votre plug-in. Si aucun fichier de paramètres de boîte de dialogue ne figure dans ce répertoire, une méthode DialogSettings vide est créée pour vous. Lorsque le plug-in est arrêté, tous les paramètres lui ayant été ajoutés sont sauvegardés dans un fichier XML et sont extraits lors de son prochain démarrage.

Les paramètres de la boîte de dialogue sont accessibles à n'importe quel endroit du code du plug-in. Le fragment ci-dessous montre comment obtenir les paramètres de la boîte de dialogue pour l'outil readme.

   IDialogSettings settings =
ReadmePlugin.getDefault().getDialogSettings();

Les valeurs sont stockées et extraites à l'aide des méthodes "get" et "put". Les méthodes "get" reçoivent un nom une fois le type de primitive accédé. Vous pouvez stocker et extraire des valeurs "boolean", "long", "double", "float", "int", "array" et "string". Le fragment ci-dessous montre comment les paramètres d'une boîte dialogue peuvent être utilisés pour initialiser les valeurs des commandes dans la boîte de dialogue.

   protected Control createDialogArea(Composite parent) {
      IDialogSettings settings =
ReadmePlugin.getDefault().getDialogSettings();
      checkbox = new Button(parent,SWT.CHECK);
      checkbox.setText("Generate sample section titles");
      // initialise la case à cocher en fonction des paramètres de la
boîte de dialogue
      checkbox.setSelection(settings.getBoolean("GenSections"));
   }

La valeur du paramètre peut être stockée ultérieurement lorsque le bouton OK est activé.

   protected void okPressed() {
      IDialogSettings settings =
ReadmePlugin.getDefault().getDialogSettings();
      // stocke la valeur de la case à cocher générée
      settings.put("GenSections", checkbox.getSelection());
      super.okPressed();
   }

Copyright IBM Corporation and others 2000, 2003.