SideShow Gadget开发[1]

SideShow的Gadget分为两类，一类是本地Gadget，一类是常规Gadget。所谓的本地Gadget就是编译SideShow工程时，直接集成到该工程的组件。如下图所示，这些组件不像常规Gadget，它无需连接PC，就天生俱有。

不过这种Gadget普通用户可能无法编写（需要下载SideShow SDK，修改其中的OEM工程），一般由提供SideShow设备的厂家定制。而我们常说的Gadget就是在Vista控制面板中SideShow Gadget，如下图所示。

本章暂不介绍常规Gadget的开发方法，对此有兴趣的朋友可以先看看网上的同类文章《开始学习编写用于 Windows SideShow 设备的小工具》。

在说本地Gadget之前，先说一下SideShow的宿主平台，最早SideShow是运行在.Net Micro Framework平台之上的（可以说SideShow是MF最值得称傲的典型应用），不过经过SideShow开发团队的努力，目前SideShow已经移植到Windows Mobile平台上来了，相关文章请参见：《Windows SideShow for Windows Mobile尝鲜》。

我所说的本地Gadget就是基于.Net Micro Framework平台之上的Gadget。其实本地Gadget和常规Gadget有本质区别，常规Gadget有些类似网页，SideShow设备从PC机下载基于简单内容格式 (SCF)协议的数据，然后在设备上呈现相关画面（类似HTTP），并且可以和PC上的Gadget Server进行交互。而本地Gadget其实说白了就是一段实现规定接口的.Net Micro Framework的C#应用程序。

我们知道在.Net Micro Framework仅且仅能运行一个应用程序，SideShow就是这么一个应用程序，所以留给本地Gadget的也只能是该应用程序的一个实现指定接口的DLL了（怎么有些拗口？！）。

我以前为MF编写的俄罗斯方块程序，由于主体程序都不需要改写，仅实现相关接口即可，所以我花了不到一个小时的时间，就把该程序移植到SideShow上了（如下图所示）。

（主菜单，选中时变大，并显示相关信息）

(操作界面）

（程序菜单）

下边就说一下实现过程。

首先程序类必须要实现IDeviceApplication接口，只有实现类该接口，SideShow主程序才能正确加载该DLL。

public interface IDeviceApplication

{

ApplicationForm GetForm();

GlanceData GetGlanceData();

void Install(IApplicationCache cache);

void SetShellAttributes(ShellAttributes attributes);

void Uninstall();

}

此外程序窗体必须派生于ApplicationForm类，该类负责为应用程序提供绘图场景，相对应的接口代码如下：

public ApplicationForm GetForm()

{

if (form == null)

{

form = new ElsForm();

}

return form;

}

至于Install和Uninstall接口可以根据需要添加相关代码即可，也可以为空函数。

1、 图标设置

细心的网友也许已经发现Gagget至少需要提供三套图标才能完成相关界面配置，主界面菜单需要两个图标（一大一小），大的48×48，选中时显示，小的32×32，未选中时显示，另一个16×16的图标，就是程序标题条上的图标。

这些图标不是ICON格式，就是普通BMP格式的图片。相关接口代码如下：

public void SetShellAttributes(ShellAttributes attributes)

{

attributes.Name = "Tetris"; //标题

attributes.Icon16Data = Resources.GetBytes(Resources.BinaryResources.ICON_16);

attributes.Icon32Data = Resources.GetBytes(Resources.BinaryResources.ICON_32);

attributes.Icon48Data = Resources.GetBytes(Resources.BinaryResources.ICON_48);

}

//主菜单上信息显示

public GlanceData GetGlanceData()

{

GlanceData glance = new GlanceData();

glance.Primary = "YeFan's Tetris";

if (ElsGame.bGameRunFlag)

{

glance.Secondary = new string[] {"[Run]"};

}

return glance;

}

2、 绘图区设置

程序窗体派生ApplicationForm类后，会自动为你的窗体添加标题条等等信息，不过你的窗体也可以全屏显示，这需要设置窗体的类型

public enum Style

{

Default = 0,

TitleBar = 1,

FullScreen = 2,

SizeToContent = 4,

Frame = 8,

Centered = 16,

DimBackground = 32,

}

//图形绘制和MF普通程序一样

public override void OnRender(DrawingContext dc)

{

base.OnRender(dc);

els.Draw(dc);

}

3、 菜单实现

//添加菜单项

public override ArrayList GetMenuItems()

{

ArrayList list = new ArrayList();

list.Add(new MenuItem("New game", 0));

list.Add(new MenuItem("Replay game", 1));

return list;

}

//菜单处理函数

public override void ExecuteMenuItem(MenuItem selected)

{

switch (selected.Id)

{

case 0:

ElsGame.bGameRunFlag = false;

els.Init(); //初始化

return;

case 1:

GameTimer.Start();

return;

case 2:

this.GoBack();

return;

}

}

如果你以前有MF图形开发的经验，开发这个一定会觉得很简单。好了，本地Gadget先介绍到这，有时间再介绍一下常规Gadget的开发。