Page d'accueil
La gestion facile de cave à vins
Français  English  
Open Cellar Home Edition - 1.1 - Le logiciel gratuit pour gérér efficacement votre cave à vins sous Windows. Open Cellar Mobile Edition - Beta 2 - La gestion de cave à vins a enfin sa solution Mobile sur Pocket PC. Open Cellar Cross Platform - Beta 1 - La gestion gratuite de vins disponible sous Mac OSX et Linux. Mon Open Cellar Les forums d'Open Cellar Place des vins
Rechercher : Bienvenue (se connecter - créer un compte)
Options de page

Nuage de tags
Mon premier AddIn
Open Cellar a été conçu de manière a être facilement étendu au moyen de code .net
Comme le veut la tradition du programmeur nous développerons notre premier complément, le fameux Hello World :-)

1) Présentation du modèle
Interface IAddIn

- OnCommand(int command) : se produit lorsque l'utilisateur clique sur le menu Compléments -> Votre complément -> Menu n.

- OnInitialize(IApplication application) : méthode appelée par Open Cellar à l'initialisation du complément.

- OnRegisterMenus(AddInMenus addInMenus) : méthode appelée pour enregistrer ses menus au sein de l'application (Compléments -> Mon Complément -> Mes sous menus.

- OnUnInitialize() : méthode appelée à la fermeture d'Open Cellar.

Classe AddInMenus

- SetMainMenuCaption(string caption) : définit le titre du menu principal

- Register(int command, string caption) : enregistre un sous menu, caption étant le texte et command étant l'identifiant de la commande qui sera passée à la void OnCommand(int command)


2) Configuration de l'outil de développement
Open Cellar pour Windows est développé en .net 1.1, nous aurons donc besoin de Visual Studio 2003 ou SharpDevelop
Démarrez votre éditeur, créez un nouveau projet (OpenCellar.AddIn.HelloWorld) de type ClassLibrary puis ajoutez aux références l'assembly OpenCellar.Application.dll et System.Windows.Forms

3) Développement du complément
Ajoutez à votre projet une classe HelloWorld qui hérite de l'interface IAddIn puis recopiez le code suivant :

using System;
using OpenCellar.Application;

namespace OpenCellar.AddIn.HelloWorld
{
	/// 
	/// HelloWorld
	/// 
	public class HelloWorld : IAddIn
	{
		/// 
		/// Initialise une instance de classe HelloWorld.
		/// 
		public HelloWorld()
		{
			
		}

		private IApplication application;

		public void OnInitialize(IApplication application)
		{
			// Conserve une référence à l'application hôte.
			this.application = application;
		}

		public void OnUnInitialize()
		{
			// Pas de ressources à libérées...
		}

		public void OnRegisterMenus(AddInMenus addInMenus)
		{
			// Enregistre le menu principal
			addInMenus.SetMainMenuCaption("Mon premier complément");

			// Enregistre le sous menu
			addInMenus.Register(40, "Hello World :-)");
		}

		public void OnCommand(int command)
		{
			if(command == 40)
			{
				// Affiche un message d'information
				this.application.ShowMessage("Mon premier complément",
					"Hello World",
					System.Windows.Forms.MessageBoxIcon.Information,
					System.Windows.Forms.MessageBoxButtons.OK);
			}
		}
	}
}



4) Installation complément
Compilez puis copiez la dll OpenCellar.AddIn.HelloWorld.dll dans le répertoire AddIns d'OC.
Redémarrez OpenCellar puis cliquez sur le menu Compléments -> Mon premier complément -> HelloWorld.

Félicitations vous venez de développer votre premier complément :-)

 

Ecrire un commentaire
Seuls les membres enregistrés peuvent poster un commentaire.
Pour vous authentifier cliquez ici
 

 

© 2006-2008 Matthieu DUCROCQ Blog officiel d'Open Cellar - Tous droits réservés - Dernière mise à jour : juillet 2008