Keyboard.SendKeys Méthode

Définition

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

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

S’applique à