lista de funções visual basic

Upload: israel-vinicius

Post on 17-Jul-2015

1.680 views

Category:

Documents


16 download

TRANSCRIPT

ABS Categoria: Funo Matemtica Finalidade: Retorna o valor absoluto de um nmero. Sintaxe: ABS(Nmero) Em que: Nmero - Qualquer valor numrico vlido. Se Nmero contm Null, o valor retornado pela funo ser Null tambm. Caso Nmero seja igual a zero, este ser o valor de retorno da funo. Exemplo:Teste = ABS(2.99) Teste = ABS(-2.99) Teste = 2.99 Teste = 2.99

Array Categoria: Funes de Array Finalidade: Retorna um dado Variant contendo um Array. Sintaxe: Array(Lista de Argumentos) Em que: Lista de Argumentos - Consiste em uma srie de argumentos separados por vrgulas. Se nenhum argumento for fornecido funo, ser criado um array de comprimento zero. Exemplo:MeuArray(Jan,Fev,Mar,Abr) MeuArray(1,3,5,7) MeuArray(2) = Fev MeuArray(3) = 5

Asc Categoria: Funes de Converso de Dados Finalidade: Retorna o cdigo ASCII corresponde quente do primeiro caractere da string indicada. Sintaxe: ASC(String) Em que: String - O argumento string qualquer expresso de caracteres vlida. Se a string especificada no contiver caracteres, ocorrer um erro de Run-Time. Exemplo:Teste = Asc("A") Teste = Asc("a") Teste = Asc("ASCII") Teste = 65 Teste = 97 Teste = 65

Atn Categoria: Funes Matemticas Finalidade: Calcula o Arco Tangente de um nmero. Sintaxe: Atn(Nmero) Em que: Nmero - A funo Atn retorna o nmero de radianos referentes ao arco tangente do ngulo especificado. Exemplo:Teste = Atn(30) Teste = Atn(45) Teste = 1.53747533091665 Teste = 1.54857776146818

Cbool Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso em Boolean. Sintaxe: CBool(Expresso) Em que: Expresso - Se o valor da expresso resultante for zero, o valor False ser retornado pela funo Cbool; caso contrrio, a resposta ser True. Exemplo:Primeiro = 10 Segundo = 10 Valor = 0 Teste = Cbool(Primeiro = Segundo) Teste2 = Cbool(Valor) Teste = True Teste2 = False

Cbyte Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso em Byte. Sintaxe: CByte(Expresso) Em que: Expresso - O argumento da funo poder ser qualquer valor numrico vlido. Exemplo:Dim Teste as Double Teste = 222.3322 MeuByte = CByte(Teste) MeuByte = 222

CCur Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso em Currency. Funes Internas

1

Sintaxe: CCur(Expresso) Em que: Expresso - O argumento da funo poder ser qualquer valor numrico vlido ou expresso string. Exemplo:Dim Dado as Double Dado = 656.123456 Dado = Dado * 2 MinhaMoeda = Ccur(Dado)

MinhaMoeda = 1312.2469

CDate Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso no tipo de dados Date. Sintaxe: CDate(Data) Exemplo:Hoje = June 18, 1999" DataCurta = CDate(Hoje) DataCurta = 18/06/99

CDbl Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso em Double. Sintaxe: CDbl(Expresso) Em que: Expresso - O argumento da funo poder ser qualquer valor numrico vlido ou expresso string. Exemplo:Dim MinhaMoeda As Currency MinhaMoeda = 255.123456 Dado = CDbl(MinhaMoeda) Dado = 255.1235

CDec Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso em Decimal. Sintaxe: CDec(Expresso) Em que: Expresso - O argumento da funo poder ser qualquer valor numrico vlido ou expresso string. Exemplo:Dim ValorTeste MeuValor = 3.05E+15 ValorTeste = CDec(MeuValor) 'ValorTeste= 3050000000000000

Choose Categoria: Funes de Verificao Finalidade: Seleciona e retorna um valor de uma lista de argumentos existente em funo do ndice passado. Sintaxe: Choose(index, choice-1[, choice-2, ... [,choice-n]]) Em que: Index - Expresso numrica ou campo que resulta em um valor entre 1 e o nmero de escolhas disponveis. Choice - Expresso Variant contendo uma das possveis escolhas. Exemplo:Teste = Escolha(2) Teste = Valor2

Funo Escolha:Function Escolha(Indice As Integer) Escolha = Choose(Indice, "Valor1", "Valor2", "Valor3") End Function

Chr Categoria: Funes de Converso de Dados Finalidade: Retorna o caractere correspondente ao cdigo ASCII informado. Sintaxe: Chr(Cdigo ASCII) Exemplo:Teste = Chr(65) Teste = Chr(97) Teste = Chr(64) Teste = A Teste = a Teste = @

CInt Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso no tipo de dados Inteiro. Sintaxe: CInt(Expresso) Em que: Expresso - O argumento da funo poder ser qualquer valor numrico vlido ou expresso string. Exemplo:Dim Duplo As Double Duplo = 8765.4321 Teste = CInt(Duplo) Teste = 8765

CLng Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso no tipo de dados Longo. Funes Internas

2

Sintaxe: CLng(Expresso) Em que: Expresso - O argumento da funo poder ser qualquer valor numrico vlido ou expresso string. Exemplo:Dim Dado As Double Dado = 65432.123 Teste = CLng(Dado) Teste = 65432

Command Categoria: Funes de Sistema Operacional Finalidade: Retorna o argumento informado na linha de comando utilizado na inicializao do Visual Basic ou de um programa executvel desenvolvido nesta linguagem. Sintaxe: Command Exemplo: Inicie a criao de um aplicativo qualquer e inclua os comandos abaixo na procedure Form_Load. A seguir, selecione o comando Options... no menu Tools, escolhendo em seguida a aba Advanced. Inclua o seguinte argumento na caixa de texto Command Line Arguments: Start. A seguir, execute seu aplicativo com e sem este argumento e veja o que acontece.Dim Msg If Command = "" Then Msg = "No existe uma linha de comando Else Msg = "A linha de comando : & Command End If MsgBox Msg

Cos Categoria: Funes Matemticas Finalidade: Calcula o cosseno de um ngulo. Sintaxe: Cos(Nmero) Em que: Nmero - Pode ser qualquer expresso numrica vlida que expresse um ngulo em radianos. Exemplo:Const PI = 3.14159265 Teste = Cos(PI) Teste = Cos(PI/2) Teste = -1 Teste = 1.79489651491878E-09

CSng Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso no tipo de dados Single. Sintaxe: CSng(Expresso) Em que: Expresso - O argumento da funo poder ser qualquer valor numrico vlido ou expresso string. Exemplo:Dim Teste As Double Teste = 22.12345678 Teste = CSng(Teste) Teste = 22.12346

CStr Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso no tipo de dados String. Sintaxe: CStr(Expresso) Em que: Expresso - O argumento da funo poder ser qualquer valor numrico vlido ou expresso string. Exemplo:Dim Dado As Double Dado = 555.4321 Teste = CStr(Dado) Teste = "555.4321"

CurDir Categoria: Funes de Sistema Operacional Finalidade: Retorna a pasta (ou diretrio) atual. Sintaxe: CurDir[(Drive)] Em que: Drive - Expresso string que especifica uma unidade de disco existente. Se a unidade no for especificada ou se a string for de tamanho zero, a funo CurDir retornar o caminho (Path) para o drive atual. Exemplo:Teste = CurDir Teste = C:\WINDOWS

CVar Categoria: Funes de Converso de Dados Finalidade: Converte uma expresso no tipo de dados Variant. Sintaxe: CVar(Expresso) Em que:

Funes Internas

3

Expresso - Qualquer valor numrico vlido ou expresso string. Exemplo:Dim Inteiro As Integer Inteiro = 2222 Teste = CVar(Inteiro & "000") Teste = 2222000

CVErr Categoria: Funes de Converso de Dados Finalidade: Retorna o nmero do erro especificado pelo usurio Sintaxe: CVErr(Nmero do Erro) Voc pode utilizar a funo CVErr para definir seus prprios nmeros de erro. Como voc j deve ter notado ao longo de nosso estudo, sempre que ocorre um erro em tempo de execuo, o VB exibe um bloco de dilogo que mostra o nmero do erro ocorrido e a mensagem correspondente a esse erro. Voc tambm pode criar suas prprias mensagens de erro e com isso controlar o comportamento de seu aplicativo no caso da ocorrncia de situaes indesejadas. Voc pode utilizar a funo IsError para avaliar o erro ocorrido e tomar as devidas providncias. Exemplo:Dado = TxtIn.TEXT Teste = CalculoGeral(Dado) If IsError(Teste) Then Teste = CStr(Teste) End If TxtOut.TEXT = Teste Entrada de Dado Se Teste um Nmero de erro Converto no tipo de dados String

Funo CalculoGeral:Function CalculoGeral(Nmero) If IsNumeric(Nmero) Then CalculoGeral = Nmero * 100 Else CalculoGeral = CVErr(1000) End If End Function Se nmero processo normalmente Define Nmero de Erro igual a 1000

Date Categoria: Funes de Data e Hora Finalidade: Retorna a Data atual do sistema. Sintaxe: Date Exemplo:Teste = Date Teste = 04/10/99

DateAdd Categoria: Funes de Data e Hora Finalidade: Retorna um valor Variant contendo a data especificada acrescida do intervalo de tempo fornecido funo. Sintaxe: DateAdd(Intervalo, Nmero, Data) Em que: Intervalo - Expresso do tipo string indicando o intervalo de tempo a ser adicionado data especificada. Pode ser horas, dias, semanas, meses, anos, etc., conforme especificado na seo ajustes, logo em seguida. Nmero -Expresso numrica indicando o nmero de intervalos de tempo que voc deseja acrescer data indicada. Ele pode ser positivo para indicar datas futuras ou mesmo negativo, obtendo datas j ocorridas. Data - Data ou nome de varivel do tipo Date que ser utilizada para o clculo da funo. Ajustes: Ajuste Descrio yyyy Year (Ano) q Quarter (Trimestre) m Month (Ms) y Day of year (Dia do Ano) d Day (Dia) w Weekday (Dia da Semana) ww Week (Semana) h Hour (Hora) n Minute (Minuto) s Second (Segundo) Exemplo:REM Acresce trs anos data atual Teste = DateAdd("yyyy", 3, #10/04/99#) Teste = 04/10/02 REM Diminui 6 meses da data atual Teste = DateAdd("m", -6, #10/04/99#) REM Soma uma semana data atual Teste = 04/04/99

Funes Internas

4

Teste = DateAdd("ww", 1, #10/4/99#)

Teste = 11/10/99

Para efeito de clculo, o VB considera os anos bissextos, de modo que o ms de fevereiro ser considerado com 28 ou 29 dias de acordo com a data especificada e o intervalo de tempo informado. DateDiff Categoria: Funes de Data e Hora Finalidade: Retorna o intervalo de tempo decorrido entre duas datas de acordo com a unidade de tempo especificada. Sintaxe: DateDiff(Intervalo, Data1, Data2[, firstdayofweek[, firstweekofyear]]) Em que: Intervalo - Expresso do tipo string indicando o intervalo de tempo que ser calculado entre Data1 e Data2. Pode ser horas, dias, semanas, meses, anos, etc., conforme especificado na seo ajustes, logo em seguida. Data1, Data2 - As duas datas entre as quais ser calculado o intervalo de tempo decorrido. Firstdayofweek - Uma constante que define o primeiro dia da semana. Caso voc no especifique, o domingo ser considerado como primeiro dia. Veja a seo ajustes, logo em seguida, para maiores detalhes. Firstweekofyear - Esta constante define a primeira semana do ano. Se voc no especificar este argumento, ser considerada como a primeira do ano a semana em que ocorre o dia 1 de janeiro. Ajustes: Para Intervalo: Ajuste Descrio yyyy Year (Ano) q Quarter (Trimestre) m Month (Ms) y Day of year (Dia do Ano) d Day (Dia) w Weekday (Dia da Semana) ww Week (Semana) h Hour (Hora) n Minute (Minuto) s Second (Segundo) Para Firstdayofweek: Ajuste Descrio 0 O atual do sistema 1 Domingo (default) 2 Segunda 3 Tera 4 Quarta 5 Quinta 6 Sexta 7 Sbado Para Firstweekofyear: Ajuste Descrio 0 O atual do sistema (se houver) 1 2 3 Exemplo:REM Dias decorridos de 1/1/99 at 4/10/99: Teste = DateDiff("d", #1/1/99#, #10/4/99#) Teste = 276

A semana em que ocorre dia 1 de janeiro A primeira semana que tem pelo menos 4 dias do novo ano A primeira semana que contiver sete dias do novo ano

REM Horas decorridas entre 1/10/99 at 4/10/99: Teste = DateDiff("h", #10/1/99#, #10/4/99#)Teste = 72

Se Data2 for menor que a Data1, o nmero de intervalos decorridos ser negativo. A opo Firstdayofweek afeta os clculos efetuados com base nos intervalos de tempo "w" (dia da semana) e "ww" (Semana). DatePart Categoria: Funes de Data e Hora Finalidade: Retorna a parte especificada de uma determinada data. Sintaxe: DatePart(Intervalo, Data[, Firstdayofweek[, Firstweekofyear]]) Em que: Intervalo - Expresso do tipo string indicando o intervalo de tempo que ser retornado pela funo. Veja a seo Ajustes em seguida. Data - A data a ser avaliada pela funo.

Funes Internas

5

Firstdayofweek - Uma constante que define o primeiro dia da semana. Caso voc no especifique, o domingo ser considerado como primeiro dia. Veja a seo ajustes, logo em seguida, para maiores detalhes. Firstweekofyear - Esta constante define a primeira semana do ano. Se voc no especificar este argumento, ser considerada como a primeira do ano a semana em que ocorre o dia 1o de janeiro. Ajustes: Esta funo utiliza os mesmos ajustes da funo DateDiff. Exemplo:REM Calcula a semana atual da data indicada Teste = DatePart("ww", #10/4/99#) Teste = 41

DateSerial Categoria: Funes de Data e Hora Finalidade: Retorna a data para o dia, ms e ano especificados. Sintaxe: DateSerial(Ano, Ms, Dia) Em que: Ano - Nmero entre 100 e 9999 inclusive. Ms - Qualquer expresso numrica. Dia - Qualquer expresso numrica. Exemplo:REM Retorna a data de 1 de maio de 1999 Teste = DateSerial(99, 5, 1) Teste = 01/05/99

DateValue Categoria: Funes de Data e Hora Finalidade: Retorna uma data. Sintaxe: DateValue(Data) Em que: Data - Expresso string representando uma data. O VB pode manipular datas que vo de 1/1/100 at 31/12/9999! Voc tambm pode utilizar qualquer expresso que represente data, hora ou ambas. Exemplo:REM Converte uma string numa data Teste = DateValue("6/22/99") Teste = 22/06/99

Day Categoria: Funes de Data e Hora Finalidade: Retorna um nmero de 1 a 31 representando o dia do ms. Sintaxe: Day(Data) Exemplo:Teste = Day(#4/10/99#) Teste = 10

DDB Categoria: Funes Financeiras Finalidade: Calcula a depreciao de um ativo pelo mtodo do Declnio de Balano. Sintaxe: DDB(Cost, Salvage, Life, Period[, Factor]) Em que: Cost - Custo inicial do bem. Salvage - Valor do bem ao final de sua vida til. Life - Vida til do bem. Period - Perodo de depreciao. Factor - Taxa de declnio do balano. Exemplo:Teste = DDB(1000, 100, 5, 1) Teste = 400

Dir Categoria: Funes de Sistema Operacional Finalidade: Retorna o nome dos arquivos ou diretrios que combinam com o padro especificado ou atributo de arquivo, ou volume de um drive. Sintaxe: Dir[(Pathname[, Attributes])] Em que: Pathname - Expresso string que especifica o nome do arquivo. Essa string tambm pode conter o caminho completo (drive e diretrio) do arquivo procurado. Se o caminho no for encontrado, Null ser retornado. Attributes - Constante ou expresso numrica que indica os atributos do arquivo selecionado. Se omitido, somente sero retornados os arquivos normais, ou seja, arquivos ocultos de sistema e diretrios no sero exibidos. Ajustes: Ajuste Descrio 0 Normal 2 Hidden (Oculto) 4 System (Sistema) 8 Volume 16 Diretrio Exemplo:Teste = Dir("C:\WINDOWS\WIN.INI") Teste = WIN.INI

Funes Internas

6

Para mltiplos arquivos: Teste = Dir("C:\WINDOWS\*.INI") List1.AddItem Teste Do While Teste Empty Teste = Dir List1.AddItem Teste Loop

Quando voc utiliza caracteres curinga como * e ?, o VB retorna o primeiro nome de arquivo que atende s condies de busca indicadas na funo Dir. A partir da, basta chamar a funo Dir sem argumentos para que os prximos arquivos que atendem condio proposta sejam exibidos. Quando no existirem mais arquivos, a funo Dir retornar uma string de comprimento zero. DoEvents Categoria: Funes de Sistema Operacional Finalidade: Interrompe momentaneamente a execuo de seu aplicativo para que o sistema operacional possa processar outros eventos pendentes. Sintaxe: DoEvents( ) Exemplo:For a = 1 To 30000 If a Mod 1000 = 0 Then 'Se o loop foi repetido 1000 vezes. DoEvents 'Passa o controle para o sistema operacional. End If Next a

Quando seu aplicativo realiza tarefas muito demoradas, o sistema operacional deixa de processar a ocorrncia de alguns eventos, que ficam pendentes em uma fila de execuo. mais ou menos o que ocorre quando voc d dois cliques sobre o cone do VB para inicializ-lo. Enquanto o seu micro vai carregando este aplicativo, as teclas que voc est acionando e os cliques de mouse dados sobre a tela so ignorados pelo Windows. Depois que a sua aplicao j est carregada que o Windows processa os eventos pendentes. A funo DoEvents tambm retorna o nmero de formulrios abertos no Windows. Environ Categoria: Funes de Sistema Operacional Finalidade: Retorna a string associada a uma varivel de ambiente do sistema operacional (como Path e Prompt, por exemplo). Sintaxe: Environ({Envstring | Nmero}) Em que: Envstring - Expresso string contendo o nome da varivel de ambiente. Nmero - Expresso numrica correspondente ordem da varivel na tabela de variveis de ambiente. Exemplo:Teste = Environ("PATH") REM Teste = C:\WINDOWS;C:\WINDOWS\COMMAND;C:\;C:\DOS;C:\UTIL Teste = Environ("TEMP") Teste = C:\WINDOWS\TEMP

Se a varivel de ambiente especificada no for encontrada, a funo Environ retornar uma string de comprimento zero. Error Categoria: Funes de Sistema Operacional Finalidade: Retorna a mensagem de erro que corresponde a um dado nmero de erro. Sintaxe: Error[(Errornumber)] Em que: Errornumber - Qualquer nmero de erro vlido para o Visual Basic. Um nmero de erro corresponde ao valor da propriedade Number do objeto Err, e seus valores vlidos vo de 0 a 65535, inclusive. Quando combinado com a propriedade Name do objeto Err, esse nmero representa uma mensagem de erro particular. Se Errornumber um nmero de erro vlido, porm indefinido, a funo Error retorna a string definida pelo usurio. Se Errornumber no um nmero de erro vlido, um erro ocorre. Se Errornumber omitido, a mensagem correspondente ao erro de Run-time mais recente exibida. Se nenhum erro de Run-time ocorreu recentemente ou o nmero do erro for 0, a funo Error retornar uma string de comprimento zero. Exemplo:Teste = Error(5) Teste = Error(6) Teste = Error(7) Teste = Invalid procedure call Teste = Overflow Teste = Out of memory

Para erros indefinidos:Teste = Error(4) Rem Teste = Application-defined or object-defined error

Exp Categoria: Funes Matemticas Finalidade: Retorna o valor de e (base de um logaritmo natural) elevado a uma potncia qualquer. Sintaxe: Exp(Nmero) Em que: Nmero - Qualquer expresso numrica vlida.

Funes Internas

7

Exemplo:Teste = Exp(1) Teste = Exp(2) Teste = Exp(-2) Teste = 2.71828182845905 Teste = 7.38905609893065 Teste = 0.13533528323661

O valor de e aproximadamente 2,718282. Se o valor do nmero for superior a 709,782712893, ocorrer um erro de overflow. FileDateTime Categoria: Funes de Acesso a Arquivos Finalidade: Retorna a data e hora em que o arquivo foi criado ou modificado pela ltima vez. Sintaxe: FileDateTime(Pathname) Em que: Pathname - Expresso string que especifica o nome do arquivo. Essa string tambm pode conter o caminho completo (drive e diretrio) do arquivo procurado. Exemplo:Teste = FileDateTime("C:\WINDOWS\WIN.COM") REM Teste = 15/05/98 20:01:00

FileLen Categoria: Funes de Acesso a Arquivos Finalidade: Retorna um valor Long contendo o tamanho do arquivo especificado em bytes. Sintaxe: FileLen(Pathname) Em que: Pathname - Expresso string que especifica o nome do arquivo. Essa string tambm pode conter o caminho completo (drive e diretrio) do arquivo procurado. Exemplo:Teste = FileLen("C:\WINDOWS\WIN.COM") Teste = 25271

Fix Categoria: Funes Matemticas Finalidade: Retorna a parte inteira de um nmero. Sintaxe: Fix(Nmero) Em que: Nmero - Qualquer expresso numrica vlida. Se nmero contm Null, o valor de retorno ser Null tambm. Exemplo:Teste = Fix(12.556) Teste = Fix(-12.556) Teste = Fix(1.6) Teste = 12 Teste = -12 Teste = 1

Format Categoria: Funes de Data e Hora Finalidade: Formata uma expresso de acordo com as instrues definidas pelo usurio. Sintaxe: Format(Expresso[, Formato[, Firstdayofweek[, Firstweekofyear]]]) Em que: Expresso - Qualquer expresso vlida. Formato - Uma expresso de formato definida pelo usurio. Veja na seo Ajustes em seguida, os formatos existentes. Firstdayofweek - Uma constante que define o primeiro dia da semana. Veja a funo DateDiff para maiores detalhes. Firstweekofyear - Esta constante define a primeira semana do ano. Veja a funo DateDiff para maiores detalhes. Ajustes: Nmeros: Nome do Formato Descrio General Number Exibe o nmero como ele , ou seja, sem separadores de milhares. Currency Exibe o nmero com separadores de milhares, smbolo de moeda e dois dgitos direita do ponto decimal. Fixed Exibe pelo menos um dgito esquerda e dois direita do ponto decimal. Standard Exibe o nmero com separadores de milhares, com pelo menos um dgito esquerda e dois direita do ponto decimal. Percent Exibe o nmero multiplicado por 100 e com o smbolo de porcentagem(%) exibido sua direita. Sempre exibe duas casas decimais. Scientific Usa a notao cientfica padro. Yes/No True/False On/Off Data e Hora: Nome do Formato General Date Exibe No se o nmero for zero. Caso contrrio, exibe Yes. Exibe False se o nmero for zero. Caso contrrio, exibe True. Exibe Off se o nmero for zero. Caso contrrio, exibe On. Descrio Para nmeros reais exibe a data e hora, como em 22/6/96 08:33 PM. Se o nmero no possuir nenhuma parte fracionria, exibe somente a data, como em 22/6/96. Se no houver parte inteira, exibe apenas a hora, como em 08:33 PM. A exibio da data Funes Internas

8

Long Date Medium Date Short Date Long Time Medium Time Short Time Exemplo:

obedece aos ajustes atuais de seu sistema. Exibe a data de acordo com o ajuste atual de seu sistema para datas longas. Ex. Sbado, 22 de junho de 1996. Exibe a data de acordo com o ajuste atual de seu sistema para datas mdias. Ex. 22-Jun-96. Exibe a data de acordo com o ajuste atual de seu sistema para datas curtas. Ex. 22/06/96. Exibe a hora de acordo com o ajuste atual de seu sistema para horas longas. Ex. 20:33:51. Exibe a hora de acordo com o ajuste atual de seu sistema para horas mdias. Ex. 08:33 PM. Exibe a hora de acordo com o ajuste atual de seu sistema para horas curtas. Ex. 20:33.

Teste = Format(12345678, General Number) REM Teste = 12345678 Teste = Format(12345678, Currency) REM Teste = R$12.345.678.00 Teste = Format(12345678, Fixed) REM Teste = 12345678.00 Teste = Format(12345678, Standard) REM Teste = 12.345.678.00 Teste = Format(12345678, Scientific) REM Teste = 1.23E+07 Teste = Format(12345678, Yes/No) REM Teste = Yes Teste = Format(#22/6/96#, Long Date) REM Teste = Sbado, 22 de Junho de 1996 Teste = Format(#22/6/96#, Medium Date) REM Teste = 22-Jun-96 Teste = Format(#22/6/96#, Short Date) REM Teste = 22/06/96 Teste = Format("20:33",Long Time) REM Teste = 20:33:00 Teste = Format("20:33",Medium Time) REM Teste = 08:33 PM Teste = Format("20:33",Short Time) REM Teste = 20:33

FV Categoria: Funes Financeiras Finalidade: Calcula o Valor Futuro de uma anuidade ou prestao. Sintaxe: FV(Rate, Nper, Pmt[, Pv[, Type]]) Em que: Rate - Taxa de juros no perodo. Nper - Nmero total de pagamentos. Pmt - Pagamento a ser feito em cada perodo. Pv - Valor presente de uma srie de pagamentos. Type - Nmero indicando quando os pagamentos sero feitos. Use 0 se os pagamentos ocorrem no fim do perodo e 1 se os pagamentos sero feitos antecipadamente. Se omitido, 0 assumido. Exemplo:Rem Quanto obterei se depositar $100 por seis meses a REM uma taxa de 2% ao ms? Teste = FV(0.02, 6, -100) Teste = 630.81 Rem Resposta: $ 630.81

GetAttr Categoria: Funes de Acesso a Arquivos Finalidade: Retorna um nmero que representa os atributos de um arquivo ou diretrio. Sintaxe: GetAttr(Pathname) Em que: Pathname - Expresso string que especifica o nome do arquivo. Essa string tambm pode conter o caminho completo (drive e diretrio) do arquivo procurado. Se o caminho no for encontrado, Null ser retornado.

Funes Internas

9

Valores de Retorno: Valor 0 1 2 4 16 32 Exemplo:Teste = GetAttr("C:\IO.SYS) Teste = 7 Rem O Arquivo IO.SYS Read-only, Hidden e System ao mesmo tempo Rem por isso 1 + 2 + 4 = 7 Teste = GetAttr("C:\WINDOWS") Teste = 16

Descrio Normal Read-Only (Somente Leitura) Hidden (Oculto) System (Sistema) Diretrio O arquivo foi alterado aps o ltimo backup

Hex Categoria: Funes de Converso de Dados Finalidade: Retorna uma string representando o valor hexadecimal de um nmero. Sintaxe: Hex(Nmero) Em que: Nmero - Qualquer expresso numrica vlida. Exemplo:Teste = Hex(15) Teste = Hex(5) Teste = Hex(255) Teste = F Teste = 5 Teste = FF

Hour Categoria: Funes de Data e Hora Finalidade: Retorna o nmero da hora (de 0 a 23) de uma hora especificada. Sintaxe: Hour(Time) Em que: Time - Qualquer expresso numrica ou string que possa representar um intervalo de tempo. Se Time contm Null, o valor de retorno da funo ser Null tambm. Exemplo:Teste = Hour(#8:33:17 PM#) Teste = 20

IIf Categoria: Funes de Verificao Finalidade: Retorna uma de duas partes, dependendo da avaliao de uma expresso. Sintaxe: IIf(Expresso, Truepart, Falsepart) Em que: Expresso - Expresso a ser avaliada. Truepart - Valor ou expresso retornada se a expresso avaliada for verdadeira. Falsepart - Valor ou expresso retornada se a expresso avaliada for falsa. Exemplo:Dado = 100 Teste = IIf(Dado > 10, Maior que Dez,Menor que Dez) Rem Teste = Maior que Dez

InputBox Categoria: Funes de Sistema Operacional Finalidade: Exibe uma caixa de dilogo para que o usurio possa digitar uma resposta qualquer. Aps escolher um dos botes disponveis, o VB retorna o valor digitado. Sintaxe: InputBox(Prompt[, Title][, Default][, Xpos][, Ypos]) Em que: Prompt - Expresso string que ser exibida como mensagem na caixa de dilogo. O comprimento mximo da mensagem de 1024 caracteres. Voc pode quebrar a mensagem em vrias linhas utilizando a combinao de caracteres de retorno de carro Chr(13) e mudana de linha Chr(10), como em (Chr(13) & Chr(10)). Title - Expresso string que ser exibida na barra de ttulo da caixa de dilogo. Se voc omitir este argumento, o nome exibido na barra de ttulo ser o nome de sua aplicao. Default Expresso string que ser retornada como default caso o usurio no digite nenhum dado na caixa de dilogo. Se voc omitir este argumento, a textbox da caixa de dilogo ser exibida vazia. Xpos - Expresso numrica que especifica em twips a distncia horizontal entre a borda esquerda da tela e da caixa de dilogo. Se voc omitir este argumento, a caixa de dilogo ser centralizada horizontalmente. Ypos - Expresso numrica que especifica em twips a distncia vertical entre a borda superior da caixa de dilogo e o topo da tela. Se voc omitir este argumento, a caixa de dilogo ser centralizada verticalmente. InStr Categoria: Funes de Manipulao de Strings Finalidade: Retorna a posio da primeira ocorrncia de uma string dentro de outra. Sintaxe: InStr([Incio, ]String1, String2[, Compare]) Em que: Funes Internas

10

Incio - Expresso numrica que indica a posio inicial de cada busca. Se omitido, a busca comea desde a primeira posio. String1 - String em que feita a procura. String2 - Expresso string que est sendo procurada. Compare - Especifica o tipo de comparao a ser efetuado entre as strings. Exemplo:Teste = InStr("Casa", "as") Teste = 2 Rem A string as foi localizada a partir da segunda posio em Casa Teste = InStr("Casamento", "t") Teste = 8 Rem A string t foi localizada na oitava posio de Casamento Teste = InStr("Casa", "z") Teste = 0 Rem A string z no foi localizada em Casa

Int Categoria: Funes Matemticas Finalidade: Retorna a parte inteira de um nmero. Sintaxe: Int(Nmero) Em que: Nmero - Qualquer expresso numrica vlida. Se nmero contm Null, o valor de retorno ser Null tambm. Exemplo: Esta funo opera de forma idntica funo Fix. IsArray Categoria: Funes de Verificao Finalidade: Retorna um valor Boolean indicando se uma determinada varivel um Array. Sintaxe: IsArray(Varname) Em que: Varname - Qualquer varivel de memria. Exemplo:Dim MeuArray(2) As Integer, Nome as String Teste = IsArray(Nome) Teste = False Teste = IsArray(MeuArray) Teste = True

IsDate Categoria: Funes de Verificao Finalidade: Retorna um valor Boolean indicando se uma determinada expresso pode ser convertida em uma data. Sintaxe: IsDate(Expresso) Em que: Expresso - Qualquer data ou string que possa ser reconhecida como uma data ou hora vlida. Exemplo:Dado = "22/6/96" Mens = hoje Teste = IsDate(Dado) Teste = IsDate(Mens) Teste = True Teste = False

IsEmpty Categoria: Funes de Verificao Finalidade: Retorna um valor Boolean indicando se uma determinada varivel foi inicializada ou no. Sintaxe: IsEmpty(Expresso) Em que: Expresso - Qualquer expresso numrica ou string que possa ser reconhecida como um nome de varivel. Exemplo:Teste = IsEmpty(Dado) Dado = Null Teste = IsEmpty(Dado) Teste = True Teste = False

IsError Categoria: Funes de Verificao Finalidade: Retorna um valor Boolean indicando se uma determinada expresso um valor de erro. Sintaxe: IsError(Expresso) Em que: Expresso - Deve ser do tipo de dados Variant. Exemplo:MeuErro = CVErr(212) Teste = IsError(MeuErro) MeuErro = 212 Teste = IsError(MeuErro) ' Teste = True ' Teste = False

IsMissing Categoria: Funes de Verificao Finalidade: Retorna um valor Boolean indicando se um argumento opcional foi passado para uma procedure ou no. Sintaxe: IsMissing(Nome do Argumento) Em que:

Funes Internas

11

Nome do Argumento - Nome de um argumento opcional em uma procedure. A funo IsMissing retorna um valor True se o argumento especificado no foi passado funo; caso contrrio, a resposta ser False. Exemplo:Function Calcula(Optional Valor) If IsMissing(valor) Then MsgBox(No recebi o argumento valor!) Exit Else Valor = ((Valor / 100) + 1) ^ 1.12 Calcula = Valor End If End Function

IsNull Categoria: Funes de Verificao Finalidade: Retorna um valor Boolean indicando se uma expresso contm dados invlidos (Null). Sintaxe: IsNull(Expresso) Em que: Expresso - Qualquer valor numrico ou expresso string. Se a expresso avaliada tiver dados invlidos (Null), a funo resultar em True; caso contrrio, o valor retornado ser False. Exemplo:Dado = "" Teste = IsNull(Dado) Dado = Null Teste = IsNull(Dado) 'Teste = False 'Teste = True.

IsNumeric Categoria: Funes de Verificao Finalidade: Retorna um valor Boolean indicando se uma determinada expresso pode ser avaliada como um valor numrico. Sintaxe: IsNumeric(Expresso) Em que: Expresso - Qualquer valor numrico ou expresso string. Exemplo:Dado = "100" Teste = IsNumeric(Dado) Dado = "cem " Teste = IsNumeric(Dado) 'Teste = True 'Teste = False

LBound Categoria: Funes de Array Finalidade: Retorna o menor elemento da dimenso especificada de um determinado Array. Sintaxe: LBound(Arrayname[, Dimenso]) Em que: Arrayname - Nome da varivel array. Dimenso - Nmero que indica que dimenso do array est sendo inspecionada. Utilize 1 para a primeira dimenso, 2 para a segunda e assim por diante. Exemplo:Dim Dado(5 To 10) Teste = LBound(Dado, 1) Teste = 5

LCase Categoria: Funes de Manipulao de Strings Finalidade: Retorna uma string convertida em letras minsculas. Sintaxe: LCase(String) Em que: String - Qualquer expresso string vlida. Somente as letras maisculas sero convertidas em minsculas. Os demais caracteres, como letras minsculas, nmeros e sinais, permanecem inalterados. Exemplo:Dado = CAIXA ALTA Teste = LCase(Dado) Teste = caixa alta

Left Categoria: Funes de Manipulao de Strings Finalidade: Retorna o nmero especificado de caracteres a partir do lado esquerdo de uma string. Sintaxe: Left(String, Comprimento) Em que: String - Expresso string da qual os caracteres sero retornados. Comprimento - Expresso numrica indicando quantos caracteres sero retornados. Se igual a 0, uma string de tamanho zero ser retornada. Se o comprimento for maior que o nmero de caracteres da string, toda ela ser retornada.

Funes Internas

12

Exemplo:Dado = "Visual Basic 4.0 Teste = Left(Dado, 1) Teste = Left(Dado, 6) Teste = Left(Dado, 10) Teste = V Teste = Visual Teste = Visual Bas

Len Categoria: Funes de Manipulao de Strings Finalidade: Retorna o nmero de caracteres em uma string ou o nmero de bytes requeridos para armazenar uma varivel. Sintaxe: Len(String | Varname) Em que: String - Qualquer expresso string vlida. Se a string contm Null, Null retornado. Varname - Qualquer nome de varivel vlido. Se Varname contm Null, Null retornado. Se Varname do tipo de dados Variant, Len trata a varivel como uma string, retornando o nmero de caracteres que ela contm. Exemplo:Dado = Estudo de Len Teste = Len (Dado) Teste = Len(Visual) Teste = Len(Visual Basic) Teste = 13 Teste = 6 Teste = 12

LoadPicture Categoria: Funes de Sistema Operacional Finalidade: Carrega uma imagem dentro de um objeto Form object, Controle PictureBox ou controle Image. Sintaxe: LoadPicture([Stringexpression]) Em que: Stringexpression - Nome do arquivo grfico a ser carregado. Os formatos de arquivo suportados pelo Visual Basic so os seguintes: Bitmap (.BMP), Icon (.ICO), Run-Length Encoded (.RLE) e Metafile (.WMF). Exemplo:Rem Para exibir a imagem como fundo de um Form, PictureBox ou controle Rem Image atribua a figura propriedade Picture. Form1.Picture = LoadPicture("PARTY.BMP") Rem Para atribuir um cone a um formulrio ajuste a propriedade Icon: Form1.Icon = LoadPicture("PHONE01.ICO")

Log Categoria: Funes Matemticas Finalidade: Calcula o logaritmo natural de um nmero. Sintaxe: Log(Nmero) Em que: Nmero - Qualquer expresso numrica vlida maior que zero. Exemplo:Teste = Log(0) Teste = Log(5) Teste = 1 Teste = 1.6094379124341

LTrim Categoria: Funes de Manipulao de Strings Finalidade: Retorna uma cpia de uma string eliminando os espaos em branco existentes entre o incio da string e o primeiro caractere. Sintaxe: LTrim(String) Em que: String - Qualquer expresso string vlida. Se a string contm Null, Null retornado. Exemplo:Dado = Casa Teste = LTrim(Dado) Teste = Casa

Mid Categoria: Funes de Manipulao de Strings Finalidade: Retorna o nmero especificado de caracteres de uma string. Sintaxe: Mid(String, Start[, Length]) Em que: String - Qualquer expresso string vlida. Se a string contm Null, Null retornado. Start - Posio inicial a partir da qual os caracteres sero selecionados. Se a posio inicial for maior que o nmero de caracteres da string, uma string de tamanho zero ser retornada. Length - Nmero de caracteres que sero selecionados. Se omitido, todos os caracteres desde a posio inicial especificada at o fim dela sero selecionados. Exemplo:Dado = Visual Basic Teste = Mid(Dado,1, 3) Teste = Mid(Dado,4) Teste = Mid(Dado,5,5) Teste = Vis Teste = ual Basic Teste = al Ba

Minute Categoria: Funes de Data e Hora Finalidade: Retorna o nmero de minutos da hora especificada (de 0 a 59)

Funes Internas

13

Sintaxe: Minute(Time) Em que: Time - Qualquer expresso numrica ou string que possa representar um intervalo de tempo. Se Time contm Null, o valor de retorno da funo ser Null tambm. Exemplo:Teste = Minute(#8:33:17 PM#) Teste = 33

Month Categoria: Funes de Data e Hora Finalidade: Retorna o nmero do ms de uma determinada data (de 1 a 12). Sintaxe: Month(Data) Em que: Data - A data a ser avaliada pela funo. Exemplo:Teste = Month(#22/06/96#) Teste = 6

MsgBox Categoria: Funes de Sistema Operacional Finalidade: Exibe uma mensagem em um quadro de dilogo e espera que o usurio escolha um dos botes disponveis. Aps a seleo, o VB retorna um valor indicando o boto escolhido. Sintaxe: MsgBox(Prompt[, Buttons][, Title]) Em que: Prompt - Expresso string que ser exibida como mensagem na caixa de dilogo. O comprimento mximo da mensagem de 1024 caracteres. Voc pode quebrar a mensagem em vrias linhas, utilizando a combinao de caracteres de retorno de carro Chr(13) e mudana de linha Chr(10), como em (Chr(13) & Chr(10)). Buttons - Expresso numrica que a soma dos valores que especificam o nmero e tipo de botes a serem exibidos. Voc tambm pode especificar o estilo de cone a ser usado, o boto default e a modalidade da caixa de mensagem. Se omitido, o valor default para os botes zero. Title - Expresso string que ser exibida na barra de ttulo da caixa de dilogo. Se voc omitir este argumento, o nome exibido na barra de ttulo ser o nome de sua aplicao. Ajustes: Aparncia: Ajuste Descrio 0 Exibe somente o boto OK (default) 1 Exibe botes OK e Cancel 2 Exibe botes Abort, Retry e Ignore 3 Exibe Yes, No e Cancel 4 Exibe os botes Yes e No 5 Exibe Retry e Cancel 16 32 48 64 0 256 512 0 4096 Exibe cone de Parada Crtica Exibe cone de Pergunta Exibe cone de Ateno Exibe cone de Informao O primeiro boto default O segundo boto default O terceiro boto default Aplicao modal. O usurio deve responder mensagem exibida antes de prosseguir com a execuo da aplicao atual. Sistema modal. Todas as aplicaes so suspensas at o usurio responder message box.

O primeiro grupo de valores descreve o nmero e o tipo de botes exibidos. O segundo grupo (16, 32, 48, 64) descreve o estilo do cone exibido. O terceiro grupo (0, 256, 512) determina que boto o default. O quarto e ltimo grupo (0, 4096) determina a modalidade da caixa de dilogo. Voc deve selecionar um nmero de cada grupo e somar todos para obter a aparncia desejada para sua Message Box. Valores de Retorno: Valor Boto Escolhido 1 OK 2 Cancel 3 Abort 4 Retry 5 Ignore 6 Yes 7 No Exemplo:Rem Exibe botes OK e Cancel e cone de Parada Crtica

Funes Internas

14

Teste = MsgBox("Teste", 17, "MsgBox") Rem Exibe Yes/No numa janela de Ateno com o primeiro boto default Teste = MsgBox("Teste", 68, "MsgBox")

Now Categoria: Funes de Data e Hora Finalidade: Retorna a data e hora atuais do seu sistema. Sintaxe: Now Exemplo:Teste = Now Teste = 22/06/96 20:33:30

Oct Categoria: Funes de Converso de Dados Finalidade: Retorna uma string representando o valor octal de um nmero. Sintaxe: Oct(Nmero) Em que: Nmero - Qualquer expresso numrica ou string vlida. Exemplo:Teste = Oct(8) Teste = Oct(459) 'Teste = 10 'Teste = 713

QBColor Categoria: Funes de Sistema Operacional Finalidade: Retorna o valor da cor RGB correspondente ao nmero de cor informado. Sintaxe: QBColor(cor) Em que: Cor - Nmero de 0 a 15 conforme descrito na seo ajustes. Ajustes: Nmero Cor Nmero Cor 0 Black 8 Gray 1 Blue 9 Light Blue 2 Green 10 Light Green 3 Cyan 11 Light Cyan 4 Red 12 Light Red 5 Magenta 13 Light Magenta 6 Yellow 14 Light Yellow 7 White 15 Bright White Exemplo:Form1.BackColor = QBColor(Cor)

RGB Categoria: Funes de Sistema Operacional Finalidade: Retorna um nmero representando uma cor do padro RGB. Sintaxe: RGB (Red, Green, Blue) Em que: Red - Nmero entre 0 to 255, inclusive, que representa o componente vermelho de uma cor. Green - Nmero entre 0 to 255, inclusive, que representa o componente verde de uma cor. Blue - Nmero entre 0 to 255, inclusive, que representa o componente azul de uma cor. Exemplo:Commdialog.Color = RGB(255, 0, 0)

Right Categoria: Funes de Manipulao de Strings Finalidade: Retorna o nmero especificado de caracteres a partir do lado direito de uma string. Sintaxe: Right(String, Comprimento) Em que: String - Expresso string da qual os caracteres sero retornados. Comprimento - Expresso numrica indicando quantos caracteres sero retornados. Se igual a 0, uma string de tamanho zero ser retornada. Se o comprimento for maior que o nmero de caracteres da string, toda ela ser retornada. Exemplo:Dado = "Visual Basic 4.0 Teste = Right(Dado, 1) Teste = Right(Dado, 6) Teste = Right(Dado, 10) Teste = 0 Teste = ic 4.0 Teste = Basic 4.0

Rnd Categoria: Funes Matemticas Finalidade: Retorna um nmero aleatrio (randmico). Sintaxe: Rnd[(Nmero)] Em que: Nmero - Qualquer expresso numrica vlida. Funes Internas

15

Esta funo retorna um valor menor que 1 e maior ou igual a zero. Exemplo:Teste = Rnd

Rtrim Categoria: Funes de Manipulao de Strings Finalidade: Retorna uma cpia de uma string, eliminando os espaos existentes entre o ltimo caractere da string e o fim dela. Sintaxe: RTrim(String) Em que: String - Qualquer expresso string vlida. Se a string contm Null, Null retornado. Exemplo:Dado = Casa Teste = LTrim(Dado) Teste = Casa

Second Categoria: Funes de Data e Hora Finalidade: Retorna o nmero de segundos da hora especificada (de 0 a 59). Sintaxe: Second(Time) Em que: Time - Qualquer expresso numrica ou string que possa representar um intervalo de tempo. Se Time contm Null, o valor de retorno da funo ser Null tambm. Exemplo:Teste = Second(#8:33:17 PM#) Teste = 17

Sgn Categoria: Funes Matemticas Finalidade: Retorna um inteiro conforme o sinal do nmero. Sintaxe: Sgn(Nmero) Em que: Nmero - Qualquer expresso numrica vlida. Ajustes: Se Nmero: Sgn Retorna: Maior que zero 1 Igual a zero 0 menor que zero -1 Exemplo:Teste = Sgn(12) Teste = Sgn(-2.4) Teste = Sgn(0) ' Teste = 1 ' Teste = -1 ' Teste = 0

Shell Categoria: Funes de Sistema Operacional Finalidade: Inicia a execuo de um programa qualquer. Sintaxe: Shell(Pathname[, Windowstyle]) Em que: Pathname - Nome do programa a ser executado. Pode incluir eventuais argumentos na linha de comando. Tambm pode incluir o diretrio e drive onde est localizado o executvel. Voc tambm pode informar o nome do documento se ele tiver sua extenso associada a um executvel no Windows (exemplo: .TXT abre o Notepad). Windowstyle - Nmero que corresponde ao estilo da janela em que o programa ser executado. Se omitido, o programa ser executado minimizado. Ajustes: Valor Descrio 0 A janela oculta e o foco passado para essa janela. 1 A janela tem o foco e restaurada para seu tamanho e posio originais. 2 A janela exibida como um cone com foco. 3 A janela maximizada com foco. 4 A janela restaurada ao seu mais recente tamanho e posio. A janela corrente permanece ativa. 6 A janela exibida como um cone. A janela corrente permanece ativa. Exemplo:Teste = Shell("C:\WINDOWS\NOTEPAD.EXE", 1)

Sin Categoria: Funes Matemticas Finalidade: Calcula o seno de um nmero. Sintaxe: Sin(Nmero) Em que:

Funes Internas

16

Nmero - Qualquer expresso numrica vlida que expresse um ngulo em radianos. Exemplo:Teste = Sin(1.25) Teste = Sin(.79) Teste = 0.948984619355586 Teste = 0.710353272417608

Space Categoria: Funes de Manipulao de Strings Finalidade: Retorna uma string com o nmero de espaos em branco especificado pelo usurio. Sintaxe: Space(Nmero) Em que: Nmero - A quantidade de espaos em branco que voc quer incluir na string. Exemplo:Dado = Passo Teste = Dado & Space(2) & Dado Teste = Passo Passo

Sqr Categoria: Funes Matemticas Finalidade: Calcula a raiz quadrada de um nmero. Sintaxe: Sqr(Nmero) Em que: Nmero - Qualquer expresso numrica vlida maior ou igual a zero. Exemplo:Teste = Sqr(16) Teste = 4

Str Categoria: Funes de Converso de Dados Finalidade: Retorna uma string representando o valor de um nmero. Sintaxe: Str(Nmero) Em que: Nmero - Qualquer expresso numrica vlida. Exemplo:Teste = Str(123) Teste = Str(2000) ' Teste = " 123" ' Teste = "2000

StrComp Categoria: Funes de Manipulao de Strings Finalidade: Retorna um valor indicando o resultado de uma comparao de strings (se maior, igual ou menor). Sintaxe: StrComp(String1, String2[, Compare]) Em que: String1 - Qualquer expresso string vlida. String2 - Qualquer expresso string vlida. Compare - Especifica o tipo de comparao a ser efetuado. Ajustes: Se: StrComp Retorna: String1 Menor que String2 -1 String1 igual String2 0 String1 maior que String2 1 String1 ou String2 Null Null Exemplo:Dado1 = "ABCD" Dado2 = "abcd" Teste = StrComp(Dado1, Dado2, 1) Teste = StrComp(Dado1, Dado2, 0) Teste = StrComp(Dado2, Dado1) ' Teste = 0. ' Teste = -1. ' Teste = 1.

StrConv Categoria: Funes de Manipulao de Strings Finalidade: Retorna uma string convertida de acordo com a operao especificada pelo usurio. Sintaxe: StrConv(String, Conversion) Em que: String - A string a ser convertida. Conversion - A soma dos valores que especificam o tipo da converso a ser feita. Ajustes: Valor Descrio 1 Converte a string em caracteres maisculos. 2 Converte a string em caracteres minsculos. 3 Converte a primeira letra de cada palavra da string em maiscula. Exemplo:Dado = visual basic Teste = StrConv(dado, 3) Teste = Visual Basic

Funes Internas

17

String Categoria: Funes de Manipulao de Strings Finalidade: Retorna uma string com caracteres repetidos no comprimento especificado pelo usurio. Sintaxe: String(Nmero, Caractere) Em que: Nmero - Comprimento da string a ser retornada. Caractere - Cdigo do caractere ou expresso string cujo primeiro caractere ser utilizado para construo da nova string. Exemplo:Teste = String(5, "*") Teste = String(5, 42) Teste = String(10, "ABC") 'Teste = "*****" 'Teste = "*****". 'Teste = "AAAAAAAAAA".

Tan Categoria: Funes Matemticas Finalidade: Calcula a tangente de um nmero. Sintaxe: Tan(Nmero) Em que: Nmero - Qualquer expresso numrica vlida que expresse um ngulo em radianos. Exemplo:Teste = Tan(.79) Teste = 1.00924628838275

Time Categoria: Funes de Data e Hora Finalidade: Retorna a hora atual do sistema. Sintaxe: Time Exemplo:Teste = Time Teste = 23:44:07

Timer Categoria: Funes de Data e Hora Finalidade: Retorna o nmero de segundos decorridos desde 0:00h (de 0 a 59). Sintaxe: Timer Exemplo:Teste = Timer Teste = 85591.6

TimeSerial Categoria: Funes de Data e Hora Finalidade: Retorna um Variant com o valor da hora, minuto e segundo especificado. Sintaxe: TimeSerial(Hora, Minuto, Segundo) Em que: Hora - Nmero entre 0 e 23 inclusive. Minuto - Qualquer expresso numrica. Segundo - Qualquer expresso numrica. Exemplo:REM Retorna a hh:mm:ss de 20:13:45 Teste = TimeSerial(20, 13, 45) Teste = 20:13:45

TimeValue Categoria: Funes de Data e Hora Finalidade: Retorna um valor de hora. Sintaxe: TimeValue(Tempo) Em que: Tempo - Expresso string representando uma hora entre 0:00:00 e 23:59:59 inclusive. Voc tambm pode utilizar qualquer expresso que represente uma indicao de tempo dentro da faixa de valores vlidos. O VB tambm aceita a notao AM/PM como em 2:00PM. Exemplo:REM Converte uma string num horrio Teste = TimeValue("14:00:23") Teste = 14:00:23

Trim Categoria: Funes de Manipulao de Strings Finalidade: Retorna uma cpia de uma string, eliminando os espaos existentes entre o incio da string e o primeiro caractere, e o ltimo caractere da string e o fim dela. Sintaxe: Trim(String) Em que: String - Qualquer expresso string vlida. Se a string contm Null, Null retornado. Exemplo:Dado = Casa Teste = LTrim(Dado) Teste = Casa

TypeName Categoria: Funes de Verificao Finalidade: Retorna uma string que informa qual o tipo de dados da varivel analisada. Sintaxe: TypeName(Varname)

Funes Internas

18

Em que: Varname - Qualquer varivel de memria. Ajustes: String Retornada: Byte Integer Long Single Double Currency Date String Boolean Error Empty Null Object Exemplo:Dim Dado As Integer Teste = TypeName(Dado)

Varivel Contm: Byte Integer Long integer Single Double Currency Date String Boolean Um valor de erro No inicializada Dado Invlido Um objeto que suporta OLE

Teste = Integer

Ubound Categoria: Funes de Array Finalidade: Retorna o maior elemento da dimenso especificada de um determinado array. Sintaxe: UBound(Arrayname[, Dimenso]) Em que: Arrayname - Nome da varivel array. Dimenso - Nmero que indica que dimenso do array est sendo inspecionada. Utilize 1 para a primeira dimenso, 2 para a segunda e assim por diante. Exemplo:Dim Dado(5 To 10) Teste = UBound(Dado, 1) Teste = 10

UCase Categoria: Funes de Manipulao de Strings Finalidade: Retorna uma string convertida em letras maisculas. Sintaxe: UCase(String) Em que: String - Qualquer expresso string vlida. Somente as letras minsculas sero convertidas em maisculas. Os demais caracteres, como nmeros e sinais, permanecem inalterados. Exemplo:Dado = caixa alta Teste = UCase(Dado) Teste = CAIXA ALTA

Val Categoria: Funes de Converso de Dados Finalidade: Retorna os nmeros contidos em uma string. Sintaxe: Val(String) Em que: String - Qualquer expresso string vlida. Exemplo:Teste = Val("2457") Teste = Val(" 2 45 7") Teste = Val("24 and 57") 'Teste = 2457. 'Teste = 2457. 'Teste = 24.

VarType Categoria: Funes de Verificao Finalidade: Retorna um valor indicando o subtipo de uma varivel. Sintaxe: VarType(Varname) Em que: Varname - Qualquer varivel de memria vlida. Ajustes: Valor Descrio da Varivel 0 Empty 1 Null 2 Integer 3 Long integer 4 Single 5 Double 6 Currency

Funes Internas

19

7 8 9 10 11 12 13 17 8192 Exemplo:Dim Dado As Integer Teste = VarType(Dado)

Date String OLE Automation object Error Boolean Variant (usada somente com arrays de Variants) No OLE Automation object Byte Array

Teste = 2

Weekday Categoria: Funes de Data e Hora Finalidade: Retorna o nmero do dia da semana (1 - Domingo, etc.). Sintaxe: Weekday(Data, [Firstdayofweek]) Em que: Data - Expresso string ou numrica representando uma data. Se Data contm Null, Null retornado. Firstdayofweek - Uma constante que define o primeiro dia da semana. Caso voc no especifique, o domingo ser considerado como primeiro dia. Veja a seo Ajustes da funo DateDiff para maiores detalhes. Exemplo:Teste = WeekDay(#6/22/96#) Teste = 7

Year Categoria: Funes de Data e Hora Finalidade: Retorna o nmero do ano de uma determinada data. Sintaxe: Year(Data) Em que: Data - Expresso string ou numrica representando uma data. Se Data contm Null, Null retornado. Exemplo:Teste = Year(#6/22/96#) Teste = 1996

Coleo de Exemplos e definies de FUNES VB 5Funes Internas

20

Funes Internas

21

Exemplo da diretiva #Const Este exemplo utiliza a diretiva #Const para declarar constantes de compilao condicional para uso em construes #If...#Else...#End If. #Const DebugVersion = 1 ' Avaliar verdadeiro no bloco #If. Exemplo da construo #If...Then...#Else Este exemplo faz referncia a constantes de compilao condicional em uma construo #If...Then...#Else para determinar se certas instrues sero compiladas. ' Se Mac avalia como verdadeiro, as instrues que se seguem a #If tambm o fazem. #If Mac Then '. Insere aqui exclusivamente instrues Mac. '. '. ' Caso contrrio, se for um programa do Windows de 32 bits, faz o seguinte: #ElseIf Win32 Then '. Insere aqui exclusivamente instrues do Windows de 32 bits. '. '. ' Caso contrrio, se no for uma coisa nem outra, faz o seguinte: #Else '. Insere aqui outras instrues de plataforma. '. '. #End If

Diretiva #ConstUtilizada para definir constantes condicionais do compilador no Visual Basic. Sintaxe #Const nomedaconst = expresso A sintaxe da diretiva de compilador #Const possui estas partes: Parte Descrio nomedaconstante Obrigatria; Variant (String). Nome da constante; obedece as convenes padronizadas para nomenclatura de varivel. expresso Obrigatria. Literal, outra constante condicional do compilador, ou qualquer combinao que inclua algum ou todos os operadores aritmticos ou lgicos, exceto Is.u

Comentrios As constantes condicionais do compilador so sempre Private para o mdulo no qual aparecem. No possvel criar constantes do compilador Public utilizando a diretiva #Const. Constantes do compilador Public s podem ser criadas na interface do usurio. Somente constantes condicionais do compilador e literais podem ser utilizadas em expresso. A utilizao de uma constante padro definida com Const ou de uma constante indefinida causar a ocorrncia de um erro. Contrariamente, as constantes definidas utilizando-se a palavra-chave #Const podem ser utilizadas somente para compilao condicional. As constantes condicionais do compilador so sempre avaliadas no nvel do mdulo, independentemente da sua posio no cdigo.

Diretiva #If...Then...#ElseCompila condicionalmente blocos selecionados do cdigo do Visual Basic. Sintaxe #If expresso Then instrues [#ElseIf expresso-n Then [instrueselseif]] [#Else [instrueselse]] #End If A sintaxe da diretiva #If...Then...#Else possui estas partes: Parte Descrio expresso Obrigatria. Qualquer expresso, consistindo exclusivamente de uma ou mais constantes condicionais do compilador, literais e operadores que so avaliados como True ou False.

Funes Internas

22

instrues

Obrigatria. Linhas de programa ou diretivas de compilador do Visual Basic que so avaliadas se a expresso associada for True. Opcional. Qualquer expresso, consistindo exclusivamente de uma ou mais constantes condicionais do compilador, literais e operadores que so avaliados como True ou False. Opcional. Uma ou mais linhas de programa ou diretivas de compilador que sero avaliadas se expresso-n for True. Opcional. Uma ou mais linhas de programa ou diretivas de compilador que sero avaliadas se nenhuma expresso ou expresso-n anterior for True.

expresso-n instrueselseif instrueselse

Comentrios O comportamento da diretiva #If...Then...#Else igual ao da instruo If...Then...Else, exceto que no h um formulrio de linha nica para as diretivas #If, #Else, #ElseIf e #End If; isto , nenhum outro cdigo pode aparecer na mesma linha que qualquer das diretivas. A compilao condicional normalmente utilizada para compilar o mesmo programa para plataformas diferentes. Tambm utilizada para evitar que o cdigo de depurao aparea em um arquivo executvel. O cdigo excludo durante a compilao condicional omitido completamente do arquivo executvel final e, desta forma, ele no afeta seu tamanho ou desempenho. Independentemente do resultado de qualquer avaliao, todas as expresses so avaliadas. Portanto, todas as constantes utilizadas em expresses devem ser definidas; qualquer constante no definida avaliada como Empty. Observao A instruo Option Compare no afeta expresses em instrues #If e #ElseIf. Expresses em uma diretiva de compilador condicional so sempre avaliadas com Option Compare Text.

Constantes do Visual BasicO Visual Basic para Aplicativos define as constantes para simplificar sua programao. As constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais:

Constantes do calendrioAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbCalGreg 0 Indica que o calendrio gregoriano utilizado vbCalHijri 1 Indica que o calendrio Hijri utilizado

Constantes do compiladorO Visual Basic para Aplicativos define as constantes para utilizao exclusiva com a diretiva #If...Then...#Else. Essas constantes so funcionalmente equivalentes s constantes definidas com a diretiva #If...Then...#Else, exceto que elas so globais no que se refere ao escopo; isto , elas se aplicam a todo o projeto. Em plataformas de desenvolvimento de 16 bits, as constantes do compilador so definidas da seguinte maneira: Constante Valor Descrio Win16 True Indica que o ambiente de desenvolvimento de 16 bits. Win32 False Indica que o ambiente de desenvolvimento no de 32 bits. Em plataformas de desenvolvimento de 32 bits, as constantes do compilador so definidas da seguinte maneira: Constante Valor Descrio Win16 False Indica que o ambiente de desenvolvimento no de 16 bits. Win32 True Indica que o ambiente de desenvolvimento de 32 bits. Observao Essas constantes so fornecidas pelo Visual Basic. Sendo assim voc no pode definir suas prprias constantes com esses mesmos nomes em qualquer nvel.

Funes Internas

23

Constantes DateAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Valores do argumento O argumento primeirodiadasemana possui os valores a seguir: Constante Valor Descrio vbUseSystem 0 Utiliza a definio NLS API. VbSunday 1 Domingo (padro) vbMonday 2 Segunda vbTuesday 3 Tera vbWednesday 4 Quarta vbThursday 5 Quinta vbFriday 6 Sexta vbSaturday 7 Sbado O argumento primeirodiadoano possui os valores a seguir: Constante Valor Descrio vbUseSystem 0 Utiliza a definio NLS API. VbFirstJan1 1 Inicia com a semana na qual ocorre o dia 1 de janeiro (padro). VbFirstFourDays 2 Inicia com a primeira semana que possui pelo menos quatro dias do ano novo. VbFirstFullWeek 3 Inicia com a primeira semana completa do ano. Valores de retorno Constante vbSunday vbMonday vbTuesday vbWednesday vbThursday vbFriday vbSaturday Valor 1 2 3 4 5 6 7 Descrio Domingo Segunda Tera Quarta Quinta Sexta Sbado

Constantes Dir, GetAttr e SetAttrAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbNormal 0 Normal (padro de Dir e SetAttr) vbReadOnly 1 Somente leitura vbHidden 2 Oculto vbSystem 4 Arquivo do sistema vbVolume 8 Rtulo do volume vbDirectory 16 Diretrio ou pasta vbArchive 32 O arquivo foi alterado desde o ltimo backup

Constantes IMEStatusAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: As constantes referentes localidade japonesa so as seguintes: Constante Valor Descrio vbIMENoOp 0 Nenhum IME instalado vbIMEOn 1 IME ligado vbIMEOff 2 IME desligado vbIMEDisable 3 IME desativado vbIMEHiragana 4 Caracteres de duplo byte Hiragana (DBC) vbIMEKatakanaDbl 5 Katakana DBC vbIMEKatakanaSng 6 Caracteres de byte simples Katakana (SBC) vbIMEAlphaDbl 7 DBC alfanumrico vbIMEAlphaSng 8 SBC alfanumrico As constantes para a localidade chinesa (em chins tradicional e simplificado) so as seguintes: Constante Valor Descrio vbIMENoOp 0 Nenhum IME instalado vbIMEOn 1 IME ligado vbIMEOff 2 IME desligado Para a localidade coreana, os cinco primeiros bits do valor de retorno so os seguintes: Bit Valor Descrio Valor Descrio 0 0 Nenhum IME instalado 1 IME instalado 1 0 IME desativado 1 IME ativado 2 0 Modo ingls IME 1 Modo Hangeul 3 0 Modo Banja (SBC) 1 Modo Junja (DBC)

Funes Internas

24

4

0

Modo normal

1

Modo de converso Hanja

Constantes Instr e StrCompAs constantes a seguir so definidas na biblioteca de tipos do Visual Basic para Aplicativos e podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbBinaryCompare 0 Realiza a comparao binria vbTextCompare 1 Realiza a comparao textual vbDatabaseCompare 2 Para o Microsoft Access, realiza a comparao baseada nas informaes contidas em seu banco de dados.

Constantes diversasAs constantes a seguir so definidas na biblioteca de tipos do Visual Basic para Aplicativos e podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Equivalente Descrio vbCrLf Chr(13) + Chr(10) Combinao de retorno de carro e alimentao de linha vbCr Chr(13) Caractere de retorno de carro vbLf Chr(10) Caractere de alimentao de linha vbNewLine Chr(13) + Chr(10) ouCaractere de linha nova especfico de uma Chr(13) plataforma; aquele que seja apropriado plataforma atual vbNullChar Chr(0) Caractere que possui o valor 0 vbNullString Seqncia contendo oNo o mesmo que a seqncia de valor 0 comprimento zero (""); utilizada para chamar procedimentos externos vbTab Chr(9) Caractere de tabulao vbBack Chr(8) Caractere de backspace vbFormFeed Chr(12) No til no Microsoft Windows vbVerticalTab Chr(11) No til no Microsoft Windows

Constantes MsgBoxAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Argumentos MsgBox Constante Valor Descrio vbOKOnly 0 Apenas o boto OK (padro) vbOKCancel 1 Botes OK e Cancelar vbAbortRetryIgnore 2 Botes Anular, Repetir e Ignorar vbYesNoCancel 3 Botes Sim, No e Cancelar vbYesNo 4 Botes Sim e No vbRetryCancel 5 Botes Repetir e Cancelar vbCritical 16 Mensagem crtica vbQuestion 32 Consulta de aviso vbExclamation 48 Mensagem de aviso vbInformation 64 Mensagem de informao vbDefaultButton1 0 Primeiro boto o padro (padro) vbDefaultButton2 256 Segundo boto o padro vbDefaultButton3 512 Terceiro boto o padro vbDefaultButton4 768 Quarto boto o padro vbApplicationModal 0 Caixa de mensagem relativa ao modo do aplicativo (padro) vbSystemModal 4096 Caixa de mensagem relativa ao modo do sistema Valores de retorno de MsgBox Constante vbOK vbCancel vbAbort vbRetry vbIgnore vbYes vbNo Valor 1 2 3 4 5 6 7 Descrio Boto OK pressionado Boto Cancelar pressionado Boto Anular pressionado Boto Repetir pressionado Boto Ignorar pressionado Boto Sim pressionado Boto No pressionado

Funes Internas

25

Constantes ShellAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbHide 0 A janela est oculta e o foco passado para a janela oculta. vbNormalFocus 1 A janela recebe o foco e restaurada para seu tamanho e posio originais. vbMinimizedFocus 2 A janela exibida como um cone com o foco sobre ela. vbMaximizedFocus 3 A janela maximizada com o foco. vbNormalNoFocus 4 A janela restaurada para o tamanho e posio mais recentes. A janela atualmente ativa permanece ativa. vbMinimizeNoFocus 6 A janela exibida como um cone. A janela atualmente ativa permanece ativa.

Constantes StrConvAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbUpperCase 1 Converte a seqncia em caracteres maisculos. VbLowerCase 2 Converte a seqncia em caracteres minsculos. VbProperCase 3 Converte a primeira letra de cada palavra da seqncia em maisculas. VbWide 4 Converte os caracteres estreitos (de byte simples) da seqncia em caracteres largos (de byte duplo). Aplicvel s localidades do oriente. VbNarrow 8 Converte os caracteres largos (de byte duplo) da seqncia em caracteres estreitos (de byte simples). Aplicvel s localidades do oriente. VbKatakana 16 Converte caracteres Hiragana da seqncia em caracteres Katakana. Aplicvel apenas ao Japo. vbHiragana 32 Converte os caracteres Katakana da seqncia em caracteres Hiragana. Aplicvel apenas ao Japo. vbUnicode 64 Converte a seqncia para Unicode utilizando a pgina de cdigo padro do sistema. vbFromUnicode 128 Converte a seqncia de Unicode para a pgina de cdigos padro do sistema.

Constantes VarTypeAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbEmpty 0 No-inicializada (padro) vbNull 1 No contm dados vlidos vbInteger 2 Integer vbLong 3 Inteiro longo vbSingle 4 Nmero de vrgula flutuante de preciso nica vbDouble 5 Nmero de vrgula flutuante de preciso dupla vbCurrency 6 Currency vbDate 7 Date vbString 8 String vbObject 9 Objeto vbError 10 Erro vbBoolean 11 Boolean vbVariant 12 Variant (utilizada apenas para as matrizes de variantes) vbDataObject 13 Objeto de acesso a dados vbDecimal 14 Decimal vbByte 17 Byte vbArray 8192 Matriz

Constantes de corAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbBlack 0x0 Preto vbRed 0xFF Vermelho

Funes Internas

26

vbGreen vbYellow vbBlue vbMagenta vbCyan vbWhite

0xFF00 0xFFFF 0xFF0000 0xFF00FF 0xFFFF00 0xFFFFFF

Verde Amarelo Azul Magenta Ciano Branco

Constantes de cdigo de teclaAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbKeyLButton 0x1 Boto esquerdo do mouse vbKeyRButton 0x2 Boto direito do mouse vbKeyCancel 0x3 Tecla CANCEL vbKeyMButton 0x4 Boto do meio do mouse vbKeyBack 0x8 Tecla BACKSPACE vbKeyTab 0x9 Tecla TAB vbKeyClear 0xC Tecla CLEAR vbKeyReturn 0xD Tecla ENTER vbKeyShift 0x10 Tecla SHIFT vbKeyControl 0x11 Tecla CTRL vbKeyMenu 0x12 Tecla MENU vbKeyPause 0x13 Tecla PAUSE vbKeyCapital 0x14 Tecla CAPS LOCK vbKeyEscape 0x1B Tecla ESC vbKeySpace 0x20 Tecla SPACEBAR vbKeyPageUp 0x21 Tecla PAGE UP vbKeyPageDown 0x22 Tecla PAGE DOWN vbKeyEnd 0x23 Tecla END vbKeyHome 0x24 Tecla HOME vbKeyLeft 0x25 Tecla SETA ESQUERDA vbKeyUp 0x26 Tecla SETA ACIMA vbKeyRight 0x27 Tecla SETA DIREITA vbKeyDown 0x28 Tecla SETA ABAIXO vbKeySelect 0x29 Tecla SELECT vbKeyPrint 0x2A Tecla PRINT SCREEN vbKeyExecute 0x2B Tecla EXECUTE vbKeySnapshot 0x2C Tecla SNAPSHOT vbKeyInsert 0x2D Tecla INSERT vbKeyDelete 0x2E Tecla DELETE vbKeyHelp 0x2F Tecla HELP vbKeyNumlock 0x90 Tecla NUM LOCK As teclas de A a Z so as mesmas teclas ASCII de A a Z equivalentes: Constante Valor Descrio vbKeyA 65 Tecla A vbKeyB 66 Tecla B vbKeyC 67 Tecla C vbKeyD 68 Tecla D vbKeyE 69 Tecla E vbKeyF 70 Tecla F vbKeyG 71 Tecla G vbKeyH 72 Tecla H vbKeyI 73 Tecla I vbKeyJ 74 Tecla J vbKeyK 75 Tecla K vbKeyL 76 Tecla L vbKeyM 77 Tecla M vbKeyN 78 Tecla N vbKeyO 79 Tecla O vbKeyP 80 Tecla P vbKeyQ 81 Tecla Q vbKeyR 82 Tecla R vbKeyS 83 Tecla S vbKeyT 84 Tecla T vbKeyU 85 Tecla U vbKeyV 86 Tecla V vbKeyW 87 Tecla W vbKeyX 88 Tecla X vbKeyY 89 Tecla Y

Funes Internas

27

vbKeyZ

90

Tecla Z

As teclas de 0 a 9 so as mesmas teclas ASCII de 0 a 9 equivalentes: Constante Valor Descrio vbKey0 48 Tecla 0 vbKey1 49 Tecla 1 vbKey2 50 Tecla 2 vbKey3 51 Tecla 3 vbKey4 52 Tecla 4 vbKey5 53 Tecla 5 vbKey6 54 Tecla 6 vbKey7 55 Tecla 7 vbKey8 56 Tecla 8 vbKey9 57 Tecla 9 As constantes a seguir representam teclas no teclado numrico: Constante Valor Descrio vbKeyNumpad0 0x60 Tecla 0 vbKeyNumpad1 0x61 Tecla 1 vbKeyNumpad2 0x62 Tecla 2 vbKeyNumpad3 0x63 Tecla 3 vbKeyNumpad4 0x64 Tecla 4 vbKeyNumpad5 0x65 Tecla 5 vbKeyNumpad6 0x66 Tecla 6 vbKeyNumpad7 0x67 Tecla 7 vbKeyNumpad8 0x68 Tecla 8 vbKeyNumpad9 0x69 Tecla 9 vbKeyMultiply 0x6A Tecla SINAL DE MULTIPLICAO (*) vbKeyAdd 0x6B Tecla SINAL DE ADIO (+) vbKeySeparator 0x6C Tecla ENTER vbKeySubtract 0x6D Tecla SINAL DE SUBTRAO () vbKeyDecimal 0x6E Tecla PONTO DECIMAL (.) vbKeyDivide 0x6F Tecla SINAL DE DIVISO (/) As constantes a seguir representam teclas de funo: Constante Valor Descrio vbKeyF1 0x70 Tecla F1 vbKeyF2 0x71 Tecla F2 vbKeyF3 0x72 Tecla F3 vbKeyF4 0x73 Tecla F4 vbKeyF5 0x74 Tecla F5 vbKeyF6 0x75 Tecla F6 vbKeyF7 0x76 Tecla F7 vbKeyF8 0x77 Tecla F8 vbKeyF9 0x78 Tecla F9 vbKeyF10 0x79 Tecla F10 vbKeyF11 0x7A Tecla F11 vbKeyF12 0x7B Tecla F12 vbKeyF13 0x7C Tecla F13 vbKeyF14 0x7D Tecla F14 vbKeyF15 0x7E Tecla F15 vbKeyF16 0x7F Tecla F16

Funes Internas

28

Constantes da cor do sistemaAs constantes a seguir podem ser utilizadas em qualquer parte do seu cdigo no lugar dos valores reais: Constante Valor Descrio vbScrollBars 0x80000000 Cor da barra de rolagem vbDesktop 0x80000001 Cor da rea de trabalho vbActiveTitleBar 0x80000002 Cor da barra de ttulo da janela ativa vbInactiveTitleBar 0x80000003 Cor da barra de ttulo da janela inativa vbMenuBar 0x80000004 Cor de segundo plano do menu vbWindowBackground 0x80000005 Cor de segundo plano da janela vbWindowFrame 0x80000006 Cor da moldura da janela vbMenuText 0x80000007 Cor do texto nos menus vbWindowText 0x80000008 Cor do texto nas janelas vbTitleBarText 0x80000009 Cor do texto na legenda, caixa de dimensionamento e seta de rolagem vbActiveBorder 0x8000000A Cor da borda da janela ativa vbInactiveBorder 0x8000000B Cor da borda da janela inativa vbApplicationWorkspace 0x8000000C Cor de segundo plano dos aplicativos de interface de mltiplos documentos (MDI, Multiple-Document Interface) vbHighlight 0x8000000D Cor de segundo plano dos itens selecionados em um controle vbHighlightText 0x8000000E Cor do texto dos itens selecionados em um controle vbButtonFace 0x8000000F Cor de sombreamento da superfcie dos botes de comando vbButtonShadow 0x80000010 Cor de sombreamento da extremidade dos botes de comando vbGrayText 0x80000011 Texto acinzentado (desativado) vbButtonText 0x80000012 Cor do texto dos botes de pressionamento vbInactiveCaptionText 0x80000013 Cor do texto de uma legenda ativa vb3DHighlight 0x80000014 Cor de realce de elementos de exibio em 3-D vb3DDKShadow 0x80000015 Cor de sombreamento mais escura dos elementos de exibio em 3-D vb3DLight 0x80000016 Segunda cor 3-D mais clara depois de vb3DHighlight vbInfoText 0x80000017 Cor do texto das Dicas de ferramentas vbInfoBackground 0x80000018 Cor de segundo plano das Dicas de ferramentas Exemplo da instruo Call Este exemplo ilustra como a instruo Call utilizada para transferir o controle para um procedimento Sub, uma funo intrnseca, um procedimento da biblioteca de vinculao dinmica (DLL) e um procedimento. ' Chama um procedimento Sub. Call PrintToDebugWindow("Al Mundo") ' A instruo anterior faz com que o controle seja passado ao procedimento ' Sub seguinte. Sub PrintToDebugWindow(AnyString) Debug.Print AnyString ' Imprime na janela Depurar. End Sub ' Chama uma funo intrnseca. O valor de retorno da funo descartado. Call Shell(AppName, 1) ' AppName contm o caminho do arquivo executvel. ' Chama um procedimento DLL do Microsoft Windows. A ' instruo Declare deve ser Private em um Mdulo de ' classe, mas no em um Mdulo padro. Private Declare Sub MessageBeep Lib "Usurio" (ByVal N As Integer) Sub CallMyDll() Call MessageBeep(0) ' Chama o procedimento DLL do Windows. MessageBeep 0 ' Chama novamente sem a palavra-chave Call.

Funes Internas

29

End Sub Exemplo da funo Choose Este exemplo utiliza a funo Choose para exibir um nome em resposta a um ndice passado ao procedimento no parmetro Ind. Function GetChoice(Ind As Integer) GetChoice = Choose(Ind, "Expresso", "United", "Federal") End Function

Funes Internas

30

Exemplo da funo DoEvents Este exemplo utiliza a funo DoEvents para fazer com que se saia para o sistema operacional uma vez a cada 1000 iteraes do loop. DoEvents retorna o nmero de formulrios abertos do Visual Basic, mas somente quando o aplicativo host for o Visual Basic. ' Cria uma varivel para conter o nmero de formulrios ' do Visual Basic carregados e visveis. Dim I, AbreFormulrios For I = 1 To 150000 ' Inicia o loop. If I Mod 1000 = 0 Then ' Se o loop tiver se repetido 1000 vezes. AbreFormulrios = DoEvents ' Submete-se ao sistema operacional. End If Next I' Incrementa o contador de loops. Exemplo da instruo Do...Loop Este exemplo mostra como as instrues Do...Loop podem ser utilizadas. A instruo Do...Loop interna faz o loop 10 vez, define o valor do sinalizador como False e sai prematuramente utilizando a instruo Exit Do. O loop externo sai imediatamente aps a verificao do valor do sinalizador. Dim Controle, Contador Controle = True: Contador = 0 ' Inicializa as variveis. Do ' Loop externo. Do While Contador < 20 ' Loop interno. Contador = Contador + 1 ' Incrementa o Contador. If Contador = 10 Then ' Se a condio for True. Controle = False ' Define o valor do sinalizador como False. Exit Do ' Sai do loop interno. End If Loop Loop Until Controle = False ' Sai do loop externo imediatamente. Exemplo da instruo End Este exemplo utiliza a instruo End para encerrar a execuo do cdigo se o usurio inserir uma senha invlida. Sub Form_Load Dim Senha, ASenha Senha = "Swordfish" ASenha = InputBox("Digite a sua senha") If ASenha Senha Then MsgBox "Sinto muito, senha incorreta" End End If End Sub

Funes Internas

31

Exemplo da instruo Exit Este exemplo utiliza a instruo Exit para sair de um loop For...Next, Do...Loop e de um procedimento Sub. Sub ExitStatementDemo() Dim I, MeuNum Do ' Configura o loop infinito. For I = 1 To 1000 ' Faz o loop 1000 vezes. MeuNum = Int(Rnd * 1000)' Gera nmeros aleatrios. Select Case MeuNum ' Avalia o nmero aleatrio. Case 7: Exit For ' Se 7, sai de For...Next. Case 29: Exit Do ' Se 29, sai de Do...Loop. Case 54: Exit Sub ' Se 54, sai do procedimento Sub. End Select Next I Loop End Sub Exemplo da instruo For Each...Next Este exemplo utiliza a instruo For Each...Next para pesquisar a propriedade Text de todos os elementos em uma coleo procura da seqncia de caracteres "Al". No exemplo, MeuObjeto um objeto relacionado ao texto e um elemento da coleo MinhaColeo. Ambos so nomes genricos utilizados somente com finalidades ilustrativas. Dim Encontrado, MeuObjeto, MinhaColeo Encontrado = False ' Inicializa a varivel. For Each MeuObjeto In MinhaColeo ' Itera a cada elemento. If MeuObjeto.Text = "Al" Then ' Se Text for igual a "Al". Encontrado = True ' Define Encontrado como True. Exit For ' Sai do loop. End If Next Exemplo da instruo For...Next Este exemplo utiliza a instruo For...Next para criar uma seqncia de caracteres que contm 10 instncias dos nmeros 0 a 9, cada seqncia de caracteres separada da outra por um nico espao. O loop externo utiliza uma varivel de contador de loops que decrescida toda vez atravs do loop. Dim Palavras, Caracteres, MinhaSeqncia For Palavras = 10 To 1 Step -1 ' Configura 10 repeties. For Caracteres = 0 To 9 ' Configura 10 repeties. MinhaSeqncia = MinhaSeqncia & Caracteres ' Acrescenta o nmero seqncia de caracteres. Next Caracteres ' Incrementa o contador MinhaSeqncia = MinhaSeqncia & " " ' Acrescenta um espao. Next Palavras

Funes Internas

32

Exemplo da instruo GoSub...Return Este exemplo utiliza GoSub para chamar uma sub-rotina dentro de um procedimento Sub. A instruo Return faz com que a execuo continue imediatamente aps a instruo GoSub. A instruo Exit Sub utilizada para evitar que o controle flua acidentalmente para a sub-rotina. Sub GosubDemo() Dim Num ' Solicita um nmero ao usurio. Num = InputBox("Insira um nmero positivo para ser dividido por 2.") ' Utiliza a rotina somente se o usurio inserir um nmero positivo. If Num > 0 Then GoSub MinhaRotina Debug.Print Num Exit Sub ' Utiliza Exit para evitar um erro. MinhaRotina: Num = Num/2 ' Executa a diviso. Return ' Retorna o controle instruo End Sub ' que se segue instruo GoSub. Exemplo da instruo GoTo Este exemplo utiliza a instruo GoTo para desviar para rtulos de linha de um procedimento. Sub GotoStatementDemo() Dim Nmero, MinhaSeqncia Nmero = 1 ' Inicializa a varivel. ' Avalia Nmero e desvia para o rtulo apropriado. If Nmero = 1 Then GoTo Line1 Else GoTo Line2 Line1: MinhaSeqncia = "Nmero igual a 1" GoTo LastLine ' Vai para LastLine. Line2: ' A instruo a seguir nunca executada. MinhaSeqncia = "Nmero igual a 2" LastLine: Debug.Print MinhaSeqncia ' Imprime "Nmero igual a 1" na ' janela Depurar. End Sub Exemplo da instruo If...Then...Else Este exemplo mostra as formas de bloco e de linha nica da instruo If...Then...Else. Ele tambm ilustra o uso de If TypeOf...Then...Else. Dim Nmero, Dgitos, MinhaSeqncia Nmero = 53 ' Inicializa a varivel. If Nmero < 10 Then Dgitos = 1 ElseIf Nmero < 100 Then ' A condio avalia como True, ento a prxima instruo executada. Dgitos = 2 Else Dgitos = 3 End If ' Atribui um valor utilizando a forma de sintaxe de linha nica. If Dgitos = 1 Then MinhaSeqncia = "Uma" Else MinhaSeqncia = "Mais de uma" Utilize a construo If TypeOf para determinar se o Controle passado para um procedimento uma caixa de texto. Sub ControlProcessor(MeuControle As Control) If TypeOf MeuControle Is CommandButton Then Debug.Print "Voc passou um " & TypeName(MeuControle) ElseIf TypeOf MeuControle Is CheckBox Then Debug.Print "Voc passou um " & TypeName(MeuControle) ElseIf TypeOf MeuControle Is TextBox Then Debug.Print "Voc passou um " & TypeName(MeuControle) End If End Sub Exemplo da funo IIf Este exemplo utiliza a funo IIf para avaliar o parmetro TestMe do procedimento CheckIt e retorna a palavra "Grande" se a quantidade for maior que 1000; do contrrio, retorna a palavra "Pequena". Function CheckIt (TestMe As Integer) CheckIt = IIf(TestMe > 1000, "Grande", "Pequena")

Funes Internas

33

End Function Exemplo das instrues On...GoSub e On...GoTo Este exemplo utiliza as instrues On...GoSub e On...GoTo para desviar para sub-rotinas e rtulos de linha, respectivamente. Sub OnGosubGotoDemo() Dim Nmero, MinhaSeqncia Nmero = 2 ' Inicializa a varivel. ' Desvia para Sub2. On Nmero GoSub Sub1, Sub2 ' A execuo continua aqui depois de ' On...GoSub. On Nmero GoTo Linha1, Linha2 ' Desvia para Linha2. ' A execuo no continua aqui depois de On...GoTo. Exit Sub Sub1: MihaSeqncia = "Em Sub1" : Return Sub2: MinhaSeqncia = "Em Sub2" : Return Linha1: MinhaSeqncia = "Em Linha1" Linha2: MinhaSeqncia = "Em Linha2" End Sub

Funes Internas

34

Exemplo da funo Partition Este exemplo pressupe que voc tem uma tabela Pedidos que contm um campo Frete. Ela cria um procedimento de seleo que conta o nmero de pedidos para os quais o custo se enquadra em cada um dos diversos intervalos. A funo Partition utilizada primeiro para estabelecer esses intervalos e, em seguida, a funo SQL Count conta o nmero de pedidos em cada faixa. Neste exemplo, os argumentos da funo Partition so incio = 0, fim = 500, intervalo = 50. O primeiro intervalo, portanto, seria 0:49, e assim por diante at 500. SELECT DISTINCTROW Partition([frete],0, 500, 50) AS Range, Count(Pedidos.Frete) AS Count FROM Pedidos GROUP BY Partition([frete],0,500,50); Exemplo da instruo Select Case Este exemplo utiliza a instruo Select Case para avaliar o valor de uma varivel. A segunda clusula Case contm o valor da varivel que est sendo avaliada e, portanto, somente a instruo associada a ela executada. Dim Nmero Nmero = 8 ' Inicializa a varivel. Select Case Nmero ' Avalia Nmero. Case 1 To 5 ' Nmero entre 1 e 5. Debug.Print "Entre 1 e 5" ' A seguinte a nica clusula Case que avalia como True. Case 6, 7, 8 ' Nmero entre 6 e 8. Debug.Print "Entre 6 e 8" Case Is > 8 And Nmero < 11 ' Nmero 9 ou 10. Debug.Print "Maior que 8" Case Else ' Outros valores. Debug.Print "No entre 1 e 10" End Select Exemplo da funo Shell Este exemplo utiliza a funo Shell para executar um aplicativo especificado pelo usurio. ' Especificar 1 como o segundo argumento abre o aplicativo no tamanho normal e lhe d o foco. Dim ValRet ValRet = Shell("C:\WINDOWS\CALC.EXE", 1) ' Executa Calculator.

Funes Internas

35

Exemplo da instruo Stop Este exemplo utiliza a instruo Stop para suspender a execuo de cada iterao atravs do loop For...Next. Dim I For I = 1 To 10 ' Inicia o loop For...Next. Debug.Print I ' Imprime I na janela Depurar. Stop ' Pra durante cada iterao. Next I Exemplo da funo Switch Este exemplo utiliza a funo Switch para retornar o nome de um idioma que corresponde ao nome de uma cidade. Function MatchUp (NomeDeCidade As String) Matchup = Switch(NomeDeCidade = "Londres", "Ingls", NomeDeCidade _ = "Roma", "Italiano", NomeDeCidade = "Paris", "Francs") End Function Exemplo da instruo While...Wend Este exemplo utiliza a instruo While...Wend para incrementar uma varivel de contador. As instrues no loop so executadas desde que a condio avalie True. Dim Contador Contador = 0 ' Inicializa a varivel. While Contador < 20 ' Testa valor de Contador. Contador = Contador + 1 ' Incrementa Contador. Wend' Encerra o loop While quando Contador > 19. Debug.Print Contador ' Imprime 20 na janela Depurar. Exemplo da instruo With Este exemplo utiliza a instruo With para executar uma srie de instrues em um nico objeto. O objeto MeuObjeto e as suas propriedades so nomes genricos utilizados somente com finalidades ilustrativas. With MeuObjeto .Height = 100 ' Igual a MeuObjeto.Height = 100. .Caption = "Al Mundo" ' Igual a MeuObjeto.Caption = "Al Mundo". With .Font .Color = Red ' Igual a MeuObjeto.Font.Color = Red. .Bold = True ' Igual a MeuObjeto.Font.Bold = True. End With End With

Funes Internas

36

Instruo CallTransfere o controle para um procedimento Sub, um procedimento Function ou procedimento de biblioteca de vnculos dinmicos (DLL). Sintaxe [Call] nome [listadeargumentos] A sintaxe da instruo Call possui as partes a seguir: Parte Descrio Call Opcional; palavra-chave. Se for especificada, voc dever colocar listadeargumentos entre parnteses. Por exemplo: Call MyProc(0) nome Obrigatria. Nome do procedimento a chamar. listadeargumentos Opcional. Lista, delimitada por vrgulas, de variveis, matrizes ou expresses a serem passadas para o procedimento. Os componentes da listadeargumentos podem incluir as palavraschave ByVal ou ByRef para descrever como os argumentos so tratados pelo procedimento chamado. Entretanto, ByVal e ByRef podem ser utilizadas com Call somente quando for chamado um procedimento DLL. Comentrios No necessrio que voc utilize a palavra-chave Call quando chamar um procedimento, entretanto, se voc us-la para chamar um procedimento que requer argumentos, a listadeargumentos deve ficar entre parnteses. Se voc omitir a palavra-chave Call, tambm dever omitir os parnteses de listadeargumentos. Se utilizar qualquer sintaxe de Call para chamar alguma funo intrnseca ou definida pelo usurio, o valor de retorno da funo ser descartado. Para passar uma matriz inteira para um procedimento, utilize o nome da matriz seguido de parnteses vazios.

Funo ChooseSeleciona e retorna um valor de uma lista de argumentos. Sintaxe Choose(ndice, escolha-1[, escolha-2, ... [, escolha-n]]) A sintaxe da funo Choose possui as partes a seguir: Parte Descrio ndice Obrigatria. Expresso numrica ou campo que resulta em um valor entre 1 e o nmero de escolhas disponveis. escolha Obrigatria. Expresso Variant contendo uma das escolhas possveis. Comentrios Choose retorna um valor da lista de escolhas com base no valor do ndice. Se ndice for 1, Choose retorna a primeira escolha da lista, se for 2, retorna a segunda escolha e assim por diante. Voc pode utilizar Choose para pesquisar um valor em uma lista de possibilidades. Por exemplo, se ndice for avaliado como 3 e escolha-1 = "um", escolha-2 = "dois" e escolha-3 = "trs", Choose retorna "trs". Esta capacidade particularmente til se ndice representa o valor em um grupo de opes. Choose avalia todas as escolhas da lista, mesmo que ela retorne somente uma. Em razo disto voc deve observar se existem efeitos colaterais indesejveis. Por exemplo, se voc utilizar a funo MsgBox como parte de uma expresso em todas as escolhas, ser exibida uma caixa de mensagem quando cada escolha for avaliada, mesmo que Choose retorne o valor de apenas uma delas. A funo Choose retorna um Null se ndice for menor que 1 ou maior que o nmero de escolhas listadas. Se ndice no for um nmero inteiro, ser arredondado para o nmero inteiro mais prximo antes de ser avaliado.

Funo DoEventsCede a execuo para que o sistema operacional possa processar outros eventos. Sintaxe DoEvents( ) Comentrios A funo DoEvents retorna um Integer que representa o nmero de formulrios abertos em verses autnomas do Visual Basic, como o Visual Basic, Standard Edition. DoEvents retorna zero em todos os outros aplicativos. DoEvents passa o controle para o sistema operacional. O controle retornado depois de o sistema operacional terminar o processamento de eventos da sua fila e todas as chaves da fila SendKeys terem sido enviadas. DoEvents tem uma maior utilidade com aes simples como permitir que um usurio cancele o processo aps ele ter sido iniciado, por exemplo, uma procura por um arquivo. Para processos de longa execuo, o controle do processador conseguido com maior facilidade utilizando-se um cronmetro ou delegando-se a tarefa a um componente ActiveX EXE. Nesse ltimo caso, a tarefa pode continuar de forma completamente independente de seu aplicativo e o sistema operacional leva em considerao a multitarefa e a diviso de tempo. Ateno Sempre que voc cede o controle ao processador dentro de um procedimento de evento, certifique-se de que o procedimento no seja executado novamente a partir de uma outra parte do seu cdigo antes que a primeira chamada retorne, pois isto poderia produzir resultados imprevisveis. Alm disto, no utilize DoEvents se houver possibilidade de outros aplicativos interagirem com o seu procedimento de forma imprevisvel durante o tempo em que voc ceder o controle. Funes Internas

37

Funes Internas

38

Instruo Do...LoopRepete um bloco de instrues enquanto uma condio True ou at que ela se torne True. Sintaxe Do [{While | Until} [instrues] [Exit [instrues] Loop Ou voc pode utilizar esta sintaxe: Do [instrues] [Exit [instrues] Loop [{While | Until} condio] A sintaxe da instruo Do Loop possui as partes a seguir: Parte Descrio condio Opcional. Expresso numrica ou expresso de seqncia que seja True ou False. Se condio for Null, condio tratada como False. instrues Uma ou mais instrues que so repetidas enquanto, ou at que, condio seja True. condio] Do]

Do]

Comentrios Qualquer nmero de instrues Exit Do pode ser colocado em qualquer lugar em DoLoop como meio alternativo para sair de um DoLoop. Exit Do freqentemente utilizada depois que alguma condio avaliada, por exemplo, IfThen, caso em que a instruo Exit Do transfere o controle para a instruo imediatamente seguinte a Loop. Quando utilizada com instrues DoLoop embutidas, Exit Do transfere o controle para o loop que est embutido em um nvel acima do loop em que ocorre Exit Do.

Instruo EndFinaliza um procedimento ou bloco. Sintaxe End End Function End If End Property End Select End Sub End Type End With A sintaxe da instruo End possui as formas a seguir: Instruo Descrio End Termina a execuo imediatamente. Nunca obrigatria por si mesma, mas pode ser colocada em qualquer lugar dentro de um procedimento para finalizar a execuo do cdigo, fechar arquivos abertos com a instruo Open e limpar variveis. End Function Obrigatria para finalizar uma instruo Function. End If Obrigatria para finalizar uma instruo de bloco IfThenElse. End Property Obrigatria para finalizar um procedimento Property Let, Property Get ou Property Set. End Select Obrigatria para finalizar uma instruo Select Case. End Sub Obrigatria para finalizar uma instruo Sub. End Type Obrigatria finalizar uma definio de tipo definido pelo usurio (instruo Type). End With Obrigatria para finalizar uma instruo With. Comentrios Quando executada, a instruo End redefine todas as variveis em nvel de mdulo e todas as variveis locais estticas em todos os mdulos. Para preservar o valor dessas variveis, utilize a instruo Stop. Assim, voc poder continuar a execuo preservando o valor daquelas variveis. Observao A instruo End interrompe a execuo do cdigo abruptamente, sem chamar o evento Unload, QueryUnload ou Terminate ou qualquer outro cdigo do Visual Basic. O cdigo que voc colocou nos eventos Unload, QueryUnload e Terminate de formulrios e mdulos de classe no executado. Os objetos criados a partir de mdulos de classe so destrudos, os arquivos abertos utilizando-se a instruo Open so fechados e a memria utilizada pelo seu programa liberada. As referncias de objeto pertencentes a outros programas so invalidadas. A instruo End fornece uma maneira de fazer com que seu programa pare. Para a finalizao normal de um programa do Visual Basic, voc deve descarregar todos os formulrios. O seu programa finalizado logo que no haja outros programas mantendo referncia a objetos criados a partir de seus mdulos de classe pblicos e nenhum cdigo sendo executado.

Funes Internas

39

Instruo ExitSai de um bloco de cdigo DoLoop, For...Next, Function, Sub ou Property. Sintaxe Exit Do Exit For Exit Function Exit Property Exit Sub A sintaxe da instruo Exit possui as formas a seguir: Instruo Descrio Exit Do Prov um meio de sair de uma instruo Do...Loop. Pode ser utilizada somente dentro de uma instruo Do...Loop. Exit Do transfere o controle para a instruo seguinte instruo Loop. Quando utilizada com instrues Do...Loop embutidas, Exit Do transfere o controle para o loop que est embutido em um nvel acima do loop em que ocorre Exit Do. Exit For Prov um meio de sair de um loop For. Pode ser utilizado somente em um loop For...Next ou For Each...Next. Exit For transfere o controle para a instruo seguinte instruo Next. Quando utilizada com loops For embutidos, Exit For transfere o controle para o loop que est embutido em um nvel acima do loop em que ocorre Exit For. Exit Function Sai imediatamente do procedimento Function no qual aparece. A execuo continua com a instruo seguinte instruo que chamou o Function. Exit Property Sai imediatamente do procedimento Property no qual aparece. A execuo continua com a instruo seguinte instruo que chamou o procedimento Property. Exit Sub Sai imediatamente do procedimento Sub no qual aparece. A execuo continua com a instruo seguinte instruo que chamou o procedimento Sub. Comentrios No confunda instrues Exit com instrues End. Exit no define o final de uma estrutura.

Instruo For Each...NextRepete um grupo de instrues para cada elemento de uma matriz ou coleo. Sintaxe For Each elemento In [instrues] [Exit [instrues] Next [elemento] A sintaxe da instruo For...Each...Next possui as partes a seguir: Parte Descrio elemento Obrigatria. Varivel utilizada para iterar atravs dos elementos da coleo ou matriz. Para as colees, elemento pode ser somente uma varivel Variant, uma varivel de objeto genrica ou qualquer varivel de objeto especfica. Para as matrizes, elemento somente pode ser uma varivel Variant. grupo Obrigatria. Nome de uma coleo ou matriz de objetos(exceto matriz de tipos definidos pelo usurio). instrues Opcional. Uma ou mais instrues que so executadas em cada item de um grupo. grupo For]

Comentrios O bloco For...Each inserido se houver pelo menos um elemento em grupo. Uma vez que o loop tenha sido inserido, todas as instrues do loop so executadas para o primeiro elemento do grupo. Se houver mais elementos em grupo, as instrues do loop continuam a ser executadas para cada elemento. Quando no houver mais elementos em grupo, o loop sai e a execuo continua com a instruo seguinte instruo Next. Qualquer nmero de instrues Exit For pode ser colocado em qualquer lugar do loop como um meio alternativo para sair. Muitas vezes, Exit For utilizada depois de se avaliar alguma condio, por exemplo, If...Then, e transfere o controle para a instruo imediatamente seguinte a Next. Voc pode embutir loops For...Each...Next colocando um dentro de outro. Entretanto, cada elemento do loop deve ser exclusivo. Observao Se voc omitir elemento em uma instruo Next a execuo continua como se elemento estivesse includo. Se uma instruo Next for encontrada antes de sua instruo For correspondente, ocorrer um erro. Voc no pode utilizar a instruo For...Each...Next com uma matriz de tipos definidos pelo usurio porque um Variant no pode conter um tipo definido pelo usurio. Funes Internas

40

Instruo For...NextRepete um grupo de instrues um nmero especfico de vezes. Sint