Button 元素

表示 按鈕 控制項。

使用方式

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

屬性

屬性 類型 必要 描述
S. IsChecked
Boolean

只有當 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、s、 SplitButtonSplitButtonGallery 元素執行一次或多次。

按鈕 會在應用程式功能表的左邊資料行中裝載時,支援 應用程式模式

範例

下列範例示範 按鈕 的基本標記。

這段程式碼會顯示 按鈕 命令宣告,以及可做為 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
  • 可以是空 的:是

另請參閱

Button 控制項

SetModes