VISUAL BASIC 5.

0 1

11. PRINCIPAIS EVENTOS DO VB

Activate, Deactivate
Aplicao Form, MDI Form.
Descrio Activate ocorre quando um formulrio torna-se a janela ativa. Deactivate
ocorre quando um outro formulrio torna-se a janela ativa.
Sintaxe Sub From_Activate()
Sub MDIForm_Activate()
Sub From_Deactivate()
Sub MDIFrom_Deactivate()
Comentrios Um formulrio pode tornar-se ativo por aes do usurio, tais como clicar um
formulrio ou controle, ou por se usar os mtodos Show e SetFocus no
cdigo. O evento Activate ocorre somente aps o formulrio ter se tornado
visvel. O evento Deactivate no ocorre quando o formulrio descarregado
sem que outro formulrio tenha se tornado ativo, isto , tenha recebido o
foco.

Change
Aplicao Combo box, directory list box, drive list box, horizontal scroll bar, label,
picture box, text box, vertical scroll box.
Descrio Indica quando o contedo de um controle sofreu alteraes.
Sintaxe Sub controle_Change (Index As Integer)
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

Click
Aplicao Form (no MDI), check box, combo box, command button, directory list box,
file list box, frame, grid, image, list box, menu, OLE, option button, picture
box, text box.
Descrio Ocorre quando o usurio pressiona o boto do mouse.
Sintaxe Sub Form_Click
Sub controle_Click (Index As Integer)
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

DblClick

Anotaes:

SETEMBRO/1998
AAA
VISUAL BASIC 5.0 2

Aplicao Form (no MDI), check box, combo box, command button, directory list box,
file list box, frame, grid, image, list box, menu, OLE, option button, picture
box, text box.
Descrio Ocorre quando o usurio pressiona o boto do mouse duas vezes.
Sintaxe Sub Form_DblClick
Sub controle_DblClick (Index As Integer)
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

GotFocus
Aplicao Form (no MDI), check box, combo box, command button, directory list box,
drive list box, file list box, grid, horizontal scroll bar, list box, OLE, option
button, picture box, text box, vertical scroll bar.
Descrio Ocorre quando um objeto recebe o foco, seja pela ao do usurio ou
usando-se o mtodo SetFocus no cdigo. Um formulrio (form) s recebe o
foco quando todos os controles visveis esto desabilitados.
Sintaxe Sub Form_GotFocus()
Sub controle_ GotFocus(ndex As Integer)
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.
Um objeto s pode receber o foco se estiver visvel (Visible=True) e
habilitado (Enabled=True). Objetos podem receber foco tambm atravs da
tecla de tabulao. Neste caso, a ordem de tabulao ser ditada pela
propriedade Tab order.

KeyDown, KeyUp
Aplicao Form (no MDI), check box, combo box, command button, directory list box,
drive list box, file list box, grid, horizontal scroll bar, list box, OLE, option
button, picture box, text box, vertical scroll bar.
Descrio Ocorre quando o usurio pressiona (KeyDown) ou libera (KeyUp) uma tecla
enquanto um objeto tem o foco (para interpretar caracteres ANSI, usar o
evento KeyPress).
Sintaxe Sub Form_KeyDown(KeyCode As Integer, Shift As Integer)
Sub controle_KeyDown([Index As Integer,]KeyCode As Integer, Shift As
Integer)
Sub Form_KeyUp(KeyCode As Integer, Shift As Integer)
Sub controle_KeyUp([Index As Integer,]KeyCode As Integer, Shift As
Integer)
Comentrios Os eventos KeyDown e KeyUp tm os seguintes argumentos:

Argumento Descrio
ndex Identifica um controle quando este for parte de um

Anotaes:

SETEMBRO/1998
AAA
VISUAL BASIC 5.0 3

de controles.
KeyCode Um cdigo de tecla, tal como KEY_F1 (a tecla F1
especificar cdigos de teclas, usar as contantes do a
CONSTANT.TXT.
Shift Estado das teclas Shift (1), Ctrl(2) e Alt(4) dura
ocorrncia do evento. Por exemplo, se Ctrl e Alt est
pressionadas, o valor de Shift ser 2+4=6.

KeyPress
Aplicao Form (no MDI), check box, combo box, command button, directory list box,
drive list box, file list box, grid, horizontal scroll bar, list box, OLE, option
button, picture box, text box, vertical scroll bar.
Descrio Ocorre quando o usurio pressiona e libera uma tecla ANSI.
Sintaxe Sub Form_KeyPress(KeyAscii As Integer)
Sub controle_KeyPress([Index As Integer,]KeyAscii As Integer)
Comentrios O eventos KeyPress tem os seguintes argumentos:

Argumento Descrio
ndex Identifica um controle quando este for parte de um
de controles.
KeyAscii Retorna o cdigo ANSI associado `a tecla pressi
KeyAscii passado por referncia; mud-lo m
tambm o caractere enviado ao objeto.

O objeto que recebe o evento KeyPress aquele com o foco.

O argumento KeyAscii pode ser convertido para um caractere usando-se a
expresso Chr(KeyAscii).

LinkClose
Aplicao Form, MDI Form, label, picture box, text box.
Descrio Ocorre quando uma conversao DDE termina.
Sintaxe Sub {Form|MDIForm}_LinkClose()
Sub controle_LinkClose(Index As Integer)
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

LinkError
Aplicao Form, MDI Form, label, picture box, text box.
Descrio Ocorre quando h um erro durante uma conversao DDE. O cdigo do erro
passado como um argumento.
Sintaxe Sub {Form|MDIForm}_LinkError(LinkErr As Integer)

Anotaes:

SETEMBRO/1998
AAA
VISUAL BASIC 5.0 4

Sub controle_LinkError ([Index As Integer,]LinkErr As Integer)

Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles. LinkErr o nmero do erro, de acordo com a tabela
abaixo.

N do Erro Descrio
1 O outro aplicativo requisitou dados em um formato er
6 O aplicativo de destino tentou continuar uma opera
aps a propriedade LinkMode do formulrio source t
igualado a zero.
7 Todas as source links esto sendo usadas.
8 O mtodo LinkRequest falhou em atualizar os dad
controle.

LinkError
Aplicao Form, MDI Form.
Descrio Ocorre quando um string de comando enviado pelo aplicativo destino em
uma conversao DDE. O aplicativo destino espera que o aplicativo fonte
execute a operao especificada pelo string.
Sintaxe Sub {Form|MDIForm}_LinkExecute(StringCmd As String, Cancel As
Integer)
Comentrios O evento LikExecute utiliza os seguintes argumentos:

Argumento Descrio
StringCmd String de comando enviado pelo aplicativo destino.
Cancel Este argumento informa se o string de coman
aceito ou recusado. Cancel = 0 significa ace
enquanto Cancel = 1 significa rejeio.

LinkNotify
Aplicao Label, picture box, text box.
Descrio Ocorre quando a fonte mudou os dados definidos em um lao DDE, se a
propriedade LinkMode do controle destino for igual a 3 (Notify).
Sintaxe Sub controle_LinkNotify (Index As Integer)
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

LinkOpen
Aplicao Form, MDI Form, label, picture box, text box.
Descrio Ocorre quando um conversao DDE est sendo iniciada.
Sintaxe Sub {Form|MDIForm}_LinkOpen(Cancel As Integer)

Anotaes:

SETEMBRO/1998
AAA
VISUAL BASIC 5.0 5

Sub controle_LinkOpen ([Index As Integer,]Cancel As Integer)

Comentrios O evento LinkOpen utiliza os seguintes argumentos:

Argumento Descrio
Index Unicamente identifica um controle se este faz parte
array de controles.
Cancel Quando o evento LinkOpen acaba, o valor
argumento determina se a conversao DD
estabelecida ou no. Deixando Cancel = 0 a conve
estabelecida.

Load
Aplicao Form, MDI Form.
Descrio Ocorre quando um formulrio carregado.
Sintaxe Sub Form_Load()
Sub MDIForm_Load()

LostFocus
Aplicao Form, check box, combo box, command button, directory list box, drive list
box, file list box, grid, horizontal scroll bar, list box, OLE, option button,
picture box, text box, vertical scroll bar.
Descrio Ocorre quando um objeto perde o foco, seja pela ao do usurio ou usando-
se o mtodo SetFocus no cdigo.
Sintaxe Sub Form_LostFocus()
Sub controle_ LostFocus([ndex As Integer])
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

MouseDown, MouseUp
Aplicao Form (no MDI), check box, command button, data control, directory list box,
file list box, frame, grid, image, label, list box, option box, OLE, picture box,
text box.
Descrio Ocorre quando o usurio pressiona (MouseDown) ou libera (MouseUp) um
boto de mouse.
Sintaxe
Sub Form_MouseDown (Button As Integer, Shift As Integer, X As
Single, Y As Single)
Sub controle_MouseDown ([Index As Integer,]Button As Integer, Shift As
Integer, X As Single, Y As Single)
Sub Form_MouseUp (Button As Integer, Shift As Integer, X As Single, Y
As Single)

Anotaes:

SETEMBRO/1998
AAA
VISUAL BASIC 5.0 6

Sub controle_MouseUp ([Index As Integer,]Button As Integer, Shift As

Integer, X As Single, Y As Single)
Comentrios Os eventos MouseUp e MouseDown utilizam os seguintes argumentos.

Argumento Descrio
Index Unicamente identifica um controle se este faz parte
array de controles.
Button Argumento que identifica qual boto foi pressionad
o boto esquerdo, Button = 1; para o direito, Button
para o do meio, Button = 4. Somente um valor p
de cada vez.
Shift Estado das teclas Shift (1), Ctrl(2) e Alt(4) dura
ocorrncia do evento. Por exemplo, se Ctrl e Alt est
pressionadas, o valor de Shift ser 2+4=6.
X, Y Localizao do ponteiro do mouse no momen
ocorrncia do evento. X e Y so expressos em term
coordenadas do sistema definidas pelas proprie
ScaleHeight, ScaleWidth, ScaleLeft e ScaleTop.

Diferentemente dos eventos Click e DblClick, os eventos MouseUp e

MouseDown identificam os botes que foram pressionados.

MouseMove
Aplicao Form (no MDI), check box, command button, data control, directory list box,
file list box, frame, grid, image, label, list box, option box, OLE, picture box,
text box.
Descrio Ocorre quando o usurio move o mouse atravs do objeto.
Sintaxe
Sub Form_MouseMove(Button As Integer, Shift As Integer, X As Single, Y As
Single)
Sub controle_MouseMove ([Index As Integer,]Button As Integer, Shift As Integer,
X As Single, Y As Single)
Comentrios O evento MouseMove utiliza os seguintes argumentos:

Argumento Descrio
Index Unicamente identifica um controle se este faz parte
array de controles.
Button Argumento que identifica qual boto foi pressionad
o boto esquerdo, Button = 1; para o direito, Button
para o do meio, Button = 4. Diferentemente do argu
Button para MouseUp e MouseDown. Aqu
permitidos valores mltiplos.
Shift Estado das teclas Shift (1), Ctrl(2) e Alt(4) dura
ocorrncia do evento. Por exemplo, se Ctrl e Alt est
pressionadas, o valor de Shift ser 2+4=6.
X, Y Localizao do ponteiro do mouse no momen
ocorrncia do evento. X e Y so expressos em term
coordenadas do sistema definidas pelas proprie

Anotaes:

SETEMBRO/1998
AAA
VISUAL BASIC 5.0 7

ScaleHeight, ScaleWidth, ScaleLeft e ScaleTop.

O evento MouseMove gerado continuamente enquanto o ponteiro do

mouse se move sobre o objeto.

Paint
Aplicao Form, picture box.
Descrio Ocorre quando uma parte ou o todo de um formurio ou picture box sofre
qualquer modificao de contedo.
Sintaxe Sub Form_Paint()
Sub controle_Paint([Index As Integer])
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.
O evento Paint pode ser utilizado juntamente com mtodos grficos em
aplicativos. Com este evento, pores de cdigo podem ser escritas para
determinar se determinadas sadas grficas necessitam ser repintadas.

PathChange
Aplicao File list box.
Descrio Ocorre quando o caminho (path) alterado quando se define as
propriedades FileName e Path a partir do cdigo.
Sintaxe Sub controle_PathChange([Index As Integer])
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

PatternChange
Aplicao File list box.
Descrio Ocorre quando o padro de arquivos (por exemplo, *.*) alterado quando se
define as propriedades FileName e Pattern a partir do cdigo.
Sintaxe Sub controle_PatternChange([Index As Integer])
Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

QueryUnLoad
Aplicao Form, MDI Form.
Descrio Ocorre antes de um formulrio ser descarregada..
Sintaxe Sub Form_QueryUnLoad (Cancel As Integer, UnLoadMode As Integer)

Anotaes:

SETEMBRO/1998
AAA
VISUAL BASIC 5.0 8

Sub MDIForm_QueryUnLoad (Cancel As Integer, UnLoadMode As

Integer)
Comentrios O evento QueryUnLoad utiliza ose seguintes argumentos:

Argumento Descrio
Cancel Definindo este argumento em qualquer valor difere
zero evita-se que o evento QueryUnLoad
finalizado.
UnLoadMode Indica o motivo de ocorrncia do eventos QueryUn
de acordo com a tabela abaixo.

Valor Descrio
0 O usurio escolheu o comando Close no menu de c
(Control-box) do formulrio
1 O mtodo UnLoad foi usado no cdigo.
2 A seo do Windows est sendo finaliizada.
3 O Gerenciador de Tarefas do Windows est encerra
aplicativo.
4 Um formulrio, filho de um MDI, est fechando porque
est fechando.

Utiliza-se o evento QueryUnLoad para verificar se alguma tarefa foi

deixada por finalizar antes do aplicativo ser fechado.

Resize
Aplicao Form, MDIForm, OLE, picture box.
Descrio Ocorre quando um formurio aparece pela primeira vez ou quando um
controle redimensionado.
Sintaxe Sub {Form|MDIForm|picturebox}_Resize()
Sub OLE_Resize(nova_altura As Single, nova_largura As Single)
Comentrios O evento Resize pode ser utilizado para redimensionar controles quando o
formulrio que os contm for redimensionado.

Scroll
Aplicao Horizontal scroll bar, vertical scroll bar
Descrio Ocorre quando o usurio aciona barras de rolagem horizontal ou vertical.
Sintaxe controle_Scroll()

Timer
Aplicao Timer.
Descrio Ocorre quando transcorreu o intervalo de tempo definido para o Timer.

Anotaes:

SETEMBRO/1998
AAA
VISUAL BASIC 5.0 9

Sintaxe Sub controle_Timer([Index As Integer])

Comentrios O argumento Index identifica um controle unicamente se este for parte de
um array de controles.

Anotaes:

SETEMBRO/1998
AAA