Elemento de sinalizador de comando

Modifica seu elemento pai.

Syntax

<CommandFlag>DynamicVisibility</CommandFlag>

Atributos e elementos

A seção a seguir descreve valores de elemento válidos.

Atributos

Nenhum.

Elementos filho

Valor Descrição
AllowParams Indica que os usuários podem inserir parâmetros de comando na janela Comando quando digitam o nome canônico do comando.

Válido para: Button
SempreCriar O menu é criado mesmo que não tenha grupos ou botões.

Válido para: Menu
CaseSensitive As entradas de usuário diferenciam maiúsculas de minúsculas.

Válido para: Combo
CommandWellOnly Aplique esse sinalizador se o comando não aparecer no menu de nível superior e você quiser disponibilizá-lo para personalização adicional do shell, por exemplo, para vinculá-lo a um atalho de teclado. Depois que o VSPackage for instalado, você poderá personalizar esses comandos abrindo a caixa de diálogo Opções e editando o posicionamento do comando na categoria Ambiente do teclado. Esse sinalizador não afeta o posicionamento em menus de atalho, barras de ferramentas, controladores de menu ou submenus.

Válido para: Button, Combo
DefaultDisabled Por padrão, o comando será desabilitado se o VSPackage que o implementa não for carregado ou o QueryStatus método não tiver sido chamado.

Válido para: Button, Combo
DefaultDocked Encaixado por padrão. Essa configuração não se aplica mais às barras de ferramentas porque elas estão sempre encaixadas.
PadrãoInvisível Por padrão, o comando será invisível se o VSPackage que o implementa não for carregado ou o QueryStatus método não tiver sido chamado.

Recomendamos que você combine isso com a DynamicVisibility bandeira.

Válido para: Button, , Combo, Menu
DontCache O ambiente de desenvolvimento não armazena em cache os resultados do QueryStatus método para esse comando.

Para um menu, isso diz a um controlador de menu para não armazenar em cache o texto de seus itens de menu. Use esse sinalizador quando o menu contiver itens dinâmicos ou itens que tenham texto dinâmico.

Válido para: Button, Menu
DynamicAutomationName Especifica que o manipulador QueryStatus responderá a OLECMDTEXTFEXT_AUTOMATIONNAME e retornará uma cadeia de caracteres a ser usada como o nome de automação para seu controle. Se você estiver usando OleMenuCommand, poderá definir a propriedade AutomationName no manipulador BeforeQueryStatus se tiver esse sinalizador definido.

Quando usado em um elemento Menu, esse sinalizador se aplica somente a menus do tipo MenuController ou MenuControllerLatched.

Válido para: Button, , Combo, Menu
DynamicItemStart Indica o início de uma lista dinâmica. Isso permite que o ambiente crie uma lista chamando sucessivamente o método em itens de lista até que o QueryStatus sinalizador OLECMDERR_E_UNSUPPORTED seja retornado. Isso funciona bem para itens como listas de janelas usadas mais recentemente (MRU).

Válido para: Button
Visibilidade dinâmica A visibilidade do comando pode ser alterada por meio do QueryStatus método ou de um GUID de contexto incluído na VisibilityConstraints seção .

Aplica-se a comandos que aparecem em menus e barras de ferramentas da janela de ferramentas, mas não em barras de ferramentas de nível superior que aparecem na janela principal. Os itens da barra de ferramentas de nível superior podem ser desabilitados, mas não ocultos, quando o sinalizador OLECMDF_INVISIBLE é retornado do QueryStatus método. Os comandos da barra de ferramentas que aparecem nas barras de ferramentas da janela de ferramentas podem ser ocultos.

Em um menu, esse sinalizador também indica que ele deve ser automaticamente oculto quando todos os seus membros estiverem ocultos. Esse sinalizador normalmente é atribuído a submenus porque os menus de nível superior já têm esse comportamento.

Esta bandeira deve ser combinada com a DefaultInvisible bandeira.

Válido para: Button, , Combo, Menu
FilterKeys Consulte o tópico Chaves de filtragem em Elemento de combinação.

Válido para: Combo
FixMenuController Se esse comando estiver posicionado em um controlador de menu, o comando será sempre o padrão; ou seja, o comando é selecionado sempre que o próprio botão do controlador de menu é selecionado. Se o controlador de menu tiver o sinalizador definido, o controlador de menu também tirará seu texto do comando que tem o TextIsAnchorCommandFixMenuController sinalizador.

Apenas um comando em um controlador de menu deve ter o FixMenuController sinalizador. Se mais de um comando estiver marcado, o último comando no menu se tornará o comando padrão.

Válido para: Button
IconAndText Mostrar um ícone e texto no menu e na barra de ferramentas.

Válido para: Button, , Combo, Menu
NãoPreenchimento Automático O recurso de preenchimento automático está desabilitado.

Válido para: Combo
NoButtonPersonalizar Não deixe que o usuário personalize esse botão.

Válido para: Button, Combo
NoKeyPersonalizar Não habilite a personalização do teclado.

Válido para: Button, Combo
NoShowOnMenuController Se esse comando estiver posicionado em um controlador de menu, o comando não aparecerá na lista suspensa.

Válido para: Button
NotInTBList Não aparece na lista de barras de ferramentas disponíveis. Isso é válido apenas para tipos de menu da barra de ferramentas.

Válido para: Menu
NoToolbarFechar O usuário não pode fechar a barra de ferramentas. Isso é válido apenas para tipos de menu da barra de ferramentas.

Válido para: Menu
Pict Mostrar apenas um ícone em uma barra de ferramentas, mas apenas texto em um menu. Se nenhum ícone for especificado, mostrará um espaço em branco clicável em uma barra de ferramentas.

Válido para: Button
Pós-Exec Torna o comando sem bloqueio. O ambiente de desenvolvimento adia a execução até que todas as consultas de pré-processamento sejam concluídas.

Válido para: Button
RouteToDocs O comando é roteado para o documento ativo.

Válido para: Button
Esticar horizontalmente Quando esse sinalizador é definido, a largura se torna a largura mínima para a caixa de combinação e, se houver espaço na barra de ferramentas, a caixa de combinação se estende para preencher o espaço disponível. Isso ocorre somente se a barra de ferramentas estiver encaixada horizontalmente e apenas uma caixa de combinação na barra de ferramentas puder usar o sinalizador (o sinalizador será ignorado em todos, exceto na primeira caixa de combinação).

Válido para: Combo
Alterações de texto O texto do comando ou menu pode ser alterado em tempo de execução, normalmente através do QueryStatus método.

Válido para: Button, Menu
TextChangesButton Válido para: Button
TextIsAnchorCommand Para um controlador de menu, o texto do menu é retirado do comando padrão (âncora). Um comando âncora é o último comando selecionado ou travado. Se esse sinalizador não estiver definido, o controlador de menu usará seu próprio MenuText campo. No entanto, clicar no controlador de menu ainda habilita o último comando selecionado desse controlador.

Recomendamos que você combine essa bandeira com a TextChanges bandeira.

Esse sinalizador se aplica somente aos menus do tipo MenuController ou MenuControllerLatched.

Válido para: Menu
TextMenuCtrlUseMenu Use o campo nos controladores de MenuText menu. O campo padrão é ButtonText.

Válido para: Button
TextMenuUseButton Use o ButtonText campo para menus. O campo padrão é MenuText se for especificado.

Válido para: Button
Somente texto Mostrar apenas texto em uma barra de ferramentas ou menu, mas nenhum ícone, mesmo se o ícone for especificado.

Válido para: Button
TogglePatternAvailable Indica que seu botão suporta ser marcado/travado (ou seja, pode retornar OLEMCDF_LATCHED ou definir a propriedade Checked em OleMenuCommand). Isso permite que a camada de automação exponha o padrão de alternância para que os leitores de tela leiam o estado marcado/não verificado junto com o texto do botão.

Válido para: Button

Elementos pai

Elemento Descrição
Elemento Buttons Fornece um grupo para elementos do elemento Button.
Elemento Menus Define todos os menus que um VSPackage implementa.

Confira também