Partager via


Élément d’indicateur de commande

Modifie son élément parent.

Syntaxe

<CommandFlag>DynamicVisibility</CommandFlag>

Attributs et éléments

La section suivante décrit les valeurs d’élément valides.

Attributs

Aucune.

Éléments enfants

Valeur Description
AllowParams Indique que les utilisateurs peuvent entrer des paramètres de commande dans la fenêtre Commande lorsqu’ils tapez le nom canonique de la commande.

Valide pour : Button
AlwaysCreate Le menu est créé même s’il n’a pas de groupes ou de boutons.

Valide pour : Menu
CaseSensitive Les entrées utilisateur respectent la casse.

Valide pour : Combo
CommandWellOnly Appliquez cet indicateur si la commande n’apparaît pas dans le menu de niveau supérieur et que vous souhaitez la rendre disponible pour une personnalisation d’interpréteur de commandes supplémentaire, par exemple pour la lier à un raccourci clavier. Une fois que VSPackage est installé, vous pouvez personnaliser ces commandes en ouvrant la boîte de dialogue Options , puis en modifiant l’emplacement des commandes sous la catégorie Environnement du clavier. Cet indicateur n’affecte pas le positionnement sur les menus contextuels, les barres d’outils, les contrôleurs de menu ou les sous-menus.

Valide pour : Button, Combo
DefaultDisabled Par défaut, la commande est désactivée si le VSPackage qui implémente qu’il n’est pas chargé ou que la QueryStatus méthode n’a pas été appelée.

Valide pour : Button, Combo
DefaultDocked Ancré par défaut. Ce paramètre ne s’applique plus aux barres d’outils, car elles sont toujours ancrées.
DefaultInvisible Par défaut, la commande est invisible si le VSPackage qui implémente qu’il n’est pas chargé ou que la QueryStatus méthode n’a pas été appelée.

Nous vous recommandons de combiner cela avec l’indicateur DynamicVisibility .

Valide pour : Button, , ComboMenu
DontCache L’environnement de développement ne met pas en cache les résultats de la QueryStatus méthode pour cette commande.

Pour un menu, cela indique à un contrôleur de menu de ne pas mettre en cache le texte de ses éléments de menu. Utilisez cet indicateur lorsque le menu contient des éléments dynamiques ou des éléments qui ont du texte dynamique.

Valide pour : Button, Menu
DynamicAutomationName Spécifie que votre gestionnaire QueryStatus répond à OLECMDTEXTFEXT_AUTOMATIONNAME et retourne une chaîne à utiliser comme nom d’automatisation pour votre contrôle. Si vous utilisez OleMenuCommand, vous pouvez définir la propriété AutomationName dans votre gestionnaire BeforeQueryStatus si vous avez défini cet indicateur.

Lorsqu’il est utilisé sur un élément Menu, cet indicateur s’applique uniquement aux menus de type MenuController ou MenuControllerLatched.

Valide pour : Button, , ComboMenu
DynamicItemStart Indique le début d’une liste dynamique. Cela permet à l’environnement de générer une liste en appelant successivement la QueryStatus méthode sur les éléments de liste jusqu’à ce que l’indicateur de OLECMDERR_E_UNSUPPORTED soit retourné. Cela fonctionne bien pour les éléments tels que les listes (MRU) les plus récemment utilisées et les listes de fenêtres.

Valide pour : Button
DynamicVisibility La visibilité de la commande peut être modifiée par le biais de la QueryStatus méthode ou d’un GUID de contexte inclus dans la VisibilityConstraints section.

S’applique aux commandes qui s’affichent dans les menus et les barres d’outils de fenêtre d’outils, mais pas dans les barres d’outils de niveau supérieur qui apparaissent dans la fenêtre principale. Les éléments de barre d’outils de niveau supérieur peuvent être désactivés, mais pas masqués, lorsque l’indicateur de OLECMDF_INVISIBLE est retourné à partir de la QueryStatus méthode. Les commandes de barre d’outils qui s’affichent dans les barres d’outils peuvent être masquées.

Dans un menu, cet indicateur indique également qu’il doit être automatiquement masqué lorsque tous ses membres sont masqués. Cet indicateur est généralement affecté à des sous-menus, car les menus de niveau supérieur ont déjà ce comportement.

Cet indicateur doit être combiné à l’indicateur DefaultInvisible .

Valide pour : Button, , ComboMenu
FilterKeys Consultez la rubrique Clés de filtrage sous Élément combo.

Valide pour : Combo
FixMenuController Si cette commande est positionnée sur un contrôleur de menu, la commande est toujours la valeur par défaut ; autrement dit, la commande est sélectionnée chaque fois que le bouton du contrôleur de menu lui-même est sélectionné. Si le contrôleur de menu a l’indicateur TextIsAnchorCommand défini, le contrôleur de menu prend également son texte à partir de la commande qui a l’indicateur FixMenuController .

Une seule commande sur un contrôleur de menu doit avoir l’indicateur FixMenuController . Si plusieurs commandes sont ainsi marquées, la dernière commande du menu devient la commande par défaut.

Valide pour : Button
IconAndText Afficher une icône et du texte dans le menu et la barre d’outils.

Valide pour : Button, , ComboMenu
NoAutoComplete La fonctionnalité de saisie semi-automatique est désactivée.

Valide pour : Combo
NoButtonCustomize Ne laissez pas l’utilisateur personnaliser ce bouton.

Valide pour : Button, Combo
NoKeyCustomize N’activez pas la personnalisation du clavier.

Valide pour : Button, Combo
NoShowOnMenuController Si cette commande est positionnée sur un contrôleur de menu, la commande n’apparaît pas dans la liste déroulante.

Valide pour : Button
NotIn To List N’apparaît pas dans la liste des barres d’outils disponibles. Cela est valide uniquement pour les types de menus de barre d’outils.

Valide pour : Menu
NoToolbarClose L’utilisateur ne peut pas fermer la barre d’outils. Cela est valide uniquement pour les types de menus de barre d’outils.

Valide pour : Menu
Pict Afficher uniquement une icône dans une barre d’outils, mais uniquement du texte dans un menu. Si aucune icône n’est spécifiée, affiche un espace vide cliquable dans une barre d’outils.

Valide pour : Button
PostExec Rend la commande non bloquante. L’environnement de développement reporte l’exécution jusqu’à ce que toutes les requêtes de prétraitement soient terminées.

Valide pour : Button
RouteToDocs La commande est routée vers le document actif.

Valide pour : Button
StretchHorizontally Lorsque cet indicateur est défini, la largeur devient la largeur minimale de la zone de liste modifiable et, s’il y a de la place dans la barre d’outils, la zone de liste modifiable s’étend pour remplir l’espace disponible. Cela se produit uniquement si la barre d’outils est ancrée horizontalement et qu’une seule zone de liste modifiable de la barre d’outils peut utiliser l’indicateur (l’indicateur est ignoré sur tous, à l’exception de la première zone de liste modifiable).

Valide pour : Combo
TextChanges La commande ou le texte du menu peut être modifié au moment de l’exécution, généralement par le biais de la QueryStatus méthode.

Valide pour : Button, Menu
TextChangesButton Valide pour : Button
TextIsAnchorCommand Pour un contrôleur de menu, le texte du menu est extrait de la commande par défaut (ancre). Une commande d’ancrage est la dernière commande sélectionnée ou latchée. Si cet indicateur n’est pas défini, le contrôleur de menu utilise son propre MenuText champ. Toutefois, le fait de cliquer sur le contrôleur de menu active toujours la dernière commande sélectionnée à partir de ce contrôleur.

Nous vous recommandons de combiner cet indicateur avec l’indicateur TextChanges .

Cet indicateur s’applique uniquement aux menus de type MenuController ou MenuControllerLatched.

Valide pour : Menu
TextMenuCtrlUseMenu Utilisez le MenuText champ sur les contrôleurs de menu. Le champ par défaut est ButtonText.

Valide pour : Button
TextMenuUseButton Utilisez le ButtonText champ pour les menus. Le champ par défaut est MenuText s’il est spécifié.

Valide pour : Button
TextOnly Afficher uniquement du texte dans une barre d’outils ou un menu, mais aucune icône même si l’icône est spécifiée.

Valide pour : Button
TogglePatternAvailable Indique que votre bouton prend en charge l’case activée ed/latched (autrement dit, peut renvoyer OLEMCDF_LATCHED ou définir la propriété Checked sur OleMenuCommand). Cela permet à la couche Automation d’exposer le modèle bascule afin que les lecteurs d’écran lisent l’état case activée/non case activée ed avec le texte de votre bouton.

Valide pour : Button

Éléments parents

Élément Description
Élément Buttons Fournit un groupe pour les éléments d’élément Button.
Élément Menus Définit tous les menus implémentés par un VSPackage.

Voir aussi