Elemento Button

Representa um controle Button .

Uso

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

Atributos

Atributo Tipo Obrigatório Descrição
ApplicationDefaults.IsChecked
Boolean
Não
Esse atributo é válido somente quando o elemento Button é filho de QuickAccessToolbar.ApplicationDefaults.
Restrito a um dos seguintes valores:

(true)
Padrão.
(false)
ApplicationModes
xs:string
Não
Válido somente se MenuGroup for o elemento pai.

(xs:string)
Uma cadeia de caracteres que contém uma lista separada por vírgulas de inteiros entre 0 e 31.
O espaço em branco é válido e ignorado.
Comprimento máximo: 250 caracteres.
CommandName
xs:positiveInteger ou xs:string
Não
Associa o elemento a um Comando.

(xs:positiveInteger ou xs:string)
Uma cadeia de caracteres, um valor inteiro entre 2 e 59999, inclusive ou um valor hexadecimal entre 0x2 e 0xea5f, inclusive.
O valor deve ser exclusivo no documento XML da Faixa de Opções.
Comprimento máximo: 100 caracteres.

Elementos filho

Não há elementos filho.

Elementos pai

Elemento
ControlGroup
DropDownButton
DropDownGallery
Grupo
Menugroup
QuickAccessToolbar.ApplicationDefaults
SplitButton
SplitButton.ButtonItem
SplitButtonGallery

Comentários

Opcional.

Pode ocorrer no máximo uma vez para cada elemento SplitButton.ButtonItem .

Pode ocorrer uma ou mais vezes para cada elemento ControlGroup, DropDownButton, DropDownGallery, Group, MenuGroup, QuickAccessToolbar.ApplicationDefaults, SplitButton ou SplitButtonGallery .

O botão dá suporte aos modos de aplicativo quando ele está hospedado na coluna à esquerda do Menu do Aplicativo.

Exemplos

O exemplo a seguir demonstra a marcação básica do Botão.

Esta seção de código mostra as declarações de Comando de Botão , com um Grupo associado que atua como o contêiner pai do elemento 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>

Esta seção de código mostra as declarações de controle de botão .

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

Informações do elemento

  • Sistema mínimo com suporte: Windows 7
  • Pode estar vazio: Sim

Confira também

Controle de botão

SetModes