WelcomeWizardForm.cs

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using be.gaudry.bibliobrol.view.controls;
using be.gaudry.view;
using be.gaudry.bibliobrol.model;
using be.gaudry.view.controls;
using be.gaudry.view.style;
using be.gaudry.bibliobrol.config;
 
namespace be.gaudry.bibliobrol.view.wizards
{
    public partial class WelcomeWizardForm : MDIChildForm
    {
 
        #region constructor and declarations
        private be.gaudry.view.controls.IWizardUC wizardUC;
        private InfoControl infoCtl;
        private UserControl dirCtl, prefsCtl, createStructureCtl;
        private DBSelectControl dbCtl;
        private PersonSelectControl ownerCtl;
        public WelcomeWizardForm()
        {
            InitializeComponent();
            initWizard();
            initInfoCtl();
            initDirSelCtl();
            initOwnerCtl();
            initOtherCtl();
        }
 
        private void initWizard()
        {
            //adapt wizard to xp or vista
            wizardUC = new WizardXpUserControl();
 
            this.SuspendLayout();
            // 
            // wizardUC
            // 
            ((Control)wizardUC).BackColor = SystemColors.ControlLight;
            ((Control)wizardUC).Dock = DockStyle.Fill;
            ((Control)wizardUC).Location = new Point(0, 0);
            //((Control)wizardUC).Name = "wizardUC";
            ((Control)wizardUC).Size = new Size(704, 498);
            ((Control)wizardUC).TabIndex = 0;
 
            this.Controls.Add((Control)wizardUC);
 
            this.ResumeLayout(false);
        }
 
 
        #endregion
 
        #region initializations
 
        private void initInfoCtl()
        {
            infoCtl = new InfoControl();
            StringBuilder str = new StringBuilder("Cet assistant de démarrage permet de configurer l'application au premier lancement, ou lorsque le système de persistance n'est pas correctement configuré.\n");
            str.Append("Vous pouvez retrouver par la suite ces différentes options dans le menu \"Outils\", puis dans \"Options\".\n");
 
            str.Append("\nPourquoi configurer le système de persistance ?\n");
            str.Append("\nLe système de persistance est le moyen utilisé par l'application pour sauver vos données. Par défaut, il s'agit d'un fichier bdb");
            str.Append("(qui est en fait une base de données MS.Access).\nVous pouvez décider de placer ce fichier dans votre répertoire \"Mes documents\", ou");
            str.Append(" sur une clé USB, sur un répertoire partagé, sur un serveur, etc.\n");
            str.Append("Même si la base de données est de type MS.Access, il n'est absolument pas nécessaire de posséder MS.Access pour que BiblioBrol fonctionne");
            str.Append(" (Ce type de fichier peut être utilisé légalement sans le logiciel de Microsoft).");
            str.Append("\nPar la suite, il sera possible de travailler avec d'autres systèmes de persistance.");
 
            str.Append("\n\nPourquoi définir un répertoire de travail ?\n");
            str.Append("\n1. Afin de séparer le programme (BiblioBrol.exe) de sa configuration. Ceci permet de garder la configuration à chaque mise à jour, ou pour les inconditionnels du formatage de garder les modifications apportées à la configuration.");
            str.Append("\n2. Afin de ne pas encombrer la base de données.");
            str.Append("\n3. Pour que vous puissiez utiliser l'application avec ses données, mais sans les images (qui peuvent rester sur votre machine et non sur votre clé USB) pour prendre moins de place.");
            str.Append("\n4. Pour que vous puissiez accéder à vos images de manière autonome par rapport à l'application.");
 
            str.Append("\n\nPourquoi configurer un propriétaire ?\n");
            str.Append("\nVous pouvez décider d'exporter certains de vos exemplaires, et d'importer certains exemplaires d'un ami.");
            str.Append("\nIl est alors nécessaire de savoir à qui appartient tel ou tel exemplaire.");
 
            str.Append("\n\nComment procéder ?\n");
            str.Append("\nL'assistant vous propose différentes étapes nécessaires à la configuration. En général, l'ordre de ces étapes est significatif (vous ne pouvez configurer le propriétaire de l'application si le");
            str.Append(" système de persistance n'est pas correctement configuré (comment entrer une nouvelle personne dans la base de données si cette dernière est introuvable ?).");
            str.Append("\nLe plus souvent, vous devez cliquer sur le bouton \"appliquer\" du panneau pour prendre en compte les modifications.");
            str.Append("\n Vous pouvez toujours utiliser le bouton \"précédent\" pour retourner au panneau de configuration précédent.");
            str.Append("\nLorsque tout est configuré, vous pouvez cliquer sur le bouton \"Terminé\".");
            str.Append("\n\nBon travail...\n\nSteph.");
            infoCtl.InfosTitle = "Premier contact...";
            infoCtl.Infos = str.ToString();
        }
        private void initDirSelCtl()
        {
            dirCtl = new DirControl();
            ((DirControl)dirCtl).DirTitle = "données";
            ((DirControl)dirCtl).Path = Config.DataDirectory;
            ((DirControl)dirCtl).Info = "";
            ((DirControl)dirCtl).dirPathModified += new DirControl.DirPathModifiedHandler(onDataDirPathModified);
 
        }
        private void initOwnerCtl()
        {
            ownerCtl = new PersonSelectControl();
            ownerCtl.CurrentPerson = Config.Owner;
            ownerCtl.personSelected += new PersonSelectControl.PersonSelectedHandler(onOwnerSelected);
            ActorRole role = ModelAdapter.getRole(11);
            ownerCtl.SelectedRole = role;
        }
        private void initOtherCtl()
        {
            prefsCtl = new SelectConsoleVerboseControl();
            dbCtl = new DBSelectControl();
            createStructureCtl = new CreateStructureControl();
        }
        #endregion
 
        #region private methods
        private void WelcomeWizardForm_Load(object sender, EventArgs e)
        {
            wizardUC.addStepControl(
                infoCtl,
                null,
                "Informations",
                "Généralités à propos de l'assistant de démarrage.",
                global::be.gaudry.bibliobrol.Properties.Resources.wizardSmall,
                null
            );
 
            wizardUC.addStepControl(
                createStructureCtl,
                null,
                "Première utilisation",
                "Création de la structure en cas de première utilisation. Sinon, passez à l'étape suivante.",
                global::be.gaudry.bibliobrol.Properties.Resources.brolExplore,
                null
            );
 
            wizardUC.addStepControl(
                dirCtl,
                null,
                "Répertoire BiblioBrol",
                "Sélection du répertoire de travail et de configuration de l'application BiblioBrol.",
                global::be.gaudry.bibliobrol.Properties.Resources.brolExplore,
                null
            );
 
            wizardUC.addStepControl(
                dbCtl,
                null,
                "Persistance des données",
                "Sélection et configuration du moyen utilisé pour sauver les données (base de données, fichiers xml, etc.).",
                global::be.gaudry.bibliobrol.Properties.Resources.brolDB,
                null
            );
 
            wizardUC.addStepControl(
                ownerCtl,
                null,
                "Propriétaire",
                "Sélection du propriétaire de l'application.\r\nCeci permet de configurer le propriétaire par défaut des nouveaux exemplaires, de gérer les emprunts, etc.",
                global::be.gaudry.bibliobrol.Properties.Resources.brolUsr,
                null
            );
 
            wizardUC.addStepControl(
                prefsCtl,
                new EventHandler(saveConsolePrefsAction),
                "Préférences",
                "configuration avancée de l'aplication.",
                global::be.gaudry.bibliobrol.Properties.Resources.brolTools,
                global::be.gaudry.bibliobrol.Properties.Resources.brolTools
            );
 
            wizardUC.displayAction(0);
        }
 
        private void saveConsolePrefsAction(object sender, EventArgs e)
        {
            Config.save();
        }
 
        private void onDataDirPathModified(object sender, DirPathModifiedEventArgs e)
        {
            Config.saveDataDirectory(e.Path);
            dbCtl.reset();
        }
        private void onOwnerSelected(object sender, PersonSelectedEventArgs e)
        {
            Config.Owner = e.Person;
            Config.save();
        } 
        #endregion
    }
}