信息
您所需的主题如下所示。但此主题未包含在此库中。

ApplicationBar 类

2013/12/13

表示 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)确定指定的 Object 是否等于当前的 Object (从 Object 继承。)
受保护的方法Finalize允许 Object 在垃圾回收器回收该对象之前尝试释放资源并执行其他清理操作。 (从 Object 继承。)
公共方法GetHashCode用作特定类型的哈希函数。 (从 Object 继承。)
公共方法GetType获取当前实例的 Type (从 Object 继承。)
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (从 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

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

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

显示: