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

将元素与 Command 相关联。

(xs:positiveInteger 或 xs:string)
字符串、介于 2 和 59999 之间的整数值(包括 2 和 59999)或0x2与 0xea5f(含)之间的十六进制值。
该值在功能区 XML 文档中必须是唯一的。
最大长度:100 个字符。

子元素

没有子元素。

父元素

元素
ControlGroup
DropDownButton
DropDownGallery

MenuGroup
QuickAccessToolbar.ApplicationDefaults
SplitButton
SplitButton.ButtonItem
SplitButtonGallery

注解

可选。

每个 SplitButton.ButtonItem 元素最多可能发生一次。

对于每个 ControlGroupDropDownButtonDropDownGalleryGroupMenuGroupQuickAccessToolbar.ApplicationDefaultsSplitButton 或 SplitButtonGallery 元素,可能会发生一次或多次。

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

示例

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

此部分代码显示 Button 命令声明,其中包含一个关联的组,该 充当 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>

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

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

元素信息

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

另请参阅

按钮控件

SetModes