Button 元素

表示 Button 控件。

使用情况

<Button
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string"
  ApplicationDefaults.IsChecked = "Boolean"/>

特性

属性	类型	必选	说明
ApplicationDefaults.IsChecked	布尔	否	仅当 Button 元素是 QuickAccessToolbar.ApplicationDefaults 的子元素时，此属性才有效。 限制为以下值之一： (true) 默认。 (false)
ApplicationModes	xs:string	否	仅当 MenuGroup 是父元素时有效。 (xs：string) 包含 0 到 31 之间的整数的逗号分隔列表的字符串。 空格有效，将被忽略。 最大长度：250 个字符。
CommandName	xs：positiveInteger 或 xs：string	否	将 元素与 命令相关联。 (xs：positiveInteger 或 xs：string) 字符串、介于 2 和 59999 之间的整数值（非独占）或 0x2 与 0xea5f 之间的十六进制值（含）。 该值在功能区 XML 文档中必须是唯一的。 最大长度：100 个字符。

子元素

没有子元素。

父元素

元素
ControlGroup
DropDownButton
DropDownGallery
组
MenuGroup
QuickAccessToolbar.ApplicationDefaults
SplitButton
SplitButton.ButtonItem
SplitButtonGallery

备注

可选。

对于每个 SplitButton.ButtonItem 元素，最多可以发生一次。

对于每个 ControlGroup、DropDownButton、DropDownGallery、Group、MenuGroup、QuickAccessToolbar.ApplicationDefaults、SplitButton 或 SplitButtonGallery 元素，可能会出现一次或多次。

当按钮 托管在应用程序菜单的左列中时，它支持应用程序 模式 。

示例

以下示例演示 Button 的基本标记。

此部分代码显示 Button 命令声明，其中包含一个关联的 Group，该 组 充当 Button 元素的父容器。

<!-- Button -->
<Command Name="cmdButtonGroup"
         Symbol="cmdButtonGroup"
         Comment="Button Group"
         LabelTitle="ButtonGroup"/>
<Command Name="cmdButton1"
         Symbol="cmdButton1"
         Comment="Button1"
         LabelTitle="Button1"/>
<Command Name="cmdButton2"
         Symbol="cmdButton2"
         Comment="Button2"
         LabelTitle="Button2"/>
<Command Name="cmdButton3"
         Symbol="cmdButton3"
         Comment="Button3"
         LabelTitle="Button3"/>
<Command Name="cmdButtonGroup2"
         Symbol="cmdButtonGroup2"
         Comment="Button Group2"
         LabelTitle="ButtonGroup2"/>
<Command Name="cmdButtonG21"
         Symbol="cmdButtonG21"
         Comment="ButtonG21"
         LabelTitle="ButtonG21">
  <Command.LargeImages>
    <Image Source="res/large.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/small.bmp"/>
  </Command.SmallImages>
</Command>
<Command Name="cmdButtonG22"
         Symbol="cmdButtonG22"
         Comment="ButtonG22"
         LabelTitle="ButtonG22">
  <Command.LargeImages>
    <Image Source="res/large.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/small.bmp"/>
  </Command.SmallImages>
</Command>
<Command Name="cmdButtonG23"
         Symbol="cmdButtonG23"
         Comment="ButtonG23"
         LabelTitle="ButtonG23">
  <Command.LargeImages>
    <Image Source="res/large.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/small.bmp"/>
  </Command.SmallImages>
</Command>
<Command Name="cmdButtonG24"
         Symbol="cmdButtonG24"
         Comment="ButtonG24"
         LabelTitle="ButtonG24">
  <Command.LargeImages>
    <Image Source="res/large.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/small.bmp"/>
  </Command.SmallImages>
</Command>

此部分代码显示 Button 控件声明。

<Group CommandName="cmdButtonGroup"
       SizeDefinition="ThreeButtons">
  <Button CommandName="cmdButton1"></Button>
  <Button CommandName="cmdButton2"></Button>
  <Button CommandName="cmdButton3"></Button>
</Group>

元素信息

• 支持的最低系统：Windows 7
• 可以为空：是

另请参阅

按钮控件

SetModes