363 VBJairSoft20140821235341 PDF

Guia de Referencia do
Visual Basic

2

ndice do Guia de Referencia do Visual Basic

Funes do Visual Basic

Abs( ): Aquisio de valor absoluto
Asc( ): Aquisio do nmero de caractere ANSI.
CCur( ), CDbl( ), CInt( ), CLng( ), CBng( ) e CVar( ): Converso de contedo de varivel
Chr$( ): Aquisio de caractere ANSI
CVDate( ): Converso de variant para data
DateSerial( ) e TimeSerial( ): Aritmtica de data/hora
DataValue( ) e TimeValue( ): Numeralizao de data/hora
Day ( ), WeekDay( ), Month( ) e Year( ): Representao de componentes de data
EOF( ): Determinao do final do arquivo de dados
Error$( ): Aquisio de descrio de erro.
FileAttr( ): Aquisio de tipo de arquivo de dados
Fix( ): Arredondamento numrico
Format$( ): Converso de valor para string
FreeFile: Aquisio de canal livre
Hex$( ): Traduo hexadecimal
Hour( ), Minute( ) e Second( ): Representao de componenetes de tempo
Input$( ): Aquisio de dados brutos
InputBox$( ): Chamada de painel textual
InStr( ): Procura de fragmento de string
Int( ): Trucagem numrica
IsDate( ): Determinao do formato de assinatura de tempo
IsNumeric( ), IsEmpty( ) e IsNull( ): Determinao do contedo de uma variante
LBound( ) e UBound( ): Aquisio dos limites de um array
LCase$( ) e UCase$( ): Converso de minsculas e maisculas de string
Left$( ) e Right$( ): Segmentao de string
Len( ): Aquisio do comprimento de uma string
LoadPicture( ): Aquisio de arquivo grfico
Loc( ): Retorna a posio do ponteiro de dados do arquivo
LOF( ): Aquisio de comprimento de arquivo de dados
Log( ) e Exp( ): Operaes logartmas
LTrim$( ) e RTrim$( ): Remoo de espaos
Mid$( ): Aquisio de parte de uma string
Oct$: Converso octal
QBColor( ): Simulao de cores CGA
RGB( ): Representao de valor de cor
Rnd( ): Gerao de nmero aleatrio
Seek( ): Aquisio da posio do ponteiro de dados
Sgn( ): Aquisio do sinal do valor
Sin( ), Cos( ), Tan( ) e Atn( ): Operaes trigonomtricas
Space$( ): Ativao de mltiplos espao
Spc( ): Espaamento do cursor de texto
Sqr( ): Aquisio da raiz quadrada
Str$( ): Converso de valor para string
String$( ): Ativao de mltiplos caracteres
Tab( ): Tabulao do cursos de texto
TypeOf: Determinao de tipo de controle
Val( ): Converso de string para valor
VarType( ): Aquisio do tipo de uma variante.

7
7
7
7
7
7
8
8
8
8
8
9
9
9
9
9
10
10
10
10
11
11
11
11
11
12
12
12
12
12
12
13
13
13
13
13
14
14
14
14
14
14
15
15
15
15
15
16
3

Mtodos do Visual Basic

.Additem: Manuteno de entradas de lista
.Arrange: Regulao de filha MDI
.Circle: Plotagem de elipse
.Clear: Limpeza de uma caixa de listagem
.Clear: Apagamento do contedo do clipboard
.Cls: Limpeza de rea de figura
.Drag: Ativao do arraste manual
.EndDoc: Ejeo de documento na impressora
.GetData( ): Aquisio de dados do clipboard
.GetFormat( ): Aquisio de tipo contedo do clipboard
.GetText( ): Aquisio de texto do clipboard
.Hide: Suspenso de operao de formulrio
.Line: Plotagem de linha geomtrica
.Move: Reposicionamento manual de controle
.NewPage: Sinal de ejeo de pgina na impressora
.Point: Aquisio de valor de cor
.Print: Exibio de texto
.Pset: Definio de valor de cor de pixel
.Refresh: Atualizao forada do contedo de um objeto
.RemoveItem: Manuteno de entradas na lista
.Scale: Estabelecimento de sistema de coordenadas varivel
.SetData: Colocao de dados no clipboard
.SetFocus: Definio do indicador manual
.SetText: Colocao de texto no clipboard
.Show: Exibio de formulrio na rea de trabalho
.TextHeight e .TextWidth: Aquisio de tamanho de texto
.ZOrder: Designar a exposio na tela

17
17
17
17
18
18
18
18
18
18
18
19
19
19
19
20
20
21
21
21
22
22
22
22
22
23
23

Eventos do Visual Basic

_Activate e _Deactivate: Acionamento de formulrio
_Change: Alterao de status
_Click: Indicao do usurio
_DblClick: Indicao do usurio
_DragDrop: Liberao de cone arrastado
_DragOver: Travessia do cone arrastado
_DropDown: Aparncia do painel de lista subordinada
_GotFocus e _LostFocus: Obteno/perda do indicador de controle
_keyDown e _KeyUp: Ativao ou liberao de tecla
_KeyPress: Reconhecimento de caractere
_MouseDown e _MouseUp: Ativao do boto do mouse
_MouseMove: Movimento do apontador
_Paint: Raquisio de imagem de reserva
_PathChange: Alterao de caminho de diretrio
_PatternChange: Alterao de padro de procura de arquivos
_RowColChange: Movimento do ponteiro de clula
_SelChange: Ativao de indicao de clulas
_Timer: Passagem de intervalo

24
24
24
24
25
25
25
25
26
26
26
26
27
27
27
28
28
28

4
Propriedades do Visual Basic

.Action: Especifica qual dilogo comum deve ser exibido
.Align: Alinhamento automtico de figura
.AutoRedraw: Permisso de reserva de imagem
BackColor e .ForeColor: Designao de cores slidas
.BackStyle: Estado de preenchimento slido
BorderColor: Cor de contorno
.BorderStyle: Tipo de envoltrio exibido
.BorderStyle: Modo de tracejamento de linhas
.BorderWidth: Extenso da marca em pixels
.Caption: Contedo textual no editvel
.CellSelected: Status de indicao de ponteiro
.Checked: Marcao de item de menu
.Clip: Contedo coletivo das clulas indicadas
.ColAlignment( ): Peso do contedo textual
.ControlBox: Especifica o status da caixa de controle da janela
.Copies, .FromPage e .ToPage
.CurrentX e .CurrentY: Coordenadas do apontador do terminal virtual
.Default e .Cancel: Aceitao/rejeio de atribuio de tecla
.DragIcon: Nome de arquivo do objeto de arrast
.DragMode: Acessibilidade do apontador do controle
.DrawStyle: Atribuio de tracejamento da plotagem
.DrawWidth: Atribuio de largura de plotagem
.Drive: Dispositivo ativo
.Enabled: Status de operacionalidade do controle
.ErrorCancel
.FileName
.FileName:Nome de arquivo escolhido
.FillColor: Cor slida de plotagem fechada
.FillStyle: Atribuio de padro de plotagem fechada
.Filter
.FixedAlignment( ): Peso do texto em clulas no-mveis
.FixedRows, .FixedCols: Quantidade de clulas no-mveis
.FontBold, .FontItalic, .FontStrikeThru e .FontUnderline
.FontBold, .FontItalic, .FontStrikethru, .FontTransparent e .FontUnderline: Estilos de caractere
.FontCount
FontCount: Quantidade de estilos de tipos instalados
.FontName e .FontSize
.Fonts( ): Estilos de tipo instalados
.GridLines: Linhas de borda intermedirias
.Height: Limite extremo inferior
.HideSelection: Continuao de indicao de texto
.HighLight: Permisso para colorir clulas indicadas
.Icon: Smbolo de formulrio minimizado
.Image: Contedo grfico
.Index: Todos os controles de um array
.Interval: Valor de ativao do timer
.Left: Coordenada do eixo X
.List( ): Contedo de entrada na lista
.ListCount: Quantidade de entradas na lista
.ListIndex: Localizao da entrada escolhida
.Max e .Min
.Max e .Min: Exteno de intervalo de valores
.MaxButton: Incluso de controle de maximizo
.MDIChild: Designao de subordinao MDI

29
29
29
29
30
30
30
30
31
31
31
31
31
32
32
32
32
32
33
33
33
33
34
34
34
34
34
34
35
35
35
35
35
35
36
36
36
36
36
36
36
37
37
37
37
37
37
38
38
38
38
38
39
39
5
.MinButton: Status de exibio do controle de minimizao
.MousePointer: Aparncia do apontador
.MultiLine: Capacidade de mltiplas linhas
.MultiSelect: Capacidade de escolha de mltiplas entradas
.Name: Todos os controles
.Page: Pgina atual da impressora
.PasswordChar: Caractere de substituio de posio
.Path: Caminho de diretrio ativo
.Pattern: Padro de procura atual
.Picture: Fundo grfico
.Row, .Col: Localizao de ponteiro de clula
.RowHeight( ), .ColWidht( ): Tamanho de clula
.Rows, .Cols: Extenso de clulas
.ScaleLeft, .ScaleTop, .ScaleWidth e .ScaleHeight: Estabelecimento de coordenadas geomtricas
variveis
.ScaleMode: Escolha do sistema de coordenadas
.ScrollBars: Permisso para anexao de barram de rolagem
.Selected( ): Status de escolha de entrada da lista
.SelLenght: Nmero de caracteres indicados
.SelStart: Posio inicial da indicao de texto
.SelStartRow, .SelEndRow, .SelStartCol e .SelEndCol: Cantos de bloco de seleo de clulas
.SelText: Texto indicado
.Shape: Identidade de elemento grfico
.SmallChange e .LargeChange: Intervalos de alterao de valor
.Sorted: Status de ordenao da lista
.Stretch: Permisso para redimensionar automaticamente o contedo
.Style: Incluso de caixa de texto
.TabIndex: Ordenao de entrada de texto
.TabStop: Particio na seqncia de teclado
. Tag: Todos os controles padro
.Text: Contedo textual editvel
.Top: Coordenada do eixo Y
.TopRow, .LeftCol: Primeira clula de dados visvel
.TwipsPerPixelX e .TwipsPerPixelY: Fator de converso de escalas coordenadas
.Value: Status dentro de um intervalo
.Visible: Status de exibio de controle
.Width: Limite extremo direito
.WindowList: Status de listagem filha MDI
.WindowState: Status operativo de janela
.X1, .Y1, .X2, .Y2: Coordenadas geomtricas
Alinhamento: Peso do texto contido
AutoSize: Permisso para economia de espao
Columns: Incluso de coluna na lista
FontName: Atributo de estilo de caractere
FontSize: Atributo de tamanho de caractere
WordWrap: Permisso para criao de espao auxiliar
39
39
40
40
40
41
41
41
41
41
42
42
42
42

42
43
43
43
43
44
44
44
45
45
45
45
45
46
46
46
46
46
47
47
47
47
47
48
48
48
48
48
49
49
49

Instues do Visual Basic

Beep: Ativao de som interno.
Call: Desvio entre procedures
Close: Terminao de ponteiro de dados
Const: Declarao de constantes
DefCur, DefDbl, DefInt, DefLng, DefSng, DefStr e DefVar: Restrio de variveis alfabticas
Dim: Declarao de varivel

50
50
50
50
50
51
6
DoEvents: Mudana de prioridade os eventos
Do [While | Until]...Loop [While | Until: Demarcao de loop condicional/incondicional
End: Terminao de contexto
Erase: Atualizao de arrays
Error: Simulao de erro
Exit: Aborto forado de contexto
For-Next: Demarcao de um loop reiterativo
Function: Inciao de procedure que retorna valor
Get #: Recuperao d dados de um dispositivo
Global: Declarao de varivel Global
GoSub: Desvio temporrio
GoTo: Desvio entre procedimentos
If... Then... [ElseIf... Then][Else... ]... End If: Clusula condicional
Input #: Aquisio de dados do dispositivo
Line Input #: Transmisso de texto formatado de um dispositvo
Load: Colocao de um bojeto na rea de trabalho
LSet e RSet: Justificao de contedo
Mid$: Insero de um fragmento de string
On Error [GoTo | Resume]: Interceptao de erros dentro da procedure
On...GoTo e On...GoSub: Desvio de mltipla escolha
Open: Iniciao de ponteiros de dados
Option Base: Predefinio default de array
Option Compare: Restries do processo de comparao de texto
Option Explicit: Estipulao de declarao
Print #: Transmisso de dados para dispositivo
Put #: Armazenamento de dados em dispositivo
Randomize: Realimentao do gerador aleatrio
ReDim: Redeclarao de array dinmico
Rem: Permite que voc coloque comentrios textuais em seu cdigo-fonte.
Reset: Encerramento do processo de transferncia de dados
Resume: Terminao de rotina de interceptao de erros
Return: Terminao de sub-rotina
SavePicture: Salvamento do contedo de imagem
Seek #: Diretiva de posicionamento do ponteiro de dados
Select Case... Case... End Select: Clusula condicional de mltipla escolha
SendKeys: Imitao de pressionamento de tecla
Set: Estabelecimento de representao indireta
Static: Declarao de varivel local
Stop: Suspenso do programa
Sub: Inciao de porocedure que no retorn valor
Type-End type: Clusula de declarao composta
Unload: remoo do objeto da rea de trabalho
Width #: Formatao de aruivo de dados textuais
Write #: Transmisso de texto para disco
51
52
52
53
53
53
53
54
54
55
55
55
55
56
56
56
57
57
57
57
58
58
58
58
58
59
60
60
60
61
61
61
61
61
62
62
62
63
63
63
64
65
65
65

7
Funes do Visual Basic

Abs( )
Propsito: Aquisio de valor absoluto
Sintaxe: solucao = Abs(expressao)
A funo Abs( ) retorna o valor absoluto de expressao, dentro da varivel solucao.
Esse valor equivalente ao valor da expresso original, sem o sinal.

Asc( )
Propsito: Aquisio do nmero de caractere ANSI.
Sintaxe: solucao% = Asc(char$)
Nesta sintaxe, char$ um nico caractere. Se esse caractere for escrito literalmente,
ele ter que aparecer entre aspas.
A funo Asc( ) obtm o valor do cdigo ASCII (na realidade, ANSI) do caractere
designado como char$. Esse valor retornado dentro da varivel solucao%.

CCur( ), CDbl( ), CInt( ), Cn!( ), CBn!( ) e CVar( )
Propsito: Converso de contedo de varivel
Sintaxe: solucao = Ctipo(expressao)
Neste sintaxe, tipo a abreviao do tipo de varivel para o qual se est convertendo.
As funes Ctipo resolvem o valor lgico reduzido de expressao e ento convertem a
expresso para o tipo de varivel especificado, mesmo que esse tipo exija mais bytes
que o necessrio para representar o valor. O resultado precisa ser atribudo a uma
varivel tendo um tipo equivalente ao tipo para o qual se est convertendo.

C"r#( )
Propsito: Aquisio de caractere ANSI
Sintaxe: solucao$ = Chr$(expressao)
Nesta sintaxe, a expressao pode ser simplificada logicamente como um valor de cdigo
ASCII legtimo.
A funo Chr$ ( ) aceita o valor de nmero inteiro de expressao e procura o caractere
de cdigo ASCII(ANSI) equivalente a esse valor. Esse caractere retornado como o
contedo de um s caractere de solucao$.

CVDate( )
Propsito: Converso de variant para data
Sintaxe: assinatura = CVDate(valor#)
A funo CVDate( ) retorna um valor de data/hora convertido usando o parmetro
valor#, dentro da assinatura variant tipo7. O tipo de varivel de valor# precisa ser um
tipo numrico, embora possa ser qualquer tipo numrico.

DateSerial( ) e $i%eSerial( )
Propsito: Aritmtica de data/hora
Sintaxe:
variant7 = dataSerial(ano, es, dia)
variant7 = !ieSerial(hora, inuto, se"undo)
A funo DateSerial ( ) avalia os trs parmetros que recebe, reduz logicamente cada
um deles em conjunto com os outros, e retorna uma data dentro de uma varivel
variant do tipo7 (data). Similarmente, TimeSerial( ) avalia os trs parmetros
passados, os reduz logicamente comparando-os uns com os outros, e retorna uma
hora dentro de uma varivel variant tipo7. Desta maneira, voc pode determinar datas
e horas relativas usando aritmtica.

8
DataValue( ) e $i%eValue( )
Propsito: Numeralizao de data/hora
Sintaxe:
variant7 = DateValue(Date$)
variant7 = !ieValue(!ie$)
A funo DateValue( ) aceita uma string de data validamente interpretvel e a
converte em uma data variant do tipo7. Esse contedo segue o formato de assinatura
de tempo visvel usado pela varivel interna #o$. Ele representa o nmero de dias que
se passaram desde 30 de dezembro de 1899. Os formatos de data aceitveis so dd-
mm-aaa, dd-mm-aa, dd/mm/aaaa e dd/mm/aa. A funo !ieValue( ) converte uma
string de temo validamente interpretvel em uma hora variant do tipo7. O formato
desse valor tambm segue o formato visvel usado por #o$.

Da& ( ), 'ee(Da&( ), )ont"( ) e *ear( )
Propsito: Representao de componentes de data
Sintaxe:
variavel% = Da%(assinatura)
variavel% = &ee'Da%(assinatura)
variavel% = (onth(assinatura)
variavel% = )ear(assinatura)
Cada funo deste conjunto aceita um valor de dupla preciso como seu parmetro,
com o formato dos nmeros nesse valor coincidindo com o do formato da assinatura
usado pela varivel interna #o$. A funo Da%( ) retorna o dia do ms da data
especificada.Da mesma forma, (onth( ) retorna o ms do ano, e )ear( ) retorna o ano
atual. &ee'da%( ) retorna o nmero do dia da semana, onde 1 Domingo.

+,F( )
Propsito: Determinao do final do arquivo de dados
Sintaxe: variavel% = *+,(canal%)
A funo *+,( ) indica se o ponteiro de arquivo de um canal% especificado est
atualmente dentro de seus limites. Se o ponteiro do arquivo tiver atingido o final do
arquivo, *+,( ) retorna um valor booleano True(-1). Se houver ainda mais elementos
de dados ou bytes a serem lidos dentro de um arquivo de dados aberto, *+,( ) retorna
False(0). A funo s trabalha com arquivos que tenham um canal% aberto
previamente com a declarao Open, e que sejam considerados atualmente abertos
pelo intepretador.

+rror#( )
Propsito: Aquisio de descrio de erro.
Sintaxe: Strin"$ = *rror$(coderro%)
Nesta sintaxe, coderro% um valor inteiro correspondente a um cdigo de erro vlido.
Voc pode usar a varivel interna *rr como coderro%.
A funo *rror$( ) retorna uma string de texto que descreve o cdigo de erro passado
a funo, dentro da varivel de string String$.

FileAttr( )
Propsito: Aquisio de tipo de arquivo de dados
Sintaxe: de-inicao% = ,ileAttr(canal%, atributo%)
Quando atributo% declarado como 1, a funo ,ileAttr( ) retorna um valor que
descreve o modo de acesso a arquivo de dados atribudo ao canal de dados
especificado. Essa valor pode ser qualquer dos seguintes:
- Input(entrada) seqncial
. Output(sada) seqncial
9
/ Random(aleatrio)
0 Append(anexao) seqncial
1. Binary(binrio)
Quando atributo% declarado como 2, a funo ,ileAttr( ) retorna um valor
representando o gerenciador de arquivo ou nmero de acesso atribudo a ele pelo
ambiente Microsoft Windows. Voc pode usar esse gerenciador em conjunto com
instrues para a API do Windows.

Fix( )
Propsito: Arredondamento numrico
Sintaxe: solucao% = ,ix(expressao)
A funo ,ix( ) remove qualquer valor fracionrio do valor simplificado logicamente de
expressao, deixando um nmero inteiro. Esse valor retornado na varivel solucao%.

For%at#( )
Propsito: Converso de valor para string
Sintaxe: strin"$ = ,orat$(valor., /0tipo-orato$0 1 descritor$23)
Nesta sintaxe, descritor$ uma srie de caracteres de diretivas e marcadores de
posio escritos em at trs grupos usando a seguinte sintaxe: descritorpos.4
descritorne".4descritor5ero33
A funo ,orat$( ) converte um valor numrico em uma string alfanumrica, da
mesma forma que a funo Str$( ). Se nenhum outro parmetro for especificado, a
funo ,orat$( ) pra aqui; caso contrrio, ela aplica um formato de aspecto a este
valor. Esse formato pode ser um dos nomes de tipo gerais tipo-orato$ reconhecidos
pelo interpretador, ou poder ser uma srie de caracteres marcadores de posio
descritor$ tiver que ser declarado dentro da funo, ele ter que aparecer entre aspas;
caso contrrio, voc pode atribuir antecipadamente o descritor a uma varivel string
usando uma equao.

FreeFile
Propsito: Aquisio de canal livre
Sintaxe: canal% = ,ree,ile
A funo ,ree,ile retorna o nmero de canal no aberto de valor mais baixo, na
varivel canal%. Voc pode ento usar essa varivel em uma declarao Open que
pode vir a seguir. A funo ,ree,ile no requer parnteses.

2ex#( )
Propsito: Traduo hexadecimal
Sintaxe: solucao$ = 6ex$(exp7nuerica)
A funo 6ex$( ) descobre o valor no fracionrio de exp7nuerica, arredonda esse
nmero para menos at o inteiro mais prximo, e encontra o valor hexadecimal (base
16) do nmero. Esse nmero retornado como uma string, especialmente porque ele
pode conter os dgitos de A a F (10 a 15).

2our( ), )inute( ) e Second(
Propsito: Representao de componenetes de tempo
Sintaxe:
variavel% = 6our(assinatura)
variavel% = (inute(assinatura)
variavel% = Second(assinatura)
Cada funo deste conjunto aceita um valor de dupla preciso como seu parmetro,
com o formato dos nmeros desse valor coincidindo com o formato de assinatura
usado pela varivel interna #o$. A funo 6our( ) retorna a hora do tempo
10
especificado em formato de 24 horas. Similarmente, (inute( ) retorna o minuto do
tempo especificado, e Second( ) retorna o segundo desse tempo.

Input#( )
Propsito: Aquisio de dados brutos
Sintaxe: se8uencia$ = 9nput$(nucarac$, .#3canal%)
A funo 9nput$( ) usada na aquisio de dados brutos de um arquivo, cujos
elementos de dados, se existirem, no possam ser distinguidos uns dos outros de
nenhuma maneira que o Visual Basic imediatamente reconhea. Depois dos dados
serem adquiridos, fica por conta do aplicativo VB fazer sua interpretao e encontrar
uma finalidade para eles.
A funo recupera um nmero nucarac% de caractres alfanumricos de um arquivo
de dados que tenha um nmero de canal% a ele alocado pela declarao Open para
Input seqncial ou acesso Binary. Ela move o ponteiro de arquivo atual para o byte
seguinte ao ltimo lido por 9nput$( ). A funo recupera a string e a atribui varivel
de string strin"$. Cada byte da string recebida tratado como um caractere
alfanumrico que pode ser convertido em um valor entre 0 e 255 com a funo Asc( ).
Essa funo no est disponvel para arquivos abertos para acesso Random. O sinal #
antes de canal% opcional nessa funo.

InputBox#( )
Propsito: Chamada de painel textual
Sintaxe: resposta$ = 9nput:ox.$3 (ensa"e$., titulo$., de-ault$., coordx%,
coord%%333)
A funo 9nput:ox$( ) usa a mensagem em ensa"e$ como um pedido para que
uma resposta textual seja inserida pelo usurio em uma linha de texto aparecendo no
painel de dilogo. O contedo dessa inha est limitado a um mximo de 31 caracteres,
que pode ser definido antecipadamente pela expresso de de-ault$. O ttulo do painel
de entrada pode opcionalmente ser expresso como titulo$; se o ttulo no estiver
expresso, a barra de ttulo ser deixada em branco.
Normalmente, o painel de entrada aparece no centro da tela. Se ele estiver colocado
em algum outro lugar, o ponto de origem da janela pode ser expresso como
coordenadas coordx%, coord%%. Uma caixa de entrada sempre contm dois botes:
OK e Cancel. Se o usurio clica em Cancel, o contedo de resposta$ permanece como
uma string nula. Se o usurio clica em OK, o contedo da linha de texto retornado
como resposta$.

InStr( )
Propsito: Procura de fragmento de string
Sintaxe: posicao; = 9nStr(.prieiro7carac;, 3exp7strin"<$, exp7strin"=$.,
copara%3)
A funo 9nStr( ) incia uma procura pela string ou concatenao de strings expressa
por exp_string2$, dentro da string maior exp7strin"=$. O comprimento de exp7strin=$
precisa ser menor que 65.536 caracteres. Se a procura resulta em uma coincidncia, o
nmero do caractere da string maior onde o primeiro caractere da string menor
aparece retornado na varivel de inteiro longo posicao;. O primeiro caractere da
string maior considerado o caractere nmero 1. Se a string menor no aparecer
exatamente dentro da string maior, ou se exp7strin"=$ for maior que exp7strin"<$, a
funo retornar uma valor nulo (0).

Int( )
Propsito: Trucagem numrica
Sintaxe: solucao% = 9nt(expressao)
11
A funo 9nt( ) arredonda o valor simplificado logicamente de expressao para menos
at o nmero inteiro mais prximo. O resultado desse arredondamento retornado na
varivel solucao%.

IsDate( )
Propsito: Determinao do formato de assinatura de tempo
Sintaxe: booleano% = 9sDate(paraetro)
A funo 9sDate( ) retorna uma valor True/False na varivel booleano%, refletindo se o
parmetro especificado pode ser interpretado legalmente como uma data VarType 7.
Uma string ou valor com tal formato pode ser atribuda diretamente a uma varivel
no-declarada, e o interpretador responde dando a esta o tipo 7 de variant
automaticamente. Nessa situao, parmetro pode tanto ser um valor numrico como
uma string; a funo incapaz de gerar erros com base neste tipo de parmetro.
Valores numerais diretos, porm, muito provavelmente retonaro um valor False.

Is3u%eric( ), Is+%pt&( ) e Is3ull( )
Propsito: Determinao do contedo de uma variante
Sintaxe: booleano% = 9s#ueric(variant)
booleano% = 9s*pt%(variant)
booleano% = 9s#ull(variant)

Bound( ) e 4Bound( )
Propsito: Aquisio dos limites de um array
Sintaxe: variavel% =>:ound(arra%., diensao3) 1 variavel% =?:ound(arra%.,
diensao3)
As funes >:ound( ) e ?:ound( ) retornam os limites inferior e superior,
respectivamente, do array especificado. Se a matriz for multidimensional, para
retornar os limites de um nvel de dimenso, o nmero desse nvel especificado como
um segundo parmetro da funo. O nome de cada array declarada sem parnteses.

Case#( ) e 4Case#( )
Propsito: Converso de minsculas e maisculas de string
Sintaxe:
strin"$ = >Case$(exp7strin"$)
strin"$ = ?Case$(exp7strin"$)
A funo >Case$( ) converte em letras minsculas todos os caracteres alfabticos que
aparecem dentro da string ou concatenao de strings expressa exp7strin"$. De modo
similar, a funo ?Case$( ) converte em letras maisculas todos os caracteres
alfabticos aparecendo dentro da string ou concatenao de strings expressa
exp7strin"$.

e5t#( ) e 6i!"t#( )
Propsito: Segmentao de string
Sintaxe:
substrin"$ = >e-t$(strin"$, nuero%)
substrin"$ = @i"ht$(strin"$, nuero%)
A funo >e-t( ) extrai seqncialmente os primeiros caracteres nuero% da string
maior strin"$ e os atribui como contedo da varivel de string menor substrin"$. Da
mesma forma, a funo @i"ht$( ) extrai seqncialmente os ltimos caracteres
nuero% da string maior strin"$ e atribui esses caracteres varivel de string menor
substrin"$. Em ambas as funes, se nuero% for maior que o comprimento de
strin"$, toda a string ser retornada em substrin"$ sem quaisquer caracteres
adicionados a qualquer lado da string.
12

en( )
Propsito: Aquisio do comprimento de uma string
Sintaxe: valor% = >en(exp7strin"$)
Nessa sintaxe, exp7strin"$ qualquer expresso que rena uma ou mais strings de
texto alfanumrico.
A funo >en( ) retorna o nmero de caracteres armazenados dentro da string
expressa, na varivel numrica valor%.

oadPicture( )
Propsito: Aquisio de arquivo grfico
Sintaxe: .!erVirtA3Bicture = >oadBicture(0noear8$0)
Onde noear8$ se refere a um arquivo com a extenso BMP (bitmap do Windows),
ICO(cone padro), ou WMF (meta-arquivo do windows).
A funo >oadBicture( ) carrega o arquivo de imagem especificado no controle terminal
virtual designado por TermVirt.

oc( )
Propsito: Retorna a posio do ponteiro de dados do arquivo
Sintaxe: posicao; = >oc(canal%)
A funo >oc( ) retorna a posio do armazenamento ou recuperao anterior de um
arquivo de dados aberto, cujo nmero canal% esteja especificado entre os parnteses.
Em arquivos de acesso aleatrio, a funo >oc( ) retorna o nmero do elemento de
dados ou registro anterior, onde 1 igual ao nmero do primeiro elemento do arquivo.
Em arquivo de acesso seqncial, >oc( ) retorna um valor arredondado equivalente
posio em bytes atual do ponteiro de dados - e no a posio do elemento ou registro
- dividida por 128. Em arquivos de acesso binrio, >oc( ) retorna a posio do byte
previamente escrito ou lido no arquivo. O sinal # antes de canal% omitido nessa
funo.

,F( )
Propsito: Aquisio de comprimento de arquivo de dados
Sintaxe: copr% = >+,(canal%)
A funo >+,( ) retorna o comprimento em bytes do arquivo aberto cujo canal%
aparece entre os parnteses. O sinal # antes de canal% omitido nessa funo.

o!( ) e +xp( )
Propsito: Operaes logartmas
Sintaxe:
solucao = >o"(expressao)
solucao = *xp(expressao)
A funo >o"( ) retorna o logaritmo natural do valor reduzido logicamente de
expressao, dentro da varivel solucao. Da mesma forma, a funo *xp( ) retorna a
base do logaritmo natural e elevada potncia do valor reduzido logicamente de
expressao, dentro da varivel solucao.

$ri%#( ) e 6$ri%#( )
Propsito: Remoo de espaos
Sintaxe:
strin"$ = >!ri$(exp7strin"$)
strin"$ = @!ri(exp7strin"$)
Nesta sintaxe, exp7strin"$ qualquer expresso lgica contendo uma ou mais strings
ou variveis de string concatenadas.
13
A funo >!ri$( ) remove todos os espaos do lado esquerdo da string expressa. Da
mesma forma, a funo @!ri$( ) remove todos os espaos do lado direito da string
expressa.

)id#( )
Propsito: Aquisio de parte de uma string
Sintaxe: substrin"$ = (id$(strin"$, pos7inic;, nuero%)
A funo (id$( ) extrai um nuero% de caracteres de uma string em ordem qa partir
da string maior strin"$, comeando na posio de caractere pos7inic; contando a
partir da esquerda de strin"$. Os caracteres extrados so ento atribudos varivel
de string menor substrin"$.

,ct#
Propsito: Converso octal
Sintaxe: solucao$ = +ct$(exp7nuerica)
A funo +ct$( ) descobre o valor no fracionrio de exp7nuerica, arredonda esse
nmero para menos at o inteiro mais prximo, e encontra o valor octal (base 8) do
nmero. Embora a soluo s contenha dgitos de 0 a 7, ela retornada dentro de
uma varivel de string solucao$.

7BColor( )
Propsito: Simulao de cores CGA
Sintaxe: cor; = C:Color(re"istro%)
A funo C:Color( ) retorna um valor inteiro longo que representa, para o Visual Basic,
uma mistura de cores aproximadamente equivalente ao valor da cor re"istro% usado
no Microsoft QuickBASIC para plotagem na tela CGA. O parmetro re"istro% pode
elevar qualquer dos valores da tabela 43.1. Nesta os valores so mostrados ao lado de
seus equivalentes @D:( ) funcionais.

68B( )
Propsito: Representao de valor de cor
Sintaxe: cor; = @D:(red%, "reen%, blue%)
Onde red%(verelho), "reen%(verde) e blue%(a5ul) so inteiros no intervalo de 0 a
255, representando a intensidade de cada cor primria na mistura.
A funo @D:( ) retorna um nico valor inteiro longo que uma combinao
matemtica dos trs parmetros de entrada e que representa, para o interpretador
Visual Basic, um valor especfico de mistura de cores. Cada parmetros representa a
quantidade de sua cor primria tica usada na mistura. Quanto maior o valor do
parmetro, mais intensa a cor primria na mistura.

6nd( )
Propsito: Gerao de nmero aleatrio
Sintaxe: nuero# = @nd.(processo#)3
Nesta sintaxe, processo# qualquer nmero de ponto-flutuante e preciso dupla, cujo
sinal, quando processo# expresso, crucial para o processo de gerao.
A funo @nd( ) retorna o que aparenta ser um nmero aleatrio de ponto-flutuante e
preciso dupla entre 0 e 1. O valor de processo# afeta o processo de gerao do
nmero aleatrio. Um nmero "aleatrio" particular gerado para cada valor de
processo# passado funo, se processo#<0. Uma seqncia particular de nmeros
aleatrios pode existir em um aplicativo para cada gerao numrica, situao na qual
a mesma srie gerada cada vez que o aplicativo executado. O prximo nmero
dessa srie pode ser gerado se processo#>0 ou se processo# for omitido. O nmero
aleatrio anterior gerado novamente se processo# = 0.
14

See(( )
Propsito: Aquisio da posio do ponteiro de dados
Sintaxe: posicao; = See'(canal%)
A funo See'( ) retorna a posio do ponteiro de arquivo dentro de um arquivo de
dados aberto, cujo nmero canal% esteja especificado entre os parnteses. Essa
posio do ponteiro onde ir ocorrer a prxima operao de leitura ou escrita. Em
arquivos de acesso aleatrio, See'( ) retorna o nmero a ser dado ao prximo
elemento de dados escrito ou lido no arquivo de dados. Em arquivos de acesso
seqncial ou binrio, see'( ) retorna a posio em bytes onde o prximo caractere de
dados ser escrito ou lido no arquivo de dados. O sinal # antes de canal% omitido
nessa funo.

S!n( )
Propsito: Aquisio do sinal do valor
Sintaxe: solucao% = S"n(expressao)
A funo S"n( ) retorna um valor que representa o sinal do valor reduzido logicamente
de expressao, dentro da varivel solucao%. Esse valor representativo pode ser um dos
seguintes:
9- Se a expressao negativa
: Se expressao = 0
- Se a expressao positiva

Sin( ), Cos( ), $an( ) e Atn( )
Propsito: Operaes trigonomtricas
Sintaxe:
solucao = Sin(expressao)
solucao = Cos(expressao)
solucao = !an(expressao)
solucao = Atn(expressao)
Essas quatro retornam, respectivamente, o seno, o cosseno, a tangente, e o arco-
tangente do valor reduzido logicamente de expressao. Esse valor retornado na
varivel solucao em radianos, que so divises de um arco circular.

Space#( )
Propsito: Ativao de mltiplos espao
Sintaxe: strin"$ = Space$(nuero%)
A funo Space$( ) retorna uma srie de nuero% caracteres de espao, entro da
varivel de seqncia sequencia$.
A funo >en( ) melhor utilizada quando ativada em uma procedure que contenha as
outras principais funes de string do vocabulrio do Visual Basic.

Spc( )
Propsito: Espaamento do cursor de texto
Sintaxe: Spc(espacos%)
A funo Spc( ) move o cursor de texto dentro de uma caixa de figura ou outro
controle de "terminal virtual" por um nmero especificado de espacos% para a direita.
Um espao nesse caso a largura do caractere espao no estilo e tamanho do tipo
sendo utilizando.

S;r( )
Propsito: Aquisio da raiz quadrada
Sintaxe: solucao = S8r(expressao)
15
A funo S8r( ) retorna a raiz quadrada do valor reduzido logicamente de expressao,
dentro da varivel solucao.

Str#( )
Propsito: Converso de valor para string
Sintaxe: solucao$ = Str$(valor)
A funo Str$( ) converte os dgitos contidos dentro de valor em uma string
alfanumrica, que colocada dentro da varivel solucao$. O valor da varivel valor
no afetado pela converso.

Strin!#( )
Propsito: Ativao de mltiplos caracteres
Sintaxe -: palavra$ = Strin"$(nuero%, carac$)
Sintaxe .: palavra$ = Strin"$(nuero%, carac7ascii%)
A funo Strin"$( ) produz um nuero% designado de caracteres repetidos como a
varivel de string palavra$. Sob a sintaxe 1 o caractere nico a ser repetido expresso
como carac$, entre aspas. Sob a Sintaxe 2, o caractere nico a ser repetido expresso
como o cdigo ASCII equivalente do caractere que expresso como carac7ascii%.

$ab( )
Propsito: Tabulao do cursos de texto
Sintaxe: !ab(coluna%)
A funo !ab( ) move o cursor de texto dentro de uma caixa de figura ou outro
controle de "terminal virtual" para a coluna% especificada. Uma coluna a qualquer
instante equivale a aproximadamente a largura mdia de cada caractere no estilo e
tamanho do tipo sendo usado, que freqntemente a largura de letra n minscula.

$&pe,5
Propsito: Determinao de tipo de controle
Sintaxe: !%pe+- +bEeto 9s tipo
A funo !%pe+- usada dentro de uma expresso para retornar um valor True/False,
significando se o Objeto declarado - referido pelo uso de um nome de varivel de
objeto - representativo de um tipo particular de objeto reconhecido pelo
interpretador. Os termos de tipo de objeto reconhecidos pela Standard Edition do
Visual Basic so os seguintes:
CheckBox ComboBox CommandButton DirListBox
DriveListBox FileListBox Frame Grid
HScrollBar Image Label Line
ListBox Menu OptionButton PictureBox
Shape TextBox Timer VScrollBar
Controles personalizados adicionados caixa de ferramentas do VB podem utilizar seus
prprios termos de tipo.

Val( )
Propsito: Converso de string para valor
Sintaxe: solucao = val(strin"$)
Nessa sintaxe, strin"$ pode ser uma expresso que concatene vrias string. A funo
Val( ) converte o primeiro conjunto de dgitos com caracteres delimitadores de nmero
em strin"$ para um valor colocado dentro da varivel solucao. O primeiro caractere
alfabtico encontrado dentro de uma string cancela o processo de converso. Uma
string totalmente alfabtico , portanto, convertido em 0. O contedo de strin"$ no
afetado por essa converso. O primeiro conjunto de caracteres diferentes de espao
em strin"$ precisa ser um conjunto de dgitos, ou quaisquer caracteres que o
16
interpretador do Visual Basic normalmente usa para distinguir nmeros fracionrios.
Os pontos decimais so reconhecidos como tais caracteres.

Var$&pe( )
Propsito: Aquisio do tipo de uma variante.
Sintaxe: tipo% = Va!%pe(variant)
: Vazio
- Nulo
. Inteiro
1 Longo
/ Simples
< Duplo
= Moeda
> Data
0 String

17
)?todos do Visual Basic

@Addite%
Propsito: Manuteno de entradas de lista
Sintaxe: CaixalistAAdd9te texto$ ., indice%3
O mtodo AAdd9te coloca o contedo textual de texto$ na caixa de listagem ou de
combinao que tenha o nome de controle Caixalist. Por default, o texto colocado no
final da lista. Opcionalmente, a posio do novo item na lista pode ser especificada por
um nmero como indice%. Os itens de uma lista so contados ou indexados
comeando por 0; o valor de indice% no deve ser maior que o nmero de itens da
lista menos um. O mtodo s pode adicionar itens a uma caixa de listagem
individualmente, e no em grupos ou matrizes.

@Arran!e
Propsito: Regulao de filha MDI
Sintaxe: .pai(D9A3Arran"e layout onde layout pode ter um dos seguintes valores:
0
Em cascata, como uma srie de pginas empilhadas umas sobre as outas, e deslocadas
para baixo e para a direita, expondo as barras de ttulo de cada janela.
1
Lado a lado horizontalmente, para que tantas janelas quantas possveis sejam
distribudas por toda a largura da janela pai MDI, com cada janela filha aparecendo ao
lado da outra na ordem cronolgica de sua invocao. Se houver um nmero grande de
janela filha MDI na rea de trabalho do pai (geralmente, mais de 6), somente umas
poucas primeiras janelas filha exibidas, o nmero exato dependendo da resoluo
grfica atual e o tamanho do pai MDI.
2
Lado a lado verticalmente, demodo que tantas janelas quantas possveis sejam
distribudas por toda a altura da rea de trabalho do pai MDI, com cada janela filha
aparecendo direita da outra na ordem de sua invocao. Se houver um nmero
grande de janela filha MDI na rea de trabalho do pai, somente as primeiras poucas
janelas filha sero exibidas. O nmero exato de janelas filha mostradas depende da
resoluo grfica atual e o tamanho do pai MDI.
3
Reservado para casos nos quais existam janelas filha minimizadas, este valor de layout
reorganiza os cones minimizados ao longo da borda inferior da rea de trabalho do pai
MDI.

@Circle
Propsito: Plotagem de elipse
Sintaxe: .+bEetoA3Circle Step3 (t$ipxF, t$ip%F), raioF., cor;3 ., an"7inicia<F,
an"7-ina<F)., aspectoF3
O mtodo ACircle plota uma srie de pontos em uma curva, todos os quais
geometricamente convergem de um ponto central especificado como (t$ipxF, t$ip%F).
Por default, esse pontos so dispostos para formar um crculo; entretando,
especificando os trs ltimos parmetros individuais, voc pode plotar em vez disso
um arco ou elipse.
A menos que aspectoF seja especificado, cada ponto da srie ser plotado a uma
distncia de raioF twips das coordenadas do centro. Se cor; for especificada, a srie
ser plotada na cor especifica. As funes @D:( ) e C:Color podem ser usadas para
determinar o valor de cor;. Se cor; omitida, a srie plotada com a cor usada como
definio da propriedade .ForeColor do objeto que est recebendo a plotagem.

@Clear
Propsito: Limpeza de uma caixa de listagem
Sintaxe 1: .,orularioA3CaixalistAClear
18
O mtodo AClear esvazia todo o contedo da caixa de listagem antecedente. A
propriedade A>istCount da caixa de listagem definida como zero.

@Clear
Propsito: Apagamento do contedo do clipboard
Sintaxe: ClipboardAClear
O mtodo AClear limpa o contedo atual do clipboard do sistema.

@Cls
Propsito: Limpeza de rea de figura
Sintaxe: .obEetoA3Cls
O mtodo ACls limpa qualquer contedo impresso ou plotado, textual ou grfico, do
objeto grfico especificado. Se obEetoA no estiver especificado, o formulrio no qual a
procedure ACls aparece ser limpo.

@Dra!
Propsito: Ativao do arraste manual
Sintaxe: ControleADra" inteiro%
O mtodo ADra" usado para iniciar ou parar manualmente o processo de arraste de
um controle, seja qual for a definio de ADra"(ode desse controle. Isso
especialmente til se o ADra"(ode do controle estiver definido como 0 (manual) e, por
default, ele no puder ser arrastado. O valor de inteiro% pode ser qualquer dos
seguintes:
0 Cancela o arraste do controle especificado
1 Inicia o arraste do controle especificado, quando o mtodo ADra" aparecer em um
procedimento de evento do controle antecedente.
2 Termina o arraste do controle e sinaliza com um evento 7Dra"Drop para esse
controle.

@+ndDoc
Propsito: Ejeo de documento na impressora
Sintaxe: BrinterA*ndDoc
O mtodo A*ndDoc chamado para sinalizar o trmino do documento interno do
aplicativo e para enviar o sinal de ejeo da ltima pgina para o Print Manager do
Windows. A propriedade ABa"e do documento interno do aplicativo automaticamente
redefinida como 1.

@8etData( )
Propsito: Aquisio de dados do clipboard
Sintaxe: +bEetoABicture = clipboardADetData (-orato%)
O mtodo ADetData atua como uma funo ao retornar o contedo A9a"e ou ABicture
do clipboard do sistema e atribuir esse contedo como propriedade ABicture do Objeto
especificado. Se -orato% for declarado como formato de dados 2,3 ou 8, o contedo
do clipboard ser atribudo propriedade ABicture, independente desses dados terem
sido criados como dados de imagem.

@8etFor%at( )
Propsito: Aquisio de tipo contedo do clipboard
Sintaxe: booleano% = ClipboardADet,orat (-orato%)
O mtodo ADet,orat atua como um funo ao retornar na varivel inteira booleano%
um valor verdadeiro/falso que indica se os dados residindo atualmente no clipboard do
sistema so do -orato% especificado.

19
@8et$ext( )
Propsito: Aquisio de texto do clipboard
Sintaxe: strin"$ = ClipboardADet!ext (-orato%)
O mtodo ADet!ext atua como uma funo, retornando o atual contedo textual de
clipboard do sistema dentro de strin"$A Se -orato% for especificado como tipo 1 ou
&HBF00 (vnculo dinmico), o contedo do clipboard ser retornado em strin"$, quer o
formato seja ou no prprio para esse contedo.

@2ide
Propsito: Suspenso de operao de formulrio
Sintaxe: .noe-orA3A6ide
O mtodo A6ide pega um formulrio sendo mostrado e o remove da tela at ordem
contrria. O formulrio continua a ocupar virtualmente as mesma coordenadas na tela.
Os controles do formulrio oculto podem ainda ser referidos no cdigo-fonte. Em
outras palavras, a operao do formulrio pelo programa no suspensa, mas o
usurio no pode oper-lo.

@ine
Propsito: Plotagem de linha geomtrica
Sintaxe: .+bEetoA3>ine ..Step3 (t$ipx<F, t$ip%<F)3 .Step3 (t$ipx=F, t$ip%=F) ., cor;3.,
:3.,3
O mtodo A>ine define o valor de cor de uma srie linear de todos os twips
endereveis na memria, se estendendo das coordenadas (t$ipx<F, t$ip%<F) at
(t$ipx=F, t$ip%=F). Os dois pares de coordenadas so sempre separados por um hfen.
O valor de cor para cada twip da srie definido, independente de ser ou no visvel
no presente. Se algum dos twips ou todos eles estiverem invisveis ou obstrudos por
algum outro objeto grfico, seus valores de cor sero definidos mesmo assim, e da
modificao (se houver) ser refletida na tela quando esses twips forem tornados
visveis.
Se +bEetoA for especificado, o mtodo definir os valores twip com relao s
coordenadas do objeto especificado. Caso contrrio, o sistema de coordenadas do
formulrio que contm o mtodo ser assumido. A forma que a linha torna
retornvel atravs das propriedades ADra$St%le e ADra$&idht, onde ADra$St%le
representa o tipo de interrupo usada na linha (se houver) e ADra$&idth representa a
largura relativa da linha desenhada.
Se o primeiro par de coordenadas for omitido, o interpretador assumir que a linha
deve se estender do ltimo ponto plotado at as coordenadas especificadas pelo
segundo par, que no pode ser omitido. O hfen, contudo, permanece na instruo do
mtodo. O ltimo ponto plotado em um objeto grfico pode ser obtido atravs das
propriedades ACurrentG e ACurrent) desse objeto. Se nenhum ponto tiver sido plotado
nesse objeto, as coordenadas iniciais (0,0) sero assumidas.

@)oAe
Propsito: Reposicionamento manual de controle
Sintaxe: ControleA(ove es8uerda.,topo%., lar"ura%., altura%333
O mtodo A(ove move o controle designado em um formulrio para a posio em
coordenadas desse formulrio especificada pelos parmetros es8uerda% e topo%.
Somente o parmetro es8uerda% precisa ser especificado para mover o controle
horizontalmente para a nova posio de tips es8uerda%. Se topo% for especificado, o
controle ser movido verticalmente tambm. Se lar"ura% ou altura% forem
especificadas, o controle ser redimensionado depois de ser movido.

@3eBPa!e
20
Propsito: Sinal de ejeo de pgina na impressora
Sintaxe: BrinterA#e$Ba"e
O mtodo A#e$Ba"e chamado para ejetar a pgina sendo impressa. Esse sinal de
ejeo guardado dentro do Print Manager do Windows at ele despachar esse sinal
para a impressora no momento oportuno. A propriedade ABa"e do documento interno
do aplicativo automaticamente incrementada.
Para declarar que o final de um documento foi atingido, o mtodo A*ndDoc chamado.

@Point
Propsito: Aquisio de valor de cor
Sintaxe: cor; = .+bEetoA3Boint(t$ipxF,t$ip%F)
O mtodo ABoint atua como uma funo ao retornar no inteiro longo cor; o valor de
cor RGB do pixel mais prximo das coordenadas de twip especificadas. No entanto, o
mtodo especificado pelo uso de sintaxe orientada para objeto. Se Objeto. for
includo na instruo, o sistema de coordenadas do objeto especificado ser usado.
Caso contrrio, o sistema do formulrio que atualmente contm a instruo ser
assumido.

@Print
Propsito: Exibio de texto
Sintaxe: .obEetoA3Brint /expressao</41,2 expressao=/41,2 AAA expressaon/,1,23 na qual
cada expresso consiste em qualquer expresso matemtica ou de string logicamente
interpretvel.
O mtodo ABrint exibe a forma logicamente reduzida de cada expresso da lista de
expresses. Se obEetoA for especificado, o destinatrio do texto impresso ser o objeto
grfico declarado, tal como Form1, ou um dispositivo de sada, tal como Printer. Se o
interpretador permite que obEetoA seja omitido, a impresso direcionada para a
janela do formulrio ao qual pertence a procedure que contm o mtodo ABrint aparece
no contexto de um mdulo geral. Se o destinatrio obEetoA pertencer a um formulrio
que no o que contm o mtodo ABrint, o nome do formulrio ser especificado antes
do nome do objeto, com ambos os nomes separados um do outro por um ponto.
Uma expresso matemtica - no caso de uma expresso fornecida como um parmetro
- composta de um ou mais valores ou variveis combinados aritmeticamente pelo
uso de smbolos operadores como + ou termos de funo como 9nt( ). Uma expresso
string composta de um ou mais elementos de texto, sejam eles frases alfanumricas,
variveis string, ou funes string tais como @i"ht$( ). Expresses string de mltiplos
elementos podem ser concatenadas pelo uso do operador +. Textos que devam ser
impressos literalmente precisam aparecer entre aspas, como em "Al". Voc pode
imprimir as prprias aspas usando a funo Chr$(HI), com a funo aparecendo fora
de quisquier aspas. Da mesma forma, voc pode expressar outros caracteres especiais
que no aparecem no teclado usando a funo Chr$( ).
O ponto-e-vrgula e a vrgula como delimitadores tm usos especficos com respeito ao
mtodo ABrint. Cada expresso da lista separada das outras por um desses
delimitadores. Se duas expresses so separadas uma da outra por um ponto-e-
vrugla, o texto de ambas as expresses impresso um ao lado do outro (juntos lado a
lado). Se duas expresses so separadas uma da outra por uma vrgula, o
interpretador insere um caractere de tabulao no final da primeira expresso antes de
imprimir o incio da segunda. Uma tabulao equivalente a 14 colunas ou, usando
emprestado um termo da tipografia, 14 enes, onde um ene a largura mdia de uma
letra na fonte atualmente escolhida.
O interpretador do Visual Basic reconhece um cursor virtual par os objetos grficos que
recebem texto usando o mtodo ABrint. A posio em coordenadas desse cursor
21
registrada dentro de propriedades do objeto grfico, chamadas ACurrentG e ACurrent).
Sempre que um mtodo Aprint completa sua execuo, ele deixa por default o cursor
virtual no incio ( por default, no lado esquerdo) da linha imediatamente seguinte
que acabou de ser impressa. Se o mtodo ABrint fechado com um ponto-e-vrgula, a
posio do cursor definida no final imediato do texto que acabou de ser impresso,
sem que o interpretador execute um retorno de carro para a prxima linha. Se o
mtodo ABrint fechado com uma vrgula, o cursor tabulado para a prxima parada
de 14 colunas e permanece lJse que o interpretador execute um avano de linha
para a prxima linha.
Se o mtodo ABrint aparecer em uma linha por si s, um retorno de carro com um
avano de linha ser gerado. Em outras palavras, a "cabea de impresso" movida
para a extremidade esquerda pelo retorno de carro e uma linha para baixo pelo avano
de linha - com o que acontece quando voc pressiona a tecla Return em uma mquina
de escrever eltrica. A posio do cursor virtual ajustada para o incio da prxima
linha abaixo da anteriormente impressa.

@Pset
Propsito: Definio de valor de cor de pixel
Sintaxe: .+bEetoA3BSet .Step3 (t$ipxF, t$ip%F) ., cor;3
O mtodo ABSet define o valor de cor de um ponto de coordenada representado pelas
coordenadas (t$ipxF, t$ip%F). Se o ponto estiver atualmente visvel na tela, o pixel
relativo esse ponto ao longo do sistema de coordenadas de twips atual ter definido
seu valor de cor. Se o ponto no estiver visvel na tela, o ponto na memria ser
definido de qualquer modo, e a mudana (se houver) ser refletida na tela quando
esse ponto for tornado visvel.
Se +bEetoA for especificado, o mtodo definir o valor do ponto com relao s
coordenadas do objeto especificado. Caso contrrio, o sistema de coordenadas do
formulrio que contm o mtodo ser assumido. Se cor; for especificada, o mtodo
ABSet definir o valor de cor do ponto com qualquer valor inteiro longo no intervalo de
0 a 16.777.215, representando uma cor ou padro de cores reconhecido pelo Microsoft
Windows. O valor de cor; pode ser representado pela funo @D:( ) ou C:Coor( ).
Para redefinir um ponto - poara dar-lhe o valor da cor de fundo - o termo de
propriedade A:ac'Color pode ser usado como cor;. Se cor; no for especificada, o
mtodo ABSet definir o valor de cor do ponto como o valor da propriedade A,oreColor
do objeto especificado.
Quando Step est no mtodo, o interpretador VB considera o sistema de coordenadas
expresso em (t$ipxF, t$ip%F) como sendo relativo ao ltimo ponto plotado, ou em
relao a (0,0) se nenhum ponto tiver sido plotado. O ltimo ponto plotado em um
objeto grfico pode ser obtido atravs das propriedades ACurentG e Current) desse
objeto.
A largura e a altura do ponto sendo plotado com ABSet podem ser definidas
previamente com a propriedade ADra$&idth do objeto que recebe o ponto. O ponto
pode ser plotado como um ponto invisvel - existente embora no visto - pela definio
da propriedade ADra$St%le do objeto como 5.

@6e5res"
Propsito: Atualizao forada do contedo de um objeto
Sintaxe: +bEetoA@e-resh
O mtodo A@e-resh diz ao interpretador para suspender temporariamente os processos
matemticos, por tempo suficiente para que ele atualize o contedo do +bEeto
especificado. Esse contedo pode ter sido destinatrio de instrues grficas ou de
alterao de texto, mas o interpretador pode ter deixado de lado a execuo dessas
22
instrues para poupar tempo. Se o objeto especificado no tem pendentes tais
atualizaes, nada acontece.

@6e%oAeIte%
Propsito: Manuteno de entradas na lista
Sintaxe: CaixalistA@eove9te indice%
O mtodo A@eove9te elemina da caixa de listagem ou de combinao especificada o
item endereado por indice%. O mtodo s pode remover itens de uma caixa de
listagem individualmente, e no em grupos ou matrizes.

@Scale
Propsito: Estabelecimento de sistema de coordenadas varivel
Sintaxe: .+bEetoA3Scale .(ori"xF, ori"%F) K (extxF, ext%F)3
O mtodo AScale define o par de coordenadas do canto superior esquerdo do objeto
antecedente como (or"xF, ori"%F) e par de coordenadas do canto inferior direito do
objeto como (extxF, ext%F). Se ambos os pares de coordenadas forem omitidos, a
escala do objeto ser redefinida para a escala default de coordenadas de twips.

@SetData
Propsito: Colocao de dados no clipboard
Sintaxe: ClipboardASetData +bEetoA/9a"e 1 Bicture2 ., -orato%3
O mtodo ASetData atribui ao clipboard do sistema o ABicture (mapa de bits no
formulrio) ou A9a"e (mapa de bits na memria) referido usando sintaxe orientada
para objeto. Por default, a imagem assumida como sendo um mapa de bits padro
do formato de dados 2; entretanto, os formatos 3 e 8 tambm so suportados.

@SetFocus
Propsito: Definio do indicador manual
Sintaxe: .ControleA3Set,ocus
O mtodo ASet,ocus aponta manualmente o controle antecedente como sendo o
controle ativo, dando-lhe portanto o foco.
Para o interpretador VB, inteiramente "legal" para um formulrio receber o foco. Em
interpretaes anteriores do paradigma focus, o controle que tinha o foco era mantido
pelo formulrio que tinha o foco.
No Visual Basic, oferecida uma alternativa para esse dualismo. Agora, o formulrio
que tem o foco reside dentro do formulrio ativo. Esse formulrio ento dito como
sendo ativado ou desativado pelo usurio. Ambas essas aes podem ser registradas
como eventos, e so atribuidas ao formulrio.

@Set$ext
Propsito: Colocao de texto no clipboard
Sintaxe: ClipboardASet!ext strin"$., -orato%3
O mtodio ASet!ext coloca o texto atualmente referido como strin"$ no clipboard do
sistema. Por padro, o texto assumido como sendo do formato de dados 1, a menos
que especificado como &HBF00, situao na qual o texto assumido como sendo parte
de uma operao de vnculo dinmico.

@S"oB
Propsito: Exibio de formulrio na rea de trabalho
Sintaxe: .noe-orA3Sho$ .estilo3
O mtodo ASho$ exibe um formulrio que se encontre em seu estado carregado,
embora no visvel. Se o formulrio no tiver sido carregado ainda na rea de
trabalho, ele ser carregado automaticamente, e o procedimento de evento Sub ,or
23
>oad( ) desse formulrio, se houver, ser disparado. Se o noe-or for omitido, o
formulrio grfico compartilhando o mdulo atual com o procedimento atualmente em
execuo ser mostrado. O valor estilo opcional, quando definido como 1 (0 o
padro) torna modal o formulrio exibido - em outras palavras, nenhuma outra janela
pode aceitar entrada do usurio at que se saia deste formulrio.

@$ext2ei!"t e @$ext'idt"
Propsito: Aquisio de tamanho de texto
Sintaxe: valor%=.+bEetoA3!ext6ei"ht(strin"$) 1 valor%=.+bEetoA3!ext&idht(strin"$)
Os mtodos A!ext6ei"ht e A!ext&idth so chamados como funes, exceto por serem
espressos com o uso de sintaxe orientada para objeto. Esses mtodos retornam a
altura e largura, respectivamente, do texto expresso em strin"$ como ele apareceria
no +bEeto especificado se impresso atravs do mtodo ABrint. Esses valores so
retornados no inteiro valor% como se os mtodos fossem funes. Esses mtodos s
funcionam com objetos de terminal virtual como caixa de figura ou formulrios, ou o
dispositivo impressora. Se +bEeto no for especificado, o formulrio que contm a
procedure atualmente em execuo ser usado.

@C,rder
Propsito: Designar a exposio na tela
Sintaxe: .ControleA3L+rder posicao%
O mtodo AL+rder define a ordem de representao do Controle designado dentro de
seu formulrio para a posicao% dada. Aqueles controles aos quais se deu uma
posicao% mais baixa so representados primeiro; auqeles com nmeros seguintes so
representados depois. Se a rea ocupada por um controle posterior na seqncia se
sobrepor a qualquer dos controles anteriores, o controle posterior aparecer na frente
daquele ao qual se sobrepor.
A ordem na qual o programador coloca os controles quando da estruturao estabelece
a ordem z natural dos controles em um formulrio. Como AL+rder um mtodo e no
uma propriedade ele s pode ser usado durante o tempo de execuo de um aplicativo
para alterar a seqncia de exibio.

24

+Aentos do Visual Basic

DActiAate e DDeactiAate
AEo: Acionamento de formulrio
Se Aplica a: Formulrios (no MDI)
ParF%etros: Nenhum
O evento 7Activate de um formulrio disparado sempre que o usurio indica esse
formulrio, ou passa o controle para ele atravs de qualquer rotina que o carregue
formalmente na rea de trabalho. Isso tambm pode ser disparado pela passagem do
foco pelo formulrio, ou por dar o foco a um controle desse formulrio. O eventor
7Deactivate disparado sempre que um outro formulrio residente na rea de
trabalho indicado, ou caso alguma atividade ou rotina torne algum outro formulrio
ativo. Ele no disparado por um formulrio quando este descarregado ou oculto.

DC"an!e
6epresentaEo: Alterao de status
Se Aplica a: Etiqueta, texto, figura, diretrio, dispositivo, lista combinao, rolagem.
ParF%etros: ndice (somente arrays de controles)
O evento 7Chan"e reconhecido sempre que o contedo ou representao de status
do objeto antecedente modificado. Essa modificao pode ser devida ao usurio
alterar a posio ou contedo do objeto, ou por uma instruo do cdigo-fonte VB
modificar uma propriedade do objeto. Para uma etiqueta ou campo de texto, 7Chan"e
reconhecido quando seu contedo textual alterado, ou quando um caractere a
adicionado ou removido do campo. Para uma caixa de imagem, 7Chan"e reconhecido
quando seu contedo grfico alterado. Para uma caixa de listagem ou dispositivo
relacionado, 7Chan"e reconhecido quando o contedo da lista alterado ou
acrescido de algo, ou quando a seleo representada por aquela lista alterada. Para
uma barra de rolagem, 7Chan"e reconhecido quando a caixa de rolagem movida.

DClic(
AEo: Indicao do usurio
Se aplica a: Boto, verificao, combinao, diretrio, arquivo, formulrio, grade,
imagem, rtulo, lista, menu, opo, figura, texto.
O eventos 7Clic' de um controle reconhecido sempre que o usurio pressiona e solta
o boto indicador do mouse enquanto o apontador est sobre esse controle.
Lembre-se, o termo boto indicador aqui se refere ao boto esquerdo em sistemas
desktop; para usurios canhatos, porm, este pode ser o boto direito. Para usurios
de mouse de laptop, este pode ser o boto comprido ao longo do lado do mouse. A
procedure de evento Sub Controle7Clic' ( ) a geralmente utilizada para
desemprenhar a funo de comando associada a ess controle. Trs outros eventos do
vocabulrio do VB esto associados ao ato de indicar um controle como uma maneira
de dar um comando para o aplicativo. Um deles, naturalmente o evento de duplo
clique.

DDblClic(
AEo: Indicao do usurio
Se Aplica a: Boto, verificao, combinao, diretrio, arquivo, formulrio, grade,
imagem, rtulo, lista, opo (no MDI), figura, texto.
25
O evento 7DblClic' de um controle reconhecido sempre que o usurio pressiona e
solta rapidamente o boto indicador do mouse duas vezes enquanto o apontador est
sobre esse controle.

DDra!Drop
AEo: Liberao de cone arrastado
Se aplica a: Verificao, combinao, comando, diretrio, unidade de disco, arquivo,
formulrio, moldura, grade, imagem, etiqueta, lista, MDI, opo, figura, rolagem, texto
ParF%etros: 9ndex As 9nte"er (soente arra%s de controles), Source As Control, G As
Sin"le, ) As Sin"le
O evento 7Dra"Drop de um controle reconhecido quando o objeto de arraste
atribudo a um outro controle - geralmente um cone - arrastado para cima dele e o
boto do mouse solto. O procedimento para esse evento leva trs parmetros:
Source como uma varivel de um objeto que representa o objeto de arraste, declarada
como sendo do tipo Control, e as coordenadas X e Y do apontador do mouse no
momento de largar.

DDra!,Aer
AEo: Travessia do cone arrastado
formulrio, moldura, grade, imagem, etiqueta, listagem, opo, MDI,figura, rolagem,
texto
ParF%etros: 9ndex As 9nte"er (soente arra%s de controles), Source G As Sin"le, )
As Sin"le, State As 9nte"er
O evento 7Dra"+ver de um controle ocorre quando o objeto de arraste atribudo a um
outro controle arrastado por cima dele, independentemente do boto do mouse ser
solto. O procedimento desse evento leva quatro parmetros: a varivel de objeto
Source, que contm as propriedades do objeto nativo do objeto de arraste, declarada
como sendo do tipo Contro1; as coordenadas X e Y do apontador do mouse no
momento de largar; e um inteiro State, que registra o estado do progresso da
operao de arraste. Esse inteiro recebe um dos seguintes valores dados pelo
interpretador:
M O apontador est entrando na rea do controle alvo.
< O apontador est saindo da rea do controle alvo.
= O apontador est dentro da rea do controle alvo
O objeto de arraste de um controle no aparece por padro em tempo de execuo;
atravs de uma propriedade, um controle informado de sua capacidade de arraste.

DDropDoBn
AEo: Aparncia do painel de lista subordinada
Se aplica a: Combinao
O evento 7DropDo$n de uma caixa de combinao ativido sempre que o usurio
clica no boto de seta para baixo da caixa de combinao. Este evento , com efeito, o
evento "Click" do boto de seta para baixo.

D8otFocus e DostFocus
AEo: Obteno/perda do indicador de controle
Se Aplica a: Todos os controles, formulrios (no MDI)
ParF%etros: Index (somente arrays de controles)
O evento 7Dot,ocus de um controle ocorre sempre que ele adquire o foco, como um
resultado do usurio indic-lo com o mouse ou a tecla Tab, ou atravs de definio
direta do foco pelo programa. A aquisio do foco faz desse controle especfico o
26
destinatrio de eventos iniciados pelo teclado. Conseqntemente, o evento
7>ost,ocus de um controle ocorre sempre que ele perde o foco, admitindo claro que
ele chegou a possuir o foco.
Se necessrio, o programa pode definir o foco de um controle manualmente, forando
assim para ele o papel de controle ativo.

D(e&DoBn e DGe&4p
AEo: Ativao ou liberao de tecla
Se aplica a: Formulrio, verificao, combinao, comando, diretrio, unidade de
disco, arquivo, grade, lista, opo, figura, rolagem, texto.
ParF%etros: 9ndex As 9nte"er (soente arra%s de controles), Ne%Code As 9nte"er,
Shi-t As 9nte"er
O evento 7Ne%Do$n de um formulrio ou controle reconhecido sempre que esse
objeto grfico tem o foco e o usurio pressiona uma tecla no teclado. O evento
7Ne%Do$n continua a ser reconhecido para esse controle contanto que essa tecla
permanea pressionada. Dois parmetros so passados para o procedimento nesse
evento: o cdigo de varredura da tecla pressionada (que no deve ser confundido com
o alor de cdigo ASCII do caractere que a tecla geralmente representa) e um inteiro
com um padro de bytes que representa o estado de pressionamento da tecla de
alterao. Este inteiro pode ter qualquer dos seguintes valores.
M Nenhuma tecla de alterao pressionada
< Uma das teclas Shift pressionada
= Uma das teclas Ctrl pressionada
H Control + Shift pressionadas
I Tecla Alt pressionada
O Alt + Shift pressionadas
P Alt + Ctrl pressionadas
7 Alt + Ctrl + Shift pressionadas
O evento 7Ne%?p de um objeto grfico reconhecido sempre que esse objeto tem o
foco e o usurio solta uma tecla que estava pressionada. Falando logicamente, o
evento reconhecido quando o cdigo de varredura de tecla anteriormente registrado
volta para 0. O interpretador VB para o procedimento de evento 7Ne%?p os mesmos
valores que para o evento 7Ne%Do$n.

DGe&Press
AEo: Reconhecimento de caractere
Se Aplica a: Formulrio, verificao, combinao, comando, diretrio, unidade de
disco, arquivo, grade, listagem, opo, figura, rolagem, texto.
ParF%etros: 9ndex As 9nte"er (soente arra%s de controles), Ne%Ascii As 9nte"er
O evento 7Ne%Bress de um formulrio ou controle reconhecido sempre que esse
objeto grfico tem o foco e uma tecla pressionada no teclado. O evento 7Ne%Bress
no continua a ser reconhecido por padro se a tecla for mantida pressionada;
entretanto, se a repetio de teclas estiver selecionada atravs do painel de controle
do Windows, o pressionamento continuado da tecla faz eventualmente com que o
Windows repita a tecla, fazendo parecer para o interpretador VB que o evento
7Ne%Bress ocorre repetitivamente. O valor de cdigo ASCII do caractere com sua tecla
correspondente pressionada o nico parmetro passado para a procedure deste
evento.

D)ouseDoBn e D)ouse4p
AEo: Ativao do boto do mouse
Se Aplica a: Diretrio, arquivo, formulrio (noMDI), grade, imagem, etiqueta,
listage, figura
27
ParF%etros: 9ndex As 9nter"et (soente arra%s de controles), :utton As 9nte"er,
Shi-t As 9nte"er, G As Sin"le, ) As Sin"le
O eveno 7(ouseDo$n de um objeto grfico reconhecido sempre que esse objeto tem
o foco e o usurio pressiona qualquer boto do mouse. O interpretador do Visual Basic
passa quatro parmetros para o procedimento desse evento. O primeiro parmetro,
Button, o estado dos botes do mouse, supondo at trs botes para o mouse. Esse
valor pode ser definido como qualquer dos seguintes:
< Boto esquerdo (boto indicador default) pressionado
= Boto direito pressionado
H Botes esquerdo e direito pressionados
I Boto do meio pressionado
O Botes do meio e da esquerda pressionados
P Botes do meio e da direita pressionados
7 Botes do meio, da esquerda e da direita pressionados
O segundo valor passado para o evento 7(ouseDo$n - Shi-t - reflete o estado atual
das teclas de alterao do teclado quando o boto do mouse registrado como
pressionado. Esse valor pode ser definido como qualquer dos seguintes:
M Nenhuma tecla de alterao pressionada
< Uma das teclas Shift pressionada
= Uma das teclas Ctrl pressionada
H Teclas Shift e Ctrl pressionada
I Uma das teclas Alt pressionadas
O Teclas Alt e Shift pressionadas
P Teclas Alt e Ctrl pressionadas
7 Teclas Alt, Shift e Ctrl pressionadas
O terceiro e quarto valores passados para a procedure de evento 7(ouseDo$n - G e )
- refletem a posio atual em coordenadas do apontador do mouse com respeito ao
objeto grfico ao qual este procedimento atribudo.
O evento 7(ouse?p de um objeto grfico reconhecido sempre que esse objeto tem o
foco e o usurio libera um boto pressionado do mouse. O interpretador VB passa para
o procedimento de evento 7(ouse?p os mesmos valores que passa o procedimento de
evento 7(ouseDo$n.

D)ouse)oAe
AEo: Movimento do apontador
Se aplica a: Diretrio, caixa de arquivo, formulrio (no MDI), grade, imagem,
etiqueta, listagem, figura
ParF%etros: 9ndex As 9nte"er (soente arra%s de controles), :utton As 9nte"er, Shi-t
As 9nte"er, G As Sin"le, ) As Sin"le
O evento 7(ouse(ove de um objeto grfico reconhecido sempre que ele tem
atualmente o foco e a o apontador do mouse movido quando reside sobre a rea
desse objeto.
O evento 7(ouse(ove pode ocorrer somente em uma caixa de arquivo, uma caixa de
etiqueta, uma caixa de listagem, uma caixa de figura, ou um formulrio. Para a
procedure de evento 7(ouse(ove so passados quatro parmetro, como descritos
anteriormente para o evento 7(ouseDo$n.

DPaint
Aao: Raquisio de imagem de reserva
Se aplica a: Formulrio, figura
ParF%etros: 9ndex As 9nte"er (soente arra%s de controles)
O evento 7Baint de um formulrio ou de caixa de figura reconhecido quando a
propriedade AAutoDra$ desse objeto definida como ,alse(M), e o objeto antecedente,
28
antes obstrudo (parcial ou totalmente) parcial ou totalmente desobstrudo. Isso
permite que o programa redesenhe manualmente o objeto, economizando assim
memria para outras finalidades.

DPat"C"an!e
AEo: Alterao de caminho de diretrio
Se aplica a: Arquivos
ParF%etros: #enhuA
O evento 7BathChan"e de uma caixa de listagem de arquivos ocorre sempre que o
caminho sendo atualmente pesquisado para obteno de seu contedo modificado
por alguma razo, seja pelo programa ou pelo usurio. O evento disparado sempre
que a propriedade ABath diretamente modificada pelo programa.

DPatternC"an!e
AEo: Alterao de padro de procura de arquivos
Se aplica a: Arquivos
ParF%etros: #enhu
O evento 7BatternChan"e de uma caixa de listagem de arquivos ocorre sempre que o
padro sendo atualmente comparado com o caminho de procura atual para obteno
de arquivos coincidentes modificado por alguma razo, seja pelo programa ou pelo
usurio. O evento disparado sempre que uma mudano feita diretamente na
propriedade ABatternA

D6oBColC"an!e
AEo: Movimento do ponteiro de clula
Se aplica a : Grade
ParF%etros: #enhu
O evento 7@o$ColChan"e de uma grade disparado sempre que o ponteiro de clula
atual movido para uma nova posio, seja por meio de interao com o usurio ou
por uma procedure que defina manualmente a propriedade A@o$ ou ACol da grade.

DSelC"an!e
AEo: Ativao de indicao de clulas
Se aplica a: Grade
ParF%etros: #enhu
O evento 7SelChan"e de um controle grade disparado sempre que um processo de
indicao de clulas comea, seja por interao do usurio com a grade, ou pela
definio de uma das propriedades ASelx da grade.

D$i%er
AEo: Passagem de intervalo
Se aplica a: Controle timer
ParF%etros: #enhu
O evento 7!ier ocorre para um formulrio que contenha yum controle timer, depois
de cada passagem de um determinado intervalo de tempo conforme especificado na
propriedade interval.

29
Propriedades do Visual Basic

@Action
Especifica qual dilogo comum deve ser exibido
A definio da propriedade AAction faz duas coisas. Primeiro ela especifica qual caixa de
dilogo deve ser exibida. Segundo, ela realmente exibe essa caixa de dilogo. Por
exemplo, a declarao C(Dialo"<AAction = < faz com que a caixa de dilogo File Open
seja exibida.

@Ali!n
6epresentaEo: Alinhamento automtico de figura
Se aplica a: Figura
De5inida por %eio de: Janela Properties
A definio da propriedade AAli"n de uma caixa de figura representa sua colocao
automtica em um formulrio padro ou formulrio MDI. A definio denota se a caixa
de figura deve, por default, ser esticada pela extenso do formulrio ao qual pertence,
bem como se ela deve ser posicionada ao longo das bordas superior ou inferior por
default. Com AAli"n definida como um valor diferente de zero, o interpretador
reposiciona a caixa de figura quando do projeto como especificado. As definies dessa
propriedade podem ser as seguintes:
M A caixa de figura pode aparecer em qualquer lugar como posicionada (esse o
default para um formulrio convencional).
< A caixa de figura esticada para se ajustar .Width (largura) do formulrio, e
posicionada ao longo da borda superior (esse o defalt para um formulrio MDI).
= A caixa de figura esticada para se ajustar .Width do formulrio, e posicionada
ao longo da borda inferior.

@Auto6edraB
6epresentaEo: Permisso de reserva de imagem
A propriedade AAuto@edra$ de um formulrio ou caixa de figura definida como um
valor !rueQ,alse que denota se o interpretador deve manter na memria um mapa de
bits persistente da imagem especificada. Se a propriedade estiver definida como !rue,
sempre que um outro objeto for movido por processo ou movimento dirigido pelo
usurio, sobrepondo parcial ou totalmente o objeto antecedente da propriedade, a
poro grfica desse objeto ser retida na memria. Quando a poro no estiver mais
obstruda, o interpretador ir automaticamente replotar o contedo grfico no objeto.
Se a propriedade estiver definida como False, sempre que um outro objeto for movido
para uma rea que obstrua o objeto antecedente, a poro obstruda ser, com efeito,
apagada do objeto. Entretanto, quando o objeto no estiver mais obstrudo, o evento
7Baint ser gerado, e uma procedure de evento 7Baint poder ser invocada para
atualizar ou reparar o contedo do objeto obstrudo.

Bac(Color e @ForeColor
6epresentaEo: Designao de cores slidas
Se aplica a: Todos os controles, formulrios, objeto Printer (somente .ForeColor)
De5inida por %eio de: Janela Properties, instruo de programa
A propriedade A:ac'Color de um controle reflete sua cor de fundo atual. A propriedade
A,oreColor de um controle representa a cor de apresentao de texto e elementos
grficos - tais como bordas - dentro desse controle. Ambas as propriedades so
expressas como valores hexadecimais de seis dgitos. Esses valores representam
digitalmente o esquema de mistura de cores atualmente em uso. Como as placas
30
grficas (e portanto os controladores de placas grficas) no so todas iguais, as cores
escolhidas para objetos no sistema onde o aplicativo est sendo programado podem
no ser idnticas (ou mesmo prximas) s cores representadas em algum outro
sistema.

@Bac(St&le
6epresentaEo: Estado de preenchimento slido
Se aplica a: Objeto shape
A propriedade A:ac'St%le de um objeto de forma definida como um valor 0 ou 1 que
significa se a forma preenchida com uma cor slida. O valor de M (o default) significa
que a rea dentro dos limites fechados da forma transparente, enquanto que o valor
de 1 significa que a rea preenchida com um cor especificada pela propriedade
A:ac'Color da imagem. Por default, a A:ac'Color de um forma definida como branco.

BorderColor
6epresentaEo: Cor de contorno
Se aplica a. Objeto line, objeto shape
A propriedade A:orderColor de um bojeto de forma ou de linha definida com um valor
hexadecimal de seis dgitos que representa o valor de cor do Windows para os pixels
usados para gerar a linha. Voc pode usar um valor decimal dentro de instrues do
cdigo-fonte para se referir a valores de cores; entretanto, voc pode achar mais fcil
usar valores hexadeximais para esse fim porque a diviso entre seis dgitos
hexadecimais lembra melhor a diviso entre os seis parmetros de cor usados para
gerar o valor. Quando voc define a propriedade A:orderColor atravs da janela
Properties, uma paleta de cores aparece abaixo da linha de entrada para que voc
possa escolher uma cor adequada visualmente em vez de ter que lembrar seu nmero
hexadecimal.

@BorderSt&le
6epresentaEo: Tipo de envoltrio exibido
Se aplica a: Todos os controles, formulrios, formulrios MDI
A propriedade A:orderSt%le representa a classificao interna de um formulrio ou
controle mantida pelo Visual Basic. Controle que o nome do objeto grfico que seja o
antecedente da propriedade tenha sido atribudo atravs de sua propriedade A#ae, o
interpretador VB sabe se deve aplicar o conjunto de categoria de formulrio ou de
controle ao objeto grfico.

@BorderSt&le
6epresentaEo 2: Modo de tracejamento de linhas
Se aplica a: Controle linha, controle forma
A propriedade A:orderSt%le de um controle de linha ou de forma, na representao 2,
reflete o tracejamento atual que aplicado "marca" que gera a aparncia desse
controle. Isto permite a gerao de linhas pontilhdas ou interrompidas. Os estilos de
marcao representveis pela propriedade A:orderSt%le aparecem a seguir:
M (transparente)
< _____(linha slida, default)
= - - - - (traos)
H (pontos)
I ___ (trao-ponto)
31
O __ (trao-ponto-ponto)
P _______(slida interior)

@Border'idt"
6epresentaEo: Extenso da marca em pixels
Se aplica a: Controle linha, controle forma
A propriedade A:order&idth de um controle de linha ou de forma representa o
comprimento, em pixels, da "pena" usada para gerar a imagem visvel desse controle.
Para um controle de forma, por default, esta largura considerada como sendo a
largura, em pixels se estendendo para fora a partir do centro desse controle. Se o
A:orderSt%le do controle for definido como 6, essa largura ser dobrada, uma vez que
o mesmo nmero de pixels se estende para dentro em direo ao centro. A
A:order&idth de um controle no pode ser definida como M; para representar um
controle aparentemente invisvel (no realmente invsivel, na tica do interpretador),
use uma propriedade A:orderSt%le de zero.

@Caption
6epresentaEo: Contedo textual no editvel
Se aplica a: Etiqueta, boto, verificao, opo, formulrio, quadro, menu
A definio da propriedade ACaption de um controle em um formulrio reflete o
contedo textual desse controle. A definio da propriedade ACaption de um formulrio
reflete o contedo textual de sua barra de ttulo. Em cada um desses casos, o usurio
no pode editar diretamente o contedo textual dentro do controle, embora eventos
disparados pelo usurio possam fazer com que instrues de programa mudem a
propriedade ACaption. O comprimento mximo em caracteres da definio de uma
propriedade ACaption 2.048 caracteres.

@CellSelected
6epresentaEo: Status de indicao de ponteiro
Se aplica a: Grade
De5inida por %eio de: Instruo de programa, interao com o usurio
A propriedade ACellSelected de uma grade definida como um valor !rueQ,alse,
denotando se as definies atuais das propriedades A@o$ e ACol colocam o ponteiro de
clula em uma regio indicada de clula.

@C"ec(ed
6epresentaEo: Marcao de item de menu
Se aplica a: Menus
De5inida por %eio de: Janela Menu Design, instruo de programa
A propriedade AChec'ed de uma seleo de menu definida como um valor !rue ou
,alse (usando !rueQ,alse ou +nQ+--) que designa se um marca de verificao aparece
ao lado da seleo. Essa propriedade no muda o efeito do menu ou de quaisquer
objetos aos quais suas procedures de evento podem se referir. Ela meramente
desenha ou remove uma marca de verificao ao lado da seleo. Voc pode usar essa
propriedade para ajudar a designar se um determinado recurso do programa
representado pela seleo do menu est atualmente ativo.

@Clip
6epresentaEo: Contedo coletivo das clulas indicadas
Se aplica a: Grade
De5inida por %eio de: Instruo de programa
32
A propriedade AClip de um controle grade definida automaticamente pelo
interpretador Visual Basic como o contedo textual de cada clula na regio indicada
da grade. A propriedade "l" da esquerda para a direita, e ento de cima para baixo.
Um caractere de tabulao representado por Chr$(R) separa o contedo das clulas
que compartilham a mesma linha. Uma vez que a "leitura" tenha chegado ao final da
linha, a prxima linha abaixo dela lida para a propriedade comeando pela clula
extrema esquerda. Esse retorno de carro de clulas representado na propriedade
AClip por um caractere ANSI de retorno de carro, Chr$(<H).

@ColAli!n%ent( )
6epresentaEo: Peso do contedo textual
Se aplica a: Grade
A propriedade AColAli"nent ( ) um array cujos elementos individuais se aplicam,
por nmero, s colunas de seu objeto grade antecedente - especificamente a suas
clulas no fixas. As definies de cada elemento refletem o eixo contra o qual o
contedo textual das clulas de cada coluna colocado. A propriedade pode ser
definida com qualquer um dos seguintes valores:
M Alinhamento esquerdo (default)
< Alinhamento direito
= Centrado
Voc pode definir o alinhamento de uma coluna em particular atravs de uma
instruo que use a seguinte sintaxe:
DradeAColAli"nent(coluna%) = de-inicao%

@ControlBox
6epresentaEo: Especifica o status da caixa de controle da janela
Se aplica a: Formulrios
A propriedade AControl:ox definida como um valor !rue ou ,alse, refletindo se a
caixa de controle da janela aparece no formulrio para essa janela. Por default,
formulrio AControl:ox definida como verdadeira. Essa propriedade redefinida ou
definida somente quando da estruturao, e tem efeito quando o aplicativo
executado.

@Copies, @Fro%Pa!e e @$oPa!e
Estas propriedades especificam o nmero de cpias a serem impressas e o intervalo de
pginas a ser impresso. Por exemplo, se ACopies tem um valor de 2, A,roBa"e tem
um valor de 4, e A!oBa"e tem um valor de 6, seu programa deve imprimir duas cpias
das pginas 4, 5 e 6.

@CurrentH e @Current*
6epresentaEo: Coordenadas do apontador do terminal virtual
Se aplica a: Formulrio, figura, impressora
As propriedades ACurrentG e ACurrent) de um objeto grfico terminal virtual so
definidas pelas coordenadas atuais do cursor desse objeto. Por default, essas
coordenadas so expressas graficamente como twips, a menos que a propriedade
AScale(ode desse objetos esteja definida de outra forma. As definies dessas
propriedades sio relativas escala de coordenadas atual do objeto grfico ou
dispositivo.

@De5ault e @Cancel
33
6epresentaEo: Aceitao/rejeio de atribuio de tecla
Se aplica a: Comando
De5inidas por %eio de: Janela Properties, instruo de programa
A propriedade ADe-ault de um boto definida como verdadeira se o usurio pode
pressionar Enter em vez de clicar nesse boto. Geralmente, esse boto implica em que
o usurio aceita as condies definidas dentro do painel. Similarmente, a propriedade
ACancel de um boto definida como verdadeira se o usurio pode pressionar Esc em
vez de clicar nesse boto. Geralmente, esse boto implica em que o usurio rejeita as
condies definidas no painel.

@Dra!Icon
6epresentaEo: Nome de arquivo do objeto de arrast
moldura, grade, imagem, etiqueta, listagem, opo, figura, rolagem, texto
A propriedade ADra"9con contm o nome de arquivo de uma figura ou cone que o
Visual Basic usa como objeto de arraste de um controle. Quando o arrastar est
ativado para um controle - e o usurio clica e mantm pressionado o apontador sobre
o controle que tem uma propriedade ADra"9con que tenha sido definida com o nome de
arquivo de um cone - uma imagem mostrada. Quando o usurio clica no objeto
fonte, o objeto de arraste aparece em preto e branco no lugar do apontador atual,
enquanto o boto indicador estiver pressionado. Esse objeto de arraste pode ento
seguir o apontador at o objeto alvo do arraste.

@Dra!)ode
6epresentaEo: Acessibilidade do apontador do controle
formulrio, moldura, grade, imagem, etiqueta, listagem, MDI, opo, figura, rolagem,
texto.
A propriedade ADra"(ode de um controle definida como 1 para tornar esse controle
automaticamente arrastvel em tempo de execuo. O default da propriedade M; isso
significa que o arraste pode ser ativado com o cdigo-fonte, seja uma s vez com o
mtodo ADra", ou pelo restante do programa com a instruo ControleADra"(ode = <
at ser desativado com ControleADra"(ode = M. Observe que essa propriedade um
indicador e no um registro booleano verdadeiro ou falso, portanto ADra"(ode no
uma propriedade passvel de ser definida como !rue(K<).

@DraBSt&le
6epresentaEo: Atribuio de tracejamento da plotagem
A propriedade ADra$St%le de um objeto terminal virtual definida com um valor que
representa o estilo da linha que ser produzida pelo prximo mtodo, que desenhe ua
srie de pontos no objeto. Essa propriedade pode levar qualquer dos valores
seguintes:
M ____(Slida, posicionada metade dentro, metade fora da rea da caixa - o default)
< ----(Traos)
= ......(Pontos)
H -.-.-(Trao-ponto)
I __(trao-ponto-ponto)
O (Invisvel)
P ____ (Slida, embora inteiramente dentro da rea da caixa)
34

@DraB'idt"
6epresentaEo: Atribuio de largura de plotagem
A propriedade ADra$&idth definida como a largura, em pixels, de quaisquer linhas ou
pontos a serem plotados no objeto antecedente pelo uso de mtodos grficos.

@DriAe
6epresentaEo: Dispositivo ativo
Se aplica a: Unidades de disco
A propriedade ADrive de uma caixa de listagem de unidades de disco definida com o
texto de sua nica entrada selecionada. A sintxe da definio de propriedade textual
a seguinte: drive: \ [nome_volume]
O nome completo do volume atribudo ao dispositivo de unidade de disco quando
formatado pela ltima vez aparece entre colchetes aps o identificador de dispositivo.

@+nabled
6epresentaEo: Status de operacionalidade do controle
Se aplica a: Todos os controles, menus, formulrios
De5inida por %eio de: Janela Properties, janela Menu Design, instruo de programa
A propriedade A*nabled de um controle definida como um valor !rue ou ,alse que
designa se um controle responde a eventos do usurio. Por default, esse propriedade e
definida como !rue. Para desativar um controle mas permitir que ele permanea
dentro de um formulrio, ou para tornar cinza ua seleo dentro de um menu, voc
define essa propriedade como False.

@+rrorCancel
Esta propriedade especifica se a varivel Err deve ser definida se o usurio pressionar
o boto Cancel
Uma vez que uma caixa de dilogo comum esteja exibida, ela pode ser encerrada pelo
pressionamento tanto do boto OK como do boto Cancel. Se .ErrorCancel estiver
definida como True, Err ser definida com o valor numrico 32755(CDERR_CANCEL).
Se .ErrorCancel estiver definida como False, a varivel Err no ser afetada.

@File3a%e
Esta propriedade contm o nome do arquivo selecionado. A propriedade A,ile#ae
pode ser usada de duas maneiras. Primeiro, se definida antes da definio da
propriedade AAction (antes da caixa de dilogo ser exibida), ela especifica o nome de
arquivo inicial que colocado na caixa de texto File Name. Segundo, quando o usurio
de seu programa sai da caixa de dilogo via boto OK, o nome do arquivo que o
usurio selecionou e colocado na propriedade.

@File3a%e
6epresentaEo:Nome de arquivo escolhido
Se aplica a: Caixa de listagem de arquivos
A propriedade A,ile#ae de uima caixa de listagem de arquivos definida com o texto
de sua nica entrada selecionada. A sintaxe deste texto a seguinte: noear8Aext
O texto reflete somente o nome do prprio arquivo com sua extenso de trs letras
independente do diretrio em que ele esteja.

35
@FillColor
6epresentaEo: Cor slida de plotagem fechada
De5inida por %eio de: Janela Propriedades, instruo de programa
A propriedade A,illColor definida com a cor RGB a ser reservada para todas as formas
fechadas produzidas com mtodos grficos. O valor default de A,illColor M (preto).

@FillSt&le
6epresentaEo: Atribuio de padro de plotagem fechada
A propriedade A,illSt%le definida com o padro de preenchimento a ser reservado
para todas as formas fechadas produzidas com mtodos grficos. O valor de A,illSt%le
pode ser qualquer dos valores descritos. A definio default de A,illSt%le <, para
transparente.

@Filter
Esta propriedade especifica o critrio de procura que ser usado para ajudar o usurio
a encontrar um arquivo. A definio do filtro dividida em trs partes. A primeira parte
o texto que voc deseja exibir na caixa de combinao "List files by Type", seguido
do caractere |, seguido pelo usado para preencher a caixa de texto File Name. Por
exemplo, a declarao CMDialog1.Filter = "Arquivos texto (*.TXT) | *.TXT faz com que
as palavras "Arquivos texto (*.TXT) sejam exibidas na caixa de combinao "List files
by Type" (listar arquivos por tipo) da caixa de dilogo.

@FixedAli!n%ent( )
6epresentaEo: Peso do texto em clulas no-mveis
Se aplica a: Grade
A propriedade A,ixedAli"nent um array cujos elementos individuais se aplicam, por
nmero, s colunas de seu objeto grade antecedente - especificamente a suas clulas
fixas. As definies de cada elemento refletem o eixo contra o qual colocado o
contedo textual das clulas fixas de cada coluna. As definies da propriedade so as
mesmas usadas para AColAli"nent( ).

@Fixed6oBs, @FixedCols
6epresentaEo: Quantidade de clulas no-mveis
Se aplica a: Grade

@FontBold, @FontItalic, @FontStri(e$"ru e @Font4nderline
Estas propriedades contm um valor !rue ou ,alse e especificam se os caracteres
exibidos esto em negrito, em itlico, cortados (uma linha cortando ao meio), ou
sublinhados. Novamente, lembre-se de que essa caixa de dilogo no ativa nem
desativa essas definies; ela siplesmente retorna as preferncias do usurio.

@FontBold, @FontItalic, @FontStri(et"ru, @Font$ransparent e @Font4nderline
6epresentaEo: Estilos de caractere
formulrio, quadro, grade, etiqueta, listagem, figura, impressora, texto
As propriedades A,ontx de um objeto grfico so definidas como valores !rueQ,alse
refletindo o estado da fonte representado por x. Em controles cujo contedo definido
36
por meio de propriedades, a definio das propriedades A,ontx em tempo de execuo
muda imediatamente a aparncia na tela das fontes desses controles. Em controles de
terminal virutal (formulrio, impressora e caixa de figura), a definio dessas
propriedades em tempo de execuo muda a forma como o texto a ser impresso
aparece, embora a aparncia do texto j impresso permanea a mesma.

@FontCount
FontCount
6epresentaEo: Quantidade de estilos de tipos instalados
Se aplica a: Impressora, tela
De5inida por %eio de: Recurso do Windows
A propriedade A,ontCount contm o nmero atual de fontes Printer e Screen instaladas
no Microsoft Windows. Essa propriedade tambm pode ser diferente para cada sistema
de computador.

@Font3a%e e @FontSiIe
Estas propriedades especificam o nome e tamanho da fonte selecionada pelo usurio.

@Fonts( )
6epresentaEo: Estilos de tipo instalados
Se aplica a: Impressora, tela
De5inida por %eio de: Recurso do Windows
A propriedade A,onts se comporta como um array que contm o nome de cada fonte
Printer ou Screen instalada no Microsoft Windows, em qualquer ordem que o sistema
de manuteno de fontes atual do Windows tenha definido para essa lista. Esse array
de propriedades pode ser diferente em cada sistema de computador.

@8ridines
6epresentaEo: Linhas de borda intermedirias
Se aplica a: Grade
A propriedade ADrid>ines de um controle grade definida como um valor verdadeiro ou
falso que denota se as linhas de borda tracejadas devem aparecer entre cada clula da
grade, tanto na rea fixa quanto na rea mvel.

@2ei!"t
6epresentaEo: Limite extremo inferior
Se aplica a: Todos os controles, formulrios, MDI
A propriedade do Visual Basic no so realmente tridimensionais; entretanto, quando o
controle se sobrepe, importante que o interpretador saiba qual controle ir aparecer
na frente dos outros. Seria bom dizer que o interpretador saiba qual controle ir
aparecer na frente dos outros. Seria bom dizer que o interpretador est determinando
qual controle aparecer "no topo", mas no vocabulrio do VB, .Top significa "acima", e
no "na frente de". Nesse caso, portanto, apenas o vocabulrio VB que na realidae
faz referncia direta a um eixo geomtrico; e ele faz isso usando o mtodo AL+rder.

@2ideSelection
6epresentaEo: Continuao de indicao de texto
Se aplica a: Texto
37
A .HideSelection de uma caixa de texto ou de combinao definida como uma valor
!rueQ,alse e especifica se o texto selecionado permanece destacado quando o controle
perde o foco. Por default essa propriedade definida como !rue.

@2i!"i!"t
6epresentaEo: Permisso para colorir clulas indicadas
Se aplica a: Grade
A propriedade A6i"h>i"ht de um controle grade definida como um valor !rueQ,alse,
denotando se a grade destaca automaticamente as clulas indicadas. Por default, essa
propriedade definida como !rue.

@Icon
6epresentaEo: Smbolo de formulrio minimizado
Se aplica a: Formulrio, formulrio MDI
A propriedade A9con de um formulrio definida com o nome de um arquivo de cone
em formato .ICO, que atua como smbolo desse formulrio quando ele est minimizado
(A&indo$State=<). Embora no existam restries quanto localizao do arquivo
.ICO, ele deve estar no mesmo diretrio que os outros arquivos de programa. Se um
caminho de arquivo peculiar salvo junto com o nome de arquivo de cone, e o projeto
instalado no sistema de um cliente depois de ser compilado, esse cliente pode no
ter a mesma estrutura de diretrios, e um erro pode ser gerado.

@I%a!e
6epresentaEo: Contedo grfico
De5inida por %eio de: Execuo do programa
A propriedade A9a"e de um formulrio ou caixa de figura sempre definida com o
contedo grfico desse controle. Essa propriedade definida indiretamente pelo uso de
mtodos para adicionar grficos ao controle.

@Index
Se Aplica a: Todos os controles de um array
6epresentaEo: Identificador do elemento do array
De5inida por %eio de: Ordem de criao, janela Properties
A propriedade A9ndex se refere a elementos de um array de controles, especialmente
porque todos os elementos em um array compartilham a mesma propriedade A#ae.
O controle referido por seu nome de array designado. Seguindo este, o ndice de um
controle em um array declarado como um valor identificador entre parnteses. Os
ndice dos controles de um array so designador em seqncia em tempo de projeto.
Sua seqncia tambm pode ser reorganizada no projeto usando a janela Properties. O
ndice de um controle fixo ao longo do tempo de execuo de um aplicativo.

@InterAal
6epresentaEo: Valor de ativao do timer
Se aplica a: Timer
De5inido por %eio de: Janela Properties, instruo de programa
A propriedade A9nterval de um timer a quantidade de tempo em milissegundos
(milsimos de segundo) que o timer do formulrio conta antes de invocar um evento
7!ier. O valor da propriedade varia de 0 a 65.535 milissegundos, onde 60.000
milissegundos so iguais a um minuto. A propriedade A9nterval costuma ser definida
como 1000 para que os eventos ocorram a cada segundo.
38

@e5t
6epresentaEo: Coordenada do eixo X
De5inida por %eio de: Janela Properties, instruo de programas
A propriedade A>e-t de um formulrio definida com a distncia em twips (1/1440 de
uma polegada lgica) entre o ponto de origem do formulrio e a borda mais
esquerda da tela. O ponto de origem o primeiro ponto enderevel pelo usurio no
canto inferior esquerdo do formulrio; se o formulrio tem bordas, elas aparecem em
volta do ponto original. A propriedade A>e-t de um controle definida como a distncia
em twips entre o ponto de origem do controle e o ponto mais esquerda do
formulrio.

@ist( )
6epresentaEo: Contedo de entrada na lista
Se aplica a: Combinao, listagem
Voc acessa a propriedade A>ist da mesma forma que acessa um array de controles;
voc enderea o contedo de uma entrada na lista em um determinado ndice como
A>ist(indice%). Voc pode ento tratar a propriedade exatamente como voc faria com
um varivel de array. Assim, se voc usar AAdd9te para reservar um contedo na
lista, o contedo de texto da lista em um ndice pode ser atribudo a uma varivel de
string.

@istCount
6epresentaEo: Quantidade de entradas na lista
Se aplica a: Combinao, unidade de disco, arquivo, listagem
De5inida por %eio de: Curso da execuo do programa
A propriedade A>istCount de uma caixa de listagem ou de combinao sempore
definida como o nmero de entradas atualmente contidas dentro dela. O valor de
A>istCount - 1 o nmero de ndice da ltima entrada da lista, porque a primeira
entrada tem um ndice de 0 em vez de 1.

@istIndex
6epresentaEo: Localizao da entrada escolhida
Se aplica a: Combinao, unidade de disco, arquivo, listagem
De5inida por %eio de: Instruo de programa, curso da execuo de programa.
A propriedade A>ist9ndex contm o ndice do item previamente escolhido na lista. Voc
tambm pode usar essa propriedade para fazer com que o usurio escolha um item da
lista. Simplesmente atribua um valor de ndice propriedade com uma equao,
usando a seguinte sintaxe: CaixalistA>ist9ndex = nSTndice%
Se o usurio no escolhe um item, A>ist9ndex definida como K< (no confunda isso
com o valor Booleano para Verdadeiro).

@)ax e @)in
Estas propriedades especificam o intervalo de pginas que pode ser impresso. Por
exemplo, se A(in tem o valor 1 e A(ax tem o valor 6, o usurio s pode imprimir entre
as pginas 1 e 6.

@)ax e @)in
6epresentaEo: Exteno de intervalo de valores
Se aplica a: Barra de rolagem
39
As propriedades A(ax e A(in de uma barra de rolagem so definidas com os valores de
coordenada mximo e mnimo da caixa de rolagem ao logno da barra. Essas
propriedades podem ser definidas com qualquer inteiro entre -32.768 e 32.767,
inclusive, contanto que A(ax permanea maior que A(in. Quando definido, o
comprimento da barra de rolagem dividido em (A(ax - A(in) intervalor. A
movimentao da caixa de rolagem ao longo da barra define sua propriedade AValue co
valor igual ao intervalor onde a caixa se entra atualmente.

@)axButton
6epresentaEo: Incluso de controle de maximizo
A propriedade A(ax:utton definida como um valor !rue ou ,alse, refletindo se o
boto de maximizar da janela aparece no formulrio para esse janela. Por default, a
propriedade A(ax:utton de um novo formulrio definida como verdadeira.

@)DIC"ild
6epresentaEo: Designao de subordinao MDI
A propriedade A(D9Child de um formulrio definida como lgico !rue ou ,alse,
representando se esse formulrio dever ou no ser usado como modelo para
formulrios filho MDI aparecem dentro da rea de trabalho de um pai MDI.

@)inButton
6epresentaEo: Status de exibio do controle de minimizao
A propriedade A(in:utton definida como um valor !rue ou ,alse, refletindo se o
boto de minimizar da janela aparece no formulrio para essa janela. Por default, a
propriedade A(in:utton de um novo formulrio definida como verdadeira.

@)ousePointer
6epresentaEo: Aparncia do apontador
formulrio, quadro, imagem, etiqueta, listagem, opo, figura, tela, rolagem, texto.
A propriedade A(ouseBointer de um objeto grfico definida como um valor inteiro
que representa a aparncia do apontador do mouse sempre que este entra na regio
do objeto. Quando o apontador do mouse sai da regio do objeto, a forma do
apontador volta para seu estado padro ou para o estado designado pela propriedade
A(ouseBointer de seu objeto pai. a propriedade pode ser definida com qualquer dos
seguintes valores:
M Estado padro conforme determinado pelo Windows
< Arrow: a seta padro do Windows
= Cross: uma cruz fina
H I-Bean: o apontador de localizao de texto
I Icon: (no confundir com um cone, a despeito de seu nome) um bullet quadrado
O Size: uma seta de quatro pontas
P Size NE SW: uma seta de duas pontas dirigida para nordeste e sudoeste
7 Size NS: uma seta de duas pontas dirigidas para norte e sul
U Size NW SE: uma seta de duas pontas dirigidas para noroeste e sudeste
R Size WE: uma seta de duas pontas dirigida para leste e oeste
40
<M Up Arrow: seta para cima
<< Wait: o smbolo de ampulheta do Windows
<= No Drop: o smbolo de crculo com uma barra indicando uma violao de
movimento de controle

@)ultiine
6epresentaEo: Capacidade de mltiplas linhas
Se aplica a: Texto
De5inida por %eio de Janel Properties
A definio da propriedade A(ulti>ine reflete se dada permisso ao interpretador
Visual Basic para gerar avanos de linha em um campo de texto quando seu contedo
tiver excedido seu comprimento. Dessa forma, se o contedo textual de um campo de
texto pode ser quebrado em mltiplas linhas usando "word-wrap" se A(ulti>ine estiver
definida como lgico True (ou On).

@)ultiSelect
6epresentaEo: Capacidade de escolha de mltiplas entradas
Se aplica a: Arquivo, listagem
De5inida por %eio de: Janela properties
A propriedade A(ultiSelect de uma caixa de listagem padro ou caixa de listagem de
arquivos definida como um valor que especifica se o usurio pode escolher mais de
uma entrada na lista, e at que ponto o usurio pode fazer mltiplas escolhas. Voc
pode definir a propriedade com qualquer dos seguintes valores:
M S permite que o usurio escolha entradas individuais. A escolha de um segundo
item da mesma lista sobrescreve a primeira escolha e desfaz sua seleo.
< Permite que o usurio selecione mltiplas entradas, uma de cada vez. O usurio
pode escolher qualquer nmero de itens clicando neles (se voc estiver usando o
teclado, pressione a barra de espao); nenhuma escolha sobrescrita.
= Permite que o usurio selcione mltiplas entradas com o teclado. A escolha de uma
nica entrada sobrescreve qualquer escolha existente da mesma lista, a menos que
voc mantenha pressionada a tecla Ctrl. A escolha de uma entrada, e ento a de uma
outra enquanto se mantm pressionada a tecla Shift, seleciona ambas as entradas e
todas as intermedirias.
Os programadores Visual Basic j se acostumaram a usar a propriedade A>ist9ndex
para determinar qual nica entrada da lista o usurio escolheu. Se voc tem mltiplas
entradas escolhidas a partir da caixa de listagem, de que vale A>ist9ndex se ela s diz a
voc a ltima entrada escolhida? O que voc precisa uma instruo que informe em
um valor verdadeiro ou falso se o usurio escolheu uma entrada especfica. Para
conseguir isso, a Microsoft mais uma vez se tornou um tanto liberal em seu escolha de
sintaxe orientada para objeto.

@3a%e
Pertinente a: Todos os controles
6epresentaEo: Ttulo de referncia
De5inida por %eio de: Somente janela Properties
A propriedade A#ae de um objeto grfico, ou uma matriz de objetos relacionados,
definida com um nome arbitrrio quando da estruturao. Essa propriedade se torna o
nome declarado esquerda do ponto quando o objeto grfico endereado dentro do
cdigo-fonte do programa, usando sintaxe orientada para objeto.
Por default, o A#ae de um formulrio leva a sintaxe ,orn, na qual n representa a
ordem na qual o formulrio foi adicionado ao projeto. Quando da estruturao, ao ser
desenhado um controle no formulrio, o interpretador d a ele a sintaxe Controlen,
onde Controle siginifica o tipo de controle e n o nmero de acesso entre controle de
41
tipo similar, representando a ordem na qual esse controle foi adicionado ao formulrio.
Voc pode optar por deixar essas propriedades A#ae como se encontram
inicialmente, ou usar a janela Properties; voc pode optar por modific-los para o que
lhe parecer mais apropriado.

@Pa!e
6epresentaEo: Pgina atual da impressora
Se aplica a: Impressora
De5inida por %eio de: Curso da execuo do programa
A propriedade BrinterABa"e definida com o nmero de pgina atual mantido pelo
interpretador VB para um aplicativo. Cada vez que um aplicativo comea a ser
executado, a propriedade ABa"e definida como 1. O interpretador assume que um
nico documento est sendo criado para este aplicativo a qualquer dado instante. Cada
vez que uma pgina tem sua impresso terminada, a propriedade ABa"e
incrementada.

@PassBordC"ar
6epresentaEo: Caractere de substituio de posio
Se aplica a: Texto
A propriedade ABass$ordChar de uma caixa de texto definida com um nico caractere
alfanumrico que o interpretador do Visual Basic exibe na caixa de texto sempre que
uma tecla pressionada. Isso evita que outros observadores percebam o que o usurio
est digitando. Quando definida com um valor nulo, os caracteres so inseridos na
caixa de texto conforme suas teclas so pressionadas.

@Pat"
6epresentaEo: Caminho de diretrio ativo
Se aplica a: Diretrio, arquivo
De5inida por %eio deJ Instruo de programa, interao com o usurio
A propriedade ABath de uma caixa de listagem de diretrio definida com o texto de
sua nica entrada selecionada. A sintaxe deste texto a seguinte:
driveVW.diretorio.WsubdiretorioA A A 3W3
O contedo textual da propriedade ABath reflete o caminho dos subsdiretrios onde um
arquivo reside ou onde uma procura de arquivo est sendo conduzida. O texto no
contm um nome de arquivo.

@Pattern
6epresentaEo: Padro de procura atual
Se aplica a: Caixa de listagem de arquivos
De5inida por %eio de: Janela Properties, instruo de programa, interao com o
usurio
A propriedade ABattern de uma caixa de listagem de arquivos definida como o padro
de procura atual com o qual cada arquivo dentro do diretrio atualmente ativo
comparado para determinar se esse arquivo deve ou no aparecer na lista. O efeito a
arestrio dos nomes de arquivo aparecendo na caia de listagem de arquivos para um
grupo de seleo. O padro de procura pode conter - e normalmente contm -
caracteres curinga tais como X e Y que representam qualquer nmero de caracteres ou
um nico caractere, respectivamente. Por default, a propriedade .Pattern definida
como *.* (todos os nomes de arquivo).

@Picture
6epresentaEo: Fundo grfico
42
Se aplica a: Formulrio, imagem, figura
A propriedade ABicture definida com o nome de arquivo da imagem que aparece
como funco do objeto caixa de figura antecedente. Esse nome de arquivo pode ter uma
extenso BMP (bitmap do Windows), ICO (cone padro), ou WMF (meta-arquivo do
Windows). A figura alinhada com o canto superior esquerdo da caixa de figura. Se a
imagem mais larga ou mais alta que a caixa de figura, diz-se que a imagem est
pendurada alm das bordas direita e inferior da caixa, respectivamente.

@6oB, @Col
6epresentaEo: Localizao de ponteiro de clula
Se aplica a: Grade
De5inidas por %eio de: Instruo de programa, interao com o usurio
As propriedades A@o$ e ACol de uma grade so definidas com as coordenadas atuais do
ponteiro interno daquela clula da grade que est atualmente recebendo dados. A
coluna mais esquerda em um grade considerada a coluna 0 e a linha mais acima
considerada a linha 0. A clula em (0,0) geralmente uma clula fixa de qualquer
modo; a primeira clula enderavel que aparece no canto superior esquerdo de uma
regio de dados no fixa da grade normalmente (1,1). Por essa razo, as definies
default de A@o$ e ACol so ambas 1.

@6oB2ei!"t( ), @Col'id"t( )
6epresentaEo: Tamanho de clula
Se aplica a: Grade
As propriedades A@o$6ei"ht e ACol&idht de um controle grade so na realidade arrays
cujo comprimento, em elementos, definido automaticamente como as A@o$s (linhas)
e ACols (colunas), respectivamente, da grade atual. Os elementos dessas propriedade
de array so definidos com a altura e largura em twips das clulas de suas respectivas
linhas e colunas. Em tempo de execuo, o usurio pode mudar as definies dessas
propriedades usando o apontador do mouse para fazer os limites entre linhas e colunas
deslizarem para novas posies. Esse deslizamento no dispara eventos para grade.

@6oBs, @Cols
6epresentaEo: Extenso de clulas
Se aplica a: Grade

@Scalee5t, @Scale$op, @Scale'idt" e @Scale2ei!"t
6epresentaEo: Estabelecimento de coordenadas geomtricas variveis
Se aplica a: Formulrio, MDI, figura e impressora
As propriedades AScale>e-t e AScale!op so definidas com o par de coordenadas que
representa o ponto do canto superior esquerdo do objeto antecedente. A propriedade
AScale&idth representa o nmero de divises no eixo x na escala de coordenadas do
objeto antecedente. Da mesma forma, a propriedade AScale6ei"ht representa o
nmero de divises no eixo % na escala de coordenadas do objeto antecedente.

@Scale)ode
6epresentaEo: Escolha do sistema de coordenadas
A propriedade AScale(ode de um objeto grfico terminal virtual definida com um dos
oito valores inteiros que representam o tipo de sistema de coordenadas usado para o
objeto antecedente. Esse valor pode ser um dos seguintes:
43
M Definido pelo usurio. Essa definio entra em vigor automaticamente quando o
programador define a escala do objeto antecedente com um valor varivel.
< Sistema de coordenadas de twips (o default)
= Pontos, aproximadamente 72 pontos por polegada em um monitor com diagonal de
14''
H Sistema de coordenadas de pixels, determinado pelo uso da resoluo de tela atual
do Microsoft Windows
I Sistema baseado em caracteres, representado 12 caracteres por polegada
horizontalmente e seis linhas por polegada, quando impressas em um dispositivo de
impressora padro
O Polegadas, novamente assumindo um monitor com diagonal de 14''
P Milmetros
7 Centmetros

@ScrollBars
6epresentaEo: Permisso para anexao de barram de rolagem
Se aplica a: Caixa de texto, grade, MDI
A propriedade AScroll:ars d ao interpretador Visual Basic permisso para colocar
barras de rolagem nos lados de uma caixa de texto se o seu contedo textual exceder
o nmero de linhas ou colunas que voc tiver definido para ela. A propriedade
definida quando em tempo do projeto como um valor binrio de dois bits. O bit 0
direita (o bit menos significativo) definido como 1 se a barra de rolagem horizontal
da caixa de texto em questo puder ser exibida. Da mesma forma, o bit 1 esquerda
(o bit mais significativo definido como 1 se a barra de rolagem vertical da caixa de
texto puder se exibida. Em decimal, o valor de AScroll:ars pode ser definido com
qualquer dos seguintes valores:
M Nenhuma barra de rolagem(default)
< Barra de rolagem horizontal
= Barra vertical
H Ambas as barras de rolagem

@Selected( )
6epresentaEo: Status de escolha de entrada da lista
Se aplica a: Arquivo, listagem
A propriedade ASelected na realidade uma matriz de propriedades que pertence, por
nmero de ndice, a cada uma das entradas da caixa de listagem antecedente,
comeando pelo nmero de ndice zero. A propriedade definida com um valor
verdadeiro ou falso denotando se o usurio selecionou o nmero de entrada de lista
subscrito. Voc pode definir o valor da propriedade manualmente dentro do cdigo-
fonte usando uma instruo com o seguinte sintaxe: Caixalist.Selected(indice%)
= booleano%

@Selen!"t
6epresentaEo: Nmero de caracteres indicados
Se aplica a: Combinao, texto
A propriedade ASel>en"ht definida com o nmero de caracteres sendo extrados
direita da posio do cursor ASelStart. Essa seleo sempre destacada se a
propriedade A6ideSelect da caixa de texto estiver definida como falsa.

@SelStart
44
6epresentaEo: Posio inicial da indicao de texto
De5inida por %eio de: Instrup de program, interao com o usurio
A propriedade ASelStart definida com um valor que designa onde o cursor aparece no
texto de uma caixa de texto. Essa posio onde a extrao desse corpo de texto
comea. Cada caractere de texto da caixa tem o seu prprio nmero de ndice,
comeando com o caractere 1 no incio do texto. A definio do valor de ASelStart
coloca o cursor direita do caractere indexado; uma definio M o coloca no incio do
texto. A posio do cursor tambm chamada de ponto de insero.

@SelStart6oB, @Sel+nd6oB, @SelStartCol e @Sel+ndCol
6epresentaEo: Cantos de bloco de seleo de clulas
Se aplica a: Grade
As propriedades ASelx de um controle grade so definidas com os nmeros de linha e
coluna de clulas refletindo o incio e fim de um bloco retangular de clulas indicadas.
As propriedades ASelStart@o$ e ASel*nd@o$ so definidas com os nmero de linh
inicial e final do bloco indicado, respectivamente. Da mesma forma, as propriedades
ASelStartCol e .Sel*ndCol so definidas com os nmeros de coluna inicial e final do
bloco indicado, respectivamente. A definio dessas propriedades com valores
diferentes de zero indici manualmente o processo de indicao de clulas. Quando o
usurio clica e mantm pressionado o boto indicador do mouse sobre uma grade,
essas propriedades so definidas no processo.

@Sel$ext
6epresentaEo: Texto indicado
A propriedade ASel!ext definida com o contedo do texto sendo indicado na caixa de
texto. A definio das propriedades ASelStart e ASel>en"ht de uma caixa de texto
define automaticamente a propriedade ASel!ext com os caracteres comeando na
posio ASelStart e se estendendo por ASel>en"ht caracteres. A definio manual da
propriedade ASel!ext substitui o texto indicado pelo contedo da prpria propriedade,
ou insere esse texto na posio atual do cursor caso nenhum texto esteja indicado.

@S"ape
6epresentaEo: Identidade de elemento grfico
Se aplica a: Boto de controle Shape
A propriedade AShape de um elemento grfico desenhado em um formulrio usa o
boto de controle Shape da caixa de ferramentas VB. Esta propriedade definida com
um valor que representa o contorno atualmente aplicado a esse elemento. A
propriedade pode ser definida como qualquer das seguintes opes:
M Retngulo (default)
< Quadrado
= Oval
H Crculo
I Retngulo arredondado
O Quadrado arredondado
A propriedade definida como zero por default. Em todos os casos anteriores, a altura
e a largura assumidas para o controle de forma so determinadas pela posio das
coordenadas dos vrtices do controle dentro do formulrio. A propriedade AShape afeta
somente o aspecto do elemento grfico mostrado por esse controle shape. Nos casos
45
1, 3 e 5 - cada um dos quais envolve contornos de forma cuja largura e altura
aparecem como sendo iguais - o tamanho real do elemento exibido dentro do controle
de forma definido como o menor dos valores de suas propriedades A6ei"ht ou A&idth,
menor alguns pixels como margem. Nos casos 4 e 5, a quantidade de arredondamento
aplicada aos cantos do elemento grfico fixa - usando um termo de diagramao de
figura, eles usam um molde de canto uniforme.

@S%allC"an!e e @ar!eC"an!e
6epresentaEo: Intervalos de alterao de valor
Se aplica a: Barra de rolagem
A definio da propriedade ASallChan"e de uma barra de rolagem representa o grau
de incremento ou decremento em seu valor representado quando um dos botes de
sera clicado. Quando o usurio clica no boto de seta, a caixa de rolagem da barra
movida, em relao a seu sistema de coordenadas atual de representao, em direo
seta. Similarmente, a definio da propriedade A>ar"eChan"e representa o grau de
incremento ou decremento no valor representado da barra de rolagem quando o
usurio clica entre a caixa de rolagem e um dos botes de seta na direo da seta.
Essa zona de barra de rolagem costuma ser chamada de rea de paginao.

@Sorted
6epresentaEo: Status de ordenao da lista
Se aplica a: Combinao, listagem
A propriedade ASorted de uma caixa de listagem ou de combinao definida como um
valor verdadeiro ou falso que denota se as entradas contidas na lista devero parecer
classicadas em ordem ascendente alfanumrica. Quando ASorted definida como
verdadeira, a classificao no continua no decorrer do programa. Portanto, se um
mtodo AAdd9te invocado para incluir um nmero de ndice especfico, o tiem
aparece na lista naqula posio, embora isso possa resultar em uma lista no
classificada. A adio de entradas na lista ou a remoo de entradas da lista no afeta
o valor da propriedade ASorted.

@Stretc"
6epresentaEo: Permisso para redimensionar automaticamente o contedo
Se aplica a: Imagem
A propriedade AStretch de uma caixa de imagem definida como um valor !rueQ,alse
denotando se ao interpretador dada a permisso de esticar (ou encolher) o contedo
grfico de uma caixa de imagem para acomodar os limites existentes desse controle.

@St&le
6epresentaEo: Incluso de caixa de texto
Se aplica a: Combinao listagem
De5inida por %eio de : Caixa de ferramentas, janela properties
A propriedade ASt%le definida como um inteiro que denota a aprncia de uma lista no
formulrio. Suas definies possveis so as seguintes:
Drop-down combo. Essa definio permite que o usurio insira um valor usando tanto
o teclado como uma lista pull-down. Simple combo. Essa definio tambm permite
que o usurio insira um valor usando tanto o teclado quanto uma lista pull-down, mas
neste caso a lista pull-down sempre exibida automaticamente. Drop-down list. Essa
definio no inclui uma rea de edio, o usurio s pode selecionar opes na lista
pull-down.
46

@$abIndex
6epresentaEo: Ordenao de entrada de texto
Se aplica a: Todos os controles
A propriedade A!ab9ndex de um controle definida como sua ordem numrica na
seqncia de tabulao dentro de seu formulrio associado. Por default, a seqncia
de tabulao dentro de seu formulrio associado. Por default, a seqncia de tabulao
dos controles em um formulrio estabelecida por sua ordem de criao quando da
estruturao; essa seqncia pode ser reorganizada na estruturao ou em tempo de
execuo. Por default, as etiquetas tm suas propriedades A!ab9ndex atribudas,
embora elas no sejam oficialmente parte da seqncia de tabulao de um
formulrio.

@$abStop
6epresentaEo: Particio na seqncia de teclado
Se aplica a: Todos os controles
De5inida por %eio de: Janea Properties, instruo de programa
A definida propriedade A!abStop de um controle um indicador !rueQ,alse refletindo
se ele est participando da seqncia de tabulao. Uma definio ,alse significa que o
usurio no pode indicar o controle pressionando Tab. Por default, A!abStop definida
como !rue. Um controle pode ser uma parada de tabulao como uma banco de praa
pode ser um ponto de nibus. Para designar que a rota dos Tabs no pare em um
determinado controle - de certa forma, para tirar o banco doponto de nibus - defina
seu valor como ,alse.

@ $a!
Se Aplica a: Todos os controles padro
6epresentaEo: Nome alternativo de ttulo do controle
A propriedade A!a" de um objeto grfico definida com um nome arbitrrio, para um
propsito que o programador pode definir. Na maioria das operaes, essa propriedade
completamente ignorada pelo interpretador VB. Em situaes onde uma procedure
pesquisa o contedo de um controle no denominado, porm, a procedure pode usar
A!a" como um identificador para o controle se voc atribuiu um ttulo nico a ele. O
interpretador VB no verifica as definies da propriedade A!a" para garantir sua
exclusividade, como faz com as definies A#ae. Por default, o A!a" de um objeto
grfico uma string nula.

@$ext
6epresentaEo: Contedo textual editvel
Se aplica a: Campo de texto, combinao
usurio
A propriedade A!ext de um controle definida com seu contedo textual. Voc pode
mudar esse contedo em tempo de execuo atravs de interao direta com o
controle. Com respeito especificamente a caixas de combinao, a propriedade A!ext
definida com o item atualemente escolhido na lista, parecendo em susa caixa de texto,
na parte superior. O comprimento mximo em caracteres da definio de uma
propriedade A!ext 2.048 caracteres.

@$op
6epresentaEo: Coordenada do eixo Y
47
Se aplica a: Todos os controles, formulrios e MDI
De5inida por %eio de: Jnaela Properties, instruo de programa
A propriedade A!op de um formulrio definida como a distncia em twips entre o
ponto de origem do formulrio e a borda superior da tela. A propriedade A!op de um
controle definida como a distncia em twips entre o ponto de origem do controle e
ponto mais acima do formulrio.

@$op6oB, @e5tCol
6epresentaEo: Primeira clula de dados visvel
Se aplica a: Grade
As propriedades A!op@o$ e A>e-tCol de uma grade podem ser definidas em uma
procedure como as coordenadas da clula visvel mais acima e mais esquerda,
respectivamente, na grade. Essas propriedades no afetam o posicionamento de clula
fixa na grade, nem afetam a posio dos ponteiros de clulas atuais A@o$ e ACol.

@$BipsPerPixelH e @$BipsPerPixel*
6epresentaEo: Fator de converso de escalas coordenadas
Se aplica a: Tela, impressora
De5inidas por %eio de: Recurso do Windows
As propriedades A!$ipsBerBixelG e A!$ipsBerBixel) dos objetos Screen e Printer so
definidas pelo Windows com o nmero inteiro aproximado de twips por pixel plotado.

@Value
6epresentaEo: Status dentro de um intervalo
Se aplica a: Caixa de verificao, boto, pronto de opo, barra de rolagem
usurio.
A propriedade AValue, para um boto de opo, definida tanto como ligado ou
desligado. Essa definio especifica se o usurio escolheu a opo. Para uma caixa de
verificao, AValue definida como 0, 1 ou 2. Essa definio especfica se a caixa est
vazia, marcada, ou escurecida (tornada indisponvel), respectivamente. Para um boto
de comando, AValue definida como !rue ou ,alse, dependendo de o usurio ter
simplesmente clicado no boto.

@Visible
6epresentaEo: Status de exibio de controle
Se aplica a: Todos os controles, menus, formulrios
De5inida por %eio de: Janela Properties, Janela Menu Design, instruo de programa
A propriedade AVisible de um controle definida como um valor !rue ou ,alse que
designa se o controle pode ser visto. Um controle invisvel no responde. Por default,
essa propriedade definida como !rue. Para fazer esse controle desaparecer ou para
eliminar temporariamente uma seleo de um menu, voc pode definir essa
propriedade como ,alse. Definir a propriedade AVisible de um formulrio como ,alse
virtualmente o mesmo que chamar o mtodo A6ide para esse formulrio.

@'idt"
6epresentaEo: Limite extremo direito
A propriedade A&idth de m objeto definida como a distncia em twips entre os dois
lados verticais desse objeto. Com efeito, essa definio estabelece a coordenada do
eixo y do ponto no canto inferior direito do objeto.
48

@'indoBist
6epresentaEo: Status de listagem filha MDI
Se aplica a: Menus
De5inida por %eio de: Janela Menu Design
A propriedade A&indo$>ist para uma categoria de menu de um formulrio pai MDI
definida como um valor onQo-- que indica se o painel de menu da categoria ir exibir
uma lista de todas as janelas filhas MDI que esto atualmente abertas. Cada janela
filha listada pelo nome em sua barra de ttulo. A listagem da janela filha que possui
atualmente o foco marcada automaticamente em tempo de execuo.

@'indoBState
6epresentaEo: Status operativo de janela
Se aplica a: Formulrio
A definio atual da propriedade A&indo$State um inteiro que representa o estado
de operao do formulrio antecedente como uma das seguintes condies.
M Emoldurado ou com borda
< Minimizado; reduzido para um cone representativo
= Maximizado; sem borda, e passvel de preencher a tela inteira.

@H-, @*-, @H., @*.
6epresentaEo: Coordenadas geomtricas
Se aplica% a: Objetos Line
De5inidas por %eio de: Projeto do controle, janela Properties, instruo de programa
As propriedades AG<, A)<, AG= e A)= de um objeto line representam as coordenadas
geomtricas dos vtices dessa linha, com respeito ao sistema de escala atualmente em
uso nesse formulrio. As referncias de coordenadas seguem o sistema cartesiano de
vrtices (x1, y1) - (x2, y2) ao longo de um plano bidimensional.

Alin"a%ento
6epresentaEo: Peso do texto contido
Se aplica a: Verificao, etiqueta, opo, texto
A propriedade AAli"nent de uma etiqueta ou caixa de texto definida com um inteiro
que descreve como o texto desse controle alinhado. A propriedade pode ser definida
com qualquer um dos valores seguintes:
M Justificao esquerda (default)
< Justificao direita
= Centrado
Para um controle caixa de verificao ou ponto de opo, a propriedade AAli"nent
reflete o lado do controle que o boto ocupa. Quando definida como M, o boto aparece
no lado extremo esquerdo do controle com a etiqueta de texto imediatamente sua
direita; quando definida como <, o boto aparece no extremo direito com o texto sua
esquerda.

AutoSiIe
6epresentaEo: Permisso para economia de espao
Se aplica a: Etiqueta, figura
Propriedade AAutoSi5e de uma figura ou etiqueta definida como um valor !rue Q
,alse. Esse valor reflete se dada permisso para que o limite inferior do controle no
formulrio seja reduzido para se ajudar ao contedo atribudo a esse controle.
49

Colu%ns
6epresentaEo: Incluso de coluna na lista
Se aplica a: Listagem
A propriedade AColuns de uma caixa de listagem especifica o nmero de colunas que
uma caixa de listagem pode conter, menos um. A definio default da propriedade
AColuns 0, denotando, de fato, uma definio "false" para mltiplas colunas. Com a
definio default, se a altura combinada das entradas na lista exceder a alura da caixa
de listagem, o interpretador Visual Basic exivbir uma barra de rolagem vertical do
lado direito da caixa de listragem. A barra de rolagem permite que o usurio navegue
para cima e para baixo na lista. Com AColuns definida como diferente de zero,
quando a altura total das entradas excede a da lista, o interpretador corta a lista logo
acima da entrada que cai abaixo da borda inferior da caixa de listagem; o
interpretador continua a lista comeando por essa entrada, na prxima coluna
direita. Uma barra de rolagem horizontal exibida sempre que a largura total das
colunas mltiplas excede a da caixa de listagem.

Font3a%e
6epresentaEo: Atributo de estilo de caractere
formulrio, quadro, grade, etiqueta, listagem, opo, figura, impressora, texto
A propriedade A,ont#ae de um objeto grfico definida com o texto preciso de um
nome da lista de fontes atualmente mantida pelo Microsoft Windows. Quando essa
propriedade definida, a fonte usada para impresso ou atribuio de texto a um
formulrio, objeto grfico ou impressora referida pelo nome.

FontSiIe
6epresentaEo: Atributo de tamanho de caractere
formulrio, quadro, grade, etiqueta, listagem, opo, figura, impressora, texto
A propriedade A,ontSi5e de um objeto grfico definida como o tamanho aproximado
em pontos disponvel para um fonte que tenha seu A,ont#ae atual suportado pelo
Windows e que seja no momento a A,ont#ae escolhida para a impresso e atribuio
de texto.

'ord'rap
6epresentaEo: Permisso para criao de espao auxiliar
Se aplica a: Etiqueta
A propriedade A&ord&rap de uma etiqueta definida como um valor !rueQ,alse. Esse
valor reflete se dada permisso para que o limite inferior do controle seja expandido
para se ajustar ao contedo atribudo propriedade ACaption da etiqueta.

50
Instrues do Visual Basic

Beep
Propsito: Ativao de som interno.
Sintaxe: :eep
A instruo :eep faz soar um rudo do tipo bip. Essa instruo no leva parmetros.

Call
Propsito: Desvio entre procedures
Sintaxe -: Call noe7da7procedure ( .ar"uento<, ar"uento=, A A A 3 )
Sintaxe .: noe7da7procedure .ar"uento<, ar"uento= A A A 3
Quando a instruo Call processada, ou quando o nome de uma procedure definido
invocado no cdigo fonte, feito um desvio para a procedure Sub assim chamada.
Quaisquer valores a serem passados para a procedure como argumentos so listados
ao lado de noe7da7procedure na ordem na qual eles devem ser recebidos pela
instruo de abertura da procedure Sub. Se so passados valores para a procedure
Sub, as variveis correspondentes listadas na instruo de abertura da procedure Sub,
as variveis correspondentes listadas na instruo de abertura da procedure recebem
seus valores. Quaisquer modificaes feitas nos valores ou contedo dessas variveis
ao longo do curso da procedure sero refletidas nas variveis correspondetes da
chamada da procedure, a menos que especificado em contrrio com ByVal.

Close
Propsito: Terminao de ponteiro de dados
Sintaxe: Close .#3canal<%., canal=%, A A A canaln%3
A instruo Close termina o acesso aos arquivos de dados com nomes que foram
atribudos pela instruo +pen aos nmeros de canal% listados. Quaisquer instrues
de leitura ou escrita aps Close pertinentes aos nmeros de canal declarados
imediatamente antes, dentro de Close geram erros. O acesso a arquivos usando esses
nmeros s pode ser redeclarado pelo uso de uma instruo +pen. Close cancela
qualquer associao entre os nmeros declarados e os nomes de arquivos atribudos a
eles pela instruo +pen, portanto voc pode usar novamente os nmeros para outros
nomes de arquivo. Os sinais # so opcionais antes de cada nmero de canal. Se
nenhum nmero de canal for especificado, todos os canais abertos sero fechados.

Const
Propsito: Declarao de constantes
Sintaxe: ."lobal3 Const noe = expressao ., noe = expressao A A A 3
A instruo Const usada para declarar o termo para representar um valor fixo (no
varivel) para uso em expresses, O escopo de uma constante determinado pela
posio de sua declarao no cdigo-gfonte. Uma constante declarada dentro de uma
procedure Sub ou function ter escopo local. Uma constante declarada dentro de da
rea geral de um mdulo tem escopo modular. Uma constante declarada dentro de um
mdulo geral pelo uso do termo global tem escopo global.

De5Cur, De5Dbl, De5Int, De5n!, De5Sn!, De5Str e De5Var
Propsito: Restrio de variveis alfabticas
Sintaxe:
De-Cur intervalo., intervalo., intervaloA A A 3 3
De-Dbl intervalo., intervalo., intervaloA A A 3 3
De-9nt intervalo., intervalo., intervaloA A A 3 3
De->n" intervalo., intervalo., intervaloA A A 3 3
De-Sn" intervalo., intervalo., intervaloA A A 3 3
51
De-Str intervalo., intervalo., intervaloA A A 3 3
De-Var intervalo., intervalo., intervaloA A A 3 3
Cur Moeda
Dbl Ponto flutuante de preciso dupla
9nt Inteiro padro
>n" Inteiro longo
Sn" Ponto flutuante de preciso simples
Str String alfanumrica
Var Variant

Di%
Propsito: Declarao de varivel
Sintaxe - (si%ples): Di variJvel (.inteiro3)
Sintaxe . (co%plexa): Di variavel ( .inteiro3 ) ., variavel= ( . inteiro3 ) A A A
variavelPM ( . inteiro 3 ) 3 . As . #e$ 3 tipo3
Sintaxe 1 (co%plexa): Di variavel<.(inteiro .to inteiro3 ., inteiro .to inteiro33)3 .As
.#e$3 tipo3 ., variavel= . ( .inteiro.!o inteiro3 ., inteiro .!o inteiro3 3 ) 3 .As .#e$3
tipo3 , A A A variavelPM . ( .inteiro.!o inteiro3 .,inteiro .!o inteiro3 3 ) 3 .As .#e$3 tipo3 3
A declarao Di determina pelo menos uma varivel array como sendo uma lista ou
tabela de valores ou string que so endereveis por nmero. Esse nmero um
inteiro, e usado como um endereo para representar o lugar de um fragmento de
dados na lista. Esse nmero indicador normalmente chamado de ndice. Um array
unidimensional, vetor ou lista, geralmente declarada pelo uso de um inteiro (ou
expresso inteira) entre os parnteses. Esse inteiro representa o ndice mais alto na
lista. Opcionalmente, um array unidimensional pode ser declarada pelo uso de dois
inteiros, que representam, respectivamente, o menor e o maior ndice da lista, e que
so separados pelo termo !o.
Uma matriz bidimensional, ou tabela, declarada pelo uso de dois inteiros entre cada
par de parnteses, separados por uma vrgula. Esses inteiros representam as
diferenas, ou eixos da tabela, como nos eixos x e y de um grfico. Ambos os inteiro
representam os ndices mais altos ao longo de seus respectivos eixos, a menos que o
termo !o seja usado para distinguir o mais baixo e o mais alto dices ao longo de um
ou ambos os eixos. Uma matriz tridimensional, ou tabela de trs eixos, declarada da
mesma forma usando trs conjuntos de inteiros separados por vrgulas.
A menos que especificado em contrrio, uma varivel no tendo smbolo de tipo ou
qualificador tipo formal ao lado do termo As dimensionada como uma variant, ou tipo
desconhecido. Uma vez que um valor ou contedo seja atribudo a essa varivel, o
interpretador determina um tipo no oficial para a varivel, embora seu tipo oficial
ainda seja uma Variant. Voc pode estabelecer um tipo oficial formal para cada
varivel na lista de dimenses seja pela anexao de um smbolo de tipo varivel ou
pela declarao do tipo como um termo opcional seguinte ao termo As.
A colocao da declarao Di se restringe seo de declaraes gerais de um
mdulo, ou para uma procedure. O escopo das declaraes de variveis pelo uso de
Di pode ser modular se feitas na seo de declaraes gerais, ou local se feitas
dentro de uma procedure. Voc pode declarar at 60 variveis usando uma nica
declarao Di.

Do+Aents
Propsito: Mudana de prioridade os eventos
Sintaxe: .-orulJrio%3 = Do*vents. ( ) 3
A intruo Do*vents suspende a execuo da procedure atual. Isso permite que o
interpretador VB passe o controle para quaisquer procedures de evento que tenham
sido disparadas pelo usurio, e que estavam esperando para serem executadas na fila
52
de eventos. A instruo permite ento que o Windows atualize todos os objetos
grficos e passe o controle para outros aplicativos na rea de trabalho do Windows
para quaisquer tarefas para as quais eles estivessem esperando no background.
Do*vents direciona a procedure atual para abrir caminho para qualquer outra coisa
que pea permisso de execuo.
Quando usado em uma frase como uma funo, Do*vents retorna na varivel
-orularios% um valor inteiro equivalente ao nmero de formulrios atualmente
carregados na rea de trabalho do aplicativo Visual Basic.
Voc acabou de ler sobre o processo de execuo geral de aplicativo Visual Basic.
Como esse processo j est definido para voc pelo interpretador do Visual Basic, voc
achar mais fcil estruturar um projeto com mltiplos mdulos e procedures. A
princpio, porm, a curva de aprendizado para organizao de mdulos e procedures
em um projeto VB pode ser melhor descrita como uma inclinao ngreme.

Do K'"ile L 4ntilM@@@oop K'"ile L 4ntil
Propsito: Demarcao de loop condicional/incondicional
Sintaxe -:
Do ./&hile 1 ?ntil2 expressao3
bloco de instrucoes<
.*xit Do3
.bloco de instrucoes=3
A A A
>oop
Sintaxe .:
Do
.*xit Do3
A A A
>oop ./&hile 1 ?ntil2 expressao3
A clusula DoK>oop executa repetidamente o conjunto de instrues nela contido. A
execuo desse conjunto pode ou no depender de uma expresso condicional
opcional. Se uma condio expressa, a execuo do conjunto pode ser terminada. Se
uma condio no expressa, o loop considerado infinito e s pode ser terminado
com uma instruo *xit Do.
Na Sintaxe 1, uma expresso condicional feita no incio da clusula, seguindo Do. Se
essa expresso est precedida de &hile, a execuo das instrues na clusula ocorre
em seqncia, contanto que a expresso seja avaliada como !rue. Se a expresso est
preceduida por Until, a execuo ocorre em seqncia contanto que a expresso eja
avaliada como False - em outras palavras, quando a expresso !rue, a clusula
terminada. Se a expresso &hile ,alse ou a expresso Until True, a execuo pula
para a instruo seguinte a >oop. Se esta a primeira iterao do loop e a execuo
pula para >oop, as instrues da clusula nunca sero executadas.
Sob a sintaxe 2, uma expresso condicional feita no final da clusula, em seguida
>oop. As regras que governam o uso de &hile e ?ntil so as mesmas que na sintaxe 1.
Na sintaxe 2, a execuo das instrues dentro da clusula ocorre incondicionalmente
aps a instruo Do. A expresso avaliada quando se chega a >oop; se o loop tiver
que prosseguir, a execuo pular para a instruo seguinte a Do. Caso contrrio, o
loop ser terminado e a execuo prosseguir normalmente.

+nd
Propsito: Terminao de contexto
Sintaxe: *nd . /,unction 1 9- 1 Seledct 1 Sub 1 !%pe23
53
Quando chamada em uma linha prpria, a instruo *nd termina o programa atual,
redefine todas as variveis declaradas, e fecha todos os canais abertos para caminhos
de dados, arquivos de dados ou outros aplicativos Windows. No h limite para o
nmero de declaraes *nd no qualificadas que podem ser chamadas durante um
aplicativo. Quando usuada com um outro termo, a declarao especifica a poro de
fechamento de uma clusula ou procedure. S pode haver uma instruo *nd por
clusula ou procedure.

+rase
Propsito: Atualizao de arrays
Sintaxe: erase arra% ., arra%A A A 3
A instruo *rase limpa os valores e contedo de todos os arrays especificados na
declarao. Os parnteses no so usados na especificao. O comprimento de cada
array apagado, previamente declarada com Di, no afetado. O estado de todos os
arrays apagados tal como o imediatamente seguinte execuo da declarao Di
que originalmente as dimensionou.

+rror
Propsito: Simulao de erro
Sintaxe: *rror coderro%
Nessa sintaxe, coderro% um valor inteiro que corresponde a um cdigo de erro
vlido. Voc pode usar a varivel *rr interna como coderro%.
A instruo *rror fora o interpretador Visual Basic a atuar como se o erro especificado
por coderro% tivesse ocorrido. Essa instruo particularmente til para se testar a
aplicabilidade de rotinas de interceptao de erros.

+xit
Propsito: Aborto forado de contexto
Sintaxe: *xit /Do 1 ,or 1 ,unction 1 Sub2
A instruo *xit pra imediatamente a procedure ou clusula de loop atual. Em
clusulas de loop, a execuo do programa retomada na instruo seguinte
instruo de fechamento da clusula. Em procedures Sub ou ,unction, a execuo
retomada na instruo seguinte que fez a chamada a procedure. Se a procedure no
foi chamada por uma outra instruo, a execuo suspensa at a ocorrncia de um
evento reconhecido de usurio.

For93ext
Propsito: Demarcao de um loop reiterativo
Sintaxe: ,or contador = valorini !o valor-i .Step valorad3
.*xit ,or3
A A A
#ext .contador3
A clusula ,orK#ext demarca um conjunto de instrues para ser executado repetidas
vezes. A princpio, a varivel contador recebe um valor inicial especificado por valorini.
A execuo da clusula procede ento em seqncia e pode ser terminada ao se
chegar instruo *xit ,or.
Em #ext contador, um valor, geralmente 1, adicionado varivel contador. O valor
1 a menos que especificado como valorad ao lado do termo opcional Step. Se o valor
aumentado de contador for menor ou igual ao valor-i especificado no topo da
clusula, a execuo pula para a instruo imediatamente seguinte linha ,or. Se
contador for maior que valor-i, o loop terminado e a execuo pssa para a
54
instruo abaixo de #ext contador. Se nenhuma clusula ,orK#ext existir nessa
clusula ,orK#ext maior, a especificao de contador depois do termo #ext opcional.

Function
Propsito: Inciao de procedure que retorna valor
Sintaxe:
.Static3 .Brivate3 ,unction noe7da7procedure (.:%Val3 ar"uento< .( )3 .As tipo3,
.:%Val3 ar"uento=.( )3 .As tipo3A A A3)
bloco7de7instrucoes<
noe7do7procedure = expressao<
.*xit -unction3
.bloco7de7instrucoes=3
.noe7do7procedure = expressao=3
A A A
*nd ,unction
A instruo ,unction atua como cabealho para procedures que recebem argumentos
da mesma maneira que uma procedure Sub, mas que retornam um nico valor ou
string. A instruo ,unction parece ter precisamente a mesma sintaxe que a instruo
Sub. Uma diferena importante entre as sintaxes das procedures ,unction e Sub que
o noe7da7procedure de uma priocedure ,unction tratado como uma varivel na
procedure. Perto do final da procedure ,unction, uma expresso de interpretao
vlida atribuda a esse noe7da7procedure com uma equao. O valor dessa
expresso a soluo ou o resultado da funo como ela foi declarada.
A sintaxe dos argumentos expressos dentro da instruo ,unction a mesma que a
sintaxe dos argumentos dentro da instruo Sub. Normalmente, os valores dessas
variveis que tm escopo local a procedure - ou que no tenham sido declaradas como
modulares ou globais fora da procedure - so tornadas nulas sempre ao sair da
procedure. O uso do termo Statis antes do termo ,unction muda o contexto da
procedure de local padro para esttico, permitindo que o interpretador mantenha os
valores e contedo das variveis usadas pela procedure depois de sair dele. O uso do
termo Brivate antes do termo ,unction - se essa procedure ,unction aparecer dentro
de um mdulo geral - muda o contexto da procedure de global para nvel de mdulo,
de modo que nenhum outro mdulo pode fazeruma chamada a esta procedure. As
procedure de funes declaradas na seo geral de mdulos de formulrio recebem
automaticamente contexto de nvel de mdulo, e no requerem o qualificador Private.

8et N
Propsito: Recuperao d dados de um dispositivo
Sintaxe: "et # canal%, .posicao;3, varivael
A instruo Det # l o contedo da variavel especificada a partir de um arquivo de
dados de acesso aleatrio, aberto previamente com a instruo +penA A A As @ando
ou +penA A A As binar%, e cujo nmero de canal% tenha sido designado por essa
instruo +pen. Voc no pode substituir o termo variavel por uma expresso ou um
valor. Na instncia da instruo Det #, voc s poe declarar explicitamente uma nica
varivel, e no uma lista de varivel.
Quando voc estiver usando a tcnica de acesso aleatrio, se posicao; for
especificada, o contedo de variavel assumido como devendo ser lido da posio de
elemento numerada como posicao; contando a partir do incio do arquivo. Se a
posicao; for omitida e uma vrgula guardar o espao vazio onde ela teria aparecido, a
leitura ocorrer na posio sendo atualmente apontada pelo ponteiro do arquivo.
Depois de feita a leitura de um arquivo de acesso aleatrio ou binrio, o ponteiro do
arquivo registrar a posio imediatamente seguinte leitura anterior. Se uma
instruo Det # l de alguma posicao; no meio de uma arquivo j existente, portanto,
55
depois da leitura o apontador ser incrementado para a prxima posio no meio
desse arquivo.
Se o valor de posicao; estiver aklm da posio onde quaisquer dados tenham sido
escritos no arquivo, qualquer valor lido a patir dessa posio no-existente ser zero, e
qualquer string lida a partir dessa posio ser nula. Contudo, vlido especificar uma
posicao; de armazenamento que seja muito que o nmero de elementos do arquivo.
Quando voc est usando a tcnica de acesso binrio para carregar um valor na
memria, a instruo Det # l exatamente tantos bytes do arquivo de acesso binrio
quantos so usados para representar o valor da variavel especificada quando ele
carregado na memria. Quando voc est carregando uma string alfanumrica e
atribuindo seu contedo a uma varivel de string na memria usando acesso binrio, o
nmero de caracteres carregados na memria exatamente o nmero de caracteres
atualmente pertencentes a essa varivel de string. Em outras palavras, se o contedo
da varivel de string ainda no foi atribudo e seu contedo oficial nulo (strin"$ = 0
0), uma instruo Det # no carrega quaisquer caracteres na varivel de string
especificada.
Se a posicao; no for especificada, aleitura ocorrer no prximo endereo ede byte na
seqncia.

8lobal
Propsito: Declarao de varivel Global
Sintaxe: Dlobal variavel< .inteiro .!o inteiro3 ., inteiro .!o inteiro3 3 ) 3 .As .#e$3
tipo3, variavel= . (inteiro .!o inteiro3 ., inteiro .!o inteiro3 3 ) 3 .As .#e$3 tipo3, A A A
variavelPM . (inteiro.!o inteiro3 ., inteiro .!o inteiro3 3 ) 3 .As tipo3 3
A declarao Dlobal usada para declarar todas as variveis unitrias e array cujos
valores devam se aplicar ao cdigo-fonte inteiro do programa. O escopo de todas as
variveis declaradas pelo uso de Dlobal considerado "lobal. Exceto pelo prprio
termo, a sintaxe de Global a mesma que a sintaxe da declarao Di. Dlobal s
pode ser usada dentro de um mdulo geral (que no de formulrio), e especialmente
dentro de um que o programador tenha designado como mdulo global.

8oSub
Propsito: Desvio temporrio
Sintaxe: DoSub rotulo
Quando a instruo DoSub executada, o interpretador desvia para a instruo
imediatamente seguinte ao rtulo especificado. Enquanto a instruo prossegue em
seqncia, o interpretador mantm registro da localizao da instruo que efetuou o
desvio. Quando o interpretador executa a prxima instruo @eturn, ele desvia de
volta para a instruo imediatamente seguinte chamada DoSub.

8o$o
Propsito: Desvio entre procedimentos
Sintaxe: Do!o rotulo
Quando executada, a instruo Do!o faz com que o interpretador suspenda a
execuo na linha de instruo atual, e a retome na instruo do mesmo procedimento
imediatamente aps o rotulo especificado. O rtulo de instruo precisa aparecer em
uma linha prpria e precisa estar seguido de dois pontos.

I5@@@ $"en@@@ K+lseI5@@@ $"enMK+lse@@@ M@@@ +nd I5
Propsito: Clusula condicional
Sintaxe -:
9- expressao< then
56
.*lse9- expressao= !hen
bloco de instrucoes=
.*lse
bloco de instrucoes3
*nd 9-
A declarao 9-K!hen testa uma expresso matemtica para ver se ela verdadeira. Se
for, a execuo continua com a primeira instruo dependente depois da expresso. Se
a expresso no for verdadeira, a execuo pula para a primeira instruo fora do
ninho. Se essa instruo for *lse, as instrues dependentes seguintes so executadas.
Se essa instruo for *lse9-, uma outra expresso matemtica avaliada da mesma
maneira que a primeira. A clusula termina quando se chega a *nd 9-.
A seguir temos uma sintaxe mais resumida para a mesma declarao:
If expressao Then instrucao1 [Else instrucao2]
Esta sintaxe usada para clusulas de uma nica instruo e pode ser escrita em uma
linha. Observe que no se inclui *nd 9- nessa sintaxe.
9-K!hen a declarao de condio fundamental da linguagem de programao BASIC.
A declarao pode ser descrita como um mecanismo cujo gatilho uma expresso
matemtica. O resultado dessa expresso um valor lgico Booleano em algum lugar
da memria, que pode ser interpretado como !rue ou ,alse (-1 ou 0). Se a expresso
verdadeira, o primeiro conjunto de instrues na clusula executado em seqncia.
Se houver um outro conjunto de instrues na clusula 9-K!hen seguindo o termo *lse
ou *lse9-, ele ser executado em seqncia se a expresso original ao lado do termo 9-
for falsa.

Input N
Propsito: Aquisio de dados do dispositivo
Sintaxe: 9nput #canal%, variavel<., variavel=, A A A variaveln3
A instruo 9nput # l dados de um arquivo de dados textual cujo nmero canal%
tenha sido aberto previamente como Input pela instruo +pen e cujo nome de
arquivo tenha sido especificado previamente dentro da instruo +pen. O sinal #
necessrio para distinguir a instruo 9nput # da antiga instruo Input do BASIC,
embora essa declaro em particular no seja mais suportada pelo Visual Basic. Cada
elemento textual do arquivo atribudo s variveis da lista da instruo 9nput #, em
seqncia. Se a varivel qual est sendo atribudo um dado do arquivo for uma
varivel numrica, o interpretador tentar converter automaticamente em um valor
numrico a string de texto associada a essa varivel antes de atribuir a ela o valor.

ine Input N
Propsito: Transmisso de texto formatado de um dispositvo
Sintaxe: >ine 9nput #canal%, strin"$
A instruo >ine 9nput # l uma linha de texto de um arquivo de acesso seqncia e a
armazena na memria dentro da varivel strin"$. Uma linha de texto, nessa situao,
definida como o fluxo contnuo de caracteres que termina com um retorno de carro.
Esse caractere considerado o caractere de fim de linha. Se nenhuma quebra desse
tipo ocorrer no arquivo, ou se &idth # no tiver sido usada para especificar a largura
de linha do arquivo de dados seqnciais, voc pode usar >ine 9nput # para atribuir
todo o contedo de texto do arquivo de dados varivel de string strin"$.

oad
Propsito: Colocao de um bojeto na rea de trabalho
Sintaxe: >oad noeobEeto
A instruo >oad enredea por nome um objeto grfico pertencente ao aplicativo
atualmente em execuo, carrega-o na memria e na rea de trabalho sem exibi-lo e o
57
mantm suspenso at que seja executada uma instruo que force o objeto a ser
mostrado. Se o objeto for um formulrio, essa instruo dispara o procedimento de
evento Sub ,or7>oad ( ) do formulrio.

Set e 6Set
Propsito: Justificao de contedo
Sintaxe:
>Set capo$ = entrada$
@Set capo$ = entrada$
As intrues >Set e @Set atribuem o contedo textual j atribudo a entrada$ a uma
string cheia de espaos : capo$. O coprimento de capo$ no modificado; em vez
disso, os espaos dentro de capo$ so substitudos pelo contedo de entrada$. A
instruo >Set dentro de campo, comeando no caractere mais esquerda de campo,
criando assim um campo justificado esquerda. Da mesma forma, a declarao @Set
insere entrada$ dentro de capo$ comeando pelo caractere mais direita de
capo$, criando um campo justificado direita. Se entrada$ contiver mais caracteres
que capo$, somente os caracteres mais esquerda de entrada$ aparecero em
capo$ para ambas as instrues. O comprimento de capo$ permanece o mesmo.

)id#
Propsito: Insero de um fragmento de string
Sintaxe: (id$ (strin"$, posVinic;., nuero;3 ) = substrin"$
A instruo (id$ substitui o texto atualmente atribuido a strin"$, comeando na
posio atual do cursor pos7inic; contando a partir da esquerda, pelo texto contido em
substrin"$. Se nuero; expresso, esse nmero de caracteres removido de strin"$
e substiudo pelos primeiro nuero; caracteres a partir da esquerda de substrin"$

,n +rror K8o$o L 6esu%eM
Propsito: Interceptao de erros dentro da procedure
Sintaxe: +n .>ocal3*rror /Doto rotulo1@esue #ext1Doto M2
A instruo de desvio +n *rror define uma interceptao de erros que, quando
chamada pela primeira vez dentro de um aplicativo, fora a execuo da procedure
atual para pular para um rtulo de linha especifio sempre que ocorrer um erro que
normalmente suspenderia o processo normal de execuo. Contanto que o
procedimento continue a ser executada sem problema, o desvio para o rtulo tem
lugar imediatamente quando ocorre um erro.
A frase +n *rror Do!o M termina uma interceptao de erro e permite que o
intepretador Visual Basic suspenda novamente a execuo no caso de um erro srio. A
frase +n *rror @esue #ext permite que voc diga ao interpretador para ignorar
quaisquer erros que possam ocorrer no caminho e retomar a execuo na instruo
seguinte que causou o erro.
A palavra-reservada Local fornecida como uma opo para os usurios de outros
compiladores BASIC da Microsoft. Porm, sua ativao dentro de uma interceptao de
erros do Visual Basic no tem efeito, porque todas as interceptaes de erros do Visual
Basic existem em nvel local.

,n@@@8o$o e ,n@@@8oSub
Propsito: Desvio de mltipla escolha
Sintaxe: +n expressao Do!o rotuloM, rotulo<., rotulo=, A A A rotulo=OO3
+n expressao DoSub rotuloM, rotulo<., rotulo=, A A A rotulo=OO3
A colocao de +n expressao antes de uma instruo Doto ou DoSub converte essa
instruo em um desvio seqncial para um dos rtulos especificados na lista seguinte
palavra reservada. O desvio depende do valor de expressao. Geralmente, a
58
expressao consiste de uma varivel por si s. O valor reduzido logicamente de
expressao, quando arredondado para o inteiro mais prximo, precisa estar entre 0 e
255, inclusive. Esse valor equivcalente posio na lista do rtulo que ser o destino
do desvio. Se a instruo que est fazendo o desvio DoSub, o desvio ser tratado
como uma chamada regular a uma sub-rotina; ao processar @eturn, a execuo ter
lugar na instruo imediatamente seguinte +nA A A DoSub.

,pen
Propsito: Iniciao de ponteiros de dados
Sintaxe: +pen noear8$ .,or odo3 .Access restricao3 .tipotrava3 As .#3canal% .>en
= cprb%te%3
A instruo +pen inicia um canal para a transferncia de dados entre o interporetador
Visual Basic e um arquivo armazenado fisicamente. O nome de arquivo DOS desse
arquivo especificado como noear8$ e pode conter o caminho completo de
armazenamento do rquivo. O nmero de canal associado a esse arquivo expresso
como canal% e pode ser qualquer inteiro entre 1 e 255. A escolha de nmeros aqui
completamente arbitrria; um canal de numerao menor no precisa ser aberto antes
de um nmero maior ser escolhido. Depois de voc usar a instruo +pen para atribuir
um nmero de canal a um nome de arquivo, qualquer instruo de transferncia de
dados que se refira a esse nmero afeta o arquivo atribudo ao nmero pela instruo
+pen. Um sinal # antes do nmero do canal opcional para manter compatibilidade de
sintaxe com as verses anteriores do BASIC.

,ption Base
Propsito: Predefinio default de array
Sintaxe: +ption :ase / M 1 < 2
A declarao +ption :ase, usada dentro do mdulo global ou rea de declaraes
gerais de um aplicativo, estabelece se o endereo incial de uma varivel array deve ser
0 ou 1. Esse valor especificado no inteiro que acompanha e no pode ser nenhum
outro. O valor de limite inferior default de variveis array 0.

,ption Co%pare
Propsito: Restries do processo de comparao de texto
Sintaxe: +ptionn Copare /:inar% 1 !ext2
Voc usa a instruo +ption Copare dentro da seo de declarae de um mdulo
para especificar o tipo de comparao textual a ser usada pelas instrues dentro
desse mdulo. A instruo +ption Copare :inar% compara caracters uns aos outros
pelo valor numrico; assim, a comparao sensvel a maisculas/minsculas. A
instruo +ption Copare !ext, por outro lado, compara caracteres somente quanto
ao contedo textual; assim, a comparao no sensvel a maisculas/minsculas.
Quando essa instruo omitida, o interpretador usa comparaes em modo binrio.

,ption +xplicit
Propsito: Estipulao de declarao
Sintaxe: +ption *xplicit
A instruo +ption *xplicit, quando includa na seo de declaraes de um mdulo,
coloca o interpretador em um modo no qual todas as variveis includas no cdigo-
fonte tem que ser primeiro declaradas explicitamente, pelo uso da declarao Di ou
Dlobal.

Print N
Propsito: Transmisso de dados para dispositivo
Sintaxe: Brint #canal%, expressao</4 1 ,2 expressao=3 .A A A /4 1 , 2 expressaon3
59
Nessa sintaxe, cada expressao tanto pode ser reduzida logicamente para um valor
numrico ou expressa como uma concatenao alfanumrica de um ou mais elementos
de texto.
A instruo Brint # imprime o texto dos valores ou contedo de cada expresso da
lista em um arquivo texto que atua como o arquivo de dados atribudo ao inteiro
canal%. Esse nmero de canal precisa ter sido aberto previamente com a instruo
+pen com +utput ou Append e atribudo a um nome de arquivo especfico encontrado
dentro da instruo +pen. Brint # imprime texto em um aruivo com esse nome de
arquivo. A forma desse texto exatamente como ele apareceria se voc tivesse usado
o mtodo ABrint para imprimi-lo em um bojeto grfico ou na impressora.
Se um ponto-e-vrgula aparece antes de uma expresso impressa imediatamente no
arquivo, na posio atual do ponteiro de caractere - cancelando assim ualquer retorno
de carro ou avano de linha antes da impresso comear. Se uma vrgula aparece
antes de uma expresso, a expresso impressa no arquivo no incio da prxima zona
de impresso. Como nenhuma fonte de texto admitida para a impresso em um
arquivo em disco - porque voc no est lidando com imagens ou aparncia
especificamente - uma zona de impresso comea a cada 14 caracteres.
Para cada canal aberto, o interpretador mantm a posio de caractere atual dentro do
arquivo at ele ser fechado com a execuo de uma instruo Close. Mltiplas
declaraes Brint # executadas em seqncia para o mesmo nmero de canal fazem
com que os seus resultados apaream dentro do arquivo associado ao canal, na
mesma seqncia.

Put N
Propsito: Armazenamento de dados em dispositivo
Sintaxe: But #canal%, .posicao;3, variavel
A instruo But # escreve o contedo da variavel especifica em um arquivo de dados
de acesso aleatrio, aberto previamente com a declarao +pen A A A As @ando ou
+penA A A As :inar%, e cujo nmero canal% seja designado por essa declarao +pen.
Voc no pode substituir o termo variavel por uma expresso ou valor. Na instncia da
declarao But #, somente uma varivel pode ser declarada explicitamente. Voc s
pode incluir uma varivel; o interpretador VB no reconhece listas de variveis para
essa instruo.
Quando voc est usando a tcnica de aesso aleatrio, se posicao; declarada, o
contedo de varivel assumido como sendo escrito na posio de elemtno de nmero
posicao; contada a partir do incio do arquivo. Se j existir um elemento nessa
posio, ele ser substitudo pelo contedo de variavel. Se a posicao; no estiver
declarada, a vrgula que guarda o lugar onde ela deveria ter sido declarada precisa
permanecer para distinguir seu propsito nesta declarao daquele de variavel.
O intepretador Visual Basic mantm um ponteiro de arquivo para cada arquivo de
dados aberto com a instruo +pen. Este ponteiro registra a posio onde o prximo
elemento de dados ser escrito. Em acesso aleatrio, se posicao for omitida, a escrita
ocorrer na posicao sendo atualmente indicada pelo ponteiro de arquivo. Depois que a
escrita em um arquivo de acesso aleatrio ou binrio ocorre, o ponteiro de arquivo
registra a posio imediatamente no meio de um arquivo existente, depois da escrita o
ponteiro incrementado para a prxima posio no meio desse arquivo. Em outras
palavras, a posio default do ponteiro de arquivo quando posicao; no est
especificada no no final de um arquivo de acesso aleatrio no Visual Basic.
Se o valor de posicao; estiver alm do valor onde quaisquer dados tenham sido
escritos no arquivo, o contedo dos dados nas posies anteriores posicao; pode ser
errneo. Contudo, valido especificar uma posicao; de armazenamento que seja
muito maior que o nmero de elemento do arquivo.
60
O comprimento de cada elemento em bytes armazenados , por default, 128 btes.
Voc pode reespecificar este comprimento com a poro >en = copr% da instruo
+pen desse arquivo. Este comprimento considerado o comprimento de campo para
cada elemento do arquivo. Cada campo pode ter de 1 a 32.767 bytes de comprimento,
e todos os campos dentro de um arquivo de acesso aletrio tm comprimentos
idnticos. Estes tantos bytes so ecritos no arquivo cada vez que But # executado,
independentemente do comprimento em bytes da variavel especificada. Uma string
alfanumrica no pode ser maior que o nmero de bytes no comprimento de campo
menos dois, considerando o quanto ocupa um valor descritor de string. Cada vez que
But # executado, o nmero de bytes no comprimento de campo adicionado para
que o ponteiro mantenha a posio absoluta atual desse ponteiro.
Quando voc est usando a tcnica de acesso binrio - quando voc abre o arquivo de
dados usando +penA A A As :inar% - o valor de posicao;, quando especificado,
repesenta o nmero de bytes absoluto dentro do arquivo aberto. Este nmero de bytes
atua como um endereo absoluto. Os elementos de um arquivo de acesso binrio no
tm comprimentos iguais; a instruo But #, portanto, escreve no arquivo de acesso
binrio exatamente tantos bytes quantos so usados para armazenar a variavel
especificada na memria. Se posicao; no especificada, a escrita ocorre no prximo
endereo de byte na seqncia.

6ando%iIe
Propsito: Realimentao do gerador aleatrio
Sintaxe: @andoi5e . (seente%) 3
A instruo @andoi5e realimenta o gerador de nmeros aleatrios de um aplicativo.
Em outras palavras, ele muda algumas das contantes do algoritmo de gerao
aleatria para que uma seqncia diferente de nmeros aleatrios possa ser gerada,
eliminando assim a possibilidade de nmeros previsveis. Se seente% expressa
uma seqncia particular de nmeros aleatrios referida por seente% iniciada. Se
seente% omitida, uma semente "aleatria" iniciada, cujo valor escolhido se
baseia no estado atual do prprio gerador de nmeros aleatrios.

6eDi%
Propsito: Redeclarao de array dinmico
Sintaxe - (si%ples): @eDi variavel (inteiro)
Sintaxe . (co%plexa): @eDi .Breserve3 variavel<(intiro) .!o inteiro3 ., inteiro .!o
inteiro33) .As tipo3 ., variavel= .As tipo3, A A AvariavelPM (inteiro .!o inteiro3 ., inteiro
.!o inteiro3 3 ) .As tipo3 3
A declarao @eDi recoloca os arrays dinmicos declarados para novos limites
mnimo e mximo, e pode ser usada para mudar o tipo de armazenamento de
variveis declaradas. Ao fazer isso, todos os valores e contedo dos arrays dinmicos
so apagados, a menos que a opo Preserve seja utilizada. Cada array dinmico na
declarao @eDi precisa ter sido previamente declarada pela utilizao de Di
variavel( ) usando precisamente esta sintaxe, omitindo quaisquuer limites do array
entre os parnteses. Novos limites podem ser especificados a qualquer momento
usando @eDi. O contedo do array ficar limpo de quaisquer valores ou contedo
depois de @eDi ser executada, portanto ela tambm pode ser usada no lugar de
*rase para limpar ou atualizar uma matriz dinmica.

6e%
Propsito: Permite que voc coloque comentrios textuais em seu cdigo-fonte.
Sintaxe: /@e 1 Z 2 .coentario3
Quando o intepretador encontra a instruo @e em uma linha, ele ignora o contedo
restante dela e pula para a prxima linha. Essa instruo permite que voc digite
61
qualquer coisa no cdigo-fonte aleatoriamente, geralmente, para uso de comentrios
para explicar seu cdigo para a prxima pessoa que for examin-lo. Voc pode usar o
apstrofo (') no lugar do termo @e.

6eset
Propsito: Encerramento do processo de transferncia de dados
Sintaxe: @eset
A declarao @eset encerra todos os processos de transferncia de dados fazendo fluir
o contedo de todos os buffers de dados abertos para seus respectivos arquivos
abertos, e fechando todos os canais abertos sem que se tenha de invocar declaraes
Close para esse canais.

6esu%e
Propsito: Terminao de rotina de interceptao de erros
Sintaxe: @esue / .M3 1 #ext 1 rotulo2
A intruo @esue reservada para ofinal de rotimnas de interceptao de erros
dentro de uma procedure. Chamada em uma linha prpria ou acompanhada de um 0,
essa instruo envia a execuo de volta para a declarao que causou o erro
interceptado. A instruo anteriormente errnea ento reexecutada paa ver se gera
o mesmo erros uma segunda vez.
A frase @esua #ext envia a execuo de volta para a instruo imediatamente
seguinte que causou o erro. A frase @esue rotulo envia a execuo de volta para a
instruo imediatamente seguinte ao rtulo especificado.

6eturn
Propsito: Terminao de sub-rotina
Sintaxe: @eturn
Quando a instruo @eturn processada, um desvio feito para a instruo
imediatamente seguinte instruo DoSub executada mais recentemente.

SaAePicture
Propsito: Salvamento do contedo de imagem
Sintaxe: SaveBictrure .+bEetoA3propriedade, noear8$
onde noear8$ se refere a um arquivo com a extenso BMP (bitmap do Windows),
ICO (cone padro), ou WMF (meta-arquivo do Windows).
A instruo SaveBicture salva em disco a ABicture ou A9a"e atualmente residindo no
Objeto caixa de figura designado, usando o nome de arquivo noear8$ dado. O termo
propriedade definido com a palavra Image ou com uma referencia direta ao Objeto e
sua propriedade ABicture. Se Image especificado, ento independente do nome de
arquivo ou extenso expressos, a imagem salva como um arquivo bitmap do
Windows, ao qual dada uma extenso BMP. Se +bEetoABicture for especificado, a
figura ser salva em seu formato atual no controle, que pode ser um bitmap do
Windows, um cone padro ou um meta-arquivo.

See( N
Propsito: Diretiva de posicionamento do ponteiro de dados
Sintaxe: See' .#3 canal%, posicao;
A instruo See' # define a posio do ponteiro de um arquvio de dados na qual ir
ocorrer a prxima leitura ou escrita, em uma posicao; especificada. O arquivo de
dados especificado por seu canal% designado, que foi dado a esse arquivo quando
ele foi aberto pelo uso da declarao +pen. O valor de posicao; pode ser especificado
como maior que o atual comprimento efetivo do arquivo. Em tais casos, o
62
interpretador gera valores nulos para todas as posies entre a posio final e a
posicao; declarada.
Em arquivos de acesso aleatrio, o valor de posicao; definido como o nmero do
elemento de dados onde uma varivel ser escrita quando But # for ativada a seguir, o
nmero do elemento de dados de onde ela ser lida quando Det # for ativada a seguir.
Em arquivos de acesso seqncial ou binrio, o valor de posicao; definido com o
endereo em bytes do prximo caractere a ser escrito ou lido no arquivo de dados. O
sinal # antes do nmero canal% opcional.

Select Case@@@ Case@@@ +nd Select
Propsito: Clusula condicional de mltipla escolha
Sintaxe: Select Case expressao
Case .9s3 coparacao<a .!o coparacao<b3
.Case .9s3 coparacao=a .!o coparacao=b3 3
A A A
.Case *lse3
.bloco de 9nstrucoesn3
*nd Select
A instruo Select Case compara o valor ou contedo de texto de uma expresso inicial
com o valor de uma ou mais expresses igualdade. A declarao contm vrias
expresses de comparao quanto igualdade, embora o elemento sendo comparado
s seja escrito uma vez como expresso inicial no comeo da clusula. essa expresso
incial pode consistir de uma varivel ou at um nmero; entretanto, ela tambm pode
conter qualquer nmero de elementos que sejam especificados ou implcitos, e
combinados por operadores aritmticos.
Para cada comparao de igualdade, na eventualidade de (ou no caso de) uma das
comparaes entre as expresses ser avaliada como True, o conjunto de instrues
aps Case executado. Quando o prximo Case ou *nd Select atingido, a execuo
pula para a instruo imediatamente seguinte *nd Select.
Select Case d ao programa uma maneira de interpretar opes.

SendGe&s
Propsito: Imitao de pressionamento de tecla
Sintaxe: SendNe%s texto$., suspende%3
A instruo SendNe%s envia para o sistema o texto contido em texto$, um caractere
aps o outro, como se cada caractere de texto$ fosse digitado muito rapidamente no
teclao. O controle do formulrio atual que tem o foco ser o destinatrio do texto. Se o
cursor est numa caixa de texto, o texto contido em texto$ aparecer nessa caixa,
como se o usurio tivesse digitado esse texto manualmente. Se o valor -1 estiver
especificado para suspende%, a execuo do aplicativo Visual Basic ser suspensa at
que o Windows processe todas as teclas enviadas e o buffer do teclado fique vazio.

Set
Propsito: Estabelecimento de representao indireta
Sintaxe -: Set varobEeto = .re-paiF3 re-obEeto
Sintaxe .: Set varobEeto = #e$ noeobEeto
A instruo Set, usando a sintaxe 1, atribui varivel de objeto varobEeto o objeto
grfico existente declarado como re-obEeto. A referncia re-obEeto para esse objeto
existente pode ser feita por meio da propriedade A#ae desse objeto, ou por meio de
mais uma outra varivel de objeto. Uma invocada, qualquer referncia a varobEeto se
palica ao mesmo objeto grfico que re-obEeto. A varivel de objeto varobEeto pode ser
63
definida posteriormente para se refereir a algum outro objeto grfico, ou desvinculada
pela definio de sua referncia a Nothing (nada). Qualquer varivel de objeto referida
pela declarao Set precisa primeiro ter sido declarada formalmente usando a
declarao Di, Dlobal ou Static, como descrito no Captulo 20, "A Janela Como
Documento".
Se o objeto pai de refobjeto no estiver atualemtne ativo (se ele no tem o foco em
nvel de formulrio), para atribuir a referncia do objeto grfico ao objeto pai particular
ao qual ele pertence, a referncia de objeto re-pai desse pai precisa ser declarada
primerio, seguida da referncia de controle filho re-obEeto. As duas referncias so
separadas uma da outra por um ponto de exclamao.
Usando a sintaxe 2, a declarao Set atribui a varivel de objeto varobEto a uma nova
instncia de um objeto pr-estruturado cuja propriedade A#ae tenha sido definida
como noeobEeto quando em tempo de projeto. A chamada desta sintaxe da declara
Set torna existente esta nova instncia #e$ do objeto grfico. O pai de noeobEeto
precisa estar atualmente ativo, ou ter o foco em nvel de formulrio.

Static
Propsito: Declarao de varivel local
Sintaxe: Static variavel< .ionteiro .!o inteiro3 ., inteiro .!o inteiro3 3 ) 3 .As tipo3 .,
variavel= . (inteiro .!o inteiro3 ., inteiro .!o inteiro3 3 ) 3 .As tipo3, A A A variavelPM .
(inteiro.!o inteiro3 ., inteiro .!o inteiro3 3 ) 3 .As tipo3 3
A instruo Static usada no lugar de Di para delarar todas as variveis unitrias e
array de uma procedure que tenham valores que o interpretador deva manter depois
da delcarao *nd Sub ou *nd ,untion ser executada para essa procedure. Exceto pelo
termo principal, a sintaxe de Static a mesma da declarao Di dentro de uma
procedure. Ela no pode, porm, incluir o termo Shared.

Stop
Propsito: Suspenso do programa
Sintaxe: Stop
A instruo Stop suspende a execuo do programa, provocando a mesma resposta do
interpretador como se o usurio tivesse selecionado Break a partir do menu Run do
Visual Basic. A janela Immediate (imeditata) do CLI se torna disponvel depois de Stop
ser executada. A execuo do programa retomada em uma procedure ou rtulo de
linha especificado em uma instruo que o usurio deve veicular atravs do CLI.

Sub
Propsito: Inciao de porocedure que no retorn valor
Sintaxe: .Static3.Brivate3 Sub noe7da7procedure (. .:%val3 ar"uento<. ( ) 3
bloco 7de7instrucoes<
.*xit Sub3
.bloco7de7instrucoes=3
A A A
*nd Sub
Sub principal instruo declarativa de procedure do vocabulrio do Visual Basic. A
declarao usada para conter uma procedure de um dado nome
noe7da7procedure. A execuo pode ser desviada para essa instruo Sub de
qualquer ponto do programa se voc chamar esse nome de procedure dentro do
cdigo-fonte ou usar a instruo Call.
Diz-se que ua procedure Sub recebe valores da procedure que a chamou, como
argumentos ou parmentros (os termos aqui so intercambiveis). Quando uma
procedure chamada de fora, os valores pertinentes a essa procedure so listados
entre parnteses, separado por vrgulas. Diz-se qu esse valores so passados para a
64
procedure, podendo ser escritos como numerais esplcitos ou representados por
variveis. Quando um procedure declarada dentro, esses valores so recebidos na
ordem na qual so passados, e so atribudos a variveis que tm nomes que podem
ser os mesmos usados na chamada de procedure. O contedo de variveis de string
pode ser passado da mesma forma que valores de variveis numricas.
Se voc deseja garantir que um tipo especfico de argumento seja passado para a sua
procedure, um interio por exemplo, voc pode colocar o termo As tipo ao lado desse
argumento. O contedo inteiro de um array pode ser passado para uma procedure
como um argumento, contanto que o nome da varivel de array seja identificado com
parnteses vazios.
Normalmente, qualquer mudana feita nos valores dos argumentos listados refletida
nas variveis usadas como argumentos na chamada a procedure. Essa reflexo pode
ser contornada para um argumetno especfico colcocando o termo ByVal antes desse
argumento; fazendo isso voc permite que a varivel usada na chamada a procedure
retenha seu valore mesmo que o valor da varivel usada para receber o argumento
tenha sido modificado na procedure.
As instrues em uma procedure Sub so exzecutadas em seqncia. Uma procedure
Sub terminada sempre que um *xit Sub ou *nd Sub atingido durante essa
seqncia.
Os valores das variveis com escopos que sejam locais a procedure, ou que no
tenham sido declaradas como modulares ou globais fora da procedure, so
normalmente tornados nulos sempe que se sai da proceure. O uso o termo Static antes
do termo Sub permite que o interpretador mantenha os valores e contedo das
variveis usadas pela procedure depois de sair dela. O uso do termo Brivate antes do
termo Sub, se essa procedure Sub aparece em um mdulo geral, muda o contexto da
procedure de global para nvel de mdulo, para que nenhum oputro mdulo possa
fazer uma chamada a esta procedure. Os proceimentos Sub declaradas em mdulos de
formulrio recebem automaticamente contexto de nvel de mdulo, e no requerem o
qualificador Brivate.

$&pe9+nd t&pe
Propsito: Clusula de declarao composta
Sintaxe: !%pe noe7do7tipo
variavel<.copriento7arra%)3 As tipo7existente .X copriento7se"3 .variavel= . (
copriento7atri5) As tipo7existente .X copriento7se83 3
End Type
A clusula !%peK*nd !%pe usada dentro do mdulo global ou seo de declaraes
gerais de um aplicativo para declarar tipos de variveis compostas definidas pelo
programador para esse aplicativo. O noe7do7tipo da varivel composta definido
arbitrariamente pelo programador; entretanto, ele no pode ser uma palavra
reservada, um bnome de varivel declarada ou um termo usado no programa para
qualquer outra finalidade.
Cada varivel que ir compor a varivel composta listada dentro da clusula. As
listas de variveis aqui no contam como declarativas; essas variveis precisam ser
declaradas em outro lugar do programa. A chamada de cada varivel aqui tida
somente como uma reserva de seu lugar dentro da varivel composta sendo
declarada. O tipo de varivel tipo existente includo dentro do tuipo composto precisa
ser especificado com o termo As, e pode ser um tipo composto declarado previamente
dentro de uma clusula anterior.
Se as strings esto sendo usadas dentro de uma varivel composta, o programador
tem a opo de especificar o comprimento absoluto em caracteres de cada uma,
escrevendo esse comprimento ao lado do asterisco * seguinte designao As String.
65
Fixar o comprimento das strings includas necessrio no uso de clusulas Type para
salvar registros em um arquivo de dados baseado em disco.

4nload
Propsito: remoo do objeto da rea de trabalho
Sintaxe: ?nload noeobEeto
A instruo ?nload remove o formulrio ou objeto grfico carregado especificado da
rea de trabalho bem como da memria. O objeto continua a existir como um
formulrio no projeto e como um arquivo armazenado em disco se ele chegou a ser
armazenado. Essa instruo necessria para um aplicativo Visual Basic compilado
porque os servios do interpretador VB no iro "fechar" automanticamente cada
formulrio uma vez que o programa compliado seja formalmente encerrado.

'idt" N
Propsito: Formatao de aruivo de dados textuais
Sintaxe: &idth #canal%, colunas%
A instruo &idth # defie a largura de "impresso" de um arquivo de acesso
seqncial cujo canal% esteja atualmente aberto por meio da instruo +pen. A
definio feita com um nmero especificado de colunas% de 0 a 255. Depois do
interpretador ter armazenado um nmero colunas% de caracteres em um arquivo
aberto, ele gera automaticamente um caractere retorno de carro e um caractere
avano de linha. A "impresso" - ou armazenamento de entradas no arquivo - comea
ento na linha seguinte. Se colunas% for zero, nenhuma linha ser assumida, e o
texto dar a volta para as linhas seguintes sem retornos de carro at o seu termino.

'rite N
Propsito: Transmisso de texto para disco
Sintaxe: &rite #canal%, expressao<., expressao= A A A , expressaon3
Nesta sintaxe, cada expressao pode tanto ser logicamente reduzida a um valor
numrico como ser um aconcatenao alfanumrica de um ou mais elementos de
texto.
A instruo &rite # imprime o texto dos valores ou contedo de cada expresso da
lista em um arquivo texto que atua como o arquivo de dados atribudo ao interio
canal%. Esse nmero de canal precisa ter sido aberto previamente com a instruo
+pen como +utput ou Append e atribudo a um nome de arquivo especfico encontrado
dentro da instruo +pen. &rite # imprime texto em um arquivo com esse nome de
arquivo. O texto est na forma de um arquivo de dados delimitado ASCII como usado
pelo recurso mail merge de muitos processadores de texto. Todos os elementos so
separados uns dos outros por vrgulas, e todas as strings alfanumricas so colocadas
entre aspas. Vrgula e qualquer pontuao alm das prprias aspas que devam
aparecer dentro de uma string so colocadas entre as aspas.

363 VBJairSoft20140821235341 PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

363 VBJairSoft20140821235341 PDF

Enviado por

Direitos autorais:

Formatos disponíveis

Guia de Referencia do

Você também pode gostar