Share via


Elemento QuickAccessToolbar

Representa a QAT (Barra de Ferramentas de Acesso Rápido), uma pequena barra de ferramentas que exibe atalhos para comandos da faixa de opções.

Uso

<QuickAccessToolbar
  CommandName = "xs:positiveInteger or xs:string"
  CustomizeCommandName = "xs:positiveInteger or xs:string">
  child elements
</QuickAccessToolbar>

Atributos

Atributo Type Obrigatório Descrição
CommandName
xs:positiveInteger ou xs:string
Não
Associa o elemento a um Command.

(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.
PersonalizarCommandName
xs:positiveInteger ou xs:string
No
Insere um item de Comando adicional no menu QAT.

(xs:positiveInteger ou xs:string)
Captura de tela de um menu QAT com os comandos Mais... Item de comando.
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

Elemento Descrição
QuickAccessToolbar.ApplicationDefaults
Pode ocorrer no máximo uma vez

Elementos pai

Elemento
Ribbon.QuickAccessToolbar

Comentários

Obrigatórios.

Deve ocorrer exatamente uma vez para cada Ribbon.QuickAccessToolbar.

Os itens no QAT podem ser adicionados ou removidos em tempo de execução.

Para consistência em aplicativos da Faixa de Opções, é recomendável que o manipulador de comandos CustomizeCommandName inicie uma caixa de diálogo de personalização de QAT.

Exemplos

O exemplo a seguir demonstra a marcação básica para QuickAccessToolbar.

Esta seção de código mostra a declaração comando QuickAccessToolbar .

<Command Name="cmdQAT"
         Symbol="ID_QAT"
         Id="40000"/>
<Command Name="cmdCustomizeQAT"
         Symbol="ID_CUSTOM_QAT"
         Id="40001"/>

Esta seção de código mostra a declaração de controle QuickAccessToolbar .

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

Informações do elemento

  • Sistema mínimo com suporte: Windows 7
  • Pode estar vazio: Não

Confira também

Controle da Barra de Ferramentas de Acesso Rápido