Propriedade CommandBarControl.IsPriorityDropped (Office)
Obtém True se o controle tiver sido removido do menu ou barra de ferramentas com base no espaço de layout e estatísticas de uso. (Observe que isso não é o mesmo que a visibilidade do controle, conforme definido pela propriedade Visible ). Somente leitura.
Observação
[!OBSERVAçãO] O uso de CommandBars em alguns aplicativos do Microsoft Office foi substituído pelo novo componente da faixa de opções da interface de usuário do Microsoft Office Fluent. Para obter mais informações, consulte Visão geral da faixa de opções fluente do Office.
Sintaxe
expressão. IsPriorityDropped
Expressão Uma variável que representa um objeto CommandBarControl .
Valor de retorno
Booliano
Comentários
Um controle com Visible definido como True não será imediatamente visível em um menu ou barra de ferramentas personalizado se IsPriorityDropped for True.
Para determinar quando definir IsPriorityDropped como True para um item de menu específico, o Microsoft Office mantém uma contagem total do número de vezes que o item de menu foi usado e um registro do número de sessões de outro aplicativo no qual o usuário usou outro item de menu no menu mesmo como esse item de menu, sem usar o item de menu específico. Quando esse valor atinge certos valores limites, a contagem será diminuída. Quando a contagem chega a zero, IsPriorityDropped é definido como True. Programadores não podem definir o valor de sessão, o valor limite ou a propriedade IsPriorityDropped. Programadores Entretanto, podem utilizar a propriedade AdaptiveMenus para desativar os menus adaptáveis de menus específicos em um aplicativo.
Para determinar quando definir IsPriorityDropped como True para um controle específico da barra de ferramentas, o Office mantém uma lista na ordem em que todos os controles na barra de ferramentas que foram executados última. Uma barra de ferramentas sempre mostrará quantos controles tem espaço para mostrar, na ordem mais recentemente usados para menos utilizados recentemente. Controles com prioridade definida como 1 sempre serão exibidos e a barra de ferramentas serão quebrados linhas, se necessário, para mostrar esses controles. Os programadores podem usar a propriedade Priority para garantir que os controles de barra de ferramentas específica sempre são mostrados ou reposicionar as barras de ferramentas para que eles tenham espaço suficiente para exibir todos os seus controles.
Use a tabela a seguir para prever o número de sessões para as quais um item de menu em um menu personalizado permanecerá visível antes que a propriedade IsPriorityDropped do item de menu seja definida como True.
| Número de usos do controle da barra de comandos | Número de sessões do aplicativo |
|---|---|
| 0, 1 | 3 |
| 2 | 6 |
| 3 | 9 |
| 4, 5 | 12 |
| 6–8 | 17 |
| 9–13 | 23 |
| 14–24 | 29 |
| 25 ou mais | 31 |
Exemplo
Este exemplo verifica a propriedade IsPriorityDropped para obter o primeiro controle na barra de comandos chamada Custom. Se IsPriorityDropped for True, o exemplo define a propriedade AdaptiveMenus como False, restaurando a barra de comandos.
If CommandBars("Custom").Controls(1).IsPriorityDropped Then
CommandBars.AdaptiveMenus = True
End If
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.