CommandBarControl.IsPriorityDropped Propriété

Définition

Espace de noms:

Microsoft.Office.Core

Assembly:

office.dll

Détermine 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

Remarques

Cette propriété renvoie la valeur True 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 . False si ce n’est pas le cas. Notez que cela n’est pas identique à 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 personnalisé ou une barre d’outils 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é. Tous les contrôles dont la propriété Priority a la valeur 1 sont toujours affichés et la barre d'outils s'affichera sur deux lignes s'il n'y a pas suffisamment de place. 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