_CommandBarButton.IsPriorityDropped Propriedade

Definição

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Retorna um valor que indica se o controle está descartado no momento do menu ou da barra de ferramentas com base nas estatísticas de uso e no espaço de layout.

public:
 property bool IsPriorityDropped { bool get(); };

public bool IsPriorityDropped { get; }

member this.IsPriorityDropped : bool

Public ReadOnly Property IsPriorityDropped As Boolean

Valor da propriedade

Boolean

Implementações

IsPriorityDropped

Comentários

Observe que o valor retornado não representa a visibilidade do controle, conforme definido pela Visible propriedade. 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. Os programadores podem, no entanto, usar a AdaptiveMenus propriedade para desabilitar menus adaptáveis para 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 Priority definido como 1 sempre serão mostrados e a barra de ferramentas envolverá 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.

Você pode usar a tabela a seguir para prever o número de sessões para o qual um item de menu em um menu personalizado permanecerá visível antes da propriedade IsPriorityDropped do item de menu é definida como True.

	0,1	3
	2	6
	3	9
	4, 5	12
	6-8	17
	9-13	23
	14-24	29
	25 or more	31