Evento WebBrowserControl. KeyUp (Access)WebBrowserControl.KeyUp event (Access)

O evento KeyUp ocorre quando o usuário libera uma tecla enquanto um formulário ou controle tenha o foco.The KeyUp event occurs when the user releases a key while a form or control has the focus. Esse evento também ocorre se você enviar um pressionamento de tecla para um formulário ou controle usando a ação EnviarSequênciaDeCaracteres em uma macro ou da instrução SendKeys no Visual Basic.This event also occurs if you send a keystroke to a form or control by using the SendKeys action in a macro or the SendKeys statement in Visual Basic.

SintaxeSyntax

expressão. KeyUp (KeyCode, Shift)expression.KeyUp (KeyCode, Shift)

expressão Uma variável que representa um objeto WebBrowserControl .expression A variable that represents a WebBrowserControl object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
KeyCodeKeyCode ObrigatórioRequired IntegerInteger Um código de tecla, como vbKeyF1 (a tecla F1) ou vbKeyHome (a tecla Home).A key code, such as vbKeyF1 (the F1 key) or vbKeyHome (the Home key). Para especificar códigos de tecla, use as constantes intrínsecas mostradas no Pesquisador de objetos.To specify key codes, use the intrinsic constants shown in the Object Browser. Você pode impedir que um objeto receba um pressionamento de __ tecla definindo KeyCode como 0.You can prevent an object from receiving a keystroke by setting KeyCode to 0.
ShiftShift ObrigatórioRequired IntegerInteger O estado das teclas Shift, CTRL e Alt no momento do evento.The state of the Shift, Ctrl, and Alt keys at the time of the event. Se for necessário testar o argumento Shift , você poderá usar uma das seguintes constantes intrínsecas como máscaras de bits:If you need to test for the Shift argument, you can use one of the following intrinsic constants as bit masks:
  • acShiftMask A máscara de bits para a tecla Shift.acShiftMask The bit mask for the Shift key.

  • acCtrlMask A máscara de bits para a tecla CTRL.acCtrlMask The bit mask for the Ctrl key.

  • acAltMask A máscara de bits para a tecla Alt.acAltMask The bit mask for the Alt key.

Valor de retornoReturn value

NadaNothing

ComentáriosRemarks

Para executar um macro ou procedimento de evento quando esses eventos ocorrerem, defina a propriedade OnKeyUp com o nome da macro ou como [procedimento do evento].To run a macro or event procedure when these events occur, set the OnKeyUp property to the name of the macro or to [Event Procedure].

Para ambos os eventos, o objeto com o foco recebe todos os pressionamentos de teclas.For both events, the object with the focus receives all keystrokes. Um formulário pode ter o foco somente se não tiver controles ou se todos os seus controles visíveis estiverem desativados.A form can have the focus only if it has no controls or all its visible controls are disabled.

Um formulário também receberá todos os eventos de teclado, mesmo aqueles que ocorrem para controles, se você definir a propriedade KeyPreview do formulário como Sim.A form will also receive all keyboard events, even those that occur for controls, if you set the KeyPreview property of the form to Yes. Com a configuração dessa propriedade, todos os eventos de teclado ocorrem primeiro para o formulário e, em seguida, para o controle que tem o foco.With this property setting, all keyboard events occur first for the form, and then for the control that has the focus. Você pode responder a teclas específicas pressionadas no formulário, independentemente de qual controle tem o foco.You can respond to specific keys pressed in the form, regardless of which control has the focus. Por exemplo, você pode querer a combinação de teclas CTRL + X para sempre executar a mesma ação em um formulário.For example, you may want the key combination Ctrl+X to always perform the same action on a form.

Se você pressionar e manter pressionada uma tecla, os eventos KeyDown e KeyPress serão alternados repetidamente (KeyDown, KeyPress, KeyDown, KeyPresse assim por diante) até que a tecla seja liberada e, em seguida, ocorrerá o evento KeyUp .If you press and hold down a key, the KeyDown and KeyPress events alternate repeatedly (KeyDown, KeyPress, KeyDown, KeyPress, and so on) until you release the key, then the KeyUp event occurs.

Embora o evento KeyUp ocorra quando a maioria das teclas é pressionada, ele geralmente é utilizado para reconhecer ou diferenciar:Although the KeyUp event occurs when most keys are pressed, it is typically used to recognize or distinguish between:

  • Teclas de caracteres estendidos, como as teclas de função.Extended character keys, such as function keys.

  • Teclas de navegação, como Home, end, PgUp, PgDn, seta para cima, seta para baixo, seta para a direita, seta para a esquerda e tabulação.Navigation keys, such as Home, End, PgUp, PgDn, Up arrow, Down arrow, Right arrow, Left arrow, and Tab.

  • Combinações de teclas e modificadores de teclado padrão (teclas Shift, CTRL ou ALT).Combinations of keys and standard keyboard modifiers (Shift, Ctrl, or Alt keys).

  • O teclado numérico e teclas numéricas do teclado.The numeric keypad and keyboard number keys.

O evento KeyUp não ocorre quando você pressiona:The KeyUp event does not occur when you press:

  • A tecla Enter se o formulário tem um botão de comando para o qual a propriedade padrão está definida como Sim.The Enter key if the form has a command button for which the Default property is set to Yes.

  • A tecla ESC se o formulário tem um botão de comando para o qual a propriedade Cancel está definida como Sim.The Esc key if the form has a command button for which the Cancel property is set to Yes.

O evento KeyUp ocorre depois de qualquer evento para um controle gerado pelo pressionamento ou envio da tecla.The KeyUp event occurs after any event for a control caused by pressing or sending the key. Se um pressionamento de tecla faz o foco mover de um controle para outro controle, o evento KeyDown ocorra para o primeiro controle, enquanto os eventos KeyPress e KeyUp ocorrem para o segundo controle.If a keystroke causes the focus to move from one control to another control, the KeyDown event occurs for the first control, while the KeyPress and KeyUp events occur for the second control.

Para descobrir o caractere ANSI correspondente à tecla pressionada, utilize o evento KeyPress.To find out the ANSI character corresponding to the key pressed, use the KeyPress event.

Se uma caixa de diálogo restrita for exibida como resultado do pressionamento ou envio de uma tecla, os eventos KeyDown e KeyPress ocorrem, mas o evento KeyUp não ocorre.If a modal dialog box is displayed as a result of pressing or sending a key, the KeyDown and KeyPress events occur, but the KeyUp event doesn't occur.

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.