ApplicationBarIconButton 类

2012/2/9

带有一个图标的应用程序栏按钮。

System..::..Object
  Microsoft.Phone.Shell..::..ApplicationBarIconButton

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

public class ApplicationBarIconButton : IApplicationBarIconButton, 
	IApplicationBarMenuItem
<ApplicationBarIconButton .../>

ApplicationBarIconButton 类型公开以下成员。

  名称说明
公共方法ApplicationBarIconButton()()()()创建 ApplicationBarIconButton 类的新实例。
公共方法ApplicationBarIconButton(Uri)使用指定的图标创建 ApplicationBarIconButton 类的新实例。
返回顶部

  名称说明
公共属性IconUri获取或设置要用于按钮的图标的 URI。
公共属性IsEnabled获取或设置按钮的启用状态。
公共属性Text获取或设置图标按钮的标签。
返回顶部

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

  名称说明
公共事件Click当用户点按应用程序栏中的按钮时发生。
返回顶部

下面是使用 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 的图标按钮和菜单项

private void button1_Click(object sender, EventArgs e)
{
    ApplicationBarIconButton btn = (ApplicationBarIconButton)ApplicationBar.Buttons[0];

    if (btn.Text == "play")
    {
        btn.Text="pause";
        btn.IconUri = new Uri("/Images/pause.png", UriKind.Relative);
    }
    else if(btn.Text == "pause")
    {
        btn.Text="play";
        btn.IconUri = new Uri("/Images/play.png", UriKind.Relative);
    }
}

下面是创建可以在应用程序的多个页面上重用的应用程序栏示例。有关完整的示例,请参阅如何:在 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) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

显示: