Guia rápido de visual basic
Transferir como DOC, PDF2 gostaram3,733 visualizações
Este documento fornece um guia de referência sobre funções, métodos, propriedades e instruções do Visual Basic. Ele lista e descreve funções como Abs() para obter o valor absoluto e Asc() para obter o código ANSI de um caractere. Também descreve métodos como .AddItem() para manutenção de listas e propriedades como .FontName e .FontSize para formatar texto. Por fim, cobre instruções como Dim para declarar variáveis e If/Then para condicionais.
![DefCur, DefDbl, DefInt, DefLng, DefSng, DefStr e DefVar: Restrição de variáveis alfabéticas
Dim: Declaração de variável
DoEvents: Mudança de prioridade os eventos
Do [While | Until]...Loop [While | Until: Demarcação de loop condicional/incondicional
End: Terminação de contexto
Erase: Atualização de arrays
Error: Simulação de erro
Exit: Aborto forçado de contexto
For-Next: Demarcação de um loop reiterativo
Function: Inciação de procedure que retorna valor
Get #: Recuperação d dados de um dispositivo
Global: Declaração de variável Global
GoSub: Desvio temporário
GoTo: Desvio entre procedimentos
If... Then... [ElseIf... Then][Else... ]... End If: Cláusula condicional
Input #: Aquisição de dados do dispositivo
Line Input #: Transmissão de texto formatado de um dispositvo
Load: Colocação de um bojeto na área de trabalho
LSet e RSet: Justificação de conteúdo
Mid$: Inserção de um fragmento de string
On Error [GoTo | Resume]: Interceptação de erros dentro da procedure
On...GoTo e On...GoSub: Desvio de múltipla escolha
Open: Iniciação de ponteiros de dados
Option Base: Predefinição default de array
Option Compare: Restrições do processo de comparação de texto
Option Explicit: Estipulação de declaração
Print #: Transmissão de dados para dispositivo
Put #: Armazenamento de dados em dispositivo
Randomize: Realimentação do gerador aleatório
ReDim: Redeclaração de array dinâmico
Rem: Permite que você coloque comentários textuais em seu código-fonte.
Reset: Encerramento do processo de transferência de dados
Resume: Terminação de rotina de interceptação de erros
Return: Terminação de sub-rotina
SavePicture: Salvamento do conteúdo de imagem
Seek #: Diretiva de posicionamento do ponteiro de dados
Select Case... Case... End Select: Cláusula condicional de múltipla escolha
SendKeys: Imitação de pressionamento de tecla
Set: Estabelecimento de representação indireta
Static: Declaração de variável local
Stop: Suspensão do programa
Sub: Inciação de porocedure que não retorn valor
Type-End type: Cláusula de declaração composta
Unload: remoção do objeto da área de trabalho
Width #: Formatação de aruivo de dados textuais
Write #: Transmissão de texto para disco
50
51
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
6](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-6-320.jpg)
![Quando atributo% é declarado como 1, a função FileAttr( ) retorna um valor que
descreve o modo de acesso a arquivo de dados atribuído ao canal de dados
especificado. Essa valor pode ser qualquer dos seguintes:
1 Input(entrada) seqüêncial
2 Output(saída) seqüêncial
4 Random(aleatório)
8 Append(anexação) seqüêncial
32 Binary(binário)
Quando atributo% é declarado como 2, a função FileAttr( ) retorna um valor
representando o gerenciador de arquivo ou número de acesso atribuído a ele pelo
ambiente Microsoft Windows. Você pode usar esse gerenciador em conjunto com
instruções para a API do Windows.
Fix( )
Propósito: Arredondamento numérico
Sintaxe: solucao% = Fix(expressao)
A função Fix( ) remove qualquer valor fracionário do valor simplificado logicamente de
expressao, deixando um número inteiro. Esse valor é retornado na variável solucao%.
Format$( )
Propósito: Conversão de valor para string
Sintaxe: string$ = Format$(valor[, {"tipoformato$" | descritor$}])
Nesta sintaxe, descritor$ é uma série de caracteres de diretivas e marcadores de
posição escritos em até três grupos usando a seguinte sintaxe: descritorpos[;
descritorneg[;descritorzero]]
A função Format$( ) converte um valor numérico em uma string alfanumérica, da
mesma forma que a função Str$( ). Se nenhum outro parâmetro for especificado, a
função Format$( ) pára aqui; caso contrário, ela aplica um formato de aspecto a este
valor. Esse formato pode ser um dos nomes de tipo gerais tipoformato$ reconhecidos
pelo interpretador, ou poderá ser uma série de caracteres marcadores de posição
descritor$ tiver que ser declarado dentro da função, ele terá que aparecer entre aspas;
caso contrário, você pode atribuir antecipadamente o descritor a uma variável string
usando uma equação.
FreeFile
Propósito: Aquisição de canal livre
Sintaxe: canal% = FreeFile
A função FreeFile retorna o número de canal não aberto de valor mais baixo, na
variável canal%. Você pode então usar essa variável em uma declaração Open que
pode vir a seguir. A função FreeFile não requer parênteses.
Hex$( )
Propósito: Tradução hexadecimal
Sintaxe: solucao$ = Hex$(exp_numerica)
A função Hex$( ) descobre o valor não fracionário de exp_numerica, arredonda esse
número para menos até o inteiro mais próximo, e encontra o valor hexadecimal (base
16) do número. Esse número é retornado como uma string, especialmente porque ele
pode conter os dígitos de A a F (10 a 15).
Hour( ), Minute( ) e Second(
Propósito: Representação de componenetes de tempo
Sintaxe:
variavel% = Hour(assinatura)
9](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-9-320.jpg)
![variavel% = Minute(assinatura)
variavel% = Second(assinatura)
Cada função deste conjunto aceita um valor de dupla precisão como seu parâmetro,
com o formato dos números desse valor coincidindo com o formato de assinatura
usado pela variável interna Now. A função Hour( ) retorna a hora do tempo
especificado em formato de 24 horas. Similarmente, Minute( ) retorna o minuto do
tempo especificado, e Second( ) retorna o segundo desse tempo.
Input$( )
Propósito: Aquisição de dados brutos
Sintaxe: sequencia$ = Input$(numcarac$, [#]canal%)
A função Input$( ) é usada na aquisição de dados brutos de um arquivo, cujos
elementos de dados, se existirem, não possam ser distinguidos uns dos outros de
nenhuma maneira que o Visual Basic imediatamente reconheça. Depois dos dados
serem adquiridos, fica por conta do aplicativo VB fazer sua interpretação e encontrar
uma finalidade para eles.
A função recupera um número numcarac% de caractres alfanuméricos de um arquivo
de dados que tenha um número de canal% a ele alocado pela declaração Open para
Input seqüêncial ou acesso Binary. Ela move o ponteiro de arquivo atual para o byte
seguinte ao último lido por Input$( ). A função recupera a string e a atribui à variável
de string string$. Cada byte da string recebida é tratado como um caractere
alfanumérico que pode ser convertido em um valor entre 0 e 255 com a função Asc( ).
Essa função não está disponível para arquivos abertos para acesso Random. O sinal #
antes de canal% é opcional nessa função.
InputBox$( )
Propósito: Chamada de painel textual
Sintaxe: resposta$ = InputBox[$] (mensagem$[, titulo$[, default$[, coordx%, coordy
%]]])
A função InputBox$( ) usa a mensagem em mensagem$ como um pedido para que
uma resposta textual seja inserida pelo usuário em uma linha de texto aparecendo no
painel de diálogo. O conteúdo dessa inha está limitado a um máximo de 31 caracteres,
que pode ser definido antecipadamente pela expressão de default$. O título do painel
de entrada pode opcionalmente ser expresso como titulo$; se o título não estiver
expresso, a barra de título 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%, coordy%. Uma caixa de entrada sempre contém dois botões:
OK e Cancel. Se o usuário clica em Cancel, o conteúdo de resposta$ permanece como
uma string nula. Se o usuário clica em OK, o conteúdo da linha de texto é retornado
como resposta$.
InStr( )
Propósito: Procura de fragmento de string
Sintaxe: posicao& = InStr([primeiro_carac&, ]exp_string1$, exp_string2$[, compara
%])
A função InStr( ) incia uma procura pela string ou concatenação de strings expressa
por exp_string2$, dentro da string maior exp_string2$. O comprimento de exp_strin2$
precisa ser menor que 65.536 caracteres. Se a procura resulta em uma coincidência, o
número do caractere da string maior onde o primeiro caractere da string menor
aparece é retornado na variável de inteiro longo posicao&. O primeiro caractere da
string maior é considerado o caractere número 1. Se a string menor não aparecer
10](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-10-320.jpg)
![exatamente dentro da string maior, ou se exp_string2$ for maior que exp_string1$, a
função retornará uma valor nulo (0).
Int( )
Propósito: Trucagem numérica
Sintaxe: solucao% = Int(expressao)
A função Int( ) arredonda o valor simplificado logicamente de expressao para menos
até o número inteiro mais próximo. O resultado desse arredondamento é retornado na
variável solucao%.
IsDate( )
Propósito: Determinação do formato de assinatura de tempo
Sintaxe: booleano% = IsDate(parametro)
A função IsDate( ) retorna uma valor True/False na variável booleano%, refletindo se o
parâmetro especificado pode ser interpretado legalmente como uma data VarType 7.
Uma string ou valor com tal formato pode ser atribuída diretamente a uma variável
não-declarada, e o interpretador responde dando a esta o tipo 7 de variant
automaticamente. Nessa situação, parâmetro pode tanto ser um valor numérico como
uma string; a função é incapaz de gerar erros com base neste tipo de parâmetro.
Valores numerais diretos, porém, muito provavelmente retonarão um valor False.
IsNumeric( ), IsEmpty( ) e IsNull( )
Propósito: Determinação do conteúdo de uma variante
Sintaxe: booleano% = IsNumeric(variant)
booleano% = IsEmpty(variant)
booleano% = IsNull(variant)
LBound( ) e UBound( )
Propósito: Aquisição dos limites de um array
Sintaxe: variavel% =LBound(array[, dimensao]) | variavel% =UBound(array[,
dimensao])
As funções LBound( ) e UBound( ) retornam os limites inferior e superior,
respectivamente, do array especificado. Se a matriz for multidimensional, para
retornar os limites de um nível de dimensão, o número desse nível é especificado como
um segundo parâmetro da função. O nome de cada array é declarada sem parênteses.
LCase$( ) e UCase$( )
Propósito: Conversão de minúsculas e maiúsculas de string
Sintaxe:
string$ = LCase$(exp_string$)
string$ = UCase$(exp_string$)
A função LCase$( ) converte em letras minúsculas todos os caracteres alfabéticos que
aparecem dentro da string ou concatenação de strings expressa exp_string$. De modo
similar, a função UCase$( ) converte em letras maiúsculas todos os caracteres
alfabéticos aparecendo dentro da string ou concatenação de strings expressa
exp_string$.
Left$( ) e Right$( )
Propósito: Segmentação de string
Sintaxe:
substring$ = Left$(string$, numero%)
substring$ = Right$(string$, numero%)
11](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-11-320.jpg)
![A função Left( ) extrai seqüêncialmente os primeiros caracteres numero% da string
maior string$ e os atribui como conteúdo da variável de string menor substring$. Da
mesma forma, a função Right$( ) extrai seqüêncialmente os últimos caracteres
numero% da string maior string$ e atribui esses caracteres à variável de string menor
substring$. Em ambas as funções, se numero% for maior que o comprimento de
string$, toda a string será retornada em substring$ sem quaisquer caracteres
adicionados a qualquer lado da string.
Len( )
Propósito: Aquisição do comprimento de uma string
Sintaxe: valor% = Len(exp_string$)
Nessa sintaxe, exp_string$ é qualquer expressão que reúna uma ou mais strings de
texto alfanumérico.
A função Len( ) retorna o número de caracteres armazenados dentro da string
expressa, na variável numérica valor%.
LoadPicture( )
Propósito: Aquisição de arquivo gráfico
Sintaxe: [TermVirt.]Picture = LoadPicture("nomearq$")
Onde nomearq$ se refere a um arquivo com a extensão BMP (bitmap do Windows),
ICO(ícone padrão), ou WMF (meta-arquivo do windows).
A função LoadPicture( ) carrega o arquivo de imagem especificado no controle terminal
virtual designado por TermVirt.
Loc( )
Propósito: Retorna a posição do ponteiro de dados do arquivo
Sintaxe: posicao& = Loc(canal%)
A função Loc( ) retorna a posição do armazenamento ou recuperação anterior de um
arquivo de dados aberto, cujo número canal% esteja especificado entre os parênteses.
Em arquivos de acesso aleatório, a função Loc( ) retorna o número do elemento de
dados ou registro anterior, onde 1 é igual ao número do primeiro elemento do arquivo.
Em arquivo de acesso seqüêncial, Loc( ) retorna um valor arredondado equivalente à
posição em bytes atual do ponteiro de dados - e não a posição do elemento ou registro
- dividida por 128. Em arquivos de acesso binário, Loc( ) retorna a posição do byte
previamente escrito ou lido no arquivo. O sinal # antes de canal% é omitido nessa
função.
LOF( )
Propósito: Aquisição de comprimento de arquivo de dados
Sintaxe: compr% = LOF(canal%)
A função LOF( ) retorna o comprimento em bytes do arquivo aberto cujo canal%
aparece entre os parênteses. O sinal # antes de canal% é omitido nessa função.
Log( ) e Exp( )
Propósito: Operações logarítmas
Sintaxe:
solucao = Log(expressao)
solucao = Exp(expressao)
A função Log( ) retorna o logaritmo natural do valor reduzido logicamente de
expressao, dentro da variável solucao. Da mesma forma, a função Exp( ) retorna a
base do logaritmo natural e elevada à potência do valor reduzido logicamente de
expressao, dentro da variável solucao.
12](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-12-320.jpg)
![LTrim$( ) e RTrim$( )
Propósito: Remoção de espaços
Sintaxe:
string$ = LTrim$(exp_string$)
string$ = RTrim(exp_string$)
Nesta sintaxe, exp_string$ é qualquer expressão lógica contendo uma ou mais strings
ou variáveis de string concatenadas.
A função LTrim$( ) remove todos os espaços do lado esquerdo da string expressa. Da
mesma forma, a função RTrim$( ) remove todos os espaços do lado direito da string
expressa.
Mid$( )
Propósito: Aquisição de parte de uma string
Sintaxe: substring$ = Mid$(string$, pos_inic&, numero%)
A função Mid$( ) extrai um numero% de caracteres de uma string em ordem qa partir
da string maior string$, começando na posição de caractere pos_inic& contando a
partir da esquerda de string$. Os caracteres extraídos são então atribuídos à variável
de string menor substring$.
Oct$
Propósito: Conversão octal
Sintaxe: solucao$ = Oct$(exp_numerica)
A função Oct$( ) descobre o valor não fracionário de exp_numerica, arredonda esse
número para menos até o inteiro mais próximo, e encontra o valor octal (base 8) do
número. Embora a solução só contenha dígitos de 0 a 7, ela é retornada dentro de
uma variável de string solucao$.
QBColor( )
Propósito: Simulação de cores CGA
Sintaxe: cor& = QBColor(registro%)
A função QBColor( ) retorna um valor inteiro longo que representa, para o Visual Basic,
uma mistura de cores aproximadamente equivalente ao valor da cor registro% usado
no Microsoft QuickBASIC para plotagem na tela CGA. O parâmetro registro% pode
elevar qualquer dos valores da tabela 43.1. Nesta os valores são mostrados ao lado de
seus equivalentes RGB( ) funcionais.
RGB( )
Propósito: Representação de valor de cor
Sintaxe: cor& = RGB(red%, green%, blue%)
Onde red%(vermelho), green%(verde) e blue%(azul) são inteiros no intervalo de 0 a
255, representando a intensidade de cada cor primária na mistura.
A função RGB( ) retorna um único valor inteiro longo que é uma combinação
matemática dos três parâmetros de entrada e que representa, para o interpretador
Visual Basic, um valor específico de mistura de cores. Cada parâmetros representa a
quantidade de sua cor primária ótica usada na mistura. Quanto maior o valor do
parâmetro, mais intensa a cor primária na mistura.
Rnd( )
Propósito: Geração de número aleatório
Sintaxe: numero# = Rnd[(processo#)]
Nesta sintaxe, processo# é qualquer número de ponto-flutuante e precisão dupla, cujo
sinal, quando processo# é expresso, é crucial para o processo de geração.
13](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-13-320.jpg)
![Métodos do Visual Basic
.Additem
Propósito: Manutenção de entradas de lista
Sintaxe: Caixalist.AddItem texto$ [, indice%]
O método .AddItem coloca o conteúdo textual de texto$ na caixa de listagem ou de
combinação que tenha o nome de controle Caixalist. Por default, o texto é colocado no
final da lista. Opcionalmente, a posição do novo item na lista pode ser especificada por
um número como indice%. Os itens de uma lista são contados ou indexados
começando por 0; o valor de indice% não deve ser maior que o número de itens da
lista menos um. O método só pode adicionar itens a uma caixa de listagem
individualmente, e não em grupos ou matrizes.
.Arrange
Propósito: Regulação de filha MDI
Sintaxe: [paiMDI.]Arrange layout onde layout pode ter um dos seguintes valores:
Em cascata, como uma série de páginas empilhadas umas sobre as outas, e deslocadas
0
para baixo e para a direita, expondo as barras de título de cada janela.
Lado a lado horizontalmente, para que tantas janelas quantas possíveis sejam
distribuídas por toda a largura da janela pai MDI, com cada janela filha aparecendo ao
lado da outra na ordem cronológica de sua invocação. Se houver um número grande
1
de janela filha MDI na área de trabalho do pai (geralmente, mais de 6), somente umas
poucas primeiras janelas filha exibidas, o número exato dependendo da resolução
gráfica atual e o tamanho do pai MDI.
Lado a lado verticalmente, demodo que tantas janelas quantas possíveis sejam
distribuídas por toda a altura da área de trabalho do pai MDI, com cada janela filha
aparecendo à direita da outra na ordem de sua invocação. Se houver um número
2
grande de janela filha MDI na área de trabalho do pai, somente as primeiras poucas
janelas filha serão exibidas. O número exato de janelas filha mostradas depende da
resolução gráfica atual e o tamanho do pai MDI.
Reservado para casos nos quais existam janelas filha minimizadas, este valor de layout
3 reorganiza os ícones minimizados ao longo da borda inferior da área de trabalho do pai
MDI.
.Circle
Propósito: Plotagem de elipse
Sintaxe: [Objeto.]Circle Step] (twipx!, twipy!), raio![, cor&] [, ang_inicia1!,
ang_fina1!)[, aspecto!]
O método .Circle plota uma série de pontos em uma curva, todos os quais
geometricamente convergem de um ponto central especificado como (twipx!, twipy!).
Por default, esse pontos são dispostos para formar um círculo; entretando,
especificando os três últimos parâmetros individuais, você pode plotar em vez disso
um arco ou elipse.
A menos que aspecto! seja especificado, cada ponto da série será plotado a uma
distância de raio! twips das coordenadas do centro. Se cor& for especificada, a série
17](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-17-320.jpg)
![será plotada na cor especifica. As funções RGB( ) e QBColor podem ser usadas para
determinar o valor de cor&. Se cor& é omitida, a série é plotada com a cor usada como
definição da propriedade .ForeColor do objeto que está recebendo a plotagem.
.Clear
Propósito: Limpeza de uma caixa de listagem
Sintaxe 1: [Formulario.]Caixalist.Clear
O método .Clear esvazia todo o conteúdo da caixa de listagem antecedente. A
propriedade .ListCount da caixa de listagem é definida como zero.
.Clear
Propósito: Apagamento do conteúdo do clipboard
Sintaxe: Clipboard.Clear
O método .Clear limpa o conteúdo atual do clipboard do sistema.
.Cls
Propósito: Limpeza de área de figura
Sintaxe: [objeto.]Cls
O método .Cls limpa qualquer conteúdo impresso ou plotado, textual ou gráfico, do
objeto gráfico especificado. Se objeto. não estiver especificado, o formulário no qual a
procedure .Cls aparece será limpo.
.Drag
Propósito: Ativação do arraste manual
Sintaxe: Controle.Drag inteiro%
O método .Drag é usado para iniciar ou parar manualmente o processo de arraste de
um controle, seja qual for a definição de .DragMode desse controle. Isso é
especialmente útil se o .DragMode do controle estiver definido como 0 (manual) e, por
default, ele não 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 método .Drag aparecer em um
procedimento de evento do controle antecedente.
2 Termina o arraste do controle e sinaliza com um evento _DragDrop para esse
controle.
.EndDoc
Propósito: Ejeção de documento na impressora
Sintaxe: Printer.EndDoc
O método .EndDoc é chamado para sinalizar o término do documento interno do
aplicativo e para enviar o sinal de ejeção da última página para o Print Manager do
Windows. A propriedade .Page do documento interno do aplicativo é automaticamente
redefinida como 1.
.GetData( )
Propósito: Aquisição de dados do clipboard
Sintaxe: Objeto.Picture = clipboard.GetData (formato%)
O método .GetData atua como uma função ao retornar o conteúdo .Image ou .Picture
do clipboard do sistema e atribuir esse conteúdo como propriedade .Picture do Objeto
especificado. Se formato% for declarado como formato de dados 2,3 ou 8, o conteúdo
do clipboard será atribuído à propriedade .Picture, independente desses dados terem
sido criados como dados de imagem.
18](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-18-320.jpg)
![.GetFormat( )
Propósito: Aquisição de tipo conteúdo do clipboard
Sintaxe: booleano% = Clipboard.GetFormat (formato%)
O método .GetFormat atua como um função ao retornar na variável inteira booleano%
um valor verdadeiro/falso que indica se os dados residindo atualmente no clipboard do
sistema são do formato% especificado.
.GetText( )
Propósito: Aquisição de texto do clipboard
Sintaxe: string$ = Clipboard.GetText (formato%)
O método .GetText atua como uma função, retornando o atual conteúdo textual de
clipboard do sistema dentro de string$. Se formato% for especificado como tipo 1 ou
&HBF00 (vínculo dinâmico), o conteúdo do clipboard será retornado em string$, quer o
formato seja ou não próprio para esse conteúdo.
.Hide
Propósito: Suspensão de operação de formulário
Sintaxe: [nomeform.].Hide
O método .Hide pega um formulário sendo mostrado e o remove da tela até ordem
contrária. O formulário continua a ocupar virtualmente as mesma coordenadas na tela.
Os controles do formulário oculto podem ainda ser referidos no código-fonte. Em
outras palavras, a operação do formulário pelo programa não é suspensa, mas o
usuário não pode operá-lo.
.Line
Propósito: Plotagem de linha geométrica
Sintaxe: [Objeto.]Line [[Step] (twipx1!, twipy1!)] [Step] (twipx2!, twipy2!) [, cor&][,
B][F]
O método .Line define o valor de cor de uma série linear de todos os twips
endereçáveis na memória, se estendendo das coordenadas (twipx1!, twipy1!) até
(twipx2!, twipy2!). Os dois pares de coordenadas são sempre separados por um hífen.
O valor de cor para cada twip da série é definido, independente de ser ou não visível
no presente. Se algum dos twips ou todos eles estiverem invisíveis ou obstruídos por
algum outro objeto gráfico, seus valores de cor serão definidos mesmo assim, e da
modificação (se houver) será refletida na tela quando esses twips forem tornados
visíveis.
Se Objeto. for especificado, o método definirá os valores twip com relação às
coordenadas do objeto especificado. Caso contrário, o sistema de coordenadas do
formulário que contém o método será assumido. A forma que a linha torna é
retornável através das propriedades .DrawStyle e .DrawWidht, onde .DrawStyle
representa o tipo de interrupção usada na linha (se houver) e .DrawWidth 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 não pode ser omitido. O hífen, contudo, permanece na instrução do
método. O último ponto plotado em um objeto gráfico pode ser obtido através das
propriedades .CurrentX e .CurrentY desse objeto. Se nenhum ponto tiver sido plotado
nesse objeto, as coordenadas iniciais (0,0) serão assumidas.
.Move
Propósito: Reposicionamento manual de controle
Sintaxe: Controle.Move esquerda[,topo%[, largura%[, altura%]]]
19](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-19-320.jpg)
![O método .Move move o controle designado em um formulário para a posição em
coordenadas desse formulário especificada pelos parâmetros esquerda% e topo%.
Somente o parâmetro esquerda% precisa ser especificado para mover o controle
horizontalmente para a nova posição de tips esquerda%. Se topo% for especificado, o
controle será movido verticalmente também. Se largura% ou altura% forem
especificadas, o controle será redimensionado depois de ser movido.
.NewPage
Propósito: Sinal de ejeção de página na impressora
Sintaxe: Printer.NewPage
O método .NewPage é chamado para ejetar a página sendo impressa. Esse sinal de
ejeção é guardado dentro do Print Manager do Windows até ele despachar esse sinal
para a impressora no momento oportuno. A propriedade .Page do documento interno
do aplicativo é automaticamente incrementada.
Para declarar que o final de um documento foi atingido, o método .EndDoc é chamado.
.Point
Propósito: Aquisição de valor de cor
Sintaxe: cor& = [Objeto.]Point(twipx!,twipy!)
O método .Point atua como uma função ao retornar no inteiro longo cor& o valor de
cor RGB do pixel mais próximo das coordenadas de twip especificadas. No entanto, o
método é especificado pelo uso de sintaxe orientada para objeto. Se Objeto. for
incluído na instrução, o sistema de coordenadas do objeto especificado será usado.
Caso contrário, o sistema do formulário que atualmente contém a instrução será
assumido.
.Print
Propósito: Exibição de texto
Sintaxe: [objeto.]Print {expressao1{;|,} expressao2{;|,} ... expressaon{,|,}] na qual
cada expressão consiste em qualquer expressão matemática ou de string logicamente
interpretável.
O método .Print exibe a forma logicamente reduzida de cada expressão da lista de
expressões. Se objeto. for especificado, o destinatário do texto impresso será o objeto
gráfico declarado, tal como Form1, ou um dispositivo de saída, tal como Printer. Se o
interpretador permite que objeto. seja omitido, a impressão é direcionada para a
janela do formulário ao qual pertence a procedure que contém o método .Print aparece
no contexto de um módulo geral. Se o destinatário objeto. pertencer a um formulário
que não o que contém o método .Print, o nome do formulário será especificado antes
do nome do objeto, com ambos os nomes separados um do outro por um ponto.
Uma expressão matemática - no caso de uma expressão fornecida como um parâmetro
- é composta de um ou mais valores ou variáveis combinados aritmeticamente pelo
uso de símbolos operadores como + ou termos de função como Int( ). Uma expressão
string é composta de um ou mais elementos de texto, sejam eles frases alfanuméricas,
variáveis string, ou funções string tais como Right$( ). Expressões string de múltiplos
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 próprias aspas usando a função Chr$(34), com a função aparecendo fora
de quisquier aspas. Da mesma forma, você pode expressar outros caracteres especiais
que não aparecem no teclado usando a função Chr$( ).
O ponto-e-vírgula e a vírgula como delimitadores têm usos específicos com respeito ao
método .Print. Cada expressão da lista é separada das outras por um desses
delimitadores. Se duas expressões são separadas uma da outra por um ponto-e-
20](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-20-320.jpg)
![vírugla, o texto de ambas as expressões é impresso um ao lado do outro (juntos lado a
lado). Se duas expressões são separadas uma da outra por uma vírgula, o
interpretador insere um caractere de tabulação no final da primeira expressão antes de
imprimir o início da segunda. Uma tabulação é equivalente a 14 colunas ou, usando
emprestado um termo da tipografia, 14 enes, onde um ene é a largura média de uma
letra na fonte atualmente escolhida.
O interpretador do Visual Basic reconhece um cursor virtual par os objetos gráficos que
recebem texto usando o método .Print. A posição em coordenadas desse cursor é
registrada dentro de propriedades do objeto gráfico, chamadas .CurrentX e .CurrentY.
Sempre que um método .print completa sua execução, ele deixa por default o cursor
virtual no início ( por default, no lado esquerdo) da linha imediatamente seguinte à que
acabou de ser impressa. Se o método .Print é fechado com um ponto-e-vírgula, a
posição do cursor é definida no final imediato do texto que acabou de ser impresso,
sem que o interpretador execute um retorno de carro para a próxima linha. Se o
método .Print é fechado com uma vírgula, o cursor é tabulado para a próxima parada
de 14 colunas e permanece lásem que o interpretador execute um avanço de linha
para a próxima linha.
Se o método .Print aparecer em uma linha por si só, um retorno de carro com um
avanço de linha será gerado. Em outras palavras, a "cabeça de impressão" é movida
para a extremidade esquerda pelo retorno de carro e uma linha para baixo pelo avanço
de linha - com o que acontece quando você pressiona a tecla Return em uma máquina
de escrever elétrica. A posição do cursor virtual é ajustada para o início da próxima
linha abaixo da anteriormente impressa.
.Pset
Propósito: Definição de valor de cor de pixel
Sintaxe: [Objeto.]PSet [Step] (twipx!, twipy!) [, cor&]
O método .PSet define o valor de cor de um ponto de coordenada representado pelas
coordenadas (twipx!, twipy!). Se o ponto estiver atualmente visível 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 não estiver visível na tela, o ponto na memória será
definido de qualquer modo, e a mudança (se houver) será refletida na tela quando
esse ponto for tornado visível.
Se Objeto. for especificado, o método definirá o valor do ponto com relação às
coordenadas do objeto especificado. Caso contrário, o sistema de coordenadas do
formulário que contém o método será assumido. Se cor& for especificada, o método
.PSet definirá o valor de cor do ponto com qualquer valor inteiro longo no intervalo de
0 a 16.777.215, representando uma cor ou padrão de cores reconhecido pelo Microsoft
Windows. O valor de cor& pode ser representado pela função RGB( ) ou QBCoor( ).
Para redefinir um ponto - poara dar-lhe o valor da cor de fundo - o termo de
propriedade .BackColor pode ser usado como cor&. Se cor& não for especificada, o
método .PSet definirá o valor de cor do ponto como o valor da propriedade .ForeColor
do objeto especificado.
Quando Step está no método, o interpretador VB considera o sistema de coordenadas
expresso em (twipx!, twipy!) como sendo relativo ao último ponto plotado, ou em
relação a (0,0) se nenhum ponto tiver sido plotado. O último ponto plotado em um
objeto gráfico pode ser obtido através das propriedades .CurentX e CurrentY desse
objeto.
A largura e a altura do ponto sendo plotado com .PSet podem ser definidas
previamente com a propriedade .DrawWidth do objeto que recebe o ponto. O ponto
pode ser plotado como um ponto invisível - existente embora não visto - pela definição
da propriedade .DrawStyle do objeto como 5.
21](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-21-320.jpg)
![.Refresh
Propósito: Atualização forçada do conteúdo de um objeto
Sintaxe: Objeto.Refresh
O método .Refresh diz ao interpretador para suspender temporariamente os processos
matemáticos, por tempo suficiente para que ele atualize o conteúdo do Objeto
especificado. Esse conteúdo pode ter sido destinatário de instruções gráficas ou de
alteração de texto, mas o interpretador pode ter deixado de lado a execução dessas
instruções para poupar tempo. Se o objeto especificado não tem pendentes tais
atualizações, nada acontece.
.RemoveItem
Propósito: Manutenção de entradas na lista
Sintaxe: Caixalist.RemoveItem indice%
O método .RemoveItem elemina da caixa de listagem ou de combinação especificada o
item endereçado por indice%. O método só pode remover itens de uma caixa de
listagem individualmente, e não em grupos ou matrizes.
.Scale
Propósito: Estabelecimento de sistema de coordenadas variável
Sintaxe: [Objeto.]Scale [(origx!, origy!) - (extx!, exty!)]
O método .Scale define o par de coordenadas do canto superior esquerdo do objeto
antecedente como (orgx!, origy!) e par de coordenadas do canto inferior direito do
objeto como (extx!, exty!). Se ambos os pares de coordenadas forem omitidos, a
escala do objeto será redefinida para a escala default de coordenadas de twips.
.SetData
Propósito: Colocação de dados no clipboard
Sintaxe: Clipboard.SetData Objeto.{Image | Picture} [, formato%]
O método .SetData atribui ao clipboard do sistema o .Picture (mapa de bits no
formulário) ou .Image (mapa de bits na memória) referido usando sintaxe orientada
para objeto. Por default, a imagem é assumida como sendo um mapa de bits padrão
do formato de dados 2; entretanto, os formatos 3 e 8 também são suportados.
.SetFocus
Propósito: Definição do indicador manual
Sintaxe: [Controle.]SetFocus
O método .SetFocus aponta manualmente o controle antecedente como sendo o
controle ativo, dando-lhe portanto o foco.
Para o interpretador VB, é inteiramente "legal" para um formulário receber o foco. Em
interpretações anteriores do paradigma focus, o controle que tinha o foco era mantido
pelo formulário que tinha o foco.
No Visual Basic, é oferecida uma alternativa para esse dualismo. Agora, o formulário
que tem o foco reside dentro do formulário ativo. Esse formulário é então dito como
sendo ativado ou desativado pelo usuário. Ambas essas ações podem ser registradas
como eventos, e são atribuidas ao formulário.
.SetText
Propósito: Colocação de texto no clipboard
Sintaxe: Clipboard.SetText string$[, formato%]
O métodio .SetText coloca o texto atualmente referido como string$ no clipboard do
sistema. Por padrão, o texto é assumido como sendo do formato de dados 1, a menos
que especificado como &HBF00, situação na qual o texto é assumido como sendo parte
de uma operação de vínculo dinâmico.
22](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-22-320.jpg)
![.Show
Propósito: Exibição de formulário na área de trabalho
Sintaxe: [nomeform.]Show [estilo]
O método .Show exibe um formulário que se encontre em seu estado carregado,
embora não visível. Se o formulário não tiver sido carregado ainda na área de
trabalho, ele será carregado automaticamente, e o procedimento de evento Sub Form
Load( ) desse formulário, se houver, será disparado. Se o nomeform for omitido, o
formulário gráfico compartilhando o módulo atual com o procedimento atualmente em
execução será mostrado. O valor estilo opcional, quando definido como 1 (0 é o
padrão) torna modal o formulário exibido - em outras palavras, nenhuma outra janela
pode aceitar entrada do usuário até que se saia deste formulário.
.TextHeight e .TextWidth
Propósito: Aquisição de tamanho de texto
Sintaxe: valor%=[Objeto.]TextHeight(string$) | valor%=[Objeto.]TextWidht(string$)
Os métodos .TextHeight e .TextWidth são chamados como funções, exceto por serem
espressos com o uso de sintaxe orientada para objeto. Esses métodos retornam a
altura e largura, respectivamente, do texto expresso em string$ como ele apareceria
no Objeto especificado se impresso através do método .Print. Esses valores são
retornados no inteiro valor% como se os métodos fossem funções. Esses métodos só
funcionam com objetos de terminal virtual como caixa de figura ou formulários, ou o
dispositivo impressora. Se Objeto não for especificado, o formulário que contém a
procedure atualmente em execução será usado.
.ZOrder
Propósito: Designar a exposição na tela
Sintaxe: [Controle.]ZOrder posicao%
O método .ZOrder define a ordem de representação do Controle designado dentro de
seu formulário para a posicao% dada. Aqueles controles aos quais se deu uma posicao
% mais baixa são representados primeiro; auqeles com números seguintes são
representados depois. Se a área ocupada por um controle posterior na seqüência 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 estruturação estabelece
a ordem z natural dos controles em um formulário. Como .ZOrder é um método e não
uma propriedade ele só pode ser usado durante o tempo de execução de um aplicativo
para alterar a seqüência de exibição.
23](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-23-320.jpg)
![série de pontos no objeto. Essa propriedade pode levar qualquer dos valores
seguintes:
0 ____(Sólida, posicionada metade dentro, metade fora da área da caixa - o default)
1 ----(Traços)
2 ......(Pontos)
3 -.-.-(Traço-ponto)
4 _··_(traço-ponto-ponto)
5 (Invisível)
6 ____ (Sólida, embora inteiramente dentro da área da caixa)
.DrawWidth
Representação: Atribuição de largura de plotagem
Se aplica a: Formulário, figura, impressora
Definida por meio de: Janela Properties, instrução de programa
A propriedade .DrawWidth é definida como a largura, em pixels, de quaisquer linhas ou
pontos a serem plotados no objeto antecedente pelo uso de métodos gráficos.
.Drive
Representação: Dispositivo ativo
Se aplica a: Unidades de disco
Definida por meio de: Instrução de programa, interação com o usuário
A propriedade .Drive de uma caixa de listagem de unidades de disco é definida com o
texto de sua única entrada selecionada. A sintxe da definição de propriedade textual é
a seguinte: drive: [nome_volume]
O nome completo do volume atribuído ao dispositivo de unidade de disco quando
formatado pela última vez aparece entre colchetes após o identificador de dispositivo.
.Enabled
Representação: Status de operacionalidade do controle
Se aplica a: Todos os controles, menus, formulários
Definida por meio de: Janela Properties, janela Menu Design, instrução de programa
A propriedade .Enabled de um controle é definida como um valor True ou False que
designa se um controle responde a eventos do usuário. Por default, esse propriedade e
definida como True. Para desativar um controle mas permitir que ele permaneça
dentro de um formulário, ou para tornar cinza ua seleção dentro de um menu, você
define essa propriedade como False.
.ErrorCancel
Esta propriedade especifica se a variável Err deve ser definida se o usuário pressionar
o botão Cancel
Uma vez que uma caixa de diálogo comum esteja exibida, ela pode ser encerrada pelo
pressionamento tanto do botão OK como do botão Cancel. Se .ErrorCancel estiver
definida como True, Err será definida com o valor numérico 32755(CDERR_CANCEL).
Se .ErrorCancel estiver definida como False, a variável Err não será afetada.
.FileName
Esta propriedade contém o nome do arquivo selecionado. A propriedade .FileName
pode ser usada de duas maneiras. Primeiro, se definida antes da definição da
propriedade .Action (antes da caixa de diálogo ser exibida), ela especifica o nome de
arquivo inicial que é colocado na caixa de texto File Name. Segundo, quando o usuário
de seu programa sai da caixa de diálogo via botão OK, o nome do arquivo que o
usuário selecionou e colocado na propriedade.
34](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-34-320.jpg)
![A propriedade .Name de um objeto gráfico, ou uma matriz de objetos relacionados, é
definida com um nome arbitrário quando da estruturação. Essa propriedade se torna o
nome declarado à esquerda do ponto quando o objeto gráfico é endereçado dentro do
código-fonte do programa, usando sintaxe orientada para objeto.
Por default, o .Name de um formulário leva a sintaxe Formn, na qual n representa a
ordem na qual o formulário foi adicionado ao projeto. Quando da estruturação, ao ser
desenhado um controle no formulário, o interpretador dá a ele a sintaxe Controlen,
onde Controle siginifica o tipo de controle e n o número de acesso entre controle de
tipo similar, representando a ordem na qual esse controle foi adicionado ao formulário.
Você pode optar por deixar essas propriedades .Name como se encontram
inicialmente, ou usar a janela Properties; você pode optar por modificá-los para o que
lhe parecer mais apropriado.
.Page
Representação: Página atual da impressora
Se aplica a: Impressora
Definida por meio de: Curso da execução do programa
A propriedade Printer.Page é definida com o número de página atual mantido pelo
interpretador VB para um aplicativo. Cada vez que um aplicativo começa a ser
executado, a propriedade .Page é definida como 1. O interpretador assume que um
único documento está sendo criado para este aplicativo a qualquer dado instante. Cada
vez que uma página tem sua impressão terminada, a propriedade .Page é
incrementada.
.PasswordChar
Representação: Caractere de substituição de posição
Se aplica a: Texto
Definida por meio de: Janela Properties, instrução de programa
A propriedade .PasswordChar de uma caixa de texto é definida com um único caractere
alfanumérico 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 usuário
está digitando. Quando definida com um valor nulo, os caracteres são inseridos na
caixa de texto conforme suas teclas são pressionadas.
.Path
Representação: Caminho de diretório ativo
Se aplica a: Diretório, arquivo
Definida por meio de: Instrução de programa, interação com o usuário
A propriedade .Path de uma caixa de listagem de diretório é definida com o texto de
sua única entrada selecionada. A sintaxe deste texto é a seguinte:
drive:[diretorio[subdiretorio. . . ]]
O conteúdo textual da propriedade .Path reflete o caminho dos subsdiretórios onde um
arquivo reside ou onde uma procura de arquivo está sendo conduzida. O texto não
contém um nome de arquivo.
.Pattern
Representação: Padrão de procura atual
Se aplica a: Caixa de listagem de arquivos
Definida por meio de: Janela Properties, instrução de programa, interação com o
usuário
A propriedade .Pattern de uma caixa de listagem de arquivos é definida como o padrão
de procura atual com o qual cada arquivo dentro do diretório atualmente ativo é
comparado para determinar se esse arquivo deve ou não aparecer na lista. O efeito é a
41](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-41-320.jpg)
![A propriedade .WordWrap de uma etiqueta é definida como um valor True/False. Esse
valor reflete se é dada permissão para que o limite inferior do controle seja expandido
para se ajustar ao conteúdo atribuído à propriedade .Caption da etiqueta.
Instruções do Visual Basic
Beep
Propósito: Ativação de som interno.
Sintaxe: Beep
A instrução Beep faz soar um ruído do tipo bip. Essa instrução não leva parâmetros.
Call
Propósito: Desvio entre procedures
Sintaxe 1: Call nome_da_procedure ( [argumento1, argumento2, . . . ] )
Sintaxe 2: nome_da_procedure [argumento1, argumento2 . . . ]
Quando a instrução Call é processada, ou quando o nome de uma procedure definido é
invocado no código fonte, é feito um desvio para a procedure Sub assim chamada.
Quaisquer valores a serem passados para a procedure como argumentos são listados
ao lado de nome_da_procedure na ordem na qual eles devem ser recebidos pela
instrução de abertura da procedure Sub. Se são passados valores para a procedure
Sub, as variáveis correspondentes listadas na instrução de abertura da procedure Sub,
as variáveis correspondentes listadas na instrução de abertura da procedure recebem
seus valores. Quaisquer modificações feitas nos valores ou conteúdo dessas variáveis
ao longo do curso da procedure serão refletidas nas variáveis correspondetes da
chamada da procedure, a menos que especificado em contrário com ByVal.
Close
Propósito: Terminação de ponteiro de dados
Sintaxe: Close [#]canal1%[, canal2%, . . . canaln%]
A instrução Close termina o acesso aos arquivos de dados com nomes que foram
atribuídos pela instrução Open aos números de canal% listados. Quaisquer instruções
de leitura ou escrita após Close pertinentes aos números de canal declarados
imediatamente antes, dentro de Close geram erros. O acesso a arquivos usando esses
números só pode ser redeclarado pelo uso de uma instrução Open. Close cancela
qualquer associação entre os números declarados e os nomes de arquivos atribuídos a
eles pela instrução Open, portanto você pode usar novamente os números para outros
nomes de arquivo. Os sinais # são opcionais antes de cada número de canal. Se
nenhum número de canal for especificado, todos os canais abertos serão fechados.
Const
Propósito: Declaração de constantes
Sintaxe: [global] Const nome = expressao [, nome = expressao . . . ]
A instrução Const é usada para declarar o termo para representar um valor fixo (não
variável) para uso em expressões, O escopo de uma constante é determinado pela
posição de sua declaração no código-gfonte. Uma constante declarada dentro de uma
50](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-50-320.jpg)
![procedure Sub ou function terá escopo local. Uma constante declarada dentro de da
área geral de um módulo tem escopo modular. Uma constante declarada dentro de um
módulo geral pelo uso do termo global tem escopo global.
DefCur, DefDbl, DefInt, DefLng, DefSng, DefStr e DefVar
Propósito: Restrição de variáveis alfabéticas
Sintaxe:
DefCur intervalo[, intervalo[, intervalo. . . ] ]
DefDbl intervalo[, intervalo[, intervalo. . . ] ]
DefInt intervalo[, intervalo[, intervalo. . . ] ]
DefLng intervalo[, intervalo[, intervalo. . . ] ]
DefSng intervalo[, intervalo[, intervalo. . . ] ]
DefStr intervalo[, intervalo[, intervalo. . . ] ]
DefVar intervalo[, intervalo[, intervalo. . . ] ]
Cur Moeda
Dbl Ponto flutuante de precisão dupla
Int Inteiro padrão
Lng Inteiro longo
Sng Ponto flutuante de precisão simples
Str String alfanumérica
Var Variant
Dim
Propósito: Declaração de variável
Sintaxe 1 (simples): Dim variável ([inteiro])
Sintaxe 2 (complexa): Dim variavel ( [inteiro] ) [, variavel2 ( [ inteiro] ) . . .
variavel60 ( [ inteiro ] ) ] [ As [ New ] tipo]
Sintaxe 3 (complexa): Dim variavel1[(inteiro [to inteiro] [, inteiro [to inteiro]])] [As
[New] tipo] [, variavel2 [ ( [inteiro[To inteiro] [, inteiro [To inteiro] ] ) ] [As [New]
tipo] , . . . variavel60 [ ( [inteiro[To inteiro] [,inteiro [To inteiro] ] ) ] [As [New] tipo] ]
A declaração Dim determina pelo menos uma variável array como sendo uma lista ou
tabela de valores ou string que são endereçáveis por número. Esse número é um
inteiro, e é usado como um endereço para representar o lugar de um fragmento de
dados na lista. Esse número indicador é normalmente chamado de índice. Um array
unidimensional, vetor ou lista, é geralmente declarada pelo uso de um inteiro (ou
expressão inteira) entre os parênteses. 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
são separados pelo termo To.
Uma matriz bidimensional, ou tabela, é declarada pelo uso de dois inteiros entre cada
par de parênteses, separados por uma vírgula. Esses inteiros representam as
diferenças, ou eixos da tabela, como nos eixos x e y de um gráfico. Ambos os inteiro
representam os índices mais altos ao longo de seus respectivos eixos, a menos que o
termo To 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 três eixos, é declarada da
mesma forma usando três conjuntos de inteiros separados por vírgulas.
A menos que especificado em contrário, uma variável não tendo símbolo de tipo ou
qualificador tipo formal ao lado do termo As é dimensionada como uma variant, ou tipo
desconhecido. Uma vez que um valor ou conteúdo seja atribuído a essa variável, o
interpretador determina um tipo não oficial para a variável, embora seu tipo oficial
ainda seja uma Variant. Você pode estabelecer um tipo oficial formal para cada
variável na lista de dimensões seja pela anexação de um símbolo de tipo à variável ou
pela declaração do tipo como um termo opcional seguinte ao termo As.
51](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-51-320.jpg)
![A colocação da declaração Dim se restringe à seção de declarações gerais de um
módulo, ou para uma procedure. O escopo das declarações de variáveis pelo uso de
Dim pode ser modular se feitas na seção de declarações gerais, ou local se feitas
dentro de uma procedure. Você pode declarar até 60 variáveis usando uma única
declaração Dim.
DoEvents
Propósito: Mudança de prioridade os eventos
Sintaxe: [formulário%] = DoEvents[ ( ) ]
A intrução DoEvents suspende a execução da procedure atual. Isso permite que o
interpretador VB passe o controle para quaisquer procedures de evento que tenham
sido disparadas pelo usuário, e que estavam esperando para serem executadas na fila
de eventos. A instrução permite então que o Windows atualize todos os objetos
gráficos e passe o controle para outros aplicativos na área de trabalho do Windows
para quaisquer tarefas para as quais eles estivessem esperando no background.
DoEvents direciona a procedure atual para abrir caminho para qualquer outra coisa
que peça permissão de execução.
Quando usado em uma frase como uma função, DoEvents retorna na variável
formularios% um valor inteiro equivalente ao número de formulários atualmente
carregados na área de trabalho do aplicativo Visual Basic.
Você acabou de ler sobre o processo de execução geral de aplicativo Visual Basic.
Como esse processo já está definido para você pelo interpretador do Visual Basic, você
achará mais fácil estruturar um projeto com múltiplos módulos e procedures. A
princípio, porém, a curva de aprendizado para organização de módulos e procedures
em um projeto VB pode ser melhor descrita como uma inclinação íngreme.
Do [While | Until]...Loop [While | Until
Propósito: Demarcação de loop condicional/incondicional
Sintaxe 1:
Do [{While | Until} expressao]
bloco de instrucoes1
[Exit Do]
[bloco de instrucoes2]
...
Loop
Sintaxe 2:
Do
bloco de instrucoes1
[Exit Do]
[bloco de instrucoes2]
...
Loop [{While | Until} expressao]
A cláusula Do-Loop executa repetidamente o conjunto de instruções nela contido. A
execução desse conjunto pode ou não depender de uma expressão condicional
opcional. Se uma condição é expressa, a execução do conjunto pode ser terminada. Se
uma condição não é expressa, o loop é considerado infinito e só pode ser terminado
com uma instrução Exit Do.
Na Sintaxe 1, uma expressão condicional é feita no início da cláusula, seguindo Do. Se
essa expressão está precedida de While, a execução das instruções na cláusula ocorre
em seqüência, contanto que a expressão seja avaliada como True. Se a expressão está
preceduida por Until, a execução ocorre em seqüência contanto que a expressão eja
avaliada como False - em outras palavras, quando a expressão é True, a cláusula é
terminada. Se a expressão While é False ou a expressão Until é True, a execução pula
52](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-52-320.jpg)
![para a instrução seguinte a Loop. Se esta é a primeira iteração do loop e a execução
pula para Loop, as instruções da cláusula nunca serão executadas.
Sob a sintaxe 2, uma expressão condicional é feita no final da cláusula, em seguida
Loop. As regras que governam o uso de While e Until são as mesmas que na sintaxe 1.
Na sintaxe 2, a execução das instruções dentro da cláusula ocorre incondicionalmente
após a instrução Do. A expressão é avaliada quando se chega a Loop; se o loop tiver
que prosseguir, a execução pulará para a instrução seguinte a Do. Caso contrário, o
loop será terminado e a execução prosseguirá normalmente.
End
Propósito: Terminação de contexto
Sintaxe: End [ {Function | If | Seledct | Sub | Type}]
Quando chamada em uma linha própria, a instrução End termina o programa atual,
redefine todas as variáveis declaradas, e fecha todos os canais abertos para caminhos
de dados, arquivos de dados ou outros aplicativos Windows. Não há limite para o
número de declarações End não qualificadas que podem ser chamadas durante um
aplicativo. Quando usuada com um outro termo, a declaração especifica a porção de
fechamento de uma cláusula ou procedure. Só pode haver uma instrução End por
cláusula ou procedure.
Erase
Propósito: Atualização de arrays
Sintaxe: erase array [, array. . . ]
A instrução Erase limpa os valores e conteúdo de todos os arrays especificados na
declaração. Os parênteses não são usados na especificação. O comprimento de cada
array apagado, previamente declarada com Dim, não é afetado. O estado de todos os
arrays apagados é tal como o imediatamente seguinte à execução da declaração Dim
que originalmente as dimensionou.
Error
Propósito: Simulação de erro
Sintaxe: Error coderro%
Nessa sintaxe, coderro% é um valor inteiro que corresponde a um código de erro
válido. Você pode usar a variável Err interna como coderro%.
A instrução Error força o interpretador Visual Basic a atuar como se o erro especificado
por coderro% tivesse ocorrido. Essa instrução é particularmente útil para se testar a
aplicabilidade de rotinas de interceptação de erros.
Exit
Propósito: Aborto forçado de contexto
Sintaxe: Exit {Do | For | Function | Sub}
A instrução Exit pára imediatamente a procedure ou cláusula de loop atual. Em
cláusulas de loop, a execução do programa é retomada na instrução seguinte à
instrução de fechamento da cláusula. Em procedures Sub ou Function, a execução é
retomada na instrução seguinte à que fez a chamada a procedure. Se a procedure não
foi chamada por uma outra instrução, a execução é suspensa até a ocorrência de um
evento reconhecido de usuário.
For-Next
Propósito: Demarcação de um loop reiterativo
Sintaxe: For contador = valorini To valorfim [Step valorad]
bloco de instrucoes1
[Exit For]
53](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-53-320.jpg)
![[bloco de instrucoes2]
...
Next [contador]
A cláusula For-Next demarca um conjunto de instruções para ser executado repetidas
vezes. A princípio, a variável contador recebe um valor inicial especificado por valorini.
A execução da cláusula procede então em seqüência e pode ser terminada ao se
chegar à instrução Exit For.
Em Next contador, um valor, geralmente 1, é adicionado à variável 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 valorfim especificado no topo da
cláusula, a execução pula para a instrução imediatamente seguinte à linha For. Se
contador for maior que valorfim, o loop é terminado e a execução pàssa para a
instrução abaixo de Next contador. Se nenhuma cláusula For-Next existir nessa
cláusula For-Next maior, a especificação de contador depois do termo Next é opcional.
Function
Propósito: Inciação de procedure que retorna valor
Sintaxe:
[Static] [Private] Function nome_da_procedure ([ByVal] argumento1 [( )] [As tipo],
[ByVal] argumento2[( )] [As tipo]. . .])
bloco_de_instrucoes1
nome_do_procedure = expressao1
[Exit function]
[bloco_de_instrucoes2]
[nome_do_procedure = expressao2]
...
End Function
A instrução Function atua como cabeçalho para procedures que recebem argumentos
da mesma maneira que uma procedure Sub, mas que retornam um único valor ou
string. A instrução Function parece ter precisamente a mesma sintaxe que a instrução
Sub. Uma diferença importante entre as sintaxes das procedures Function e Sub é que
o nome_da_procedure de uma priocedure Function é tratado como uma variável na
procedure. Perto do final da procedure Function, uma expressão de interpretação
válida é atribuída a esse nome_da_procedure com uma equação. O valor dessa
expressão é a solução ou o resultado da função como ela foi declarada.
A sintaxe dos argumentos expressos dentro da instrução Function é a mesma que a
sintaxe dos argumentos dentro da instrução Sub. Normalmente, os valores dessas
variáveis que têm escopo local a procedure - ou que não tenham sido declaradas como
modulares ou globais fora da procedure - são tornadas nulas sempre ao sair da
procedure. O uso do termo Statis antes do termo Function muda o contexto da
procedure de local padrão para estático, permitindo que o interpretador mantenha os
valores e conteúdo das variáveis usadas pela procedure depois de sair dele. O uso do
termo Private antes do termo Function - se essa procedure Function aparecer dentro
de um módulo geral - muda o contexto da procedure de global para nível de módulo,
de modo que nenhum outro módulo pode fazeruma chamada a esta procedure. As
procedure de funções declaradas na seção geral de módulos de formulário recebem
automaticamente contexto de nível de módulo, e não requerem o qualificador Private.
Get #
Propósito: Recuperação d dados de um dispositivo
Sintaxe: get # canal%, [posicao&], varivael
A instrução Get # lê o conteúdo da variavel especificada a partir de um arquivo de
dados de acesso aleatório, aberto previamente com a instrução Open. . . As Random
54](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-54-320.jpg)
![ou Open. . . As binary, e cujo número de canal% tenha sido designado por essa
instrução Open. Você não pode substituir o termo variavel por uma expressão ou um
valor. Na instância da instrução Get #, você só poe declarar explicitamente uma única
variável, e não uma lista de variável.
Quando você estiver usando a técnica de acesso aleatório, se posicao& for
especificada, o conteúdo de variavel é assumido como devendo ser lido da posição de
elemento numerada como posicao& contando a partir do início do arquivo. Se a
posicao& for omitida e uma vírgula guardar o espaço vazio onde ela teria aparecido, a
leitura ocorrerá na posição sendo atualmente apontada pelo ponteiro do arquivo.
Depois de feita a leitura de um arquivo de acesso aleatório ou binário, o ponteiro do
arquivo registrará a posição imediatamente seguinte à leitura anterior. Se uma
instrução Get # lê de alguma posicao& no meio de uma arquivo já existente, portanto,
depois da leitura o apontador será incrementado para a próxima posição no meio
desse arquivo.
Se o valor de posicao& estiver aklém da posição onde quaisquer dados tenham sido
escritos no arquivo, qualquer valor lido a patir dessa posição não-existente será zero, e
qualquer string lida a partir dessa posição será nula. Contudo, é válido especificar uma
posicao& de armazenamento que seja muito que o número de elementos do arquivo.
Quando você está usando a técnica de acesso binário para carregar um valor na
memória, a instrução Get # lê exatamente tantos bytes do arquivo de acesso binário
quantos são usados para representar o valor da variavel especificada quando ele é
carregado na memória. Quando você está carregando uma string alfanumérica e
atribuindo seu conteúdo a uma variável de string na memória usando acesso binário, o
número de caracteres carregados na memória é exatamente o número de caracteres
atualmente pertencentes a essa variável de string. Em outras palavras, se o conteúdo
da variável de string ainda não foi atribuído e seu conteúdo oficial é nulo (string$ = "
"), uma instrução Get # não carrega quaisquer caracteres na variável de string
especificada.
Se a posicao& não for especificada, aleitura ocorrerá no próximo endereço ede byte na
seqüência.
Global
Propósito: Declaração de variável Global
Sintaxe: Global variavel1 [inteiro [To inteiro] [, inteiro [To inteiro] ] ) ] [As [New]
tipo], variavel2 [ (inteiro [To inteiro] [, inteiro [To inteiro] ] ) ] [As [New] tipo], . . .
variavel60 [ (inteiro[To inteiro] [, inteiro [To inteiro] ] ) ] [As tipo] ]
A declaração Global é usada para declarar todas as variáveis unitárias e array cujos
valores devam se aplicar ao código-fonte inteiro do programa. O escopo de todas as
variáveis declaradas pelo uso de Global é considerado global. Exceto pelo próprio
termo, a sintaxe de Global é a mesma que a sintaxe da declaração Dim. Global só pode
ser usada dentro de um módulo geral (que não de formulário), e especialmente dentro
de um que o programador tenha designado como módulo global.
GoSub
Propósito: Desvio temporário
Sintaxe: GoSub rotulo
Quando a instrução GoSub é executada, o interpretador desvia para a instrução
imediatamente seguinte ao rótulo especificado. Enquanto a instrução prossegue em
seqüência, o interpretador mantém registro da localização da instrução que efetuou o
desvio. Quando o interpretador executa a próxima instrução Return, ele desvia de
volta para a instrução imediatamente seguinte à chamada GoSub.
GoTo
55](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-55-320.jpg)
![Propósito: Desvio entre procedimentos
Sintaxe: GoTo rotulo
Quando é executada, a instrução GoTo faz com que o interpretador suspenda a
execução na linha de instrução atual, e a retome na instrução do mesmo procedimento
imediatamente após o rotulo especificado. O rótulo de instrução precisa aparecer em
uma linha própria e precisa estar seguido de dois pontos.
If... Then... [ElseIf... Then][Else... ]... End If
Propósito: Cláusula condicional
Sintaxe 1:
If expressao1 then
bloco de instrucoes1
[ElseIf expressao2 Then
bloco de instrucoes2
[Else
bloco de instrucoes]
End If
A declaração If-Then testa uma expressão matemática para ver se ela é verdadeira. Se
for, a execução continua com a primeira instrução dependente depois da expressão. Se
a expressão não for verdadeira, a execução pula para a primeira instrução fora do
ninho. Se essa instrução for Else, as instruções dependentes seguintes são executadas.
Se essa instrução for ElseIf, uma outra expressão matemática é avaliada da mesma
maneira que a primeira. A cláusula termina quando se chega a End If.
A seguir temos uma sintaxe mais resumida para a mesma declaração:
If expressao Then instrucao1 [Else instrucao2]
Esta sintaxe é usada para cláusulas de uma única instrução e pode ser escrita em uma
linha. Observe que não se inclui End If nessa sintaxe.
If-Then é a declaração de condição fundamental da linguagem de programação BASIC.
A declaração pode ser descrita como um mecanismo cujo gatilho é uma expressão
matemática. O resultado dessa expressão é um valor lógico Booleano em algum lugar
da memória, que pode ser interpretado como True ou False (-1 ou 0). Se a expressão
é verdadeira, o primeiro conjunto de instruções na cláusula é executado em seqüência.
Se houver um outro conjunto de instruções na cláusula If-Then seguindo o termo Else
ou ElseIf, ele será executado em seqüência se a expressão original ao lado do termo If
for falsa.
Input #
Propósito: Aquisição de dados do dispositivo
Sintaxe: Input #canal%, variavel1[, variavel2m, . . . variaveln]
A instrução Input # lê dados de um arquivo de dados textual cujo número canal%
tenha sido aberto previamente como Input pela instrução Open e cujo nome de
arquivo tenha sido especificado previamente dentro da instrução Open. O sinal # é
necessário para distinguir a instrução Input # da antiga instrução Input do BASIC,
embora essa declarção em particular não seja mais suportada pelo Visual Basic. Cada
elemento textual do arquivo é atribuído às variáveis da lista da instrução Input #, em
seqüência. Se a variável à qual está sendo atribuído um dado do arquivo for uma
variável numérica, o interpretador tentará converter automaticamente em um valor
numérico a string de texto associada a essa variável antes de atribuir a ela o valor.
Line Input #
Propósito: Transmissão de texto formatado de um dispositvo
Sintaxe: Line Input #canal%, string$
56](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-56-320.jpg)
![A instrução Line Input # lê uma linha de texto de um arquivo de acesso seqüência e a
armazena na memória dentro da variável string$. Uma linha de texto, nessa situação,
é definida como o fluxo contínuo 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 Width # não tiver sido usada para especificar a largura
de linha do arquivo de dados seqüênciais, você pode usar Line Input # para atribuir
todo o conteúdo de texto do arquivo de dados à variável de string string$.
Load
Propósito: Colocação de um bojeto na área de trabalho
Sintaxe: Load nomeobjeto
A instrução Load enredeça por nome um objeto gráfico pertencente ao aplicativo
atualmente em execução, carrega-o na memória e na área de trabalho sem exibi-lo e o
mantém suspenso até que seja executada uma instrução que force o objeto a ser
mostrado. Se o objeto for um formulário, essa instrução dispara o procedimento de
evento Sub Form_Load ( ) do formulário.
LSet e RSet
Propósito: Justificação de conteúdo
Sintaxe:
LSet campo$ = entrada$
RSet campo$ = entrada$
As intruções LSet e RSet atribuem o conteúdo textual já atribuído a entrada$ a uma
string cheia de espaços : campo$. O coprimento de campo$ não é modificado; em vez
disso, os espaços dentro de campo$ são substituídos pelo conteúdo de entrada$. A
instrução LSet dentro de campo, começando no caractere mais à esquerda de campo,
criando assim um campo justificado à esquerda. Da mesma forma, a declaração RSet
insere entrada$ dentro de campo$ começando pelo caractere mais à direita de
campo$, criando um campo justificado à direita. Se entrada$ contiver mais caracteres
que campo$, somente os caracteres mais à esquerda de entrada$ aparecerão em
campo$ para ambas as instruções. O comprimento de campo$ permanece o mesmo.
Mid$
Propósito: Inserção de um fragmento de string
Sintaxe: Mid$ (string$, pos:inic&[, numero&] ) = substring$
A instrução Mid$ substitui o texto atualmente atribuido a string$, começando na
posição atual do cursor pos_inic& contando a partir da esquerda, pelo texto contido em
substring$. Se numero& é expresso, esse número de caracteres é removido de string$
e substiuído pelos primeiro numero& caracteres a partir da esquerda de substring$
On Error [GoTo | Resume]
Propósito: Interceptação de erros dentro da procedure
Sintaxe: On [Local]Error {Goto rotulo|Resume Next|Goto 0}
A instrução de desvio On Error define uma interceptação de erros que, quando
chamada pela primeira vez dentro de um aplicativo, força a execução da procedure
atual para pular para um rótulo de linha especifição sempre que ocorrer um erro que
normalmente suspenderia o processo normal de execução. Contanto que o
procedimento continue a ser executada sem problema, o desvio para o rótulo tem
lugar imediatamente quando ocorre um erro.
A frase On Error GoTo 0 termina uma interceptação de erro e permite que o
intepretador Visual Basic suspenda novamente a execução no caso de um erro sério. A
frase On Error Resume Next permite que você diga ao interpretador para ignorar
57](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-57-320.jpg)
![quaisquer erros que possam ocorrer no caminho e retomar a execução na instrução
seguinte à que causou o erro.
A palavra-reservada Local é fornecida como uma opção para os usuários de outros
compiladores BASIC da Microsoft. Porém, sua ativação dentro de uma interceptação de
erros do Visual Basic não tem efeito, porque todas as interceptações de erros do Visual
Basic existem em nível local.
On...GoTo e On...GoSub
Propósito: Desvio de múltipla escolha
Sintaxe: On expressao GoTo rotulo0, rotulo1[, rotulo2, . . . rotulo255]
On expressao GoSub rotulo0, rotulo1[, rotulo2, . . . rotulo255]
A colocação de On expressao antes de uma instrução Goto ou GoSub converte essa
instrução em um desvio seqüêncial para um dos rótulos especificados na lista seguinte
à palavra reservada. O desvio depende do valor de expressao. Geralmente, a
expressao consiste de uma variável por si só. O valor reduzido logicamente de
expressao, quando arredondado para o inteiro mais próximo, precisa estar entre 0 e
255, inclusive. Esse valor é equivcalente à posição na lista do rótulo que será o destino
do desvio. Se a instrução que está fazendo o desvio é GoSub, o desvio será tratado
como uma chamada regular a uma sub-rotina; ao processar Return, a execução terá
lugar na instrução imediatamente seguinte à On. . . GoSub.
Open
Propósito: Iniciação de ponteiros de dados
Sintaxe: Open nomearq$ [For modo] [Access restricao] [tipotrava] As [#]canal%
[Len = cmprbyte%]
A instrução Open inicia um canal para a transferência de dados entre o interporetador
Visual Basic e um arquivo armazenado fisicamente. O nome de arquivo DOS desse
arquivo é especificado como nomearq$ e pode conter o caminho completo de
armazenamento do rquivo. O número de canal associado a esse arquivo é expresso
como canal% e pode ser qualquer inteiro entre 1 e 255. A escolha de números aqui é
completamente arbitrária; um canal de numeração menor não precisa ser aberto antes
de um número maior ser escolhido. Depois de você usar a instrução Open para atribuir
um número de canal a um nome de arquivo, qualquer instrução de transferência de
dados que se refira a esse número afeta o arquivo atribuído ao número pela instrução
Open. Um sinal # antes do número do canal é opcional para manter compatibilidade de
sintaxe com as versões anteriores do BASIC.
Option Base
Propósito: Predefinição default de array
Sintaxe: Option Base { 0 | 1 }
A declaração Option Base, usada dentro do módulo global ou área de declarações
gerais de um aplicativo, estabelece se o endereço incial de uma variável array deve ser
0 ou 1. Esse valor é especificado no inteiro que acompanha e não pode ser nenhum
outro. O valor de limite inferior default de variáveis array é 0.
Option Compare
Propósito: Restrições do processo de comparação de texto
Sintaxe: Optionn Compare {Binary | Text}
Você usa a instrução Option Compare dentro da seção de declaraçõe de um módulo
para especificar o tipo de comparação textual a ser usada pelas instruções dentro
desse módulo. A instrução Option Compare Binary compara caracters uns aos outros
pelo valor numérico; assim, a comparação é sensível a maiúsculas/minúsculas. A
instrução Option Compare Text, por outro lado, compara caracteres somente quanto
58](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-58-320.jpg)
![ao conteúdo textual; assim, a comparação não é sensível a maiúsculas/minúsculas.
Quando essa instrução é omitida, o interpretador usa comparações em modo binário.
Option Explicit
Propósito: Estipulação de declaração
Sintaxe: Option Explicit
A instrução Option Explicit, quando incluída na seção de declarações de um módulo,
coloca o interpretador em um modo no qual todas as variáveis incluídas no códigofonte tem que ser primeiro declaradas explicitamente, pelo uso da declaração Dim ou
Global.
Print #
Propósito: Transmissão de dados para dispositivo
Sintaxe: Print #canal%, expressao1{; | ,} expressao2] [. . . {; | , } expressaon]
Nessa sintaxe, cada expressao tanto pode ser reduzida logicamente para um valor
numérico ou expressa como uma concatenação alfanumérica de um ou mais elementos
de texto.
A instrução Print # imprime o texto dos valores ou conteúdo de cada expressão da lista
em um arquivo texto que atua como o arquivo de dados atribuído ao inteiro canal%.
Esse número de canal precisa ter sido aberto previamente com a instrução Open com
Output ou Append e atribuído a um nome de arquivo específico encontrado dentro da
instrução Open. Print # imprime texto em um aruivo com esse nome de arquivo. A
forma desse texto é exatamente como ele apareceria se você tivesse usado o método
.Print para imprimi-lo em um bojeto gráfico ou na impressora.
Se um ponto-e-vírgula aparece antes de uma expressão é impressa imediatamente no
arquivo, na posição atual do ponteiro de caractere - cancelando assim ualquer retorno
de carro ou avanço de linha antes da impressão começar. Se uma vírgula aparece
antes de uma expressão, a expressão é impressa no arquivo no início da próxima zona
de impressão. Como nenhuma fonte de texto é admitida para a impressão em um
arquivo em disco - porque você não está lidando com imagens ou aparência
especificamente - uma zona de impressão começa a cada 14 caracteres.
Para cada canal aberto, o interpretador mantém a posição de caractere atual dentro do
arquivo até ele ser fechado com a execução de uma instrução Close. Múltiplas
declarações Print # executadas em seqüência para o mesmo número de canal fazem
com que os seus resultados apareçam dentro do arquivo associado ao canal, na
mesma seqüência.
Put #
Propósito: Armazenamento de dados em dispositivo
Sintaxe: Put #canal%, [posicao&], variavel
A instrução Put # escreve o conteúdo da variavel especifica em um arquivo de dados
de acesso aleatório, aberto previamente com a declaração Open . . . As Random ou
Open. . . As Binary, e cujo número canal% seja designado por essa declaração Open.
Você não pode substituir o termo variavel por uma expressão ou valor. Na instância da
declaração Put #, somente uma variável pode ser declarada explicitamente. Você só
pode incluir uma variável; o interpretador VB não reconhece listas de variáveis para
essa instrução.
Quando você está usando a técnica de aesso aleatório, se posicao& é declarada, o
conteúdo de variável é assumido como sendo escrito na posição de elemtno de número
posicao& contada a partir do início do arquivo. Se já existir um elemento nessa
posição, ele será substituído pelo conteúdo de variavel. Se a posicao& não estiver
declarada, a vírgula que guarda o lugar onde ela deveria ter sido declarada precisa
permanecer para distinguir seu propósito nesta declaração daquele de variavel.
59](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-59-320.jpg)
![O intepretador Visual Basic mantém um ponteiro de arquivo para cada arquivo de
dados aberto com a instrução Open. Este ponteiro registra a posição onde o próximo
elemento de dados será escrito. Em acesso aleatório, 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 aleatório ou binário ocorre, o ponteiro de arquivo
registra a posição imediatamente no meio de um arquivo existente, depois da escrita o
ponteiro é incrementado para a próxima posição no meio desse arquivo. Em outras
palavras, a posição default do ponteiro de arquivo quando posicao& não está
especificada não é no final de um arquivo de acesso aleatório no Visual Basic.
Se o valor de posicao& estiver além do valor onde quaisquer dados tenham sido
escritos no arquivo, o conteúdo dos dados nas posições anteriores à posicao& pode ser
errôneo. Contudo, é valido especificar uma posicao& de armazenamento que seja
muito maior que o número de elemento do arquivo.
O comprimento de cada elemento em bytes armazenados é, por default, 128 btes.
Você pode reespecificar este comprimento com a porção Len = compr% da instrução
Open 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 aletório têm comprimentos
idênticos. Estes tantos bytes são ecritos no arquivo cada vez que Put # é executado,
independentemente do comprimento em bytes da variavel especificada. Uma string
alfanumérica não pode ser maior que o número de bytes no comprimento de campo
menos dois, considerando o quanto ocupa um valor descritor de string. Cada vez que
Put # é executado, o número de bytes no comprimento de campo é adicionado para
que o ponteiro mantenha a posição absoluta atual desse ponteiro.
Quando você está usando a técnica de acesso binário - quando você abre o arquivo de
dados usando Open. . . As Binary - o valor de posicao&, quando especificado,
repesenta o número de bytes absoluto dentro do arquivo aberto. Este número de bytes
atua como um endereço absoluto. Os elementos de um arquivo de acesso binário não
têm comprimentos iguais; a instrução Put #, portanto, escreve no arquivo de acesso
binário exatamente tantos bytes quantos são usados para armazenar a variavel
especificada na memória. Se posicao& não é especificada, a escrita ocorre no próximo
endereço de byte na seqüência.
Randomize
Propósito: Realimentação do gerador aleatório
Sintaxe: Randomize [ (semente%) ]
A instrução Randomize realimenta o gerador de números aleatórios de um aplicativo.
Em outras palavras, ele muda algumas das contantes do algoritmo de geração
aleatória para que uma seqüência diferente de números aleatórios possa ser gerada,
eliminando assim a possibilidade de números previsíveis. Se semente% é expressa
uma seqüência particular de números aleatórios referida por semente% é iniciada. Se
semente% é omitida, uma semente "aleatória" é iniciada, cujo valor escolhido se
baseia no estado atual do próprio gerador de números aleatórios.
ReDim
Propósito: Redeclaração de array dinâmico
Sintaxe 1 (simples): ReDim variavel (inteiro)
Sintaxe 2 (complexa): ReDim [Preserve] variavel1(intiro) [To inteiro] [, inteiro [To
inteiro]]) [As tipo] [, variavel2 [As tipo], . . .variavel60 (inteiro [To inteiro] [, inteiro
[To inteiro] ] ) [As tipo] ]
A declaração ReDim recoloca os arrays dinâmicos declarados para novos limites
mínimo e máximo, e pode ser usada para mudar o tipo de armazenamento de
variáveis declaradas. Ao fazer isso, todos os valores e conteúdo dos arrays dinâmicos
60](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-60-320.jpg)
![são apagados, a menos que a opção Preserve seja utilizada. Cada array dinâmico na
declaração ReDim precisa ter sido previamente declarada pela utilização de Dim
variavel( ) usando precisamente esta sintaxe, omitindo quaisquuer limites do array
entre os parênteses. Novos limites podem ser especificados a qualquer momento
usando ReDim. O conteúdo do array ficará limpo de quaisquer valores ou conteúdo
depois de ReDim ser executada, portanto ela também pode ser usada no lugar de
Erase para limpar ou atualizar uma matriz dinâmica.
Rem
Propósito: Permite que você coloque comentários textuais em seu código-fonte.
Sintaxe: {Rem | ' } [comentario]
Quando o intepretador encontra a instrução Rem em uma linha, ele ignora o conteúdo
restante dela e pula para a próxima linha. Essa instrução permite que você digite
qualquer coisa no código-fonte aleatoriamente, geralmente, para uso de comentários
para explicar seu código para a próxima pessoa que for examiná-lo. Você pode usar o
apóstrofo (') no lugar do termo Rem.
Reset
Propósito: Encerramento do processo de transferência de dados
Sintaxe: Reset
A declaração Reset encerra todos os processos de transferência de dados fazendo fluir
o conteúdo de todos os buffers de dados abertos para seus respectivos arquivos
abertos, e fechando todos os canais abertos sem que se tenha de invocar declarações
Close para esse canais.
Resume
Propósito: Terminação de rotina de interceptação de erros
Sintaxe: Resume { [0] | Next | rotulo}
A intrução Resume é reservada para ofinal de rotimnas de interceptação de erros
dentro de uma procedure. Chamada em uma linha própria ou acompanhada de um 0,
essa instrução envia a execução de volta para a declaração que causou o erro
interceptado. A instrução anteriormente errônea é então reexecutada paa ver se gera
o mesmo erros uma segunda vez.
A frase Resuma Next envia a execução de volta para a instrução imediatamente
seguinte à que causou o erro. A frase Resume rotulo envia a execução de volta para a
instrução imediatamente seguinte ao rótulo especificado.
Return
Propósito: Terminação de sub-rotina
Sintaxe: Return
Quando a instrução Return é processada, um desvio é feito para a instrução
imediatamente seguinte à instrução GoSub executada mais recentemente.
SavePicture
Propósito: Salvamento do conteúdo de imagem
Sintaxe: SavePictrure [Objeto.]propriedade, nomearq$
onde nomearq$ se refere a um arquivo com a extensão BMP (bitmap do Windows),
ICO (ícone padrão), ou WMF (meta-arquivo do Windows).
A instrução SavePicture salva em disco a .Picture ou .Image atualmente residindo no
Objeto caixa de figura designado, usando o nome de arquivo nomearq$ dado. O termo
propriedade é definido com a palavra Image ou com uma referencia direta ao Objeto e
sua propriedade .Picture. Se Image é especificado, então independente do nome de
arquivo ou extensão expressos, a imagem é salva como um arquivo bitmap do
61](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-61-320.jpg)
![Windows, ao qual é dada uma extensão BMP. Se Objeto.Picture for especificado, a
figura será salva em seu formato atual no controle, que pode ser um bitmap do
Windows, um ícone padrão ou um meta-arquivo.
Seek #
Propósito: Diretiva de posicionamento do ponteiro de dados
Sintaxe: Seek [#] canal%, posicao&
A instrução Seek # define a posição do ponteiro de um arquvio de dados na qual irá
ocorrer a próxima 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 declaração Open. O valor de posicao& pode ser especificado
como maior que o atual comprimento efetivo do arquivo. Em tais casos, o
interpretador gera valores nulos para todas as posições entre a posição final e a
posicao& declarada.
Em arquivos de acesso aleatório, o valor de posicao& é definido como o número do
elemento de dados onde uma variável será escrita quando Put # for ativada a seguir, o
número do elemento de dados de onde ela será lida quando Get # for ativada a seguir.
Em arquivos de acesso seqüêncial ou binário, o valor de posicao& é definido com o
endereço em bytes do próximo caractere a ser escrito ou lido no arquivo de dados. O
sinal # antes do número canal% é opcional.
Select Case... Case... End Select
Propósito: Cláusula condicional de múltipla escolha
Sintaxe: Select Case expressao
Case [Is] comparacao1a [To comparacao1b]
bloco de instrucoes1
[Case [Is] comparacao2a [To comparacao2b] ]
[bloco de instrucoes2]
...
[Case Else]
[bloco de Instrucoesn]
End Select
A instrução Select Case compara o valor ou conteúdo de texto de uma expressão inicial
com o valor de uma ou mais expressões à igualdade. A declaração contém várias
expressões de comparação quanto à igualdade, embora o elemento sendo comparado
só seja escrito uma vez como expressão inicial no começo da cláusula. essa expressão
incial pode consistir de uma variável ou até um número; entretanto, ela também pode
conter qualquer número de elementos que sejam especificados ou implícitos, e
combinados por operadores aritméticos.
Para cada comparação de igualdade, na eventualidade de (ou no caso de) uma das
comparações entre as expressões ser avaliada como True, o conjunto de instruções
após Case é executado. Quando o próximo Case ou End Select é atingido, a execução
pula para a instrução imediatamente seguinte à End Select.
Select Case dá ao programa uma maneira de interpretar opções.
SendKeys
Propósito: Imitação de pressionamento de tecla
Sintaxe: SendKeys texto$[, suspende%]
A instrução SendKeys envia para o sistema o texto contido em texto$, um caractere
após o outro, como se cada caractere de texto$ fosse digitado muito rapidamente no
teclao. O controle do formulário atual que tem o foco será o destinatário do texto. Se o
cursor está numa caixa de texto, o texto contido em texto$ aparecerá nessa caixa,
como se o usuário tivesse digitado esse texto manualmente. Se o valor -1 estiver
62](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-62-320.jpg)
![especificado para suspende%, a execução do aplicativo Visual Basic será suspensa até
que o Windows processe todas as teclas enviadas e o buffer do teclado fique vazio.
Set
Propósito: Estabelecimento de representação indireta
Sintaxe 1: Set varobjeto = [refpai!] refobjeto
Sintaxe 2: Set varobjeto = New nomeobjeto
A instrução Set, usando a sintaxe 1, atribui à variável de objeto varobjeto o objeto
gráfico existente declarado como refobjeto. A referència refobjeto para esse objeto
existente pode ser feita por meio da propriedade .Name desse objeto, ou por meio de
mais uma outra variável de objeto. Uma invocada, qualquer referência a varobjeto se
palica ao mesmo objeto gráfico que refobjeto. A variável de objeto varobjeto pode ser
definida posteriormente para se refereir a algum outro objeto gráfico, ou desvinculada
pela definição de sua referência a Nothing (nada). Qualquer variável de objeto referida
pela declaração Set precisa primeiro ter sido declarada formalmente usando a
declaração Dim, Global ou Static, como descrito no Capítulo 20, "A Janela Como
Documento".
Se o objeto pai de refobjeto não estiver atualemtne ativo (se ele não tem o foco em
nível de formulário), para atribuir a referência do objeto gráfico ao objeto pai particular
ao qual ele pertence, a referência de objeto refpai desse pai precisa ser declarada
primerio, seguida da referência de controle filho refobjeto. As duas referências são
separadas uma da outra por um ponto de exclamação.
Usando a sintaxe 2, a declaração Set atribui a variável de objeto varobjto a uma nova
instância de um objeto pré-estruturado cuja propriedade .Name tenha sido definida
como nomeobjeto quando em tempo de projeto. A chamada desta sintaxe da declara
Set torna existente esta nova instância New do objeto gráfico. O pai de nomeobjeto
precisa estar atualmente ativo, ou ter o foco em nível de formulário.
Static
Propósito: Declaração de variável local
Sintaxe: Static variavel1 [ionteiro [To inteiro] [, inteiro [To inteiro] ] ) ] [As tipo] [,
variavel2 [ (inteiro [To inteiro] [, inteiro [To inteiro] ] ) ] [As tipo], . . . variavel60
[ (inteiro[To inteiro] [, inteiro [To inteiro] ] ) ] [As tipo] ]
A instrução Static é usada no lugar de Dim para delarar todas as variáveis unitárias e
array de uma procedure que tenham valores que o interpretador deva manter depois
da delcaração End Sub ou End Funtion ser executada para essa procedure. Exceto pelo
termo principal, a sintaxe de Static é a mesma da declaração Dim dentro de uma
procedure. Ela não pode, porém, incluir o termo Shared.
Stop
Propósito: Suspensão do programa
Sintaxe: Stop
A instrução Stop suspende a execução do programa, provocando a mesma resposta do
interpretador como se o usuário tivesse selecionado Break a partir do menu Run do
Visual Basic. A janela Immediate (imeditata) do CLI se torna disponível depois de Stop
ser executada. A execução do programa é retomada em uma procedure ou rótulo de
linha especificado em uma instrução que o usuário deve veicular através do CLI.
Sub
Propósito: Inciação de porocedure que não retorn valor
Sintaxe: [Static][Private] Sub nome_da_procedure ([ [Byval] argumento1[ ( ) ]
bloco _de_instrucoes1
[Exit Sub]
63](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-63-320.jpg)
![[bloco_de_instrucoes2]
...
End Sub
Sub é principal instrução declarativa de procedure do vocabulário do Visual Basic. A
declaração é usada para conter uma procedure de um dado nome
nome_da_procedure. A execução pode ser desviada para essa instrução Sub de
qualquer ponto do programa se você chamar esse nome de procedure dentro do
código-fonte ou usar a instrução Call.
Diz-se que ua procedure Sub recebe valores da procedure que a chamou, como
argumentos ou parâmentros (os termos aqui são intercambiáveis). Quando uma
procedure é chamada de fora, os valores pertinentes a essa procedure são listados
entre parênteses, separado por vírgulas. Diz-se qu esse valores são passados para a
procedure, podendo ser escritos como numerais esplícitos ou representados por
variáveis. Quando um procedure é declarada dentro, esses valores são recebidos na
ordem na qual são passados, e são atribuídos a variáveis que têm nomes que podem
ser os mesmos usados na chamada de procedure. O conteúdo de variáveis de string
pode ser passado da mesma forma que valores de variáveis numéricas.
Se você deseja garantir que um tipo específico de argumento seja passado para a sua
procedure, um interio por exemplo, você pode colocar o termo As tipo ao lado desse
argumento. O conteúdo inteiro de um array pode ser passado para uma procedure
como um argumento, contanto que o nome da variável de array seja identificado com
parênteses vazios.
Normalmente, qualquer mudança feita nos valores dos argumentos listados é refletida
nas variáveis usadas como argumentos na chamada a procedure. Essa reflexão pode
ser contornada para um argumetno específico colcocando o termo ByVal antes desse
argumento; fazendo isso você permite que a variável usada na chamada a procedure
retenha seu valore mesmo que o valor da variável usada para receber o argumento
tenha sido modificado na procedure.
As instruções em uma procedure Sub são exzecutadas em seqüência. Uma procedure
Sub é terminada sempre que um Exit Sub ou End Sub é atingido durante essa
seqüência.
Os valores das variáveis com escopos que sejam locais a procedure, ou que não
tenham sido declaradas como modulares ou globais fora da procedure, são
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 conteúdo das
variáveis usadas pela procedure depois de sair dela. O uso do termo Private antes do
termo Sub, se essa procedure Sub aparece em um módulo geral, muda o contexto da
procedure de global para nível de módulo, para que nenhum oputro módulo possa
fazer uma chamada a esta procedure. Os proceimentos Sub declaradas em módulos de
formulário recebem automaticamente contexto de nível de módulo, e não requerem o
qualificador Private.
Type-End type
Propósito: Cláusula de declaração composta
Sintaxe: Type nome_do_tipo
variavel1[comprimento_array)] As tipo_existente [* comprimento_seg] [variavel2
[ ( comprimento_matriz) As tipo_existente [* comprimento_seq] ]
End Type
A cláusula Type-End Type é usada dentro do módulo global ou seção de declarações
gerais de um aplicativo para declarar tipos de variáveis compostas definidas pelo
programador para esse aplicativo. O nome_do_tipo da variável composta é definido
arbitrariamente pelo programador; entretanto, ele não pode ser uma palavra
64](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-64-320.jpg)
![reservada, um bnome de variável declarada ou um termo usado no programa para
qualquer outra finalidade.
Cada variável que irá compor a variável composta é listada dentro da cláusula. As
listas de variáveis aqui não contam como declarativas; essas variáveis precisam ser
declaradas em outro lugar do programa. A chamada de cada variável aqui é tida
somente como uma reserva de seu lugar dentro da variável composta sendo
declarada. O tipo de variável tipo existente incluído dentro do tuipo composto precisa
ser especificado com o termo As, e pode ser um tipo composto declarado previamente
dentro de uma cláusula anterior.
Se as strings estão sendo usadas dentro de uma variável composta, o programador
tem a opção de especificar o comprimento absoluto em caracteres de cada uma,
escrevendo esse comprimento ao lado do asterisco * seguinte à designação As String.
Fixar o comprimento das strings incluídas é necessário no uso de cláusulas Type para
salvar registros em um arquivo de dados baseado em disco.
Unload
Propósito: remoção do objeto da área de trabalho
Sintaxe: Unload nomeobjeto
A instrução Unload remove o formulário ou objeto gráfico carregado especificado da
área de trabalho bem como da memória. O objeto continua a existir como um
formulário no projeto e como um arquivo armazenado em disco se ele chegou a ser
armazenado. Essa instrução é necessária para um aplicativo Visual Basic compilado
porque os serviços do interpretador VB não irão "fechar" automanticamente cada
formulário uma vez que o programa compliado seja formalmente encerrado.
Width #
Propósito: Formatação de aruivo de dados textuais
Sintaxe: Width #canal%, colunas%
A instrução Width # defie a largura de "impressão" de um arquivo de acesso
seqüêncial cujo canal% esteja atualmente aberto por meio da instrução Open. A
definição é feita com um número especificado de colunas% de 0 a 255. Depois do
interpretador ter armazenado um número colunas% de caracteres em um arquivo
aberto, ele gera automaticamente um caractere retorno de carro e um caractere
avanço de linha. A "impressão" - ou armazenamento de entradas no arquivo - começa
então 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.
Write #
Propósito: Transmissão de texto para disco
Sintaxe: Write #canal%, expressao1[, expressao2 . . . , expressaon]
Nesta sintaxe, cada expressao pode tanto ser logicamente reduzida a um valor
numérico como ser um aconcatenação alfanumérica de um ou mais elementos de
texto.
A instrução Write # imprime o texto dos valores ou conteúdo de cada expressão da
lista em um arquivo texto que atua como o arquivo de dados atribuído ao interio canal
%. Esse número de canal precisa ter sido aberto previamente com a instrução Open
como Output ou Append e atribuído a um nome de arquivo específico encontrado
dentro da instrução Open. Write # 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 são
separados uns dos outros por vírgulas, e todas as strings alfanuméricas são colocadas
entre aspas. Vírgula e qualquer pontuação além das próprias aspas que devam
aparecer dentro de uma string são colocadas entre as aspas.
65](https://image.slidesharecdn.com/guiarpidodevisualbasic-131013144424-phpapp02/85/Guia-rapido-de-visual-basic-65-320.jpg)
Guia rápido de visual basic
- 1. Guia de Referencia do Visual Basic
- 2. Índice do Guia de Referencia do Visual Basic Funções do Visual Basic Abs( ): Aquisição de valor absoluto Asc( ): Aquisição do número de caractere ANSI. CCur( ), CDbl( ), CInt( ), CLng( ), CBng( ) e CVar( ): Conversão de conteúdo de variável Chr$( ): Aquisição de caractere ANSI CVDate( ): Conversão de variant para data DateSerial( ) e TimeSerial( ): Aritmética de data/hora DataValue( ) e TimeValue( ): Numeralização de data/hora Day ( ), WeekDay( ), Month( ) e Year( ): Representação de componentes de data EOF( ): Determinação do final do arquivo de dados Error$( ): Aquisição de descrição de erro. FileAttr( ): Aquisição de tipo de arquivo de dados Fix( ): Arredondamento numérico Format$( ): Conversão de valor para string FreeFile: Aquisição de canal livre Hex$( ): Tradução hexadecimal Hour( ), Minute( ) e Second( ): Representação de componenetes de tempo Input$( ): Aquisição de dados brutos InputBox$( ): Chamada de painel textual InStr( ): Procura de fragmento de string Int( ): Trucagem numérica IsDate( ): Determinação do formato de assinatura de tempo IsNumeric( ), IsEmpty( ) e IsNull( ): Determinação do conteúdo de uma variante LBound( ) e UBound( ): Aquisição dos limites de um array LCase$( ) e UCase$( ): Conversão de minúsculas e maiúsculas de string Left$( ) e Right$( ): Segmentação de string Len( ): Aquisição do comprimento de uma string LoadPicture( ): Aquisição de arquivo gráfico Loc( ): Retorna a posição do ponteiro de dados do arquivo LOF( ): Aquisição de comprimento de arquivo de dados Log( ) e Exp( ): Operações logarítmas LTrim$( ) e RTrim$( ): Remoção de espaços Mid$( ): Aquisição de parte de uma string Oct$: Conversão octal QBColor( ): Simulação de cores CGA RGB( ): Representação de valor de cor Rnd( ): Geração de número aleatório Seek( ): Aquisição da posição do ponteiro de dados Sgn( ): Aquisição do sinal do valor Sin( ), Cos( ), Tan( ) e Atn( ): Operações trigonométricas Space$( ): Ativação de múltiplos espaço Spc( ): Espaçamento do cursor de texto Sqr( ): Aquisição da raiz quadrada Str$( ): Conversão de valor para string String$( ): Ativação de múltiplos caracteres Tab( ): Tabulação do cursos de texto TypeOf: Determinação de tipo de controle Val( ): Conversão de string para valor 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 2
- 3. VarType( ): Aquisição do tipo de uma variante. 16 Métodos do Visual Basic .Additem: Manutenção de entradas de lista .Arrange: Regulação de filha MDI .Circle: Plotagem de elipse .Clear: Limpeza de uma caixa de listagem .Clear: Apagamento do conteúdo do clipboard .Cls: Limpeza de área de figura .Drag: Ativação do arraste manual .EndDoc: Ejeção de documento na impressora .GetData( ): Aquisição de dados do clipboard .GetFormat( ): Aquisição de tipo conteúdo do clipboard .GetText( ): Aquisição de texto do clipboard .Hide: Suspensão de operação de formulário .Line: Plotagem de linha geométrica .Move: Reposicionamento manual de controle .NewPage: Sinal de ejeção de página na impressora .Point: Aquisição de valor de cor .Print: Exibição de texto .Pset: Definição de valor de cor de pixel .Refresh: Atualização forçada do conteúdo de um objeto .RemoveItem: Manutenção de entradas na lista .Scale: Estabelecimento de sistema de coordenadas variável .SetData: Colocação de dados no clipboard .SetFocus: Definição do indicador manual .SetText: Colocação de texto no clipboard .Show: Exibição de formulário na área de trabalho .TextHeight e .TextWidth: Aquisição de tamanho de texto .ZOrder: Designar a exposição 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 formulário _Change: Alteração de status _Click: Indicação do usuário _DblClick: Indicação do usuário _DragDrop: Liberação de ícone arrastado _DragOver: Travessia do ícone arrastado _DropDown: Aparência do painel de lista subordinada _GotFocus e _LostFocus: Obtenção/perda do indicador de controle _keyDown e _KeyUp: Ativação ou liberação de tecla _KeyPress: Reconhecimento de caractere _MouseDown e _MouseUp: Ativação do botão do mouse _MouseMove: Movimento do apontador _Paint: Raquisição de imagem de reserva _PathChange: Alteração de caminho de diretório _PatternChange: Alteração de padrão de procura de arquivos _RowColChange: Movimento do ponteiro de célula _SelChange: Ativação de indicação de células _Timer: Passagem de intervalo 24 24 24 24 25 25 25 25 26 26 26 26 27 27 27 28 28 28 3
- 4. Propriedades do Visual Basic .Action: Especifica qual diálogo comum deve ser exibido .Align: Alinhamento automático de figura .AutoRedraw: Permissão de reserva de imagem BackColor e .ForeColor: Designação de cores sólidas .BackStyle: Estado de preenchimento sólido BorderColor: Cor de contorno .BorderStyle: Tipo de envoltório exibido .BorderStyle: Modo de tracejamento de linhas .BorderWidth: Extensão da marca em pixels .Caption: Conteúdo textual não editável .CellSelected: Status de indicação de ponteiro .Checked: Marcação de item de menu .Clip: Conteúdo coletivo das células indicadas .ColAlignment( ): Peso do conteúdo 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: Aceitação/rejeição de atribuição de tecla .DragIcon: Nome de arquivo do objeto de arrast .DragMode: Acessibilidade do apontador do controle .DrawStyle: Atribuição de tracejamento da plotagem .DrawWidth: Atribuição de largura de plotagem .Drive: Dispositivo ativo .Enabled: Status de operacionalidade do controle .ErrorCancel .FileName .FileName:Nome de arquivo escolhido .FillColor: Cor sólida de plotagem fechada .FillStyle: Atribuição de padrão de plotagem fechada .Filter .FixedAlignment( ): Peso do texto em células não-móveis .FixedRows, .FixedCols: Quantidade de células não-móveis .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 intermediárias .Height: Limite extremo inferior .HideSelection: Continuação de indicação de texto .HighLight: Permissão para colorir células indicadas .Icon: Símbolo de formulário minimizado .Image: Conteúdo gráfico .Index: Todos os controles de um array .Interval: Valor de ativação do timer .Left: Coordenada do eixo X .List( ): Conteúdo de entrada na lista .ListCount: Quantidade de entradas na lista .ListIndex: Localização da entrada escolhida .Max e .Min .Max e .Min: Extenção de intervalo de valores 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 4
- 5. .MaxButton: Inclusão de controle de maximizção .MDIChild: Designação de subordinação MDI .MinButton: Status de exibição do controle de minimização .MousePointer: Aparência do apontador .MultiLine: Capacidade de múltiplas linhas .MultiSelect: Capacidade de escolha de múltiplas entradas .Name: Todos os controles .Page: Página atual da impressora .PasswordChar: Caractere de substituição de posição .Path: Caminho de diretório ativo .Pattern: Padrão de procura atual .Picture: Fundo gráfico .Row, .Col: Localização de ponteiro de célula .RowHeight( ), .ColWidht( ): Tamanho de célula .Rows, .Cols: Extensão de células .ScaleLeft, .ScaleTop, .ScaleWidth e .ScaleHeight: Estabelecimento de coordenadas geométricas variáveis .ScaleMode: Escolha do sistema de coordenadas .ScrollBars: Permissão para anexação de barram de rolagem .Selected( ): Status de escolha de entrada da lista .SelLenght: Número de caracteres indicados .SelStart: Posição inicial da indicação de texto .SelStartRow, .SelEndRow, .SelStartCol e .SelEndCol: Cantos de bloco de seleção de células .SelText: Texto indicado .Shape: Identidade de elemento gráfico .SmallChange e .LargeChange: Intervalos de alteração de valor .Sorted: Status de ordenação da lista .Stretch: Permissão para redimensionar automaticamente o conteúdo .Style: Inclusão de caixa de texto .TabIndex: Ordenação de entrada de texto .TabStop: Particiàção na seqüência de teclado . Tag: Todos os controles padrão .Text: Conteúdo textual editável .Top: Coordenada do eixo Y .TopRow, .LeftCol: Primeira célula de dados visível .TwipsPerPixelX e .TwipsPerPixelY: Fator de conversão de escalas coordenadas .Value: Status dentro de um intervalo .Visible: Status de exibição de controle .Width: Limite extremo direito .WindowList: Status de listagem filha MDI .WindowState: Status operativo de janela .X1, .Y1, .X2, .Y2: Coordenadas geométricas Alinhamento: Peso do texto contido AutoSize: Permissão para economia de espaço Columns: Inclusão de coluna na lista FontName: Atributo de estilo de caractere FontSize: Atributo de tamanho de caractere WordWrap: Permissão para criação de espaço auxiliar 39 39 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 Instuções do Visual Basic Beep: Ativação de som interno. Call: Desvio entre procedures Close: Terminação de ponteiro de dados Const: Declaração de constantes 50 50 50 50 5
- 6. DefCur, DefDbl, DefInt, DefLng, DefSng, DefStr e DefVar: Restrição de variáveis alfabéticas Dim: Declaração de variável DoEvents: Mudança de prioridade os eventos Do [While | Until]...Loop [While | Until: Demarcação de loop condicional/incondicional End: Terminação de contexto Erase: Atualização de arrays Error: Simulação de erro Exit: Aborto forçado de contexto For-Next: Demarcação de um loop reiterativo Function: Inciação de procedure que retorna valor Get #: Recuperação d dados de um dispositivo Global: Declaração de variável Global GoSub: Desvio temporário GoTo: Desvio entre procedimentos If... Then... [ElseIf... Then][Else... ]... End If: Cláusula condicional Input #: Aquisição de dados do dispositivo Line Input #: Transmissão de texto formatado de um dispositvo Load: Colocação de um bojeto na área de trabalho LSet e RSet: Justificação de conteúdo Mid$: Inserção de um fragmento de string On Error [GoTo | Resume]: Interceptação de erros dentro da procedure On...GoTo e On...GoSub: Desvio de múltipla escolha Open: Iniciação de ponteiros de dados Option Base: Predefinição default de array Option Compare: Restrições do processo de comparação de texto Option Explicit: Estipulação de declaração Print #: Transmissão de dados para dispositivo Put #: Armazenamento de dados em dispositivo Randomize: Realimentação do gerador aleatório ReDim: Redeclaração de array dinâmico Rem: Permite que você coloque comentários textuais em seu código-fonte. Reset: Encerramento do processo de transferência de dados Resume: Terminação de rotina de interceptação de erros Return: Terminação de sub-rotina SavePicture: Salvamento do conteúdo de imagem Seek #: Diretiva de posicionamento do ponteiro de dados Select Case... Case... End Select: Cláusula condicional de múltipla escolha SendKeys: Imitação de pressionamento de tecla Set: Estabelecimento de representação indireta Static: Declaração de variável local Stop: Suspensão do programa Sub: Inciação de porocedure que não retorn valor Type-End type: Cláusula de declaração composta Unload: remoção do objeto da área de trabalho Width #: Formatação de aruivo de dados textuais Write #: Transmissão de texto para disco 50 51 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 6
- 7. Funções do Visual Basic Abs( ) Propósito: Aquisição de valor absoluto Sintaxe: solucao = Abs(expressao) A função Abs( ) retorna o valor absoluto de expressao, dentro da variável solucao. Esse valor é equivalente ao valor da expressão original, sem o sinal. Asc( ) Propósito: Aquisição do número 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 função Asc( ) obtém o valor do código ASCII (na realidade, ANSI) do caractere designado como char$. Esse valor é retornado dentro da variável solucao%. CCur( ), CDbl( ), CInt( ), CLng( ), CBng( ) e CVar( ) Propósito: Conversão de conteúdo de variável Sintaxe: solucao = Ctipo(expressao) Neste sintaxe, tipo é a abreviação do tipo de variável para o qual se está convertendo. As funções Ctipo resolvem o valor lógico reduzido de expressao e então convertem a expressão para o tipo de variável especificado, mesmo que esse tipo exija mais bytes que o necessário para representar o valor. O resultado precisa ser atribuído a uma variável tendo um tipo equivalente ao tipo para o qual se está convertendo. Chr$( ) Propósito: Aquisição de caractere ANSI Sintaxe: solucao$ = Chr$(expressao) Nesta sintaxe, a expressao pode ser simplificada logicamente como um valor de código ASCII legítimo. A função Chr$ ( ) aceita o valor de número inteiro de expressao e procura o caractere de código ASCII(ANSI) equivalente a esse valor. Esse caractere é retornado como o conteúdo de um só caractere de solucao$. CVDate( ) Propósito: Conversão de variant para data Sintaxe: assinatura = CVDate(valor#) A função CVDate( ) retorna um valor de data/hora convertido usando o parâmetro valor#, dentro da assinatura variant tipo7. O tipo de variável de valor# precisa ser um tipo numérico, embora possa ser qualquer tipo numérico. DateSerial( ) e TimeSerial( ) Propósito: Aritmética de data/hora Sintaxe: variant7 = dataSerial(ano, mes, dia) variant7 = TimeSerial(hora, minuto, segundo) A função DateSerial ( ) avalia os três parâmetros que recebe, reduz logicamente cada um deles em conjunto com os outros, e retorna uma data dentro de uma variável variant do tipo7 (data). Similarmente, TimeSerial( ) avalia os três parâmetros passados, os reduz logicamente comparando-os uns com os outros, e retorna uma 7
- 8. hora dentro de uma variável variant tipo7. Desta maneira, você pode determinar datas e horas relativas usando aritmética. DataValue( ) e TimeValue( ) Propósito: Numeralização de data/hora Sintaxe: variant7 = DateValue(Date$) variant7 = TimeValue(Time$) A função DateValue( ) aceita uma string de data validamente interpretável e a converte em uma data variant do tipo7. Esse conteúdo segue o formato de assinatura de tempo visível usado pela variável interna Now. Ele representa o número de dias que se passaram desde 30 de dezembro de 1899. Os formatos de data aceitáveis são ddmm-aaa, dd-mm-aa, dd/mm/aaaa e dd/mm/aa. A função TimeValue( ) converte uma string de temo validamente interpretável em uma hora variant do tipo7. O formato desse valor também segue o formato visível usado por Now. Day ( ), WeekDay( ), Month( ) e Year( ) Propósito: Representação de componentes de data Sintaxe: variavel% = Day(assinatura) variavel% = WeekDay(assinatura) variavel% = Month(assinatura) variavel% = Year(assinatura) Cada função deste conjunto aceita um valor de dupla precisão como seu parâmetro, com o formato dos números nesse valor coincidindo com o do formato da assinatura usado pela variável interna Now. A função Day( ) retorna o dia do mês da data especificada.Da mesma forma, Month( ) retorna o mês do ano, e Year( ) retorna o ano atual. Weekday( ) retorna o número do dia da semana, onde 1 é Domingo. EOF( ) Propósito: Determinação do final do arquivo de dados Sintaxe: variavel% = EOF(canal%) A função EOF( ) 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, EOF( ) 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, EOF( ) retorna False(0). A função só trabalha com arquivos que tenham um canal% aberto previamente com a declaração Open, e que sejam considerados atualmente abertos pelo intepretador. Error$( ) Propósito: Aquisição de descrição de erro. Sintaxe: String$ = Error$(coderro%) Nesta sintaxe, coderro% é um valor inteiro correspondente a um código de erro válido. Você pode usar a variável interna Err como coderro%. A função Error$( ) retorna uma string de texto que descreve o código de erro passado a função, dentro da variável de string String$. FileAttr( ) Propósito: Aquisição de tipo de arquivo de dados Sintaxe: definicao% = FileAttr(canal%, atributo%) 8
- 9. Quando atributo% é declarado como 1, a função FileAttr( ) retorna um valor que descreve o modo de acesso a arquivo de dados atribuído ao canal de dados especificado. Essa valor pode ser qualquer dos seguintes: 1 Input(entrada) seqüêncial 2 Output(saída) seqüêncial 4 Random(aleatório) 8 Append(anexação) seqüêncial 32 Binary(binário) Quando atributo% é declarado como 2, a função FileAttr( ) retorna um valor representando o gerenciador de arquivo ou número de acesso atribuído a ele pelo ambiente Microsoft Windows. Você pode usar esse gerenciador em conjunto com instruções para a API do Windows. Fix( ) Propósito: Arredondamento numérico Sintaxe: solucao% = Fix(expressao) A função Fix( ) remove qualquer valor fracionário do valor simplificado logicamente de expressao, deixando um número inteiro. Esse valor é retornado na variável solucao%. Format$( ) Propósito: Conversão de valor para string Sintaxe: string$ = Format$(valor[, {"tipoformato$" | descritor$}]) Nesta sintaxe, descritor$ é uma série de caracteres de diretivas e marcadores de posição escritos em até três grupos usando a seguinte sintaxe: descritorpos[; descritorneg[;descritorzero]] A função Format$( ) converte um valor numérico em uma string alfanumérica, da mesma forma que a função Str$( ). Se nenhum outro parâmetro for especificado, a função Format$( ) pára aqui; caso contrário, ela aplica um formato de aspecto a este valor. Esse formato pode ser um dos nomes de tipo gerais tipoformato$ reconhecidos pelo interpretador, ou poderá ser uma série de caracteres marcadores de posição descritor$ tiver que ser declarado dentro da função, ele terá que aparecer entre aspas; caso contrário, você pode atribuir antecipadamente o descritor a uma variável string usando uma equação. FreeFile Propósito: Aquisição de canal livre Sintaxe: canal% = FreeFile A função FreeFile retorna o número de canal não aberto de valor mais baixo, na variável canal%. Você pode então usar essa variável em uma declaração Open que pode vir a seguir. A função FreeFile não requer parênteses. Hex$( ) Propósito: Tradução hexadecimal Sintaxe: solucao$ = Hex$(exp_numerica) A função Hex$( ) descobre o valor não fracionário de exp_numerica, arredonda esse número para menos até o inteiro mais próximo, e encontra o valor hexadecimal (base 16) do número. Esse número é retornado como uma string, especialmente porque ele pode conter os dígitos de A a F (10 a 15). Hour( ), Minute( ) e Second( Propósito: Representação de componenetes de tempo Sintaxe: variavel% = Hour(assinatura) 9
- 10. variavel% = Minute(assinatura) variavel% = Second(assinatura) Cada função deste conjunto aceita um valor de dupla precisão como seu parâmetro, com o formato dos números desse valor coincidindo com o formato de assinatura usado pela variável interna Now. A função Hour( ) retorna a hora do tempo especificado em formato de 24 horas. Similarmente, Minute( ) retorna o minuto do tempo especificado, e Second( ) retorna o segundo desse tempo. Input$( ) Propósito: Aquisição de dados brutos Sintaxe: sequencia$ = Input$(numcarac$, [#]canal%) A função Input$( ) é usada na aquisição de dados brutos de um arquivo, cujos elementos de dados, se existirem, não possam ser distinguidos uns dos outros de nenhuma maneira que o Visual Basic imediatamente reconheça. Depois dos dados serem adquiridos, fica por conta do aplicativo VB fazer sua interpretação e encontrar uma finalidade para eles. A função recupera um número numcarac% de caractres alfanuméricos de um arquivo de dados que tenha um número de canal% a ele alocado pela declaração Open para Input seqüêncial ou acesso Binary. Ela move o ponteiro de arquivo atual para o byte seguinte ao último lido por Input$( ). A função recupera a string e a atribui à variável de string string$. Cada byte da string recebida é tratado como um caractere alfanumérico que pode ser convertido em um valor entre 0 e 255 com a função Asc( ). Essa função não está disponível para arquivos abertos para acesso Random. O sinal # antes de canal% é opcional nessa função. InputBox$( ) Propósito: Chamada de painel textual Sintaxe: resposta$ = InputBox[$] (mensagem$[, titulo$[, default$[, coordx%, coordy %]]]) A função InputBox$( ) usa a mensagem em mensagem$ como um pedido para que uma resposta textual seja inserida pelo usuário em uma linha de texto aparecendo no painel de diálogo. O conteúdo dessa inha está limitado a um máximo de 31 caracteres, que pode ser definido antecipadamente pela expressão de default$. O título do painel de entrada pode opcionalmente ser expresso como titulo$; se o título não estiver expresso, a barra de título 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%, coordy%. Uma caixa de entrada sempre contém dois botões: OK e Cancel. Se o usuário clica em Cancel, o conteúdo de resposta$ permanece como uma string nula. Se o usuário clica em OK, o conteúdo da linha de texto é retornado como resposta$. InStr( ) Propósito: Procura de fragmento de string Sintaxe: posicao& = InStr([primeiro_carac&, ]exp_string1$, exp_string2$[, compara %]) A função InStr( ) incia uma procura pela string ou concatenação de strings expressa por exp_string2$, dentro da string maior exp_string2$. O comprimento de exp_strin2$ precisa ser menor que 65.536 caracteres. Se a procura resulta em uma coincidência, o número do caractere da string maior onde o primeiro caractere da string menor aparece é retornado na variável de inteiro longo posicao&. O primeiro caractere da string maior é considerado o caractere número 1. Se a string menor não aparecer 10
- 11. exatamente dentro da string maior, ou se exp_string2$ for maior que exp_string1$, a função retornará uma valor nulo (0). Int( ) Propósito: Trucagem numérica Sintaxe: solucao% = Int(expressao) A função Int( ) arredonda o valor simplificado logicamente de expressao para menos até o número inteiro mais próximo. O resultado desse arredondamento é retornado na variável solucao%. IsDate( ) Propósito: Determinação do formato de assinatura de tempo Sintaxe: booleano% = IsDate(parametro) A função IsDate( ) retorna uma valor True/False na variável booleano%, refletindo se o parâmetro especificado pode ser interpretado legalmente como uma data VarType 7. Uma string ou valor com tal formato pode ser atribuída diretamente a uma variável não-declarada, e o interpretador responde dando a esta o tipo 7 de variant automaticamente. Nessa situação, parâmetro pode tanto ser um valor numérico como uma string; a função é incapaz de gerar erros com base neste tipo de parâmetro. Valores numerais diretos, porém, muito provavelmente retonarão um valor False. IsNumeric( ), IsEmpty( ) e IsNull( ) Propósito: Determinação do conteúdo de uma variante Sintaxe: booleano% = IsNumeric(variant) booleano% = IsEmpty(variant) booleano% = IsNull(variant) LBound( ) e UBound( ) Propósito: Aquisição dos limites de um array Sintaxe: variavel% =LBound(array[, dimensao]) | variavel% =UBound(array[, dimensao]) As funções LBound( ) e UBound( ) retornam os limites inferior e superior, respectivamente, do array especificado. Se a matriz for multidimensional, para retornar os limites de um nível de dimensão, o número desse nível é especificado como um segundo parâmetro da função. O nome de cada array é declarada sem parênteses. LCase$( ) e UCase$( ) Propósito: Conversão de minúsculas e maiúsculas de string Sintaxe: string$ = LCase$(exp_string$) string$ = UCase$(exp_string$) A função LCase$( ) converte em letras minúsculas todos os caracteres alfabéticos que aparecem dentro da string ou concatenação de strings expressa exp_string$. De modo similar, a função UCase$( ) converte em letras maiúsculas todos os caracteres alfabéticos aparecendo dentro da string ou concatenação de strings expressa exp_string$. Left$( ) e Right$( ) Propósito: Segmentação de string Sintaxe: substring$ = Left$(string$, numero%) substring$ = Right$(string$, numero%) 11
- 12. A função Left( ) extrai seqüêncialmente os primeiros caracteres numero% da string maior string$ e os atribui como conteúdo da variável de string menor substring$. Da mesma forma, a função Right$( ) extrai seqüêncialmente os últimos caracteres numero% da string maior string$ e atribui esses caracteres à variável de string menor substring$. Em ambas as funções, se numero% for maior que o comprimento de string$, toda a string será retornada em substring$ sem quaisquer caracteres adicionados a qualquer lado da string. Len( ) Propósito: Aquisição do comprimento de uma string Sintaxe: valor% = Len(exp_string$) Nessa sintaxe, exp_string$ é qualquer expressão que reúna uma ou mais strings de texto alfanumérico. A função Len( ) retorna o número de caracteres armazenados dentro da string expressa, na variável numérica valor%. LoadPicture( ) Propósito: Aquisição de arquivo gráfico Sintaxe: [TermVirt.]Picture = LoadPicture("nomearq$") Onde nomearq$ se refere a um arquivo com a extensão BMP (bitmap do Windows), ICO(ícone padrão), ou WMF (meta-arquivo do windows). A função LoadPicture( ) carrega o arquivo de imagem especificado no controle terminal virtual designado por TermVirt. Loc( ) Propósito: Retorna a posição do ponteiro de dados do arquivo Sintaxe: posicao& = Loc(canal%) A função Loc( ) retorna a posição do armazenamento ou recuperação anterior de um arquivo de dados aberto, cujo número canal% esteja especificado entre os parênteses. Em arquivos de acesso aleatório, a função Loc( ) retorna o número do elemento de dados ou registro anterior, onde 1 é igual ao número do primeiro elemento do arquivo. Em arquivo de acesso seqüêncial, Loc( ) retorna um valor arredondado equivalente à posição em bytes atual do ponteiro de dados - e não a posição do elemento ou registro - dividida por 128. Em arquivos de acesso binário, Loc( ) retorna a posição do byte previamente escrito ou lido no arquivo. O sinal # antes de canal% é omitido nessa função. LOF( ) Propósito: Aquisição de comprimento de arquivo de dados Sintaxe: compr% = LOF(canal%) A função LOF( ) retorna o comprimento em bytes do arquivo aberto cujo canal% aparece entre os parênteses. O sinal # antes de canal% é omitido nessa função. Log( ) e Exp( ) Propósito: Operações logarítmas Sintaxe: solucao = Log(expressao) solucao = Exp(expressao) A função Log( ) retorna o logaritmo natural do valor reduzido logicamente de expressao, dentro da variável solucao. Da mesma forma, a função Exp( ) retorna a base do logaritmo natural e elevada à potência do valor reduzido logicamente de expressao, dentro da variável solucao. 12
- 13. LTrim$( ) e RTrim$( ) Propósito: Remoção de espaços Sintaxe: string$ = LTrim$(exp_string$) string$ = RTrim(exp_string$) Nesta sintaxe, exp_string$ é qualquer expressão lógica contendo uma ou mais strings ou variáveis de string concatenadas. A função LTrim$( ) remove todos os espaços do lado esquerdo da string expressa. Da mesma forma, a função RTrim$( ) remove todos os espaços do lado direito da string expressa. Mid$( ) Propósito: Aquisição de parte de uma string Sintaxe: substring$ = Mid$(string$, pos_inic&, numero%) A função Mid$( ) extrai um numero% de caracteres de uma string em ordem qa partir da string maior string$, começando na posição de caractere pos_inic& contando a partir da esquerda de string$. Os caracteres extraídos são então atribuídos à variável de string menor substring$. Oct$ Propósito: Conversão octal Sintaxe: solucao$ = Oct$(exp_numerica) A função Oct$( ) descobre o valor não fracionário de exp_numerica, arredonda esse número para menos até o inteiro mais próximo, e encontra o valor octal (base 8) do número. Embora a solução só contenha dígitos de 0 a 7, ela é retornada dentro de uma variável de string solucao$. QBColor( ) Propósito: Simulação de cores CGA Sintaxe: cor& = QBColor(registro%) A função QBColor( ) retorna um valor inteiro longo que representa, para o Visual Basic, uma mistura de cores aproximadamente equivalente ao valor da cor registro% usado no Microsoft QuickBASIC para plotagem na tela CGA. O parâmetro registro% pode elevar qualquer dos valores da tabela 43.1. Nesta os valores são mostrados ao lado de seus equivalentes RGB( ) funcionais. RGB( ) Propósito: Representação de valor de cor Sintaxe: cor& = RGB(red%, green%, blue%) Onde red%(vermelho), green%(verde) e blue%(azul) são inteiros no intervalo de 0 a 255, representando a intensidade de cada cor primária na mistura. A função RGB( ) retorna um único valor inteiro longo que é uma combinação matemática dos três parâmetros de entrada e que representa, para o interpretador Visual Basic, um valor específico de mistura de cores. Cada parâmetros representa a quantidade de sua cor primária ótica usada na mistura. Quanto maior o valor do parâmetro, mais intensa a cor primária na mistura. Rnd( ) Propósito: Geração de número aleatório Sintaxe: numero# = Rnd[(processo#)] Nesta sintaxe, processo# é qualquer número de ponto-flutuante e precisão dupla, cujo sinal, quando processo# é expresso, é crucial para o processo de geração. 13
- 14. A função Rnd( ) retorna o que aparenta ser um número aleatório de ponto-flutuante e precisão dupla entre 0 e 1. O valor de processo# afeta o processo de geração do número aleatório. Um número "aleatório" particular é gerado para cada valor de processo# passado à função, se processo#<0. Uma seqüência particular de números aleatórios pode existir em um aplicativo para cada geração numérica, situação na qual a mesma série é gerada cada vez que o aplicativo é executado. O próximo número dessa série pode ser gerado se processo#>0 ou se processo# for omitido. O número aleatório anterior é gerado novamente se processo# = 0. Seek( ) Propósito: Aquisição da posição do ponteiro de dados Sintaxe: posicao& = Seek(canal%) A função Seek( ) retorna a posição do ponteiro de arquivo dentro de um arquivo de dados aberto, cujo número canal% esteja especificado entre os parênteses. Essa posição do ponteiro é onde irá ocorrer a próxima operação de leitura ou escrita. Em arquivos de acesso aleatório, Seek( ) retorna o número a ser dado ao próximo elemento de dados escrito ou lido no arquivo de dados. Em arquivos de acesso seqüêncial ou binário, seek( ) retorna a posição em bytes onde o próximo caractere de dados será escrito ou lido no arquivo de dados. O sinal # antes de canal% é omitido nessa função. Sgn( ) Propósito: Aquisição do sinal do valor Sintaxe: solucao% = Sgn(expressao) A função Sgn( ) retorna um valor que representa o sinal do valor reduzido logicamente de expressao, dentro da variável solucao%. Esse valor representativo pode ser um dos seguintes: -1 Se a expressao é negativa 0 Se expressao = 0 1 Se a expressao é positiva Sin( ), Cos( ), Tan( ) e Atn( ) Propósito: Operações trigonométricas Sintaxe: solucao = Sin(expressao) solucao = Cos(expressao) solucao = Tan(expressao) solucao = Atn(expressao) Essas quatro retornam, respectivamente, o seno, o cosseno, a tangente, e o arcotangente do valor reduzido logicamente de expressao. Esse valor é retornado na variável solucao em radianos, que são divisões de um arco circular. Space$( ) Propósito: Ativação de múltiplos espaço Sintaxe: string$ = Space$(numero%) A função Space$( ) retorna uma série de numero% caracteres de espaço, entro da variável de seqüência sequencia$. A função Len( ) é melhor utilizada quando ativada em uma procedure que contenha as outras principais funções de string do vocabulário do Visual Basic. Spc( ) Propósito: Espaçamento do cursor de texto Sintaxe: Spc(espacos%) 14
- 15. A função Spc( ) move o cursor de texto dentro de uma caixa de figura ou outro controle de "terminal virtual" por um número especificado de espacos% para a direita. Um espaço nesse caso é a largura do caractere espaço no estilo e tamanho do tipo sendo utilizando. Sqr( ) Propósito: Aquisição da raiz quadrada Sintaxe: solucao = Sqr(expressao) A função Sqr( ) retorna a raiz quadrada do valor reduzido logicamente de expressao, dentro da variável solucao. Str$( ) Propósito: Conversão de valor para string Sintaxe: solucao$ = Str$(valor) A função Str$( ) converte os dígitos contidos dentro de valor em uma string alfanumérica, que é colocada dentro da variável solucao$. O valor da variável valor não é afetado pela conversão. String$( ) Propósito: Ativação de múltiplos caracteres Sintaxe 1: palavra$ = String$(numero%, carac$) Sintaxe 2: palavra$ = String$(numero%, carac_ascii%) A função String$( ) produz um numero% designado de caracteres repetidos como a variável 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 código ASCII equivalente do caractere que é expresso como carac_ascii%. Tab( ) Propósito: Tabulação do cursos de texto Sintaxe: Tab(coluna%) A função Tab( ) 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 média de cada caractere no estilo e tamanho do tipo sendo usado, que freqüêntemente é a largura de letra n minúscula. TypeOf Propósito: Determinação de tipo de controle Sintaxe: TypeOf Objeto Is tipo A função TypeOf é usada dentro de uma expressão para retornar um valor True/False, significando se o Objeto declarado - referido pelo uso de um nome de variável 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 são 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 próprios termos de tipo. Val( ) Propósito: Conversão de string para valor 15
- 16. Sintaxe: solucao = val(string$) Nessa sintaxe, string$ pode ser uma expressão que concatene várias string. A função Val( ) converte o primeiro conjunto de dígitos com caracteres delimitadores de número em string$ para um valor colocado dentro da variável solucao. O primeiro caractere alfabético encontrado dentro de uma string cancela o processo de conversão. Uma string totalmente alfabético é, portanto, convertido em 0. O conteúdo de string$ não é afetado por essa conversão. O primeiro conjunto de caracteres diferentes de espaço em string$ precisa ser um conjunto de dígitos, ou quaisquer caracteres que o interpretador do Visual Basic normalmente usa para distinguir números fracionários. Os pontos decimais são reconhecidos como tais caracteres. VarType( ) Propósito: Aquisição do tipo de uma variante. Sintaxe: tipo% = VaType(variant) 0 Vazio 1 Nulo 2 Inteiro 3 Longo 4 Simples 5 Duplo 6 Moeda 7 Data 8 String 16
- 17. Métodos do Visual Basic .Additem Propósito: Manutenção de entradas de lista Sintaxe: Caixalist.AddItem texto$ [, indice%] O método .AddItem coloca o conteúdo textual de texto$ na caixa de listagem ou de combinação que tenha o nome de controle Caixalist. Por default, o texto é colocado no final da lista. Opcionalmente, a posição do novo item na lista pode ser especificada por um número como indice%. Os itens de uma lista são contados ou indexados começando por 0; o valor de indice% não deve ser maior que o número de itens da lista menos um. O método só pode adicionar itens a uma caixa de listagem individualmente, e não em grupos ou matrizes. .Arrange Propósito: Regulação de filha MDI Sintaxe: [paiMDI.]Arrange layout onde layout pode ter um dos seguintes valores: Em cascata, como uma série de páginas empilhadas umas sobre as outas, e deslocadas 0 para baixo e para a direita, expondo as barras de título de cada janela. Lado a lado horizontalmente, para que tantas janelas quantas possíveis sejam distribuídas por toda a largura da janela pai MDI, com cada janela filha aparecendo ao lado da outra na ordem cronológica de sua invocação. Se houver um número grande 1 de janela filha MDI na área de trabalho do pai (geralmente, mais de 6), somente umas poucas primeiras janelas filha exibidas, o número exato dependendo da resolução gráfica atual e o tamanho do pai MDI. Lado a lado verticalmente, demodo que tantas janelas quantas possíveis sejam distribuídas por toda a altura da área de trabalho do pai MDI, com cada janela filha aparecendo à direita da outra na ordem de sua invocação. Se houver um número 2 grande de janela filha MDI na área de trabalho do pai, somente as primeiras poucas janelas filha serão exibidas. O número exato de janelas filha mostradas depende da resolução gráfica atual e o tamanho do pai MDI. Reservado para casos nos quais existam janelas filha minimizadas, este valor de layout 3 reorganiza os ícones minimizados ao longo da borda inferior da área de trabalho do pai MDI. .Circle Propósito: Plotagem de elipse Sintaxe: [Objeto.]Circle Step] (twipx!, twipy!), raio![, cor&] [, ang_inicia1!, ang_fina1!)[, aspecto!] O método .Circle plota uma série de pontos em uma curva, todos os quais geometricamente convergem de um ponto central especificado como (twipx!, twipy!). Por default, esse pontos são dispostos para formar um círculo; entretando, especificando os três últimos parâmetros individuais, você pode plotar em vez disso um arco ou elipse. A menos que aspecto! seja especificado, cada ponto da série será plotado a uma distância de raio! twips das coordenadas do centro. Se cor& for especificada, a série 17
- 18. será plotada na cor especifica. As funções RGB( ) e QBColor podem ser usadas para determinar o valor de cor&. Se cor& é omitida, a série é plotada com a cor usada como definição da propriedade .ForeColor do objeto que está recebendo a plotagem. .Clear Propósito: Limpeza de uma caixa de listagem Sintaxe 1: [Formulario.]Caixalist.Clear O método .Clear esvazia todo o conteúdo da caixa de listagem antecedente. A propriedade .ListCount da caixa de listagem é definida como zero. .Clear Propósito: Apagamento do conteúdo do clipboard Sintaxe: Clipboard.Clear O método .Clear limpa o conteúdo atual do clipboard do sistema. .Cls Propósito: Limpeza de área de figura Sintaxe: [objeto.]Cls O método .Cls limpa qualquer conteúdo impresso ou plotado, textual ou gráfico, do objeto gráfico especificado. Se objeto. não estiver especificado, o formulário no qual a procedure .Cls aparece será limpo. .Drag Propósito: Ativação do arraste manual Sintaxe: Controle.Drag inteiro% O método .Drag é usado para iniciar ou parar manualmente o processo de arraste de um controle, seja qual for a definição de .DragMode desse controle. Isso é especialmente útil se o .DragMode do controle estiver definido como 0 (manual) e, por default, ele não 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 método .Drag aparecer em um procedimento de evento do controle antecedente. 2 Termina o arraste do controle e sinaliza com um evento _DragDrop para esse controle. .EndDoc Propósito: Ejeção de documento na impressora Sintaxe: Printer.EndDoc O método .EndDoc é chamado para sinalizar o término do documento interno do aplicativo e para enviar o sinal de ejeção da última página para o Print Manager do Windows. A propriedade .Page do documento interno do aplicativo é automaticamente redefinida como 1. .GetData( ) Propósito: Aquisição de dados do clipboard Sintaxe: Objeto.Picture = clipboard.GetData (formato%) O método .GetData atua como uma função ao retornar o conteúdo .Image ou .Picture do clipboard do sistema e atribuir esse conteúdo como propriedade .Picture do Objeto especificado. Se formato% for declarado como formato de dados 2,3 ou 8, o conteúdo do clipboard será atribuído à propriedade .Picture, independente desses dados terem sido criados como dados de imagem. 18
- 19. .GetFormat( ) Propósito: Aquisição de tipo conteúdo do clipboard Sintaxe: booleano% = Clipboard.GetFormat (formato%) O método .GetFormat atua como um função ao retornar na variável inteira booleano% um valor verdadeiro/falso que indica se os dados residindo atualmente no clipboard do sistema são do formato% especificado. .GetText( ) Propósito: Aquisição de texto do clipboard Sintaxe: string$ = Clipboard.GetText (formato%) O método .GetText atua como uma função, retornando o atual conteúdo textual de clipboard do sistema dentro de string$. Se formato% for especificado como tipo 1 ou &HBF00 (vínculo dinâmico), o conteúdo do clipboard será retornado em string$, quer o formato seja ou não próprio para esse conteúdo. .Hide Propósito: Suspensão de operação de formulário Sintaxe: [nomeform.].Hide O método .Hide pega um formulário sendo mostrado e o remove da tela até ordem contrária. O formulário continua a ocupar virtualmente as mesma coordenadas na tela. Os controles do formulário oculto podem ainda ser referidos no código-fonte. Em outras palavras, a operação do formulário pelo programa não é suspensa, mas o usuário não pode operá-lo. .Line Propósito: Plotagem de linha geométrica Sintaxe: [Objeto.]Line [[Step] (twipx1!, twipy1!)] [Step] (twipx2!, twipy2!) [, cor&][, B][F] O método .Line define o valor de cor de uma série linear de todos os twips endereçáveis na memória, se estendendo das coordenadas (twipx1!, twipy1!) até (twipx2!, twipy2!). Os dois pares de coordenadas são sempre separados por um hífen. O valor de cor para cada twip da série é definido, independente de ser ou não visível no presente. Se algum dos twips ou todos eles estiverem invisíveis ou obstruídos por algum outro objeto gráfico, seus valores de cor serão definidos mesmo assim, e da modificação (se houver) será refletida na tela quando esses twips forem tornados visíveis. Se Objeto. for especificado, o método definirá os valores twip com relação às coordenadas do objeto especificado. Caso contrário, o sistema de coordenadas do formulário que contém o método será assumido. A forma que a linha torna é retornável através das propriedades .DrawStyle e .DrawWidht, onde .DrawStyle representa o tipo de interrupção usada na linha (se houver) e .DrawWidth 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 não pode ser omitido. O hífen, contudo, permanece na instrução do método. O último ponto plotado em um objeto gráfico pode ser obtido através das propriedades .CurrentX e .CurrentY desse objeto. Se nenhum ponto tiver sido plotado nesse objeto, as coordenadas iniciais (0,0) serão assumidas. .Move Propósito: Reposicionamento manual de controle Sintaxe: Controle.Move esquerda[,topo%[, largura%[, altura%]]] 19
- 20. O método .Move move o controle designado em um formulário para a posição em coordenadas desse formulário especificada pelos parâmetros esquerda% e topo%. Somente o parâmetro esquerda% precisa ser especificado para mover o controle horizontalmente para a nova posição de tips esquerda%. Se topo% for especificado, o controle será movido verticalmente também. Se largura% ou altura% forem especificadas, o controle será redimensionado depois de ser movido. .NewPage Propósito: Sinal de ejeção de página na impressora Sintaxe: Printer.NewPage O método .NewPage é chamado para ejetar a página sendo impressa. Esse sinal de ejeção é guardado dentro do Print Manager do Windows até ele despachar esse sinal para a impressora no momento oportuno. A propriedade .Page do documento interno do aplicativo é automaticamente incrementada. Para declarar que o final de um documento foi atingido, o método .EndDoc é chamado. .Point Propósito: Aquisição de valor de cor Sintaxe: cor& = [Objeto.]Point(twipx!,twipy!) O método .Point atua como uma função ao retornar no inteiro longo cor& o valor de cor RGB do pixel mais próximo das coordenadas de twip especificadas. No entanto, o método é especificado pelo uso de sintaxe orientada para objeto. Se Objeto. for incluído na instrução, o sistema de coordenadas do objeto especificado será usado. Caso contrário, o sistema do formulário que atualmente contém a instrução será assumido. .Print Propósito: Exibição de texto Sintaxe: [objeto.]Print {expressao1{;|,} expressao2{;|,} ... expressaon{,|,}] na qual cada expressão consiste em qualquer expressão matemática ou de string logicamente interpretável. O método .Print exibe a forma logicamente reduzida de cada expressão da lista de expressões. Se objeto. for especificado, o destinatário do texto impresso será o objeto gráfico declarado, tal como Form1, ou um dispositivo de saída, tal como Printer. Se o interpretador permite que objeto. seja omitido, a impressão é direcionada para a janela do formulário ao qual pertence a procedure que contém o método .Print aparece no contexto de um módulo geral. Se o destinatário objeto. pertencer a um formulário que não o que contém o método .Print, o nome do formulário será especificado antes do nome do objeto, com ambos os nomes separados um do outro por um ponto. Uma expressão matemática - no caso de uma expressão fornecida como um parâmetro - é composta de um ou mais valores ou variáveis combinados aritmeticamente pelo uso de símbolos operadores como + ou termos de função como Int( ). Uma expressão string é composta de um ou mais elementos de texto, sejam eles frases alfanuméricas, variáveis string, ou funções string tais como Right$( ). Expressões string de múltiplos 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 próprias aspas usando a função Chr$(34), com a função aparecendo fora de quisquier aspas. Da mesma forma, você pode expressar outros caracteres especiais que não aparecem no teclado usando a função Chr$( ). O ponto-e-vírgula e a vírgula como delimitadores têm usos específicos com respeito ao método .Print. Cada expressão da lista é separada das outras por um desses delimitadores. Se duas expressões são separadas uma da outra por um ponto-e- 20
- 21. vírugla, o texto de ambas as expressões é impresso um ao lado do outro (juntos lado a lado). Se duas expressões são separadas uma da outra por uma vírgula, o interpretador insere um caractere de tabulação no final da primeira expressão antes de imprimir o início da segunda. Uma tabulação é equivalente a 14 colunas ou, usando emprestado um termo da tipografia, 14 enes, onde um ene é a largura média de uma letra na fonte atualmente escolhida. O interpretador do Visual Basic reconhece um cursor virtual par os objetos gráficos que recebem texto usando o método .Print. A posição em coordenadas desse cursor é registrada dentro de propriedades do objeto gráfico, chamadas .CurrentX e .CurrentY. Sempre que um método .print completa sua execução, ele deixa por default o cursor virtual no início ( por default, no lado esquerdo) da linha imediatamente seguinte à que acabou de ser impressa. Se o método .Print é fechado com um ponto-e-vírgula, a posição do cursor é definida no final imediato do texto que acabou de ser impresso, sem que o interpretador execute um retorno de carro para a próxima linha. Se o método .Print é fechado com uma vírgula, o cursor é tabulado para a próxima parada de 14 colunas e permanece lásem que o interpretador execute um avanço de linha para a próxima linha. Se o método .Print aparecer em uma linha por si só, um retorno de carro com um avanço de linha será gerado. Em outras palavras, a "cabeça de impressão" é movida para a extremidade esquerda pelo retorno de carro e uma linha para baixo pelo avanço de linha - com o que acontece quando você pressiona a tecla Return em uma máquina de escrever elétrica. A posição do cursor virtual é ajustada para o início da próxima linha abaixo da anteriormente impressa. .Pset Propósito: Definição de valor de cor de pixel Sintaxe: [Objeto.]PSet [Step] (twipx!, twipy!) [, cor&] O método .PSet define o valor de cor de um ponto de coordenada representado pelas coordenadas (twipx!, twipy!). Se o ponto estiver atualmente visível 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 não estiver visível na tela, o ponto na memória será definido de qualquer modo, e a mudança (se houver) será refletida na tela quando esse ponto for tornado visível. Se Objeto. for especificado, o método definirá o valor do ponto com relação às coordenadas do objeto especificado. Caso contrário, o sistema de coordenadas do formulário que contém o método será assumido. Se cor& for especificada, o método .PSet definirá o valor de cor do ponto com qualquer valor inteiro longo no intervalo de 0 a 16.777.215, representando uma cor ou padrão de cores reconhecido pelo Microsoft Windows. O valor de cor& pode ser representado pela função RGB( ) ou QBCoor( ). Para redefinir um ponto - poara dar-lhe o valor da cor de fundo - o termo de propriedade .BackColor pode ser usado como cor&. Se cor& não for especificada, o método .PSet definirá o valor de cor do ponto como o valor da propriedade .ForeColor do objeto especificado. Quando Step está no método, o interpretador VB considera o sistema de coordenadas expresso em (twipx!, twipy!) como sendo relativo ao último ponto plotado, ou em relação a (0,0) se nenhum ponto tiver sido plotado. O último ponto plotado em um objeto gráfico pode ser obtido através das propriedades .CurentX e CurrentY desse objeto. A largura e a altura do ponto sendo plotado com .PSet podem ser definidas previamente com a propriedade .DrawWidth do objeto que recebe o ponto. O ponto pode ser plotado como um ponto invisível - existente embora não visto - pela definição da propriedade .DrawStyle do objeto como 5. 21
- 22. .Refresh Propósito: Atualização forçada do conteúdo de um objeto Sintaxe: Objeto.Refresh O método .Refresh diz ao interpretador para suspender temporariamente os processos matemáticos, por tempo suficiente para que ele atualize o conteúdo do Objeto especificado. Esse conteúdo pode ter sido destinatário de instruções gráficas ou de alteração de texto, mas o interpretador pode ter deixado de lado a execução dessas instruções para poupar tempo. Se o objeto especificado não tem pendentes tais atualizações, nada acontece. .RemoveItem Propósito: Manutenção de entradas na lista Sintaxe: Caixalist.RemoveItem indice% O método .RemoveItem elemina da caixa de listagem ou de combinação especificada o item endereçado por indice%. O método só pode remover itens de uma caixa de listagem individualmente, e não em grupos ou matrizes. .Scale Propósito: Estabelecimento de sistema de coordenadas variável Sintaxe: [Objeto.]Scale [(origx!, origy!) - (extx!, exty!)] O método .Scale define o par de coordenadas do canto superior esquerdo do objeto antecedente como (orgx!, origy!) e par de coordenadas do canto inferior direito do objeto como (extx!, exty!). Se ambos os pares de coordenadas forem omitidos, a escala do objeto será redefinida para a escala default de coordenadas de twips. .SetData Propósito: Colocação de dados no clipboard Sintaxe: Clipboard.SetData Objeto.{Image | Picture} [, formato%] O método .SetData atribui ao clipboard do sistema o .Picture (mapa de bits no formulário) ou .Image (mapa de bits na memória) referido usando sintaxe orientada para objeto. Por default, a imagem é assumida como sendo um mapa de bits padrão do formato de dados 2; entretanto, os formatos 3 e 8 também são suportados. .SetFocus Propósito: Definição do indicador manual Sintaxe: [Controle.]SetFocus O método .SetFocus aponta manualmente o controle antecedente como sendo o controle ativo, dando-lhe portanto o foco. Para o interpretador VB, é inteiramente "legal" para um formulário receber o foco. Em interpretações anteriores do paradigma focus, o controle que tinha o foco era mantido pelo formulário que tinha o foco. No Visual Basic, é oferecida uma alternativa para esse dualismo. Agora, o formulário que tem o foco reside dentro do formulário ativo. Esse formulário é então dito como sendo ativado ou desativado pelo usuário. Ambas essas ações podem ser registradas como eventos, e são atribuidas ao formulário. .SetText Propósito: Colocação de texto no clipboard Sintaxe: Clipboard.SetText string$[, formato%] O métodio .SetText coloca o texto atualmente referido como string$ no clipboard do sistema. Por padrão, o texto é assumido como sendo do formato de dados 1, a menos que especificado como &HBF00, situação na qual o texto é assumido como sendo parte de uma operação de vínculo dinâmico. 22
- 23. .Show Propósito: Exibição de formulário na área de trabalho Sintaxe: [nomeform.]Show [estilo] O método .Show exibe um formulário que se encontre em seu estado carregado, embora não visível. Se o formulário não tiver sido carregado ainda na área de trabalho, ele será carregado automaticamente, e o procedimento de evento Sub Form Load( ) desse formulário, se houver, será disparado. Se o nomeform for omitido, o formulário gráfico compartilhando o módulo atual com o procedimento atualmente em execução será mostrado. O valor estilo opcional, quando definido como 1 (0 é o padrão) torna modal o formulário exibido - em outras palavras, nenhuma outra janela pode aceitar entrada do usuário até que se saia deste formulário. .TextHeight e .TextWidth Propósito: Aquisição de tamanho de texto Sintaxe: valor%=[Objeto.]TextHeight(string$) | valor%=[Objeto.]TextWidht(string$) Os métodos .TextHeight e .TextWidth são chamados como funções, exceto por serem espressos com o uso de sintaxe orientada para objeto. Esses métodos retornam a altura e largura, respectivamente, do texto expresso em string$ como ele apareceria no Objeto especificado se impresso através do método .Print. Esses valores são retornados no inteiro valor% como se os métodos fossem funções. Esses métodos só funcionam com objetos de terminal virtual como caixa de figura ou formulários, ou o dispositivo impressora. Se Objeto não for especificado, o formulário que contém a procedure atualmente em execução será usado. .ZOrder Propósito: Designar a exposição na tela Sintaxe: [Controle.]ZOrder posicao% O método .ZOrder define a ordem de representação do Controle designado dentro de seu formulário para a posicao% dada. Aqueles controles aos quais se deu uma posicao % mais baixa são representados primeiro; auqeles com números seguintes são representados depois. Se a área ocupada por um controle posterior na seqüência 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 estruturação estabelece a ordem z natural dos controles em um formulário. Como .ZOrder é um método e não uma propriedade ele só pode ser usado durante o tempo de execução de um aplicativo para alterar a seqüência de exibição. 23
- 24. Eventos do Visual Basic _Activate e _Deactivate Ação: Acionamento de formulário Se Aplica a: Formulários (não MDI) Parâmetros: Nenhum O evento _Activate de um formulário é disparado sempre que o usuário indica esse formulário, ou passa o controle para ele através de qualquer rotina que o carregue formalmente na área de trabalho. Isso também pode ser disparado pela passagem do foco pelo formulário, ou por dar o foco a um controle desse formulário. O eventor _Deactivate é disparado sempre que um outro formulário residente na área de trabalho é indicado, ou caso alguma atividade ou rotina torne algum outro formulário ativo. Ele não é disparado por um formulário quando este é descarregado ou oculto. _Change Representação: Alteração de status Se Aplica a: Etiqueta, texto, figura, diretório, dispositivo, lista combinação, rolagem. Parâmetros: Índice (somente arrays de controles) O evento _Change é reconhecido sempre que o conteúdo ou representação de status do objeto antecedente é modificado. Essa modificação pode ser devida ao usuário alterar a posição ou conteúdo do objeto, ou por uma instrução do código-fonte VB modificar uma propriedade do objeto. Para uma etiqueta ou campo de texto, _Change é reconhecido quando seu conteúdo textual é alterado, ou quando um caractere é a adicionado ou removido do campo. Para uma caixa de imagem, _Change é reconhecido quando seu conteúdo gráfico é alterado. Para uma caixa de listagem ou dispositivo relacionado, _Change é reconhecido quando o conteúdo da lista é alterado ou acrescido de algo, ou quando a seleção representada por aquela lista é alterada. Para uma barra de rolagem, _Change é reconhecido quando a caixa de rolagem é movida. _Click Ação: Indicação do usuário Se aplica a: Botão, verificação, combinação, diretório, arquivo, formulário, grade, imagem, rótulo, lista, menu, opção, figura, texto. Parâmetros: Índice (somente arrays de controles) O eventos _Click de um controle é reconhecido sempre que o usuário pressiona e solta o botão indicador do mouse enquanto o apontador está sobre esse controle. Lembre-se, o termo botão indicador aqui se refere ao botão esquerdo em sistemas desktop; para usuários canhatos, porém, este pode ser o botão direito. Para usuários de mouse de laptop, este pode ser o botão comprido ao longo do lado do mouse. A procedure de evento Sub Controle_Click ( ) é a geralmente utilizada para desemprenhar a função de comando associada a ess controle. Três outros eventos do vocabulário do VB estão 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. 24
- 25. _DblClick Ação: Indicação do usuário Se Aplica a: Botão, verificação, combinação, diretório, arquivo, formulário, grade, imagem, rótulo, lista, opção (não MDI), figura, texto. Parâmetros: Índice (somente arrays de controles) O evento _DblClick de um controle é reconhecido sempre que o usuário pressiona e solta rapidamente o botão indicador do mouse duas vezes enquanto o apontador está sobre esse controle. _DragDrop Ação: Liberação de ícone arrastado Se aplica a: Verificação, combinação, comando, diretório, unidade de disco, arquivo, formulário, moldura, grade, imagem, etiqueta, lista, MDI, opção, figura, rolagem, texto Parâmetros: Index As Integer (somente arrays de controles), Source As Control, X As Single, Y As Single O evento _DragDrop de um controle é reconhecido quando o objeto de arraste atribuído a um outro controle - geralmente um ícone - é arrastado para cima dele e o botão do mouse é solto. O procedimento para esse evento leva três parâmetros: Source como uma variável 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. _DragOver Ação: Travessia do ícone arrastado Se aplica a: Verificação, combinação, comando, diretório, unidade de disco, arquivo, formulário, moldura, grade, imagem, etiqueta, listagem, opção, MDI,figura, rolagem, texto Parâmetros: Index As Integer (somente arrays de controles), Source X As Single, Y As Single, State As Integer O evento _DragOver de um controle ocorre quando o objeto de arraste atribuído a um outro controle é arrastado por cima dele, independentemente do botão do mouse ser solto. O procedimento desse evento leva quatro parâmetros: a variável de objeto Source, que contém 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 operação de arraste. Esse inteiro recebe um dos seguintes valores dados pelo interpretador: 0 O apontador está entrando na área do controle alvo. 1 O apontador está saindo da área do controle alvo. 2 O apontador está dentro da área do controle alvo O objeto de arraste de um controle não aparece por padrão em tempo de execução; através de uma propriedade, um controle é informado de sua capacidade de arraste. _DropDown Ação: Aparência do painel de lista subordinada Se aplica a: Combinação Parâmetros: Índice (somente arrays de controles) O evento _DropDown de uma caixa de combinação é ativido sempre que o usuário clica no botão de seta para baixo da caixa de combinação. Este evento é, com efeito, o evento "Click" do botão de seta para baixo. _GotFocus e _LostFocus Ação: Obtenção/perda do indicador de controle 25
- 26. Se Aplica a: Todos os controles, formulários (não MDI) Parâmetros: Index (somente arrays de controles) O evento _GotFocus de um controle ocorre sempre que ele adquire o foco, como um resultado do usuário indicá-lo com o mouse ou a tecla Tab, ou através de definição direta do foco pelo programa. A aquisição do foco faz desse controle específico o destinatário de eventos iniciados pelo teclado. Conseqüêntemente, o evento _LostFocus de um controle ocorre sempre que ele perde o foco, admitindo é claro que ele chegou a possuir o foco. Se necessário, o programa pode definir o foco de um controle manualmente, forçando assim para ele o papel de controle ativo. _keyDown e _KeyUp Ação: Ativação ou liberação de tecla Se aplica a: Formulário, verificação, combinação, comando, diretório, unidade de disco, arquivo, grade, lista, opção, figura, rolagem, texto. Parâmetros: Index As Integer (somente arrays de controles), KeyCode As Integer, Shift As Integer O evento _KeyDown de um formulário ou controle é reconhecido sempre que esse objeto gráfico tem o foco e o usuário pressiona uma tecla no teclado. O evento _KeyDown continua a ser reconhecido para esse controle contanto que essa tecla permaneça pressionada. Dois parâmetros são passados para o procedimento nesse evento: o código de varredura da tecla pressionada (que não deve ser confundido com o alor de código ASCII do caractere que a tecla geralmente representa) e um inteiro com um padrão de bytes que representa o estado de pressionamento da tecla de alteração. Este inteiro pode ter qualquer dos seguintes valores. 0 Nenhuma tecla de alteração pressionada 1 Uma das teclas Shift pressionada 2 Uma das teclas Ctrl pressionada 3 Control + Shift pressionadas 4 Tecla Alt pressionada 5 Alt + Shift pressionadas 6 Alt + Ctrl pressionadas 7 Alt + Ctrl + Shift pressionadas O evento _KeyUp de um objeto gráfico é reconhecido sempre que esse objeto tem o foco e o usuário solta uma tecla que estava pressionada. Falando logicamente, o evento é reconhecido quando o código de varredura de tecla anteriormente registrado volta para 0. O interpretador VB para o procedimento de evento _KeyUp os mesmos valores que para o evento _KeyDown. _KeyPress Ação: Reconhecimento de caractere Se Aplica a: Formulário, verificação, combinação, comando, diretório, unidade de disco, arquivo, grade, listagem, opção, figura, rolagem, texto. Parâmetros: Index As Integer (somente arrays de controles), KeyAscii As Integer O evento _KeyPress de um formulário ou controle é reconhecido sempre que esse objeto gráfico tem o foco e uma tecla é pressionada no teclado. O evento _KeyPress não continua a ser reconhecido por padrão se a tecla for mantida pressionada; entretanto, se a repetição de teclas estiver selecionada através 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 _KeyPress ocorre repetitivamente. O valor de código ASCII do caractere com sua tecla correspondente pressionada é o único parâmetro passado para a procedure deste evento. 26
- 27. _MouseDown e _MouseUp Ação: Ativação do botão do mouse Se Aplica a: Diretório, arquivo, formulário (nãoMDI), grade, imagem, etiqueta, listage, figura Parâmetros: Index As Interget (somente arrays de controles), Button As Integer, Shift As Integer, X As Single, Y As Single O eveno _MouseDown de um objeto gráfico é reconhecido sempre que esse objeto tem o foco e o usuário pressiona qualquer botão do mouse. O interpretador do Visual Basic passa quatro parâmetros para o procedimento desse evento. O primeiro parâmetro, Button, é o estado dos botões do mouse, supondo até três botões para o mouse. Esse valor pode ser definido como qualquer dos seguintes: 1 Botão esquerdo (botão indicador default) pressionado 2 Botão direito pressionado 3 Botões esquerdo e direito pressionados 4 Botão do meio pressionado 5 Botões do meio e da esquerda pressionados 6 Botões do meio e da direita pressionados 7 Botões do meio, da esquerda e da direita pressionados O segundo valor passado para o evento _MouseDown - Shift - reflete o estado atual das teclas de alteração do teclado quando o botão do mouse é registrado como pressionado. Esse valor pode ser definido como qualquer dos seguintes: 0 Nenhuma tecla de alteração pressionada 1 Uma das teclas Shift pressionada 2 Uma das teclas Ctrl pressionada 3 Teclas Shift e Ctrl pressionada 4 Uma das teclas Alt pressionadas 5 Teclas Alt e Shift pressionadas 6 Teclas Alt e Ctrl pressionadas 7 Teclas Alt, Shift e Ctrl pressionadas O terceiro e quarto valores passados para a procedure de evento _MouseDown - X e Y - refletem a posição atual em coordenadas do apontador do mouse com respeito ao objeto gráfico ao qual este procedimento é atribuído. O evento _MouseUp de um objeto gráfico é reconhecido sempre que esse objeto tem o foco e o usuário libera um botão pressionado do mouse. O interpretador VB passa para o procedimento de evento _MouseUp os mesmos valores que passa o procedimento de evento _MouseDown. _MouseMove Ação: Movimento do apontador Se aplica a: Diretório, caixa de arquivo, formulário (não MDI), grade, imagem, etiqueta, listagem, figura Parâmetros: Index As Integer (somente arrays de controles), Button As Integer, Shift As Integer, X As Single, Y As Single O evento _MouseMove de um objeto gráfico é reconhecido sempre que ele tem atualmente o foco e a o apontador do mouse é movido quando reside sobre a área desse objeto. O evento _MouseMove pode ocorrer somente em uma caixa de arquivo, uma caixa de etiqueta, uma caixa de listagem, uma caixa de figura, ou um formulário. Para a procedure de evento _MouseMove são passados quatro parâmetro, como descritos anteriormente para o evento _MouseDown. _Paint 27
- 28. Açao: Raquisição de imagem de reserva Se aplica a: Formulário, figura Parâmetros: Index As Integer (somente arrays de controles) O evento _Paint de um formulário ou de caixa de figura é reconhecido quando a propriedade .AutoDraw desse objeto é definida como False(0), e o objeto antecedente, antes obstruído (parcial ou totalmente) é parcial ou totalmente desobstruído. Isso permite que o programa redesenhe manualmente o objeto, economizando assim memória para outras finalidades. _PathChange Ação: Alteração de caminho de diretório Se aplica a: Arquivos Parâmetros: Nenhum. O evento _PathChange de uma caixa de listagem de arquivos ocorre sempre que o caminho sendo atualmente pesquisado para obtenção de seu conteúdo é modificado por alguma razão, seja pelo programa ou pelo usuário. O evento é disparado sempre que a propriedade .Path é diretamente modificada pelo programa. _PatternChange Ação: Alteração de padrão de procura de arquivos Se aplica a: Arquivos Parâmetros: Nenhum O evento _PatternChange de uma caixa de listagem de arquivos ocorre sempre que o padrão sendo atualmente comparado com o caminho de procura atual para obtenção de arquivos coincidentes é modificado por alguma razão, seja pelo programa ou pelo usuário. O evento é disparado sempre que uma mudanção é feita diretamente na propriedade .Pattern. _RowColChange Ação: Movimento do ponteiro de célula Se aplica a : Grade Parâmetros: Nenhum O evento _RowColChange de uma grade é disparado sempre que o ponteiro de célula atual é movido para uma nova posição, seja por meio de interação com o usuário ou por uma procedure que defina manualmente a propriedade .Row ou .Col da grade. _SelChange Ação: Ativação de indicação de células Se aplica a: Grade Parâmetros: Nenhum O evento _SelChange de um controle grade é disparado sempre que um processo de indicação de células começa, seja por interação do usuário com a grade, ou pela definição de uma das propriedades .Selx da grade. _Timer Ação: Passagem de intervalo Se aplica a: Controle timer Parâmetros: Nenhum O evento _Timer ocorre para um formulário que contenha yum controle timer, depois de cada passagem de um determinado intervalo de tempo conforme especificado na propriedade interval. 28
- 29. Propriedades do Visual Basic .Action Especifica qual diálogo comum deve ser exibido A definição da propriedade .Action faz duas coisas. Primeiro ela especifica qual caixa de diálogo deve ser exibida. Segundo, ela realmente exibe essa caixa de diálogo. Por exemplo, a declaração CMDialog1.Action = 1 faz com que a caixa de diálogo File Open seja exibida. .Align Representação: Alinhamento automático de figura Se aplica a: Figura Definida por meio de: Janela Properties A definição da propriedade .Align de uma caixa de figura representa sua colocação automática em um formulário padrão ou formulário MDI. A definição denota se a caixa de figura deve, por default, ser esticada pela extensão do formulário ao qual pertence, bem como se ela deve ser posicionada ao longo das bordas superior ou inferior por default. Com .Align definida como um valor diferente de zero, o interpretador reposiciona a caixa de figura quando do projeto como especificado. As definições dessa propriedade podem ser as seguintes: 0 A caixa de figura pode aparecer em qualquer lugar como posicionada (esse é o default para um formulário convencional). 1 A caixa de figura é esticada para se ajustar à .Width (largura) do formulário, e é posicionada ao longo da borda superior (esse é o defalt para um formulário MDI). 2 A caixa de figura é esticada para se ajustar à .Width do formulário, e é posicionada ao longo da borda inferior. .AutoRedraw Representação: Permissão de reserva de imagem Se aplica a: Formulário, figura Definida por meio de: Janela Properties A propriedade .AutoRedraw de um formulário ou caixa de figura é definida como um valor True/False que denota se o interpretador deve manter na memória um mapa de bits persistente da imagem especificada. Se a propriedade estiver definida como True, sempre que um outro objeto for movido por processo ou movimento dirigido pelo usuário, sobrepondo parcial ou totalmente o objeto antecedente da propriedade, a porção gráfica desse objeto será retida na memória. Quando a porção não estiver mais obstruída, o interpretador irá automaticamente replotar o conteúdo gráfico 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 porção obstruída será, com efeito, apagada do objeto. Entretanto, quando o objeto não estiver mais obstruído, o evento _Paint será gerado, e uma procedure de evento _Paint poderá ser invocada para atualizar ou reparar o conteúdo do objeto obstruído. BackColor e .ForeColor Representação: Designação de cores sólidas Se aplica a: Todos os controles, formulários, objeto Printer (somente .ForeColor) 29
- 30. Definida por meio de: Janela Properties, instrução de programa A propriedade .BackColor de um controle reflete sua cor de fundo atual. A propriedade .ForeColor de um controle representa a cor de apresentação de texto e elementos gráficos - tais como bordas - dentro desse controle. Ambas as propriedades são expressas como valores hexadecimais de seis dígitos. Esses valores representam digitalmente o esquema de mistura de cores atualmente em uso. Como as placas gráficas (e portanto os controladores de placas gráficas) não são todas iguais, as cores escolhidas para objetos no sistema onde o aplicativo está sendo programado podem não ser idênticas (ou mesmo próximas) às cores representadas em algum outro sistema. .BackStyle Representação: Estado de preenchimento sólido Se aplica a: Objeto shape Definida por meio de: Janela Properties, instrução de programa A propriedade .BackStyle de um objeto de forma é definida como um valor 0 ou 1 que significa se a forma é preenchida com uma cor sólida. O valor de 0 (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 .BackColor da imagem. Por default, a .BackColor de um forma é definida como branco. BorderColor Representação: Cor de contorno Se aplica a. Objeto line, objeto shape Definida por meio de: Janela Properties, instrução de programa A propriedade .BorderColor de um bojeto de forma ou de linha é definida com um valor hexadecimal de seis dígitos que representa o valor de cor do Windows para os pixels usados para gerar a linha. Você pode usar um valor decimal dentro de instruções do código-fonte para se referir a valores de cores; entretanto, você pode achar mais fácil usar valores hexadeximais para esse fim porque a divisão entre seis dígitos hexadecimais lembra melhor a divisão entre os seis parâmetros de cor usados para gerar o valor. Quando você define a propriedade .BorderColor através 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 número hexadecimal. .BorderStyle Representação: Tipo de envoltório exibido Se aplica a: Todos os controles, formulários, formulários MDI Definida por meio de: Janela Properties A propriedade .BorderStyle representa a classificação interna de um formulário ou controle mantida pelo Visual Basic. Controle que o nome do objeto gráfico que seja o antecedente da propriedade tenha sido atribuído através de sua propriedade .Name, o interpretador VB sabe se deve aplicar o conjunto de categoria de formulário ou de controle ao objeto gráfico. .BorderStyle Representação 2: Modo de tracejamento de linhas Se aplica a: Controle linha, controle forma Definida por meio de: Janela Properties, instrução de programa A propriedade .BorderStyle de um controle de linha ou de forma, na representação 2, reflete o tracejamento atual que é aplicado à "marca" que gera a aparência desse 30
- 31. controle. Isto permite a geração de linhas pontilhdas ou interrompidas. Os estilos de marcação representáveis pela propriedade .BorderStyle aparecem a seguir: 0 (transparente) 1 _____(linha sólida, default) 2 - - - - (traços) 3 ····· (pontos) 4 _·_·_· (traço-ponto) 5 _··_·· (traço-ponto-ponto) 6 _______(sólida interior) .BorderWidth Representação: Extensão da marca em pixels Se aplica a: Controle linha, controle forma Definida por meio de: Janela Properties, instrução de programa A propriedade .BorderWidth de um controle de linha ou de forma representa o comprimento, em pixels, da "pena" usada para gerar a imagem visível 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 .BorderStyle do controle for definido como 6, essa largura será dobrada, uma vez que o mesmo número de pixels se estende para dentro em direção ao centro. A .BorderWidth de um controle não pode ser definida como 0; para representar um controle aparentemente invisível (não realmente invísivel, na ótica do interpretador), use uma propriedade .BorderStyle de zero. .Caption Representação: Conteúdo textual não editável Se aplica a: Etiqueta, botão, verificação, opção, formulário, quadro, menu Definida por meio de: Janela Properties, instrução de programa A definição da propriedade .Caption de um controle em um formulário reflete o conteúdo textual desse controle. A definição da propriedade .Caption de um formulário reflete o conteúdo textual de sua barra de título. Em cada um desses casos, o usuário não pode editar diretamente o conteúdo textual dentro do controle, embora eventos disparados pelo usuário possam fazer com que instruções de programa mudem a propriedade .Caption. O comprimento máximo em caracteres da definição de uma propriedade .Caption é 2.048 caracteres. .CellSelected Representação: Status de indicação de ponteiro Se aplica a: Grade Definida por meio de: Instrução de programa, interação com o usuário A propriedade .CellSelected de uma grade é definida como um valor True/False, denotando se as definições atuais das propriedades .Row e .Col colocam o ponteiro de célula em uma região indicada de célula. .Checked Representação: Marcação de item de menu Se aplica a: Menus Definida por meio de: Janela Menu Design, instrução de programa A propriedade .Checked de uma seleção de menu é definida como um valor True ou False (usando True/False ou On/Off) que designa se um marca de verificação aparece ao lado da seleção. Essa propriedade não 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 verificação ao lado da seleção. Você pode usar essa 31
- 32. propriedade para ajudar a designar se um determinado recurso do programa representado pela seleção do menu está atualmente ativo. .Clip Representação: Conteúdo coletivo das células indicadas Se aplica a: Grade Definida por meio de: Instrução de programa A propriedade .Clip de um controle grade é definida automaticamente pelo interpretador Visual Basic como o conteúdo textual de cada célula na região indicada da grade. A propriedade "lê" da esquerda para a direita, e então de cima para baixo. Um caractere de tabulação representado por Chr$(9) separa o conteúdo das células que compartilham a mesma linha. Uma vez que a "leitura" tenha chegado ao final da linha, a próxima linha abaixo dela é lida para a propriedade começando pela célula extrema esquerda. Esse retorno de carro de células é representado na propriedade .Clip por um caractere ANSI de retorno de carro, Chr$(13). .ColAlignment( ) Representação: Peso do conteúdo textual Se aplica a: Grade Definida por meio de: Janela Properties, instrução de programa A propriedade .ColAlignment ( ) é um array cujos elementos individuais se aplicam, por número, às colunas de seu objeto grade antecedente - especificamente a suas células não fixas. As definições de cada elemento refletem o eixo contra o qual o conteúdo textual das células de cada coluna é colocado. A propriedade pode ser definida com qualquer um dos seguintes valores: 0 Alinhamento esquerdo (default) 1 Alinhamento direito 2 Centrado Você pode definir o alinhamento de uma coluna em particular através de uma instrução que use a seguinte sintaxe: Grade.ColAlignment(coluna%) = definicao% .ControlBox Representação: Especifica o status da caixa de controle da janela Se aplica a: Formulários Definida por meio de: Janela Properties A propriedade .ControlBox é definida como um valor True ou False, refletindo se a caixa de controle da janela aparece no formulário para essa janela. Por default, formulário .ControlBox é definida como verdadeira. Essa propriedade é redefinida ou definida somente quando da estruturação, e tem efeito quando o aplicativo é executado. .Copies, .FromPage e .ToPage Estas propriedades especificam o número de cópias a serem impressas e o intervalo de páginas a ser impresso. Por exemplo, se .Copies tem um valor de 2, .FromPage tem um valor de 4, e .ToPage tem um valor de 6, seu programa deve imprimir duas cópias das páginas 4, 5 e 6. .CurrentX e .CurrentY Representação: Coordenadas do apontador do terminal virtual Se aplica a: Formulário, figura, impressora Definida por meio de: Instrução de programa 32
- 33. As propriedades .CurrentX e .CurrentY de um objeto gráfico terminal virtual são definidas pelas coordenadas atuais do cursor desse objeto. Por default, essas coordenadas são expressas graficamente como twips, a menos que a propriedade .ScaleMode desse objetos esteja definida de outra forma. As definições dessas propriedades sãio relativas à escala de coordenadas atual do objeto gráfico ou dispositivo. .Default e .Cancel Representação: Aceitação/rejeição de atribuição de tecla Se aplica a: Comando Definidas por meio de: Janela Properties, instrução de programa A propriedade .Default de um botão é definida como verdadeira se o usuário pode pressionar Enter em vez de clicar nesse botão. Geralmente, esse botão implica em que o usuário aceita as condições definidas dentro do painel. Similarmente, a propriedade .Cancel de um botão é definida como verdadeira se o usuário pode pressionar Esc em vez de clicar nesse botão. Geralmente, esse botão implica em que o usuário rejeita as condições definidas no painel. .DragIcon Representação: Nome de arquivo do objeto de arrast Se aplica a: Verificação, combinação, comando, diretório, unidade de disco, arquivo, moldura, grade, imagem, etiqueta, listagem, opção, figura, rolagem, texto Definida por meio de: Janela Properties, instrução de programa A propriedade .DragIcon contém 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 usuário clica e mantém pressionado o apontador sobre o controle que tem uma propriedade .DragIcon que tenha sido definida com o nome de arquivo de um ícone - uma imagem é mostrada. Quando o usuário clica no objeto fonte, o objeto de arraste aparece em preto e branco no lugar do apontador atual, enquanto o botão indicador estiver pressionado. Esse objeto de arraste pode então seguir o apontador até o objeto alvo do arraste. .DragMode Representação: Acessibilidade do apontador do controle Se aplica a: Verificação, combinação, comando, diretório, unidade de disco, arquivo, formulário, moldura, grade, imagem, etiqueta, listagem, MDI, opção, figura, rolagem, texto. Definida por meio de: Janela Properties, instrução de programa A propriedade .DragMode de um controle é definida como 1 para tornar esse controle automaticamente arrastável em tempo de execução. O default da propriedade é 0; isso significa que o arraste pode ser ativado com o código-fonte, seja uma só vez com o método .Drag, ou pelo restante do programa com a instrução Controle.DragMode = 1 até ser desativado com Controle.DragMode = 0. Observe que essa propriedade é um indicador e não um registro booleano verdadeiro ou falso, portanto .DragMode não é uma propriedade passível de ser definida como True(-1). .DrawStyle Representação: Atribuição de tracejamento da plotagem Se aplica a: Formulário, figura, impressora Definida por meio de: Janela Properties, instrução de programa A propriedade .DrawStyle de um objeto terminal virtual é definida com um valor que representa o estilo da linha que será produzida pelo próximo método, que desenhe ua 33
- 34. série de pontos no objeto. Essa propriedade pode levar qualquer dos valores seguintes: 0 ____(Sólida, posicionada metade dentro, metade fora da área da caixa - o default) 1 ----(Traços) 2 ......(Pontos) 3 -.-.-(Traço-ponto) 4 _··_(traço-ponto-ponto) 5 (Invisível) 6 ____ (Sólida, embora inteiramente dentro da área da caixa) .DrawWidth Representação: Atribuição de largura de plotagem Se aplica a: Formulário, figura, impressora Definida por meio de: Janela Properties, instrução de programa A propriedade .DrawWidth é definida como a largura, em pixels, de quaisquer linhas ou pontos a serem plotados no objeto antecedente pelo uso de métodos gráficos. .Drive Representação: Dispositivo ativo Se aplica a: Unidades de disco Definida por meio de: Instrução de programa, interação com o usuário A propriedade .Drive de uma caixa de listagem de unidades de disco é definida com o texto de sua única entrada selecionada. A sintxe da definição de propriedade textual é a seguinte: drive: [nome_volume] O nome completo do volume atribuído ao dispositivo de unidade de disco quando formatado pela última vez aparece entre colchetes após o identificador de dispositivo. .Enabled Representação: Status de operacionalidade do controle Se aplica a: Todos os controles, menus, formulários Definida por meio de: Janela Properties, janela Menu Design, instrução de programa A propriedade .Enabled de um controle é definida como um valor True ou False que designa se um controle responde a eventos do usuário. Por default, esse propriedade e definida como True. Para desativar um controle mas permitir que ele permaneça dentro de um formulário, ou para tornar cinza ua seleção dentro de um menu, você define essa propriedade como False. .ErrorCancel Esta propriedade especifica se a variável Err deve ser definida se o usuário pressionar o botão Cancel Uma vez que uma caixa de diálogo comum esteja exibida, ela pode ser encerrada pelo pressionamento tanto do botão OK como do botão Cancel. Se .ErrorCancel estiver definida como True, Err será definida com o valor numérico 32755(CDERR_CANCEL). Se .ErrorCancel estiver definida como False, a variável Err não será afetada. .FileName Esta propriedade contém o nome do arquivo selecionado. A propriedade .FileName pode ser usada de duas maneiras. Primeiro, se definida antes da definição da propriedade .Action (antes da caixa de diálogo ser exibida), ela especifica o nome de arquivo inicial que é colocado na caixa de texto File Name. Segundo, quando o usuário de seu programa sai da caixa de diálogo via botão OK, o nome do arquivo que o usuário selecionou e colocado na propriedade. 34
- 35. .FileName Representação:Nome de arquivo escolhido Se aplica a: Caixa de listagem de arquivos Definida por meio de: Instrução de programa, interação com o usuário A propriedade .FileName de uima caixa de listagem de arquivos é definida com o texto de sua única entrada selecionada. A sintaxe deste texto é a seguinte: nomearq.ext O texto reflete somente o nome do próprio arquivo com sua extensão de três letras independente do diretório em que ele esteja. .FillColor Representação: Cor sólida de plotagem fechada Se aplica a: Formulário, figura, impressora Definida por meio de: Janela Propriedades, instrução de programa A propriedade .FillColor é definida com a cor RGB a ser reservada para todas as formas fechadas produzidas com métodos gráficos. O valor default de .FillColor é 0 (preto). .FillStyle Representação: Atribuição de padrão de plotagem fechada Se aplica a: Formulário, figura, impressora Definida por meio de: Janela Properties, instrução de programa A propriedade .FillStyle é definida com o padrão de preenchimento a ser reservado para todas as formas fechadas produzidas com métodos gráficos. O valor de .FillStyle pode ser qualquer dos valores descritos. A definição default de .FillStyle é 1, para transparente. .Filter Esta propriedade especifica o critério de procura que será usado para ajudar o usuário a encontrar um arquivo. A definição do filtro é dividida em três partes. A primeira parte é o texto que você deseja exibir na caixa de combinação "List files by Type", seguido do caractere |, seguido pelo usado para preencher a caixa de texto File Name. Por exemplo, a declaração CMDialog1.Filter = "Arquivos texto (*.TXT) | *.TXT faz com que as palavras "Arquivos texto (*.TXT) sejam exibidas na caixa de combinação "List files by Type" (listar arquivos por tipo) da caixa de diálogo. .FixedAlignment( ) Representação: Peso do texto em células não-móveis Se aplica a: Grade Definida por meio de: Janela Properties, instrução de programa A propriedade .FixedAlignment é um array cujos elementos individuais se aplicam, por número, às colunas de seu objeto grade antecedente - especificamente a suas células fixas. As definições de cada elemento refletem o eixo contra o qual é colocado o conteúdo textual das células fixas de cada coluna. As definições da propriedade são as mesmas usadas para .ColAlignment( ). .FixedRows, .FixedCols Representação: Quantidade de células não-móveis Se aplica a: Grade Definida por meio de: Janela Properties, instrução de programa .FontBold, .FontItalic, .FontStrikeThru e .FontUnderline Estas propriedades contêm um valor True ou False e especificam se os caracteres exibidos estão em negrito, em itálico, cortados (uma linha cortando ao meio), ou 35
- 36. sublinhados. Novamente, lembre-se de que essa caixa de diálogo não ativa nem desativa essas definições; ela siplesmente retorna as preferências do usuário. .FontBold, .FontItalic, .FontStrikethru, .FontTransparent e .FontUnderline Representação: Estilos de caractere Se aplica a: Verificação, combinação, comando, diretório, unidade de disco, arquivo, formulário, quadro, grade, etiqueta, listagem, figura, impressora, texto Definida por meio de: Janela Properties, instrução de programa As propriedades .Fontx de um objeto gráfico são definidas como valores True/False refletindo o estado da fonte representado por x. Em controles cujo conteúdo é definido por meio de propriedades, a definição das propriedades .Fontx em tempo de execução muda imediatamente a aparência na tela das fontes desses controles. Em controles de terminal virutal (formulário, impressora e caixa de figura), a definição dessas propriedades em tempo de execução muda a forma como o texto a ser impresso aparece, embora a aparência do texto já impresso permaneça a mesma. .FontCount FontCount Representação: Quantidade de estilos de tipos instalados Se aplica a: Impressora, tela Definida por meio de: Recurso do Windows A propriedade .FontCount contém o número atual de fontes Printer e Screen instaladas no Microsoft Windows. Essa propriedade também pode ser diferente para cada sistema de computador. .FontName e .FontSize Estas propriedades especificam o nome e tamanho da fonte selecionada pelo usuário. .Fonts( ) Representação: Estilos de tipo instalados Se aplica a: Impressora, tela Definida por meio de: Recurso do Windows A propriedade .Fonts se comporta como um array que contém o nome de cada fonte Printer ou Screen instalada no Microsoft Windows, em qualquer ordem que o sistema de manutenção de fontes atual do Windows tenha definido para essa lista. Esse array de propriedades pode ser diferente em cada sistema de computador. .GridLines Representação: Linhas de borda intermediárias Se aplica a: Grade Definida por meio de: Janela Properties, instrução de programa A propriedade .GridLines de um controle grade é definida como um valor verdadeiro ou falso que denota se as linhas de borda tracejadas devem aparecer entre cada célula da grade, tanto na área fixa quanto na área móvel. .Height Representação: Limite extremo inferior Se aplica a: Todos os controles, formulários, MDI Definida por meio de: Janela Properties, instrução de programa A propriedade do Visual Basic não são realmente tridimensionais; entretanto, quando o controle se sobrepõe, é 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 36
- 37. qual controle aparecerá "no topo", mas no vocabulário do VB, .Top significa "acima", e não "na frente de". Nesse caso, portanto, é apenas o vocabulário VB que na realidae faz referência direta a um eixo geométrico; e ele faz isso usando o método .ZOrder. .HideSelection Representação: Continuação de indicação de texto Se aplica a: Texto Definida por meio de: Janela Properties A .HideSelection de uma caixa de texto ou de combinação é definida como uma valor True/False e especifica se o texto selecionado permanece destacado quando o controle perde o foco. Por default essa propriedade é definida como True. .HighLight Representação: Permissão para colorir células indicadas Se aplica a: Grade Definida por meio de: Janela Properties, instrução de programa A propriedade .HighLight de um controle grade é definida como um valor True/False, denotando se a grade destaca automaticamente as células indicadas. Por default, essa propriedade é definida como True. .Icon Representação: Símbolo de formulário minimizado Se aplica a: Formulário, formulário MDI Definida por meio de: Janela Properties A propriedade .Icon de um formulário é definida com o nome de um arquivo de ícone em formato .ICO, que atua como símbolo desse formulário quando ele está minimizado (.WindowState=1). Embora não existam restrições quanto à localização do arquivo .ICO, ele deve estar no mesmo diretório 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 não ter a mesma estrutura de diretórios, e um erro pode ser gerado. .Image Representação: Conteúdo gráfico Se aplica a: Formulário, figura Definida por meio de: Execução do programa A propriedade .Image de um formulário ou caixa de figura é sempre definida com o conteúdo gráfico desse controle. Essa propriedade é definida indiretamente pelo uso de métodos para adicionar gráficos ao controle. .Index Se Aplica a: Todos os controles de um array Representação: Identificador do elemento do array Definida por meio de: Ordem de criação, janela Properties A propriedade .Index se refere a elementos de um array de controles, especialmente porque todos os elementos em um array compartilham a mesma propriedade .Name. 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 parênteses. Os índice dos controles de um array são designador em seqüência em tempo de projeto. Sua seqüência também pode ser reorganizada no projeto usando a janela Properties. O índice de um controle é fixo ao longo do tempo de execução de um aplicativo. .Interval 37
- 38. Representação: Valor de ativação do timer Se aplica a: Timer Definido por meio de: Janela Properties, instrução de programa A propriedade .Interval de um timer é a quantidade de tempo em milissegundos (milésimos de segundo) que o timer do formulário conta antes de invocar um evento _Timer. O valor da propriedade varia de 0 a 65.535 milissegundos, onde 60.000 milissegundos são iguais a um minuto. A propriedade .Interval costuma ser definida como 1000 para que os eventos ocorram a cada segundo. .Left Representação: Coordenada do eixo X Se aplica a: Todos os controles, formulários, MDI Definida por meio de: Janela Properties, instrução de programas A propriedade .Left de um formulário é definida com a distância em twips (1/1440 de uma polegada lógica) entre o ponto de origem do formulário e a borda mais à esquerda da tela. O ponto de origem é o primeiro ponto endereçável pelo usuário no canto inferior esquerdo do formulário; se o formulário tem bordas, elas aparecem em volta do ponto original. A propriedade .Left de um controle é definida como a distância em twips entre o ponto de origem do controle e o ponto mais à esquerda do formulário. .List( ) Representação: Conteúdo de entrada na lista Se aplica a: Combinação, listagem Definida por meio de: Instrução de programa Você acessa a propriedade .List da mesma forma que acessa um array de controles; você endereça o conteúdo de uma entrada na lista em um determinado índice como .List(indice%). Você pode então tratar a propriedade exatamente como você faria com um variável de array. Assim, se você usar .AddItem para reservar um conteúdo na lista, o conteúdo de texto da lista em um índice pode ser atribuído a uma variável de string. .ListCount Representação: Quantidade de entradas na lista Se aplica a: Combinação, unidade de disco, arquivo, listagem Definida por meio de: Curso da execução do programa A propriedade .ListCount de uma caixa de listagem ou de combinação é sempore definida como o número de entradas atualmente contidas dentro dela. O valor de .ListCount - 1 é o número de índice da última entrada da lista, porque a primeira entrada tem um índice de 0 em vez de 1. .ListIndex Representação: Localização da entrada escolhida Se aplica a: Combinação, unidade de disco, arquivo, listagem Definida por meio de: Instrução de programa, curso da execução de programa. A propriedade .ListIndex contém o índice do item previamente escolhido na lista. Você também pode usar essa propriedade para fazer com que o usuário escolha um item da lista. Simplesmente atribua um valor de índice à propriedade com uma equação, usando a seguinte sintaxe: Caixalist.ListIndex = númíndice% Se o usuário não escolhe um item, .ListIndex é definida como -1 (não confunda isso com o valor Booleano para Verdadeiro). .Max e .Min 38
- 39. Estas propriedades especificam o intervalo de páginas que pode ser impresso. Por exemplo, se .Min tem o valor 1 e .Max tem o valor 6, o usuário só pode imprimir entre as páginas 1 e 6. .Max e .Min Representação: Extenção de intervalo de valores Se aplica a: Barra de rolagem Definida por meio de: Janela Properties, instrução de programa As propriedades .Max e .Min de uma barra de rolagem são definidas com os valores de coordenada máximo e mínimo 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 .Max permaneça maior que .Min. Quando definido, o comprimento da barra de rolagem é dividido em (.Max - .Min) intervalor. A movimentação da caixa de rolagem ao longo da barra define sua propriedade .Value co valor igual ao intervalor onde a caixa se entra atualmente. .MaxButton Representação: Inclusão de controle de maximizção Se aplica a: Formulários Definida por meio de: Janela Properties A propriedade .MaxButton é definida como um valor True ou False, refletindo se o botão de maximizar da janela aparece no formulário para esse janela. Por default, a propriedade .MaxButton de um novo formulário é definida como verdadeira. .MDIChild Representação: Designação de subordinação MDI Se aplica a: Formulários Definida por meio de: Janela Properties A propriedade .MDIChild de um formulário é definida como lógico True ou False, representando se esse formulário deverá ou não ser usado como modelo para formulários filho MDI aparecem dentro da área de trabalho de um pai MDI. .MinButton Representação: Status de exibição do controle de minimização Se aplica a: Formulários Definida por meio de: Janela Properties A propriedade .MinButton é definida como um valor True ou False, refletindo se o botão de minimizar da janela aparece no formulário para essa janela. Por default, a propriedade .MinButton de um novo formulário é definida como verdadeira. .MousePointer Representação: Aparência do apontador Se aplica a: Verificação, combinação, comando, diretório, unidade de disco, arquivo, formulário, quadro, imagem, etiqueta, listagem, opção, figura, tela, rolagem, texto. Definida por meio de: Janela Properties, instrução de programa A propriedade .MousePointer de um objeto gráfico é definida como um valor inteiro que representa a aparência do apontador do mouse sempre que este entra na região do objeto. Quando o apontador do mouse sai da região do objeto, a forma do apontador volta para seu estado padrão ou para o estado designado pela propriedade .MousePointer de seu objeto pai. a propriedade pode ser definida com qualquer dos seguintes valores: 0 Estado padrão conforme determinado pelo Windows 1 Arrow: a seta padrão do Windows 39
- 40. 2 Cross: uma cruz fina 3 I-Bean: o apontador de localização de texto 4 Icon: (não confundir com um ícone, a despeito de seu nome) um bullet quadrado 5 Size: uma seta de quatro pontas 6 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 8 Size NW SE: uma seta de duas pontas dirigidas para noroeste e sudeste 9 Size WE: uma seta de duas pontas dirigida para leste e oeste 10 Up Arrow: seta para cima 11 Wait: o símbolo de ampulheta do Windows 12 No Drop: o símbolo de círculo com uma barra indicando uma violação de movimento de controle .MultiLine Representação: Capacidade de múltiplas linhas Se aplica a: Texto Definida por meio de Janel Properties A definição da propriedade .MultiLine reflete se é dada permissão ao interpretador Visual Basic para gerar avanços de linha em um campo de texto quando seu conteúdo tiver excedido seu comprimento. Dessa forma, se o conteúdo textual de um campo de texto pode ser quebrado em múltiplas linhas usando "word-wrap" se .MultiLine estiver definida como lógico True (ou On). .MultiSelect Representação: Capacidade de escolha de múltiplas entradas Se aplica a: Arquivo, listagem Definida por meio de: Janela properties A propriedade .MultiSelect de uma caixa de listagem padrão ou caixa de listagem de arquivos é definida como um valor que especifica se o usuário pode escolher mais de uma entrada na lista, e até que ponto o usuário pode fazer múltiplas escolhas. Você pode definir a propriedade com qualquer dos seguintes valores: 0 Só permite que o usuário escolha entradas individuais. A escolha de um segundo item da mesma lista sobrescreve a primeira escolha e desfaz sua seleção. 1 Permite que o usuário selecione múltiplas entradas, uma de cada vez. O usuário pode escolher qualquer número de itens clicando neles (se você estiver usando o teclado, pressione a barra de espaço); nenhuma escolha é sobrescrita. 2 Permite que o usuário selcione múltiplas 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 então a de uma outra enquanto se mantém pressionada a tecla Shift, seleciona ambas as entradas e todas as intermediárias. Os programadores Visual Basic já se acostumaram a usar a propriedade .ListIndex para determinar qual única entrada da lista o usuário escolheu. Se você tem múltiplas entradas escolhidas a partir da caixa de listagem, de que vale .ListIndex se ela só diz a você a última entrada escolhida? O que você precisa é uma instrução que informe em um valor verdadeiro ou falso se o usuário escolheu uma entrada específica. Para conseguir isso, a Microsoft mais uma vez se tornou um tanto liberal em seu escolha de sintaxe orientada para objeto. .Name Pertinente a: Todos os controles Representação: Título de referência Definida por meio de: Somente janela Properties 40
- 41. A propriedade .Name de um objeto gráfico, ou uma matriz de objetos relacionados, é definida com um nome arbitrário quando da estruturação. Essa propriedade se torna o nome declarado à esquerda do ponto quando o objeto gráfico é endereçado dentro do código-fonte do programa, usando sintaxe orientada para objeto. Por default, o .Name de um formulário leva a sintaxe Formn, na qual n representa a ordem na qual o formulário foi adicionado ao projeto. Quando da estruturação, ao ser desenhado um controle no formulário, o interpretador dá a ele a sintaxe Controlen, onde Controle siginifica o tipo de controle e n o número de acesso entre controle de tipo similar, representando a ordem na qual esse controle foi adicionado ao formulário. Você pode optar por deixar essas propriedades .Name como se encontram inicialmente, ou usar a janela Properties; você pode optar por modificá-los para o que lhe parecer mais apropriado. .Page Representação: Página atual da impressora Se aplica a: Impressora Definida por meio de: Curso da execução do programa A propriedade Printer.Page é definida com o número de página atual mantido pelo interpretador VB para um aplicativo. Cada vez que um aplicativo começa a ser executado, a propriedade .Page é definida como 1. O interpretador assume que um único documento está sendo criado para este aplicativo a qualquer dado instante. Cada vez que uma página tem sua impressão terminada, a propriedade .Page é incrementada. .PasswordChar Representação: Caractere de substituição de posição Se aplica a: Texto Definida por meio de: Janela Properties, instrução de programa A propriedade .PasswordChar de uma caixa de texto é definida com um único caractere alfanumérico 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 usuário está digitando. Quando definida com um valor nulo, os caracteres são inseridos na caixa de texto conforme suas teclas são pressionadas. .Path Representação: Caminho de diretório ativo Se aplica a: Diretório, arquivo Definida por meio de: Instrução de programa, interação com o usuário A propriedade .Path de uma caixa de listagem de diretório é definida com o texto de sua única entrada selecionada. A sintaxe deste texto é a seguinte: drive:[diretorio[subdiretorio. . . ]] O conteúdo textual da propriedade .Path reflete o caminho dos subsdiretórios onde um arquivo reside ou onde uma procura de arquivo está sendo conduzida. O texto não contém um nome de arquivo. .Pattern Representação: Padrão de procura atual Se aplica a: Caixa de listagem de arquivos Definida por meio de: Janela Properties, instrução de programa, interação com o usuário A propriedade .Pattern de uma caixa de listagem de arquivos é definida como o padrão de procura atual com o qual cada arquivo dentro do diretório atualmente ativo é comparado para determinar se esse arquivo deve ou não aparecer na lista. O efeito é a 41
- 42. arestrição dos nomes de arquivo aparecendo na caia de listagem de arquivos para um grupo de seleção. O padrão de procura pode conter - e normalmente contém caracteres curinga tais como * e ? que representam qualquer número de caracteres ou um único caractere, respectivamente. Por default, a propriedade .Pattern é definida como *.* (todos os nomes de arquivo). .Picture Representação: Fundo gráfico Se aplica a: Formulário, imagem, figura A propriedade .Picture é 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 extensão BMP (bitmap do Windows), ICO (ícone padrão), 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 além das bordas direita e inferior da caixa, respectivamente. .Row, .Col Representação: Localização de ponteiro de célula Se aplica a: Grade Definidas por meio de: Instrução de programa, interação com o usuário As propriedades .Row e .Col de uma grade são definidas com as coordenadas atuais do ponteiro interno daquela célula 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 célula em (0,0) é geralmente uma célula fixa de qualquer modo; a primeira célula enderaçável que aparece no canto superior esquerdo de uma região de dados não fixa da grade é normalmente (1,1). Por essa razão, as definições default de .Row e .Col são ambas 1. .RowHeight( ), .ColWidht( ) Representação: Tamanho de célula Se aplica a: Grade Definidas por meio de: Instrução de programa, interação com o usuário As propriedades .RowHeight e .ColWidht de um controle grade são na realidade arrays cujo comprimento, em elementos, é definido automaticamente como as .Rows (linhas) e .Cols (colunas), respectivamente, da grade atual. Os elementos dessas propriedade de array são definidos com a altura e largura em twips das células de suas respectivas linhas e colunas. Em tempo de execução, o usuário pode mudar as definições dessas propriedades usando o apontador do mouse para fazer os limites entre linhas e colunas deslizarem para novas posições. Esse deslizamento não dispara eventos para grade. .Rows, .Cols Representação: Extensão de células Se aplica a: Grade Definida por meio de: Janela Properties, instrução de programa .ScaleLeft, .ScaleTop, .ScaleWidth e .ScaleHeight Representação: Estabelecimento de coordenadas geométricas variáveis Se aplica a: Formulário, MDI, figura e impressora Definida por meio de: Janela Properties, instrução de programa As propriedades .ScaleLeft e .ScaleTop são definidas com o par de coordenadas que representa o ponto do canto superior esquerdo do objeto antecedente. A propriedade .ScaleWidth representa o número de divisões no eixo x na escala de coordenadas do 42
- 43. objeto antecedente. Da mesma forma, a propriedade .ScaleHeight representa o número de divisões no eixo y na escala de coordenadas do objeto antecedente. .ScaleMode Representação: Escolha do sistema de coordenadas Se aplica a: Formulário, figura, impressora A propriedade .ScaleMode de um objeto gráfico 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: 0 Definido pelo usuário. Essa definição entra em vigor automaticamente quando o programador define a escala do objeto antecedente com um valor variável. 1 Sistema de coordenadas de twips (o default) 2 Pontos, aproximadamente 72 pontos por polegada em um monitor com diagonal de 14'' 3 Sistema de coordenadas de pixels, determinado pelo uso da resolução de tela atual do Microsoft Windows 4 Sistema baseado em caracteres, representado 12 caracteres por polegada horizontalmente e seis linhas por polegada, quando impressas em um dispositivo de impressora padrão 5 Polegadas, novamente assumindo um monitor com diagonal de 14'' 6 Milímetros 7 Centímetros .ScrollBars Representação: Permissão para anexação de barram de rolagem Se aplica a: Caixa de texto, grade, MDI Definida por meio de: Janela Properties A propriedade .ScrollBars dá ao interpretador Visual Basic permissão para colocar barras de rolagem nos lados de uma caixa de texto se o seu conteúdo textual exceder o número de linhas ou colunas que você tiver definido para ela. A propriedade é definida quando em tempo do projeto como um valor binário 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 questão 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 .ScrollBars pode ser definido com qualquer dos seguintes valores: 0 Nenhuma barra de rolagem(default) 1 Barra de rolagem horizontal 2 Barra vertical 3 Ambas as barras de rolagem .Selected( ) Representação: Status de escolha de entrada da lista Se aplica a: Arquivo, listagem Definida por meio de: Instrução de programa, interação com o usuário A propriedade .Selected é na realidade uma matriz de propriedades que pertence, por número de índice, a cada uma das entradas da caixa de listagem antecedente, começando pelo número de índice zero. A propriedade é definida com um valor verdadeiro ou falso denotando se o usuário selecionou o número de entrada de lista subscrito. Você pode definir o valor da propriedade manualmente dentro do códigofonte usando uma instrução com o seguinte sintaxe: Caixalist.Selected(indice%) = booleano% 43
- 44. .SelLenght Representação: Número de caracteres indicados Se aplica a: Combinação, texto Definida por meio de: Instrução de programa, interação com o usuário A propriedade .SelLenght é definida com o número de caracteres sendo extraídos à direita da posição do cursor .SelStart. Essa seleção é sempre destacada se a propriedade .HideSelect da caixa de texto estiver definida como falsa. .SelStart Representação: Posição inicial da indicação de texto Se aplica a: Combinação, texto Definida por meio de: Instruçãp de program, interação com o usuário A propriedade .SelStart é definida com um valor que designa onde o cursor aparece no texto de uma caixa de texto. Essa posição é onde a extração desse corpo de texto começa. Cada caractere de texto da caixa tem o seu próprio número de índice, começando com o caractere 1 no início do texto. A definição do valor de .SelStart coloca o cursor à direita do caractere indexado; uma definição 0 o coloca no início do texto. A posição do cursor também é chamada de ponto de inserção. .SelStartRow, .SelEndRow, .SelStartCol e .SelEndCol Representação: Cantos de bloco de seleção de células Se aplica a: Grade Definidas por meio de: Instrução de programa, interação com o usuário As propriedades .Selx de um controle grade são definidas com os números de linha e coluna de células refletindo o início e fim de um bloco retangular de células indicadas. As propriedades .SelStartRow e .SelEndRow são definidas com os número de linh inicial e final do bloco indicado, respectivamente. Da mesma forma, as propriedades .SelStartCol e .SelEndCol são definidas com os números de coluna inicial e final do bloco indicado, respectivamente. A definição dessas propriedades com valores diferentes de zero indici manualmente o processo de indicação de células. Quando o usuário clica e mantém pressionado o botão indicador do mouse sobre uma grade, essas propriedades são definidas no processo. .SelText Representação: Texto indicado Se aplica a: Combinação, texto Definida por meio de: Instrução de programa, interação com o usuário A propriedade .SelText é definida com o conteúdo do texto sendo indicado na caixa de texto. A definição das propriedades .SelStart e .SelLenght de uma caixa de texto define automaticamente a propriedade .SelText com os caracteres começando na posição .SelStart e se estendendo por .SelLenght caracteres. A definição manual da propriedade .SelText substitui o texto indicado pelo conteúdo da própria propriedade, ou insere esse texto na posição atual do cursor caso nenhum texto esteja indicado. .Shape Representação: Identidade de elemento gráfico Se aplica a: Botão de controle Shape Definida por meio de: Janela Properties, instrução de programa A propriedade .Shape de um elemento gráfico desenhado em um formulário usa o botão 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 opções: 44
- 45. 0 Retângulo (default) 1 Quadrado 2 Oval 3 Círculo 4 Retângulo arredondado 5 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 são determinadas pela posição das coordenadas dos vértices do controle dentro do formulário. A propriedade .Shape afeta somente o aspecto do elemento gráfico mostrado por esse controle shape. Nos casos 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 .Height ou .Width, menor alguns pixels como margem. Nos casos 4 e 5, a quantidade de arredondamento aplicada aos cantos do elemento gráfico é fixa - usando um termo de diagramação de figura, eles usam um molde de canto uniforme. .SmallChange e .LargeChange Representação: Intervalos de alteração de valor Se aplica a: Barra de rolagem Definida por meio de: Janela Properties, instrução de programa A definição da propriedade .SmallChange de uma barra de rolagem representa o grau de incremento ou decremento em seu valor representado quando um dos botões de sera é clicado. Quando o usuário clica no botão de seta, a caixa de rolagem da barra é movida, em relação a seu sistema de coordenadas atual de representação, em direção à seta. Similarmente, a definição da propriedade .LargeChange representa o grau de incremento ou decremento no valor representado da barra de rolagem quando o usuário clica entre a caixa de rolagem e um dos botões de seta na direção da seta. Essa zona de barra de rolagem costuma ser chamada de área de paginação. .Sorted Representação: Status de ordenação da lista Se aplica a: Combinação, listagem Definida por meio de: Janela Properties A propriedade .Sorted de uma caixa de listagem ou de combinação é definida como um valor verdadeiro ou falso que denota se as entradas contidas na lista deverão parecer classicadas em ordem ascendente alfanumérica. Quando .Sorted é definida como verdadeira, a classificação não continua no decorrer do programa. Portanto, se um método .AddItem é invocado para incluir um número de índice específico, o tiem aparece na lista naqula posição, embora isso possa resultar em uma lista não classificada. A adição de entradas na lista ou a remoção de entradas da lista não afeta o valor da propriedade .Sorted. .Stretch Representação: Permissão para redimensionar automaticamente o conteúdo Se aplica a: Imagem Definida por meio de: Janela Properties, instrução de programa A propriedade .Stretch de uma caixa de imagem é definida como um valor True/False denotando se ao interpretador é dada a permissão de esticar (ou encolher) o conteúdo gráfico de uma caixa de imagem para acomodar os limites existentes desse controle. .Style Representação: Inclusão de caixa de texto 45
- 46. Se aplica a: Combinação listagem Definida por meio de : Caixa de ferramentas, janela properties A propriedade .Style é definida como um inteiro que denota a aprência de uma lista no formulário. Suas definições possíveis são as seguintes: Drop-down combo. Essa definição permite que o usuário insira um valor usando tanto o teclado como uma lista pull-down. Simple combo. Essa definição também permite que o usuário 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 definição não inclui uma área de edição, o usuário só pode selecionar opções na lista pull-down. .TabIndex Representação: Ordenação de entrada de texto Se aplica a: Todos os controles Definida por meio de: Janela Properties, instrução de programa A propriedade .TabIndex de um controle é definida como sua ordem numérica na seqüência de tabulação dentro de seu formulário associado. Por default, a seqüência de tabulação dentro de seu formulário associado. Por default, a seqüência de tabulação dos controles em um formulário é estabelecida por sua ordem de criação quando da estruturação; essa seqüência pode ser reorganizada na estruturação ou em tempo de execução. Por default, as etiquetas têm suas propriedades .TabIndex atribuídas, embora elas não sejam oficialmente parte da seqüência de tabulação de um formulário. .TabStop Representação: Particiàção na seqüência de teclado Se aplica a: Todos os controles Definida por meio de: Janea Properties, instrução de programa A definida propriedade .TabStop de um controle é um indicador True/False refletindo se ele está participando da seqüência de tabulação. Uma definição False significa que o usuário não pode indicar o controle pressionando Tab. Por default, .TabStop é definida como True. Um controle pode ser uma parada de tabulação como uma banco de praça pode ser um ponto de ônibus. Para designar que a rota dos Tabs não pare em um determinado controle - de certa forma, para tirar o banco doponto de ônibus - defina seu valor como False. . Tag Se Aplica a: Todos os controles padrão Representação: Nome alternativo de título do controle Definida por meio de: Janela Properties, instrução de programa A propriedade .Tag de um objeto gráfico é definida com um nome arbitrário, para um propósito que o programador pode definir. Na maioria das operações, essa propriedade é completamente ignorada pelo interpretador VB. Em situações onde uma procedure pesquisa o conteúdo de um controle não denominado, porém, a procedure pode usar .Tag como um identificador para o controle se você atribuiu um título único a ele. O interpretador VB não verifica as definições da propriedade .Tag para garantir sua exclusividade, como faz com as definições .Name. Por default, o .Tag de um objeto gráfico é uma string nula. .Text Representação: Conteúdo textual editável Se aplica a: Campo de texto, combinação 46
- 47. Definida por meio de: Janela Properties, instrução de programa, interação com o usuário A propriedade .Text de um controle é definida com seu conteúdo textual. Você pode mudar esse conteúdo em tempo de execução através de interação direta com o controle. Com respeito especificamente a caixas de combinação, a propriedade .Text é definida com o item atualemente escolhido na lista, parecendo em susa caixa de texto, na parte superior. O comprimento máximo em caracteres da definição de uma propriedade .Text é 2.048 caracteres. .Top Representação: Coordenada do eixo Y Se aplica a: Todos os controles, formulários e MDI Definida por meio de: Jnaela Properties, instrução de programa A propriedade .Top de um formulário é definida como a distância em twips entre o ponto de origem do formulário e a borda superior da tela. A propriedade .Top de um controle é definida como a distância em twips entre o ponto de origem do controle e ponto mais acima do formulário. .TopRow, .LeftCol Representação: Primeira célula de dados visível Se aplica a: Grade Definida por meio de: Instrução de programa As propriedades .TopRow e .LeftCol de uma grade podem ser definidas em uma procedure como as coordenadas da célula visível mais acima e mais à esquerda, respectivamente, na grade. Essas propriedades não afetam o posicionamento de célula fixa na grade, nem afetam a posição dos ponteiros de células atuais .Row e .Col. .TwipsPerPixelX e .TwipsPerPixelY Representação: Fator de conversão de escalas coordenadas Se aplica a: Tela, impressora Definidas por meio de: Recurso do Windows As propriedades .TwipsPerPixelX e .TwipsPerPixelY dos objetos Screen e Printer são definidas pelo Windows com o número inteiro aproximado de twips por pixel plotado. .Value Representação: Status dentro de um intervalo Se aplica a: Caixa de verificação, botão, pronto de opção, barra de rolagem Definida por meio de: Janela Properties, instrução de programa, interação com o usuário. A propriedade .Value, para um botão de opção, é definida tanto como ligado ou desligado. Essa definição especifica se o usuário escolheu a opção. Para uma caixa de verificação, .Value é definida como 0, 1 ou 2. Essa definição específica se a caixa está vazia, marcada, ou escurecida (tornada indisponível), respectivamente. Para um botão de comando, .Value é definida como True ou False, dependendo de o usuário ter simplesmente clicado no botão. .Visible Representação: Status de exibição de controle Se aplica a: Todos os controles, menus, formulários Definida por meio de: Janela Properties, Janela Menu Design, instrução de programa A propriedade .Visible de um controle é definida como um valor True ou False que designa se o controle pode ser visto. Um controle invisível não responde. Por default, essa propriedade é definida como True. Para fazer esse controle desaparecer ou para 47
- 48. eliminar temporariamente uma seleção de um menu, você pode definir essa propriedade como False. Definir a propriedade .Visible de um formulário como False é virtualmente o mesmo que chamar o método .Hide para esse formulário. .Width Representação: Limite extremo direito Se aplica a: Todos os controles, formulários, MDI Definida por meio de: Janela Properties, instrução de programa A propriedade .Width de m objeto é definida como a distância em twips entre os dois lados verticais desse objeto. Com efeito, essa definição estabelece a coordenada do eixo y do ponto no canto inferior direito do objeto. .WindowList Representação: Status de listagem filha MDI Se aplica a: Menus Definida por meio de: Janela Menu Design A propriedade .WindowList para uma categoria de menu de um formulário pai MDI é definida como um valor on/off que indica se o painel de menu da categoria irá exibir uma lista de todas as janelas filhas MDI que estão atualmente abertas. Cada janela filha é listada pelo nome em sua barra de título. A listagem da janela filha que possui atualmente o foco é marcada automaticamente em tempo de execução. .WindowState Representação: Status operativo de janela Se aplica a: Formulário Definida por meio de: Janela Properties, instrução de programa A definição atual da propriedade .WindowState é um inteiro que representa o estado de operação do formulário antecedente como uma das seguintes condições. 0 Emoldurado ou com borda 1 Minimizado; reduzido para um ícone representativo 2 Maximizado; sem borda, e passível de preencher a tela inteira. .X1, .Y1, .X2, .Y2 Representação: Coordenadas geométricas Se aplicam a: Objetos Line Definidas por meio de: Projeto do controle, janela Properties, instrução de programa As propriedades .X1, .Y1, .X2 e .Y2 de um objeto line representam as coordenadas geométricas dos vétices dessa linha, com respeito ao sistema de escala atualmente em uso nesse formulário. As referências de coordenadas seguem o sistema cartesiano de vértices (x1, y1) - (x2, y2) ao longo de um plano bidimensional. Alinhamento Representação: Peso do texto contido Se aplica a: Verificação, etiqueta, opção, texto Definida por meio de: Janela Properties, instrução de programa A propriedade .Alignment 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: 0 Justificação esquerda (default) 1 Justificação direita 2 Centrado Para um controle caixa de verificação ou ponto de opção, a propriedade .Alignment reflete o lado do controle que o botão ocupa. Quando definida como 0, o botão aparece 48
- 49. no lado extremo esquerdo do controle com a etiqueta de texto imediatamente à sua direita; quando definida como 1, o botão aparece no extremo direito com o texto à sua esquerda. AutoSize Representação: Permissão para economia de espaço Se aplica a: Etiqueta, figura Definida por meio de: Janela Properties, instrução de programa Propriedade .AutoSize de uma figura ou etiqueta é definida como um valor True / False. Esse valor reflete se é dada permissão para que o limite inferior do controle no formulário seja reduzido para se ajudar ao conteúdo atribuído a esse controle. Columns Representação: Inclusão de coluna na lista Se aplica a: Listagem Definida por meio de: Janela Properties A propriedade .Columns de uma caixa de listagem especifica o número de colunas que uma caixa de listagem pode conter, menos um. A definição default da propriedade .Columns é 0, denotando, de fato, uma definição "false" para múltiplas colunas. Com a definição 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 usuário navegue para cima e para baixo na lista. Com .Columns 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 começando por essa entrada, na próxima coluna à direita. Uma barra de rolagem horizontal é exibida sempre que a largura total das colunas múltiplas excede a da caixa de listagem. FontName Representação: Atributo de estilo de caractere Se aplica a: Verificação, combinação, comando, diretório, unidade de disco, arquivo, formulário, quadro, grade, etiqueta, listagem, opção, figura, impressora, texto Definida por meio de: Janela Properties, instrução de programa A propriedade .FontName de um objeto gráfico é 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 impressão ou atribuição de texto a um formulário, objeto gráfico ou impressora é referida pelo nome. FontSize Representação: Atributo de tamanho de caractere Se aplica a: Verificação, combinação, comando, diretório, unidade de disco, arquivo, formulário, quadro, grade, etiqueta, listagem, opção, figura, impressora, texto Definida por meio de: Janela Properties, instrução de programa A propriedade .FontSize de um objeto gráfico é definida como o tamanho aproximado em pontos disponível para um fonte que tenha seu .FontName atual suportado pelo Windows e que seja no momento a .FontName escolhida para a impressão e atribuição de texto. WordWrap Representação: Permissão para criação de espaço auxiliar Se aplica a: Etiqueta Definida por meio de: Janela Properties, instrução de programa 49
- 50. A propriedade .WordWrap de uma etiqueta é definida como um valor True/False. Esse valor reflete se é dada permissão para que o limite inferior do controle seja expandido para se ajustar ao conteúdo atribuído à propriedade .Caption da etiqueta. Instruções do Visual Basic Beep Propósito: Ativação de som interno. Sintaxe: Beep A instrução Beep faz soar um ruído do tipo bip. Essa instrução não leva parâmetros. Call Propósito: Desvio entre procedures Sintaxe 1: Call nome_da_procedure ( [argumento1, argumento2, . . . ] ) Sintaxe 2: nome_da_procedure [argumento1, argumento2 . . . ] Quando a instrução Call é processada, ou quando o nome de uma procedure definido é invocado no código fonte, é feito um desvio para a procedure Sub assim chamada. Quaisquer valores a serem passados para a procedure como argumentos são listados ao lado de nome_da_procedure na ordem na qual eles devem ser recebidos pela instrução de abertura da procedure Sub. Se são passados valores para a procedure Sub, as variáveis correspondentes listadas na instrução de abertura da procedure Sub, as variáveis correspondentes listadas na instrução de abertura da procedure recebem seus valores. Quaisquer modificações feitas nos valores ou conteúdo dessas variáveis ao longo do curso da procedure serão refletidas nas variáveis correspondetes da chamada da procedure, a menos que especificado em contrário com ByVal. Close Propósito: Terminação de ponteiro de dados Sintaxe: Close [#]canal1%[, canal2%, . . . canaln%] A instrução Close termina o acesso aos arquivos de dados com nomes que foram atribuídos pela instrução Open aos números de canal% listados. Quaisquer instruções de leitura ou escrita após Close pertinentes aos números de canal declarados imediatamente antes, dentro de Close geram erros. O acesso a arquivos usando esses números só pode ser redeclarado pelo uso de uma instrução Open. Close cancela qualquer associação entre os números declarados e os nomes de arquivos atribuídos a eles pela instrução Open, portanto você pode usar novamente os números para outros nomes de arquivo. Os sinais # são opcionais antes de cada número de canal. Se nenhum número de canal for especificado, todos os canais abertos serão fechados. Const Propósito: Declaração de constantes Sintaxe: [global] Const nome = expressao [, nome = expressao . . . ] A instrução Const é usada para declarar o termo para representar um valor fixo (não variável) para uso em expressões, O escopo de uma constante é determinado pela posição de sua declaração no código-gfonte. Uma constante declarada dentro de uma 50
- 51. procedure Sub ou function terá escopo local. Uma constante declarada dentro de da área geral de um módulo tem escopo modular. Uma constante declarada dentro de um módulo geral pelo uso do termo global tem escopo global. DefCur, DefDbl, DefInt, DefLng, DefSng, DefStr e DefVar Propósito: Restrição de variáveis alfabéticas Sintaxe: DefCur intervalo[, intervalo[, intervalo. . . ] ] DefDbl intervalo[, intervalo[, intervalo. . . ] ] DefInt intervalo[, intervalo[, intervalo. . . ] ] DefLng intervalo[, intervalo[, intervalo. . . ] ] DefSng intervalo[, intervalo[, intervalo. . . ] ] DefStr intervalo[, intervalo[, intervalo. . . ] ] DefVar intervalo[, intervalo[, intervalo. . . ] ] Cur Moeda Dbl Ponto flutuante de precisão dupla Int Inteiro padrão Lng Inteiro longo Sng Ponto flutuante de precisão simples Str String alfanumérica Var Variant Dim Propósito: Declaração de variável Sintaxe 1 (simples): Dim variável ([inteiro]) Sintaxe 2 (complexa): Dim variavel ( [inteiro] ) [, variavel2 ( [ inteiro] ) . . . variavel60 ( [ inteiro ] ) ] [ As [ New ] tipo] Sintaxe 3 (complexa): Dim variavel1[(inteiro [to inteiro] [, inteiro [to inteiro]])] [As [New] tipo] [, variavel2 [ ( [inteiro[To inteiro] [, inteiro [To inteiro] ] ) ] [As [New] tipo] , . . . variavel60 [ ( [inteiro[To inteiro] [,inteiro [To inteiro] ] ) ] [As [New] tipo] ] A declaração Dim determina pelo menos uma variável array como sendo uma lista ou tabela de valores ou string que são endereçáveis por número. Esse número é um inteiro, e é usado como um endereço para representar o lugar de um fragmento de dados na lista. Esse número indicador é normalmente chamado de índice. Um array unidimensional, vetor ou lista, é geralmente declarada pelo uso de um inteiro (ou expressão inteira) entre os parênteses. 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 são separados pelo termo To. Uma matriz bidimensional, ou tabela, é declarada pelo uso de dois inteiros entre cada par de parênteses, separados por uma vírgula. Esses inteiros representam as diferenças, ou eixos da tabela, como nos eixos x e y de um gráfico. Ambos os inteiro representam os índices mais altos ao longo de seus respectivos eixos, a menos que o termo To 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 três eixos, é declarada da mesma forma usando três conjuntos de inteiros separados por vírgulas. A menos que especificado em contrário, uma variável não tendo símbolo de tipo ou qualificador tipo formal ao lado do termo As é dimensionada como uma variant, ou tipo desconhecido. Uma vez que um valor ou conteúdo seja atribuído a essa variável, o interpretador determina um tipo não oficial para a variável, embora seu tipo oficial ainda seja uma Variant. Você pode estabelecer um tipo oficial formal para cada variável na lista de dimensões seja pela anexação de um símbolo de tipo à variável ou pela declaração do tipo como um termo opcional seguinte ao termo As. 51
- 52. A colocação da declaração Dim se restringe à seção de declarações gerais de um módulo, ou para uma procedure. O escopo das declarações de variáveis pelo uso de Dim pode ser modular se feitas na seção de declarações gerais, ou local se feitas dentro de uma procedure. Você pode declarar até 60 variáveis usando uma única declaração Dim. DoEvents Propósito: Mudança de prioridade os eventos Sintaxe: [formulário%] = DoEvents[ ( ) ] A intrução DoEvents suspende a execução da procedure atual. Isso permite que o interpretador VB passe o controle para quaisquer procedures de evento que tenham sido disparadas pelo usuário, e que estavam esperando para serem executadas na fila de eventos. A instrução permite então que o Windows atualize todos os objetos gráficos e passe o controle para outros aplicativos na área de trabalho do Windows para quaisquer tarefas para as quais eles estivessem esperando no background. DoEvents direciona a procedure atual para abrir caminho para qualquer outra coisa que peça permissão de execução. Quando usado em uma frase como uma função, DoEvents retorna na variável formularios% um valor inteiro equivalente ao número de formulários atualmente carregados na área de trabalho do aplicativo Visual Basic. Você acabou de ler sobre o processo de execução geral de aplicativo Visual Basic. Como esse processo já está definido para você pelo interpretador do Visual Basic, você achará mais fácil estruturar um projeto com múltiplos módulos e procedures. A princípio, porém, a curva de aprendizado para organização de módulos e procedures em um projeto VB pode ser melhor descrita como uma inclinação íngreme. Do [While | Until]...Loop [While | Until Propósito: Demarcação de loop condicional/incondicional Sintaxe 1: Do [{While | Until} expressao] bloco de instrucoes1 [Exit Do] [bloco de instrucoes2] ... Loop Sintaxe 2: Do bloco de instrucoes1 [Exit Do] [bloco de instrucoes2] ... Loop [{While | Until} expressao] A cláusula Do-Loop executa repetidamente o conjunto de instruções nela contido. A execução desse conjunto pode ou não depender de uma expressão condicional opcional. Se uma condição é expressa, a execução do conjunto pode ser terminada. Se uma condição não é expressa, o loop é considerado infinito e só pode ser terminado com uma instrução Exit Do. Na Sintaxe 1, uma expressão condicional é feita no início da cláusula, seguindo Do. Se essa expressão está precedida de While, a execução das instruções na cláusula ocorre em seqüência, contanto que a expressão seja avaliada como True. Se a expressão está preceduida por Until, a execução ocorre em seqüência contanto que a expressão eja avaliada como False - em outras palavras, quando a expressão é True, a cláusula é terminada. Se a expressão While é False ou a expressão Until é True, a execução pula 52
- 53. para a instrução seguinte a Loop. Se esta é a primeira iteração do loop e a execução pula para Loop, as instruções da cláusula nunca serão executadas. Sob a sintaxe 2, uma expressão condicional é feita no final da cláusula, em seguida Loop. As regras que governam o uso de While e Until são as mesmas que na sintaxe 1. Na sintaxe 2, a execução das instruções dentro da cláusula ocorre incondicionalmente após a instrução Do. A expressão é avaliada quando se chega a Loop; se o loop tiver que prosseguir, a execução pulará para a instrução seguinte a Do. Caso contrário, o loop será terminado e a execução prosseguirá normalmente. End Propósito: Terminação de contexto Sintaxe: End [ {Function | If | Seledct | Sub | Type}] Quando chamada em uma linha própria, a instrução End termina o programa atual, redefine todas as variáveis declaradas, e fecha todos os canais abertos para caminhos de dados, arquivos de dados ou outros aplicativos Windows. Não há limite para o número de declarações End não qualificadas que podem ser chamadas durante um aplicativo. Quando usuada com um outro termo, a declaração especifica a porção de fechamento de uma cláusula ou procedure. Só pode haver uma instrução End por cláusula ou procedure. Erase Propósito: Atualização de arrays Sintaxe: erase array [, array. . . ] A instrução Erase limpa os valores e conteúdo de todos os arrays especificados na declaração. Os parênteses não são usados na especificação. O comprimento de cada array apagado, previamente declarada com Dim, não é afetado. O estado de todos os arrays apagados é tal como o imediatamente seguinte à execução da declaração Dim que originalmente as dimensionou. Error Propósito: Simulação de erro Sintaxe: Error coderro% Nessa sintaxe, coderro% é um valor inteiro que corresponde a um código de erro válido. Você pode usar a variável Err interna como coderro%. A instrução Error força o interpretador Visual Basic a atuar como se o erro especificado por coderro% tivesse ocorrido. Essa instrução é particularmente útil para se testar a aplicabilidade de rotinas de interceptação de erros. Exit Propósito: Aborto forçado de contexto Sintaxe: Exit {Do | For | Function | Sub} A instrução Exit pára imediatamente a procedure ou cláusula de loop atual. Em cláusulas de loop, a execução do programa é retomada na instrução seguinte à instrução de fechamento da cláusula. Em procedures Sub ou Function, a execução é retomada na instrução seguinte à que fez a chamada a procedure. Se a procedure não foi chamada por uma outra instrução, a execução é suspensa até a ocorrência de um evento reconhecido de usuário. For-Next Propósito: Demarcação de um loop reiterativo Sintaxe: For contador = valorini To valorfim [Step valorad] bloco de instrucoes1 [Exit For] 53
- 54. [bloco de instrucoes2] ... Next [contador] A cláusula For-Next demarca um conjunto de instruções para ser executado repetidas vezes. A princípio, a variável contador recebe um valor inicial especificado por valorini. A execução da cláusula procede então em seqüência e pode ser terminada ao se chegar à instrução Exit For. Em Next contador, um valor, geralmente 1, é adicionado à variável 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 valorfim especificado no topo da cláusula, a execução pula para a instrução imediatamente seguinte à linha For. Se contador for maior que valorfim, o loop é terminado e a execução pàssa para a instrução abaixo de Next contador. Se nenhuma cláusula For-Next existir nessa cláusula For-Next maior, a especificação de contador depois do termo Next é opcional. Function Propósito: Inciação de procedure que retorna valor Sintaxe: [Static] [Private] Function nome_da_procedure ([ByVal] argumento1 [( )] [As tipo], [ByVal] argumento2[( )] [As tipo]. . .]) bloco_de_instrucoes1 nome_do_procedure = expressao1 [Exit function] [bloco_de_instrucoes2] [nome_do_procedure = expressao2] ... End Function A instrução Function atua como cabeçalho para procedures que recebem argumentos da mesma maneira que uma procedure Sub, mas que retornam um único valor ou string. A instrução Function parece ter precisamente a mesma sintaxe que a instrução Sub. Uma diferença importante entre as sintaxes das procedures Function e Sub é que o nome_da_procedure de uma priocedure Function é tratado como uma variável na procedure. Perto do final da procedure Function, uma expressão de interpretação válida é atribuída a esse nome_da_procedure com uma equação. O valor dessa expressão é a solução ou o resultado da função como ela foi declarada. A sintaxe dos argumentos expressos dentro da instrução Function é a mesma que a sintaxe dos argumentos dentro da instrução Sub. Normalmente, os valores dessas variáveis que têm escopo local a procedure - ou que não tenham sido declaradas como modulares ou globais fora da procedure - são tornadas nulas sempre ao sair da procedure. O uso do termo Statis antes do termo Function muda o contexto da procedure de local padrão para estático, permitindo que o interpretador mantenha os valores e conteúdo das variáveis usadas pela procedure depois de sair dele. O uso do termo Private antes do termo Function - se essa procedure Function aparecer dentro de um módulo geral - muda o contexto da procedure de global para nível de módulo, de modo que nenhum outro módulo pode fazeruma chamada a esta procedure. As procedure de funções declaradas na seção geral de módulos de formulário recebem automaticamente contexto de nível de módulo, e não requerem o qualificador Private. Get # Propósito: Recuperação d dados de um dispositivo Sintaxe: get # canal%, [posicao&], varivael A instrução Get # lê o conteúdo da variavel especificada a partir de um arquivo de dados de acesso aleatório, aberto previamente com a instrução Open. . . As Random 54
- 55. ou Open. . . As binary, e cujo número de canal% tenha sido designado por essa instrução Open. Você não pode substituir o termo variavel por uma expressão ou um valor. Na instância da instrução Get #, você só poe declarar explicitamente uma única variável, e não uma lista de variável. Quando você estiver usando a técnica de acesso aleatório, se posicao& for especificada, o conteúdo de variavel é assumido como devendo ser lido da posição de elemento numerada como posicao& contando a partir do início do arquivo. Se a posicao& for omitida e uma vírgula guardar o espaço vazio onde ela teria aparecido, a leitura ocorrerá na posição sendo atualmente apontada pelo ponteiro do arquivo. Depois de feita a leitura de um arquivo de acesso aleatório ou binário, o ponteiro do arquivo registrará a posição imediatamente seguinte à leitura anterior. Se uma instrução Get # lê de alguma posicao& no meio de uma arquivo já existente, portanto, depois da leitura o apontador será incrementado para a próxima posição no meio desse arquivo. Se o valor de posicao& estiver aklém da posição onde quaisquer dados tenham sido escritos no arquivo, qualquer valor lido a patir dessa posição não-existente será zero, e qualquer string lida a partir dessa posição será nula. Contudo, é válido especificar uma posicao& de armazenamento que seja muito que o número de elementos do arquivo. Quando você está usando a técnica de acesso binário para carregar um valor na memória, a instrução Get # lê exatamente tantos bytes do arquivo de acesso binário quantos são usados para representar o valor da variavel especificada quando ele é carregado na memória. Quando você está carregando uma string alfanumérica e atribuindo seu conteúdo a uma variável de string na memória usando acesso binário, o número de caracteres carregados na memória é exatamente o número de caracteres atualmente pertencentes a essa variável de string. Em outras palavras, se o conteúdo da variável de string ainda não foi atribuído e seu conteúdo oficial é nulo (string$ = " "), uma instrução Get # não carrega quaisquer caracteres na variável de string especificada. Se a posicao& não for especificada, aleitura ocorrerá no próximo endereço ede byte na seqüência. Global Propósito: Declaração de variável Global Sintaxe: Global variavel1 [inteiro [To inteiro] [, inteiro [To inteiro] ] ) ] [As [New] tipo], variavel2 [ (inteiro [To inteiro] [, inteiro [To inteiro] ] ) ] [As [New] tipo], . . . variavel60 [ (inteiro[To inteiro] [, inteiro [To inteiro] ] ) ] [As tipo] ] A declaração Global é usada para declarar todas as variáveis unitárias e array cujos valores devam se aplicar ao código-fonte inteiro do programa. O escopo de todas as variáveis declaradas pelo uso de Global é considerado global. Exceto pelo próprio termo, a sintaxe de Global é a mesma que a sintaxe da declaração Dim. Global só pode ser usada dentro de um módulo geral (que não de formulário), e especialmente dentro de um que o programador tenha designado como módulo global. GoSub Propósito: Desvio temporário Sintaxe: GoSub rotulo Quando a instrução GoSub é executada, o interpretador desvia para a instrução imediatamente seguinte ao rótulo especificado. Enquanto a instrução prossegue em seqüência, o interpretador mantém registro da localização da instrução que efetuou o desvio. Quando o interpretador executa a próxima instrução Return, ele desvia de volta para a instrução imediatamente seguinte à chamada GoSub. GoTo 55
- 56. Propósito: Desvio entre procedimentos Sintaxe: GoTo rotulo Quando é executada, a instrução GoTo faz com que o interpretador suspenda a execução na linha de instrução atual, e a retome na instrução do mesmo procedimento imediatamente após o rotulo especificado. O rótulo de instrução precisa aparecer em uma linha própria e precisa estar seguido de dois pontos. If... Then... [ElseIf... Then][Else... ]... End If Propósito: Cláusula condicional Sintaxe 1: If expressao1 then bloco de instrucoes1 [ElseIf expressao2 Then bloco de instrucoes2 [Else bloco de instrucoes] End If A declaração If-Then testa uma expressão matemática para ver se ela é verdadeira. Se for, a execução continua com a primeira instrução dependente depois da expressão. Se a expressão não for verdadeira, a execução pula para a primeira instrução fora do ninho. Se essa instrução for Else, as instruções dependentes seguintes são executadas. Se essa instrução for ElseIf, uma outra expressão matemática é avaliada da mesma maneira que a primeira. A cláusula termina quando se chega a End If. A seguir temos uma sintaxe mais resumida para a mesma declaração: If expressao Then instrucao1 [Else instrucao2] Esta sintaxe é usada para cláusulas de uma única instrução e pode ser escrita em uma linha. Observe que não se inclui End If nessa sintaxe. If-Then é a declaração de condição fundamental da linguagem de programação BASIC. A declaração pode ser descrita como um mecanismo cujo gatilho é uma expressão matemática. O resultado dessa expressão é um valor lógico Booleano em algum lugar da memória, que pode ser interpretado como True ou False (-1 ou 0). Se a expressão é verdadeira, o primeiro conjunto de instruções na cláusula é executado em seqüência. Se houver um outro conjunto de instruções na cláusula If-Then seguindo o termo Else ou ElseIf, ele será executado em seqüência se a expressão original ao lado do termo If for falsa. Input # Propósito: Aquisição de dados do dispositivo Sintaxe: Input #canal%, variavel1[, variavel2m, . . . variaveln] A instrução Input # lê dados de um arquivo de dados textual cujo número canal% tenha sido aberto previamente como Input pela instrução Open e cujo nome de arquivo tenha sido especificado previamente dentro da instrução Open. O sinal # é necessário para distinguir a instrução Input # da antiga instrução Input do BASIC, embora essa declarção em particular não seja mais suportada pelo Visual Basic. Cada elemento textual do arquivo é atribuído às variáveis da lista da instrução Input #, em seqüência. Se a variável à qual está sendo atribuído um dado do arquivo for uma variável numérica, o interpretador tentará converter automaticamente em um valor numérico a string de texto associada a essa variável antes de atribuir a ela o valor. Line Input # Propósito: Transmissão de texto formatado de um dispositvo Sintaxe: Line Input #canal%, string$ 56
- 57. A instrução Line Input # lê uma linha de texto de um arquivo de acesso seqüência e a armazena na memória dentro da variável string$. Uma linha de texto, nessa situação, é definida como o fluxo contínuo 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 Width # não tiver sido usada para especificar a largura de linha do arquivo de dados seqüênciais, você pode usar Line Input # para atribuir todo o conteúdo de texto do arquivo de dados à variável de string string$. Load Propósito: Colocação de um bojeto na área de trabalho Sintaxe: Load nomeobjeto A instrução Load enredeça por nome um objeto gráfico pertencente ao aplicativo atualmente em execução, carrega-o na memória e na área de trabalho sem exibi-lo e o mantém suspenso até que seja executada uma instrução que force o objeto a ser mostrado. Se o objeto for um formulário, essa instrução dispara o procedimento de evento Sub Form_Load ( ) do formulário. LSet e RSet Propósito: Justificação de conteúdo Sintaxe: LSet campo$ = entrada$ RSet campo$ = entrada$ As intruções LSet e RSet atribuem o conteúdo textual já atribuído a entrada$ a uma string cheia de espaços : campo$. O coprimento de campo$ não é modificado; em vez disso, os espaços dentro de campo$ são substituídos pelo conteúdo de entrada$. A instrução LSet dentro de campo, começando no caractere mais à esquerda de campo, criando assim um campo justificado à esquerda. Da mesma forma, a declaração RSet insere entrada$ dentro de campo$ começando pelo caractere mais à direita de campo$, criando um campo justificado à direita. Se entrada$ contiver mais caracteres que campo$, somente os caracteres mais à esquerda de entrada$ aparecerão em campo$ para ambas as instruções. O comprimento de campo$ permanece o mesmo. Mid$ Propósito: Inserção de um fragmento de string Sintaxe: Mid$ (string$, pos:inic&[, numero&] ) = substring$ A instrução Mid$ substitui o texto atualmente atribuido a string$, começando na posição atual do cursor pos_inic& contando a partir da esquerda, pelo texto contido em substring$. Se numero& é expresso, esse número de caracteres é removido de string$ e substiuído pelos primeiro numero& caracteres a partir da esquerda de substring$ On Error [GoTo | Resume] Propósito: Interceptação de erros dentro da procedure Sintaxe: On [Local]Error {Goto rotulo|Resume Next|Goto 0} A instrução de desvio On Error define uma interceptação de erros que, quando chamada pela primeira vez dentro de um aplicativo, força a execução da procedure atual para pular para um rótulo de linha especifição sempre que ocorrer um erro que normalmente suspenderia o processo normal de execução. Contanto que o procedimento continue a ser executada sem problema, o desvio para o rótulo tem lugar imediatamente quando ocorre um erro. A frase On Error GoTo 0 termina uma interceptação de erro e permite que o intepretador Visual Basic suspenda novamente a execução no caso de um erro sério. A frase On Error Resume Next permite que você diga ao interpretador para ignorar 57
- 58. quaisquer erros que possam ocorrer no caminho e retomar a execução na instrução seguinte à que causou o erro. A palavra-reservada Local é fornecida como uma opção para os usuários de outros compiladores BASIC da Microsoft. Porém, sua ativação dentro de uma interceptação de erros do Visual Basic não tem efeito, porque todas as interceptações de erros do Visual Basic existem em nível local. On...GoTo e On...GoSub Propósito: Desvio de múltipla escolha Sintaxe: On expressao GoTo rotulo0, rotulo1[, rotulo2, . . . rotulo255] On expressao GoSub rotulo0, rotulo1[, rotulo2, . . . rotulo255] A colocação de On expressao antes de uma instrução Goto ou GoSub converte essa instrução em um desvio seqüêncial para um dos rótulos especificados na lista seguinte à palavra reservada. O desvio depende do valor de expressao. Geralmente, a expressao consiste de uma variável por si só. O valor reduzido logicamente de expressao, quando arredondado para o inteiro mais próximo, precisa estar entre 0 e 255, inclusive. Esse valor é equivcalente à posição na lista do rótulo que será o destino do desvio. Se a instrução que está fazendo o desvio é GoSub, o desvio será tratado como uma chamada regular a uma sub-rotina; ao processar Return, a execução terá lugar na instrução imediatamente seguinte à On. . . GoSub. Open Propósito: Iniciação de ponteiros de dados Sintaxe: Open nomearq$ [For modo] [Access restricao] [tipotrava] As [#]canal% [Len = cmprbyte%] A instrução Open inicia um canal para a transferência de dados entre o interporetador Visual Basic e um arquivo armazenado fisicamente. O nome de arquivo DOS desse arquivo é especificado como nomearq$ e pode conter o caminho completo de armazenamento do rquivo. O número de canal associado a esse arquivo é expresso como canal% e pode ser qualquer inteiro entre 1 e 255. A escolha de números aqui é completamente arbitrária; um canal de numeração menor não precisa ser aberto antes de um número maior ser escolhido. Depois de você usar a instrução Open para atribuir um número de canal a um nome de arquivo, qualquer instrução de transferência de dados que se refira a esse número afeta o arquivo atribuído ao número pela instrução Open. Um sinal # antes do número do canal é opcional para manter compatibilidade de sintaxe com as versões anteriores do BASIC. Option Base Propósito: Predefinição default de array Sintaxe: Option Base { 0 | 1 } A declaração Option Base, usada dentro do módulo global ou área de declarações gerais de um aplicativo, estabelece se o endereço incial de uma variável array deve ser 0 ou 1. Esse valor é especificado no inteiro que acompanha e não pode ser nenhum outro. O valor de limite inferior default de variáveis array é 0. Option Compare Propósito: Restrições do processo de comparação de texto Sintaxe: Optionn Compare {Binary | Text} Você usa a instrução Option Compare dentro da seção de declaraçõe de um módulo para especificar o tipo de comparação textual a ser usada pelas instruções dentro desse módulo. A instrução Option Compare Binary compara caracters uns aos outros pelo valor numérico; assim, a comparação é sensível a maiúsculas/minúsculas. A instrução Option Compare Text, por outro lado, compara caracteres somente quanto 58
- 59. ao conteúdo textual; assim, a comparação não é sensível a maiúsculas/minúsculas. Quando essa instrução é omitida, o interpretador usa comparações em modo binário. Option Explicit Propósito: Estipulação de declaração Sintaxe: Option Explicit A instrução Option Explicit, quando incluída na seção de declarações de um módulo, coloca o interpretador em um modo no qual todas as variáveis incluídas no códigofonte tem que ser primeiro declaradas explicitamente, pelo uso da declaração Dim ou Global. Print # Propósito: Transmissão de dados para dispositivo Sintaxe: Print #canal%, expressao1{; | ,} expressao2] [. . . {; | , } expressaon] Nessa sintaxe, cada expressao tanto pode ser reduzida logicamente para um valor numérico ou expressa como uma concatenação alfanumérica de um ou mais elementos de texto. A instrução Print # imprime o texto dos valores ou conteúdo de cada expressão da lista em um arquivo texto que atua como o arquivo de dados atribuído ao inteiro canal%. Esse número de canal precisa ter sido aberto previamente com a instrução Open com Output ou Append e atribuído a um nome de arquivo específico encontrado dentro da instrução Open. Print # imprime texto em um aruivo com esse nome de arquivo. A forma desse texto é exatamente como ele apareceria se você tivesse usado o método .Print para imprimi-lo em um bojeto gráfico ou na impressora. Se um ponto-e-vírgula aparece antes de uma expressão é impressa imediatamente no arquivo, na posição atual do ponteiro de caractere - cancelando assim ualquer retorno de carro ou avanço de linha antes da impressão começar. Se uma vírgula aparece antes de uma expressão, a expressão é impressa no arquivo no início da próxima zona de impressão. Como nenhuma fonte de texto é admitida para a impressão em um arquivo em disco - porque você não está lidando com imagens ou aparência especificamente - uma zona de impressão começa a cada 14 caracteres. Para cada canal aberto, o interpretador mantém a posição de caractere atual dentro do arquivo até ele ser fechado com a execução de uma instrução Close. Múltiplas declarações Print # executadas em seqüência para o mesmo número de canal fazem com que os seus resultados apareçam dentro do arquivo associado ao canal, na mesma seqüência. Put # Propósito: Armazenamento de dados em dispositivo Sintaxe: Put #canal%, [posicao&], variavel A instrução Put # escreve o conteúdo da variavel especifica em um arquivo de dados de acesso aleatório, aberto previamente com a declaração Open . . . As Random ou Open. . . As Binary, e cujo número canal% seja designado por essa declaração Open. Você não pode substituir o termo variavel por uma expressão ou valor. Na instância da declaração Put #, somente uma variável pode ser declarada explicitamente. Você só pode incluir uma variável; o interpretador VB não reconhece listas de variáveis para essa instrução. Quando você está usando a técnica de aesso aleatório, se posicao& é declarada, o conteúdo de variável é assumido como sendo escrito na posição de elemtno de número posicao& contada a partir do início do arquivo. Se já existir um elemento nessa posição, ele será substituído pelo conteúdo de variavel. Se a posicao& não estiver declarada, a vírgula que guarda o lugar onde ela deveria ter sido declarada precisa permanecer para distinguir seu propósito nesta declaração daquele de variavel. 59
- 60. O intepretador Visual Basic mantém um ponteiro de arquivo para cada arquivo de dados aberto com a instrução Open. Este ponteiro registra a posição onde o próximo elemento de dados será escrito. Em acesso aleatório, 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 aleatório ou binário ocorre, o ponteiro de arquivo registra a posição imediatamente no meio de um arquivo existente, depois da escrita o ponteiro é incrementado para a próxima posição no meio desse arquivo. Em outras palavras, a posição default do ponteiro de arquivo quando posicao& não está especificada não é no final de um arquivo de acesso aleatório no Visual Basic. Se o valor de posicao& estiver além do valor onde quaisquer dados tenham sido escritos no arquivo, o conteúdo dos dados nas posições anteriores à posicao& pode ser errôneo. Contudo, é valido especificar uma posicao& de armazenamento que seja muito maior que o número de elemento do arquivo. O comprimento de cada elemento em bytes armazenados é, por default, 128 btes. Você pode reespecificar este comprimento com a porção Len = compr% da instrução Open 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 aletório têm comprimentos idênticos. Estes tantos bytes são ecritos no arquivo cada vez que Put # é executado, independentemente do comprimento em bytes da variavel especificada. Uma string alfanumérica não pode ser maior que o número de bytes no comprimento de campo menos dois, considerando o quanto ocupa um valor descritor de string. Cada vez que Put # é executado, o número de bytes no comprimento de campo é adicionado para que o ponteiro mantenha a posição absoluta atual desse ponteiro. Quando você está usando a técnica de acesso binário - quando você abre o arquivo de dados usando Open. . . As Binary - o valor de posicao&, quando especificado, repesenta o número de bytes absoluto dentro do arquivo aberto. Este número de bytes atua como um endereço absoluto. Os elementos de um arquivo de acesso binário não têm comprimentos iguais; a instrução Put #, portanto, escreve no arquivo de acesso binário exatamente tantos bytes quantos são usados para armazenar a variavel especificada na memória. Se posicao& não é especificada, a escrita ocorre no próximo endereço de byte na seqüência. Randomize Propósito: Realimentação do gerador aleatório Sintaxe: Randomize [ (semente%) ] A instrução Randomize realimenta o gerador de números aleatórios de um aplicativo. Em outras palavras, ele muda algumas das contantes do algoritmo de geração aleatória para que uma seqüência diferente de números aleatórios possa ser gerada, eliminando assim a possibilidade de números previsíveis. Se semente% é expressa uma seqüência particular de números aleatórios referida por semente% é iniciada. Se semente% é omitida, uma semente "aleatória" é iniciada, cujo valor escolhido se baseia no estado atual do próprio gerador de números aleatórios. ReDim Propósito: Redeclaração de array dinâmico Sintaxe 1 (simples): ReDim variavel (inteiro) Sintaxe 2 (complexa): ReDim [Preserve] variavel1(intiro) [To inteiro] [, inteiro [To inteiro]]) [As tipo] [, variavel2 [As tipo], . . .variavel60 (inteiro [To inteiro] [, inteiro [To inteiro] ] ) [As tipo] ] A declaração ReDim recoloca os arrays dinâmicos declarados para novos limites mínimo e máximo, e pode ser usada para mudar o tipo de armazenamento de variáveis declaradas. Ao fazer isso, todos os valores e conteúdo dos arrays dinâmicos 60
- 61. são apagados, a menos que a opção Preserve seja utilizada. Cada array dinâmico na declaração ReDim precisa ter sido previamente declarada pela utilização de Dim variavel( ) usando precisamente esta sintaxe, omitindo quaisquuer limites do array entre os parênteses. Novos limites podem ser especificados a qualquer momento usando ReDim. O conteúdo do array ficará limpo de quaisquer valores ou conteúdo depois de ReDim ser executada, portanto ela também pode ser usada no lugar de Erase para limpar ou atualizar uma matriz dinâmica. Rem Propósito: Permite que você coloque comentários textuais em seu código-fonte. Sintaxe: {Rem | ' } [comentario] Quando o intepretador encontra a instrução Rem em uma linha, ele ignora o conteúdo restante dela e pula para a próxima linha. Essa instrução permite que você digite qualquer coisa no código-fonte aleatoriamente, geralmente, para uso de comentários para explicar seu código para a próxima pessoa que for examiná-lo. Você pode usar o apóstrofo (') no lugar do termo Rem. Reset Propósito: Encerramento do processo de transferência de dados Sintaxe: Reset A declaração Reset encerra todos os processos de transferência de dados fazendo fluir o conteúdo de todos os buffers de dados abertos para seus respectivos arquivos abertos, e fechando todos os canais abertos sem que se tenha de invocar declarações Close para esse canais. Resume Propósito: Terminação de rotina de interceptação de erros Sintaxe: Resume { [0] | Next | rotulo} A intrução Resume é reservada para ofinal de rotimnas de interceptação de erros dentro de uma procedure. Chamada em uma linha própria ou acompanhada de um 0, essa instrução envia a execução de volta para a declaração que causou o erro interceptado. A instrução anteriormente errônea é então reexecutada paa ver se gera o mesmo erros uma segunda vez. A frase Resuma Next envia a execução de volta para a instrução imediatamente seguinte à que causou o erro. A frase Resume rotulo envia a execução de volta para a instrução imediatamente seguinte ao rótulo especificado. Return Propósito: Terminação de sub-rotina Sintaxe: Return Quando a instrução Return é processada, um desvio é feito para a instrução imediatamente seguinte à instrução GoSub executada mais recentemente. SavePicture Propósito: Salvamento do conteúdo de imagem Sintaxe: SavePictrure [Objeto.]propriedade, nomearq$ onde nomearq$ se refere a um arquivo com a extensão BMP (bitmap do Windows), ICO (ícone padrão), ou WMF (meta-arquivo do Windows). A instrução SavePicture salva em disco a .Picture ou .Image atualmente residindo no Objeto caixa de figura designado, usando o nome de arquivo nomearq$ dado. O termo propriedade é definido com a palavra Image ou com uma referencia direta ao Objeto e sua propriedade .Picture. Se Image é especificado, então independente do nome de arquivo ou extensão expressos, a imagem é salva como um arquivo bitmap do 61
- 62. Windows, ao qual é dada uma extensão BMP. Se Objeto.Picture for especificado, a figura será salva em seu formato atual no controle, que pode ser um bitmap do Windows, um ícone padrão ou um meta-arquivo. Seek # Propósito: Diretiva de posicionamento do ponteiro de dados Sintaxe: Seek [#] canal%, posicao& A instrução Seek # define a posição do ponteiro de um arquvio de dados na qual irá ocorrer a próxima 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 declaração Open. O valor de posicao& pode ser especificado como maior que o atual comprimento efetivo do arquivo. Em tais casos, o interpretador gera valores nulos para todas as posições entre a posição final e a posicao& declarada. Em arquivos de acesso aleatório, o valor de posicao& é definido como o número do elemento de dados onde uma variável será escrita quando Put # for ativada a seguir, o número do elemento de dados de onde ela será lida quando Get # for ativada a seguir. Em arquivos de acesso seqüêncial ou binário, o valor de posicao& é definido com o endereço em bytes do próximo caractere a ser escrito ou lido no arquivo de dados. O sinal # antes do número canal% é opcional. Select Case... Case... End Select Propósito: Cláusula condicional de múltipla escolha Sintaxe: Select Case expressao Case [Is] comparacao1a [To comparacao1b] bloco de instrucoes1 [Case [Is] comparacao2a [To comparacao2b] ] [bloco de instrucoes2] ... [Case Else] [bloco de Instrucoesn] End Select A instrução Select Case compara o valor ou conteúdo de texto de uma expressão inicial com o valor de uma ou mais expressões à igualdade. A declaração contém várias expressões de comparação quanto à igualdade, embora o elemento sendo comparado só seja escrito uma vez como expressão inicial no começo da cláusula. essa expressão incial pode consistir de uma variável ou até um número; entretanto, ela também pode conter qualquer número de elementos que sejam especificados ou implícitos, e combinados por operadores aritméticos. Para cada comparação de igualdade, na eventualidade de (ou no caso de) uma das comparações entre as expressões ser avaliada como True, o conjunto de instruções após Case é executado. Quando o próximo Case ou End Select é atingido, a execução pula para a instrução imediatamente seguinte à End Select. Select Case dá ao programa uma maneira de interpretar opções. SendKeys Propósito: Imitação de pressionamento de tecla Sintaxe: SendKeys texto$[, suspende%] A instrução SendKeys envia para o sistema o texto contido em texto$, um caractere após o outro, como se cada caractere de texto$ fosse digitado muito rapidamente no teclao. O controle do formulário atual que tem o foco será o destinatário do texto. Se o cursor está numa caixa de texto, o texto contido em texto$ aparecerá nessa caixa, como se o usuário tivesse digitado esse texto manualmente. Se o valor -1 estiver 62
- 63. especificado para suspende%, a execução do aplicativo Visual Basic será suspensa até que o Windows processe todas as teclas enviadas e o buffer do teclado fique vazio. Set Propósito: Estabelecimento de representação indireta Sintaxe 1: Set varobjeto = [refpai!] refobjeto Sintaxe 2: Set varobjeto = New nomeobjeto A instrução Set, usando a sintaxe 1, atribui à variável de objeto varobjeto o objeto gráfico existente declarado como refobjeto. A referència refobjeto para esse objeto existente pode ser feita por meio da propriedade .Name desse objeto, ou por meio de mais uma outra variável de objeto. Uma invocada, qualquer referência a varobjeto se palica ao mesmo objeto gráfico que refobjeto. A variável de objeto varobjeto pode ser definida posteriormente para se refereir a algum outro objeto gráfico, ou desvinculada pela definição de sua referência a Nothing (nada). Qualquer variável de objeto referida pela declaração Set precisa primeiro ter sido declarada formalmente usando a declaração Dim, Global ou Static, como descrito no Capítulo 20, "A Janela Como Documento". Se o objeto pai de refobjeto não estiver atualemtne ativo (se ele não tem o foco em nível de formulário), para atribuir a referência do objeto gráfico ao objeto pai particular ao qual ele pertence, a referência de objeto refpai desse pai precisa ser declarada primerio, seguida da referência de controle filho refobjeto. As duas referências são separadas uma da outra por um ponto de exclamação. Usando a sintaxe 2, a declaração Set atribui a variável de objeto varobjto a uma nova instância de um objeto pré-estruturado cuja propriedade .Name tenha sido definida como nomeobjeto quando em tempo de projeto. A chamada desta sintaxe da declara Set torna existente esta nova instância New do objeto gráfico. O pai de nomeobjeto precisa estar atualmente ativo, ou ter o foco em nível de formulário. Static Propósito: Declaração de variável local Sintaxe: Static variavel1 [ionteiro [To inteiro] [, inteiro [To inteiro] ] ) ] [As tipo] [, variavel2 [ (inteiro [To inteiro] [, inteiro [To inteiro] ] ) ] [As tipo], . . . variavel60 [ (inteiro[To inteiro] [, inteiro [To inteiro] ] ) ] [As tipo] ] A instrução Static é usada no lugar de Dim para delarar todas as variáveis unitárias e array de uma procedure que tenham valores que o interpretador deva manter depois da delcaração End Sub ou End Funtion ser executada para essa procedure. Exceto pelo termo principal, a sintaxe de Static é a mesma da declaração Dim dentro de uma procedure. Ela não pode, porém, incluir o termo Shared. Stop Propósito: Suspensão do programa Sintaxe: Stop A instrução Stop suspende a execução do programa, provocando a mesma resposta do interpretador como se o usuário tivesse selecionado Break a partir do menu Run do Visual Basic. A janela Immediate (imeditata) do CLI se torna disponível depois de Stop ser executada. A execução do programa é retomada em uma procedure ou rótulo de linha especificado em uma instrução que o usuário deve veicular através do CLI. Sub Propósito: Inciação de porocedure que não retorn valor Sintaxe: [Static][Private] Sub nome_da_procedure ([ [Byval] argumento1[ ( ) ] bloco _de_instrucoes1 [Exit Sub] 63
- 64. [bloco_de_instrucoes2] ... End Sub Sub é principal instrução declarativa de procedure do vocabulário do Visual Basic. A declaração é usada para conter uma procedure de um dado nome nome_da_procedure. A execução pode ser desviada para essa instrução Sub de qualquer ponto do programa se você chamar esse nome de procedure dentro do código-fonte ou usar a instrução Call. Diz-se que ua procedure Sub recebe valores da procedure que a chamou, como argumentos ou parâmentros (os termos aqui são intercambiáveis). Quando uma procedure é chamada de fora, os valores pertinentes a essa procedure são listados entre parênteses, separado por vírgulas. Diz-se qu esse valores são passados para a procedure, podendo ser escritos como numerais esplícitos ou representados por variáveis. Quando um procedure é declarada dentro, esses valores são recebidos na ordem na qual são passados, e são atribuídos a variáveis que têm nomes que podem ser os mesmos usados na chamada de procedure. O conteúdo de variáveis de string pode ser passado da mesma forma que valores de variáveis numéricas. Se você deseja garantir que um tipo específico de argumento seja passado para a sua procedure, um interio por exemplo, você pode colocar o termo As tipo ao lado desse argumento. O conteúdo inteiro de um array pode ser passado para uma procedure como um argumento, contanto que o nome da variável de array seja identificado com parênteses vazios. Normalmente, qualquer mudança feita nos valores dos argumentos listados é refletida nas variáveis usadas como argumentos na chamada a procedure. Essa reflexão pode ser contornada para um argumetno específico colcocando o termo ByVal antes desse argumento; fazendo isso você permite que a variável usada na chamada a procedure retenha seu valore mesmo que o valor da variável usada para receber o argumento tenha sido modificado na procedure. As instruções em uma procedure Sub são exzecutadas em seqüência. Uma procedure Sub é terminada sempre que um Exit Sub ou End Sub é atingido durante essa seqüência. Os valores das variáveis com escopos que sejam locais a procedure, ou que não tenham sido declaradas como modulares ou globais fora da procedure, são 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 conteúdo das variáveis usadas pela procedure depois de sair dela. O uso do termo Private antes do termo Sub, se essa procedure Sub aparece em um módulo geral, muda o contexto da procedure de global para nível de módulo, para que nenhum oputro módulo possa fazer uma chamada a esta procedure. Os proceimentos Sub declaradas em módulos de formulário recebem automaticamente contexto de nível de módulo, e não requerem o qualificador Private. Type-End type Propósito: Cláusula de declaração composta Sintaxe: Type nome_do_tipo variavel1[comprimento_array)] As tipo_existente [* comprimento_seg] [variavel2 [ ( comprimento_matriz) As tipo_existente [* comprimento_seq] ] End Type A cláusula Type-End Type é usada dentro do módulo global ou seção de declarações gerais de um aplicativo para declarar tipos de variáveis compostas definidas pelo programador para esse aplicativo. O nome_do_tipo da variável composta é definido arbitrariamente pelo programador; entretanto, ele não pode ser uma palavra 64
- 65. reservada, um bnome de variável declarada ou um termo usado no programa para qualquer outra finalidade. Cada variável que irá compor a variável composta é listada dentro da cláusula. As listas de variáveis aqui não contam como declarativas; essas variáveis precisam ser declaradas em outro lugar do programa. A chamada de cada variável aqui é tida somente como uma reserva de seu lugar dentro da variável composta sendo declarada. O tipo de variável tipo existente incluído dentro do tuipo composto precisa ser especificado com o termo As, e pode ser um tipo composto declarado previamente dentro de uma cláusula anterior. Se as strings estão sendo usadas dentro de uma variável composta, o programador tem a opção de especificar o comprimento absoluto em caracteres de cada uma, escrevendo esse comprimento ao lado do asterisco * seguinte à designação As String. Fixar o comprimento das strings incluídas é necessário no uso de cláusulas Type para salvar registros em um arquivo de dados baseado em disco. Unload Propósito: remoção do objeto da área de trabalho Sintaxe: Unload nomeobjeto A instrução Unload remove o formulário ou objeto gráfico carregado especificado da área de trabalho bem como da memória. O objeto continua a existir como um formulário no projeto e como um arquivo armazenado em disco se ele chegou a ser armazenado. Essa instrução é necessária para um aplicativo Visual Basic compilado porque os serviços do interpretador VB não irão "fechar" automanticamente cada formulário uma vez que o programa compliado seja formalmente encerrado. Width # Propósito: Formatação de aruivo de dados textuais Sintaxe: Width #canal%, colunas% A instrução Width # defie a largura de "impressão" de um arquivo de acesso seqüêncial cujo canal% esteja atualmente aberto por meio da instrução Open. A definição é feita com um número especificado de colunas% de 0 a 255. Depois do interpretador ter armazenado um número colunas% de caracteres em um arquivo aberto, ele gera automaticamente um caractere retorno de carro e um caractere avanço de linha. A "impressão" - ou armazenamento de entradas no arquivo - começa então 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. Write # Propósito: Transmissão de texto para disco Sintaxe: Write #canal%, expressao1[, expressao2 . . . , expressaon] Nesta sintaxe, cada expressao pode tanto ser logicamente reduzida a um valor numérico como ser um aconcatenação alfanumérica de um ou mais elementos de texto. A instrução Write # imprime o texto dos valores ou conteúdo de cada expressão da lista em um arquivo texto que atua como o arquivo de dados atribuído ao interio canal %. Esse número de canal precisa ter sido aberto previamente com a instrução Open como Output ou Append e atribuído a um nome de arquivo específico encontrado dentro da instrução Open. Write # 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 são separados uns dos outros por vírgulas, e todas as strings alfanuméricas são colocadas entre aspas. Vírgula e qualquer pontuação além das próprias aspas que devam aparecer dentro de uma string são colocadas entre as aspas. 65
- 66. 66