Compartilhar via


SendKeys.Send(String) Método

Definição

Envia pressionamentos de teclas para um aplicativo ativo.

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)

Parâmetros

keys
String

A cadeia de caracteres de pressionamentos de teclas a ser enviada.

Exceções

Não há um aplicativo ativo para o qual enviar pressionamentos de teclas.

keys não representa pressionamentos de tecla válidos.

Exemplos

O exemplo de código a seguir demonstra como usar o Send método. Para executar o exemplo, cole o código a seguir em um formulário chamado Form1 que contém um botão chamado Button1. Verifique se os eventos de clique estão associados aos métodos de tratamento de eventos neste exemplo. A propriedade do controle de TabIndex botão deve ser definida como 0. Quando o exemplo estiver em execução, clique duas vezes no formulário para disparar o evento de clique do botão.

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

Comentários

Cada chave é representada por um ou mais caracteres. Para especificar um único caractere de teclado, use o próprio caractere. Por exemplo, para representar a letra A, passe a cadeia de caracteres "A" para o método. Para representar mais de um caractere, acrescente cada caractere adicional ao anterior. Para representar as letras A, B e C, especifique o parâmetro como "ABC".

O sinal de adição (+), o sinal de cuidado (^), o sinal percentual (%), o bloco (~) e os parênteses () têm significados especiais para SendKeys. Para especificar um desses caracteres, coloque-o entre chaves ({}). Por exemplo, para especificar o sinal de adição, use "{+}". Para especificar caracteres de chave, use "{{}" e "{}}". Colchetes ([ ]) não têm nenhum significado especial, SendKeysmas você deve colocá-los entre chaves. Em outros aplicativos, os colchetes têm um significado especial que pode ser significativo quando a troca dinâmica de dados (DDE) ocorre.

Cuidado

Se seu aplicativo se destina a uso internacional com uma variedade de teclados, o uso Send pode gerar resultados imprevisíveis e deve ser evitado.

Para especificar caracteres que não são exibidos quando você pressiona uma tecla, como ENTER ou TAB, e chaves que representam ações em vez de caracteres, use os códigos na tabela a seguir.

Chave Código
BACKSPACE {BACKSPACE}, {BS}ou {BKSP}
BREAK {BREAK}
CAPS LOCK {CAPSLOCK}
DEL ou DELETE {DELETE} ou {DEL}
SETA PARA BAIXO {DOWN}
END {END}
Enter {ENTER}ou ~
ESC {ESC}
HELP {HELP}
HOME {HOME}
INS ou INSERT {INSERT} ou {INS}
SETA PARA A ESQUERDA {LEFT}
NUM LOCK {NUMLOCK}
PAGE DOWN {PGDN}
PAGE UP {PGUP}
TELA DE IMPRESSÃO {PRTSC} (reservado para uso futuro)
SETA PARA A DIREITA {RIGHT}
SCROLL LOCK {SCROLLLOCK}
TAB {TAB}
SETA PARA CIMA {UP}
F1 {F1}
F2 {F2}
F3 {F3}
F4 {F4}
F5 {F5}
F6 {F6}
F7 {F7}
F8 {F8}
F9 {F9}
F10 {F10}
F11 {F11}
F12 {F12}
F13 {F13}
F14 {F14}
F15 {F15}
F16 {F16}
Adicionar teclado {ADD}
Subtraído do teclado {SUBTRACT}
Multiplicação do teclado {MULTIPLY}
Divisão do teclado {DIVIDE}

Para especificar chaves combinadas com qualquer combinação das chaves SHIFT, CTRL e ALT, preceda o código de chave com um ou mais dos códigos a seguir.

Chave Código
SHIFT +
CTRL ^
ALT %

Para especificar que qualquer combinação de SHIFT, CTRL e ALT deve ser mantida pressionada enquanto várias outras chaves são pressionadas, coloque o código para essas chaves em parênteses. Por exemplo, para especificar para segurar SHIFT enquanto E e C são pressionados, use "+(EC)". Para especificar para segurar SHIFT enquanto E é pressionado, seguido por C sem SHIFT, use "+EC".

Para especificar chaves repetidas, use o formulário {número de chave}. Você deve colocar um espaço entre chave e número. Por exemplo, {LEFT 42} significa pressionar a tecla LEFT ARROW 42 vezes; {h 10} significa pressionar H 10 vezes.

Observação

Como não há nenhum método gerenciado para ativar outro aplicativo, você pode usar essa classe dentro do aplicativo atual ou usar métodos nativos Windows, como FindWindow eSetForegroundWindow, para forçar o foco em outros aplicativos.

Observação

A SendKeys classe foi atualizada para o .NET Framework 3.0 para habilitar seu uso em aplicativos executados no Windows Vista. A segurança avançada do Windows Vista (conhecida como Controle de Conta de Usuário ou UAC) impede que a implementação anterior funcione conforme o esperado.

A SendKeys classe é suscetível a problemas de tempo, que alguns desenvolvedores tiveram que resolver. A implementação atualizada ainda está suscetível a problemas de atraso, mas é ligeiramente mais rápida e pode exigir alterações para as soluções alternativas. A SendKeys classe tenta usar a implementação anterior primeiro e, se isso falhar, usa a nova implementação. Como resultado, a SendKeys classe pode se comportar de forma diferente em diferentes sistemas operacionais. Além disso, quando a SendKeys classe usa a nova implementação, o método não aguardará que as SendWait mensagens sejam processadas quando forem enviadas para outro processo.

Se o aplicativo depender de um comportamento consistente, independentemente do sistema operacional, você poderá forçar a SendKeys classe a usar a nova implementação adicionando a seguinte configuração de aplicativo ao arquivo app.config.

<appSettings>

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

</appSettings>

Para forçar a SendKeys classe a usar a implementação anterior, use o valor "JournalHook" em vez disso.

Aplica-se a