SendKeys.Send(String) SendKeys.Send(String) SendKeys.Send(String) SendKeys.Send(String) Method

Определение

Посылает сообщения о нажатии клавиш активному приложению.Sends keystrokes to the active application.

public:
 static void Send(System::String ^ keys);
public static void Send (string keys);
static member Send : string -> unit
Public Shared Sub Send (keys As String)

Параметры

keys
String String String String

Строка, содержащая отправляемые данные о нажатиях клавиш.The string of keystrokes to send.

Исключения

Отсутствует активное приложение для отправки сообщений о нажатии клавиш.There is not an active application to send keystrokes to.

Объект keys не представляет допустимые сообщения о нажатии клавиш.keys does not represent valid keystrokes

Примеры

В следующем примере кода показано, как использовать Send метод. Чтобы выполнить пример, вставьте следующий код в форму с именем Form1, содержащую кнопку с именем Button1.The following code example demonstrates how to use the Send method.To run the example, paste the following code in a form called Form1 containing a button called Button1. Убедитесь, что события щелчка связаны с методами обработки событий в этом примере.Ensure the click events are associated with their event-handling methods in this example. TabIndex Свойству элемента управления "Кнопка" должно быть присвоено значение 0.The button control's TabIndex property should be set to 0. При выполнении примера дважды щелкните форму, чтобы активировать событие нажатия кнопки.When the example is running, double-click the form to trigger the button's click event.

private:
   // Clicking Button1 causes a message box to appear.
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      MessageBox::Show( "Click here!" );
   }

   // Use the SendKeys.Send method to raise the Button1 click event 
   // and display the message box.
   void Form1_DoubleClick( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Send the enter key; since the tab stop of Button1 is 0, this
      // will trigger the click event.
      SendKeys::Send( "{ENTER}" );
   }

// Clicking Button1 causes a message box to appear.
private void Button1_Click(System.Object sender, System.EventArgs e)
{
	MessageBox.Show("Click here!");
}


// Use the SendKeys.Send method to raise the Button1 click event 
// and display the message box.
private void Form1_DoubleClick(object sender, System.EventArgs e)
{

	// Send the enter key; since the tab stop of Button1 is 0, this
	// will trigger the click event.
	SendKeys.Send("{ENTER}");
}

' Clicking Button1 causes a message box to appear.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click
    MessageBox.Show("Click here!")
End Sub


' Use the SendKeys.Send method to raise the Button1 click event 
' and display the message box.
Private Sub Form1_DoubleClick(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles MyBase.DoubleClick

    ' Send the enter key; since the tab stop of Button1 is 0, this
    ' will trigger the click event.
    SendKeys.Send("{ENTER}")
End Sub

Комментарии

Каждый ключ представлен одним или несколькими символами.Each key is represented by one or more characters. Чтобы указать одиночный символ клавиатуры, используйте сам символ.To specify a single keyboard character, use the character itself. Например, чтобы представить букву A, передайте в метод строку "A".For example, to represent the letter A, pass in the string "A" to the method. Чтобы представить более одного символа, добавьте каждый дополнительный символ в предыдущий.To represent more than one character, append each additional character to the one preceding it. Чтобы представить буквы A, B и C, укажите для параметра значение "ABC".To represent the letters A, B, and C, specify the parameter as "ABC".

Знак плюс (+), символ (^), знак процента (%), тильда (~) и круглые скобки () имеют специальное значение SendKeys.The plus sign (+), caret (^), percent sign (%), tilde (~), and parentheses () have special meanings to SendKeys. Чтобы указать один из этих символов, заключите его в фигурные скобки ({}).To specify one of these characters, enclose it within braces ({}). Например, чтобы указать знак "плюс", используйте "{+}".For example, to specify the plus sign, use "{+}". Чтобы указать символы фигурных скобок, используйте{}"{"{}и "}".To specify brace characters, use "{{}" and "{}}". Квадратные скобки ([]) не имеют SendKeysособого смысла, но их необходимо заключить в фигурные скобки.Brackets ([ ]) have no special meaning to SendKeys, but you must enclose them in braces. В других приложениях скобки имеют специальное значение, которое может быть значительным при выполнении динамического обмена данными (DDE).In other applications, brackets do have a special meaning that might be significant when dynamic data exchange (DDE) occurs.

Внимание!

Если приложение предназначено для международного использования с различными клавиатурами, применение метода Send может иметь непредсказуемые результаты и его следует избегать.If your application is intended for international use with a variety of keyboards, the use of Send could yield unpredictable results and should be avoided.

Чтобы указать символы, которые не отображаются при нажатии клавиши, например ENTER или TAB, а также ключи, представляющие действия, а не символы, используйте коды, приведенные в следующей таблице.To specify characters that aren't displayed when you press a key, such as ENTER or TAB, and keys that represent actions rather than characters, use the codes in the following table.

КлючKey КодCode
BACKSPACEBACKSPACE {Backspace}, {BS} или {БКСП}{BACKSPACE}, {BS}, or {BKSP}
РАЗБИЕНИBREAK РАЗБИЕНИ{BREAK}
CAPS LOCKCAPS LOCK {КАПСЛОКК}{CAPSLOCK}
DEL или DELETEDEL or DELETE {DELETE} или {DEL}{DELETE} or {DEL}
СТРЕЛКА ВНИЗDOWN ARROW КРЫВАЮЩЕЙ{DOWN}
ENDEND КОНЦЕ{END}
ВВОДENTER {ENTER} или ~{ENTER}or ~
ESCESC ESC{ESC}
СПРАВКАHELP ПОЗВОЛЯЮТ{HELP}
ГЛАВНАЯHOME ДОМОМ{HOME}
INS или INSERTINS or INSERT {INSERT} или {INS}{INSERT} or {INS}
СТРЕЛКА ВЛЕВОLEFT ARROW СЛЕВА{LEFT}
NUM LOCKNUM LOCK NUMLOCK{NUMLOCK}
PAGE DOWNPAGE DOWN PAGE DOWN{PGDN}
PAGE UPPAGE UP PAGE UP{PGUP}
ПЕЧАТЬ ЭКРАНАPRINT SCREEN {ПРТСК} (зарезервировано для будущего использования){PRTSC} (reserved for future use)
СТРЕЛКА ВПРАВОRIGHT ARROW СПРАВА{RIGHT}
ПРОКРУТИТЬ БЛОКИРОВКУSCROLL LOCK {СКРОЛЛЛОКК}{SCROLLLOCK}
TABTAB ВКЛАДКЕ{TAB}
СТРЕЛКА ВВЕРХUP ARROW КРЫВАЮЩЕМСЯ{UP}
F1F1 {F1}{F1}
F2F2 {F2}{F2}
F3F3 {F3}{F3}
F4F4 {F4}{F4}
F5F5 {F5}{F5}
F6F6 {F6}{F6}
F7F7 {F7}{F7}
F8F8 {F8}{F8}
F9F9 {F9}{F9}
F10F10 {F10}{F10}
F11F11 {F11}{F11}
F12F12 {F12}{F12}
F13F13 {F13}{F13}
F14F14 {F14}{F14}
F15F15 {F15}{F15}
F16F16 {F16}{F16}
Добавление клавиатурыKeypad add ВКЛЮЧИТЬ{ADD}
Вычитание с клавиатурыKeypad subtract ВЫЧЕСТЬ{SUBTRACT}
Умножение клавиатурыKeypad multiply ПЕРЕМНОЖАЕМЫХ{MULTIPLY}
Разделительная клавишаKeypad divide ДЕЛЕНИЕ{DIVIDE}

Чтобы указать ключи в сочетании с любым сочетанием клавиш SHIFT, CTRL и ALT, перед кодом клавиши укажите один или несколько из следующих кодов.To specify keys combined with any combination of the SHIFT, CTRL, and ALT keys, precede the key code with one or more of the following codes.

КлючKey КодCode
МЕСТИSHIFT +
КОМБИНАЦИCTRL ^
МЕЩАЮЩИЙALT %

Чтобы указать, что сочетание клавиш SHIFT, CTRL и ALT должно удерживаться при нажатии нескольких других клавиш, заключите код этих клавиш в круглые скобки.To specify that any combination of SHIFT, CTRL, and ALT should be held down while several other keys are pressed, enclose the code for those keys in parentheses. Например, чтобы указать, чтобы при нажатии клавиш «E» и «C» использовались клавиши SHIFT, используйте «+ (EC)».For example, to specify to hold down SHIFT while E and C are pressed, use "+(EC)". Чтобы указать, что при нажатии клавиши «E», а затем C без СДВИГа, следует использовать «+ EC».To specify to hold down SHIFT while E is pressed, followed by C without SHIFT, use "+EC".

Чтобы указать повторяющиеся ключи, используйте форму {номер ключа}.To specify repeating keys, use the form {key number}. Необходимо поставить пробел между ключом и числом.You must put a space between key and number. Например, {LEFT 42} означает нажатие клавиши со стрелкой влево 42 раз; {h 10} означает нажатие клавиши H 10 раз.For example, {LEFT 42} means press the LEFT ARROW key 42 times; {h 10} means press H 10 times.

Примечание

Поскольку нет управляемого метода для активации другого приложения, можно либо использовать этот класс в текущем приложении, либо использовать собственные методы Windows, такие как FindWindow и SetForegroundWindow, чтобы принудительно сосредоточиться на других приложениях.Because there is no managed method to activate another application, you can either use this class within the current application or use native Windows methods, such as FindWindow and SetForegroundWindow, to force focus on other applications.

Примечание

Класс SendKeys был обновлен в .NET Framework 3.0, что позволило использовать его в приложениях, работающих в Windows Vista.The SendKeys class has been updated for the .NET Framework 3.0 to enable its use in applications that run on Windows Vista. Усиленная система безопасности Windows Vista (известная как контроль учетных записей или UAC) не позволяет предыдущей реализации работать должным образом.The enhanced security of Windows Vista (known as User Account Control or UAC) prevents the previous implementation from working as expected.

Класс SendKeys подвержен проблемам со временем, которые пришлось решать некоторым разработчикам.The SendKeys class is susceptible to timing issues, which some developers have had to work around. Обновленная реализация по-прежнему подвержена этим проблемам, но она работает немного быстрее, поэтому существующие решения может потребоваться переработать.The updated implementation is still susceptible to timing issues, but is slightly faster and may require changes to the workarounds. Класс SendKeys сначала пытается использовать предыдущую реализацию, и если это не удается, использует новую реализацию.The SendKeys class tries to use the previous implementation first, and if that fails, uses the new implementation. В результате класс SendKeys может работать по-разному в разных операционных системах.As a result, the SendKeys class may behave differently on different operating systems. Кроме того, при использовании новой реализации класса SendKeys метод SendWait не будет дожидаться обработки сообщений, если они отправляются другому процессу.Additionally, when the SendKeys class uses the new implementation, the SendWait method will not wait for messages to be processed when they are sent to another process.

Если необходимо обеспечить согласованное поведение приложения независимо от операционной системы, можно заставить класс SendKeys использовать новую реализацию, добавив указанный ниже параметр приложения в файл app.config.If your application relies on consistent behavior regardless of the operating system, you can force the SendKeys class to use the new implementation by adding the following application setting to your app.config file.

<appSettings>

<add key="SendKeys" value="SendInput"/>

</appSettings>

Для принудительного использования классом SendKeys предыдущей реализации задайте значение "JournalHook" .To force the SendKeys class to use the previous implementation, use the value "JournalHook" instead.

Безопасность

SecurityPermission
для неуправляемого кода, чтобы вызвать этот метод.for unmanaged code to call this method. Связанное перечисление:UnmanagedCodeAssociated enumeration: UnmanagedCode

Применяется к