Windows Phone 7 开发 31 日谈——第21日：Silverlight Toolkit for Windows Phone

 

第21日。

在昨天讨论了地图控件之后，我突然想到你可能还不知道silverlight toolkit为你提供了大量的控件。今天的文章就来讲解silverlight toolkit for windows phone，另外，还会说到silverlight 3 toolkit。

什么是工具包？

 

    在最初的silverlight 3工具包中有一大堆可以用在项目中的额外控件。包含的控件从图表（chart）到手风琴视图（accordion），从日期选择器（date picker）到自动完成输入框（autocomplete box）。这个工具包最棒的地方就是它完全兼容我们用silverlight写的windows phone应用程序。

silverlight toolkit for windows phone与之类似，但它包含了额外的一些可以用在windows phone程序中的控件。它们是：

• contextmenu
• datepicker & timepicker
• gesturelistener
• toggleswitch
• wrappanel

    在本文下面的内容中我会为工具包中的每种控件都提供一个例子，不过我还是强烈建议你仔细研究silverlight 3 toolkit。这里有大量可以用在你的项目中的控件，示例和代码。我会在后面的文章中介绍工具包中的图表控件，但是你需要耐心等待，当然你也可以现在就开始研究它。

contextmenu控件

如果你试过将某个程序别到起始页上，你就会看到contextmenu在起作用。下面是我在将internet explorer放到模拟器起始页面时的样子（按下并保持就会显示这个菜单）：

为了让这个菜单出现，我们需要使用silverlight工具包中的contextmenu控件。和本文所有的例子一样，我们需要在项目中添加silverlight工具包的程序集。你可以在这看到：

添加程序集后，还要在xaml页中添加名称空间。将这个名称空间添加到文件顶部的<phone:phoneapplicationpage>标签中：

xmlns:toolkit="clr-namespace:microsoft.phone.controls;assembly=microsoft.phone.controls.toolkit"

    现在可以进入正题了。让我们找一个能为用户提供更多选项的控件，矩形。我们可能会有一个用户想与之交互的形状，图片或图标等等。也可能对这个矩形我们要做更多的事（想想右击菜单）。通过向矩形添加一个contextmenu，可以在用户点击对象并保持时弹出一个菜单。它可以是任何xaml元素，所以你甚至可以在应用程序的背景，全景视图或按钮中应用此控件。下面是如何使用它的xaml代码：

<rectangle width="100" height="100" fill="red">
    <toolkit:contextmenuservice.contextmenu>
        <toolkit:contextmenu>
            <toolkit:menuitem header="this is menu item 1" click="menuitem_click" />
            <toolkit:menuitem header="this is menu item 2" click="menuitem_click" />
            <toolkit:menuitem header="this is menu item 3" click="menuitem_click" />
        </toolkit:contextmenu>
    </toolkit:contextmenuservice.contextmenu>
</rectangle>

通常我们要使用contextmenuservice，在特定的控件上添加contextmenu。你可以看到每一项都有一个click事件，允许将这些菜单项与代码相关联。下面是我的contextmenu截图：

如果你在模拟器中测试这个程序，可能会注意到背景中的内容都缩小了一点，好像陷入了背景中，将菜单呈现在了用户所注视的正前方。当然你可能不需要这个动作，那么在<toolkit:contextmenu>项中有一个iszoomenabled特性。将它设置为false可以停止自动的缩放动画。

为xaml元素添加这种类似右击菜单的内容很简单。这可能是6个控件中最常用的控件了（除非gestureservice不能用了）。

datepicker和timepicker控件

在我为本文准备例子时，这两个控件给我带来了一个有趣的挑战。它们是如此的简单以至于我都不知道我哪儿做错了。事实上，还真是有点儿小魔力。一会儿我会解释。首先，看看如何将这些控件添加到页面中。这很简单：

<toolkit:datepicker value="7/22/1976" />
<toolkit:timepicker value="12:02 am" />

当你添加这些控件到页面中后，它们可以如介绍地那样工作。它们允许用户选择一个日期（以你提供的初始日期开始……如果你没有提供，它默认使用“今天”的日期）。下面是每个控件的截图：

 

好了，现在来看看这些控件带给我的复杂问题。你会注意到上面截图中的工具栏。还有两个图标（没有图片）。在我几番思索之后，我知道了它们是完成和取消按钮（你还可以在点击省略号（…）图标时发现它们。它们会向上滑动并显示文本标签）。

为了让这些图标能真正工作，你需要按照下面的步骤操作：

1. 在你的项目中建一个根目录，命名为“toolkit.content”。
2. 在这个目录中添加两个带特定名字的图片
   1. applicationbar.cancel.png (点此下载)
   2. applicationbar.check.png (点此下载)
3. 要确保这两个图片的build action已被设置为“content”。如果你没这么做，请点击图片，然后在属性标签中修改。

遵从上述步骤后，它就能工作了！下面是可以正常使用的程序截图：

 

gesturelistener控件

    从从windows phone 7开发31日谈开始到目前为止，你可能一直在想什么时候能找到在程序中处理用户手势的方法。就在今天！（免责声明：这是其中的“一种方法”。其实有很多种方法来处理手势，但无疑这是最简单的一种，如果你是一路读下来的就会发现这是这个系列所推崇的。用最简单的方法实现windows phone中的内容。但这未必是你要一直遵从的最佳实践。）

    好了，都说清楚了，我们来讨论gesturelistener吧。和contextmenu很像，我们要让gestureservice知道我们创建了一个gesturelistener，然后通常要为我们期待的特定手势配备事件处理程序。记住是在xaml元素中应用它，所以手势只会在被应用的控件中才能被识别。gesturelistener支持以下手势：

tap

doubletap

hold

flick

pinch

drag and drop

每一个手势都是以这种方法实现的，实现起来非常简单。收缩和拖拽操作还有一些细节（通常delta过程介于手势开始和完成之间）。下面是xaml代码（在另一个矩形中）：

代码

<rectangle width="100" height="100" fill="blue">

    <toolkit:gestureservice.gesturelistener>

        <toolkit:gesturelistener

            doubletap="doubletapped"

            tap="tapped"

            hold="held"

            dragstarted="dragstart"

                dragdelta="dragdelta"

                dragcompleted="dragend"

            flick="flicked"

            pinchstarted="pinchstart"

                pinchdelta="pinchdelta"

                pinchcompleted="pinchend" />

    </toolkit:gestureservice.gesturelistener>

</rectangle>

复制代码

正如你所见，我定义了所有需要去识别的手势，并将相应的事件处理程序赋给它们，在silverlight toolkit for windows phone的代码示例中，有很多关于如何处理这些事件的好例子toggleswitch控件

 

如果你更改过模拟器的日期/时间就可能看到过这个控件。下面是例子：

将它添加到页面中非常简单：

 

 

<toolkit:toggleswitch header="receive updates automatically"/>

    在上面的截图中写的是“24-hour clock”，我的例子将会写着“receive updates automatically”。很幸运，on/off文本是自动为你处理的。如果你想对这个控件做一些定制也是很简单的。我们可以利用headertemplate和contenttemplate来使这个控件更加“自我”。还有checked和unchecked事件，它们在操作开关时被触发。（这个控件和checkbox很相似）。下面是一个使用示例（并绑定到了数据源）：

代码

<toolkit:toggleswitch header="12:02 am">

    <toolkit:toggleswitch.headertemplate>

        <datatemplate>

            <contentcontrol fontsize="{staticresource phonefontsizelarge}" foreground="{staticresource phoneforegroundbrush}" content="{binding}"/>

        </datatemplate>

    </toolkit:toggleswitch.headertemplate>

    <toolkit:toggleswitch.contenttemplate>

        <datatemplate>

            <stackpanel>

                <stackpanel orientation="horizontal">

                    <textblock text="alert: " fontsize="{staticresource phonefontsizesmall}"/>

                    <contentcontrol horizontalalignment="left" fontsize="{staticresource phonefontsizesmall}" content="{binding}"/>

                </stackpanel>

                <textblock text="every weekday" fontsize="{staticresource phonefontsizesmall}" foreground="{staticresource phonesubtlebrush}"/>

            </stackpanel>

        </datatemplate>

    </toolkit:toggleswitch.contenttemplate>

</toolkit:toggleswitch>

 

最后是wrappanel。它的目的很明显，因为它是标准控件集中赫然缺失的控件。

wrappanel控件

    wrappanel基本上是带很多额外特性的stackpanel。几个月前我在创建了一个游戏，我想在一个屏幕里面放置30个按钮。因为那时还没有wrappanel，我不得不去动态的创建一个grid，然后再将每个按钮放在grid中的某个位置上。这些工作比我想象的要多得多，而仅仅是为了在一个5 x 6的布局中放30个按钮。现在wrappanel帮我们解决了这个问题。

在下面的例子中，我在一个wrappanel中放置了12个按钮。

代码

<toolkit:wrappanel>

    <button width="75" height="75" content="1" />

    <button width="75" height="75" content="2" />

    <button width="75" height="75" content="3" />

    <button width="75" height="75" content="4" />

    <button width="75" height="75" content="5" />

    <button width="75" height="75" content="6" />

    <button width="75" height="75" content="7" />

    <button width="75" height="75" content="8" />

    <button width="75" height="75" content="9" />

    <button width="75" height="75" content="10" />

    <button width="75" height="75" content="11" />

    <button width="75" height="75" content="12" />

</toolkit:wrappanel>

 

 

在下面的截图中，你可以看到wrappanel动态决定在每一行如何安放它们，并在第一行下面堆叠。不会发生重叠（很像stackpanel），而且不用担心内容的尺寸会将你的布局搞砸。下面是截图：

在我下面的代码示例中，你会看到我为button 1和button 2配备了事件处理程序。它们可以让所有按钮的尺寸放大或缩小。在把玩这个例子时应该仔细看看wrappanel是如何动态移动你的内容的，尤其是在运行时。下面是相同代码的截图，只不过其中的按钮被刻意地放大了：

好了，就是这些！我们讲解了silverlight toolkit for windows phone中5个全新的可用控件。请在今天就下载它，因为你会发现很快就会用到它。

下载示例代码

在这个示例代码中，你可以找到silverlight toolkit for windows phone中每一个控件的例子。在第31日时，我会介绍silverlight 3 toolkit，以及如何在wp7应用程序中使用图表。

 

原文地址：http://www.jeffblankenburg.com/post/31-days-of-windows-phone-7c-day-21-silverlight-toolkit-for-windows-phone.x