Desktop Sidebar SDK Readme File
Desktop Sidebar SDK includes all files required to create new panels for Desktop Sidebar in C++ and in any .NET language.
SDK should be unpacked to DSSDK folder in Desktop
Sidebar installation directory (where
sidebar.exe is stored). So include files should be placed
<<desktop sidebar folder>>\dssdk\includes and
dsidebarpia.dll should be placed <<desktop sidebar
folder>>\dsidebarpia.dll
(e.g. C:\Program Files\Desktop Sidebar\dsidebarpia.dll)
C++ users
DSSDK includes wizard to create panel project inside Microsoft Visual
Studio.NET 2003. To create panel:
- Please copy content of
dssdk/wizards/vc7 directories to vc7 directory inside Microsoft Visual
Studio.NET 2003.
- Select File->New
Project->Visual
C++ Projects->Desktop Sidebar Panel in Visual Studio and then
wizard will generate full implementation of simple panel with configuration
file
- Build generated
project
- Copy compiled dll and
“dsplugin” file to Desktop Sidebar installation directory
- Restart Desktop
Sidebar
- Then your panel should
be visible in Add New Panel dialog
If you don’t
use VC7.1 you can use included sample: samples/cpp/recyclebin as start point
for creating your panel. All required include files are in includes folder. You
don’t need any libraries to build panels.
Panels are COM components but they required small xml configuration file with dsplugin extension. This file should be stored in Desktop Sidebar installation directory. Primary function of this file is point to COM component which implements plugin interface. You can point to COM component by ProgId or by path to dll. If you use Desktop Sidebar Panel wizard inside Visual Studio this configuration file will be generated automatically for your plugin. If you prefer to create it manually please use included sample recyclebin.dsplugin as template. Please remember that you have to copy dll and dsplugin file to Desktop Sidebar Directory and then restart sidebar to notify it about new panel
.NET users
DSSDK includes wizard
to create panel project inside Microsoft Visual Studio.NET 2003. To create
panel:
- Please copy content of
dssdk/wizards/vc# directories to vc# directory inside Microsoft Visual
Studio.NET 2003.
- Select File->New
Project-> Visual C# Projects->Desktop Sidebar Panel in Visual Studio and
then wizard will
generate full implementation of simple panel with configuration files
- Build generated
project
- Copy Copy compiled dll
and generated “dsplugin” file to Desktop Sidebar installation directory
- Restart Desktop
Sidebar
- Your panel should be
visible in Add New Panel dialog
If you prefer to create panel manually please use included sample: samples/cs/stickerpanel as start point. To develop panel with .NET you have to create assembly with two classes which implements IPlugin and IPanel interfaces defined in Interop Assembly for Desktop Sidebar: dsidebarpia.dll, build this assembly, register it with regasm or with “Registry for COM interop” setting in project, create “dsplugin” file for your panel and copy this file to Desktop Sidebar installation directory. (You can use stickerpanel.dsplugin as template). You have to restart Desktop Sidebar to notify it about new panel and then your panel should be visible in “Add New Panel” dialog in Desktop Sidebar
Support
You can find information about plugin's development on
Developers Forum and you can send mail with questions
or suggestions to damian@desktopsidebar.com