ApplicationBar 类

2012/2/9

表示 Windows Phone 应用程序中的应用程序栏。

System..::..Object
  Microsoft.Phone.Shell..::..ApplicationBar

Namespace:  Microsoft.Phone.Shell
程序集:  Microsoft.Phone(位于 Microsoft.Phone.dll 中)
XMLNS for XAML:未映射到 xmlns。

[ContentPropertyAttribute("Buttons")]
public sealed class ApplicationBar : IApplicationBar
<ApplicationBar>
  Buttons
</ApplicationBar>

ApplicationBar 类型公开以下成员。

  名称说明
公共方法ApplicationBar创建 ApplicationBar 类的新实例。
返回顶部

  名称说明
公共属性BackgroundColor获取或设置应用程序栏的背景颜色。
公共属性Buttons获取应用程序栏上显示的图标按钮列表。
公共属性DefaultSize获取当 Mode 属性设置为 Default 时应用程序扩展到页面的距离。
公共属性ForegroundColor获取或设置应用程序栏的前景颜色。
公共属性IsMenuEnabled获取或设置一个值,该值指示当用户单击省略号以展开应用程序栏时用户是否看到(可选)菜单项。
公共属性IsVisible获取或设置一个值,该值指示应用程序栏是否可见。
公共属性MenuItems获取应用程序栏上显示的菜单项列表。
公共属性MiniSize获取当 Mode 属性设置为 Minimized 时应用程序扩展到页面的距离。
公共属性Mode获取或设置应用程序栏的大小。
公共属性Opacity获取或设置应用程序栏的不透明度。
返回顶部

  名称说明
公共方法Equals (从 Object 继承。)
受保护的方法Finalize (从 Object 继承。)
公共方法GetHashCode (从 Object 继承。)
公共方法GetType (从 Object 继承。)
受保护的方法MemberwiseClone (从 Object 继承。)
公共方法ToString (从 Object 继承。)
返回顶部

  名称说明
公共事件StateChanged当用户通过单击省略号打开或关闭应用程序栏时发生。
返回顶部

应用程序栏包含 1 到 4 个按钮、一个省略号和一组文本菜单项。有关更多信息,请参阅 Windows Phone 的应用程序栏概述

下面是使用 XAML 创建具有两个图标按钮和两个菜单项的应用程序栏示例。有关完整的示例,请参阅如何:在 Windows Phone 的 XAML 中创建应用程序栏

<phone:PhoneApplicationPage.ApplicationBar>
    <shell:ApplicationBar Mode="Default" Opacity="1.0" IsMenuEnabled="True" IsVisible="True">

        <shell:ApplicationBarIconButton Click="Save_Click" IconUri="/Images/save.png" Text="save" />
        <shell:ApplicationBarIconButton Click="Settings_Click" IconUri="/Images/settings.png" Text="settings" />

        <shell:ApplicationBar.MenuItems>
            <shell:ApplicationBarMenuItem Click="MenuItem1_Click" Text="menu item 1" />
            <shell:ApplicationBarMenuItem Click="MenuItem2_Click" Text="menu item 2" />
        </shell:ApplicationBar.MenuItems>

    </shell:ApplicationBar>
</phone:PhoneApplicationPage.ApplicationBar>

下面是在代码中创建具有一个图标按钮和一个菜单项的应用程序栏示例。有关完整的示例,请参阅如何:在 Windows Phone 的代码中创建应用程序栏

using System;
using System.Windows;
using Microsoft.Phone.Controls;
using Microsoft.Phone.Shell;

namespace HowToCS
{
    public partial class MainPage : PhoneApplicationPage
    {
        // Constructor
        public MainPage()
        {
            InitializeComponent();

            ApplicationBar = new ApplicationBar();

            ApplicationBar.Mode = ApplicationBarMode.Default;
            ApplicationBar.Opacity = 1.0; 
            ApplicationBar.IsVisible = true;
            ApplicationBar.IsMenuEnabled = true;

            ApplicationBarIconButton button1 = new ApplicationBarIconButton();
            button1.IconUri = new Uri("/Images/YourImage.png", UriKind.Relative);
            button1.Text = "button 1";
            ApplicationBar.Buttons.Add(button1);
            button1.Click += new EventHandler(button1_Click);

            ApplicationBarMenuItem menuItem1 = new ApplicationBarMenuItem();
            menuItem1.Text = "menu item 1";
            ApplicationBar.MenuItems.Add(menuItem1);
            menuItem1.Click += new EventHandler(menuItem1_Click);
        }

        private void button1_Click(object sender, EventArgs e)
        {
            MessageBox.Show("Button 1 works!");
            //Do work for your application here.
        }

        private void menuItem1_Click(object sender, EventArgs e)
        {
            MessageBox.Show("Menu item 1 works!");
            //Do work for your application here.
        }
    }
}

下面是创建可以在应用程序的多个页面上重用的应用程序栏示例。有关完整的示例,请参阅如何:在 Windows Phone 应用程序的多个页面上重用应用程序栏

<Application.Resources>

    <shell:ApplicationBar x:Key="GlobalAppBar" IsVisible="True" IsMenuEnabled="True">
        <shell:ApplicationBarIconButton IconUri="/Images/appbar_button1.png" Text="Button 1" Click="Button1_Click" />
        <shell:ApplicationBarIconButton IconUri="/Images/appbar_button2.png" Text="Button 2" Click="Button2_Click" />
        <shell:ApplicationBar.MenuItems>
            <shell:ApplicationBarMenuItem Text="MenuItem 1" Click="MenuItem1_Click" />
            <shell:ApplicationBarMenuItem Text="MenuItem 2" Click="MenuItem2_Click" />
        </shell:ApplicationBar.MenuItems>
    </shell:ApplicationBar>

</Application.Resources>

下面是创建可用于应用程序的单个 Pivot 控件的两个应用程序栏示例。有关完整的示例,请参阅如何:在 Windows Phone 应用程序的一个 Pivot 控件中使用不同的应用程序栏

<Application.Resources>

    <shell:ApplicationBar x:Key="AppBar1" IsVisible="True" IsMenuEnabled="True">
        <shell:ApplicationBarIconButton IconUri="/Images/appbar_button1.png" Text="Button 1" Click="Button1_Click" />
        <shell:ApplicationBar.MenuItems>
            <shell:ApplicationBarMenuItem Text="MenuItem 1" Click="MenuItem1_Click" />
        </shell:ApplicationBar.MenuItems>
    </shell:ApplicationBar>

    <shell:ApplicationBar x:Key="AppBar2" IsVisible="True" IsMenuEnabled="True">
        <shell:ApplicationBarIconButton IconUri="/Images/appbar_button1.png" Text="Button 1" Click="Button1_Click" />
        <shell:ApplicationBarIconButton IconUri="/Images/appbar_button2.png" Text="Button 2" Click="Button2_Click" />
        <shell:ApplicationBar.MenuItems>
            <shell:ApplicationBarMenuItem Text="MenuItem 1" Click="MenuItem1_Click" />
            <shell:ApplicationBarMenuItem Text="MenuItem 2" Click="MenuItem2_Click" />
        </shell:ApplicationBar.MenuItems>
    </shell:ApplicationBar>
        
</Application.Resources>

Windows Phone OS

在 7.1、7.0 中支持

Windows Phone

此类型的所有公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

显示: