通过

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