Home Page
Free and easy wine cellar software
Français  English  
Open Cellar Home Edition - 1.1 - Windows 98, Me, 2000, XP and Vista. The free Windows wine cellar management software. Open Cellar Mobile Edition - Beta 2 (French version) - Pocket PC. The free Pocket PC wine cellar management software. Open Cellar Cross Platform - Beta 1 (French version) - Mac OSX and Linux. The free MacOS/Linux wine cellar management software. My Open Cellar Open Cellar Forums Place des vins
Search: Welcome (connect - create an account )
Page settings

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 :-)

 

Write a comment
Only registered members can post a comment.
To identify yourself please click here
 

 

© 2006-2008 Matthieu DUCROCQ  Open Cellar official blog - All rights reserved - Last update: july 2008