_CommandBarButton.IsPriorityDropped Propriété

Définition

Espace de noms:

Microsoft.Office.Core

Assembly:

office.dll

Retourne une valeur qui indique si le contrôle est actuellement supprimé du menu ou de la barre d’outils en fonction des statistiques d’utilisation et de l’espace de disposition.

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

public bool IsPriorityDropped { get; }

member this.IsPriorityDropped : bool

Public ReadOnly Property IsPriorityDropped As Boolean

Valeur de propriété

Boolean

Implémente

IsPriorityDropped

Remarques

Notez que la valeur retournée ne représente pas la visibilité du contrôle, comme défini par la Visible propriété . Un contrôle avec Visible défini sur True ne sera pas immédiatement visible dans un menu ou une barre d’outils personnalisé si IsPriorityDropped a lavaleur True.

Pour déterminer quand la valeur True doit être affectée à la propriété IsPriorityDropped pour un élément de menu spécifique, Microsoft Office conserve un décompte du nombre d'utilisations de l'élément de menu en question et un enregistrement du nombre de sessions d'application au cours desquelles l'utilisateur a utilisé un autre élément du même menu, sans utiliser l'élément de menu en question. Lorsque cette valeur atteint un certain seuil, le décompte est décrémenté. Lorsque le décompte atteint zéro, la valeur True est affectée à la propriété IsPriorityDropped. Les programmeurs ne peuvent pas définir la valeur de session, la valeur seuil, ni la propriété IsPriorityDropped. Toutefois, les programmeurs peuvent utiliser la propriété pour désactiver les AdaptiveMenus menus adaptatifs pour des menus spécifiques dans une application.

Pour déterminer quand la valeur True doit être affectée à la propriété IsPriorityDropped pour un contrôle de barre d'outils spécifique, Office conserve une liste de l'ordre dans lequel les contrôles de cette barre d'outils ont été exécutés. Une barre d'outils affiche toujours autant de contrôles que l'espace qui lui est alloué le permet, en commençant par le bouton le plus récemment utilisé. Les contrôles dont Priority la valeur est définie sur 1 sont toujours affichés et la barre d’outils encapsule les lignes, si nécessaire, pour afficher ces contrôles. Les programmeurs peuvent utiliser la propriété Priority pour s'assurer que certains contrôles de barre d'outils seront toujours affichés ou pour repositionner une barre d'outils de manière à lui attribuer suffisamment de place pour afficher tous les contrôles.

Vous pouvez utiliser le tableau suivant pour prédire le nombre de sessions pour lesquelles un élément de menu d’un menu personnalisé restera visible avant que la propriété IsPriorityDropped de l’élément de menu soit définie sur True.

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