Button 元素

表示 按钮 控件。

使用情况

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

特性

属性 类型 必须 说明
S. IsChecked
布尔

仅当 Button 元素是 QuickAccessToolbar. s的子元素时,此属性才有效。
限制为下列值之一:

(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. s
SplitButton
SplitButton. ButtonItem
SplitButtonGallery

备注

可选。

对于每个 SplitButton. ButtonItem 元素最多可以出现一次。

对于每个 ControlGroupDropDownButtonDropDownGalleryGroupMenuGroupQuickAccessToolbar 、sSplitButton 元素,可能会出现一次或多次。

在应用程序菜单的左栏中承载应用程序模式时,按钮 支持 应用程序模式

示例

下面的示例演示 按钮 的基本标记。

此代码段显示了 按钮 命令声明,其中包含一个充当 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
  • 可为空:是

另请参阅

Button 控件

SetModes