CognitionMaster Files

GenericBusinessClient is interesting only for programmers. If you are not familliar with C# programming you should not waste time with reading this document.

When writing applications you often have to setup a main window, tool bar, configuration file and a engine that allows for switching between different frames within your application. If you have those problems than GenericBusinessClient may be an option for you. All you have to do is:

  - create a new .NET component library
  - Reference #Accessory.dll and #Accessory.GenericBusinessClient.exe from the program files folder
  - Write a new class that derives from #Accessory.GenericBusinessClient.Plugging.Plugin
  - Create a config file with .gbcc extension (an example can be found at the end of this document)
  - Launch #Accessory.GenericBusinessClient.exe passing the full path to your config file or just double-click your config file


In your plugin class you can:

  - Add your own controls using the Control property
  - Read and write settings using the Configuration property in the OnLoad, OnReady or OnRelease method
  - Show tool buttons, see GetToolButtons method
  - Make your plugin a homepage of the application, see GetHomePageInfo method
  - switch to another plugin, see ShowPlugin method (use full names, e.g. "MyLib.MyClass")
  - prevent the application from closing by overriding the OnProgramClosing method


Example config file:

<?xml version="1.0" standalone="yes"?>
<GenericBusinessClient.Configuration Version="1.0">
  <WindowState>Normal</WindowState>
  <Language>English</Language>
  <BackgroundImage>PATH_TO_BACKGOUND_IMAGE</BackgroundImage>
  <PluginFolder>PATH_TO_PLUGIN_ASSEMBLIES</PluginFolder>
  <WindowBounds X="0" Y="0" Width="1024" Height="768" />
  <BannerImage>PATH_TO_BANNER_IMAGE</BannerImage>
  <Icon>PATH_TO_ICON_FILE</Icon>
</GenericBusinessClient.Configuration>


- Icon, BannerImage and BackgroundImage are optionally, you can leave this fields empty
- pathes may contain environment variables:
  - e.g.: %ProgramFiles%
  - see System.Environment.SpecialFolder enumeration
  - environment variables are case sensitive