Keyboard.SendKeys Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Envoie une ou plusieurs séquences de touches à la fenêtre active, comme si elle était tapée sur le clavier.
Surcharges
| SendKeys(String) |
Envoie une ou plusieurs séquences de touches à la fenêtre active, comme si elle était tapée sur le clavier. |
| SendKeys(String, Boolean) |
Envoie une ou plusieurs séquences de touches à la fenêtre active, comme si elle était tapée sur le clavier. |
SendKeys(String)
Envoie une ou plusieurs séquences de touches à la fenêtre active, comme si elle était tapée sur le clavier.
public:
void SendKeys(System::String ^ keys);
public void SendKeys (string keys);
member this.SendKeys : string -> unit
Public Sub SendKeys (keys As String)
Paramètres
- keys
- String
String qui définit les touches à envoyer.
Exceptions
Il existe une situation d'un niveau de confiance partiel dans laquelle l'utilisateur ne dispose des autorisations nécessaires.
Exemples
Cet exemple utilise la My.Computer.Keyboard.SendKeys méthode pour envoyer des frappes à une application externe, l’application Bloc-notes, démarrée par la Shell méthode .
Dim ProcID As Integer
' Start the Notepad application, and store the process id.
ProcID = Shell("NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the Notepad application.
AppActivate(ProcID)
' Send the keystrokes to the Notepad application.
My.Computer.Keyboard.SendKeys("I ", True)
My.Computer.Keyboard.SendKeys("♥", True)
My.Computer.Keyboard.SendKeys(" Visual Basic!", True)
' The sentence I ♥ Visual Basic! is printed on Notepad.
Une exception ArgumentException est levée si aucune application avec l’identificateur de processus demandé n’est trouvée.
L’appel à la Shell méthode nécessite une confiance totale (SecurityException classe).
Remarques
La My.Computer.Keyboard.SendKeys méthode fournit des fonctionnalités similaires aux Send méthodes et SendWait .
L’argument wait est utile si l’autre application doit se terminer avant que votre application puisse continuer.
Notes
Étant donné qu’il n’existe aucune méthode managée pour activer une autre application, vous pouvez utiliser cette classe dans l’application actuelle, sélectionner manuellement la fenêtre à laquelle envoyer les clés, ou utiliser des méthodes d’API Windows, telles que FindWindow et SetForegroundWindow, pour forcer le focus sur d’autres applications. Pour plus d’informations, consultez Procédure pas à pas : appel d’API Windows.
L’argument keys peut spécifier n’importe quelle touche unique ou n’importe quelle touche combinée avec Alt, Ctrl ou Maj (ou toute combinaison de ces touches). Chaque clé est représentée par un ou plusieurs caractères, par a exemple pour le caractère « a » ou {ENTER} pour la clé ENTRÉE.
Pour combiner une clé avec MAJ, précédez le code de clé avec + (signe plus). Pour combiner une touche avec CTRL, précédez le code de la clé avec ^ (caret). Pour combiner une clé avec ALT, précédez le code de clé avec % (signe pourcentage). Pour spécifier des clés répétées, utilisez le numéro} de clé de formulaire{. Vous devez placer un espace entre la clé et le nombre. Par exemple, {LEFT 42} signifie « appuyez 42 fois sur la flèche gauche » ; {h 10} signifie « appuyez sur 'h' 10 fois ».
Le tableau suivant répertorie les codes qui peuvent être utilisés pour spécifier des caractères qui ne sont pas affichés lorsque vous appuyez sur la touche correspondante (par exemple, ENTRÉE ou TAB).
| Clé | Code |
|---|---|
| Ret.arr | {BACKSPACE} ou {BS} |
| BREAK | {BREAK} |
| VERR. MAJ | {CAPSLOCK} |
| CLEAR | {CLEAR} |
| Suppression | {DELETE} ou {DEL} |
| Bas | {DOWN} |
| FIN | {END} |
| ENTRÉE (pavé numérique) | {ENTER} |
| ENTRÉE | ~ |
| ÉCHAP | {ESCAPE} ou {ESC} |
| HELP | {HELP} |
| Origine | {HOME} |
| INS | {INSERT} |
| Gauche | {LEFT} |
| NUM LOCK | {NUMLOCK} |
| Pg. suiv | {PGDN} |
| Pg. préc | {PGUP} |
| RETURN | {RETURN} |
| Flèche droite | {RIGHT} |
| VERROUILLAGE DE DÉFILEMENT | {SCROLLLOCK} |
| Tab | {TAB} |
| Flèche haut | {UP} |
| F1 à F15 | {F1} à {F15} |
Disponibilité par type de projet
| Type de projet | Disponible |
|---|---|
| Application Windows | Oui |
| Bibliothèque de classes | Oui |
| Application console | Oui |
| Bibliothèque de contrôles Windows | Oui |
| Bibliothèque de contrôles web | Non |
| Service Windows | Oui |
| Site web | Non |
Voir aussi
- Computer
- Send(String)
- SendWait(String)
- Objets (Visual Basic)
- Accès au clavier (Visual Basic)
- Procédure pas à pas : Appel des API Windows
S’applique à
SendKeys(String, Boolean)
Envoie une ou plusieurs séquences de touches à la fenêtre active, comme si elle était tapée sur le clavier.
public:
void SendKeys(System::String ^ keys, bool wait);
public void SendKeys (string keys, bool wait);
member this.SendKeys : string * bool -> unit
Public Sub SendKeys (keys As String, wait As Boolean)
Paramètres
- keys
- String
String qui définit les touches à envoyer.
- wait
- Boolean
Optionnel. Valeur Boolean qui indique s'il convient ou non d'attendre que les séquences de touches soient traitées avant que l'application continue.
True par défaut.
Exceptions
Il existe une situation d'un niveau de confiance partiel dans laquelle l'utilisateur ne dispose des autorisations nécessaires.
Exemples
Cet exemple utilise la My.Computer.Keyboard.SendKeys méthode pour envoyer des frappes à une application externe, l’application Bloc-notes, démarrée par la Shell méthode .
Dim ProcID As Integer
' Start the Notepad application, and store the process id.
ProcID = Shell("NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the Notepad application.
AppActivate(ProcID)
' Send the keystrokes to the Notepad application.
My.Computer.Keyboard.SendKeys("I ", True)
My.Computer.Keyboard.SendKeys("♥", True)
My.Computer.Keyboard.SendKeys(" Visual Basic!", True)
' The sentence I ♥ Visual Basic! is printed on Notepad.
Une exception ArgumentException est levée si aucune application avec l’identificateur de processus demandé n’est trouvée.
L’appel à la Shell méthode nécessite une confiance totale (SecurityException classe).
Remarques
La My.Computer.Keyboard.SendKeys méthode fournit des fonctionnalités similaires aux Send méthodes et SendWait .
L’argument wait est utile si l’autre application doit se terminer avant que votre application puisse continuer.
Notes
Étant donné qu’il n’existe aucune méthode managée pour activer une autre application, vous pouvez utiliser cette classe dans l’application actuelle, sélectionner manuellement la fenêtre à laquelle envoyer les clés, ou utiliser des méthodes d’API Windows, telles que FindWindow et SetForegroundWindow, pour forcer le focus sur d’autres applications. Pour plus d’informations, consultez Procédure pas à pas : appel d’API Windows.
L’argument keys peut spécifier n’importe quelle touche unique ou n’importe quelle touche combinée avec Alt, Ctrl ou Maj (ou toute combinaison de ces touches). Chaque clé est représentée par un ou plusieurs caractères, par a exemple pour le caractère « a » ou {ENTER} pour la clé ENTRÉE.
Pour combiner une clé avec MAJ, précédez le code de clé avec + (signe plus). Pour combiner une touche avec CTRL, précédez le code de la clé avec ^ (caret). Pour combiner une clé avec ALT, précédez le code de clé avec % (signe pourcentage). Pour spécifier des clés répétées, utilisez le numéro} de clé de formulaire{. Vous devez placer un espace entre la clé et le nombre. Par exemple, {LEFT 42} signifie « appuyez 42 fois sur la flèche gauche » ; {h 10} signifie « appuyez sur 'h' 10 fois ».
Le tableau suivant répertorie les codes qui peuvent être utilisés pour spécifier des caractères qui ne sont pas affichés lorsque vous appuyez sur la touche correspondante (par exemple, ENTRÉE ou TAB).
| Clé | Code |
|---|---|
| Ret.arr | {BACKSPACE} ou {BS} |
| BREAK | {BREAK} |
| VERR. MAJ | {CAPSLOCK} |
| CLEAR | {CLEAR} |
| Suppression | {DELETE} ou {DEL} |
| Bas | {DOWN} |
| FIN | {END} |
| ENTRÉE (pavé numérique) | {ENTER} |
| ENTRÉE | ~ |
| ÉCHAP | {ESCAPE} ou {ESC} |
| HELP | {HELP} |
| Origine | {HOME} |
| INS | {INSERT} |
| Gauche | {LEFT} |
| NUM LOCK | {NUMLOCK} |
| Pg. suiv | {PGDN} |
| Pg. préc | {PGUP} |
| RETURN | {RETURN} |
| Flèche droite | {RIGHT} |
| VERROUILLAGE DE DÉFILEMENT | {SCROLLLOCK} |
| Tab | {TAB} |
| Flèche haut | {UP} |
| F1 à F15 | {F1} à {F15} |
Disponibilité par type de projet
| Type de projet | Disponible |
|---|---|
| Application Windows | Oui |
| Bibliothèque de classes | Oui |
| Application console | Oui |
| Bibliothèque de contrôles Windows | Oui |
| Bibliothèque de contrôles web | Non |
| Service Windows | Oui |
| Site web | Non |
Voir aussi
- Computer
- Send(String)
- SendWait(String)
- Objets (Visual Basic)
- Accès au clavier (Visual Basic)
- Procédure pas à pas : Appel des API Windows