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 TextIsAnchorCommand FixMenuController 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. |