Partager via

Command.Bindings, propriété

  • Article

Définit ou obtient la liste des séquences de touches utilisées pour appeler la commande.

Espace de noms :  EnvDTE
Assembly :  EnvDTE (dans EnvDTE.dll)

Syntaxe

'Déclaration
Property Bindings As Object

Object Bindings { get; set; }

property Object^ Bindings {
    Object^ get ();
    void set (Object^ value);
}

abstract Bindings : Object with get, set

function get Bindings () : Object 
function set Bindings (value : Object)

Valeur de propriété

Type : Object
SafeArray d'objets.

Notes

Bindings définit ou retourne un SafeArray d'objets contenant des chaînes décrivant l'ensemble des combinaisons de touches pour la commande. Pour ajouter des combinaisons de touches à la commande, ajoutez-les au SafeArray, puis redéfinissez-le ensuite. Pour supprimer des combinaisons de touches de la commande, supprimez-les du SafeArray, puis redéfinissez-le ensuite.

La syntaxe de chaque chaîne est l'une des syntaxes suivantes (où "modifiers+" est facultatif) :

  • "scopename::modifiers+key"

  • "scopename::modifiers+key, modifiers+key"

Les modificateurs « ctrl+ », « alt+ », et « shift+ », qui doivent être spécifiés en anglais. Leur ordre de leur apparition n'a pas d'importance. Le premier modificateur ou spécificateur de touche se situe immédiatement après le double deux-points (::). Dans une séquence de touches, tout séparateur de type virgule est suivi d'un espace.

Tous les rapports utilisent une casse mixte, par exemple "Ctrl+Espace", mais vous pouvez utiliser n'importe quelle combinaison de casse lors de l'ajout de nouvelles combinaisons.

Les espaces sont traités comme des littéraux dans la chaîne de combinaison de touches. Il n'existe pas de séquence d'échappement pour les espaces et les caractères de tabulation, etc. Voici quelques exemples de paramètres de combinaison de touches :

  • "Text Editor::ctrl+r, ctrl+r"

  • "Global::ctrl+o"

  • "Global::f2"

Bindings retourne Nothing pour les commandes pour lesquelles il n'est pas possible de définir des combinaisons de touches ; en d'autres termes, elles n'apparaissent pas dans la page de propriétés Options relative à la configuration du clavier, accessible via le menu Outils. Si vous essayez de définir cette propriété pour une commande de ce type, une erreur est retournée.

Notes

Vous ne pouvez pas modifier par programme les paramètres du schéma de configuration par défaut du clavier.Pour modifier les paramètres définis, enregistrez une copie du schéma de configuration par défaut du clavier dans le nœud Clavier de la boîte de dialogue Options.Vous pouvez alors modifier les paramètres dans ce schéma de configuration.

Exemples

Sub BindingsExample()
    Dim cmds As Commands
    Dim cmd As Command
    Dim props As EnvDTE.Properties = DTE.Properties("Environment", _
    "Keyboard")
    Dim prop As EnvDTE.Property

    ' Set references to the Commands collection and the File.NewFile 
    ' command.
    cmds = DTE.Commands
    cmd = cmds.Item("File.NewFile")

    ' Assigns the command (File.NewFile) globally to the F2 key.
    ' Because you cannot programmatically change the default keyboard 
    ' mapping scheme settings, you must first make a copy of the 
    ' Default Settings for the Keyboard Mapping Scheme.
    prop = props.Item("Scheme")
    ' Sets the Scheme property value to a new keyboard scheme.
    ' This saves the old keyboard mapping scheme and allows you 
    ' to add new key mappings.
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
    prop.Value = "C:\Documents and Settings\johndoe\Application _
    Data\Microsoft\VisualStudio\8.0\MyNewKbdScheme.vsk"
    MsgBox("PROP NAME: " & prop.Name & "   VALUE: " & prop.Value)
    cmd.Bindings = "Global::f2"
End Sub

Sécurité .NET Framework

Voir aussi

Référence

Command Interface

EnvDTE, espace de noms

Autres ressources

Association de touches à des commandes de complément