ToggleButton 元素

表示 切换按钮 控件。

使用情况

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

特性

属性 类型 必选 说明
ApplicationDefaults.IsChecked
布尔

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

(true)
默认。
(false)
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 元素,最多可以发生一次。

对于每个 ControlGroupDropDownButtonGroupDropDownGalleryMenuGroupQuickAccessToolbar.ApplicationDefaultsSplitButton 或 SplitButtonGallery 元素,可能会出现一次或多次。

示例

以下示例演示 ToggleButton 元素的基本标记。

此部分代码显示 QuickAccessToolbar.ApplicationDefaults 元素中的 ToggleButton 元素声明。

      <Ribbon.QuickAccessToolbar>
        <QuickAccessToolbar CommandName="cmdQAT"
                            CustomizeCommandName="cmdCustomizeQAT">
          <QuickAccessToolbar.ApplicationDefaults>
            <Button CommandName="cmdButton1"/>
            <ToggleButton CommandName="cmdMinimize"
                          ApplicationDefaults.IsChecked="false"/>
          </QuickAccessToolbar.ApplicationDefaults>
        </QuickAccessToolbar>
      </Ribbon.QuickAccessToolbar>

元素信息

要求 详细信息
最低支持系统
Windows 7
可为空

请参阅

切换按钮控件