Delphi - 7 - Curso - Completo - Blog - Conhecimentovaleouro - Blogspot.com by @viniciusf666

CURSO COMPLETO
DELPHI 7
BORLAND
Marcelo Leo
Para uso pessoal. Este material no pode ser utilizado em Salas de Aula e para ministrar treinamentos.
Pirataria crime contra os direitos autorais, com penas para os infratores de
acordo com a Lei 9.610 de 19 de fevereiro de 1998.
Este e-book no pode ser vendido e/ou distribudo em CD-ROM, DVD-ROM ou por programas de
compartilhamento P2P. A forma correta de obter este arquivo adquirindo-o atravs dos sites da Editora
Axcel (www.axcel.com.br) e de Jlio Battisti (www.juliobattisti.com.br).
Se voc adquiriu este documento atravs dos meios legais descritos acima, no distribua ou venda este
produto. Voc estar cometendo um crime contra o autor da obra.
Se voc adquiriu este e-book por intermdio de terceiros, regularize sua situao entrando em contato pelo e-mail
editora@axcel.com.br, para que no seja alvo das penalizaes previstas em Lei. Usar cpia ilegal tambm
crime de violao dos direitos autorais.
REPRODUO PROI BI DA PELA LEI DO DI REI TO AUTORAL.
SUMRIO
III CURSO COMPLETO00
DEDICATRIA
minha esposa Beatriz e aos meus filhos Thiago e Lucas, minhas constantes e principais fontes de
estmulo e carinho.
AGRADECIMENTOS
A todos que sempre me apoiaram ao longo desta dura jornada e a todos que me acompanham no dia-
a-dia e, ainda que de forma indireta, colaboraram para que este trabalho fosse concludo.
Aos meus pais Pery e May Leo, pelos exemplos de carinho e dedicao; aos meus irmos Pery Jr,
Ernesto e Andr pela eterna amizade; aos meus super tios Mara e Nestor Vieira e aos meus super sogros
Srgio e Marly, pelo incondicional apoio; Beth Ruth Castro da Silveira, pelo apoio e pacincia.
Ao competente pessoal da Axcel Books, pelo trabalho srio e competente.
Ao Jos Eugnio, Jos Rubens, Mariana Lima, Tertius e a todo pessoal da Borland Latin America, pelo
apoio e profissionalismo.
Ao pessoal do Clube Delphi: Gladstone, Luciano, Jlio, Rosngela, Vincius e demais integrantes, pelo
apoio, amizade e incentivo.
Ao meu amigo e conselheiro Professor Slvio Macieira, amigo de todas as horas, obrigado pela sua
amizade!
Aos amigos do CDEM 2002, pela pacincia e amizade.
A fim de evitar o risco de cometer injustias por algum esquecimento, no vou listar a enorme relao
de amigos e amigas que sempre me prestigiam com a sua valorosa amizade. Graas a deus, a lista
completa de Amigos do Marcelo Leo ocuparia um livro inteiro. Mas vale acrescentar alguns nomes
aos listados na edio anterior: Alexander Mazolii, ureo Pinheiro Ruffier, Edgar Gurgel, Edson Belm,
Emerson Moraes, rico Fagundes Lisboa, Guto Garcia, Luiz Felipe Estrella, Regina Clia, Renato Pitta.
SOBRE O AUTOR
Marcelo Leo engenheiro formado pelo Instituto Militar de Engenharia (IME) e Mestre em Cincias
pela mesma instituio. Atualmente professor e coordenador do Curso de Graduao em Engenharia
do Instituto Militar de Engenharia, professor do Curso de Graduao em Informtica da Universidade
Estcio de S, tendo coordenado o Campus Penha desta universidade, alm de ministrar cursos de
informtica em diversas empresas de treinamento.
BORLAND DELPHI 7 CURSO COMPLETO
IV 00CURSO COMPLETO
SUMRIO
PARTE I: FUNDAMENTOS ................................................................................................................................ 1
CAPTULO 1: INTRODUO.............................................................................................................................. 2
Fundamentos em: Ferramentas de Desenvolvimento ........................................................................ 4
As Origens das Ferramentas RAD........................................................................................................................ 4
CAPTULO 2: O AMBIENTE DE DESENVOLVIMENTO INTEGRADO DO DELPHI 7 ........................................................... 9
Fundamentos em: Composio do Ambiente de Desenvolvimento ................................................ 10
Apresentao do Ambiente de Desenvolvimento Integrado do Delphi 7 ....................................................... 10
Formulrios Os Elementos de Criao da Interface com o Usurio .............................................................. 14
Controles e Componentes ................................................................................................................................ 15
Propriedades ................................................................................................................................................. 16
Mtodos ........................................................................................................................................................ 17
Eventos ......................................................................................................................................................... 18
O Object Inspector ............................................................................................................................................ 18
Alterando o Valor de uma Propriedade no Object Inspector....................................................................... 19
Definindo Procedimentos Associados a Eventos ......................................................................................... 20
O Conceito de Projeto de uma Aplicao......................................................................................................... 22
Iniciando um Novo Projeto .............................................................................................................................. 28
Salvando o Projeto Recm-criado ..................................................................................................................... 29
Fechando um Projeto........................................................................................................................................ 31
Manipulando Grupos de Projetos ..................................................................................................................... 32
O Code Explorer ............................................................................................................................................... 35
Desabilitando o Recurso de Ancoragem de Janelas .......................................................................................... 36
Garantindo a Visibilidade de uma Janela ......................................................................................................... 37
CAPTULO 3: FUNDAMENTOS DA LINGUAGEM OBJECT PASCAL .............................................................................. 39
Fundamentos em: Estrutura de uma Unidade de Cdigo (Unit) ..................................................... 40
Examinando o Cdigo de uma Unidade de Cdigo (Unit) Gerado Pelo Delphi 7 .......................................... 40
Examinando as Sees de uma Unit ................................................................................................................. 41
Acessando Tipos e Variveis Definidos em Outras Units ................................................................................. 42
Fundamentos em: Declarao de Variveis ....................................................................................... 42
O Conceito de Variveis .................................................................................................................................... 42
Atribuindo um Valor a uma Varivel ................................................................................................................ 43
Tipos de Dados Predefinidos na Linguagem Object Pascal .............................................................................. 43
Tipos de Variveis Inteiras ............................................................................................................................ 43
Tipos de Variveis Reais ................................................................................................................................ 44
Tipos de Variveis Booleanas ....................................................................................................................... 44
Tipos de Variveis Para Manipulao de Caracteres .................................................................................... 44
Tipos de Variveis Para Manipulao de Arquivos ...................................................................................... 45
Tipo Genrico de Variveis ............................................................................................................................... 46
Comentrios...................................................................................................................................................... 46
Comentrios de uma nica linha ................................................................................................................ 46
Comentrios de mltiplas linhas ................................................................................................................. 46
Definindo Novos Tipos de Dados ..................................................................................................................... 46
Tipos de Dados Enumerados ........................................................................................................................ 47
Conjuntos ..................................................................................................................................................... 47
Variveis Compostas .................................................................................................................................... 49
Vetores (Arrays) ............................................................................................................................................ 49
Operadores Aritmticos .................................................................................................................................... 51
Tipos Ordinais ................................................................................................................................................... 52
Escopo e Tempo de Vida das Variveis ......................................................................................................... 52
Variveis Locais ................................................................................................................................................. 52
Variveis Globais a uma Unidade de Cdigo ................................................................................................... 53
Criao de Variveis Globais a uma Aplicao ............................................................................................ 53
Adicionando uma Nova Unit ao Projeto Para Armazenamento de Variveis Globais ................................ 53
Fundamentos em: Blocos de Comandos, Estruturas Condicionais e de Repetio........................ 54
SUMRIO
V CURSO COMPLETO00
Alterando o Fluxo de Execuo do Programa ................................................................................................... 54
Blocos de Comandos ......................................................................................................................................... 55
Estruturas Condicionais .................................................................................................................................... 55
Estrutura Condicional if-then-else ............................................................................................................... 55
Estrutura Condicional Case Of .................................................................................................................... 56
Testes Condicionais .......................................................................................................................................... 56
Os Operadores Relacionais ........................................................................................................................... 56
Estruturas de Repetio ..................................................................................................................................... 57
Laos For ....................................................................................................................................................... 57
Laos While .................................................................................................................................................. 58
Laos Repeat ................................................................................................................................................. 58
Condies Compostas ...................................................................................................................................... 59
Operadores Lgicos da Linguagem Object Pascal ........................................................................................ 59
Fundamentos em: Funes e Procedimentos ..................................................................................... 59
A Estratgia de Dividir Para Conquistar ........................................................................................................... 60
Procedimentos (Procedures) ............................................................................................................................. 60
Funes ............................................................................................................................................................. 61
Funes e Procedimentos Para Manipulao de Arquivos Representados por Variveis ................................. 62
Funes e Procedimentos Para Manipulao Direta de Arquivos .................................................................... 63
Fundamentos em: Classes e Objetos ................................................................................................... 63
Uma Nova (Mas J No To Nova) Abordagem ............................................................................................... 64
As Classes e os Objetos...................................................................................................................................... 64
O Conceito de Classes ....................................................................................................................................... 64
Mtodos de uma Classe ................................................................................................................................ 65
Mtodos sem Parmetros ............................................................................................................................. 67
O Objeto Formulrio e a Classe TForm........................................................................................................ 68
O Conceito de Herana de Classes ............................................................................................................... 69
Tipos de Mtodos e Campos ........................................................................................................................ 70
Procedimentos Associados a Eventos ............................................................................................................... 71
Pare e Reflita Antes de Prosseguir ..................................................................................................................... 72
CAPTULO 4: PLANEJANDO A SUA APLICAO ................................................................................................... 73
Fundamentos em: Planejamento de Aplicaes ................................................................................ 74
Planejando o seu Trabalho................................................................................................................................ 74
A Importncia de um Bom Planejamento ........................................................................................................ 74
Planejando o Nosso Aplicativo-exemplo .......................................................................................................... 75
Padronizando a Nomenclatura dos Componentes .......................................................................................... 76
Adicionando um Item a uma To-Do Lists......................................................................................................... 77
Fundamentos em: To-Do Lists ............................................................................................................. 77
Organizando o seu Trabalho com as Ferramentas To-Do List .......................................................................... 77
Editando um Item de uma To-Do Lists ............................................................................................................. 78
Excluindo um Item de uma To-Do Lists ........................................................................................................... 79
Configurando as Informaes Exibidas em uma To-Do Lists........................................................................... 79
Configurando Como as Informaes Devem
Ser Ordenadas em uma To-Do Lists .................................................................................................................. 80
Adicionando um Item a uma To-Do Lists Diretamente no Cdigo-fonte ....................................................... 80
Copiando a Relao de Itens de uma To-Do List .............................................................................................. 81
Filtrando a Relao de Itens de uma To-Do List .............................................................................................. 82
CAPTULO 5: CRIANDO O FORMULRIO PRINCIPAL DA APLICAO ....................................................................... 83
Fundamentos em: Manipulao de Formulrios .............................................................................. 84
Os Formulrios Elementos Para a Construo da
Interface em Aplicaes Desenvolvidas em Delphi 7 ....................................................................................... 84
O Objeto Formulrio .................................................................................................................................... 84
Propriedades com um Conjunto de Valores Predefinidos ........................................................................... 85
Alterando as Propriedades do Objeto Formulrio........................................................................................ 88
Definindo um cone Para o Formulrio Principal da Aplicao .................................................................. 89
Inserindo Componentes em um Formulrio ............................................................................................... 90
Inserindo um Componente Para Exibio de Imagens no Formulrio Principal ........................................ 90
Renomeando um Componente ................................................................................................................... 92
Reposicionando um Componente ............................................................................................................... 92
Redimensionando um Componente ........................................................................................................... 93
Alterando a Fonte do Texto Exibido em um Componente ......................................................................... 96
VI 00CURSO COMPLETO
Selecionando Vrios Componentes Simultaneamente................................................................................ 96
Alinhando Componentes ............................................................................................................................. 97
Analisando o Cdigo Gerado Pelo Delphi ................................................................................................... 99
Testando a sua Aplicao .................................................................................................................................. 99
Finalizando a Execuo do Aplicativo ............................................................................................................ 100
CAPTULO 6: PROJETANDO UM MENU PARA A SUA APLICAO .......................................................................... 101
Fundamentos em: Criao de Menus................................................................................................ 102
Menus Elementos Indispensveis ao Formulrio Principal de uma Aplicao ........................................... 102
Incluindo um Menu na sua Aplicao............................................................................................................ 102
Acessando o Editor de Menus .................................................................................................................... 103
Criando Itens de Menu .............................................................................................................................. 105
Criando um Separador de Itens em um Menu ............................................................................................... 107
Criando Teclas Aceleradoras Para Itens de Menu ........................................................................................... 108
Criando Outros Itens de Menu ....................................................................................................................... 108
Incluindo um Menu Pop-up na sua Aplicao ............................................................................................... 109
Criando Itens de Menu em um Menu Pop-up........................................................................................... 110
Criando Submenus no Menu Pop-up ........................................................................................................ 112
Associando Eventos a Itens de Menu......................................................................................................... 114
Definindo Procedimentos Associando Eventos Para Itens de Menu Pop-up ............................................ 115
CAPTULO 7: MANIPULANDO FORMULRIOS E CAIXAS DE DILOGO .................................................................... 117
Fundamentos em: Criao de Caixas de Dilogo ............................................................................ 118
Caixas de Dilogo Elementos de Interface
Que Do Vida ao seu Aplicativo ..................................................................................................................... 118
Criando uma Caixa de Dilogo de Direitos Autorais ..................................................................................... 118
Personalizando a Caixa de Dilogo de Direitos Autorais ............................................................................... 119
Exibindo uma Caixa de Dilogo ..................................................................................................................... 120
O Componente Boto de Comando ............................................................................................................... 122
Principais Propriedades do Componente Boto de Comando .................................................................. 123
CAPTULO 8: FUNDAMENTOS DO PROJETO DE APLICATIVOS DE BANCO DE DADOS ................................................. 125
Fundamentos em: Mecanismos de Acesso a Bancos de Dados ....................................................... 126
Mecanismos de Acesso a Bancos de Dados ..................................................................................................... 126
Fundamentos em: Conceitos Fundamentais Sobre Bancos de Dados............................................ 127
Conceitos Fundamentais ................................................................................................................................ 127
Custos .............................................................................................................................................................. 128
Planejando seu Banco de Dados ..................................................................................................................... 128
CAPTULO 9: FUNDAMENTOS DE BANCOS DE DADOS ........................................................................................ 129
Fundamentos em: Criao de Tabelas do Interbase ....................................................................... 130
Criando um Banco de Dados no Interbase ..................................................................................................... 130
Criando Tabelas com o Database Desktop...................................................................................................... 133
Definindo Nomes Para os Campos dos Registros de uma Tabela .............................................................. 136
Definindo Tipos Para os Campos dos Registros de uma Tabela................................................................. 138
Definindo os Tamanhos Para os Campos dos Registros de uma Tabela .................................................... 139
Definindo Campos de Preenchimento Obrigatrio................................................................................... 141
Criando ndices .......................................................................................................................................... 141
Salvando uma Tabela.................................................................................................................................. 144
Inserindo Dados em uma Tabela Atravs do Database Desktop ................................................................ 144
Construindo as Demais Tabelas do Aplicativo ............................................................................................... 148
Criando a Tabela Atividades ....................................................................................................................... 148
Criando ndices Para a Tabela de Atividades ............................................................................................. 149
Salvando a Tabela Atividades ..................................................................................................................... 149
Incluindo Registros na Tabela de Atividades ............................................................................................. 149
Criando a Tabela de Matrculas ...................................................................................................................... 150
Criando ndices Para a Tabela de Matrculas ............................................................................................. 150
CAPTULO10: CRIAO DE UM FORMULRIO PARA MANIPULAO
DE TABELAS DE BANCOS DE DADOS COM O DBEXPRESS ................................................................................... 151
Criao de Formulrios Para Acesso a Dados.................................................................................. 152
Utilizando os Componentes DatasetProvider e ClientDataset ....................................................................... 159
O Componente DBEdit ................................................................................................................................... 164
SUMRIO
VII CURSO COMPLETO00
Definindo Mscaras Para os Campos .............................................................................................................. 164
Significado dos Caracteres Usados na Propriedade EditMask.................................................................... 165
O Componente MaskEdit ............................................................................................................................... 167
Fazendo a Tecla Enter Funcionar Como Tab .................................................................................................. 167
O Componente DBCombobox ....................................................................................................................... 168
Propriedades do Controle DBComboBox .................................................................................................. 168
Propriedades do Objeto Items (da Classe TStrings) ................................................................................... 169
Mtodos do Objeto Items (da classe TStrings) ........................................................................................... 169
Destacando o Componente Que Recebe o Foco............................................................................................. 171
CAPTULO 11: CRIAO DE UM REPOSITRIO PARA COMPONENTES DE ACESSO A DADOS ....................................... 173
Criao de Data Modules ................................................................................................................... 174
Os Objetos do Tipo DataModule .................................................................................................................... 174
Os Objetos de Acesso ao Banco de Dados ...................................................................................................... 178
O Componente ClientDataset ................................................................................................................... 178
O Componente DataSource ....................................................................................................................... 180
O Componente SimpleDataset .................................................................................................................. 180
Inserindo os Demais Componentes de Acesso ............................................................................................... 181
Para a tabela de Atividades: ........................................................................................................................ 182
Para a tabela de Matrculas: ........................................................................................................................ 182
Definindo ndices nos Componentes de Acesso ............................................................................................ 183
Criando um ndice Simples ........................................................................................................................ 183
Criando um ndice Composto ................................................................................................................... 184
Criando Chaves Primrias .......................................................................................................................... 184
CAPTULO 12: CRIAO DE FORMULRIOS PARA CADASTRO DE FORNECEDORES, PRODUTOS E PEDIDOS .................... 187
Criao de Formulrios de Cadastro ................................................................................................ 188
Criando o Formulrio de Cadastro de Atividades .......................................................................................... 188
Criando um Formulrio Para Cadastrar Novas Matrculas ............................................................................. 192
Definindo o Formulrio ............................................................................................................................. 192
Criando o Formulrio................................................................................................................................. 193
Inserindo os Componentes no Formulrio................................................................................................ 193
Trabalhando com Campos Calculados ...................................................................................................... 196
CAPTULO 13: CRIANDO FORMULRIOS PARA ALTERAO DE SCIOS E ATIVIDADES ............................................. 199
Criao de Formulrios Para Alterao de Dados .......................................................................... 200
O Conceito de Templates de Componentes ................................................................................................... 200
Criando os Templates de Componentes ......................................................................................................... 201
Criando o Formulrio de Alterao de Scios ................................................................................................ 202
Criando o Formulrio de Alterao de Atividades.......................................................................................... 204
O Componente DBNavigator ......................................................................................................................... 205
CAPTULO 14: CRIANDO FORMULRIOS PARA EXCLUSO DE SCIOS, ATIVIDADES E MATRCULAS ............................ 209
Criao de Formulrios Para Excluso de Dados ........................................................................... 210
Criando um Template de Formulrio ............................................................................................................. 210
Criando Formulrios a Partir de um Template ............................................................................................... 213
Criando o Formulrio de Excluso de Scios ................................................................................................. 213
Criando o Formulrio de Excluso de Atividades ...................................................................................... 215
A Linguagem SQL ........................................................................................................................................... 216
Criando o Formulrio de Excluso de Matrculas .......................................................................................... 217
CAPTULO 15: CRIANDO FORMULRIOS PARA CONSULTA DE SCIOS, ATIVIDADES E MATRCULAS ............................ 223
Criao de Formulrios Para Consulta de Dados ........................................................................... 224
Criando um Formulrio Para a Consulta de Dados dos Scios ...................................................................... 224
Criando um formulrio Para a Consulta de Dados das Atividades ................................................................ 225
Criando um Formulrio Para a Consulta de Dados das Matrculas ............................................................... 226
CAPTULO 16: CRIANDO ROTINAS DE BACKUP E RESTAURAO ......................................................................... 227
Cpia de Arquivos .............................................................................................................................. 228
Criando um Formulrio de Backup ................................................................................................................ 228
PARTE II: KNOW-HOW ............................................................................................................................. 233
CAPTULO 17: CRIAO DE RELATRIOS COM O RAVE REPORTS ........................................................................ 235
Know-How em: Criao de Relatrios com o Rave Reports .......................................................... 236
VIII 00CURSO COMPLETO
Introduo ...................................................................................................................................................... 236
O Componente RvProject .......................................................................................................................... 236
Criando um Relatrio de Scios ................................................................................................................. 236
Criando um Relatrio de Atividades .......................................................................................................... 242
Criando um Relatrio de Matrculas .......................................................................................................... 244
CAPTULO 18: INCORPORANDO O RECURSO DE HELP ON-LINE NOSSA APLICAO.............................................. 247
Know-How em: Criao de Arquivos de Help ................................................................................. 248
Criando um Arquivo de Help ......................................................................................................................... 248
Definindo uma Pgina de ndice .................................................................................................................... 248
Criando um Arquivo RTF ........................................................................................................................... 249
Criando uma Pgina Para Cada Tpico ..................................................................................................... 250
Criando Strings de Contexto ..................................................................................................................... 250
Criando uma Palavra-chave Para um Tpico............................................................................................. 252
Criando um Ttulo Para um Tpico ........................................................................................................... 252
Associando um Nmero de Pgina a um Tpico ....................................................................................... 253
Estabelecendo a Conexo Entre Tpicos ................................................................................................... 254
Criando um Arquivo de Projeto de Help ................................................................................................... 256
Criando e Compilando o Arquivo de Projeto de Help com o Microsoft Help Workshop ........................ 257
Associando o Arquivo de Help sua Aplicao ......................................................................................... 260
Associando um Componente a um Tpico do Arquivo de Help............................................................... 261
Exibindo o Arquivo de Help em Resposta a um Item de Menu ................................................................ 262
CAPTULO 19: PROGRAMAO ORIENTADA A OBJETOS EM DELPHI 7 ................................................................. 263
KNOW-HOW em: Programao Procedural em Linguagem Object Pascal .................................. 264
Apresentao do Problema ............................................................................................................................. 265
Utilizando o Ambiente do Delphi 7 Para o Pascal Procedural ....................................................................... 266
KNOW-HOW em: Fundamentos da Programao Orientada a Objetos ........................................ 269
A Filosofia da Programao Orientada a Objetos ........................................................................................... 269
Anlise do Cdigo-fonte ................................................................................................................................. 271
A Implementao de uma Classe .................................................................................................................... 272
Anlise do Cdigo-fonte ................................................................................................................................. 274
KNOW-HOW em: Herana de Classes ............................................................................................... 274
O Conceito de Herana de Classes ................................................................................................................. 275
Mtodos Construtores .................................................................................................................................... 277
Mtodos Destrutores ....................................................................................................................................... 278
Visibilidade dos Campos e Mtodos de uma Classe ....................................................................................... 279
Campos e Mtodos Pblicos (public) ......................................................................................................... 279
Campos e Mtodos Privados (private) ....................................................................................................... 280
Campos e Mtodos Protegidos (protected) ................................................................................................ 280
Sobreposio de Mtodos ............................................................................................................................... 281
Mtodos Estticos, Virtuais e Dinmicos ........................................................................................................ 282
Mas e os Mtodos Dinmicos? O Que Significam? ........................................................................................ 284
Mtodos Abstratos .......................................................................................................................................... 284
Mtodos de Classe........................................................................................................................................... 285
Propriedades .................................................................................................................................................... 285
Referncia: a Classe TObject ........................................................................................................................... 287
Principais Mtodos da Classe TObject ....................................................................................................... 288
KNOW-HOW em: Converso de Tipos ............................................................................................... 294
O Conceito de Converso de Tipos ................................................................................................................ 294
O Operador Is .................................................................................................................................................. 294
O Operador As................................................................................................................................................. 295
Converso Explcita Entre Tipos ..................................................................................................................... 295
O Identificador Self ......................................................................................................................................... 296
KNOW-HOW em: Tratamento de Excees ...................................................................................... 296
Tcnica ............................................................................................................................................................ 296
O Conceito de Excees .................................................................................................................................. 296
Referncia: a Classe Exception........................................................................................................................ 298
Definio da Classe Exception ................................................................................................................... 298
Campos Internos da Classe Exception....................................................................................................... 298
Mtodos Pblicos da Classe Exception ...................................................................................................... 299
Propriedades da Classe Exception .............................................................................................................. 302
Classes Derivadas por Herana da Classe Exception ................................................................................. 302
SUMRIO
IX CURSO COMPLETO00
O Mecanismo Utilizado na Gerao de Excees ...................................................................................... 302
KNOW-HOW em: Manipulao de Listas de Objetos ....................................................................... 304
Referncia: a Classe TList ................................................................................................................................ 305
Definio da Classe TList ........................................................................................................................... 305
Propriedades da Classe TList ...................................................................................................................... 305
Principais Mtodos da Classe TList ............................................................................................................ 306
Exemplo de Utilizao................................................................................................................................ 309
Definio da Interface ................................................................................................................................ 309
Codificao do Exemplo ............................................................................................................................ 311
KNOW-HOW em: Sobrecarga de Mtodos ........................................................................................ 322
O Conceito de Sobrecarga de Mtodos ........................................................................................................... 323
KNOW-HOW em: Definio de Parmetros Default Para uma Funo ou Procedimento ......... 324
O Conceito de Parmetro Default Para uma Funo ou Procedimento......................................................... 324
CAPTULO 20: O CONCEITO DE COMPONENTES ............................................................................................... 327
KNOW-HOW em: Definio de Componentes .................................................................................. 328
O Conceito de Componentes ......................................................................................................................... 329
Exibindo uma Propriedade no Object Inspector ............................................................................................ 331
O Sistema de Mensagens do Windows ........................................................................................................... 331
A Classe TCanvas ............................................................................................................................................ 335
Principais Propriedades da Classe TCanvas ............................................................................................... 336
Principais Mtodos da Classe TCanvas ...................................................................................................... 337
Principais Propriedades da Classe TPen ..................................................................................................... 341
Principais Propriedades da Classe TBrush.................................................................................................. 343
O Componente Shape..................................................................................................................................... 343
CAPTULO 21: CRIAO DE COMPONENTES .................................................................................................... 347
KNOW-HOW em: Criao de Componentes ..................................................................................... 348
Criando o Esqueleto do Novo Componente .................................................................................................. 350
Definio de Novas Propriedades ................................................................................................................... 352
Criando uma Nova Propriedade ..................................................................................................................... 353
Instalando o Novo Componente .................................................................................................................... 354
Sobrecarregando o Mtodo Construtor da Classe Ancestral do Componente............................................... 356
Redefinindo Mtodos da Classe-base.............................................................................................................. 358
Definindo um Novo Evento Para o Componente .......................................................................................... 360
O Tipo TNotifyEvent ....................................................................................................................................... 361
Definindo um Mtodo de Leitura Para uma Propriedade .............................................................................. 362
KNOW-HOW em: Criao de Componentes Associados a Bancos de Dados.................................. 364
Criando o Esqueleto do Novo Componente .................................................................................................. 365
Definindo as Novas Propriedades Para o Componente.................................................................................. 366
Refletindo Alteraes Feitas no Campo .......................................................................................................... 369
Refletindo Alteraes Feitas no Componente ................................................................................................ 371
Notificando o Componente da Remoo de um DataSource ........................................................................ 374
Criando uma Propriedade que Permita Tratar a Tecla Enter Como Tab ........................................................ 376
KNOW-HOW em: Criao de Controles ActiveX.............................................................................. 379
Convertendo o Componente NumEdit em um Controle ActiveX ................................................................ 379
CAPTULO 22: MECANISMOS DE ACESSO A BANCO DE DADOS ............................................................................ 393
KNOW-HOW em: Fundamentos dos Mecanismos de Acesso a Bancos de Dados .......................... 394
Os Mecanismos de Acesso a Bancos de Dados ............................................................................................... 394
KNOW-HOW em: Classes Fundamentais de Acesso a Bancos de Dados A Classe TDataset ....... 395
A Classe TDataSet ............................................................................................................................................ 395
Principais Propriedades da Classe TDataSet ............................................................................................... 397
Principais Mtodos da Classe TDataSet ...................................................................................................... 401
Principais Eventos da Classe TDataSet ....................................................................................................... 406
A Classe TCustomConnection........................................................................................................................ 411
Principais Propriedades da Classe TCustomConnection ........................................................................... 411
Principais Mtodos da Classe TCustomConnection.................................................................................. 411
Principais Eventos da Classe TCustomConnection ................................................................................... 413
X 00CURSO COMPLETO
CAPTULO 23: BANCO DE DADOS COMPONENTES DE ACESSO VIA BDE ............................................................ 415
KNOW-HOW em: CLasses Fundamentais de Acesso a Bancos
de Dados via BDE As Classes TBDEDataset e TDBDataset ........................................................... 416
A Classe TBDEDataSet ..................................................................................................................................... 416
Principais Propriedades da Classe TBDEDataSet ........................................................................................ 417
Principais Mtodos da Classe TBDEDataSet ............................................................................................... 417
A Classe TDBDataSet ....................................................................................................................................... 418
Principais Propriedades da Classe TDBDataSet .......................................................................................... 418
A Classe TDatabase ......................................................................................................................................... 419
Principais Propriedades da Classe TDatabase ................................................................................................. 419
Principais Mtodos do Componente Database .......................................................................................... 421
A Classe TSession ............................................................................................................................................ 422
Principais Propriedades da Classe TSession ............................................................................................... 422
Principais Mtodos da Classe TSession ...................................................................................................... 424
Eventos do Componente Session............................................................................................................... 427
KNOW-HOW em: CLasses de Acesso Direto a Bancos de Dados via BDE
As Classes TTable e TQuery ............................................................................................................... 427
A Classe TTable ............................................................................................................................................... 428
Principais Propriedades da Classe TTable ................................................................................................... 428
Principais Mtodos da Classe TTable ......................................................................................................... 430
A Classe TQuery .............................................................................................................................................. 434
Principais Propriedades da Classe TQuery ................................................................................................. 435
Principais Mtodos da Classe TQuery ........................................................................................................ 436
A Classe TUpdateSQL...................................................................................................................................... 437
Principais Propriedades da Classe TUpdateSQL ......................................................................................... 437
Principais Mtodos da Classe TUpdateSQL................................................................................................ 438
Exemplos de Aplicao ................................................................................................................................... 438
Indexao de Tabelas Acessadas Pelo Componente Table ......................................................................... 438
Exemplo de Aplicao..................................................................................................................................... 439
Filtrando os Registros de uma Tabela Acessada Pelo Componente Table .................................................. 442
Estabelecendo um Relacionamento Entre Tabelas Representadas Pelo Componente Table ..................... 454
Pesquisando Registros em Tabelas Representadas Pelo Componente Table .............................................. 458
Criao de Tabelas em Run-time ................................................................................................................ 463
Componentes e Mtodos de Navegao .................................................................................................... 473
Traduo da Mensagem Delete Record do Componente Table ................................................................. 480
Exemplo de Utilizao do Componente TSession ..................................................................................... 481
Consulta a Bancos de Dados via Declaraes SQL Definidas em Run-Time ............................................. 487
Utilizao de Parmetros em Declaraes SQL .......................................................................................... 491
Utilizao do Recurso de Cached Updates ................................................................................................. 495
Exemplo de Utilizao do Componente TUpdateSQL .............................................................................. 500
KNOW-HOW em: Aplicao de Senhas a Tabelas do Tipo Paradox............................................... 506
Definindo Senhas Para uma Tabela do Tipo Paradox..................................................................................... 507
Definindo Senhas Auxiliares Para uma Tabela do Tipo Paradox.................................................................... 508
Inibindo a Exibio da Caixa de Dilogo Enter
Password Durante a Execuo do seu Aplicativo............................................................................................ 509
Protegendo Sua Aplicao Mediante Definio de uma Senha ...................................................................... 509
CAPTULO 24: BANCO DE DADOS COMPONENTES DE ACESSO VIA ADO............................................................ 511
KNOW-HOW em: CLasses Fundamentais de Acesso a Bancos de Dados
via ADO A Classe TCustomADODataset e os Componentes TADOConnection,
TRDSConnection e TADODataset e TADOCommand ...................................................................... 512
O Componente TADOConnection ................................................................................................................. 512
Principais Propriedades da Classe TADOConnection ................................................................................ 512
Principais Mtodos da Classe TADOConnection....................................................................................... 514
Principais Eventos da Classe TADOConnection ........................................................................................ 516
O Componente TRDSConnection .................................................................................................................. 517
Principais Propriedades da Classe TRDSConnection ................................................................................. 517
Principais Mtodos da Classe TRDSConnection ........................................................................................ 517
Principais Eventos da Classe TRDSConnection ......................................................................................... 517
A Classe TCustomADODataset ....................................................................................................................... 518
Principais Propriedades da Classe TCustomADODataSet .......................................................................... 518
Principais Mtodos da Classe TCustomADODataset ................................................................................. 521
SUMRIO
XI CURSO COMPLETO00
Principais Eventos da Classe TCustomADODataset .................................................................................. 524
A Classe TADOCommand ............................................................................................................................... 525
Principais Propriedades da Classe TADOCommand .................................................................................. 525
Principais Mtodos da Classe TADOCommand......................................................................................... 526
Principais Eventos da Classe TADOCommand .......................................................................................... 527
A Classe TADODataset .................................................................................................................................... 527
Principais Propriedades da Classe TADODataSet ....................................................................................... 527
Principais Mtodos da Classe TADODataset .............................................................................................. 528
Principais Eventos da Classe TADODataset ............................................................................................... 528
KNOW-HOW em: Classes de Acesso Direto a Bancos de dados via BDE
As Classes TADOTable e TADOQuery ................................................................................................ 528
A Classe TADOTable ........................................................................................................................................ 529
Principais Propriedades da Classe TADOTable ........................................................................................... 529
Principais Mtodos da Classe TADOTable .................................................................................................. 530
Principais Eventos da Classe TADOTable ................................................................................................... 530
A Classe TADOQuery ...................................................................................................................................... 530
Principais Propriedades da Classe TADOQuery ......................................................................................... 530
Principais Mtodos da Classe TADOQuery ................................................................................................ 530
Principais Eventos da Classe TADOQuery ................................................................................................. 531
Exemplos de Aplicao ................................................................................................................................... 531
Estabelecendo uma Conexo a Bancos de Dados do MS Acess com o Componente ADOConnection ... 531
Acessando tabelas do Access com o Componente ADOComando............................................................ 534
Acessando Tabelas do Access com o Componente ADODataset ............................................................... 534
Acessando tabelas do Access com o Componente ADOTable ................................................................... 535
Acessando tabelas do Access com o Componente ADOQuery .................................................................. 536
Diferenas na Utilizao dos Componentes
Table x ADOTable, e Query x ADOQuery ....................................................................................................... 536
Definio do ndice Corrente..................................................................................................................... 536
Pesquisando Registros em Tabelas
Representadas Pelo Componente ADOTable ............................................................................................. 537
Criao de Tabelas em Run-time ................................................................................................................ 537
Componentes e Mtodos de Navegao .................................................................................................... 537
Utilizao de Parmetros em Declaraes SQL .......................................................................................... 537
CAPTULO 25: BANCO DE DADOS COMPONENTES DE ACESSO VIA DBEXPRESS ................................................... 539
KNOW-HOW em: Componentes de Acesso a Bancos de Dados via DBExpress.............................. 540
O Componente TSQLConnection .................................................................................................................. 540
Principais Propriedades da Classe TSQLConnection ................................................................................. 540
Principais Mtodos da Classe TSQLConnection ........................................................................................ 542
Principais Eventos da Classe TSQLConnection ......................................................................................... 543
A Classe TCustomSQLDataset ......................................................................................................................... 543
Principais Propriedades da Classe TCustomSQLDataSet ........................................................................... 544
Principais Eventos da Classe TCustomSQLDataset .................................................................................... 544
A Classe TSQLDataSet ..................................................................................................................................... 544
Principais Propriedades da Classe TSQLDataSet ........................................................................................ 545
KNOW-HOW em: Classes de Acesso Direto a Bancos de
Dados via DBExpress As Classes TSQLTable,
TSQLQuery e TSQLStoredProc .......................................................................................................... 545
A Classe TSQLTable ......................................................................................................................................... 546
Principais Propriedades da Classe TSQLTable ............................................................................................ 546
Principais Mtodos da Classe TSQLTable ................................................................................................... 547
Principais Eventos da Classe TSQLTable .................................................................................................... 547
A Classe TSQLQuery ....................................................................................................................................... 547
Principais Propriedades da Classe TSQLQuery........................................................................................... 547
Principais Mtodos da Classe TSQLQuery ................................................................................................. 547
Principais Eventos da Classe TSQLQuery................................................................................................... 548
A Classe TSimpleDataset ................................................................................................................................. 548
Principais Propriedades da Classe TSimpleDataset .................................................................................... 548
Principais Mtodos da Classe TSimpleDataset ........................................................................................... 549
Principais Eventos da Classe TSimpleDataset ............................................................................................ 549
CAPTULO 26: BANCO DE DADOS COMPONENTES DE ACESSO VIA INTERBASE EXPRESS ......................................... 551
KNOW-HOW em: Componentes de Acesso a Bancos de Dados via Interbase Express ................. 552
XII 00CURSO COMPLETO
O Componente TIBDatabase .......................................................................................................................... 552
Principais Propriedades da Classe TIBDatabase ......................................................................................... 552
Principais Mtodos da Classe TIBDatabase ................................................................................................ 554
Principais Eventos da Classe TIBDatabase ................................................................................................. 555
O Componente TIBTransaction...................................................................................................................... 555
Principais Propriedades da Classe TIBTransaction ..................................................................................... 555
Principais Mtodos da Classe TIBTransaction............................................................................................ 556
Principais Eventos da Classe TIBTransaction ............................................................................................. 558
A Classe TIBCustomDataset ............................................................................................................................ 558
Principais Propriedades da Classe TIBCustomDataset ............................................................................... 559
Principais Mtodos da Classe TIBCustomDataset ...................................................................................... 560
Principais Eventos da Classe TIBCustomDataset ....................................................................................... 561
A Classe TIBDataSet ........................................................................................................................................ 561
Principais Propriedades da Classe TIBDataSet ........................................................................................... 561
Principais Mtodos da Classe TIBDataset ................................................................................................... 562
Principais Eventos da Classe TIBDataset .................................................................................................... 562
KNOW-HOW em: Classes de Acesso Direto a
Bancos de dados via Interbase Express As
Classes TIBTable, TIBQuery e TIBUpdateSQL ................................................................................ 563
A Classe TIBTable ............................................................................................................................................ 563
Principais Propriedades da Classe TIBTable ............................................................................................... 563
Principais Mtodos da Classe TIBTable ...................................................................................................... 565
Principais Eventos da Classe TIBTable ....................................................................................................... 567
A Classe TIBQuery........................................................................................................................................... 567
Principais Propriedades da Classe TIBQuery .............................................................................................. 567
Principais Mtodos da Classe TIBQuery..................................................................................................... 568
Principais Eventos da Classe TIBQuery ...................................................................................................... 568
A Classe TIBUpdateSQL .................................................................................................................................. 568
Principais Propriedades da Classe TIBUpdateSQL ..................................................................................... 569
Principais Mtodos da Classe TIBUpdateSQL ............................................................................................ 569
CAPTULO 27: BANCOS DE DADOS CLIENTE/SERVIDOR .................................................................................... 571
KNOW-HOW em: Fundamentos dos Bancos de Dados Cliente/Servidor ...................................... 572
O Administrador do Servidor de Banco de Dados .......................................................................................... 572
Cadastrando um Novo Usurio ...................................................................................................................... 574
Alterando os Dados de um Usurio J Cadastrado ......................................................................................... 575
Removendo um Usurio Cadastrado .............................................................................................................. 575
O Utilitrio Interactive SQL ............................................................................................................................ 576
Criando um Banco de Dados no Interbase a Partir do Utilitrio Interactive SQL ......................................... 576
Conectando-se a um Banco de Dados do Interbase................................................................................... 578
Tipos de Dados Definidos Pelo Interbase ....................................................................................................... 578
Criando uma Tabela no Interbase................................................................................................................... 579
Aplicando Restries aos Campos de uma Tabela .......................................................................................... 580
Removendo uma Tabela do Banco de Dados.................................................................................................. 580
Criando ndices em uma Tabela ..................................................................................................................... 580
Concedendo Privilgios a um Outro Usurio ou Banco de Dados ................................................................. 581
Removendo Privilgios ................................................................................................................................... 582
Vises (Views) ................................................................................................................................................. 582
O Conceito de Transaes ............................................................................................................................... 583
Incluindo Registros com o Comando INSERT................................................................................................ 583
Atualizando Registros em uma Tabela ............................................................................................................ 584
Removendo Registros de uma Tabela ............................................................................................................. 584
Ordenando os Registros de uma Tabela .......................................................................................................... 585
TRIGGERS ....................................................................................................................................................... 585
STORED PROCEDURES (Procedimentos Armazenados) ................................................................................ 586
Linguagem de Codificao do Interbase ........................................................................................................ 587
Declarao de Variveis no Interbase ......................................................................................................... 587
Atribuio de Valores a Variveis no Interbase .......................................................................................... 588
Definio de Comentrios no Interbase .................................................................................................... 588
Estruturas Condicionais do Interbase ........................................................................................................ 588
Estruturas de Repetio do Interbase ......................................................................................................... 588
SUMRIO
XIII CURSO COMPLETO00
Criao de Novos Tipos no Interbase ........................................................................................................ 589
Metadados de um Banco de Dados ................................................................................................................. 589
Concatenando Dados Provenientes de Vrias Tabelas ................................................................................... 590
Criando um Backup de um Banco de Dados do Interbase ............................................................................. 591
Recuperando um Banco de Dados a Partir de um Backup ............................................................................. 591
Criando um Alias Para um Banco de Dados do Interbase .............................................................................. 592
CAPTULO 28: ACESSANDO BANCOS DE DADOS CLIENTE/SERVIDOR ................................................................... 593
KNOW-HOW em: Acesso a Bancos de Dados Cliente/Servidor ...................................................... 594
Acessando Banco de Dados Cliente-Servidor do Interbase em uma Aplicao Delphi via BDE .................... 594
Principais Propriedades do Componente StoredProc ................................................................................ 595
Principais Mtodos do Componente StoredProc ....................................................................................... 596
Principais Eventos do Componente IBoredProc ........................................................................................ 597
Exemplo de Aplicao ................................................................................................................................ 597
Acessando Banco de Dados do Interbase em uma Aplicao Delphi via Interbase Express .......................... 600
Principais Propriedades do Componente IBSToredProc ............................................................................ 601
Principais Mtodos do Componente IBStoredProc.................................................................................... 601
Principais Eventos do Componente IBStoredProc ..................................................................................... 602
Acessando Banco de Dados do Interbase em uma Aplicao Delphi via DBExpress ..................................... 605
Principais Propriedades do Componente SQLSToredProc ......................................................................... 605
Principais Mtodos do Componente SQLStoredProc ................................................................................ 606
Principais Eventos do Componente SQLStoredProc.................................................................................. 606
CAPTULO 29: PROGRAMAO GRFICA........................................................................................................ 609
KNOW-HOW em: Definio de Desenhos em Run-Time ................................................................. 610
A Classe TCanvas ............................................................................................................................................ 610
O Componente Shape..................................................................................................................................... 611
Desenhando em um Formulrio..................................................................................................................... 611
KNOW-HOW em: Definio de Desenhos de Forma Interativa ..................................................... 620
Desenhando de Forma Interativa ................................................................................................................... 621
A Classe TBitmap ............................................................................................................................................ 626
Modos de Mapeamento .................................................................................................................................. 630
Funes Para Transformao de Coordenadas ............................................................................................... 632
Funo SetWindowExtEx ........................................................................................................................... 632
Funo SetViewportExtEx .......................................................................................................................... 633
CAPTULO 30: TCNICAS DE IMPRESSO........................................................................................................ 635
KNOW-HOW em: Impresso Direta no Windows ............................................................................ 636
Principais Propriedades da Classe TPrinter ..................................................................................................... 637
Aborted ....................................................................................................................................................... 637
Canvas ........................................................................................................................................................ 637
Copies ......................................................................................................................................................... 637
Fonts ........................................................................................................................................................... 637
Orientation................................................................................................................................................. 637
PageHeight ................................................................................................................................................. 637
PageNumber ............................................................................................................................................... 637
PageWidth .................................................................................................................................................. 637
PrinterIndex ............................................................................................................................................... 638
Printers ....................................................................................................................................................... 638
Printing....................................................................................................................................................... 638
Title............................................................................................................................................................. 638
Principais Mtodos da Classe TPrinter ........................................................................................................... 638
BeginDoc .................................................................................................................................................... 638
EndDoc ....................................................................................................................................................... 638
NewPage ..................................................................................................................................................... 639
Exemplo de Utilizao da Classe TPrinter ...................................................................................................... 639
Criando a Interface da Aplicao ............................................................................................................... 639
Codificando a Aplicao ............................................................................................................................ 641
Imprimindo o Contedo Exibido por um Componente Memo .................................................................... 643
XIV 00CURSO COMPLETO
CAPTULO 31: CRIAO DE DLLS ............................................................................................................... 649
KNOW-HOW em: Criao de DLLs .................................................................................................... 650
Introduo ...................................................................................................................................................... 650
Procedimentos Bsicos Necessrios Criao de uma DLL em Delphi ......................................................... 650
Chamando uma DLL a Partir de Outra Aplicao .......................................................................................... 652
O Formulrio Principal da Aplicao ......................................................................................................... 653
Arquivo de Cdigo Associado ao Formulrio ............................................................................................ 653
Exibindo Formulrios a Partir de uma DLL .................................................................................................... 654
Carregamento Explcito de uma DLL ............................................................................................................. 656
CAPTULO 32: MANIPULAO DE ARQUIVOS, STRINGS E FONTES EM DELPHI ....................................................... 657
KNOW-HOW em: Manipulao de Arquivos .................................................................................... 658
Manipulao Direta de Arquivos Associados a uma Varivel ......................................................................... 658
KNOW-HOW em: Manipulao de Strings ....................................................................................... 662
Principais Funes Para a Manipulao de Strings ......................................................................................... 663
Principais Funes Para a Manipulao de Strings de Terminao Nula ....................................................... 670
StrLower ...................................................................................................................................................... 674
StrNew ........................................................................................................................................................ 675
StrPCopy ..................................................................................................................................................... 675
KNOW-HOW em: Manipulao de Listas de Strings ....................................................................... 676
A Classe TStrings ............................................................................................................................................. 676
Referncia: A Classe TStrings .......................................................................................................................... 676
Definio da Classe TStrings ...................................................................................................................... 676
Propriedades da Classe TStrings ................................................................................................................. 677
Mtodos da Classe TStrings ........................................................................................................................ 679
Componentes que Definem Propriedades Como Objetos da Classe TStrings ............................................... 682
KNOW-HOW em: Manipulao de Fontes ........................................................................................ 683
Referncia: a Classe TFont .............................................................................................................................. 683
Definio da Classe TFont .......................................................................................................................... 683
Propriedades da Classe TFont ..................................................................................................................... 684
Exemplo de Utilizao das Classes TFont e TStrings Para Manipulao de Arquivos Texto ASCII ................ 685
Exemplo de Utilizao das Classes TFont e TStrings Para Manipulao de Arquivos RTF............................. 696
CAPTULO 33: MANIPULAO DE THREADS EM DELPHI ................................................................................... 705
KNOW-HOW em: Threads .................................................................................................................. 706
O Conceito de Threads ................................................................................................................................... 706
Unidade de Cdigo Associada: ................................................................................................................... 707
A Classe TThread ........................................................................................................................................ 708
Implementando a Classe TPBThread ......................................................................................................... 711
Redefinindo o Cdigo da Unit Associada ao Formulrio .......................................................................... 712
CAPTULO 34: IMPLEMENTAO DA TECNOLOGIA COM EM DELPHI ................................................................... 715
KNOW-HOW em: Tecnologia COM.................................................................................................... 716
A Tecnologia COM.......................................................................................................................................... 716
Adicionando e Implementando um Mtodo Interface IUtilitario .............................................................. 720
Compilando e Registrando o Objeto COM no seu Sistema ........................................................................... 725
Criando uma Aplicao que Utilize o Objeto COM....................................................................................... 725
A Tecnologia OLE............................................................................................................................................ 726
CAPTULO 35: APLICAES MULTICAMADAS .................................................................................................. 727
KNOW-HOW em: Aplicaes Multicamadas .................................................................................... 728
Apresentando a Tecnologia............................................................................................................................. 728
A Camada de Armazenamento de Informaes ........................................................................................ 728
A Camada Intermediria a Camada Servidora ........................................................................................ 728
Criando a Camada de Interface com o Usurio (a aplicao-cliente) ....................................................... 731
CAPTULO 36: TCNICAS TEIS PARA A CRIAO DA INTERFACE COM O USURIO ................................................ 737
KNOW-HOW em: Parametrizao de Strings de Auxlio ............................................................... 738
Utilizao das Strings de Auxlio (Hints) ........................................................................................................ 738
Alterando a Cor de Fundo do Texto Exibido na String de Auxlio ............................................................ 738
SUMRIO
XV CURSO COMPLETO00
Alterando o Tempo de Incio e Trmino de Exibio da String de Auxlio ............................................... 739
Alterando o Tempo de Exibio Entre Strings de Auxlio Distintas .......................................................... 739
Exibindo uma String de Auxlio Composta por Vrias Linhas .................................................................. 739
KNOW-HOW em: Mltiplas Instncias ............................................................................................ 740
KNOW-HOW em: Reinicializao do sistema a partir de uma aplicao..................................... 741
KNOW-HOW em: Manipulao da data e hora do sistema ............................................................ 741
O Tipo TDateTime .......................................................................................................................................... 742
Obtendo a Data e Hora do Sistema ............................................................................................................ 742
Convertendo um Valor do Tipo Data/Hora em uma String ...................................................................... 743
Convertendo uma String em um Valor do Tipo Data/Hora ...................................................................... 743
Obtendo o Dia da Semana Correspondente a uma Data........................................................................... 743
Funes Especiais de Converso de Data/Hora.......................................................................................... 743
KNOW-HOW em: Personalizao de Formulrios com a Definio de um Pano de Fundo........ 744
Inserindo um Pano de Fundo em um Formulrio.......................................................................................... 744
KNOW-HOW em: Desenvolvimento de Aplicaes MDI ................................................................. 745
Criando Aplicaes MDI ................................................................................................................................. 745
Criando a Janela Principal de uma Aplicao MDI ................................................................................... 746
Criando uma Janela-filha de uma Aplicao MDI ..................................................................................... 746
Destruindo Uma Janela-Filha de uma Aplicao MDI ............................................................................... 746
Organizando a Exibio das Janelas-filhas ................................................................................................. 747
Mesclando Menus ...................................................................................................................................... 747
Codificando a Aplicao ................................................................................................................................. 748
KNOW-HOW em: Operaes de Drag-drop em Componentes ........................................................ 751
Descrio das Tcnicas de Drag & Drop..................................................................................................... 751
Exemplo de Utilizao................................................................................................................................ 752
Definio da Interface ................................................................................................................................ 752
Codificao do Exemplo ............................................................................................................................ 754
CAPTULO 37: INTERNACIONALIZAO DE APLICATIVOS CRIADOS COM O DELPHI .................................................. 757
KNOW-HOW em: Internacionalizao de Aplicativos.................................................................... 758
O Ambiente Integrado de Traduo do Delphi 7 ........................................................................................... 758
Incorporando os Recusos do Ambiente Integrado
de Traduo ao seu Projeto de Aplicativo ....................................................................................................... 758
Traduzindo Constantes e Expresses .............................................................................................................. 763
Definindo o Idioma Corrente ......................................................................................................................... 765
Utilizando o Translation Repository .......................................................................................................... 766
CAPTULO 38: CRIANDO APLICAES PARA A INTERNET .................................................................................. 769
KNOW-HOW em: Desenvolvimento de Aplicaes CGI com WebBroker ...................................... 770
Procedimentos Bsicos Necessrios Criao de Aplicaes CGI .................................................................. 770
Uma Aplicao CGI Bastante Elementar ........................................................................................................ 771
Exibindo a Data e a Hora do Sistema em uma Pgina HTML ........................................................................ 776
Respondendo a Entrada de Dados de Formulrios HTML.............................................................................. 777
O Componente PageProducer .................................................................................................................... 780
O Componente DataSetTableProducer ...................................................................................................... 782
O Componente QueryTableProducer ......................................................................................................... 788
KNOW-HOW em: Desenvolvimento de Aplicaes CGI com WebSnap ....................................................... 791
Criando o Mdulo Principal de uma Aplicao WebSnap ............................................................................. 792
Adicionando um Grid Para Exibio dos Registros ........................................................................................ 796
Adicionando Botes Para a Edio dos Registros do Grid .............................................................................. 798
Criando uma Pgina com um Formulrio Para Edio dos Registros ............................................................ 799
Conectando as Pginas ................................................................................................................................... 801
Testando a Aplicao ...................................................................................................................................... 801
Tratando Erros ................................................................................................................................................. 803
Criando uma Pgina de Login ........................................................................................................................ 803
Definindo as Pginas que Requerem Login .................................................................................................... 805
Definindo Direitos de Acesso a Usurios ........................................................................................................ 805
KNOW-HOW em: Desenvolvimento de Aplicaes CGI com Intraweb ........................................................ 806
Fundamentos da Tecnologia IntraWeb ........................................................................................................... 807
Criando a Aplicao ........................................................................................................................................ 807
XVI 00CURSO COMPLETO
Criando o Formulrio Principal da Aplicao............................................................................................ 807
Criando o Formulrio de Cadastro ............................................................................................................ 811
Criando o Formulrio de Alterao............................................................................................................ 813
Criando o Formulrio de Excluso............................................................................................................. 814
Testando a Aplicao ...................................................................................................................................... 816
PARTE III: REFERNCIA............................................................................................................................. 819
CAPTULO 39: FUNES MATEMTICAS DISPONVEIS EM DELPHI ....................................................................... 820
CAPTULO 40: CLASSES, CONTROLES E COMPONENTES ...................................................................................... 829
CAPTULO 41: PROPRIEDADES ..................................................................................................................... 977
CAPTULO 42: MTODOS .......................................................................................................................... 1229
CAPTULO 43: EVENTOS ........................................................................................................................... 1339
NDICE REMISSIVO .................................................................................................................................. 1383
CAPTULO 1 INTRODUO
1 CURSO COMPLETO00
Parte
Fundamentos
I
BORLAND DELPHI 7 CURSO COMPLETO PARTE I: FUNDAMENTOS
2 00CURSO COMPLETO
CAPTULO 1 INTRODUO
3 CURSO COMPLETO00
Captulo
Introduo
1
4 00CURSO COMPLETO
Neste captulo ser feita uma breve apresentao dos fatos que antecederam o surgimento das ferramentas
de desenvolvimento RAD, dentre as quais se destaca o prprio Delphi, e da importncia dessas
ferramentas no mercado desenvolvedor.
importante destacar que o Delphi, agora na verso 7, no mais uma simples ferramenta para
desenvolvimento de aplicaes com interface grfica e baseada na linguagem Object Pascal. O Delphi
7 , na realidade, um ambiente de desenvolvimento que integra diversas tecnologias.
FUNDAMENTOS EM: FERRAMENTAS DE DESENVOLVIMENTO
PR-REQUISITOS
Noes bsicas de desenvolvimento de software. Experincia na utilizao do sistema operacional Windows.
METODOLOGIA
Apresentao do problema: A escolha de uma ferramenta capaz de acelerar o processo de desenvolvimento de software.
AS ORIGENS DAS FERRAMENTAS RAD
Nos ltimos anos, o surgimento dos sistemas operacionais com interface grfica fez com que as tarefas
relacionadas ao desenvolvimento de softwares comerciais sofressem transformaes radicais.
Inicialmente, o desenvolvimento de sistemas para o ambiente Windows requeria a utilizao da
linguagem C na qual esto implementadas as funes da API do Windows. O desenvolvimento de
uma aplicao extremamente simples, que exibisse apenas uma janela com alguma mensagem esttica,
requeria cerca de dezenas de linhas de cdigo em linguagem C. O desenvolvimento de aplicaes mais
complexas, por sua vez, exigia centenas (se no milhares) de linhas de cdigo em linguagem C
apenas para criar os elementos de interface com o usurio.
Dessa maneira, o desenvolvedor levava um tempo enorme apenas codificando a interface do sistema
cuja finalidade simplesmente obter informaes do usurio ou exibir informaes referentes ao resultado
de algum processamento , em vez de se dedicar mais ao cdigo associado a um sistema especfico.
Considere, por exemplo, a seguinte situao: um desenvolvedor foi encarregado de criar um sistema
para controle de estoque de uma empresa. No seria mais lgico se dedicar mais codificao das
rotinas destinadas a solucionar os problemas intrnsecos ao sistema do que se preocupar em criar
janelas e botes de comando? Evidentemente que sim!
Paralelamente ao problema decorrente da extensa codificao necessria criao da interface, a
linguagem C tambm no uma linguagem de programao orientada a objetos caracterstica desejada
s linguagens modernas o que levaria a uma mudana radical nas tcnicas de modelagem e
desenvolvimento de sistemas. Alm disso, muitos desenvolvedores consideravam a linguagem C
extremamente difcil em comparao com o Basic e o Pascal (do qual se originou o Delphi), por exemplo.
Com o surgimento de ambientes de desenvolvimento baseados na linguagem C++ (uma das primeiras
linguagens a suportar as caractersticas da programao orientada a objetos), como o Borland C++ e o Microsoft
Visual C++, as tcnicas de programao orientada a objetos passaram a ser incorporadas com mais facilidade
CAPTULO 1 INTRODUO
5 CURSO COMPLETO00
no desenvolvimento dos novos sistemas. A linguagem C++, por ser uma extenso da linguagem C (s vezes
denominada por alguns autores como C com Classes), podia acessar diretamente as funes da API do
Windows e j oferecia uma srie de classes que definiam os principais elementos de interface. Continuava, no
entanto, a existir uma certa distncia entre a codificao do aplicativo e a criao da interface com o
usurio. A interface com o usurio era desenhada em um editor de recursos e a sua associao ao cdigo era
feita de forma indireta, em uma tabela de respostas a eventos definida no cdigo da aplicao.
Essa lacuna comeou a ser preenchida com o surgimento das primeiras ferramentas para
desenvolvimento rpido de aplicativos, tambm denominadas ferramentas RAD (Rapid Application
Development). Essas ferramentas permitiam associar, de maneira simples e rpida, um elemento de
interface e o cdigo da aplicao.
Uma das primeiras ferramentas a adotar o conceito RAD foi o Visual Basic for Windows, da Microsoft.
Ao adotar uma linguagem simples como o Basic e facilitar a associao entre cdigo e elementos de
interface (por meio da incorporao das tcnicas de programao orientada a eventos), o Visual Basic
reuniu os requisitos bsicos para se tornar, inicialmente, uma das ferramentas de desenvolvimento de
maior sucesso do mercado.
Havia, no entanto, algumas limitaes. Uma aplicao desenvolvida em Visual Basic requeria a utilizao
de algumas DLLs cuja distribuio era indesejvel, e o desempenho dos aplicativos gerados no era to
bom quanto o das aplicaes desenvolvidas em C++. Alm disso, o Visual Basic no suportava os
requisitos de uma linguagem de programao orientada a objetos (o que, no entanto, j ocorre a partir
da verso do produto para a plataforma .NET, que incorporou profundas modificaes na linguagem).
Os desenvolvedores Windows passaram ento a ser obrigados a optar entre desempenho final e
velocidade de desenvolvimento. Aqueles que optassem pelos ambientes de desenvolvimento baseados
na linguagem C++ ganhavam no desempenho das aplicaes geradas, mas necessitavam de prazos
superiores aos daqueles que optavam pelo Visual Basic.
Foi ento que a Borland surpreendeu o mercado com o lanamento do Borland Delphi (ainda na
verso 1.0 para desenvolvimento de aplicaes para o Windows 3.x) uma ferramenta que aliava a
facilidade do Visual Basic ao poder da linguagem Object Pascal, cujo compilador apresentava o mesmo
desempenho do Borland C++.
O Delphi apresentava (e ainda apresenta) uma biblioteca de componentes inteiramente desenvolvida
em Object Pascal a VCL (Visual Component Library) , na qual cada componente era representado
por uma classe. Alm disso, a linguagem Object Pascal suportava os requisitos bsicos de programao
orientada a objetos (excetuando-se apenas os recursos de herana mltipla que pode ser simulada
e sobrecarga de operadores e funes esse ltimo recurso j incorporado desde a verso 4 do produto).
Alm disso, a Borland disponibilizou o cdigo-fonte dos componentes da VCL, o que permitiu aos
desenvolvedores compreender sua estrutura hierrquica e codificao, e tambm facilitou a expanso
dessa biblioteca mediante a criao de novos componentes (desenvolvidos por terceiros).
Essa estratgia impulsionou o surgimento de um novo mercado o mercado de desenvolvedores de
componentes. Ao mesmo tempo em que incorpora ao Delphi os componentes padres para criao de
interface, a Borland permite que terceiros desenvolvam componentes capazes de realizar tarefas especficas.
6 00CURSO COMPLETO
Esse mercado se desenvolveu com tanta rapidez e eficincia que alguns desses componentes
desenvolvidos por terceiros, como o Rave Reports (para a criao de relatrios), o TChart (para
gerao de grficos), e o Intraweb (para desenvolvimento RAD para WEB) passaram a integrar o
pacote oficial do Delphi.
Atualmente existe uma infinidade de componentes, e muitos so comercializados pela Internet. A
maioria destes possui uma verso de avaliao, e muitos podem ser adquiridos com o cdigo-fonte
completo. Por terem sido desenvolvidos em Object Pascal, no precisam de nenhuma DLL ou arquivo
adicional, e so facilmente integrados ao ambiente de desenvolvimento do Delphi (que tambm suporta
componentes ActiveX, mas sem as vantagens dos componentes nativos denominao dada aos
componentes desenvolvidos em Object Pascal). Existem ainda os componentes Freeware, que podem
ser utilizados sem custo algum.
Recomendo que voc use e abuse dos componentes existentes no mercado, de forma a acelerar o
processo de desenvolvimento dos seus aplicativos. No se esquea, no entanto, de adquirir legalmente
os componentes que utilizar, pois, alm dos aspectos legais envolvidos, a justa remunerao estimula
os desenvolvedores de componentes a prosseguir no seu trabalho.
Infelizmente, a falta de respeito aos direitos autorais se manifesta em grande escala por todo o mundo,
e o Brasil no exceo. Devemos ter em mente, no entanto, que a prtica da pirataria tende a
desestimular os desenvolvedores de solues, e no futuro voc pode se tornar uma vtima do seu
prprio crime, ao no encontrar para uma futura verso do Delphi um componente que possa
simplificar o seu trabalho de desenvolvimento (componente este que havia sido desenvolvido para
verses anteriores do produto). Esse tipo de argumento se aplica ao prprio Delphi, comercializado em
diversas verses, a preos compatveis para cada finalidade.
A fim de facilitar o desenvolvimento de aplicaes multiplataforma, a Borland passou a incluir, desde
a verso 6 do Delphi, uma nova biblioteca de componentes denominada CLX e usada pelo Kylix (a
ferramenta RAD da Borland para o desenvolvimento de aplicaes para o ambiente Linux). A CLX
baseada na biblioteca Qt da Troll Tech, que realmente multiplataforma, e seus componentes so
muito semelhantes queles existentes na VCL.
Conseqentemente, o desenvolvedor que for capaz de, utilizando o Delphi 7 como ferramenta de
desenvolvimento, criar aplicaes para o ambiente Windows baseadas na CLX, no ter nenhuma
dificuldade em migrar suas aplicaes para o ambiente Linux, caso empregue o Kylix como ferramenta
de desenvolvimento para aquele sistema operacional.
Um alerta aos iniciantes: programao no sinnimo de criao de interface! Nos ltimos anos,
tenho observado que muitas pessoas (principalmente os iniciantes em programao) esto confundindo
um pouco as coisas. Desenvolver um aplicativo requer mais do que apenas construir uma bela inter-
face, e o objetivo das ferramentas RAD exatamente esse: simplificar a criao da interface para permitir
que o desenvolvedor se atenha mais anlise, projeto e codificao do sistema. A interface, como o
prprio nome diz, serve para a comunicao entre o usurio e o sistema, e corresponde apenas a uma
parcela do seu desenvolvimento.
Desenvolver uma aplicao requer conhecimento de tpicos como, por exemplo, algoritmos, lgica de
programao e teoria de Bancos de Dados. Devemos considerar que a formao de um desenvolvedor
no se faz da noite para o dia, e a programao apenas um dos ingredientes dessa formao.
CAPTULO 1 INTRODUO
7 CURSO COMPLETO00
Embora tenha me esforado para redigir meus livros de forma didtica e precisa, de maneira a poder
oferecer informao atualizada aos nossos leitores, a rapidez com que a informtica evolui fora-nos a
escrever e publicar livros em tempo recorde! Conseqentemente, eventuais erros de redao ou digitao
podem vir a ocorrer, mas que de forma alguma comprometem o entendimento do assunto. Reforo o
argumento de que programao uma atividade que exige muito raciocnio, estando distante de ser
uma atividade mecnica. De qualquer maneira, estarei disposio para resolver dvidas referentes ao
livro pelo endereo eletrnico mrleao@rio.com.br.
Gostaria de concluir esse captulo parabenizando o leitor por adotar o Delphi 7 como ferramenta
de desenvolvimento. Conforme ser mostrado ao longo do livro, o Delphi 7 ferramenta de
desenvolvimento robusta e capaz de atender s necessidades de desenvolvedores de qualquer
porte desde aqueles que desenvolvem aplicativos mais simples (com acesso a bancos de dados
locais) at aqueles que esto comprometidos com o desenvolvimento de solues corporativas e
para a Internet.
8 00CURSO COMPLETO
CAPTULO 2 O AMBIENTE DE DESENVOLVIMENTO INTEGRADO DO DELPHI 7
9 CURSO COMPLETO00
Captulo
O Ambiente de Desenvolvimento
Integrado do Delphi 7
2
10 00CURSO COMPLETO
Neste captulo ser apresentado o ambiente de desenvolvimento integrado do Delphi 7. Sero mostrados
os conceitos fundamentais de formulrios, controles, componentes, propriedades, mtodos e eventos,
cuja compreenso indispensvel ao desenvolvimento de uma boa aplicao.
FUNDAMENTOS EM: COMPOSIO DO AMBIENTE DE DESENVOLVIMENTO
PR-REQUISITOS
Noes bsicas da utilizao do ambiente Windows.
METODOLOGIA
Apresentao dos elementos que compem o ambiente de desenvolvimento integrado do Delphi 7.
APRESENTAO DO AMBIENTE DE DESENVOLVIMENTO INTEGRADO DO DELPHI 7
Neste captulo ser apresentado o ambiente de desenvolvimento do Delphi 7 e os conceitos fundamentais
utilizados na criao da interface de um aplicativo.
As figuras que se seguem apresentam o ambiente de desenvolvimento integrado do Delphi 7, tal como
se apresenta quando voc o inicializa pela primeira vez.
Figura 2.1: Ambiente de desenvolvimento integrado do Delphi 7.
11 CURSO COMPLETO00
As figuras exibidas neste livro foram capturadas com o sistema operacional Windows XP, mas os procedimentos e as janelas so muito
semelhantes nas outras verses deste sistema operacional (95/98/Me/NT/2000).
O ambiente de desenvolvimento integrado do Delphi 7 composto pelas seguintes reas de trabalho:
a) Uma janela principal, onde se encontram:
Uma barra de ttulos, que exibe o ttulo do projeto corrente. Quando voc inicia um novo
projeto, este recebe o nome default Project1, como mostra a figura anterior.
Uma barra de menus, que d acesso aos principais comandos e configuraes do ambiente de
desenvolvimento integrado do Delphi 7.
Uma caixa de ferramentas, composta de vrios botes reunidos em trs grupos, e que fornecem
atalho para a execuo de diversas tarefas, como ser mostrado ao longo do texto.
Uma caixa combo que permite selecionar a configurao desejada para a sua rea de trabalho.
Uma paleta de componentes, composta por diversas pginas nas quais os componentes esto
reunidos por categoria. Estes componentes so os objetos utilizados na criao da interface do
programa, no desenvolvimento de aplicaes para o ambiente Windows. Estas pginas da paleta
de componentes apresentam algumas diferenas quando a aplicao se baseia na VCL ou na CLX.
A VCL, por ser desenvolvida exclusivamente para o ambiente Windows, possui mais componentes
que a CLX (que precisa atender ao requisito de ser multiplataforma). Logo, se voc for desenvolver
uma aplicao exclusivamente para o ambiente Windows, dever dar preferncia utilizao da
VCL. Caso a aplicao venha a ser multiplataforma (compilada no Delphi para o ambiente Win-
dows e no Kylix para o ambiente Linux), dever dar preferncia utilizao da CLX.
b) Uma janela chamada Object Inspector, que d acesso s principais propriedades e eventos de um
componente. Esta janela composta por:
Uma caixa de seleo de objetos, utilizada para selecionar o objeto cujas propriedades e eventos
desejamos alterar.
Duas guias, intituladas Properties e Events, que do acesso s pginas de propriedades e de
eventos, respectivamente.
Os nomes das propriedades e dos eventos podem ser organizados em ordem alfabtica ou por categoria, alm de se poder ocultar a
exibio de determinados tipos de propriedades e eventos. Esta versatilidade permite otimizar ainda mais a utilizao do ambiente de
desenvolvimento.
c) Uma janela chamada Form1, criada automaticamente pelo Delphi 7. O que o Delphi 7 chama de
formulrios so as janelas usadas no desenvolvimento de aplicaes. Em geral, uma aplicao
composta por diversas janelas (ou, como descrito anteriormente, por vrios formulrios).
d) Uma janela denominada Code Editor mostrada na figura a seguir , inicialmente sobreposta
pelo formulrio Form1, na qual ser digitado o cdigo da aplicao. Para alternar entre o Editor
de Cdigos e o formulrio, basta pressionar seguidamente a tecla de funo F12.
12 00CURSO COMPLETO
Figura 2.2: O Editor de Cdigos do Delphi 7.
Para que uma aplicao se comporte da maneira desejada, torna-se necessria a incluso de linhas
de cdigo que definam o comportamento do programa, como resposta a aes do usurio ou do
sistema operacional.
Embora o Delphi 7 facilite muito o trabalho de codificao de um aplicativo, sempre ser necessrio
incluir algumas linhas de cdigo, como ser mostrado ao longo do livro, no desenvolvimento dos
nossos aplicativos-exemplo.
Repare que, inicialmente, a janela do Editor de Cdigos possui uma outra janela ancorada ao longo
da sua extremidade esquerda. Esta janela, chamada Code Explorer, e que pode ser reposicionada dentro
do ambiente de desenvolvimento integrado do Delphi 7, permite uma melhor movimentao pelo
cdigo da aplicao, principalmente quando os arquivos de cdigo se tornam mais extensos.
Em sua barra de ttulos, a janela do Code Editor apresenta o nome do arquivo em que est armazenado
o cdigo que est sendo editado no momento. Inicialmente, conforme mostrado na figura anterior,
esse arquivo denominado Unit1.
Logo abaixo da sua barra de ttulos so exibidas as guias correspondentes aos arquivos de cdigo que
esto abertos. Na figura anterior, como apenas o arquivo unit1 est aberto, s existe uma guia,
identificada pelo nome Unit1 (essa a situao existente quando se inicia um novo projeto).
Ao editar o cdigo do seu programa, voc pode aplicar as tcnicas de copiar, recortar e colar texto usando as combinaes de tecla
Ctrl+C, Ctrl+X e Ctrl+V, como se faz em muitos editores de texto, ou empregar os itens correspondentes no menu Edit da janela principal
do ambiente de desenvolvimento.
e) Uma janela chamada Object TreeView mostrada na figura a seguir que permite selecionar
rapidamente um componente inserido no formulrio, estando os nomes dos componentes exibidos
13 CURSO COMPLETO00
visualmente em uma estrutura hierrquica. Esta janela muito til quando se deseja alterar as
propriedades de um componente cuja seleo pode ser dificultada pela existncia de outros
componentes sobrepostos e que ocupem boa parte da sua regio visvel.
Figura 2.3: A Janela Object TreeView.
importante destacar que o ambiente de desenvolvimento do Delphi 7 completamente configurvel.
Voc pode ancorar janelas em outras, alm de arrast-las e reposicion-las de forma que o ambiente
seja configurado para acelerar ao mximo a sua produtividade.
Existem ainda outras janelas, usadas principalmente na depurao de aplicativos, e que sero discutidas
em um captulo posterior.
A janela principal usada para a edio do trabalho, personalizao do ambiente, gerenciamento de
documentos, etc. Os elementos que compem a janela principal podem ser tratados como barras de
ferramentas independentes (mas internas janela principal), isto , podem ser arrastados, reposicionados,
etc. dentro da janela principal.
Voc pode selecionar os elementos que devem ser exibidos na janela principal. Para isso, basta executar
o seguinte procedimento:
1. Pressionar o boto direito do mouse sobre qualquer rea livre da janela principal (geralmente
na rea superior direita dessa janela, prximo ao menu Help) para exibir o menu pop-up
mostrado na figura a seguir, na qual se pode selecionar os elementos da janela principal que
devem ou no ser exibidos.
Figura 2.4: Exibindo o menu pop-up da janela principal do ambiente de desenvolvimento do Delphi 7.
14 00CURSO COMPLETO
Voc tambm pode selecionar o item Customize desse menu, para exibir a caixa de dilogo Customize,
mostrada na figura a seguir.
Figura 2.5: A caixa de dilogo Customize.
Essa caixa de dilogo apresenta ainda as guias Commands e Options, que permitem que se definam
opes para a janela principal.
Utilizando-se da guia Commands dessa caixa de dilogo, voc pode adicionar novos botes s barras
de ferramentas da janela principal. Para isso, basta executar os seguintes procedimentos:
1. Exiba a caixa de dilogo Customize, executando os procedimentos descritos anteriormente.
2. Selecione a guia Commands dessa caixa de dilogo.
3. Selecione uma das categorias na lista da esquerda (lista Categories). Os comandos
correspondentes so exibidos na lista da direita (Commands).
4. Selecione o comando que deseja acessar por meio de um boto de comando e o arraste para a
janela principal, na posio em que o boto deve ser inserido. Caso o comando possua um
bitmap associado, este ser exibido no boto a ser criado; caso contrrio, o texto do comando
ser exibido (e as dimenses do boto sero maiores).
Para remover o boto de comando, basta selecion-lo e arrast-lo para fora da barra de ferramentas.
Utilizando a guia Options dessa caixa de dilogo, voc pode definir se os botes de comando devem ou
no exibir strings de auxlio e se estas devem ou no exibir as teclas de atalho correspondentes ao
comando. Para isso, basta selecionar as opes correspondentes.
FORMULRIOS OS ELEMENTOS DE CRIAO DA INTERFACE COM O USURIO
Quando voc inicia o ambiente de trabalho do Delphi 7 ou comea a desenvolver uma nova aplicao,
aparece um formulrio default denominado Form1, criado automaticamente pelo ambiente, no qual
voc pode comear a construir a interface visual do seu programa.
15 CURSO COMPLETO00
O que o Delphi 7 chama de formulrio , na realidade, uma janela de uma aplicao, que pode ser a sua
janela principal, uma caixa de dilogo, etc.
Um formulrio apresenta uma rea de trabalho, denominada rea-cliente, na qual podem ser includos
os controles e componentes que proporcionaro maior funcionalidade sua aplicao.
A figura a seguir mostra o formulrio default criado pelo Delphi 7.
Figura 2.6: O formulrio default criado pelo Delphi 7.
Os procedimentos necessrios personalizao de um formulrio sero apresentados posteriormente,
medida que forem apresentados os procedimentos necessrios criao da interface.
CONTROLES E COMPONENTES
Os componentes so os objetos utilizados para criar a interface do programa com o usurio e executar
tarefas especficas do sistema operacional.
Os controles so os componentes que podem permanecer visveis durante a execuo do aplicativo.
Fica evidente, portanto, que os componentes podem ser divididos em dois grandes grupos: os
componentes no-visuais e os componentes visuais os controles.
Como exemplo de componentes no-visuais podem ser citados os que permitem a exibio das caixas
de dilogo padro do sistema (encontradas na pgina Dialogs da paleta de componentes) e o
temporizador (encontrado na pgina System da paleta de componentes do Delphi 7), usado para gerar
mensagens do sistema a intervalos de tempo predefinidos.
16 00CURSO COMPLETO
Como exemplo de controles podemos citar as caixas de texto, rtulos, caixas de lista e botes de
comando, entre muitos outros que sero mostrados ao longo do livro.
Em suma, os controles so os componentes visuais com os quais o usurio poder interagir durante a
execuo do aplicativo. Os componentes no-visuais, por outro lado, permanecem invisveis durante
a execuo da aplicao (o usurio no os enxerga), embora realizem tarefas importantes.
Os controles e componentes esto distribudos, de acordo com a sua funcionalidade, pelas diversas
pginas da paleta de componentes (Figura 2.7), situada na janela principal do Delphi 7.
Figura 2.7: A paleta de componentes do Delphi 7.
As pginas da paleta de componentes exibidas no Delphi 7 dependem da biblioteca de componentes
utilizada. As pginas de componentes da VCL e da CLX no so exatamente iguais, mas a maneira de
utiliz-las a mesma. As diferenas dizem respeito existncia ou no de determinadas pginas (A
CLX, por ser multiplataforma, no possui uma pgina chamada Win32 na sua paleta de componentes)
e componentes especficos, bem como localizao de determinados componentes. O temporizador
(componente Timer) um exemplo de componente disponvel nas duas bibliotecas, mas em pginas
diferentes da paleta de componentes.
importante destacar que, inicialmente, nem todas as guias esto visveis. Para navegar pelas guias da
paleta de componentes, use os botes de seta situados no seu canto superior direito. Para selecionar
uma das pginas, basta clicar com o boto esquerdo do mouse sobre a guia correspondente.
Quando o nmero de componentes de uma pgina exceder a sua capacidade de exibio, use os botes
de seta situados nas extremidades da pgina para exibir os componentes que estiverem ocultos. Outra
opo alterar a resoluo atual do seu monitor, de forma a tornar possvel a exibio simultnea de
um maior nmero de componentes por pgina. Normalmente, em uma resoluo de 800 x 600, todos
os componentes podem ser acessados sem qualquer dificuldade, o que no ocorre no caso em que se
adota uma resoluo de 640 x 480.
Cada controle ou componente tem propriedades, mtodos e eventos associados. As propriedades de
um controle ou componente definem o seu aspecto e algumas das suas principais caractersticas. Os
mtodos so funes ou procedimentos intrnsecos ao controle ou componente, e so capazes de
realizar alguma tarefa especfica quando executados. Os eventos, por sua vez, so acontecimentos
associados a um controle ou componente. As definies de propriedades, mtodos e eventos sero
detalhadas nos tpicos a seguir.
PROPRIEDADES
Os controles e componentes, junto com os formulrios, so objetos predefinidos da linguagem Object
Pascal (a linguagem de programao utilizada pelo Delphi 7) e apresentam algumas caractersticas
muito semelhantes s dos objetos que diariamente manipulamos. Vamos aproveitar essas semelhanas
na definio das caractersticas dos objetos da linguagem Object Pascal e eleger como objeto de
17 CURSO COMPLETO00
comparao um monitor de vdeo, objeto que todos ns, programadores, conhecemos e com o qual
estamos habituados a trabalhar.
Todo e qualquer objeto tem propriedades que o caracterizam e o diferenciam dos demais. Entre as
propriedades de um monitor de vdeo, podemos destacar:
O seu tamanho (definido em polegadas).
A cor do seu gabinete.
Assim como o monitor de vdeo, um formulrio (e todos os demais objetos da linguagem) tambm
tem propriedades que o diferenciam, tais como:
A sua cor, que definida pelo valor armazenado na sua propriedade Color.
O seu tamanho, definido pelo valor armazenado nas suas propriedades Height (altura) e
Width (largura).
A definio ou alterao de um valor para uma propriedade pode ser feita de duas formas:
Na fase de projeto, usando-se o Object Inspector (que ser visto em um tpico posterior, ainda
neste captulo).
Durante a execuo do aplicativo, mediante a incluso de uma linha de cdigo com a seguinte
sintaxe:
nome_do_objeto.nome_da_propriedade:= valor;
Esse um tpico exemplo de comando de atribuio, e o sinal de igualdade precedido por dois-pontos
, nesse caso, denominado operador de atribuio. Os operadores da linguagem Object Pascal sero
apresentados no prximo captulo.
MTODOS
Todo objeto na vida real tem alguma funcionalidade e, no caso do monitor de vdeo, por exemplo, essa
funcionalidade consiste em mostrar a imagem correspondente a um sinal enviado pela placa de vdeo
do sistema. Entretanto, para que isso acontea, necessrio que o monitor de vdeo saiba como
transformar o sinal emitido pela placa de vdeo em imagem, isto , deve existir um mtodo para se fazer
isso (no caso do monitor de vdeo, existem circuitos eletrnicos que se encarregam dessa tarefa).
Assim como o monitor de vdeo, os objetos utilizados no desenvolvimento de uma aplicao com o
Delphi 7 tambm tero mtodos que os tornaro capazes de realizar determinadas tarefas.
Diferentemente do que ocorre com as propriedades, que tambm podem ser definidas na fase de projeto,
a chamada a um mtodo s pode ser feita durante a execuo do aplicativo, mediante a incluso de
uma linha de cdigo com a seguinte sintaxe:
nome_do_objeto.nome_do_mtodo;
Conforme ser descrito posteriormente (no captulo referente programao orientada a objetos), um
mtodo pode ou no receber parmetros, sendo, na realidade, uma funo ou procedimento que
definida para o objeto (para ser mais exato, um mtodo definido internamente a uma classe, da qual
18 00CURSO COMPLETO
o objeto uma instncia, mas por enquanto vamos deixar de lado esses preciosismos de definio, de
forma a no confundir o prezado leitor).
Em alguns casos, pode ser necessria a passagem de parmetros na chamada a um mtodo.
EVENTOS
No tpico anterior vimos que todo objeto tem mtodos, que so caractersticas que representam a sua
funcionalidade.
Normalmente, os mtodos so executados em resposta a algum acontecimento (um evento). No caso do
monitor de vdeo, por exemplo, quando o usurio alterna entre aplicaes do Windows (quando ocorre
o evento de alternar entre aplicaes), os mtodos necessrios atualizao da imagem so executados.
Da mesma forma que no monitor de vdeo, os objetos que usamos no desenvolvimento dos nossos
aplicativos com o Delphi 7 tambm apresentam eventos associados.
Cada objeto tem a capacidade de responder a um determinado conjunto de eventos, e essa resposta a
um evento feita mediante a definio de um procedimento associado a esse evento, e esse procedimento
pode ser facilmente acessado por meio do Object Inspector.
Sempre que um determinado evento ocorre, a aplicao verifica se existe um procedimento associado
a esse evento e, em caso positivo, o procedimento a ele associado executado.
Considere, por exemplo, um boto de comando, objeto bastante comum nas aplicaes desenvolvidas
para o ambiente Windows. Quando um usurio seleciona um boto (clicando sobre este com o boto
esquerdo do mouse), diz-se que ocorreu o evento de clicar sobre o boto com o boto esquerdo do
mouse. Quando esse evento ocorre, o usurio espera alguma resposta (afinal de contas, se o boto est
l, deve servir para alguma coisa). Associado a esse evento, deve haver um procedimento a ser executado
sempre que isso ocorrer. importante lembrar que, ao ocorrer esse evento, a aplicao verifica se existe
um procedimento associado. Se houver, esse procedimento executado, se no, a aplicao no faz
nada. Cabe a voc o desenvolvedor definir um procedimento associado a esse evento e codificar os
comandos a serem executados nesse procedimento.
Nos prximos tpicos, sero apresentados os passos necessrios definio de procedimentos associados
a eventos.
O OBJECT INSPECTOR
Essa janela, que fornece acesso direto s propriedades e eventos associados a um componente, tem:
Uma caixa de seleo de objetos, que identifica o objeto selecionado.
Pginas de eventos (acessada selecionando-se a guia Events com o boto esquerdo do mouse) e
de propriedades (acessada selecionando-se a guia Properties com o boto esquerdo do mouse).
19 CURSO COMPLETO00
Figura 2.8: A pgina Properties do Object Inspector no Delphi 7.
ALTERANDO O VALOR DE UMA PROPRIEDADE NO OBJECT INSPECTOR
Voc pode alterar o valor de uma propriedade de um componente executando os seguintes
procedimentos:
1. Selecione o componente, clicando sobre ele com o boto esquerdo do mouse ou por meio da
caixa de seleo de objetos do Object Inspector.
2. Selecione a pgina Properties do Object Inspector, se ela j no estiver selecionada.
3. Clique no campo direita da propriedade a ser alterada.
4. Defina o novo valor da propriedade.
Quando se altera a propriedade de um componente usando-se o Object Inspector, diz-se que essa propriedade est sendo alterada na
fase de projeto do aplicativo. Quando essa alterao for feita mediante a incluso de uma linha de cdigo (conforme descrito
anteriormente), diz-se que a propriedade est sendo alterada durante a execuo do aplicativo.
Conforme descrito anteriormente, voc pode optar por exibir as propriedades em ordem alfabtica ou
agrupadas por categoria, bastando selecionar a opo correspondente no item Arrange do menu pop-
up que exibido quando voc pressiona o boto direito do mouse sobre o Object Inspector, como
mostra a Figura 2.9.
Voc tambm pode selecionar as propriedades que devem estar visveis, bastando marcar ou desmarcar
a opo correspondente no item View do menu pop-up apresentado na figura anterior. Alm disso, o
Object Inspector exibe, em sua extremidade inferior, o nmero de propriedades ou eventos ocultos (ou
a frase All Shown indicando que todos esto sendo exibidos).
A Figura 2.8 mostra a pgina de propriedades do objeto Form1.
20 00CURSO COMPLETO
Figura 2.9: O menu pop-up do Object Inspector.
DEFININDO PROCEDIMENTOS ASSOCIADOS A EVENTOS
A Figura 2.10 mostra a pgina Events do object Inspector, usada para definir procedimentos associados
a eventos para um objeto.
Figura 2.10: A pgina Events do Object Inspector.
Para alguns componentes, algumas propriedades consideradas muito importantes tambm so exibidas na pgina de eventos do
Object Inspector.
21 CURSO COMPLETO00
Voc pode definir um procedimento associado a um evento de um objeto da seguinte forma:
1. Selecione o objeto clicando sobre ele com o boto esquerdo do mouse ou por meio da caixa de
seleo de objetos.
2. Selecione a pgina Events do Object Inspector, se ela j no estiver selecionada.
3. D um duplo clique no espao em branco exibido direita do nome do evento cujo
procedimento dever ser definido. Ser exibida a janela do Code Editor, com o cursor situado
no ponto em que deve ser inserido o cdigo associado quele evento. A Figura 2.11 mostra a
janela exibida quando se cria o procedimento associado ao evento OnActivate do objeto Form1.
4. Digite o trecho de cdigo a ser executado quando o evento ocorrer.
Figura 2.11: Definindo o procedimento associado a um evento.
Observe que o cabealho e o corpo principal do procedimento so gerados automaticamente.
Qualquer cdigo a ser executado em resposta a esse evento dever ser escrito entre as palavras
begin e end (no as apague). Como mostra a Figura 2.12, alm de criar o cabealho e o corpo
principal da funo, o compilador ainda inseriu uma declarao do procedimento dentro da
definio da classe TForm1 (Calma! Se voc no sabe o que uma classe, no precisa se assustar,
pois isso ser visto no prximo captulo).
22 00CURSO COMPLETO
Figura 2.12: Declarao do procedimento associado a um evento.
O CONCEITO DE PROJETO DE UMA APLICAO
Normalmente, uma aplicao desenvolvida para o ambiente Windows tem diversas janelas e caixas de
dilogo, cada uma com sua finalidade especfica (entrada de dados, mensagens de advertncia, exibio
de grficos, etc.) e diversos arquivos de cdigo.
Dessa maneira, fica claro que o desenvolvimento de uma aplicao com o Delphi 7 exigir a utilizao
de diversos formulrios e arquivos de cdigo.
Como a quantidade de formulrios e arquivos de cdigos de uma aplicao pode tornar difcil o
seu gerenciamento por parte do programador, o Delphi 7 utiliza o conceito de Projeto de uma
aplicao. Quando voc inicia o desenvolvimento de uma aplicao, est, na realidade, criando
um projeto. Quando voc adiciona um formulrio ou arquivo de cdigo para a aplicao, est, na
realidade, adicionando arquivo(s) ao projeto. O Projeto chama para si a responsabilidade de gerenciar
a aplicao, facilitando o trabalho do programador.
Conforme descrito anteriormente, quando voc inicia um novo projeto de aplicao no Delphi 7,
ele recebe o nome de Project1 (o nome do projeto exibido na barra de ttulo da janela principal) e
ser armazenado no arquivo project1.dpr, a menos que voc o renomeie, selecionando o item Save
Project As do menu File e redefinindo os nomes dos arquivos de cdigo e de projeto nas caixas de
dilogo correspondentes.
Alm do arquivo de projeto, o Delphi 7 cria tambm um formulrio (denominado Form1) e uma
unidade de cdigo, denominada unit1 e armazenada no arquivo unit1.pas (a menos que voc o
renomeie, selecionando o item Save As do menu File ou definindo esse nome na caixa de dilogo Save
Unit1 As, exibida ao se salvar o projeto).
23 CURSO COMPLETO00
Um projeto de aplicao tem a sua definio armazenada em um arquivo com a extenso DPR e pode
ser visualizado selecionando-se o item View Source do menu Project. A Figura 2.13 mostra o cdigo do
arquivo project1.dpr, criado automaticamente pelo Delphi 7.
Observe que agora existem dois arquivos de cdigo abertos no Code Editor (sendo que um deles o arquivo de projeto). Voc pode
exibir um arquivo selecionando a guia correspondente.
Figura 2.13: O cdigo do arquivo de projeto.
Na primeira linha, tem-se a palavra-chave program seguida do nome do projeto (nome do arquivo de
projeto). Se voc salvar esse projeto com um outro nome, esse outro nome ser mostrado logo aps a
palavra-chave program (em vez de Project1).
O programador iniciante no deve manipular diretamente o arquivo de projeto. Mesmo no desenvolvimento de aplicativos
avanados, raramente se faz necessria a manipulao direta desse arquivo, ficando todo o gerenciamento do projeto por conta
do prprio ambiente.
Em seguida pode-se verificar a clusula Uses reproduzida a seguir.
Na VCL:
uses
Forms,
Unit1 in Unit1.pas {Form1};
24 00CURSO COMPLETO
Na CLX
uses
QForms,
Unit1 in Unit1.pas {Form1};
Essa clusula permite que o arquivo de projeto acesse as definies armazenadas nos arquivos Forms.pas
(no caso da VCL) ou QForms.pas (no caso da CLX) e Unit1.pas.
Repare que, enquanto a VCL usa a unit Forms, a CLX usa a unit QForms. Em geral, o prefixo Q
identifica que a unit pertence biblioteca CLX.
Em seguida verifica-se a presena da seguinte linha de cdigo:
{$R *.res}
Esta linha de cdigo, exibida normalmente em itlico, representa uma diretiva de compilao, e indica
ao compilador que, associado a este projeto, deve existir um arquivo de recursos (resources) com o
mesmo nome do arquivo de projeto e extenso .res, e que se este arquivo no existir, dever ser criado.
Por fim, verifica-se a existncia do seguinte trecho de cdigo (que o cdigo principal do arquivo de
projeto, responsvel pela execuo do aplicativo):
begin
Application.Initialize;
Application.CreateForm(TForm1, Form1);
Application.Run;
end.
Nesse trecho de cdigo usa-se o objeto Application (que uma instncia da classe TApplication) que
representa a aplicao.
O mtodo Initialize do objeto Application, executado na linha de cdigo reproduzida a seguir,
responsvel pela inicializao da aplicao.
O mtodo CreateForm do objeto Application carrega um formulrio na memria (esse mtodo recebe
como parmetros a classe e o nome do formulrio). Nesse caso, como o projeto recm-criado j possui
automaticamente um formulrio chamado Form1, da classe TForm1, a criao desse formulrio feita
na execuo da seguinte linha de cdigo:
Application.CreateForm(TForm1, Form1);
A execuo da aplicao se inicia com a execuo do mtodo Run do objeto Application, o que ocorre
mediante a execuo da seguinte linha de cdigo:
Application.Run;
Se voc examinar o cdigo do arquivo unit1.pas criado pela VCL, mostrado a seguir, ver que esse
cdigo faz referncia ao objeto Form1:
25 CURSO COMPLETO00
unit Unit1;
interface
uses
Windows, Messages, SysUtils, Variants, Classes, Graphics, Controls, Forms,
Dialogs;
type
TForm1 = class(TForm)
private
{ Private declarations }
public
{ Public declarations }
end;
var
Form1: TForm1;
implementation
{$R *.dfm}
end.
Na primeira linha, tem-se a palavra-chave unit seguida do nome da unit (nome da unidade de cdigo).
Se voc salvar o arquivo dessa unit com um outro nome, esse outro nome ser mostrado logo aps a
palavra-chave unit (em vez de unit1).
Alm disso, pode-se observar a seguinte linha de cdigo:
{$R *.DFM}
Essa linha de cdigo representa uma diretiva de compilao e indica ao Delphi 7 que, associado a essa
unit, existe um arquivo de mesmo nome, mas com a extenso DFM.
Um arquivo com a extenso DFM armazena uma descrio textual do formulrio.
Para acessar o arquivo unit1.dfm, por exemplo, basta executar os seguintes procedimentos:
1. Selecione o formulrio, clicando sobre este com o boto esquerdo do mouse.
2. Pressione o boto direito do mouse, para exibir o menu pop-up mostrado na Figura 2.14.
Nunca altere o nome do arquivo no qual a unit est armazenada usando as ferramentas disponveis no sistema operacional. Sempre
que precisar alterar o nome do arquivo no qual uma unit est armazenada, use as opes disponveis no ambiente de desenvolvimento
(usando, por exemplo, o item Save as do menu File ou o boto correspondente da barra de ferramentas).
26 00CURSO COMPLETO
Figura 2.14: Exibindo o menu pop-up de um formulrio.
3. Selecione o item View as Text do menu pop-up. Pronto! Ser exibida a descrio textual do
formulrio, como mostra a Figura 2.15.
Figura 2.15: Visualizando a descrio textual de um formulrio.
At a verso 4 do Delphi esse arquivo, que contm a descrio textual do formulrio, era armazenado com uma formatao especial e
no podia ser visualizado em outros editores de texto. Nas ltimas verses, este arquivo passou a ser armazenado, por default, como
um arquivo ASCII, desde que a opo correspondente (Text DFM) esteja selecionada no menu pop-up do formulrio.
27 CURSO COMPLETO00
No caso da CLX, o arquivo Unit1.pas apresenta a seguinte definio:
unit Unit1;
interface
uses
SysUtils, Types, Classes, Variants, QTypes, QGraphics, QControls, QForms,
QDialogs, QStdCtrls;
type
private
public
end;
var
Form1: TForm1;
implementation
{$R *.xfm}
end.
Repare na diferena entre os nomes das units bsicas acessadas pela VCL e pela CLX. Alm disso, a
diretiva de compilao {$R *.xfm} indica que, associado a essa unit, existe um arquivo de mesmo
nome, mas com a extenso xfm (mantenha a extenso em letras minsculas, pois caso voc venha a
recompilar sua aplicao no Kylix, isto faz diferena).
Podemos ento concluir que, em qualquer das bibliotecas de componentes, todo formulrio tem uma
unidade de cdigo associada (um arquivo com a extenso PAS) e possui a sua descrio visual armazenada
em um arquivo com a extenso DFM (no caso da VCL) ou xfm (no caso da CLX) que armazena a sua
descrio textual.
Para retornar situao anterior (representao visual do formulrio), bastando executar os seguintes
procedimentos:
1. Selecione o arquivo com a descrio textual do formulrio.
2. Pressione o boto direito do mouse, para exibir o menu pop-up mostrado na Figura 2.16.
3. Selecione o item View As Form do menu pop-up. Pronto! Ser exibida novamente a representao
visual do formulrio.
Ao fazer o backup de um projeto de aplicao, voc dever copiar:
Os arquivos de cdigo (extenso .pas).
Os arquivos de descrio textual de formulrio (extenso .dfm no caso da VCL ou .xfm no
caso da CLX).
O arquivo de projeto (extenso .dpr).
Alm dos arquivos do banco de dados, se for o caso.
28 00CURSO COMPLETO
Figura 2.16: Exibindo o menu pop-up de um arquivo de formulrio.
INICIANDO UM NOVO PROJETO
Sempre que voc for iniciar o desenvolvimento de uma nova aplicao usando o Delphi 7 como
ferramenta de desenvolvimento, dever iniciar um novo projeto.
recomendvel que o seu projeto e todos os seus arquivos sejam salvos em uma pasta prpria.
Nesta parte do livro, ser desenvolvida uma aplicao para cadastrar os scios de um clube, e suas
respectivas atividades.
Para salvar nosso projeto e seus arquivos, ser criada uma pasta denominada Clube.
Dessa maneira, devemos iniciar um novo projeto, referente a essa nova aplicao.
Para iniciar um novo projeto, execute um dos seguintes procedimentos:
1. Selecione o item New/Application do menu File, para criar uma aplicao baseada na VCL.
Ou:
1. Selecione o item New/CLX Application do menu File, para criar uma aplicao baseada na CLX.
Ou:
1. Selecione o item New/Other do menu File do Delphi 7, para exibir a caixa de dilogo New
Items (Figura 2.17).
Ou:
29 CURSO COMPLETO00
Figura 2.17: A caixa de dilogo New Items do Delphi 7.
1. Selecione o item Application, na pgina New desta caixa de dilogo, para criar uma aplicao
baseada na VCL.
2. Selecione o item CLX Application, na pgina New desta caixa de dilogo, para criar uma aplicao
baseada na CLX.
3. Clique em OK, para fechar a caixa de dilogo.
Ser ento criado um novo projeto chamado Project1, armazenado no arquivo Project1.dpr; um
formulrio denominado Form1, armazenado no arquivo unit1.dfm (no caso da VCL) ou unit1.xfm
(no caso da CLX) e um arquivo de cdigo associado ao formulrio Form1, denominado Unit1.pas.
Esses so os nomes default fornecidos pelo ambiente de desenvolvimento, mas voc deve salvar o seu
projeto e os seus arquivos de cdigo com nomes mais fceis de se memorizar.
Antes de iniciar o desenvolvimento de uma aplicao, voc deve planej-la com cuidado, principalmente no que se refere aos nomes dos
arquivos a serem manipulados pela aplicao. Um arquivo com o cdigo referente ao cadastro de um scio, por exemplo, pode ser
armazenado com o nome UnitCadastroSocio.pas. Repare que o nome de um arquivo deve ser o mais descritivo possvel, de maneira a
facilitar uma futura manuteno do sistema. Se aps iniciar o desenvolvimento da aplicao voc desejar alterar o nome de um arquivo
de cdigo aps referenci-lo em outros arquivos, ser necessrio alterar explicitamente todas as referncias a este arquivo.
SALVANDO O PROJETO RECM-CRIADO
Para salvar um projeto recm-criado, execute um dos seguintes procedimentos:
1. Selecione o item Save Project As do menu File.
Ou:
1. Na caixa de ferramentas, selecione o cone correspondente.
30 00CURSO COMPLETO
Inicialmente ser exibida a caixa de dilogo Save Unit1 As (Figura 2.18), para que sejam definidos o
nome e a pasta da primeira unidade de cdigo do programa (que o ambiente chamou de Unit1). Salve
essa unidade de cdigo com um nome fcil de se memorizar, como UnitPrincipal, por exemplo.
Figura 2.18: Salvando a primeira unidade de cdigo.
Sempre que voc mandar salvar as alteraes de projetos, ser solicitado que voc atribua nomes a todas as units que foram
criadas desde a ltima vez em que o projeto foi salvo, e que ainda no foram renomeadas (isto , ainda esto com o nome
default gerado pelo ambiente).
Aps definir um nome para a primeira unidade de cdigo e fechar a caixa de dilogo Save Unit1 As com
o boto Salvar, ser exibida a caixa de dilogo Save Project1 As (Figura 2.19), para que voc defina o nome
e a pasta do arquivo de projeto. Salve esse projeto com um nome fcil de se memorizar, mas que seja
diferente dos nomes atribudos aos arquivos de cdigo (voc no pode dar o mesmo nome a uma unit e
a um arquivo de projeto). Nesse caso, adotamos o nome Clube, como mostra a figura a seguir.
Figura 2.19: Salvando o arquivo de projeto.
31 CURSO COMPLETO00
FECHANDO UM PROJETO
Ao terminar de executar seu trabalho, voc deve fechar o ambiente de desenvolvimento integrado.
Antes disso, no entanto, voc deve salvar as alteraes realizadas no projeto.
Para salvar todas as alteraes realizadas, basta executar um dos seguintes procedimentos:
1. Selecione o item Save All do menu File.
Ou:
1. Na caixa de ferramentas, selecione o cone correspondente.
Para fechar o projeto, basta executar um dos seguintes procedimentos:
1. Selecione o item Close do menu File.
Ou:
1. Selecione o item Close All do menu File.
Se voc alterar o projeto atual ou um dos arquivos de cdigo e no salv-lo antes de tentar executar os passos anteriores, ser
apresentada uma caixa de dilogo como as das Figuras 2.20 e 2.21, perguntando se as alteraes devem ser salvas. Caso no tenha
sido definido um nome para o projeto e para cada uma das suas unidades de cdigo, tambm sero apresentadas as caixas de dilogo
Save Unit1 As e Save Project1 As, descritas anteriormente.
Figura 2.20: Confirmando se as alteraes
feitas no projeto devem ser salvas.
Figura 2.21: Confirmando se as alteraes
feitas no arquivo devem ser salvas.
32 00CURSO COMPLETO
MANIPULANDO GRUPOS DE PROJETOS
O Delphi 7 permite que voc rena vrios projetos em uma nova entidade, denominada Grupo
de Projeto.
Essa caracterstica muito til quando voc possui vrios projetos inter-relacionados e deseja manipul-
los simultaneamente no ambiente de desenvolvimento.
Para criar um novo grupo de projeto, voc deve executar os seguintes procedimentos:
1. Selecione o item New/Other do menu File do Delphi 7, para exibir a caixa de dilogo New
Items (Figura 2.22).
Figura 2.22: A caixa de dilogo New Items.
2. Selecione o item Project Group, na pgina New desta caixa de dilogo.
3. Clique em OK, para fechar a caixa de dilogo.
Ser exibida a caixa de dilogo Project Manager, mostrada na figura a seguir.
Figura 2.23: A caixa de dilogo Project Manager.
33 CURSO COMPLETO00
Nessa caixa de dilogo voc pode:
Adicionar um novo projeto ao grupo de projetos atual.
Adicionar um projeto existente ao grupo de projetos atual.
Para adicionar um novo projeto ao grupo de projetos atual, voc deve executar os seguintes
procedimentos:
1. Selecionar o boto New na janela do Project Manager.
Ou:
1. Selecionar o boto direito do mouse com o nome do grupo de projetos selecionado, para exibir
o menu pop-up dessa janela.
2. Selecionar o item Add New Project desse menu pop-up, como mostrado na figura a seguir.
Ser exibida a caixa de dilogo New Items, na qual voc deve selecionar o item Application e
o boto OK.
Repare que, aps adicionar um novo projeto, este ser exibido na caixa de dilogo Project Manager,
como indicado na figura a seguir. Repare que o novo projeto (Project1) possui uma unit chamada Unit1,
qual correspondem um arquivo de cdigo (chamado Unit1.pas) e um formulrio (chamado Form1).
Figura 2.24: Adicionando o novo projeto (Project1) ao
grupo de projetos atual.
Para adicionar um projeto existente ao grupo de projetos atual, voc deve executar os seguintes
procedimentos:
2. Selecionar o item Add Existing Project desse menu pop-up, como mostrado na figura a seguir.
Ser exibida a caixa de Open Project, na qual voc dever selecionar o projeto a ser includo no
grupo de projetos atual e o boto Abrir.
34 00CURSO COMPLETO
Figura 2.25: Adicionando um projeto existente ao grupo de projetos atual.
No Delphi 7, voc pode adicionar ou remover unidades de cdigo em um projeto simplesmente arrastando o seu cone a partir do
Windows Explorer para o local adequado na janela do Project Manager.
A figura a seguir apresenta a janela do gerenciador de projetos (Project Manager) aps a incluso de um
novo projeto (Project1.exe) e um projeto existente (Clube.exe).
Figura 2.26: Manipulando vrios projetos com o Project Manager.
Para remover um projeto do grupo de projetos atual, voc deve executar os seguintes procedimentos:
1. Selecionar o projeto que se quer remover na janela do Project Manager.
2. Selecionar o boto Remove na janela do Project Manager.
35 CURSO COMPLETO00
Ou:
1. Selecionar o projeto que se quer remover na janela do Project Manager.
3. Selecionar o item Remove Project desse menu pop-up. Ser exibida a caixa de dilogo de
confirmao mostrada na figura a seguir, na qual voc deve selecionar o boto OK para finalizar
esta tarefa.
Figura 2.28: A janela do Code Explorer, destacada da janela do Editor de Cdigos.
Voc pode ancorar essa janela em qualquer janela do ambiente, como no Object Inspector, por exemplo.
Para isso, basta selecionar a barra horizontal superior da janela do Code Explorer com o boto esquerdo
do mouse, arrast-la e solt-la na janela em que deseja ancor-la.
A figura a seguir mostra a janela do Code Explorer ancorada no Object Inspector.
Figura 2.27: A caixa de dilogo de confirmao.
O CODE EXPLORER
Conforme descrito anteriormente, inicialmente existe outra janela ancorada ao longo da borda esquerda
da janela do Editor de Cdigos. Essa janela (denominada Code Explorer) pode ser destacada do Code
Editor, bastando, para isso, selecionar a barra horizontal situada no topo da janela e arrast-la para
fora da janela do Editor de Cdigos.
A figura a seguir mostra a janela do Code Explorer, aps ser destacada do Editor de Cdigos.
36 00CURSO COMPLETO
Figura 2.29: A janela do Code Explorer, ancorada na janela do Object Inspector.
Conforme descrito anteriormente, a janela do Code Explorer exibe uma rvore hierrquica que mostra
os tipos, classes, propriedades, variveis e rotinas globais, alm dos nomes das units listadas na clusula
Uses da unit corrente.
O Code Explorer permite que se acesse o trecho de cdigo no qual definido um tipo de dado ou
declarada uma funo dando-se um duplo clique com o boto esquerdo do mouse sobre o item desejado
na rvore hierrquica do Code Explorer.
Esse recurso muito til quando se est trabalhando com unidades de cdigo extensas, nas quais se
deseja localizar o trecho de cdigo no qual declarado um tipo, uma varivel, ou implementada uma
funo. Alm disso, a janela do Code Explorer possui o recurso de pesquisa incremental, isto , voc
pode localizar um item, digitando o seu nome quando a janela do Code Explorer possui o foco.
DESABILITANDO O RECURSO DE ANCORAGEM DE JANELAS
Existem situaes em que voc pode preferir mover uma janela pelo ambiente de desenvolvimento
sem que esta possa ser ancorada em alguma outra.
Para desabilitar esse recurso, voc deve executar os seguintes procedimentos:
1. Selecionar a janela para a qual deseja desabilitar esse recurso.
2. Selecionar o boto direito do mouse sobre essa janela, para exibir o seu menu pop-up.
3. Desmarcar o item Dockable desse menu pop-up.
37 CURSO COMPLETO00
GARANTINDO A VISIBILIDADE DE UMA JANELA
Existem situaes em que voc pode preferir manter uma janela permanentemente visvel no ambiente
de desenvolvimento, evitando a sua sobreposio por outras janelas.
Para habilitar esse recurso, voc deve executar os seguintes procedimentos:
1. Selecionar a janela para a qual deseja habilitar esse recurso.
2. Selecionar o boto direito do mouse sobre essa janela, para exibir o seu menu pop-up.
3. Selecionar o item Stay on Top desse menu pop-up, como mostrado na figura a seguir.
Figura 2.30: Selecionando o item Stay on Top do Object Inspector.
38 00CURSO COMPLETO
CAPTULO 3 FUNDAMENTOS DA LINGUAGEM OBJECT PASCAL
39 CURSO COMPLETO00
Captulo
Fundamentos da Linguagem
Object Pascal
3
40 00CURSO COMPLETO
Neste captulo sero examinados o cdigo gerado pelo ambiente de desenvolvimento do Delphi 7, e os
conceitos de variveis, classes e objetos da linguagem Object Pascal a linguagem de programao
empregada pelo ambiente de desenvolvimento do Delphi 7.
Os conceitos apresentados ajudaro a esclarecer algumas dvidas que o leitor ainda possa ter aps a
leitura do captulo anterior.
FUNDAMENTOS EM: ESTRUTURA DE UMA UNIDADE DE CDIGO (UNIT)
PR-REQUISITOS
Noes bsicas da utilizao do ambiente de desenvolvimento do Delphi 7.
METODOLOGIA
Apresentao e descrio dos elementos que compem uma unit.
EXAMINANDO O CDIGO DE UMA UNIDADE DE CDIGO (UNIT) GERADO PELO DELPHI 7
No final do captulo anterior, iniciamos o projeto do aplicativo-exemplo que ser desenvolvido ao
longo desta primeira parte do livro. Por enquanto, a aplicao o projeto Clube consiste em um
nico formulrio e seu arquivo de cdigo associado (que foi salvo com o nome UnitPrincipal.pas).
A seguir, apresentamos os arquivos de cdigo gerados pelo Delphi 7, com os quais trabalharemos ao
longo deste captulo.
Arquivo de cdigo gerado pela VCL:
unit UnitPrincipal;
interface
unit UnitPrincipal;
interface
uses
Dialogs;
type
private
public
end;
var
Form1: TForm1;
implementation
{$R *.dfm}
end.
41 CURSO COMPLETO00
Arquivo de cdigo gerado pela CLX:
unit UnitPrincipal;
interface
uses
type
private
public
end;
var
Form1: TForm1;
implementation
{$R *.xfm}
end.
Inicialmente observa-se a palavra reservada unit seguida do nome do arquivo em que a unit est
armazenada (j discutido no captulo anterior).
Nos prximos tpicos, ser detalhado o significado de cada uma das outras linhas de cdigo,
automaticamente geradas pelo Delphi 7, e sero apresentados os tipos de dados predefinidos da
linguagem Object Pascal.
EXAMINANDO AS SEES DE UMA UNIT
Na linha seguinte que define o nome da unit, tem-se a palavra-chave interface, que, juntamente com
a palavra-chave implementation, define as duas principais sees de uma unit.
Na seo Interface so declarados os tipos de dados, classes, variveis, funes e procedimentos que
podem ser acessados por outras units.
Na seo Implementation so declarados os tipos de dados, classes, variveis, funes e procedimentos
que no podem ser acessados por outras units. Nessa seo tambm so implementadas as funes e
procedimentos cujo cabealho declarado na seo Interface.
Alm dessas duas sees, voc pode incluir, opcionalmente, mais duas, denominadas Initialization e
Finalization. Na seo Initialization so includos comandos de atribuies de valores a variveis, que
devem ser processados assim que a aplicao for inicializada. A seo Finalization, por outro lado,
armazena os comandos que devem ser executados quando a aplicao finalizada (estas duas sees
no so criadas automaticamente pelo Delphi 7).
42 00CURSO COMPLETO
ACESSANDO TIPOS E VARIVEIS DEFINIDOS EM OUTRAS UNITS
Aps a palavra-chave interface, tem-se o seguinte trecho de cdigo:
Numa unit gerada com o uso da VCL:
uses
uses
Dialogs;
Numa unit gerada com o uso da CLX:
uses
A palavra uses outra palavra reservada da linguagem Object Pascal e define as units que sero utilizadas
pela unit corrente. Repare que o ambiente j incluiu diversas units nessa clusula uses. No caso da
VCL, por exemplo, foi includa a unit Windows (na qual esto armazenadas as declaraes das funes
da API do Windows). Se voc remover a unit Windows da clusula uses da unit, no ter mais acesso s
funes da API do Windows.
Voc tambm pode, opcionalmente, incluir uma clusula uses na seo Implementation de uma unit.
Isso evita problemas como referncia circular e impede que as units referenciadas nessa clusula uses
sejam acessadas por outros usurios (lembre-se de que nada que declarado na seo Implementation
pode ser visto por outras unidades de cdigo que usam essa unit).
FUNDAMENTOS EM: DECLARAO DE VARIVEIS
PR-REQUISITOS
METODOLOGIA
Apresentao e descrio dos conceitos de variveis, bem como dos tipos predefinidos da linguagem Object Pascal.
TCNICA
Apresentao dos procedimentos necessrios declarao de variveis e tipos na linguagem Object Pascal.
O CONCEITO DE VARIVEIS
Em um programa de computador, dados so armazenados em variveis. Na linguagem Object Pascal, a
declarao de uma varivel de um determinado tipo feita na seo var de uma unit (ou de uma
funo ou procedure, no caso de se desejar criar uma varivel local, conforme ser visto posteriormente)
e obedece seguinte sintaxe:
var
Nome_varivel: Tipo_da_varivel;
Voc pode declarar simultaneamente mais de uma varivel de um mesmo tipo. Nesse caso, os nomes
das variveis devem vir separados por vrgulas, obedecendo seguinte sintaxe:
43 CURSO COMPLETO00
var
Nome_varivel1, Nome_varivel2,..., Nome_variveln: Tipo_da_varivel;
Nos trechos de cdigo exemplificados anteriormente, a palavra reservada var (que j existe na unit gerada) foi includa apenas para
tornar mais claro o contexto em que uma varivel declarada.
Os nomes das variveis devem comear com uma letra ou um caractere sublinhado (_), seguidos por
uma seqncia de letras, dgitos ou caracteres sublinhados, e no podem conter espaos em branco ou
caracteres especiais como $,%, acentuao e operadores aritmticos.
ATRIBUINDO UM VALOR A UMA VARIVEL
Para atribuir um valor a uma determinada varivel, voc deve usar o comando de atribuio da linguagem
Object Pascal, que apresenta a seguinte sintaxe:
nome_variavel:= valor;
Nesse caso, conforme descrito anteriormente, o sinal de igualdade precedido de dois-pontos
denominado operador de atribuio.
O programador novato no deve estranhar a utilizao da seguinte linha de cdigo:
X := X + 1;
Evidentemente, se nesse caso o sinal de igual estivesse realmente representando a igualdade entre dois
valores, essa equao seria matematicamente absurda.
Entretanto, se considerarmos que, nesse caso, esse sinal est funcionando como um operador de
atribuio, a expresso anterior passa a ter sentido, pois, nesse caso, estamos atribuindo varivel X o
valor armazenado nessa varivel, acrescido de uma unidade. Essa expresso deve ser entendida da
seguinte maneira: Obtenha o valor armazenado na varivel X, acrescente uma unidade a esse valor e
atribua o resultado varivel X.
Conseqentemente, analisando-a como um comando de atribuio, essa expresso passa a ter sentido.
TIPOS DE DADOS PREDEFINIDOS NA LINGUAGEM OBJECT PASCAL
Na linguagem Object Pascal esto definidos os seguintes tipos de dados predefinidos (tipos de variveis):
TIPOS DE VARIVEIS INTEIRAS
Tipo Faixa de Valores Formato
Integer 2147483648..2147483647 32 bits
Cardinal 0..4294967295 32 bits, sem sinal
Shortint 128..127 8 bits
44 00CURSO COMPLETO
TIPOS DE VARIVEIS REAIS
O tipo genrico Real equivalente a double.
TIPOS DE VARIVEIS BOOLEANAS
(*) Esses tipos so definidos apenas por questo de compatibilidade com outras linguagens de programao. Uma varivel booleana pode assumir apenas
os valores ordinais 0 e 1, ao passo que os demais tipos podem assumir quaisquer valores ordinais. Nesses casos, a expresso ser falsa se seu valor ordinal
for 0, e verdadeira quando esse valor for diferente de 0 (como ocorre nas linguagens C e C++).
TIPOS DE VARIVEIS PARA MANIPULAO DE CARACTERES
Na linguagem Object Pascal, caracteres e strings literais so delimitados por aspas simples. Para a
manipulao de textos, compostos de um ou mais caracteres, a linguagem Object Pascal apresenta os
tipos de variveis listados a seguir:
Tipo Faixa de Valores Formato
Smallint 32768..32767 16
Longint 2147483648..2147483647 32
Int64 2^63..2^631 64
Byte 0..255 8 bits, sem sinal
Word 0..65535 16 bits, sem sinal
Longword 0..4294967295 32 bits, sem sinal
Tipo Faixa de Valores Dgitos Significativos Tamanho (Bytes)
Real48 2.9 x 10^39 .. 1.7 x 10^38 1112 6
Single 1.5 x 10^45 .. 3.4 x 10^38 78 4
Double 5.0 x 10^324 .. 1.7 x 10^308 1516 8
Extended 3.6 x 10^4951 .. 1.1 x 10^4932 1920 10
Comp 2^63+1 .. 2^63 1 1920 8
Currency 922337203685477.5808.. 922337203685477.5807 1920 8
Tipo Faixa de Valores
Boolean False ou True (0 ou 1)
ByteBool *
WordBool *
LongBool *
45 CURSO COMPLETO00
Char: Tipo alfanumrico que pode armazenar um caractere ASCII.
AnsiChar: Tipo alfanumrico que pode armazenar um caractere ASCII (8 bits).
WideChar: Tipo alfanumrico que pode armazenar um caractere Unicode (16 bits).
ShortString: Tipo alfanumrico que tem como contedo uma cadeia de at 255 caracteres.
AnsiString: Tipo alfanumrico que tem como contedo uma cadeia ilimitada de caracteres (Char).
WideString: Tipo alfanumrico que tem como contedo uma cadeia ilimitada (na verdade h
um limite, definido pela memria disponvel) de caracteres (WideChar).
A linguagem Object Pascal suporta ainda as strings de terminao nula, cujo trmino indicado pelo
caractere #0 (NULL). Esse tipo de string deve ser utilizado apenas em casos em que for realmente necessrio,
em chamadas das funes que necessitam de parmetros do tipo PChar (ponteiro para caractere) como,
por exemplo, quando se utilizam, no caso de se estar usando a VCL, chamadas a funes da API do
Windows ou funes exportadas por DLLs criadas em outras linguagens para este ambiente.
Voc pode manipular esse tipo de dado criando arrays do tipo Char, AnsiChar e WideChar, nas quais
o caractere NULL ser armazenado na posio que indica o final da string. Outra alternativa consiste
em utilizar as funes de manipulao de string, a serem vistas posteriormente.
TIPOS DE VARIVEIS PARA MANIPULAO DE ARQUIVOS
Para a manipulao de arquivos, a linguagem Object Pascal apresenta a palavra reservada File, que
pode ser usada para criar um tipo a ser utilizado para representar um arquivo.
O tipo File consiste em uma seqncia linear de valores de um determinado tipo (que pode ser qualquer
tipo de varivel, exceto o prprio tipo File), incluindo-se uma classe ou um tipo estruturado definido
pelo programador.
Para criar uma varivel para representar um arquivo destinado a armazenar valores de um determinado
tipo, deve-se incluir uma linha de cdigo com a seguinte sintaxe, na seo var de uma unit (ou de
procedure ou funo, no caso de varivel local):
nome_da_varivel: File of Tipo;
Por exemplo, para criar uma varivel denominada arq_real, para representar um arquivo destinado a
armazenar nmeros reais, deve ser usada a seguinte declarao:
arq_real: File of Real;
Para armazenar texto no formato ASCII, existem os tipos predefinidos Text e TextFile. Os dois so
equivalentes.
Nesse caso, a declarao correspondente seria:
arq_text: TextFile;
Existem funes especficas para manipulao de arquivos, que sero abordadas ainda neste captulo,
aps os tpicos correspondentes s funes e procedimentos.
46 00CURSO COMPLETO
TIPO GENRICO DE VARIVEIS
A linguagem Object Pascal apresenta um tipo genrico de varivel, denominado Variant, e que ser
descrito a seguir.
O tipo Variant pode armazenar qualquer tipo predefinido de varivel durante a execuo do aplicativo.
Esse tipo foi introduzido na verso 2.0 do Borland Delphi, mas apresenta como desvantagens um
maior consumo de memria para armazenar um valor e de tempo para executar uma operao. Deve
ser utilizado quando no se conhece, a priori, o tipo de valor que ser armazenado na varivel.
Cabe a voc, desenvolvedor, considerar as vantagens e desvantagens de se utilizar variveis desse tipo.
COMENTRIOS
Os comentrios constituem pores de texto cuja finalidade documentar o cdigo de um programa,
sendo eventualmente empregado como recurso para a depurao de programas. A linguagem Object
Pascal admite dois tipos de comentrios:
COMENTRIOS DE UMA NICA LINHA
Este tipo de comentrio identificado por duas barras inclinadas. A partir destas duas barras, tudo o
que for escrito na mesma linha ser tratado como um comentrio.
Exemplo:
// isto um comentrio de uma nica linha
COMENTRIOS DE MLTIPLAS LINHAS
A linguagem Object Pascal admite dois tipos de comentrios de mltiplas linhas. A primeira opo
consiste em colocar o texto entre chaves de abertura { e de fechamento }.
Exemplo:
{ isto um comentrio
de mltiplas linhas }
A segunda opo consiste em colocar o texto entre os seguintes identificadores: Parnteses-asterisco
para incio do comentrio e asterisco-parnteses para o seu trmino.
(* isto um comentrio
de mltiplas linhas *)
DEFININDO NOVOS TIPOS DE DADOS
Logo aps a clusula uses da seo Interface de uma unit, aparece a palavra-chave type.
Esse identificador usado para definir novos tipos de dados, conforme ser descrito nos tpicos a seguir.
47 CURSO COMPLETO00
TIPOS DE DADOS ENUMERADOS
Um tipo de dado enumerado consiste em um grupo com um nmero finito de elementos, separados
por vrgulas e inseridos entre um par de parnteses.
Por exemplo, para se criar um tipo de dado enumerado chamado semana, cujos elementos so os dias
da semana, deve-se incluir a seguinte linha de cdigo aps a palavra-chave type:
semana = (Domingo, Segunda, Terca, Quarta, Quinta, Sexta, Sabado);
Esse tipo de dado ainda apresenta uma caracterstica interessante: seus elementos tm uma relao de
ordem, isto , Domingo menor que Segunda, que menor que Tera, e assim por diante.
Podemos, ento, declarar uma varivel denominada dia, do tipo semana, incluindo a sua declarao
aps a palavra-chave var:
var
dia: semana;
Essa varivel pode, portanto, receber qualquer um dos valores definidos no seu tipo, como, por exemplo:
dia:= Quarta;
CONJUNTOS
Um conjunto muito parecido com um tipo de dado enumerado, mas, nesse caso, a ordem dos
elementos no importante. Alm disso, uma varivel de um tipo definido como um conjunto pode
armazenar vrios elementos de um conjunto (podendo inclusive no armazenar qualquer dos elementos
caso em que se obtm um conjunto vazio).
Para criar um tipo de dado como um conjunto, voc deve incluir, aps a palavra reservada type, uma
linha de comando com a seguinte sintaxe:
nome_do_tipo = set of tipo_j_definido;
A palavra reservada set indica que est sendo criado um conjunto baseado em um tipo ordinal j
definido (pode ser um dos tipos fundamentais da linguagem Object Pascal, ou um tipo definido pelo
desenvolvedor).
Por exemplo, para criar um tipo conjunto denominado letras, poderamos considerar o seguinte
trecho de cdigo:
type
letras = set of Char;
Podemos, ento, declarar uma varivel denominada consoante, do tipo letras, incluindo a sua declarao
aps a palavra-chave var, como exemplificado a seguir.
var
consoante: letras;
48 00CURSO COMPLETO
A atribuio de valores a uma varivel definida como um conjunto feita colocando-se os elementos
do conjunto entre colchetes, como mostrado a seguir.
consoante:= [b,c, d, f, g, h, j, l, m, n, p, q, r, s, t, v,
x, z] ;
Para criar um conjunto vazio, basta incluir o seguinte trecho de cdigo:
letras:= [ ];
Voc pode realizar operaes sobre conjuntos, tal qual se faz na matemtica.
Apresentamos, a seguir, as operaes definidas para o tipo Set:
A operao de unio retorna um conjunto cujos elementos esto contidos em qualquer dos operandos.
A operao de diferena retorna um conjunto cujos elementos esto contidos no primeiro operando,
mas no esto presentes no segundo.
A operao de interseo retorna um conjunto cujos elementos esto obrigatoriamente contidos
simultaneamente nos dois operandos.
A operao de subconjunto corresponde ao est contido que aprendemos na matemtica colegial, e
retorna true ou false, conforme o primeiro operando seja ou no um subconjunto do segundo operando,
isto , se todo e qualquer elemento do primeiro operando est presente no segundo.
A operao de superconjunto corresponde ao contm que aprendemos na matemtica colegial, e
retorna true ou false, conforme o primeiro operando seja ou no um superconjunto do segundo
operando, isto , se todo e qualquer elemento do segundo operando est presente no primeiro.
A operao de igualdade retorna true ou false. Retorna true se todo elemento do primeiro operando
estiver presente no segundo e vice-versa, retornando false em caso contrrio.
A operao de desigualdade retorna true ou false. Retorna true se ao menos um elemento do primeiro
operando no estiver presente no segundo e vice-versa, retornando false em caso contrrio.
Operador Significado Exemplo
+ unio Letras1 + Letras2 ou [a, b] + [c, d]
diferena Letras1 Letras2 ou [a, b] [c, d]
* interseo Letras1 * Letras2 ou [a, b] * [a, e]
<= subconjunto Letras1 <= Letras2 ou [a, b] <= [a, d]
>= superconjunto Letras1 >= Letras2 ou [a, b] >= [a, d]
= igualdade Letras1 = Letras2 ou [a, b] = [a, d]
<> desigualdade Letras1 <> Letras2 ou [a, b] <> [a, d]
in pertinncia char in Letras1 ou a in [a, d]
49 CURSO COMPLETO00
O operador in verifica se o elemento representado pelo primeiro operando est presente no conjunto
representado pelo segundo operando, retornando false em caso contrrio.
VARIVEIS COMPOSTAS
A linguagem Object Pascal permite que se definam tipos compostos de variveis, denominados registros,
aos quais pertence um conjunto de variveis de tipos distintos. Isso feito mediante a incluso de um
trecho de cdigo na seo type de uma unit, e que apresenta a seguinte sintaxe:
nome_do_tipo = Record
varivel1: primeiro_tipo;
varivel2: segundo_tipo;
......
variveln: n-zimo_tipo;
end;
As variveis varivel1, varivel2, ..., variveln contidas no registro so denominadas campos do registro.
Podem ser de qualquer tipo, inclusive objetos de classes definidas no ambiente ou pelo prprio
desenvolvedor (a definio de uma classe ser apresentada nos prximos tpicos).
Para declarar uma varivel desse tipo, devemos proceder da mesma forma que faramos se quisssemos
declarar uma varivel de qualquer tipo predefinido, bastando que se inclua, aps a palavra reservada
var, uma linha de cdigo como:
Nome_varivel: nome_do_tipo;
Para acessar um campo de uma varivel composta, devemos usar a chamada notao de ponto, que
pode ser descrita como:
nome_da_variavel.nome_do_campo;
Por exemplo, para criar um tipo de varivel composta chamada materia, poderamos definir o seguinte
trecho de cdigo, aps a palavra reservada type:
materia= Record
Livro_Texto: string;
carga_horaria: integer;
end;
Podemos, ento, declarar uma varivel chamada matematica, do tipo materia, incluindo a sua declarao
aps a palavra reservada var:
var
matematica: materia;
Para atribuir valores aos seus campos, basta incluir as seguintes linhas de cdigo:
matematica.Livro_Texto:= Matematica para Principiantes;
matematica.carga_horaria:= 75;
VETORES (ARRAYS)
Os vetores ou arrays so grupos de variveis com mesmo nome, mas diferenciados por um ndice,
sendo teis para armazenar uma grande quantidade de dados de um mesmo tipo.
50 00CURSO COMPLETO
Para criar um tipo de dado como um vetor, voc deve incluir, aps a palavra reservada type, uma linha
de comando com a seguinte sintaxe:
nome_do_tipo: array[i1..i2] of tipo_da_varivel;
Onde i1 e i2 determinam os valores mnimo e mximo do ndice, respectivamente.
Por exemplo, para criar um tipo chamado letras como um vetor, poderamos definir o seguinte
trecho de cdigo:
type
letras = array[1..23] of Char;
Podemos, ento, declarar uma varivel denominada alfabeto, do tipo letras, incluindo a sua declarao
aps a palavra reservada var, como mostra o trecho de cdigo a seguir.
var
alfabeto: letras;
A atribuio de valores a uma varivel definida como um vetor feita independentemente para cada
um dos seus elementos, indicando-se o seu ndice entre colchetes, como mostramos a seguir.
alfabeto[1]:= a;
alfabeto[2]:= b;
alfabeto[3]:= c;
A linguagem Object Pascal tambm suporta diretamente o conceito de arrays dinmicos (cujas dimenses
podem ser alteradas durante a execuo do aplicativo). A declarao de um array dinmico feita
mediante a incluso de uma linha de cdigo que apresenta a seguinte sintaxe:
var
A : array of integer; // Declara um array unidimensional de inteiros.
B : array of array of real; // Declara um array bidimensional de nmeros reais.
C : array of array of array of char; // Declara um array tridimensional de caracteres.
A simples declarao no aloca memria para o array, o que feito mediante uma chamada ao
procedimento SetLength.
Esse procedimento, declarado na unit System, recebe como parmetros o nome do array e as suas
novas dimenses.
Poderamos, por exemplo, alocar memria para os arrays descritos anteriormente mediante a incluso
do seguinte trecho de cdigo:
SetLength(A,20);
SetLength(B,20,5);
SetLength(C,20,10,15);
importante deixar claro para o leitor que, para arrays dinmicos, o ndice de cada dimenso comea
em 0, e no em 1, como poderia indicar a nossa intuio.
Para atribuir um valor a um elemento do array multidimensional C, deve-se utilizar a seguinte linha
de cdigo:
C[4,3,7]:= k;
51 CURSO COMPLETO00
O procedimento SetLength tambm pode ser usado para definir o nmero de caracteres de uma string
definida como ShortString e para redimensionar um array durante a execuo do aplicativo (nesse
caso, os valores existentes no array so preservados quando sua dimenso aumenta).
Para liberar a memria alocada para um array, existem duas alternativas:
Atribuir o valor nil varivel que representa o array.
Passar o nome da varivel que define o array em uma chamada ao procedimento Finalize
(tambm definido na unit System).
OPERADORES ARITMTICOS
Na linguagem Object Pascal, voc pode realizar operaes aritmticas sobre variveis, e os seguintes
operadores esto disponveis:
Voc pode realizar uma operao aritmtica entre duas variveis e atribuir o resultado a uma terceira
varivel, mediante a incluso de uma linha de cdigo com a seguinte sintaxe:
variavel3:= varivel1 op variavel2;
Onde op um dos operadores aritmticos descritos anteriormente.
importante respeitar a precedncia dos operadores, que pode ser alterada mediante a utilizao de
parnteses. A seguir apresentamos a ordem de precedncia dos diversos operadores:
Operador Significado
* Multiplicao
/ Diviso (entre duas variveis reais)
+ Soma (ou concatenao, no caso de strings)
- Subtrao
div Diviso (entre duas variveis inteiras)
mod Resto da diviso entre duas variveis inteiras
Os operadores + e -, quando aplicados a um nico operando (como operadores unrios, indicando o sinal de um nmero ou varivel),
possuem ordem de precedncia igual a 1.
Operador Ordem de Precedncia
@, not 1
*, /, div, mod, and, shl, shr, as 2
+, , or, xor 3
=, <>, <, >, <=, >=, in, is 4
52 00CURSO COMPLETO
Alguns desses operadores ainda no foram apresentados, e sero vistos ao longo do livro. O operador
@, por exemplo, utilizado para obter o endereo de uma varivel (e que provavelmente ser atribudo
a uma varivel do tipo ponteiro).
Operadores com maior precedncia (os primeiros da tabela) so executados antes dos de menor
precedncia. Operadores com mesma ordem de precedncia em uma expresso so executados da
esquerda para a direita.
A expresso seguinte, por exemplo, resultaria no valor 28:
X := 8 + 5 * 4;
Caso voc queira que a adio seja executada antes da multiplicao, deve incluir parnteses para
alterar a ordem de precedncia, como a seguir (o resultado, nesse caso, seria a atribuio do valor 52
varivel X):
X := (8 + 5) * 4;
TIPOS ORDINAIS
Definem-se como ordinais os tipos de variveis cujos valores tm uma relao de ordem entre si.
Dentre os tipos ordinais podem-se destacar os tipos integer e char, por exemplo.
Entre duas variveis de um mesmo tipo ordinal podem-se estabelecer comparaes do tipo menor que
(<), maior que (>), etc.
Existem funes especficas para os tipos ordinais, que sero abordadas ainda neste captulo, aps os
tpicos correspondentes s funes e procedimentos.
ESCOPO E TEMPO DE VIDA DAS VARIVEIS
Define-se como escopo de uma varivel o conjunto de trechos de cdigo nos quais a varivel visvel
(isto , pode ser acessada).
VARIVEIS LOCAIS
Na linguagem Object Pascal, quando uma varivel for declarada dentro de uma funo ou procedimento,
ela somente ser visvel dentro da prpria rotina (procedimento ou funo), isto , ter escopo local.
Se, em outra funo ou procedimento, voc declarar uma varivel com o mesmo nome, uma no
tomar conhecimento da existncia da outra, no havendo relao alguma entre elas, ou qualquer
tipo de interferncia. Conseqentemente, os dados tratados dentro de um procedimento ou funo
esto protegidos contra intervenes externas.
Quando uma varivel definida em uma funo ou procedimento, diz-se que essa varivel tem o
escopo da funo ou procedimento (a varivel local funo ou procedimento), excetuando-se o
caso em que a varivel definida como um parmetro que passado por referncia (precedido pela
palavra reservada var).
53 CURSO COMPLETO00
A criao de variveis locais a procedimentos ser descrita no tpico correspondente.
VARIVEIS GLOBAIS A UMA UNIDADE DE CDIGO
Existem situaes em que necessrio compartilhar dados entre funes ou procedimentos dentro de
uma mesma unidade de cdigo (unit). Voc precisa, nesse caso, de variveis que sejam acessveis (visveis)
em toda a unidade de cdigo (unit). Essas variveis so ditas globais unit e devem ser declaradas aps
a palavra reservada var na seo Interface da unit (antes da palavra reservada implementation).
Quando voc quiser que uma varivel declarada com o escopo de uma unit seja acessada por outra
unit, essa ltima unit deve incluir o nome da primeira (que contm a declarao da varivel) em sua
clusula uses.
D preferncia s variveis locais em seus programas, que, dessa maneira, ficaro mais estruturados,
legveis e com dados protegidos contra alteraes acidentais.
Precisando compartilhar dados entre sub-rotinas ou procedimentos, d preferncia s variveis com
escopo de uma unit. S permita que uma unit acesse os dados das variveis declaradas em outra
quando isso for estritamente necessrio e lembre-se de que, se existirem duas variveis com o mesmo
nome e escopos diferentes, todas as referncias ao nome da varivel sero referncias varivel
declarada localmente.
CRIAO DE VARIVEIS GLOBAIS A UMA APLICAO
Variveis globais so aquelas que so acessveis (visveis) em todas as units, funes e procedimentos.
Para declarar um conjunto de variveis globais a uma aplicao, proceda da seguinte forma:
1. Crie uma nova unit para a sua aplicao.
2. Inclua o nome dessa unit na clusula uses de todas as outras units.
Pronto! As variveis declaradas na seo Interface dessa unit sero acessadas em todo o cdigo da
aplicao. recomendvel que voc salve essa unit com um nome fcil de ser memorizado, como
global.pas, por exemplo.
O tpico seguinte mostra como adicionar uma unit para armazenar as variveis globais de uma aplicao.
ADICIONANDO UMA NOVA UNIT AO PROJETO PARA ARMAZENAMENTO DE VARIVEIS GLOBAIS
Um projeto de aplicao no composto apenas por formulrios, mas tambm inclui unidades de
cdigo (as units). Quando voc cria um novo formulrio, o ambiente cria automaticamente uma unit
associada a esse formulrio. Nada impede, no entanto, que voc inclua no projeto da sua aplicao
novas unidades de cdigo que sejam independentes de formulrios. Essas unidades de cdigo podem
ser usadas para armazenar tipos especiais de classes, funes, procedimentos e variveis.
No caso da VCL, por exemplo, as units Windows.pas e System.pas definem uma quantidade enorme
de funes e no esto associadas a nenhum formulrio.
54 00CURSO COMPLETO
Para criar uma unit independente, proceda da seguinte forma:
1. Selecione a opo New/Other do menu File do Delphi 7. Ser exibida a caixa de dilogo New
Items (Figura 3.1).
2. Selecione a guia New.
3. Selecione o cone correspondente opo Unit.
4. Clique no boto OK, para fechar a caixa de dilogo. Ser criada uma nova unit (independente
de qualquer formulrio), na qual podem ser definidas as novas classes, funes e procedimentos.
Figura 3.1: A caixa de dilogo New Items do Delphi 7.
FUNDAMENTOS EM: BLOCOS DE COMANDOS,
ESTRUTURAS CONDICIONAIS E DE REPETIO
PR-REQUISITOS
METODOLOGIA
Apresentao e descrio dos elementos de sintaxe necessrios criao dos blocos de comandos e das estruturas condicionais e de repetio.
TCNICA
Apresentao e descrio dos procedimentos necessrios criao dos blocos de comandos e das estruturas condicionais e de repetio da
ALTERANDO O FLUXO DE EXECUO DO PROGRAMA
Desde os primrdios da computao, as estruturas condicionais e de repetio tm sido fundamentais
para que o fluxo dos sistemas possa variar em funo de determinadas condies.
Essas estruturas esto presentes na totalidade das linguagens de programao, e a linguagem Object
Pascal no seria uma exceo.
55 CURSO COMPLETO00
BLOCOS DE COMANDOS
Na linguagem Object Pascal, um bloco de comandos constitudo por um conjunto de linhas de
cdigo, que comea com a palavra reservada begin e termina com a palavra reservada end, seguida de
um ponto-e-vrgula (;).
Um bloco de comandos definido pela sintaxe:
begin
{Instrues do Bloco de comandos}
end;
A palavra reservada end s no deve ser seguida por um ponto-e-vrgula nas seguintes situaes:
Antes da palavra reservada else, em uma estrutura condicional do tipo if-then-else (a ser abordada
nos prximos tpicos).
No final de uma unit (o end que encerra uma unit seguido por um ponto).
ESTRUTURAS CONDICIONAIS
Existem situaes em que se deseja executar um trecho de cdigo, apenas se uma determinada condio
for verdadeira, e um outro trecho de cdigo, caso a condio testada seja falsa.
Na linguagem Object Pascal, isso obtido utilizando-se as estruturas condicionais if-then-else e case
of, descritas a seguir.
ESTRUTURA CONDICIONAL IF-THEN-ELSE
A estrutura condicional if-then-else da linguagem Object Pascal apresenta a seguinte sintaxe:
if (condio)
then
begin
{Bloco de comandos executados se a condio for verdadeira}
end
else
begin
{Bloco de comandos executados se a condio for falsa}
end;
Caso voc no queira executar qualquer comando se a condio for falsa, basta suprimir o trecho de
cdigo correspondente clusula else, como mostrado no trecho de cdigo a seguir.
if (condio)
then
begin
{Bloco de comandos executados se a condio for verdadeira}
end;
Nunca coloque um ponto-e-vrgula antes da palavra reservada else. Isso gerar um erro de compilao.
56 00CURSO COMPLETO
Nos casos em que um bloco de comando formado por uma nica linha de cdigo, podem-se suprimir
as palavras begin e end, como mostram os trechos de cdigo a seguir.
if (condio)
then
{Comando executado se a condio for verdadeira}
else
{Comando executado se a condio for falsa};
e:
if (condio)
then
{Comandos executados se a condio for verdadeira}
ESTRUTURA CONDICIONAL CASE OF
A estrutura condicional case of da linguagem Object Pascal tem a seguinte sintaxe:
case <expresso> of
Valor_1:
<Bloco de comandos>
Valor_2:
<Bloco de comandos>
...........................
Valor_n:
<Bloco de comandos>
else:
<Bloco de comandos>
end;
Nesse caso, se a expresso testada for igual a um dos valores especificados (Valor_1, Valor_2,..., Valor_n),
ser executado o bloco de comandos a ele correspondente. Caso nenhum desses valores seja igual ao
definido pela expresso testada, o bloco de comandos correspondente palavra reservada else ser executado.
A expresso avaliada em uma estrutura condicional case of deve ser de um tipo ordinal.
TESTES CONDICIONAIS
Nos tpicos anteriores foram apresentadas as estruturas condicionais da linguagem Object Pascal.
Nessas estruturas, a condio a ser testada deve retornar o valor False (falso) ou True (verdadeiro).
Quando a condio a ser testada uma varivel booleana, a sua verificao imediata.
Existem situaes, no entanto, em que o resultado da condio advm de uma relao entre dois
operandos. Quando for esse o caso, devem-se usar os operadores relacionais da linguagem Object
Pascal, mostrados nos tpicos a seguir.
OS OPERADORES RELACIONAIS
A linguagem Object Pascal tem os seguintes operadores relacionais:
57 CURSO COMPLETO00
O trecho de cdigo a seguir, por exemplo, compara o valor de duas variveis e exibe uma mensagem
em funo do resultado obtido.
if (a < b)
then
Showmessage(a menor que b)
else
Showmessage(a maior ou igual a b);
ESTRUTURAS DE REPETIO
Quando um mesmo tipo de comando (ou bloco de comandos) precisa ser executado repetidamente, pode-
se economizar a sua codificao usando-se uma das estruturas de repetio da linguagem Object Pascal.
A linguagem Object Pascal tem os seguintes tipos de estruturas de repetio:
Laos For
Laos While
Laos Repeat
LAOS FOR
Essa estrutura de repetio bastante til quando se deseja que a execuo de um bloco de comandos
seja repetida um nmero predeterminado de vezes. Essa estrutura apresenta a seguinte sintaxe:
for contador:= valor_inicial to valor_final do
<bloco de comandos>
Onde:
contador: uma varivel ordinal enumervel, normalmente inteira.
valor_inicial: o valor inicial do contador, geralmente um nmero inteiro.
valor_final: o valor final assumido pelo contador, geralmente um nmero inteiro.
bloco de comandos: uma seqncia de comandos que comea com a palavra reservada begin
e termina com a palavra reservada end.
Operador Finalidade
= (igual): Usado para testar se dois valores so iguais.
<> (diferente): Usado para testar se dois valores so diferentes.
< (menor): Usado para testar se um valor menor do que outro.
<= (menor ou igual): Usado para testar se um valor menor ou igual a outro.
> (maior): Usado para testar se um valor maior do que outro.
>= (maior ou igual): Usado para testar se um valor maior ou igual a outro.
in (pertinncia): Verifica se um valor pertence ou no a um conjunto.
58 00CURSO COMPLETO
Desse modo, a varivel inteira contador varia desde o valor inicial at o valor final, em incrementos
unitrios e, para cada incremento, executa o bloco de comandos que se inicia na linha seguinte.
Caso se queira que o contador assuma valores decrescentes, deve-se usar a seguinte sintaxe:
for contador:= valor_inicial downto valor_final do
<bloco de comandos>
Nesse caso, evidentemente, o valor inicial deve ser superior ao valor final.
O contador pode ser qualquer tipo ordinal enumervel. O cdigo abaixo, por exemplo, perfeitamente
vlido (embora possa no ser muito til).
for contador:= a to z do
Showmessage(contador);
A varivel contador, nesse caso, deve ser declarada como sendo do tipo char.
LAOS WHILE
Essa estrutura de repetio bastante til quando se deseja que a execuo de um bloco de comandos
seja repetida enquanto uma determinada condio for verdadeira.
Essa estrutura de repetio apresenta a seguinte sintaxe:
while <condio> do
<bloco de comandos>
Observe que, se a condio for falsa na primeira vez em que a estrutura de repetio for acessada, o
bloco de comandos no ser executado nenhuma vez.
Essa estrutura de repetio muito til quando se quer, por exemplo, ler as informaes a partir de um
arquivo, pois, nesse caso, no se sabe previamente quantas iteraes sero necessrias para ler todo o
seu contedo. O seguinte trecho de cdigo pode ser usado:
while not Eof(F1) do
begin
Read(F1, Ch);
Write(F2, Ch);
end;
Onde F1 e F2 so variveis de arquivo e Eof uma funo que retorna o valor True, se for alcanado o
final do arquivo, e False, em caso contrrio. Portanto, enquanto houver registros a serem lidos no
arquivo, isto , enquanto a condio Eof(F1) for falsa (e not Eof(F1) for verdadeira), o bloco de cdigo
ser executado, lendo dados de F1 e gravando-os em F2.
LAOS REPEAT
Essa estrutura de repetio bastante til quando se pretende que a execuo de um bloco de comandos
seja repetida enquanto uma determinada condio for verdadeira, mas se impe que esse bloco de
comandos seja executado ao menos uma vez. Nesse caso, ao contrrio do que ocorre nos laos While,
59 CURSO COMPLETO00
a condio testada aps a primeira execuo do bloco de comandos, garantindo que ele seja executado
ao menos uma vez.
Essa estrutura de repetio apresenta a seguinte sintaxe:
repeat
<bloco de comandos>
until condio;
CONDIES COMPOSTAS
Existem situaes em que uma condio a ser testada , na realidade, uma combinao de duas ou
mais condies.
Normalmente, uma condio composta testada usando-se os operadores lgicos da linguagem Ob-
ject Pascal, apresentados no prximo tpico.
OPERADORES LGICOS DA LINGUAGEM OBJECT PASCAL
A linguagem Object Pascal tem os seguintes operadores lgicos:
A tabela a seguir mostra o resultado de expresses em que so usados os operadores lgicos.
FUNDAMENTOS EM: FUNES E PROCEDIMENTOS
PR-REQUISITOS
Noes bsicas da utilizao dos ambientes de desenvolvimento do Delphi 7.
METODOLOGIA
Apresentao e descrio dos conceitos e elementos de sintaxe necessrios criao dos procedimentos e funes.
Operador Significado
not Negao
and e lgico
or ou lgico
xor ou lgico exclusivo
Operando A Operando B not A A and B A or B A xor B
True True False True True False
True False False False True True
False True True False True True
False False True False False False
60 00CURSO COMPLETO
TCNICA
Apresentao e descrio dos procedimentos necessrios criao de procedimentos e funes na linguagem Object Pascal.
A ESTRATGIA DE DIVIDIR PARA CONQUISTAR
O conceito de procedimentos e funes advm da necessidade de se subdividir um sistema complexo
em unidades menores, denominadas sub-rotinas (denominao genrica dada aos procedimentos
e funes).
Essa estratgia, popularmente conhecida como dividir para conquistar, facilita a manuteno de um
sistema e a reutilizao de cdigo em diversos aplicativos.
Nos prximos tpicos sero apresentados os procedimentos necessrios definio dos procedimentos
e funes na linguagem Object Pascal.
PROCEDIMENTOS (PROCEDURES)
Normalmente, os procedimentos so usados para dividir um programa em blocos menores de cdigo
e para armazenar trechos de cdigo utilizados diversas vezes no programa (em vez de se digitar o
mesmo trecho de cdigo em cada ponto do programa no qual a sua presena se faz necessria, basta
que se inclua uma chamada ao procedimento).
Normalmente, o cabealho de um procedimento composto pela palavra reservada procedure, seguida
do nome do procedimento, uma lista de parmetros e um ponto-e-vrgula.
A definio de um procedimento na linguagem Object Pascal obedece seguinte sintaxe:
procedure nome_do_procedimento (parmetro_1: tipo_1, ,...,parmetro_n: tipo_n)
var
{declarao de variveis locais ao procedimento}
begin
{Corpo do procedimento}
end;
A palavra reservada var indica o incio do trecho de cdigo em que so declaradas as variveis locais ao
procedimento. A declarao de variveis locais termina na linha anterior da palavra reservada begin,
que inicia o corpo do procedimento propriamente dito, e que termina com a palavra reservada end,
seguida de um ponto-e-vrgula.
Um exemplo de procedure muito utilizada no Delphi 7, quando se quer exibir uma mensagem simples
para o usurio, a procedure ShowMessage, cuja declarao mostrada a seguir.
procedure ShowMessage(const Msg: string);
Essa procedure tem como nico parmetro uma string a ser exibida em uma caixa de dilogo. Para
exibir a mensagem Al pessoal, basta incluir a seguinte linha de cdigo:
Showmessage(Delphi 7);
A mensagem ser exibida em uma caixa de dilogo simples, como mostra a figura a seguir.
61 CURSO COMPLETO00
Figura 3.2: Exibindo uma mensagem com a procedure ShowMessage.
O quadro de dilogo gerado pela procedure Showmessage exibe, na sua barra de ttulos, o nome do
aplicativo, alm de um boto com o texto OK, usado para fechar a caixa de dilogo. Esse exemplo foi
elaborado com um novo projeto, inicialmente denominado Project1.
FUNES
Na linguagem Object Pascal, uma funo muito semelhante a um procedimento, com a diferena
de que a chamada a uma funo deve retornar um valor como resultado, e este pode ser atribudo a
uma varivel. Alm disso, o resultado de uma chamada a funo pode ser diretamente incorporado
a uma expresso aritmtica.
Normalmente, o cabealho de uma funo composto pela palavra reservada function, seguida pelo nome
da funo, uma lista de parmetros, um sinal de dois-pontos, do tipo de retorno e um ponto-e-vrgula.
A definio de uma funo na linguagem Object Pascal obedece seguinte sintaxe:
function nome_da_funo (parmetro_1:tipo_1;...;parmetro_n:tipo_n): tipo_de_retorno;
var
{declarao de variveis locais funo}
begin
{Corpo da funo}
result:= valor;
end;
A palavra reservada var indica o incio do trecho de cdigo em que so declaradas as variveis locais
funo. A declarao de variveis termina na linha anterior da palavra reservada begin. A palavra
reservada begin inicia o corpo da funo propriamente dita, que termina com a palavra reservada end,
seguida de um ponto-e-vrgula.
O valor a ser retornado deve ser atribudo a result (uma varivel interna criada automaticamente pelo
ambiente) ou ao prprio nome da funo, como indicado.
Um grupo de funes bastante til no Delphi 7 o das funes que permitem a converso de tipos.
Por exemplo, para converter um nmero real em uma string, deve ser utilizada a funo FloatToStr,
que tem o seguinte cabealho:
function FloatToStr(Value: Extended): string;
Como voc pode observar, essa funo recebe um parmetro do tipo Extended e retorna uma string.
62 00CURSO COMPLETO
Para converter uma string em um nmero real, deve ser utilizada a funo StrToFloat, que tem o
seguinte cabealho:
function StrToFloat(const S: string): Extended;
Nesse caso, a funo recebe um parmetro do tipo string e retorna um nmero real.
Tanto para procedimentos como para funes, a clusula var s deve ser includa se voc realmente declarar uma varivel local
funo. Caso no se declare nenhuma varivel local, a clusula var deve ser omitida, ou dar origem a um erro de compilao.
FUNES E PROCEDIMENTOS PARA MANIPULAO DE ARQUIVOS REPRESENTADOS POR VARIVEIS
A relao a seguir apresenta as principais funes para manipulao de arquivos representados por
uma varivel:
Append (var F): Abre o arquivo representado pela varivel F, apenas para escrita no final do arquivo.
AssignFile(var F; FileName: string): Associa varivel F o arquivo cujo nome passado como
segundo parmetro.
CloseFile (var F): Fecha o arquivo representado pela varivel F.
EOF (var F): Retorna True, se o arquivo representado pela varivel F est posicionado no seu
final, e False, em caso contrrio.
Erase (var F): Apaga o arquivo representado pela varivel F.
FileSize (var F): Retorna o tamanho, em bytes, do arquivo representado pela varivel F.
Read (F, V1 [, V2, ..., Vn]): L elementos de dados em um arquivo representado pela varivel F
e os armazena nas variveis v1, v2, ..., vn.
Readln ([var F: Text;] V1 [, V2, ..., Vn]): L elementos de dados em uma linha de um arquivo de
texto representado pela varivel F e os armazena nas variveis v1, v2, ..., vn. Caso no sejam
fornecidos parmetros, o arquivo passa para a linha seguinte.
Rename (var F; NewName): Renomeia como NewName o arquivo representado pela varivel F.
Reset (var F [: File; RecSize: Word]): Esse procedimento abre o arquivo representado pela varivel
F. O parmetro RecSize opcional e especifica o tamanho do registro usado na transferncia de
dados. Se for omitido, o valor default 128 usado. Se o arquivo no existir, ocorrer um erro no
processamento. Se o arquivo j estiver aberto, ele fechado e reaberto, sendo posicionado no
seu incio. Se F representar um arquivo de texto, ele aberto apenas para leitura.
Rewrite (var F [: File; RecSize: Word]): Esse procedimento cria o arquivo representado pela
varivel. Se o arquivo j existir, seu contedo ser apagado, mesmo que j esteja aberto.
Write (F, V1 [, V2,..., Vn]): Escreve, em um arquivo representado pela varivel F, elementos de
dados armazenados nas variveis v1, v2, ..., vn.
Writeln ([var F: Text;] V1 [, V2, ..., Vn]): Escreve, em uma linha de um arquivo de texto
representado pela varivel F, elementos de dados armazenados nas variveis v1, v2, ..., vn.
63 CURSO COMPLETO00
Caso no sejam fornecidos parmetros, o arquivo escreve uma linha em branco e passa para a
linha seguinte.
FUNES E PROCEDIMENTOS PARA MANIPULAO DIRETA DE ARQUIVOS
A relao a seguir apresenta as principais funes para manipulao direta de arquivos (no associados
a uma varivel):
ChangeFileExt (const FileName, Extension: string): Muda para Extension a extenso do arquivo
cujo nome e/ou path completo so definidos pela string FileName.
DeleteFile (const FileName: string): Apaga o arquivo cujo nome e/ou path completo so definidos
pela string FileName. Retorna False, se o arquivo no existe, e True, em caso contrrio.
ExpandFileName (const FileName: string): Retorna em uma string o path completo e o nome
do arquivo definido pela string FileName.
ExtractFileDir (const FileName: string): Retorna em uma string o diretrio do arquivo cujo
nome e/ou path completo so definidos pela string FileName.
ExtractFileDrive (const FileName: string): Retorna em uma string o drive do arquivo cujo nome
e/ou path completo so definidos pela string FileName.
ExtractFileExt (const FileName: string): Retorna em uma string a extenso do arquivo cujo
nome e/ou path completo so definidos pela string FileName.
ExtractFileName (const FileName: string): Retorna em uma string apenas o nome do arquivo
cujo nome e/ou path completo so definidos pela string FileName.
ExtractFilePath (const FileName: string): Retorna em uma string apenas o path completo do
arquivo cujo nome e/ou path completo so definidos pela string FileName.
FileExists (const FileName: string): Retorna True, se o arquivo cujo nome e/ou path completo
so definidos pela string FileName existe, e False, em caso contrrio.
FileSearch (const Name, DirList: string): Pesquisa, pelos diretrios definidos no parmetro DirList,
um arquivo cujo nome definido pela string Name. O parmetro DirList uma string em que
os diretrios de pesquisa devem ser separados por vrgulas. Se o arquivo for encontrado, a
funo retorna o path completo do arquivo.
RenameFile (const OldName, NewName: string): Renomeia para NewName o arquivo cujo
nome definido pela string OldName, retornando True, se a operao realizada com sucesso,
e False, em caso contrrio.
FUNDAMENTOS EM: CLASSES E OBJETOS
PR-REQUISITOS
METODOLOGIA
Apresentao e descrio dos conceitos de classes e objetos.
64 00CURSO COMPLETO
TCNICA
Apresentao e descrio dos procedimentos necessrios criao de classes e objetos na linguagem Object Pascal.
UMA NOVA (MAS J NO TO NOVA) ABORDAGEM
As tcnicas de programao orientada a objetos so a ltima palavra em programao, mudando a
forma de concepo de um sistema.
A programao orientada a objetos permite que um sistema seja subdividido em entidades denominadas
objetos, capazes de representar um sistema de uma forma muito semelhante quela pela qual encaramos
o mundo ao nosso redor.
Como essa tecnologia se baseia no conceito de classes e objetos, os prximos tpicos apresentam os
procedimentos necessrios sua implementao na linguagem Object Pascal.
AS CLASSES E OS OBJETOS
A linguagem Object Pascal uma linguagem de programao orientada a objetos. A expresso POO
(Programao Orientada a Objetos) tem tirado o sono de muitos programadores iniciantes,
principalmente quando estes resolvem aprender programao orientada a objetos em textos que
abordam o tema sob um aspecto bastante filosfico (e pouco didtico).
Como este livro se destina a ensinar ao leitor como desenvolver aplicativos utilizando o Delphi 7
como ferramenta de desenvolvimento, e como foge aos nossos objetivos escrever um tratado sobre
POO, nos prximos tpicos procuraremos abordar de maneira didtica e sucinta apenas os conceitos
bsicos da POO necessrios ao entendimento dos exemplos apresentados ao longo desta primeira
parte do livro.
Na segunda parte do livro, abordaremos mais detalhadamente as tcnicas de programao orientada
a objetos.
O CONCEITO DE CLASSES
Nos tpicos anteriores, mostramos como criar uma varivel composta em Object Pascal. Como voc
deve se lembrar, uma varivel composta tem diversos campos, que podem ser de qualquer tipo
predefinido da linguagem ou previamente criados pelo programador.
Naquele tpico, vimos que, para criar um tipo de varivel composta denominada materia, com os
campos Livro_Texto e carga_horaria, bastava incluir o seguinte trecho de cdigo na seo type da unit:
materia= Record
end;
Vimos tambm que, para declarar uma varivel denominada matematica, do tipo materia, bastava
incluir a sua declarao aps a palavra reservada var:
65 CURSO COMPLETO00
var
Uma classe, por sua vez, tem muitas semelhanas com uma varivel composta, pois uma classe tambm
pode ter diversos campos. A definio de um tipo de classe pode ser feita de forma bastante semelhante
de um tipo de varivel composta, bastando que se substitua a palavra reservada Record por Class.
Dessa maneira, se quisssemos criar uma classe denominada materia em vez de um tipo composto
chamado materia, bastaria incluir o seguinte trecho de cdigo aps a palavra reservada type:
materia= Class
end;
Agora teramos uma classe denominada materia, em vez de um tipo de varivel composta chamada
materia.
Podemos, ento, declarar um objeto denominado matematica, da classe materia, incluindo a sua
declarao aps a palavra reservada var:
var
Repare que, at o presente momento, pouca coisa mudou. A diferena bsica que anteriormente
crivamos um tipo de varivel e declarvamos uma varivel daquele tipo. Agora criamos uma
determinada classe e declaramos um objeto daquela classe.
Podemos, ento, concluir que uma classe est para um tipo de varivel assim como um objeto de uma
determinada classe est para uma varivel de determinado tipo! (os puristas da POO dizem que um
objeto uma instncia de uma classe).
Para acessar os campos de um objeto da classe, basta que se utilize a notao de ponto, descrita
anteriormente para as variveis compostas.
Para atribuir valores aos campos do objeto matematica (da classe materia), basta incluir as seguintes
linhas de cdigo:
matematica.Livro_Texto:= Matematica para Principiantes;
matematica.carga_horaria:= 75;
Alguns puristas da POO preferem dizer que um objeto uma instncia de uma classe. Na minha opinio, o importante que voc
entenda o conceito de classes e objetos, razo pela qual no estou me atendo rigorosamente aos termos tcnicos da Programao
Orientada a Objetos.
MTODOS DE UMA CLASSE
No tpico anterior, vimos as semelhanas existentes entre tipos de variveis compostas e classes, e
transformamos a varivel composta materia em uma classe.
66 00CURSO COMPLETO
Por enquanto voc no deve ter percebido qualquer vantagem na utilizao de classes, pois tudo o que
fizemos com classes at o momento poderia ser feito com uma varivel composta.
Neste tpico, com a apresentao do conceito de criao de mtodos, essas vantagens comearo a
aparecer.
Suponha que se queira criar uma funo capaz de obter a carga horria semanal de uma matria, uma
vez conhecida a sua carga horria total.
Poderamos, a princpio, criar uma funo que recebesse como argumentos a carga horria total da
matria e o nmero de semanas de aula, retornando como resposta o valor da carga horria semanal.
Essa funo poderia ser definida como mostra o trecho de cdigo a seguir:
function carga_semanal (disciplina: materia; semanas: integer): integer;
begin
result:= (disciplina.carga_horaria div semanas);
end;
A funo anterior deve ser implementada na seo Implementation de uma unit, sendo apenas o seu
cabealho reproduzido na funo interface, pelas razes expostas no prximo pargrafo.
Caso se queira que outras unidades de cdigo (units) que incluem o nome da unit na qual essa funo
foi definida em sua clusula uses possam utilizar essa funo, o cabealho da funo deve ser definido
na seo Interface da sua unit.
Essa funo precisa de dois parmetros: um objeto da classe matria e um nmero inteiro, que
representa o nmero de semanas de um perodo letivo. Como resultado, a funo retorna a carga
horria semanal, obtida dividindo-se a carga horria total (que um campo do objeto) pelo nmero
de semanas do perodo letivo.
Repare que a funo foi definida externamente classe e que um objeto da classe um dos parmetros
da funo.
Que tal se essa funo fizesse parte da nossa classe? aqui que comeam as diferenas entre uma classe
e uma varivel composta.
Para que a funo anterior faa parte da classe, basta defini-la (ou declar-la) na prpria definio da
classe, como mostra o trecho de cdigo a seguir:
type
materia= Class
function carga_semanal (disciplina: materia; semanas: integer): integer;
end;
A implementao da funo, no entanto, deve ser feita fora da classe, na seo Implementation da
unit, como mostra o trecho de cdigo a seguir (correspondente a uma unit do Delphi 7):
implementation
{$R *.DFM}
67 CURSO COMPLETO00
function materia.carga_semanal (disciplina: materia; semanas: integer): integer;
begin
result:= (disciplina.carga_horaria div semanas);
end;
Repare, contudo, que agora o nome da funo precedido pelo nome da classe, indicando que essa
funo pertence classe, isto , a funo um mtodo da classe.
Mas as coisas podem ficar ainda melhores! Como a funo agora um mtodo da classe, ela enxerga os
campos da classe. Dessa maneira, no h mais a necessidade de se passar um objeto da classe como
parmetro da funo, e esse mtodo pode ser redefinido como mostrado nos trechos de cdigo a seguir:
type
materia= Class
function carga_semanal (semanas: integer): integer;
end;
..........................................
implementation
{$R *.DFM}
f
unction materia.carga_semanal (semanas: integer): integer;
begin
result:= (carga_horaria div semanas);
end;
A est mais uma vantagem de se empregar um mtodo! Ao contrrio das funes externas classe, um
mtodo conhece e pode acessar todos os campos da classe.
Para executar um mtodo de uma classe, basta chamar o nome do mtodo usando-se a mesma notao
de ponto utilizada para acessar os campos da classe (devendo, no entanto, incluir os parmetros
necessrios chamada do mtodo), como mostra o trecho de cdigo a seguir:
var
horas_por_semana: integer;
.............................................
horas_por_semana:= matematica.carga_semanal(15);
MTODOS SEM PARMETROS
Ao longo do livro, voc ver algumas chamadas a mtodos que no tm parmetros. Isso ocorre quando
todos os valores a serem manipulados pelo mtodo so campos da classe, e no h necessidade de se
passar qualquer parmetro para o mtodo.
No exemplo descrito nos tpicos anteriores, se horas_por_semana e semanas fossem campos da classe,
esse mtodo no precisaria de parmetros, como mostra o trecho de cdigo a seguir:
type
materia= Class
carga_horaria, horas_por_semana, semanas: integer;
68 00CURSO COMPLETO
function carga_semanal: integer;
end;
..........................................
implementation
{$R *.DFM}
function materia.carga_semanal: integer;
begin
horas_por_semana:= (carga_horaria div semanas);
end;
Nesse caso, para executar o mtodo, basta que se inclua a seguinte linha de cdigo (neste caso, nenhum
parmetro necessrio na chamada do mtodo):
matematica.carga_semanal;
Onde, como descrito nos tpicos anteriores, matematica um objeto da classe materia.
Entretanto, nos casos em que uma funo no precisa retornar um valor, mais conveniente que se
defina o mtodo como uma procedure em vez de uma funo.
Dessa maneira, poderamos redefinir o mtodo como mostra o trecho de cdigo a seguir:
type
materia= Class
procedure carga_semanal;
end;
..........................................
implementation
{$R *.DFM}
procedure materia.carga_semanal: integer;
begin
horas_por_semana:= (carga_horaria div semanas);
end;
Embora nesse caso o uso de uma funo no gere um erro de compilao, a utilizao de uma procedure evita que o Delphi 7 exiba a
mensagem de advertncia Return value of function materia.carga_horaria might be undefined.
O OBJETO FORMULRIO E A CLASSE TFORM
Examinando novamente o cdigo gerado pelo Delphi 7, notamos a seguinte declarao de classe no
arquivo UnitPrincipal.pas:
type
private
public
end;
69 CURSO COMPLETO00
Fazendo uma analogia com a definio da classe materia analisada nos tpicos anteriores, observa-se
que esse trecho de cdigo corresponde declarao de uma nova classe, chamada TForm1.
A diferena que, aps a palavra reservada class, aparece entre parnteses a palavra TForm. Mas o que
significa isso? Isso tem a ver com o conceito de herana, tambm muito importante na programao
orientada a objetos. Esse conceito, bastante importante, ser discutido nos prximos tpicos, junto
com o significado das palavras reservadas private e public.
Bom, por enquanto vamos nos concentrar apenas no fato de que TForm1 uma nova classe. Se
continuarmos a examinar o cdigo gerado pelo Delphi 7, veremos ainda a seguinte declarao, na
seo var da unit:
var
Form1: TForm1;
Como voc j deve ter percebido, essa declarao indica que Form1 um objeto da classe TForm1.
Esse objeto nada mais nada menos que o formulrio criado automaticamente pelo Delphi 7, e do
qual voc j tomou conhecimento desde o incio do segundo captulo.
Mas o que TForm? TForm uma classe, definida na unit Forms (no caso da VCL) ou Qforms (no caso
do CLX), e que representa um formulrio vazio (sem nenhum controle ou componente).
Ento voc deve estar se perguntando: no seria mais fcil trabalhar com a classe TForm, em vez de
criar uma nova classe, chamada TForm1?
Bem, a resposta seria positiva se voc quisesse trabalhar com um formulrio vazio. Acontece que esse,
provavelmente, no o seu caso; afinal de contas, para que serve um formulrio (janela) vazio?
No prximo tpico abordaremos o conceito de herana de classes, e acredito que as coisas comearo
a ficar mais claras.
O CONCEITO DE HERANA DE CLASSES
Um dos conceitos mais importantes da programao orientada a objetos o de herana de classes. Por
meio da herana, podemos criar uma nova classe baseada em uma classe j existente. Quando uma classe
derivada de uma j existente, diz-se que essa nova classe herda os campos e mtodos de uma classe-base.
Dessa maneira, a forma mais genrica de declarao de uma classe obedece sintaxe abaixo:
nome_da_classe = class(nome_da_classe_base)
private
{ Campos e mtodos privados}
public
{ Campos e mtodos public
end;
Mas voc deve estar se perguntando: qual a classe-base da classe materia, definida nos tpicos
anteriores?
A resposta a seguinte: a linguagem Object Pascal possui uma classe, denominada TObject, que a
me de todas as classes. Por esta razo, quando voc deriva uma classe diretamente de TObject, no
70 00CURSO COMPLETO
precisa declarar explicitamente a classe-base, pois o ambiente do Delphi 7 assume a classe TObject
como a classe-base default.
Desse modo, as declaraes de classe a seguir so equivalentes:
materia= Class
end;
Ou:
materia= Class(TObject)
end;
Podemos ento concluir que, ao se criar uma nova classe sem especificar uma classe-base, estamos na
realidade criando uma classe derivada de TObject.
No caso anterior, o Delphi 7 criou uma nova classe chamada TForm1, derivada de TForm. A razo de se
criar uma nova classe que, como ser visto posteriormente, medida que inserirmos componentes e
controles em nosso formulrio, esses objetos passaro a ser um campo da nova classe (um campo pode
ser qualquer tipo j definido, inclusive um objeto de uma outra classe).
Nos tpicos a seguir, sero apresentados os tipos de mtodos e campos de uma classe.
TIPOS DE MTODOS E CAMPOS
Na linguagem Object Pascal, uma classe pode ter os seguintes tipos de mtodos e campos:
Pblicos (public).
Privados (private).
Protegidos (protected).
Alm dos campos dos tipos citados anteriormente, existem ainda os tipos published e automated. O
tipo published semelhante ao tipo public, mas seu valor pode ser visualizado no Object Inspector (e
ser visto em maiores detalhes no captulo referente criao de componentes). O tipo automated
tambm tem as mesmas regras de visibilidade do tipo public e geralmente usado em classes derivadas
da classe TAutoObject (definida na unit OleAuto).
MTODOS E CAMPOS PBLICOS
Os mtodos e campos pblicos de uma classe so definidos aps a palavra reservada public e podem ser
acessados em qualquer ponto de um programa.
Na linguagem Object Pascal, os campos de uma classe so public por default (isto , se nada for
especificado, o campo ser considerado public).
71 CURSO COMPLETO00
MTODOS E CAMPOS PRIVADOS
Os mtodos e campos privados de uma classe so definidos aps a palavra reservada private e s podem
ser acessados na unit em que a classe foi definida.
MTODOS E CAMPOS PROTEGIDOS
Os mtodos e campos protegidos de uma classe so definidos aps a palavra reservada protected e s
podem ser acessados na unit em que a classe foi definida ou, em outra unit, pelas classes dela derivadas.
Ao longo do livro, ao lidarmos com controles e componentes, usaremos eventualmente o termo
propriedade quando nos referirmos a um campo de um objeto, seja esse campo visvel ou no no Object
Inspector.
PROCEDIMENTOS ASSOCIADOS A EVENTOS
Se voc observou atentamente o procedimento associado ao evento OnActivate de um formulrio,
mostrado no captulo anterior, viu que o Delphi 7 cuidou de quase tudo.
Mesmo assim, bom que voc entenda o significado de cada trecho de cdigo em um procedimento,
para se sentir mais vontade ao escrever o cdigo do seu aplicativo.
Vamos examinar atentamente o cdigo do procedimento, que novamente exibido a seguir.
procedure TForm1.FormActivate(Sender: TObject);
begin
end;
Inicialmente, temos na primeira linha o cabealho do procedimento, que comea com a palavra
reservada procedure, seguida do nome da classe do objeto (TForm1), de um ponto e do indicativo do
evento (FormActivate Ativao de formulrio), alm de uma lista de parmetros (Sender: TObject) e
de um ponto-e-vrgula, que indica o fim do cabealho do procedimento.
Abaixo do cabealho vem o corpo do procedimento, limitado pelas palavras reservadas begin e end,
entre as quais deve ser digitado o cdigo do procedimento (nesse caso, o cdigo que definir o
comportamento do nosso aplicativo em resposta ocorrncia do evento).
Alm disso, se voc observar o incio do arquivo de cdigo, ver que o Delphi 7 tambm incluiu na
definio do objeto TForm1 a declarao da procedure, como mostra o trecho de cdigo a seguir,
extrado do arquivo de cdigo.
type
procedure FormActivate(Sender: TObject);
private
public
end;
72 00CURSO COMPLETO
Pode-se concluir, portanto, que o procedimento associado ao evento OnActivate, denominado
FormActivate , nesse caso, um mtodo da classe TForm1.
Essa procedure tem apenas o parmetro Sender, que identifica o objeto que gerou o evento e, exceto
em situaes em que vrios objetos compartilham o mesmo evento, no precisa ser diretamente
manipulado pelo programador.
PARE E REFLITA ANTES DE PROSSEGUIR
Uma ltima recomendao: antes de passar diretamente aos prximos captulos, verifique se realmente
compreendeu os fundamentos da linguagem Object Pascal.
Lembre-se de que ambientes de desenvolvimento como o do Delphi 7 facilitam muito o seu trabalho,
principalmente no que se refere criao da interface, mas no desenvolve o sistema para voc. Cabe
a voc, desenvolvedor, codificar a aplicao de forma a resolver um elenco de questes.
No se iluda! Programar no o mesmo que desenhar uma belssima interface. O trabalho de criao
de interface, embora extremamente importante, no representa o corao de um sistema.
No prximo captulo falaremos sobre a importncia de um bom planejamento requisito indispensvel
ao sucesso de um empreendimento. Leia-o com ateno, pois os aspectos discutidos podero lhe ser
muito teis.
CAPTULO 4 PLANEJANDO A SUA APLICAO
73 CURSO COMPLETO00
Captulo
Planejando a sua Aplicao
4
74 00CURSO COMPLETO
Neste captulo ser mostrada a importncia de se planejar uma aplicao antes de iniciar o seu
desenvolvimento.
FUNDAMENTOS EM: PLANEJAMENTO DE APLICAES
PR-REQUISITOS
Disciplina de trabalho e capacidade organizacional.
METODOLOGIA
Apresentao e descrio dos fatores que influenciam o sucesso no desenvolvimento de uma aplicao.
PLANEJANDO O SEU TRABALHO
Um bom planejamento indispensvel ao sucesso de um empreendimento. Nos prximos tpicos,
sero descritos alguns aspectos julgados importantes ao planejamento do trabalho de um desenvolvedor.
A IMPORTNCIA DE UM BOM PLANEJAMENTO
Antes de iniciar a codificao e o desenho da interface da sua aplicao, importante que voc reserve
um tempo para o seu planejamento.
Esse planejamento, embora possa parecer suprfluo para algumas pessoas, pode reduzir bastante o
tempo despendido no desenvolvimento da sua aplicao.
Graas facilidade e rapidez com que se pode construir a interface de uma aplicao com o Delphi 7,
muitos programadores comeam a desenhar a interface sem se preocupar com um planejamento prvio
da sua aplicao e, no meio do processo de desenvolvimento, descobrem que muita coisa poderia ser
modificada (e, nesse caso, as correes podem consumir um tempo muito maior do que aquele gasto
no seu planejamento).
A fim de evitar esse tipo de problema, recomendvel que se reserve algum tempo para discutir aspectos
importantes da aplicao, como, por exemplo:
Que menus devem ser includos na tela principal da aplicao? E quais devem ser os itens de
cada menu?
O programa ter uma barra de ferramentas? E uma barra de status? Que botes devem ser
includos na barra de ferramentas? Que informaes devem ser exibidas na barra de status?
Como ser o pano de fundo da tela principal da aplicao? Ser utilizada uma cor padro ou
um bitmap?
O programa efetuar acesso a tabelas de bancos de dados? Em caso afirmativo, qual o tipo de
banco de dados a ser empregado (Access, Paradox, MySQL, dBASE, Interbase, Oracle, etc.)?
Haver algum relacionamento entre essas tabelas? Desktop ou Client/Server? Ser uma aplicao
multiplataforma (desenvolvida com a CLX)?
75 CURSO COMPLETO00
Que relatrios sero gerados pela aplicao?
Como deve ser o help on-line da aplicao? Que itens devem ser includos e como esses itens
devem estar relacionados?
Quantas janelas e caixas de dilogo deve ter a aplicao? Qual a funo de cada uma delas?
Como ser o instalador do aplicativo? Ser utilizado o InstallShield Express, um outro produto
comercial ou ser desenvolvido um instalador para a aplicao?
Como voc deve ter percebido, o elenco de questes muito grande (e olhe que relacionamos apenas
poucos itens). Se voc planejar direitinho o seu trabalho, o desenvolvimento da aplicao ser mais
rpido e menos sujeito a erros.
No caso do desenvolvimento em equipe, esse planejamento fundamental, pois a diviso de tarefas s
deve ser feita aps uma perfeita definio dos seus objetivos especficos.
PLANEJANDO O NOSSO APLICATIVO-EXEMPLO
O aplicativo-exemplo que ser desenvolvido ao longo desta primeira parte do livro ser destinado a
gerenciar o cadastro de scios de um clube fictcio. Os conceitos de programao apresentados, no
entanto, se aplicam a outros tipos de aplicaes, pois as tcnicas apresentadas na construo da inter-
face e para acesso a bancos de dados permanecem as mesmas.
Nossa aplicao dever permitir:
O cadastro de novos scios.
A alterao de dados de um scio.
A excluso de um scio.
A consulta de dados dos scios.
O cadastro de novas atividades.
A alterao de dados de uma atividade.
A excluso de uma atividade.
A consulta de dados das atividades.
O cadastro de novas matrculas em atividades.
A excluso de matrculas em atividades.
A consulta de dados das matrculas em atividades.
A definio dos objetivos acima o primeiro passo a ser dado no planejamento da nossa aplicao.
Com base nesses objetivos, podem-se definir:
Os menus necessrios nossa aplicao.
76 00CURSO COMPLETO
As tabelas necessrias ao armazenamento dos dados: tabelas com os dados dos scios, das
atividades e das matrculas.
As janelas que devem compor a aplicao: uma janela para cadastro de scios, outra para
cadastro de atividades e janelas para matrculas em atividades, etc Alm disso, deve ser prevista
uma caixa de dilogo com informaes sobre direitos autorais do programa.
Os relatrios que devem ser gerados pela aplicao.
Os itens a serem includos no nosso arquivo de help.
Esses itens sero detalhados nos prximos captulos, na medida em que forem apresentadas as tcnicas
utilizadas na sua elaborao.
PADRONIZANDO A NOMENCLATURA DOS COMPONENTES
Ao criar a interface da sua aplicao, voc incluir diversos componentes nos vrios formulrios que a
compem. Cada formulrio, controle ou componente ter um nome (definido na sua propriedade
Name) pelo qual ser referenciado no cdigo da aplicao.
Quando voc inicia uma nova aplicao (um novo projeto), o Delphi 7 cria automaticamente um
formulrio denominado Form1. Se voc criar um segundo formulrio, ele ser denominado Form2 e
assim por diante.
Imagine agora que a sua aplicao possua quinze formulrios (o que no tanta coisa assim). J imaginou
ter de se lembrar qual a funo de Form1, Form2, ..., Form15?
Quando se inserem componentes em um formulrio, ocorre a mesma coisa. Se voc colocar quatro
caixas de texto em um formulrio, a primeira ser denominada Edit1, a segunda Edit2 e assim por diante.
Para facilitar as suas tarefas como desenvolvedor de aplicaes, voc deve estabelecer uma conveno
para os nomes dos seus formulrios e componentes. Pode ser qualquer uma, desde que seja de fcil
entendimento.
Alguns autores recomendam a utilizao de prefixos (que indicam o tipo do componente) seguidos de
um nome que identifique claramente a que se destina o componente.
Eu, por exemplo, costumo chamar de FormPrincipal o formulrio principal de uma aplicao. Com
relao a componentes do tipo Label, usados apenas para exibir textos estticos, s altero seu nome
quando preciso modificar alguma das suas propriedades no cdigo do aplicativo. Uma caixa de texto
na qual o usurio deve digitar seu nome costumo denominar EditNome, por exemplo.
Mas, conforme j disse anteriormente, no h uma regra rgida para os nomes dos componentes. A
melhor regra aquela que mais facilita o seu trabalho. O importante que voc defina uma e a utilize
de forma coerente. No caso em que o desenvolvimento feito em equipe, a utilizao de uma conveno
ainda mais importante.
77 CURSO COMPLETO00
FUNDAMENTOS EM: TO-DO LISTS
PR-REQUISITOS
Experincia prvia no desenvolvimento de aplicaes com Delphi, e na manipulao do seu ambiente de desenvolvimento.
METODOLOGIA
Apresentao do problema: Utilizao das TO-DO Lists na organizao e planejamento durante o desenvolvimento de aplicaes com o Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios utilizao do recurso de TO-DO Lists.
ORGANIZANDO O SEU TRABALHO COM AS FERRAMENTAS TO-DO LIST
Desenvolver um bom aplicativo requer, antes de mais nada, um bom planejamento e uma prvia
organizao das tarefas a serem desempenhadas, e justamente esta a funo das To-Do Lists, presentes
no Delphi 7.
Sua funo consiste em registrar atividades que devem ser realizadas no desenvolvimento de um projeto
de aplicativo. Uma referncia a uma atividade pode ser adicionada a um projeto na prpria janela que
relaciona as To-Do Lists ou diretamente no cdigo-fonte da aplicao.
A figura a seguir apresenta a janela de gerenciamento das To-Do Lists de um projeto, exibida quando se
seleciona o item To-Do List do menu View do ambiente de desenvolvimento integrado do Delphi 7:
Figura 4.1: A janela de gerenciamento das To-Do Lists.
Cada Projeto possui a sua prpria relao de To-Do Lists a ele associada.
ADICIONANDO UM ITEM A UMA TO-DO LISTS
Para adicionar um item a uma To-Do Lists, voc deve executar os seguintes procedimentos:
1. Exibir a janela de To-Do Lists do projeto.
2. Selecionar o boto direito do mouse sobre esta janela e, no menu pop-up que ser exibido, selecionar
o item Add, para exibir a caixa de dilogo Add To-Do Item, mostrada na figura a seguir.
78 00CURSO COMPLETO
Figura 4.2: A caixa de dilogo Add To-Do Item.
Nesta caixa de dilogo, devero ser fornecidas as seguintes informaes:
Um texto descritivo da ao a ser realizada (Text).
A prioridade desta tarefa (Priority).
O responsvel pela tarefa (Owner). Voc pode digitar um novo nome ou selecionar um nome
j existente.
A sua categoria (Category). Voc pode digitar uma nova categoria ou selecionar um nome j
existente.
3. Aps fornecer as informaes necessrias, selecionar o boto Ok para fechar esta caixa de dilogo
e criar o novo item.
EDITANDO UM ITEM DE UMA TO-DO LISTS
Para editar um item de uma To-Do Lists, voc deve executar os seguintes procedimentos:
2. Selecionar o boto direito do mouse sobre um item desta janela e, no menu pop-up que ser
exibido, selecionar o item Edit, para exibir a caixa de dilogo Edit To-Do item, mostrada na
figura a seguir.
Figura 4.3: A caixa de dilogo Edit To-Do Item.
Nesta caixa de dilogo, podero ser alteradas as informaes j fornecidas na criao do item, alm de
poder indicar que a tarefa j foi realizada (o que feito marcando-se a caixa de verificao Done).
79 CURSO COMPLETO00
3. Aps fornecer as informaes necessrias, selecionar o boto Ok para fechar esta caixa de dilogo.
EXCLUINDO UM ITEM DE UMA TO-DO LISTS
Para excluir um item de uma To-Do Lists, voc deve executar os seguintes procedimentos:
2. Selecionar o item a ser removido.
3. Pressionar o boto Del ou selecionar o boto direito do mouse sobre esta janela e, no menu
pop-up que ser exibido, selecionar o item Delete.
CONFIGURANDO AS INFORMAES EXIBIDAS EM UMA TO-DO LISTS
Para configurar as informaes a serem exibidas em uma TO-DO Lists, voc deve executar os seguintes
procedimentos:
1. Exibir a janela de TO-DO Lists do projeto.
2. Selecionar o boto direito do mouse sobre esta janela e, no menu pop-up que ser exibido,
selecionar o item Table Properties, para exibir a caixa de dilogo mostrada na figura a seguir.
Figura 4.4: A caixa de dilogo Table Properties.
Esta caixa de dilogo apresenta duas pginas, uma referente s caractersticas gerais da tabela de itens,
como mostrado na figura anterior, e outra na qual se pode configurar cada uma das suas colunas, como
mostrado na prxima figura.
80 00CURSO COMPLETO
Figura 4.5: A pgina Column da caixa de dilogo Table Properties.
Nesta pgina pode-se definir, para cada coluna:
Seu ttulo (Title).
Sua largura (Width) em porcentagem da largura total.
Sua altura (Height) em pixels.
Se o texto pode ser quebrado em mais de uma linha (Wrap).
Se a coluna deve estar visvel (Visible).
Seu alinhamento (horizontal e vertical).
A fonte usada na exibio do texto correspondente.
CONFIGURANDO COMO AS INFORMAES DEVEM
SER ORDENADAS EM UMA TO-DO LISTS
Para configurar como as informaes devem ser ordenadas em uma To-Do Lists, voc deve executar os
seguintes procedimentos:
2. Selecionar o boto direito do mouse sobre esta janela e, no menu pop-up que ser exibido,
selecionar o item Sort, para exibir os subitens pelos quais a lista pode ser ordenada, selecionando-
se ento o item desejado.
ADICIONANDO UM ITEM A UMA TO-DO LISTS DIRETAMENTE NO CDIGO-FONTE
Para adicionar um item a uma To-Do Lists diretamente no cdigo-fonte, voc deve executar os seguintes
procedimentos:
81 CURSO COMPLETO00
1. No Editor de cdigo, selecione o boto direito do mouse e, no menu suspenso que ser exibido,
selecione o item Add To-Do item. Ser exibida a caixa de dilogo Add To-Do item, na qual
dever ser selecionado o item desejado e o boto Ok, para inserir a referncia a este item no
cdigo-fonte, que dever ficar como apresentado a seguir (o cdigo-fonte se refere ao
procedimento associado ao evento OnClick de um boto chamado BotaoTeste, criado apenas
para ilustrar o uso das TO-DO Lists):
procedure TFormPrincipal.BotaoTesteClick(Sender: TObject);
begin
{ TODO 2 -oMarcelo -cInterface : Iniciar a interface }
end;
Repare que ser criado um novo item na TO-DO List Neste caso seria melhor no t-lo criado
anteriormente. A diferena est no fato de que o item recm-criado est diretamente vinculado ao
cdigo-fonte e, ao ser posteriormente editado e marcado como concludo, o cdigo-fonte ser
automaticamente alterado para:
procedure TFormPrincipal.BotaoTesteClick(Sender: TObject);
begin
{ DONE 2 -oMarcelo -cInterface : Iniciar a interface }
end;
Voc tambm pode digitar diretamente as informaes no cdigo-fonte, usando comandos com a
seguinte sintaxe:
{TODO|DONE [n] [-o<owner>] [-c<category>] : <to-do item text>}
Onde:
n indica a prioridade do item.
TODO: indica que a tarefa representada por este item no foi completada.
DONE: indica que a tarefa representada por este item foi completada.
-o owner: o nome do responsvel pela tarefa.
-c category: a categoria da tarefa representada pelo item.
Os itens digitados no cdigo-fonte so automaticamente adicionados To-Do List.
COPIANDO A RELAO DE ITENS DE UMA TO-DO LIST
Voc pode copiar a relao de itens de uma To-Do List como texto ou no formato HTML.
Para isto, basta selecionar o boto direito do mouse sobre esta janela e, no menu pop-up que ser
exibido, selecionar o item Copy As para exibir os subitens, selecionando-se ento o item desejado.
82 00CURSO COMPLETO
FILTRANDO A RELAO DE ITENS DE UMA TO-DO LIST
Voc pode filtrar a relao de itens de uma To-Do List.
Para isto, basta selecionar o boto direito do mouse sobre a janela TO-DO Lists e, no menu pop-up que
ser exibido, selecionar o item Filter para exibir os subitens, selecionando-se ento a opo desejada.
CAPTULO 5 CRIANDO O FORMULRIO PRINCIPAL DA APLICAO
83 CURSO COMPLETO00
Captulo
Criando o Formulrio
Principal da Aplicao
5
84 00CURSO COMPLETO
Neste captulo sero apresentados os procedimentos necessrios criao do formulrio principal do
nosso aplicativo-exemplo. Sero apresentadas as principais propriedades de um formulrio, os
procedimentos necessrios definio dos seus valores e a incluso de componentes para a criao
da interface.
FUNDAMENTOS EM: MANIPULAO DE FORMULRIOS
PR-REQUISITOS
Conhecimentos bsicos da codificao na linguagem Object Pascal.
Noes bsicas de programao orientada a objetos, principalmente os conceitos de propriedades, mtodos e eventos (apresentados nos
captulos anteriores).
METODOLOGIA
Apresentao e descrio das principais caractersticas de um formulrio.
TCNICA
Apresentao dos procedimentos necessrios configurao de formulrios.
OS FORMULRIOS ELEMENTOS PARA A CONSTRUO DA
INTERFACE EM APLICAES DESENVOLVIDAS EM DELPHI 7
Conforme descrito anteriormente, os formulrios so as janelas que iro compor a interface da sua
aplicao. Este nome pode parecer no muito adequado, mas j est consagrado na literatura, e
iremos adot-lo.
Nos prximos tpicos voc aprender a definir as principais caractersticas do formulrio principal de
uma aplicao desenvolvida em Delphi 7.
O OBJETO FORMULRIO
Um dos principais objetos utilizados no desenvolvimento de aplicaes com o Delphi 7 o objeto
formulrio (Form).
Como j foi visto no Captulo 2, sempre que iniciamos uma nova aplicao (um novo projeto), o
Delphi 7 cria um formulrio vazio, que pode ser usado como o formulrio principal da aplicao.
Como todo objeto que se preza, um formulrio possui propriedades, mtodos e eventos.
Dentre as propriedades de um formulrio, podem-se destacar:
BorderStyle: Determina o estilo de borda do formulrio.
BorderIcons: Determina os cones a serem habilitados na extremidade superior direita da barra
de ttulos do formulrio.
Caption: Armazena o texto exibido na barra de ttulos do formulrio.
85 CURSO COMPLETO00
Color: Define a cor do formulrio.
Font: Define a fonte do texto exibido no formulrio.
Height: Define a dimenso vertical (altura) de um formulrio.
Icon: Define o cone a ser exibido quando o formulrio for minimizado.
Left: Define a posio de um formulrio, em relao extremidade esquerda da tela.
Menu: Define o menu associado ao formulrio.
Name: Define o nome pelo qual o objeto referenciado no cdigo da aplicao.
PopupMenu: Define o menu flutuante associado ao formulrio.
Position: Define o posicionamento do formulrio na tela.
Windowstate: Determina o estado de exibio do formulrio (maximizado, minimizado ou
normal).
Top: Define a posio de um formulrio, em relao extremidade superior da tela.
PROPRIEDADES COM UM CONJUNTO DE VALORES PREDEFINIDOS
Existem propriedades que s podem assumir alguns valores predefinidos. Esse o caso, por exemplo,
da propriedade Position de um formulrio, descrita no tpico anterior.
Nesses casos, o valor da propriedade pode ser selecionado a partir de uma lista exibida quando se clica
com o boto esquerdo do mouse sobre a seta exibida direita do valor da propriedade, como mostra a
figura a seguir.
Figura 5.1: Definindo o valor da propriedade Position no Object Inspector.
86 00CURSO COMPLETO
PROPRIEDADES QUE CONTM SUBPROPRIEDADES
Existem algumas propriedades que representam um conjunto de valores. Como foi mostrado no Captulo
3, um conjunto armazena seus elementos entre colchetes.
Esse o caso, por exemplo, da propriedade BorderIcons de um formulrio.
Uma observao mais atenta mostra que o Object Inspector exibe, esquerda do nome dessa propriedade,
um pequeno sinal de +. Esse sinal indica que essa propriedade , neste caso, um conjunto, cujos
elementos podem ser definidos (habilitados) de forma independente.
Para acessar cada um desses elementos, que denominaremos subpropriedades, basta dar um duplo
clique com o boto esquerdo do mouse sobre o sinal +. Nesse caso, cada subpropriedade poder ser
definida de maneira independente, como mostra a figura a seguir. Repare ainda que o sinal + foi
substitudo por -. Dando-se um duplo clique sobre o sinal -, as subpropriedades ficaro novamente
ocultas, e o sinal - ser substitudo por +.
Figura 5.2: Acessando subpropriedades no Object Inspector.
Observe ainda que cada uma dessas propriedades exibe uma lista de valores possveis (nesse caso, True
e False).
Existem ainda casos em que os valores dessas subpropriedades podem ser definidos em uma caixa de
dilogo. Esse o caso, por exemplo, da propriedade Font de um formulrio.
Nessas situaes, alm do sinal de + exibido esquerda do nome da propriedade, o Object Inspector
apresenta reticncias (...) direita do valor da propriedade. Clicando-se sobre essas reticncias, exibe-
se uma caixa de dilogo na qual se podem definir os valores das subpropriedades.
87 CURSO COMPLETO00
As figuras a seguir mostram a propriedade Font, e a caixa de dilogo utilizada para atribuir valores s
suas subpropriedades.
Figura 5.3: Acessando a propriedade Font no Object Inspector.
Figura 5.4: A caixa de dilogo Font.
Conforme veremos ao longo do livro, essa situao ocorre em muitas propriedades de diversos
componentes.
88 00CURSO COMPLETO
ALTERANDO AS PROPRIEDADES DO OBJETO FORMULRIO
Vamos iniciar a criao da interface visual da nossa aplicao. Para isso, execute os seguintes
procedimentos:
1. Abra o projeto Clube.dpr, criado anteriormente.
2. Selecione o formulrio principal, inicialmente denominado Form1.
3. Atribua os seguintes valores para as principais propriedades do formulrio principal, diretamente
no Object Inspector:
BorderStyle: bsSingle (esse estilo impede que o formulrio seja redimensionado).
BorderIcons: [biSystemMenu,biMinimize].
Caption: .Cadastro de Scios.
Height: 700.
Name: FormPrincipal.
Position: poScreenCenter.
Width: 1100.
As propriedades cujo valor no for alterado permanecero com o seu valor default.
Os valores das propriedades Height e Width foram definidos considerando-se uma resoluo de 1280 por 1024. Caso a resoluo a
ser adotada seja diferente, reajuste estes valores de forma proporcional.
Seu formulrio deve ficar com o aspecto mostrado na figura a seguir.
Figura 5.5: Aspecto inicial do formulrio principal da aplicao.
89 CURSO COMPLETO00
DEFININDO UM CONE PARA O FORMULRIO PRINCIPAL DA APLICAO
Para definir um cone para o formulrio, voc deve executar os seguintes procedimentos:
1. Selecione o formulrio.
2. Selecione as reticncias exibidas direita da propriedade Icon no Object Inspector. Ser exibida
a caixa de dilogo Picture Editor, mostrada na figura a seguir.
Figura 5.6: A caixa de dilogo Picture Editor.
3. Selecione o boto Load desta caixa de dilogo. Ser exibida a caixa de dilogo Load Picture,
mostrada na Figura 5.7, na qual dever ser selecionado o cone desejado.
Nesse exemplo, a imagem selecionada est no arquivo C:\Arquivos de Programas\Arquivos
Comuns\Borland Shared\Images\Icons\Handshak.ico do Windows. A localizao deste arquivo pode,
no entanto, no ser a mesma no seu computador, dependendo de como foi feita a sua instalao do
Delphi 7. Neste caso, recomenda-se pesquisar a sua localizao.
4. Selecione o boto Abrir, para fechar a caixa de dilogo Load Picture.
Figura 5.7: A caixa de dilogo Load Picture.
90 00CURSO COMPLETO
5. Selecione o boto OK, para fechar a caixa de dilogo Picture Editor.
Pronto! Voc acaba de definir um cone para o seu formulrio.
Voc no precisa distribuir o arquivo de cone com a aplicao, pois o cone incorporado diretamente ao seu executvel (voc pode
verificar isso analisando a descrio textual do formulrio).
INSERINDO COMPONENTES EM UM FORMULRIO
Para criar a interface da sua aplicao, voc precisar inserir controles e componentes em seus
formulrios.
Para inserir um componente em um formulrio, basta que se execute um dos seguintes procedimentos:
D um duplo clique com o boto esquerdo do mouse sobre o seu cone na paleta de
componentes. Isso faz com que o componente seja exibido centralizado no formulrio com o
seu tamanho default.
Ou:
Selecione o cone correspondente na paleta de componentes e depois d um clique com o
boto esquerdo do mouse sobre o formulrio. Isso faz com que o componente seja exibido com
o seu tamanho default e com a sua extremidade superior esquerda situada na posio definida
pelo ponteiro do mouse.
Ou:
Selecione o componente desejado na paleta de componentes (clicando uma nica vez sobre o
seu cone), pressione o boto esquerdo do mouse sobre o formulrio e, mantendo o boto
esquerdo do mouse pressionado, arraste-o de forma a definir o tamanho do componente. Isso
permite que se definam simultaneamente o tamanho e a posio do componente durante a
sua insero no formulrio.
Para inserir mais de um componente de um mesmo tipo em um formulrio, pressione a tecla Shift ao selecion-lo na paleta de
componentes. Isso faz com que, ao se clicar novamente sobre o formulrio, seja criado um novo componente, sem a necessidade de
selecion-lo outra vez na paleta. Para cancelar o processo de insero mltipla, basta selecionar qualquer outro componente da paleta.
Observe que os componentes so distribudos por vrias pginas da paleta de componentes (Standard, Additional, Data Access, Data
Controls, etc.), e antes de selecionar um componente necessrio que a pgina onde o mesmo se encontra esteja selecionada (o que
feito clicando-se com o boto esquerdo do mouse sobre o nome da pgina).
INSERINDO UM COMPONENTE PARA EXIBIO DE IMAGENS NO FORMULRIO PRINCIPAL
Para incluir um componente capaz de exibir imagens gravadas em arquivos, execute os seguintes
procedimentos:
1. Selecione a pgina Additional da paleta de componentes.
91 CURSO COMPLETO00
2. Selecione o sexto componente da paleta.
3. Clique com o boto esquerdo do mouse sobre o formulrio.
4. O componente ser exibido no formulrio, como mostra a figura a seguir.
Figura 5.8: Inserindo um componente para exibio de imagens no formulrio.
Entre as principais propriedades desse componente, possvel destacar:
AutoSize: Essa propriedade define se o componente ser ou no automaticamente
redimensionado para se adaptar ao tamanho da imagem a ser exibida (definida na sua
propriedade Picture) e s pode assumir os valores False (falso) e True (verdadeiro).
Height: Define a dimenso vertical (altura) do componente.
Left: Define a posio do componente em relao extremidade esquerda do formulrio.
Name: Define o nome com o qual o objeto referenciado no cdigo da aplicao.
Picture: Define a imagem a ser exibida pelo componente.
Stretch: Essa propri edade defi ne se a i magem ser ou no automati camente
redimensionada e, para se adaptar ao tamanho do componente, s pode assumir os valores
False (falso) e True (verdadeiro). Entretanto, definir o valor de Stretch como True pode
provocar distores na imagem.
Top: Define a sua posio, em relao extremidade superior do formulrio.
Width: Define a dimenso horizontal (largura) do componente.
92 00CURSO COMPLETO
O valor definido na propriedade AutoSize prevalece sobre o definido na propriedade Stretch.
SELECIONANDO UM COMPONENTE INSERIDO EM UM FORMULRIO
Para selecionar um componente inserido em um formulrio, basta clicar sobre este com o boto esquerdo
do mouse. Quando um componente selecionado, apresenta pequenos quadrados pretos ao seu redor.
Esses pequenos quadrados pretos so denominados marcas de seleo e indicam que o componente
est selecionado.
A figura anterior mostra o componente de exibio de imagens selecionado e suas marcas de seleo.
Quando um componente inserido em um formulrio, ele automaticamente selecionado.
A seleo de um componente permite que ele seja movimentado e redimensionado com o mouse e
que as suas propriedades sejam alteradas diretamente no Object Inspector.
RENOMEANDO UM COMPONENTE
O nome dado a um componente, definido pela sua propriedade Name, o nome pelo qual este
componente ser referenciado no cdigo da aplicao.
Para renomear um componente, execute os seguintes procedimentos:
1. Selecione o componente com o mouse.
2. Altere o valor da sua propriedade Name diretamente no Object Inspector.
Executando os passos anteriores, mude o valor da propriedade Name do componente de exibio de
imagens para Logotipo.
REPOSICIONANDO UM COMPONENTE
Para movimentar um componente com o mouse, execute os seguintes procedimentos:
1. Pressione o boto esquerdo do mouse sobre o componente e, mantendo o boto pressionado,
movimente o mouse, arrastando o componente. medida que voc movimenta o componente,
os valores das suas propriedades Left e Top so exibidos junto ao ponteiro do mouse.
2. Quando o componente estiver situado na posio desejada, libere o boto esquerdo do mouse.
Por exemplo: selecione com o mouse o componente inserido no formulrio no tpico anterior e verifique
o valor das suas propriedades Left e Top no Object Inspector.
Movimente o componente executando os passos descritos anteriormente e, aps coloc-lo em uma
nova posio, verifique os novos valores das suas propriedades Left e Top.
Como voc j deve ter constatado, os valores das propriedades Left e Top so automaticamente
atualizados quando voc termina de movimentar o componente. Isso ocorre porque as propriedades
93 CURSO COMPLETO00
Left e Top definem a posio do componente em relao ao canto superior esquerdo do formulrio. A
propriedade Left mede, em pixels, a distncia da extremidade esquerda do componente em relao
extremidade esquerda do formulrio. A propriedade Top mede, em pixels, a distncia da extremidade
superior de um componente em relao extremidade superior do formulrio (no caso de um formulrio,
essas propriedades so definidas em relao tela).
A recproca tambm verdadeira, isto , se voc selecionar um componente e alterar os valores das
suas propriedades Left e Top no Object Inspector, o componente ser deslocado para uma nova posio
no formulrio.
Reposicione o componente de exibio de imagens inserido no formulrio, executando os seguintes
procedimentos:
1. Selecione o componente.
2. No Object Inspector, atribua o valor 260 sua propriedade Top e 469 sua propriedade Left.
Voc tambm pode reposicionar um componente que esteja selecionado, usando as combinaes de tecla Ctrl + uma das teclas
de movimentao do teclado (seta para esquerda, seta para direita, etc.).
REDIMENSIONANDO UM COMPONENTE
Para redimensionar um componente com o mouse, execute os seguintes procedimentos:
1. Selecione o componente com o boto esquerdo do mouse.
2. Posicione o ponteiro do mouse sobre uma das marcas de seleo do componente, at que ele se
torne uma seta dupla.
3. Pressione o boto esquerdo do mouse e movimente o seu ponteiro, redimensionando o
componente. medida que voc redimensiona o componente, os valores das suas
propriedades Height e Width so exibidos junto ao ponteiro do mouse (esse recurso no
estava disponvel nas verses anteriores, e simplifica bastante a tarefa de se redimensionar
um componente no formulrio).
4. Quando o componente estiver com o tamanho desejado, libere o boto esquerdo do mouse.
Selecione, com o mouse, o componente de exibio de imagens que foi inserido no formulrio e
verifique, no Object Inspector, o valor das suas propriedades Height e Width. Redimensione o
componente executando os passos descritos anteriormente e, aps redimension-lo, verifique os novos
valores das suas propriedades Height e Width.
Como voc j deve ter constatado, os valores das propriedades Height e Width so automaticamente
atualizados quando voc termina de redimensionar o componente. Isso ocorre porque as propriedades
Height e Width definem respectivamente os valores, em pixels, da altura e largura do componente.
A recproca tambm verdadeira, isto , se voc selecionar um componente e alterar os valores das
suas propriedades Height e Width no Object Inspector, o componente ser redimensionado.
94 00CURSO COMPLETO
Redimensione o componente de exibio de imagens inserido no formulrio, executando os seguintes
procedimentos:
1. Selecione o componente.
2. No Object Inspector, atribua o valor 139 sua propriedade Height e 153 sua propriedade Width.
Voc tambm pode redimensionar um componente que esteja selecionado, usando as combinaes de tecla Shift + uma das teclas de
movimentao do teclado (seta para esquerda, seta para direita, etc.).
EXIBINDO UMA IMAGEM
Para definir a imagem a ser exibida, o que feito definindo-se um valor para a propriedade Picture do
componente Logotipo, execute os seguintes procedimentos:
1. Selecione o componente Logotipo.
2. No Object Inspector, selecione a sua propriedade Picture.
3. D um clique com o boto esquerdo do mouse sobre as reticncias (...) exibidas do lado direito
da propriedade. Ser exibida a caixa de dilogo Picture Editor.
4. Para definir a figura a ser exibida, selecione o boto Load, que exibe a caixa de dilogo Load
Picture, descrita anteriormente.
5. Selecione o arquivo C:\Arquivos de Programas\Arquivos Comuns\Borland Shared\Images\
splash\16color\Athena.bmp e clique no boto Open.
6. Selecione o boto OK na caixa de dilogo Picture Editor.
Figura 5.9: Exibio da imagem no componente.
95 CURSO COMPLETO00
O componente exibir a figura selecionada (Figura 5.9). No Object Inspector ser informado apenas o tipo de
imagem a ser exibida pelo componente (TBitmap, TIcon, etc.), e no o diretrio e nome do arquivo. Isso se
deve ao fato de que a imagem ser realmente armazenada no formulrio, e no apenas referenciada por ele.
Altere a propriedade AutoSize do componente para True, para que a imagem seja totalmente visvel.
Caso voc esteja trabalhando com outra resoluo, pode centralizar o componente selecionando-o e, com o boto direito do mouse,
acessar a opo Position->Align do menu pop-up associado ao componente. Na caixa de dilogo que ser exibida, selecione a opo
Center in window tanto para o alinhamento horizontal como para o alinhamento vertical. Estes procedimentos sero detalhados
adiante, no tpico Alinhando Componentes.
EXIBINDO UM TEXTO NO FORMULRIO
Para exibir em um formulrio um texto que no deve ser alterado pelo usurio da aplicao, deve-se
usar o componente Label, o quarto componente da pgina Standard da paleta de componentes.
A principal propriedade desse componente a propriedade Caption, que define o texto que ser exibido.
Para inserir um label no seu formulrio, execute os seguintes procedimentos:
1. Selecione a pgina Standard da paleta de componentes.
2. Selecione o componente Label.
3. Clique com o boto esquerdo do mouse sobre o formulrio.
4. Altere o valor da sua propriedade Caption para Fundamentos do Delphi 7 diretamente no
Object Inspector.
5. No Object Inspector, atribua o valor 468 sua propriedade Left e 550 sua propriedade Top. O
componente ser exibido no formulrio, como mostra a Figura 5.10.
Figura 5.10: Incluso de um rtulo no formulrio.
96 00CURSO COMPLETO
ALTERANDO A FONTE DO TEXTO EXIBIDO EM UM COMPONENTE
Se voc no alterou as configuraes padres do ambiente e seguiu corretamente os passos descritos no
tpico anterior, a fonte do texto exibido no rtulo inserido no formulrio ser a fonte default do
ambiente, sem nenhum efeito especial.
Vamos alterar algumas das suas caractersticas, de forma a tornar mais atraente o aspecto do formulrio
principal da nossa aplicao.
Como descrito anteriormente, a propriedade Font de um componente pode ser alterada selecionando
este componente e clicando-se com o boto esquerdo do mouse sobre os trs pontinhos que so exibidos
direita do valor da propriedade, para exibir a caixa de dilogo Font, mostrada na Figura 5.4. Altere as
caractersticas da fonte para tamanho 24, estilo Negrito Itlico, efeito sublinhado e cor azul-marinho.
Seu formulrio dever ficar com o aspecto mostrado na figura a seguir.
Figura 5.11: Redefinindo a fonte do rtulo no formulrio.
SELECIONANDO VRIOS COMPONENTES SIMULTANEAMENTE
Para selecionar mais de um componente de uma nica vez, execute os seguintes procedimentos:
1. Selecione o primeiro componente com o boto esquerdo do mouse.
2. Pressione a tecla Shift enquanto seleciona os demais componentes.
Voc tambm pode desenhar com o mouse um retngulo que circunscreva todos os componentes a
serem selecionados. Para isso, basta executar os seguintes procedimentos:
1. Pressione o boto esquerdo do mouse quando o seu ponteiro estiver sobre o ponto que definir
o primeiro vrtice do retngulo no formulrio.
97 CURSO COMPLETO00
2. Mantendo o boto esquerdo do mouse pressionado, arraste o seu ponteiro para a posio que
definir o outro vrtice do retngulo ( medida que se arrasta o ponteiro do mouse, um retngulo
pontilhado desenhado automaticamente).
3. Libere o boto esquerdo do mouse.
Aps concluir o passo anterior, todos os componentes situados dentro do retngulo ou interceptados
por ele estaro selecionados.
Voc tambm pode selecionar todos os componentes presentes em um formulrio, selecionando o item Select All do menu Edit do Delphi 7.
ALINHANDO COMPONENTES
Quando inserimos vrios componentes em um formulrio, dificilmente conseguimos coloc-los em
uma disposio bem organizada. Felizmente, o Delphi fornece um recurso que permite que os
componentes sejam facilmente alinhados.
Para ajustar a posio dos componentes Label1 e Logotipo, execute os seguintes procedimentos:
1. Selecione o componente Label1 e, pressionando a tecla Shift, selecione o componente Logotipo.
Os dois componentes exibiro marcas de seleo.
2. Selecione o item Align do menu Edit.
Ser exibida a caixa de dilogo Alignment, mostrada na Figura 5.12.
Figura 5.12: A caixa de dilogo Alignment.
Essa caixa de dilogo apresenta dois grupos de botes, um denominado Horizontal e outro denominado
Vertical, com as seguintes opes:
No change: A posio do(s) componente(s) no se altera na direo especificada. Essa opo
est disponvel nos dois grupos de botes.
Left sides: Os componentes so alinhados pela sua extremidade esquerda, tomando por
base a extremidade esquerda do primeiro componente selecionado. Essa opo s existe no
grupo Horizontal.
98 00CURSO COMPLETO
Centers: Os componentes so alinhados pelos seus centros, tomando por base o centro do
primeiro componente selecionado. Essa opo est disponvel nos dois grupos de botes.
Right sides: Os componentes so alinhados pela sua extremidade direita, tomando por
base a extremidade direita do primeiro componente selecionado. Essa opo s existe no
grupo Horizontal.
Space equally: Os componentes so distribudos de forma que os seus centros se mantenham
eqidistantes. Essa opo est disponvel nos dois grupos de botes.
Center in window: O(s) componente(s) (so) centralizado(s) na janela. Essa opo est
disponvel nos dois grupos de botes. Observao: se voc selecionar um nico componente,
este ser centralizado na janela, mas, se voc selecionar um grupo de componentes, o centro
desse grupo que ser alinhado com o centro do formulrio.
Tops: Os componentes so alinhados pela sua extremidade superior, tomando por base a extremidade
superior do primeiro componente selecionado. Essa opo s existe no grupo Vertical.
Bottoms: Os componentes so alinhados pela sua extremidade inferior, tomando por base a
extremidade inferior do primeiro componente selecionado. Essa opo s existe no grupo Vertical.
3. Como desejamos alinhar horizontalmente os componentes pelos seus pontos mdios, selecione
a opo Centers, no grupo Horizontal, e No change, no grupo Vertical.
4. Clique no boto OK para fechar a caixa de dilogo.
Para centralizar horizontalmente os componentes em conjunto no formulrio, execute os passos
anteriores e selecione a opo Center in Window, nos grupos Horizontal e Vertical da caixa de dilogo
Alignment. Seu formulrio deve ficar com o aspecto indicado na Figura 5.13.
Figura 5.13: Aspecto do formulrio aps o alinhamento dos componentes.
Repare que os valores armazenados nas propriedades Left e Top dos componentes devem ter sido alterados.
99 CURSO COMPLETO00
ANALISANDO O CDIGO GERADO PELO DELPHI
Se voc analisar o cdigo da unit correspondente ao formulrio, ver a seguinte definio de classe:
type
TFormPrincipal = class(TForm)
Logotipo: TImage;
Label1: TLabel;
private
public
end;
Repare que a classe TFormPrincipal apresenta, entre seus campos, um componente do tipo TImage e
outro do tipo TLabel, que no existem na classe TForm. Lembra-se do conceito de herana? A classe
TFormPrincipal, derivada de TForm, herda suas propriedades e mtodos, e ainda acrescenta novas
propriedades e mtodos (inexistentes em TForm).
TESTANDO A SUA APLICAO
At que nosso aplicativo est ficando com uma boa aparncia, porm est faltando algo muito comum
em todos os aplicativos Windows: um menu. Vamos inclu-lo no prximo captulo, mas antes vamos
fazer um pequeno teste da nossa aplicao.
O Delphi permite que voc execute o seu aplicativo a partir de seu prprio ambiente de desenvolvimento.
Isso permite que o comportamento e o desempenho da sua aplicao sejam analisados sem a necessidade
de sair do ambiente do Borland Delphi 7, otimizando-se o tempo gasto no desenvolvimento da aplicao.
Para testar seu aplicativo, basta executar um dos seguintes procedimentos:
Selecionar o item Run do menu Run.
Ou:
Pressionar a tecla de funo F9.
Ou:
Na caixa de ferramentas, selecionar o boto que exibe uma seta verde. Repare que esse boto
apresenta uma seta direita que permite selecionar o projeto a ser executado (no caso de se
estar trabalhando com um grupo de projetos).
Ao iniciar a sua execuo, o formulrio deve apresentar o aspecto da Figura 5.14.
Em princpio, pode parecer que no se tem l grande coisa, apenas uma janela com um ttulo, uma
imagem e nada mais.
Tudo bem, no criamos nenhuma aplicao espetacular, mas sem escrever uma nica linha de cdigo
j temos uma aplicao que consiste em uma janela principal com uma barra de ttulos, botes Maximizar
(que nesse caso foi desabilitado por ns), Minimizar, Finalizao e um menu de sistema.
100 00CURSO COMPLETO
Figura 5.14: Execuo do aplicativo a partir do ambiente de desenvolvimento.
Voc pode reposicionar a janela, clicando com o boto esquerdo do mouse sobre a sua barra de ttulos
e, mantendo o boto esquerdo pressionado, arrast-la para a posio desejada, alternar para outra
aplicao e posteriormente retornar. Tudo isso sem a necessidade de qualquer codificao, a no ser
aquela gerada pelo prprio Delphi.
De qualquer maneira, isso refora os argumentos de que a criao da interface apenas uma fase do
desenvolvimento de um aplicativo.
FINALIZANDO A EXECUO DO APLICATIVO
Para finalizar o aplicativo, execute um dos seguintes procedimentos:
Selecione o boto Finalizar (aquele quadradinho com um x no seu interior), situado na
extremidade direita da barra de ttulos.
Ou:
Selecione o item Fechar no menu de sistema.
Ou:
Selecione o item Program Reset no menu Run (essa opo s vlida quando voc inicializa a
aplicao com base no ambiente de desenvolvimento do Borland Delphi).
Ou:
Pressione simultaneamente as teclas Ctrl e F12 (essa opo s vlida quando voc inicializa a
aplicao com base no ambiente de desenvolvimento do Borland Delphi).
CAPTULO 6 PROJETANDO UM MENU PARA A SUA APLICAO
101 CURSO COMPLETO00
Captulo
Projetando um Menu
Para a sua Aplicao
6
Neste captulo, voc ver como simples a incluso de menus nas janelas formulrios da sua aplicao
com o Delphi 7, e como associar eventos a itens de um menu.
FUNDAMENTOS EM: CRIAO DE MENUS
PR-REQUISITOS
Incluso e manipulao de componentes em um formulrio.
METODOLOGIA
Apresentao e descrio das principais caractersticas de um menu.
TCNICA
Apresentao dos procedimentos necessrios incluso de um menu no formulrio principal da sua aplicao.
MENUS ELEMENTOS INDISPENSVEIS AO FORMULRIO PRINCIPAL DE UMA APLICAO
Dificilmente encontramos uma aplicao com interface grfica que no exiba um menu em sua janela
principal, e seus aplicativos no devem fugir a essa (quase) regra; afinal de contas seus usurios esperam
poder acessar alguns dos recursos dos seus aplicativos por meio dos menus existentes na janela principal.
Nos prximos tpicos mostraremos como simples incluir essa caracterstica aos aplicativos
desenvolvidos com o Delphi 7.
INCLUINDO UM MENU NA SUA APLICAO
A incluso de um menu em uma aplicao feita por meio da insero de um componente MainMenu
no seu formulrio principal.
O componente MainMenu est situado na pgina Standard da paleta de componentes ( o segundo
componente desta pgina) e fornece acesso a um editor de menus.
Para inserir um componente do tipo MainMenu no formulrio principal da aplicao, execute os
1. Exiba o formulrio principal.
2. Selecione o componente MainMenu, na pgina Standard da paleta de componentes, clicando
nele com o boto esquerdo do mouse.
3. Clique novamente sobre o formulrio, no ponto em que o componente deve ser inserido. O
componente MainMenu inserido no formulrio, como mostra a Figura 6.1.
4. Usando o Object Inspector, altere a propriedade Name do componente para MenuPrincipal.
O componente MainMenu um exemplo de componente no-visual, isto , no estar visvel durante
a execuo do aplicativo. Ele apenas representa um menu e fornece acesso a um editor de menus; nesse
caso, portanto, a sua posio no formulrio no de grande relevncia.
Figura 6.1: Insero de um componente MainMenu no formulrio principal da aplicao.
Observe que, quando voc inseriu o componente MainMenu no formulrio, o ambiente atribuiu o
valor MainMenu1 sua propriedade Name e atribuiu esse mesmo valor propriedade Menu do
formulrio (indicando que o menu que ser exibido no formulrio o representado por este
componente). Quando posteriormente voc alterou o valor da propriedade Name do componente
MainMenu para MenuPrincipal, o ambiente de desenvolvimento fez a alterao correspondente na
propriedade Menu do formulrio.
A criao dos menus e itens de menus no Delphi 7 feita em um editor de menus. No prximo tpico
ser mostrado como acessar o editor de menus.
ACESSANDO O EDITOR DE MENUS
Para acessar o editor de menus, execute os seguintes procedimentos:
1. Selecione o componente MenuPrincipal, criado no tpico anterior.
2. D um duplo clique com o boto esquerdo do mouse sobre o componente MainMenu. O
editor de menus exibido, com o primeiro menu selecionado, pronto para ser editado, como
Figura 6.2: O editor de menus.
3. Selecione o Object Inspector e altere o valor da propriedade Name do objeto que est em
destaque (um retngulo que representa o primeiro menu) para MenuSistema.
4. Usando o Object Inspector, altere o valor da propriedade Caption para &Sistema.
5. Selecione novamente o editor de menus.
Como voc pode ver na Figura 6.3, foi criado o menu Sistema em que a letra S aparece sublinhada. Se
voc j est acostumado a usar aplicativos Windows, sabe que uma letra sublinhada em um menu
funciona como uma tecla de atalho, que permite que o menu seja acessado pressionando-se
simultaneamente as teclas Alt e a tecla correspondente letra sublinhada. Foram criados tambm dois
novos espaos: um espao direita, que permite a criao de um novo menu, e um espao sob o menu
Sistema, para que se criem itens desse menu.
Figura 6.3: Criao do menu Sistema.
Os itens de menu (que so objetos da classe TMenuItem) possuem uma propriedade chamada AutoHotKeys que, se configurada
corretamente, impede que dois itens de menu possuam a mesma tecla de atalho.
Esta propriedade pode assumir um dos valores a seguir:
maAutomatic: Caso dois itens de menu possuam a mesma tecla de atalho, a do ltimo item
automaticamente redefinida durante a execuo do aplicativo.
maManual: Caso dois itens de menu possuam a mesma tecla de atalho, a do ltimo item
redefinida mediante uma chamada ao mtodo RethinkHotKeys da classe TMenuItem.
maParent: A redefinio das teclas de atallho de itens de menu segue a regra estabelecida pelo
seu componente-pai. No caso de itens de menu, por exemplo, ser adotado o valor configurado
na propriedade de mesmo nome do componente MainMenu ou PopupMenu que o contm.
Voc tambm pode acessar o editor de menus clicando com o boto direito do mouse sobre o
componente MenuPrincipal e selecionando o item Menu Designer no menu pop-up exibido. Outra
opo consiste em selecionar no Object Inspector a propriedade Items do componente MainMenu.
Crie ainda os seguintes menus para o nosso aplicativo-exemplo:
Menu Scios
Name: MenuSocios
Caption: &Scios
Menu Atividades
Name: MenuAtividades
Caption: &Atividades
Menu Matrcula
Name: MenuMatricula
Caption: &Matrcula
Menu Relatrios
Name: MenuRelatorios
Caption: &Relatrios
Menu Help
Name: MenuHelp
Caption: &Help
Repare que a propriedade Name no pode conter acentuao, o que j no ocorre com a propriedade Caption.
A figura a seguir apresenta o aspecto do formulrio principal da aplicao, aps a incluso destes menus.
Figura 6.4: Aspecto do formulrio principal da aplicao, aps a incluso de todos os menus.
CRIANDO ITENS DE MENU
Como vimos no tpico anterior, a criao de menus e itens de menu feita usando-se o editor de
menus do ambiente de desenvolvimento.
Um item de menu , na realidade, um objeto da classe TMenuItem, cujas principais propriedades de
um item de menu so:
Caption: Uma cadeia de caracteres que define o texto exibido pelo item de menu.
Checked: Uma varivel booleana que define se o item de menu deve ou no exibir uma marca
de verificao, indicando que alguma opo est ativa. No Microsoft Word, por exemplo, uma
marca de verificao no item Rgua do menu Exibir indica que a rgua est sendo exibida.
Enabled: Uma varivel booleana que define se o item de menu est ou no habilitado. Quando
essa propriedade tem o valor False, o item de menu est desabilitado e apresenta um aspecto
acinzentado.
GroupIndex: Essa propriedade define como os menus das janelas-filhas so mesclados com os
menus da janela principal em uma aplicao MDI.
ImageIndex: Define o ndice correspondente imagem do componente Imagelist associado ao
componente MenuPrincipal que ser exibido com o item de menu. Caso no se queira exibir
nenhuma imagem com o menu, o valor dessa propriedade deve ser igual a -1.
Name: Define o nome pelo qual o objeto referenciado no cdigo da aplicao (lembre-se de
que no Delphi um item de menu um objeto da classe TMenuItem).
RadioItem: Uma varivel booleana que define se a marca de verificao de um item de menu
deve ser uma marca circular.
ShortCut: Essa propriedade define a combinao de teclas que executa a mesma ao que um
item de menu. Essa combinao de teclas denominada tecla aceleradora de um item de menu.
Em nossa aplicao, devemos oferecer ao usurio a possibilidade de incluir novos scios, atividades e
matrculas, exclu-los ou alterar os seus dados cadastrais, e a cada uma dessas opes pode corresponder
um item de menu. Alm disso, deve ser capaz de fazer cpia (backup) e restaurao destes dados.
Para criar um item Backup no menu Sistema, execute os seguintes procedimentos:
1. Selecione o espao em branco que foi criado sob o menu Sistema.
2. Selecione o Object Inspector e altere o valor da sua propriedade Name para SistemaBackup.
3. Usando o Object Inspector, altere o valor da propriedade Caption para &Backup.
Figura 6.5: Criao do item Backup no menu Sistema.
Como voc pode ver na Figura 6.5, foi criado o item Backup no menu Sistema. Tambm foi includo
um espao sob o item, para que seja criado um novo item de menu.
Para criar os itens Restaurar e Finalizar deste menu, voc deve proceder de forma semelhante, definindo
as seguintes propriedades para cada um dos itens.
Item Name Caption
Restaurar SistemaRestaurar &Restaurar...
Finalizar SistemaFinalizar &Finalizar...
A Figura 6.6 mostra o estado atual do nosso menu, aps a criao de mais esses dois itens.
Figura 6.6: Estado atual do menu Sistema.
CRIANDO UM SEPARADOR DE ITENS EM UM MENU
Para criar um separador de itens entre os itens Restaurar e Finalizar do menu Sistema, execute os
1. Selecione o item Finalizar do menu Sistema.
2. Pressione a tecla Ins para criar um novo item entre os itens Restaurar e Finalizar. Selecione o
Object Inspector e altere o valor da propriedade Name deste novo item para Separador.
3. Usando o Object Inspector, altere o valor da propriedade Caption para - (isso mesmo, um
sinal de subtrao, usado para criar um separador entre itens de menu).
Pronto! Est criado o separador de itens de menu, como pode ser verificado na figura a seguir.
Figura 6.7: Criando um separador de itens de menu.
Os itens de menu (que so objetos da classe TMenuItem) possuem uma propriedade chamada AutoLineReduction que, se configurada
corretamente, impede a incluso de dois separadores contguos, ou de um separador isolado no final de um menu.
Esta propriedade pode assumir um dos valores a seguir:
maAutomatic: Caso haja separadores contguos, os excedentes sero automaticamente
removidos durante a execuo do aplicativo.
maManual: Caso haja separadores contguos, os excedentes sero removidos durante a execuo
do aplicativo mediante uma chamada ao mtodo RethinkLines da classe TMenuItem.
maParent: A remoo de separadores contguos segue a regra estabelecida pelo seu componente-
pai. No caso de itens de menu, por exemplo, ser adotado o valor configurado para o componente
MainMenu ou PopupMenu que o contm.
CRIANDO TECLAS ACELERADORAS PARA ITENS DE MENU
Para criar teclas aceleradoras para itens de menus, basta definir corretamente sua propriedade ShortCut
no Object Inspector.
Desta maneira, para definir como Ctrl+X as teclas aceleradoras do item Finalizar do menu sistema,
execute os seguintes procedimentos:
1. Acesse o editor de menus.
2. Selecione o item Finalizar deste menu.
3. No Object Inspector, altere o valor da propriedade ShortCut deste item para Ctrl+X.
A figura a seguir apresenta o aspecto deste menu, aps a criao das teclas aceleradoras para o item
Finalizar do menu Sistema.
Figura 6.8: Criao das teclas aceleradoras para o item Finalizar do menu Sistema.
CRIANDO OUTROS ITENS DE MENU
Devemos ainda criar os itens dos demais menus do nosso aplicativo-exemplo, seguindo os procedimentos
que sero apresentados ainda neste tpico.
Para criar um item Cadastrar no menu Scios, execute os seguintes procedimentos:
1. Acesse o editor de menus e selecione o espao em branco que foi criado sob o menu Scios.
2. Selecione o Object Inspector e altere o valor da sua propriedade Name para SociosCadastro.
3. Usando o Object Inspector, altere o valor da propriedade Caption para &Cadastro.
Para criar os itens Alterao,Excluso e Consulta deste menu, voc deve proceder de forma semelhante,
definindo as seguintes propriedades para cada um dos itens.
Item Name Caption
Alterao SociosAlteracao &Alterao...
Excluso SocioExclusao &Excluso
Consulta SocioConsulta &Consulta
uma conveno de que, em programas desenvolvidos para o ambiente Windows, itens de menu que provoquem a exibio de caixas
de dilogo terrminem com trs pontinhos.
Execute procedimentos semelhantes para criar os itens Cadastro, Alterao, Excluso e Consulta do
menu Atividades.
Para o menu Matrculas, crie os itens Cadastro, Excluso e Consulta.
Para o menu Relatrios, crie os itens Scios, Atividades e Matrculas.
Para o menu Help, crie os itens Tpicos e Sobre.
INCLUINDO UM MENU POP-UP NA SUA APLICAO
A incluso de um menu pop-up em uma aplicao feita por meio da insero de um componente
PopupMenu no seu formulrio principal (o componente PopupMenu est situado na pgina Standard
da paleta de componentes e o terceiro componente desta pgina).
Para inserir um componente do tipo PopupMenu no formulrio principal da aplicao, execute os
1. Selecione o formulrio principal.
2. Selecione o componente PopupMenu, na pgina Standard da paleta de componentes.
3. Clique novamente com o mouse sobre o formulrio, no ponto em que o componente deve ser
inserido. O componente PopupMenu inserido no formulrio, como mostra a Figura 6.9.
4. Usando o Object Inspector, altere a propriedade Name do componente para PopupPrincipal.
Figura 6.9: Insero de um componente PopupMenu no formulrio principal da aplicao.
5. Usando o Object Inspector, altere a propriedade PopupMenu do componente FormPrincipal
para PopupPrincipal.
CRIANDO ITENS DE MENU EM UM MENU POP-UP
A criao de itens em um menu pop-up feita por meio de um editor de menus vinculado a este
componente, acessado da mesma forma que no caso do menu principal da aplicao.
Para criar itens do menu pop-up, execute os seguintes procedimentos:
1. Selecione o componente PopupPrincipal, criado no tpico anterior.
2. D um duplo clique com o boto esquerdo do mouse sobre o componente PopupMenu. O
editor de menus pop-up exibido, com o primeiro item selecionado, pronto para ser editado,
como mostra a Figura 6.10.
Figura 6.10: Acessando o editor de menus com base no menu pop-up.
3. Altere os valores das suas propriedades Name e Caption para PopupSistema e &Sistema,
respectivamente.
4. Pressione o boto de seta para baixo, para exibir o espao destinado ao prximo menu pop-up,
Figura 6.11: Criando o menu Sistema no menu pop-up.
5. Pressione o boto de seta para baixo, para exibir o espao destinado ao prximo menu pop-up.
6. Altere os valores de suas propriedades Name e Caption para PopupScios e &Scios,
respectivamente.
8. Altere os valores de suas propriedades Name e Caption para PopupAtividades e &Atividades,
respectivamente.
10. Altere os valores de suas propriedades Name e Caption para PopupMatriculas e &Matrculas,
respectivamente.
12. Altere os valores de suas propriedades Name e Caption para PopupRelatorios e &Relatrios,
respectivamente.
14. Altere os valores de suas propriedades Name e Caption para PopupHelp e &Help,
respectivamente.
Seu menu pop-up ficar com o aspecto da Figura 6.12.
Figura 6.12: Criando o menu pop-up.
CRIANDO SUBMENUS NO MENU POP-UP
No tpico anterior criamos os menus pop-up da nossa aplicao. Para incluir os seus itens, no entanto,
teremos que introduzir o conceito de submenu.
Para inserir os itens do menu Sistema no submenu correspondente, execute os seguintes procedimentos:
1. Selecione o menu Sistema do menu pop-up e pressione o boto direito, para exibir o menu
suspenso mostrado na Figura 6.13.
Figura 6.13: Exibindo o menu suspenso do editor de menus.
2. Selecione o item Create Submenu, e o submenu ser criado, como mostra a Figura 6.14. A seta
exibida ao lado da palavra Sistema foi includa automaticamente pelo editor de menus.
3. Altere os valores das propriedades Name e Caption desse item para PopupSistemaBackup e
&Backup, respectivamente.
Figura 6.14: Criando um submenu no menu pop-up do editor de menus.
4. Pressione o boto de seta para baixo, para criar um novo item.
5. Altere os valores das suas propriedades Name e Caption para PopupSistemaRestaurar e
&Restaurar, respectivamente.
6. Pressione o boto de seta para baixo, para criar um novo item e crie um separador de itens de menu.
7. Pressione o boto de seta para baixo, para criar um novo item.
8. Altere os valores das suas propriedades Name e Caption para PopupSistemaFinalizar e &Finalizar,
respectivamente.
Seu menu pop-up deve estar como o da Figura 6.15.
Figura 6.15: Criando itens em um submenu no menu pop-up do editor de menus.
Repita os passos anteriores para criar os demais submenus.
Para o menu pop-up Scios, inclua os seguintes itens no seu submenu.
Para o menu pop-up Atividades, inclua os seguintes itens no seu submenu.
Para o menu pop-up Matriculas, inclua os seguintes itens no seu submenu.
Para o menu pop-up Relatrios, inclua os seguintes itens no seu submenu.
Item Name Caption
Cadastro PopupSociosCadastro &Cadastro...
Alterao PopupSociosAlteracao &Alterao...
Excluso PopupSocioExclusao &Excluso
Consulta PopupSocioConsulta &Consulta
Item Name Caption
Cadastro PopupAtividadesCadastro &Cadastro...
Alterao PopupAtividadesAlteracao &Alterao...
Excluso PopupAtividadesExclusao &Excluso
Consulta PopupAtividadesConsulta &Consulta
Item Name Caption
Cadastro PopupMatriculasCadastro &Cadastro...
Excluso PopupMatriculasExclusao &Excluso
Consulta PopupMatriculasConsulta &Consulta
Para o menu pop-up Help, inclua os seguintes itens no seu submenu.
Item Name Caption
Scios PopupRelatoriosSocios &Scios...
Atividades PopupRelatoriosAtividades &Atividades
Matrculas PopupRelatoriosMatriculas &Matrculas
Item Name Caption
Tpicos PopupHelpTopicos &Tpicos
Sobre PopupHelpSobre &Sobre
ASSOCIANDO EVENTOS A ITENS DE MENU
A associao de um evento a um item de menu feita de forma semelhante associao de um evento
a qualquer outro componente ou formulrio (lembra-se da criao de um procedimento associado ao
evento OnActivate de um formulrio, feita no Captulo 2?).
A nica diferena que os itens de menu no so vistos como um componente inserido em um
formulrio e, para selecionar um deles, voc precisa usar a caixa de seleo de objetos do Object In-
spector ou o editor de menus.
Vamos agora criar um evento associado ao item Finalizar do menu Sistema. Como o prprio nome
indica, queremos que esse item de menu finalize a execuo da aplicao; logo devemos incluir a
seguinte linha de cdigo no procedimento associado ao evento OnClick desse item de menu:
Application.Terminate;
Como esse o formulrio principal da aplicao e, ao se fechar o formulrio principal de uma aplicao, esta encerrada, poderamos
alternativamente incluir a seguinte linha de cdigo, em vez da mostrada anteriormente:
FormPrincipal.Close;
Para criar o procedimento associado ao evento OnClick do item Finalizar do menu Sistema, basta
executar os seguintes procedimentos:
1. Na caixa de seleo de objetos do Object Inspector, selecione o objeto SistemaFinalizar, como
3. D um duplo clique no campo direita do evento a ser definido (no caso, o evento OnClick).
4. Inclua a linha de cdigo acima, como mostra a Figura 6.17.
Figura 6.16: Selecionando o objeto SistemaFinalizar no Object Inspector.
Agora sua aplicao pode ser finalizada selecionando-se o item Finalizar do menu Sistema ou por meio
da combinao de teclas Ctrl+X. Execute a aplicao e verifique o seu funcionamento.
Figura 6.17: Incluso de uma linha de cdigo no procedimento associado ao evento OnClick de um item de menu.
DEFININDO PROCEDIMENTOS ASSOCIANDO EVENTOS PARA ITENS DE MENU POP-UP
A associao de um evento a um item de menu pop-up feita de forma semelhante associao de um
evento a um item de menu.
Se voc tiver um item de menu pop-up que deva realizar a mesma tarefa de um item de menu
comum, basta estabelecer uma correspondncia entre o procedimento associado ao evento OnClick
desse ltimo e o evento OnClick do item de menu pop-up. A isso denominamos compartilhamento
de eventos (dois objetos compartilham um mesmo evento). Esse o caso, por exemplo, do item
Finalizar do menu pop-up Sistema.
Para criar o procedimento associado ao evento OnClick do item Finalizar do menu pop-up Sistema,
faa o seguinte:
1. Na caixa de seleo de objetos do Object Inspector, selecione o objeto PopupSistemaFinalizar,
3. Associe o evento OnClick desse objeto ao evento OnClick do objeto SistemaFinalizar, como
mostra a Figura 6.19. Dessa forma, o mesmo procedimento estar associado aos eventos OnClick
dos objetos SistemaFinalizar e PopupSistemaFinalizar.
Figura 6.18: Selecionando o objeto PopupSistemaFinalizar no Object Inspector.
Figura 6.19: Definindo o procedimento associado ao evento OnClick do objeto PopupSistemaFinalizar.
CAPTULO 7 MANIPULANDO FORMULRIOS E CAIXAS DE DILOGO
Captulo
Manipulando Formulrios
e Caixas de Dilogo
7
Neste captulo sero apresentadas as tcnicas de manipulao de caixas de dilogo, exemplificadas por
meio da criao de uma caixa de dilogo usada para exibir informaes sobre direitos autorais.
FUNDAMENTOS EM: CRIAO DE CAIXAS DE DILOGO
PR-REQUISITOS
Conhecimentos bsicos sobre a linguagem Object Pascal (j apresentados nos captulos anteriores).
METODOLOGIA
Apresentao e descrio das principais caractersticas de uma caixa de dilogo.
TCNICA
Apresentao dos procedimentos necessrios exibio de caixas de dilogo a partir da janela principal de uma aplicao.
CAIXAS DE DILOGO ELEMENTOS DE INTERFACE
QUE DO VIDA AO SEU APLICATIVO
Geralmente uma aplicao com interface grfica composta por vrias janelas e caixas de dilogos
(que o Delphi 7 chama de formulrios).
Neste captulo sero apresentados os procedimentos necessrios criao de uma caixa de dilogo
bastante simples e sua exibio a partir da seleo de um item de menu.
CRIANDO UMA CAIXA DE DILOGO DE DIREITOS AUTORAIS
Para criar uma caixa de dilogo de direitos autorais, voc pode usar um dos formulrios predefinidos
do Delphi 7, executando os seguintes procedimentos:
1. Selecione o item New/Other do Delphi 7. Ser exibida a caixa de dilogo New Items, tambm
denominada Repositrio de Objetos.
Figura 7.1: Seleo da opo About box da caixa de dilogo New Items.
2. Selecione a opo About box na pgina Forms da caixa de dilogo New Items, como mostra a
Figura 7.1.
3. Clique no boto OK, para fechar essa caixa de dilogo e criar o novo formulrio.
Ser criada a caixa de dilogo About, mostrada na Figura 7.2.
Figura 7.2: A caixa de dilogo About.
Altere as propriedades Name e Caption desse formulrio para FormSobre e Informaes Gerais,
respectivamente.
Repare que essa caixa de dilogo j possui os seguintes componentes:
Um componente do tipo boto de comando, que o ambiente chamou de OkButton.
Um componente de exibio de imagens, que o ambiente chamou de ProgramIcon.
Quatro componentes do tipo Label para exibio de texto, que o ambiente chamou de
ProductName, Version, Copyright e Comments.
Um componente chamado Panel1, usado para criar um painel no formulrio.
No prximo tpico mostraremos os procedimentos necessrios personalizao desta caixa de dilogo.
PERSONALIZANDO A CAIXA DE DILOGO DE DIREITOS AUTORAIS
Para personalizar a sua caixa de dilogo de direitos autorais, execute os seguintes procedimentos:
1. Altere o valor da propriedade Caption de ProductName para Cadastro de Scios.
2. Altere o valor da propriedade Caption do label Version para Verso 1.0.
3. Altere o valor da propriedade Caption do label Copyright para Direitos Autorais.
4. Altere o valor da propriedade Caption do label Comments para o nome do autor do programa.
5. Altere o valor da propriedade WordWrap do label Comments para False.
6. Defina como True o valor da propriedade AutoSize de todos os labels (j deve estar definido).
7. Centralize horizontalmente todos os labels, usando a caixa de dilogo Alignment, apresentada
no Captulo 5.
8. Defina como True a propriedade AutoSize do componente ProgramIcon.
9. Carregue a imagem do arquivo Earth.bmp na propriedade Picture do componente ProgramIcon.
10. Salve o arquivo de cdigo associado a este formulrio com o nome UnitSobre.pas, usando o
item Save As do menu File.
Seu formulrio deve ficar como o da Figura 7.3.
Figura 7.3: Aspecto final do formulrio de direitos autorais.
EXIBINDO UMA CAIXA DE DILOGO
No tpico anterior criamos uma caixa de dilogo chamada FormSobre, contendo informaes de direitos
autorais. No entanto, surge agora um pequeno problema: como exibir esse formulrio? evidente que
esse formulrio dever ser exibido quando o usurio selecionar o item Sobre do menu Help.
Um formulrio (ou uma caixa de dilogo) pode ser exibido de duas formas: como uma caixa de dilogo
modal ou como uma caixa de dilogo no-modal. Uma caixa de dilogo modal aquela que no
permite que se execute qualquer ao no programa fora da caixa de dilogo at que esta seja fechada,
ao passo que uma caixa de dilogo no-modal no impe essa restrio. Um exemplo de caixa de
dilogo modal a caixa de dilogo Abrir do Microsoft Word, acessada por meio do item Abrir do menu
Arquivo. Um exemplo de caixa de dilogo no-modal a caixa de dilogo Localizar do Microsoft
Word, acessada por meio do item Localizar do menu Edit.
Um objeto formulrio apresenta dois mtodos (herdados da classe TForm), denominados Show e
ShowModal, que podem ser usados para exibi-lo. Para exibir uma caixa de dilogo modal, basta executar
o mtodo ShowModal do formulrio, enquanto, para exibir uma caixa de dilogo no-modal, basta
executar o seu mtodo Show.
Inicialmente, temos de definir se essa caixa de dilogo ser modal ou no-modal. Neste exemplo,
vamos optar por uma caixa de dilogo modal, como geralmente acontece na maioria das aplicaes.
No nosso caso queremos que, quando o item Sobre do menu Help for selecionado, essa caixa de
dilogo seja exibida como uma caixa de dilogo modal.
Temos ento a seguinte situao: quando o usurio selecionar o item Sobre do menu Help (quando
ocorrer o evento OnClick desse item de menu), a caixa de dilogo deve ser exibida como uma caixa de
dilogo modal (o mtodo ShowModal do formulrio deve ser executado).
Dessa maneira, devemos incluir a seguinte linha de cdigo no procedimento associado ao evento
OnClick do item Sobre do menu Help do formulrio principal da aplicao:
FormSobre.ShowModal;
Para incluir essa linha de cdigo no procedimento associado ao evento OnClick do item Sobre do
menu Help, basta executar os seguintes procedimentos:
1. Exiba o formulrio FormPrincipal e selecione o objeto HelpSobre (que um item de menu),
usando a caixa de seleo de objetos do Object Inspector.
3. D um duplo clique no campo direita do evento a ser definido (no caso, o evento OnClick).
4. Inclua a linha de cdigo acima, como mostra a Figura 7.4.
Figura 7.4: Incluso de uma linha de cdigo no procedimento associado ao evento OnClick de um item de menu.
5. Associe esse procedimento ao evento OnClick do item Sobre do menu pop-up criado no captulo
anterior.
Tente executar a sua aplicao. Infelizmente ela no compilar de imediato e ser exibida uma mensagem
de advertncia (Figura 7.5), informando que o formulrio FormPrincipal faz referncia ao formulrio
FormSobre, declarado na unit UnitSobre, mas cujo nome no est includo na clusula uses da unit
que declarou o formulrio Principal, e esta caixa de dilogo pergunta se voc deseja inclu-la. Selecione
o boto Yes, e o ambiente de desenvolvimento far as alteraes necessrias.
Figura 7.5: Mensagem de advertncia do Delphi.
Tente executar outra vez a sua aplicao. Agora o programa funcionar normalmente e, quando o
usurio selecionar o item Sobre do menu Help, a caixa de dilogo ser exibida como uma caixa de
dilogo modal, como mostra a Figura 7.6.
Figura 7.6: Exibindo uma caixa de dilogo modal.
No prximo tpico, vamos examinar o componente boto de comando, includo automaticamente
no formulrio quando o mesmo foi criado, usando a caixa de dilogo New Items.
O COMPONENTE BOTO DE COMANDO
O boto de comando um dos objetos vistos com maior freqncia nos aplicativos com interface
grfica. Ele apresenta formato retangular e normalmente se espera que algo acontea quando
selecionado com o boto esquerdo do mouse.
O boto de comando (um objeto da classe TButton) est localizado na pgina Standard da paleta
de componentes ( o stimo componente desta pgina), e suas principais propriedades so
apresentadas a seguir.
PRINCIPAIS PROPRIEDADES DO COMPONENTE BOTO DE COMANDO
Entre as principais propriedades de um boto de comando, possvel destacar:
Cancel: Essa propriedade, que pode assumir os valores True (verdadeiro) e False (False), indica
se o boto deve associar o seu evento OnClick ao pressionamento da tecla Esc isto , se voc
definir o seu valor como True, pressionar a tecla Esc ser equivalente a selecionar o componente
com o boto esquerdo do mouse.
Caption: Essa propriedade define o texto a ser exibido pelo boto.
Default: Essa propriedade, que pode assumir os valores True (verdadeiro) e False (False), indica
se o boto deve associar o seu evento OnClick ao pressionamento da tecla Enter isto , se
voc definir o seu valor como True, pressionar a tecla Enter ser equivalente a selecionar o
componente com o boto esquerdo do mouse.
Enabled: Essa propriedade, que pode assumir os valores True (verdadeiro) e False (Falso), indica
se o boto est habilitado. Quando o boto est desabilitado (a propriedade Enable tem o valor
False), apresenta um aspecto acinzentado e no pode ser selecionado.
Font: Define a fonte do texto exibido na propriedade Caption.
ModalResult: Essa propriedade usada para encerrar a execuo de um quadro de dilogo
modal. Voc pode definir qualquer uma das constantes predefinidas do Delphi, como mrNone,
mrOk, mrCancel, mrAbort, mrRetry, mrIgnore, mrYes, mrNo e mrAll.
Quando voc criou o formulrio FormSobre, o ambiente atribuiu o valor mrOk propriedade
ModalResult do componente OkButton. Dessa maneira, quando esse boto for selecionado com o
boto esquerdo do mouse, o formulrio ser fechado.
CAPTULO 8 FUNDAMENTOS DO PROJETO DE APLICATIVOS DE BANCO DE DADOS
Captulo
Fundamentos do Projeto de
Aplicativos de Banco de Dados
8
Neste captulo, voc ser apresentado aos fundamentos do projeto de aplicativos de bancos de dados com
o Delphi 7. Sero apresentados os fundamentos do mecanismo de acesso a bancos de dados multiplataforma
denominado DBExpress, incorporado na verso 6 do Delphi.
FUNDAMENTOS EM: MECANISMOS DE ACESSO A BANCOS DE DADOS
PR-REQUISITOS
Utilizao de utilitrios para o ambiente Windows.
METODOLOGIA
Apresentao e descrio dos principais conceitos relacionados ao desenvolvimento de aplicaes que acessem bancos de dados, e seus
mecanismos de acesso.
TCNICA
Apresentao dos mecanismos de acesso a bancos de dados presentes no Delphi 7.
MECANISMOS DE ACESSO A BANCOS DE DADOS
Um dos fatores que impulsionaram o sucesso das verses anteriores do Delphi foi a capacidade de se
criar uma aplicao capaz de acessar diferentes tipos de bancos de dados, com praticamente nenhuma
alterao na sua interface. Uma mesma aplicao poderia ser desenvolvida para acessar tabelas Para-
dox e, com pequenas alteraes, acessar tabelas do Interbase, do Access, SQL Server ou qualquer outro
dos principais bancos de dados disponveis no mercado. A escalabilidade de aplicaes era uma realidade.
Isso se deve ao fato de, desde o lanamento da sua primeira verso, uma aplicao desenvolvida em
Delphi no acessar diretamente um banco de dados, mas faz-lo atravs de uma camada intermediria,
denominada mecanismo de acesso.
Inicialmente, o nico mecanismo de acesso disponvel era o Borland Database Engine BDE um
conjunto de DLLs desenvolvido pela prpria Borland. A aplicao acessava o BDE e este acessava o
banco de dados.
A partir da verso 5, o Borland Delphi passou a incluir componentes especiais, que permitiam que a
aplicao acessasse outro mecanismo de acesso a banco de dados o ADO (Activex Data Objects) da
Microsoft. Alm disso, foram tambm includos componentes para acesso nativo (e exclusivo) ao
interbase (denominados Interbase Express).
O lanamento da verso 6 do Delphi (junto com o Kylix) trouxe um novo mecanismo de acesso
denominado DBExpress presente nos dois ambientes de desenvolvimento e que facilita o
desenvolvimento de aplicaes multiplataforma. O Delphi 6, no entanto, continuava a oferecer suporte
ao BDE e ao ADO, e estes mecanismos continuam presentes na verso 7.
Embora este livro tambm aborde o acesso a bancos de dados via BDE e ADO, inicialmente ser abordado
o DBExpress, por ser multiplataforma e se tratar da nova aposta da Borland no que se refere a mecanismos
CAPTULO 8 FUNDAMENTOS DO PROJETO DE APLICATIVOS DE BANCO DE DADOS
de acesso a bancos de dados (a Borland j anuncia, inclusive, que deixar de dar suporte ao BDE,
embora este ainda esteja presente).
FUNDAMENTOS EM: CONCEITOS FUNDAMENTAIS SOBRE BANCOS DE DADOS
PR-REQUISITOS
Noes bsicas sobre dados e informaes.
METODOLOGIA
Apresentao e descrio dos termos fundamentais relacionados criao e acesso a bancos de dados.
CONCEITOS FUNDAMENTAIS
Um banco de dados consiste em uma forma organizada de armazenamento de informaes, mas seu
conceito no representa uma inovao da era da informtica. H muito tempo as corporaes (empresas,
escolas, hospitais, rgos governamentais, etc.) que necessitam manipular grande quantidade de
informaes armazenam dados de forma organizada e, antes que os custos da implantao de sistemas
informatizados cassem a nveis compatveis com a realidade econmica das pequenas e mdias
empresas, estas organizavam seus dados e informaes em enormes arquivos de ao.
A informatizao trouxe, entre outros benefcios, a impressionante reduo do espao necessrio ao
armazenamento dessas informaes e uma maior rapidez em sua consulta e pesquisa. Atualmente,
muitas empresas disponibilizam um mesmo conjunto de informaes em um banco de dados acessvel
localmente, pela Internet ou atravs de uma Intranet.
Antes da informatizao, esses bancos de dados consistiam em enormes arquivos de ao utilizados
para armazenar dados dos scios, dados de atividades, etc.
Os dados dos scios, por exemplo, eram guardados em fichas armazenadas em ordem alfabtica, e cada
ficha continha uma srie de campos nos quais eram guardadas informaes como nome, endereo,
CPF, etc. Quando se cadastrava um novo scio, uma nova ficha (um novo registro) deveria ser preenchida
e armazenada (inserida) no local correto. Qualquer operao de busca de informaes deveria ser feita
dessa forma, e o armazenamento incorreto de uma ficha produzia enormes transtornos. O mesmo era
vlido para as informaes das atividades, matrculas, etc.
Embora os antigos arquivos de ao tenham sido substitudos, muitos dos seus conceitos permanecem
vlidos. Os dados dos scios continuam a ser armazenados em arquivos, porm estes so agora arquivos
de dados armazenados em meios magnticos especiais (disquetes, discos rgidos, CDs-ROM, Zip disks,
DVDs, etc.). Esses arquivos tambm contm fichas, que passaram a ser denominadas registros, e em
cada registro (como nas fichas) existem diversos campos.
No caso do nosso arquivo de scios, por exemplo, cada registro ser usado para armazenar as informaes
de um determinado scio, com um campo para o nome, outro para o endereo, etc.
CUSTOS
Ao se desenvolver um aplicativo que acesse bancos de dados deve-se considerar tambm os custos
envolvidos na aquisio de licenas que permitam a sua utilizao de forma legal. Estes custos, no
entanto, podem ser considerados elevados para pequenas empresas, e para estas situaes h a alternativa
de se empregar bancos de dados gratuitos, como a verso OpenSource do Interbase e o MySQL.
Neste livro abordaremos em nossos exemplos o Interbase, que por ser um produto da Borland e estar
presente no prprio CD do Delphi, certamente estar ao alcance de nossos leitores.
PLANEJANDO SEU BANCO DE DADOS
Como j enfatizamos no Captulo 4, um planejamento adequado fundamental para o desenvolvimento
de uma boa aplicao.
Neste livro, adotamos como exemplo o desenvolvimento de uma aplicao para gerenciamento de
dados referentes aos scios de um clube. Numa organizao deste tipo, comum que se armazenem
informaes a respeito dos scios, atividades e matrculas.
Vejamos agora como estes dados devem ser organizados: cada scio do clube pode se matricular em zero,
uma ou mais atividades. Podemos ento concluir que um scio pode estar relacionado a vrias atividades.
A recproca tambm verdadeira, pois numa nica atividade podem estar matriculados mais de um scio.
Neste caso, diz-se que h uma relao de N x N entre scios e atividades, e desta forma no seria muito
razovel armazenar todos os dados de um scio juntamente com os dados de cada uma das atividades (e vice-
versa), pois estaramos armazenando repetidamente (vrias vezes) uma grande quantidade de informaes.
A concluso a que se chega que os dados dos scios e das atividades devem ser armazenados em
tabelas distintas, e cada scio deve ter um cdigo exclusivo, que o diferencie dos demais. Na linguagem
de banco de dados, um campo exclusivo em uma tabela (cujo valor no pode ser repetido) denominado
chave primria. Toda tabela deve ter ao menos um campo definido como chave primria, e quando
isto no for possvel pode-se usar mais de um campo, definindo-se o que se chama de uma chave
primria composta. O mesmo se aplica s atividades.
Alm disso, para cada scio devem-se armazenar, alm do seu cdigo exclusivo, dados como o seu
nome, seu CPF e seu endereo. Da mesma forma, para cada atividade devem-se armazenar tambm sua
descrio e o valor da atividade.
Alm das tabelas que armazenam os dados dos scios e das atividades, devemos ainda criar uma tabela
para armazenar os dados das matrculas. Nesta tabela devem ser definidos campos para armazenar o
cdigo do scio e da atividade, (criando, desta forma, um relacionamento entre os scios e as atividades.
Agora que j fizemos um esboo de como os dados sero armazenados, veremos no prximo captulo
como criar as tabelas que sero usadas no nosso aplicativo.
Nesta edio do livro optei por criar, nesta primeira parte, uma aplicao extremamente simples, de modo a facilitar a assimilao dos
conceitos fundamentais, sem a necessidade de se digitar cdigos extensos e sujeitos a erros.
CAPTULO 9 FUNDAMENTOS DE BANCOS DE DADOS
Captulo
Fundamentos de Bancos de Dados
9
Neste captulo voc aprender a criar as tabelas do Interbase que sero acessadas pela nossa aplicao.
A opo pelo Interbase considerou o fato de que h uma verso que acompanha o prprio Delphi, e
por ser multiplataforma, facilitando a migrao, para o ambiente Linux, de aplicaes desenvolvidas
com base na biblioteca CLX e nesta base de dados.
FUNDAMENTOS EM: CRIAO DE TABELAS DO INTERBASE
PR-REQUISITOS
Utilizao de utilitrios para o ambiente Windows.
METODOLOGIA
Apresentao e descrio dos principais conceitos relacionados ao desenvolvimento de tabelas para bancos de dados do Interbase.
TCNICA
Apresentao dos procedimentos necessrios criao de tabelas do tipo Interbase com o Database Desktop, utilitrio para criao de
tabelas que acompanha o Delphi 7.
Nesta primeira parte do livro so apresentados os procedimentos necessrios ao desenvolvimento de
aplicaes que acessam localmente tabelas do Interbase.
CRIANDO UM BANCO DE DADOS NO INTERBASE
O Interbase um banco de dados cliente-servidor. Nada nos impede, no entanto, de utiliz-lo como
um banco de dados Desktop (ou local).
Para criar um banco de dados chamado Clube no Interbase, voc deve executar os seguintes
procedimentos:
1. Iniciar o aplicativo IBConsole, disponvel no grupo de programas Interbase do Windows, e
cuja tela principal apresentada na Figura 9.1.
2. Selecione o item Local Server, no painel esquerdo do IBConsole, como mostrado na Figura 9.2.
3. D um duplo clique sobre o item selecionado ou selecione o item Login do menu Server, para
exibir a caixa de dilogo Server Login mostrada na Figura 9.3.
4. Nesta caixa de dilogo, voc deve, inicialmente, usar o nome de usurio (username) SYSDBA e
a senha (password) masterkey, que j esto preconfigurados.
5. Selecione o boto Login para fechar esta caixa de dilogo e se conectar ao servidor local.
Figura 9.1: A tela principal do IBConsole.
Figura 9.2: Selecione o item Local Server no painel esquerdo do IBConsole.
Figura 9.3: A caixa de dilogo Server Login.
Um servidor pode conter diversos bancos de dados. Repare que neste caso a conexo foi feita ao servidor, e no a um banco de dados.
6. Selecione o item Create Database, do menu Database, para exibir a caixa de dilogo mostrada
na figura a seguir, na qual so fornecidas as informaes necessrias criao do banco de
dados. Voc dever informar o nome do banco de dados (com extenso gdb, que a extenso
padro para um banco de dados do Interbase) a ser criado e um alias (neste caso, CLUBE).
Figura 9.4: A caixa de dilogo Create Database.
7. Selecione o boto Ok, para fechar a caixa de dilogo e criar o banco de dados. O painel esquerdo
do IBConsole mostra o banco de dados que acabou de ser criado (identificado pelo seu alias),
Figura 9.5: Criao do banco de dados CLUBE.
8. Com o banco de dados CLUBE selecionado, selecione o item Disconnect do menu Database.
Ser exibida uma mensagem solicitando uma confirmao para fechar o banco de dados, como
Figura 9.6: Mensagem de confirmao.
CRIANDO TABELAS COM O DATABASE DESKTOP
O Database Desktop um utilitrio independente que acompanha o Borland Delphi 7, mas que pode ser
acessado a partir de seu ambiente de desenvolvimento. Ser utilizado por estar disponvel e por simplificar
o processo de criao de tabelas de bancos de dados do Interbase para o ambiente Windows.
Para iniciar o Database Desktop a partir do ambiente de desenvolvimento integrado do Borland Delphi
7, basta selecionar o item Database Desktop no menu Tools.
Ser exibida a janela principal do Database Desktop, como mostra a Figura 9.7.
Figura 9.7: A janela principal do Database Desktop.
Antes de criarmos uma tabela para o nosso banco de dados, devemos criar um Alias (nome alternativo)
para o mesmo, o que pode ser feito a partir do prprio Database Desktop. Este alias no deve ser
confundido com aquele usado pelo IBConsole.
Para criar um alias para o banco de dados Clube com o Database Desktop, execute os seguintes
procedimentos:
1. Selecione o item Alias Manager no menu Tools do Database Desktop. Ser exibida a caixa de
dilogo mostrada na Figura 9.8.
Figura 9.8: A caixa de dilogo Alias Manager do Database Desktop.
2. Selecione o boto New para criar um novo Alias, e configure-o como mostrado na Figura 9.9.
3. Selecione o boto Ok, para criar o alias. Ser mostrada a mensagem de confirmao mostrada
na Figura 9.10. Selecione Yes para confirmar a sua criao.
Figura 9.9: Configurando o Alias na caixa de dilogo Alias Manager do Database Desktop.
Figura 9.10: Confirmando a criao do Alias.
Para criar uma tabela com o Database Desktop, execute os seguintes procedimentos:
1. Selecione o item New do menu File. Ser exibido um submenu, com as opes QBE Query, SQL
File e Table, como mostra a Figura 9.11.
Figura 9.11: O submenu exibido quando o item New do menu File selecionado.
2. Selecione o item Table do submenu File. Ser exibida a caixa de dilogo Create Table, como
Figura 9.12: A caixa de dilogo Create Table.
A caixa de dilogo Create Table permite que voc selecione os seguintes tipos de tabela:
Paradox 7
Paradox 5.0 for Windows
Paradox 4
Paradox 3.5
Visual dBASE
dBASE for Windows
dBASE IV
dBASE III+
FOXPRO
MS ACCESS
SYBASE
MSSQL
INFORMIX
INTRBASE
DB2
ORACLE
3. Selecione a opo INTRBASE, como mostrado na figura anterior, e depois clique no boto OK.
Ser exibida a caixa de dilogo Create INTRBASE Table, na qual podem ser definidos os campos
que iro compor um registro da tabela (Figura 9.13).
Figura 9.13: A caixa de dilogo Create INTRBASE Table.
DEFININDO NOMES PARA OS CAMPOS DOS REGISTROS DE UMA TABELA
Para cada campo em um registro deve ser definido um nome (coluna Field Name), o tipo de dado que ser
armazenado no campo (coluna Type), seu tamanho (coluna Size) e o nmero de casas decimais (Dec).
Vamos comear a definir os nomes dos campos para a tabela que armazenar os dados dos scios.
Repare que, quando iniciamos a criao da nossa tabela, a coluna Field Name do primeiro campo
aparece em destaque, indicando que o seu valor j pode ser digitado. Para definir o nome do primeiro
campo, que armazenar o cdigo do scio, execute os seguintes procedimentos:
1. Digite a expresso CodigoSocio.
2. Pressione a tecla de seta para baixo.
Pronto! Repare que neste momento a coluna Field Name do segundo campo aparece em destaque,
Figura 9.14: A caixa de dilogo Create INTRBASE Table aps
a definio de um nome para o primeiro campo.
Repita os passos anteriores para definir os seguintes nomes para os campos subseqentes da tabela:
Nome, Sobrenome, Endereo, Complemento, Bairro, Cidade, Estado, CEP, Telefone e CPF.
Aps definir todos os nomes para os campos, a caixa de dilogo Create INTRBASE Table dever ter a
aparncia mostrada na Figura 9.15.
a definio de um nome para todos os campos.
DEFININDO TIPOS PARA OS CAMPOS DOS REGISTROS DE UMA TABELA
Conforme mencionado anteriormente, cada campo de um registro deve armazenar um valor de um
determinado tipo. Para tabelas do tipo INTRBASE, os seguintes tipos podem ser utilizados:
SHORT: Inteiros entre -32768 e 32767.
LONG: Inteiros entre -2,147,483,648 e 2,147,483,648.
FLOAT: Real de preciso simples (at 7 dgitos significativos de preciso).
DOUBLE: Real de preciso dupla (at 15 dgitos significativos de preciso).
VARCHAR(n): Armazena at n caracteres.
DATE: Data
BLOB: Objeto binrio de tamanhoVarivel.
CHAR(n): Armazena n caracteres. (mximo 32767).
Os tipos disponveis podem variar de um banco de dados para outro, e inclusive entre verses distintas de um mesmo banco de dados.
Para definir o tipo do campo CodigoCliente como LONG, execute os seguintes procedimentos:
1. Selecione com o boto esquerdo do mouse a coluna Type do campo CodigoSocio.
2. Digite LONG.
ou:
1. No menu pop-up exibido quando se pressiona o boto direito do mouse (Figura 9.16), selecione
a opo LONG.
2. Pressione a tecla de seta para baixo.
Figura 9.16: Menu pop-up, usado para selecionar um tipo para um campo.
Repita os passos anteriores para definir os demais campos como alfanumricos (do tipo VARCHAR).
Alguns leitores podem pensar que o campo CEP, por exemplo, deveria ser definido como um campo numrico, pois armazena um grupo
de nmeros. Cabe salientar, no entanto, que, se o campo fosse definido como numrico, no poderia armazenar caracteres especiais
como um hfen (-), que geralmente separa os cinco primeiros dgitos dos trs ltimos em um CEP, nem poderia ser criada uma mscara
para exibio do campo (as mscaras de exibio sero vistas mais adiante). Alm disso, como no ser feita nenhuma operao
aritmtica sobre os valores armazenados neste campo, no h nenhum inconveniente em defini-lo como alfanumrico. Esta observao
tambm se aplica aos campos CPF e Telefone.
Aps definir os tipos de todos os campos, a caixa de dilogo Create INTRBASE Table dever apresentar
o aspecto mostrado na Figura 9.17.
a definio de tipos para todos os campos.
DEFININDO OS TAMANHOS PARA OS CAMPOS DOS REGISTROS DE UMA TABELA
Aps definir o tipo de cada campo, deve-se definir o seu tamanho especificando-se o valor desejado
na coluna Size.
Os campos alfanumricos (VARCHAR) podem armazenar at 32767 caracteres. Logo, devemos armazenar
na sua coluna Size o nmero mximo de caracteres que ser permitido ao usurio digitar em um
campo deste tipo.
Na nossa tabela de clientes, o primeiro campo do tipo LONG, razo pela qual no ser atribudo um
valor para o seu tamanho na coluna Size.
Para definir o tamanho do campo Nome em 15 caracteres, execute os seguintes procedimentos:
1. Selecione com o boto esquerdo do mouse a coluna Size do campo Nome.
2. Digite o valor 15.
3. Pressione a tecla de seta para baixo, para passar para o prximo campo.
A caixa de dilogo Create Paradox INTRBASE dever ficar com o aspecto indicado na Figura 9.18.
a definio do tamanho para o campo Nome.
Repita os passos anteriores, definindo os seguintes valores para os tamanhos dos demais campos:
Sobrenome: 25.
Endereo: 25.
Complemento: 10.
Bairro: 20.
Cidade: 20.
Estado: 2.
CEP: 8.
Telefone: 10.
CPF: 11.
A caixa de dilogo Create INTRBASE Table dever ficar com o aspecto indicado na Figura 9.19.
Figura 9.19: A caixa de dilogo Create INTRBASE Table aps a definio de tamanho para os campos.
Definimos um tamanho igual a 10 para o campo telefone, considerando-se a nova modalidade de ligao interurbana. Um telefone do
Rio de Janeiro poderia, por exemplo, ser cadastrado como (21)2345-6789, e no armazenaremos os caracteres no-numricos.
DEFININDO CAMPOS DE PREENCHIMENTO OBRIGATRIO
Para que os dados armazenados em um registro possuam significado, necessrio que seja fornecida
uma quantidade mnima de informaes, isto , alguns campos devem ser obrigatoriamente preenchidos.
No faria muito sentido, por exemplo, cadastrar um scio sem armazenar o seu nome e sobrenome,
razo pela qual estes campos devero ser preenchidos pelo usurio.
Para definir o campo Nome como um campo de preenchimento obrigatrio, execute os seguintes
procedimentos:
1. Selecione o campo Nome, clicando sobre o mesmo com o boto esquerdo do mouse.
2. Marque a caixa de verificao Required Field, como mostra a Figura 9.20.
Repita os passos anteriores para definir os campos CodigoSocio e sobrenome como campos de
preenchimento obrigatrio.
Figura 9.20: A caixa de dilogo Create INTRBASE Table aps a definio
do campo Nome como um campo de preenchimento obrigatrio.
CRIANDO NDICES
Quando desejamos ordenar ou filtrar os registros de uma tabela por um determinado campo (ou grupo
de campos), devemos associ-lo a um ndice. Cada ndice deve ter um nome que o identifique, como por
exemplo ind_Nome para um ndice correspondente ao Nome de um cliente. recomendvel que se
atribuam aos ndices nomes fceis de memorizar, para auxiliar durante a fase de codificao do aplicativo.
Um ndice pode ser simples, no caso de s corresponder a um campo, ou composto, no caso de se
referir a mais de um campo.
No caso da tabela scios, vamos definir os seguintes ndices:
Socios_Nome: Um ndice composto, correspondente aos campos Nome e Sobrenome.
Socios _Bairro: Um ndice simples, correspondente ao campo Bairro.
Socios _Cidade: Um ndice simples, correspondente ao campo Cidade.
Para definir o ndice Socios _Nome, execute os seguintes procedimentos:
1. Selecione o boto Define Indexes. da caixa de dilogo Create INTRBASE Table., para exibir a
caixa de dilogo Define Secondary Index, mostrada na Figura 9.21.
Figura 9.22: Selecionando os campos de um ndice.
Figura 9.21: A caixa de dilogo Define Index.
2. Selecione com o mouse o campo Nome na caixa de lista Fields.
3. Pressione a tecla Shift e, mantendo-a pressionada, selecione o campo Sobrenome (para selecionar
um campo sem desmarcar outros que j tenham sido previamente selecionados, mantenha
pressionada a tecla Ctrl). A Figura 9.22 mostra os campos selecionados na caixa de lista Fields.
4. Selecione com o boto esquerdo do mouse o pequeno boto que exibe uma seta para a direita,
para movimentar os campos selecionados para a caixa de lista Indexed Fields, como mostra
a Figura 9.23.
Figura 9.23: Movendo campos para a caixa de lista Indexed Fields.
5. Selecione o boto OK, e ser exibida a caixa de dilogo Save Index As, na qual deve ser digitado
o nome do ndice, como mostra a Figura 9.24.
Figura 9.24: Definindo o Nome do ndice.
Repare que a caixa de dilogo anterior exibe a expresso<Table>_, indicando que devemos apenas completar o nome do ndice, pois
o termo <Table> ser substitudo pelo nome da tabela. Neste caso, por exemplo, bastar informar <Table>_Nome.
Repita os passos anteriores para definir os ndices simples Socios_Bairro e Socios_Cidade descritos
anteriormente.
Repare que, aps a sua definio, os nomes dos ndices so exibidos na caixa de dilogo Create INTRBASE
Table, como mostra a Figura 9.25.
Figura 9.25: A caixa de dilogo Create INTRBASE Table aps a definio dos ndices.
SALVANDO UMA TABELA
Para salvar a tabela de clientes, execute os seguintes procedimentos:
1. Selecione o boto Save As na caixa de dilogo Create INTRBASE Table para exibir a caixa de
dilogo Save Table As, na qual devem ser definidos um nome para a tabela e o alias
correspondente ao banco de dados no qual ser armazenada, como mostra a Figura 9.26. No
nosso exemplo, demos o nome Socios para a tabela e a armazenamos no banco de dados
representado pelo alias Clube.
2. Clique no boto Salvar.
Figura 9.26: Salvando uma tabela com a caixa de dilogo Save Table As.
Se for exibida uma caixa de dilogo de Login, preencha com o username e password descritos anteriormente.
Pronto! Sua tabela foi salva.
Aps salvar a tabela, o Interbase coloca todas as informaes de nomes de campos e de ndices em letras maisculas.
INSERINDO DADOS EM UMA TABELA ATRAVS DO DATABASE DESKTOP
Como j foi dito anteriormente, o Database Desktop um utilitrio independente, que permite a
criao e o gerenciamento de tabelas de bancos de dados. Embora voc esteja desenvolvendo um
aplicativo que ser capaz de fazer este tipo de gerenciamento de uma maneira mais personalizada,
nada o impede de incluir uma massa de dados atravs do Database Desktop para testar alguns aspectos
do seu aplicativo, antes mesmo de implementar toda a sua funcionalidade.
Caso queira inserir registros na sua tabela, basta coloc-la em modo de edio, o que pode ser feito
executando-se os seguintes procedimentos:
1. Selecione o item Table do submenu Open do menu File do Database Desktop. Ser exibida a
caixa de dilogo Open Table, mostrada na Figura 9.27, na qual dever ser selecionada a tabela
a ser aberta clicando no boto Abrir (No esquea de especificar o Alias Clube).
Figura 9.27: Abrindo uma tabela com a caixa de dilogo Open Table.
2. Selecione o item Edit Data do menu Table, ou pressione a tecla de funo F9, para colocar a
tabela em modo de edio, conforme indicado na Figura 9.28.
Figura 9.28: Colocando a tabela em modo de Edio.
Vamos incluir em nossa tabela os seguintes dados, referentes a trs clientes (fictcios, naturalmente):
Cliente 1:
CodigoCliente: 1
Nome: Augusto.
Sobrenome: Campos da Silva.
Endereo: Rua dos Andradas 435.
Complemento: Apto 905.
Bairro: Cascadura.
CEP: 22089-157.
Cidade: Rio de Janeiro.
Estado: RJ.
Telefone: (21) 25768495
CPF: 85725415608.
Cliente 2:
CodigoCliente: 2
Nome: Cludia.
Sobrenome: Moreira Bastos.
Endereo: Avenida Santa Ceclia 387.
Complemento: Bl. B, 101.
Bairro: Itaim.
CEP: 05980555.
Cidade: So Paulo.
Estado: SP.
Telefone: (11)37629645
CPF: 15954235704.
Cliente 3:
CodigoCliente: 3
Nome: Paulo.
Sobrenome: Aroeira dos Santos.
Endereo: Avenida Guanabara 87.
Complemento:
Bairro: Graja.
CEP: 22587344.
Cidade: Rio de Janeiro.
Estado: RJ.
Telefone: (21)21225489
CPF: 68575454601.
Para digitar os dados do primeiro cliente, faa o seguinte:
1. Digite o nmero 1 no campo CodigoCliente
2. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo Nome.
3. Digite a palavra Augusto no campo Nome.
4. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo Sobrenome.
5. Digite a expresso Campos da Silva no campo.
6. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo Endereco.
7. Digite a expresso Rua dos Andradas 435 no campo.
8. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo Complemento.
9. Digite a expresso Apto 905 no campo.
10. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo Bairro.
11. Digite a expresso Cascadura no campo.
12. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo Cidade.
13. Digite Rio de Janeiro no campo.
14. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo Estado.
15. Digite RJ no campo.
16. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo CEP.
17. Digite a expresso 22089157 no campo.
18. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo Telefone.
20. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o campo CPF.
22. Pressione a tecla Enter ou a tecla de seta para a direita para passar para o prximo registro.
Repita os procedimentos anteriores para inserir os dados dos outros dois clientes. Aps inserir os dois
novos registros, sua tabela deve ficar com o aspecto mostrado na Figura 9.29.
Figura 9.29: Aspecto da tabela aps a incluso dos trs registros.
CONSTRUINDO AS DEMAIS TABELAS DO APLICATIVO
Neste tpico sero apresentadas as caractersticas das demais tabelas que compem o nosso aplicativo.
Alm da tabela Socios, sero necessrias as seguintes tabelas:
Atividades, para armazenar os dados das atividades.
Matriculas, para armazenar os dados das matrculas de scios em atividades.
CRIANDO A TABELA ATIVIDADES
Executando os procedimentos descritos nos tpicos anteriores, crie uma tabela chamada Atividades
no banco de dados Clube, com os seguintes campos:
Nome do Campo Tipo Tamanho Dec
CodigoAtividade LONG
Nome VARCHAR 25
Valor Numeric 8 2
Aps a definio dos campos indicados anteriormente, esta tabela deve apresentar, no Database Desk-
top, o aspecto mostrado na Figura 9.30.
Figura 9.30: Criao da tabela Atividades.
Defina todos os campos desta tabela como campos requeridos.
CRIANDO NDICES PARA A TABELA DE ATIVIDADES
Para a tabela Atividades crie o seguinte ndice, executando os procedimentos descritos nos tpicos anteriores:
Atividade_Nome, para o campo Nome.
SALVANDO A TABELA ATIVIDADES
Salve a tabela no banco de dados representado pelo Alias CLUBE, com o nome Atividades, seguindo os
mesmos passos descritos anteriormente para salvar a tabela Clientes.
INCLUINDO REGISTROS NA TABELA DE ATIVIDADES
Coloque a tabela criada no tpico anterior em modo de edio e inclua os seguintes registros:
Atividade 1:
CodigoAtividade: 1
Nome: Natao.
Valor: 30.00
Atividade 2:
CodigoAtividade: 2
Nome: Musculao.
Valor: 25.00
Atividade 3:
CodigoAtividade: 3
Nome: Basquete.
Valor: 40.00
CRIANDO A TABELA DE MATRCULAS
Executando os procedimentos descritos nos tpicos anteriores, crie uma tabela chamada Matriculas
no banco de dados Clube, com os seguintes campos:
Nome do Campo Tipo Tamanho Dec
Socio LONG
Atividade LONG
Defina estes dois campos como campos requeridos.
Nesta tabela o campo Socio, do tipo LONG, armazenar o cdigo do scio desta matrcula. Desta
maneira, se precisarmos obter dados a respeito do scio, basta consultar na tabela de scios o registro
cujo valor do campo CodigoSocio seja igual ao valor armazenado no campo Socio do registro corrente
na tabela Matriculas. Veremos mais adiante como se estabelece um relacionamento entre tabelas,
usando um campo como ligao entre elas. O mesmo se aplica ao campo Atividade.
CRIANDO NDICES PARA A TABELA DE MATRCULAS
Para a tabela de Matrculas crie os seguintes ndices, executando os procedimentos descritos nos tpicos
anteriores:
Matriculas_Socio, para o campo Socio.
Matriculas_Atividade, para o campo Atividade.
Pronto! As tabelas do nosso banco de dados j esto criados, e no prximo captulo sero
apresentados os componentes que permitem o acesso a estas tabelas a partir de aplicaes
desenvolvidas com o Delphi 7.
CAPTULO 10 CRIAO DE UM FORMULRIO PARA MANIPULAO DE TABELAS DE BANCOS DE DADOS COM O DBEXPRESS
Captulo
Criao de um Formulrio Para
Manipulao de Tabelas de Bancos
de Dados com o DBExpress
10
Neste captulo sero apresentados os procedimentos necessrios criao de um formulrio para acesso
a banco de dados no Delphi 7 usando como mecanismo de acesso o DBExpress. Sero utilizados os
componentes das paletas Data Access e DBExpress (que, como j descrito anteriormente, um
mecanismo de acesso a dados multiplataforma).
CRIAO DE FORMULRIOS PARA ACESSO A DADOS
PR-REQUISITOS
Noes bsicas sobre bancos de dados.
METODOLOGIA
Apresentao e descrio dos principais conceitos relacionados criao de formulrios para acesso a bancos de dados.
TCNICA
Apresentao e descrio dos procedimentos necessrios criao de formulrios para acesso a dados com o Delphi 7.
Para criar um formulrio para acessar os dados da tabela de Scios, voc deve executar os seguintes
procedimentos:
1 Abra o projeto Socio.dpr.
2 Selecione o item New/Form do menu File do Delphi 7. Ser criado um formulrio em branco.
3. Altere a propriedade Name deste formulrio para FormCadastraSocios.
4. Altere a propriedade Caption deste formulrio para Cadastro de Scios.
5. Coloque um componente SQLConnection, situado na pgina DBExpress da paleta de
componentes ( o primeiro componente desta pgina). Este um componente no-visual (logo,
sua posio no formulrio indiferente), e representa um banco de dados acessado pelo formulrio.
6. D um duplo clique sobre este componente para exibir a caixa de dilogo Connection Editor,
mostrada na Figura 10.1 (esta caixa de dilogo tambm pode ser exibida selecionando o item
Edit Connection Properties no menu pop-up exibido quando voc seleciona o componente
com o boto direito do mouse).
7. Crie uma nova conexo chamada Clube, selecionando o boto com o smbolo + desta caixa
de dilogo. Ser exibida a caixa de dilogo New Connection, mostrada na Figura 10.2
8. Configure esta caixa de dilogo como mostrado na Figura 10.3 e selecione o boto Ok para
fech-la. Repare, como mostrado na caixa de dilogo apresentada na figura a seguir, que a
nova conexo foi selecionada para ser configurada. Configure esta conexo como indicado,
e selecione o boto Ok.
Repare na Figura 10.3 que, para este exemplo, foi criada uma conexo chamada Clube, tendo sido
configuradas, na caixa de dilogo DBExpress Connection Editor, as propriedades DriverName, Data-
base, UserName e Password.
Figura 10.1: A caixa de dilogo DBExpress Connection Editor.
Figura 10.2: A caixa de dilogo New Connection.
Figura 10.3: Criao da nova conexo.
Caso voc queira usar uma conexo j definida para outro banco de dados do Interbase, basta alterar as propriedades da conexo,
usando a caixa de dilogo Value List editor, exibida quando voc seleciona os trs pontinhos existentes direita da propriedade Params
do componente, mostrada na Figura 10.4.
Figura 10.4: A caixa de dilogo Value List editor.
9. Atribua o valor True propriedade Connected do componente. Se a propriedade LoginPrompt
deste componente estiver configurada como True, ser exibida a caixa de dilogo Database
Login (na qual devero ser informados o nome do usurio UserName, e senha password).
Caso contrrio, ser feita uma tentativa de conexo com os valores default de User_Name e
Password j fornecidos.
10. Aps estabelecer a conexo ao banco de dados (definindo a propriedade Connected como True),
altere o valor da propriedade Name do componente SQLConnection para SQLConnectionClube.
11. Insira no formulrio um componente SQLTable, tambm situado na pgina DBExpress ( o
quinto componente desta pgina).
12. Altere o valor da propriedade Connection deste componente para SQLConnectionClube.
13. Defina SOCIOS como o valor da propriedade TableName deste componente.
14. Altere o valor da propriedade Name deste componente para SQLTableSocios.
15. Altere para True o valor da sua propriedade Active.
O componente SQLTable um componente no-visual, e que representa a tabela de Scios no formulrio.
16. Coloque um componente DataSource (disponvel como o primeiro componente da pgina
Data Access da paleta de componentes) no formulrio e atribua o valor SQLTableSocios sua
propriedade Dataset. Este componente responsvel pela ligao entre os componentes de
acesso a dados e os componentes de visualizao (apresentados a seguir).
17. Altere o valor da propriedade Name deste componente para DataSouceSocios.
Figura 10.5: Aspecto do formulrio, aps a incluso dos componentes de acesso a dados, com o componente Datasource selecionado.
Pronto! J esto colocados os componentes de acesso a dados. Posteriormente abordaremos esta categoria
de componentes em maiores detalhes.
Como os componentes inseridos at o momento so componentes no-visuais, sua posio no formulrio irrelevante.
18. Insira um componente Label (pgina Standard da paleta de componentes) no formulrio, e
altere o valor da sua propriedade Caption para Cdigo.
19. Insira um componente DBEdit (quarto componente da pgina Data Controls da paleta de
componentes) no formulrio. Este componente, vinculado a uma tabela atravs de um
componente Datasource, representa um dos campos do registro corrente. Suas principais
propriedades so Name (que define o nome do componente), Datasource (que define o nome
do componente Datasource ao qual est vinculado) e DataField (que define o nome do campo
acessado pelo componente). Altere o valor da propriedade Name deste componente para
DBEditCodigoSocio.
20. Altere o valor da propriedade Datasource deste componente para DatasourceClientes.
21. Altere o valor da propriedade DataField deste componente para CodigoSocio. Repare que, neste
momento, o valor deste campo correspondente ao primeiro registro exibido.
22. Repita os procedimentos anteriores de forma semelhante para cada um dos outros campos da
tabela Clientes. Disponha os componentes de forma semelhante mostrada na figura a seguir
(ou com o layout que voc julgar mais conveniente).
Figura 10.6: Aspecto do formulrio, aps a incluso dos componentes de visualizao.
23. Selecione o item Save As do menu File e salve-o com o nome UnitCadastroSocios.pas.
24. Inclua um boto de comando do tipo BitBtn (boto de figura, situado na pgina Additional da
paleta de componentes) no formulrio.
25. Altere os valores das propriedades Kind e ModalResult deste componente para bkCustom e
mrNone, respectivamente.
26. Altere os valores das propriedades Name, Caption e Default deste boto de comando para
BotaoCadastrar, &Cadastrar e False, respectivamente.
27. Inclua um segundo boto de comando do tipo BitBtn (boto de figura, situado na pgina
Additional da paleta de componentes) no formulrio.
28. Altere o valor da propriedade Kind deste componente para bkClose.
29. Altere os valores das propriedades Name e Caption deste boto de comando para BotaoFechar
e &Fechar, respectivamente.
O fato de se definir o valor da propriedade Kind deste componente como bkClose far com que, ao ser selecionado este boto, o
formulrio seja fechado. Alm disso, se voc alterar o valor da propriedade Kind depois de alterar o valor da propriedade Caption, o
valor desta ltima propriedade ser alterado para &Close.
30. Reposicione e redimensione os botes, de maneira que o mesmo fique com um aspecto
semelhante ao apresentado na Figura 10.7.
31. Defina da seguinte maneira o procedimento associado ao evento OnShow deste formulrio:
procedure TFormCadastraSocios.FormShow(Sender: TObject);
begin
DBEditCodigoSocio.SetFocus;
SQLTableSocios.Open;
SQLTableSocios.Append;
end;
Neste procedimento, executado sempre que o formulrio exibido, so executados os mtodos Open
e Append do componente SQLTableSocios, da classe SQLTable. O mtodo Open ativa o acesso tabela.
O mtodo Append adiciona um novo registro em branco. Evidentemente, o mtodo Open no
necessrio se mantivermos a propriedade Active do componente como True. Desta forma, altere o
valor da propriedade Active do componente SQLTableSocios para False. Faa o mesmo para a propriedade
Connected do componente SQLConnectionClube.
Figura 10.7: Aspecto do formulrio, aps a incluso dos botes de comando.
Atribuir o valor True propriedade Active do componente SQLTable equivale a executar o mtodo open deste componente. Ao atribuir o
valor True propriedade Active do componente SQLTableSocios este tentar estabelecer a conexo atravs do componente SQLConnectionClube.
Se a propriedade Connected deste componente estiver definida como False, o aplicativo tentar redefini-la como True.
32. Defina da seguinte maneira o procedimento associado ao evento OnClick do componente
BotoCadastrar:
procedure TFormCadastraSocios.BotaoCadastrarClick(Sender: TObject);
begin
SQLTableSocios.Post;
SQLTableSocios.Append;
end;
O mtodo Post responsvel por gravar o ltimo registro criado pelo mtodo Append. Aps a gravao
do registro, um novo registro criado com outra chamada ao mtodo Append.
O mtodo SetFocus do componente DBEdit responsvel por redirecionar o foco da aplicao (o
cursor) para o componente DBEditCodigoSocio.
33. Defina da seguinte maneira o procedimento associado ao evento OnClose do formulrio:
procedure TFormCadastraSocios.FormClose(Sender: TObject;
var Action: TCloseAction);
begin
SQLTableSocios.Delete;
end;
Desta maneira, o ltimo registro criado por um mtodo Append, mas no gravado com um mtodo
Post, ser apagado.
34. Inclua a seguinte linha de cdigo no procedimento associado ao evento OnClick do item
cadastro do menu Scios.
FormCadastraSocios.Showmodal.
35. Compile a aplicao. Ser exibida a mensagem de erro mostrada na figura a seguir, indicando
que a unit unitCadastraSocios no foi includa na clusula uses da unit referente ao formulrio
principal. Selecione o boto Yes.
Figura 10.8: Mensagem de erro.
36. Execute e teste a aplicao. Ao selecionar o item Cadastro do menu Socios, ser exibida a
mensagem de erro mostrada na figura a seguir:
Figura 10.9: Mensagem de erro.
Esta mensagem indica que a aplicao est tentando editar uma tabela atravs de um componente
disponvel apenas para leitura. Esta a primeira diferena do DBExpress para os demais mecanismos
de acesso: O DBExpress (ao contrrio do BDE e do ADO) unidirecional, e no permite a edio
direta dos registros (exceto em comandos SQL) apenas a sua consulta, e desde que esta seja feita de
forma unidirecional.
Para contornar este problema, devem-se utilizar os componentes DatasetProvider e ClientDataset (pgina
Data Access da paleta de componentes), que em conjunto armazenam e gerenciam na memria o
conjunto de registros acessados pelo componente SQLTable, e podem editar estes conjunto de registros
(devendo posteriormente aplicar estas alteraes ao banco de dados, mediante uma chamada ao mtodo
Applyupdates do componente ClientDataset).
No prximo tpico, sero apresentados os procedimentos necessrios utilizao dos componentes
DatasetProvider e ClientDataset.
UTILIZANDO OS COMPONENTES DATASETPROVIDER E CLIENTDATASET
Para contornar o problema apresentado no tpico anterior, voc dever executar os seguintes
procedimentos:
1. Inclua um componente DatasetProvider no formulrio.
2. Altere as propriedades Name e Dataset deste componente para DatasetProviderSocios e
SQLTableSocios, respectivamente.
3. Inclua um componente ClientDataset no formulrio.
4. Altere as propriedades Name e ProviderName deste componente para ClientDatasetSocios e
DatasetProviderSocios, respectivamente.
5. Altere a propriedade Dataset do componente DatasourceSocios para ClientDatasetSocios.
6. Defina como True o valor da propriedade Active do componente ClientDatasetSocios. Aps
realizar estas alteraes, o formulrio dever ficar como mostrado na figura a seguir.
Figura 10.10: Aspecto do formulrio, aps a incluso e configurao dos componentes DatasetProvider e ClientDataset.
7. Redefina da seguinte maneira o procedimento associado ao evento OnShow deste formulrio:
begin
ClientDatasetSocios.Open;
ClientDatasetSocios.Append;
end;
8. Redefina da seguinte maneira o procedimento associado ao evento OnClick do componente
BotaoCadastrar:
procedure TFormCadastraSocio.BotaoCadastrarClick(Sender: TObject);
begin
ClientDatasetSocios.Post;
ClientDatasetSocios.Append;
end;
Desta forma, uma cpia dos registros ser manipulada localmente pelo componente ClientDataset.
9. Redefina da seguinte maneira o procedimento associado ao evento OnClose do formulrio:
begin
ClientDatasetSocios.Delete;
ClientDatasetSocios.ApplyUpdates(0);
end;
importante destacar, neste caso, a chamada ao mtodo ApplyUpdates do componente ClientDataset,
responsvel por efetivar no banco de dados as alteraes realizadas no conjunto de registros manipulados
localmente pelo componente. Lembre-se de que, ao ativar a conexo com o banco de dados, este
componente recebeu uma cpia dos registros armazenados na tabela, e todas as incluses, excluses e
alteraes foram feitas nesta cpia. O mtodo ApplyUpdates responsvel por gravar estas alteraes
no banco de dados, recebendo como parmetro um nmero inteiro que identifica o nmero de erros
permitidos em tal operao (entenda por erros as inconsistncias entre os registros obtidos inicialmente
e aqueles existentes no banco de dados no momento em que sero efetivamente registradas tais alteraes
(neste caso, definido como igual a zero).
10. Selecione o componente ClientDatasetSocios com o boto direito do mouse, para exibir o seu
menu pop-up, como mostrado na figura a seguir.
Figura 10.11: Acessando o menu pop-up do componente ClientDataset.
11. Selecione o item Fields Editor neste menu pop-up, para exibir a janela do editor de campos,
Figura 10.12: Acessando o editor de campos do componente ClientDataset.
12. Selecione com o boto direito do mouse a rea branca desta janela para exibir o menu pop-up
do Field Editor, mostrado na figura a seguir.
Figura 10.13: Acessando o menu pop-up do editor de campos do componente ClientDataset.
13. Neste menu popup, selecine o item Add All Fields. Sero criados os objetos que representam os
campos, como mostrado na Figura 10.14.
14. A classe TFormCadastraSocios passa a incluir, entre seus campos, objetos que representam os
campos da tabela, como mostrado no trecho de cdigo reproduzido a seguir:
TFormCadastraSocios = class(TForm)
SQLConnectionClube: TSQLConnection;
SQLTableSocios: TSQLTable;
s DataSourceSocios: TDataSource;
Label1: TLabel;
DBEditCodigoSocio: TDBEdit;
BotaoCadastrar: TBitBtn;
BotaoFechar: TBitBtn;
DataSetProviderSocios: TDataSetProvider;
ClientDataSetSocios: TClientDataSet;
ClientDataSetSociosCODIGOSOCIO: TIntegerField;
ClientDataSetSociosNOME: TStringField;
ClientDataSetSociosSOBRENOME: TStringField;
ClientDataSetSociosENDERECO: TStringField;
ClientDataSetSociosCOMPLEMENTO: TStringField;
ClientDataSetSociosBAIRRO: TStringField;
ClientDataSetSociosCIDADE: TStringField;
ClientDataSetSociosESTADO: TStringField;
ClientDataSetSociosCEP: TStringField;
ClientDataSetSociosTELEFONE: TStringField;
ClientDataSetSociosCPF: TStringField;
procedure FormShow(Sender: TObject);
procedure BotaoCadastrarClick(Sender: TObject);
procedure FormClose(Sender: TObject; var Action: TCloseAction);
private
public
end;
Repare que o campo CEP, por exemplo, representado pelo objeto ClientDataSetSociosCEP, do tipo
TstringField.
Figura 10.14: Incluindo os objetos que representam os campos da tabela no editor de campos do componente ClientDataset.
15. Inclua componentes Labels e DBEdits correspondentes aos demais campos da tabela de Scios.
Para isso, selecione no Fields Editor os objetos que representam os demais campos e arraste
estes componentes para o formulrio, como mostrado nas Figuras 10.15 e 10.16.
Reposicione e redimensione estes componentes para que seu formulrio fique com o aspecto mostrado
na Figura 11.17.
Atribua nomes adequados aos diversos componentes DBEdit, como DBEditSobrenomeSocio,
DBEditEnderecoSocio, etc., para facilitar sua identificao no cdigo da aplicao.
Figura 10.15: Arrastando os objetos que representam os demais campos da tabela de Scios a partir do editor de campos para o formulrio.
Figura 10.16: Criando os objetos para acessar os demais campos da tabela de Scios a partir do formulrio.
Figura 10.17: Criando os componentes para acessar os demais campos da tabela de Scios a partir do formulrio.
O COMPONENTE DBEDIT
Este componente, usado anteriormente, exibe o valor de um campo do registro corrente e permite que
o usurio altere o seu valor. Entre as propriedades deste componente, podemos destacar:
DataSource: Esta propriedade define o componente que nos fornecer a conexo a um
componente que representa uma tabela ou um banco de dados.
Name: Esta propriedade define o nome pelo qual o componente ser referenciado no programa.
DataField: Esta propriedade especifica o campo da tabela cujo valor ser exibido.
No nosso exemplo, temos diversos controles deste tipo, todos com a propriedade DataSource igual a
DataSourceSocios e cuja propriedade DataField vale, respectivamente: Nome, Sobrenome, Endereo,
Complemento, Bairro, Cidade, Estado, CEP, Telefone e CPF. Neste caso, como usamos o Fields Editor, estas
propriedades foram configuradas automaticamente quando os componentes foram criados no formulrio.
O componente que exibe o valor do campo Nome, por exemplo, possui as seguintes propriedades:
DataSource: DataSourceSocios
DataField: Nome
Name: DBEditNomeSocio
DEFININDO MSCARAS PARA OS CAMPOS
Uma deficincia que este formulrio apresenta a seguinte: nada impede que o usurio digite um valor
como abcde-fgh ou xasdr-auy, no campo CEP, pois ambos so strings de caracteres e podem ser
armazenadas em campos alfanumricos.
Para restringir os caracteres que o usurio pode digitar em um componente que representa um campo
de uma tabela, devemos definir uma mscara para este campo.
Para definir uma mscara para um campo, voc deve atribuir um valor propriedade EditMask do
objeto que representa o campo (criado com o editor de campos). Estes objetos esto definidos na classe
do formulrio, mas no sero visualizados como componentes, embora voc possa acess-los atravs
do Object Inspector para definir suas propriedades (como a propriedade EditMask, por exemplo).
1. Usando a caixa de seleo de objetos do Object Inspector, selecione o objeto
ClientDataSetSociosCEP, como mostra a Figura 10.18.
Uma vez selecionado o objeto que representa o campo, o prximo passo consiste em definir um valor
para a sua propriedade EditMask.
A propriedade EditMask constituda de trs partes, separadas por ponto-e-vrgula. A primeira parte
representa a mscara propriamente dita; a segunda parte define se apenas os caracteres digitados (valor
igual a 0 o default) ou toda a mscara deve ser armazenada na tabela (valor igual a 1); a terceira parte
especifica o caractere usado para representar espaos em branco (o default _).
Figura 10.18: Selecionando o objeto ClientDataSetSociosCEP.
SIGNIFICADO DOS CARACTERES USADOS NA PROPRIEDADE EDITMASK
A seguir so mostrados os caracteres que podem ser usados na definio da propriedade EditMask:
!: Se um! aparecer na mscara, caracteres em branco no so armazenados como dados.
>: Se um > aparecer na mscara, todos os caracteres seguintes estaro em letras maisculas, at
que seja encontrado um caractere igual a <.
<: Se um < aparecer na mscara, todos os caracteres seguintes estaro em letras minsculas, at
que seja encontrado um caractere igual a >.
<>: Significa que as letras maisculas e minsculas sero armazenadas como digitadas pelo usurio.
\: Os caracteres que seguem este sinal sero tratados como caracteres literais.
L: Este caractere faz com que apenas caracteres alfabticos (a-z e A-Z) sejam aceitos nesta posio.
l: Este caractere faz com que apenas caracteres alfabticos (a-z e A-Z) sejam aceitos nesta posio,
mas aceita que sejam omitidos.
A: Este caractere faz com que apenas caracteres alfanumricos (0-9, a-z e A-Z) sejam aceitos
nesta posio.
a: Este caractere faz com que apenas caracteres alfanumricos (0-9, a-z e A-Z) sejam aceitos
nesta posio, mas aceita que sejam omitidos.
C: Este caractere faz com que quaisquer caracteres sejam aceitos nesta posio.
c: Este caractere faz com que quaisquer caracteres sejam aceitos nesta posio, mas aceita que
sejam omitidos.
0: Este caractere faz com que apenas caracteres numricos (0-9) sejam aceitos nesta posio.
9: Este caractere faz com que apenas caracteres numricos (0-9) sejam aceitos nesta posio,
#: Este caractere faz com que apenas caracteres numricos (0-9) e sinais de mais (+) ou menos
(-) sejam aceitos nesta posio, mas aceita que sejam omitidos.
:: Este caractere (dois-pontos) usado para separar horas, minutos e segundos em dados horrios.
Se outro caractere separador de horas, minutos e segundos for definido nos atributos
internacionais do Painel de Controle do seu sistema, este ser usado em lugar de dois-pontos.
/: Este caractere usado para separar meses, dias e anos que representam dados de datas. Se
outro caractere separador de meses, dias e anos for definido nos atributos internacionais do
Painel de Controle do seu sistema, este caractere ser usado em lugar do caractere /.
;: O ponto-e-vrgula usado para separar os pontos de uma mscara.
_: O caractere _ insere espaos em branco na caixa de edio.
Voc tambm pode definir o valor da propriedade EditMask atravs do Editor de mscaras. Para acessar
este editor, selecione com o mouse as reticncias (...) exibidas do lado direito da propriedade no Object
Inspector. Ser exibida a caixa de dilogo Input Mask Editor, como mostra a Figura 10.19.
Figura 10.19: A caixa de dilogo Input Mask Editor.
Esta caixa de dilogo apresenta as seguintes caractersticas:
Permite que voc selecione uma das mscaras j disponveis na lista Sample Masks.
Permite que voc personalize a mscara na caixa de texto Input Mask.
Permite que voc especifique o caractere usado para representar espaos em branco na caixa de
texto Character for Blanks.
Permite que voc defina se toda a mscara deve ser armazenada na tabela ou apenas os dados
digitados pelo usurio, atravs da caixa de verificao Save Literal Characters.
Permite que voc teste a mscara, digitando valores na caixa de texto Test Input.
Permite que voc carregue um arquivo de mscaras (extenso .dem) e armazene seus dados na
lista de mscaras disponveis selecionando o boto Masks. Experimente criar o seu prprio
arquivo de mscaras, disponibilizando-as atravs da caixa de dilogo Input Mask Editor.
Para definir uma mscara para o campo CEP, atribua o valor 00000\-999;0; propriedade EditMask do
objeto ClientDataSetSociosCEP.
Esta mscara permite que se digitem todos os caracteres ou apenas os cinco primeiros.
Outro campo que deve ter mscara o campo CPF. Defina da seguinte forma a mscara deste campo:
Atribua o valor 000.000.000-00;0; propriedade EditMask do objeto ClientDatasetSociosCPF.
Experimente acrescentar um novo registro e verifique que os campos para os quais foram definidas
mscaras no permitem a digitao de caracteres invlidos.
O COMPONENTE MASKEDIT
Em situaes em que voc precisa definir uma mscara para um texto a ser digitado pelo usurio, mas
este texto no ser armazenado em um campo de um registro, possvel usar o componente MaskEdit,
que tambm possui a propriedade EditMask.
O componente MaskEdit est localizado na pgina Additional da paleta de componentes.
FAZENDO A TECLA ENTER FUNCIONAR COMO TAB
Os usurios que necessitam digitar uma grande quantidade de dados geralmente preferem navegar
pelos diversos controles utilizando a tecla Enter em vez da tecla Tab.
Para incorporar essa funcionalidade ao nosso aplicativo, devemos definir um procedimento associado
ao evento OnKeyPress dos diversos controles com os quais o usurio dever interagir.
Esse procedimento normalmente recebe, como um dos seus parmetros, uma varivel chamada Var
(passada por referncia) que armazena o cdigo da tecla pressionada.
Para verificar se a tecla pressionada foi a tecla Enter, basta verificar se o valor armazenado nessa varivel
igual a #13. Em caso positivo, deve-se atribuir o valor #0 a essa varivel (de forma a evitar que se
escute um bip desagradvel) e utilizar o procedimento SelectNext para transferir o foco para o prximo
controle (prximo de acordo com o valor da propriedade TabOrder).
Este procedimento recebe como parmetros:
O controle atual.
Um valor booleano, indicando se o prximo controle ser o que possui o valor da sua propriedade
TabOrder imediatamente superior ao do controle atual (true) ou imediatamente inferior ao do
controle atual (false).
Um valor booleano, indicando se o prximo controle dever ou no ter o valor da sua
propriedade TabStop igual a True.
Dessa maneira, basta codificar da seguinte forma o procedimento associado ao evento OnKeyPress do
componente DBEditCodigoSocio, procedimento este que dever ser compartilhado pelos demais
componentes DBEdit do formulrio.
procedure TFormCadastraSocios.DBEditCodigoClienteKeyPress(
Sender: TObject; var Key: Char);
begin
if (key = #13) then
begin
Key := #0;
SelectNext((Sender as TWinControl),True,True);
end;
end;
Compartilhe este evento tambm com o componente BotaoCadastrar e defina como False a propriedade
TabStop do componente BotaoFechar.
No esquea de configurar adequadamente a propriedade TabStop dos diversos componentes.
O COMPONENTE DBCOMBOBOX
Nosso formulrio j est funcionando corretamente, mas poderemos aperfeio-lo ainda mais se
considerarmos que, ao invs de exigir do usurio que digite um valor para o campo Estado, podemos
dar a ele a possibilidade de selecionar este valor a partir de uma lista contendo todos os estados da
federao o que pode ser feito utilizando-se o componente DBCombobox, situado na pgina Data
Controls da paleta de componentes.
PROPRIEDADES DO CONTROLE DBCOMBOBOX
O componente DBCombobox, da mesma forma que o componente DBEdit, possui as mesmas
propriedades Datasource e Datafield que definem a tabela e o campo ao qual est vinculado. Entre as
outras principais propriedades deste componente, podem-se destacar:
ItemIndex: Define o ndice da string selecionada da lista. O primeiro item possui o ndice 0, o
segundo possui o ndice 1, etc., at o n-simo item, que possui ndice n-1.
Left e Top: Definem a posio do componente no formulrio.
Name: Esta propriedade define o nome pelo qual o objeto ser referenciado no cdigo da aplicao.
Height e Width: Definem as dimenses do componente.
Style: Define o estilo do componente. Esta propriedade pode assumir os valores descritos na
tabela a seguir:
Valor Significado
TACsDropDown: Cria uma lista drop-down com uma caixa de edio na qual o usurio pode digitar texto.
TAcsSimple: Cria uma caixa de edio sem uma lista drop-down.
Text: Define o texto que est sendo exibido na caixa de texto do componente.
Items: Esta propriedade consiste em uma lista de strings, que associa uma linha de texto a cada
um dos itens da lista. Esta propriedade pode ser alterada mediante a incluso de um trecho de
cdigo ou diretamente no Object Inspector.
PROPRIEDADES DO OBJETO ITEMS (DA CLASSE TSTRINGS)
Entre as propriedades do objeto Items, podem-se destacar:
Sorted: Esta propriedade declarada como uma varivel booleana e define se os itens esto
ordenados alfabeticamente.
Count: Esta propriedade declarada como uma varivel inteira e define o nmero de strings
na lista.
MTODOS DO OBJETO ITEMS (DA CLASSE TSTRINGS)
Entre os mtodos do objeto Items, podem-se destacar:
Add: Adiciona uma string lista.
Para adicionar a string exemplo na lista de strings exibida por um componente do tipo DBComboBox
chamado DBComboBox1, basta incluir uma linha de cdigo como:
DBComboBox1.Items.Add(exemplo);
Clear: Deleta todas as strings da lista.
Para deletar todas as strings na lista de strings exibida por um componente do tipo DBComboBox
DBComboBox1.Items.Clear;
Delete: Remove uma string da lista.
Para remover a string selecionada na lista de strings exibida por um componente do tipo DBComboBox
DBComboBox1.Items.Delete(DBComboBox1.ItemIndex);
Insert: Insere uma string na lista, em uma posio predeterminada.
Valor Significado
TAcsDropDownList: Cria uma lista drop-down sem uma caixa de edio.
TAcsOwnerDrawFixed: Cria uma lista drop-down sem caixa de edio em que os itens podem ser qualquer objeto
definido pelo usurio e no apenas strings, sendo que todos eles tm altura fixa.
TAcsOwnerDrawVariable: Cria uma lista drop-down sem caixa de edio em que os itens podem ser qualquer objeto
definido pelo usurio e no apenas strings, sendo que eles no tm altura fixa.
Para inserir a string exemplo na primeira posio da lista de strings exibida por um componente do
tipo DBComboBox chamado DBComboBox1, basta incluir uma linha de cdigo como:
DBComboBox1.Items.Insert(0,exemplo);
LoadFromFile: Carrega a lista de strings a ser armazenada a partir de um arquivo.
Para colocar o texto armazenado no arquivo dados.dat na lista de strings exibida por um componente
do tipo DBComboBox chamado DBComboBox1, basta incluir uma linha de cdigo como:
DBComboBox1.Items.LoadFromFile(dados.dat);
SaveToFile: Salva a lista de strings em um arquivo.
Para colocar a lista de strings armazenada no componente em um arquivo chamado dados.dat, basta
incluir uma linha de cdigo como:
DBComboBox1.Items.SaveToFile(dados.dat);
A propriedade chamada Items na realidade, uma lista de strings (objeto da classe TStrings) que
permite armazenar uma relao de valores que podem ser selecionados pelo usurio. Neste caso, queremos
armazenar nesta lista de strings as siglas de cada um dos 27 estados da federao, relacionadas a seguir:
AC
AL
AM
AP
BA
CE
DF
ES
GO
MA
MG
MT
MS
PA
PB
PE
PI
PR
RJ
RN
RR
RO
RS
SC
SE
SP
TO
Para substituir o componente DBEditEstadoSocio pelo componente DBCombobox, voc dever executar
os seguintes procedimentos:
1. Selecionar o componente DBEditEstadoSocio e pressionar a tecla Del, para remov-lo.
2. Incluir um componente DBCombobox (o oitavo componente da pgina Data Controls) no
local anteriormente ocupado pelo componente DBEditEstadoSocio.
3. Alterar a propriedade Name deste componente para DBComboboxEstadoSocio.
4. Selecionar as reticncias exibidas direita da propriedade Items deste componente para exibir
a caixa de dilogo String List Editor e digitar as siglas dos 27 estados.
5. Alterar o valor da propriedade Style deste componente para csDropDownList.
6. Utilizando a caixa de dilogo Edit Tab Order (mostrada na figura a seguir e exibida selecionando-
se o item Tab Order no menu pop-up do formulrio), ordenar os componentes como indicado.
Figura 10.20: A caixa de dilogo Edit Tab Order.
7. Compartilhar com este componente o procedimento associado ao evento OnKeyPress do
componente DBEditCodigoSocio (que j est sendo compartilhado pelos demais componentes).
Desta maneira, a tecla Enter funcionar como Tab tambm para este componente.
DESTACANDO O COMPONENTE QUE RECEBE O FOCO
Para que o usurio no se perca durante a digitao de informaes, seria interessante destacar o
componente que possui o foco da aplicao.
Isto pode ser feito codificando-se adequadamente os procedimentos associados ao evento OnEnter e
OnExit do componente. O evento OnEnter ocorre sempre que o componente recebe o foco (nada tem
a ver com a tecla Enter, como pode ser sugerido pelo seu nome). J o evento OnExit ocorre sempre que
o componente perde o foco.
Desta maneira, seria interessante alterarmos a cor do componente quando o mesmo recebe o foco, e
devolver a sua cor original quando o foco sai do componente. Isto pode ser feito definindo-se da seguinte
maneira os procedimentos associados aos Eventos OnEnter e OnExit do componente DBEditCodigoCliente
(a serem compartilhados pelos demais componentes DBEdit). No componente DBCombobox no precisa,
pois far isso automaticamente, e se tentar trat-lo com um DBEdit, provocar um erro.
procedure TFormCadastraSocios.DBEditCodigoSocioEnter(Sender: TObject);
begin
(Sender as TDBEdit).Color := clActiveCaption;
(Sender as TDBEdit).Font.Color := clCaptionText;
end;
procedure TFormCadastraSocios.DBEditCodigoSocioExit(Sender: TObject);
begin
(Sender as TDBEdit).Color := clWindow;
(Sender as TDBEdit).Font.Color := clWindowText;
end;
Gostaria de, neste ponto, fazer uma observao importante. Voc j deve ter reparado que, na maioria
dos procedimentos associados a eventos, existe um parmetro denominado Sender. Este parmetro
muito til quando compartilhamos procedimentos associados a eventos entre diversos componentes,
pois identifica qual destes componentes disparou o evento o que muito importante quando
precisamos alterar as propriedades do componente que disparou o evento (pois precisamos identific-
lo). Como o parmetro Sender definido como sendo um objeto da classe TObject, precisamos trat-
lo como sendo um objeto da classe do componente que disparou o evento o que pode ser feito
usando-se o operador de converso As.
Pronto! Agora nosso formulrio de Cadastro de Clientes est mais interessante e funcional, e deve
apresentar o aspecto mostrado na figura a seguir.
Figura 10.21: Aspecto final do formulrio de Cadastro de Scios.
CAPTULO 11 CRIAO DE UM REPOSITRIO PARA COMPONENTES DE ACESSO A DADOS
Captulo
Criao de um Repositrio Para
Componentes de Acesso a Dados
11
Neste captulo ser apresentado o Data Module, um repositrio de objetos destinado a armazenar
componentes para acesso a bancos de dados, e as vantagens da sua utilizao.
CRIAO DE DATA MODULES
PR-REQUISITOS
Conhecimentos bsicos sobre a linguagem Object Pascal (j apresentados nos captulos anteriores) e os componentes bsicos de acesso a
dados da pgina DBExpress da paleta de componentes.
Noes Bsicas sobre bancos de dados.
METODOLOGIA
Apresentao e descrio dos principais conceitos relacionados criao e utilizao de objetos Data Module.
TCNICA
Apresentao e descrio dos procedimentos necessrios criao de Data Modules para armazenamento de componentes de acesso a dados.
OS OBJETOS DO TIPO DATAMODULE
No captulo anterior foram apresentados os procedimentos necessrios criao de um formulrio no
qual foram inseridos os componentes responsveis por acessar a tabela de dados dos Scios. Esta
abordagem apresenta a desvantagem de que, caso vrios formulrios acessem uma mesma tabela,
todos devero conter estes componentes de acesso. Neste caso, uma boa alternativa consiste em empregar
um Data Module.
Os objetos do tipo DataModule servem como um repositrio para o armazenamento de componentes
no-visuais de acesso a bancos de dados, permitindo que estes sejam acessados pelo formulrio da
aplicao, centralizando o acesso a dados por parte da aplicao.
Para criar um Data Module, voc deve executar os seguintes procedimentos:
1. Selecionar o item New/Data Module do menu File do Delphi 7.
Ou:
1. Selecionar o item New/Other do menu File do Delphi 7, para exibir a caixa de dilogo New
Items, selecionar o item correspondente ao Data Module e o boto Ok.
Ser ento criado um Data Module, como mostrado na figura a seguir.
2. Altere a propriedade Name deste DataModule para Dados.
3. Selecione o item Save as, do menu File, e salve a unidade de cdigo associada a este DataModule
com o nome UnitDados.pas.
Embora o objeto DataModule no seja um formulrio comum, para exibi-lo devem ser executados os mesmos procedimentos usados
para exibir qualquer formulrio.
Figura 11.1: O objeto DataModule.
4. Exiba o formulrio de Cadastro de Scios e selecione os diversos componentes de acesso, como
mostrado na figura a seguir.
Figura 11.2: Selecionando os componentes de acesso a dados no formulrio de Cadastro de Scios.
5. Selecione o item Cut do menu Edit do ambiente de desenvolvimento do Delphi 7.
6. Exiba novamente o Datamodule.
7. Selecione o item Paste do menu Edit do ambiente de desenvolvimento do Delphi 7. Os
componentes de acesso sero includos no formulrio, como mostrado na figura a seguir.
Figura 11.3: Copiando os componentes de acesso a dados do formulrio de cadastro de scios para o Datamodule.
Caso seja necessrio, reposicione os diversos componentes no Datamodule.
8. Exiba novamente o formulrio de Cadastro de Scios e selecione o item Use Unit do menu File
do ambiente de desenvolvimento do Delphi 7. Ser exibida a caixa de dilogo Use Unit, mostrada
na figura a seguir.
Figura 11.4: A caixa de dilogo Use Unit.
9. Nesta caixa de dilogo, selecione a unit UnitDados e o boto Ok.
10. Selecione cada um dos componentes DBEdit e o DBCombobox e altere a propriedade Datasource
de cada um deles para Dados.DatasourceSocios.
11. Na unit UnitCadastraSocios, troque cada referncia a ClientDatasetSocios para
Dados.ClientDatasetSocios. Isto se deve ao fato de que, a partir de agora, o componente
ClientDataSocios um campo interno ao objeto Dados, e da a necessidade da sua qualificao.
Desta maneira, os procedimentos associados a eventos na unit UnitCadastraSocios passaro a
ter a seguinte codificao:
begin
Dados.ClientDatasetSocios.Open;
Dados.ClientDatasetSocios.Append;
end;
begin
Dados.ClientDatasetSocios.Post;
Dados.ClientDatasetSocios.Append;
end;
begin
Dados.ClientDatasetSocios.Delete;
Dados.ClientDatasetSocios.ApplyUpdates(0);
end;
procedure TFormCadastraSocios.DBEditCodigoSocioKeyPress(Sender: TObject;
var Key: Char);
begin
if (key = #13) then
begin
Key := #0;
end;
end;
procedure TFormCadastraSocios.DBEditCodigoSocioEnter(Sender: TObject);
begin
end;
procedure TFormCadastraSocios.DBEditCodigoSocioExit(Sender: TObject);
begin
end;
Para exibir o objeto DataModule criado nos tpicos anteriores, execute os seguintes procedimentos:
1. Selecione a opo Forms no menu View.
Ser apresentada a lista de formulrios disponveis (Figura 11.5).
Figura 11.5: Selecionando um formulrio ou objeto DataModule.
2. Selecione Dados e depois o boto OK.
Ser exibido o objeto Dados (o DataModule).
OS OBJETOS DE ACESSO AO BANCO DE DADOS
Observando novamente a Figura 11.3, verificamos que os seguintes componentes foram inseridos no
objeto DataModule:
Um componente que representa a conexo ao banco de dados. Este componente denominado
SQLConnection, e foi abordado anteriormente.
Um componente que representa uma tabela de um banco de dados. Este componente
denominado SQLTable, e s permite acesso unidirecional aos registros da tabela.
Um componente que faz a ligao entre o componente SQLTable e o componente ClientDataset,
que permitir o acesso bidirecional aos registros da tabela. Este componente denominado
DatasetProvider. Este componente se conecta ao componente SQLTable atravs da sua
propriedade Dataset.
Um componente ClientDataset, que como j foi dito permitir o acesso bidirecional aos registros
da tabela, e permitindo a sua edio local (na memria), a ser posteriormente efetivada no
banco de dados, mediante uma chamada ao seu mtodo ApplyUpdates. Este componente se
conecta ao componente DatasetProvider atravs da sua propriedade ProviderName.
Um componente que estabelece a conexo entre o componente que representa uma tabela de um
banco de dados e os componentes destinados sua visualizao. Este componente denominado
DataSource, e se conecta ao componente SQLTable atravs da sua propriedade Dataset.
O COMPONENTE CLIENTDATASET
Conforme visto no tpico anterior, o componente ClientDataset representa uma tabela de um banco
de dados, permitindo a sua edio local e com acesso bidirecional, o que no permitido pelo
componente SQLTable. Este componente possui um cursor ou ponteiro que indica o registro corrente
da tabela na memria, isto , aquele registro com o qual se est trabalhando localmente no momento.
PRINCIPAIS PROPRIEDADES DO COMPONENTE CLIENTDATASET
Entre as principais propriedades de um componente do tipo ClientDataset, podemos destacar:
Active: Esta propriedade definida como uma varivel booleana, e define se uma tabela est
ou no ativa na memria. Definir Active como True ou False equivale a chamar os seus mtodos
Open e Close, respectivamente (estes mtodos sero descritos a seguir).
BOF: Esta propriedade declarada como uma varivel booleana. Quando o seu valor for igual
a True, indica que o cursor est posicionado no primeiro registro da tabela na memria.
ProviderName: Esta propriedade serve para informar o nome do componente DatasetProvider
ao qual pertence est conectado.
EOF: Esta propriedade declarada como uma varivel booleana. Quando o seu valor for igual
a True, indica que o cursor est posicionado no ltmo registro da tabela na memria.
Fields: Esta propriedade um array que armazena, em cada um dos seus elementos, o valor
armazenado em cada um dos campos do registro corrente da tabela representada pelo
componente. O valor do primeiro campo est armazenado em Fields[0], o do segundo campo
em Fields[1], etc., de maneira que o valor armazenado no n-simo campo est em Fields[n-1].
IndexName: Esta propriedade armazena o nome do ndice corrente da tabela na memria.
Name: Esta propriedade, como em qualquer objeto, define o nome pelo qual o componente
ser referenciado no programa.
RecordCount: Esta propriedade armazena o nmero de registros existentes na tabela.
PRINCIPAIS MTODOS DO COMPONENTE CLIENTDATASET
Alm das propriedades descritas no tpico anterior, este componente tambm tem mtodos que nos
permitem manipular os registros de uma tabela na memria. Entre estes mtodos, podemos destacar:
Append: Este mtodo acrescenta um registro em branco no final da tabela na memria.
Cancel: Este mtodo desfaz as alteraes feitas no registro corrente (desde que estas alteraes
ainda no tenham sido gravadas, ainda que localmente na memria).
Close: Este mtodo bloqueia o acesso a uma tabela na memria (equivale a definir o valor da
propriedade Active como False).
Delete: Este mtodo deleta (remove) o registro corrente da tabela na memria.
Edit: Este mtodo permite a edio dos campos do registro corrente na memria.
FieldByName: Este mtodo retorna o valor armazenado em um campo do registro corrente na
memria, cujo nome passado como parmetro na forma de uma string. Por exemplo, para
obter o valor armazenado no campo Nome do registro corrente da tabela Scios na memria,
que representado pelo componente ClientDatasetSocios, e atribu-lo a uma varivel s do
tipo string, basta incluir a seguinte linha de cdigo:
s:= ClientDatasetSocios.FieldByName(Nome).AsString;
First: Este mtodo coloca o primeiro registro da tabela na memria como o registro corrente
(move o cursor para o primeiro registro da tabela na memria).
Last: Este mtodo coloca o ltimo registro da tabela na memria como o registro corrente
(move o cursor para o primeiro registro da tabela na memria).
Next: Este mtodo coloca o prximo registro da tabela na memria como o registro corrente
(move o cursor para o prximo registro da tabela na memria).
Open: Este mtodo abre uma tabela na memria, tornando-a ativa e fornecendo acesso aos
seus registros (equivale a definir o valor da propriedade Active como True).
Post: Este mtodo realiza a gravao do registro corrente na memria.
Prior: Este mtodo coloca o registro anterior da tabela na memria como o registro corrente
(move o cursor para o registro anterior da tabela na memria).
Refresh: Este mtodo atualiza os dados exibidos pelos registros da tabela na memria.
Existem outros mtodos, usados para aplicar filtros a uma tabela e para realizar pesquisas em registros,
que sero vistos posteriormente.
A ordem dos registros definida pelos campo(s) que forma(m) o ndice corrente da tabela.
O COMPONENTE DATASOURCE
Este componente de importncia fundamental no desenvolvimento de aplicativos de bancos de
dados com o Delphi, pois ele quem se encarrega de fazer a conexo entre os componentes de
visualizao (a serem vistos posteriormente) e os componentes de acesso (no nosso caso, as tabelas que
compem o banco de dados).
Exemplificando: para acessar a tabela Scios, representada na memria por um componente do tipo
ClientDatasetSocios, precisamos incluir um componente DataSource para realizar a conexo entre a
tabela na memria e os componentes que exibiro os valores armazenados nos campos dos seus registros
(os componentes de visualizao). Os componentes de visualizao que desejarem acessar esta tabela
na memria no o faro diretamente, mas atravs do componente DataSource, que serve como uma
ponte entre estes e as tabelas.
PRINCIPAIS PROPRIEDADES DO COMPONENTE DATASOURCE
Entre as principais propriedades de um componente do tipo DataSource, podemos destacar:
DataSet: Esta propriedade usada para definir o componente cuja conexo desejamos estabelecer.
Name: Esta propriedade, como em qualquer objeto, define o nome pelo qual o componente
ser referenciado no programa.
Desta maneira, qualquer componente que queira acessar os dados da tabela Scios na memria, que
representada por SQLCientDatasetSocios, deve faz-lo atravs do componente DataSourceSocios (o
componente Datasource empregado neste exemplo).
Fica ento estabelecida a seguinte regra: para cada tabela que quisermos acessar, representada por um
componente do tipo ClientDataset (ou qualquer outro que represente uma tabela, como o SQLTable,
Table no caso do BDE, ADOTable no caso do ADO, IBTable no caso do IBX, etc.), devemos incluir
um componente do tipo DataSource cuja propriedade DataSet igual ao valor da propriedade Nome
do componente que representa a tabela.
O COMPONENTE SIMPLEDATASET
Este componente foi incorporado a esta verso do Delphi (substituindo o componente SQLClientDataset
incorporado na verso 6), e tem por finalidade substituir os componentes SQLConnection, SQLTable,
DatasetProvider e ClientDataset. Na verdade, ele incorpora um componente SQLDataset, que ser
visto posteriormente. Nestes exemplos, no eliminaremos a necessidade de uso do componente
SQLConnection (no caso o componente SQLConnectionClube), pois vrios componentes usaro a
conexo definida por este componente.
Este componente o ltimo da pgina DBExpress da paleta de componentes, e para utiliz-lo para
acessar a tabela Scios, execute os seguintes procedimentos:
1. Exiba o Datamodule Dados.
2. Selecione simultaneamente os componentes SQLTableSocios, DatasetProviderSocios e
ClientDatasetSocios.
3. Selecione a tecla Del, para remover os componentes selecionados.
4. Insira um componente SimpleDataset no Datamodule e configure da seguinte maneira as suas
principais propriedades:
Name: SimpleDatasetSocios.
Connection: SQLConnectionClube.
Subpropriedade CommandType da propriedade Dataset: ctTable.
Subpropriedade Command da propriedade Dataset: SOCIOS.
Subpropriedade Active da propriedade Dataset: True.
5. Altere a propriedade Dataset do componente DatasourceSocios para SimpleDatasetSocios.
6. Redefina da seguinte maneira os procedimentos associados a eventos da unit UnitCadastraSocios
que referenciavam o componente ClientDatasetSocios:
begin
Dados.SimpleDatasetSocios.Open;
Dados.SimpleDatasetSocios.Append;
end;
begin
Dados.SimpleDatasetSocios.Post;
end;
begin
Dados.SimpleDatasetSocios.Delete;
Dados.SimpleDatasetSocios.ApplyUpdates(0);
end;
7. Usando o Fields Editor, selecione o item Add All Fields de seu menu pop-up para adicionar
objetos para representar todos os campos desta tabela.
6. Redefina a propriedade EditMask para os objetos que representam os campos CEP e CPF, como
descrito no captulo anterior.
INSERINDO OS DEMAIS COMPONENTES DE ACESSO
Para que as demais tabelas possam ser acessadas pelo nosso aplicativo, devemos incluir no Datamodule os
componentes SimpleDataset e DataSource necessrios. Para isso, basta executar os seguintes procedimentos:
PARA A TABELA DE ATIVIDADES:
1. Inclua um componente SimpleDataset e atribua os seguintes valores s suas principais propriedades:
Name: SimpleDatasetAtividades.
Subpropriedade Command da propriedade Dataset: ATIVIDADES.
2. Inclua um componente DataSource e atribua os seguintes valores s suas principais propriedades:
Name: DatasourceAtividades.
Dataset: SimpleDatasetAtividades.
4. Atribua o valor ########.00 s propriedades EditFormat e DisplayFormat do objeto que
representa o campo VALOR desta tabela. Isto far com que o nmero seja sempre exibido com
duas casas decimais (estas propriedades definem a mscarade campos numricos).
PARA A TABELA DE MATRCULAS:
1. Inclua um componente SimpleDataset e atribua os seguintes valores s suas principais propriedades:
Name: SimpleDatasetMatriculas.
Subpropriedade Command da propriedade Dataset: MATRICULAS.
2. Inclua um componente DataSource e atribua os seguintes valores s suas principais propriedades:
Name: DatasourceMatriculas.
Dataset: SimpleDatasetMatriculas.
Aps a incluso destes componentes, seu Datamodule dever ficar com o aspecto mostrado na Figura a seguir:
Figura 11.6: Aspecto do objeto Datamodule aps a incluso dos demais componentes de acesso.
Se necessrio, redimensione o Datamodule para que todos os componentes possam ser visualizados
simultaneamente.
DEFININDO NDICES NOS COMPONENTES DE ACESSO
O componente SimpleDataset permite a definio de ndices locais, que so conjuntos de dois ou mais
campos pelos quais os dados podem ser ordenados. Um ndice pode ser simples (quando formado
por um nico campo) ou composto (quando formado por dois ou mais campos).
Neste tpico sero apresentados os procedimentos necessrios criao de ndices simples e compostos.
CRIANDO UM NDICE SIMPLES
Quando consultarmos a tabela de atividades, ser interessante que estes dados estejam ordenados
alfabeticamente pelos nomes das atividades. Neste caso, devemos criar um ndice simples, baseado no
campo Nome.
Para criar este ndice, voc deve executar os seguintes procedimentos:
1. Selecione o componente SimpleDatasetAtividades.
2. No Object Inspector, selecione os trs pontinhos direita da propriedade IndexDefs, para exibir
a janela de edio de ndices, mostrada na figura a seguir.
Figura 11.7: A janela de edio de ndices.
3. Selecione o boto direito do mouse para exibir o menu pop-up desta janela e, neste menu,
selecione o ndice Add, para criar um novo ndice na memria. Este ndice ser representado
por um objeto da classe TIndexDefs, como mostrado na figura a seguir.
Figura 11.8: Criando um objeto da classe TIndexDefs.
4. Altere a propriedade Name deste objeto para indNome, usando o Object Inspector.
5. Defina como NOME a propriedade Fields deste objeto no Object Inspector. Isto indica que este
ser um ndice simples, formado pelo campo Nome.
6. Altere para indNome a propriedade indexName do componente SimpleDatasetAtividades,
usando o Object Inspector.
Pronto! Seu ndice simples foi criado!
CRIANDO UM NDICE COMPOSTO
Quando consultarmos a tabela de scios, ser interessante que estes dados estejam ordenados
alfabeticamente pelos seus nomes. Neste caso, devemos criar um ndice composto, baseado no campo
Nome e Sobrenome.
Para criar este ndice, voc deve executar os seguintes procedimentos:
1. Selecione o componente SimpleDatasetSocios.
a janela de edio de ndices.
por um objeto da classe TIndexDefs.
4. Altere a propriedade Name deste objeto para indNome, usando o Object Inspector.
5. Defina como NOME;SOBRENOME (Os dois campos separados por um ponto-e-vrgula) a
propriedade Fields deste objeto no Object Inspector. Isto indica que este ser um ndice
composto, formado pelos campos Nome e Sobrenome.
6. Altere para indNome a propriedade indexName do componente SimpleDatasetSocios, usando
o Object Inspector.
Pronto! Seu ndice composto foi criado!
CRIANDO CHAVES PRIMRIAS
Existem situaes em que dois registros no podem ter o mesmo valor em um determinado campo (ou
grupo de campos), e neste caso dizemos que este campo (ou estes campos) formam uma chave primria
simples (composta).
No caso das tabelas de Scios e de Atividades, por exemplo, o campo referente a seu cdigo deve ser
nico. Ou seja, devemos ter uma chave primria definida pelo campo CodigoSocio na tabela de scios
e CodigoAtividade na tabela de Atividades.
No caso da tabela de matrculas, devemos ter uma chave primria composta formada pelos cam-
pos Scio e Atividade (de modo a evitar que um mesmo scio seja matriculado duas vezes em uma
mesma atividade).
CRIANDO UMA CHAVE PRIMRIA NA TABELA DE SCIOS
Para criar uma chave primria formada pelo campo CodigoSocio na tabela de Scios, voc deve executar
os seguintes procedimentos:
4. Altere a propriedade Name deste objeto para indCodigoSocio, usando o Object Inspector.
5. Defina como CODIGOSOCIO a propriedade Fields deste objeto no Object Inspector.
6. Altere para True o valor da subpropriedade ixPrimary da propriedade Options deste objeto,
7. Altere para True o valor da subpropriedade ixUnique da propriedade Options deste objeto,
8. Redefina da seguinte maneira o procedimento associado ao evento OnShow do formulrio:
begin
Dados.SimpleDatasetSocios.IndexName := indCodigoSocio;
end;
Desta maneira, o ndice ser trocado ao se exibir o formulrio.
9. Redefina da seguinte maneira o procedimento associado ao evento OnClose do formulrio:
begin
Dados.SimpleDatasetSocios.Delete;
Dados.SimpleDatasetSocios.IndexName := indNomeCompleto;
end;
10. Redefina da seguinte maneira o procedimento associado ao evento OnClick do componente
BotaoCadastrar:
begin
try
Dados.SimpleDatasetSocios.Post;
except
ShowMessage(Este Cdigo J Foi Cadastrado);
end;
end;
Desta maneira, o ndice ser novamente trocado ao se fechar o formulrio.
CRIANDO UMA CHAVE PRIMRIA NA TABELA DE ATIVIDADES
Para criar uma chave primria formada pelo campo CodigoAtividade na tabela de Atividades, voc
deve executar os seguintes procedimentos:
1. Selecione o componente SimpleDatasetAtividade.
4. Altere a propriedade Name deste objeto para indCodigoAtividade, usando o Object Inspector.
5. Defina como CODIGOATIVIDADE a propriedade Fields deste objeto no Object Inspector.
CRIANDO UMA CHAVE PRIMRIA COMPOSTA NA TABELA DE MATRCULAS
Para criar uma chave primria composta formada pelos campos SOCIO e ATIVIDADE na tabela de
Matriculas, voc deve executar os seguintes procedimentos:
1. Selecione o componente SimpleDatasetMatricula.
selecione o ndice Add, para criar um novo ndice na memria. Este ndice ser representado por
um objeto da classe TIndexDefs.
4. Altere a propriedade Name deste objeto para indMatricula, usando o Object Inspector.
5. Defina como SOCIO:ATIVIDADE a propriedade Fields deste objeto no Object Inspector.
CAPTULO 12 CRIAO DE FORMULRIOS PARA CADASTRO DE FORNECEDORES, PRODUTOS E PEDIDOS
Captulo
Criao de Formulrios Para
Cadastro de Fornecedores,
Produtos e Pedidos
12
Neste captulo sero apresentados os procedimentos necessrios criao de formulrios de cadastro
de atividades e matrculas.
CRIAO DE FORMULRIOS DE CADASTRO
PR-REQUISITOS
Criao de formulrios e utilizao dos componentes bsicos de interface.
Utilizao de componentes para acesso a bancos de dados.
METODOLOGIA
Apresentao e descrio dos principais conceitos relacionados criao de formulrios de cadastro.
TCNICA
Apresentao e descrio dos procedimentos necessrios criao de formulrios de cadastro.
CRIANDO O FORMULRIO DE CADASTRO DE ATIVIDADES
Para criar um formulrio de cadastro de atividades, execute os seguintes procedimentos:
1. Abra o projeto Clube.dpr, se ele j no estiver aberto no ambiente de desenvolvimento.
2. Crie um novo formulrio, selecionando o item New/Form do menu File do Delphi 7.
3. Altere as propriedades Name e Caption deste formulrio para FormCadastraAtividades e Cadastro
de Atividades, respectivamente.
4. Salve a unit associada a este formulrio com o nome UnitCadastraAtividades.
5. Selecione o componente SimpleDatasetAtividades do Datamodule, conforme indicado na
Figura 12.1.
Figura 12.1: Selecionando o componente SimpleDatasetAtividades do Datamodule.
6. Pressione o boto direito do mouse com o componente SimpleDatasetAtividades selecionado,
para exibir o seu menu pop-up.
7. Selecione o item Fields Editor deste menu pop-up. Ser exibida a caixa de dilogo do Fields Editor.
8. Pressione o boto direito do mouse sobre a rea branca do Fields Editor, para exibir o menu
pop-up.
9. Selecione o item Add All Fields deste menu pop-up. Todos os campos sero exibidos na caixa
de dilogo do Fields Editor, como mostrado na Figura 12.2.
Figura 12.2: Exibindo os campos da tabela no Fields Editor.
Conforme j descrito anteriormente, ao adicionar os campos da tabela no Fields Editor, o Delphi
automaticamente cria objetos para representar estes campos.
10. Arraste os objetos do Fields Editor para o formulrio FormCadastraAtividades para criar os
componentes Labels e DBEdits vinculados aos campos da tabela, como mostrado na figura a seguir.
Figura 12.3: Arraste os objetos do Fields Editor para o formulrio FormCadastraAtividades.
Figura 12.4: Mensagem de advertncia.
Isto provoca a incluso do nome da unit que contm o Datamodule Dados (UnitDados) na clusula
uses da unit UnitCadastraAtividades.
11. Altere a propriedade Caption do Label referente ao cdigo da atividade para CDIGO DA
ATIVIDADE.
12. Renomeie os componentes de visualizao dando-lhes os nomes DBEditCodigoAtividade,
DBEditNomeAtividade e DBEditValorAtividade.
13. Coloque um boto de comando com figura (BitBtn) para Cadastro, e defina da seguinte maneira
as suas principais propriedades:
Kind: bkCustom.
ModalResult: mrNone
Name: BotaoCadastrar
Caption: &Cadastrar
Height: 50
Width: 100
14. Para que estes dados sejam gravados na tabela quando o usurio selecionar este boto, devemos
definir da seguinte maneira o procedimento associado ao evento OnClick deste boto.
procedure TFormCadastraAtividades.BotaoCadastrarClick(Sender: TObject);
begin
try
Dados.SimpleDatasetAtividades.Post;
Dados.SimpleDatasetAtividades.Append;
except
ShowMessage(Este Cdigo J Foi Cadastrado);
end;
end;
procedure TFormCadastraAtividades.FormShow(Sender: TObject);
begin
Dados.SimpleDatasetAtividades.IndexName := indCodigoSocio;
Dados.SimpleDatasetAtividades.Open;
Dados.SimpleDatasetAtividades.Append;
end;
Ao liberar o boto esquerdo do mouse ser exibida a mensagem mostrada na figura a seguir,
informando que FormCadastraAtividades no inclui a unit Dados, e perguntando se deseja inclu-la.
Selecione o boto Yes.
16. Defina da seguinte maneira o procedimento associado ao evento OnKeyPress do componente
DBEditCodigoAtividade, a ser compartilhado pelos demais componentes DBEdit:
procedure TFormCadastraAtividades.DBEditCodigoAtividadeKeyPress(
begin
if (key = #13) then
begin
Key := #0;
end;
end;
17. Defina da seguinte maneira o procedimento associado ao evento OnClose deste formulrio:
procedure TFormCadastraAtividades.FormClose(Sender: TObject;
begin
Dados.SimpleDatasetAtividades.Delete;
Dados.SimpleDatasetAtividades.ApplyUpdates(0);
Dados.SimpleDatasetAtividades.IndexName := indNomeCompleto;
end;
18. Defina da seguinte maneira o procedimento associado ao evento OnEnter do componente
procedure TFormCadastraAtividades.DBEditCodigoAtividadeEnter(
Sender: TObject);
begin
end;
19. Defina da seguinte maneira o procedimento associado ao evento OnExit do componente
procedure TFormCadastraAtividades.DBEditCodigoAtividadeExit(
Sender: TObject);
begin
end;
20. Inclua mais um boto de comando com figura e defina suas principais propriedades como
indicado a seguir:
Name: BotaoFechar
Kind: bkClose
Caption: &Fechar
Height: 50
Width: 100
Figura 12.5: Aspecto final do formulrio para Cadastro de Atividades.
21. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Cadastrar
do menu Atividades, e compartilhe este procedimento com o evento OnClick do item Cadastrar
do submenu Atividades do menu pop-up:
procedure TFormPrincipal.AtividadesCadastroClick(Sender: TObject);
begin
FormCadastraAtividades.ShowModal;
end;
Ao recompilar a aplicao, ser exibida uma mensagem de advertncia perguntando se o nome da unit
do novo formulrio deve ser includo na clusula uses da unit UnitPrincipal. Responda yes a esta
mensagem e recompile o projeto.
CRIANDO UM FORMULRIO PARA CADASTRAR NOVAS MATRCULAS
Neste tpico veremos como criar um formulrio para acrescentar novas matrculas.
DEFININDO O FORMULRIO
Este formulrio ser usado para acrescentar um nova matrcula de um scio numa atividade tabela de
matrculas. Como j descrito anteriormente, esta tabela possui os seguintes campos:
CodigoScio. Este campo, do tipo inteiro, armazena o cdigo de scio que ser matriculado.
CodigoAtividade. Este campo, do tipo inteiro, armazena o cdigo da atividade na qual o scio
ser matriculado.
Estes campos poderiam ser acessados atravs de um componente do tipo DBEdit. No entanto, o valor
armazenado neles deve ser igual a um dos valores j armazenados no campo CodigoScio (para o
campo referente ao scio que est sendo matriculado) da tabela de Scios, ou igual a um dos valores j
armazenados no campo CodigoAtividade (para o campo referente atividade na qual o scio ser
matriculado) da tabela de Atividades. Desta forma evitamos que se selecione um scio ou uma atividade
no cadastrados. Para resolver este problema, podemos apresentar uma lista de opes usando um
componente do tipo DBLookupComboBox, que ser apresentado nos prximos tpicos.
CRIANDO O FORMULRIO
Para criar o formulrio, execute os seguintes procedimentos:
1. Selecione o item New/Form do menu File do Delphi 7. Ser criado um formulrio default,
chamado Form1.
2. Altere o valor da propriedade Name do formulrio para FormCadastraMatriculas.
3. Altere o valor da sua propriedade Caption para Cadastro de Matrculas.
4. Salve a unit associada a este formulrio com o nome UnitCadastraMatriculas.
5. Inclua a unit UnitCadastraMatriculas na clusula uses da unit UnitPrincipal.
INSERINDO OS COMPONENTES NO FORMULRIO
Para incluir os controles no formulrio, execute os seguintes procedimentos:
1. Insira no formulrio um componente do tipo Label e defina como Scio o valor da sua
propriedade Caption.
2. Insira no formulrio um segundo componente do tipo Label e defina como Atividade o
valor da sua propriedade Caption.
3. Inclua o nome da unit UnitDados na clusula uses da unit associada a este formulrio.
4. Insira no formulrio um componente do tipo DBLookupCombobox (da pgina Data Con-
trols), posicione-o abaixo do componente Label cuja propriedade Caption foi definida como
Scio e defina os seguintes valores para as suas principais propriedades:
Name: DBLookupComboboxSocio.
DataSource: Dados.DatasouceMatriculas.
DataField: Socio.
ListSource: Dados.DatasouceSocios.
ListField: Nome.
KeyField: CodigoSocio.
Para definir o scio que est sendo matriculado, optou-se por usar um componente do tipo
DBLookupComboBox, que permite exibir em uma lista drop-down os valores armazenados em um
campo dos registros de uma tabela e gravar um valor correspondente ao item selecionado em um
campo do registro corrente de uma segunda tabela.
Este componente trabalha, portanto, com duas tabelas: uma tabela-fonte a partir da qual so obtidos
os valores a serem exibidos na lista e uma segunda tabela (tabela-destino), na qual ser gravado, em um
campo do registro corrente, um valor que vai depender do item selecionado na lista.
Para acessar duas tabelas, tm de ser usados, evidentemente, dois componentes do tipo DataSource,
que so especificados nas propriedades ListSource (para a tabela-fonte) e DataSource (para a tabela-
destino) do componente DBLookupCombobox.
5. Insira no formulrio um segundo componente do tipo DBLookupCombobox, posicione-o abaixo
do componente Label cuja propriedade Caption foi definida como Atividade e defina os
seguintes valores para as suas principais propriedades:
Name: DBLookupComboboxAtividade.
DataSource: Dados.DatasouceMatriculas.
DataField: Atividade.
ListSource: Dados.DatasouceAtividades.
ListField: Nome.
KeyField: CodigoAtividade.
PROPRIEDADES DO COMPONENTE DBLOOKUPCOMBOBOX
Entre as principais propriedades deste componente, podem-se destacar:
Name: Define o nome pelo qual o objeto ser referenciado no cdigo da aplicao.
Left e Top: Definem a posio do componente no formulrio.
Height e Width: Definem as dimenses do componente.
DataSource: Define o componente que estabelece a conexo com a tabela-destino.
ListSource: Define o componente que estabelece a conexo com a tabela-fonte.
KeyField: Define o campo de ligao entre as tabelas. Esta propriedade define o campo da
tabela-fonte cujo valor do registro corrente ser armazenado num campo do registro corrente
da tabela-destino (o nome do campo ser o especificado na propriedade DataField). O registro
corrente da tabela-fonte ser o correspondente ao item selecionado na lista.
DataField: Esta propriedade define o campo do registro corrente da tabela-destino, no qual ser gravado
o valor do campo especificado na propriedade KeyField do registro corrente da tabela-fonte.
ListField: Define o campo dos registros da tabela-fonte, cujos valores sero exibidos na lista
drop-down do componente.
6. Coloque um boto de comando com figura (BitBtn) para Cadastro, e defina da seguinte maneira
Kind: bkCustom.
ModalResult: mrNone
Name: BotaoCadastrar
Caption: &Cadastrar
Height: 50
Width: 100
7. Para que estes dados sejam gravados na tabela quando o usurio selecionar este boto, devemos
definir da seguinte maneira o procedimento associado ao evento OnClick deste boto.
procedure TFormCadastraMatriculas.BotaoCadastrarClick(Sender: TObject);
begin
try
Dados.SimpleDatasetMatriculas.Post;
Dados.SimpleDatasetMatriculas.Append;
except
ShowMessage(Este Scio J Foi Cadastrado Nesta Atividade);
end;
DBLookupComboBoxSocio.SetFocus;
end;
procedure TFormCadastraMatriculas.FormShow(Sender: TObject);
begin
Dados.SimpleDatasetMatriculas.IndexName := indMatrcula;
Dados.SimpleDatasetMatriculas.Open;
Dados.SimpleDatasetMatriculas.Append;
end;
DBLookupComboboxSocio, a ser compartilhado pelos componente DBLookupComboboxSocio.
procedure TFormCadastraMatriculas.DBLookupComboBoxSocioKeyPress(
begin
if (key = #13) then
begin
Key := #0;
end;
end;
procedure TFormCadastraMatriculas.FormClose(Sender: TObject;
begin
Dados.SimpleDatasetMatriculas.Delete;
Dados.SimpleDatasetMatriculas.ApplyUpdates(0);
Dados.SimpleDatasetMatriculas.IndexName := indSocio;
end;
11. Inclua mais um boto de comando com figura e defina suas principais propriedades como
indicado a seguir:
Name: BotaoFechar
Kind: bkClose
Caption: &Fechar
Height: 50
Width: 100
Figura 12.6: Aspecto final do formulrio para Cadastro de Atividades.
do menu Matriculas, e compartilhe este procedimento com o evento OnClick do item Cadastrar
do submenu Matriculas do menu pop-up:
procedure TFormPrincipal.MatriculasCadastroClick(Sender: TObject);
begin
FormCadastraMatriculas.ShowModal;
end;
13. Use a caixa de dilogo Edit Tab Order para que os componentes sejam ordenados na forma
mais adequada para a digitao das informaes.
Repare que ao exibir o formulrio e selecionar a seta direita do componente DBLookupComboboxSocio,
apenas o nome de um scio exibido. Isto ocorre porque, em nossa tabela, o nome e o sobrenome de um
scio foram armazenados em campos distintos. E como resolver o caso de vrios scios com o mesmo nome?
Neste caso, a soluo consiste em empregar o recurso de campos calculados, apresentado no tpico a seguir.
TRABALHANDO COM CAMPOS CALCULADOS
Um campo calculado um tipo especial de campo de uma tabela, cujo valor depende dos valores
armazenados em outros campos. Este campo s existe durante a execuo do aplicativo, reduzindo
desta maneira a quantidade de espao em disco a ser ocupado pela tabela.
Podemos ento criar um campo calculado na tabela de Scios, chamado NomeCompleto, cujo valor
ser obtido pela unio dos valores armazenados nos campos Nome e Sobrenome. Para criar este campo
calculado, execute os seguintes procedimentos:
1. Exiba o objeto Dados (o DataModule).
3. Redefina como False o valor da propriedade Active deste componente.
4. Pressione o boto direito do mouse, para exibir o menu pop-up do componente.
5. Selecione o item Fields Editor do menu pop-up, para exibir o Editor de campos.
6. Pressione o boto direito do mouse, para exibir o menu pop-up do Fields Editor.
7. Selecione o item New Field do menu pop-up, para exibir a caixa de dilogo New Field, mostrada
na figura a seguir.
Figura 12.7: Criando um campo calculado.
8. Preencha os campos da caixa de dilogo New Field como indicado na figura anterior.
9. Clique em OK, para fechar a caixa de dilogo e criar o novo campo.
10. Redefina como True o valor da propriedade Active deste componente.
11. Defina da seguinte maneira o procedimento associado ao evento OnCalcFields do componente
SimpleDatasetSocios:
procedure TDados.SimpleDataSetSociosCalcFields(DataSet: TDataSet);
begin
SimpleDatasetSociosNomeCompleto.AsString :=
SimpleDatasetSociosNome.AsString + +SimpleDatasetSociosSobrenome.AsString;
end;
A linha de cdigo anterior faz com que o valor armazenado no campo NomeCompleto seja obtido pela
concatenao do valor armazenado no campo Nome, com uma string composta por um espao em
branco e o valor armazenado no campo Sobrenome. No esquea de incluir a string composta por um
espao em branco, para que seja inserido um espao entre o nome e o sobrenome do scio. Esta string
tambm ser til quando criarmos um formulrio para a consulta de dados de scios.
12. Redefina como NomeCompleto a propriedade ListField do componente DBLookupComboboxSocio.
CAPTULO 13 CRIANDO FORMULRIOS PARA ALTERAO DE SCIOS E ATIVIDADES
Captulo
Criando Formulrios Para
Alterao de Scios e Atividades
13
Neste captulo sero apresentados os procedimentos necessrios criao de formulrios para alterao
dos dados de Scios e Atividades.
Sero utilizados muitos dos procedimentos descritos nos captulos anteriores. Portanto, importante
que estes tenham sido perfeitamente compreendidos pelo leitor.
CRIAO DE FORMULRIOS PARA ALTERAO DE DADOS
PR-REQUISITOS
Utilizao de componentes para acesso a bancos de dados e de visualizao.
METODOLOGIA
Apresentao e descrio dos principais conceitos relacionados criao de Templates de Componentes para agrupar componentes a serem
utilizados em vrios Formulrios.
TCNICA
Apresentao e descrio dos procedimentos necessrios criao de Templates de Componentes.
O CONCEITO DE TEMPLATES DE COMPONENTES
Existem situaes em que um mesmo grupo de componentes usado em diversos formulrios.
Neste captulo, por exemplo, criaremos formulrios para a alterao dos dados dos scios e atividades.
Para que isso seja possvel, devemos, em cada formulrio, incluir vrios componentes que acessem os
diversos campos de cada uma das tabelas. Acontece que este trabalho j foi feito na criao de formulrios
de cadastro, e seria razovel aproveitar o trabalho j realizado.
A fim de facilitar o trabalho do desenvolvedor, o Delphi apresenta o conceito de Templates de
Componentes entidades capazes de armazenar um conjunto de componentes (e os procedimentos
associados a seus eventos) como um tipo especial de componente.
Neste captulo, criaremos trs formulrios com uma caracterstica comum: permitir alterao de registros.
Conseqentemente, cada um destes formulrios possuir:
Os componentes de visualizao e labels criados nos respectivos formulrios de Cadastro.
Uma caixa de texto para que o usurio possa pesquisar o registro a ser alterado pelo Nome do
Scio ou Atividade.
Um boto a ser utilizado para fechar o formulrio.
Um componente DBNavigator, para permitir uma navegao rpida entre os registros.
CRIANDO OS TEMPLATES DE COMPONENTES
Para criar o Template de Componentes de Visualizao da tabela de Scios usando os componentes j
existentes no formulrio de cadastro de Scios, voc dever executar os seguintes procedimentos:
1. Exibir o formulrio FormCadastraSocios.
2. Selecionar todos os componentes Label, DBEdit e DBComboBox existentes neste formulrio.
3. Selecionar o item Create Component Template do menu Component, para exibir a caixa de
dilogo mostrada na figura a seguir, na qual devero ser fornecidas as informaes necessrias
criao do template.
Figura 13.1: A caixa de dilogo Component Template Information,
usada para manipular componentes de acesso tabela de scios.
4. Nesta caixa de dilogo devero ser informados:
Um nome para o template.
O nome da pgina da paleta de componentes na qual o cone do Template ser exibido
como se fosse um componente. Neste exemplo digitaremos o nome de uma pgina
inexistente na paleta de componentes, e que ser ento automaticamente criada pelo
ambiente de desenvolvimento.
Um cone para o Template (neste exemplo, estamos usando o cone do componente Label).
Digite as informaes mostradas na figura anterior e selecione o boto OK, para fechar esta caixa de
dilogo e criar o Template de Componentes. Ser criada uma pgina chamada Clube na paleta de
componentes, para armazenar o Template recm-criado.
Para criar o Template de Componentes para a tabela Atividades usando os componentes j existentes
no formulrio de cadastro de Atividades, voc dever executar os seguintes procedimentos:
1. Exibir o formulrio FormCadastraAtividades.
2. Selecionar todos os componentes Label e DBEdit existentes neste formulrio.
3. Selecionar o item Create component Template do menu Component, para exibir a caixa de
dilogo mostrada na figura a seguir, na qual devero ser fornecidas as informaes necessrias
criao do template.
Figura 13.2: A caixa de dilogo Component Template Information, usada
para manipular componentes de acesso tabela de atividades.
4. Digite as informaes mostradas na figura anterior e selecione o boto OK, para fechar esta
caixa de dilogo e criar o Template de Componentes.
CRIANDO O FORMULRIO DE ALTERAO DE SCIOS
Para criar o formulrio de alterao de scios, voc deve executar os seguintes procedimentos:
1. Selecione o item New/Form do menu File do Delphi 7, para criar um novo formulrio.
2. Altere o valor das suas propriedades Name e Caption para FormAlteraSocios e Alterao de
Dados dos Scios, respectivamente.
3. Salve a unit associada a este formulrio com o nome UnitAlteraClientes.
4. Inclua o nome das units UnitDados e DB na clusula uses da unit associada ao formulrio
recm-criado.
5. Inclua o Template SociosTemplate no formulrio. Repare que todos os componentes sero
criados de uma s vez, bem como os procedimentos associados a seus eventos. A incluso de
um Template segue os mesmos procedimentos necessrios incluso de um componente.
6. Inclua um boto de comando com figura na parte inferior do formulrio, e defina da seguinte
maneira as suas principais propriedades:
Name: BotaoFechar
Kind: bkClose
Caption: &Fechar
Height: 50
Width: 100
7. Inclua um componente Caixa de Texto (Edit) no formulrio, e altere o valor da sua propriedade
Name para EditPesquisa, apague o valor digitado na sua propriedade Text e codifique da seguinte
maneira o procedimento associado ao seu evento OnChange:
procedure TFormAteraSocios.EditPesquisaChange(Sender: TObject);
begin
Dados.SimpleDatasetSocios.Locate(NOME,VarArrayOf([EditPesquisa.Text]),[loPartialKey,LocaseInsensitive]);
end;
Para evitar erros de compilao mantenha todo o comando digitado em uma nica linha.
8. Defina da seguinte maneira o procedimento associado ao evento OnShow do formulrio:
procedure TFormAteraSocios.FormShow(Sender: TObject);
begin
EditPesquisa.Clear;
end;
procedure TFormAlteraSocios.FormClose(Sender: TObject;
begin
end;
10. Inclua prximo ao componente EditPesquisa um componente Label no formulrio e altere o
valor da sua propriedade Caption para DIGITE O NOME A SER PESQUISADO, respectivamente.
11. Inclua um componente DBNavigator (pgina Data Controls) no formulrio e defina da seguinte
Name: DBNavigatorSocios
DataSource: Dados.DatasourceSocios
VisibleButtons: [nbFirst,nbPrior,nbNext,nbLast]
12. Reposicione os componentes no formulrio, de maneira que este fique com um aspecto
semelhante ao apresentado na figura a seguir.
Figura 13.3: Aspecto do formulrio para alterao dos dados dos scios.
13. Inclua o nome da unit associada a este formulrio na clusula uses da unit associada ao
formulrio FormPrincipal.
Alterao do menu Scios, e compartilhe este procedimento com o evento OnClick do item
Alterao do submenu Scios do menu pop-up do formulrio.
FormAlteraSocios.ShowModal;
CRIANDO O FORMULRIO DE ALTERAO DE ATIVIDADES
Para criar o formulrio de alterao de atividades, voc deve executar os seguintes procedimentos:
2. Altere o valor das suas propriedades Name e Caption para FormAlteraAtividades e Alterao
de Atividades, respectivamente.
3. Salve a unit associada a este formulrio com o nome UnitAlteraAtividades.
4. Inclua os nomes das units UnitDados e DB na clusula uses da unit associada ao formulrio
recm-criado.
5. Inclua o Template AtividadesTemplate no formulrio. Repare que todos os componentes sero
criados de uma s vez, bem como os procedimentos associados a seus eventos.
6. Inclua outro boto de comando com figura na parte inferior do formulrio, e defina da seguinte
Name: BotaoFechar
Kind: bkClose
Caption: &Fechar
Height: 50
Width: 100
Name para EditPesquisa, apague o valor digitado na sua propriedade Text e codifique da seguinte
maneira o procedimento associado ao seu evento OnChange:
procedure TFormAlteraAtividades.EditPesquisaChange(Sender: TObject);
begin
Dados.SimpleDatasetAtividades.Locate(NOME,VarArrayOf([EditPesquisa.Text]),[loPartialKey,LocaseInsensitive]);
end;
procedure TFormAlteraAtividades.FormShow(Sender: TObject);
begin
EditPesquisa.Clear;
end;
procedure TFormAlteraAtividades.FormClose(Sender: TObject;
begin
end;
10. Inclua prximo ao componente EditPesquisa um componente Label no formulrio e altere o
valor da sua propriedade Caption para DIGITE O NOME A SER PESQUISADO.
11. Inclua um componente DBNavigator no formulrio e defina da seguinte maneira as suas
Name: DBNavigatorAtividades
DataSource: Dados.DatasourceAtividades
VisibleButtons: [nbFirst,nbPrior,nbNext,nbLast]
semelhante ao apresentado na figura a seguir.
Figura 13.4: Aspecto do formulrio para alterao dos Dados das Atividades.
Alterao do menu Atividades, e compartilhe este procedimento com o evento OnClick do
item Alterao do submenu Atividades do menu pop-up do formulrio.
FormAlteraAtividades.ShowModal;
O COMPONENTE DBNAVIGATOR
Este controle permite a manipulao direta dos registros de uma tabela.
Este controle permite que o usurio manipule os registros de uma tabela do banco de dados e seus
botes possuem os seguintes significados (da esquerda para a direita):
Exibir o primeiro registro da tabela.
Exibir o registro anterior da tabela.
Exibir o prximo registro da tabela.
Exibir o ltimo registro da tabela.
Insere um registro em branco na tabela.
Deleta (exclui) o registro corrente da tabela.
Permite a edio do registro corrente da tabela.
Grava o registro corrente da tabela.
Cancela a edio do registro corrente do banco de dados.
Atualiza a exibio dos registros da tabela.
Entre as propriedades deste componente, podemos destacar:
DataSource: Esta propriedade define o componente que nos fornecer a conexo que desejamos
estabelecer.
Name: Esta propriedade define o nome pelo qual o componente ser referenciado no programa.
ShowHint: Essa propriedade uma varivel booleana que define se o componente deve ou no
exibir strings de auxlio quando o ponteiro do mouse estiver sobre cada um dos seus botes.
Hints: Essa propriedade um objeto da classe TStrings e define as strings de auxlio dos diversos
botes exibidos pelo componente DBNavigator (permitindo a sua personalizao).
Para personalizar as strings de auxlio dos controles DBNavigator includos nos formulrios, execute os
1. Selecione o componente DBNavigator, clicando sobre o mesmo com o boto esquerdo do mouse.
2. Selecione a propriedade Hints diretamente no Object Inspector.
3. Clique com o boto esquerdo do mouse sobre as reticncias (...) exibidas do lado direito da
propriedade no Object Inspector. Ser exibida a caixa de dilogo String List Editor.
4. Digite as expresses mostradas na figura a seguir.
Figura 13.5: Configurando as strings de auxlio para o componente DBNavigator.
5. Selecione o boto OK, para fechar a caixa de dilogo.
Nessa caixa de dilogo, cada string digitada em uma linha corresponde string de auxlio de um boto.
A primeira linha corresponde ao primeiro boto (da esquerda para a direita); a segunda linha, ao
segundo boto e assim por diante.
Os mtodos correspondentes a cada um desses botes, disponveis para os objetos da classe
TSimpleDataset, so:
Primeiro Registro: Mtodo First.
Registro Anterior: Mtodo Prior.
Prximo Registro: Mtodo Next.
ltimo Registro: Mtodo Last.
Inserir Registro: Mtodo Append.
Deletar Registro: Mtodo Delete.
Editar Registro: Mtodo Edit.
Gravar Registro: Mtodo Post.
Cancelar Edio do Registro: Mtodo Cancel.
Atualizar a Exibio do Registro: Mtodo Refresh.
ShowHint: Esta propriedade definida como uma varivel booleana e define se uma string de
auxlio deve ou no ser exibida quando o usurio mantiver o ponteiro do mouse sobre um
controle. Se o seu valor for False, nenhuma string de auxlio ser exibida durante a execuo
do aplicativo.
VisibleButtons: Define os botes que devem ser exibidos no controle.
Voc pode alterar essa propriedade mediante a incluso de uma linha de cdigo ou modificando os
valores das subpropriedades de VisibleButtons diretamente no Object Inspector.
Para exibir essas subpropriedades, d um duplo clique com o boto esquerdo do mouse sobre o sinal
(+) exibido esquerda do nome da propriedade VisibleButtons. As subpropriedades so exibidas
(podendo ser diretamente alteradas) e o sinal (+) substitudo por (-). Dando um duplo clique com o
boto esquerdo do mouse sobre o smbolo (-), as subpropriedades so novamente ocultadas. Para
exibir um boto, atribua o valor True subpropriedade correspondente, e False em caso contrrio.
Lembre-se: a existncia de um sinal de (+) imediatamente esquerda do nome de uma propriedade no
Object Inspector indica que essa propriedade tem subpropriedades.
Cada subpropriedade (de cima para baixo) corresponde a um dos botes (da esquerda para a direita).
Neste exemplo, apenas os quatro primeiros botes foram habilitados, usando a propriedade
VisibleButtons.
CAPTULO 14 CRIANDO FORMULRIOS PARA EXCLUSO DE SCIOS, ATIVIDADES E MATRCULAS
Captulo
Criando Formulrios Para Excluso
de Scios, Atividades e Matrculas
14
Neste captulo sero apresentados os procedimentos necessrios criao de formulrios para excluso
dos dados de Scios, Atividades e Matrculas.
Sero utilizados muitos dos procedimentos descritos nos captulos anteriores. Portanto, importante
que estes tenham sido perfeitamente compreendidos pelo leitor.
CRIAO DE FORMULRIOS PARA EXCLUSO DE DADOS
PR-REQUISITOS
METODOLOGIA
Apresentao e descrio dos procedimentos necessrios criao de Templates de formulrios Templates.
Apresentao e descrio dos principais conceitos relacionados criao de Formulrios Para Excluso de Dados.
TCNICA
Descrio dos procedimentos necessrios criao de formulrios Para Excluso.
CRIANDO UM TEMPLATE DE FORMULRIO
Neste captulo, criaremos trs formulrios com uma caracterstica comum: Excluir um registro
selecionado. Conseqentemente, cada um destes formulrios possuir:
Um DBGrid conectado a uma tabela atravs da qual sero visualizados os diversos registros.
Um boto a ser utilizado para excluir o registro selecionado.
Uma caixa de texto para que o usurio possa pesquisar o registro a ser excludo pelo Nome do
Scio ou Atividade.
Um boto a ser utilizado para fechar o formulrio.
Para criar um template de formulrio para excluso de registro, voc deve executar os seguintes
procedimentos:
2. Inclua um componente DBGrid (primeiro componente da pgina Data Controls da paleta de
componentes) no formulrio.
3. Defina como True a propriedade ReadOnly deste DBGrid, diretamente no Object Inspector.
4. Defina como True a subpropriedade RowSelect da propriedade Options deste componente,
diretamente no Object Inspector.
5. Inclua um boto de comando com figura (o segundo componente da pgina Additional) na
parte inferior do formulrio, e defina da seguinte maneira as suas principais propriedades:
Figura 14.1: Aspecto do formulrio a ser usado como template.
12. Inclua o nome da unit UnitDados na clusula uses da unit associada a este formulrio.
13. Selecione o boto direito do mouse sobre o formulrio para exibir o seu menu pop-up, conforme
mostrado na Figura 14.2.
Glyph: Localize o arquivo Trash.bmp (no Delphi 7 este arquivo costuma estar em c:\Arquivos de
programas\Arquivos comuns\Borland shared\Images\Buttons\Trash.bmp, a menos que voc tenha
alterado o diretrio default de instalao).
Height: 50
Width: 100
Default: False
Kind: bkCustom
ModalResult: mrNone
6. Inclua outro boto de comando com figura na parte inferior do formulrio, e defina da seguinte
Name: BotaoFechar
Kind: bkClose
Caption: &Fechar
Height: 50
Width: 100
Name para EditPesquisa.
8. Apague o texto existente na propriedade Text do componente EditPesquisa.
9. Inclua um componente Label no formulrio e altere o valor da sua propriedade Caption para
Digite o Nome a ser Pesquisado.
10. Altere as propriedades Name e Caption do formulrio para FormExclusao e Excluso de ,
respectivamente.
semelhante ao apresentado na Figura 14.1.
Name: BotaoExcluir
Caption: &Excluir
Figura 14.2: Exibindo o menu pop-up do Formulrio.
14. Neste menu pop-up, selecione o item Add To Repository, como indicado na figura anterior,
para exibir a caixa de dilogo de mesmo nome, reproduzida na Figura 14.3.
Figura 14.3: A caixa de dilogo Add To Repository.
15. Digite um ttulo para este template na caixa de texto Title, desta caixa de dilogo, como indicado
na figura anterior. Este ser o nome exibido na caixa de dilogo New Items, quando se desejar
criar um novo formulrio usando este template.
16. Digite uma descrio para este template na caixa de texto Description, desta caixa de dilogo,
como indicado na figura anterior. Esta descrio tem por finalidade documentar o objetivo do
template.
17. Na caixa combo Page digite o nome da pgina da caixa de dilogo New Items na qual o tem-
plate ser exibido, ou selecione um dos nomes disponveis.
18. Digite o nome do autor deste template na caixa de texto Author, desta caixa de dilogo, como
indicado na figura anterior.
19. Opcionalmente, voc pode definir um cone alternativo para representar este template. Para
isto, basta selecionar o boto Browse, clicando sobre o mesmo com o boto esquerdo do mouse,
e especificar o nome do arquivo do cone na caixa de dilogo que ser exibida.
20. Selecione o boto Ok para fechar esta caixa de dilogo. Ser exibida uma mensagem, reproduzida
na figura a seguir, indicando que a unit deve ser salva.
Figura 14.4: Mensagem indicando que a unit deve ser salva.
21. Selecione yes nesta caixa de dilogo. Ser exibida a caixa de dilogo Save Unit1 As, na qual
dever ser fornecido um nome para a unit. D o nome UnitTemplateExclusao para esta unit,
como mostrado na figura a seguir e selecione o boto Salvar, para fechar esta caixa de dilogo.
Figura 14.5: A caixa de dilogo Save Unit1 As.
Pronto! O Template foi criado e poder ser usado na criao dos formulrios de excluso, conforme
ser mostrado nos prximos tpicos.
CRIANDO FORMULRIOS A PARTIR DE UM TEMPLATE
Neste tpico, mostraremos os procedimentos necessrios criao de formulrios de excluso a partir
do template criado no tpico anterior.
CRIANDO O FORMULRIO DE EXCLUSO DE SCIOS
Para criar o formulrio de excluso de scios a partir do template criado no tpico anterior, voc deve
Items. Nesta caixa de dilogo, voc deve selecionar o template criado no tpico anterior, como
mostrado na Figura 14.4.
Repare que esta caixa de dilogo possui a guia Clube (referente ao projeto) e CLUBE (referente ao Template).
2. Selecione o boto OK para fechar esta caixa de dilogo e criar o novo formulrio.
3. Altere as propriedades Name e Caption do formulrio recm-criado para FormExclusaoSocios e
Excluso de Scios, respectivamente.
4. Altere a propriedade Datasource do DBGrid para Dados.DatasourceSocios.
5. Inclua a unit DB na clusula Uses da unit associada ao formulrio.
6. Defina da seguinte maneira o procedimento associado ao evento OnChange do componente
EditPesquisa:
procedure TFormExclusaoSocios.EditPesquisaChange(Sender: TObject);
begin
Dados.SimpleDatasetSocios.Locate(NOME,VarArrayOf([EditPesquisa.Text]),[loPartialKey,LocaseInsensitive]);
end;
Este cdigo faz com que seja efetuada uma pesquisa aproximada pelo nome do cliente.
BotaoExcluir:
procedure TFormExclusaoSocios.BotaoExcluirClick(Sender: TObject);
begin
if MessageDlg(Confirma a Excluso do Registro?,mtConfirmation,mbOkCancel,0) = mrOk
then Dados.SimpleDataSetsocios.Delete;
end;
Desta maneira, ser enviada uma mensagem de confirmao antes que o registro seja efetivamente excludo.
procedure TFormExclusaoSocios.FormShow(Sender: TObject);
begin
end;
procedure TFormExclusaoSocios.FormClose(Sender: TObject;
begin
end;
10. Salve a unit associada a este formulrio com o nome UnitExlusaoSocios.
12. Inclua a seguinte linha de cdigo no procedimento associado ao evento OnClick do item Excluso
do menu Scios, e compartilhe este procedimento com o evento OnClick do item Excluir do
submenu Scios do menu pop-up do formulrio.
FormExclusaoSocios.ShowModal;
CRIANDO O FORMULRIO DE EXCLUSO DE ATIVIDADES
Para criar o formulrio de excluso de atividades a partir do template criado no tpico anterior, voc
Items. Nesta caixa de dilogo, voc deve selecionar o template criado no tpico anterior.
3. Altere as propriedades Name e Caption do formulrio recm-criado para FormExclusaoAtividades
e Excluso de Atividades, respectivamente.
4. Altere a propriedade Datasource do DBGrid para Dados.DatasourceAtividades.
procedure TFormExclusaoAtividades.FormShow(Sender: TObject);
begin
EditPesquisa.Clear;
end;
EditPesquisa:
procedure TFormExclusaoAtividades.EditPesquisaChange(Sender: TObject);
begin
Dados.SimpleDatasetAtividades.Locate(NOME,VarArrayOf([EditPesquisa.Text]),[loPartialKey,LocaseInsensitive]);
end;
Este cdigo faz com que seja efetuada uma pesquisa aproximada pelo nome da atividade.
BotaoExcluir:
procedure TFormExclusaoAtividades.BotaoExcluirClick(Sender: TObject);
begin
then Dados.SimpleDataSetAtividades.Delete;
end;
9. Salve a unit associada a este formulrio com o nome UnitExclusaoAtividades.
procedure TFormExclusaoAtividades.FormClose(Sender: TObject;
begin
Dados.SimpleDatasetAtividades.ApplyUpdates(0);
end;
Excluso do menu Atividades, e compartilhe este procedimento com o evento OnClick do
item Excluso do submenu Atividades do menu pop-up do formulrio.
FormExclusaoAtividades.ShowModal;
A LINGUAGEM SQL
SQL a abreviatura de Structured Query Language (Linguagem Estruturada de Consulta). Nos ltimos
anos, a linguagem SQL se transformou numa linguagem padro para a consulta e acesso a registros de
bancos de dados, sendo convencionalmente subdividida em:
Uma linguagem de manipulao de dados (DML Data Manipulation Language).
Uma linguagem de controle de dados (DCL Data Control Language).
Uma linguagem de definio de dados (DDL Data Definition Language).
Embora existam vrios dialetos para a linguagem SQL, uma tentativa de padronizao foi feita com a
definio da linguagem SQL ANSI-92. Este livro no tem por objetivo apresentar ao leitor uma descrio
completa da linguagem SQL, mas isto no nos impede de mostrar como os seus comandos podem ser
executados a partir de um aplicativo desenvolvido com o Delphi 7.
Para executar comandos SQL em um aplicativo desenvolvido com o Delphi 7, voc pode usar o componente
SimpleDataset com o qual j est trabalhando, mas deve no entanto considerar as seguintes modificaes:
Sua propriedade CommandTupe dever ser definida como ctQuery, e no como ctTable.
Sua propriedade CommandText dever definir o comando SQL a ser executado.
CRIANDO O FORMULRIO DE EXCLUSO DE MATRCULAS
Para criar o formulrio de excluso de matrculas a partir do template criado no tpico anterior,
seguiremos um procedimento um pouco diferenciado. Como a tabela de matrculas s armazena os
cdigos do scio e das atividades, e seria difcil pesquisar um scio ou uma atividade por um destes
campos, faremos o acesso atravs de um comando SQL (uma linguagem padro para acesso a bancos
de dados). Ser apresentado tambm o conceito de relacionamento entre tabelas na memria.
Desta maneira, para criar o novo formulrio voc dever executar os seguintes procedimentos:
Items. Nesta caixa de dilogo, voc deve selecionar o template criado no tpico anterior.
3. Altere as propriedades Name e Caption do formulrio recm-criado para FormExclusaoMatriculas
e Excluso de Matrculas, respectivamente.
4. Inclua um componente SimpleDataset no formulrio (e no no DataModule, pois este
componente no ser compartilhado entre vrios formulrios) e atribua os seguintes valores s
suas principais propriedades:
Name: SimpleDatasetConsulta.
Subpropriedade CommandType da Propriedade Dataset: ctQuery
Subpropriedade Command da Propriedade Dataset: Defina esta propriedade como mostrado
na caixa de dilogo Command Text Editor mostrada na Figura a seguir, exibida quando se
selecionam os trs pontinhos direita do nome da propriedade.
Subpropriedade Active da Propriedade Dataset: True.
Figura 14.7: A caixa de dilogo Command Text Editor.
Repare que esta caixa de dilogo define o seguinte comando SQL:
Select SOCIOS.CODIGOSOCIO, SOCIOS.NOME AS NOME, SOCIOS.SOBRENOME AS SOBRENOME,
ATIVIDADES.CODIGOATIVIDADE, ATIVIDADES.NOME As ATIVIDADE FROM SOCIOS, ATIVIDADES,
MATRICULAS
WHERE
SOCIOS.CODIGOSOCIO = MATRICULAS.SOCIO AND ATIVIDADES.CODIGOATIVIDADE =
MATRICULAS.ATIVIDADE
ORDER BY SOCIOS.NOME, SOCIOS.SOBRENOME
Vamos analisar este cdigo:
Select SOCIOS.CODIGOSOCIO, SOCIOS.NOME AS NOME, SOCIOS.SOBRENOME AS SOBRENOME,
ATIVIDADES.CODIGOATIVIDADE, ATIVIDADES.NOME As ATIVIDADE FROM SOCIOS, ATIVIDADES, MATRICULAS
Este trecho de cdigo seleciona (SELECT) os campos CodigoSocio da tabela Scios (SOCIOS.CODIGOSOCIO),
Nome da tabela Scios (SOCIOS.NOME AS NOME), Sobrenome da tabela Scios (SOCIOS.SOBRENOME AS
SOBRENOME), CodigoAtividade da tabela Atividades (ATIVIDADES.CODIGOATIVIDADE), e campo Nome
da tabela Atividades (ATIVIDADES.NOME AS ATIVIDADE).
Repare que, quando se manipulam vrias tabelas em um cdigo Select, o acesso a um campo de uma
tabela segue a sintaxe Nome_Tabela.Nome_Campo.
O conector As d um nome alternativo para cada um dos campos selecionados.
FROM SOCIOS, ATIVIDADES, MATRICULAS
Este trecho de cdigo informa os nomes das tabelas a partir das quais ser montada a consulta.
WHERE
SOCIOS.CODIGOSOCIO = MATRICULAS.SOCIO AND ATIVIDADES.CODIGOATIVIDADE = MATRICULAS.ATIVIDADE
Este trecho de cdigo define as condies que devem ser obedecidas por estes campos. Os campos
selecionados so descritos no trecho de cdigo anterior (SELECT) e desde que (WHERE) as seguintes
condies sejam satisfeitas:
O valor armazenado no campo CodigoSocio da tabela Scios deve ser igual ao campo SOCIO
da tabela MATRICULAS.
E (AND)
O valor armazenado no campo CodigoAtividade da tabela Atividades deve ser igual ao campo
ATIVIDADE da tabela MATRICULAS.
ORDER BY SOCIOS.NOME, SOCIOS.SOBRENOME
Este trecho de cdigo define que os registros retornados (satisfazendo as condies anteriores) devero
ser ordenados pelos campos Nome e Sobrenome da tabela Scios.
5. Inclua um componente Datasource neste formulrio e atribua os seguintes valores para as suas
Name: DatasourceConsulta.
Dataset: SimpleDatasetConsulta.
6. Inclua um segundo componente SimpleDataset neste formulrio e atribua os seguintes valores
s suas principais propriedades:
Name: SimpleDatasetExclusao.
Subpropriedade CommandType da Propriedade Dataset: ctTable.
Subpropriedade Command da Propriedade Dataset: Matriculas.
Propriedade Mastersource: DatasourceConsulta.
Propriedade Masterfield: Definida selecionando os trs pontinhos direita da propriedade
para exibir a caixa de dilogo Field Link Editor, como mostrado nas figuras a seguir. Repare
que voc deve selecionar os campos que estabelecero o relacionamento e o boto Add.
Subpropriedade Active da Propriedade Dataset: True.
Figura 14.8: Selecionando o primeiro relacionamento.
Figura 14.9: Selecionando o segundo relacionamento.
7. Altere a propriedade Datasource do DBGrid para DatasourceConsulta.
procedure TFormExclusaoMatriculas.FormShow(Sender: TObject);
begin
SimpleDataSetConsulta.Open;
SimpleDataSetExclusao.Open;
EditPesquisa.Clear;
end;
EditPesquisa:
procedure TFormExclusaoMatriculas.EditPesquisaChange(Sender: TObject);
begin
Dados.SimpleDatasetConsulta.Locate(Nome,VarArrayOf([EditPesquisa.Text]),[loPartialKey,LocaseInsensitive]);
end;
Este cdigo faz com que seja efetuada uma pesquisa aproximada pelo nome do scio.
BotaoExcluir:
procedure TFormExclusaoMatriculas.BotaoExcluirClick(Sender: TObject);
begin
then
begin
SimpleDataSetExclusao.Delete;
SimpleDataSetConsulta.Refresh;
end;
end;
12. Salve a unit associada a este formulrio com o nome UnitExlusaoMatriculas.
procedure TFormExclusaoMatriculas.FormClose(Sender: TObject;
begin
Dados.SimpleDatasetExclusao.ApplyUpdates(0);
end;
15. D um duplo clique com o boto esquerdo do mouse sobre o DBGrid, para exibir a janela
Columns Editor (editor de colunas) do DBGrid, como mostrado na figura a seguir.
Figura 14.10: O editor de colunas do Componente DBGrid.
16. Exiba o menu pop-up desta janela e selecione o item Add All Fields, para criar objetos que
representam os campos exibidos nas colunas do DBGrid, como mostrado na Figura 14.11. Estes
objetos permitem que se configure de forma independente cada uma das colunas do DBGrid.
17. Remova os objetos correspondentes aos campos CODIGOSOCIO e CODIGOATIVIDADE,
selecionando-se e pressionando a tecla Del. Desta forma, o DBGrid s exibir as colunas
correspondentes aos campos Lookup.
Excluso do menu Matrculas, e compartilhe este procedimento com o evento OnClick do
item Excluso do submenu Matrculas do menu pop-up do formulrio.
FormExclusaoMatriculas.ShowModal;
Figura 14.11: O editor de colunas do componente DBGrid.
CAPTULO 15 CRIANDO FORMULRIOS PARA CONSULTA DE SCIOS, ATIVIDADES E MATRCULAS
Captulo
Criando Formulrios Para Consulta
de Scios, Atividades e Matrculas
15
Neste captulo vamos criar formulrios destinados consulta dos dados dos scios, atividades e
matrculas. Estes formulrios sero muito semelhantes queles criados para excluso, exceto pela
inexistncia de um boto de excluso. Podemos ento cri-los a partir dos formulrios de consulta,
excluindo o boto Excluir em cada um deles.
CRIAO DE FORMULRIOS PARA CONSULTA DE DADOS
PR-REQUISITOS
METODOLOGIA
Apresentao e descrio dos conceitos relacionados criao de formulrios para consulta de dados.
TCNICA
Apresentao e descrio dos procedimenttos relacionados criao de formulrios para consulta de dados a partir de formulrios criados
para excluso.
CRIANDO UM FORMULRIO PARA A CONSULTA DE DADOS DOS SCIOS
Este formulrio ser criado a partir do formulrio criado para excluso de scios, e para isso voc deve
Items. Nesta caixa de dilogo, voc deve selecionar o Formulrio de excluso de scios j
existente, como mostrado na figura a seguir.
CAPTULO 15 CRIANDO FORMULRIOS PARA CONSULTA DE SCIOS, ATIVIDADES E MATRCULAS
Repare que neste caso estamos usando a guia Clube (referente ao projeto) e no a guia CLUBE (referente ao Template). Repare ainda
a seleo da opo inherit, que indica que ser usado o mecanismo de herana de formulrios.
3. Altere as propriedades Name e Caption do formulrio recm-criado para FormConsultaSocios
e Consulta de Scios, respectivamente.
4. Defina como False a Propriedade Visible do componente BotaoExcluir.
Repare que, como este formulrio foi criado a partir do formulrio FormExclusaoSocios usando o mecanismo de herana, no possvel excluir
o componente BotaoExcluir, a menos que isso fosse feito no prprio formulrio ancestral (no o caso). A redefinio de valores de propriedade,
no entanto, permitida. A existncia deste mecanismo verificada na seguinte linha de cdigo, extrada da unit deste formulrio:
type
TFormConsultaSocios = class(TFormExclusaoSocios)
Repare que os diversos componentes esto todos definidos no formulrio ancestral. No caso do captulo
anterior, em que foi criado um template independente, a opo Copy pode ser usada na caixa de
dilogo New Items, e neste caso foram criadas cpias do formulrio criado como template, desvinculados
de qualquer herana com o formulrio original.
5. Salve a unit associada a este formulrio com o nome UnitCONSULTASocios.
7. Inclua a seguinte linha de cdigo no procedimento associado ao evento OnClick do item Consulta
do menu Scios, e compartilhe este procedimento com o evento OnClick do item Consulta do
submenu Scios do menu pop-up do formulrio.
FormConsultaSocios.ShowModal;
CRIANDO UM FORMULRIO PARA A CONSULTA DE DADOS DAS ATIVIDADES
Este formulrio ser criado a partir do formulrio criado para excluso de atividades, e para isso voc
1. Selecionar o item New/Other do menu File do Delphi 7, para exibir a caixa de dilogo New Items.
Nesta caixa de dilogo, voc deve selecionar o Formulrio de excluso de atividades j existente
3. Altere as propriedades Name e Caption do formulrio recm-criado para
FormConsultaAtividades e Consulta de Atividades, respectivamente.
4. Defina como False a Propriedade Visible do componente BotaoExcluir.
5. Salve a unit associada a este formulrio com o nome UnitConsultaAtividades.
Consulta do menu Atividades, e compartilhe este procedimento com o evento OnClick do
item Consulta do submenu Atividades do menu pop-up do formulrio.
FormConsultaAtividades.ShowModal;
CRIANDO UM FORMULRIO PARA A CONSULTA DE DADOS DAS MATRCULAS
Este formulrio ser criado a partir do formulrio criado para excluso de Matrculas, e para isso voc
Nesta caixa de dilogo, voc deve selecionar o Formulrio de excluso de Matrculas j existente
3. Altere as propriedades Name e Caption do formulrio recm-criado para FormConsultaMa-
triculas e Consulta de Matrculas, respectivamente.
4. Defina como False a Propriedade Visible do componente BotaoExclui.
5. Salve a unit associada a este formulrio com o nome UnitConsultaMatriculas.
Consulta do menu Matrculas, e compartilhe este procedimento com o evento OnClick do
item Consulta do submenu Matrculas do menu pop-up do formulrio.
FormConsultaMatriculas.ShowModal;
CAPTULO 16 CRIANDO ROTINAS DE BACKUP E RESTAURAO
Captulo
Criando Rotinas de Backup
e Restaurao
16
Neste captulo vamos criar as rotinas de backup e restaurao de nossos arquivos de dados. Este
procedimento muito importante, tendo em vista que no raro acontecerem situaes em que
ocorrem perdas de dados devido a fatores indesejveis como corte no fornecimento de energia eltrica
ou falha no sistema operacional, dentre outras causas possveis. Evidentemente os procedimentos so
muito limitados, devendo-se usar tcnicas de compresso de arquivos em aplicaes mais sofisticadas.
CPIA DE ARQUIVOS
PR-REQUISITOS
METODOLOGIA
Apresentao e descrio dos comandos da linguagem pascal que permitem a realizao de cpias de arquivos.
TCNICA
Apresentao e descrio dos procedimentos necessrios criao de formulrios para cpia e restaurao de arquivos.
Para efetuar cpias de arquivos, o Delphi 7 fornece acesso a uma funo chamada CopyFileTo, definida
na unit IdGlobal, que permite que esta tarefa seja executada de maneira simples e rpida.
Esta funo recebe como parmetros:
Uma string que define o nome do arquivo a ser copiado (incluindo seu path).
Uma string que define o nome do arquivo de destino para o qual a cpia ser feita (incluindo
seu path).
Esta funo multiplataforma, e retorna False se o arquivo de destino j existir. Logo, deve-se
inicialmente testar se o referido arquivo j existe e, em caso positivo, apag-lo.
CRIANDO UM FORMULRIO DE BACKUP
Para criar um formulrio de Backup, voc dever executar os seguintes procedimentos:
2. Altere os valores das suas propriedades Name e Caption para FormBackup e Backup de Dados
respectivamente.
3. Coloque um label no formulrio e defina sua propriedade Caption como Digite o Nome do
Arquivo de Destino (incluindo seu path).
4. Inclua um componente Caixa de Texto (pgina Standard) no formulrio e defina os seguintes
valores para as suas principais propriedades.
5. Inclua um componente Boto de Comando com figura no formulrio e defina os seguintes
Name: BotaoCopiar
Caption: &Copiar
Glyph: c:\Arquivos de programas\Arquivos comuns\Borland shared\Images\Buttons\
Floppy.bmp.
Height: 50
Width: 100
6. Inclua um segundo componente Boto de Comando com figura no formulrio e defina os
seguintes valores para as suas principais propriedades.
Name: BotaoFechar
Kind: bkClose
Caption: &Fechar
Height: 50
Width: 100
Seu formulrio dever ficar com o aspecto indicado na figura a seguir.
Name: EditDestino
Text (Deixe em Branco)
Figura 16.1: Aspecto final do formulrio de backup.
7. Inclua o nome da unit IdGlobal na clusula uses da unit associada a este formulrio.
8. Defina da seguinte maneira o procedimento associado ao evento Onclick do componente
BotaoCopiar:
procedure TFormBackup.BotaoCopiarClick(Sender: TObject);
var
origem, destino: string;
begin
origem := ExtractFilePath(Application.Exename)+C:\DB\Clube.gdb;;
destino := EditDestino.Text;
if FileExists(destino) then DeleteFile(destino);
if (CopyFileTo(origem,destino))
then
ShowMessage(Backup Efetuado com Sucesso)
else
ShowMessage(Cpia No Efetuada);
end;
A funo ExtractFilePath retorna na forma de uma string o diretrio completo do arquivo cujo nome
passado como parmetro, tambm na forma de uma string. Para obter o nome do arquivo executvel
da aplicao, basta usar o mtodo ExeName do objeto Application (que representa a aplicao).
Observe que inicialmente so declaradas duas variveis do tipo string, destinadas a armazenar os nomes
dos arquivos de origem e de destino, a serem usadas na chamada da funo CopyFileTo.
9. Salve a unit associada a este arquivo de cdigo com o nome UnitBackup.
10. Inclua o nome desta unit na clusula uses da unit associada ao formulrio FormPrincipal (o
formulrio principal da aplicao).
Backup do menu Sistema, e compartilhe este procedimento com o evento OnClick do item
Backup do submenu Sistema do menu pop-up do formulrio.
FormBackup.ShowModal;
Para criar um formulrio de Restaurao de dados, voc dever executar os seguintes procedimentos:
2. Altere os valores das suas propriedades Name e Caption para FormRestaura e Recuperao de
Dados respectivamente.
3. Coloque um label no formulrio e defina sua propriedade Caption como Digite o Nome do
Arquivo de Origem (incluindo seu path).
4. Inclua um componente Caixa de Texto (pgina Standard) no formulrio e defina os seguintes
Name: EditOrigem
Text (Deixe em Branco)
5. Inclua um componente Boto de Comando com figura no formulrio e defina os seguintes
Name: BotaoCopiar
Caption: &Copiar
Glyph: c:\Arquivos de programas\Arquivos comuns\Borland shared\Images\Buttons\
Floppy.bmp.
Height: 50
Width: 100
6. Inclua um segundo componente Boto de Comando com figura no formulrio e defina os
seguintes valores para as suas principais propriedades.
Name: BotaoFechar
Kind: bkClose
Figura 16.2: Aspecto final do formulrio de Recuperao de Dados.
7. Inclua o nome da unit IdGlobal na clusula uses da unit associada a este formulrio.
8. Defina da seguinte maneira o procedimento associado ao evento Onclick do componente
BotaoCopiar:
procedure TFormRestaura.BotaoCopiarClick(Sender: TObject);
var
origem, destino: string;
begin
origem := Editorigem.Text;
destino := ExtractFilePath(Application.Exename)+C:\DB\Clube.gdb;;
if FileExists(destino) then DeleteFile(destino);
if (CopyFileTo(origem,destino))
then
ShowMessage(Recuperao Efetuada com Sucesso)
else
ShowMessage(Cpia No Efetuada);
end;
9. Salve a unit associada a este arquivo de cdigo com o nome UnitRestaura.
10. Inclua o nome desta unit na clusula uses da unit associada ao formulrio FormPrincipal (o
formulrio principal da aplicao).
11. Inclua a seguinte linha de cdigo no procedimento associado ao evento OnClick do item Restaurar
do menu Sistema, e compartilhe este procedimento com o evento OnClick do item Restaurar do
submenu Sistema do menu pop-up do formulrio.
FormRestaura.ShowModal;
Evidentemente estamos supondo que o backup esteja sendo feito para um meio de armazenamento
secundrio de grande capacidade, como um ZipDisk ou um SuperDisk. Uma opo alternativa seria a
utilizao de componentes disponveis no mercado, que gerenciam a compactao de arquivos (no
formato .zip) e possuem mtodos capazes de gerenciar cpia de arquivos para mltiplos disquetes.
Caption: &Fechar
Height: 50
Width: 100
Seu formulrio dever ficar com o aspecto indicado na Figura 16.2.
CAPTULO 17 CRIAO DE RELATRIOS COM O RAVE REPORTS
Parte
Know-How
II
BORLAND DELPHI 7 CURSO COMPLETO PARTE II: KNOW-HOW
Captulo
Criao de Relatrios
com o Rave Reports
17
Neste captulo, sero apresentados os componentes que integram o pacote do Rave Reports (utilizado
para a criao de relatrios em aplicaes desenvolvidas com o Borland Delphi 7), e os procedimentos
necessrios criao de relatrios com esses componentes.
KNOW-HOW EM: CRIAO DE RELATRIOS COM O RAVE REPORTS
PR-REQUISITOS
Noes bsicas da utilizao do ambiente de desenvolvimento do Borland Delphi 7.
Conceitos bsicos sobre a utilizao de componentes de acesso a bancos de dados.
METODOLOGIA
Apresentao e descrio dos principais conceitos relacionados criao de relatrios com o conjunto de componentes Rave Reports.
TCNICA
Apresentao dos procedimentos necessrios criao de relatrios com o conjunto de componentes Rave Reports.
INTRODUO
O Rave Reports , na realidade, um conjunto de componentes situados na pgina Rave da paleta de
componentes, que permite a criao de relatrios de forma simples e rpida.
O COMPONENTE RVPROJECT
O componente RvProject (o primeiro componente da pgina Rave da paleta de componentes) de
fundamental importncia na criao de relatrios com o Rave Reports, pois fornece acesso direto a um
ambiente de desenvolvimento intrnseco criao de relatrios.
CRIANDO UM RELATRIO DE SCIOS
Para criar um relatrio com os dados dos scios, voc deve executar os seguintes procedimentos:
1. Crie um novo Datamodule, executando os procedimentos j descritos nos captulos anteriores,
e altere sua propriedade Name para Relatrios (lembre-se que um Datamodule um repositrio
de objetos no-visuais, e no serve apenas para armazenar componentes de acesso a dados).
2. Inclua um componente RvProject neste Datamodule, e altere o valor da sua propriedade Name
para RvClube.
3. Inclua um componente RvDatasetConnection neste Datamodule, e altere o valor da sua
propriedade Name para RvDatasetConnectionSocios.
4. Inclua a unit UnitDados na clusula uses da unit associada a este Datamodule.
5. Atribua o valor Dados.SimpleDatasetSocios propriedade Dataset do componente
RvDatasetConnectionSocios. Seu Datamodule dever ficar com o aspecto mostrado na figura
a seguir.
Figura 17.1: Iniciando a criao de um relatrio.
6. D um duplo clique com o boto esquerdo do mouse sobre o componente RvClube. Ser
exibido o ambiente de desenvolvimento do Rave Reports, mostrado na figura a seguir.
Figura 17.2: O ambiente de desenvolvimento do Rave Reports.
Repare que este ambiente apresenta sua prpria paleta de componentes, seu prprio Object Inspector, etc.
7. Selecione o item New Data Object do menu File do ambiente do Rave Reports, para exibir a
caixa de dilogo Data Connection, mostrada na Figura 17.3.
8. Nesta caixa de dilogo, selecione o item Direct Data View e o boto Next. Sero exibidas as
conexes de dados disponveis (no momennto s h uma), como mostra a Figura 17.4.
9. Selecione a nica conexo disponvel e o boto Finish. Selecione e expanda a opo Data View
Dictionary, no lado direito do ambiente do Rave Reports. Selecione o item Dataview1 e altere
para DataviewSocios a sua propriedade Name. Repare que foram inseridos objetos
correspondentes aos diversos campos da tabela Scios, como mostrado na figura a seguir.
Figura 17.3: A caixa de dilogo Data Connections.
Figura 17.4: Exibindo as conexes de dados disponveis na caixa de dilogo Data Connections.
Figura 17.5: Exibindo os objetos correspondentes opo Data View Dictionary.
10. Selecione e expanda a opo Repot Library, no lado direito do ambiente do Rave Reports.
Selecione o item Report1 e altere para RelatSocios a sua propriedade Name.
11. Inclua um componente Region (pgina Report da paleta de componentes do ambiente de
desenvolvimento do Rave Reports) na rea da pgina do relatrio (rea central do ambiente
de desenvolvimento do Rave Reports) e faa com que este componente ocupe toda a rea
disponvel, como mostrado na figura a seguir. Este componente permite que sejam adicionadas
bandas (faixas) ao relatrio.
Figura 17.6: Incluindo um componente Region.
12. Inclua um componente Band (pgina Report da paleta de componentes do ambiente de
desenvolvimento do Rave Reports) na rea superior do componente Region1.
13. Selecione os trs pontinhos direita da propriedade BandStyle para exibir a caixa de dilogo
Band Style Editor, mostrada na Figura 17.7.
14. Marque a opo Body Header e o boto Ok para fechar esta caixa de dilogo.
15. Altere para 0,990 o valor da propriedade Height.
16. Inclua nesta banda um componente Text (pgina Standard da paleta de componentes do
ambiente de desenvolvimento do Rave Reports) e atribua os seguintes valores s suas principais
propriedades:
Name: Ttulo
Text: Relatrio de Clientes
Font: Arial, Bold Italic, sublinhada, tamanho 20.
Top: 0,080
Figura 17.7: A caixa de dilogo Band Style Editor.
17. Centralize horizontalmente este componente na banda, selecionando o item Center Horizon-
tally na pgina Alignment da paleta de componentes do ambiente de desenvolvimento do
Rave Reports.
18. Coloque mais trs componentes Text e defina a propriedade Text de cada um deles como Cdigo,
Nome e Sobrenome, respectivamente. Defina para estes componentes a mesma fonte e cuide de
seu alinhamento. Seu relatrio dever ficar com o aspecto mostrado na figura a seguir.
Figura 17.8: Incluso de componentes do tipo Text.
19. Inclua um componente DataBand (pgina Report da paleta de componentes do ambiente de
desenvolvimento do Rave Reports) abaixo da banda existente. Esta banda ser a banda na qual
sero exibidos os dados dos registros das tabelas.
20. Atribua o valor DataviewSocios propriedade Dataview desta banda.
21. Nesta banda, coloque trs componentes DataText (pgina Report da paleta de componentes
do ambiente de desenvolvimento do Rave Reports) e atribua o valor DataviewSocios
propriedade Dataview de cada um destes componentes.
22. Configure a propriedade Datafield de cada um destes componentes como CODIGOSOCIO,
NOME e SOBRENOME, respectivamente.
23. Selecione o item Save do menu File do ambiente de desenvolvimento do Rave Reports e salve
o arquivo de projeto de relatrio com o nome RelatClube, no mesmo diretrio do seu projeto.
24. Para Pr-visualizar o relatrio, selecione Execute Report do menu File do ambiente de
desenvolvimento do Rave Reports. Ser exibida a caixa de dilogo Output Options mostrada
na figura a seguir.
Figura 17.9: A caixa de dilogo Output Options.
25. Nesta caixa de dilogo, selecione a opo Preview e o boto Ok para Pr-visualizar o relatrio,
como mostrado na Figura 17.10.
26. Salve a unit associada ao Datamodule Relatrios com o nome UnitRelatorios, e inclua o nome
desta unit na clusula uses da unit do formulrio principal da aplicao.
27. No Delphi 7, Atribua o valor RelatClube.rav propriedade ProjectFile do componente RvClube.
28. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Scios do
menu Relatrio, a ser compartilhado pelo item Scios do submenu Relatrios do menu pop-up.
procedure TFormPrincipal.RelatorioSociosClick(Sender: TObject);
begin
Relatorios.RvClube.SelectReport(RelatSocios,False);
Relatorios.RvClube.Execute;
end;
A primeira linha de cdigo seleciona o relatrio a ser exibido (podemos ter vrios relatrios relacionados
a um nico componente RvProject) e a segunda manda executar o relatrio selecionado.
Figura 17.10: Pr-visualizando o Relatrio.
CRIANDO UM RELATRIO DE ATIVIDADES
Para criar um relatrio com os dados das atividades, voc deve executar os seguintes procedimentos:
1. Inclua no Datamodule Relatrios mais um componente RvDatasetConnection, e altere o valor
da sua propriedade Name para RvDatasetConnectionSocios.
2. Atribua o valor Dados.SimpleDatasetAtividades propriedade Dataset do componente
RvDatasetConnectionAtividades.
exibido o ambiente de desenvolvimento do Rave Reports.
4. Selecione o item New Report do menu File do ambiente do Rave Reports, para criar um
novo relatrio.
5. Selecione e expanda a opo Repot Library, no lado direito do ambiente do Rave Reports. Selecione
o item Report2 e altere para RelatAtividades a sua propriedade Name.
caixa de dilogo Data Connection.
conexes de dados disponveis.
8. Selecione a conexo correspondente tabela de atividades.
desenvolvimento do Rave Reports) na rea da pgina do relatrio (rea central do ambiente de
desenvolvimento do Rave Reports) e faa com que este componente ocupe toda a rea disponvel.
Band Style Editor.
ambiente de desenvolvimento do Rave Reports) e atribua os seguintes valores s suas
Name: Ttulo
Text: Relatrio de Atividades
Top: 0,080
15. Centralize horizontalmente este componente na banda, selecionando o item Center Horizon-
tally na pgina Alignment da paleta de componentes do ambiente de desenvolvimento do
Rave Reports.
16. Coloque mais trs componentes Text e defina a propriedade Text de cada um deles como
Cdigo, Nome e Valor, respectivamente. Defina para estes componentes a mesma fonte e cuide
de seu alinhamento.
18. Atribua o valor DataviewAtividades propriedade Dataview desta banda.
do ambiente de desenvolvimento do Rave Reports) e atribua o valor DataviewAtividades
20. Configure a propriedade Datafield de cada um destes componentes como CODIGOATIVIDADE,
NOME e VALOR, respectivamente.
21. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Atividades do
menu Relatrio, a ser compartilhado pelo item Atividades do submenu Relatrios do menu pop-up.
procedure TFormPrincipal.RelatorioAtividadesClick(Sender: TObject);
begin
Relatorios.RvClube.SelectReport(RelatAtividades,False);
end;
22. Selecione o item Save do menu File do ambiente de desenvolvimento do Rave Reports para
salvar as alteraes no projeto de relatrio.
CRIANDO UM RELATRIO DE MATRCULAS
Para criar um relatrio com os dados das matrculas, voc deve executar os seguintes procedimentos:
1. Inclua no Datamodule Relatrios mais um componente RvDatasetConnection, e altere o valor
da sua propriedade Name para RvDatasetConnectionMatriculas.
2. Inclua a unit UnitExclusaoMatriculas na clusula uses da unit associada ao Datamodule Relatrios.
3. Atribua o valor FormExclusaoMatriculas.SimpleDatasetConsulta propriedade Dataset do
componente RvDatasetConnectionMatriculas.
exibido o ambiente de desenvolvimento do Rave Reports.
5. Selecione o item New Report do menu File do ambiente do Rave Reports, para criar um
novo relatrio.
6. Selecione e expanda a opo Report Library, no lado direito do ambiente do Rave Reports. Selecione
o item Report3 e altere para RelatMatriculas a sua propriedade Name.
caixa de dilogo Data Connection.
conexes de dados disponveis.
9. Selecione a conexo correspondente tabela de Matrculas.
desenvolvimento do Rave Reports) na rea da pgina do relatrio (rea central do ambiente de
desenvolvimento do Rave Reports) e faa com que este componente ocupe toda a rea disponvel.
Band Style Editor.
ambiente de desenvolvimento do Rave Reports) e atribua os seguintes valores s suas principais
propriedades:
Name: Ttulo
Text: Relatrio de Matrculas
Top: 0,080
16. Centralize horizontalmente este componente na banda, selecionando o item Center Hori-
zontally na pgina Alignment da paleta de componentes do ambiente de desenvolvimento
do Rave Reports.
17. Coloque mais trs componentes Text e defina a propriedade Text de cada um deles como
Nome, Sobrenome e Atividade, respectivamente. Defina para estes componentes a mesma fonte
e cuide de seu alinhamento.
19. Atribua o valor DataviewMatriculas propriedade Dataview desta banda.
do ambiente de desenvolvimento do Rave Reports) e atribua o valor DataviewMatriculas
21. Configure a propriedade Datafield de cada um destes componentes como NOME, SOBRENOME
e ATIVIDADE, respectivamente.
22. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Matrculas do
menu Relatrio, a ser compartilhado pelo item Matrculas do submenu Relatrios do menu pop-up.
procedure TFormPrincipal.RelatorioMatriculasClick(Sender: TObject);
begin
Relatorios.RvClube.SelectReport(RelatMatrculas,False);
end;
23. Selecione o item Save do menu File do ambiente de desenvolvimento do Rave Reports para
salvar as alteraes no projeto de relatrio.
CAPTULO 18 INCORPORANDO O RECURSO DE HELP ON-LINE NOSSA APLICAO
Captulo
Incorporando o Recurso de Help
On-Line Nossa Aplicao
18
Neste captulo sero apresentados os procedimentos necessrios incorporao do recurso de Help
On-Line ao seu aplicativo.
KNOW-HOW EM: CRIAO DE ARQUIVOS DE HELP
PR-REQUISITOS
Noes bsicas da utilizao do ambiente de desenvolvimento do Borland Delphi 7.
Conceitos bsicos sobre a utilizao de utilitrios para o ambiente Windows.
METODOLOGIA
Apresentao e descrio dos principais conceitos relacionados criao de Arquivos de Help com o Word e o Microsoft Help Compiler.
TCNICA
Apresentao e descrio dos procedimentos necessrios criao de Arquivos de Help com o Word e o Microsoft Help Compiler.
CRIANDO UM ARQUIVO DE HELP
Para criar um arquivo de Help voc deve usar um editor capaz de manipular arquivos no formato
RTF, como por exemplo o Word for Windows. Neste captulo vamos usar o Word XP para criar o
nosso arquivo de Help.
DEFININDO UMA PGINA DE NDICE
A maioria dos arquivos de Help On-Line apresenta uma pgina de ndice, onde so mostrados os ttulos
das principais sees ou tpicos do arquivo. No nosso caso, apenas para exemplificar, vamos criar uma
pgina com o ttulo ndice do Programa de Cadastro dos Scios do Clube e os seguintes tpicos:
Cadastrando um Novo Scio
Alterando os Dados de um Scio
Excluindo um Scio
Consultando um Scio
Cadastrando uma Nova Atividade
Alterando os Dados de uma Atividade
Excluindo uma Atividade
Consultando uma Atividade
Efetuando uma Matrcula
Removendo uma Matrcula
Consultando Matrculas
Relatrios
A figura a seguir mostra o aspecto da pgina criada, usando o Microsoft Word 2000.
Figura 18.1: Criando a pgina de tpicos.
CRIANDO UM ARQUIVO RTF
Para criar um arquivo RTF, voc deve executar os seguintes procedimentos:
1. Criar um documento no Word, como a pgina de tpicos mostrada anteriormente.
2. Selecione o item Salvar Como, do menu Arquivo. Ser exibida a caixa de dilogo Salvar como,
Figura 18.2: Salvando um arquivo no formato rtf.
3. Nesta caixa de dilogo digite o nome do arquivo e selecione a opo Rich Text Format (rtf) na
caixa combo Salvar como tipo:.
CRIANDO UMA PGINA PARA CADA TPICO
Cada tpico deve ser digitado em uma pgina distinta, como mostra a figura a seguir.
Figura 18.3: Definindo uma pgina para cada tpico.
CRIANDO STRINGS DE CONTEXTO
Cada tpico de um arquivo de Help deve ser identificado por uma string de contexto. o valor definido
para esta string de contexto que ser usado para que este tpico seja acessado a partir de outro. Vamos
definir Cad_Socios como a string de contexto para o tpico Cadastrando um Novo Scio.
Para criar uma string de contexto, voc deve executar os seguintes procedimentos:
1. Posicione o cursor no incio da pgina que representa o tpico cuja string de contexto est sendo definida.
2. Selecione o item Notas... do submenu Referncia do menu Inserir do Word XP. Ser exibida a
caixa de dilogo Nota de Rodap e Nota de Fim, mostrada na prxima figura.
Figura 18.4: A caixa de dilogo Nota de rodap e nota de fim.
3. Nesta caixa de dilogo, selecione a opo Notas de rodap.
4. Digite o caractere # na caixa de texto direita da opo Personalizada.
6. Digite a string de contexto na nota de rodap, logo aps o sinal #, criado no passo anterior,
como mostra a figura a seguir.
Figura 18.5: Definindo uma string de contexto para um tpico.
Uma string de contexto no pode conter espaos em branco e deve ter, no mximo, 255 caracteres.
CRIANDO UMA PALAVRA-CHAVE PARA UM TPICO
Cada tpico em um arquivo de Help deve possuir uma palavra-chave (que pode ser um texto com
espaos em branco), que a palavra pela qual o tpico poder ser pesquisado pelo Help do Windows.
O processo de criao de uma palavra-chave idntico ao de criao de uma string de contexto, exceto
que o caractere a ser digitado na caixa de texto direita da opo Personalizada, na caixa de dilogo
Nota de rodap e nota de fim, ser um K ao invs de um #. Normalmente se escolhe um texto
significativo, que neste caso pode ser Cadastro de Scios.
Se voc executar os passos descritos no tpico anterior para a criao desta palavra-chave, a sua pgina
de tpico dever ficar com o aspecto mostrado na figura a seguir.
Figura 18.6: Definindo uma palavra-chave para um tpico.
CRIANDO UM TTULO PARA UM TPICO
Cada tpico de um arquivo de Help deve possuir um ttulo pelo qual o tpico ser referenciado pelo
Help do Windows, quando selecionada a sua palavra-chave aps uma pesquisa pelo Help. O processo
de criao de um ttulo idntico ao de criao de uma string de contexto, exceto que o caractere a ser
digitado na caixa de texto direita da opo Personalizada na caixa de dilogo Nota de rodap e nota
de fim ser um $ ao invs de um #. Normalmente se escolhe um texto significativo, que neste
caso pode ser Cadastrando Novos Scios.
Se voc executar os passos descritos nos tpicos anteriores para a criao deste ttulo, a sua pgina de
tpico dever ficar com o aspecto mostrado na prxima figura.
Figura 18.7: Definindo um ttulo para um tpico.
ASSOCIANDO UM NMERO DE PGINA A UM TPICO
Cada tpico de um arquivo de Help deve possuir um nmero de pgina, que estabelece a sua localizao
numa seqncia de pginas a serem percorridas pelo usurio com os botes << e >> no Help do Win-
dows. O processo de criao de um nmero de pgina idntico ao de criao de uma string de
contexto, exceto que o caractere a ser digitado na caixa de texto direita da opo Personalizada na
caixa de dilogo Nota de rodap e nota de fim ser um + ao invs de um #. O nmero de pgina
pode ser precedido por uma seqncia de caracteres que define um grupo de pginas, desde que
terminado por dois-pontos (:).
Se voc executar os passos descritos nos tpicos anteriores para a criao do nmero de pgina
Topicos:001, a sua pgina de tpico dever ficar com o aspecto mostrado na Figura 18.8.
Crie voc mesmo as demais pginas de tpicos, executando os procedimentos descritos anteriormente.
Figura 18.8: Definindo um ttulo para um tpico.
ESTABELECENDO A CONEXO ENTRE TPICOS
Se voc j utilizou o arquivo de Help das principais aplicaes desenvolvidas para o ambiente Windows,
j deve ter percebido que algumas palavras so exibidas sublinhadas e na cor verde. Quando voc seleciona
estas palavras com o mouse, ocorre um salto para um outro tpico de um arquivo de Help.
Para implementar o salto para a pgina de tpico Cadastrando um Novo Scio. quando o usurio
selecionar este nome na pgina de ndice, basta executar os seguintes procedimentos:
1. Selecione o texto Cadastrando um Novo Scio na pgina de ndice.
2. Aplique o formato de duplo sublinhado ao texto selecionado no passo anterior.
3. Imediatamente aps o texto selecionado e formatado no passo anterior, digite a string de
contexto do tpico para onde ocorrer o salto, selecione-a e aplique o formato de texto
escondido. Sua pgina de ndices dever ficar com o aspecto mostrado na prxima figura.
Crie voc mesmo as conexes para os demais tpicos, executando os passos descritos anteriormente.
Pronto! Est estabelecida a conexo entre tpicos do Help!
Caso voc no esteja enxergando o texto oculto como mostra a Figura 18.9, marque a opo Texto Oculto na guia Exibir da caixa de
dilogo Opes do Word XP, exibida quando se seleciona o item Opes, do menu Ferramentas (Figura 18.10).
Figura 18.9: Definindo uma conexo para um tpico.
Figura 18.10: A pgina Exibir da caixa de dilogo Opes do Word XP.
Crie as demais pginas de tpicos e defina as strings de auxlio, palavras-chave, ttulo e numerao
como indicado. Defina a numerao da pgina de ndice como Tpico:001.
CRIANDO UM ARQUIVO DE PROJETO DE HELP
Alm do arquivo com a extenso rtf, voc precisa criar um arquivo de projeto (Help Project File), que
armazenar as informaes a serem usadas pelo compilador de arquivos de Help. Este arquivo deve ter
a extenso HPJ (no ser criado no Word) e o seu nome ser o nome do arquivo de Help, tendo este
ltimo a extenso EXE.
Um arquivo de projeto de Help composto de vrias sees, descritas a seguir:
A seo OPTIONS possui a seguinte sintaxe:
[OPTIONS]
CONTENTS = string_de_contexto
TITLE = title
COMPRESS = nvel_de_compresso
ERRORLOG = Nome_do_arquivo_de_descrio_de_erros
A primeira linha define a string de contexto do tpico principal do arquivo de Help (na realidade, o
Help On-Line de uma aplicao pode ser composto por vrios arquivos). Se esta linha for omitida, o
primeiro tpico do primeiro arquivo de ajuda ser assumido como tpico principal.
A segunda linha define o texto exibido na barra de ttulos do arquivo de Help.
A terceira linha define o tipo de compresso do arquivo. O nvel de compresso pode assumir um dos
valores definidos na tabela a seguir:
Valor Velocidade de Compilao Tamanho do arquivo
FALSE Rpida Grande (sem compresso)
MEDIUM Mdia Mdio (compresso mdia)
HIGH Lenta Pequeno (compresso alta)
0 Rpida Grande (sem compresso)
1 Lenta Pequeno (compresso alta)
NO Rpida Grande (sem compresso)
TRUE Lenta Pequeno (compresso alta)
YES Lenta Pequeno (compresso alta)
Se esta linha for omitida, no haver compresso.
A quarta linha define o arquivo no qual sero gravadas as mensagens de erros de compilao. Se esta linha
for omitida, as mensagens de erro sero exibidas na tela mas no sero enviadas para nenhum arquivo.
A seo CONFIG possui a seguinte sintaxe:
[CONFIG]
BrowseButtons()
Esta linha, se includa, faz com que os botes << e >> sejam exibidos, permitindo ao usurio percorrer
uma seqncia de pginas do arquivo de Help.
A seo FILES possui a seguinte sintaxe:
[FILES]
arquivo_1 com extenso rtf.
..............
arquivo_n com extenso rtf.
Nesta seo so listados os arquivos que vo compor o arquivo de Help.
Voc pode criar este arquivo em um editor de texto ou usando o Microsoft Help Workshop, como mostrado no prximo tpico.
CRIANDO E COMPILANDO O ARQUIVO DE PROJETO DE HELP COM O MICROSOFT HELP WORKSHOP
Para compilar o arquivo de Help com o Microsoft Help Workshop, voc deve executar os seguintes
procedimentos:
1. Execute o programa HCW.EXE, situado no subdiretrio c:\Arquivos de Programas\Borland\\
Delphi 7\Help\Tools. Ser exibida a seguinte tela de abertura:
Figura 18.11: A tela de abertura do Microsoft Help Workshop.
2. Selecione o item New do menu File. Ser exibida a caixa de dilogo New (Figura 18.12).
3. Selecione a opo Help Project.
4. Selecione o boto OK, para fechar a caixa de dilogo. Ser exibida a caixa de dilogo Project
File Name (Figura 18.13).
Figura 18.12: A caixa de dilogo New.
Figura 18.13: A Caixa de dilogo Project File Name.
5. Digite o nome do arquivo de projeto.
6. Selecione o boto Salvar, para fechar a caixa de dilogo. Ser criado o esqueleto do arquivo de
projeto, como mostra a Figura 18.14.
Figura 18.14: Criando o arquivo de projeto.
7. Selecione o boto Files, para exibir a caixa de dilogo Topic Files (Figura 18.15).
Figura 18.15: A caixa de dilogo Topic Files.
8. Selecione o boto Add, para exibir a caixa de dilogo Abrir (Figura 18.16).
Figura 18.16: A caixa de dilogo Abrir.
9. Selecione o arquivo desejado.
10. Clique em Open para fechar a caixa de dilogo Abrir.
11. Clique em OK para fechar a caixa de dilogo Topic Files. Seu arquivo ser includo no projeto,
como mostra a figura a seguir.
12. Selecione o boto Save and Compile, para salvar e compilar o arquivo de projeto de Help.
Pronto! Voc acaba de criar o arquivo Clube.hlp (o arquivo de help do seu aplicativo).
Voc pode configurar as diversas sees do arquivo de projeto de Help selecionando o boto correspondente na janela principal do
Microsoft Help Workshop.
Figura 18.17: Adio do arquivo Clube.rtf no arquivo de projeto.
ASSOCIANDO O ARQUIVO DE HELP SUA APLICAO
Para criar um Help sensvel ao contexto, execute os seguintes procedimentos a partir do ambiente do
Delphi 7:
1. Abra o seu projeto de aplicao.
2. Selecione o item Options do menu Project. Ser exibida a caixa de dilogo Project Options.
3. Selecione a pgina Application na caixa de dilogo Project Options.
4. Digite o path e o nome do arquivo de Help na caixa de texto Help file, como mostra a Figura 18.18.
Figura 18.18: A caixa de dilogo Project Options.
5. Selecione o boto OK para fechar a caixa de dilogo Project Options.
ASSOCIANDO UM COMPONENTE A UM TPICO DO ARQUIVO DE HELP
Cada componente do Borland Delphi 7 possui uma propriedade chamada HelpContext, qual deve
ser atribudo um valor inteiro. Para associar um tpico a um componente, deve-se atribuir um valor
inteiro (001, por exemplo) e criar uma correspondncia entre a string de contexto e este nmero na
seo [MAP] do arquivo de projeto (esta seo ainda no havia sido mencionada).
Exemplo:
[MAP]
Cad_Socios 002
Para associar um nmero a uma string de contexto, voc deve executar os seguintes procedimentos:
1. Abra o arquivo de projeto, selecionando o item Open no menu File do Microsoft Help Workshop.
2. Selecione o boto Map. Ser exibida a caixa de dilogo Map. Selecione o boto Add para exibir
a caixa de dilogo Add Map Entry (Figura 18.19).
Figura 18.19: A caixa de dilogo Add Map Entry.
3. Digite os valores adequados nas caixas de texto Topic ID e Mapped numeric value.
4. Selecione o boto OK para fechar a caixa de dilogo. Ser exibida a caixa de dilogo Map,
Figura 18.20: A caixa de dilogo Map.
5. Selecione o boto Save and Compile, para salvar e recompilar o arquivo de projeto de Help.
6. Atribua o valor 002 propriedade HelpContext do componente desejado.
EXIBINDO O ARQUIVO DE HELP EM RESPOSTA A UM ITEM DE MENU
Para que o arquivo de Help seja exibido quando o usurio selecionar o item Ajuda, do menu Help, ou
pressionar a tecla de funo F1, basta executar os seguintes procedimentos:
1. Incluir a seguinte linha de cdigo no procedimento associado ao evento OnClick do item de
menu:
WinHelp(FormPrincipal.handle,C:\loja\loja.hlp,HELP_CONTENTS,0);
2. Atribuir o valor F1 propriedade ShortCut do item de menu.
A funo WinHelp uma funo da API do Windows que requer os seguintes parmetros:
O handle da janela.
Uma string com o path completo e o nome do arquivo de Help.
O tipo de Help.
Um inteiro (geralmente pode ser usado o valor 0).
Assim, quando o usurio selecionar o item Ajuda, do menu Help, ou pressionar a tecla de funo F1,
ser exibida a tela do arquivo de Help associado aplicao.
CAPTULO 19 PROGRAMAO ORIENTADA A OBJETOS EM DELPHI 7
Captulo
Programao Orientada
a Objetos em Delphi 7
19
Nos ltimos anos, as tcnicas de programao orientada a objetos vm ocupando lugar de destaque no
cenrio de desenvolvimento de aplicaes, principalmente aps o surgimento de novas linguagens
que passaram a incorporar esse recurso, como o C++ e o Object Pascal (a linguagem de programao
utilizada pelo Delphi 7).
Inicialmente, importante salientar que as tcnicas de programao orientada a objetos no constituem
apenas um novo estilo de codificao, mas uma nova maneira de se abordar um problema a ser resolvido
com o uso do computador.
As linguagens de programao procedurais, predominantes anteriormente, tratavam os dados de um
problema e os procedimentos que manipulavam esses dados como entidades distintas. Geralmente os
dados eram passados como parmetros a estes procedimentos (a menos que fossem definidos como
variveis globais). Era ntida, portanto, a separao entre dados e funes como entidades distintas.
As linguagens de programao orientadas a objetos, por outro lado, tm como caracterstica principal
a capacidade de reunir os dados e as funes que operam sobre estes dados em uma nova e nica
entidade denominada classe. Desta maneira, as funes e os procedimentos (denominados mtodos
no linguajar da Programao Orientada a Objetos) definidos internamente classe passam a ter a
capacidade de acessar diretamente estes dados, que no precisam mais ser passados como parmetros.
Esta abordagem representa uma viso muito mais prxima da realidade, uma vez que, no nosso
cotidiano, lidamos o tempo todo com objetos que renem caractersticas (as propriedades que os
definem) e funcionalidades (caracterizadas pelos seus mtodos) em uma nica entidade.
Este captulo trata dos princpios da filosofia da programao orientada a objetos, comparando-os aos
da programao estruturada, tradicionalmente utilizada no desenvolvimento de programas por meio
do Pascal Procedural.
Inicialmente abordamos a programao estruturada em Object Pascal, para posteriormente apresentar
ao leitor as caractersticas da programao orientada a objetos, de forma a tornar mais claras as diferenas
entre as duas abordagens
evidente que no pretendemos esgotar este assunto, pois existem livros inteiramente dedicados anlise
e programao orientada a objetos, mas pretende-se dar ao leitor os conhecimentos necessrios ao
desenvolvimento de sistemas em Object Pascal (a linguagem de programao orientada a objetos do Delphi).
KNOW-HOW EM: PROGRAMAO PROCEDURAL
EM LINGUAGEM OBJECT PASCAL
PR-REQUISITOS
Experincia em programao estruturada com verses anteriores da linguagem Pascal.
METODOLOGIA
Apresentao do problema: Criao de um programa que utilize o Pascal procedural utilizando-se o ambiente de desenvolvimento integrado
do Delphi 7.
TCNICA
Utilizao do ambiente de desenvolvimento integrado do Delphi 7 para criar aplicaes tipo Console.
APRESENTAO DO PROBLEMA
Este tpico se destina a apresentar os procedimentos necessrios ao desenvolvimento de aplicaes
tipo console com o Delphi 7, e sua incluso decorre da necessidade de apresentarmos, nos tpicos que
se seguem, os fundamentos da programao orientada a objetos sem a necessidade de nos referirmos
aos elementos de criao da interface grfica de uma aplicao.
Alm disso, gostaria de iniciar este captulo relatando um fato bastante interessante, mas que pode
parecer um tanto estranho para os analistas, programadores e demais profissionais de informtica.
Nos ltimos anos, minha experincia acadmica e profissional tem demonstrado que, apesar de toda a
evoluo dos sistemas operacionais com interface grfica (como o Windows 95/98/Me/2000/NT/XP,
por exemplo), os currculos escolares de muitas faculdades e universidades brasileiras tm evitado a
incluso de disciplinas que abordem exclusivamente a utilizao de ambientes e linguagens visuais de
programao, como o Delphi, o C++ Builder, o Visual Basic, etc.
Esse fato se deve, entre outras causas, aos seguintes fatores:
Muitos professores ainda no aceitaram ou assimilaram os novos conceitos que envolvem as
tcnicas de programao orientada a objetos e a eventos.
As linguagens visuais de programao, ao simplificarem demasiadamente os procedimentos
necessrios criao da interface com o usurio, muitas vezes fazem com que o aluno diminua
o seu interesse pelas importantssimas tcnicas de codificao (lgica, algoritmos, anlise, etc.),
colocando-as em segundo plano.
importante salientar, entretanto, que as linguagens visuais de programao foram desenvolvidas
com o objetivo de minimizar o tempo gasto no desenvolvimento dessa interface, justamente para que
o analista ou programador dedique a maior parte do seu tempo s tarefas de codificao e implementao
relacionadas soluo de um determinado problema (que o objetivo de qualquer programa
automatizar a soluo de um dado problema).
H pouco tempo, antes do surgimento destas linguagens visuais, o desenvolvimento de um programa
extremamente simples para o ambiente Windows formado por uma nica janela requeria cerca de
80 linhas de cdigo-fonte escrito em linguagem C. A criao da interface, ento, exigia um enorme
esforo de programao.
Conseqentemente, as linguagens de programao procedurais (como o C e o Pascal) tm predominado
nos currculos universitrios (principalmente nos primeiros anos do curso).
importante lembrar, no entanto, que a linguagem Object Pascal , na realidade, uma evoluo da linguagem
Pascal e que o ambiente de desenvolvimento do Delphi 7 permite a codificao e a compilao de programas
desenvolvidos utilizando-se o Pascal como linguagem de programao no estilo procedural.
O objetivo deste tpico ser, portanto, mostrar como codificar e compilar programas escritos em
linguagem Pascal, usando o ambiente de desenvolvimento do Delphi 7. Nos tpicos subseqentes, ao
abordarmos a filosofia da programao orientada a objetos, as diferenas entre estas duas abordagens
ficaro muito mais claras.
UTILIZANDO O AMBIENTE DO DELPHI 7 PARA O PASCAL PROCEDURAL
Neste tpico sero apresentados os procedimentos necessrios utilizao do ambiente de
desenvolvimento do Delphi 7 para a criao de aplicaes que utilizem o Pascal como linguagem de
programao procedural. Esses tipos de aplicaes no tero formulrios (janelas), botes de comando
ou qualquer outro tipo de componente da interface padro do ambiente Windows, sendo definidas
pelo Delphi 7 como aplicaes do tipo console (sero executadas em uma janela padro do DOS).
Para criar uma aplicao do tipo console, proceda da seguinte maneira:
1. Selecione o item New/Other do menu File do Delphi 7, para exibir a caixa de dilogo New Items.
2. Selecione o item Console Application na pgina New desta caixa de dilogo, conforme indicado
na figura a seguir.
3. Selecione o boto Ok, para fechar esta caixa de dilogo.
Figura 19.1: Criando uma aplicao tipo console com o Delphi.
A aplicao tipo console ser criada com um nico arquivo (arquivo de projeto, com extenso dpr), e
cujo cdigo gerado reproduzido a seguir.
program Project1;
{$APPTYPE CONSOLE}
uses sysutils;
begin
end.
4. Salve o seu projeto com o nome Console.dpr, usando o tem Save Project As do menu File.
5. O cdigo-fonte do seu arquivo de projeto dever ficar como indicado a seguir.
program console;
program Console;
{$APPTYPE CONSOLE}
uses sysutils;
begin
end.
No caso de um programa desenvolvido com o Pascal padro, o incio do programa definido pela palavra-
chave program, seguida pelo nome do programa e pelas instrues delimitadas entre o primeiro begin e o
ltimo end (que acompanhado de um ponto, e no de um ponto-e-vrgula, pois encerra a unit).
Apenas para exemplificar o funcionamento de uma aplicao do tipo console, redefina o cdigo do
seu programa da maneira indicada a seguir.
program Console;
{$APPTYPE CONSOLE}
uses sysutils;
begin
Writeln(Exemplo de Aplicativo Tipo Console);
Readln;
end.
Execute esta aplicao, e ver a janela mostrada na figura a seguir.
Figura 19.2: Executando uma aplicao tipo console com o Delphi 7.
importante salientar, no entanto, que no caso do Delphi 7, este tipo de aplicao de 32 bits do
Windows (e no uma aplicao de 16 bits do DOS), e conseqentemente pode chamar qualquer funo
definida pela API do Windows 95/98/Me/2000/NT/XP.
Experimente, por exemplo, redefinir este programa da maneira mostrada a seguir.
program Console;
{$APPTYPE CONSOLE}
uses
Dialogs;
begin
ShowMessage(Exemplo de Aplicao Tipo Console);
end.
A funo ShowMessage tpica do ambiente Windows, mostrando que, embora seja do tipo Console,
no uma aplicao DOS (embora possua a cara e interface do DOS).
Execute esta aplicao, e ver a janela mostrada na figura a seguir.
Figura 19.3: Acessando uma funo da API do Windows em uma aplicao tipo console criada com o Delphi 7.
O objetivo deste tpico foi mostrar que o ambiente de desenvolvimento do Delphi 7 pode ser usado no
desenvolvimento de aplicaes do tipo console, utilizando-se o Pascal como linguagem de programao
procedural.
Desta maneira, se voc possui qualquer aplicao desenvolvida utilizando-se o Pascal tradicional, pode
recompil-la a partir do ambiente do Delphi 7, executando os procedimentos descritos neste tpico
(talvez tenha alguma dificuldade no caso de utilizao de algumas bibliotecas grficas). Dessa maneira
no necessrio manter instalados simultaneamente, em um mesmo equipamento, o Delphi 7 e uma
verso antiga do compilador Turbo Pascal.
Nos prximos tpicos, a comparao entre a programao estruturada e a programao orientada a
objetos ser feita, inicialmente, utilizando aplicaes tipo console, e nestas situaes este tpico poder
ser bastante til.
KNOW-HOW EM: FUNDAMENTOS DA
PROGRAMAO ORIENTADA A OBJETOS
PR-REQUISITOS
Conhecimento das tcnicas de programao estruturada.
Conhecimento da sintaxe bsica da linguagem Pascal.
Familiaridade com o ambiente de desenvolvimento integrado do Borland Delphi 7.
METODOLOGIA
Apresentao dos conceitos fundamentais da programao orientada a objetos.
Comparao dos procedimentos adotados na programao estruturada e na programao orientada a objetos.
TCNICA
Criao de classes e objetos com o Borland Delphi 7.
A FILOSOFIA DA PROGRAMAO ORIENTADA A OBJETOS
Nos anos 80, as tcnicas de programao estruturada se destacaram como uma nova estratgia para o
desenvolvimento de programas, adotando a tcnica de dividir para conquistar na qual um problema
era subdividido em problemas menores, denominados mdulos, procedimentos, funes ou sub-rotinas
(a terminologia variava principalmente em funo da linguagem de programao utilizada) cada
uma destinada a realizar uma determinada tarefa.
O problema era, logo, resolvido utilizando-se um mdulo principal, que recorria a estes mdulos
secundrios sempre que fosse necessrio executar uma determinada tarefa. Dessa maneira, o programa
principal tinha como funo o gerenciamento da soluo global tornando-o mais claro e necessitando
de uma menor codificao.
A partir das tcnicas de programao estruturada surgiram as bibliotecas de funes, que poderiam ser
compartilhadas entre vrios programas e no caso do Pascal bastava que se fornecesse o arquivo
compilado protegendo-se desta maneira o cdigo-fonte da biblioteca.
Esta filosofia de programao, no entanto, apresentava uma caracterstica que ainda dificultava a
abordagem do problema a ser resolvido de uma forma mais prxima do mundo real: o fato de que os
dados e as funes que operavam sobre estes dados eram tratados como entidades inteiramente distintas.
Consideremos, apenas para relembrar estes conceitos, o cdigo apresentado a seguir escrito em Pas-
cal Procedural e destinado a calcular o imposto de renda (pessoa fsica).
Este um exemplo bastante simples, mas nosso objetivo aqui no ensinar programao procedural,
mas comparar a sintaxe utilizada na sua implementao com a utilizada na soluo do mesmo problema
usando as tcnicas de programao orientada a objetos a serem apresentadas posteriormente.
As frmulas utilizadas para o clculo do imposto no correspondem s utilizadas atualmente pela Receita Federal, tendo sido includas
apenas a ttulo de exemplificao portanto no as incorpore diretamente no cdigo-fonte de seus programas.
program ImpostoDeRenda;
{$APPTYPE CONSOLE}
type
TContribuinte = record
rendimento, imposto : double;
end;
var
Contribuinte : TContribuinte;
procedure calcula_imposto(var um_contribuinte : TContribuinte);
begin
with um_contribuinte do
begin
if (rendimento < 900.0) then imposto := 0.0;
if (rendimento > 1800) then imposto := 0.275*rendimento-360.0;
if (rendimento >= 900)and(rendimento <= 1800) then imposto := 0.15*rendimento -135.0;
end;
end;
begin
write(Digite o valor do rendimento:);
readln(contribuinte. rendimento);
calcula_imposto(contribuinte);
writeln(imposto:,contribuinte.imposto);
readln;
end.
Observe que no Delphi 7, a janela para edio de cdigos (O Code Editor) apresenta sua esquerda
uma outra janela denominada Code Browser, como mostrado na figura a seguir, e que exibe os
procedimentos, tipos, objetos e variveis definidos na unit que est sendo editada (mesmo se tratando
de uma aplicao tipo console).
Figura 19.4: A janela do editor de cdigos, com a janela do Code Browser incorporada.
Esta janela pode ser desacoplada do editor de cdigos e visualizada de forma independente, bastando para isso selecionar a sua barra
de ttulos e arrastar a janela para outra regio do ambiente de desenvolvimento.
No prximo tpico ser apresentada uma anlise deste cdigo, escrito por meio do Pascal procedural.
ANLISE DO CDIGO-FONTE
Conforme descrito anteriormente, nesse programa (escrito em Pascal Procedural) os dados so entidades
totalmente distintas das funes.
Nesse caso particular, os dados so declarados no seguinte trecho de cdigo:
var
onde TContribuinte um tipo composto (registro) definido na seo type da unit que rene duas
variveis chamadas rendimento e imposto (denominadas campos). Os tipos compostos j existem h
muito tempo na linguagem pascal, e no so uma inovao do Delphi 7.
A nica sub-rotina deste programa a funo calcula_imposto, que recebe como parmetro uma varivel
do tipo TContribuinte (sub-rotina esta reproduzida a seguir).
procedure calcula_imposto(var um_contribuinte : TContribuinte);
begin
with um_contribuinte do
begin
if (rendimento > 1800) then imposto := 0.275*rendimento - 360.0;
end;
end;
Observe a utilizao do parmetro var, caracterizando que a varivel passada por referncia, e no
por valor. Desta maneira, garantimos que estamos trabalhando com a varivel original, e no com
uma cpia da mesma.
O programa principal muito simples, e dispensa maiores comentrios, pois realiza apenas a leitura
das informaes solicitadas, chama a funo calcula_imposto e exibe o resultado final na tela.
Dessa maneira pode-se constatar que, conforme j dissemos anteriormente, na programao proce-
dural os dados e as funes so entidades distintas.
evidente que, neste exemplo muito simples, a varivel Contribuinte possui escopo global, e por esta
razo poderamos alter-la diretamente na sub-rotina, no havendo a necessidade de utilizao do
parmetro especificado. Esta, no entanto, uma prtica de programao desaconselhvel, principalmente
se levarmos em conta a possibilidade de se incluir a procedure calcula_imposto em uma biblioteca de
funes codificada em uma unit independente.
O objetivo da programao orientada a objetos, por outro lado, consiste primordialmente em reunir os
dados, as funes e procedimentos que operam sobre estes dados em uma nica entidade ou tipo,
denominada classe. Uma classe, portanto, ser um novo tipo da linguagem na qual estaro reunidos
dados e funes (ou procedimentos).
A IMPLEMENTAO DE UMA CLASSE
Na linguagem Object Pascal, a definio de uma classe feita em um trecho de cdigo que obedece
seguinte sintaxe:
type
Nome_da_classe = Class
Nome_do_dado_1 : tipo_1;
..
Nome_do_dado_n : tipo_n;
Cabealho_da_funo_1;
..
Cabealho _da_funo_n;
end;
onde tipo pode ser qualquer tipo bsico definido pela linguagem, criado pelo programador ou, at
mesmo, outras classes previamente definidas.
Repare que agora estamos definindo um novo tipo, no qual internamente so declaradas variveis e
funes. Pode-se dizer, sem muito preciosismo, que a definio de uma classe estende a definio de
um registro, permitindo a incorporao de funes ao tipo que est sendo criado.
Por conveno, os nomes das classes definidas na linguagem Object Pascal comeam com a letra T,
e neste livro seguiremos esta conveno.
importante caracterizar que, na definio do tipo, as funes e os procedimentos so declarados mas
no implementados. A implementao das funes e dos procedimentos declarados internamente a
uma classe, e que no jargo da programao orientada a objetos so denominados mtodos, feita na
seo Implementation da unit em que a classe definida, devendo, no entanto, o nome do mtodo ser
precedido pelo nome da classe e obedecer seguinte sintaxe:
function Nome_da_Classe.Nome_do_Mtodo(parmetros)
begin
// Cdigo do mtodo
end;
ou
procedure Nome_da_Classe.Nome_do_Mtodo(parmetros)
begin
// Cdigo do mtodo
end;
evidente que um mtodo, assim como uma funo ou procedimento, tambm pode no ter parmetros.
No caso do exemplo anterior, poderamos, portanto, criar uma classe denominada TContribuinte,
como mostrado a seguir.
type
TContribuinte = Class
procedure calcula_imposto;
end;
A implementao do mtodo calcula_imposto, por sua vez, poderia ser feita da seguinte maneira:
procedure TContribuinte.calcula_imposto;
begin
if (rendimento > 1800) then imposto := 0.275*rendimento -360.0;
end;
Repare que, neste caso, no h a necessidade de se passar qualquer parmetro. Isso se deve ao fato de
que, por ser definido internamente a uma classe, um mtodo pode acessar diretamente todos os seus
campos. Conseqentemente, o mtodo calcula_imposto acessa diretamente o campo rendimento, e
este no precisa ser passado como parmetro.
O Delphi 7 possui um recurso que permite a gerao automtica do cdigo bsico de um mtodo na
seo Implementation da unit, bastando para isso que se pressione, simultaneamente as teclas Ctrl, Shift
e C. O mesmo se aplica definio de propriedades para uma classe, conforme ser visto posteriormente.
Esse recurso, denominado Complementao Automtica de Classes, acelera muito o trabalho de codificao
por parte do programador, reduzindo-se tambm a possibilidade de erros de digitao.
Antes de utilizarmos uma varivel, objeto ou instncia de uma classe, devemos alocar memria para o mesmo.
A alocao de memria para um objeto feita executando-se um mtodo especial da classe, denominado
mtodo construtor. Em geral (mas no obrigatoriamente) esse mtodo denominado Create, e pode
ou no possuir parmetros. Voc pode definir vrios mtodos construtores para uma classe, com nomes
e parmetros distintos, e decidir qual deve ser usado na alocao de memria para um objeto ou
instncia da classe.
Essa memria que foi alocada deve ser posteriormente liberada, antes de se finalizar a execuo do
programa, e isso feito executando-se um outro mtodo especial da classe, denominado mtodo
destrutor. Em geral, esse mtodo denominado Destroy, e pode ou no possuir parmetros.
O programa anterior poderia, portanto, ser recodificado da seguinte maneira (usando uma classe ao
invs de um registro):
program imposto_renda;
{$APPTYPE CONSOLE}
type
end;
var
procedure TContribuinte.calcula_imposto;
begin
if (> 1800) then imposto := 0.275*rendimento -360.0;
end;
begin
Contribuinte := TContribuinte.Create;
write(Digite o valor do rendimento:);
readln(contribuinte. rendimento);
contribuinte.calcula_imposto;
writeln(imposto:,contribuinte.imposto);
Contribuinte.Destroy;
readln;
end.
ANLISE DO CDIGO-FONTE
Nesse exemplo, a varivel Contribuinte , na realidade, um objeto ou instncia (terminologia largamente
empregada na programao orientada a objetos) da classe TContribuinte, mas no nenhum pecado
cham-la de varivel (embora os puristas da programao orientada a objetos possam querer me crucificar
por causa disso).
Repare que, no trecho principal do programa, alterou-se a linha de cdigo em que o procedimento
para clculo do imposto executado.
No programa escrito anteriormente, utilizando as tcnicas de programao estruturada, o procedimento
para clculo do imposto era uma entidade independente dos dados que deve manipular, e precisava
receber, como parmetro, uma varivel do tipo composto TContribuinte.
O programa escrito utilizando as tcnicas de programao orientada a objetos, por sua vez, define esse
procedimento como um mtodo da classe TContribuinte. Dessa maneira, a chamada desse procedimento
(que nesse caso no possui parmetros) feita a partir de um objeto dessa classe, como mostra a linha
de cdigo a seguir:
contribuinte.calcula_imposto;
Alm disso, foram includas duas outras linhas de cdigo, em que os mtodos construtor e destrutor da
classe so executados. Repare que o mtodo construtor executado a partir da classe propriamente
dita, enquanto o destrutor executado a partir do objeto ou instncia da classe.
Nesse ponto, uma dvida deve estar presente na mente do prezado leitor: como os mtodos construtor
e destrutor podem ser executados, se no foram sequer definidos para a classe? A resposta a essa pergunta
ser dada no prximo tpico, em que abordaremos uma das caractersticas mais importantes da
programao orientada a objetos o mecanismo de herana de classes.
KNOW-HOW EM: HERANA DE CLASSES
PR-REQUISITOS
Conhecimento da sintaxe bsica da linguagem Pascal.
Familiaridade com o ambiente de desenvolvimento integrado do Delphi 7.
METODOLOGIA
Apresentao do conceito de herana da programao orientada a objetos.
TCNICA
Implementao do mecanismo de herana de classes com o Delphi 7.
O CONCEITO DE HERANA DE CLASSES
Uma das principais vantagens da programao orientada a objetos, e muito divulgada na literatura
especializada sobre o assunto, reside na reutilizao de cdigo atravs do mecanismo de herana.
Esse mecanismo permite que se definam novas classes (chamadas classes derivadas) a partir de uma
classe fundamental (denominada classe-base).
Esse tipo de abordagem permite que a implementao da nossa soluo para um determinado problema
seja feita de uma maneira muito mais apropriada, e semelhante ao problema real.
Considere novamente o problema de elaborao de um programa para o clculo do imposto de renda.
No mundo real, existem dois tipos de contribuinte pessoa fsica e pessoa jurdica. Esses dois tipos, no
entanto, dispem de algumas caractersticas em comum: ambos tm imposto a pagar, e devem ter um
mtodo para o clculo desse imposto.
Podemos ento imaginar uma classe-base, denominada classe TContribuinte, a partir da qual sero
derivadas por herana duas outras classes, denominadas TPessoa_Fisica e TPessoa_Juridica.
Conseqentemente, podemos definir, para a classe-base TContribuinte, campos chamados rendimento
e imposto, do tipo double, e um mtodo chamado calcula_imposto.
O esqueleto dessa classe apresentado a seguir.
type
end;
A definio de uma classe derivada a partir de uma classe-base feita mediante a utilizao de um
cdigo com a seguinte sintaxe:
Nome_Classe_Derivada = Class(Nome_Classe_Base)
// Definio dos campos e mtodos da classe derivada
end;
Caso no seja especificado o nome de uma classe-base, ser usada como tal a classe TObject, que a classe-
base de todas as classes definidas na linguagem Object Pascal. Se voc analisar o diagrama de hierarquia de
objetos do Delphi 7, ver que a classe TObject exibida isoladamente no topo dessa hierarquia.
Dessa maneira, a classe TContribuinte poderia ser redefinida da seguinte maneira, em que o nome da
classe-base (TObject) exibido de maneira explcita.
type
TContribuinte = Class(TObject)
end;
Na unit System (definida pelo arquivo System.pas), a classe TObject definida da seguinte maneira:
TObject = class
constructor Create;
procedure Free;
class function InitInstance(Instance: Pointer): TObject;
procedure CleanupInstance;
function ClassType: TClass;
class function ClassName: ShortString;
class function ClassNameIs(const Name: string): Boolean;
class function ClassParent: TClass;
class function ClassInfo: Pointer;
class function InstanceSize: Longint;
class function InheritsFrom(AClass: TClass): Boolean;
class function MethodAddress(const Name: ShortString): Pointer;
class function MethodName(Address: Pointer): ShortString;
function FieldAddress(const Name: ShortString): Pointer;
function GetInterface(const IID: TGUID; out Obj): Boolean;
class function GetInterfaceEntry(const IID: TGUID): PInterfaceEntry;
class function GetInterfaceTable: PInterfaceTable;
function SafeCallException(ExceptObject: TObject;
ExceptAddr: Pointer): HResult; virtual;
procedure AfterConstruction; virtual;
procedure BeforeDestruction; virtual;
procedure Dispatch(var Message); virtual;
procedure DefaultHandler(var Message); virtual;
class function NewInstance: TObject; virtual;
procedure FreeInstance; virtual;
destructor Destroy; virtual;
end;
Observe que essa classe j define os mtodos Create e Destroy. Conseqentemente, as classes dela
derivadas por herana (como, por exemplo, a classe TContribuinte) herdaro esses mtodos da classe
TObject. Isso esclarece a questo colocada no tpico anterior, em que se utilizaram os mtodos Create
e Destroy sem que os mesmos houvessem sido explicitamente declarados na classe. Esses mtodos
foram definidos na classe-base (TObject), podendo ser utilizados nas classes dela derivadas por herana.
Repare ainda que alguns mtodos se iniciam com palavras reservadas especiais, como:
Constructor, no caso do mtodo construtor da classe.
Destructor, no caso do mtodo destrutor da classe.
Class, que ocorre em diversos mtodos.
O significado de cada uma dessas palavras reservadas ser descrito nos prximos tpicos. No
comentaremos o significado das palavras reservadas procedure e function, por considerarmos o seu
conhecimento obrigatrio a todos aqueles que j tm alguma experincia com a linguagem pascal
(incluindo-se neste grupo aqueles que j leram a primeira parte deste livro).
Dessa maneira, a definio das classes TContribuinte, TPessoa_Juridica e TPessoa_Fisica pode ser feita
da seguinte maneira:
TContribuinte = Class(TObject)
imposto : double;
rendimento: double;
end;
TPessoa_Juridica = Class(TContribuinte)
end;
TPessoa_Fisica = Class(TContribuinte)
end;
Essas classes, portanto, herdam os campos imposto e o mtodo calcula_imposto da classe-base
TContribuinte. Alm disso, herdam tambm os mtodos definidos na classe TObject.
No jargo da programao orientada a objetos diz-se que as classes TPessoa_Fisica e TPessoa_Juridica
so especializaes da classe TContribuinte.
Quando voc declarar uma instncia de uma classe, aquela armazenar, na realidade, o endereo de
um objeto dessa classe, podendo no entanto armazenar tambm o endereo de uma classe dela derivada
por herana. Caso nenhum endereo seja referenciado, o seu valor ser igual a nil (nulo).
Consideremos, por exemplo, a linha de cdigo a seguir, em que declaramos uma instncia da classe
TContribuinte:
Essa instncia a varivel contribuinte pode armazenar o endereo de um objeto da classe
TContribuinte ou de qualquer das classes dela derivadas por herana.
Dessa maneira, as linhas de cdigo a seguir so igualmente vlidas:
Contribuinte := TPessoa_Fisica.Create;
Contribuinte := TPessoa_Juridica.Create;
A recproca, no entanto, no verdadeira: voc no pode declarar um objeto de uma classe e referenciar
um objeto da sua classe-base.
MTODOS CONSTRUTORES
Um construtor um mtodo especial de uma classe, que tem por finalidade alocar a memria para um
objeto que est sendo criado (ou instanciado, no jargo da Programao Orientada a Objetos) e,
opcionalmente, atribuir valores iniciais aos campos do objeto.
Uma classe pode ter mais do que um mtodo construtor e, se voc no definir explicitamente um
construtor para essa classe, o construtor da sua classe-base ser utilizado.
A definio de um construtor utiliza a palavra-chave constructor em vez de procedure ou function. Alm
disso, um construtor pode ter parmetros e chamar o construtor da classe-base. Dessa maneira, a palavra-
chave constructor que indica ao compilador que deve alocar a memria necessria para o objeto.
Embora no especifique um tipo de retorno, um construtor retorna um novo objeto da classe. A chamada
ao mtodo construtor deve ser feita a partir da definio da classe, e no a partir de uma instncia ou
objeto da classe. Por essa razo, nos tpicos anteriores, a chamada do mtodo Create foi feita a partir
da classe TContribuinte, e no a partir do objeto Contribuinte.
Alguns autores costumam identificar uma classe como uma fbrica de objetos. Nesse caso, o mtodo
construtor seria uma mquina existente na fbrica, e que retorna um objeto da classe sempre que
posta em funcionamento.
Caso voc execute um construtor a partir de uma instncia da classe, nenhuma memria ser alocada
e no ser retornado um novo objeto da classe apenas o cdigo definido no corpo do construtor ser
executado (esta, no entanto, no uma prtica aconselhvel voc deve chamar o construtor a partir
da definio da classe e no a partir de uma instncia ou objeto).
MTODOS DESTRUTORES
Um destrutor um mtodo especial de uma classe, que tem por finalidade liberar a memria alocada
para um objeto ou instncia da classe.
Uma classe pode ter mais do que um mtodo destrutor e, se voc no definir explicitamente um
destrutor para essa classe, o destrutor da sua classe-base ser utilizado.
A definio de um mtodo destrutor usa a palavra-chave destructor em vez de procedure ou function.
Alm disso, um mtodo destrutor pode ter parmetros e chamar o mtodo destrutor da classe-base.
Se voc est criando uma nova classe derivada de uma classe-base e est sobrecarregando ou redefinindo o seu mtodo destrutor, a
ltima instruo a ser colocada no corpo do novo mtodo destrutor deve ser aquela que chama o destrutor da classe-base, principalmente
se o destrutor da classe-base executa algumas tarefas importantes relacionadas liberao de memria alocada para um objeto. No
caso de uma classe derivada de TObject, no entanto, isso no necessrio, pois seu mtodo destrutor no realiza nenhuma tarefa
importante, como mostra o trecho de cdigo a seguir (extrado da unit System.pas):
destructor TObject.Destroy;
begin
end;
Geralmente, mais seguro chamar o mtodo Free do que o mtodo Destroy de uma classe, uma vez
que Free verifica se o objeto realmente existe na memria e, em caso positivo, executa o mtodo
Destroy. Esse mtodo tambm declarado como uma procedure na classe TObject, e sua implementao
(definida na unit System.pas da VCL do Delphi 7) reproduzida a seguir.
procedure TObject.Free;
asm
TEST EAX,EAX
JE @@exit
MOV ECX,[EAX]
MOV DL,1
CALL dword ptr [ECX].vmtDestroy
@@exit:
end;
Esse cdigo, na realidade, est escrito em Assembler, e verifica se existe memria alocada para o objeto
antes de executar o seu destrutor.
Voc no deve se preocupar em compreender o significado desse cdigo, afinal de contas voc no est
lendo um texto sobre Assembler. O importante compreender que, mesmo que no exista memria
alocada para o objeto, a execuo desse mtodo no provocar um erro em run-time.
Para compreender a diferena existente entre a utilizao dos mtodos Free e Destroy, crie uma aplicao
bastante simples, composta por um nico formulrio, no qual so inseridos uma caixa de texto (chamada
Edit1) e um boto de comando. No procedimento associado ao evento OnClick do boto de comando
digite a seguinte linha de cdigo:
Edit1.Free;
Execute a aplicao e selecione o boto. A caixa de texto ser eliminada do formulrio, e se voc
selecionar novamente o boto de comando nada de anormal acontecer. Por outro lado, se voc substituir
a linha de cdigo anterior pela apresentada a seguir, o componente caixa de texto ser eliminado do
formulrio quando o boto de comando for selecionado pela primeira vez. Entretanto, caso voc
selecione novamente o boto de comando, a execuo da aplicao ser interrompida e uma mensagem
de erro ser exibida. Isso se deve ao fato de que o mtodo Destroy, ao contrrio do mtodo Free, no
verifica se realmente existe memria alocada para o objeto antes de tentar destru-lo.
Edit1.Destroy;
Mas ateno: o mtodo Free verifica se existe memria alocada para o objeto, isto , se o valor referenciado
pelo objeto diferente de nil antes de executar o mtodo Destroy para destruir o objeto. Contudo,
cabe a voc garantir que, aps destruir o objeto, esse apontar para um endereo nulo, isto , nil. Para
garantir que isso ocorra, no entanto, voc deve atribuir o valor nil instncia aps executar o seu
mtodo Free, no caso de estar implementando esses mtodos da classe.
VISIBILIDADE DOS CAMPOS E MTODOS DE UMA CLASSE
Define-se como visibilidade dos campos e mtodos de uma classe o conjunto de trechos de cdigo em
que os mesmos podem ser acessados.
Na linguagem Object Pascal, os mtodos e campos de uma classe podem ser classificados como pblicos
(public), privados (private) ou protegidos (protected). No caso de classes que representam componentes,
temos ainda o tipo published (no traduzirei esse termo), que ser abordado no captulo relativo
criao de componentes. As classes derivadas da classe TAutoObject (usadas em automao OLE) tambm
podero ter campos do tipo automated.
Por enquanto, vamos nos concentrar apenas nos trs primeiros tipos: public, private e protected.
CAMPOS E MTODOS PBLICOS (PUBLIC)
Os campos e mtodos pblicos de uma classe so aqueles que podem ser acessados em qualquer trecho
de um programa no qual um objeto ou instncia da classe definido.
No Delphi 7 os campos de uma classe so public por default, isto , caso no haja qualquer declarao
explcita em relao a um campo de uma classe, este ser considerado como um campo pblico.
Dessa maneira, as duas declaraes a seguir so equivalentes:
type
T Contribuinte = Class
imposto : double;
rendimento: double;
end;
type
public
imposto : double;
rendimento: double;
end;
CAMPOS E MTODOS PRIVADOS (PRIVATE)
Os campos e mtodos privados de uma classe so aqueles que s podem ser acessados por outros
mtodos da classe, isto , s so visveis dentro da classe, no podendo ser acessados nem mesmo nas
classes dela derivadas por herana. Na declarao da classe, os mtodos e campos privados devem ser
precedidos da palavra-chave private, como mostrado no trecho de cdigo a seguir.
type
public
imposto : double;
rendimento: double;
private
// Campos e mtodos privados devem ser definidos aqui.
end;
Existe, no entanto, uma exceo a essa regra: uma classe pode acessar os campos e mtodos privados de
outras classes que tenham sido definidas na mesma unit.
CAMPOS E MTODOS PROTEGIDOS (PROTECTED)
Os campos e mtodos protegidos de uma classe so aqueles que s podem ser acessados por outros
mtodos da classe ou de classes dela derivadas isto , s so visveis dentro da prpria classe ou das
classes que forem dela derivadas por herana. Na declarao da classe, os mtodos e campos protegidos
devem ser precedidos da palavra-chave protected, como mostrado no trecho de cdigo a seguir.
type
public
imposto : double;
rendimento: double;
private
protected
// Campos e mtodos protegidos devem ser definidos aqui.
end;
SOBREPOSIO DE MTODOS
Existem situaes em que, ao criarmos uma classe, desejamos sobrepor o mtodo existente na classe-
base. Quando desejamos simplesmente substituir o mtodo j existente na classe-base basta que se
defina, na classe derivada, um mtodo com o mesmo nome do mtodo a ser sobreposto.
Desse modo, a classe derivada passar a ignorar a existncia de um mtodo de mesmo nome na classe-base.
Nada impede, no entanto, que voc ainda acesse o mtodo de mesmo nome da classe-base, desde que
o nome do mtodo seja precedido pela palavra reservada inherited.
Para compreender esse mecanismo, codifique uma aplicao tipo console da maneira indicada a seguir.
program Exemplo;
{$APPTYPE CONSOLE}
uses
Dialogs;
type
TClasseBaseTeste = class
procedure ExibeMensagem;
end;
TClasseDerivadaTeste = class(TClasseBaseTeste)
end;
procedure TClasseBaseTeste.ExibeMensagem;
begin
ShowMessage(Classe Base);
end;
procedure TClasseDerivadaTeste.ExibeMensagem;
begin
ShowMessage(Classe Derivada);
inherited ExibeMensagem;
end;
var
Teste : TClasseDerivadaTeste;
{$R *.RES}
begin
Teste := TClasseDerivadaTeste.Create;
writeln(Digite Qualquer tecla);
Readln;
Teste.ExibeMensagem;
Teste.Free;
end.
Execute essa aplicao e verifique que, embora o mtodo ExibeMensagem da classe-base tenha sido
sobreposto na classe derivada, pode ainda ser chamado em um mtodo da classe derivada usando a
palavra reservada inherited. Experimente trocar a ordem das linhas de cdigo do mtodo ExibeMensagem
da classe derivada, e verifique que a ordem de exibio de mensagens alterada.
MTODOS ESTTICOS, VIRTUAIS E DINMICOS
Os mtodos considerados at o momento so denominados estticos, que so aqueles cujo endereo
determinado pelo compilador durante a compilao do programa e gerao do arquivo executvel.
Existem situaes, no entanto, em que no sabemos de antemo que tipo de objeto ser apontado por
uma determinada varivel (lembre-se de que uma varivel de uma determinada classe pode armazenar
um objeto dessa classe ou de qualquer classe dela derivada por herana).
Nesse caso, para que o programa possa definir durante a sua execuo que mtodo deve ser chamado,
devemos declarar o mtodo como virtual.
Consideremos novamente uma aplicao console bastante simples, com o cdigo apresentado a seguir.
program Exemplo;
{$APPTYPE CONSOLE}
uses
Dialogs;
type
end;
end;
begin
end;
begin
end;
var
Teste : TClasseBaseTeste;
{$R *.RES}
begin
Readln;
Teste.Free;
end.
Nesse caso, embora a varivel Teste seja declarada como um objeto da classe TClasseBaseTeste, no programa
principal referencia um objeto da classe TClasseDerivadaTeste o que perfeitamente legal, pois, conforme
discutido anteriormente, uma instncia ou objeto de uma determinada classe pode referenciar um objeto
dessa classe ou de qualquer classe dela derivada por herana (embora a recproca no seja correta).
Entretanto, ao executar esse cdigo verifica-se que o mtodo executado o definido na classe-base, e no
o definido na classe derivada. Isto se deve utilizao de mtodos estticos, cujo endereo determinado
na fase de compilao e nessa fase a varivel Teste declarada como um objeto da classe TClasseBaseTeste
(embora durante a execuo da aplicao ela venha a referenciar um objeto da classe TClasseDerivadaTeste).
Conseqentemente, o programa executar sempre o mtodo da classe-base, pois durante a compilao
definiu-se Teste como um objeto da classe TBaseTeste.
A soluo para esse problema est justamente na utilizao de mtodos virtuais cujo endereo
definido durante a execuo do aplicativo (e no durante a sua compilao).
Para declarar um mtodo como virtual, deve-se acrescentar a palavra-chave virtual, seguida de um
ponto-e-vrgula, ao final da declarao do mtodo na classe-base. Nas classes derivadas em que esse
mtodo for sobrecarregado, deve-se acrescentar a palavra-chave override (em vez de virtual), seguida
de um ponto-e-vrgula, ao final da declarao do mtodo.
Dessa maneira, o programa anterior poderia ser recodificado da seguinte maneira:
program Exemplo;
uses
Dialogs;
type
procedure ExibeMensagem;virtual;
end;
procedure ExibeMensagem;override;
end;
begin
end;
begin
end;
var
begin
Readln;
Teste.Free;
end.
Se voc executar essa aplicao, ver que o mtodo correto chamado. Nesse caso, no entanto, nada
impede que o mtodo da classe-base continue a ser acessado pelo mtodo de mesmo nome da classe
derivada usando-se a palavra reservada inherited mas, nesse caso, o mtodo correto ser chamado!
Diferentemente do que ocorreu no exemplo anterior, ao encontrar a palavra-chave virtual na definio
do mtodo ExibeMensagem, o compilador ficou ciente de que o endereo do mtodo a ser executado
ser determinado durante a execuo do aplicativo, e no durante a sua compilao e isso vai depender
do tipo de classe realmente referenciado pelo objeto.
MAS E OS MTODOS DINMICOS? O QUE SIGNIFICAM?
A finalidade dos mtodos dinmicos a mesma dos mtodos virtuais, isto , so funcionalmente
equivalentes. A nica diferena diz respeito otimizao feita pelo compilador. Ao utilizar mtodos
virtuais, melhora-se o desempenho em detrimento do tamanho do cdigo gerado. Por outro lado, a
utilizao de mtodos dinmicos reduz o tamanho do cdigo em detrimento do desempenho.
Para utilizar o recurso de mtodos dinmicos, basta recodificar o programa-exemplo como mostrado a seguir.
program Exemplo;
{$APPTYPE CONSOLE}
uses
Dialogs;
type
procedure ExibeMensagem;dynamic;
end;
procedure ExibeMensagem;override;
end;
begin
end;
begin
end;
var
{$R *.RES}
begin
Readln;
Teste.Free;
end.
MTODOS ABSTRATOS
Os mtodos abstratos formam um tipo especial de mtodo, que so declarados em uma classe-base,
mas s so implementados nas classes dela derivadas por herana.
Esse tipo de mtodo til quando se quer definir um mtodo que dever ser implementado em todas
as classes derivadas de uma classe-base.
Um mtodo declarado como abstrato ao se acrescentar a palavra-chave abstract ao final da sua
declarao. Entretanto, um mtodo s pode ser declarado como abstrato se previamente declarado
como virtual ou dinmico. O trecho de cdigo a seguir mostra a declarao de um mtodo abstrato.
type
Figura = class
procedure Desenha; virtual; abstract;
...
end;
Voc pode sobrecarregar um mtodo abstrato da mesma forma que sobrecarrega um mtodo virtual ou
dinmico. A nica restrio que, nesse caso, no se pode usar a palavra reservada inherited para
chamar o mtodo de mesmo nome da classe-base (j que nesta ele no foi implementado).
MTODOS DE CLASSE
Conforme pode ser verificado na definio da classe TObject, a declarao de alguns de seus mtodos
comea com a palavra reservada class. Quando a declarao de um mtodo inicia com essa palavra
reservada, isso significa que esse mtodo intrnseco definio da classe e no pode, no entanto,
acessar os campos e mtodos da classe.
Esses mtodos sero descritos no prximo tpico, que discute em mais detalhes a classe TObject.
PROPRIEDADES
Nos tpicos anteriores foram apresentados os conceitos de campos e mtodos de uma classe. Conforme
j descrito anteriormente, os campos armazenam valores que definem as caractersticas de um objeto
e os mtodos implementam a sua funcionalidade.
Existem situaes, no entanto, em que no se quer permitir o acesso direto aos campos de uma classe,
ainda que esses sejam definidos como pblicos. Nesse caso, uma opo natural seria a utilizao de
mtodos destinados a ler e atribuir valores aos campos da classe.
Consideremos, por exemplo, a seguinte definio para a classe TContribuinte.
type
public
rendimento:double;
imposto : double;
private
protected
end;
Nesta definio, imposto um campo pblico, e conseqentemente pode ter o seu valor diretamente
alterado, o que no caracteriza uma boa prtica de programao, pois o valor do imposto deve sempre
ser calculado, e no ter um valor atribudo de forma direta (os puristas da orientao a objetos dizem
que este campo deve ser encapsulado).
Uma soluo natural, portanto, seria implementar o mtodo calcula_imposto como uma funo em
vez de um procedimento, redefinindo a classe da maneira indicada a seguir.
public
rendimento:double;
function calcula_imposto:double;
private
imposto : double;
protected
end;
Nesse caso, o campo imposto passa a ser privado, e no pblico.
A sua implementao correspondente seria:
function TContribuinte.calcula_imposto:double;
begin
if (rendimento > 1800) then imposto := 0.275*rendimento -360.0;
result := imposto;
end;
Dessa maneira, se Contribuinte um objeto da classe TContribuinte, a obteno do valor do imposto
pode ser feita utilizando-se a seguinte linha de cdigo, onde valor_do_imposto uma varivel global
do tipo double:
valor_do_imposto := Contribuinte.calcula_imposto;
O Delphi 7, no entanto, permite uma soluo alternativa, que consiste em empregar o conceito de
propriedades.
Uma propriedade consiste em um meio de comunicao entre um campo interno e privado da classe
e o cdigo que utiliza um objeto dessa classe.
Para o programador que utiliza a classe, uma propriedade funcionalmente equivalente a um campo,
mas para quem definiu a classe um campo e uma propriedade so entidades distintas.
Por conveno, os campos internos das classes definidas pela VCL e pela CLX (as bibliotecas de classes
do Delphi 7) so privados e seus nomes comeam com a letra F (de Field). As propriedades, por sua vez,
tm o mesmo nome de um campo da classe, omitindo-se a letra F inicial.
O componente Label, por exemplo, um objeto da classe TLabel, que tem uma propriedade chamada
Left. Embora voc, usurio da classe, acesse essa propriedade da mesma maneira que acessa um campo
pblico qualquer, est na realidade acessando um meio de comunicao com um outro campo interno
e privado da classe, chamado FLeft.
No caso da classe TContribuinte, por exemplo, poderamos ter um campo privado chamado Fimposto
e uma propriedade chamada imposto.
A definio de uma propriedade, no entanto, feita mediante a incluso de uma linha de cdigo que
apresenta a seguinte sintaxe:
property nome_propriedade : tipo read metodo_ leitura write metodo_ escrita;
Como pode ser visto na definio anterior, uma propriedade deve ter um tipo e pode ter um mtodo de
leitura e um mtodo de escrita. Quando se omite o nome do mtodo de escrita, a propriedade do tipo
read-only (apenas de leitura) e quando se omite o mtodo de leitura a propriedade do tipo write-only
(apenas de escrita). Existem situaes, no entanto, que, em vez de se definir um mtodo de leitura e
um mtodo de escrita, coloca-se em seu lugar o nome do campo em que o valor da propriedade ser
armazenado. Nesses casos, diz-se que a propriedade acessa diretamente o valor de um campo, sem que
se use qualquer mtodo especfico. Conforme ser visto posteriormente, os mtodos de acesso so
teis para validar o valor atribudo a uma propriedade.
A propriedade imposto poderia, portanto, ser definida da seguinte maneira:
property imposto : double read calcula_imposto;
Nesse caso, imposto definida como uma propriedade apenas de leitura (repare que foi omitida a
clusula write).
A classe TContribuinte seria, portanto, redefinida da seguinte maneira:
public
rendimento:double;
private
Fimposto : double;
protected
end;
begin
if (rendimento < 900.0) then Fimposto := 0.0;
if (rendimento > 1800) then Fimposto := 0.275*rendimento -360.0;
if (rendimento >= 900)and(rendimento <= 1800) then Fimposto := 0.15*rendimento -135.0;
result := Fimposto;
end;
No prximo tpico apresentaremos a classe TObject, que a me de todas as classes definidas na
REFERNCIA: A CLASSE TOBJECT
Conforme descrito nos tpicos anteriores, a classe TObject a classe-base de todas as classes
implementadas no Delphi 7, isto , toda classe derivada por herana, ainda que indiretamente, da
classe TObject.
importante, portanto, que voc como desenvolvedor conhea detalhadamente as caractersticas dessa
classe, conforme ser mostrado nos prximos tpicos.
PRINCIPAIS MTODOS DA CLASSE TOBJECT
Apresentamos a seguir uma descrio dos principais mtodos definidos na classe TObject. Como a
maioria desses mtodos est implementada em Assembler, no discutiremos sua implementao
apenas descrevemos a finalidade de cada um deles.
AfterConstruction
Declarao
procedure AfterDestruction; virtual;
Esse mtodo um mtodo virtual, executado automaticamente aps a finalizao do ltimo mtodo
construtor da classe.
BeforeDestruction
Declarao
procedure BeforeDestruction; virtual;
Esse mtodo um mtodo virtual, executado automaticamente antes da inicializao do primeiro
mtodo destrutor da classe.
Create
Declarao
constructor Create;
Esse mtodo o mtodo construtor da classe, conforme indicado pela palavra reservada constructor, e
tem por finalidade alocar a memria necessria a um objeto ou instncia da classe. Como qualquer
construtor, executado como se fosse um mtodo da classe (embora, por ser um mtodo construtor,
no seja precedido pela palavra reservada class).
ClassInfo
Declarao
Como pode ser verificado a partir da sua declarao, este um mtodo de classe e, por ser uma funo,
deve retornar um valor, que nesse caso ser um Pointer (ponteiro para um endereo de memria sem
uma qualificao de tipo).
A Unit TypInfo define, no entanto, alguns tipos compostos que simplificam a utilizao da informao
retornada por esse mtodo.
Dentre esses tipos compostos destaca-se:
TTypeInfo = record
Kind: TTypeKind;
Name: ShortString;
{TypeData: TTypeData}
end;
PtypeInfo: ^TtypeInfo.
O tipo TTypeInfo possui os campos Kind e Name, que retornam respectivamente um valor que indica
o tipo de dado armazenado em um endereo e o nome do tipo ou Classe do valor armazenado nesse
endereo, respectivamente.
O tipo PtypeInfo representa um ponteiro para um valor do tipo TtypeInfo.
O tipo TTypeKind (definido como um tipo enumerado em Pascal) tambm declarado na unit
TypeInfo, sendo sua definio reproduzida a seguir.
TTypeKind = (tkUnknown, tkInteger, tkChar, tkEnumeration, tkFloat,
tkString, tkSet, tkClass, tkMethod, tkWChar, tkLString, tkWString,
tkVariant, tkArray, tkRecord, tkInterface);
Logo, para obter informaes sobre uma classe atravs do mtodo ClassInfo, voc precisa:
Declarar uma varivel do tipo PtypeInfo (que ser um ponteiro).
Armazenar nessa varivel o valor retornado pelo mtodo ClassInfo.
Utilizar as informaes armazenadas nos campos dessa varivel.
ClassName
Declarao
class function ClassName: ShortString;
Como pode ser verificado a partir da sua declarao, esse um mtodo de classe e, por ser uma funo,
deve retornar um valor, que nesse caso ser uma string que armazenar o nome da classe.
ClassNameIs
Declarao
deve retornar um valor que nesse caso ser true ou false dependendo do texto definido na string
passada como parmetro.
Se o texto passado como parmetro for igual ao nome da classe, esse mtodo retornar true. Caso
contrrio, retornar o valor False.
ClassParent
Declarao
deve retornar um valor que nesse caso ser uma referncia sua classe-base.
Observe que o valor retornado por esse mtodo do tipo TClass, declarado da seguinte maneira na
unit System.pas:
TClass = class of TObject;
Isso significa que TClass , na realidade, uma varivel que pode armazenar o nome de um tipo de
classe, que pode ser a classe TObject, ou qualquer classe dela derivada por herana.
Embora esse mtodo no seja til para a classe TObject (que no possui classe-base) pode ser empregada
nas demais classes dela derivadas por herana. No caso de TObject, esse mtodo retorna nil.
ClassType
Declarao
Como pode ser verificado pela sua declarao, esse mtodo retorna a classe do objeto, e usado
internamente pelo Delphi 7 no emprego dos operadores Is e As, a serem descritos posteriormente.
CleanupInstance
Declarao
Esse mtodo automaticamente executado a partir do mtodo Free, e no deve ser chamado diretamente
pelo cdigo da sua aplicao. Esse mtodo atribui uma string vazia a campos do tipo string e o valor
Unassigned a campos do tipo Variant da classe.
Dispatch
Declarao
procedure Dispatch(var Message);
Esse mtodo responsvel por disparar a execuo de outros mtodos da classe que sejam capazes de
manipular mensagens do Windows, baseado no valor passado pelo parmetro Message.
Caso nenhum dos mtodos definidos pela classe (ou pelas suas classes ancestrais) seja capaz de manipu-
lar a mensagem indicada pelo parmetro Message, o mtodo DefaultHandler da classe ser executado.
Isso permite que se d um tratamento s mensagens que no so manipuladas diretamente pelos
objetos da classe (o conceito de mensagens ser apresentado posteriormente).
DefaultHandler
Declarao
procedure DefaultHandler(var Message); virtual;
Como pode ser verificado, esse um mtodo virtual, e que pode ser sobrecarregado nas classes derivadas
por herana.
Conforme descrito no tpico anterior, esse mtodo automaticamente chamado pelo mtodo Dis-
patch, sempre que a mensagem no for diretamente manipulada por um dos mtodos da classe.
Destroy
Declarao
destructor Destroy; virtual;
Esse mtodo o mtodo destrutor da classe, conforme indicado pela palavra reservada destructor, e tem
por finalidade liberar a memria reservada para um objeto (memria esta alocada pelo seu construtor).
Como pode ser verificado, esse um mtodo virtual e que pode ser sobrecarregado nas classes derivadas.
Conforme descrito anteriormente, geralmente mais seguro executar o mtodo Free, que verifica se o
valor armazenado na instncia da classe igual a nil, e s executa o mtodo Destroy se existir memria
alocada para o objeto.
FieldAddress
Declarao
Esse mtodo retorna, na forma de um Pointer (ponteiro para um endereo de memria sem uma
qualificao de tipo), o endereo de um campo do objeto da classe, cujo nome passado como parmetro
na forma de uma string. Caso no exista o campo cujo nome passado como parmetro, o mtodo
retornar nil.
Free
Declarao
procedure Free;
Esse mtodo, conforme j descrito anteriormente, verifica se existe memria alocada para uma instncia
de uma classe, antes de chamar o mtodo destrutor da classe.
Lembre-se de que cabe a voc incluir, na implementao do cdigo da sua aplicao, uma linha de
cdigo que atribua o valor nil instncia da classe aps a execuo do mtodo Free (isso no necessrio
para objetos da VCL e da CLX).
FreeInstance
Declarao
Esse mtodo libera a memria alocada previamente para uma instncia de uma classe atravs de uma
chamada ao seu mtodo NewInstance (a ser descrito a seguir).
Esse mtodo no precisa ser manipulado diretamente pelo cdigo da sua aplicao. Entretanto, caso
voc tenha sobrecarregado o mtodo NewInstance da classe, deve tambm sobrecarregar esse mtodo,
codificando as alteraes necessrias manuteno da compatibilidade entre esses mtodos.
NewInstance
Declarao
Esse mtodo um mtodo de classe, e responsvel por alocar a memria necessria a uma nova
instncia da classe, retornando o endereo de memria a partir do qual estar armazenada esta instncia
recm-criada.
Para obter a quantidade de memria a ser alocada para a nova instncia, esse mtodo chama o mtodo
InstanceSize da classe, e para criar a nova instncia executa o mtodo InitInstance.
Esse mtodo chamado automaticamente pelo construtor da classe, e o cdigo da sua aplicao no
deve incluir uma chamada explcita a esse mtodo.
InitInstance
Declarao
class procedure InitInstance(Instance: Pointer): TObject;
Esse mtodo um mtodo de classe, e responsvel por criar a instncia da classe propriamente dita (a
ser retornada pelo construtor).
Voc no precisa incluir uma chamada explcita a esse mtodo no cdigo da sua aplicao, pois isso
feito pelo mtodo NewInstance. Entretanto, caso voc sobrecarregue o mtodo NewInstance, deve
incluir, como ltimo comando a ser executado por esse mtodo, uma chamada ao mtodo InitInstance.
InstanceSize
Declarao
Esse um mtodo de classe, e determina a quantidade de bytes de memria necessrios para armazenar
uma instncia da classe.
Geralmente esse mtodo usado internamente pelos mtodos responsveis pela alocao de memria
para um objeto, e posterior liberao dessa memria, quando o objeto for destrudo.
Se voc possuir um formulrio com um componente chamado Edit1, da classe TEdit e um boto de
comando chamado Button1 (da classe TButton) pode descobrir o nmero de bytes ocupados para cada
um desses componentes incluindo as seguintes linhas de cdigo no procedimento associado ao evento
OnClick desse boto de comando:
ShowMessage(IntToStr(Edit1.InstanceSize));
ShowMessage(IntToStr(Button1.InstanceSize));
Ao executar este procedimento, voc descobrir que Edit1 e Button1 ocupam 496 e 484 bytes,
respectivamente.
MethodAddress
Declarao
Esse um mtodo de classe, e retorna, na forma de um Pointer (ponteiro para um endereo de memria
sem uma qualificao de tipo), o endereo de um mtodo cujo nome passado como parmetro na
forma de uma string. Caso no exista o mtodo cujo nome passado como parmetro, o mtodo
retornar nil.
Geralmente esse mtodo usado internamente pelo Delphi 7, e normalmente no dever ser includa
uma chamada explcita a esse mtodo no cdigo da sua aplicao.
MethodName
Declarao
Esse um mtodo de classe, e retorna, na forma de uma string, o nome do mtodo cujo endereo
passado como parmetro, na forma de um Pointer (ponteiro para um endereo de memria sem uma
qualificao de tipo). Repare que esse mtodo executa a tarefa inversa do mtodo MethodAddress. Caso
no exista o mtodo cujo endereo passado como parmetro, o mtodo retornar uma string vazia.
Geralmente esse mtodo usado internamente pelo Delphi 7, e normalmente no dever ser includa
uma chamada explcita a esse mtodo no cdigo da sua aplicao.
InheritsFrom
Declarao
class function InheritsFrom(AClass: TClass): boolean;
Este um mtodo de classe, e determina se a classe cujo tipo passado como parmetro ou no um
ancestral da classe a partir da qual o mtodo executado
Evidentemente, se voc passar TObject como parmetro, esse mtodo retornar sempre o valor true,
pois todas as classes so derivadas, ainda que indiretamente, da classe TObject.
KNOW-HOW EM: CONVERSO DE TIPOS
PR-REQUISITOS
Conhecimento da sintaxe bsica da linguagem Pascal e dos fundamentos da programao orientada a objetos em Delphi 7 .
Familiaridade com os ambientes de desenvolvimento integrado do Delphi 7.
METODOLOGIA
Apresentao do conceito de converso de tipos.
TCNICA
Implementao do mecanismo de converso de tipos, usando os operadores Is, As e a converso explcita entre classes.
O CONCEITO DE CONVERSO DE TIPOS
A converso de tipos permite que se trate um objeto de uma classe como uma instncia de uma das
suas classes-base.
Essa tcnica muito til nas seguintes situaes:
Quando se quer realizar uma mesma operao sobre objetos de classes distintas, mas que possuem uma caracterstica semelhante, presente
em uma classe-base comum.
Quando se quer compartilhar um procedimento (que pode estar ou no associado a um evento) entre vrios objetos.
Nesse caso, a soluo consiste em tratar os vrios objetos como se fossem uma instncia da classe-base
da qual todas so derivadas (direta ou indiretamente).
Para verificar se um objeto uma instncia de uma classe derivada de uma classe-base, deve-se utilizar
o operador Is.
Para tratar um objeto como uma instncia de uma das suas classes-base, deve-se utilizar o operador As.
Os operadores Is e As, bem como a converso explcita entre classes, sero apresentados nos prximos
tpicos.
O OPERADOR IS
Existem situaes em que, durante a execuo de um programa, voc precisa verificar se um objeto
uma instncia de uma determinada classe, ou de uma das classes dela derivadas por herana.
Nesse caso, voc pode utilizar o operador Is, usando a seguinte sintaxe:
<nome_objeto> Is <nome_classe>
Considere, a ttulo de exemplificao, o seguinte trecho de cdigo:
if (nome_objeto Is nome_classe)
then
// Cdigo executado se a expresso verdadeira
else
// Cdigo executado se a expresso falsa
Nesse caso, se o objeto cujo nome nome_objeto for uma instncia da classe nome_classe ou de
uma das classes dela derivadas por herana, a expresso ser verdadeira, e retornar o valor true.
evidente, portanto, que se nome_classe for igual a TObject, essa expresso retornar sempre o
valor true, independente do objeto analisado.
O OPERADOR AS
O operador As permite que um objeto de uma determinada classe seja tratado como uma instncia de
uma das suas classes-base.
A utilizao do operador As segue esta sintaxe:
<nome_objeto> As <nome_classe>
Em geral, o operador As utilizado para acessar um mtodo ou propriedade da classe-base.
Nesse caso, deve-se colocar a expresso anterior entre parnteses, como indicado a seguir:
(nome_objeto As nome_classe).nome_mtodo
(nome_objeto As nome_classe).nome_propriedade
Considere, por exemplo, que voc queira limpar o texto exibido em todos os controles do tipo TEdit e
TDBEdit existentes em um formulrio, quando o usurio selecionar um boto de comando. Essa situao
comum, por exemplo, em formulrios de cadastro de clientes, de produtos, fornecedores ou qualquer
outra entidade.
Para obter esse resultado, basta definir da seguinte maneira o procedimento associado ao evento OnClick
desse boto de comando:
procedure TForm1.Button1Click(Sender: TObject);
var
i:integer;
begin
for i:= 0 to Componentcount-1 do
if Components[i] is TCustomEdit then (Components[i] as TCustomEdit).Text := ;
end;
Nesse cdigo, executa-se um looping pelos componentes inseridos no formulrio (definidos pela sua
propriedade Components). Para cada um dos componentes, verifica-se se o mesmo um objeto de
uma classe derivada da classe TCustomEdit, usando-se para isso o operador Is. Caso o componente seja
um objeto de uma classe derivada da classe TCustomEdit, utiliza-se o operador As para efetuar uma
converso de tipo e atribuir uma string nula sua propriedade Text.
CONVERSO EXPLCITA ENTRE TIPOS
Como alternativa ao operador As pode-se empregar a converso explcita entre tipos, atravs da qual
um objeto tratado como uma instncia de uma das suas classes-base.
A converso explcita de tipos segue a seguinte sintaxe:
(Classe-Base)nome_objeto
Em geral, a converso explcita entre tipos utilizada para acessar um mtodo ou propriedade da
classe-base.
Nesse caso, deve-se colocar a expresso anterior entre parnteses, como indicado a seguir:
((Classe-Base)nome_objeto).nome_mtodo
((Classe-Base)nome_objeto).nome_propriedade
O cdigo apresentado no tpico anterior poderia, portanto, ser reescrito da seguinte maneira:
var
i:integer;
begin
for i:= 0 to Componentcount-1 do
if Components[i] is TCustomEdit then (TCustomEdit(Components[i])).Text := ;
end;
O IDENTIFICADOR SELF
O identificador Self pode ser utilizado para referenciar a instncia corrente de uma classe em um dos
seus mtodos ( semelhante ao identificador this do C++).
Por incrvel que parea, isso praticamente tudo o que voc precisa saber sobre esse identificador.
Diversos exemplos de utilizao desse identificador sero apresentados ao longo do livro, o que tornar
ainda mais fcil a compreenso do seu significado.
KNOW-HOW EM: TRATAMENTO DE EXCEES
PR-REQUISITOS
Conhecimento da sintaxe bsica da linguagem Pascal e dos fundamentos da programao orientada a objetos em Delphi 7.
METODOLOGIA
Apresentao do conceito de Exceo e da classe Exception.
TCNICA
Discusso das propriedades e mtodos da classe Exception e das principais classes dela derivadas por herana.
Implementao de novas excees.
O CONCEITO DE EXCEES
Excees so erros que ocorrem durante a execuo do seu programa, mas que podem ser tratadas em
um bloco de cdigo do tipo tryexceptend. Dessa maneira, seu cdigo pode tratar os erros ocorridos
durante a execuo do programa, evitando que a execuo da aplicao seja encerrada de forma brusca.
Para proteger um determinado trecho de cdigo implementado na sua aplicao, deve-se utilizar um
bloco tryexceptend, que apresenta a seguinte sintaxe:
try
// Bloco de cdigo a ser executado
except
// Bloco de cdigo a ser executado caso haja algum erro na execuo do bloco de
// cdigo anterior
end;
Considere, por exemplo, um formulrio no qual existam duas caixas de texto, denominadas EditNum1
e EditNum2, nas quais devem ser digitados dois nmeros reais.
Alm disso, considere que esse formulrio possui um boto de comando no qual foi digitado o seguinte
cdigo no procedimento associado ao seu evento OnClick:
ShowMessage(FloatToStr(StrToFloat(EditNum1.Text)/StrToFloat(EditNum2.Text)));
Esse cdigo exibe em uma mensagem o resultado da diviso dos valores digitados nas duas caixas de texto.
Caso voc execute essa aplicao, digite o valor 4 na primeira caixa de texto e 0 na segunda; ao selecionar
o boto de comando ser gerada uma mensagem de erro com o texto:
Floating point division by zero.
Experimente, no entanto, redefinir o trecho de cdigo do procedimento associado ao evento OnClick
do boto de comando da seguinte maneira:
try
except
ShowMessage(Voc digitou valores incorretos);
EditNum1.Text := ;
EditNum2.Text := ;
end;
Nesse caso, se ocorrer algum problema durante a execuo do programa, seja na converso das strings
em valores numricos ou na diviso dos nmeros, uma mensagem mais amigvel ser exibida. Alm
disso, o contedo das caixas de texto ser apagado.
Voc pode, no entanto, definir um tratamento para cada tipo de erro. Para isso, basta redefinir da
seguinte maneira o cdigo do procedimento associado ao evento OnClick do boto de comando:
try
except
On EZeroDivide do
begin
ShowMessage(Voc digitou valores incorretos);
EditNum1.Text := ;
EditNum2.Text := ;
end;
On EconvertError do
begin
ShowMessage(Erro de Converso);
EditNum1.Text := ;
EditNum2.Text := ;
end;
end;
Nesse caso, verifica-se o tipo de erro usando-se a clusula:
on <tipo de exceo> do
Com essa clusula, voc pode definir uma resposta para cada um dos diversos tipos de erros que
possam ser gerados durante a execuo do seu aplicativo.
REFERNCIA: A CLASSE EXCEPTION
A classe Exception, codificada na unit SysUtils e reproduzida a seguir, derivada por herana da classe
TObject e a classe-base para todas as classes que manipulam excees no Delphi 7.
Repare que essa classe no segue a conveno padro do Delphi 7, pela qual o nome de uma classe
deve comear com um T.
DEFINIO DA CLASSE EXCEPTION
Reproduzimos a seguir o trecho de cdigo responsvel pela definio da classe Exception.
Exception = class(TObject)
private
FMessage: string;
FHelpContext: Integer;
public
constructor Create(const Msg: string);
constructor CreateFmt(const Msg: string; const Args: array of const);
constructor CreateRes(Ident: Integer; Dummy: Extended = 0);
constructor CreateResFmt(Ident: Integer; const Args: array of const);
constructor CreateHelp(const Msg: string; AHelpContext: Integer);
constructor CreateFmtHelp(const Msg: string; const Args: array of const;
AHelpContext: Integer);
constructor CreateResHelp(Ident: Integer; AHelpContext: Integer);
constructor CreateResFmtHelp(Ident: Integer; const Args: array of const;
property HelpContext: Integer read FHelpContext write FHelpContext;
property Message: string read FMessage write FMessage;
end;
CAMPOS INTERNOS DA CLASSE EXCEPTION
Conforme pode ser verificado na sua definio, a classe Exception possui os seguintes campos internos,
cuja visibilidade definida como private:
FMessage: string;
FHelpContext: Integer;
FMessage
Esse campo, do tipo string, define o texto a ser exibido na caixa de dilogo que mostrada quando
ocorre um erro definido por essa exceo.
FHelpContext
Esse campo, do tipo inteiro, armazena o valor que identifica o tpico do arquivo de help on-line
associado a essa classe.
MTODOS PBLICOS DA CLASSE EXCEPTION
Create
Declarao
constructor Create (const Msg: string);
Esse um dos mtodos construtores da classe (responsvel pela alocao da memria necessria aos
objetos da classe), e recebe como parmetro uma string que ser mostrada na caixa de dilogo exibida
quando a exceo ocorrer durante a execuo do programa.
Como j foi descrito anteriormente, uma classe pode definir mais de um mtodo construtor, o que
ocorre justamente na definio da classe Exception.
Como pode ser verificado na codificao do mtodo (reproduzida a seguir), o valor passado como
parmetro no construtor da classe armazenado no campo interno FMessage.
constructor Exception.Create(const Msg: string);
begin
FMessage := Msg;
end;
CreateFmt
Declarao
constructor CreateFmt (const Msg: string; const Args: array of const)
Este outro mtodo construtor da classe (responsvel pela alocao da memria necessria aos objetos
da classe), e recebe como parmetros uma string que ser mostrada na caixa de dilogo exibida
quando a exceo ocorrer durante a execuo do programa, e um array contendo cdigos de
formatao para essa string.
Como pode ser verificado na codificao do mtodo (reproduzida a seguir), os valores passados como
parmetros nesse construtor da classe so passados como parmetros em uma chamada da funo
Format, e a string resultante da execuo dessa funo armazenada no campo interno FMessage.
constructor Exception.CreateFmt(const Msg: string;
const Args: array of const);
begin
FMessage := Format(Msg, Args);
end;
Os cdigos de formatao so apresentados no item Format Stringsdo Help On-line do Delphi 7.
CreateFmtHelp
Declarao
constructor CreateFmtHelp (const Msg: string; const Args: array of const; AHelpContext:
Integer);
da classe), e recebe como parmetros uma string que ser mostrada na caixa de dilogo exibida quando
a exceo ocorrer durante a execuo do programa, um array contendo cdigos de formatao para
essa string e um inteiro identificando o tpico do arquivo de help on-line a ser associado classe.
Como pode ser verificado na codificao do mtodo (reproduzida a seguir), os dois primeiros valores
passados como parmetros nesse construtor da classe so passados como parmetros em uma chamada
da funo Format, e a string resultante da execuo dessa funo armazenada no campo interno
FMessage. O terceiro parmetro, por sua vez, armazenado no campo interno FhelpContext.
constructor Exception.CreateFmtHelp(const Msg: string; const Args: array of const;
begin
FMessage := Format(Msg, Args);
FHelpContext := AHelpContext;
end;
CreateHelp
Declarao
constructor CreateHelp (const Msg: string; AHelpContext: Integer);
da classe), e recebe como parmetros uma string que ser mostrada na caixa de dilogo exibida quando
a exceo ocorrer durante a execuo do programa e um inteiro identificando o tpico do arquivo de
help on-line a ser associado classe.
A diferena entre esse construtor e o descrito no tpico anterior est no fato de que a string no
formatada, no havendo portanto uma chamada funo Format.
A codificao deste mtodo reproduzida a seguir.
constructor Exception.CreateHelp(const Msg: string; AHelpContext: Integer);
begin
FMessage := Msg;
end;
CreateRes
Declarao
constructor CreateRes (Ident: Integer; Dummy: Extended = 0);
da classe), e recebe como parmetro um inteiro que identifica uma string armazenada no arquivo de
recursos do seu aplicativo.
Nesse caso, a string a ser armazenada no campo interno FMessage obtida executando-se a funo LoadStr,
que retorna a string armazenada no arquivo de recursos identificada pelo valor passado como parmetro.
constructor Exception.CreateRes(Ident: Integer);
begin
FMessage := LoadStr(Ident);
end;
CreateResFmt
Declarao
Esse outro mtodo construtor da classe (responsvel pela alocao da memria necessria aos objetos
da classe), e recebe como parmetros um inteiro que identifica uma string armazenada no arquivo de
recursos do seu aplicativo e um array contendo cdigos de formatao para essa string.
Nesse caso, a string a ser armazenada no campo interno FMessage obtida executando-se a funo
Format, passando como parmetro a string resultante de uma chamada funo LoadStr (que retorna
a string armazenada no arquivo de recursos identificada pelo valor passado como parmetro).
constructor Exception.CreateResFmt(Ident: Integer;
const Args: array of const);
begin
FMessage := Format(LoadStr(Ident), Args);
end;
CreateResFmtHelp
Declarao
constructor CreateResFmtHelp(Ident: Integer; const Args: array of const
; AHelpContext: Integer);
da classe), e recebe como parmetros um inteiro que identifica uma string armazenada no arquivo de
recursos do seu aplicativo, um array contendo cdigos de formatao para essa string e um valor
inteiro que identifica o cdigo do arquivo de help associado a essa classe.
A diferena entre esse mtodo e o descrito no tpico anterior est na incluso do terceiro parmetro,
que identifica o cdigo do arquivo de help associado classe, e cujo valor ser armazenado no campo
interno FhelpContext.
constructor Exception.CreateResFmtHelp(Ident: Integer;
const Args: array of const;
begin
FMessage := Format(LoadStr(Ident), Args);
end;
PROPRIEDADES DA CLASSE EXCEPTION
HelpContext
A propriedade HelpContext definida pela seguinte linha de cdigo:
property HelpContext: Integer read FHelpContext write FHelpContext;
Conforme pode ser verificado, o valor atribudo propriedade HelpContext diretamente armazenado
no campo FHelpContext. Da mesma forma, ao se tentar obter o valor dessa propriedade, esse tambm
obtido diretamente do campo FHelpContext.
Repare que, nesse caso, no se definiu nenhum mtodo de leitura ou de escrita, e conseqentemente a
propriedade acessa diretamente o valor armazenado em um campo interno da classe.
Message
A propriedade Message definida pela seguinte linha de cdigo.
property Message: string read FMessage write FMessage;
Conforme pode ser verificado, o valor atribudo propriedade Message diretamente armazenado no
campo FMessage. Da mesma forma, ao se tentar obter o valor dessa propriedade, esse tambm obtido
diretamente do campo FMessage.
Repare que, nesse caso, tambm no se definiu nenhum mtodo de leitura ou de escrita, e conseqentemente
a propriedade acessa diretamente o valor armazenado em um campo interno da classe.
CLASSES DERIVADAS POR HERANA DA CLASSE EXCEPTION
A classe Exception a classe-base de todas as classes criadas para manipular excees.
O Delphi 7 define vrias classes destinadas a manipulao de excees (derivadas de Exception), como
pode ser verificado no cdigo-fonte da unit SysUtils.
Muitas dessas classes, no entanto, no implementam nenhum campo adicional ou sobrecarregam
qualquer dos mtodos definidos na classe-base.
Nesses casos, essas classes servem apenas como um alias ou apelido para a classe Exception, a serem
utilizadas em determinadas situaes.
N prximo tpico ser apresentada a sintaxe necessria gerao de uma exceo.
O MECANISMO UTILIZADO NA GERAO DE EXCEES
Para gerar uma exceo deve-se usar o comando raise, seguido pela execuo do mtodo construtor da
classe correspondente exceo a ser gerada.
Considere, por exemplo, a definio da seguinte exceo, denominada ERendimento Error:
ERendimento Error = Class(Exception);
Essa classe pode ser usada para exibir uma mensagem de erro para o usurio da classe, sempre que se
tentar atribuir um valor incorreto para o campo.
Para isso, podemos redefinir a classe TContribuinte (j definida anteriormente) da maneira mostrada
a seguir.
private
FRendimento : double;
Fimposto : double;
public
procedure SetRendimento (valor : double);
property rendimento : double read FRendimento write SetRendimento;
protected
end;
begin
if (FRendimento < 900.0) then Fimposto := 0.0;
if (FRendimento > 1800) then Fimposto := 0.25*rendimento -315.0;
if (FRendimento >= 900)and(FRendimento <= 1800) then Fimposto := 0.15*rendimento -135.0;
result := Fimposto;
end;
procedure TContribuinte.SetRendimento (Valor : double);
begin
if valor < 0
then
raise ERendimentoError.Create(Rendimento No pode ser Negativo)
else
FRendimento := valor;
end;
Dessa maneira, se voc tentar atribuir um valor negativo propriedade rendimento de uma instncia
da classe TContribuinte, ser exibida uma caixa de dilogo com a mensagem Rendimento No pode
ser Negativo (ainda bem!).
As excees permitem, portanto, que se faa um tratamento diferenciado em funo do tipo de erro
que provoca uma interrupo na execuo normal de um programa.
Voc pode tratar o erro descrito anteriormente em um bloco try..except semelhante ao mostrado no
seguinte trecho de cdigo, onde valor uma varivel do tipo double:
try
contribuinte1.rendimento := valor;
except
on ERendimento Error do
ShowMessage(Rendimento No pode ser Negativo);
end;
KNOW-HOW EM: MANIPULAO DE LISTAS DE OBJETOS
PR-REQUISITOS
METODOLOGIA
Apresentao da classe TList, que permite a manipulao de listas de objetos.
TCNICA
Implementao de classes derivadas da classe TList, de forma a ilustrar o mecanismo de manipulao de listas de objetos.
Considere a seguinte situao: sua aplicao define uma determinada classe, e precisa manipular uma
lista de objetos dessa classe.
Vamos considerar novamente a classe TPessoa_Fisica, derivada da classe TContribuinte, qual ser
acrescida o campo nome, do tipo string, como a seguir:
TPessoa_Fisica = Class(TContribuinte)
nome: string;
end;
Caso a sua aplicao necessite manipular uma lista de contribuintes do tipo pessoa fsica, a princpio
seria necessrio criar uma nova classe com essa finalidade.
A fim de facilitar o trabalho do desenvolvedor, o Delphi 7 inclui entre as diversas classes disponveis a
classe TList, que declara a maioria dos mtodos necessrios manipulao de listas de objetos.
importante, no entanto, ressaltar que uma instncia de uma classe armazena, na realidade, um endereo
para um objeto da classe, e no o objeto propriamente dito embora o Delphi 7 torne o acesso ao objeto
da classe to transparente que muitos consideram que o objeto esteja sendo acessado diretamente. Quando
manipulamos um objeto (ou instncia) de uma classe estamos na realidade acessando o endereo ocupado
pelo objeto a questo que o Delphi 7 trata de desreferenciar o ponteiro.
J que o ambiente de desenvolvimento tratou de simplificar essa tarefa, no vamos nos deter em
explicar a aritmtica de ponteiros definida na linguagem Object Pascal seria complicar aquilo que j
foi simplificado na contramo da produtividade desejada por aqueles que utilizam o Delphi 7 como
ferramenta de desenvolvimento.
importante, no entanto, que esse conceito fique bem claro pelo leitor: embora tudo se passe como se
estivssemos acessando diretamente uma instncia da classe, o nome do objeto armazena na realidade
o endereo do objeto. Conforme ser visto a seguir, a classe TList manipula endereos de objetos, e no
armazena os objetos propriamente ditos.
Podemos portanto pensar em criar a classe TListaContribuinte a partir da classe TList, aproveitando as
caractersticas j disponveis para essa classe.
Apresentamos a seguir a descrio das principais propriedades, mtodos e eventos da classe TList.
REFERNCIA: A CLASSE TLIST
A classe TList, codificada na unit Classes e reproduzida a seguir, derivada por herana da classe
TObject e a classe-base para todas as classes que manipulam listas de objetos no Delphi 7.
DEFINIO DA CLASSE TLIST
Reproduzimos a seguir o trecho de cdigo responsvel pela definio da classe TList.
TList = class(TObject)
private
FList: PPointerList;
FCount: Integer;
FCapacity: Integer;
protected
function Get(Index: Integer): Pointer;
procedure Grow; virtual;
procedure Put(Index: Integer; Item: Pointer);
procedure SetCapacity(NewCapacity: Integer);
procedure SetCount(NewCount: Integer);
public
destructor Destroy; override;
function Add(Item: Pointer): Integer;
procedure Clear; dynamic;
procedure Delete(Index: Integer);
class procedure Error(const Msg: string; Data: Integer); virtual;
procedure Exchange(Index1, Index2: Integer);
function Expand: TList;
function First: Pointer;
function IndexOf(Item: Pointer): Integer;
procedure Insert(Index: Integer; Item: Pointer);
function Last: Pointer;
procedure Move(CurIndex, NewIndex: Integer);
function Remove(Item: Pointer): Integer;
procedure Pack;
procedure Sort(Compare: TListSortCompare);
property Capacity: Integer read FCapacity write SetCapacity;
property Count: Integer read FCount write SetCount;
property Items[Index: Integer]: Pointer read Get write Put; default;
property List: PPointerList read FList;
end;
PROPRIEDADES DA CLASSE TLIST
Apresentamos a seguir a descrio das propriedades definidas para a classe TList.
Capacity
Essa propriedade declarada como uma varivel inteira, e retorna o nmero de objetos que podem ser
referenciados na lista. Essa propriedade retorna o nmero de objetos que a lista capaz de referenciar,
e no o nmero de objetos que realmente esto sendo endereados pela lista, o que definido pela sua
propriedade Count (a ser vista a seguir).
Inicialmente (quando a lista criada) o seu valor igual a 0, mas alterado durante a manipulao da lista.
Count
Essa propriedade declarada como uma varivel inteira, e retorna o nmero de objetos referenciados
na lista e no o nmero de objetos que podem vir a ser endereados pela mesma, o que definido pela
sua propriedade Capacity, descrita anteriormente.
O valor da propriedade Count pode ser inferior ao definido pela propriedade Capacity, pois a lista
pode, eventualmente, enderear ponteiros nulos (que armazenam o valor nil). Para remover essas
referncias a endereos nos quais no est armazenado nenhum objeto, deve-se utilizar o mtodo Pack
da classe, a ser descrito posteriormente.
Items
Essa propriedade armazena, na forma de um array, as referncias a todos os objetos endereados pela lista.
Esse array inicia com o ndice 0 e, conseqentemente, o endereo do primeiro objeto referenciado pela
lista estar armazenado em Items[0].
List
Essa propriedade armazena, na forma de um array, os endereos de todos os objetos da lista (as variveis
do tipo Pointer que armazenam os endereos dos objetos referenciados pela lista).
PRINCIPAIS MTODOS DA CLASSE TLIST
Add
Declarao
Esse mtodo adiciona uma referncia a um objeto no final da lista, e retorna um valor inteiro que
retorna o ndice dessa referncia no array (esse ndice comea em zero).
Clear
Declarao
procedure Clear; dynamic;
Esse mtodo remove todas as referncias a objetos da lista, e atribui o valor 0 s propriedades Count
e Capacity.
Delete
Declarao
Esse mtodo remove da lista o endereo do objeto cujo ndice passado como parmetro.
Conseqentemente, o ndice das referncias a objetos cujo ndice atual superior ao da referncia
removida da lista tem o seu valor reduzido em uma unidade.
Destroy
Declarao
Este o mtodo destrutor da classe, responsvel por remover todas as referncias a objetos da lista.
Aconselha-se utilizar o mtodo Free (herdado da classe TObject) em vez do mtodo Destroy, pois,
conforme j descrito anteriormente, o mtodo Free verifica se o valor do endereo igual a nil antes de
chamar o mtodo destrutor da classe.
importante destacar que esse mtodo no destri os objetos propriamente ditos, mas sim as suas
referncias na lista. Para destruir cada objeto, deve-se chamar seu prprio mtodo construtor.
Error
Declarao
class procedure Error(const Msg: string; Data: Integer); virtual;
Este mtodo deve ser usado para gerar uma exceo caso ocorra algum erro durante a manipulao dos
objetos da lista, e recebe como parmetros uma string e um valor inteiro que pode ser usado para
indicar a causa do erro.
Exchange
Declarao
Esse mtodo troca a posio na lista das referncias a dois objetos cujos ndices so passados como
parmetros.
Expand
Declarao
Esse mtodo expande a capacidade da lista.
Se Count = Capacity, o valor da propriedade Capacity incrementado de acordo com as seguintes regras:
Se o valor da propriedade Capacity maior do que 8, seu valor incrementado em 16 unidades.
Se o valor da propriedade Capacity maior do que 4 e menor ou igual a 8, seu valor
incrementado em 8 unidades.
Se o valor da propriedade Capacity menor do que 4, seu valor incrementado em 4 unidades.
First
Declarao
Esse mtodo retorna em um ponteiro o endereo do primeiro objeto referenciado pela lista.
IndexOf
Declarao
function IndexOf(Item: Pointer): Integer;
Esse mtodo retorna o ndice da referncia a objeto cujo endereo passado como parmetro.
Insert
Declarao
Esse mtodo insere, na posio da lista definida pelo ndice cujo valor passado como primeiro
parmetro, o endereo do objeto a ser referenciado, que passado como segundo parmetro na forma
de um ponteiro.
Conseqentemente, o ndice dos objetos cujo ndice atual igual ou superior ao do objeto inserido na
lista tem o seu valor incrementado em uma unidade.
Last
Declarao
Esse mtodo retorna em um ponteiro o endereo do ltimo objeto referenciado pela lista.
Move
Declarao
Esse mtodo move a referncia ao objeto definida pelo ndice passado como primeiro parmetro para
a posio indicada pelo ndice passado como segundo parmetro.
Pack
Declarao
procedure Pack;
Esse mtodo remove todos os itens que no referenciam qualquer objeto, isto , que armazenam o
valor nil, para o incio da lista e reduz o valor da propriedade Count para o nmero de objetos realmente
referenciados pela lista.
Esse mtodo, no entanto, no libera a memria usada para armazenar os ponteiros cujo valor nil (o
que pode ser feito atribuindo-se propriedade Capacity o valor armazenado na propriedade Count).
Remove
Declarao
Esse mtodo remove da lista a referncia ao objeto cujo endereo passado como parmetro na forma
de um ponteiro, retornando o ndice do objeto cuja referncia na lista foi removida. Conseqentemente,
o ndice das referncias a objetos cujo ndice atual superior ao do objeto removido da lista tem o seu
valor reduzido em uma unidade.
Sort
Declarao
procedure Sort(Compare: TListSortCompare);
Esse mtodo ordena os itens da lista usando o algoritmo QuickSort, usando como valor para definir
essa ordenao o retornado pela funo passada como parmetro.
Essa funo deve receber como parmetros dois ponteiros que referenciam itens da lista e retorna:
Um valor negativo (< 0), se o objeto referenciado por item1 , segundo o critrio de ordenao
definido no corpo da funo, menor do que o objeto referenciado por item2.
Um valor nulo (= 0), se o objeto referenciado por item1 , segundo o critrio de ordenao
definido no corpo da funo, igual ao objeto referenciado por item2.
Um valor positivo (> 0), se o objeto referenciado por item1 , segundo o critrio de ordenao
definido no corpo da funo, maior do que o objeto referenciado por item2.
O cabealho da funo usada na ordenao dos itens da lista definido pelo tipo TListSortCompare,
indicado a seguir.
type TListSortCompare = function (Item1, Item2: Pointer): Integer;
EXEMPLO DE UTILIZAO
Nesse tpico apresentaremos um exemplo de utilizao de uma classe derivada da classe TList.
DEFINIO DA INTERFACE
Inicialmente dever ser definida uma nova aplicao, composta por um formulrio no qual sero
inseridos vrios componentes, com as propriedades descritas a seguir:
Formulrio:
Name: FormListaObjetos
Caption: Formulrio Para a Manipulao de Listas de Objetos
Position: poScreenCenter
Boto de Figura:
Name: BotaoFechar
Kind: bkClose
Caption: &Fechar
GroupBoxes:
Name: GroupBoxDados
Caption: Dados do Contribuinte
Name: GroupBoxOperacoes
Caption: Operaes Sobre a Lista
Name: GroupBoxPesquisa
Caption: Digite o Nome do Contribuinte a Pesquisar
Objetos a serem inseridos dentro do GroupBox GroupBoxDados:
Labels:
Name: LabelNome
Caption: Nome:
Name: LabelRendimento
Caption: Rendimento:
Name: LabelImposto
Caption: Imposto:
Name: LabelValorImposto
Caption: 0.0
Caixas de Texto:
Name: EditNome
Text:
Name: EditRendimento
Text:
Objetos a serem inseridos dentro do GroupBox GroupBoxOperacoes:
Botes de Comando:
Name: BotaoAdiciona
Caption: Adiciona
Name: BotaoInsere
Caption: Insere
Name: BotaoRemove
Enabled: False
Caption: Remove
Name: BotaoOrdena
Caption: Ordena
Name: BotaoPrimeiro
Caption: Primeiro
Name: BotaoAnterior
Caption: Anterior
Name: BotaoProximo
Caption: Prximo
Name: BotaoUltimo
Caption: ltimo
Objetos a serem inseridos dentro do GroupBox GroupBoxPesquisa:
Caixas de Texto:
Name: EditPesquisa
Text:
Reposicione e redimensione estes componentes para que o formulrio fique com o aspecto mostrado
na figura a seguir.
Figura 19.5: Aspecto do formulrio usado no exemplo de manipulao de listas.
CODIFICAO DO EXEMPLO
Ser criada uma classe chamada TListaContribuinte, destinada a manipular uma lista de objetos da
classe TPessoa_Fisica, na qual sero includos mtodos no existentes em sua classe ancestral (TList).
A definio dessa classe deve ser feita na seo type da unit associada a esse formulrio, mediante a
incluso das seguintes linhas de cdigo:
private
Fimposto : double;
public
protected
end;
ERendimento = Class(Exception);
TPessoa_Fisica = class(TContribuinte)
nome: string;
end;
TListaContribuinte = class(TList)
procedure PesquisaNome(Nome:String);
destructor Destroy;override;
end;
Repare que inclumos ainda as definies das classes TContribuinte (ancestral da classe TPessoa_Fisica)
e ERendimentoError (exceo manipulada pela classe TContribuinte).
Repare ainda que, nesse caso, optamos por manter o campo rendimento definido na classe
TContribuinte, de maneira a aproveitar o cdigo j escrito em tpicos anteriores.
O nico campo acrescentado na definio da classe TPessoa_Fisica foi o campo nome, do tipo string.
A classe TListaContribuinte, derivada por herana da classe TList, acrescenta na sua definio os mtodos
PesquisaNome e Destroy (que sobrecarrega o mtodo de mesmo nome definido na classe-base).
Para criar o corpo principal de um mtodo da classe, basta selecionar simultaneamente as teclas Ctrl, Shift e C aps digitar as declaraes
dos mtodos na definio da classe. O ambiente de desenvolvimento vai gerar automaticamente o corpo principal dos mtodos na seo
Implementation da unit.
Declare as seguintes variveis na seo var da unit:
ListaContribuinte : TListaContribuinte;
indiceatual : integer;
O objeto ListaContribuinte, da classe TListaContribuinte, ser usado para representar a lista que
manipular os objetos.
A varivel indiceatual, do tipo inteiro, ser usada para armazenar o ndice do objeto cujos valores so
exibidos no momento.
Para alocar a memria necessria ao objeto ListaContribuinte, deve-se fazer uma chamada ao seu
mtodo construtor no procedimento associado ao evento OnCreate do formulrio, que deve ser
codificado da seguinte maneira:
procedure TFormListaObjetos.FormCreate(Sender: TObject);
begin
ListaContribuinte := TListaContribuinte.Create;
end;
Para liberar a memria alocada ao trmino da execuo da aplicao, basta definir da seguinte maneira
o procedimento associado ao evento OnDestroy do formulrio:
procedure TFormListaObjetos.FormDestroy(Sender: TObject);
begin
ListaContribuinte.Free;
end;
Para permitir ao usurio adicionar um elemento lista, deve-se definir da seguinte maneira o
procedimento associado ao evento OnClick do componente BotaoAdicionar:
procedure TFormListaObjetos.BotaoAdicionaClick(Sender: TObject);
var
Contribuinte: TPessoa_Fisica;
begin
Contribuinte.Nome := EditNome.Text;
Contribuinte.rendimento := StrToFloat(EditRendimento.Text);
ListaContribuinte.Add(Contribuinte);
indiceatual := ListaContribuinte.Count-1;
LabelValorImposto.Caption:=FloatToStr(TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).calcula_imposto);
BotaoRemove.Enabled := True;
end;
Repare que esse procedimento declara uma instncia local da classe TPessoa_Fisica, e que a chamada
ao seu mtodo Create retorna uma nova instncia da classe, o que feito mediante a incluso da
seguinte linha de cdigo:
Em seguida, atribuem-se valores aos campos Nome e rendimento da classe, o que feito mediante a
incluso das seguintes linhas de cdigo:
A adio do objeto lista feita mediante uma chamada ao mtodo Add da classe TListaContribuinte,
mediante a incluso da seguinte linha de cdigo:
Por fim, o valor do ndice atual e o texto exibido no label LabelValorImposto so atualizados, o que
feito mediante a incluso das seguintes linhas de cdigo:
LabelValorImposto.Caption:=FloatToStr(TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).calcula_imposto);
Repare a converso explcita de tipos empregada nesse cdigo. Isso se deve ao fato de que a propriedade
Items da classe TList (e conseqentemente da classe TListaContribuinte) nos fornece os endereos dos
objetos manipulados pela lista e, como sabemos que os objetos so da classe TPessoa_Fisica, podemos
realizar essa converso com segurana.
Para permitir que o usurio possa remover posteriormente os objetos adicionados lista, deve-se habilitar
o componente BotaoRemove, o que feito mediante a incluso da seguinte linha de cdigo:
Para permitir ao usurio inserir um elemento na lista, deve-se definir da seguinte maneira o procedimento
associado ao evento OnClick do componente BotaoInsere:
procedure TFormListaObjetos.BotaoInsereClick(Sender: TObject);
var
begin
ListaContribuinte.Insert(indiceatual, Contribuinte);
end;
Esse cdigo muito semelhante ao definido para o procedimento associado ao evento OnClick do
componente BotaoAdiciona, exceto que se utiliza nesse caso o mtodo Insert em vez do mtodo Add
da classe TListaContribuinte.
Para permitir ao usurio remover um elemento na lista, deve-se definir da seguinte maneira o
procedimento associado ao evento OnClick do componente BotaoRemove:
procedure TFormListaObjetos.BotaoRemoveClick(Sender: TObject);
begin
ListaContribuinte.Delete(indiceatual);
if indiceatual > ListaContribuinte.Count-1 then indiceatual :=
ListaContribuinte.Count-1;
if ListaContribuinte.Count > 0 then
begin
EditNome.Text :=
TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).Nome;
EditRendimento.Text:=FloatToStr(TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).
rendimento);
LabelValorImposto.Caption :=
FloatToStr(TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).calcula_imposto);
end
else
begin
EditNome.Clear;
EditRendimento.Clear;
LabelValorImposto.Caption := ;
BotaoRemove.Enabled := False;
end;
end;
importante, inicialmente, verificar que esse procedimento s ser executado se a propriedade En-
abled do componente for igual a True.
Inicialmente remove-se o objeto atual da lista (e cujo ndice identificado pela varivel indiceatual)
mediante uma chamada ao mtodo Delete da classe TListaContribuinte, o que feito mediante a
incluso da seguinte linha de cdigo:
Em seguida, verifica-se se o valor armazenado na varivel ndice atual est dentro dos limites possveis
para o ndice do array, o que feito mediante a incluso da seguinte linha de cdigo:
if indiceatual > ListaContribuinte.Count-1 then indiceatual := ListaContribuinte.Count-1;
Por fim, verifica-se se ainda existem elementos na lista (analisando-se o valor da propriedade Count do
objeto ListaContribuinte), e atualizam-se corretamente os valores exibidos nas caixas de texto e no
label LabelValorImposto, o que feito mediante a incluso do seguinte trecho de cdigo:
begin
EditNome.Text := TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).Nome;
EditRendimento.Text:=FloatToStr(TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).
rendimento);
end
else
begin
EditNome.Clear;
end;
Repare que, se no houver mais objetos na lista, o boto BotaoRemove desabilitado, mediante a
incluso da seguinte linha de cdigo:
Enabled := False;
Para permitir ao usurio exibir os dados armazenados no primeiro objeto da classe, deve-se definir da
seguinte maneira o procedimento associado ao evento OnClick do componente BotaoPrimeiro:
procedure TFormListaObjetos.BotaoPrimeiroClick(Sender: TObject);
begin
ListaContribuinte.First;
indiceatual := 0;
EditRendimento.Text :=
FloatToStr(TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).rendimento);
end;
Inicialmente, faz-se uma chamada ao mtodo First da classe TListaContribuinte, mediante a incluso
da seguinte linha de cdigo:
Em seguida atualizam-se o valor da varivel indiceatual que deve ser igual ao ndice do primeiro
elemento da lista isto , 0, o que feito mediante a incluso da seguinte linha de cdigo:
indiceatual := 0;
Por fim, atualizam-se os valores exibidos nas caixas de texto e no label LabelValorImposto, o que
feito mediante a incluso das seguintes linhas de cdigo:
Os procedimentos associados ao evento OnClick dos componentes BotaoProximo, BotaoUltimo e
BotaoAnterior tm codificao semelhante, sendo sua definio reproduzida a seguir.
procedure TFormListaObjetos.BotaoAnteriorClick(Sender: TObject);
begin
if indiceatual > 0 then indiceatual := indiceatual-1;
EditRendimento.Text := FloatToStr(TPessoa_Fisica(ListaContribuinte.Items[indiceatual]).
rendimento);
end;
procedure TFormListaObjetos.BotaoProximoClick(Sender: TObject);
begin
if indiceatual < ListaContribuinte.Count-1 then indiceatual := indiceatual+1;
end;
procedure TFormListaObjetos.BotaoUltimoClick(Sender: TObject);
begin
ListaContribuinte.Last;
end;
O nico cuidado que se deve ter na codificao desses procedimentos se refere a garantir que os limites
do ndice do array sejam respeitados.
O mtodo PesquisaNome da classe TListaContribuinte deve ser capaz de retornar o ndice do objeto
manipulado pela lista cujo valor armazenado no campo Nome seja igual ao da string passada como
parmetro.
Apresenta-se a seguir a codificao desse mtodo:
procedure TListaContribuinte.PesquisaNome(Nome: String);
var
i : integer;
begin
First;
indiceatual := 0;
for i := 0 to Count-1 do
begin
if TPessoa_Fisica(Items[i]).Nome = Nome then
begin
indiceatual := i;
Exit;
end;
end;
end;
Nesse procedimento, define-se uma varivel local i a ser usada no loop de pesquisa.
Inicialmente define-se o objeto corrente como sendo o primeiro objeto manipulado pela lista, mediante
uma chamada ao mtodo First da classe TListaContribuinte, o que feito mediante a incluso da
First;
Alm disso, atribui-se o valor 0 varivel ndice atual:
indiceatual := 0;
Por fim, efetua-se um looping pelos objetos referenciados pela lista, at que se encontre um objeto
cujo valor armazenado no campo Nome igual ao da string passada como parmetro (atribuindo-se o
valor atual do contador varivel indiceatual).
begin
begin
indiceatual := i;
Exit;
end;
end;
Repare que nesse caso implementou-se uma pesquisa exata, e no uma pesquisa aproximada.
Para permitir ao usurio ordenar os objetos referenciados pela lista, deve-se definir da seguinte maneira
o procedimento associado ao evento OnClick do componente BotaoOrdena:
procedure TFormListaObjetos.BotaoOrdenaClick(Sender: TObject);
begin
ListaContribuinte.Sort(Compara);
end;
O cdigo desse procedimento consiste apenas em uma chamada ao mtodo Sort da classe
TListaContribuinte, o que feito mediante a incluso da seguinte linha de cdigo:
Falta ainda definir a funo a ser usada pelo algoritmo QuickSort. Nesse caso, definiu-se uma funo
denominada Compara, e implementada da seguinte maneira:
function Compara(indice1, indice2: Pointer): integer;
begin
result:=AnsiCompareText(TPessoa_Fisica(indice1).Nome,TPessoa_Fisica(indice2).Nome);
end;
Repare que essa funo utiliza a funo AnsiCompareText, definida na unit SysUtils, e que compara
duas strings sem levar em considerao se a letra est em caixa alta ou caixa baixa.
Por fim, falta apresentar a definio do mtodo destrutor da classe TListaContribuinte, cuja codificao
reproduzida a seguir:
destructor TListaContribuinte.Destroy;
var
i : integer;
begin
for i:= 0 to Count-1 do
begin
TPessoa_Fisica(Items[i]).Destroy;
end;
end;
Repare que esse mtodo responsvel por liberar a memria alocada para todos os objetos referenciados
pela lista.
Para simplificar a digitao de novos valores pelo usurio, os procedimentos associados ao evento
OnEnter das caixas de texto EditNome e EditRendimento devem ser implementados da seguinte maneira:
procedure TFormListaObjetos.EditNomeEnter(Sender: TObject);
begin
EditNome.Clear;
LabelValorImposto.Caption := 0.0;
end;
procedure TFormListaObjetos.EditRendimento Enter(Sender: TObject);
begin
end;
Apresentamos a seguir o cdigo completo da unit Ulista:
unit Ulista;
interface
uses
Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs,
Buttons, StdCtrls;
type
TFormListaObjetos = class(TForm)
GroupBoxDados: TGroupBox;
LabelNome: TLabel;
EditNome: TEdit;
LabelRendimento: TLabel;
EditRendimento: TEdit;
GroupBoxOperacoes: TGroupBox;
BotaoAdiciona: TButton;
BotaoInsere: TButton;
BotaoRemove: TButton;
BotaoOrdena: TButton;
BotaoPrimeiro: TButton;
BotaoAnterior: TButton;
BotaoProximo: TButton;
BotaoUltimo: TButton;
LabelImposto: TLabel;
LabelValorImposto: TLabel;
GroupBoxPesquisa: TGroupBox;
EditPesquisa: TEdit;
procedure FormCreate(Sender: TObject);
procedure BotaoAdicionaClick(Sender: TObject);
procedure BotaoInsereClick(Sender: TObject);
procedure BotaoOrdenaClick(Sender: TObject);
procedure BotaoPrimeiroClick(Sender: TObject);
procedure BotaoAnteriorClick(Sender: TObject);
procedure BotaoProximoClick(Sender: TObject);
procedure BotaoUltimoClick(Sender: TObject);
procedure EditPesquisaChange(Sender: TObject);
procedure EditNomeEnter(Sender: TObject);
procedure EditRendimento Enter(Sender: TObject);
procedure BotaoRemoveClick(Sender: TObject);
procedure FormDestroy(Sender: TObject);
private
public
end;
private
Fimposto : double;
public
property Rendimento : double read FRendimento write SetRendimento;
protected
end;
ERendimento Error = Class(Exception);
TPessoa_Fisica = class(TContribuinte)
nome: string;
end;
TListaContribuinte = class(TList)
procedure PesquisaNome(Nome:String);
end;
function Compara(indice1, indice2 : Pointer):integer;
var
FormListaObjetos: TFormListaObjetos;
ListaContribuinte : TListaContribuinte;
indiceatual : integer;
implementation
{$R *.DFM}
{ TListaContribuinte }
function Compara(indice1, indice2: Pointer): integer;
begin
result := AnsiCompareText(TPessoa_Fisica(indice1).Nome,TPessoa_Fisica(indice2).Nome);
end;
destructor TListaContribuinte.Destroy;
var
i : integer;
begin
for i:= 0 to Count-1 do
begin
TPessoa_Fisica(Items[i]).Destroy;
end;
end;
procedure TListaContribuinte.PesquisaNome(Nome: String);
var
i : integer;
begin
First;
indiceatual := 0;
begin
begin
indiceatual := i;
Exit;
end;
end;
end;
procedure TFormListaObjetos.FormCreate(Sender: TObject);
begin
ListaContribuinte := TListaContribuinte.Create;
end;
begin
if (FRendimento < 900.0) then Fimposto := 0.0;
if (FRendimento > 1800) then Fimposto := 0.25*rendimento -315.0;
if (FRendimento >= 900)and(FRendimento <= 1800) then Fimposto := 0.15*rendimento -135.0;
result := Fimposto;
end;
procedure TContribuinte.SetRendimento (Valor : double);
begin
if valor < 0
then
raise ERendimentoError.Create(Rendimento No pode ser Negativo)
else
FRendimento := valor;
end;
procedure TFormListaObjetos.BotaoAdicionaClick(Sender: TObject);
var
begin
Contribuinte.Rendimento := StrToFloat(EditRendimento.Text);
end;
procedure TFormListaObjetos.BotaoInsereClick(Sender: TObject);
var
begin
Contribuinte. rendimento := StrToFloat(EditRendimento.Text);
ListaContribuinte.Insert(indiceatual, Contribuinte);
end;
procedure TFormListaObjetos.BotaoOrdenaClick(Sender: TObject);
begin
end;
procedure TFormListaObjetos.BotaoPrimeiroClick(Sender: TObject);
begin
indiceatual := 0;
end;
procedure TFormListaObjetos.BotaoAnteriorClick(Sender: TObject);
begin
if indiceatual > 0 then indiceatual := indiceatual-1;
end;
procedure TFormListaObjetos.BotaoProximoClick(Sender: TObject);
begin
if indiceatual < ListaContribuinte.Count-1 then indiceatual := indiceatual+1;
end;
procedure TFormListaObjetos.BotaoUltimoClick(Sender: TObject);
begin
ListaContribuinte.Last;
end;
procedure TFormListaObjetos.EditPesquisaChange(Sender: TObject);
begin
ListaContribuinte.PesquisaNome(EditPesquisa.Text);
end;
procedure TFormListaObjetos.EditNomeEnter(Sender: TObject);
begin
EditNome.Clear;
LabelValorImposto.Caption := 0.0;
end;
procedure TFormListaObjetos.EditRendimento Enter(Sender: TObject);
begin
end;
procedure TFormListaObjetos.BotaoRemoveClick(Sender: TObject);
begin
if indiceatual > ListaContribuinte.Count-1 then indiceatual := ListaContribuinte.Count-1;
begin
end
else
begin
EditNome.Clear;
end;
end;
procedure TFormListaObjetos.FormDestroy(Sender: TObject);
begin
ListaContribuinte.Free;
end;
end.
Evidentemente esse exemplo pode ser ainda mais incrementado pelo leitor, pois nosso objetivo aqui
foi apresentar as tcnicas fundamentais relacionadas manipulao de listas de objetos.
Um dos problemas que deve ter sido verificado pelo leitor a ausncia de persistncia de dados, ou
seja, os dados so manipulados apenas em memria e perdidos aps o trmino da aplicao.
KNOW-HOW EM: SOBRECARGA DE MTODOS
PR-REQUISITOS
METODOLOGIA
Apresentao do conceito de sobrecarga de mtodos.
O CONCEITO DE SOBRECARGA DE MTODOS
Conforme voc j deve ter verificado, muitas classes tm diversos construtores, cada um com um
nome distinto (um exemplo tpico o da classe Exception, j apresentada).
Isso decorre do fato de que, at a verso 3, o Delphi no permitia a utilizao do recurso de sobrecarga
de mtodos (j existente h muito tempo no C++) recurso este que permite que se definam vrios
mtodos de mesmo nome, mas com uma lista de parmetros distintos (em quantidade e/ou tipo).
A classe TContribuinte, por exemplo, poderia definir dois mtodos construtores, recodificando a classe
da seguinte maneira:
private
Fimposto : double;
public
constructor Create;overload;
constructor Create(rendimento_inicial : double);overload;
protected
end;
As implementaes dos mtodos seriam feitas da seguinte maneira:
constructor TContribuinte.Create(rendimento_inicial: double);
begin
inherited Create;
rendimento := rendimento_inicial;
end;
constructor TContribuinte.Create;
begin
inherited Create;
rendimento := 0.0;
end;
Repare que, agora, a classe possui dois mtodos de mesmo nome, mas com uma lista de parmetros distinta.
A nica exigncia que deve ser atendida ao se sobrecarregar um mtodo consiste em incluir na sua
declarao a palavra reservada overload, conforme exemplificado anteriormente.
importante destacar que esse recurso pode ser aplicado a qualquer mtodo da classe, e no apenas
aos seus construtores, e que os cdigos dos mtodos sobrecarregados podem ser inteiramente distintos.
Nesse caso, as duas linhas de cdigo a seguir so igualmente vlidas:
e
Contribuinte := TContribuinte.Create(1000.00);
A diferena que, no primeiro caso, a instncia da classe ao ser criada atribui o valor 0.0 ao campo
rendimento, enquanto que, no segundo caso, esse campo recebe o valor passado como parmetro.
O recurso de sobrecarga tambm pode ser empregado em funes e procedimentos que no sejam mtodos de uma classe.
KNOW-HOW EM: DEFINIO DE PARMETROS DEFAULT PARA UMA
FUNO OU PROCEDIMENTO
PR-REQUISITOS
METODOLOGIA
Apresentao do conceito de definio de parmetros default em uma funo ou procedimento.
O CONCEITO DE PARMETRO DEFAULT PARA UMA FUNO OU PROCEDIMENTO
Outro recurso bastante interessante do Delphi 7 o associado definio de uma funo ou
procedimento com parmetros default.
Esse recurso permite que aos ltimos parmetros da lista de parmetros de uma funo ou procedimento
seja definido um valor default.
Dessa maneira, se um valor no for especificado para esses parmetros na chamada da funo ou
procedimento, esses assumiro os seus valores default.
Considere, por exemplo, a seguinte funo, destinada a retornar o valor da soma de trs nmeros inteiros:
Declarao:
function Soma(valor1, valor2, valor3 : integer):integer;
Implementao:
function Soma(valor1, valor2, valor3 : integer):integer;
begin
result := valor1+valor2+valor3;
end;
Caso se queira definir o valor 0 como valor default para os dois ltimos parmetros, essa funo deveria
ser redeclarada da seguinte maneira (no altere a sua implementao):
function Soma(valor1 : integer; valor2 : integer = 0; valor3 : integer = 0):integer;
Dessa maneira, as chamadas da funo a seguir so equivalentes:
Total := Soma(10,0,0);
Total := Soma(10,0);
Total := Soma(10);
Com os recursos de sobrecargas de mtodos e de definio de valores default, o Object Pascal se torna
uma linguagem de programao orientada a objetos ainda mais completa.
Evidentemente, esses recursos tambm se aplicam a mtodos de classes.
CAPTULO 20 O CONCEITO DE COMPONENTES
Captulo
O Conceito de Componentes
20
Ao utilizar o Delphi 7 como uma ferramenta de desenvolvimento de aplicaes, trabalhamos
intensamente com os componentes fornecidos por essa ferramenta.
Como j deve ser do seu conhecimento, o Delphi 7 fornece componentes capazes de realizar as mais
diversas tarefas, como por exemplo:
Criar elementos de interface como menus pull-down, menus pop-up, botes de comando,
caixas de texto, etc.
Representar caixas de dilogo padro do Windows, com as quais nosso usurio j est habituado,
em funo da sua experincia prvia decorrente da utilizao de outras aplicaes.
Acessar tabelas de bancos de dados, atravs dos mtodos fornecidos pelos componentes e
mediante a utilizao de declaraes SQL.
Exibir os valores armazenados nos campos dos registros de uma tabela.
Criar relatrios.
Incorporar recursos de multimdia sua aplicao.
Existem situaes, no entanto, em que os componentes oferecidos pelo ambiente de desenvolvimento no
so suficientes para atender a todas as nossas necessidades, embora sejam capazes de atend-las parcialmente.
Nesses casos, tm-se a opo de instalar componentes desenvolvidos por terceiros ou criar novos
componentes a partir de componentes j existentes, incorporando apenas as caractersticas necessrias
a atender completamente s nossas necessidades.
O objetivo deste captulo ser, portanto, apresentar ao leitor o mecanismo de definio de componentes,
de forma a torn-lo apto a estender as potencialidades oferecidas pelos componentes j disponibilizados
pelo ambiente de desenvolvimento do Delphi 7.
A criao de novos componentes ser objeto de um captulo especfico.
KNOW-HOW EM: DEFINIO DE COMPONENTES
PR-REQUISITOS
METODOLOGIA
Apresentao do conceito de componentes.
Definio dos conceitos de propriedades e eventos.
Apresentao da classe TCanvas.
TCNICA
Discusso dos conceitos relacionados definio de um componente.
Implementao de procedimentos capazes de responder a mensagens do sistema operacional.
O CONCEITO DE COMPONENTES
Os componentes so, na realidade, objetos ou instncias de classes que tm algumas caractersticas
adicionais s existentes nas classes definidas no captulo anterior.
Diferentemente do que ocorre com as instncias das classes definidas anteriormente, os componentes
podem ter algumas das suas caractersticas manipuladas durante a fase de projeto de um aplicativo,
isto , a partir do prprio ambiente de desenvolvimento integrado do Delphi 7, e isso normalmente
feito alterando-se algumas das suas propriedades diretamente no Object Inspector.
O prprio componente pode ser visualizado e manipulado diretamente com o mouse (e algumas das
suas caractersticas visuais, como tamanho e posio, podem ser diretamente alteradas pelo mouse).
Alm disso, durante a execuo do aplicativo, alguns componentes podem responder a aes diretas
do usurio ou do sistema operacional, ou seja, so capazes de responder s mensagens disparadas pelo
sistema operacional. O usurio do componente pode ainda definir um trecho de cdigo a ser executado
quando o componente responder a essa mensagem, o que geralmente feito definindo-se procedimentos
associados a eventos (onde se define genericamente por evento uma ao do usurio ou do sistema
operacional).
Exemplificando: Quando um componente precisa ser redesenhado na tela, o sistema operacional envia
ao componente uma mensagem identificada como WM_Paint.
Alm disso, alguns componentes possuem um evento chamado OnPaint, cujo procedimento associado
ser executado sempre que o componente precisar responder a essa mensagem.
Alguns componentes, no entanto, s podem ser visualizados na fase de projeto do aplicativo, como
por exemplo aqueles que representam as caixas de dilogo padres do Windows. Esse tipo de
componente, na realidade, representa uma determinada funcionalidade do sistema operacional, que
foi transformada em componente para facilitar o trabalho do programador. O mesmo ocorre com os
componentes utilizados para representar tabelas, em aplicaes que acessam bancos de dados.
Se voc examinar o diagrama da hierarquia de objetos do Delphi 7, ver que todas as classes usadas na
definio de componentes so classes derivadas, direta ou indiretamente, da classe TPersistent, definida
na unit Classes.
A classe TPersistent incorpora a funcionalidade bsica a todas as classes cujas instncias devem ser capazes
de ler e armazenar suas caractersticas em um meio auxiliar de armazenamento, que pode ser a memria
RAM ou um disco magntico. Na realidade, os mtodos fornecidos por essa classe so todos virtuais ou
dinmicos, podendo portanto ser sobrecarregados nas classes dela derivadas por herana, de forma a
ampliar a sua funcionalidade.
Alm dos componentes propriamente ditos, todas as classes cujos objetos precisam incorporar o conceito
de persistncia so derivadas diretamente da classe TPersistent.
Dentre as classes derivadas diretamente da classe TPersistent, podem-se destacar:
TCanvas: Utilizada para representar uma superfcie de desenho, incorporando boa parte da
funcionalidade presente na GDI (Graphical Device Interface) do Windows.
TClipboard: Utilizada para representar a rea de transferncia do Windows.
TStrings: Definida como classe-base de muitas outras classes destinadas manipulao de listas
de strings.
A classe TComponent, derivada diretamente da classe TPersistent, tambm uma classe-base de todos
os componentes definidos na linguagem Object Pascal, e implementa algumas caractersticas e
funcionalidades comuns a todos os componentes, como por exemplo:
Exibir uma imagem na paleta de componentes do ambiente de desenvolvimento integrado
do Delphi 7.
Exibir o componente em um formulrio.
Incorporar e gerenciar outros componentes. Nesse caso, diz-se que esse componente o
proprietrio dos componentes nele inseridos.
Dessa maneira, todos os componentes so derivados diretamente ou indiretamente da classe
TComponent. Dentre as classes derivadas diretamente de TComponent, podem-se destacar:
TApplication: Essa classe permite a definio de instncias que representam uma aplicao.
TBatchMove: Os objetos dessa classe so usados para efetuar transferncia de registros entre tabelas.
TCommomDialog: Usada como classe-base de todas as classes usadas na representao das
caixas de dilogo padres do Windows.
TDataSet: Usada como classe-base para todas as classes destinadas a acessar as tabelas de um
banco de dados.
TMenu: Usada para definir o menu principal de uma aplicao.
Uma caracterstica comum a essas classes o fato de que os componentes por elas representados no
so visveis durante a execuo do aplicativo. O componente SQLDataset (derivado da classe TDataset),
por exemplo, pode ser manipulado durante a fase de projeto de uma aplicao, mas no exibido
durante a execuo do aplicativo.
Analisando-se novamente o diagrama de hierarquia de objetos do Delphi 7, pode-se verificar que
todos os componentes que apresentam esse tipo de componente so derivados de TComponent, mas
no possuem a classe TControl como uma das suas classes-base.
Dessa maneira, pode-se concluir: Componentes cujas instncias no devem ser visualizadas durante
a execuo do aplicativo devem ser representados por classes derivadas direta ou indiretamente da
classe TComponent, mas no devem ser derivadas da classe TControl.
Por ltimo, pode-se verificar a partir do diagrama de hierarquia de objetos do Delphi 7 que existe ainda
uma classe chamada TControl, derivada de TComponent, da qual so derivadas muitas outras classes
que representam os principais componentes de construo da interface.
A principal caracterstica dessa classe reside na incorporao da funcionalidade necessria para que os
objetos das classes dela derivadas por herana possam ser visualizados durante a execuo do aplicativo.
Dessa maneira, pode-se concluir: Componentes cujas instncias devem ser visualizadas durante a
execuo do aplicativo devem ser representados por classes derivadas da classe TControl.
A classe TControl, por sua vez, possui duas subclasses principais, denominadas TGraphicControl e
TwinControl.
A classe TGraphicControl utilizada como classe-base para as classes que representam componentes
que devem exibir texto e grfico, mas que no devem receber o foco da aplicao durante a sua execuo,
isto , componentes que no so selecionados quando se pressiona seguidamente a tecla Tab, nem
podem conter outros componentes.
A classe TwinControl (definida como sinnimo da classe TWidget na CLX), por sua vez, utilizada
como classe-base para as classes que representam componentes que devem ter as seguintes caractersticas:
So capazes de receber o foco da aplicao durante a sua execuo.
Podem conter outros controles.
Possuem um handle que os identifica.
EXIBINDO UMA PROPRIEDADE NO OBJECT INSPECTOR
No captulo anterior foi apresentado o conceito de propriedade, definida como sendo um meio de
comunicao entre um campo interno e privado da classe e o cdigo que utiliza um objeto dessa classe.
Normalmente, para que uma propriedade possa ser acessada pelo cdigo da aplicao, esta deve ser
definida na seo public de uma classe.
No caso de um componente, para que uma propriedade possa ter o seu valor visualizado e alterado no
Object Inspector, voc deve defini-la na seo published da classe que representa o componente, seo
esta que no havia sido abordada at o momento, e ser visto em maiores detalhes no captulo referente
criao de componentes.
O SISTEMA DE MENSAGENS DO WINDOWS
Conforme descrito anteriormente, um componente deve ser capaz de responder a determinadas
mensagens do Windows, o que normalmente feito definindo-se procedimentos associados a um
evento que tenha sido configurado para responder a essa mensagem.
O Delphi 7 define uma srie de constantes numricas, relacionadas na unit messages.pas, que identificam
as diversas mensagens que podem ser enviadas a um componente pelo sistema operacional.
A Mensagem WM_Paint do Windows, por exemplo, codificada da seguinte maneira pela VCL do
Delphi 7:
WM_PAINT = $000F;
As principais mensagens relacionadas com o pressionamento de teclas e movimentao do mouse
para aplicaes desenvolvidas em Delphi 7 com a VCL so codificadas como mostrado a seguir:
WM_MOUSEFIRST = $0200;
WM_MOUSEMOVE = $0200;
WM_LBUTTONDOWN = $0201;
WM_LBUTTONUP = $0202;
WM_LBUTTONDBLCLK = $0203;
WM_RBUTTONDOWN = $0204;
WM_RBUTTONUP = $0205;
WM_RBUTTONDBLCLK = $0206;
WM_MBUTTONDOWN = $0207;
WM_MBUTTONUP = $0208;
WM_MBUTTONDBLCLK = $0209;
WM_MOUSEWHEEL = $020A;
WM_MOUSELAST = $020A;
No caso do Windows, para definir em uma classe um mtodo que responda a uma mensagem do
sistema operacional, basta codific-lo com a seguinte sintaxe:
Procedure <cdigo_mensagem_sem_undescore>(var Nome_Parmetro: TMessage);message
<cdigo_da_mensagem>;
Onde:
< cdigo_mensagem_sem_undescore> exatamente isso: o cdigo da mensagem sem o
undescore. Conseqentemente, se quisermos definir um mtodo que responda mensagem
WM_PAINT, ele ser denominado WMPaint.
Nome_Parmetro o nome de um parmetro passado por referncia, e de um tipo definido
como um registro que identifica a mensagem a ser manipulada, e definida na unit Messages.
Message uma palavra reservada utilizada para identificar que esse procedimento ser executado
em resposta a uma mensagem do sistema operacional.
<cdigo_da_mensagem> o cdigo da mensagem propriamente dita.
Para responder a uma mensagem WM_PAINT, por exemplo, um componente deve definir um mtodo
chamado WMPaint, que apresenta o seguinte cabealho:
procedure WMPaint(var Message: TWMPaint); message WM_PAINT;
As classes TWinControl e TGraphicControl, por exemplo, implementam esse mtodo, embora o faam
de maneira diferente, como mostram os trechos de cdigo que implementam esses mtodos,
reproduzidos a seguir.
procedure TWinControl.WMPaint(var Message: TWMPaint);
var
DC, MemDC: HDC;
MemBitmap, OldBitmap: HBITMAP;
PS: TPaintStruct;
begin
if not FDoubleBuffered or (Message.DC <> 0) then
if ControlCount = 0 then inherited else PaintHandler(Message)
else
begin
DC:= GetDC(0);
MemBitmap:= CreateCompatibleBitmap(DC, ClientRect.Right, ClientRect.Bottom);
ReleaseDC(0, DC);
MemDC:= CreateCompatibleDC(0);
OldBitmap:= SelectObject(MemDC, MemBitmap);
try
DC:= BeginPaint(Handle, PS);
Perform(WM_ERASEBKGND, MemDC, MemDC);
Message.DC:= MemDC;
WMPaint(Message);
Message.DC:= 0;
BitBlt(DC, 0, 0, ClientRect.Right, ClientRect.Bottom, MemDC, 0, 0, SRCCOPY);
EndPaint(Handle, PS);
finally
SelectObject(MemDC, OldBitmap);
DeleteDC(MemDC);
DeleteObject(MemBitmap);
end;
end;
end;
procedure TGraphicControl.WMPaint(var Message: TWMPaint);
begin
if Message.DC <> 0 then
begin
Canvas.Lock;
try
Canvas.Handle:= Message.DC;
try
Paint;
finally
Canvas.Handle:= 0;
end;
finally
Canvas.Unlock;
end;
end;
end;
Alguns exemplos de tipos definidos como registro (tipo composto) na unit Messages so apresentados
a seguir.
Para representar mensagens geradas pelo pressionamento de uma tecla:
TWMKey = record
Msg: Cardinal;
CharCode: Word;
Unused: Word;
KeyData: Longint;
Result: Longint;
end;
Para representar mensagens geradas pelo mouse:
TWMMouse = record
Msg: Cardinal;
Keys: Longint;
case Integer of
0: (
XPos: Smallint;
YPos: Smallint);
1: (
Pos: TSmallPoint;
Result: Longint);
end;
Para representar a mensagem WM_Paint:
TWMPaint = record
Msg: Cardinal;
DC: HDC;
Unused: Longint;
Result: Longint;
end;
Algumas mensagens especficas so representadas como um alias (nome alternativo) para os registros
descritos anteriormente, como exemplificado a seguir:
TWMLButtonDblClk = TWMMouse;
TWMLButtonDown = TWMMouse;
TWMLButtonUp = TWMMouse;
TWMMButtonDblClk = TWMMouse;
TWMMButtonDown = TWMMouse;
TWMMButtonUp = TWMMouse;
TWMMouseMove = TWMMouse;
TWMRButtonDblClk = TWMMouse;
TWMRButtonDown = TWMMouse;
TWMRButtonUp = TWMMouse;
TWMChar = TWMKey;
TWMKeyDown = TWMKey;
TWMKeyUp = TWMKey;
TWMSysChar = TWMKey;
TWMSysKeyDown = TWMKey;
TWMSysKeyUp = TWMKey;
No discutiremos neste livro a codificao desses mtodos, que executam diversas funes da API do
Windows. O objetivo desse tpico mostrar como so implementados os mtodos que respondem a
mensagens do sistema operacional.
Repare que, como a classe TGraphicControl j implementa o mtodo Paint, tenta execut-lo a partir
do procedimento definido como resposta mensagem WM_PAINT, o que no ocorre no caso do mesmo
mtodo para a classe TWinControl, que no implementa o mtodo Paint.
Entretanto, a classe TCustomControl, derivada da classe TWinControl e que implementa o mtodo
Paint, define seu procedimento WMPaint da maneira descrita a seguir:
procedure TCustomControl.WMPaint(var Message: TWMPaint);
begin
PaintHandler(Message);
end;
Esse mtodo executa o mtodo PaintHandler, definido na classe-base, e que por sua vez executa o
mtodo PaintWindow, que na classe TCustomControl implementado da seguinte forma:
procedure TCustomControl.PaintWindow(DC: HDC);
begin
FCanvas.Lock;
try
FCanvas.Handle:= DC;
try
Paint;
finally
FCanvas.Handle:= 0;
end;
finally
FCanvas.Unlock;
end;
end;
Repare que esse mtodo chama o mtodo Paint.
O importante neste ponto compreender que:
Para responder mensagem WM_PAINT do Windows, uma classe deve implementar o mtodo
WMPaint da maneira descrita anteriormente.
Se uma classe implementa o mtodo Paint, este deve ser chamado a partir do seu mtodo
WMPaint, ou por qualquer mtodo chamado a partir deste.
A CLASSE TCANVAS
Muitos componentes (como os representados pela classe TGraphicControl ou de classes dela derivadas
por herana) tm um campo interno chamado FCanvas, e uma propriedade chamada Canvas, da
classe TCanvas, que representa a superfcie de desenho do componente.
Neste tpico apresentaremos algumas propriedades e mtodos da classe TCanvas, fundamentais
compreenso dos procedimentos envolvidos na criao de componentes.
Para o Windows, qualquer rea a ser manipulada na tela (ou na impressora) tratada como uma
superfcie de desenho.
Para simplificar a vida do programador, o Delphi 7 possui uma classe, denominada TCanvas, que representa
uma superfcie de desenho retangular sobre a qual podero ser feitos desenhos, exibidos textos, etc.
Em um Canvas existe um sistema de coordenadas cartesianas em que a origem est situada no canto
superior esquerdo, as abscissas crescem da esquerda para a direita e as ordenadas de cima para baixo
(ao contrrio do sistema cartesiano convencional).
Conforme ser visto posteriormente, no captulo referente programao grfica, existem funes da
GDI do Windows que permitem que se altere a orientao de eixos do Canvas, bem como o
posicionamento da origem desse sistema.
A figura a seguir apresenta a orientao de eixos em um Canvas, conforme descrito anteriormente.
Figura 20.1: Sistema de coordenadas da tela.
0
X
Y
Guarde bem este conceito: um canvas um objeto da classe TCanvas, que define uma regio retangular
da tela, e que possui, entre seus mtodos, as principais funes da GDI do Windows.
O desenho de linhas em um Canvas feito usando uma caneta imaginria, que na realidade um
objeto da classe TPen (outra classe definida pelo Delphi 7), e o preenchimento de superfcies feito
usando-se um pincel imaginrio, que na realidade um objeto da classe TBrush. Dentre as principais
propriedades de um objeto da classe TPen a caneta imaginria destacam-se aquelas que definem a
sua espessura, a sua cor, modo e estilo de desenho. Para um objeto da classe TBrush, suas principais
propriedades so aquelas que definem a sua cor e estilo.
PRINCIPAIS PROPRIEDADES DA CLASSE TCANVAS
Dentre as principais propriedades da classe TCanvas, destacam-se:
Brush
A propriedade Brush de um objeto da classe TCanvas , na realidade, um objeto da classe TBrush, e define
as caractersticas do pincel utilizado no preenchimento de superfcies como retngulos e elipses, por exemplo.
CanvasOrientation
Essa propriedade, apenas de leitura, uma varivel do tipo Tcanvas e pode assumir um dos seguintes
valores:
coLeftToRight: Orientao da esquerda para a direita.
coRightToLeft: Orientao da direita para a esquerda.
ClipRect
Essa propriedade um objeto da classe TRect, e permite restringir a rea de desenho a uma poro
retangular do Canvas.
CopyMode
Essa propriedade definida como uma varivel inteira, e define como imagens grficas devem ser
desenhadas no Canvas: Uma relao dos valores possveis e seus efeitos ser apresentada no captulo
de programao grfica.
Font
Essa propriedade um objeto da classe TFont, e define a fonte utilizada na exibio de textos no
Canvas.
Handle
Essa propriedade retorna o handle do Canvas, e utilizada apenas quando se precisa utilizar funes
grficas da GDI do Windows que no foram incorporadas pela VCL do Delphi 7 ou pela CLX como
mtodos da classe TCanvas.
LockCount
Essa propriedade definida como uma varivel inteira, e define quantas vezes o canvas foi protegido
contra a interveno de outras threads, mediante chamadas ao seu mtodo Lock.
Pen
A propriedade Pen de um objeto da classe TCanvas , na realidade, um objeto da classe TPen, e define
as caractersticas da caneta utilizada no desenho de linhas e do contorno de figuras como retngulos e
elipses, por exemplo.
PenPos
Essa propriedade uma varivel do tipo TPoint, e define a posio atual da caneta no Canvas. Atribuir
um valor propriedade PenPos equivale a executar o mtodo MoveTo do Canvas.
Pixels [x,y]
Essa propriedade define a cor do pixel situado nas coordenadas (x,y) do Canvas.
TextFlags
Essa propriedade definida como uma varivel inteira, e define como um texto deve ser desenhado
no Canvas. Uma relao dos valores possveis e seus efeitos ser apresentada no captulo de
programao grfica.
PRINCIPAIS MTODOS DA CLASSE TCANVAS
Dentre os principais mtodos da classe TCanvas, destacam-se:
Arc
Declarao
procedure Arc(X1, Y1, X2, Y2, X3, Y3, X4, Y4: Integer);
Esse mtodo desenha na superfcie do Canvas um arco coincidente com o permetro da elipse cujo
retngulo circunscrito definido pelos pontos (X1,Y1) e (X2,Y2). O arco comea no ponto de interseo
desse retngulo com a linha que une o centro da elipse ao ponto (X3,Y3) e segue no sentido anti-horrio
at o ponto de interseo desse retngulo com a linha que une o centro da elipse ao ponto (X4,Y4).
BrushCopy
Declarao
procedure BrushCopy(const Dest: TRect; Bitmap: TBitmap; const Source: TRect; Color: TColor);
Esse mtodo copia uma poro retangular de um bitmap (Source) para uma rea retangular do canvas
(Dest), substituindo uma das cores do bitmap (Color) pela definida para a propriedade Brush do canvas.
Chord
Declarao
procedure Chord(X1, Y1, X2, Y2, X3, Y3, X4, Y4: Integer);
Esse mtodo desenha uma curva fechada, definida pela interseo entre uma linha e uma elipse. A
Elipse definida pelos dois primeiros pontos e a linha, pelos dois ltimos.
CopyRect
Declarao
procedure CopyRect(Dest: TRect; Canvas: TCanvas; Source: TRect);
Esse mtodo copia uma rea retangular de um Canvas para outra rea retangular do Canvas corrente
(que executa o mtodo).
Draw
Declarao
procedure Draw(X, Y: Integer; Graphic: TGraphic);
Esse mtodo copia uma imagem grfica (que pode ser um cone, um bitmap ou um metafile) para o
Canvas corrente, sendo a extremidade superior esquerda da imagem colocada no ponto de coordenadas
X e Y (passadas como parmetros).
DrawFocusRect
Declarao
procedure DrawFocusRect(const Rect: TRect);
Esse mtodo desenha um retngulo no Canvas, com o estilo comumente usado para indicar que o
componente recebeu o foco da aplicao.
Ellipse
Declarao
procedure Ellipse(X1, Y1, X2, Y2: Integer); overload;
procedure Ellipse(const Rect: TRect); overload;
Esse mtodo desenha no Canvas uma elipse cujo retngulo circunscrito definido pelos pontos (X1,Y1)
e (X2,Y2) ou por uma rea retngular (Rect). Para desenhar um crculo, basta que o retngulo circunscrito
seja um quadrado, isto , (Y2 - Y1) deve ser igual a (X2 - X1). Repare que este mtodo um mtodo
sobrecarregado.
FillRect
Declarao
Esse mtodo preenche uma rea retangular do Canvas (passada como parmetro) com o pincel
(brush) corrente.
LineTo
Declarao
procedure LineTo(X, Y: Integer);
Esse mtodo desenha no Canvas uma linha que comea na posio atual da caneta imaginria e termina
na posio definida pelas coordenadas (X,Y), que passa a ser a posio atual da caneta imaginria.
Lock
Declarao
procedure Lock;
Esse mtodo impede que outras threads desenhem sobre o Canvas.
MoveTo
Declarao
procedure MoveTo(X, Y: Integer);
Esse mtodo move a caneta imaginria para a posio do Canvas definida pelas coordenadas (X,Y).
PolyBezier
Declarao
procedure PolyBezier(const Points: array of TPoint);
Esse mtodo desenha uma curva de Bezier, com base no conjunto de pontos fornecido como parmetro.
Pie (X1, Y1, X2, Y2)
Declarao
procedure Pie(X1, Y1, X2, Y2, X3, Y3, X4, Y4: Longint);
Esse mtodo desenha no Canvas um setor elptico cujo retngulo circunscrito definido pelos pontos
(X1,Y1) e (X2,Y2), preenchendo-o com o pincel definido na propriedade Brush do Canvas.
Polygon
Declarao
procedure Polygon(Points: array of TPoint);
Esse mtodo desenha no Canvas um polgono fechado usando a caneta imaginria definida na propriedade
Pen do Canvas e preenchendo-o com o pincel imaginrio definido pela propriedade Brush do Canvas.
Polyline
Declarao
procedure Polyline(Points: array of TPoint);
Esse mtodo desenha uma poligonal aberta unindo os pontos que compem o array passado como
parmetro. Para desenhar uma poligonal fechada, basta que as coordenadas do primeiro e do ltimo
ponto do array sejam coincidentes.
Rectangle
Declarao
procedure Rectangle(X1, Y1, X2, Y2: Integer); overload;
procedure Rectangle(const Rect: TRect); overload;
Esse mtodo desenha no Canvas um retngulo definido pelos pontos (X1,Y1) e (X2,Y2), ou por uma
varivel do tipo Trect (repare que este um mtodo sobrecarregado) preenchendo-o com o pincel
definido na propriedade Brush do Canvas.
RoundRect
Declarao
procedure RoundRect(X1, Y1, X2, Y2, X3, Y3: Integer);
Esse mtodo desenha no Canvas um retngulo de cantos arredondados definido pelos pontos (X1,Y1)
e (X2,Y2), sendo os cantos concordados por uma elipse de eixos iguais a X3 e Y3.
StretchDraw
Declarao
procedure StretchDraw(const Rect: TRect; Graphic: TGraphic );
Esse mtodo copia, na rea retangular definida pelo parmetro Rect do canvas corrente, uma imagem
definida pelo parmetro Graphic.
TextExtent
Declarao
function TextExtent(const Text: string): TSize;
Esse mtodo retorna, nos campos cx e cy de uma varivel do tipo TSize, as dimenses (largura e altura,
em pixels) que uma string ocupa ao ser desenhada no canvas corrente.
TextHeight
Declarao
function TextHeight(const Text: string): Integer;
Esse mtodo retorna a altura, em pixels, que a string passada como parmetro ocupa no Canvas.
TextOut
Declarao
procedure TextOut(X, Y: Integer; const Text: string);
Esse mtodo exibe no Canvas uma string definida pelo parmetro Texto, na posio definida pelas
coordenadas (X,Y). Essas coordenadas definem o vrtice superior esquerdo do retngulo circunscrito
ao texto, usando a fonte corrente do Canvas (definida pela sua propriedade Font).
TextWidth
Declarao
function TextWidth(const Text: string): Integer;
Esse mtodo retorna a largura, em pixels, que a string definida pelo parmetro Texto ocupa no Canvas.
Unlock
Declarao
procedure Unlock;
Esse mtodo permite que outras threads desenhem sobre o Canvas. Deve ser chamado sempre que outras
threads houvessem sido impedidas de desenhar no Canvas aps uma chamada do mtodo Lock.
Apresentam-se a seguir as principais propriedades da classe TPen.
PRINCIPAIS PROPRIEDADES DA CLASSE TPEN
Dentre as principais propriedades da classe TPen, destacam-se:
Color
Essa propriedade um objeto da classe TColor, e define a cor atual da caneta imaginria. Voc pode
usar uma das constantes predefinidas do Delphi 7 (clBlack, clWhite, clBlue, clYellow, etc.).
Style
Essa propriedade define como a linha ser desenhada, e pode assumir um dos valores apresentados a seguir.
Valor Significado
psSolid Desenha uma linha slida.
psDash Desenha uma linha tracejada.
psDot Desenha uma linha pontilhada.
continua
Mode
Essa propriedade define como a cor atual da caneta interage com a cor corrente do Canvas, e pode
assumir um dos valores apresentados a seguir:
pmBlack: A linha desenhada na cor preta, independente da cor existente no Canvas.
pmWhite: A linha desenhada na cor branca, independente da cor existente no Canvas.
pmNop: A cor atual do canvas permanece inalterada. A caneta se comporta de forma
transparente.
pmNot: A cor utilizada pela caneta ser a inversa da presente no Canvas.
pmCopy: A caneta desenha linhas com a cor especificada na sua propriedade Color.
pmNotCopy: A caneta desenha linhas com a cor especificada na sua propriedade Color.
pmMergePenNot: A caneta desenha linhas com a cor resultante da combinao entre a cor da
propriedade Color da caneta e a inversa da presente no Canvas.
pmMaskPenNot: A caneta desenha linhas com a cor resultante da combinao das cores comuns
entre a cor da propriedade Color da caneta e a inversa da presente no Canvas.
pmMergeNotPen: A caneta desenha linhas com a cor resultante da combinao entre a cor
inversa da propriedade Color da caneta e a cor presente no Canvas.
pmMaskNotPen: A caneta desenha linhas com a cor resultante da combinao entre a cor
inversa da definida pela propriedade Color da caneta e a da cor de fundo do Canvas.
pmMerge: A caneta desenha linhas com a cor resultante da combinao entre a cor definida
pela propriedade Color da caneta e a da cor de fundo do Canvas.
pmNotMerge: Cor inversa da definida com pmMerge.
pmMask: A caneta desenha linhas com a cor resultante da combinao entre a cor definida
pela propriedade Color da caneta e a da cor de fundo do Canvas.
PmNotMask: Cor inversa da definida com pmMask.
PmXor: A caneta desenha linhas com a cor resultante da combinao entre as cores presentes
na propriedade Color da caneta e na cor de fundo do Canvas, mas no em ambas.
PmNotXor: Cor inversa da definida com pmXor.
Valor Significado
psDashDot Desenha uma linha no estilo trao-ponto.
psDashDotDot Desenha uma linha no estilo trao-dois pontos.
psClear Desenha uma linha invisvel.
psInsideFrame Desenha uma linha slida, mas cuja cor pode sofrer leves variaes,
quando sua propriedade width tiver valor maior do que 1.
Width
Essa propriedade armazena um valor inteiro que define a espessura da linha desenhada pela caneta imaginria.
Apresentam-se a seguir as principais propriedades da classe TBrush.
PRINCIPAIS PROPRIEDADES DA CLASSE TBRUSH
Dentre as principais propriedades da classe TBrush, destacam-se:
Bitmap
Essa propriedade permite que se defina um bitmap de 8 x 8 pixels como padro de preenchimento do
pincel imaginrio. Se for atribudo um bitmap de dimenses maiores, apenas a regio de 8 x 8 pixels
situada no canto superior esquerdo do bitmap ser considerada.
Color
Essa propriedade um objeto da classe TColor, e define a cor atual do pincel imaginrio.
Style
Essa propriedade define o estilo de preenchimento do pincel imaginrio, com os seguintes valores:
TValor Significado
bsSolid Preenchimento Total (Slido)
bsClear Transparente
bsBDiagonal Hachura em diagonal, com inclinao ////
bsFDiagonal Hachura em diagonal, com inclinao \\\\
bsCross Hachuras Ortogonais cruzadas
bsDiagCross Hachuras Diagonais cruzadas
bsHorizontal Hachuras Horizontais
bsVertical Hachuras Verticais
O COMPONENTE SHAPE
O componente Shape, situado na pgina Additional da paleta de componentes, utilizado para desenhar
formas geomtricas em um formulrio ou outro componente que permita a incluso de outros
componentes em seu interior (como um Panel, por exemplo), e, diferentemente de outros componentes,
permite que suas propriedades Brush e Pen sejam definidas durante o projeto da aplicao alterando os
seus valores diretamente no Object Inspector.
A ttulo de ilustrao, apresentamos a seguir a definio da classe TShape e a implementao do seu
mtodo Paint, extrados do arquivo ExtCtrls.pas:
TShape = class(TGraphicControl)
private
FPen: TPen;
FBrush: TBrush;
FShape: TShapeType;
procedure SetBrush(Value: TBrush);
procedure SetPen(Value: TPen);
procedure SetShape(Value: TShapeType);
protected
procedure Paint; override;
public
constructor Create(AOwner: TComponent); override;
published
procedure StyleChanged(Sender: TObject);
property Align;
property Brush: TBrush read FBrush write SetBrush;
property DragCursor;
property DragMode;
property Enabled;
property ParentShowHint;
property Pen: TPen read FPen write SetPen;
property Shape: TShapeType read FShape write SetShape default stRectangle;
property ShowHint;
property Visible;
property OnDragDrop;
property OnDragOver;
property OnEndDrag;
property OnMouseDown;
property OnMouseMove;
property OnMouseUp;
property OnStartDrag;
end;
Observe que essa classe herda o campo interno FCanvas e a propriedade Canvas da sua classe-base,
TGraphicControl.
procedure TShape.Paint;
var
X, Y, W, H, S: Integer;
begin
with Canvas do
begin
Pen := FPen;
Brush := FBrush;
X := Pen.Width div 2;
Y := X;
W := Width - Pen.Width + 1;
H := Height - Pen.Width + 1;
if Pen.Width = 0 then
begin
Dec(W);
Dec(H);
end;
if W < H then S := W else S := H;
if FShape in [stSquare, stRoundSquare, stCircle] then
begin
Inc(X, (W - S) div 2);
Inc(Y, (H - S) div 2);
W := S;
H := S;
end;
case FShape of
stRectangle, stSquare:
Rectangle(X, Y, X + W, Y + H);
stRoundRect, stRoundSquare:
RoundRect(X, Y, X + W, Y + H, S div 4, S div 4);
stCircle, stEllipse:
Ellipse(X, Y, X + W, Y + H);
end;
end;
end;
Conforme descrito anteriormente, o mtodo Paint de um componente executado sempre que o mesmo
precisa ser redesenhado em um formulrio. Repare que, no mtodo Paint do componente Shape, so
feitas vrias chamadas a mtodos da sua propriedade Canvas (que um objeto da classe TCanvas).
Repare ainda que no mtodo Paint do componente Shape, os valores das propriedades Brush e Pen do
Canvas so definidos como sendo iguais aos definidos nos campos FBrush e FPen, que so na realidade
objetos da classe TBrush e TPen, e que armazenam internamente os valores definidos pelas propriedades
Brush e Pen, respectivamente.
Existem componentes, no entanto, que no permitem que se acessem suas propriedades Brush e Pen
na fase de projeto, mas apenas durante a execuo do aplicativo.
Esses componentes, no entanto, como aqueles representados pelas classes TPaintBox, TImage e TPrinter,
possuem um evento chamado OnPaint, para o qual podemos definir um procedimento associado, e
nesse procedimento definir o cdigo referente a qualquer desenho a ser feito no seu Canvas.
Para que um desenho seja permanentemente visualizado em um formulrio ou componente, o cdigo
que o define deve ser digitado no procedimento associado ao evento OnPaint do formulrio ou
componente. Se esse cdigo no for includo no evento OnPaint e a regio do formulrio ou componente
que exibe o desenho for sobreposta por outra janela, este no ser restaurado na tela quando a regio
correspondente se tornar visvel novamente.
CAPTULO 21 CRIAO DE COMPONENTES
Captulo
Criao de Componentes
21
O amplo conjunto de usurios do Delphi pode ser subdividido em dois grandes grupos: um grupo de
desenvolvedores de aplicaes e um grupo de desenvolvedores de componentes e ferramentas, que
tm por objetivo ampliar as caractersticas e funcionalidades j disponveis no ambiente de
desenvolvimento do Borland Delphi.
Neste captulo sero apresentados os procedimentos necessrios criao de componentes com o Borland
Delphi, o que pode ser feito sem que seja necessria a utilizao de qualquer ferramenta adicional, pois
os novos componentes podem ser criados usando-se a prpria linguagem Object Pascal.
Alm disso, conforme ser descrito posteriormente, os componentes desenvolvidos em Object Pascal
podem ser transformados em controles ActiveX e utilizados em outros ambientes de desenvolvimento
que suportam essa tecnologia.
Conforme ser mostrado nos tpicos subseqentes, voc pode criar um componente inteiramente
original ou partir de um componente j existente, usando o conceito de herana da linguagem Object
Pascal. Nesse caso, voc poder adicionar novas caractersticas ao componente ancestral ou redefinir
algumas de suas funcionalidades.
KNOW-HOW EM: CRIAO DE COMPONENTES
PR-REQUISITOS
Fundamentos da programao orientada a objetos com o Delphi 5.
Experincia prvia na utilizao de componentes no desenvolvimento de aplicaes com Delphi.
METODOLOGIA
Apresentao do problema: Utilizao dos conceitos de herana e polimorfismo na criao de novos componentes.
TCNICA
Apresentao dos procedimentos necessrios criao de novos componentes.
Ao longo dos ltimos captulos, voc trabalhou intensamente com componentes, selecionando-os nas
diversas pginas da paleta de componentes, inserindo-os em formulrios e alterando algumas das suas
propriedades diretamente no Object Inspector.
Esses componentes so, na verdade, objetos de classes previamente definidas na Visual Component
Library VCL (a biblioteca de componentes do Delphi). O que diferencia um componente de uma
classe comum justamente o fato de que os componentes podem ser manipulados na fase de projeto
do aplicativo, ao passo que as classes comuns s podem ser manipuladas via cdigo.
Existem situaes, no entanto, em que precisamos adaptar um componente j existente de forma a
adequ-lo s nossas necessidades.
Considere, por exemplo, que nossas aplicaes utilizem constantemente caixas de texto (componentes
da classe TEdit) nas quais devem ser digitados apenas nmeros inteiros.
Existe uma soluo natural, e que consiste em codificar adequadamente os procedimentos associados
aos principais eventos desse componente.
Poderamos, por exemplo, inserir em um formulrio um componente caixa de texto e definir da seguinte
maneira os procedimentos associados aos seus principais eventos:
procedure TFormNumerico.EditNumeroInteiroChange(Sender: TObject);
var
indice : word;
posinal : string;
begin
indice := Pos(-,TEdit(Sender).text);
if indice > 1
then
begin
posinal := TEdit(Sender).Text;
Delete(posinal, indice, 1);
TEdit(Sender).Text := -+posinal;
end;
indice := Pos(+,TEdit(Sender).text);
if indice > 1
then
begin
TEdit(Sender).Text := ++posinal;
end;
end;
procedure TFormNumerico.EditNumeroInteiroKeyPress(Sender: TObject;
var Key: Char);
begin
if (not (key in [0..9',-,+,#8]))or((key in [+,-]) and
(Pos(key,TEdit(Sender).text)>0))
then key := #0;
end;
O procedimento associado ao evento OnKeyPress do componente verifica se a tecla pressionada pelo
usurio corresponde a um dos caracteres vlidos, que so os dgitos (0 a 9) e os sinais + e -.
Como a tecla pressionada passada para o procedimento associado ao evento pelo parmetro Key,
basta verificar se a tecla representada por esse parmetro pertence ao conjunto de valores permitidos,
o que feito nas linhas de cdigo reproduzidas a seguir.
if (not (key in [0..9',-,+,#8]))or((key in [+,-]) and
(Pos(key,TEdit(Sender).text)>0))
then key := #0;
Essa linha de cdigo verifica se a tecla representada pelo parmetro Key pertence ao conjunto de
valores permitidos e, caso essa condio no seja satisfeita, anula a entrada fornecida pelo usurio.
Portanto, caso a tecla seja invlida, atribui-se o valor #0 ao parmetro Key, anulando-se a ao do
usurio (isso possvel, pois o parmetro Key passado por referncia, como indica o modificador var
includo na relao de parmetros do procedimento).
Repare que, no caso das teclas + e -, deve-se ainda verificar se o caractere correspondente j existe
na propriedade Text do componente, o que feito verificando-se o valor retornado pela funo Pos
(que retorna a posio de um conjunto de caracteres em uma string) no procedimento associado ao
evento OnChange do componente. Se essa funo retornar um valor positivo, indica que o sinal j est
includo na string representada pela propriedade Text do componente.
O procedimento associado ao evento OnChange do componente verifica se existe um caractere +ou
- na sua propriedade Text, e, em caso positivo, verifica se a mesma foi inserida no meio da string. Em
caso positivo, a remove da posio corrente da string e a recoloca no seu incio, o que feito no
seguinte trecho de cdigo:
Para o caractere -:
indice := Pos(-,TEdit(Sender).text);
if indice > 1
then
begin
TEdit(Sender).Text := -+posinal;
end;
Para o caractere +:
indice := Pos(+,TEdit(Sender).text);
if indice > 1
then
begin
TEdit(Sender).Text := ++posinal;
end;
indice e posinal so variveis locais ao procedimento.
Evidentemente, se nossa aplicao utilizar muitos componentes caixas de texto com essas caractersticas,
ou se muitas aplicaes necessitarem dessa funcionalidade, ser mais adequado criar um novo
componente capaz de incorporar essas funcionalidades, ou criar um template para este componente.
Nos prximos tpicos sero apresentados os procedimentos necessrios criao de templates e
criao desse componente, que neste ser representado por uma classe derivada da classe TEdit, e que
ser denominada TNumEdit.
CRIANDO O ESQUELETO DO NOVO COMPONENTE
Para criar o novo componente, voc deve executar os seguintes procedimentos:
1. Selecione o item New Component do menu Component, para exibir a caixa de dilogo New
Component, mostrada na Figura 21.1.
Nessa caixa de dilogo devero ser especificados:
O nome da classe-base (Ancestor Type), da qual o novo componente ser derivado por herana.
Nesse caso, estaremos criando um novo componente cujas definies sero armazenadas em
uma classe derivada de TEdit. Logo, a classe TEdit dever ser especificada nesse campo. Repare
que existem duas opes, correspondentes VCL (StdCtrls) e CLX (QStdCtrls), e neste exemplo
ser adotada a primeira opo.
O nome da classe que representar o novo componente (Class Name). Para essa classe, ser
atribudo o nome TNumEdit.
A pgina da paleta de componentes na qual o componente ser inserido (Palette Page). Neste
exemplo, criaremos uma paleta denominada Axcel.
O nome da unit onde ser definida a classe do componente (Unit file name). Usaremos o
Nome NumEdit.Pas, que ser o nome default.
O nome dos diretrios de pesquisa (Search Path).
Figura 21.1: A caixa de dilogo New Component.
2. Selecione o boto Ok para fechar essa caixa de dilogo, criar a unit do componente e exibi-la
no editor de cdigos, como mostrado a seguir.
unit NumEdit;
interface
uses
StdCtrls;
type
TNumEdit = class(TEdit)
private
protected
{ Protected declarations }
public
published
{ Published declarations }
end;
procedure Register;
implementation
procedure Register;
begin
RegisterComponents(AXCEL, [TNumEdit]);
end;
end.
Outra opo seria selecionar o item New do menu File para exibir a caixa de dilogo New Items, o item Component da pgina New dessa
caixa de dilogo e o boto Ok.
Nesse arquivo de cdigo, verifica-se que a nova classe, TNumEdit, ser derivada por herana da classe
TEdit, como mostra o trecho de cdigo a seguir, em que a mesma definida:
type
Repare ainda que foi definido o procedimento Register, e nesse procedimento feita uma chamada a
um outro procedimento, denominado RegisterComponents.
A procedure RegisterComponents recebe como parmetro o nome da pgina da paleta de componentes
na qual os novos componentes sero inseridos (se a pgina indicada no existir, a mesma ser criada),
e um array de componentes.
Voc pode registrar vrios componentes de uma nica vez para uma nica pgina da paleta de
componentes. Nesse caso, o nome de todos os componentes a serem exibidos nessa paleta dever ser
includo nesse array de componentes.
Caso a unit defina mais de um componente, e esses componentes sejam instalados em paletas distintas,
o procedimento Register dever fazer vrias chamadas procedure RegisterComponents.
Embora o procedimento Register possa conter vrias chamadas ao procedimento RegisterComponents, s pode haver um procedimento
Register em cada unit.
DEFINIO DE NOVAS PROPRIEDADES
No captulo referente programao orientada a objetos, vimos que uma classe engloba, em uma
nica entidade, dados (denominados campos) e funes (denominadas mtodos). O mesmo se aplica
aos componentes (que so um tipo especial de classe), mas nesse caso alguns campos podem ter os seus
valores alterados diretamente no Object Inspector, atravs das suas propriedades.
Podemos concluir, portanto, que uma propriedade serve como um meio de comunicao entre um
campo de um componente e o programador, na fase de projeto do aplicativo.
Se considerarmos, por exemplo, um componente Label (da classe TLabel), sabemos que esse componente
tem uma propriedade chamada AutoSize, que pode apresentar o valor True ou False. Na realidade, a
propriedade AutoSize um meio de comunicao entre voc (o programador) e o campo FAutoSize da
classe TLabel. Voc define o valor na propriedade AutoSize, mas na verdade quem armazena esse valor
o campo FAutoSize da classe TLabel.
Se voc observar o cdigo-fonte desses componentes no arquivo StdCtrl.pas, ver que o campo FAutoSize est definido na seo private
da classe TCustomLabel, e a propriedade AutoSize est definida na seo protected dessa mesma classe. Ocorre, no entanto, que a classe
TLabel derivada, por herana, da classe TCustomLabel (e, conseqentemente, herda a sua propriedade AutoSize, atravs da qual
acessar o campo FAutoSize). Alm disso, a classe TLabel redefine a propriedade AutoSize na seo published da classe que representa
o componente, seo esta cuja definio ser vista no tpico a seguir.
Se voc observar o diagrama de hierarquia de classes da VCL, ver que existem diversas classes cujo
nome comea com a palavra TCustom, e que declaram algumas propriedades como protected, tornadas
published em classes delas derivadas por herana.
CRIANDO UMA NOVA PROPRIEDADE
Neste tpico sero apresentados os procedimentos necessrios criao de uma nova propriedade.
Conforme j foi dito anteriormente, o componente NumEdit poder ser usado, opcionalmente, para
permitir apenas a digitao de nmeros inteiros, e isso ser definido mediante a atribuio de um valor
adequado a uma propriedade do componente que chamaremos de Numerico. Essa propriedade ser do
tipo booleana e poder, portanto, receber apenas os valores True e False.
Normalmente, conforme dito no tpico anterior, o valor de uma propriedade armazenado em um
campo privado da classe e, dessa maneira, a propriedade serve apenas como uma interface ou meio de
comunicao entre o campo e o desenvolvedor.
Convencionalmente, os campos internos dos componentes costumam ter o mesmo nome das
propriedades, precedidos pela letra F (de Field). Nesse caso, portanto, se a propriedade ser denominada
Numerico, o campo respectivo poder ser denominado FNumerico (repare que no estamos acentuando
esses nomes, seguindo portanto as mesmas regras estabelecidas para a definio de nomes de variveis).
A criao da propriedade propriamente dita, no entanto, ser feita na seo published da classe do
componente, mediante a incluso de uma linha de cdigo que apresenta a seguinte sintaxe:
property nome_propriedade : tipo read metodo_ leitura write metodo_ escrita;
Como pode ser visto na definio anterior, uma propriedade pode ter um mtodo de leitura e um
mtodo de escrita. Quando se omite o nome do mtodo de escrita, a propriedade do tipo read-only
(apenas de leitura) e seu valor pode ser apenas lido.
Existem situaes, no entanto, que, em vez de se definir um mtodo de leitura e um mtodo de escrita,
coloca-se em seu lugar o nome do campo em que o valor da propriedade ser armazenado. Nesses casos,
diz-se que a propriedade acessa diretamente o valor de um campo, sem que se use qualquer mtodo especfico.
No caso da propriedade Numerico, sua definio ser inicialmente feita mediante a incluso da seguinte
linha de cdigo na seo published da classe:
property Numerico : boolean read FNumerico write FNumerico;
A definio da classe, portanto, passaria a ter a forma apresentada a seguir.
private
FNumerico : boolean;
protected
public
published
end;
No se esquea de incluir, na seo private da classe que representa o componente, a definio do campo que armazenar internamente
o valor da propriedade.
INSTALANDO O NOVO COMPONENTE
Antes de incrementar ainda mais o nosso componente, vamos instal-lo e analisar o funcionamento
da propriedade recm-criada.
Para instalar o componente, selecione o item Install Component do menu Component. Ser exibida a
caixa de dilogo Install Component, apresentada na figura a seguir. Nesse caso, o componente ser
instalado no pacote dclusr.dpk (para instalar o componente em um novo pacote, selecione a guia Into
new package e preencha corretamente seus diversos campos).
Figura 21.2: A caixa de dilogo Install Component.
Aps preencher corretamente as informaes dessa caixa de dilogo, selecione o boto OK. Ser exibida
a caixa de dilogo de confirmao mostrada na figura a seguir.
Figura 21.3: A caixa de dilogo de confirmao.
O componente ser instalado no pacote especificado, como mostra a figura a seguir.
Figura 21.4: Instalando o componente em um pacote.
Durante a instalao sero exibidas algumas mensagens informativas. Basta selecionar o boto Ok dessas caixas de dilogo para dar
prosseguimento ao processo.
Nesse caso, o componente foi inserido no pacote dclusr.dpk, que possui exatamente esta finalidade
armazenar a definio de componentes criados pelo desenvolvedor.
O componente estar instalado e estar disponvel na pgina Axcel da paleta de componentes, como
mostra a figura a seguir.
Figura 21.5: A nova pgina da paleta de componentes.
Caso o componente no tenha sido instalado, selecione os botes Compile e Install na janela Package do pacote correspondente.
Repare que, como no foi definido um bitmap especfico para o componente, o bitmap do seu
componente ancestral foi automaticamente utilizado (nesse caso, o bitmap definido para o componente
TEdit). Posteriormente sero apresentados os procedimentos necessrios definio de um bitmap
para o novo componente.
Se voc colocar o cursor do mouse sobre o bitmap que identifica o componente na paleta, ser exibida
uma string de auxlio com o nome do componente (no caso, NumEdit).
Coloque o componente em um formulrio e verifique que a nova propriedade j est disponvel no
Object Inspector, como mostra a figura a seguir.
Figura 21.6: Visualizando a nova propriedade no Object Inspector.
Repare que o valor default dessa propriedade False. Para alterar esse valor default, voc deve
sobrecarregar o construtor da classe-base e definir o novo valor.
Isso ser feito da maneira descrita no tpico apresentado a seguir.
Evidentemente, a alterao do valor dessa propriedade ainda no provoca nenhum efeito, pois o
componente ainda no foi codificado para reagir a alterao de valores da propriedade Numerico. Nos
prximos tpicos, esses aspectos sero tratados em maiores detalhes.
SOBRECARREGANDO O MTODO CONSTRUTOR DA CLASSE ANCESTRAL DO COMPONENTE
A definio de um novo construtor, sobrecarregando o construtor da sua classe ancestral e utilizando
o conceito de polimorfismo (apresentado no captulo referente programao orientada a objetos),
feita mediante a utilizao do seguinte trecho de cdigo:
type
private
protected
public
constructor Create(AOwner: TComponent);override;
published
end;
A implementao do construtor deve ser feita na seo implementation da unit, como apresentado a seguir:
constructor TNumEdit.Create(AOwner: TComponent);
begin
inherited Create(AOwner);
FNumerico := True;
Text := 0;
end;
Repare que a primeira coisa que o construtor faz chamar o mtodo construtor da classe-base. Em
seguida, define as propriedades Numerico e Text como True e 0, respectivamente (afinal de contas, no
seria lgico que o valor default da propriedade Text desse componente fosse NumEdit1).
Reinstale novamente o componente. Voc ver que agora o valor default da propriedade Numerico
ser igual a True.
Para reinstalar o componente, voc deve executar os seguintes procedimentos:
1. Selecionar o item Install Packages do menu Components. Ser exibida a caixa de dilogo Project
Options, na qual dever ser selecionado o item Borland Delphi User, conforme indicado na
figura a seguir.
Figura 21.7: A caixa de dilogo Project Options.
2. Selecione o boto Edit dessa caixa de dilogo. Ser exibida uma caixa de dilogo solicitando
uma confirmao, e indicando que a caixa de dilogo Project Options ser fechada.
3. Ser exibida a caixa de dilogo do editor de pacotes. Selecione o boto Compile dessa caixa de
dilogo, para recompilar o pacote.
Dessa maneira, a partir desse momento, a propriedade Numerico ter o valor default igual a True e a
proprieade Text o valor 0.
Entretanto, se voc observar a descrio textual de um formulrio aps a incluso desse componente, ver
que a descrio do objeto feita da seguinte maneira (os valores numricos podem variar um pouco):
object NumEdit1: TNumEdit
Left = 208
Top = 168
Width = 121
Height = 21
TabOrder = 0
Text = 0
Numerico = True
End
Para que o valor default da propriedade Numerico do componente TNumEdit no seja armazenado na
descrio textual do formulrio que o contm, torna-se necessrio redefinir a declarao da propriedade
na definio da classe, como mostra o trecho de cdigo a seguir.
property Numerico : boolean read FNumerico write Fnumerico default True;
Repare que definir um valor default para a propriedade (ou campo) diferente de definir um valor
default para a sua descrio textual no formulrio.
A declarao de um valor default para o campo feita no construtor, ao passo que a definio de um
valor default para definir a incluso ou no do valor da propriedade na descrio textual do formulrio
que contm o componente feita na prpria definio da propriedade.
Dessa maneira, se o valor da propriedade Numerico for igual a True, sua definio no ser mais includa
na descrio textual do formulrio.
REDEFININDO MTODOS DA CLASSE-BASE
Nesse componente, como desejamos que o usurio s possa digitar valores numricos inteiros caso a
propriedade Numerico seja igual a True, precisamos redefinir os mtodo KeyPress e Change existentes
na classe-base, a serem implementados como mostrados nos trechos de cdigo apresentados a seguir.
procedure TNumEdit.KeyPress(var Key : Char);
begin
if FNumerico then
begin
if (not (key in [0..9',-,+,#8]))or((key in [+,-]) and (Pos(key,Text)>0))
then key := #0;
end;
inherited KeyPress(Key);
end;
procedure TNumEdit.Change;
var
indice : word;
posinal : string;
valorconvertido : integer;
begin
if FNumerico then
begin
indice := Pos(-,Text);
if indice > 1
then
begin
posinal := Text;
System.Delete(posinal, indice, 1);
Text := -+posinal;
end;
indice := Pos(+,Text);
if indice > 1
then
begin
posinal := Text;
Text := ++posinal;
end;
try
valorconvertido := StrToInt(Text);
except
on EConvertError do
begin
Numerico := False;
end;
end;
end;
inherited Change;
end;
Com a implementao desse mtodo definida dessa maneira, caso o usurio insista em digitar um
caractere invlido no componente na fase de projeto do aplicativo, o valor da propriedade Numerico
ser redefinido como false.
A redefinio da classe por completa apresentada a seguir.
type
private
protected
procedure KeyPress(var Key : Char);override;
procedure Change;override;
public
constructor Create(AOwner: TComponent);override; published
property Numerico : boolean read FNumerico write FNumerico default True;
end;
A partir de ento, se o valor da propriedade Numerico for igual a True, apenas valores numricos
podero ser digitados no componente durante a execuo de um aplicativo que o utilize.
Dessa maneira, a utilizao do componente TNumEdit evita que se tenha de codificar os procedimentos
associados aos eventos OnKeyPress e OnChange para cada caixa de texto, e exatamente este o objetivo
de se criar novos componentes automatizar tarefas realizadas com freqncia no desenvolvimento
dos seus aplicativos.
Alm disso, da forma como foi definido, esse componente ainda pode ser utilizado como uma caixa de
texto comum, bastando para isso que se defina como False o valor da sua propriedade Numerico.
Considere agora a situao em que se prefere dar ao usurio a capacidade de definir o que deve ser feito
caso a converso descrita anteriormente no seja possvel. O que fazer nesse caso? Que tal criarmos um
evento que deve ser disparado quando isso ocorrer, e deixar a cargo do usurio a tarefa de tomar uma
deciso? Embora este exemplo possa parecer meio simplrio, ao menos ajuda a esclarecer didaticamente
o processo de definio de novos eventos para um componente. Alm disso, veremos como usar mtodos
de leitura e escrita na definio de novas propriedades.
DEFININDO UM NOVO EVENTO PARA O COMPONENTE
Neste tpico definiremos um novo evento para o componente TNumEdit, cujo procedimento associado
ser executado sempre que o usurio alterar para True o valor da propriedade Numerico do componente,
mas o texto exibido pelo componente no puder ser convertido em nmero.
Inicialmente, deve-se considerar o fato de que um evento , na realidade, uma propriedade. Isso mesmo:
um evento uma propriedade especial, que aponta para uma funo a ser executada!
O tipo mais bsico de evento o do tipo TNotifyEvent, cujo procedimento associado ter como
parmetro uma nica varivel chamada Sender, da classe TObject. No nosso caso, definiremos um
evento chamado OnErroConversao, alterando a definio da nossa classe como a seguir.
type
private
FOnErroConversao : TNotifyEvent;
protected
public
published
property Numerico : boolean read FNumerico write Fnumerico default True;
property OnErroConversao : TNotifyEvent read FOnErroConversao write FOnErroConversao;
end;
Repare que, por ser uma propriedade, o evento OnErroConverso tambm possui um campo interno
associado, denominado FOnErroConversao.
No entanto, esse evento dever ser disparado quando o usurio alterar o valor da propriedade Numerico,
e apenas se isso ocorrer durante a execuo do aplicativo. Dessa forma, devemos definir um mtodo de
escrita para essa varivel, de modo a tratar esse fato.
Um mtodo de escrita deve ter um nico parmetro, e este deve ser do mesmo tipo da propriedade
acessada. Podemos ento definir, atravs do seguinte cdigo, um mtodo denominado AtribuiValor
para a classe TNumEdit:
procedure TNumEdit.AtribuiValor(NovoValor : boolean);
var
valorconvertido : Integer;
begin
FNumerico := NovoValor;
if not(NovoValor) then exit;
try
except
on EConvertError do
begin
if (csdesigning in ComponentState) then
Text := 0
else
if Assigned(FOnErroConversao) then FOnErroConversao(Self);
end;
end;
end;
Nesse procedimento, verifica-se se o valor da propriedade Numerico est sendo alterada na fase de
projeto do aplicativo, verificando-se se a propriedade ComponentState (que um conjunto) contm
entre seus elementos a constante csdesigning que indica que a propriedade est sendo alterada na
fase de projeto do aplicativo.
A classe ter, conseqentemente, a sua definio alterada para:
type
private
protected
procedure AtribuiValor(NovoValor : boolean);
public
published
property Numerico : boolean read FNumerico write AtribuiValor default True;
end;
Repare que agora o valor da propriedade Numerico escrito no campo FNumerico atravs de um
mtodo chamado AtribuiValor.
Voc pode agora recompilar o pacote que contm este novo componente, incluir um componente
NumEdit no formulrio e definir, da seguinte maneira, o procedimento associado ao seu evento
OnErroConversao:
procedure TForm1.NumEdit1ErroConversao(Sender: TObject);
begin
NumEdit1.text := 0;
end;
Dessa maneira, sempre que neste exemplo ocorrer um erro de converso durante a execuo do
aplicativo, o valor da propriedade Text de NumEdit1 ser igual a 0. Isso foi definido pelo usurio do
componente, que poder no ter acesso ao seu cdigo-fonte, mas poder decidir o que deve ser feito
pelo programa quando houver um erro de converso.
O TIPO TNOTIFYEVENT
O tipo TNotifyEvent est definido da seguinte maneira na unit Classes:
type TNotifyEvent = procedure (Sender: TObject) of object;
Caso voc queira, pode definir outros tipos de eventos, como descrito a seguir.
type TMeuEvento = procedure of object;
Nesse caso, se essa definio fosse includa antes da definio da classe TNumEdit, voc poderia definir
FOnErroConversao como:
FOnErroConversao : TMeuEvento;
E a propriedade OnErroConversao teria de ser redefinida como:
property OnErroConversao : TMeuEvent read FOnErroConversao write FOnErroConversao;
No mtodo AtribuiEvento, a chamada do procedimento associado ao evento seria feita da seguinte maneira:
if Assigned(FOnErroConversao) then FOnErroConversao;
Repare que, nesse caso, no existiro mais parmetros a passar, pois voc usou o tipo TMeuEvento em
vez de TNotifyEvent! Nada o impede, no entanto, de definir outros eventos com parmetros distintos.
Repare os procedimentos associados a diversos eventos de um formulrio, e verifique as diferenas
existentes em suas listas de parmetros.
DEFININDO UM MTODO DE LEITURA PARA UMA PROPRIEDADE
Nos tpicos anteriores foram apresentados os procedimentos necessrios definio de um mtodo de
escrita para uma propriedade. A definio de um mtodo de leitura segue procedimentos semelhantes,
devendo-se considerar, no entanto, que:
Enquanto um mtodo de escrita um procedimento, um mtodo de leitura deve ser uma
funo, cujo tipo de retorno deve ser o mesmo tipo definido para a propriedade.
Enquanto um mtodo de escrita deve possuir um parmetro, uma funo no deve possuir
nenhum (excetuando-se o caso de propriedades definidas como arrays).
Dessa maneira, um mtodo de leitura definido de maneira bastante simples, com o objetivo de obter o
valor da propriedade Numerico, poderia ser implementado da seguinte maneira:
function TNumEdit.LeValor : boolean;
begin
result := FNumerico;
end;
Repare que esse mtodo bastante simples, e pouco acrescenta ao mtodo de acesso direto, pois apenas
retorna o valor armazenado no campo FNumerico da classe. Nosso objetivo, contudo, foi mostrar os
procedimentos necessrios definio de um mtodo de leitura para uma propriedade de um componente.
No Delphi, os mtodos de leitura e de escrita costumam ter os seus nomes iniciados com as palavras Get e Set, respectivamente. Esta
, no entanto, apenas uma conveno, pois, conforme mostrado anteriormente, os mtodos podem ter qualquer nome vlido, de acordo
com as regras da linguagem Object Pascal. De qualquer forma, nos prximos tpicos seguiremos as convenes do Delphi.
Apresenta-se a seguir o cdigo final da unit que define a classe TNumEdit:
unit NumEdit;
interface
uses
StdCtrls;
type
private
protected
procedure AtribuiValor(NovoValor : boolean);
function LeValor : boolean;
public
published
property Numerico : boolean read Levalor write AtribuiValor default True;
end;
procedure Register;
implementation
function TNumEdit.LeValor : boolean;
begin
result := FNumerico;
end;
procedure TNumEdit.AtribuiValor(NovoValor : boolean);
var
valorconvertido : Integer;
begin
FNumerico := NovoValor;
if not(NovoValor) then exit;
try
except
on EConvertError do
begin
if (csdesigning in ComponentState) then
Text := 0
else
if Assigned(FOnErroConversao) then FOnErroConversao(Self);
end;
end;
end;
procedure TNumEdit.KeyPress(var Key : Char);
begin
if FNumerico then
begin
if (not (key in [0..9',-,+,#8]))or((key in [+,-]) and (Pos(key,Text)>0))
then key := #0;
end;
end;
procedure TNumEdit.Change;
var
indice : word;
posinal : string;
valorconvertido : integer;
begin
if FNumerico then
begin
indice := Pos(-,Text);
if indice > 1
then
begin
posinal := Text;
Text := -+posinal;
end;
indice := Pos(+,Text);
if indice > 1
then
begin
posinal := Text;
Text := ++posinal;
end;
try
except
on EConvertError do
begin
Numerico := False;
end;
end;
end;
inherited Change;
end;
constructor TNumEdit.Create(AOwner: TComponent);
begin
FNumerico := True;
Text := 0;
end;
procedure Register;
begin
RegisterComponents(KnowHow, [TNumEdit]);
end;
end.
KNOW-HOW EM: CRIAO DE COMPONENTES ASSOCIADOS A BANCOS
DE DADOS
PR-REQUISITOS
Experincia prvia na utilizao de componentes no desenvolvimento de aplicaes com Delphi 7.
Fundamentos bsicos da criao de componentes em Delphi 7.
METODOLOGIA
Apresentao do problema: Associao de um componente ao valor armazenado em um campo de uma tabela de um banco de dados.
TCNICA
Apresentao dos procedimentos necessrios criao de componentes associados a bancos de dados.
Nos tpicos anteriores foram apresentados os procedimentos necessrios criao de novos
componentes com o Delphi 7.
Existem situaes, no entanto, em que o valor exibido pelo componente deve refletir o valor armazenado
em um campo de uma tabela. Alm disso, qualquer alterao feita no valor exibido pelo componente
deve ser refletida no valor armazenado na tabela.
Nos tpicos subseqentes, sero apresentados os procedimentos necessrios converso do componente
TNumEdit, descrito e desenvolvido nos tpicos anteriores, em um componente associado a um banco
de dados (ou, como costuma-se denominar na linguagem object Pascal, um componente data-aware)
que ser denominado TDBNumEdit.
CRIANDO O ESQUELETO DO NOVO COMPONENTE
O novo componente ser denominado TDBNumEdit, e ser derivado diretamente do componente
TNumEdit.
Para criar o esqueleto desse novo componente, basta executar os procedimentos descritos no incio
deste captulo, e salvar a unit na qual ser armazenada a definio do componente com o nome
DBNumEdit.pas.
Inicialmente, esse arquivo apresentar o cdigo reproduzido a seguir.
unit DBNumEdit;
interface
uses
StdCtrls, NumEdit;
type
TDBNumEdit = class(TNumEdit)
private
protected
public
published
end;
procedure Register;
implementation
procedure Register;
begin
RegisterComponents(AXCEL, [TDBNumEdit]);
end;
end.
Como j deve ser do seu conhecimento, os componentes associados a um banco de dados costumam
apresentar as seguintes propriedades:
DataSource: Que identifica o objeto da classe TDataSource ao qual o componente est vinculado.
DataField: O nome do campo da tabela cujo valor do registro corrente ser exibido e/ou editado
pelo componente.
A princpio, seria natural que se criassem dois campos internos, denominados FDataSource (do tipo
TDataSource) e FDataField (do tipo string) para armazenarem internamente os valores dessas propriedades.
Ocorre no entanto que, para simplificar o desenvolvimento de componentes associados a bancos de dados,
a Borland incorporou biblioteca de classes do Delphi uma classe chamada TFieldDataLink, a partir da
qual poderemos criar um objeto responsvel pela associao do componente ao banco de dados.
A classe TFieldDataLink possui, entre outras, as seguintes propriedades:
DataSource: Que identificar o componente da classe TDataSource ao qual o nosso componente
ser vinculado.
FieldName: Que identificar o nome do campo ao qual o nosso componente ser vinculado.
Conseqentemente, em vez de criarmos campos internos para armazenar os valores das propriedades
DataSource e DataField do nosso componente, podemos utilizar as propriedades DataSource e FieldName
de um objeto da classe TFieldDataLink (a ser criado e destrudo pelo nosso componente) nos mtodos
de acesso dessas propriedades.
Alm disso, como a classe TFieldDataLink est definida na unit dbctrls, o nome dessa unit dever ser
includo na clusula uses da unit que define a classe TBDNumEdit, e o mesmo se aplica unit db, na
qual est definida a classe TDataSource.
DEFININDO AS NOVAS PROPRIEDADES PARA O COMPONENTE
Conforme descrito anteriormente, as propriedades DataSource e DataField do componente sero
armazenadas em um objeto da classe TFieldDataLink.
Conseqentemente, precisamos definir um campo interno como um objeto dessa classe, incluindo-se
a seguinte linha de cdigo na seo private da classe que define o componente:
FDataLink : TFieldDataLink;
Alm disso, como as propriedades DataSource e DataField sero na realidade armazenadas em propriedades
do objeto FDataLink, precisamos definir mtodos de leitura e de escrita para essas propriedades, o que
pode ser feito incluindo-se as seguintes linhas de cdigo na seo private da classe que define o componente
(e usando as denominaes Get para leitura e Set para escrita):
function GetDataSource : TDataSource;
Procedure SetDataSource(Value : TDataSource);
function GetDataField : string;
procedure SetDataField(Value : string);
As propriedades so definidas incluindo-se as seguintes linhas de cdigo na seo public da classe que
define o componente:
property DataSource : TDataSource read GetDataSource write SetDataSource;
property DataField : string read GetDataField write SetDataField;
Os mtodos de leitura e escrita devero ser implementados como mostrados nos trechos de cdigo
apresentados a seguir.
function TDBNumEdit.GetDataSource : TDataSource;
begin
Result := FDataLink.DataSource;
end;
procedure TDBNumEdit.SetDataSource(Value : TDataSource);
begin
FDataLink.DataSource := Value;
end;
function TDBNumEdit.GetDataField : string;
begin
Result := FDataLink.FieldName;
end;
procedure TDBNumEdit.SetDataField(Value : string);
begin
FDataLink.FieldName := Value;
end;
Conforme descrito anteriormente, nosso componente ser responsvel por criar e destruir o objeto
FDataLink, o que deve ser feito sobrecarregando-se os mtodos construtor e destrutor do componente.
No mtodo construtor devero ser includas as seguintes linhas de cdigo:
FDataLink := TFieldDataLink.Create;
Lembre-se de que o mtodo construtor um mtodo virtual, e que estamos sobrecarregando o mtodo
construtor da classe-base.
No mtodo destrutor devero ser includas as seguintes linhas de cdigo:
FDataLink.Free;
inherited Destroy;
Apresenta-se a seguir o cdigo da unit que define a classe TDBNumEdit, aps terem sido feitas as
alteraes descritas anteriormente.
unit DBNumEdit;
interface
uses
StdCtrls, NumEdit, dbCtrls, db;
type
private
procedure SetDataSource(Value : TDataSource);
protected
public
published
end;
procedure Register;
implementation
constructor TDBNumEdit.Create(AOwner: TComponent);
begin
end;
destructor TDBNumEdit.Destroy;
begin
FDataLink.Free;
inherited Destroy;
end;
begin
end;
begin
end;
begin
end;
begin
end;
procedure Register;
begin
RegisterComponents(KnowHow, [TDBNumEdit]);
end;
end.
REFLETINDO ALTERAES FEITAS NO CAMPO
Uma das caractersticas do nosso componente deve ser a capacidade de refletir as alteraes feitas no
campo da tabela a ela associada.
Para facilitar a implementao dessa caracterstica, a classe TFieldDataLink tem o evento OnDataChange,
cujo procedimento associado executado sempre que o valor armazenado no campo alterado.
Entretanto, como essa classe no define um componente, seus eventos no podem ser acessados atravs
do Object Inspector, e a associao de um procedimento a esse evento deve ser feita mediante uma
adequada codificao.
Nesse caso, devem-se executar os seguintes procedimentos:
1. Definir um mtodo para o componente, a ser associado ao evento OnDataChange do objeto
FDataLink, da classe TFieldDataLink.
Neste exemplo, criaremos um mtodo chamado DataChange, responsvel por atualizar o texto exibido
pelo componente. Esse mtodo deve ser declarado na seo private da classe que define o componente,
e implementado da seguinte maneira:
procedure TDBNumEdit.DataChange(Sender : TObject);
begin
try
Text := FDataLink.Field.Text;
except
Text := 0;
end;
end;
Inclumos um tratamento de exceo para o caso de no haver sucesso na associao desejada.
2. Associar esse procedimento ao evento OnDataChange do objeto FDataLink, o que pode ser
feito incluindo-se a seguinte linha de cdigo no mtodo construtor do componente:
FDataLink.OnDataChange := DataChange;
unit DBNumEdit;
interface
uses
type
private
procedure DataChange(Sender : TObject);
protected
public
published
end;
procedure Register;
implementation
begin
try
except
Text := 0;
end;
end;
begin
end;
begin
FDataLink.Free;
inherited Destroy;
end;
begin
end;
begin
end;
begin
end;
begin
end;
procedure Register;
begin
end;
end.
REFLETINDO ALTERAES FEITAS NO COMPONENTE
Uma das caractersticas do nosso novo componente deve ser a capacidade de refletir no campo associado
as alteraes feitas no valor por ele exibido.
Para facilitar a implementao dessa caracterstica, a classe TFieldDataLink tem o evento OnUpdateData,
cujo procedimento associado executado sempre que o valor armazenado no campo deve ser modificado.
Nesse caso a associao de um procedimento a esse evento tambm deve ser feita mediante uma
adequada codificao.
Nesse caso, devem-se executar os seguintes procedimentos:
1. Definir um mtodo para o componente, a ser associado ao evento OnUpdateData do objeto
FDataLink, da classe TFieldDataLink.
Neste exemplo, criaremos um mtodo chamado UpdateData, responsvel por atualizar no campo o
texto exibido pelo componente. Esse mtodo deve ser declarado na seo private da classe que define
o componente, e implementado da seguinte maneira:
procedure TDBNumEdit.UpdateData(Sender : TObject);
begin
try
FDataLink.Field.Text := Text;
except
begin
FDataLink.Edit;
end;
end;
end;
Nesse mtodo, caso ocorra uma exceo na tentativa de se atualizar o campo, o objeto FDataLink
colocado em modo de edio e a alterao efetivada.
2. Associar esse procedimento ao evento OnUpdateData do objeto FDataLink, o que pode ser
feito incluindo-se a seguinte linha de cdigo no mtodo construtor do componente:
FDataLink.OnUpdateData := UpdateData;
3. Sobrecarregar o mtodo Change da classe-base, de maneira que o valor armazenado no campo
seja alterado sempre que o usurio alterar o texto exibido pelo componente.
A implementao do mtodo Change deve ser feita da maneira apresentada a seguir.
Repare que esse mtodo responsvel por chamar os mtodos Modified e UpdateRecord do objeto
FDataLink, este responsvel por gerar o seu evento OnUpdateData e conseqentemente executar o
procedimento a ele associado.
procedure TDBNumEdit.Change;
begin
FDataLink.ModiFied;
inherited Change;
try
FDataLink.Edit;
FDataLink.UpdateRecord;
except
end;
end;
unit DBNumEdit;
interface
uses
type
private
procedure UpdateData(Sender : TObject);
protected
public
published
end;
procedure Register;
implementation
begin
FDataLink.ModiFied;
inherited Change;
try
FDataLink.Edit;
except
end;
end;
begin
try
except
begin
FDataLink.Edit;
end;
end;
end;
begin
try
except
Text := 0;
end;
end;
begin
end;
begin
FDataLink.Free;
inherited Destroy;
end;
begin
end;
begin
end;
begin
end;
begin
end;
procedure Register;
begin
end;
end.
NOTIFICANDO O COMPONENTE DA REMOO DE UM DATASOURCE
Da forma como nosso componente est implementado, se removermos o componente DataSource do
formulrio, a propriedade DataSource do componente no apresentar nenhum valor (o que est correto)
mas o valor da propriedade DataField no alterado (o que est errado).
A soluo desse problema consiste em sobrecarregar o mtodo Notification do seu componente ancestral.
Esse mtodo executado sempre que um componente inserido ou movido do formulrio, e recebe
como parmetros:
Um ponteiro para o componente que foi inserido ou removido.
Uma varivel do tipo TOperation, que identifica a operao realizada sobre o componente.
Neste exemplo, devemos remover o valor exibido na propriedade DataField sempre que o DataSource
associado for removido, o que pode ser feito implementando-se da seguinte maneira o mtodo Notifi-
cation do componente:
procedure TDBNumEdit.Notification(AComponent : TComponent;Operation : TOperation);
begin
if (Operation = opRemove)and(AComponent is TDataSource)and(FDataLink.DataSource = nil)
then FDataLink.FieldName := ;
end;
unit DBNumEdit;
interface
uses
type
private
protected
procedure Notification(AComponent : TComponent;Operation : TOperation);override;
public
published
end;
procedure Register;
implementation
begin
end;
begin
FDataLink.ModiFied;
inherited Change;
try
FDataLink.Edit;
except
end;
end;
begin
try
except
begin
FDataLink.Edit;
end;
end;
end;
begin
try
except
Text := 0;
end;
end;
begin
end;
begin
FDataLink.Free;
inherited Destroy;
end;
begin
end;
begin
end;
begin
end;
begin
end;
procedure Register;
begin
end;
end.
CRIANDO UMA PROPRIEDADE QUE PERMITA TRATAR A TECLA ENTER COMO TAB
Normalmente os usurios de aplicaes desenvolvidas para o ambiente Windows, principalmente aqueles
acostumados a utilizar aplicaes desenvolvidas para o ambiente MS-DOS, preferem utilizar a tecla Enter
em vez da tecla Tab, para alterar o componente que recebe o foco.
Como j deve ser do seu conhecimento, essa caracterstica pode ser implementada incluindo-se o
seguinte trecho de cdigo no procedimento associado ao evento OnKeyPress do componente:
if key = #13 then
begin
Key := #0;
Perform(WM_NEXTDLGCTL,0,0);
end;
Com essa codificao, ao se pressionar a tecla Enter o foco ser deslocado para o prximo componente
(seguindo-se a ordem estabelecida para a propriedade TabOrder dos componentes).
Evidentemente, seria muito mais simples incluir essa caracterstica em uma propriedade do componente.
Neste exemplo, definiremos para o componente DBNumEdit uma propriedade chamada TabEnter, do
tipo booleano, que se for igual a true (seu valor default) far com que, ao se pressionar a tecla Enter, o
prximo componente receba o foco.
Para implementar essa propriedade devemos redefinir da seguinte maneira a unit que define o
componente:
unit DBNumEdit;
interface
uses
type
private
FTabEnter : boolean;
protected
procedure Notification(AComponent : TComponent;Operation : TOperation);override;
public
published
property TabEnter : boolean read FTabEnter write FTabEnter default True;
end;
procedure Register;
implementation
procedure TDBNumEdit.KeyPress(var Key : Char);
Begin
if (key = #13) and (TabEnter) then
begin
Key := #0;
(Parent as TComponent).Perform(WM_NEXTDLGCTL,0,0);
end
else
end;
begin
end;
begin
FDataLink.ModiFied;
inherited Change;
try
FDataLink.Edit;
except
end;
end;
begin
try
except
begin
FDataLink.Edit;
end;
end;
end;
begin
try
except
Text := 0;
end;
end;
begin
end;
begin
FDataLink.Free;
inherited Destroy;
end;
begin
end;
begin
end;
begin
end;
begin
end;
procedure Register;
begin
end;
end.
Repare que, como queremos que o mtodo Perform seja executado no formulrio (ou objeto) que
contm o componente, o cdigo correto :
(Parent as TComponent).Perform(WM_NEXTDLGCTL,0,0);
e no simplesmente
Perform(WM_NEXTDLGCTL,0,0);
Esta ltima linha de cdigo no surtiria nenhum efeito.
Repare ainda que foi necessrio sobrecarregar o mtodo KeyPress da classe-base.
Esta ltima propriedade poderia ser definida na classe TNumEdit. Neste caso, estaria tambm presente na classe TDBNumEdit, derivada
por herana da classe TNumEdit.
KNOW-HOW EM: CRIAO DE CONTROLES ACTIVEX
PR-REQUISITOS
Experincia prvia na criao de componentes com o Delphi 7.
METODOLOGIA
Apresentao do problema: Criao de controles ActiveX a partir de componentes desenvolvidos em Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios criao de Controles ActiveX.
Conforme descrito nos tpicos precedentes, a criao de componentes usando-se a linguagem Object
Pascal no oferece maiores dificuldades.
Considere agora a seguinte situao: voc precisa desenvolver uma aplicao usando uma outra
ferramenta de desenvolvimento que no o Delphi 7, e nessa aplicao precisa utilizar um componente
(no disponvel no ambiente) cujas caractersticas sejam idnticas s existentes em um componente
desenvolvido em Object Pascal.
Se esse ambiente de desenvolvimento manipular controles ActiveX, e entre as caractersticas desejadas
para o componente no se inclurem aquelas relacionadas manipulao de bancos de dados, a sua
tarefa ser bastante simples, pois o Delphi 7 permite que se converta, de forma simples e rpida, um
componente Delphi em um controle ActiveX (desde que esse componente no seja data-aware).
A ttulo de exemplificao, apresentaremos nos tpicos subseqentes os procedimentos necessrios
converso do componente NumEdit em um controle ActiveX.
CONVERTENDO O COMPONENTE NUMEDIT EM UM CONTROLE ACTIVEX
Para transformar o componente NumEdit em um controle ActiveX, voc deve executar os seguintes
procedimentos:
1. Selecione o item New do menu File para exibir a caixa de dilogo New Items.
2. Selecione o item ActiveX Control da pgina ActiveX dessa caixa de dilogo, como mostrado na
figura a seguir.
3. Selecione o boto Ok, para fechar essa caixa de dilogo e exibir a caixa de dilogo ActiveX
Control Wizard, mostrada na figura a seguir.
Figura 21.9: A caixa de dilogo ActiveX Control Wizard.
Nessa caixa de dilogo, devem-se definir:
O nome da classe que define o componente a partir do qual ser gerado o controle ActiveX.
O nome do controle ActiveX que ser gerado.
O nome da unit na qual ser implementado o controle.
O nome do projeto responsvel pela gerao do controle ActiveX.
O modelo de Thread empregado.
4. Selecione o boto Ok, para fechar essa caixa de dilogo. Caso o projeto corrente no corresponda
a uma biblioteca ActiveX, ser exibida a mensagem de advertncia mostrada na figura a seguir.
Selecione o boto Ok para gerar o novo projeto.
Figura 21.10: A mensagem de advertncia.
Ser ento criada a unit responsvel pela gerao do controle ActiveX, cujo cdigo reproduzido a seguir.
unit NumEditImpl1;
{$WARN SYMBOL_PLATFORM OFF}
interface
uses
Windows, ActiveX, Classes, Controls, Graphics, Menus, Forms, StdCtrls,
ComServ, StdVCL, AXCtrls, NumEditXControl1_TLB, NumEdit;
type
TNumEditX = class(TActiveXControl, INumEditX)
private
FDelphiControl: TNumEdit;
FEvents: INumEditXEvents;
procedure ChangeEvent(Sender: TObject);
procedure ClickEvent(Sender: TObject);
procedure DblClickEvent(Sender: TObject);
procedure ErroConversaoEvent(Sender: TObject);
procedure KeyPressEvent(Sender: TObject; var Key: Char);
protected
procedure DefinePropertyPages(DefinePropertyPage: TDefinePropertyPage); override;
procedure EventSinkChanged(const EventSink: IUnknown); override;
procedure InitializeControl; override;
function DrawTextBiDiModeFlagsReadingOnly: Integer; safecall;
function Get_AlignDisabled: WordBool; safecall;
function Get_AutoSelect: WordBool; safecall;
function Get_AutoSize: WordBool; safecall;
function Get_BevelInner: TxBevelCut; safecall;
function Get_BevelKind: TxBevelKind; safecall;
function Get_BevelOuter: TxBevelCut; safecall;
function Get_BorderStyle: TxBorderStyle; safecall;
function Get_CanUndo: WordBool; safecall;
function Get_CharCase: TxEditCharCase; safecall;
function Get_Color: OLE_COLOR; safecall;
function Get_Ctl3D: WordBool; safecall;
function Get_DoubleBuffered: WordBool; safecall;
function Get_DragCursor: Smallint; safecall;
function Get_DragMode: TxDragMode; safecall;
function Get_Enabled: WordBool; safecall;
function Get_Font: IFontDisp; safecall;
function Get_HideSelection: WordBool; safecall;
function Get_ImeMode: TxImeMode; safecall;
function Get_ImeName: WideString; safecall;
function Get_MaxLength: Integer; safecall;
function Get_Modified: WordBool; safecall;
function Get_Numerico: WordBool; safecall;
function Get_OEMConvert: WordBool; safecall;
function Get_ParentColor: WordBool; safecall;
function Get_ParentCtl3D: WordBool; safecall;
function Get_PasswordChar: Smallint; safecall;
function Get_ReadOnly: WordBool; safecall;
function Get_SelLength: Integer; safecall;
function Get_SelStart: Integer; safecall;
function Get_SelText: WideString; safecall;
function Get_Text: WideString; safecall;
function Get_Visible: WordBool; safecall;
function Get_VisibleDockClientCount: Integer; safecall;
function IsRightToLeft: WordBool; safecall;
function UseRightToLeftReading: WordBool; safecall;
function UseRightToLeftScrollBar: WordBool; safecall;
procedure _Set_Font(var Value: IFontDisp); safecall;
procedure Clear; safecall;
procedure ClearSelection; safecall;
procedure ClearUndo; safecall;
procedure CopyToClipboard; safecall;
procedure CutToClipboard; safecall;
procedure InitiateAction; safecall;
procedure PasteFromClipboard; safecall;
procedure SelectAll; safecall;
procedure Set_AutoSelect(Value: WordBool); safecall;
procedure Set_AutoSize(Value: WordBool); safecall;
procedure Set_BevelInner(Value: TxBevelCut); safecall;
procedure Set_BevelKind(Value: TxBevelKind); safecall;
procedure Set_BevelOuter(Value: TxBevelCut); safecall;
procedure Set_BorderStyle(Value: TxBorderStyle); safecall;
procedure Set_CharCase(Value: TxEditCharCase); safecall;
procedure Set_Color(Value: OLE_COLOR); safecall;
procedure Set_Ctl3D(Value: WordBool); safecall;
procedure Set_DoubleBuffered(Value: WordBool); safecall;
procedure Set_DragCursor(Value: Smallint); safecall;
procedure Set_DragMode(Value: TxDragMode); safecall;
procedure Set_Enabled(Value: WordBool); safecall;
procedure Set_Font(const Value: IFontDisp); safecall;
procedure Set_HideSelection(Value: WordBool); safecall;
procedure Set_ImeMode(Value: TxImeMode); safecall;
procedure Set_ImeName(const Value: WideString); safecall;
procedure Set_MaxLength(Value: Integer); safecall;
procedure Set_Modified(Value: WordBool); safecall;
procedure Set_Numerico(Value: WordBool); safecall;
procedure Set_OEMConvert(Value: WordBool); safecall;
procedure Set_ParentColor(Value: WordBool); safecall;
procedure Set_ParentCtl3D(Value: WordBool); safecall;
procedure Set_PasswordChar(Value: Smallint); safecall;
procedure Set_ReadOnly(Value: WordBool); safecall;
procedure Set_SelLength(Value: Integer); safecall;
procedure Set_SelStart(Value: Integer); safecall;
procedure Set_SelText(const Value: WideString); safecall;
procedure Set_Text(const Value: WideString); safecall;
procedure Set_Visible(Value: WordBool); safecall;
procedure SetSubComponent(IsSubComponent: WordBool); safecall;
procedure Undo; safecall;
end;
implementation
uses ComObj;
{ TNumEditX }
procedure TNumEditX.DefinePropertyPages(DefinePropertyPage: TDefinePropertyPage);
begin
{TODO: Define property pages here. Property pages are defined by calling
DefinePropertyPage with the class id of the page. For example,
DefinePropertyPage(Class_NumEditXPage); }
end;
procedure TNumEditX.EventSinkChanged(const EventSink: IUnknown);
begin
FEvents := EventSink as INumEditXEvents;
end;
procedure TNumEditX.InitializeControl;
begin
FDelphiControl := Control as TNumEdit;
FDelphiControl.OnChange := ChangeEvent;
FDelphiControl.OnClick := ClickEvent;
FDelphiControl.OnDblClick := DblClickEvent;
FDelphiControl.OnErroConversao := ErroConversaoEvent;
FDelphiControl.OnKeyPress := KeyPressEvent;
end;
function TNumEditX.DrawTextBiDiModeFlagsReadingOnly: Integer;
begin
Result := FDelphiControl.DrawTextBiDiModeFlagsReadingOnly;
end;
function TNumEditX.Get_AlignDisabled: WordBool;
begin
Result := FDelphiControl.AlignDisabled;
end;
function TNumEditX.Get_AutoSelect: WordBool;
begin
Result := FDelphiControl.AutoSelect;
end;
function TNumEditX.Get_AutoSize: WordBool;
begin
Result := FDelphiControl.AutoSize;
end;
function TNumEditX.Get_BevelInner: TxBevelCut;
begin
Result := Ord(FDelphiControl.BevelInner);
end;
function TNumEditX.Get_BevelKind: TxBevelKind;
begin
Result := Ord(FDelphiControl.BevelKind);
end;
function TNumEditX.Get_BevelOuter: TxBevelCut;
begin
Result := Ord(FDelphiControl.BevelOuter);
end;
function TNumEditX.Get_BorderStyle: TxBorderStyle;
begin
Result := Ord(FDelphiControl.BorderStyle);
end;
function TNumEditX.Get_CanUndo: WordBool;
begin
Result := FDelphiControl.CanUndo;
end;
function TNumEditX.Get_CharCase: TxEditCharCase;
begin
Result := Ord(FDelphiControl.CharCase);
end;
function TNumEditX.Get_Color: OLE_COLOR;
begin
Result := OLE_COLOR(FDelphiControl.Color);
end;
function TNumEditX.Get_Ctl3D: WordBool;
begin
Result := FDelphiControl.Ctl3D;
end;
function TNumEditX.Get_DoubleBuffered: WordBool;
begin
Result := FDelphiControl.DoubleBuffered;
end;
function TNumEditX.Get_DragCursor: Smallint;
begin
Result := Smallint(FDelphiControl.DragCursor);
end;
function TNumEditX.Get_DragMode: TxDragMode;
begin
Result := Ord(FDelphiControl.DragMode);
end;
function TNumEditX.Get_Enabled: WordBool;
begin
Result := FDelphiControl.Enabled;
end;
function TNumEditX.Get_Font: IFontDisp;
begin
GetOleFont(FDelphiControl.Font, Result);
end;
function TNumEditX.Get_HideSelection: WordBool;
begin
Result := FDelphiControl.HideSelection;
end;
function TNumEditX.Get_ImeMode: TxImeMode;
begin
Result := Ord(FDelphiControl.ImeMode);
end;
function TNumEditX.Get_ImeName: WideString;
begin
Result := WideString(FDelphiControl.ImeName);
end;
function TNumEditX.Get_MaxLength: Integer;
begin
Result := FDelphiControl.MaxLength;
end;
function TNumEditX.Get_Modified: WordBool;
begin
Result := FDelphiControl.Modified;
end;
function TNumEditX.Get_Numerico: WordBool;
begin
Result := FDelphiControl.Numerico;
end;
function TNumEditX.Get_OEMConvert: WordBool;
begin
Result := FDelphiControl.OEMConvert;
end;
function TNumEditX.Get_ParentColor: WordBool;
begin
Result := FDelphiControl.ParentColor;
end;
function TNumEditX.Get_ParentCtl3D: WordBool;
begin
Result := FDelphiControl.ParentCtl3D;
end;
function TNumEditX.Get_PasswordChar: Smallint;
begin
Result := Smallint(FDelphiControl.PasswordChar);
end;
function TNumEditX.Get_ReadOnly: WordBool;
begin
Result := FDelphiControl.ReadOnly;
end;
function TNumEditX.Get_SelLength: Integer;
begin
Result := FDelphiControl.SelLength;
end;
function TNumEditX.Get_SelStart: Integer;
begin
Result := FDelphiControl.SelStart;
end;
function TNumEditX.Get_SelText: WideString;
begin
Result := WideString(FDelphiControl.SelText);
end;
function TNumEditX.Get_Text: WideString;
begin
Result := WideString(FDelphiControl.Text);
end;
function TNumEditX.Get_Visible: WordBool;
begin
Result := FDelphiControl.Visible;
end;
function TNumEditX.Get_VisibleDockClientCount: Integer;
begin
Result := FDelphiControl.VisibleDockClientCount;
end;
function TNumEditX.IsRightToLeft: WordBool;
begin
Result := FDelphiControl.IsRightToLeft;
end;
function TNumEditX.UseRightToLeftReading: WordBool;
begin
Result := FDelphiControl.UseRightToLeftReading;
end;
function TNumEditX.UseRightToLeftScrollBar: WordBool;
begin
Result := FDelphiControl.UseRightToLeftScrollBar;
end;
procedure TNumEditX._Set_Font(var Value: IFontDisp);
begin
SetOleFont(FDelphiControl.Font, Value);
end;
procedure TNumEditX.ChangeEvent(Sender: TObject);
begin
if FEvents <> nil then FEvents.OnChange;
end;
procedure TNumEditX.Clear;
begin
FDelphiControl.Clear;
end;
procedure TNumEditX.ClearSelection;
begin
FDelphiControl.ClearSelection;
end;
procedure TNumEditX.ClearUndo;
begin
FDelphiControl.ClearUndo;
end;
procedure TNumEditX.ClickEvent(Sender: TObject);
begin
if FEvents <> nil then FEvents.OnClick;
end;
procedure TNumEditX.CopyToClipboard;
begin
FDelphiControl.CopyToClipboard;
end;
procedure TNumEditX.CutToClipboard;
begin
FDelphiControl.CutToClipboard;
end;
procedure TNumEditX.DblClickEvent(Sender: TObject);
begin
if FEvents <> nil then FEvents.OnDblClick;
end;
procedure TNumEditX.ErroConversaoEvent(Sender: TObject);
begin
if FEvents <> nil then FEvents.OnErroConversao;
end;
procedure TNumEditX.InitiateAction;
begin
FDelphiControl.InitiateAction;
end;
procedure TNumEditX.KeyPressEvent(Sender: TObject; var Key: Char);
var
TempKey: Smallint;
begin
TempKey := Smallint(Key);
if FEvents <> nil then FEvents.OnKeyPress(TempKey);
Key := Char(TempKey);
end;
procedure TNumEditX.PasteFromClipboard;
begin
FDelphiControl.PasteFromClipboard;
end;
procedure TNumEditX.SelectAll;
begin
FDelphiControl.SelectAll;
end;
procedure TNumEditX.Set_AutoSelect(Value: WordBool);
begin
FDelphiControl.AutoSelect := Value;
end;
procedure TNumEditX.Set_AutoSize(Value: WordBool);
begin
FDelphiControl.AutoSize := Value;
end;
procedure TNumEditX.Set_BevelInner(Value: TxBevelCut);
begin
FDelphiControl.BevelInner := TBevelCut(Value);
end;
procedure TNumEditX.Set_BevelKind(Value: TxBevelKind);
begin
FDelphiControl.BevelKind := TBevelKind(Value);
end;
procedure TNumEditX.Set_BevelOuter(Value: TxBevelCut);
begin
FDelphiControl.BevelOuter := TBevelCut(Value);
end;
procedure TNumEditX.Set_BorderStyle(Value: TxBorderStyle);
begin
FDelphiControl.BorderStyle := TBorderStyle(Value);
end;
procedure TNumEditX.Set_CharCase(Value: TxEditCharCase);
begin
FDelphiControl.CharCase := TEditCharCase(Value);
end;
procedure TNumEditX.Set_Color(Value: OLE_COLOR);
begin
FDelphiControl.Color := TColor(Value);
end;
procedure TNumEditX.Set_Ctl3D(Value: WordBool);
begin
FDelphiControl.Ctl3D := Value;
end;
procedure TNumEditX.Set_DoubleBuffered(Value: WordBool);
begin
FDelphiControl.DoubleBuffered := Value;
end;
procedure TNumEditX.Set_DragCursor(Value: Smallint);
begin
FDelphiControl.DragCursor := TCursor(Value);
end;
procedure TNumEditX.Set_DragMode(Value: TxDragMode);
begin
FDelphiControl.DragMode := TDragMode(Value);
end;
procedure TNumEditX.Set_Enabled(Value: WordBool);
begin
FDelphiControl.Enabled := Value;
end;
procedure TNumEditX.Set_Font(const Value: IFontDisp);
begin
SetOleFont(FDelphiControl.Font, Value);
end;
procedure TNumEditX.Set_HideSelection(Value: WordBool);
begin
FDelphiControl.HideSelection := Value;
end;
procedure TNumEditX.Set_ImeMode(Value: TxImeMode);
begin
FDelphiControl.ImeMode := TImeMode(Value);
end;
procedure TNumEditX.Set_ImeName(const Value: WideString);
begin
FDelphiControl.ImeName := TImeName(Value);
end;
procedure TNumEditX.Set_MaxLength(Value: Integer);
begin
FDelphiControl.MaxLength := Value;
end;
procedure TNumEditX.Set_Modified(Value: WordBool);
begin
FDelphiControl.Modified := Value;
end;
procedure TNumEditX.Set_Numerico(Value: WordBool);
begin
FDelphiControl.Numerico := Value;
end;
procedure TNumEditX.Set_OEMConvert(Value: WordBool);
begin
FDelphiControl.OEMConvert := Value;
end;
procedure TNumEditX.Set_ParentColor(Value: WordBool);
begin
FDelphiControl.ParentColor := Value;
end;
procedure TNumEditX.Set_ParentCtl3D(Value: WordBool);
begin
FDelphiControl.ParentCtl3D := Value;
end;
procedure TNumEditX.Set_PasswordChar(Value: Smallint);
begin
FDelphiControl.PasswordChar := Char(Value);
end;
procedure TNumEditX.Set_ReadOnly(Value: WordBool);
begin
FDelphiControl.ReadOnly := Value;
end;
procedure TNumEditX.Set_SelLength(Value: Integer);
begin
FDelphiControl.SelLength := Value;
end;
procedure TNumEditX.Set_SelStart(Value: Integer);
begin
FDelphiControl.SelStart := Value;
end;
procedure TNumEditX.Set_SelText(const Value: WideString);
begin
FDelphiControl.SelText := String(Value);
end;
procedure TNumEditX.Set_Text(const Value: WideString);
begin
FDelphiControl.Text := TCaption(Value);
end;
procedure TNumEditX.Set_Visible(Value: WordBool);
begin
FDelphiControl.Visible := Value;
end;
procedure TNumEditX.SetSubComponent(IsSubComponent: WordBool);
begin
FDelphiControl.SetSubComponent(IsSubComponent);
end;
procedure TNumEditX.Undo;
begin
FDelphiControl.Undo;
end;
initialization
TActiveXControlFactory.Create(
ComServer,
TNumEditX,
TNumEdit,
Class_NumEditX,
1,
,
0,
tmApartment);
end.
O cdigo do arquivo de projeto reproduzido a seguir (podendo ser renomeado).
library NumEditXControl1;
uses
ComServ,
NumEditXControl1_TLB in NumEditXControl1_TLB.pas,
NumEditImpl1 in NumEditImpl1.pas {NumEditX: CoClass};
{$E ocx}
exports
DllGetClassObject,
DllCanUnloadNow,
DllRegisterServer,
DllUnregisterServer;
{$R *.TLB}
{$R *.RES}
begin
end.
5. Selecione o item Build All Projects (ou Build NumEditXControl1) do menu Project para gerar o
arquivo NumEditXControl.ocx, no qual est definido o controle ActiveX.
6. Selecione o item Register ActiveX Server do menu Run, para registrar o controle no sistema
operacional.
Caso o componente seja registrado com sucesso, ser exibida a caixa de dilogo mostrada na figura a seguir.
Figura 21.11: Registrando o Controle Activex.
O controle gerado pode ento ser usado por qualquer ambiente de desenvolvimento que suporte
controles ActiveX, como o Microsoft Visual Basic 5.0, por exemplo.
A figura a seguir mostra a incluso do controle no ambiente de desenvolvimento do Microsoft Visual
Basic 6.0.
A Figura 21.12 mostra a janela de propriedades do Microsoft Visual Basic 6.0 para o controle recm-criado.
O controle ActiveX recm-criado apresenta as mesmas caractersticas definidas para o componente
usado no Delphi.
Figura 21.12: Incluso do controle no ambiente de desenvolvimento do Microsoft Visual Basic 6.0.
Figura 21.13: A janela de propriedades do Microsoft
Visual Basic 6.0 para o controle recm-criado.
CAPTULO 22 MECANISMOS DE ACESSO A BANCO DE DADOS
Captulo
Mecanismos de Acesso
a Banco de Dados
22
Neste captulo sero apresentados tpicos gerais relacionados aos procedimentos necessrios ao acesso
a bancos de dados a partir de uma aplicao desenvolvida em Delphi 7, usando os mecanismos de
acesso disponveis.
KNOW-HOW EM: FUNDAMENTOS DOS MECANISMOS DE ACESSO
A BANCOS DE DADOS
PR-REQUISITOS
Conhecimentos bsicos relacionados organizao de informaes.
Conhecimentos bsicos relacionados utilizao de componentes.
METODOLOGIA
Apresentao dos conceitos fundamentais dos mecanismos de acesso a bancos de dados, e sua terminologia.
OS MECANISMOS DE ACESSO A BANCOS DE DADOS
Ao lanar a sua primeira ferramenta RAD para o desenvolvimento de aplicaes para o ambente Win-
dows (o Delphi 1.0) h alguns anos atrs, a Borland procurou apresentar ao mercado uma ferramenta
que no simplificasse apenas a criao da interface com o usurio da aplicao, mas tambm a forma
pela qual esta aplicao acessaria os diferentes formatos de bancos de dados existentes no mercado.
A Borland desejava que as aplicaes criadas pudessem acessar diferentes bases de dados sem que
fossem necessrias grandes alteraes na codificao dos aplicativos criados, e isto foi possvel graas
introduo de um mecanismo de acesso a bancos de dados tambm desenvolvido pela Borland o
Borland Database Engine (BDE).
Este mecanismo foi um dos grandes responsveis pelo sucesso alcanado pelo Delphi como ferramenta
de desenvolvimento (alm de fatores mencionados em captulos anteriores, como facilidade de criao
de interface, orientao a objetos, etc.).
Apesar do grande sucesso alcanado pelo BDE, muitos desenvolvedores que utilizavam bancos de
dados da Microsoft (como o Access e o SQL Server) reclamavam a ausncia do suporte tecnologia
Activex Data Objects (ADO), presente na maioria dos computadores que executavam suas tarefas sobre
o sistema operacional Windows.
Por esta razo o Delphi, a partir da sua verso 5, criou componentes com a finalidade especfica de
acessar bancos de dados via ADO, sem que fosse ento necessria a instalao do BDE (supondo
evidentemente que o suporte a ADO estivesse instalado nas mquinas onde a aplicao fosse ser
executada se no seria necessria a sua instalao).
Alm disso, a verso 5 passava a incluir tambm um conjunto de componentes com a finalidade de
permitir o desenvolvimento de aplicaes cliente-servidor que obtivessem acesso nativo a bases de dados
do Interbase sem a necessidade de instalao do BDE conjunto este denominado Interbase Express.
A verso 6 do Delphi trouxe um novo mecanismo de acesso multiplataforma denominado DBExpress,
mais leve do que o BDE, mas que s permite o acesso a sistemas gerenciadores de bancos de dados
SQL, no oferecendo suporte a bancos de dados locais baseados em arquivos, como o Paradox e o
DBase, por exemplo.
A verso 7 do Delphi trouxe um aprimoramento do DBExpress, e o congelamentodo Borland Data-
base Engine, para o qual no devero ser oferecidas novas verses ou atualizaes, ou suporte tcnico.
Desta maneira, nosso estudo sobre bancos de dados ser inicialmente subdividido nos seguintes captulos:
Desenvolvimento de Aplicaes para acesso a Bancos de Dados via BDE.
Desenvolvimento de Aplicaes para acesso a Bancos de Dados via ADO.
Desenvolvimento de Aplicaes para acesso a Bancos de Dados via DBExpress.
Desenvolvimento de Aplicaes para acesso a Bancos de Dados via Interbase Express.
importante caracterizar, no entanto, que a portabilidade de uma aplicao no fica comprometida
com a existncia de tantas opes, uma vez que a interface da aplicao poder ser integralmente
aproveitada ao se alternar de uma tecnologia para outra sendo necessrio apenas modificar os
componentes de acesso base de dados, geralmente situados em um repositrio chamado Datamodule,
cuja finalidade justamente armazenar estes componentes, e alterar algumas poucas propriedades.
KNOW-HOW EM: CLASSES FUNDAMENTAIS DE ACESSO A BANCOS DE
DADOS A CLASSE TDATASET
PR-REQUISITOS
Experincia prvia na utilizao de classes e componentes no desenvolvimento de aplicaes
com Delphi 7.
METODOLOGIA
Apresentao das classes e componentes fundamentais de acesso a bancos de dados, juntamente
com uma descrio das suas propriedades, mtodos e eventos.
TCNICA
Descrio da classe TDataset, para acesso a bancos de dados.
Inicialmente ser apresentada a classe TDataSet, a partir da qual so derivadas, por herana, as classes
mais utilizadas para acessar os bancos de dados a serem manipulados por uma aplicao desenvolvida
em Delphi, atravs dos diversos mecanismos de acesso.
A CLASSE TDATASET
Observando-se o diagrama de hierarquia de classes da VCL, verifica-se que, no topo das classes de
acesso a bancos de dados, encontra-se a classe TDataSet. Dela so derivadas:
A classe TTable, que representa uma tabela acessada via BDE.
A classe TADOTable, que representa uma tabela acessada via ADO.
A classe TIBTable, que representa uma tabela do Interbase acessada via Interbase Express.
A classe TSQLTable, que representa uma tabela acessada via DBExpress.
A classe TClientDataSet,que representa uma tabela acessada diretamente pela aplicao (sendo
esta tabela armazenada no formato binrio, no mesmo computador em que a aplicao
executada), ou em uma aplicao distribuda. Pode ser usada tambm para permitir, em conjunto
com um componente DatasetProvider, acesso bidirecional (em memria) a bancos de dados
acessados atravs de um mecanismo de acesso unidirecional.
A classe TSQLSimpleDataSet, que permitie acesso bidirecional (em memria) a bancos de dados
acessados atravs do mecanismo de acesso unidirecional DBExpress. Consiste em reunir, em
uma nica classe, objetos das classes TSQLDataset, DatasetProvider e ClientDataset, e substitui
a classe TClientDataset da verso 6.
A classe TQuery, que permite o acesso a uma ou mais tabelas via declaraes SQL, atravs do
Borland Database Engine.
A classe TADOQuery, que permite o acesso a uma ou mais tabelas via declaraes SQL, atravs
da tecnologia ADO.
A classe TIBQuery, que permite o acesso a uma ou mais tabelas via declaraes SQL, atravs da
tecnologia Interbase Express.
A classe TSQLQuery, que permite o acesso a uma ou mais tabelas via declaraes SQL, atravs
da tecnologia DBExpress.
A classe TStoredProc, que permite executar procedimentos armazenados em um banco de dados
acessado atravs do Borland Database Emgine.
A classe TADOStoredProc, que permite executar procedimentos armazenados em um banco de
dados acessado atravs da tecnologia ADO.
A classe TIBStoredProc, que permite executar procedimentos armazenados em um banco de
dados acessado atravs da tecnologia Interbase Express.
A classe TSQLStoredProc, que permite executar procedimentos armazenados em um banco de
dados acessado atravs da tecnologia DBExpress.
A classe TSQLDataset, que uma generalizao das classes TSQLTable, TSQLQuery e
TSQLStoredProc, e que permite acessar diretamente uma tabela, uma ou vrias tabelas via
declaraes SQL, ou executar procedimentos armazenados em um banco de dados acessado
atravs da tecnologia DBExpress.
Um objeto da classe TDataSet, ou de qualquer das classes dela derivadas por herana, tem por objetivo
representar tabelas a serem acessadas pela aplicao, sendo uma tabela definida, de forma genrica,
por um conjunto de informaes organizadas em linhas (registros da tabela) e colunas (campos da
tabela). No caso de declaraes SQL, tambm poder ser retornado um conjunto de registros, ainda
que provenientes de vrias tabelas.
Dessa maneira, o acesso a tabelas definidas em um banco de dados ser feito sempre atravs de um
componente derivado da classe TDataSet.
A classe TDataSet, no entanto, implementa a funcionalidade genrica para acesso a tabelas, sem
incorporar as funes da API do Borland Database Engine (o mecanismo de acesso a banco de dados
criado pela Borland), os mtodos da biblioteca ADO da Microsoft, do Interbase Express ou qualquer
outro mecanismo de acesso. Estes mtodos so implementados nas classes dela derivadas por herana.
Nos prximos tpicos, sero apresentadas as principais propriedades e mtodos da classe TDataSet.
Sempre que nos referirmos ao termo Tabela, este dever ser entendido como um conjunto de registros,
ainda que retornados por uma declarao SQL.
PRINCIPAIS PROPRIEDADES DA CLASSE TDATASET
Apresenta-se a seguir uma descrio das principais propriedades da classe TDataSet. Desta maneira,
podemos descrever estas propriedades de uma nica vez, ao invs de falar sobre elas cada vez que
abordarmos uma das classes derivadas da classe TDataSet.
ACTIVE
Essa propriedade definida como uma varivel booleana, e define se a tabela (ou conjunto de tabelas)
associada ao componente est ou no ativa.
Conforme ser visto posteriormente, atribuir o valor true a essa propriedade equivale a executar o
mtodo Open do componente. Da mesma forma, atribuir o valor false a essa propriedade equivale a
executar o mtodo Close do componente.
AUTOCALCFIELDS
Essa propriedade definida como uma varivel booleana, e define se o procedimento associado ao
evento OnCalcFields do componente deve ser executado sempre que houver uma alterao nos dados
armazenados na tabela representada pelo componente.
Os campos calculados so aqueles cujo valor pode ser diretamente obtido em funo dos valores
armazenados em outros campos da tabela, razo pela qual no precisam ser armazenados
permanentemente na tabela.
A definio da frmula utilizada para o clculo dos valores desses campos feita no procedimento
associado ao evento OnCalcFields do componente, conforme ser exemplificado posteriormente.
BOF
Essa propriedade definida como uma varivel booleana, e define se o registro corrente o primeiro
registro da tabela representada pelo componente. uma propriedade apenas de leitura, e tem o valor
true em cada uma das seguintes situaes:
Quando se estabelece o acesso tabela representada pelo componente, definido-se como True
o valor da sua propriedade Active, ou aps uma chamada ao seu mtodo Open.
Aps uma chamada ao mtodo First do componente.
Aps uma chamada ao mtodo Prior do componente, quando o registro corrente j o primeiro
registro da tabela.
EOF
Essa propriedade definida como uma varivel booleana, e define se o registro corrente o ltimo
registro da tabela representada pelo componente. uma propriedade apenas de leitura, e tem o valor
True em cada uma das seguintes situaes:
Quando se estabelece o acesso tabela representada pelo componente, definido-se como True
o valor da sua propriedade Active (ou aps uma chamada ao seu mtodo Open) e a tabela no
possui nenhum registro armazenado.
Aps uma chamada ao mtodo Last do componente.
Aps uma chamada ao mtodo Next do componente, quando o registro corrente j o ltimo
registro da tabela.
FIELDCOUNT
Essa propriedade definida como uma varivel inteira, e define o nmero de campos da tabela
representada pelo componente. uma propriedade apenas de leitura, e no pode ter o seu valor
diretamente alterado pelo usurio.
importante salientar que essa propriedade retorna o nmero de campos acessado pelo componente
que no necessariamente igual ao nmero de campos reais da tabela representada pelo componente.
Uma forma de se alterar o nmero de campos acessados pela tabela consiste em utilizar o Fields Editor,
que permite que se definam os campos da tabela que sero realmente acessados pelo componente.
FIELDS
Essa propriedade definida como uma array de objetos da classe TField, e permite o acesso a campos
individuais do registro corrente da tabela representada pelo componente.
Nesse caso, o primeiro campo representado pelo ndice 0, sendo o n-zimo campo representado pelo
ndice n-1.
importante lembrar que esses campos so aqueles realmente acessados pelo componente, e no so
necessariamente todos os campos da tabela por ele representada.
Para acessar os valores armazenados em cada campo acessado pelo componente, deve-se utilizar uma
das propriedades de converso da classe TField, dentre as quais podem-se destacar:
AsString, para tratar o valor armazenado no campo como uma string.
AsInteger, para tratar o valor armazenado no campo como um nmero inteiro.
AsFloat, para tratar o valor armazenado no campo como um nmero real.
AsBoolean, para tratar o valor armazenado no campo como um valor booleano.
AsCurrency, para tratar o valor armazenado no campo como um valor monetrio.
AsDateTime, para tratar o valor armazenado no campo como um valor no formato Data/Hora.
AsVariant, para tratar o valor armazenado no campo como um valor do Variant (que pode
armazenar qualquer tipo de dado).
Dessa maneira, se quisermos exibir o valor armazenado no dcimo campo acessado pelo componente,
devemos empregar uma linha de cdigo com a seguinte sintaxe:
ShowMessage(Table1.Fields[9].AsString);
Nesse caso, Table1 o nome do componente que representa a tabela.
FIELDVALUES
Essa propriedade definida como uma array de valores do tipo Variant, indexado pelos nomes dos
campos da tabela representada pelo componente. interessante destacar que essa a propriedade de-
fault da classe TDataSet e das classes dela derivadas por herana. Conseqentemente, se TblPais o nome
de um componente de uma classe derivada de TDataSet, as linhas de cdigo a seguir so equivalentes.
TblPais[Nome] := Brasil;
TblPais.FieldValues[Nome] := Brasil;
FILTER
Essa propriedade definida como uma varivel do tipo string, e permite que se estabelea uma condio
(filtro) a ser atendida pelos registros da tabela acessada por esse componente.
Para que essa condio seja aplicada, deve-se, no entanto, definir como True o valor da propriedade
Filtered do componente.
FILTERED
Essa propriedade definida como uma varivel booleana, e define se os registros provenientes da
tabela representada pelo componente devem ou no atender a uma condio (filtro) especificada na
sua propriedade Filter (definida anteriormente) ou por um cdigo inserido no procedimento associado
ao seu evento OnFilterRecord.
FILTEROPTIONS
Essa propriedade definida como uma varivel do tipo TFilterOptions que , por sua vez, um conjunto
de elementos do tipo TFilterOption, sendo esses elementos definidos da seguinte maneira:
foCaseInsensitive: No diferencia letras maisculas e minsculas na aplicao do filtro.
foNoPartialCompare: No permite que se utilize um asterisco para definir comparaes parciais
na aplicao de um filtro. Esse elemento deve ser includo quando se quer tratar o asterisco (*)
como um caractere do filtro.
Inicialmente, essa propriedade definida como um conjunto vazio, isto , por default nenhuma das
condies anteriores especificada.
RECNO
Essa propriedade definida como uma varivel inteira, e define o nmero do registro corrente, dentre
todos os registros provenientes da tabela representada pelo componente. uma propriedade apenas
de leitura, e no pode ter o seu valor diretamente alterado pelo usurio, podendo ter o seu valor
alterado em funo da aplicao de um filtro.
RECORDCOUNT
Essa propriedade definida como uma varivel inteira, e define o nmero de registros provenientes da
tabela representada pelo componente. uma propriedade apenas de leitura, e no pode ter o seu valor
diretamente alterado pelo usurio, podendo, no entanto, ter o seu valor alterado em funo da aplicao
de um filtro.
STATE
Essa propriedade uma varivel do tipo TDataSetState que define os estados que podem ser assumidos
por uma tabela representada pelo componente. Essa propriedade s est disponvel durante a execuo
do aplicativo, e, por ser uma propriedade apenas de leitura, no pode ter o seu valor diretamente
alterado pelo usurio.
Essa propriedade pode assumir um dos valores descritos a seguir:
dsInactive: A tabela est inativa, ou seja, sua propriedade Active igual a false.
dsBrowse: A tabela est sendo consultada. Os registros podem ser visualizados, mas no podem
ser alterados.
dsEdit: A tabela est sendo editada.
dsFilter: O procedimento associado ao evento OnFilterRecord est sendo executado.
dsInsert: A tabela est em modo de Insero (um novo registro foi includo na tabela).
dsSetKey: A tabela est sendo reindexada (aplica-se apenas a objetos da classe TTable, derivada
por herana da classe TDataSet).
dsCalcFields: O procedimento associado ao evento OnCalcFields est sendo executado.
dsNewValue: Estado temporrio, utilizado para indicar que a propriedade NewValue de um
objeto da classe TField est sendo acessada.
dsOldValue: Estado temporrio, utilizado para indicar que a propriedade OldValue de um objeto
da classe TField est sendo acessada.
dsCurValue: Estado temporrio, utilizado para indicar que a propriedade CurValue de um objeto
da classe TField est sendo acessada.
PRINCIPAIS MTODOS DA CLASSE TDATASET
Apresenta-se a seguir os principais mtodos da classe TDataset, sendo a maioria desses mtodos virtuais
ou abstratos (implementados nas classes derivadas).
APPEND
Declarao
procedure Append;
Esse mtodo adiciona um novo registro aps o ltimo registro existente na tabela representada pelo
componente.
APPENDRECORD
Declarao
procedure AppendRecord(const Values: array of const);
Esse mtodo adiciona e grava um novo registro aps o ltimo registro existente na tabela representada
pelo componente, atribuindo aos campos do registro valores passados como parmetros na chamada
do mtodo.
CANCEL
Declarao
procedure Cancel; virtual;
Esse mtodo cancela as alteraes realizadas no registro corrente da tabela representada pelo
componente, desde a ltima chamada ao seu mtodo Post.
CLEARFIELDS
Declarao
procedure ClearFields;
Esse mtodo apaga os valores armazenados nos campos do registro corrente da tabela representada
pelo componente, desde que a tabela esteja em modo de edio ou insero, gerando uma exceo em
caso contrrio.
CLOSE
Declarao
procedure Close;
Esse mtodo desfaz a conexo tabela representada pelo componente, atribuindo o valor False
propriedade Active do componente, como mostra o trecho de cdigo a seguir, extrado da unit db.pas.
procedure TDataSet.Close;
begin
Active := False;
end;
CREATE
Declarao
constructor Create(AOwner: TComponent);
Esse mtodo o mtodo construtor da classe, e recebe como parmetro um objeto da classe TComponent,
que indica o seu componente proprietrio.
DELETE
Declarao
procedure Delete;
Esse mtodo remove o registro corrente da tabela representada pelo componente, definindo o prximo
registro como registro atual.
DESTROY
Declarao
destructor Destroy;
Esse mtodo o mtodo destrutor da classe, devendo ser utilizado apenas quando uma instncia da
classe criada dinamicamente pelo cdigo da aplicao (mediante uma chamada ao mtodo Create do
componente que representa a tabela).
DISABLECONTROLS
Declarao
procedure DisableControls;
Esse mtodo desconecta temporariamente todos os componentes associados ao componente que
representa a tabela.
EDIT
Declarao
procedure Edit;
Esse mtodo coloca a tabela representada pelo componente em modo de edio, permitindo que se
alterem os valores armazenados nos campos do registro corrente.
ENABLECONTROLS
Declarao
procedure EnableControls;
Esse mtodo restabelece a conexo a todos os componentes associados ao componente que representa
a tabela, cuja conexo tenha sido desabilitada por uma chamada ao mtodo DisableControls.
FIELDBYNAME
Declarao
function FieldByName(const FieldName: string): TField;
Esse mtodo retorna um objeto da classe TField que representa o campo cujo nome passado como
parmetro na chamada ao mtodo.
O valor retornado pelo mtodo pode, evidentemente, ser tratado como um objeto da classe TField, e as
propriedades de converso descritas anteriormente podem ser utilizadas normalmente.
A utilizao desse mtodo apresenta, em relao propriedade Fields, a vantagem de se poder
desconsiderar a ordem exata dos campos, bastando que se conhea o nome de cada um deles.
FINDFIELD
Declarao
function FindField(const FieldName: string): TField;
Esse mtodo determina se o componente acessa um campo cujo nome passado como parmetro na
forma de uma string, retornando um objeto da classe TField que representa o campo caso o mesmo
exista, e retornando nil em caso contrrio.
FIRST
Declarao
procedure First;
Esse mtodo define o primeiro registro da tabela representada pelo componente como registro corrente.
Alm disso, antes de alterar o registro corrente grava qualquer alterao pendente, mediante uma
chamada implcita ao mtodo Post do componente.
INSERT
Declarao
procedure Insert;
Esse mtodo insere um novo registro na posio definida pelo registro corrente.
INSERTRECORD
Declarao
procedure InsertRecord(const Values: array of const);
Esse mtodo insere e grava um novo registro na posio definida pelo registro corrente da tabela
representada pelo componente, atribuindo aos campos do registro valores passados como parmetros
na chamada do mtodo.
ISEMPTY
Declarao
function IsEmpty: Boolean;
Esse mtodo retorna True se a tabela representada pelo componente no tiver nenhum registro,
retornando False em caso contrrio.
ISLINKEDTO
Declarao
function IsLinkedTo(DataSource: TDataSource): Boolean;
Esse mtodo retorna True se o componente que representa a tabela estiver ligado a um componente
DataSource, cujo nome passado como parmetro na chamada ao mtodo, retornando False em caso
contrrio.
LAST
Declarao
procedure Last;
Esse mtodo define o ltimo registro da tabela representada pelo componente como registro corrente.
LOCATE
Declarao
function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions):
Boolean; virtual;
Esse mtodo permite a busca exata de um registro, por campos que no faam parte do ndice corrente
da tabela representada pelo componente, e recebe como parmetros:
Uma string contendo os nomes dos campos pelos quais ser feita a pesquisa (separados por
ponto-e-vrgula).
Uma string contendo os valores a serem pesquisados nos campos pelos quais ser feita a pesquisa
(separados por ponto-e-vrgula).
Um conjunto de opes, que pode conter os seguintes elementos: LoCaseInsensitive se esse
elemento for includo, letras maisculas e minsculas sero tratadas indiferentemente;
LoPartialKey indica que a pesquisa ser aproximada.
MOVEBY
Declarao
function MoveBy(Distance: Integer): Integer;
Esse mtodo redefine o registro atual, deslocando o ponteiro ou cursor que representa o registro
atual da tabela representada pelo componente por um nmero de registros que passado como nico
parmetro na chamada do mtodo.
NEXT
Declarao
procedure Next;
Esse mtodo define o prximo registro da tabela representada pelo componente como registro corrente.
Na realidade, esse mtodo faz uma chamada ao mtodo MoveBy da classe, passando o valor 1 como
parmetro, como mostra o trecho de cdigo reproduzido a seguir e extrado da unit db.pas.
procedure TDataSet.Next;
begin
MoveBy(1);
end;
OPEN
Declarao
procedure Open;
Esse mtodo estabelece a conexo tabela representada pelo componente, atribuindo o valor True
sua propriedade Active, como mostra o trecho de cdigo a seguir, extrado da unit db.pas.
procedure TDataSet.Open;
begin
Active := True;
end;
POST
Declarao
procedure Post; virtual;
Esse mtodo grava as alteraes feitas no registro atual da tabela representada pelo componente. As
alteraes feitas anteriormente a uma chamada ao mtodo Post no podem ser canceladas mediante
uma chamada ao mtodo Cancel (para que isso seja possvel, deve-se empregar o conceito de transaes,
a ser descrito posteriormente).
PRIOR
Declarao
procedure Prior;
Esse mtodo define o registro anterior da tabela representada pelo componente como registro corrente.
Na realidade, esse mtodo faz uma chamada ao mtodo MoveBy da classe, passando o valor -1 como
parmetro, como mostra o trecho de cdigo a seguir, extrado da unit db.pas.
procedure TDataSet.Prior;
begin
MoveBy(-1);
end;
REFRESH
Declarao
procedure Refresh;
Esse mtodo atualiza a exibio dos dados armazenados em uma tabela nos componentes de visualizao
conectados ao componente que representa a tabela. Uma situao em que deve ser feita uma chamada
ao mtodo refresh do componente corresponde quela em que a aplicao de um filtro cancelada
(modificando-se o valor da sua propriedade Filtered para False).
SETFIELDS
Declarao
procedure SetFields(const Values: array of const);
Esse mtodo permite que se atribuam simultaneamente valores a vrios campos do registro corrente da
tabela representada pelo componente. Os valores devem ser fornecidos na ordem em que os campos
so armazenados na tabela.
Para executar esse mtodo a tabela deve estar em modo de edio, o que pode ser garantido por uma
chamada ao mtodo Edit do componente que a representa.
PRINCIPAIS EVENTOS DA CLASSE TDATASET
Apresenta-se a seguir uma descrio dos principais eventos da classe TDataSet.
AFTERCANCEL
O procedimento associado a esse evento executado imediatamente aps se cancelarem as alteraes
feitas no registro corrente, normalmente aps uma chamada ao mtodo Cancel do componente que
Na realidade, o mtodo Cancel faz uma chamada a um mtodo protegido da classe TDataSet,
denominado DoAfterCancel, que verifica se existe um procedimento associado ao evento e, em caso
positivo, o executa.
AFTERCLOSE
O procedimento associado a esse evento executado imediatamente aps se interromper a conexo
estabelecida entre a tabela e o componente que a representa, normalmente aps uma chamada ao seu
mtodo Close, ou atribuindo-se o valor False sua propriedade Active.
Na realidade, o mtodo Close, ao atribuir o valor False propriedade Active, provoca uma chamada a
um mtodo protegido da classe TDataSet, denominado DoAfterClose, que verifica se existe um
procedimento associado ao evento e, em caso positivo, o executa. O mesmo feito pelo mtodo interno
SetActive, responsvel pela atribuio de um valor ao campo que armazena internamente o valor da
propriedade Active.
AFTERDELETE
O procedimento associado a esse evento executado imediatamente aps se remover o registro corrente,
normalmente aps uma chamada ao mtodo Delete do componente que representa a tabela.
Na realidade, o mtodo Delete faz uma chamada a um mtodo protegido da classe TDataSet,
denominado DoAfterDelete, que verifica se existe um procedimento associado ao evento e, em caso
AFTEREDIT
O procedimento associado a esse evento executado imediatamente aps se colocar a tabela representada
pelo componente em modo de edio.
Na realidade, o mtodo Edit faz uma chamada a um mtodo protegido da classe TDataSet, denominado
DoAfterEdit, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa.
AFTERINSERTT
O procedimento associado a esse evento executado imediatamente aps a insero de um novo
registro na tabela representada pelo componente.
Na realidade, os mtodos Insert e Append fazem uma chamada a um mtodo protegido da classe
TDataSet, denominado DoAfterInsertt, que verifica se existe um procedimento associado a esse evento
e, em caso positivo, o executa.
AFTEROPEN
O procedimento associado a esse evento executado imediatamente aps se estabelecer a conexo
entre a tabela e o componente que a representa, normalmente aps uma chamada ao seu mtodo
Open, ou atribuindo-se o valor True sua propriedade Active.
Na realidade, o mtodo Open, ao atribuir o valor True propriedade Active, faz uma chamada a um
mtodo protegido da classe TDataSet, denominado DoAfterOpen, que verifica se existe um
procedimento associado ao evento e, em caso positivo, o executa. O mesmo feito pelo mtodo
interno SetActive, responsvel pela atribuio de um valor ao campo que armazena internamente o
valor da propriedade Active.
AFTERPOST
O procedimento associado a esse evento executado imediatamente aps a gravao das alteraes
feitas no registro corrente da tabela representada pelo componente, normalmente aps uma chamada
ao seu mtodo Post.
Na realidade, o mtodo Post faz uma chamada a um mtodo protegido da classe TDataSet, denominado
DoAfterPost, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa.
AFTERSCROLL
O procedimento associado a esse evento executado imediatamente aps uma movimentao para
um outro registro da tabela (que passa a ser o registro corrente), normalmente aps uma chamada aos
seus mtodos First, Prior, Next e Last, dentre outros.
Na realidade, esses mtodos fazem uma chamada a um mtodo protegido da classe TDataSet,
denominado DoAfterScroll, que verifica se existe um procedimento associado ao evento e, em caso
BEFORECANCEL
O procedimento associado a esse evento executado imediatamente antes de se cancelarem as alteraes
feitas no registro corrente, normalmente aps uma chamada ao mtodo Cancel do componente que
Na realidade, o mtodo Cancel faz uma chamada a um mtodo protegido da classe TDataSet,
denominado DoBeforeCancel, que verifica se existe um procedimento associado ao evento e, em caso
BEFORECLOSE
O procedimento associado a esse evento executado imediatamente antes de se interromper a conexo
estabelecida entre a tabela e o componente que a representa, normalmente aps uma chamada ao seu
mtodo Close, ou atribuindo-se o valor False sua propriedade Active.
Na realidade, o mtodo Close faz uma chamada a um mtodo protegido da classe TDataSet, denominado
DoBeforeClose, que verifica se existe um procedimento associado ao evento e, em caso positivo, o
executa. O mesmo feito pelo mtodo interno SetActive, responsvel pela atribuio de um valor ao
campo que armazena internamente o valor da propriedade Active.
BEFOREDELETE
O procedimento associado a esse evento executado imediatamente antes de se remover o registro
corrente, normalmente aps uma chamada ao mtodo Delete do componente que representa a tabela.
Na realidade, o mtodo Delete faz uma chamada a um mtodo protegido da classe TDataSet,
denominado DoBeforeDelete, que verifica se existe um procedimento associado ao evento e, em
caso positivo, o executa.
BEFOREEDIT
O procedimento associado a esse evento executado imediatamente antes de se colocar a tabela
representada pelo componente em modo de edio.
Na realidade, o mtodo Edit faz uma chamada a um mtodo protegido da classe TDataSet, denominado
DoBeforeEdit, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa.
BEFOREINSERTT
O procedimento associado a esse evento executado imediatamente antes da insero de um novo
registro na tabela representada pelo componente.
Na realidade, os mtodos Insert e Append fazem uma chamada a um mtodo protegido da classe
TDataSet, denominado DoBeforeInsertt, que verifica se existe um procedimento associado ao evento
e, em caso positivo, o executa.
BEFOREOPEN
O procedimento associado a esse evento executado imediatamente antes de se estabelecer a conexo
entre a tabela e o componente que a representa, normalmente aps uma chamada ao seu mtodo
Open, ou atribuindo-se o valor True sua propriedade Active.
Na realidade, o mtodo Open faz uma chamada a um mtodo protegido da classe TDataSet, denominado
DoBeforeOpen, que verifica se existe um procedimento associado ao evento e, em caso positivo, o
executa. O mesmo feito pelo mtodo interno SetActive, responsvel pela atribuio de um valor ao
campo que armazena internamente o valor da propriedade Active.
BEFOREPOST
O procedimento associado a esse evento executado imediatamente antes da gravao das alteraes
feitas no registro corrente da tabela representada pelo componente, normalmente aps uma chamada
ao seu mtodo Post.
Na realidade, o mtodo Post faz uma chamada a um mtodo protegido da classe TDataSet, denominado
DoBeforePost, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa.
BEFORESCROLL
O procedimento associado a esse evento executado imediatamente antes de uma movimentao
para um outro registro da tabela (que passa a ser o registro corrente), normalmente aps uma chamada
aos seus mtodos First, Prior, Next e Last, dentre outros.
Na realidade, esses mtodos fazem uma chamada a um mtodo protegido da classe TDataSet,
denominado DoBeforeScroll, que verifica se existe um procedimento associado ao evento e, em caso
ONCALCFIELDS
O procedimento associado a esse evento executado sempre que os valores dos campos calculados da
tabela representada pelo componente precisam ser calculados.
ONDELETEERROR
O procedimento associado a esse evento executado sempre que a tentativa de se remover um registro
da tabela, em uma chamada ao seu mtodo Delete, falha.
ONFILTERRECORD
O procedimento associado a esse evento executado sempre que se aplica um filtro aos registros da
tabela, devendonesse procedimento ser estabelecida a condio a ser atendida pelos registros. A aplicao
de um filtro a uma tabela pode ser feita atribuindo-se o valor True sua propriedade Filtered.
ONNEWRECORD
O procedimento associado a esse evento executado sempre que se adiciona um novo registro tabela
representada pelo componente, mediante uma chamada ao mtodo Append ou Insert, podendo ser
utilizado para se definir valores default para os campos do registro recm-criado.
ONPOSTERROR
O procedimento associado a esse evento executado sempre que a tentativa de se gravar um registro
da tabela, em uma chamada ao seu mtodo Post, falha.
Conforme ser visto nos prximos captulos, as classes de acesso a dados via BDE, ADO, DBExpress e
Interbase Express no so derivadas diretamente da classe TDataSet, mas de outras classes dela derivadas,
e que so:
TCustomADODataSet, para acesso via ADO.
TBDEDataSet e TDBDataset, para acesso via BDE.
TIBCustomDataset, para acesso via Interbase Express.
TCustomSQLDataSet, para acesso via DBExpress.
A classes TClientDataset e TSQLClientDataset so derivadas diretamente da classe TCustomClientDataset.
A CLASSE TCUSTOMCONNECTION
A classe TCustomConnection derivada por herana direta da classe TComponent, sendo a classe-
base de classes usada para fazer uma conexo a um banco de dados atravs do BDE (componente
TDatabase), ADO (componente TADOConnection), InterbaseExpress (TIBDatabase) e DBExpress
(TSQLConnection).
PRINCIPAIS PROPRIEDADES DA CLASSE TCUSTOMCONNECTION
Apresenta-se a seguir uma descrio das principais propriedades da classe TCustomConnection, alm
daquelas herdadas das suas classes ancestrais.
CONNECTED
Essa propriedade definida como uma varivel booleana e define se a conexo foi estabelecida.
DATASETCOUNT
Essa propriedade definida como uma varivel inteira e define o nmero de componentes derivados
da clase TDataset linkados a este componente de conexo.
DATASETS
Essa propriedade uma array de objetos de classes derivadas da classe TDataset, e permite acessar os
componentes linkados a este componente de conexo.
LOGINPROMPT
Essa propriedade definida como uma varivel booleana e define se uma caixa de dilogo dever ser
exibida quando se estabelece uma conexo.
STREAMEDCONNECTED
Essa propriedade definida como uma varivel booleana e define se a conexo estava ativa quando o
componente responsvel pela conexo foi carregado a partir de um stream.
PRINCIPAIS MTODOS DA CLASSE TCUSTOMCONNECTION
Apresenta-se a seguir uma descrio dos principais mtodos da classe TCustomConnection, alm
daqueles herdados das suas classes ancestrais.
CLOSE
Declarao
procedure Close;
Esse mtodo encerra uma conexo (equivale a definir a propriedade Connected como False).
DOCONNECT
Declarao
procedure DoConnect; virtual;;
Esse mtodo estabelece a conexo ao banco de dados (usado pela propriedade connected para estabelecer
a conexo).
DODISCONNECT
Declarao
procedure DoDisConnect; virtual;;
Esse mtodo finaliza a comexo ao banco de dados (usado pela propriedade comnected para finalizar
a conexo).
GETCONNECTED
Declarao
function GetConnected: Boolean; virtual;
Esse mtodo retorna o valor armazenado na propriedade Connected.
GETDATASET
Declarao
function GetDataSet(Index:Integer): TDataSet; virtual;
Esse mtodo retorna uma referncia a um dos objetos derivados da classe TDataset vinculados a esta
conexo, recebendo como parmetro o ndice que define o objeto na propriedade Datasets.
GETDATASETCOUNT
Declarao
function GetDataSetCount: Integer; virtual;
Esse mtodo retorna o valor armazenado na propriedade DatasetCount.
LOADED
Declarao
procedure Loaded; override;
Esse mtodo carrega o componente de conexo aps todos os outros componentes do formulrio ou
Datamodule terem sido carregados na memria.
DELETEINDEX
Declarao
procedure DeleteIndex(const Name: string);
Esse mtodo remove o ndice cujo nome passado como parmetro na forma de uma string.
OPEN
Declarao
procedure Open;
Esse mtodo inicializa ou estabelece uma conexo.
SETCONNECTED
Declarao
procedure SetConnected(Value: Boolean); virtual;
Esse mtodo altera o valor da propriedade Connected, em funo do argumento passado como parmetro
na chamada do mtodo.
PRINCIPAIS EVENTOS DA CLASSE TCUSTOMCONNECTION
Apresenta-se a seguir uma descrio dos principais mtodos da classe TCustomConnection, alm
daqueles herdados das suas classes ancestrais.
AFTERCONNECT
Esse evento ocorre assim que uma conexo estabelecida.
AFTERDISCONNECT
Esse evento ocorre assim que uma conexo encerrada.
BEFORECONNECT
Esse evento ocorre antes que uma conexo seja estabelecida.
BEFOREDISCONNECT
Esse evento ocorre antes que uma conexo seja encerrada.
ONLOGIN
O procedimento associado a esse evento executado sempre que se estabelece uma nova conexo ao
banco de dados representado pelo componente, e o valor da sua propriedade LoginPrompt igual a True.
Esse procedimento tem, entre seus parmetros, um objeto da classe TStrings chamado LogimParams
no qual devem ser fornecidos os valores dos parmetros USERNAME e PASSWORD, para permitir o
acesso ao banco de dados.
Caso se esteja utilizando a caixa de dilogo padro de Login, no h necessidade de se codificar esse
procedimento.
CAPTULO 23 BANCO DE DADOS COMPONENTES DE ACESSO VIA BDE
Captulo
Banco de Dados Componentes
de Acesso via BDE
23
Neste captulo sero apresentados as classes e os componentes responsveis pelo acesso a dados via
BDE, a partir de uma aplicao VCL desenvolvida com o Borland Delphi 7. importante destacar,
inicialmente, que este mecanismo de acesso s est disponvel para aplicaes baseadas na VCL
(inexistindo para aplicaes baseadas na CLX).
Este mecanismo est presente desde a primeira verso do Delphi, e j enorme a base de aplicaes
desenvolvidas com bvase nesta tecnologia. Por estas e outras razes, o BDE continua presente nesta
nova verso do Delphi, embora seu desenvolvimento esteja descontinuado.
KNOW-HOW EM: CLASSES FUNDAMENTAIS DE ACESSO A BANCOS DE
DADOS VIA BDE AS CLASSES TBDEDATASET E TDBDATASET
PR-REQUISITOS
Compreenso da classe TDataset.
METODOLOGIA
Apresentao das classes e dos componentes de acesso a bancos de dados via BDE, juntamente com uma descrio das suas propriedades,
mtodos e eventos.
TCNICA
Descrio das classes e dos componentes de acesso a bancos de dados e apresentao de exemplos de aplicao.
Inicialmente apresentaremos as classes derivadas de TDataset que implementam as principais
funcionalidades do Borland Database Engine e depois os componentes efetivamente usados no
desenvolvimento de aplicaes.
Alguns autores apresentam uma vasta coletnea de funes da API do BDE. Como as classes e
componentes definidas pelo Delphi possuem justamente a finalidade de evitar que o desenvolvedor
precise manipular diretamente estas funes, s as citarei quando isto for realmente indispensvel.
Afinal de contas, se voc gostasse de programar usando diretamente funes de APIs, provavelmente
no estaria usando o Delphi como ferramenta de desenvolvimento, mas um compilador C e as funes
da API do Windows.
A CLASSE TBDEDATASET
Conforme descrito anteriormente, a classe TDataSet implementa a funcionalidade genrica para acesso
a tabelas, sem incorporar as funes da API do Borland Database Engine o primeiro mecanismo de
acesso a banco de dados criado pela Borland.
A classe TBDEDataSet, derivada por herana direta da classe TDataSet, incorpora a API do Borland
DataBase Engine a alguns dos mtodos declarados na classe TDataSet, sobrecarregando-os (no caso de
mtodos virtuais) ou implementando-os (no caso de mtodos abstratos).
Alm disso, redefine como published propriedades e eventos declarados na seo public da classe-base,
tornando-os acessveis pelo Object Inspector.
Os mtodos implementados por essa classe no so normalmente usados no desenvolvimento de
aplicaes em Delphi, pois geralmente so utilizados componentes representados por classes derivadas
por herana da classe TBDEDataSet.
PRINCIPAIS PROPRIEDADES DA CLASSE TBDEDATASET
Apresenta-se a seguir uma descrio das principais propriedades implementadas na classe TDataSet.
CACHEDUPDATES
Essa propriedade definida como uma varivel booleana, e define se o recurso de cached updates ser
utilizado ou no pelo componente.
O recurso de cached updates permite que uma aplicao obtenha um conjunto de registros de uma
base de dados e faa sua edio local (que pode abranger edio, incluso ou remoo de registros) e
posterior atualizao das informaes na base de dados.
Alm de reduzir o trfego de informaes em redes, esse recurso permite o cancelamento de alteraes
feitas de forma indesejada.
Para habilitar o recurso de cached updates, basta definir como True o valor da propriedade
CachedUpdates do componente que representa a tabela.
A atualizao dos registros na base de dados feita mediante uma chamada aos mtodos ApplyUpdates
e CommitUpdates do componente que representa a tabela. O cancelamento das alteraes feito
mediante uma chamada ao mtodo CancelUpdates desse mesmo componente.
PRINCIPAIS MTODOS DA CLASSE TBDEDATASET
Apresenta-se a seguir uma descrio dos principais mtodos da classe TBDEDataSet, alm daquelas
herdadas das suas classes-base.
APPLYUPDATES
Declarao
procedure ApplyUpdates;
Esse mtodo armazena no banco de dados as alteraes feitas localmente. Essas alteraes, no entanto,
s so efetivadas aps uma chamada ao mtodo Commit do componente TDatabase que representa o
banco de dados, se este estiver sendo empregado.
CANCELUPDATES
Declarao
procedure CancelUpdates;
Esse mtodo cancela as alteraes feitas localmente, para um componente que representa uma tabela
em que o recurso de Cached Updates est habilitado.
COMMITUPDATES
Declarao
procedure CommitUpdates;
Esse mtodo limpa o buffer de alteraes locais, para um componente que representa uma tabela em
que o recurso de Cached Updates est habilitado.
LOCATE
Declarao
Boolean;
Esse mtodo permite a busca de um registro por campos que no faam parte do ndice corrente da
tabela. Recebe como parmetros:
ponto-e-vrgula).
Uma array do tipo Variant contendo os valores a serem pesquisados nos campos pelos quais
ser feita a pesquisa (separados por ponto-e-vrgula).
Um conjunto de opes, que pode conter os seguintes elementos:
LoCaseInsensitive: Se esse elemento for includo, letras maisculas e minsculas sero tratadas
indiferentemente.
LoPartialKey: A pesquisa ser aproximada.
A CLASSE TDBDATASET
A classe TDBDataSet derivada por herana direta da classe TBDEDataSet, sendo a ancestral direta das
classes que representam os componentes freqentemente utilizados no acesso a tabelas definidas em
um banco de dados via BDE TTable, TQuery e TStoredProc (este utilizado nas aplicaes que acessam
bancos de dados que implementam a filosofia cliente-servidor).
Diferentemente da classe TBDEDataSet, esta implementa propriedades e mtodos utilizados
freqentemente no desenvolvimento de aplicaes para acesso a bancos de dados em Delphi, ainda
que utilizando em componentes representados por classes dela derivadas.
PRINCIPAIS PROPRIEDADES DA CLASSE TDBDATASET
Apresenta-se a seguir uma descrio das principais propriedades da classe TDBDataSet, alm daquelas
DATABASE
Essa propriedade definida como um objeto da classe TDatabase, e permite o acesso s propriedades e
mtodos do componente que representa o banco de dados ao qual se est conectado.
importante lembrar que, se nenhum componente TDataBase for explicitamente includo na aplicao,
uma instncia dessa classe ser gerada automaticamente pelo Delphi.
DATABASENAME
Essa propriedade definida como uma varivel do tipo string, e define o nome do banco de dados ao
qual o componente est conectado. Pode ser o nome de um alias definido no Borland Database Engine
ou o nome definido na propriedade DataBaseName do componente Database associado e, no caso de
tabelas locais do dBASE e Paradox, por exemplo, pode ser definida como o diretrio no qual as tabelas
esto armazenadas.
DBSESSION
Essa propriedade definida como um objeto da classe TSession, e define o nome do componente
Session associado ao componente TDatabase que representa o banco de dados ao qual se est conectado.
Se o componente no estiver explicitamente conectado a um objeto TDatabase, este ser criado
dinamicamente e conectado ao objeto Session default, a ser criado dinamicamente pela aplicao.
SESSIONNAME
Essa propriedade definida como uma varivel do tipo string, e define o nome do objeto da classe
TSession associado ao componente TDatabase que representa o banco de dados ao qual se est conectado.
Se o componente no estiver explicitamente conectado a um objeto TDatabase, este ser criado
dinamicamente e conectado ao objeto Session default, a ser criado dinamicamente pela aplicao.
A CLASSE TDATABASE
A classe TDatabase derivada por herana direta da classe TComponent, sendo normalmente utilizada
para se estabelecer uma conexo a um banco de dados.
Essa classe permite que se incorpore o conceito de transaes no acesso a um banco de dados atravs
de uma aplicao desenvolvida em Delphi, alm de permitir a personalizao das caixas de dilogo
utilizadas para validar o acesso de um usurio ao banco de dados representado pelo componente.
PRINCIPAIS PROPRIEDADES DA CLASSE TDATABASE
Apresenta-se a seguir uma descrio das principais propriedades da classe TDatabase.
ALIASNAME
Essa propriedade definida como uma varivel do tipo string, e define o nome do alias, definido no
Borland Database Engine, que representa o banco de dados que est sendo acessado.
DATABASENAME
Essa propriedade definida como uma varivel do tipo string, e define o nome pelo qual o componente
ser referenciado nos componentes a ele associados (definido-se esse valor na propriedade DatabaseName
desses componentes). No confundir com a sua propriedade Name, que define o nome pelo qual o
componente ser referenciado no cdigo-fonte da aplicao.
DATASETS
Essa propriedade definida como um array de objetos da classe TDBDataSet, e que retorna um conjunto
de objetos da classe TDBDataSet (ou de classes delas derivadas por herana) associados ao banco de
dados representado por esse componente, e cuja conexo est ativa.
DIRECTORY
Essa propriedade definida como uma varivel do tipo string, e define o nome do diretrio de trabalho
para bancos de dados que manipulam tabelas no formato Paradox ou dBASE.
DRIVERNAME
Essa propriedade definida como uma varivel do tipo string, e define o nome de um driver do Borland
Database Engine.
As propriedades DatabaseName e AliasName so mutuamente excludentes. A especificao de um valor para uma dessas propriedades
anula o valor definido para a outra.
INTRANSACTION
Essa propriedade definida como uma varivel booleana, e define se existe uma transao em progresso
(o conceito de transaes ser apresentado no prximo captulo).
ISSQLBASED
Essa propriedade definida como uma varivel booleana, e define se a conexo est sendo feita atravs
de um driver SQL, ou localmente a tabelas dos tipos Paradox e dBASE.
KEEPCONNECTION
Essa propriedade definida como uma varivel booleana, e define se a conexo ao banco de dados
deve ser mantida, ainda que todas as conexes estabelecidas por componentes derivados da classe
TDataSet tenham sido encerradas.
PARAMS
Essa propriedade definida como um objeto da classe TStrings (lista de strings) e pode ser usada para
armazenar as definies dos parmetros que devem ser informados quando se estabelece uma conexo
ao banco de dados representado pelo componente.
SESSION
Essa propriedade definida como um objeto da classe TSession, e define o nome do objeto da classe
TSession ao qual o componente est conectado. Se nenhum componente da classe TSession for
explicitamente includo na aplicao, ser usado um objeto da classe TSession criado dinamicamente
pela aplicao.
TRANSISOLATION
Essa propriedade especifica o nvel de isolamento das transaes gerenciadas pelo BDE, determinando
como vrias transaes independentes se relacionam. Essa propriedade pode assumir os valores descritos
na tabela a seguir:
tiDirtyRead: Permite a leitura de alteraes feitas por outras transaes simultneas, mas ainda
no confirmadas por uma chamada ao mtodo Commit.
TiReadCommitted: Permite apenas a leitura de alteraes feitas por outras transaes
simultneas, mas que j tenham sido confirmadas por uma chamada ao mtodo Commit.
Este o valor default dessa propriedade.
TiRepeatableRead: A transao no enxerga qualquer alterao feita por outras transaes que
atuam simultaneamente. Esse nvel de isolamento garante que, uma vez que uma transao
leia um registro, essa viso do registro no se altere a menos que a prpria transao efetue
alteraes no registro.
PRINCIPAIS MTODOS DO COMPONENTE DATABASE
Os principais mtodos do componente Database, e o significado de cada um deles, so apresentados a seguir.
APPLYUPDATES
Declarao
procedure ApplyUpdates(const DataSets: array of TDBDataSet);
Esse mtodo aplica as alteraes pendentes em componentes derivados da classe TDataSet associados
a esse componente (e passados como parmetros na chamada ao mtodo, na forma de um array de
objetos da classe TDBDataSet), para os quais a propriedade CachedUpdates possui o valor True.
CLOSEDATASETSS
Declarao
procedure CloseDatasets;
Esse mtodo encerra as conexes estabelecidas em componentes derivados da classe TDataSet associados
a esse componente.
COMMIT
Declarao
procedure Commit;
Esse mtodo confirma a execuo de todos os comandos iniciados aps a ltima chamada ao mtodo
StartTransaction. Esse mtodo s pode ser executado se uma transao estiver sendo processada, o que
pode ser constatado verificando-se o valor da propriedade InTransaction. Aps uma chamada ao mtodo
Commit, a propriedade InTransaction assume o valor False.
ROLLBACK
Declarao
procedure RollBack;
Esse mtodo cancela todos os comandos iniciados aps a ltima chamada ao mtodo StartTransaction.
Esse mtodo s pode ser executado se uma transao estiver sendo processada, o que pode ser constatado
verificando-se o valor da propriedade InTransaction. Aps uma chamada ao mtodo RollBack, a
propriedade InTransaction assume o valor False.
STARTTRANSACTION
Declarao
procedure StartTransaction;
Esse mtodo inicia uma nova transao, e s pode ser executado se no houver uma transao sendo
processada, isto , aps uma chamada ao mtodo Commit ou RollBack. Aps uma chamada ao mtodo
StartTransaction, a propriedade InTransaction assume o valor True.
A CLASSE TSESSION
A classe TSession derivada por herana direta da classe TComponent, sendo normalmente utilizada
para se estabelecer uma conexo a um banco de dados.
Essa classe permite que se gerenciem mltiplas conexes a bancos de dados a partir de uma nica
aplicao e que aplicaes precisando acessar tabelas Paradox em diretrios distintos de uma rede ou
compartilhado a tabelas utilizem vrios componentes da classe TSession.
PRINCIPAIS PROPRIEDADES DA CLASSE TSESSION
Apresenta-se a seguir uma descrio das principais propriedades da classe TSession.
ACTIVE
Essa propriedade determinada como uma varivel booleana, e define se a sesso est ativa. Atribuir
um valor False a essa propriedade gera as seguintes conseqncias:
A propriedade Connected dos componentes Database associados ao componente passa a ter o valor
False, bem como os componentes de classes derivadas de TDataSet associados a esses componentes da
classe TDatabase.
AUTOSESSIONNAME
Essa propriedade determinada como uma varivel booleana, e define se a sesso ter ou no um
nome gerado automaticamente (e armazenado na sua propriedade SessionName).
DATABASECOUNT
Essa propriedade determinada como uma varivel inteira, e define o nmero de componentes da
classe TDatabase associados ao componente.
DATABASES
Essa propriedade definida como um array de objetos da classe TDatabase, e que retorna um conjunto
de objetos da classe TDatabase associados ao componente, e cuja conexo est ativa.
KEEPCONNECTION
Essa propriedade determinada como uma varivel booleana, e define se a conexo ao banco de dados
criado temporariamente pelo componente deve ser mantida, ainda que todas as conexes estabelecidas
por componentes derivados da classe TDataSet a ele associados tenham sido encerradas.
NETFILEDIR
Essa propriedade determinada como uma varivel do tipo string, e define o nome do diretrio que
armazena o arquivo de controle de rede do BDE (arquivo PDOXUSRS.NET).
PRIVATEDIR
Essa propriedade determinada como uma varivel do tipo string, e define o nome do diretrio de
trabalho para bancos de dados que manipulam tabelas temporrias geradas pelo Borland database
Engine no formato Paradox ou dBASE.
SESSIONNAME
Essa propriedade determinada como uma varivel do tipo string, e define o nome pelo qual a sesso
representada pelo componente ser identificada nos componentes da classe TDatabase que estaro
conectados ao componente.
SQLHOURGLASS
Essa propriedade determinada como uma varivel booleana, e define se o cursor do mouse deve
apresentar o formato de uma ampulheta durante a execuo de operaes por parte do Borland Data-
base Engine (BDE).
TRACEFLAGS
Essa propriedade uma varivel do tipo TTraceFlags, e indica as operaes do Borland Database Engine
que devem ser monitoradas pelo utilitrio SQL Monitor.
A propriedade TTraceFlags um conjunto que pode conter os seguintes elementos:
TfQPrepare: Monitora operaes do tipo Prepare.
TfQExecute: Monitora operaes do tipo ExecSQL.
TfError: Monitora mensagens de erro do servidor.
TfStmt: Monitora todas as operaes decorrentes da execuo de declaraes SQL.
TfConnect: Monitora operaes de conexo a bancos de dados.
TfTransact: Monitora operaes de transaes, como as decorrentes de chamadas aos mtodos
StartTransaction, Commit e RollBack.
TfBlob: Monitora operaes com dados do tipo blob.
TfMisc: Monitora operaes que no sejam definidas pelos outros flags.
TfVendor: Monitora chamadas das funes da API do servidor de banco de dados.
TfDataIn: Monitora os dados recebidos do servidor.
TfDataOut: Monitora os dados enviados ao servidor.
PRINCIPAIS MTODOS DA CLASSE TSESSION
Apresenta-se a seguir uma descrio dos principais mtodos da classe TSession.
ADDALIAS
Declarao
procedure AddAlias(const Name, Driver: string; List: TStrings);
Esse mtodo permite que se crie um alias durante a execuo do aplicativo. Esse mtodo recebe como
parmetros uma string que define o nome do alias que est sendo criado, o driver do SQL Links para o
servidor de banco de dados para o qual o alias ser criado e um objeto da classe TStrings (uma lista de
strings) que define os parmetros para configurao do alias no BDE (esses parmetros variam de
acordo com o banco de dados selecionado e podem ser visualizados no SQL Explorer, exibido quando
voc seleciona o item Explore do menu Database).
ADDPASSWORD
Declarao
procedure AddPassword(const Password: string);
Esse mtodo permite que se adicione uma senha para acessar tabelas criptografadas do tipo Paradox,
sendo esta senha passada como parmetro na forma de uma string, durante a chamada ao mtodo.
ADDSTANDARDALIAS
Declarao
procedure AddStandardAlias(const Name, Path, DefaultDriver: string);
Esse mtodo semelhante ao mtodo AddAlias, mas recebe trs strings como parmetros. A primeira
define o alias que est sendo criado, a segunda o path a que o alias se refere e a terceira pode ser igual
a um dos seguintes valores: Paradox, dBASE ou ASCIIDRV. Para este ltimo parmetro, uma string
nula equivale a Paradox.
CLOSE
Declarao
procedure Close;
Esse mtodo encerra a sesso e todas as conexes realizadas por componentes da classe TDatabase
associados ao componente.
CLOSEDATABASE
Declarao
procedure CloseDatabase(Database: TDatabase);
Esse mtodo encerra a conexo realizada por um componente da classe TDatabase associado ao
componente, e cujo nome passado como parmetro na chamada do mtodo.
DELETEALIAS
Declarao
procedure DeleteAlias(const Name: string);
Esse mtodo faz justamente o inverso do mtodo AddAlias, isto , remove um alias do BDE. Esse
mtodo s tem um parmetro, que uma string contendo o nome do alias a ser removido.
FINDDATABASE
Declarao
function FindDatabase(const DatabaseName: string): TDatabase;
Esse mtodo verifica se entre os componentes da classe TDatabase associados ao componente existe
um componente cujo nome igual ao da string passada como parmetro na chamada desse mtodo.
GETALIASNAMES
Declarao
procedure GetAliasNames(List: TStrings);
Esse mtodo coloca, em um objeto da classe TStrings passado como parmetro, os nomes de todos os
alias configurados pelo BDE.
GETALIASPARAMS
Declarao
procedure GetAliasParams(const AliasName: string; List: TStrings);
Esse mtodo recebe como primeiro parmetro o nome de um alias (na forma de uma string) e retorna,
em um objeto da classe TStrings (que deve ser passado como segundo parmetro), os parmetros do
alias cujo nome foi fornecido.
ISALIAS
Declarao
function IsAlias(const Name: string): Boolean;
Esse mtodo recebe uma string como parmetro e determina se j existe um alias com o nome definido
por essa string.
GETTABLENAMES
Declarao
procedure GetTableNames(const DatabaseName, Pattern: string; Extensions, SystemTables:
Boolean; List: TStrings);
Esse mtodo recebe como parmetros:
O nome do banco de dados (que pode ser um componente TDataBase) cujos nomes das tabelas
se quer acessar.
Uma string que define um delimitador para as tabelas (deve ser nulo, quando se quer obter os
nomes de todas as tabelas).
Uma constante booleana que define se as extenses dos nomes das tabelas devem ser exibidas.
Uma outra constante booleana que define se os nomes das tabelas de sistema que definem a
estrutura das tabelas do banco de dados tambm devem ser obtidos (essa constante deve ter o
valor False para tabelas dos tipos Paradox e dBASE).
Um objeto da classe TStrings no qual sero armazenados os nomes das tabelas.
OPEN
Declarao
procedure Open;
Esse mtodo inicializa uma sesso e a define como sendo a sesso corrente.
OPENDATABASE
Declarao
function OpenDatabase(const DatabaseName: string): TDatabase;
Esse mtodo estabelece a conexo de um componente da classe TDatabase associado ao componente,
e cujo nome passado como parmetro na chamada do mtodo.
REMOVEALLPASSWORD
Declarao
procedure RemovePassword(const Password: string);
Esse mtodo permite que se removam todas as senhas definidas para acessar tabelas criptografadas do
tipo Paradox, estabelecidas anteriormente em chamadas ao mtodo AddPassword.
REMOVEPASSWORD
Declarao
Esse mtodo permite que se remova uma senha para acessar tabelas criptografadas do tipo Paradox,
sendo esta senha passada como parmetro na forma de uma string, durante a chamada ao mtodo.
EVENTOS DO COMPONENTE SESSION
Apresenta-se a seguir uma breve descrio dos eventos associados a esse componente.
ONPASSWORD
O procedimento associado a esse evento executado sempre que se tenta acessar um arquivo Paradox
que requer uma validao do usurio.
ONSTARTUP
O procedimento associado a esse evento executado sempre que a sesso representada pelo componente
ativada.
KNOW-HOW EM: CLASSES DE ACESSO DIRETO A BANCOS DE DADOS
VIA BDE AS CLASSES TTABLE E TQUERY
PR-REQUISITOS
Compreenso da classes TDataset, TBDEDataset e TDBDataset.
METODOLOGIA
Apresentao das classes e dos componentes de acesso direto a bancos de dados via BDE, juntamente com uma descrio das suas
propriedades, mtodos e eventos.
TCNICA
Descrio das classes e dos componentes de acesso direto a bancos de dados e apresentao de exemplos de aplicao.
Sero apresentadas neste tpico as classes usadas para acesso direto a bancos de dados via BDE as classes Ttable e TQuery.
A CLASSE TTABLE
A classe TTable derivada por herana direta da classe TDBDataSet, sendo normalmente utilizada para
se estabelecer uma conexo a uma tabela individual do banco de dados.
PRINCIPAIS PROPRIEDADES DA CLASSE TTABLE
Apresenta-se a seguir uma descrio das principais propriedades da classe TTable, alm daquelas herdadas
das suas classes ancestrais.
CANMODIFY
Essa propriedade definida como uma varivel booleana e define se a tabela pode ser acessada para
edio, insero e remoo de registros.
EXCLUSIVE
Essa propriedade definida como uma varivel booleana e define se a tabela ser acessada em modo
exclusivo pela aplicao. Se seu valor for igual a True, nenhuma outra aplicao poder acessar a
tabela, enquanto a mesma estiver sendo acessada pela aplicao corrente.
INDEXDEFS
Essa propriedade um objeto da classe TindexDefs e define os ndices da tabela.
INDEXFIELDCOUNT
Essa propriedade definida como uma varivel inteira e define o nmero de campos que compem o
ndice corrente.
INDEXFIELDNAMES
Essa propriedade definida como uma varivel do tipo string, que armazena os nomes dos campos que
compem o ndice corrente, separados por um ponto-e-vrgula.
As propriedades IndexName e IndexFieldNames so mutuamente excludentes, isto , a definio de um valor para uma propriedade
INDEXFIELDS
Essa propriedade definida como um array de objetos da classe TField correspondentes aos campos
que compem o ndice corrente.
INDEXNAME
Essa propriedade definida como uma varivel do tipo string e define o nome do ndice corrente da tabela.
MASTERFIELDS
Essa propriedade definida como uma varivel do tipo string e define os nomes dos campos da tabela
principal em um relacionamento (separados por um ponto-e-vrgula), devendo ser definida no
componente que representa a tabela secundria.
MASTERSOURCE
Essa propriedade definida como um objeto da classe TDataSource e define o nome do componente
DataSource ao qual est associado o componente da classe TTable que representa a tabela principal em
um relacionamento entre tabelas. Essa propriedade deve ser definida apenas no componente que
representa a tabela secundria no relacionamento.
READONLY
Essa propriedade definida como uma varivel booleana e define se a tabela pode ser acessada apenas
para visualizao de registros.
TABLENAME
Essa propriedade definida como uma varivel do tipo string e define os nomes da tabela representada
pelo componente.
TABLETYPE
Essa propriedade definida como uma varivel do tipo TTableType e pode receber um dos valores
descritos a seguir:
ttDefault: O tipo da tabela ser determinado em funo da extenso do nome do arquivo.
TtParadox: A tabela ser do tipo Paradox.
TtDBase: A tabela ser do tipo dBASE.
TtASCII: A tabela ser armazenada em um arquivo-texto no formato ASCII.
Se o valor desta for igual a ttDefault, o tipo de tabela ser baseado na extenso do nome do arquivo,
conforme descrito a seguir.
PRINCIPAIS MTODOS DA CLASSE TTABLE
Apresenta-se a seguir uma descrio dos principais mtodos da classe TTable, alm daqueles herdados
das suas classes ancestrais:
ADDINDEX
Declarao
procedure AddIndex(const Name, Fields: string; Options: TIndexOptions);
Esse mtodo adiciona um ndice tabela, recebendo como parmetros:
Uma string com o nome do ndice a ser criado.
Uma string com os nomes dos campos que formam o novo ndice (separados por ponto-e-vrgula).
Uma varivel do tipo TIndexOptions, que representa um conjunto que pode incluir os
seguintes elementos:
ixPrimary: Se o novo ndice for definido como a chave primria da tabela (no se aplica a
tabelas no formato dBASE).
ixUnique: Se o novo ndice no admitir duplicidade de valores.
ixDescending: Se os registros forem ordenados alfabeticamente de forma decrescente.
ixCaseInsensitive: Se no houver diferenciao entre letras maisculas e minsculas na
indexao dos campos (no se aplica a tabelas no formato dBASE).
ixExpression: O ndice ser baseado numa expresso (aplica-se apenas a tabelas no formato dBASE).
APPLYRANGE
Declarao
procedure ApplyRange;
Esse mtodo filtra os registros da tabela representada pelo componente, aplicando as condies definidas
por chamadas aos mtodos SetRangeStart, SetRangeEnd, EditRangeStart e EditRangeEnd.
BATCHMOVE
Declarao
function BatchMove(ASource: TBDEDataSet; AMode: TBatchMode): Longint;
Extenso Significado
DB Paradox
DBF dBASE
TXT ASCII
Esse mtodo move ou copia registros de outra tabela para a tabela representada pelo componente, e
recebe como parmetros:
Um objeto da classe TBDEDataSet, que define o componente que representa a tabela de onde
os registros sero movidos ou copiados.
Uma varivel do tipo TBatchMode, que especifica como essa cpia ser feita, e que pode assumir
um dos valores apresentados a seguir:
batAppend: Adiciona os registros ao final da tabela.
batAppendUpdate: Adiciona os registros ao final da tabela e sobrepe os registros j existentes
em que haja duplicidade de valores.
batCopy: Copia todos os registros da tabela origem para a tabela representada pelo componente.
batDelete: Remove os registros que tambm existem na tabela de origem.
batUpdate: Atualiza os registros da tabela representada pelo componente, com os registros
correspondentes existentes na tabela de origem.
CANCELRANGE
Declarao
procedure CancelRange;
Esse mtodo Remove o filtro aplicado a uma tabela por uma chamada ao seu mtodo ApplyRange.
CREATETABLE
Declarao
procedure CreateTable;
Esse mtodo permite a criao de uma tabela em run-time (no confundir com a criao do componente).
Entretanto, antes de se executar uma chamada ao mtodo CreateTable, devem-se definir os valores das
seguintes propriedades do componente:
DataBasename: Define nome do diretrio no qual a tabela ser armazenada ou o seu alias.
TableName: Define o nome da tabela a ser criada.
TableType: Define o tipo da tabela que ser criada.
FieldDefs: Define os campos da tabela. Conforme ser visto posteriormente, esse objeto tem
alguns mtodos importantes, como:
Clear: Remove todas as definies de campos da tabela.
Add: Adiciona um novo campo tabela.
IndexDefs: Objeto da classe TindexDefs que define os ndices da tabela. Essa classe tem alguns
mtodos importantes, como:
Clear: Remove todas as definies de ndices da tabela.
Add: Adiciona um novo ndice tabela.
DELETEINDEX
Declarao
DELETETABLE
Declarao
procedure DeleteTable;
Esse mtodo remove do banco de dados a tabela representada pelo componente, e deve ser empregado
com o mximo de cautela.
Antes de se executar esse mtodo, deve-se atribuir o valor False propriedade Active do componente
que representa a tabela (o que tambm pode ser feito por uma chamada ao seu mtodo Close).
EDITRANGEEND
Declarao
procedure EditRangeEnd;
Esse mtodo efetiva as alteraes definidas para um filtro, iniciadas aps uma chamada ao mtodo
EditRangeStart do componente que representa a tabela.
EDITRANGESTART
Declarao
procedure EditRangeStart;
Esse mtodo permite que se alterem as definies para um filtro, alteraes estas que sero efetivadas
aps uma chamada ao mtodo EditRangeEnd do componente que representa a tabela.
EMPTYTABLE
Declarao
procedure EmptyTable;
Esse mtodo remove todos os registros da tabela representada pelo componente.
FINDKEY
Declarao
function FindKey(const KeyValues: array of const): Boolean;
Esse mtodo permite a busca exata de um registro, cujos valores armazenados nos campos que compem
o ndice corrente sejam iguais aos valores passados como parmetros, na forma de um array.
Esse mtodo retorna True se for encontrado um registro que atenda as condies especificadas, e False
em caso contrrio.
FINDNEAREST
Declarao
procedure FindNearest(const KeyValues: array of const);
Esse mtodo permite a busca aproximada de um registro, cujos valores armazenados nos campos que
compem o ndice corrente sejam os mais aproximados aos valores passados como parmetros na
forma de um array.
GETINDEXNAMES
Declarao
procedure GetIndexNames(List: TStrings);
Esse mtodo armazena em um objeto da classe TStrings (passado como parmetro na chamada do
mtodo) os nomes dos ndices definidos para a tabela representada pelo componente.
GOTOCURRENT
Declarao
procedure GotoCurrent(Table: TTable);
Esse mtodo sincroniza o registro corrente dentre os registros manipulados pelo componente que
representa a tabela com o registro corrente de outro componente TTable, cujo nome passado como
parmetro, e que acessa a mesma tabela.
LOCKTABLE
Declarao
procedure LockTable(LockType: TLockType);
Esse mtodo restringe o acesso tabela por outras aplicaes, sendo essa restrio definida como uma
varivel do tipo TLockType, passada como parmetro na chamada do mtodo, sendo que uma varivel
desse tipo pode assumir os seguintes valores:
taReadLock: A tabela no poder ser acessada para leitura por outras aplicaes.
taWriteLock: A tabela no poder ser acessada para escrita por outras aplicaes.
RENAMETABLE
Declarao
procedure RenameTable(const NewTableName: string);
Esse mtodo renomeia a tabela representada pelo componente, e todos os arquivos a ela associados. O
novo nome da tabela deve ser passado como parmetro na forma de uma string.
SETRANGE
Declarao
procedure SetRange(const StartValues, EndValues: array of const);
Esse mtodo incorpora a funcionalidade dos mtodos SetRangeStart e SetRangeEnd, recebendo como
parmetros dois arrays que indicam, respectivamente, os valores iniciais e finais que definiro o filtro
a ser aplicado aos campos que definem o ndice corrente da tabela.
SETRANGEEND
Declarao
procedure SetRangeEnd;
Esse mtodo define o incio do trecho de cdigo em que devero ser definidos os valores finais dos
campos para o filtro a ser aplicado aos campos que definem o ndice corrente da tabela.
SETRANGESTART
Declarao
procedure SetRangeStart;
Esse mtodo define o incio do trecho de cdigo em que devero ser definidos os valores iniciais dos
campos para o filtro a ser aplicado aos campos que definem o ndice corrente da tabela.
UNLOCKTABLE
Declarao
procedure UnlockTable(LockType: TLockType);
Esse mtodo remove a restrio aplicada tabela representada pelo componente, definida previamente
por uma chamada ao seu mtodo LockTable:
Esse mtodo recebe como parmetro uma varivel do tipo TLockType, j descrita anteriormente.
A CLASSE TQUERY
A classe TQuery derivada por herana direta da classe TBDDataSet, sendo normalmente utilizada para se
estabelecer uma conexo a uma ou mais tabelas de um banco de dados acessadas usando-se declaraes SQL.
Quando o valor da propriedade RequestLive do componente (a ser definida posteriormente) igual a
True, os registros provenientes de uma consulta podem ser editados localmente pelo usurio. Essa
caracterstica no deve, no entanto, ser confundida com o recurso de cached updates, definida na
classe TBDEDataSet e herdada nessa classe.
PRINCIPAIS PROPRIEDADES DA CLASSE TQUERY
Apresenta-se a seguir uma descrio das principais propriedades da classe TQuery, alm daquelas herdadas
CONSTRAINED
Essa propriedade definida como uma varivel booleana, e se o seu valor for igual a True no sero
permitidas alteraes nos registros de tabelas do tipo dBASE e Paradox, que no sejam compatveis
com as condies estabelecidas na clusula SELECT da declarao SQL que gerou o conjunto de registros.
Essas restries s se aplicam quando a propriedade RequestLive do componente tem o valor True.
LOCAL
Essa propriedade definida como uma varivel booleana, e define se as tabelas acessadas so tabelas
locais (dos tipos Paradox e dBASE).
PARAMCOUNT
Essa propriedade definida como uma varivel inteira, e define o nmero de parmetros definidos
para a Query.
Essa uma propriedade apenas de leitura, e no pode ter o seu valor diretamente alterado pelo usurio.
PARAMS
Essa propriedade definida como um array de objetos da classe TParams, que representam
individualmente os parmetros definidos para a Query.
PREPARED
Essa propriedade definida como uma varivel booleana, e define se a Query foi preparada para ser
executada, de modo a melhorar o seu desempenho.
A preparao de uma Query pode ser feita atribuindo-se o valor True a essa propriedade, ou mediante
uma chamada ao seu mtodo Prepare.
REQUESTLIVE
Essa propriedade definida como uma varivel booleana, e define se os registros provenientes de uma
consulta podem ser editados localmente pelo usurio.
ROWSAFFECTED
Essa propriedade definida como uma varivel inteira, e define o nmero de linhas ou registros
atualizados ou removidos pela execuo da ltima declarao SQL.
SQL
Essa propriedade definida como um objeto da classe TStrings (que uma lista de strings) na qual deve
ser armazenada a declarao SQL a ser executada mediante uma chamada aos mtodos Open ou ExecSQL
do componente.
TEXT
Essa propriedade definida como uma varivel do tipo Pchar (string de terminao nula) e define o
texto da declarao SQL realmente enviada para ser executada pelo Borland Database Engine.
UNIDIRECIONAL
consulta podem ser navegados ou percorridos em uma nica direo.
PRINCIPAIS MTODOS DA CLASSE TQUERY
Apresenta-se a seguir uma descrio dos principais mtodos da classe TQuery, alm daqueles herdados
EXECSQL
Declarao
procedure ExecSQL;
Esse mtodo permite a execuo de declaraes SQL que envolvam a insero, a remoo e a atualizao
de registros, isto , declaraes SQL que contm as clusulas Insert, Delete e Update.
Declaraes SQL que envolvem apenas consultas resultantes da utilizao da clusula SELECT devem
ser executadas mediante uma chamada ao mtodo Open do componente.
PARAMBYNAME
Declarao
function ParamByName(const Value: string): TParam;
Esse mtodo permite o acesso individual a parmetros definidos em uma declarao SQL, sendo o
nome de um parmetro passado na forma de uma string na chamada ao procedimento.
PREPARE
Declarao
procedure Prepare;
Esse mtodo prepara a Query a ser executada, atribuindo o valor True sua propriedade Prepared.
UNPREPARE
Declarao
procedure UnPrepare;
Esse mtodo cancela a preparao da Query a ser executada, atribuindo o valor False sua propriedade
Prepared.
A CLASSE TUPDATESQL
A classe TUpdateSQL derivada por herana direta da classe TDataSetUpdateObject (sendo esta derivada
diretamente da classe TComponent), e permite que se definam instrues de insero (INSERT), deleo
(DELETE) e atualizao (UPDATE) em registros retornados atravs de uma consulta SQL, mesmo que
esta tenha sido definida como uma consulta apenas de leitura (isto , a propriedade RequestLive do
componente Query igual a False ou os registros foram transformados em registros apenas de leitura
durante a execuo do cdigo), desde que a propriedade CachedUpdates do componente Query
responsvel pela execuo da declarao SQL tenha sido definida como True.
A grande vantagem da utilizao desse componente est no fato de no haver necessidade de se preocupar
com o fato de os registros terem sido gerados apenas para leitura pelo componente Query.
PRINCIPAIS PROPRIEDADES DA CLASSE TUPDATESQL
Apresenta-se a seguir uma descrio das principais propriedades da classe TUpdateSQL.
INSERTSQL
Essa propriedade determinada como um objeto da classe TStrings, e permite que se defina o cdigo
SQL para insero de registros em uma tabela.
DELETESQL
SQL para remoo de registros em uma tabela.
MODIFYSQL
SQL para a atualizao de registros em uma tabela.
PRINCIPAIS MTODOS DA CLASSE TUPDATESQL
Apresenta-se a seguir uma descrio dos principais mtodos da classe TUpdateSQL.
EXECSQL
Declarao
procedure ExecSQL(UpdateKind: TUpdateKind);
Esse mtodo executa uma das instrues definidas pelas trs propriedades descritas no tpico anterior.
Esse mtodo, ao contrrio do mtodo de mesmo nome do objeto Query, recebe como parmetro uma
constante que indica o cdigo a ser executado. A tabela a seguir apresenta essas constantes e seus
significados:
UkModify: Execute a declarao SQL armazenada na propriedade ModifySQL.
UkInsert: Execute a declarao SQL armazenada na propriedade InsertSQL.
UkDelete: Execute a declarao SQL armazenada na propriedade DeleteSQL.
Caso as declaraes SQL definidas nesse componente tenham parmetros, os nomes dos parmetros
devero coincidir com nomes de campos da tabela acessada atravs do componente Query.
EXEMPLOS DE APLICAO
INDEXAO DE TABELAS ACESSADAS PELO COMPONENTE TABLE
Existem situaes em que precisamos reordenar os registros provenientes de uma tabela, com base nos
valores armazenados em um determinado campo (ou conjunto de campos).
Nesses casos, torna-se necessrio redefinir o ndice corrente da tabela, o que pode ser feito durante a
execuo da aplicao, conforme ser apresentado no exemplo descrito neste tpico.
CHAVE PRIMRIA
Define-se como chave primria um campo (ou conjunto de campos) que tem um valor exclusivo em
uma tabela. Toda tabela deve ter ao menos um campo definido como chave primria e, quando isso no
for possvel, pode-se utilizar mais de um campo, definindo-se o que se chama chave primria composta.
NDICES SECUNDRIOS
Define-se como ndice secundrio de uma tabela um campo (ou conjunto de campos) pelo qual as
informaes podero ser ordenadas. Nesse caso, no existe necessariamente a restrio de valor exclusivo,
como ocorre no caso das chaves primrias.
Uma tabela pode ser ordenada pela sua chave primria ou por quaisquer campos que definam uma
entidade denominada ndice secundrio.
DEFINIO DO NDICE CORRENTE
No Delphi, a definio do ndice corrente de uma tabela acessada usando-se um componente Table
pode ser feita da seguinte maneira:
Na fase de projeto: Definindo-se, diretamente no Object Inspector, o valor da propriedade
IndexName do componente Table que representa a tabela (se essa propriedade no for definida,
ser utilizada a chave primria) ou definindo-se, diretamente no Object Inspector, o valor da
propriedade IndexFieldNames do componente Table que representa a tabela.
Conforme j foi descrito anteriormente, as propriedades IndexName e IndexFieldNames so mutuamente excludentes. Atribuir um
valor a uma propriedade anula o valor definido para a outra.
Durante a execuo do aplicativo: Definindo-se via cdigo, mediante uma operao de atribuio,
o valor das propriedades descritas no tpico anterior. No caso da propriedade IndexFieldNames,
os nomes dos campos que formam o ndice devem vir separados por ponto-e-vrgula.
Apresenta-se, a seguir, um pequeno exemplo, que utiliza a tabela Employees.db (uma das tabelas-
exemplo que acompanham o Delphi 7), na qual a ordenao dos campos definida durante a execuo
do aplicativo.
EXEMPLO DE APLICAO
Apresenta-se, a seguir, a descrio das principais propriedades dos componentes utilizados na criao do
formulrio, o aspecto visual do formulrio e o cdigo a ser implementado. Alguns componentes mantiveram
seus nomes default, pois, em exemplos simples como este, tal fato no gera qualquer tipo de problema.
Nas definies deste exemplo adotou-se uma resoluo de 640 x 480.
Formulrio:
Name: FormIndice
Width: 500
Height: 260
Caption: Exemplo de Definio de ndices em Run-Time
Table:
Name: Table1
DatabaseName: DBDEMOS
TableName: EMPLOYEE.DB
Active: True
DataSource:
Name: DataSource1
DataSet: Table1
DBGrid:
Name: DBGrid1
Left: 6
Top: 80
Width: 480
Height: 112
DataSource: DataSource1
RadioGroup:
Name: RadioGroup1
Left: 56
Top: 24
Width: 200
Height: 40
Caption: Ordenar por
Columns: 2
ItemIndex: 0
Items. Cdigo,Nome -um em cada linha
Boto de Comando (BitButton):
Name: BotaoFechar
Left: 320
Top: 32
Width: 75
Height: 25
Kind: bkClose
Caption: &Fechar
Para definir a propriedade Items do componente RadioGroup, basta digitar os valores desejados na caixa de dilogo String list editor,
que acessada clicando-se com o boto esquerdo do mouse sobre as reticncias () exibidas direita do nome da propriedade.
Codificao: A nica codificao a ser feita consiste em definir, da seguinte maneira, o procedimento
associado ao evento OnClick do componente RadioGroup1:
procedure TFormIndice.RadioGroup1Click(Sender: TObject);
begin
case Radiogroup1.itemindex of
0 :
table1.IndexName := ;
1 :
table1.IndexName := ByName;
end;
end;
Figura 23.1: Aspecto visual do formulrio.
Durante a execuo do aplicativo, a seleo de um dos botes de rdio altera a ordem de exibio dos registros.
A estrutura condicional Case verifica o item selecionado e, em funo deste, altera a definio do
ndice corrente.
Apresenta-se a seguir a unit associada ao formulrio da aplicao.
unit UnitIndice;
interface
uses
StdCtrls, Buttons, ExtCtrls, Grids, DBGrids, Db, DBTables;
type
TFormIndice = class(TForm)
Table1: TTable;
DataSource1: TDataSource;
DBGrid1: TDBGrid;
RadioGroup1: TRadioGroup;
BitBtn1: TBitBtn;
procedure RadioGroup1Click(Sender: TObject);
private
public
end;
var
FormIndice: TFormIndice;
implementation
{$R *.DFM}
procedure TFormIndice.RadioGroup1Click(Sender: TObject);
begin
table1.Close;
case Radiogroup1.itemindex of
0 :
table1.IndexName := ;
1 :
table1.IndexName := ByName;
end;
table1.Open;
end;
end.
FILTRANDO OS REGISTROS DE UMA TABELA ACESSADA PELO COMPONENTE TABLE
No Delphi, a aplicao de um filtro aos registros de uma tabela acessada usando-se um componente
Table pode ser feita da seguinte maneira:
Na fase de projeto: Definindo-se, diretamente no Object Inspector, o valor da propriedade
Filter do componente Table que representa a tabela e definindo-se como True o valor da
propriedade Filtered do componente. Para a propriedade Filter, deve-se definir uma expresso
booleana, que retorne True ou False.
Ou:
Durante a execuo do aplicativo: Definindo-se via cdigo, mediante uma operao de
atribuio, o valor das propriedades descritas anteriormente e codificando-se o procedimento
associado ao evento OnFilter Record do componente Table.
Considere que, na tabela Employees.db, usada no exemplo anterior, queremos exibir apenas os empregados
contratados aps 31/12/92. Nesse caso, devemos digitar, na propriedade Filter do componente Table, a
expresso: HireDate > 31/12/92', alm de definir como True o valor da sua propriedade Filtered. Simples,
no? Considere, no entanto, a seguinte situao: voc deseja exibir apenas os dados dos empregados
contratados em um determinado ms, e isso ser definido durante a execuo do aplicativo (usando-se
um combobox). Nesse caso, ser necessrio utilizar a funo DecodeDate, para obter o ms de cada
registro, e ser mais simples digitar o cdigo que define o filtro no procedimento associado ao evento
OnFilterRecord do componente Table, alm de manter o valor True para a propriedade Filtered.
A fim de tornar este exemplo ainda mais interessante, vamos utilizar um componente checkbox para
definir se o filtro dever ou no ser aplicado tabela.
Formulrio:
Name: FormFiltro:
Width: 500
Height: 260
Caption: Exemplo de Definio de Filtros em Run-Time
Table:
Name: Table1
TableName: EMPLOYEE.DB
Active: True
DataSource:
Name: DataSource1
DataSet: Table1
DBGrid:
Name: DBGrid1
Left: 6
Top: 80
Width: 480
Height: 112
Boto de Comando (BitButton):
Name: BotaoFechar
Left: 320
Top: 32
Width: 75
Height: 25
Kind: bkClose
Caption: &Fechar
Combobox:
Name: ComboBox1
Left: 60
Top: 34
Width: 100
Height: 21
Style: csDropDownList
ItemHeight: 13
Items: Janeiro, Fevereiro, Maro, Abril, Maio, Junho, Julho, Agosto, Setembro, Outubro,
Novembro, Dezembro um em cada linha
CheckBox1:
Name: CheckBox1
Left: 185
Top: 36
Width: 90
Height: 17
Caption: Aplicar Filtro
Codificao: Como a propriedade ItemIndex do combobox no est disponvel no Object Inspector, voc
deve defini-la codificando da seguinte maneira o procedimento associado ao evento OnCreate do formulrio:
procedure TFormFiltro.FormCreate(Sender: TObject);
begin
ComboBox1.ItemIndex := 0;
end;
Para alterar a propriedade Filtered do componente Table em funo da opo feita pelo usurio, basta
codificar da seguinte maneira o procedimento associado ao evento OnClick do CheckBox:
procedure TFormFiltro.CheckBox1Click(Sender: TObject);
begin
Table1.Filtered := CheckBox1.Checked;
end;
A definio do filtro, nesse caso, dever ser feita no procedimento associado ao evento OnFilterRecord
do componente Table, apresentado a seguir. Nesse procedimento, o parmetro Accept definir se o
registro deve ou no ser exibido, em funo do resultado da expresso booleana definida no seu
comando de atribuio.
Neste exemplo, utilizou-se o procedimento DecodeDate, que extrai o dia, ms e ano de um valor do
tipo TDateTime. Como a propriedade ItemIndex do combobox comea em 0 e o primeiro ms (Janeiro)
comea em 01, basta verificar a diferena entre o valor do ms e o valor armazenado na propriedade
ItemIndex do combobox:
procedure TFormFiltro.Table1FilterRecord(DataSet : TDataSet;
var Accept : Boolean);
var
Dia, Mes, Ano: Word;
begin
DecodeDate(Table1.FieldByName(HireDate).AsDateTime,Ano,Mes,Dia);
Accept := Mes - Combobox1.ItemIndex = 1;
end;
Para atualizar a exibio dos registros sempre que o usurio alterar a seleo do item no combobox,
basta executar o mtodo Refresh do componente Table. Para isso, basta que se codifique, da seguinte
maneira, o procedimento associado ao evento OnChange do combobox:
procedure TFormFiltro.ComboBox1Change(Sender: TObject);
begin
Table1.Refresh;
end;
Apresenta-se a seguir a codificao completa da unit associada a esse formulrio.
unit UnitFiltro;
interface
uses
StdCtrls, Buttons, Grids, DBGrids, Db, DBTables;
type
TFormFiltro = class(TForm)
Table1: TTable;
DBGrid1: TDBGrid;
BitBtn1: TBitBtn;
ComboBox1: TComboBox;
CheckBox1: TCheckBox;
procedure CheckBox1Click(Sender: TObject);
procedure Table1FilterRecord(DataSet: TDataSet; var Accept: Boolean);
procedure ComboBox1Change(Sender: TObject);
private
public
end;
var
FormFiltro: TFormFiltro;
implementation
{$R *.DFM}
begin
end;
begin
end;
procedure TFormFiltro.Table1FilterRecord(DataSet: TDataSet;
var Accept: Boolean);
var
begin
end;
begin
Table1.Refresh;
end;
end.
CAMPOS CALCULADOS
Um campo calculado um tipo especial de campo de uma tabela, cujo valor depende dos valores
armazenados em outros campos. Esse campo s existe durante a execuo do aplicativo, reduzindo,
dessa maneira, a quantidade de espao em disco a ser ocupado pela tabela.
Considere novamente a tabela Employees.db. Caso voc queira exibir o tempo de cada funcionrio na
empresa, no h necessidade de criar fisicamente um novo campo na tabela, pois todas as informaes
necessrias ao clculo da idade j esto armazenadas na tabela.
Nesse caso, devemos criar um campo calculado, que chamaremos de WorkTime (no sei se esse nome
o mais adequado, mas definir o tempo do funcionrio na empresa). O cdigo que define um campo
calculado deve ser definido no procedimento associado ao evento OnCalcFields do componente Table
que representa a tabela.
Para criar um campo calculado, voc deve executar os seguintes procedimentos:
1. Selecione o componente Table, clicando sobre o mesmo com o boto esquerdo do mouse.
2. Pressione o boto direito do mouse sobre esse componente e selecione o item Fields Editor do
menu pop-up, para exibir o editor de campos.
3. Pressione o boto direito do mouse sobre o Fields Editor e selecione o item Add Field no menu
pop-up que exibido. Ser exibida a caixa de dilogo Add Fields, mostrada na figura a seguir.
Figura 23.3: A caixa de dilogo Add Fields.
4. Mantendo todos os campos selecionados, clique com o boto esquerdo do mouse sobre o
boto OK para fechar essa caixa de dilogo e adicionar os novos campos janela Editor de
Campos (o Fields Editor), como mostra a Figura 23.4.
5. Pressione o boto direito do mouse sobre o Fields Editor e selecione o item New Field no menu
pop-up que exibido. Ser exibida a caixa de dilogo New Field, mostrada na Figura 23.5.
6. Selecione o boto de rdio calculated da caixa de dilogo New Field.
7. Digite o nome do novo campo na caixa de texto name da caixa de dilogo New Field (no caso,
o nome do campo ser WorkTime).
8. Selecione o tipo de campo no combobox Type da caixa de dilogo New Field (no caso, Integer).
9. Digite o tamanho do campo na caixa de texto Size, se for o caso (principalmente em campos
alfanumricos). Para o campo WorkTime, essa caixa de texto deve permanecer em branco. A
caixa de dilogo New Fields deve ficar com o aspecto apresentado na figura a seguir.
Figura 23.4: O Fields Editor.
Figura 23.5: A caixa de dilogo New Field.
Figura 23.6: A caixa de dilogo New Field, aps a digitao das informaes necessrias.
10. Selecione o boto OK para fechar a caixa de dilogo New Field e exibir o novo campo no Fields
Editor, como mostra a figura a seguir.
Figura 23.7: Criao do campo calculado.
Crie esse campo calculado no exemplo anterior (usado para aplicao de filtros). Para que o campo
calculado tenha o seu valor calculado corretamente, basta codificar, da seguinte maneira, o procedimento
associado ao evento OnCalcFields do componente Table1:
procedure TFormFiltro.Table1CalcFields(DataSet : TDataSet);
begin
Table1Age.AsInteger = trunc((Date - Table1HireDate.AsDateTime) / 365);
end;
Apresenta-se a seguir a codificao completa da unit associada a esse formulrio (criado no exemplo
anterior), aps a incluso do campo calculado.
unit UnitFiltro;
interface
uses
type
TFormFiltro = class(TForm)
Table1: TTable;
DBGrid1: TDBGrid;
BitBtn1: TBitBtn;
CheckBox1: TCheckBox;
Table1EmpNo: TIntegerField;
Table1LastName: TStringField;
Table1FirstName: TStringField;
Table1PhoneExt: TStringField;
Table1HireDate: TDateTimeField;
Table1Salary: TFloatField;
Table1Age: TIntegerField;
procedure CheckBox1Click(Sender: TObject);
procedure Table1FilterRecord(DataSet: TDataSet; var Accept: Boolean);
procedure Table1CalcFields(DataSet: TDataSet);
private
public
end;
var
FormFiltro: TFormFiltro;
implementation
{$R *.DFM}
begin
end;
begin
end;
procedure TFormFiltro.Table1FilterRecord(DataSet: TDataSet;
var Accept: Boolean);
var
begin
end;
begin
Table1.Refresh;
end;
procedure TFormFiltro.Table1CalcFields(DataSet: TDataSet);
begin
Table1Age.AsInteger = trunc((Date - Table1HireDate.AsDateTime) / 365);
end;
end.
importante lembrar que o Fields Editor cria, para cada campo, um objeto que o representa. Esse objeto, que pode ser acessado no
Object Inspector, recebe um nome composto pelo nome da tabela seguido pelo nome do campo. No caso do campo Age, por exemplo,
esse objeto ser chamado Table1Age. Para alterar as propriedades desse objeto, basta selecionar seu nome na caixa de seleo de
objetos do Object Inspector.
CAMPOS LOOKUP
Um campo lookup um tipo especial de campo de uma tabela, cujo valor reflete o valor armazenado
em um campo de uma outra tabela, desde que essas duas tabelas tenham um campo com mesmo
significado e valores idnticos (ainda que esses campos possam ter nomes distintos). Esse campo s
existe durante a execuo do aplicativo, reduzindo, dessa maneira, a quantidade de espao em disco a
ser ocupado pela tabela.
A tabela Orders.db, que acompanha o Delphi, por exemplo, armazena o cdigo de um cliente no
campo CustNo (os dados dos clientes esto armazenados na tabela Customers.db). Para exibir o nome
do cliente em um DBGrid que acessa a tabela Orders.db, devemos criar um campo lookup nessa tabela,
que busque o nome do cliente no campo Company da tabela Customers.db, usando para isso o campo
que as tabelas possuem em comum.
Neste exemplo, vamos criar um campo lookup chamado CustName na tabela Orders.db, cujos registros
sero exibidos em um DBGrid. Devero ser utilizados dois componentes Table, sendo que o primeiro
acessar a tabela Orders.db e o segundo, a tabela Customer.db.
Apresenta-se, a seguir, a descrio das principais propriedades dos componentes utilizados na criao
do formulrio e Datamodule, o aspecto visual do formulrio e o cdigo a ser implementado. Alguns
componentes mantiveram seus nomes default, pois, em exemplos simples como este, tal fato no gera
qualquer tipo de problema:
Formulrio:
Name: FormLookup
Width: 500
Height: 300
Caption: Exemplo de Definio de Campos Lookup
DBGrid1:
Name: DBGrid1
Left: 12
Top: 30
Width: 468
Height: 150
DataSource: Dados.DataSourceOrders
Boto de Comando:
Nome: BotaoFechar
Left: 208
Top: 220
Width: 75
Height: 25
Kind: bkClose
Caption: &Fechar
Datamodule:
Name: Dados
Componentes Table: (a serem colocados no Datamodule)
Name: TblOrders
TableName: ORDERS.DB
Active: True
Name: TblCustomers
TableName: CUSTOMER.DB
Active: True
DataSource:
Name: DataSourceOrders
DataSet: TblOrders
Figura 23.9: Aspecto visual do DataModule.
Para criar um campo lookup, voc deve executar os seguintes procedimentos:
1. Selecione o componente TblOrders, clicando sobre o mesmo com o boto esquerdo do mouse.
2. Pressione o boto direito do mouse sobre esse componente e selecione o item Fields Editor do
menu pop-up, para exibir o editor de campos.
3. Pressione o boto direito do mouse sobre o Fields Editor e selecione o item Add Field no menu
pop-up que exibido. Ser exibida a caixa de dilogo Add Fields.
4. Mantendo todos os campos selecionados, clique com o boto esquerdo do mouse sobre o
boto OK para fechar essa caixa de dilogo e adicionar os novos campos ao Fields Editor.
5. Pressione o boto direito do mouse sobre o Fields Editor e selecione o item New Field no menu
pop-up que exibido. Ser exibida a caixa de dilogo New Field, mostrada nos tpicos anteriores.
6. Selecione o boto de rdio lookup da caixa de dilogo New Field.
7. Digite o nome do novo campo na caixa de texto name da caixa de dilogo New Field (no caso,
o nome do campo ser CustName).
8. Selecione o tipo de campo no combobox Type da caixa de dilogo New Field (no caso, String).
9. Digite o tamanho do campo na caixa de texto Size, se for o caso (principalmente em campos
alfanumricos). Para o campo CustName, esse valor dever ser igual a 30 (que o tamanho do
campo Company na tabela Customers.db).
10. Selecione, no combobox Key Fields, o campo da tabela Orders.db que far a ligao com a
tabela Customer.db (no caso, CustNo).
11. Selecione, no combobox DataSet, o componente que fornecer o valor do campo que est
sendo criado (no caso, TblCustomers).
12. Selecione, no combobox Lookup Keys, o campo da tabela origem (no caso, Customer.db) que
far a ligao com a tabela Orders.db. Nesse caso, o campo desejado o campo CustNo.
13. Selecione, no combobox Result Field, o campo da tabela origem (no caso, Customer.db) cujo
valor ser exibido no campo lookup que est sendo criado. Nesse caso, o campo desejado o
campo Company.
A figura a seguir apresenta a caixa de dilogo New Field, aps o fornecimento de todas as informaes necessrias.
Figura 23.10: A caixa de dilogo New Field, aps o fornecimento
das informaes necessrias criao de um campo lookup.
14. Selecione o boto OK para fechar a caixa de dilogo New Field. Ser criado um objeto chamado
Table1Custname, que representar o campo recm-criado.
Para visualizar o campo criado durante a execuo da aplicao, use a barra de rolagem horizontal do DBGrid.
Apresentamos a seguir o cdigo completo das units associadas ao formulrio e ao Datamodule.
unit UnitLookup;
interface
uses
Grids, DBGrids, StdCtrls, Buttons;
type
TFormLookup = class(TForm)
DBGrid1: TDBGrid;
BitBtn1: TBitBtn;
private
public
end;
var
FormLookup: TFormLookup;
implementation
uses UnitDadosLookup;
{$R *.DFM}
end.
unit UnitDadosLookup;
interface
uses
Db, DBTables;
type
TDados = class(TDataModule)
TblOrders: TTable;
TblCustomers: TTable;
DataSourceOrders: TDataSource;
TblOrdersOrderNo: TFloatField;
TblOrdersCustNo: TFloatField;
TblOrdersSaleDate: TDateTimeField;
TblOrdersShipDate: TDateTimeField;
TblOrdersEmpNo: TIntegerField;
TblOrdersShipToContact: TStringField;
TblOrdersShipToAddr1: TStringField;
TblOrdersShipToCity: TStringField;
TblOrdersShipToState: TStringField;
TblOrdersShipToZip: TStringField;
TblOrdersShipToCountry: TStringField;
TblOrdersShipToPhone: TStringField;
TblOrdersShipVIA: TStringField;
TblOrdersPO: TStringField;
TblOrdersTerms: TStringField;
TblOrdersPaymentMethod: TStringField;
TblOrdersItemsTotal: TCurrencyField;
TblOrdersTaxRate: TFloatField;
TblOrdersFreight: TCurrencyField;
TblOrdersAmountPaid: TCurrencyField;
TblOrdersCustName: TStringField;
private
public
end;
var
Dados: TDados;
implementation
{$R *.DFM}
end.
ESTABELECENDO UM RELACIONAMENTO ENTRE TABELAS REPRESENTADAS PELO COMPONENTE TABLE
Neste tpico sero apresentados os procedimentos necessrios definio de um relacionamento en-
tre tabelas representadas pelo componente table. Sero utilizadas como exemplo as tabelas Customer.db
e Orders.db, que tm um campo em comum o campo CustNo.
A tabela Customer.db ser acessada por um componente Table chamado TblCustomer, enquanto a tabela
Orders.db ser acessada por outro componente Table chamado TblOrders. Os componentes DataSource
associados a esses Tables sero denominados DatasourceCustomer e DatasourceOrders, respectivamente.
No exemplo criado neste tpico, deseja-se exibir, no DBGrid associado tabela Orders.db, apenas os pedidos
do cliente selecionado no DBGrid vinculado tabela Customers.db. Nesse relacionamento, a tabela Princi-
pal (Mestre) ser a tabela Customer.db, enquanto a tabela Orders.db ser a tabela secundria (ou de detalhes).
Para estabelecer esse relacionamento, voc dever executar os seguintes procedimentos, aps inserir os
componentes no formulrio:
1. Selecione o componente TblOrders e defina a sua propriedade MasterSource como
DatasourceCustomer.
2. Defina a propriedade MasterFields desse componente usando a caixa de dilogo Field Links
Editor, como mostrado na figura a seguir. Nessa caixa de dilogo, basta selecionar os campos
que faro a ligao e o boto Add.
interessante ressaltar que, nesta nova verso do Delphi, do relacionamento entre tabelas tambm pode ser estabelecido atravs da
pgina data diagram do Data Module, conforme ser descrito no final deste captulo.
do formulrio e do Datamodule, o aspecto visual do formulrio e o cdigo a ser implementado. Alguns
Figura 23.11: A caixa de dilogo Field Link Designer.
Formulrio:
Name: FormRelacionamento
Width: 500
Height: 360
Caption: Exemplo de Relacionamento entre Tabelas Acessadas Pelo Componentte Table
Labels:
Name: Label1
Left: 12
Top: 6
Width: 40
Height: 13
Caption: Clientes:
Name: Label2
Left: 12
Top: 136
Width: 41
Height: 13
Caption: Pedidos:
DBGrids:
Name: DBGridCustomers
Left: 12
Top: 24
Width: 468
Height: 110
DataSource: Dados.DatasourceCustomers
Name: DBGridOrders
Left: 12
Top: 150
Width: 468
Height: 110
DataSource: Dados.DatasourceOrders
Boto de Comando:
Name: BotaoFechar
Left: 208
Top: 288
Width: 75
Height: 25
Caption: &Fechar
Datamodule:
Name: Dados
Componentes Table: (a serem colocados no Datamodule)
Name: TblOrders
TableName: ORDERS.DB
Active: True
Name: TblCustomers
Active: True
DataSource:
Name: DataSourceOrders
DataSet: TblOrders
Name: DatasourceCustomers
DataSet: TblCustomers
Figura 23.13: Aspecto visual do Datamodule.
Apresenta-se a seguir o cdigo completo das units associadas ao formulrio e ao Datamodule. Repare
que no necessria qualquer codificao especial para estabelecer um relacionamento entre tabelas
acessadas pelo componente TTable.
unit UnitRelacionamento;
interface
uses
Grids, DBGrids, StdCtrls, Buttons;
type
TFormRelacionamento = class(TForm)
DBGridCustomers: TDBGrid;
BitBtn1: TBitBtn;
DBGridOrders: TDBGrid;
Label1: TLabel;
Label2: TLabel;
private
public
end;
var
FormRelacionamento: TFormRelacionamento;
implementation
uses UnitDadosRelacionamento;
{$R *.DFM}
end.
var
FormRelacionamento: TFormRelacionamento;
implementation
{$R *.DFM}
end.
unit UnitDadosRelacionamento;
interface
uses
Db, DBTables;
type
TDados = class(TDataModule)
TblOrders: TTable;
DataSourceOrders: TDataSource;
TblOrdersOrderNo: TFloatField;
TblOrdersCustNo: TFloatField;
TblOrdersSaleDate: TDateTimeField;
TblOrdersShipDate: TDateTimeField;
TblOrdersEmpNo: TIntegerField;
TblOrdersShipToContact: TStringField;
TblOrdersShipToCity: TStringField;
TblOrdersShipToState: TStringField;
TblOrdersShipToZip: TStringField;
TblOrdersShipToCountry: TStringField;
TblOrdersShipToPhone: TStringField;
TblOrdersShipVIA: TStringField;
TblOrdersPO: TStringField;
TblOrdersTerms: TStringField;
TblOrdersPaymentMethod: TStringField;
TblOrdersItemsTotal: TCurrencyField;
TblOrdersTaxRate: TFloatField;
TblOrdersFreight: TCurrencyField;
TblOrdersAmountPaid: TCurrencyField;
TblOrdersCustName: TStringField;
DataSourceCustomers: TDataSource;
private
public
end;
var
Dados: TDados;
implementation
{$R *.DFM}
end.
PESQUISANDO REGISTROS EM TABELAS REPRESENTADAS PELO COMPONENTE TABLE
Conforme j descrito anteriormente, o componente Table tem os seguintes mtodos de pesquisa:
FindKey: Esse mtodo permite a busca exata de um registro, cujos valores armazenados nos
campos que compem o ndice corrente sejam iguais aos valores passados como parmetros,
na forma de uma array.
FindNearest: Esse mtodo permite a busca aproximada de um registro, cujos valores armazenados
nos campos que compem o ndice corrente sejam os mais aproximados aos valores passados
como parmetros na forma de uma array.
Locate: Esse mtodo permite a busca exata ou aproximada de um registro, por campos que no
faam parte do ndice corrente da tabela.
Neste tpico sero utilizados os mtodos descritos anteriormente para realizar pesquisas pelos registros
da tabela Customer.db.
do formulrio e do Datamodule, seus aspectos visuais e o cdigo a ser implementado. Alguns
Formulrio:
Name: FormPesquisa:
Width: 500
Height: 360
Caption: Exemplo de Pesquisa em Tabelas
DBGrid:
Name: DBGridCustomers
Left: 12
Top: 24
Width: 468
Height: 110
DataSource: Dados.DatasourceCustomers
RadioGroups:
Name: RGTipoPesquisa
Left: 54
Top: 200
Width: 385
Height: 40
Caption: Tipo de Pesquisa
Columns: 3
ItemIndex: 0
Items. Exata Indexada, Exata No-Indexada, Aproximada Indexada
Name: RGCampo
Left: 44
Top: 256
Width: 385
Height: 40
Caption: Campo
Columns: 3
ItemIndex: 0
Items. CustNo, Company, Country
Caixa de Texto:
Name: EditPesquisa
Left: 54
Top: 264
Width: 280
Height: 21
Boto de Comando:
Name: BotaoFechar
Left: 363
Top: 262
Width: 75
Height: 25
Kind: bkClose
Caption: &Fechar
Datamodule:
Name: Dados
Table:
Name: TblCustomer
Active: True
DataSource:
Name: DatasourceCustomer
DataSet: TblCustomer
Figura 23.15: Aspecto visual do Datamodule.
Codificao: Neste exemplo, o tipo de pesquisa a ser realizada definido no procedimento associado
ao evento OnClick do componente RGTipoPesquisa. No evento OnClick desse componente, deve-se
verificar se uma pesquisa indexada foi selecionada, pois no poder ser feita uma pesquisa pelo campo
Country. Nesse caso, se o campo Country estiver selecionado, este desmarcado e a seleo passa para
o campo CustNo. Para que isso ocorra, deve-se codificar, da seguinte maneira, o procedimento associado
ao evento OnClick do componente RGTipoPesquisa:
procedure TFormPesquisa.RGTipoPesquisaClick(Sender: TObject);
begin
case RGTipoPesquisa.ItemIndex of
0,2 :
begin
if RGCampo.ItemIndex = 2 then RGCampo.ItemIndex := 0;
Dados.TblCustomers.IndexName := ;
end;
end;
end;
Dependendo do campo selecionado no componente RGCampo, deve-se definir o ndice corrente da
tabela Customer.db. A nica exceo ocorre quando o usurio selecionou uma das opes de pesquisa
indexada e escolheu o campo Country, pelo qual a tabela no est indexada. Se esse for o caso, emite-
se uma mensagem ao usurio e redefine-se o campo CustNo como o campo de pesquisa.
Para que isso ocorra, deve-se codificar, da seguinte maneira, o procedimento associado ao evento
OnClick do componente RGCampo:
procedure TFormPesquisa.RGCampoClick(Sender: TObject);
begin
case RGCampo.ItemIndex of
0 :
1 :
Dados.TblCustomers.IndexName := ByCompany;
2 : if RGTipoPesquisa.ItemIndex <> 1 then
begin
ShowMessage(Campo Selecionado No-Indexado);
RGCampo.ItemIndex := 0;
end;
end;
end;
Para que a pesquisa seja feita medida que o usurio digita um valor na caixa de texto, deve-se definir da
seguinte maneira o procedimento associado ao evento OnChange do componente EditPesquisa (esse
procedimento testa o tipo de pesquisa selecionada e executa o mtodo adequado do componente Table):
procedure TFormPesquisa.EditPesquisaChange(Sender: TObject);
begin
0 :
Dados.TblCustomers.FindKey([EditPesquisa.Text]);
1 :
Dados.TblCustomers.Locate(RGCampo.Items[RGCampo.ItemIndex],EditPesquisa.Text,[LoCaseInsensitive]);
2 :
Dados.TblCustomers.FindNearest([EditPesquisa.Text]);
end;
end;
Apresenta-se a seguir o cdigo completo da unit associada ao formulrio:
unit UnitPesquisa;
interface
uses
Grids, DBGrids, StdCtrls, Buttons, ExtCtrls, DB;
type
TFormPesquisa = class(TForm)
DBGridCustomers: TDBGrid;
BitBtn1: TBitBtn;
Label1: TLabel;
RGTipoPesquisa: TRadioGroup;
RGCampo: TRadioGroup;
EditPesquisa: TEdit;
procedure RGTipoPesquisaClick(Sender: TObject);
procedure RGCampoClick(Sender: TObject);
procedure EditPesquisaChange(Sender: TObject);
private
public
end;
var
FormPesquisa: TFormPesquisa;
implementation
uses UnitDadosRelacionamento;
{$R *.DFM}
procedure TFormPesquisa.RGTipoPesquisaClick(Sender: TObject);
begin
0,2 :
begin
if RGCampo.ItemIndex = 2 then RGCampo.ItemIndex := 0;
end;
end;
end;
procedure TFormPesquisa.RGCampoClick(Sender: TObject);
begin
case RGCampo.ItemIndex of
0 :
1 :
Dados.TblCustomers.IndexName := ByCompany;
2 : if RGTipoPesquisa.ItemIndex <> 1 then
begin
ShowMessage(Campo Selecionado No-Indexado);
RGCampo.ItemIndex := 0;
end;
end;
end;
procedure TFormPesquisa.EditPesquisaChange(Sender: TObject);
begin
0 :
Dados.TblCustomers.FindKey([EditPesquisa.Text]);
1 :
Dados.TblCustomers.Locate(RGCampo.Items[RGCampo.ItemIndex],EditPesquisa.Text,[LoCaseInsensitive]);
2 :
Dados.TblCustomers.FindNearest([EditPesquisa.Text]);
end;
end;
end.
CRIAO DE TABELAS EM RUN-TIME
Neste tpico ser apresentado um exemplo de aplicao que ilustra os procedimentos necessrios
criao de tabelas em run-time.
Para criar uma tabela em run-time, deve-se usar o mtodo CreateTable do componente Table.
Entretanto, antes de se executar uma chamada ao mtodo CreateTable do componente Table, os valores
das seguintes propriedades devem estar definidos:
DataBaseName: Define o nome do diretrio no qual a tabela ser armazenada (ou o seu alias).
TableName: Define o nome da tabela.
TableType: Define o tipo da tabela.
FieldDefs: Essa propriedade um objeto da classe TFieldDefs, e define os campos da tabela.
Essa classe tem alguns mtodos importantes, como:
Clear, que remove todas as definies de campos da tabela.
Add, que adiciona um novo campo tabela. Esse mtodo recebe como parmetros: uma
string que define o nome do campo, uma constante do tipo TFieldType, que define o tipo
do campo. O parmetro TFieldType pode receber um dos seguintes valores: ftUnknown,
ftString, ftSmallint, ftInteger, ftWord, ftBoolean, ftFloat, ftCurrency, ftBCD, ftDate, ftTime,
ftDateTime, ftBytes, ftVarBytes, ftAutoInc, ftBlob, ftMemo, ftGraphic, ftFmtMemo,
ftParadoxOle, ftDBaseOle, ftTypedBinary, ftCursor, o tamanho do campo (se for o caso) e
uma constante booleana, que define se o campo ser ou no um campo requerido.
A propriedade Count dessa classe retorna o nmero de campos definidos no objeto:
IndexDefs: Essa propriedade um objeto da classe TIndexDefs e define os ndices da tabela.
Essa classe tem alguns mtodos importantes, como:
Add: Adiciona um novo ndice tabela. Esse mtodo recebe como parmetros uma string
com o nome do ndice; uma string com os nomes dos campos que compem o ndice
(separados por ponto-e-vrgula) e um conjunto de opes, em que cada elemento um dos
valores possveis definidos para o tipo TIndexDefOptions, listados a seguir.
seus nomes default, pois em exemplos simples como este tal fato no gera qualquer tipo de problema.
Formulrio:
Name: FormCriaTabela
Height: 400
Width: 435
Caption: Formulrio Para a Criao de Tabelas
Objetos colocados no formulrio
Table:
Name: Table1
Labels:
Name: LabelNomeTabela
Left: 10
Top: 8
Width: 179
Height: 13
Caption: Digite o Nome da Tabela a Ser Criada
Caixa de Texto:
Name: EditNome
Left: 10
Valor Significado
ixPrimary O ndice ser a chave primria da tabela.
ixUnique No pode haver duplicidade de valores.
ixDescending A indexao ser decrescente.
ixExpression O ndice depende de uma expresso-chave do dBASE.
ixCaseInsensitive O ndice no diferencia caracteres maisculos e minsculos (no se aplica ao dBASE).
Top: 24
Width: 280
Height: 21
RadioGroups:
Name: RGTipo
Left: 10
Top: 50
Width: 285
Height: 40
Caption: Tipo da Tabela
Columns: 3
ItemIndex: 0
Items. Paradox, DBase, ASCII
GroupBox:
Name: GroupboxDadosDosCampos
Left: 10
Top: 94
Width: 350
Height: 140
Caption: Dados de Cada Campo:
Name: GroupBoxIndices
Left: 10
Top: 240
Width: 350
Height: 100
Caption: Dados dos ndices
Boto de Comando:
Name: BotaoFechar
Left: 317
Top: 58
Width: 75
Height: 25
Kind: bkClose
Caption: &Fechar
Name: BotaoCriaTabela
Left: 138
Top: 344
Width: 150
Height: 25
Caption: Criar Tabela
Kind: bkOK
Objetos colocados dentro do GroupBox GroupboxDadosDosCampos:
Labels:
Name: LabelNomeCampo
Left: 16
Top: 32
Width: 84
Height: 13
Caption: Nome do campo:
Name: LabelTipoCampo
Left: 16
Top: 68
Width: 77
Height: 13
Caption: Tipo do campo:
Name: LabelTamanhoCampo
Left: 16
Top: 100
Width: 51
Height: 13
Caption: Tamanho:
Caixa de Texto:
Name: EditNomeCampo
Left: 130
Top: 24
Width: 120
Height: 21
ComboBox:
Name: ComboBoxTipo
Left: 145
Top: 60
Width: 120
Height: 21
ItemHeight: 13
Items. Boolean, Date, DateTime, Float, Integer, SmallInt, String, Time, Word
Name: EditSize
Left: 130
Top: 96
Width: 40
Height: 21
ReadOnly: True
Text: 0
Objetos UpDown:
Name: UpDown1
Left: 170
Top: 96
Width: 15
Height: 21
Associate: EditSize
Min: 0
Max: 255
Position: 0
Wrap: False
CheckBoxes:
Name: Requerido
Left: 200
Top: 98
Width: 110
Height: 17
Alignment: taLeftJustify
Caption: Campo Requerido
Boto de Comando:
Name: BotaoAddCampo
Left: 290
Top: 45
Width: 120
Height: 25
Caption: Adicionar Campo
Kind: bkOK
Objetos colocados dentro do GroupBoxIndices:
Labels:
Name: LabelCampos
Left: 10
Top: 15
Width: 41
Height: 13
Caption: Campos:
Name: LabelNomeIndice
Left: 145
Top: 15
Width: 75
Height: 13
Caption: Nome do ndice:
ListBoxes:
Name: ListBoxCampos
Left: 10
Top: 30
Width: 120
Height: 65
ItemHeight: 13
MultiSelect: True
CheckBoxes:
Name: Primaria
Left: 280
Top: 32
Width: 95
Height: 17
Caption: Chave Primria
Name: Decrescente
Left: 280
Top: 69
Width: 95
Height: 17
Caption: Decrescente
Caixa de Texto:
Name: EditNomeIndice
Left: 145
Top: 30
Width: 120
Height: 21
Boto de Comando
Name: BotaoAddIndice
Left: 145
Top: 65
Width: 150
Height: 25
Caption: Adicionar ndice
Kind: bkOK
Codificao: Para inicializar adequadamente o combobox, defina da seguinte maneira o procedimento
associado ao evento OnCreate do formulrio:
procedure TFormCriaTabelas.FormCreate(Sender: TObject);
begin
ComboboxTipo.ItemIndex := 0;
UPDown1.Max := 0;
end;
Isso faz com que o combobox exiba o item Boolean quando o formulrio exibido. Como apenas o
tipo String pode ter tamanho distinto de 0, as propriedades Text do componente EditSize e as de
UpDown1 so inicializadas com o valor 0.
A mudana do item selecionado no combobox tratada no procedimento associado ao seu evento
OnChange, como mostrado a seguir.
procedure TFormCriaTabelas.ComboBoxTipoChange(Sender: TObject);
begin
case ComboboxTipo.ItemIndex of
6 :
begin
EditSize.Text := 10;
UPDown1.Max := 255;
end;
else
begin
EditSize.Text := 0;
UPDown1.Max := 0;
end;
end;
end;
A criao de campos tratada no procedimento associado ao evento OnClick do boto BotaoAddCampo,
mostrado a seguir.
procedure TFormCriaTabelas.BotaoAddCampoClick(Sender: TObject);
var
Tipo : TFieldType;
begin
Case comboboxtipo.itemindex of
0 :
Tipo := ftBoolean;
1 :
Tipo := ftDate;
2 :
Tipo := ftDateTime;
3 :
Tipo := ftFloat;
4 :
Tipo := ftInteger;
5 :
Tipo := ftSmallInt;
6 :
Tipo := ftString;
7 :
Tipo := ftTime;
8 :
Tipo := ftWord;
end;
Table1.FieldDefs.Add(EditNomeCampo.Text,Tipo,StrToInt(EditSize.Text),Requerido.Checked);
ListBoxCampos.Items.Add(EditNomeCampo.Text);
EditNomeCampo.Clear;
end;
Inicialmente, o tipo de campo definido em funo do item selecionado no combobox. Depois, o
campo adicionado tabela usando o mtodo Add da propriedade FieldDefs do componente Table e
seu nome includo no ListBox que exibe os nomes dos campos. Para finalizar, remove-se o texto
exibido no componente EditNomeCampo.
A criao de ndices tratada no procedimento associado ao evento OnClick do boto BotaoAddIndice,
mostrado a seguir.
procedure TFormCriaTabelas.BotaoAddIndiceClick(Sender: TObject);
var
i : integer;
campos : string;
Opcoes : TIndexOptions;
begin
campos := ;
for i :=0 to ListBoxCampos.Items.Count-1 do
if ListBoxCampos.Selected[i] then
begin
campos := campos+ListBoxCampos.Items[i] + ;;
end;
campos := copy(campos,1,Length(campos)-1);
Opcoes := [ixUnique];
if Primaria.Checked then Opcoes := Opcoes + [ixPrimary];
if Decrescente.Checked then Opcoes := Opcoes + [ixDescending];
Table1.IndexDefs.Add(EditNomeIndice.Text,campos,Opcoes);
EditNomeIndice.Clear;
end;
Inicialmente, verificam-se quais os campos selecionados no ListBox e armazenam-se, na varivel cam-
pos, os nomes dos campos que formam o ndice que est sendo criado. Em seguida, define-se o terceiro
parmetro em funo da seleo ou no dos CheckBoxes Primria e Descendente.
A criao do ndice feita em uma chamada ao mtodo Add da propriedade IndexDefs do componente Table.
Para finalizar, remove-se o texto exibido no componente EditNomeIndice.
A criao da tabela tratada no procedimento associado ao evento OnClick do boto BotaoCriaTabela,
mostrado a seguir.
procedure TFormCriaTabelas.BotaoCriaTabelaClick(Sender: TObject);
begin
case RGTipo.ItemIndex of
0:
Table1.TableType := ttParadox;
1 :
Table1.TableType := ttDBase;
2 :
Table1.TableType := ttASCII;
end;
Table1.CreateTable;
ListBoxCampos.Items.Clear;
EditNome.Clear;
end;
Inicialmente, verifica-se qual o tipo selecionado para a tabela. Em seguida, a tabela criada executando-
se o mtodo Createtable do componente Table, e o contedo do listbox removido (bem como o texto
do componente EditNome, que define o nome da tabela a ser criada):
Para zerar a lista de campos e ndices da tabela que est sendo criada, deve-se executar o mtodo Clear
das propriedades FieldDefs e IndexDefs do componente Table, o que feito no procedimento associado
ao evento OnExit do componente EditNome, como mostrado a seguir.
procedure TFormCriaTabela.EditNomeExit(Sender: TObject);
begin
Table1.TableName := EditNome.Text;
Table1.FieldDefs.Clear;
Table1.IndexDefs.Clear;
end;
Apresenta-se a seguir o cdigo da unit associada a esse formulrio:
unit UnitCriarTabela;
interface
uses
StdCtrls, ComCtrls, Buttons, ExtCtrls, Db, DBTables;
type
TFormCriaTabelas = class(TForm)
Table1: TTable;
LabelNomeTabela: TLabel;
EditNome: TEdit;
RGTipo: TRadioGroup;
GroupBoxDadosDosCampos: TGroupBox;
GroupBoxIndices: TGroupBox;
BitBtn1: TBitBtn;
BotaoCriaTabela: TBitBtn;
EditNomeCampo: TEdit;
ComboBoxTipo: TComboBox;
EditSize: TEdit;
Label1: TLabel;
Label2: TLabel;
Label3: TLabel;
UpDown1: TUpDown;
Requerido: TCheckBox;
BotaoAddCampo: TBitBtn;
ListBoxCampos: TListBox;
EditNomeIndice: TEdit;
BotaoAddIndice: TBitBtn;
LabelCampos: TLabel;
LabelNomeIndice: TLabel;
Primaria: TCheckBox;
Decrescente: TCheckBox;
procedure ComboBoxTipoChange(Sender: TObject);
procedure BotaoAddCampoClick(Sender: TObject);
procedure BotaoAddIndiceClick(Sender: TObject);
procedure BotaoCriaTabelaClick(Sender: TObject);
procedure EditNomeExit(Sender: TObject);
private
public
end;
var
FormCriaTabelas: TFormCriaTabelas;
implementation
{$R *.DFM}
procedure TFormCriaTabelas.FormCreate(Sender: TObject);
begin
ComboboxTipo.ItemIndex := 0;
UPDown1.Max := 0;
end;
procedure TFormCriaTabelas.ComboBoxTipoChange(Sender: TObject);
begin
case ComboboxTipo.ItemIndex of
6 :
begin
EditSize.Text := 10;
UPDown1.Max := 255;
end;
else
begin
EditSize.Text := 0;
UPDown1.Max := 0;
end;
end;
end;
procedure TFormCriaTabelas.BotaoAddCampoClick(Sender: TObject);
var
Tipo : TFieldType;
begin
Case comboboxtipo.itemindex of
0 :
Tipo := ftBoolean;
1 :
Tipo := ftDate;
2 :
Tipo := ftDateTime;
3 :
Tipo := ftFloat;
4 :
Tipo := ftInteger;
5 :
Tipo := ftSmallInt;
6 :
Tipo := ftString;
7 :
Tipo := ftTime;
8 :
Tipo := ftWord;
end;
Table1.FieldDefs.Add(EditNomeCampo.Text,Tipo,StrToInt(EditSize.Text),Requerido.Checked);
ListBoxCampos.Items.Add(EditNomeCampo.Text);
EditNomeCampo.Clear;
end;
procedure TFormCriaTabelas.BotaoAddIndiceClick(Sender: TObject);
var
i : integer;
campos : string;
Opcoes : TIndexOptions;
begin
campos := ;
for i :=0 to ListBoxCampos.Items.Count-1 do
if ListBoxCampos.Selected[i] then
begin
campos := campos+ListBoxCampos.Items[i] + ;;
end;
campos := copy(campos,1,Length(campos)-1);
Opcoes := [ixUnique];
if Primaria.Checked then Opcoes := Opcoes + [ixPrimary];
if Decrescente.Checked then Opcoes := Opcoes + [ixDescending];
Table1.IndexDefs.Add(EditNomeIndice.Text,campos,Opcoes);
EditNomeIndice.Clear;
end;
procedure TFormCriaTabelas.BotaoCriaTabelaClick(Sender: TObject);
begin
case RGTipo.ItemIndex of
0:
Table1.TableType := ttParadox;
1 :
Table1.TableType := ttDBase;
2 :
Table1.TableType := ttASCII;
end;
Table1.CreateTable;
ListBoxCampos.Items.Clear;
EditNome.Clear;
end;
procedure TFormCriaTabelas.EditNomeExit(Sender: TObject);
begin
Table1.TableName := EditNome.Text;
Table1.FieldDefs.Clear;
Table1.IndexDefs.Clear;
end;
end.
COMPONENTES E MTODOS DE NAVEGAO
O componente DBNavigator permite a navegao pelos registros de uma tabela, alm da incluso,
edio e excluso de registros.
As principais propriedades desse componente so:
DataSource: Indica o componente DataSource ao qual estar conectado.
VisibleButtons: Essa propriedade define os botes a serem exibidos pelo componente, e muito
til em situaes nas quais, por exemplo, desejamos que o componente seja utilizado apenas
para fins de navegao pelos registros da tabela.
Voc tambm pode definir os botes que devem ou no ser exibidos por esse tipo de controle, alterando-
se o valor da propriedade VisibleButtons durante a execuo de um aplicativo. Como essa propriedade
definida por um conjunto, cada elemento representa um dos botes a ser exibido. O valor default
dessa propriedade exibe todos os botes, isto :
VisibleButtons:= [nbFirst,nbPrior,nbNext,nbLast,nbInsert,nbDelete,nbEdit,nbPost,nbCancel,nbRefresh]
Voc pode alterar essa propriedade mediante a incluso de uma linha de cdigo ou modificando os
valores das subpropriedades de VisibleButtons diretamente no Object Inspector.
Para exibir essas subpropriedades, d um duplo clique com o boto esquerdo do mouse sobre o sinal
(+) exibido esquerda do nome da propriedade VisibleButtons. As subpropriedades so exibidas
(podendo ser diretamente alteradas) e o sinal (+) substitudo por (-). Dando um duplo clique com o
boto esquerdo do mouse sobre o smbolo (-), as subpropriedades so novamente ocultadas. Para
exibir um boto, atribua o valor True subpropriedade correspondente, e False em caso contrrio.
Lembre-se: a existncia de um sinal de (+) imediatamente esquerda do nome de uma propriedade no Object Inspector indica que essa
propriedade tem subpropriedades.
Cada subpropriedade (de cima para baixo) corresponde a um dos botes (da esquerda para a direita).
ShowHint: Essa propriedade uma varivel booleana que define se o componente deve ou no
exibir strings de auxlio quando o ponteiro do mouse estiver sobre cada um dos seus botes.
Hints: Essa propriedade um objeto da classe TStrings e define as strings de auxlio dos diversos
botes exibidos pelo componente DBNavigator (permitindo a sua personalizao).
Para personalizar as strings de auxlio do controle DBNavigator, execute os seguintes procedimentos:
1. Selecione o componente DBNavigator, clicando sobre o mesmo com o boto esquerdo do
mouse.
2. Selecione a propriedade Hints diretamente no Object Inspector.
3. Clique com o boto esquerdo do mouse sobre as reticncias (.) exibidas do lado direito da
propriedade no Object Inspector. Ser exibida a caixa de dilogo String list editor.
4. Digite as expresses mostradas na Figura 23.14.
Nessa caixa de dilogo, cada string digitada em uma linha corresponde string de auxlio de um boto. A primeira linha corresponde
ao primeiro boto (da esquerda para a direita), a segunda linha ao segundo boto e assim por diante.
Figura 23.17: Configurando as strings de auxlio para o componente DBNavigator.
Os mtodos correspondentes a cada um desses botes, disponveis para os objetos da classe TTable, so:
Primeiro Registro: Mtodo First.
Registro Anterior: Mtodo Prior.
Prximo Registro: Mtodo Next.
ltimo Registro: Mtodo Last.
Inserir Registro: Mtodo Append.
Deletar Registro: Mtodo Delete.
Editar Registro: Mtodo Edit.
Gravar Registro: Mtodo Post.
Cancelar Edio do Registro: Mtodo Cancel.
Atualizar a Exibio do Registro: Mtodo Refresh.
A ttulo de exemplificao, ser criado um formulrio para acessar e exibir os registros da tabela
Customer.db, no qual ser inserido um componente DBNavigator e vrios botes de comando utilizados
como alternativa ao componente DBNavigator.
seus nomes default, pois em exemplos simples como este tal fato no gera qualquer tipo de problema.
Formulrio:
Name: FormNavegacao
Width: 300
Height: 435
Caption: Formulrio de Navegao
Table:
Name: TblCustomers
Active: True
DataSource:
Name: DatasourceCustomers
DataSet: TblCustomers
DBNavigator:
Name: DBNavigator1
Left: 50
Top: 15
Width: 240
Height: 25
DataSource: DatasourceCustomers
DBGrid:
Name: DBGrid1
Left: 10
Top: 55
Width: 410
Height: 95
DataSource: DatasourceCustomers
Botes de Comando:
Name: BotaoPrimeiro
Left: 6
Top: 165
Width: 100
Height: 25
Caption: Primeiro Registro
Name: BotaoAnterior
Left: 112
Top: 165
Width: 100
Height: 25
Caption: Registro Anterior
Name: BotaoProximo
Left: 219
Top: 165
Width: 100
Height: 25
Caption: Prximo Registro
Name: BotaoUltimo
Left: 325
Top: 165
Width: 100
Height: 25
Caption: ltimo Registro
Name: BotaoAdicionar
Left: 6
Top: 200
Width: 100
Height: 25
Caption: Adicionar Registro
Name: BotaoDeletar
Left: 112
Top: 200
Width: 100
Height: 25
Caption: Deletar Registro
Name: BotaoEditar
Left: 219
Top: 200
Width: 100
Height: 25
Caption: Editar Registro
Name: BotaoGravar
Left: 325
Top: 200
Width: 100
Height: 25
Caption: Gravar Registro
Name: BotaoCancelar
Left: 112
Top: 235
Width: 100
Height: 25
Caption: Cancelar
Name: BotaoAtualizar
Left: 219
Top: 235
Width: 100
Height: 25
Caption: Atualizar
Name: BotaoFechar
Left: 315
Top: 15
Width: 75
Height: 25
Caption: &Fechar
Kind: bkClose
Codificao: O cdigo do procedimento associado ao evento OnClick de cada um dos botes de comando
(reproduzidos a seguir) consiste simplesmente em uma chamada a um dos mtodos do componente
TblCustomer, e dispensa maiores explicaes.
procedure TFormNavegacao.BotaoPrimeiroClick(Sender: TObject);
begin
TblCustomers.First;
end;
procedure TFormNavegacao.BotaoAnteriorClick(Sender: TObject);
begin
TblCustomers.Prior;
end;
procedure TFormNavegacao.BotaoProximoClick(Sender: TObject);
begin
TblCustomers.Next;
end;
procedure TFormNavegacao.BotaoUltimoClick(Sender: TObject);
begin
TblCustomers.Last;
end;
procedure TFormNavegacao.BotaoAdicionarClick(Sender: TObject);
begin
TblCustomers.Append;
end;
procedure TFormNavegacao.BotaoDeletarClick(Sender: TObject);
begin
TblCustomers.Delete;
end;
procedure TFormNavegacao.BotaoEditarClick(Sender: TObject);
begin
TblCustomers.Edit;
end;
procedure TFormNavegacao.BotaoGravarClick(Sender: TObject);
begin
TblCustomers.Post;
end;
procedure TFormNavegacao.BotaoCancelarClick(Sender: TObject);
begin
TblCustomers.Cancel;
end;
procedure TFormNavegacao.BotaoAtualizarClick(Sender: TObject);
begin
TblCustomers.Refresh;
end;
Apresenta-se a seguir a codificao completa da unit associada a esse formulrio:
unit UnitNavegacao;
interface
uses
StdCtrls, Buttons, Grids, DBGrids, Db, DBTables, ExtCtrls, DBCtrls;
type
TFormNavegacao = class(TForm)
DBNavigator1: TDBNavigator;
DataSourceCustomers: TDataSource;
DBGrid1: TDBGrid;
BotaoPrimeiro: TButton;
BotaoAnterior: TButton;
BotaoProximo: TButton;
BotaoUltimo: TButton;
BotaoAdicionar: TButton;
BotaoDeletar: TButton;
BotaoEditar: TButton;
BotaoGravar: TButton;
BotaoCancelar: TButton;
BotaoAtualizar: TButton;
BitBtn1: TBitBtn;
procedure BotaoPrimeiroClick(Sender: TObject);
procedure BotaoAnteriorClick(Sender: TObject);
procedure BotaoProximoClick(Sender: TObject);
procedure BotaoUltimoClick(Sender: TObject);
procedure BotaoAdicionarClick(Sender: TObject);
procedure BotaoDeletarClick(Sender: TObject);
procedure BotaoEditarClick(Sender: TObject);
procedure BotaoGravarClick(Sender: TObject);
procedure BotaoCancelarClick(Sender: TObject);
procedure BotaoAtualizarClick(Sender: TObject);
private
public
end;
var
FormNavegacao: TFormNavegacao;
implementation
{$R *.DFM}
procedure TFormNavegacao.BotaoPrimeiroClick(Sender: TObject);
begin
TblCustomers.First;
end;
procedure TFormNavegacao.BotaoAnteriorClick(Sender: TObject);
begin
TblCustomers.Prior;
end;
procedure TFormNavegacao.BotaoProximoClick(Sender: TObject);
begin
TblCustomers.Next;
end;
procedure TFormNavegacao.BotaoUltimoClick(Sender: TObject);
begin
TblCustomers.Last;
end;
procedure TFormNavegacao.BotaoAdicionarClick(Sender: TObject);
begin
TblCustomers.Append;
end;
procedure TFormNavegacao.BotaoDeletarClick(Sender: TObject);
begin
TblCustomers.Delete;
end;
procedure TFormNavegacao.BotaoEditarClick(Sender: TObject);
begin
TblCustomers.Edit;
end;
procedure TFormNavegacao.BotaoGravarClick(Sender: TObject);
begin
TblCustomers.Post;
end;
procedure TFormNavegacao.BotaoCancelarClick(Sender: TObject);
begin
TblCustomers.Cancel;
end;
procedure TFormNavegacao.BotaoAtualizarClick(Sender: TObject);
begin
TblCustomers.Refresh;
end;
end.
TRADUO DA MENSAGEM DELETE RECORD DO COMPONENTE TABLE
Para traduzir a mensagem Delete Record?, exibida sempre que se remove um registro de uma tabela,
voc deve executar os seguintes procedimentos:
1. Atribua o valor False propriedade ConfirmDelete do componente Table.
2. Digite o seguinte cdigo do procedimento associado ao evento OnDeleteRecord do
componente Table:
if MessageDlg(Deseja Realmente Deletar o Registro Selecionado
?,mtconfirmation,mbokcancel,0) = mrok
then
Abort;
EXEMPLO DE UTILIZAO DO COMPONENTE TSESSION
Conforme descrito anteriormente, o componente Tsession permite o gerenciamento de vrias conexes
independentes de bancos de dados em uma nica aplicao. Esse componente muito til quando se
quer controlar o acesso de arquivos paradox em uma rede ou quando se desenvolve uma aplicao de
bancos de dados em mltiplas camadas.
O Delphi cria automaticamente um objeto da classe TSession chamado Session em todas as aplicaes
que acessam bancos de dados mas que no incluem explicitamente esse componente.
Aplicaes que acessam simultaneamente tabelas Paradox situadas em endereos distintos de uma rede
podem estabelecer mltiplas sesses, uma para cada endereo. Alm disso, a utilizao de componentes
TSession muito til quando se quer estabelecer conexes mltiplas e concorrentes com um mesmo
banco de dados (como, por exemplo, quando se quer estabelecer duas consultas SQL simultneas).
Conforme ser mostrado no exemplo a seguir, o componente TSession tem mtodos (descritos em
tpicos anteriores) que permitem obter informaes importantes sobre as conexes a um banco de
dados. Dentre esses mtodos, podem-se destacar:
AddAlias, que permite que se crie um alias durante a execuo do aplicativo.
AddStandardAlias, semelhante ao mtodo AddAlias, mas que recebe trs strings como
parmetros. A primeira define o alias que est sendo criado, a segunda o path a que o Alias se
refere e a terceira pode ser igual a um dos seguintes valores: Paradox, dBASE ou ASCIIDRV.
Para este ltimo parmetro, uma string nula equivale a Paradox.
DeleteAlias, que faz justamente o inverso, isto , remove um alias do BDE.
GetAliasNames, que coloca em um objeto da classe TStrings, passado como parmetro na
chamada do procedimento, os nomes de todos os alias configurados pelo BDE.
GetAliasParams, que recebe como primeiro parmetro o nome de um Alias (na forma de uma
string) e retorna, em um objeto da classe TStrings (que deve ser passado como segundo
parmetro), os parmetros do alias cujo nome foi fornecido.
IsAlias, que recebe uma string como parmetro e determina se j existe um alias com o nome
definido por essa string.
GetTableNames, que retorna os nomes das tabelas associadas a um componente TDatabase
passado como parmetro.
No exemplo descrito a seguir, os mtodos supracitados sero utilizados na obteno de informaes do BDE.
seus nomes default, pois, em exemplos simples como este, tal fato no gera qualquer tipo de problema:
Formulrio:
Name: FormSession
Width: 350
Height: 400
Caption: Exemplo de Uso do Objeto Session
Botes de Comando:
Name: BotaoRemove
Left: 93
Top: 126
Width: 150
Height: 25
Caption: Remover Alias
Kind: bkOk
Name: BotaoFechar
Left: 133
Top: 336
Width: 75
Height: 25
Kind: bkClose
Caption: &Fechar
Labels:
Name: Label1
Left: 36
Top: 6
Width: 89
Height: 13
Caption: Selecione um alias
Name: Label2
Left: 184
Top: 6
Width: 140
Height: 13
Caption: Tabelas Definidas do alias Selecionado
ListBoxes:
Name: ListBoxAlias
Left: 36
Top: 21
Width: 125
Height: 97
IntegralHeight: True
ItemHeight: 13
Name: ListBoxTabelas
Left: 184
Top: 48
Width: 150
Height: 97
IntegralHeight: True
ItemHeight: 13
GroupBox:
Name: GroupBox1
Left: 34
Top: 158
Width: 273
Height: 164
Caption: Criao de Alias do Paradox
Objetos colocados dentro do groupBox:
Labels:
Name: Label3
Left: 16
Top: 24
Width: 31
Height: 13
Caption: Nome
Name: Label4
Left: 16
Top: 47
Width: 39
Height: 13
Caption: Diretrio
Caixas de Texto:
Name: EditNome
Left: 61
Top: 20
Text:
Width: 170
Height: 21
DirectoryListBox:
Name: ListaDiretorio
Left: 61
Top: 47
Width: 170
Height: 82
ItemHeight: 16
Botes de Comando:
Name: BotaoCria
Left: 99
Top: 133
Width: 75
Height: 25
Caption: Criar
Kind: bkOK
Codificao: A codificao deste exemplo consiste basicamente em chamadas aos mtodos do objeto
Session, da classe TSession, descritos anteriormente. Nos mtodos que necessitam de objetos da classe
TStrings como parmetro, este passado como a propriedade Items de um ListBox.
So utilizados dois ListBoxes, um para exibir os nomes dos alias e outro para exibir os nomes das
tabelas para o alias selecionado.
No procedimento associado ao evento OnCreate do formulrio, mostrado a seguir, os ListBoxes so
carregados com os nomes dos alias e das tabelas do primeiro alias:
procedure TFormSession.FormCreate(Sender: TObject);
begin
ListaDiretorio.Directory := c:\;
Session.GetAliasNames(ListBoxAlias.Items);
ListBoxAlias.ItemIndex := 0;
Session.GetTableNames(ListBoxAlias.Items[ListBoxAlias.ItemIndex],,false,false,
ListBoxTabelas.items);
end;
No procedimento associado ao evento OnClick do primeiro ListBox, atualiza-se o contedo do segundo,
como mostra o trecho de cdigo a seguir.
procedure TFormSession.ListBoxAliasClick(Sender: TObject);
begin
Session.GetTableNames(ListBoxAlias.Items[ListBoxAlias.ItemIndex],,
false,false,ListBoxTabelas.items);
end;
O procedimento associado ao evento OnClick do boto Cria, apresentado a seguir, verifica se o alias a ser
criado j existe e, em caso negativo, cria o novo alias com o nome desejado. Por fim, atualiza a lista de alias:
procedure TFormSession.BotaocriaClick(Sender: TObject);
begin
if not(Session.IsAlias(EditNome.Text))
then Session.AddStandardAlias(EditNome.Text,ListaDiretorio.
Directory,Paradox)
else ShowMessage(J Existe um Alias com esse Nome);
end;
A remoo de um alias feita no procedimento associado ao evento OnClick do componente
BotaoRemove, apresentado a seguir. Inicialmente, o procedimento solicita uma confirmao do usurio
e, em caso positivo, elimina o alias selecionado e atualiza a exibio dos ListBoxes.
procedure TFormSession.BotaoremoveClick(Sender: TObject);
var
indice : integer;
begin
if MessageDlg(Deseja Realmente Deletar o Alias Selecionado
then
begin
indice := ListBoxAlias.ItemIndex-1;
Session.DeleteAlias(ListBoxAlias.Items[ListBoxAlias.ItemIndex]);
ListBoxAlias.ItemIndex := indice;
end;
end;
Para acessar o componente Session, voc deve incluir a unit dbTables na clusula uses da unit do formulrio. Repare que, neste
exemplo, no inclumos explicitamente os componentes TSession e TDatabase no formulrio, e nesses casos a aplicao trata de criar
dinamicamente os componentes necessrios.
Apresenta-se a seguir o cdigo completo da unit associada ao formulrio.
unit UnitCriaAlias;
interface
uses
FileCtrl, StdCtrls, Buttons, dbTables;
type
TFormSession = class(TForm)
Label1: TLabel;
Label2: TLabel;
ListBoxAlias: TListBox;
ListBoxTabelas: TListBox;
Botaoremove: TBitBtn;
GroupBox1: TGroupBox;
Label3: TLabel;
EditNome: TEdit;
Label4: TLabel;
ListaDiretorio: TDirectoryListBox;
Botaocria: TBitBtn;
BitBtn3: TBitBtn;
procedure ListBoxAliasClick(Sender: TObject);
procedure BotaocriaClick(Sender: TObject);
procedure BotaoremoveClick(Sender: TObject);
private
public
end;
var
FormSession: TFormSession;
implementation
{$R *.DFM}
procedure TFormSession.FormCreate(Sender: TObject);
begin
ListaDiretorio.Directory := c:\;
ListBoxAlias.ItemIndex := 0;
end;
procedure TFormSession.ListBoxAliasClick(Sender: TObject);
begin
Session.GetTableNames(ListBoxAlias.Items[ListBoxAlias.ItemIndex],,
false,false,ListBoxTabelas.items);
end;
procedure TFormSession.BotaocriaClick(Sender: TObject);
begin
if not(Session.IsAlias(EditNome.Text))
then Session.AddStandardAlias(EditNome.Text,ListaDiretorio.
Directory,Paradox)
else ShowMessage(J Existe um Alias com esse Nome);
end;
procedure TFormSession.BotaoremoveClick(Sender: TObject);
var
indice : integer;
begin
if MessageDlg(Deseja Realmente Deletar o Alias Selecionado
then
begin
indice := ListBoxAlias.ItemIndex-1;
Session.DeleteAlias(ListBoxAlias.Items[ListBoxAlias.ItemIndex]);
ListBoxAlias.ItemIndex := indice;
end;
end;
end.
CONSULTA A BANCOS DE DADOS VIA DECLARAES SQL DEFINIDAS EM RUN-TIME
O acesso para consulta a bancos de dados via declaraes SQL em uma aplicao desenvolvida em
Delphi muito simples. Basta definir corretamente as suas propriedades DataBaseName (que deve ser
o nome de um alias ou diretrio no qual esto armazenadas as tabelas) e SQL, que um objeto da classe
TStrings que armazena a declarao SQL a ser executada pelo componente.
Existem, no entanto, dois mtodos do componente Query que executam tarefas semelhantes em
situaes ligeiramente distintas o mtodo Open e o mtodo ExecSQL:
Open: Esse mtodo abre uma tabela (no caso do componente Table) ou executa uma declarao
SQL baseada em uma consulta (no caso do componente Query), tornando-a ativa e fornecendo
acesso aos seus registros (e, conforme descrito anteriormente, equivale a definir o valor da sua
propriedade Active como True).
ExecSQL: Esse mtodo deve ser utilizado para executar declaraes SQL que alteram o contedo
das tabelas que so acessadas pelo componente, envolvendo comandos como UPDATE, DE-
LETE e INSERT. O mtodo Open, descrito anteriormente, usado para executar as declaraes
SQL que geram consultas, mas no alteram o contedo das tabelas (como, por exemplo, as
declaraes SQL que usam o comando SELECT).
A declarao SQL pode ser definida de duas maneiras:
Na fase de projeto do aplicativo, digitando-se a declarao SQL na caixa de dilogo String List
Editor, exibida quando voc seleciona, com o boto esquerdo do mouse, as reticncias exibidas
direita do nome da propriedade.
Durante a execuo do aplicativo, usando os mtodos da propriedade SQL, que na realidade
um objeto da classe TStrings.
Neste tpico ser apresentado um exemplo em que a declarao SQL definida durante a execuo do
aplicativo, digitando-se a mesma em um componente Memo.
do formulrio, o aspecto visual do formulrio e o cdigo a ser implementado. Alguns componentes
mantiveram seus nomes default, pois, em exemplos simples como este, tal fato no gera qualquer tipo
de problema:
Formulrio:
Name: FormSQL
Width: 435
Height: 300
Caption: Exemplo de Uso de SQL
Labels:
Name: Label1
Left: 24
Top: 136
Width: 118
Height: 13
Caption: Digite a Declarao SQL
Query:
Name: Query1
Active: False
DataSource:
Name: DataSource1
DataSet: Query1
DBGrid:
Name: DBGrid1
Left: 24
Top: 8
Width: 350
Height: 125
Botes de Comando:
Name: BotaoOk
Left: 300
Top: 170
Width: 75
Height: 25
Kind: bkOK
Name: BotaoFechar
Left: 300
Top: 215
Width: 75
Height: 25
Kind: bkClose
Memo:
Name: Memo1
Left: 24
Top: 150
Width: 260
Height: 120
Lines.
Codificao: A nica codificao deste exemplo consiste no procedimento associado ao evento OnClick
de um boto de comando, apresentado a seguir.
Nesse procedimento, o texto digitado no Memo (em sua propriedade Lines) atribudo propriedade
SQL do componente Query1.
Dependendo do fato de o texto representar ou no uma consulta, ser executado o mtodo Open ou
ExecSQL do componente Query1. A funo Pos usada para testar se a palavra Select est ou no
includa na declarao SQL.
Caso haja erro no cdigo SQL, uma mensagem ser exibida para o usurio:
procedure TFormSQL.BotaoOkClick(Sender: TObject);
var
i : integer;
consulta : boolean;
begin
Query1.SQL := Memo1.Lines;
consulta := false;
for i :=0 to Memo1.Lines.Count-1 do
if Pos(SELECT,UpperCase(Memo1.Lines[i]))>0 then consulta := true;
try
if consulta then Query1.Open else Query1.ExecSQL;
except
ShowMessage(Erro no Cdigo SQL);
end;
end;
Repare que, da forma como o exemplo foi preparado, a palvra Select deve ser colocada em uma
nica linha.
Para corrigir a deficincia deste exemplo, recodifique o procedimento associado ao evento OnClick do
boto OK como a seguir:
var
i : integer;
declaracao : string;
consulta : boolean;
begin
declaracao := ;
consulta := false;
if Pos(,Memo1.Lines[i+1]) <> 1
then declaracao := declaracao + Memo1.Lines[i]
else declaracao := declaracao + Memo1.Lines[i]+ ;
Query1.SQL.clear;
Query1.Sql.Add(declaracao);
if Pos(SELECT,UpperCase(declaracao))>0 then consulta := true;
try
except
end;
end;
Deixarei por conta do leitor a compreenso da lgica utilizada.
Nesse caso, pode-se digitar a declarao SQL da maneira mostrada na figura a seguir.
Figura 23.21: Testando a aplicao-exemplo.
Apresenta-se a seguir a codificao completa da unit associada a esse formulrio.
unit UnitSQL;
interface
uses
StdCtrls, Buttons, Db, DBTables, Grids, DBGrids;
type
TFormSQL = class(TForm)
DBGrid1: TDBGrid;
Query1: TQuery;
Memo1: TMemo;
Label1: TLabel;
BotaoOk: TBitBtn;
procedure BotaoOkClick(Sender: TObject);
private
public
end;
var
FormSQL: TFormSQL;
implementation
{$R *.DFM}
var
i : integer;
declaracao : string;
consulta : boolean;
begin
declaracao := ;
consulta := false;
if Pos(,Memo1.Lines[i+1]) <> 1
then declaracao := declaracao + Memo1.Lines[i]
else declaracao := declaracao + Memo1.Lines[i]+ ;
Query1.SQL.clear;
Query1.Sql.Add(declaracao);
if Pos(SELECT,UpperCase(declaracao))>0 then consulta := true;
try
except
end;
end;
end.
UTILIZAO DE PARMETROS EM DECLARAES SQL
Existem situaes em que se deseja utilizar um valor varivel em uma declarao SQL, tambm conhecido
como parmetro.
A definio de um parmetro em uma declarao SQL pode ser feita de duas maneiras:
Na fase de projeto, acessando a declarao Params do componente Query diretamente no
Object Inspector.
Durante a execuo do aplicativo, usando o mtodo AddParams da propriedade Params do
componente Query.
Considere, por exemplo, a seguinte declarao SQL:
Select * From Country Where Continent =:Nome
Essa declarao faz com que s sejam exibidos os registros da tabela Country nos quais o valor do
campo Continent seja igual ao parmetro Nome.
Para definir esse parmetro na fase de projeto do aplicativo, basta digitar esse cdigo na propriedade
SQL do componente Query e selecionar a propriedade Params, para exibir a caixa de dilogo mostrada
na figura a seguir, na qual devem ser exibidos os parmetros da declarao SQL.
Figura 23.22: A caixa de dilogo para definio de parmetros.
Uma vez selecionado um parmetro, suas propriedades podem ser definidas diretamente no Object
Inspector. Dentre essas propriedades, destacam-se o tipo do parmetro e, opcionalmente, um valor
default para o mesmo.
seus nomes default, pois, em exemplos simples como este, tal fato no gera qualquer tipo de problema:
Formulrio:
Name: FormParametros
Width: 435
Height: 220
Caption: Exemplo do Uso de Parmetros em Declaraes SQL
Label:
Name: Label1
Left: 24
Top: 140
Width: 110
Height: 13
Caption: Selecione o Continente:
Componente Query:
Name: Query1
SQL.Strings: (Select * From Country Where Continent = Nome)
Active: True
DataSource:
Name: DataSource1
DataSet: Query1
DBGrid:
Name: DBGrid1
Left: 24
Top: 8
Width: 350
Height: 125
ComboBox:
Name: ComboBox1
Left: 25
Top: 155
Width: 145
Height: 21
ItemHeight: 13
Items: North America, South America
Boto de Comando:
Name: BotaoFechar
Left: 245
Top: 155
Width: 75
Height: 25
TabOrder: 2
Kind: bkClose
Caption: &Fechar
Codificao: A codificao deste exemplo bastante simples. No procedimento associado ao evento OnCreate
do formulrio, define-se o valor selecionado no combobox como igual ao valor default do parmetro:
procedure TFormParametros.FormCreate(Sender: TObject);
begin
end;
A redefinio do parmetro e atualizao da query feita no procedimento associado ao evento
OnChange do comboBox:
procedure TFormParametros.ComboBox1Change(Sender: TObject);
begin
Query1.Close;
Query1.ParamByName(Nome).AsString := ComboBox1.Items[ComboBox1.ItemIndex];
Query1.Prepare;
Query1.Open;
end;
A execuo do mtodo Prepare opcional, mas otimiza a execuo do cdigo.
Apresenta-se a seguir a codificao completa da unit associada ao formulrio.
unit UnitParametroSQL;
interface
uses
StdCtrls, Buttons, Db, DBTables, Grids, DBGrids;
type
TFormParametros = class(TForm)
DBGrid1: TDBGrid;
Query1: TQuery;
Label1: TLabel;
private
public
end;
var
FormParametros: TFormParametros;
implementation
{$R *.DFM}
procedure TFormParametros.FormCreate(Sender: TObject);
begin
end;
begin
Query1.Close;
Query1.ParamByName(Nome).AsString := ComboBox1.Items[ComboBox1.ItemIndex];
Query1.Prepare;
Query1.Open;
end;
end.
UTILIZAO DO RECURSO DE CACHED UPDATES
O recurso de cached updates permite que uma aplicao obtenha um conjunto de registros de uma
base de dados e faa sua edio local (que pode abranger edio, incluso ou remoo de registros) e
posterior atualizao das informaes na base de dados.
Alm de reduzir o trfego de informaes em redes, esse recurso permite o cancelamento de alteraes
feitas de forma indesejada.
Para habilitar o recurso de cached updates, basta definir como True o valor da propriedade
CachedUpdates do componente Query ou Table.
A atualizao dos registros na base de dados feita mediante uma chamada aos mtodos ApplyUpdates
e CommitUpdates do componente Query ou Table. O cancelamento das alteraes feito mediante
uma chamada ao mtodo CancelUpdates desses mesmos componentes (embora a alterao final s
seja garantida aps uma chamada ao mtodo Commit do componente TDatabase responsvel pela
conexo ao banco de dados).
No prximo exemplo, mostraremos como criar uma pequena aplicao que utiliza os recursos de
cached updates.
Apresenta-se a seguir a descrio das principais propriedades dos componentes utilizados na criao do
Formulrio:
Name: FormCachedUpdates
Width: 544
Height: 375
Caption: Exemplo de Utilizao do Recurso de Cached Updates
Labels:
Name: LabelNome
Left: 8
Top: 192
Width: 34
Height: 13
Caption: Nome:
Name: LabelCapital
Left: 216
Top: 192
Width: 41
Height: 13
Caption: Capital:
Name: LabelContinente
Left: 8
Top: 224
Width: 57
Height: 13
Caption: Continente:
Name: LabelArea
Left: 216
Top: 224
Width: 28
Height: 13
Caption: rea:
Name: LabelPopulacao
Left: 8
Top: 256
Width: 57
Height: 13
Caption: Populao:
Componente Query:
Name: Query1
CachedUpdates: True
SQL.Strings: (Select * From Country)
Active: True
RequestLive: True
Componente DataSource:
Name: DataSource1
DataSet: Query1
DBGrid:
Name: DBGrid1
Left: 8
Top: 24
Width: 460
Height: 145
Componentes Caixa de Texto:
Name: EditNome
Left: 72
Top: 188
Width: 120
Height: 21
Name: EditCapital
Left: 270
Top: 188
Width: 120
Height: 21
Name: EditContinente
Left: 72
Top: 220
Width: 120
Height: 21
Name: EditArea
Left: 270
Top: 220
Width: 120
Height: 21
Name: EditPopulacao
Left: 72
Top: 252
Width: 120
Height: 21
Botes de Comando:
Name: BotaoIncluir
Left: 32
Top: 296
Width: 75
Height: 25
Caption: Inclui
TabOrder: 6
Name -= BotaoExcluir
Left: 128
Top: 296
Width: 75
Height: 25
Caption: Excluir
Name: BotaoAplicar
Left: 270
Top: 256
Width: 125
Height: 25
Caption: Aplicar Alteraes
Name: BotaoCancela
Left: 288
Top: 296
Width: 125
Height: 25
Caption: Cancelar Alteraes
Name: BotaoFechar
Left: 440
Top: 276
Width: 75
Height: 25
Kind: bkClose
Codificao: Toda a codificao do programa que implementa este exemplo est definida em
procedimentos associados ao evento OnClick dos botes de comando. Esses procedimentos so
apresentados a seguir e so bastante simples e fceis de compreender.
procedure TFormCachedUpdates.BotaoAplicarClick(Sender: TObject);
begin
Query1.ApplyUpdates;
Query1.CommitUpdates;
Query1.SQL.Clear;
Query1.SQL.Add(Select * From Country);
Query1.Open
end;
procedure TFormCachedUpdates.BotaoCancelarClick(Sender: TObject);
begin
Query1.CancelUpdates;
Query1.SQL.Clear;
Query1.Open
end;
procedure TFormCachedUpdates.BotaoIncluirClick(Sender: TObject);
begin
Query1.SQL.Clear;
Query1.SQL.Add(Insert Into Country(Name,Capital,Area,Population,Continent));
Query1.SQL.Add(VALUES(+EditNome.Text+,+EditCapital.Text+,
+EditArea.Text+,+EditPopulacao.Text+,+EditContinente.Text+));
Query1.ExecSQL;
Query1.SQL.Clear;
Query1.Open
end;
procedure TFormCachedUpdates.BotaoExcluirClick(Sender: TObject);
begin
Query1.Delete;
end;
unit UnitCache;
interface
uses
Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs;
type
TFormCachedUpdates = class(TForm)
LabelNome: TLabel;
LabelCapital: TLabel;
LabelContinente: TLabel;
LabelArea: TLabel;
LabelPopulacao: TLabel;
Query1: TQuery;
DBGrid1: TDBGrid;
EditNome: TEdit;
EditCapital: TEdit;
EditContinente: TEdit;
EditArea: TEdit;
EditPopulacao: TEdit;
BotaoIncluir: TButton;
BotaoExcluir: TButton;
BotaoAplicar: TButton;
BotaoCancela: TButton;
procedure BotaoAplicarClick(Sender: TObject);
procedure BotaoCancelaClick(Sender: TObject);
procedure BotaoIncluirClick(Sender: TObject);
procedure BotaoExcluirClick(Sender: TObject);
private
public
end;
var
FormCachedUpdates: TFormCachedUpdates;
implementation
{$R *.DFM}
procedure TFormCachedUpdates.BotaoAplicarClick(Sender: TObject);
begin
Query1.SQL.Clear;
Query1.Open
end;
procedure TFormCachedUpdates.BotaoCancelaClick(Sender: TObject);
begin
Query1.SQL.Clear;
Query1.Open
end;
procedure TFormCachedUpdates.BotaoIncluirClick(Sender: TObject);
begin
Query1.SQL.Clear;
Query1.SQL.Add(Insert Into Country(Name,Capital,Area,Population,Continent));
Query1.SQL.Add(VALUES(+EditNome.Text+,+EditCapital.Text+,
+EditArea.Text+,+EditPopulacao.Text+,+EditContinente.Text+));
Query1.ExecSQL;
Query1.SQL.Clear;
Query1.Open
end;
procedure TFormCachedUpdates.BotaoExcluirClick(Sender: TObject);
begin
Query1.Delete;
end;
end.
EXEMPLO DE UTILIZAO DO COMPONENTE TUPDATESQL
Conforme j descrito anteriormente, o componente TUpdateSQL permite que se definam instrues
de insero (INSERT), excluso (DELETE) e atualizao (UPDATE) em registros retornados atravs de
uma consulta SQL, mesmo que esta tenha sido definida como uma consulta apenas de leitura (isto ,
a propriedade RequestLive do componente Query igual a False ou os registros foram transformados
em registros apenas de leitura durante a execuo do cdigo).
Esse componente oferece trs propriedades que so objetos da classe TStrings, nas quais devem ser
definidos os cdigos de insero, excluso e atualizao. Essas propriedades so denominadas InsertSQL,
DeleteSQL e ModifySQL, respectivamente.
Como essas propriedades so objetos da classe TStrings, podem ter o seu valor alterado durante a
execuo do aplicativo mediante chamadas aos mtodos Clear, Add e Insert da classe TStrings.
A execuo dessas instrues realizada por uma chamada ao mtodo ExecSQL do componente
UpdateSQL. Esse mtodo, ao contrrio do mtodo de mesmo nome do objeto Query, recebe como
parmetro uma constante que indica o cdigo a ser executado. A tabela a seguir apresenta essas
constantes e seus significados.
com o fato de os registros terem sido gerados apenas para leitura pelo componente Query.
Ser mostrado a seguir um pequeno exemplo de utilizao desse componente.
Apresenta-se inicialmente a descrio das principais propriedades dos componentes utilizados na criao do
Formulrio:
Name: FormUpdateSQL
Width: 544
Height: 375
Caption: Exemplo de uso do Componente UpdateSQL
PixelsPerInch: 96
UpdateSQL:
Name: UpdateSQL1
Left: 24
Top: 16
Query:
Name: Query1
SQL.Strings: (Select * From Country)
UpdateObject: UpdateSQL1
Active: True
DataSource:
Name: DataSource1
DataSet: Query1
Labels:
Name: LabelNome
Left: 24
Top: 200
Width: 34
Height: 13
Caption: Nome:
Name: LabelCapital
Left: 168
Top: 200
Width: 38
Height: 13
Caption: Capital:
Name: LabelContinente
Left: 328
Top: 200
Width: 57
Height: 13
Caption: Continente:
Name: LabelArea
Left: 24
Top: 248
Width: 28
Height: 13
Caption: rea:
Name: LabelPopulacao
Left: 168
Top: 248
Width: 60
Height: 13
Caption: Populao:
DBGrid:
Name: DBGrid1
Left: 24
Top: 48
Width: 480
Height: 130
Botes de Comando:
Name: BotaoInsert
Left: 110
Top: 304
Width: 75
Height: 25
Caption: Inserir
Name: BotaoDelete
Left: 230
Top: 304
Width: 75
Height: 25
Caption: Deletar
Caixas de Texto:
Name: EditNome
Left: 24
Top: 216
Width: 120
Height: 21
Name: EditCapital
Left: 168
Top: 216
Width: 120
Height: 21
Name: EditContinente
Left: 328
Top: 216
Width: 120
Height: 21
Name: EditArea
Left: 24
Top: 264
Width: 120
Height: 21
Name: EditPopulacao
Left: 168
Top: 264
Width: 120
Height: 21
Name: BotaoAtualiza
Left: 352
Top: 262
Width: 75
Height: 25
Kind: bkOk
Name: BotaoFechar
Left: 352
Top: 304
Width: 75
Height: 25
Kind: bkClose
Caption: &Fechar
Codificao: Apresenta-se a seguir a codificao deste aplicativo-exemplo, cujo cdigo muito
semelhante aos j apresentados ao longo deste captulo.
Segue a codificao dos procedimentos associados ao evento OnClick dos botes de comando:
procedure T FormUpdateSQL.BotaoInsertClick(Sender: TObject);
begin UpdateSQL1.InsertSQL.Clear;
UpdateSQL1.InsertSQL.Add(Insert Into Country(Name,Capital,Area,Population,Continent));
UpdateSQL1.InsertSQL.Add(VALUES(+EditNome.Text+,+EditCapital.Text+,
+EditArea.Text+,+EditPopulacao.Text+, +EditContinente.Text+));
UpdateSQL1.ExecSQL(ukInsert);
Query1.disablecontrols;
Query1.Close;
Query1.Open;
Query1.Refresh;
Query1.enablecontrols;
end;
procedure TFormUpdateSQL.BotaoDeleteClick(Sender: TObject);
begin
UpdateSQL1.DeleteSQL.Clear;
UpdateSQL1.DeleteSQL.Add(Delete From Country Where Name =
+Query1.FieldByname(Name).AsString+);
UpdateSQL1.ExecSQL(ukDelete);
Query1.Close;
Query1.Open;
Query1.Refresh;
end;
Cdigo da unit associada ao formulrio:
unit UnitUpdateSQL;
interface
uses
type
TFormUpdateSQL = class(TForm)
LabelNome: TLabel;
LabelCapital: TLabel;
LabelContinente: TLabel;
LabelArea: TLabel;
LabelPopulacao: TLabel;
Query1: TQuery;
DBGrid1: TDBGrid;
EditNome: TEdit;
EditCapital: TEdit;
EditContinente: TEdit;
EditArea: TEdit;
EditPopulacao: TEdit;
BotaoInsere: TButton;
BotaoDelete: TButton;
UpdateSQL1: TUpdateSQL;
BotaoAtualiza: TBitBtn;
procedure BotaoAplicarClick(Sender: TObject);
procedure BotaoCancelaClick(Sender: TObject);
procedure BotaoInsereClick(Sender: TObject);
procedure BotaoDeleteClick(Sender: TObject);
procedure BotaoAtualizaClick(Sender: TObject);
private
public
end;
var
FormUpdateSQL: TFormUpdateSQL;
implementation
{$R *.DFM}
procedure TFormUpdateSQL.BotaoAplicarClick(Sender: TObject);
begin
Query1.SQL.Clear;
Query1.Open
end;
procedure TFormUpdateSQL.BotaoCancelaClick(Sender: TObject);
begin
Query1.SQL.Clear;
Query1.Open
end;
procedure TFormUpdateSQL.BotaoInsereClick(Sender: TObject);
begin
UpdateSQL1.InsertSQL.Clear;
UpdateSQL1.InsertSQL.Add(Insert Into Country(Name,Capital,Area,Population,Continent));
UpdateSQL1.InsertSQL.Add(VALUES(+EditNome.Text+,+EditCapital.Text+,
+EditArea.Text+,+EditPopulacao.Text+, +EditContinente.Text+));
UpdateSQL1.ExecSQL(ukInsert);
Query1.Close;
Query1.Open;
Query1.Refresh;
end;
procedure TFormUpdateSQL.BotaoDeleteClick(Sender: TObject);
begin
UpdateSQL1.DeleteSQL.Clear;
UpdateSQL1.DeleteSQL.Add(Delete From Country Where Name =
+Query1.FieldByname(Name).AsString+);
UpdateSQL1.ExecSQL(ukDelete);
Query1.Close;
Query1.Open;
Query1.Refresh;
end;
procedure TFormUpdateSQL.BotaoAtualizaClick(Sender: TObject);
begin
UpdateSQL1.ExecSQL(ukModify);
end;
end.
KNOW-HOW EM: APLICAO DE SENHAS A TABELAS DO TIPO
PARADOX
PR-REQUISITOS
Experincia prvia no emprego do utilitrio Database Desktop, para criao e manuteno de tabelas do tipo Paradox.
Experincia na criao dinmica de formulrios.
Experincia na utilizao de componentes de acesso a banco de dados.
METODOLOGIA
Apresentao do problema: Aplicao de senhas a tabelas do tipo Paradox.
TCNICA
Apresentao dos procedimentos necessrios aplicao de senhas a tabelas do tipo Paradox em aplicaes desenvolvidas com o Borland Delphi.
DEFININDO SENHAS PARA UMA TABELA DO TIPO PARADOX
Neste tpico sero apresentados os procedimentos necessrios definio de senhas para tabelas do
tipo Paradox, empregando-se o utilitrio Database Desktop.
Ser utilizada como exemplo a tabela Country.db, uma das tabelas-exemplo que acompanham o Delphi.
Para definir uma senha para a tabela Country.db, voc deve executar os seguintes procedimentos:
1. Iniciar a execuo do Database Desktop e abrir a tabela Country.db.
2. Selecionar o item Info Restructure, do menu Table, para exibir a caixa de dilogo Restructure
Paradox Table.
3. Selecione o item Password Security do combobox Table Properties.
4. Selecione o boto Define. Ser exibida a caixa de dilogo Password Security, apresentada na
figura a seguir, e na qual dever ser digitada (e confirmada) uma senha principal para essa
tabela. Neste exemplo, usei como senha a palavra AXCEL.
Figura 23.26: A caixa de dilogo Password Security.
5. Selecione o boto Ok para fechar essa caixa de dilogo.
A partir deste momento, quando a tabela for acessada em futuras sesses de utilizaes do Database
Desktop, ser exibida a seguinte caixa de dilogo:
Figura 23.27: A caixa de dilogo Enter Password(s).
Essa caixa de dilogo permite que voc digite vrias senhas correspondentes a diversas tabelas a serem
abertas numa mesma sesso do Database Desktop, bastando digitar cada uma das senhas e o boto Add.
Para remover uma ou vrias das senhas digitadas, basta selecionar os botes Remove e Remove All.
Figura 23.28: A caixa de dilogo Enter Password(s), exibida
quando se tenta acessar uma tabela a partir de uma aplicao.
DEFININDO SENHAS AUXILIARES PARA UMA TABELA DO TIPO PARADOX
No tpico anterior foram apresentados os procedimentos necessrios definio de uma senha princi-
pal para uma tabela do tipo Paradox.
Existem situaes, no entanto, em que pode ser necessrio conceder a outros usurios o acesso a essa
tabela, ainda que com privilgios de acesso diferenciados, o que pode ser feito definindo-se senhas
auxiliares para a tabela.
Para definir uma senha auxiliar para a tabela Country.db, voc deve executar os seguintes procedimentos:
1. Iniciar a execuo do utilitrio Database Desktop e abrir a tabela Country.db.
2. Selecionar o item Info Restructure, do menu Table, para exibir a caixa de dilogo Restructure
Paradox Table.
3. Selecionar o item Password Security do combobox Table Properties.
4. Selecionar o boto Modify. Ser exibida a caixa de dilogo Password Security.
5. Selecionar o boto Auxiliary Passwords dessa caixa de dilogo. Ser exibida a caixa de dilogo
Auxiliary Passwords.
Figura 23.29: A caixa de dilogo Auxiliary Passwords.
O nico inconveniente que, nesse caso, sempre que a tabela for aberta a partir de uma aplicao, uma
caixa de dilogo semelhante a esta, mostrada na figura a seguir, ser exibida. Veremos em um tpico
posterior como evitar esse conveniente.
Nessa caixa de dilogo voc deve digitar cada senha auxiliar, definir os privilgios de acesso (Table
Rights) selecionando a opo desejada e o boto Add.
INIBINDO A EXIBIO DA CAIXA DE DILOGO ENTER
PASSWORD DURANTE A EXECUO DO SEU APLICATIVO
Conforme descrito anteriormente, existem situaes em que se prefere definir uma caixa de dilogo
personalizada para obter a senha do usurio em uma caixa de texto.
Para que uma aplicao possa acessar uma tabela sem que seja necessrio utilizar a caixa de dilogo Enter
Password, basta utilizar o mtodo AddPassword do componente Session, que recebe como parmetro
uma string com um dos possveis valores para as senhas das tabelas a serem acessadas pela aplicao.
Lembre-se de que, mesmo que no se esteja utilizando explicitamente um componente dessa classe,
um objeto dessa classe (denominado Session) ser automaticamente criado pelo Delphi.
PROTEGENDO SUA APLICAO MEDIANTE DEFINIO DE UMA SENHA
Para evitar que sua aplicao seja utilizada por usurios no autorizados, voc deve executar os seguintes
procedimentos:
1. Criar uma tabela chamada Senha.db, com um campo chamado Senha, que pode ser um campo
alfanumrico de tamanho igual a 10 caracteres, por exemplo.
2. Definir uma senha para a tabela que armazenar a senha de acesso aplicao, senha esta que
pode ser DELPHI, por exemplo. Isso evita que qualquer pessoa possa abrir a tabela e verificar o
valor armazenado no campo.
3. Definir uma senha para a aplicao, e armazenar o seu valor no campo Senha da tabela, que s
precisar possuir um registro. Neste exemplo definiremos a string AXCEL como sendo esta senha.
4. Inclua a unit DB na clusula Uses do arquivo de projeto da sua aplicao.
5. No arquivo de projeto da sua aplicao, inclua o seguinte cdigo:
Session.AddPassword(AXCEL);
Essa linha de cdigo permite que a aplicao tenha acesso irrestrito tabela.
6. Inclua a unit dbTables na clusula Uses da unidade de cdigo associada ao formulrio em que
ser feita a verificao da senha.
7. No formulrio em que ser feita a verificao da senha, declare o seguinte objeto na seo var
da unidade de cdigo a ele associada:
TabelaSenha: TTable;
8. Inclua as seguintes linhas de cdigo no procedimento associado ao evento OnShow do
formulrio em que ser feita a verificao da senha:
TabelaSenha := TTable.Create(self);
TabelaSenha.DatabaseName := DBDEMOS;
Tabelasenha.TableName := Senha.db;
TabelaSenha.Open;
Evidentemente, voc deve usar o SEU alias. O alias DBDEMOS foi usado apenas para ilustrar o cdigo necessrio.
9. Inclua a seguinte linha de cdigo no procedimento associado ao evento OnHide do formulrio
em que ser feita a verificao da senha:
TabelaSenha.Free;
10. No trecho em que o direito de acesso aplicao deve ser verificado, compare o valor armazenado
no campo Senha da tabela Senha.db com o valor fornecido pelo usurio. Considere, por exemplo,
que o usurio digite a senha numa caixa de texto chamada Password.
Essa verificao pode ser feita mediante a incluso de uma linha de cdigo com a seguinte sintaxe:
If TabelaSenha.FieldByName(Senha).AsString = Password.Text
Then
begin
// Cdigo a ser executado se a senha estiver correta
end
else
begin
// Cdigo a ser executado se a senha no estiver correta
end;
CAPTULO 24 BANCO DE DADOS COMPONENTES DE ACESSO VIA ADO
Captulo
de Acesso via ADO
24
Neste captulo sero apresentados as classes e os componentes responsveis pelo acesso a dados via ADO,
a partir de uma aplicao desenvolvida com o Borland Delphi 7. Estes componentes no esto disponveis
para aplicaes baseadas na CLX, pois a tecnologia ADO s est disponvel para o ambiente Windows.
KNOW-HOW EM: CLASSES FUNDAMENTAIS DE ACESSO A BANCOS DE DADOS
VIA ADO A CLASSE TCUSTOMADODATASET E OS COMPONENTES
TADOCONNECTION, TRDSCONNECTION E TADODATASET E TADOCOMMAND
PR-REQUISITOS
METODOLOGIA
Apresentao das classes e dos componentes de acesso a bancos de dados via ADO, juntamente com uma descrio das suas propriedades,
mtodos e eventos.
TCNICA
Descrio das classes e dos componentes de acesso a bancos de dados e apresentao de exemplos de aplicao.
Inicialmente apresentaremos as classes derivadas de TDataset que implementam as principais
funcionalidades da tecnologia Activex Data Objects e depois os componentes efetivamente usados no
desenvolvimento de aplicaes. Estes componentes esto disponveis desde a verso 5 do Delphi, e por
se tratar de uma tecnologia disponvel apenas para o ambiente Windows, tais componentes no esto
disponveis para aplicaes baseadas na CLX.
O mecanismo definido pela tecnologia Activex Data Objects bastante complexo, mas a Borland,
demonstrando mais uma vez a sua superioridade no que se refere a ferramentas de desenvolvimento,
encapsulou este mecanismo em componentes que tornam o seu uso to fcil como no caso do BDE.
O COMPONENTE TADOCONNECTION
Este componente, derivado por herana da classe TCustomConnection, permite que se estabelea uma
conexo a um banco de dados via ADO. Este componente tem uma funcionalidade semelhante ao
TDatabase no mecanismo do Borland Database Engine, e permite que diversos componentes de acesso
estejam diretamente a ele conectados.
Este componente o primeiro componente da pgina ADO da paleta de componentes.
PRINCIPAIS PROPRIEDADES DA CLASSE TADOCONNECTION
Apresenta-se a seguir uma descrio das principais propriedades implementadas na classe
TADOConnection, alm daquelas herdadas das suas classes-base:
Attributes
Essa propriedade definida como uma varivel do tipo TXactAttributes, e na verdade um conjunto
de duas subproprieades, descritas a seguir:
xaCommitRetaining: Especificar este valor como True indica que, ao se fazer uma confirmao
de uma transao via um comando Commit, uma nova transao iniciada automaticamente.
xaAbortRetaining: Especificar este valor como True indica que, ao se fazer um cancelamento
de uma transao via um comando Rollback, uma nova transao iniciada automaticamente.
CommandCount
Essa propriedade definida como uma varivel inteira, e define o nmero de componentes da classe
TADOCommand vinculados a este componente de conexo.
Commands
Essa propriedade definida como uma array de objetos da classe TCommand, e retorna os objetos da
classe TADOCommand vinculados a este componente de conexo que estejam ativos.
CommandTimeOut
Essa propriedade definida como uma varivel inteira, e define o tempo mximo (em segundos) para
a execuo de um comando (seno considera-se que o comando no foi executado com successo). Seu
valor default igual a 30.
ConnectionObject
Essa propriedade fornece acesso direto ao objeto Activex responsvel pela conexo via ADO.
ConnectionString
Essa propriedade definida como uma varivel do tipo WideString e define como ser feita a conexo
ao banco de dados.
ConnectionTimeOut
a ativao de uma conexo (seno considera-se que a conexo no foi executada com sucesso). Seu
Cursorlocation
Essa propriedade definida como uma varivel do tipo TcursorLocation e define se o cursor que aponta
para os registros se situa do lado cliente (ideal para manipulao irrestrita dos registros) ou do lado
servidor (ideal quando o nmero de registros a serem acessados muito grande).
DefaultDatabase
Essa propriedade definida como uma varivel do tipo WideString, e define o banco de dados que a
conexo usar como default.
InTransaction
Essa propriedade definida como uma varivel booleana, e indica se uma transao est em progresso.
State
Essa propriedade definida como uma varivel do tipo TobjectSatae, e pode assumir um dos
seguintes valores:
stClosed: Connection: A conexo no est estabelecida e o objeto no est conectado ao banco
de dados.
stOpen: A conexo no est estabelecida mas o objeto est conectado ao banco de dados.
stConnecting: A conexo est sendo estabelecida.
stExecuting: Conexo j estabelecida e funcionando.
stFetching: A conexo est estabelecida mas ainda est recebendo as informaes do banco de
dados.
PRINCIPAIS MTODOS DA CLASSE TADOCONNECTION
Apresenta-se a seguir uma descrio dos principais mtodos da classe TADOConnection, alm daqueles
herdados das suas classes-base.
BeginTrans
Declarao
function BeginTrans: Integer;
Esse mtodo inicializa uma nova transao com o banco de dados, retornando um valor inteiro indicando
o nvel da transao. Se a transao for inicializada com successo, ser executado o procedimento associado
ao evento OnBeginTransComplete e a propriedade Instransaction receber o valor True.
Cancel
Declarao
procedure Cancel;
Esse mtodo aborta uma tentativa de conexo a um banco de dados.
CloseAllDataSets
Declarao
procedure CloseDataSets(All: Boolean = True);
Esse mtodo desativa todos os objetos derivados da classe todataset a ele conctados, sem no entanto
finalizar a sua prpria conexo ao banco de dados.
CommitTrans
Declarao
procedure CommitTrans;
Esse mtodo realiza um commit sobre a transao corrente.
Execute
Declarao
function Execute(const CommandText: WideString; ExecuteOptions: TExecuteOptions = []):
_RecordSet; overload;
procedure Execute(const CommandText: WideString; var RecordsAffected: Integer; ExecuteOptions:
TExecuteOptions = [eoExecuteNoRecords]); overload;
Esse mtodo executa um comando sobre o banco de dados. Repare que este mtodo sobrecarregado,
possuindo duas implementaes distintas.
O comando a ser executado passado na forma de uma string, alm de outros parmetros que indicam
como os registros devem ser afetados.
GetProcedureNames
Declarao
procedure GetProcedureNames(List: TStrings);
Esse mtodo armazena na lista de strings passada como parmetro os nomes de todos os procedimentos
armazenados existentes no banco de dados ao qual o componente est conectado.
GetTableNames
Declarao
procedure GetTableNames(List: TStrings; SystemTables: Boolean = False);
Esse mtodo armazena na lista de strings passada como parmetro os nomes de todas as tabelas existentes
no banco de dados ao qual o componente est conectado.
Open
Declarao
procedure Open; overload;
procedure Open(const UserID: WideString; const Password: WideString); overload;
Esse mtodo ativa uma conexo ao banco de dados ao qual o componente est conectado. Repare que
este mtodo sobrecarregado, possuindo duas implementaes distintas, sendo que a segunda permite
que se fornea um nome de usurio e uma senha.
RollbackTrans
Declarao
procedure RollbackTrans;
Esse mtodo realiza um rollback sobre a transao corrente.
PRINCIPAIS EVENTOS DA CLASSE TADOCONNECTION
Apresenta-se a seguir uma descrio dos principais eventos da classe TADOConnection, alm daqueles
OnBeginTransComplete
Este evento ocorre quando uma transao iniciada.
OnCommitTransComplete
Este evento ocorre quando uma transao finalizada com um commit.
OnConnectComplete
Este evento ocorre quando uma conexo estabelecida.
OnDisConnect
Este evento ocorre quando uma conexo encerrada.
OnExecuteComplete
Este evento ocorre quando um comando executado com sucesso.
OnInfoMessage
Este evento ocorre quando uma mensagem enviada do banco de dados para a conexo.
OnRollbackTransComplete
Este evento ocorre quando uma transao cancelada com um rollback.
OnWillConnect
Este evento ocorre quando uma conexo est para ser estabelecida.
OnWillCommand
Este evento ocorre quando um comando est para ser executado.
O COMPONENTE TRDSCONNECTION
conexo a um banco de dados remoto via ADO.
Este componente o ltimo componente da pgina ADO da paleta de componentes.
PRINCIPAIS PROPRIEDADES DA CLASSE TRDSCONNECTION
TRDSConnection, alm daquelas herdadas das suas classes-base:
Appserver
Essa propriedade definida como uma varivel do tipo OleVariant, e define o nome do servidor de
aplicaes atravs do qual a conexo ser feita.
ComputerName
Essa propriedade definida como uma varivel do tipo WideString, e define o nome da mquina do servidor
de aplicaes atravs do qual a conexo ser feita. Pode ser uma URL, sua identidade no IIS ou seu DNS.
InternetTimeOut
Essa propriedade definida como uma varivel inteira, e define o tempo mximo (em milissegundos)
para que, se no houver comunicao, a conexo seja desativada (para protocolos http e httpS).
ServerName
Essa propriedade definida como uma varivel do tipo WideString, o ProgID (Identificador) do servidor
de aplicaes.
PRINCIPAIS MTODOS DA CLASSE TRDSCONNECTION
Apresenta-se a seguir uma descrio dos principais mtodos da classe TADOConnection, alm daquelas
GetRecordset
Declarao
function GetRecordset(const CommandText: WideString; ConnectionString: WideString = ): _Recordset;
Esse mtodo faz com que o componente receba um conjunto de registros do banco de dados ao qual
est conectado, aps executar o comando passado como primeiro parmetro, e usando a string de
conexo passada como segundo parmetro.
PRINCIPAIS EVENTOS DA CLASSE TRDSCONNECTION
Esta classe no implementa novos eventos, utilizando os herdados das suas classes-base.
A CLASSE TCUSTOMADODATASET
Conforme descrito anteriormente, a classe TDataSet implementa a funcionalidade genrica para acesso a
tabelas, sem incorporar as funes da API do Borland Database Engine o mecanismo de acesso a banco de
dados criado pela Borland ou, neste caso, o mecanismo de acesso do Activex Data Objects (ADO).
A classe TCustomADODataSet, derivada por herana direta da classe TDataSet, incorpora as principais
caractersticas do mecanismo ADO a alguns dos mtodos declarados na classe TDataSet, sobrecarregando-
os (no caso de mtodos virtuais) ou implementando-os (no caso de mtodos abstratos).
por herana desta classe.
PRINCIPAIS PROPRIEDADES DA CLASSE TCUSTOMADODATASET
CacheSize
Essa propriedade definida como uma varivel inteira, e define o nmero de registros armazenados na
memria local pelo componente. Indica portanto o nmero de registros carregados quando a conexo
atravs do componente se torna ativa.
CanModify
Essa propriedade definida como uma varivel booleana, e define se os registros acessados atravs do
componente podem ou no ser alterados (Na realidade, costuma-se usar a propriedade ReadOnly dos
componentes derivados desta classe).
CommandText
Essa propriedade definida como uma varivel do tipo WideString, e define o comando a ser executado
(geralmente na forma de uma declarao SQL).
CommandTimeOut
a execuo de um comando (seno considera-se que o comando no foi executado com sucesso). Seu
CommandType
Essa propriedade definida como uma varivel do tipo TCommandType, e define o tipo de comando
a ser executado.
Esta propriedade pode assumir um dos seguintes valores:
CmdUnknown: O tipo de comando desconhecido.
cmdText: O comando uma definio textual de uma declarao SQL ou chamada de uma
Stored Procedure.
cmdTable: O comando , na realidade, o nome de uma tabela.
cmdStoredProc: O comando , na realidade, o nome de uma stored procedure.
cmdFile: O comando se refere ao nome de um arquivo no qual um conjunto de registros est
armazenado.
cmdTableDirect: O comando , na realidade, o nome de uma tabela, sendo todos os campos
retornados.
As constantes cmdTable, cmdTableDirect, e cmdOpenFile no so usadas com o componente TADOCommand.
Connection
Essa propriedade definida como uma varivel do tipo TADOConnection, e define o tipo de coconexo
que ser usada pelo componente.
ConnectionString
ao banco de dados.
As propriedades Connection e ConnectionString so mutuamente excludentes.
IndexFieldCount
Essa propriedade definida como uma varivel inteira, e define o nmero de campos que definem o
ndice corrente.
IndexFieldCount
Essa propriedade definida como uma array de objetos da classe TFields, sendo que cada um destes
objetos define um dos campos que formam o ndice corrente.
LockType
Essa propriedade definida como uma varivel do tipo TADOLockType e define como os registros so
protegidos (travados) ao serem acessados pelo componente. o cursor que aponta para os registros se
situa do lado cliente (ideal para manipulao irrestrita dos registros) ou do lado servidor (ideal quando
o nmero de registros a serem acessados muito grande).
Esta propriedade pode assumir um dos valores descritos a seguir:
ltUnspecified: Nenhuma proteo especificada.
ltReadOnly: Os registros s podem ser lidos, sem ser modificados.
ltPessimistic: Proteo aplicada ao registro corrente.
ltOptimistic: Proteo aplicada ao registro corrente, mas apenas quando o mesmo est
sendo editado.
ltBatchOptimistic: Usado em operaes de transferncia de arquivos.
MaxRecords
Essa propriedade definida como uma varivel inteira, e define o nmero mximo de registros retornados
pelo componente.
ParamCheck
Essa propriedade definida como uma varivel booleana, e define se a lista de parmetros do componente
deve ser gerada novamente quando a declarao SQL alterada durante a execuo do aplicativo.
Parameters
Essa propriedade definida como um objeto da classe TParameters, e define os parmetros usados em
uma declarao SQL.
Prepared
Essa propriedade definida como uma varivel booleana, e define se a declarao SQL deve ser preparada
(para otimizao da sua execuo) artes de ser executada.
RecNo
Essa propriedade definida como uma varivel inteira, e define o nmero do registro corrente, dentre
todos os registros provenientes da tabela representada pelo componente. uma propriedade apenas
de leitura, e no pode ter o seu valor diretamente alterado pelo usurio, podendo ter o seu valor
alterado em funo da aplicao de um filtro.
RecordCount
Essa propriedade definida como uma varivel inteira, e define o nmero de registros provenientes da
tabela representada pelo componente. uma propriedade apenas de leitura, e no pode ter o seu valor
diretamente alterado pelo usurio, podendo, no entanto, ter o seu valor alterado em funo da aplicao
de um filtro.
RecordSize
Essa propriedade definida como uma varivel inteira sem sinal (Word), e define o tamanho do registro
acessado pelo componente.
RecordStatus
Essa propriedade definida como uma varivel do tipo TRecordStausSet, e define o status do registro
corrente (novo, modificado, etc.).
Sort
Essa propriedade definida como uma varivel do tipo Widestring, e define o(s) campo(s) pelos quais
os registros acessados pelo componente devem ser ordenados. Os campos devem ser separados por
vrgulas, e podem ser acompanhados das palavras ASCENDING ou DESCENDING, indicando se o
campo ser ordenado de forma ascendente ou descendente. Se no existir um ndice para os campos
especificados, ser criado um ndice temporrio.
PRINCIPAIS MTODOS DA CLASSE TCUSTOMADODATASET
Apresenta-se a seguir uma descrio dos principais mtodos da classe TCustomADODataset, alm
daqueles herdados das suas classes-base.
ApplyUpdates
Declarao
function BookmarkValid(Bookmark: TBookmark): Boolean; override;
Esse mtodo determina se o bookmark passado como parmetro vlido, isto , se h um valor atribudo
ao mesmo.
CancelUpdates
Declarao
Esse mtodo cancela as alteraes feitas localmente, para um componente que acessa uma tabela.
Clone
Declarao
procedure Clone(Source: TCustomADODataSet; LockType: TLockType = ltUnspecified);
Esse mtodo copia os registros de outro componente derivado de TCustomADODataset passado como
parmetro.
CompareBookmarks
Declarao
function CompareBookmarks(Bookmark1, Bookmark2: TBookmark): Integer; override;
Este mtodo compara dois objetos da classe TBookmark, retornando a diferena entre os dois Bookmarks.
DeleteRecords
Declarao
procedure DeleteRecords(AffectRecords: TAffectRecords = arAll);
Este mtodo permite a remoo de um ou mais registros acessados pelo componente, dependendo do
valor passado pelo parmetro AffectRecords passado como parmetro. Este parmetro pode assumir
um dos seguintes valores:
arCurrent: Remove apenas o registro corrente.
arFiltered: Remove apenas os registros que satisfazem a condio definida pelo filtro aplicado
a um componente.
arAll: Remove todos os registros acessados pelo componente.
DeleteRecords
Declarao
procedure FilterOnBookmarks(Bookmarks: array of const);
Este mtodo aplica um filtro que faz com que apenas sejam exibidos os registros para os quais foi
definido um Bookmark.
LoadFromFile
Declarao
procedure LoadFromFile(const FileName: WideString);
Este mtodo recupera de um arquivo (cujo nome passado como primeiro parmetro na forma de
uma string) os registros acessados pelo componente.
Requery
Declarao
procedure Requery(Options: TExecuteOptions = []);
Este mtodo atualiza a exibio dos registros acessados pelo componente, em funo das opes definidas
pelo parmetro Options, que pode ter um dos valores a seguir:
eoAsyncExecute: O comando de atualizao de registros executado de forma assncrona.
eoAsyncFetch: O comando de atualizao de registros executado de forma assncrona,
dependendo do valor especificado na propriedade Cache.
eoAsyncFetchNonBlocking: O comando de atualizao de registros executado sem bloquear
a thread corrente.
eoExecuteNoRecords: Aplica-se a comandos ou stored procedures que no retornam um
conjunto de registros.
SaveToFile
Declarao
procedure SaveToFile(const FileName: String = ; Format: TPersistFormat = pfADTG);
Este mtodo salva em um arquivo (cujo nome passado como primeiro parmetro na forma de uma
string) os registros acessados pelo componente, no formato definido pelo segundo parmetro.
Os formatos possveis para o segundo parmetro so:
pfADTG: Formato Advanced Data Tablegram
pfXML: Formato XML
Seek
Declarao
function Seek(const KeyValues: Variant; SeekOption: TSeekOption = soFirstEQ): Boolean;
Este mtodo pesquisa os registros com base em valores a serem armazenados nos campos que definem
o ndice corrente.
O primeiro parmetro, na forma de uma array de Variants, contm os valores a serem pesquisados nos
campos que formam o ndice corrente.
O segundo parmetro define como dever ser feita a pesquisa, e pode ter um dos seguintes valores:
soFirstEQ: Se um ou mais registros possuem nos campos que formam o indice corrente os
valores definidos na pesquisa, o primeiro registro deste conjunto definido como o registro
corrente. Se nenhum registro atende aos requisitos especificados, o ltimo registro acessado
pelo componente definido como o registro corrente.
soLastEQ: Se um ou mais registros possuem nos campos que formam o indice corrente os
valores definidos na pesquisa, o ltimo registro deste conjunto definido como o registro
corrente. Se nenhum registro atende aos requisitos especificados, o ltimo registro acessado
pelo componente definido como o registro corrente.
.soAfterEQ: Se um ou mais registros possuem nos campos que formam o indice corrente os
valores definidos na pesquisa, o registro aps o primeiro registro deste conjunto definido
como o registro corrente. Se nenhum registro atende aos requisitos especificados, o ltimo
registro acessado pelo componente definido como o registro corrente.
soAfter: Se um ou mais registros possuem nos campos que formam o indice corrente os valores
definidos na pesquisa, o registro aps o ltimo registro deste conjunto definido como o
registro corrente. Se nenhum registro atende aos requisitos especificados, o ltimo registro
acessado pelo componente definido como o registro corrente.
soBeforeEQ: Se um ou mais registros possuem nos campos que formam o indice corrente os
valores definidos na pesquisa, o registro imediatamente anterior ao primeiro registro deste
conjunto definido como o registro corrente. Se nenhum registro atende aos requisitos
especificados, o ltimo registro acessado pelo componente definido como o registro corrente.
soBefore: Se um ou mais registros possuem nos campos que formam o ndice corrente os valores
definidos na pesquisa, o registro imediatamente anterior ao primeiro registro deste conjunto
definido como o registro corrente. Se nenhum registro atende aos requisitos especificados, o
ltimo registro acessado pelo componente definido como o registro corrente.
PRINCIPAIS EVENTOS DA CLASSE TCUSTOMADODATASET
Apresenta-se a seguir uma descrio dos principais eventos da classe TCustomADODataset, alm daqueles
OnEndOfRecordSet
Este evento ocorre quando o ltimo registro acessado pelo componente o registro corrente.
OnFetchComplete
Este evento ocorre quando o componente termina de carregar o conjunto de registros por ele acessado.
OnFetchProgress
Este evento ocorre enquanto o componente carrega o conjunto de registros por ele acessado.
OnFieldChangeComplete
Este evento ocorre aps a alterao do valor armazenado em um campo do registro corrente.
OnMoveComplete
Este evento ocorre aps a alterao de posio do registro definido como registro corrente.
OnRecordChangeComplete
Este evento ocorre aps a alterao dos valores armazenados nos campos de diversos registros acessados
pelo componente.
OnRecordsetChangeComplete
Este evento ocorre aps a alterao do conjunto de registros acessados pelo componente.
OnWillChangeField
Este evento ocorre antes da alterao do valor armazenado em um campo do registro corrente.
OnWillMove
Este evento ocorre antes da alterao de posio do registro definido como registro corrente.
OnWillChangeRecord
Este evento ocorre antes da alterao dos valores armazenados nos campos de diversos registros acessados
pelo componente.
OnWillChangeRecordset
Este evento ocorre antes da alterao do conjunto de registros acessados pelo componente.
A CLASSE TADOCOMMAND
Esta classe derivada diretamente da classe TComponent, e implementada na forma de um
componente (o segundo componente da pgina ADO da paleta de componentes).
A classe TADOCommand permite que se acesse diretamente um banco de dados ADO via declaraes
SQL que no retornem um conjunto de registros a serem editados na aplicao.
PRINCIPAIS PROPRIEDADES DA CLASSE TADOCOMMAND
TADOCommand, alm daquelas herdadas das suas classes ancestrais
CommandObject
Essa propriedade definida como um objeto que acessa diretamente o objeto Activex responsvel pela
conexo.
CommandText
Essa propriedade definida como uma varivel do tipo WideString, e define o comando a ser executado
CommandTimeOut
a execuo de um comando (seno considera-se que o conando no foi executado com sucesso). Seu
CommandType
Essa propriedade definida como uma varivel do tipo TCommandType, e define o tipo de comando
a ser executado.
Esta propriedade pode assumir um dos seguintes valores:
CmdUnknown: O tipo de comando desconhecido.
cmdText: O comando uma definio textual de uma declarao SQL ou chamada de uma
Stored Procedure.
cmdTable: O comando , na realidade, o nome de uma tabela.
cmdStoredProc: O comando , na realidade, o nome de uma stored procedure.
cmdFile: O comando se refere ao nome de um arquivo no qual um conjunto de registros est
armazenado.
cmdTableDirect: O comando , na realidade, o nome de uma tabela, sendo todos os campos
retornados.
As constantes cmdTable, cmdTableDirect, e cmdOpenFile no so usadas com o componente TADOCommand.
Connection
Essa propriedade definida como uma varivel do tipo TADOConnection, e define o tipo de conexo
que ser usada pelo componente.
ConnectionString
ao banco de dados.
ParamCheck
Parameters
Essa propriedade definida como um objeto da classe TParameters, e define os parmetros usados em
uma declarao SQL.
Prepared
Essa propriedade definida como uma varivel booleana, e define se a declarao SQL deve ser preparada
(para otimizao da sua execuo) antes de ser executada.
PRINCIPAIS MTODOS DA CLASSE TADOCOMMAND
Apresenta-se a seguir uma descrio dos principais mtodos da classe TADODataset, alm daqueles
Assign
Declarao
procedure Assign(Source: TPersistent); override;
Esse mtodo copia as propriedades de outro componente TADOCommand para o componente corrente.
Cancel
Declarao
procedure Cancel;
Esse mtodo suspende a execuo do comando definido na propriedade CommandText do componente.
Execute
Declarao
function Execute: _RecordSet; overload;
function Execute(const Parameters: OleVariant): _Recordset; overload;
function Execute(var RecordsAffected: Integer; var Parameters: OleVariant; ExecuteOptions:
TExecuteOptions = []): _RecordSet; overload;
Esse mtodo responsvel pela execuo do comando especificado na propriedade CommandText do
componente. Repare que este mtodo sobrecarregado, podendo ser executado com diferentes conjuntos
de parmetros.
PRINCIPAIS EVENTOS DA CLASSE TADOCOMMAND
Esta classe no possui eventos.
A CLASSE TADODATASET
Esta classe derivada diretamente da classe TCustomADODataset, e implementada na forma de um
componente (o terceiro componente da pgina ADO da paleta de componentes).
A classe TADODataSet, derivada por herana direta da classe TCustomADODataSet, incorpora as
principais caractersticas do mecanismo ADO a alguns dos mtodos declarados na classe TDataSet,
sobrecarregando-os (no caso de mtodos virtuais) ou implementando-os (no caso de mtodos abstratos).
por herana desta classe (TADOTable, TADOQuery e TADOStoredProc).
PRINCIPAIS PROPRIEDADES DA CLASSE TADODATASET
Apresenta-se a seguir uma descrio das principais propriedades implementadas na classe TADODataSet,
alm daquelas herdadas das suas classes ancestrais.
RDSConnection
Permite que a conexo seja feita a um banco de dados remoto, atravs de um componente
TRDSConnection, cujo nome especificado nesta propriedade.
PRINCIPAIS MTODOS DA CLASSE TADODATASET
Apresenta-se a seguir uma descrio dos principais mtodos da classe TADODataset, alm daqueles
CreateDataset
Declarao
function Createdataset;
Esse mtodo responsvel pela obteno dos registros a serem acessados pelo componente, sendo
usado internamente e no devendo ser chamado diretamente pela aplicao.
GetIndexNames
Declarao
Esse mtodo retorna, na lista de strings passada como parmetro na forma de um objeto da classe
TStrings, os nomes dos ndices definidos para a tabela.
PRINCIPAIS EVENTOS DA CLASSE TADODATASET
Esta classe no Implementa novos eventos, utilizando os herdados das suas classes-base.
KNOW-HOW EM: CLASSES DE ACESSO DIRETO A BANCOS DE DADOS
VIA BDE AS CLASSES TADOTABLE E TADOQUERY
PR-REQUISITOS
Compreenso da classes TCustomADODataset, TADODataset e TADOConnection.
METODOLOGIA
Apresentao das classes e dos componentes de acesso direto a bancos de dados via ADO, juntamente com uma descrio das suas
TCNICA
Sero apresentadas neste tpico as classes usadas para acesso direto a bancos de dados via ADO as classes TADOTable e TADOQuery.
A CLASSE TADOTABLE
A classe TADOTable derivada por herana direta da classe TADODataSet, sendo normalmente utilizada
para se estabelecer uma conexo a uma tabela individual do banco de dados.
PRINCIPAIS PROPRIEDADES DA CLASSE TADOTABLE
Apresenta-se a seguir uma descrio das principais propriedades da classe TADOTable, alm daquelas
herdadas das suas classes ancestrais.
IndexFieldNames
IndexName
MasterFields
MasterSource
ReadOnly
TableDirect
Essa propriedade definida como uma varivel booleana, e define se o acesso tabela feito de forma
direta, ou se necessria a criao de uma declarao SQL em background.
TableName
pelo componente.
PRINCIPAIS MTODOS DA CLASSE TADOTABLE
Apresenta-se a seguir uma descrio dos principais mtodos da classe TADOTable, alm daqueles
herdados das suas classes ancestrais:
GetIndexNames
Declarao
PRINCIPAIS EVENTOS DA CLASSE TADOTABLE
A CLASSE TADOQUERY
A classe TADOQuery derivada por herana direta da classe TCustomADODataSet, sendo normalmente
utilizada para se estabelecer uma conexo a uma ou mais tabelas de um banco de dados acessadas via
ADO usando-se declaraes SQL.
PRINCIPAIS PROPRIEDADES DA CLASSE TADOQUERY
Apresenta-se a seguir uma descrio das principais propriedades da classe TADOQuery, alm daquelas
herdadas das suas classes ancestrais:
RowsAffected
Essa propriedade definida como uma varivel inteira e informa a quantidade de registros afetados
pela ltima declarao SQL executada pelo componente.
SQL
do componente.
PRINCIPAIS MTODOS DA CLASSE TADOQUERY
Apresenta-se a seguir uma descrio dos principais mtodos da classe TADOQuery, alm daqueles
herdados das suas classes ancestrais.
ExecSQL
Declarao
procedure ExecSQL;
PRINCIPAIS EVENTOS DA CLASSE TADOQUERY
EXEMPLOS DE APLICAO
ESTABELECENDO UMA CONEXO A BANCOS DE DADOS DO MS ACESS COM O COMPONENTE ADOCONNECTION
Para se conectar a um banco de dados do MS Access com o componente ADOConnection, voc deve
1. Coloque um componente ADOConnection no formulrio ou Datamodule.
2. Selecione os trs pontinhos direita da sua propriedade ConnectionString, para exibir a caixa
de dilogo mostrada na figura a seguir:
Figura 24.1: A caixa de dilogo Connection String.
3. Selecione o boto Build para exibir a caixa de dilogo de Propriedades de vinculao de dados,
mostrada na figura a seguir, e cuja finalidade nos auxiliar na criao da string de conexo.
Figura 24.2: A caixa de dilogo de Propriedades de vinculao de dados.
4. Nesta caixa de dilogo, selecione o item Microsoft Jet 4.0 OLE DB Provider, como indicado na
figura anterior.
5. Selecione o boto Next, para exibir a prxima pgina desta caixa de dilogo. Nesta pgina, voc
deve informar o nome do banco de dados ou localizar o arquivo no qual o mesmo se encontra
armazenado. Neste caso, basta selecionar o boto direita da caixa de texto Insira o nome de um
banco de dados para exibir a caixa de dilogo padro para seleo de arquivos do Windows (neste
caso, para a seleo de arquivos mdb) e escolher o arquivo desejado, cujos nome e path completos
aparecero nesta caixa de texto, conforme mostrado na figura a seguir. Neste caso selecionou-se
C:\Arquivos de programas\Arquivos comuns\Borland Shared\Data\dbdemos.mdb
Figura 24.3: A pgina Conexo da caixa de dilogo de Propriedades de vinculao de dados.
6. Selecione o boto Testar Conexo, para verificar se a execuo foi efetuada corretamente. Em
caso positivo, ser exibida a caixa de dilogo mostrada na figura a seguir.
Figura 24.4: Testando a conexo.
7. Selecione Ok para fechar a caixa de dilogo de Propriedades de vinculao de dados e verificar
a string de conexo na caixa de dilogo String Connection, como mostrado na prxima figura.
Repare que a string de conexo bastante complexa, embora possa ser definida manualmente
bem mais simples utilizar a caixa de dilogo Data Link Properties.
Figura 24.5: A caixa de dilogo Connection String.
8. Selecione Ok para fechar a caixa de dilogo Connection String e defina como True o valor da
propriedade Connected deste componente. Ser exibida a caixa de dilogo Database Login.
Mantenha os valores de UserName e password em branco e selecione o boto Ok para efetuar
a conexo. Se voc definir como False o valor da propriedade LoginPrompt, esta caixa de dilogo
no ser exibida (e neste caso no necessria em outras situaes ser necessrio fornecer
tais valores a partir do procedimento associado ao seu evento OnLogin).
Repare o tamanho da string usada para definir a conexo:
Provider=Microsoft.Jet.OLEDB.4.0;User ID=Admin;Data Source=C:\Arquivos de
programas\Arquivos comuns\Borland Shared\Data\dbdemos.mdb;Mode=Share Deny
None;Extended Properties=;Jet OLEDB:System database=;Jet OLEDB:Registry
Path=;Jet OLEDB:Database Password=;Jet OLEDB:Engine Type=5;Jet OLEDB:Database
Locking Mode=1;Jet OLEDB:Global Partial Bulk Ops=2;Jet OLEDB:Global Bulk
Transactions=1;Jet OLEDB:New Database Password=;Jet OLEDB:Create System
Database=False;Jet OLEDB:Encrypt Database=False;Jet OLEDB:Dont Copy Locale on
Compact=False;Jet OLEDB:Compact Without Replica Repair=False;Jet OLEDB:SFP=False
Embora os componentes ADOCommand, ADODataset, ADOStoredproc, ADOTable e ADOQuery
possam acessar o banco de dados atravs de sua prpria propriedade Connection string,
recomenda-se que o faam atravs deste componente, para evitar o desperdcio de memria e
de tempo na abertura de vrias conexes simultneas.
ACESSANDO TABELAS DO ACCESS COM O COMPONENTE ADOCOMANDO
Para utilizar o componente ADOCommand, voc deve executar os seguintes procedimentos:
1. Coloque-o no mesmo datamodule em que foi colocado o componente ADOConnection (que
chamei nestes exemplos de ADOConnectionTest) e atribua sua propriedade Connection o
nome do componente (que pode ser selecionado a partir da relao de componentes disponveis).
2. Digite o cdigo SQL a ser executado em sua propriedade CommandText.
3. Em um procedimento qualquer (como o de um evento OnClick de um boto de comando),
execute o mtodo Execute deste componente.
Repare que este componente, por no ser derivado da classe TDataset, no pode ter o seu nome
diretamente atribudo propriedade Dataset de um componente Datasource, de forma que os registros
retornados em um comando Select possam ser visualizados diretamente em um dos componentes de
visualizao. Fica claro, portanto, que este componente til quando se quer executar declaraes
SQL sem a necessidade de visualizar os seus resultados.
ACESSANDO TABELAS DO ACCESS COM O COMPONENTE ADODATASET
Para utilizar o componente ADODataset, voc deve executar os seguintes procedimentos:
1. Coloque-o no mesmo Datamodule em que foi colocado o componente ADOConnection (que
2. Digite o cdigo SQL a ser executado em sua propriedade CommandText, como por exemplo:
Select * From Customer
3. Atribua o valor True a sua propriedade Active.
Repare que este componente, por ser derivado da classe TDataset, pode ter o seu nome diretamente
atribudo propriedade Dataset de um componente Datasource, de forma que os registros retornados
em um comando Select possam ser visualizados diretamente em um dos componentes de visualizao.
til quando se quer acessar dados a partir de um banco de dados remoto, pois possui a propriedade
RDSConnection ( qual pode ser atribudo o nome de um componente TRDSConnection) o que no
pode ser feito com os componentes TADOQuery e TADOTable.
Este componente tambm possui um editor de campos (Fields Editor) semelhante ao existente para os
componentes TTable, TQuery e seus equivalentes TADOTable e TADOQuery.
Figura 24.6: Acessando uma tabela com o componente ADODataset.
Como mostrado na figura a seguir, a propriedade CommandText pode ser editada a partir da caixa de dilogo Command Text Editor,
A figura a seguir mostra um formulrio em que os registros obtidos a partir deste componente so
visualizados em um DBGrid.
Figura 24.7: Editando a propriedade CommandText com a caixa de dilogo CommandText Editor.
ACESSANDO TABELAS DO ACCESS COM O COMPONENTE ADOTABLE
Para utilizar o componente ADOTable, voc deve executar os seguintes procedimentos:
1. Coloque-o no mesmo Datamodule em que foi colocado o componente ADOConnection (que
2. Selecione a tabela desejada na propriedade TableName.
No mais, tudo se passa da mesma forma que com o componente Table, com o qual voc j deve estar
acostumado desde as primeiras verses do Delphi.
Repare que para este componente no existe a propriedade DatabaseName em seu lugar temos as propriedades Connection e
ConnectionString, que so mutuamente excludentes.
ACESSANDO TABELAS DO ACCESS COM O COMPONENTE ADOQUERY
Para utilizar o componente ADOQuery, voc deve executar os seguintes procedimentos:
1. Coloque-o no mesmo datamodule em que foi colocado o componente ADOConnection (que
2. Digite o cdigo a ser executado na sua propriedade SQL.
No mais, tudo se passa da mesma forma que com o componente TQuery, com o qual voc j deve estar
acostumado desde as primeiras verses do Delphi
Repare que para este componente tambm no existe a propriedade DatabaseName - em seu lugar temos as propriedades Connection
e ConnectionString, que so umtuamente excludentes.
DIFERENAS NA UTILIZAO DOS COMPONENTES
TABLE X ADOTABLE, E QUERY X ADOQUERY
Quase tudo que feito com os componentes Table e Query pode ser feito pelos componentes ADOTable
e ADOQuery, respectivamente. Nos prximos tpicos, abordaremos apenas algumas caractersticas
no suportadas e que diferenciam a utilizao destes componentes.
DEFINIO DO NDICE CORRENTE
No Delphi, a definio do ndice corrente de uma tabela acessada usando-se um componente Table
pode ser feita da seguinte maneira:
Na fase de projeto: Definindo-se, diretamente no Object Inspector, o valor da propriedade IndexName
do componente Table que representa a tabela (se essa propriedade no for definida, ser utilizada a
chave primria) ou definindo-se, diretamente no Object Inspector, o valor da propriedade
IndexFieldNames do componente Table que representa a tabela.
Conforme j foi descrito anteriormente, as propriedades IndexName e IndexFieldNames so mutuamente excludentes. Atribuir um
valor a uma propriedade anula o valor definido para a outra.
Durante a execuo do aplicativo: Definindo-se via cdigo, mediante uma operao de atribuio, o valor
das propriedades descritas no tpico anterior. No caso da propriedade IndexFieldNames, os nomes dos
campos que formam o ndice devem vir separados por ponto-e-vrgula. No caso do componente ADOTable,
no entanto, voc deve atribuir o valor False sua propriedade Active amates de alterar o ndice corrente.
PESQUISANDO REGISTROS EM TABELAS
REPRESENTADAS PELO COMPONENTE ADOTABLE
Diferentemente do componente Table, o componente ADOTable no possui os mtodos FindKey e
FindNearest, mas apenas o mtodo Locate, que permite a busca exata ou aproximada de um registro,
por campos que no faam parte do ndice corrente da tabela.
CRIAO DE TABELAS EM RUN-TIME
O componente TADOTable no possui um mtodo semelhante ao mtodo CreateTable do componente
Table, que permita a criao de tabelas em run-time.
COMPONENTES E MTODOS DE NAVEGAO
Os mesmos mtodos de navegao so suportados pelos dois conjuntos de componentes BDE e ADO.
UTILIZAO DE PARMETROS EM DECLARAES SQL
No caso do componente ADOQuery, o parmetro no diretamente reconhecido a partir da declarao
SQL. Neste caso, voc dever completar as informaes do parmetro no Object Inspector, como indicado
na figura a seguir.
Figura 24.8: Definindo o parmetro da declarao SQL.
Considere, neste exemplo, a seguinte declarao SQL (usada no exemplo do componente TQuery):
Select * From Country Where Continent =:Nome
A redefinio do parmetro e atualizao da query feita no procedimento associado ao evento
OnChange do comboBox. Neste caso, no entanto, o cdigo de definio do parmetro dever ser
alterado, como mostrado a seguir:
begin
ADOQuery1.Close;
ADOQuery1.Parameters.ParamValues[Nome] := ComboBox1.Items[ComboBox1.ItemIndex];
ADOQuery1.Open;
end;
Repare que o componente ADOQuery no possui o mtodo ParambyName ao invs disso deve ser
usada a propriedade Parameters que, por sua vez, possui uma array de parmetros chamada ParamValues,
na qual os parmetros podem ser acessados pelo seu nome.
Alm disso, deve ser notada a inexistncia do mtodo Prepare, e que o componente no pode ter o
valor da sua propriedade Active como True enquanto no for definido um valor para o parmetro. Isto
pode ser feito no procedimento associado ao evento OnCreate do formulrio ou no prprio Object
Inspector, como mostrado na figura a seguir.
Figura 24.9: Definindo um valor para o parmetro da declarao SQL.
CAPTULO 25 BANCO DE DADOS COMPONENTES DE ACESSO VIA DBEXPRESS
Captulo
de Acesso via DBExpress
25
BORLAND DELPHI 7 KYLIX CURSO COMPLETO PARTE II: KNOW-HOW
Neste captulo sero discutidos em maiores detalhes os componentes responsveis pelo acesso a dados via
DBExpress, alguns j apresentados na primeira parte do livro, a partir de uma aplicao desenvolvida com o
Delphi 7. Conforme j foi descrito anteriormente, o DBExpress foi especialmente desenvolvido pela Borland
para permitir o desenvolvimento de aplicaes multiplataforma capazes de ser compiladas para o ambiente
Windows (com o Delphi) e Linux (com o Kylix) em aplicaes desenvolvidas com base na CLX.
KNOW-HOW EM: COMPONENTES DE ACESSO
A BANCOS DE DADOS VIA DBEXPRESS
PR-REQUISITOS
METODOLOGIA
Apresentao dos componentes de acesso a bancos de dados via DBExpress, juntamente com uma descrio das suas propriedades, mtodos
e eventos.
TCNICA
Descrio dos componentes de acesso a bancos de dados via DBExpress.
Este mecanismo foi bastante empregado na primeira parte do livro, e sua principal caracterstica reside
no fato de ser um mecanismo unidirecional de acesso a dados, o que significa que voc no pode
navegar diretamente pelos registros acessados atravs de seus componentes, como ocorria com os
componentes de acesso via BDE e ADO. Uma alternativa, neste caso, consiste em utilizar o componente
ClientDataset em conjunto com um DatasetProvider e o componente de acesso ou, como j descrito
anteriormente, o componente SimpleDataset, que rene as funcionalidades de diversos componentes.
O COMPONENTE TSQLCONNECTION
conexo a um banco de dados via DBExpress. Este componente tem uma funcionalidade semelhante
ao TDatabase no mecanismo Borland Database Engine e ao ADOConnection do ADO, e permite que
diversos componentes de acesso estejam diretamente conectados a ele.
PRINCIPAIS PROPRIEDADES DA CLASSE TSQLCONNECTION
TADOConnection, alm daquelas herdadas das suas classes-base:
DriverName
Essa propriedade definida como uma varivel do tipo string, e define o driver para o tipo de banco de
dados que ser acessado. Por enquanto, esto disponveis drivers para INTERBASE, MYSQL, ORACLE,
MSSQL, INFORMIX e DB2.
ConnectionName
Essa propriedade definida como uma varivel do tipo string, e define o nome da conexo representada
pelo componente. similar propriedade DatabaseName do componente Database do BDE.
Connected
Essa propriedade definida como uma varivel booleana, e define se uma conexo foi ou no estabelecida
pelo componente.
LoginPrompt
Essa propriedade definida como uma varivel booleana, e define se uma caixa de dilogo de Login
deve ou no ser exibida ao se tentar estabelecer uma conexo atravs deste componente.
KeepConnection
Essa propriedade definida como uma varivel booleana, e define se a conexo deve continuar
permanentemente ativa, mesmo que no se esteja efetuando nenhum acesso aos dados.
Name
ser referenciado no cdigo da aplicao.
A maioria destas propriedades pode ser configurada usando-se a caixa de dilogo DBExpress Connection, mostrada na figura a seguir.
Esta caixa de dilogo exibida dando-se um duplo clique sobre o componente ou selecionando-se o item Connection Editor do seu menu
pop-up, e tambm pode ser usada para armazenar os valores default do username e password.
Figura 25.1: A caixa de dilogo DBExpress Connections.
Algumas destas propriedades podem ser configuradas usando-se a caixa de dilogo Value List Editor, exibida atravs da seleo da
propriedade Params.
PRINCIPAIS MTODOS DA CLASSE TSQLCONNECTION
Apresenta-se a seguir uma descrio dos principais mtodos da classe TSQLConnection, alm daquelas
CloseAllDataSets
Declarao
procedure CloseDataSets;
Esse mtodo desativa todos os objetos derivados da classe TDataset a ele conctados, sem no entanto
Commit
Declarao
procedure Commit;
Esse mtodo realiza um commit sobre a transao corrente.
Execute
Declarao
function Execute(const SQL: string; Params: TParams
; ResultSet:Pointer=nil): Integer;
Esse mtodo executa um comando SQL sobre o servidor de banco de dados. Repare que este mtodo
sobrecarregado, possuindo duas implementaes distintas.
O comando a ser executado passado na forma de uma string, alm de outros parmetros que indicam
como os registros devem ser afetados.
GetProcedureNames
Declarao
Esse mtodo armazena na lista de strings passada como parmetro os nomes de todos os procedimentos
armazenados existentes no banco de dados ao qual o componente est conectado.
GetTableNames
Declarao
procedure GetTableNames(List: TStrings; SystemTables: Boolean = False);
Esse mtodo armazena na lista de strings passada como parmetro os nomes de todas as tabelas existentes
no banco de dados ao qual o componente est conectado.
Open
Declarao
procedure Open;
Esse mtodo ativa uma conexo ao banco de dados ao qual o componente est conectado.
Rollback
Declarao
procedure Rollback(TransDesc: TTransactionDesc);
Esse mtodo realiza um rollback sobre a transao corrente.
PRINCIPAIS EVENTOS DA CLASSE TSQLCONNECTION
Apresenta-se a seguir uma descrio dos principais eventos da classe TSQLConnection, alm daquelas
AfterConnect
Este evento ocorre logo aps uma conexo ser estabelecida pelo componente.
AfterDisConnect
Este evento ocorre logo aps uma conexo ser finalizada pelo componente.
BeforeConnect
Este evento ocorre imediatamente antes de uma conexo ser estabelecida pelo componente.
BeforeDisConnect
Este evento ocorre imediatamente antes de uma conexo ser finalizada pelo componente.
OnLogin
Este evento ocorre imediatamente aps o evento BeforeConnect, e permite que se definam valores
para o username e o password de acesso ao banco de dados.
A CLASSE TCUSTOMSQLDATASET
a tabelas, sem incorporar as funes de qualquer API.
A classe TCustomSQLDataSet, derivada por herana direta da classe TDataSet, incorpora aa principais
caractersticas do mecanismo DBExpress a alguns dos mtodos declarados na classe TDataSet,
PRINCIPAIS PROPRIEDADES DA CLASSE TCUSTOMSQLDATASET
SQLConnection
Essa propriedade definida como uma varivel do tipo TSQLConnection, e define o nome do
componente SQLConnection atravs do qual ser feita a conexo ao servidor do banco de dados.
CommandType
Essa propriedade definida como uma varivel do tipo TSQLCommandType, e define se o acesso ser
feito diretamente a uma tabela (se seu valor for ctTable), via declarao SQL (se seu valor for ctQuery)
ou a um procedimento armazenado (se seu valor for igual a ctStoredProc).
CommandText
Essa propriedade definida como uma varivel do tipo string, e seu valor vai depender do valor
previamente atribudo propriedade CommandType.
Se CommandType for igual a ctTable, esta propriedade dever armazenar o nome de uma tabela.
Se CommandType for igual a ctQuery, esta propriedade dever armazenar um comando SQL.
Se CommandType for igual a ctStoredProc, esta propriedade dever armazenar o nome de um
procedimento armazenado.
PRINCIPAIS EVENTOS DA CLASSE TCUSTOMSQLDATASET
Este componente no implementa nenhum mtodo, possuindo apenas os herdados de sua classe-base.
A CLASSE TSQLDATASET
Esta classe derivada diretamente da classe TCustomSQLDataset, e implementada na forma de um
componente.
A classe TSQLDataSet permite que se acesse diretamente uma tabela de um banco de dados, um conjunto
de tabelas via declaraes SQL ou um procedimento armazenado, dependendo do valor atribudo a sua
propriedade CommandType.
PRINCIPAIS PROPRIEDADES DA CLASSE TSQLDATASET
Apresenta-se a seguir uma descrio das principais propriedades implementadas na classe TSQLDataSet,
Active
Esta propriedade definida como uma varivel booleana que define se a conexo representada pelo
componente est ou no ativa.
SQLConnection
CommandType
CommandText
KNOW-HOW EM: CLASSES DE ACESSO DIRETO A BANCOS DE
DADOS VIA DBEXPRESS AS CLASSES TSQLTABLE,
TSQLQUERY E TSQLSTOREDPROC
PR-REQUISITOS
Fundamentos da programao orientada a objetos com o Delphi 6 e o Kylix.
Compreenso das classes TCustomSQLDataset, TSQLDataset e TSQLConnection.
METODOLOGIA
Apresentao das classes e dos componentes de acesso direto a bancos de dados via DBExpress, juntamente com uma descrio das suas
TCNICA
Sero apresentadas neste tpico as classes usadas para acesso direto a bancos de dados via DBExpress
as classes TSQLTable, TSQLQuery e TSQLStoredProc.
A CLASSE TSQLTABLE
A classe TSQLTable derivada por herana direta da classe TSQLDataSet, sendo normalmente utilizada
para se estabelecer uma conexo a uma tabela individual do banco de dados. Trata-se de uma
especializao da classe TSQLDataSet com CommandType igual a ctTable.
PRINCIPAIS PROPRIEDADES DA CLASSE TSQLTABLE
Apresenta-se a seguir uma descrio das principais propriedades da classe TSQLTable, alm daquelas
Active
IndexFieldNames
IndexName
MasterFields
MasterSource
DataSource ao qual est associado o componente da classe TSQLTable que representa a tabela principal
em um relacionamento entre tabelas. Essa propriedade deve ser definida apenas no componente que
TableName
pelo componente.
PRINCIPAIS MTODOS DA CLASSE TSQLTABLE
Apresenta-se a seguir uma descrio dos principais mtodos da classe TSQLTable, alm daqueles herdados
GetIndexNames
Declarao
PRINCIPAIS EVENTOS DA CLASSE TSQLTABLE
A CLASSE TSQLQUERY
A classe TSQLQuery derivada por herana direta da classe TSQLDataSet, sendo normalmente utilizada para
se estabelecer uma conexo a uma ou mais tabelas de um banco de dados acessadas via DBExpress usando-se
declaraes SQL. Trata-se de uma especializao da classe TSQLDataSet com CommandType igual a ctQuery.
PRINCIPAIS PROPRIEDADES DA CLASSE TSQLQUERY
Apresenta-se a seguir uma descrio das principais propriedades da classe TSQLQuery, alm daquelas
herdadas das suas classes ancestrais:
Active
SQL
do componente.
PRINCIPAIS MTODOS DA CLASSE TSQLQUERY
Apresenta-se a seguir uma descrio dos principais mtodos da classe TSQLQuery, alm daquelas herdadas
ExecSQL
Declarao
function ExecSQL(ExecDirect: Boolean = False): Integer; override;
PRINCIPAIS EVENTOS DA CLASSE TSQLQUERY
A CLASSE TSIMPLEDATASET
Conforme descrito anteriormente, os componentes que acessam bancos de dados via DBExpress s
permitem acesso unidirecional ao banco de dados. Conseqentemente, para contornar este problema
seria necessrio utilizar, em conjunto com cada um daqieles componentes, um componente
DatasetProvider e um componente ClientDataset, responsvel por editar localmente os registros, e
permitir o seu acesso de forma bidirecional. Evidentemente, neste caso, as alteraes seriam aplicadas
ao banco de dados mediante uma chamada ao mtodo ApplyUpdates do componente ClientDataset.
Este componente pode ser considerado como uma reunio de trs componentes: Um SQLDataSet, um
DatasetProvider e um ClientDataset. Conforme visto na primeira parte do livro, este componente
simplifica bastante o desenvolvimento de aplicaes que acessam bancos de dados via DBExpress.
PRINCIPAIS PROPRIEDADES DA CLASSE TSIMPLEDATASET
Apresenta-se a seguir uma descrio das principais propriedades da classe TSimpleDataset, alm daquelas
herdadas das suas classes ancestrais. Devido a sua importncia, sero reapresentadas algumas das
propriedades j definidas em seus componentes ancestrais.
Active
DBConnection
CommandType
CommandText
IndexFieldNames
IndexName
MasterFields
MasterSource
DataSource ao qual est associado o componente da classe TSimpleDataset que representa a tabela
principal em um relacionamento entre tabelas. Essa propriedade deve ser definida apenas no
componente que representa a tabela secundria no relacionamento.
PRINCIPAIS MTODOS DA CLASSE TSIMPLEDATASET
Esta classe possui todos os mtodos da classe TClientDataset, permitindo o acesso bidirecional e edio
dos registros em memria.
PRINCIPAIS EVENTOS DA CLASSE TSIMPLEDATASET
Esta classe possui todos os eventos da classe TClientDataset, acrescentando, no entanto, o evento
apresentado a seguir.
OnReconcileError
Este evento ocorre sempre que surge um erro na atualizao de um registro (numa chamada ao mtodo
ApplyUpdates) que no tenha sido tratado pelo evento OnUpdateError.
CAPTULO 26 BANCO DE DADOS COMPONENTES DE ACESSO VIA INTERBASE EXPRESS
Captulo
de Acesso via Interbase Express
26
Neste captulo sero apresentados os componentes responsveis pelo acesso a dados via Interbase
Express, um mecanismo multiplataforma formado por um conjunto de componentes para acesso nativo
ao banco de dados Interbase a partir de uma aplicao desenvolvida com o Delphi 7.
KNOW-HOW EM: COMPONENTES DE ACESSO A
BANCOS DE DADOS VIA INTERBASE EXPRESS
PR-REQUISITOS
METODOLOGIA
Apresentao dos componentes de acesso a bancos de dados via Interbase Express, juntamente com uma descrio das suas propriedades,
mtodos e eventos.
TCNICA
Descrio dos componentes de acesso a bancos de dados via Interbase Express.
Este mecanismo apresenta como principal vantagem o fato de ser um mecanismo de acesso bidirecional,
nativo e multiplataforma a bancos de dados do Interbase. Exige, no entanto, o emprego do conceito de
transaes, que se aplica a aplicaes cliente-servidor, apresentadas em maiores detalhes no prximo
captulo.
Estes componentes esto disponveis na paleta Interbase da paleta de componentes, tanto para aplicaes
baseadas na VCL como na CLX.
O COMPONENTE TIBDATABASE
conexo a um banco de dados via Interbase Express. Este componente tem uma funcionalidade
semelhante ao TDatabase no mecanismo Borland Database Engine, ao TADOConnection do ADO, e
ao TSQLConnection do DBExpress, e permite que diversos componentes de acesso estejam diretamente
conectados a ele.
PRINCIPAIS PROPRIEDADES DA CLASSE TIBDATABASE
Apresenta-se a seguir uma descrio das principais propriedades implementadas na classe TIBDatabase,
alm daquelas herdadas das suas classes-base:
AllowStreamedConnection
Essa propriedade definida como uma varivel booleana, e define se uma conexo ao banco de dados
deve ser estabelecida a partir do IDE do Delphi, quando a propriedade Connected deste componente
for definida como True no Object Inspector.
Connected
Essa propriedade definida como uma varivel booleana, e define se uma conexo foi ou no estabelecida
pelo componente.
DatabaseName
Essa propriedade definida como uma varivel do tipo string, e define o nome do banco de dados que
ser acessado.
DefaultTransaction
Essa propriedade definida como um objeto da classe TIBTransaction, e define o componente da
classe TIBTransaction que representar a transao default para o acesso ao banco de dados.
LoginPrompt
Essa propriedade definida como uma varivel booleana, e define se uma caixa de dilogo de Login
deve ou no ser exibida ao se tentar estabelecer uma conexo atravs deste componente.
Name
ser referenciado no cdigo da aplicao.
Params
Essa propriedade definida como uma varivel do tipo TStrings, e define um conjunto de parmetros
para a conexo que ser estabelecida. Como exemplo, podem-se citar as propriedades Username e
Password, apresentadas a seguir, que podem ser definidas na caixa de dilogo String List Editor associada
a esta propriedade, ao se estabelecer uma conexo quando a propriedade Login Prompt igual a False.
Password
Essa propriedade definida como uma varivel do tipo string, e define a senha de um usurio que
tenta estabelecer a conexo ao banco de dados.
UserName
Essa propriedade definida como uma varivel do tipo string, e define o nome de um usurio que
tenta estabelecer a conexo ao banco de dados.
A maioria destas propriedades pode ser configurada usando-se a caixa de dilogo Database Editor, exibida dando-se um duplo clique
sobre o componente ou selecionando-se o item correspondente do seu menu pop-up.
SQLDialect
Essa propriedade definida como uma varivel do tipo inteiro, e define o dialeto SQL a ser usado pelas
aplicaes cliente que acessaro o banco de dados.
PRINCIPAIS MTODOS DA CLASSE TIBDATABASE
Apresenta-se a seguir uma descrio dos principais mtodos da classe TIBDatabase, alm daquelas
ApplyUpdates
Declarao
procedure ApplyUpdates(const DataSets: array of TDataSet);
Esse mtodo aplica atualizaes pendentes em objetos derivados da classe TDataset passados como
parmetros, na forma de uma array de objetos da classe TDataset. Desativa todos os objetos derivados
da classe TDataset a ele conectados, sem no entanto finalizar a sua prpria conexo ao banco de dados.
CloseDataSets
Declarao
Esse mtodo desativa todos os objetos derivados da classe TDataset a ele conectados, sem no entanto
DropDatabase
Declarao
procedure DropDatabase;
Esse mtodo remove o arquivo associado ao banco de dados, e deve ser usado com muita cautela.
GetTableNames
Declarao
procedure GetTableNames(const DatabaseName, Pattern: string; Extensions, SystemTables:
Boolean; List: TStrings);
Esse mtodo recebe como parmetros:
Um objeto da classe TStrings no qual sero armazenados os nomes das tabelas.
Uma outra constante booleana que define se os nomes das tabelas de sistema que definem a
estrutura das tabelas do banco de dados tambm devem ser obtidos.
TestConnected
Declarao
procedure TestConnected: Boolean;
Este mtodo verifica se a conexo ao banco de dados est ativa.
PRINCIPAIS EVENTOS DA CLASSE TIBDATABASE
Apresenta-se a seguir uma descrio dos principais eventos da classe TIBDatabase, alm daqueles
AfterConnect
Este evento ocorre logo aps uma conexo ser estabelecida pelo componente.
AfterDisConnect
Este evento ocorre logo aps uma conexo ser finalizada pelo componente.
BeforeConnect
Este evento ocorre imediatamente antes de uma conexo ser estabelecida pelo componente.
BeforeDisConnect
Este evento ocorre imediatamente antes de uma conexo ser finalizada pelo componente.
OnLogin
Este evento ocorre imediatamente aps o evento BeforeConnect, e permite que se definam valores
para o username e o password de acesso ao banco de dados.
O COMPONENTE TIBTRANSACTION
Este componente, derivado por herana da classe TComponent, permite que se represente uma transao
individual a um banco de dados representado por um componente TIBDatabase. Um componente
TIBDatabase ter uma transao default, mas vrias transaes podem estar definidas, cada uma definida
por um componente Transaction. Os componentes de acesso estaro vinculados a um componente
desta classe a partir da sua propriedade Transaction.
O conceito de transaes ser apresentado no prximo captulo, que trata de aplicaes cliente-servidor.
PRINCIPAIS PROPRIEDADES DA CLASSE TIBTRANSACTION
Apresenta-se a seguir uma descrio das principais propriedades implementadas na classe TIBTransaction,
alm daquelas herdadas das suas classes-base:
Active
Esta propriedade definida como uma varivel booleana que define se a transao representada pelo
DatabaseCount
Essa propriedade definida como uma varivel inteira, que define o nmero de bancos de dados
vinculados a essa transao.
Databases
Essa propriedade definida como uma array de objetos da classe TIBDatabase, e permite acessar
diretamente cada um dos componentes que representam os bancos de dados vinculados a essa transao.
DefaultDatabase
Essa propriedade definida como um objeto da classe TIBDatabase, e permite acessar diretamente o
componente que representa o banco de dados default vinculado a essa transao.
InTransaction
Esta propriedade definida como uma varivel booleana que define se a transao representada pelo
componente est sendo executada (est em progresso).
PRINCIPAIS MTODOS DA CLASSE TIBTRANSACTION
Apresenta-se a seguir uma descrio dos principais mtodos da classe TIBTransaction, alm daqueles
AddDatabase
Declarao
function AddDatabase(db: TIBDatabase): Integer;
Esse mtodo adiciona um banco de dados, cujo componente TIBDatabase que o representa passado
como parmetro, transao representada pelo componente.
CheckDatabasesInList
Declarao
procedure CheckDatabasesInList;
Esse mtodo verifica se existem bancos de dados associados transao representada pelo componente,
gerando uma exceo caso no haja nenhum.
Commit
Declarao
procedure Commit;
StartTransaction e finaliza a execuo da transao. Esse mtodo s pode ser executado se uma transao
estiver sendo processada, o que pode ser constatado verificando-se o valor da propriedade InTransaction.
Aps uma chamada ao mtodo Commit, a propriedade InTransaction assume o valor False.
CommitRetaining
Declarao
procedure CommitRetaining;
StartTransaction sem no entanto finalizar a execuo da transao. Esse mtodo s pode ser executado
se uma transao estiver sendo processada, o que pode ser constatado verificando-se o valor da
propriedade InTransaction. Aps uma chamada ao mtodo Commit, a propriedade InTransaction as-
sume o valor False.
FindDatabase
Declarao
function FindDatabase(db: TIBDatabase): Integer;
Esse mtodo retorna o ndice de um banco de dados, cujo componente TIBDatabase que o representa
passado como parmetro, no que se refere transao representada pelo componente.
FindDatabase
Declarao
function FindDefaultDatabase: TIBDatabase;
Esse mtodo retorna o componente TIBDatabase que representa o banco de dados default associado
transao.
RemoveDatabase
Declarao
procedure RemoveDatabase(Idx: Integer);
Esse mtodo remove o banco de dados associado transao, cujo ndice passado como parmetro.
RemoveDatabases
Declarao
procedure RemoveDatabases;
Esse mtodo remove todos os bancos de dados associados transao.
RollBack
Declarao
procedure RollBack;
Esse mtodo cancela todos os comandos iniciados aps a ltima chamada ao mtodo StartTransaction
e finaliza a execuo da transao representada pelo componente. Esse mtodo s pode ser executado
se uma transao estiver sendo processada, o que pode ser constatado verificando-se o valor da
propriedade InTransaction. Aps uma chamada ao mtodo RollBack, a propriedade InTransaction as-
sume o valor False.
RollBackRetaining
Declarao
procedure RollBackRetaining;
Esse mtodo cancela todos os comandos iniciados aps a ltima chamada ao mtodo StartTransaction
sem no entanto finalizar a execuo da transao representada pelo componente.
StartTransaction
Declarao
Esse mtodo inicia uma nova transao, e s pode ser executado se no houver uma transao sendo
processada, isto , aps uma chamada ao mtodo Commit ou RollBack. Aps uma chamada ao mtodo
StartTransaction, a propriedade InTransaction assume o valor True.
PRINCIPAIS EVENTOS DA CLASSE TIBTRANSACTION
Apresenta-se a seguir uma descrio dos principais eventos da classe TIBDatabase, alm daqueles
OnIdleTimer
Este evento ocorre quando a transao representada pelo componente fica em espera.
A CLASSE TIBCUSTOMDATASET
a tabelas, sem incorporar as funes de qualquer API.
A classe TIBCustomDataset, derivada por herana direta da classe TDataSet, incorpora as principais
caractersticas do mecanismo Interbase Express a alguns dos mtodos declarados na classe TDataSet,
PRINCIPAIS PROPRIEDADES DA CLASSE TIBCUSTOMDATASET
Apresenta-se a seguir uma descrio das principais propriedades implementadas na classe TDataSet,
alm daquelas presentes em suas classes ancestrais.
Database
Essa propriedade definida como uma varivel do tipo TIBDatabase, e define o nome do componente
Database atravs do qual ser feita a conexo ao servidor do banco de dados.
Active
Database
Essa propriedade definida como uma varivel do tipo TIBDatabase, e define o nome do componente
IBDatabase atravs do qual ser feita a conexo ao servidor do banco de dados.
DeleteSQL
Essa propriedade definida como um objeto da classe TStrings, e define o cdigo SQL a ser executado
para a excluso de registros do banco de dados associado atravs do componente.
InsertSQL
para a incluso de registros do banco de dados associado atravs do componente.
ModifySQL
para a atualizao de registros do banco de dados associado atravs do componente.
RecNo
Essa propriedade definida como uma varivel do tipo inteiro, e define o nmero do registro corrente
dentre aqueles acessados pelo componente.
RecordCount
Essa propriedade definida como uma varivel do tipo inteiro, e retorna o nmero de registros acessados
pelo componente.
RefreshSQL
para a atualizao da visualizao dos registros do banco de dados associado atravs do componente.
SelectSQL
para a consulta a registros do banco de dados associado atravs do componente.
Transaction
Essa propriedade definida como um objeto da classe TIBTransaction, e define o componente desta
classe ao qual o componente de acesso est vinculado.
PRINCIPAIS MTODOS DA CLASSE TIBCUSTOMDATASET
Apresenta-se a seguir uma descrio dos principais mtodos da classe TIBCustomDataset, alm daqueles
ApplyUpdates
Declarao
Esse mtodo armazena no banco de dados as alteraes feitas localmente no componente. Essas
alteraes, no entanto, s so efetivadas aps uma chamada ao mtodo Commit do componente
TIBTransaction que representa uma transao do banco de dados.
CancelUpdates
Declarao
Esse mtodo cancela as alteraes feitas localmente para um componente.
Locate
Declarao
function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean;
Esse mtodo permite a busca de um registro por campos que no faam parte do ndice corrente da
tabela. Recebe como parmetros:
ponto-e-vrgula).
Uma array do tipo Variant contendo os valores a serem pesquisados nos campos pelos quais
ser feita a pesquisa (separados por ponto-e-vrgula).
Um conjunto de opes, que pode conter os seguintes elementos:
LoCaseInsensitive: Se esse elemento for includo, letras maisculas e minsculas sero tratadas
indiferentemente.
LoPartialKey: A pesquisa ser aproximada.
Post
Declarao
Procedure Post;
Esse mtodo efetiva a gravao das alteraes no registro corrente acessado pelo componente.
PRINCIPAIS EVENTOS DA CLASSE TIBCUSTOMDATASET
Esta classe implementa os seguintes eventos, alm daqueles herdados de sua classe-base:
AfterDatabaseDisconnect
Este evento ocorre logo que a conexo ao servidor do banco de dados encerrada.
AfterTransactionEnd
Este evento ocorre logo que a transao vinculada ao componente finalizada.
BeforeDatabaseDisconnect
Este evento ocorre imediatamente antes que a conexo ao servidor do banco de dados seja encerrada.
BeforeTransactionEnd
Este evento ocorre imediatamente antes que a transao vinculada ao componente seja finalizada.
OnUpdateError
Este evento ocorre quando uma exceo gerada ao se tentar gravar as alteraes pendentes em um
componente de acesso.
OnUpdateRecord
Este evento ocorre logo ao se atualizar um registro acessado pelo componente.
A CLASSE TIBDATASET
Esta classe derivada diretamente da classe TIBCustomDataset, e implementada na forma de um
componente.
A classe TIBDataSet permite que se execute diretamente uma declarao SQL em um banco de dados
do Interbase.
PRINCIPAIS PROPRIEDADES DA CLASSE TIBDATASET
Apresenta-se a seguir uma descrio das principais propriedades implementadas na classe TIBDataSet,
Filtered
Essa propriedade definida como uma varivel booleana, e define se est ou no sendo aplicado um
filtro ao conjunto de registros representados pelo componente.
Prepared
Essa propriedade definida como uma varivel booleana, e define se o conjunto de registros
representados pelo componente est ou no preparado para a execuo de uma consulta parametrizada.
PRINCIPAIS MTODOS DA CLASSE TIBDATASET
Apresenta-se a seguir uma descrio dos principais mtodos da classe TIBDataset, alm daqueles herdados
das suas classes-base.
ExecSQL
Declarao
procedure ExecSQL;
Este mtodo executa o comando SQL definido no componente, desde que no corresponda a uma
consulta.
ParamByName
Declarao
function ParamByName(Idx : String) : TIBXSQLVAR;
Este mtodo permite retornar ou definir o valor de um parmetro em uma consulta parametrizada,
sendo o seu nome passado como parmetro na forma de uma string.
Prepare
Declarao
procedure Prepare;
Este mtodo prepara o componente para a execuo de uma consulta parametrizada pelo componente.
UnPrepare
Declarao
PRINCIPAIS EVENTOS DA CLASSE TIBDATASET
Esta classe no implementa novos eventos, alm daqueles herdados das suas classes-base.
KNOW-HOW EM: CLASSES DE ACESSO DIRETO A
BANCOS DE DADOS VIA INTERBASE EXPRESS AS
CLASSES TIBTABLE, TIBQUERY E TIBUPDATESQL
PR-REQUISITOS
Compreenso da classes TIBCustomDataset, TIBDataset e TIBDatabase.
METODOLOGIA
Apresentao das classes e dos componentes de acesso direto a bancos de dados via Interbase Express, juntamente com uma descrio das
suas propriedades, mtodos e eventos.
TCNICA
Sero apresentadas neste tpico as classes usadas para acesso direto a bancos de dados via Interbase Express as classes TIBTable,
TIBQuery e TIBUpdateSQL.
A CLASSE TIBTABLE
A classe TIBTable derivada por herana direta da classe TIBCustomDataSet, sendo normalmente
utilizada para se estabelecer uma conexo a uma tabela individual do banco de dados.
PRINCIPAIS PROPRIEDADES DA CLASSE TIBTABLE
Apresenta-se a seguir uma descrio das principais propriedades da classe TIBTable, alm daquelas
Active
CanModify
Essa propriedade definida como uma varivel booleana e define se a tabela pode ser acessada para
edio, insero e remoo de registros.
Exclusive
Essa propriedade definida como uma varivel booleana e define se a tabela ser acessada em modo
exclusivo pela aplicao. Se seu valor for igual a True, nenhuma outra aplicao poder acessar a
tabela, enquanto a mesma estiver sendo acessada pela aplicao corrente.
IndexDefs
Essa propriedade um objeto da classe TindexDefs e define os ndices da tabela.
IndexFieldCount
Essa propriedade definida como uma varivel inteira e define o nmero de campos que compem o
ndice corrente.
IndexFieldNames
IndexFields
Essa propriedade definida como uma array de objetos da classe TField correspondentes aos campos
que compem o ndice corrente.
IndexName
MasterFields
MasterSource
ReadOnly
TableName
pelo componente.
PRINCIPAIS MTODOS DA CLASSE TIBTABLE
Apresenta-se a seguir uma descrio dos principais mtodos da classe TIBTable, alm daqueles herdados
AddIndex
Declarao
Esse mtodo adiciona um ndice tabela, recebendo como parmetros:
Uma string com o nome do ndice a ser criado.
Uma string com os nomes dos campos que formam o novo ndice (separados por ponto-e-vrgula).
Uma varivel do tipo TIndexOptions, que representa um conjunto que pode incluir os seguintes
elementos:
ixPrimary: Se o novo ndice for definido como a chave primria da tabela (no se aplica a
tabelas no formato dBASE).
ixUnique: Se o novo ndice no admitir duplicidade de valores.
ixDescending: Se os registros forem ordenados alfabeticamente de forma decrescente.
ixCaseInsensitive: Se no houver diferenciao entre letras maisculas e minsculas na
indexao dos campos (no se aplica a tabelas no formato dBASE).
ixExpression: O ndice ser baseado numa expresso (aplica-se apenas a tabelas no formato dBASE).
CreateTable
Declarao
Esse mtodo permite a criao de uma tabela em run-time (no confundir com a criao do componente).
Entretanto, antes de se executar uma chamada ao mtodo CreateTable, devem-se definir os valores das
seguintes propriedades do componente:
DataBase: Define o nome do componente TIBDatabase que representa o banco de dados que
ser acessado.
TableName: Define o nome da tabela a ser criada.
TableType: Define o tipo da tabela que ser criada.
FieldDefs: Define os campos da tabela. Conforme ser visto posteriormente, esse objeto tem
alguns mtodos importantes, como:
Clear: Remove todas as definies de campos da tabela.
Add: Adiciona um novo campo tabela.
IndexDefs: Objeto da classe TindexDefs que define os ndices da tabela. Essa classe tem alguns
mtodos importantes, como:
Add: Adiciona um novo ndice tabela.
DeleteIndex
Declarao
DeleteTable
Declarao
Esse mtodo remove do banco de dados a tabela representada pelo componente, e deve ser empregado
com o mximo de cautela.
Antes de se executar esse mtodo, deve-se atribuir o valor False propriedade Active do componente
que representa a tabela (o que tambm pode ser feito por uma chamada ao seu mtodo Close).
EmptyTable
Declarao
Esse mtodo remove todos os registros da tabela representada pelo componente.
GetIndexNames
Declarao
GotoCurrent
Declarao
Esse mtodo sincroniza o registro corrente dentre os registros manipulados pelo componente que
representa a tabela com o registro corrente de outro componente TTable, cujo nome passado como
parmetro, e que acessa a mesma tabela.
PRINCIPAIS EVENTOS DA CLASSE TIBTABLE
A CLASSE TIBQUERY
A classe TIBQuery derivada por herana direta da classe TIBCustomDataSet, sendo normalmente
utilizada para se estabelecer uma conexo a uma ou mais tabelas de um banco de dados, acessadas via
Interbase Express usando-se declaraes SQL.
PRINCIPAIS PROPRIEDADES DA CLASSE TIBQUERY
Apresenta-se a seguir uma descrio das principais propriedades da classe TIBQuery, alm daquelas
Active
Params
Essa propriedade definida como uma array de objetos da classe TParams, que representam
individualmente os parmetros definidos para a Query.
Prepared
Essa propriedade definida como uma varivel booleana, e define se a Query foi preparada para ser
executada, de modo a melhorar o seu desempenho.
A preparao de uma Query pode ser feita atribuindo-se o valor True a essa propriedade, ou mediante
uma chamada ao seu mtodo Prepare.
RequestLive
consulta podem ser editados localmente pelo usurio.
RowsAffected
Essa propriedade definida como uma varivel inteira, e define o nmero de linhas ou registros
atualizados ou removidos pela execuo da ltima declarao SQL.
SQL
do componente.
PRINCIPAIS MTODOS DA CLASSE TIBQUERY
Apresenta-se a seguir uma descrio dos principais mtodos da classe TSQLQuery, alm daqueles
herdados das suas classes ancestrais.
ExecSQL
Declarao
Procedure ExecSQL;
ParamByName
Declarao
function ParamByName(Idx : String) : TIBXSQLVAR;
Este mtodo permite retornar ou definir o valor de um parmetro em uma consulta parametrizada,
sendo o seu nome passado como parmetro na forma de uma string.
Prepare
Declarao
procedure Prepare;
UnPrepare
Declarao
PRINCIPAIS EVENTOS DA CLASSE TIBQUERY
A CLASSE TIBUPDATESQL
A classe TIBUpdateSQL derivada por herana direta da classe TIBDataSetUpdateObject (sendo esta
derivada diretamente da classe TComponent), e permite que se definam instrues de insero (IN-
SERT), deleo (DELETE) e atualizao (UPDATE) em registros retornados atravs de uma consulta
SQL, mesmo que esta tenha sido definida como uma consulta apenas de leitura (isto , a propriedade
RequestLive do componente Query igual a False ou os registros foram transformados em registros
apenas de leitura durante a execuo do cdigo), desde que a propriedade CachedUpdates do
componente Query responsvel pela execuo da declarao SQL tenha sido definida como True.
com o fato de os registros terem sido gerados apenas para leitura pelo componente IBQuery.
PRINCIPAIS PROPRIEDADES DA CLASSE TIBUPDATESQL
Apresenta-se a seguir uma descrio das principais propriedades da classe TIBUpdateSQL.
DeleteSQL
para a excluso de registros do banco de dados associado atravs do componente.
InsertSQL
para a incluso de registros do banco de dados associado atravs do componente.
ModifySQL
para a atualizao de registros do banco de dados associado atravs do componente.
RefreshSQL
para a atualizao da visualizao dos registros do banco de dados associado atravs do componente.
PRINCIPAIS MTODOS DA CLASSE TIBUPDATESQL
Apresenta-se a seguir uma descrio dos principais mtodos da classe TUpdateSQL.
ExecSQL
Declarao
procedure ExecSQL(UpdateKind: TUpdateKind);
Esse mtodo executa uma das instrues definidas pelas trs propriedades descritas no tpico anterior.
Esse mtodo, ao contrrio do mtodo de mesmo nome do objeto Query, recebe como parmetro uma
constante que indica o cdigo a ser executado. A tabela a seguir apresenta essas constantes e seus significados:
O mecanismo de acesso Interbase Express oferece tambm o componente IBSQL, da classe TIBSQL, que uma verso unidirecional, e
conseqentemente mais eficiente para a realizao de consultas.
CAPTULO 27 BANCOS DE DADOS CLIENTE/SERVIDOR
Captulo
Bancos de Dados Cliente/Servidor
27
Neste captulo sero apresentados os conceitos fundamentais e indispensveis utilizao de bancos
de dados na filosofia cliente-servidor, utilizando-se como banco de dados o Interbase, desenvolvido e
comercializado pela Borland.
KNOW-HOW EM: FUNDAMENTOS DOS
BANCOS DE DADOS CLIENTE/SERVIDOR
PR-REQUISITOS
Utilizao dos componentes de acesso e visualizao de bancos de dados do Delphi 7.
METODOLOGIA
Apresentao do problema: Diviso de tarefas entre uma aplicao cliente e o servidor de bancos de dados.
TCNICA
Apresentao dos procedimentos necessrios criao de um banco de dados no Interbase, definio de triggers e stored procedures.
O desenvolvimento de uma aplicao de acesso a banco de dados em ambiente cliente/servidor consiste
fundamentalmente em subdividir o trabalho de pesquisa e manuteno de um banco de dados entre a
aplicao cliente e o servidor de bancos de dados.
Essa subdiviso de tarefas, no entanto, no deve se limitar apenas a delegar ao servidor a responsabilidade
pelo armazenamento de informaes. Este deve ser responsvel, tambm, por executar algumas rotinas
predefinidas, de modo a limitar os dados a serem enviados ao cliente, reduzindo-se o trfego de
informaes na rede.
Conforme ser mostrado nos prximos tpicos, o servidor executa essas tarefas mediante a utilizao
de triggers e stored procedures.
Nos exemplos a serem apresentados, ser utilizado o banco de dados Interbase, tambm desenvolvido
pela Borland e que acompanha o Borland Delphi.
O ADMINISTRADOR DO SERVIDOR DE BANCO DE DADOS
Em um servidor de bancos de dados como o Interbase, cada usurio possui um nome ou identificao
(username) e uma senha (password) que devem ser informados sempre que o mesmo quer se conectar
ao servidor. Conforme ser visto posteriormente, cada usurio possui permisso para realizar um
determinado conjunto de aes sobre um banco de dados, e a esse conjunto de aes que podem ser
realizadas denomina-se privilgios do usurio.
O Interbase possui um usurio privilegiado, que o administrador do banco de dados. Esse administrador
inicialmente configurado com o username SYSDBA e a senha masterkey e, ao acessar o Interbase
pela primeira vez aps a sua instalao, esses parmetros devero ser utilizados.
O administrador do banco de dados pode, entre outras coisas:
Cadastrar novos usurios.
Remover usurios cadastrados.
Alterar as configuraes de usurios j cadastrados.
O administrador de um servidor de bancos de dados Interbase realiza essas tarefas atravs do IBConsole,
um utilitrio situado no grupo de programas do Interbase e cuja janela principal mostrada na
figura a seguir.
Figura 27.1: O Interbase Server Manager.
Para se conectar ao servidor, o administrador do servidor de bancos de dados deve executar os seguintes
procedimentos:
1. Executar o utilitrio IBConsole.
2. Selecionar o cone do servidor de banco de dados a ser conectado e o item Login do menu
Server ou dar um duplo clique sobre o cone selecionado. Ser exibida a caixa de dilogo Server
Login, na qual o administrador dever fornecer seu username e sua senha (que inicialmente
possuem os valores default descritos anteriormente).
3. Selecionar o boto OK para iniciar a conexo ao servidor. O IBConsole ficar com o aspecto
apresentado na figura a seguir.
Figura 27.2: A janela do IBConsole, aps a conexo inicial.
Para se desconectar do servidor, basta selecionar o servidor de banco de dados e o item Logout do
menu Server Manager. Ser exibida uma caixa de dilogo na qual ser solicitada uma confirmao em
relao desconexo.
N prximo tpico, sero apresentados os procedimentos necessrios ao cadastramento de um novo usurio.
CADASTRANDO UM NOVO USURIO
Aps se conectar ao servidor, o administrador pode cadastrar novos usurios, e para isso basta que
sejam executados os seguintes procedimentos (aps a conexo):
1. Selecionar o cone correspondente ao servidor e o item User Security do menu Server. Ser
exibida a caixa de dilogo Interbase security, mostrada na figura a seguir.
Figura 27.3: A caixa de dilogo User Information.
2. Selecionar o boto New, clicando sobre o mesmo com o boto esquerdo do mouse. Os
valores correntes dos campos da caixa de dilogo User Information sero apagados, para
que sejam fornecidos os dados do novo usurio, como mostrado na figura a seguir, na qual
devem ser fornecidos seu username, sua senha e a confirmao da senha. Opcionalmente,
poder ser fornecido o nome do usurio.
Figura 27.4: A caixa de dilogo User Information.
ALTERANDO OS DADOS DE UM USURIO J CADASTRADO
Para alterar os dados de um usurio j cadastrado, voc deve acessar o IBConsole Manager e executar os
exibida a caixa de dilogo Interbase security, mostrada anteriormente.
2. Selecionar o usurio na relao User name, alterar os dados correspondentes e o boto Apply
dessa caixa de dilogo, clicando sobre o mesmo com o boto esquerdo do mouse.
REMOVENDO UM USURIO CADASTRADO
Para remover um usurio j cadastrado, voc deve acessar o IBConsole e executar os seguintes
procedimentos:
exibida a caixa de dilogo Interbase security, mostrada anteriormente.
2. Selecionar o usurio na relao User name e o boto Delete dessa caixa de dilogo, clicando
sobre o mesmo com o boto esquerdo do mouse.
3. Selecionar o boto Ok na caixa de dilogo de confirmao que ser exibida.
O UTILITRIO INTERACTIVE SQL
Voc pode interagir com o servidor empregando o utilitrio Interactive SQL.
O utilitrio Interactive SQL apresenta a janela principal apresentada na figura a seguir e permite uma
interao direta com o Interbase.
Voc pode acessar o utilitrio Interactive SQL selecionando o item Interactive SQL no menu Tools do IBConsole.
Figura 27.5: A janela principal do utilitrio Interactive SQL.
Essa janela composta por duas reas distintas:
Uma rea superior (que em verses anteriores era identificada por SQL Statement): nessa rea
que devem ser digitadas as declaraes SQL que sero utilizadas para a criao de tabelas,
insero, remoo e alterao de registros, etc.
Uma rea inferior (que em verses anteriores era identificada por SQL Output): nessa rea
que sero visualizados os resultados de um comando SQL e sero lidas as mensagens emitidas
pelo banco de dados, inclusive mensagens de erro.
CRIANDO UM BANCO DE DADOS NO INTERBASE A PARTIR DO UTILITRIO INTERACTIVE SQL
Para criar um novo banco de dados a partir do utilitrio Interactive SQL, voc deve executar os seguintes
procedimentos:
1. Selecionar o item Create Database do menu Database. Ser exibida a caixa de dilogo Create
Database, mostrada na figura a seguir.
Figura 27.6: A caixa de dilogo Create Database.
2. Digitar, nessa caixa de dilogo, o nome do banco de dados a ser criado (voc deve fornecer o
path completo e o nome do arquivo com a extenso gdb), como mostrado na figura anterior.
Nesta caixa de dilogo, defina como 1 o valor da propriedade SQL Dialect.
Para se desconectar do banco de dados, voc deve executar os seguintes procedimentos:
1. Selecionar o item Disconnect do menu Database. Ser exibida uma caixa de dilogo (mostrada
na figura a seguir) para que voc confirme a ao.
Figura 27.7: Confirmando uma desconexo a um banco de dados do Interbase.
CONECTANDO-SE A UM BANCO DE DADOS DO INTERBASE
Para se conectar a um banco de dados do Interbase, a partir do utilitrio Interactive SQL, voc deve
1. Selecionar o item Connect As do menu Database. Ser exibida a caixa de dilogo Database
Connect, mostrada na figura a seguir.
Figura 27.8: A caixa de dilogo Database Connect.
2. Nessa caixa de dilogo, preenchar adequadamente as caixas de texto Username e Password.
3. Selecionar o boto OK, para fechar essa caixa de dilogo e se conectar ao banco de dados.
TIPOS DE DADOS DEFINIDOS PELO INTERBASE
Os campos de uma tabela do Interbase podem ser de um dos seguintes tipos:
Tipo Significado Tamanho
BLOB Objeto binrio Varivel
CHAR(n) Armazena at n caracteres n caracteres (mximo 32767)
DATE Data/hora
DECIMAL(p,d)(p = preciso, d = nmero de casas decimais)
NUMERIC(p,d)(p = preciso, d = nmero de casas decimais)
DOUBLE Real de preciso dupla
FLOAT Real de preciso simples
INTEGER Inteiros entre -2,147,483,648 e 2,147,483,648
SMALLINT Inteiros entre -32768 e 32767
VARCHAR(n) Armazena at n caracteres.
Repare que alguns tipos so bastante semelhantes.
CRIANDO UMA TABELA NO INTERBASE
Existem duas formas de se criar uma tabela no Interbase a partir do ambiente Windows:
Usando o utilitrio Interactive SQL.
Usando o Database Desktop.
Para criar uma tabela do Interbase atravs do utilitrio Interactive SQL, voc deve executar os seguintes
procedimentos:
1. Conectar-se ao banco de dados, executando os procedimentos descritos nos tpicos anteriores.
2. Digitar um cdigo SQL com a seguinte sintaxe:
CREATE TABLE nome da tabela (campo1 tipo1[NOT NULL], campon tipon[NOT NULL],
Na realidade, a sintaxe global desse comando muito mais complexa, mas vamos nos concentrar
numa sintaxe mais simples, de forma a no dificultar a sua compreenso. O parmetro opcional NOT
NULL, se fornecido, indica que esse campo deve ser obrigatrio.
Para criar uma tabela chamada Empregados no banco de dados Exemplo.gdb, voc deve digitar a
seguinte declarao na rea superior da janela do utilitrio Interactive SQL:
CREATE TABLE Empregados (Codigo SMALLINT NOT NULL PRIMARY KEY, Nome VARCHAR(40) NOT NULL,
Funcao VARCHAR(15) NOT NULL, Salario DECIMAL(15,2))
Figura 27.9: Criando uma Tabela no Interbase.
Essa tabela ter a seguinte estrutura:
3. Selecionar o boto Execute Query (o terceiro boto da bara de ferramentas do utilitrio Interac-
tive SQL).
APLICANDO RESTRIES AOS CAMPOS DE UMA TABELA
Durante a criao de uma tabela, os seguintes tipos de restries podem ser aplicados aos seus campos:
NULL/NOT NULL: Define se o campo pode ou no ter o valor nulo em algum registro da
tabela.
DEFAULT valor_default: Define um valor default para o campo. Pode ser NULL e, nesse caso, o
campo ser criado com um valor nulo.
UNIQUE: Define que dois registros distintos no podem ter o mesmo valor armazenado nesse campo.
CHECK (condio): Permite que voc defina uma condio a ser satisfeita para o valor a ser
inserido no campo. Se essa condio no for satisfeita, o valor ser rejeitado.
PRIMARY KEY: Especifica que o campo que est sendo criado ser uma chave primria da tabela.
FOREIGN KEY REFERENCES nome_outra_tabela (campo_de_outra_tabela): Essa restrio in-
dica que o campo que est sendo criado uma chave primria de outra tabela.
Por exemplo, para garantir que todos os funcionrios recebero mais do que R$ 120,00, a declarao
SQL que cria a tabela poderia ser redefinida como:
CREATE TABLE Empregados (Codigo SMALLINT NOT NULL PRIMARY KEY, Nome VARCHAR(40) NOT NULL,
Funcao VARCHAR(15) NOT NULL, Salario DECIMAL(15,2) CHECK (SALARIO > 120))
REMOVENDO UMA TABELA DO BANCO DE DADOS
Para remover uma tabela de um banco de dados, voc deve executar os seguintes procedimentos:
1. Conectar-se ao banco de dados cuja tabela se quer excluir.
2. Executar a seguinte declarao SQL:
DROP TABLE nome_da_tabela
CRIANDO NDICES EM UMA TABELA
O SQL padro no define o suporte a ndices, mas alguns servidores o suportam, entre os quais o Interbase.
Nome do Campo Tipo NOT NULL Chave Primria
Codigo SMALLINT Sim Sim
Nome VARCHAR(40) Sim No
Funcao VARCHAR(15) Sim No
Salario DECIMAL(15,2) No No
Os ndices do origem a listas ordenadas que permitem uma navegao mais rpida pelos registros de
uma tabela, em uma ordenao distinta daquela especificada pelo campo que define a sua chave primria.
A criao de ndices no Interbase feita executando-se uma declarao SQL que apresenta a seguinte sintaxe:
CREATE [UNIQUE] [ASC|DESC] INDEX nome_do_indice ON nome_da_tabela (coluna_1,coluna_n)
Para criar um ndice chamado IndSalario pelo campo Salrio da tabela Empregados, por exemplo,
pode-se utilizar a seguinte declarao SQL:
CREATE INDEX IndSalario ON Empregados (Salario)
Para remover um ndice, deve-se executar uma declarao SQL com a seguinte sintaxe:
DROP INDEX nome_do_ndice
CONCEDENDO PRIVILGIOS A UM OUTRO USURIO OU BANCO DE DADOS
Suponha que o administrador do servidor de banco de dados tenha criado o banco de dados
Exemplo.gdb descrito nos tpicos anteriores, e cadastrado um usurio com username GUESS e uma
outra senha qualquer.
Nesse caso, se o usurio GUESS tentar se conectar ao banco de dados Exemplo.gdb, ser exibida uma
mensagem de erro, pois esse banco de dados no foi criado por ele, e no lhe foi dada qualquer
autorizao para utiliz-lo.
Quem cria um banco de dados, no entanto, pode conceder esses privilgios a outros usurios (ou a outro
banco de dados), conectando-se ao banco de dados e executando um cdigo SQL com a seguinte sintaxe:
GRANT privilgio ON [Tabela|Procedure] To [Usurio|Banco de dados]
A palavra privilgio deve ser substituda por uma das palavras listadas a seguir:
Select: Permite uma consulta tabela (ou View).
Delete: Permite excluir registros da tabela (ou View).
Insert: Permite inserir registros na tabela (ou View).
Update: Permite alterar valores armazenados nos campos dos registros de uma tabela (ou View).
EXECUTE: Permite a execuo de uma stored procedure. Esse privilgio s se aplica no caso de
se utilizar a palavra Procedure na clusula ON.
ALL: Concede todos os privilgios descritos anteriormente.
Voc pode usar a palavra Public para conceder um privilgio a todos os usurios.
Para conceder ao usurio GUESS todos os privilgios de acesso tabela Empregados, do banco de dados
Exemplo.gdb, o administrador deve empregar o seguinte cdigo, aps se conectar ao banco de dados:
GRANT ALL On Empregados To GUESS
No se esquea de selecionar o boto Execute Query para executar essa declarao SQL a partir do
utilitrio Interactive SQL.
REMOVENDO PRIVILGIOS
Para remover um privilgio concedido a um usurio, voc deve executar uma declarao SQL com a
seguinte sintaxe:
REVOKE privilgio ON [Tabela|Procedure] FROM [Usurio|Banco de dados]
VISES (VIEWS)
Ao acessar um banco de dados usando declaraes SQL, muitas vezes executamos repetidas vezes uma
instruo SELECT para obter um determinado conjunto de registros que atendem a determinadas
condies.
A maioria dos servidores de bancos de dados permite que se crie uma representao alternativa para
um conjunto de registros de uma tabela que atendem a determinadas condies, conjunto este
denominado View (Viso) e que pode ser tratado como uma tabela independente.
O cdigo de uma declarao SQL utilizado para a criao de uma View apresenta a seguinte sintaxe:
CREATE VIEW nome_view (Lista de Colunas)
AS(Cdigo SQL que define a VIEW).
A fim de exemplificar a criao de uma View, vamos acessar o banco de dados Employee.gdb, que
acompanha o Delphi, executando os procedimentos descritos nos tpicos anteriores. Lembre-se
que antes de usar este banco de dados voc deve registr-lo, usando o item Register do menu
Database do IBConsole.
Esse banco de dados tem uma tabela chamada Employee, que armazena os dados dos empregados de
uma empresa.
Para criar uma viso dessa tabela chamada Nomes, que retorna apenas o primeiro e o ltimo nomes de
cada empregado, deve-se executar a seguinte declarao SQL:
CREATE VIEW NOMES (EMP_NO,FIRST_NAME,LAST_NAME) AS
Select * From Employee
Voc poder ento executar uma consulta SQL sobre a View, como se esta fosse uma tabela independente.
A figura a seguir mostra a execuo de uma declarao SQL (SELECT * FROM NOMES) sobre a View
recm-criada.
importante salientar que a View apenas uma representao de um conjunto de registros armazenados
em uma tabela. Os registros so fisicamente armazenados na tabela, e no na View.
Figura 27.10: Resultado da execuo de uma declarao SQL sobre a View.
A remoo de uma View feita executando-se uma declarao SQL com a seguinte sintaxe:
DROP VIEW nome_da_view
O CONCEITO DE TRANSAES
Define-se como transao um conjunto de comandos, na forma de declaraes SQL, que devem ser
executados antes que as alteraes decorrentes desse conjunto de instrues sejam realizadas de forma
definitiva no banco de dados.
Uma transao confirmada mediante a execuo do comando COMMIT e cancelada por uma execuo
do comando ROLLBACK.
A partir do momento em que voc inicia uma conexo a um banco de dados, as alteraes realizadas
(incluso, remoo e atualizao de registros) s sero gravadas de forma efetiva aps uma execuo do
comando COMMIT. Se voc executar um ROLLBACK antes de um COMMIT, todas as alteraes realizadas
desde a execuo de ltimo COMMIT sero canceladas.
INCLUINDO REGISTROS COM O COMANDO INSERT
Para incluir registros em uma tabela de um banco de dados, voc deve executar uma declarao SQL
com a seguinte sintaxe:
INSERT INTO nome_tabela (nome_campo_1,,nome_campo_n)
VALUES (valor_campo_1,,valor_campo_n)
O cdigo a seguir insere um registro na tabela Empregados, criada anteriormente:
INSERT INTO Empregados (Codigo,Nome,Funcao,Salario) VALUES (101,Marcelo
Leo,Professor,2000.00)
Neste exemplo foi usado o dialeto 3 da linguagem SQL.
Executando os procedimentos descritos anteriormente, inclua os seguintes registros na tabela
Empregados, do banco de dados Exemplo.gdb:
ATUALIZANDO REGISTROS EM UMA TABELA
Para atualizar registros em uma tabela de um banco de dados, voc deve executar uma declarao SQL
UPDATE nome_tabela SET nome_campo_1=Valor_1,,nome_campo_n=Valor_n
WHERE (Condio)
Por exemplo, para atualizar os salrios de maneira que todos os empregados recebam, no mnimo, R$
1.400,00, pode-se executar uma declarao SQL como a apresentada a seguir.
UPDATE Empregados SET Salario = 1400.00 Where (Salario < 1400)
Se voc est executando esses procedimentos no seu computador, execute um COMMIT para gravar as alteraes feitas at o momento.
REMOVENDO REGISTROS DE UMA TABELA
Para remover registros de uma tabela de um banco de dados, voc deve executar uma declarao SQL
DELETE FROM nome_tabela WHERE (Condio)
Por exemplo, para remover os empregados com salrio superior a R$ 2000,00, voc deve executar a
seguinte declarao SQL:
DELETE FROM Empregados WHERE (Salario > 2000.00)
Cdigo Nome Funo Salrio
101 Marcelo Leo Professor 2000.00
102 Jos Vieira Diretor 2500.00
103 Maria Emilia Secretria 1200.00
104 Rosane Santos Bibliotecria 1800.00
Teste esse comando, visualize os registros da tabela com uma instruo SELECT e execute um ROLL-
BACK para recuperar esse registro.
ORDENANDO OS REGISTROS DE UMA TABELA
Para relacionar os registros de uma tabela ordenados por um determinado campo (ou por um grupo de
campos), voc deve executar uma declarao SELECT com uma clusula ORDER BY, que apresenta a
seguinte sintaxe:
SELECT (Lista de Colunas) FROM nome_da_tabela WHERE (Condio) ORDER BY nome_coluna_1
[ASC|DESC],, nome_coluna_n [ASC|DESC]
Nesse cdigo, ASC e DESC significam ordem Ascendente (Crescente) e Descendente (Decrescente),
respectivamente, onde a primeira opo a opo default.
Por exemplo, para ordenar os empregados em ordem crescente de salrio, basta executar a seguinte
declarao SQL:
Select * From Empregados ORDER BY Salario
TRIGGERS
As triggers so um conjunto de funes definidas em um banco de dados e que podem ser executadas
em decorrncia de instrues SQL que envolvem a incluso de novos dados (INSERT), atualizao
(UPDATE) ou remoo de dados j existentes (DELETE).
Pode-se ento fazer uma analogia entre as triggers e os procedimentos associados a eventos do Delphi
e dizer que as triggers so procedimentos associados a eventos do banco de dados, e esses eventos
podem ser de seis tipos distintos:
BEFORE INSERT
AFTER INSERT
BEFORE UPDATE
AFTER UPDATE
BEFORE DELETE
AFTER DELETE
A princpio, pode-se definir mais de uma trigger para cada evento no Interbase, razo pela qual cada
trigger receber um nmero (entre 0 e 32767) que a identificar unicamente entre as demais triggers
associadas a um mesmo evento. Esse nmero definir a ordem em que as triggers sero executadas, e
ser definida pela clusula POSITION na declarao SQL usada para criar a TRIGGER.
recomendvel que as triggers no sejam numeradas seqencialmente, mas em incrementos que
possibilitem a insero de outras triggers.
O cdigo utilizado para a criao de uma trigger no Interbase apresenta a seguinte sintaxe:
SET TERM ^ ;
CREATE TRIGGER nome_trigger FOR nome_tabela evento POSITION nmero AS
BEGIN
// Cdigo da Trigger
END ^
onde a palavra evento dever ser substituda por um dos seis eventos descritos anteriormente.
Por exemplo, para evitar que um funcionrio seja cadastrado com um salrio superior a R$ 5000,00,
voc pode criar as seguintes triggers para a tabela Empregados, do banco de dados Exemplo.gdb:
SET TERM ^ ;
CREATE TRIGGER MAXSALARIO FOR Empregados AFTER INSERT POSITION 5 AS
BEGIN
UPDATE Empregados SET Salario = 5000.00 WHERE (Salario > 5000.00);
END ^
CREATE TRIGGER LIMITASALARIO FOR Empregados AFTER UPDATE POSITION 5 AS
BEGIN
UPDATE Empregados SET Salario = 5000.00 WHERE (Salario > 5000.00);
END ^
Se voc tentar inserir um funcionrio com salrio superior a R$ 5000,00 ver que esse limite ser
respeitado, isto , o valor 5000,00 ser armazenado no campo Salario.
A remoo de uma trigger feita em uma instruo SQL com a seguinte sintaxe:
DROP TRIGGER nome_trigger
Para alterar a definio de uma TRIGGER, voc deve executar uma instruo SQL com a seguinte sintaxe:
SET TERM ^ ;
ALTER TRIGGER nome_trigger evento POSITION nmero AS
BEGIN
// Cdigo da Trigger
END ^
A instruo SET TERM define o smbolo usado para a terminao da TRIGGER, que deve ser diferente do ponto-e-vrgula, usado na
linguagem de codificao do Interbase. O mesmo ser vlido para stored procedures.
STORED PROCEDURES (PROCEDIMENTOS ARMAZENADOS)
As stored procedures (tambm conhecidas como procedimentos armazenados) so funes
armazenadas no banco de dados, e que podem ser executadas a partir de uma instruo SQL (EX-
ECUTE PROCEDURE), de outra stored procedure, de uma trigger ou de uma aplicao-cliente
desenvolvida em Delphi.
O cdigo utilizado para criar uma stored procedure no Interbase apresenta a seguinte sintaxe:
SET TERM ^ ;
CREATE PROCEDURE nome_procedure (Lista de Parmetros de Entrada)
RETURNS (Lista de Parmetros de Sada) AS
BEGIN
// Cdigo da Stored Procedure
END ^
As listas de parmetros de entrada e de sada devem especificar os nomes dos parmetros e seus tipos.
A remoo de uma stored procedure feita em uma instruo SQL com a seguinte sintaxe:
DROP PROCEDURE nome_stored_procedure
A stored procedure apresentada a seguir permite que se multiplique por um fator o salrio de todos os
empregados.
SET TERM ^ ;
CREATE PROCEDURE AUMENTO (Fator Float) AS
BEGIN
UPDATE Empregados SET Salario = Salario * :Fator;
END ^
Repare que, no cdigo da stored procedure, o parmetro fator precedido por dois-pontos (:).
Para executar uma stored procedure, pode-se utilizar a seguinte declarao SQL:
EXECUTE PROCEDURE nome_stored_procedure(parmetros de entrada)
RETURNING_VALUES (Lista de parmetros de sada)
Por exemplo, para aumentar em 10% o salrio de todos os empregados cujos dados esto armazenados
nos registros da tabela Empregados, basta que se execute a seguinte declarao SQL:
EXECUTE PROCEDURE AUMENTO(1.10)
Para alterar a definio de uma Stored Procedure, voc deve executar uma instruo SQL com a
seguinte sintaxe:
SET TERM ^ ;
ALTER PROCEDURE nome_procedure (Lista de Parmetros de Entrada)
RETURNS (Lista de Parmetros de Sada) AS
BEGIN
// Cdigo da Stored Procedure
END ^
LINGUAGEM DE CODIFICAO DO INTERBASE
O Interbase tem uma linguagem de codificao prpria, que pode ser usada na definio de triggers e
stored procedures mais complexas.
DECLARAO DE VARIVEIS NO INTERBASE
A declarao de variveis internas a uma trigger ou stored procedure deve ser feita antes da palavra reservada
BEGIN (que define o incio do corpo principal da trigger ou stored procedure) e apresenta a seguinte sintaxe:
DECLARE VARIABLE nome_varivel tipo_varivel;
Deve-se utilizar uma instruo DECLARE VARIABLE para cada varivel a ser declarada.
ATRIBUIO DE VALORES A VARIVEIS NO INTERBASE
A atribuio de um valor a uma varivel interna de uma stored procedure feita em uma linha de
cdigo que apresenta a seguinte sintaxe:
Nome_varivel = valor;
DEFINIO DE COMENTRIOS NO INTERBASE
As triggers e stored procedures definidas no Interbase podem conter comentrios semelhantes aos
utilizados na linguagem C, como mostra a linha de cdigo a seguir.
/* Isto um Comentrio */
ESTRUTURAS CONDICIONAIS DO INTERBASE
O Interbase tem uma estrutura condicional cuja sintaxe apresentada a seguir.
If (condio)
Then
// Comandos executados se a condio for verdadeira;
Else
// Comandos executados se a condio for falsa;
Diferentemente do que ocorre no Pascal, no Interbase deve-se colocar um ponto-e-vrgula antes da
clusula Else de uma estrutura condicional.
A procedure AUMENTO, por exemplo, poderia ser reescrita da seguinte maneira:
CREATE PROCEDURE AUMENTO (Fator Float) AS
BEGIN
If (:Fator > 1.0) Then
UPDATE Empregados SET Salario = Salario * :Fator;
END
ESTRUTURAS DE REPETIO DO INTERBASE
O Interbase apresenta as estruturas de repetio FOR SELECTDO SUSPEND e WHILEDO.
As estruturas de repetio FOR SELECTDO SUSPEND apresentam a seguinte sintaxe:
FOR
SELECT (restante da declarao Select)
INTO (Lista de parmetros)
DO SUSPEND;
Para a tabela Empregados, do banco de dados Exemplo.gdb, pode-se criar a seguinte procedure, que
retorna o nome e o salrio de cada empregado:
CREATE PROCEDURE DADOS
RETURNS (NOME VARCHAR(40), SALARIO DECIMAL(15,2)) AS
BEGIN
FOR
SELECT Nome,Salario From Empregados
INTO:Nome, :Salario
DO SUSPEND;
END
Nas estruturas de condio e de repetio descritas anteriormente, podem-se utilizar blocos de comando BEGINEND, como no Object Pascal.
CRIAO DE NOVOS TIPOS NO INTERBASE
A linguagem SQL permite que voc crie um tipo de dado (chamado Domnio) baseado em um tipo j definido.
A criao de um domnio feita mediante a execuo de uma declarao SQL que apresenta a
seguinte sintaxe:
CREATE DOMAIN nome_do_domnio AS tipo_de_dado DEFAULT valor_default
A especificao de um valor default para um domnio opcional.
Consideremos novamente a tabela Empregados, em que o campo Salario foi definido como DECI-
MAL(15,2).
Nesse caso, se utilizarmos muitas tabelas com esse tipo de campo, podemos criar um domnio chamado
Salario, mediante a execuo de uma instruo SQL como a apresentada a seguir.
CREATE DOMAIN SALARIO AS DECIMAL(15,2)
A partir da, SALARIO poderia ser tratado como um tipo da linguagem, e poderamos criar variveis
desse novo tipo.
Para remover um domnio, voc deve executar uma instruo SQL com a seguinte sintaxe:
DROP DOMAIN nome_do_domnio
Voc s pode remover um domnio se ele no estiver sendo usado como definio de campos em uma das tabelas definidas no banco de dados.
Para alterar a definio de um domnio, deve-se executar uma instruo SQL com a seguinte sintaxe:
ALTER DOMAIN nome_domnio AS Tipo_Prdefinido
METADADOS DE UM BANCO DE DADOS
Quando um banco de dados criado no Interbase, ele armazena dois tipos de informaes: o primeiro
tipo, denominado Metadados, diz respeito s definies das tabelas, ndices, triggers, stored proce-
dures e outros itens que definem a estrutura do banco de dados; o segundo tipo se refere aos dados
realmente armazenados nos registros das tabelas que compem o banco de dados.
Para visualizar os metadados de um banco de dados do Interbase, voc deve executar os seguintes
procedimentos:
1. Conectar-se ao banco de dados, dando um duplo clique sobre o mesmo no IBConsole.
2. Selecionar o item View Metadata do menu Database do IBConsole.
Os metadados do banco de dados sero exibidos na janela Database Metadata.
Para visualizar os metadados de uma nica tabela, voc deve executar os seguintes procedimentos:
1. Conectar-se ao banco de dados, dando um duplo clique sobre o mesmo no IBConsole.
2. Selecione o item Tables entre as opes disponveis para o banco de dados a partir do IBConsole.
As tabelas do banco de dados sero exibidas no painel direito do IBConsole.
3. D um duplo clique sobre a tabela desejada, no painel direito do IBConsole.
4. Selecione a guia Metadata na janela que ser exibida, e a partir da qual voc poder selecionar
outras tabelas cujos metadados desejar visualizar.
Voc tambm pode visualizar os metadados de uma View, desde que existam Views definidas no banco de dados.
CONCATENANDO DADOS PROVENIENTES DE VRIAS TABELAS
Voc pode utilizar instrues SELECT complexas, que retornem dados provenientes de vrias tabelas e
que atendam a determinadas condies.
Por exemplo, para concatenar os registros das tabelas Employee e Depart, do banco de dados
Employee.gdb, reunidas pelo campo que define o cdigo do departamento em cada tabela, pode-se
usar uma declarao SQL como a exemplificada a seguir.
SELECT * FROM employee, department where (employee.dept_no = department.dept_no)
Ao executar essa declarao SQL, os campos dos registros da tabela Employee precedem os campos da
tabela Department.
Se a declarao SQL for definida como a exemplificada a seguir, a ordem de exibio dos campos ser
invertida.
SELECT * FROM department,employee where (employee.dept_no = department.dept_no)
Para restringir os campos a serem exibidos, o nome de cada campo deve ser exibido na declarao,
como exemplificado a seguir.
SELECT employee.First_Name,employee.Last_Name,Department.Department FROM employee,department
where (employee.dept_no = department.dept_no)
Nesse caso, apenas os campos selecionados sero exibidos.
Caso o nmero de campos a serem exibidos seja muito grande, o fato de ter de preceder o nome do
campo pelo nome da tabela pode ser uma tarefa bastante ingrata. Nesse caso, pode-se usar um nome
alternativo para a tabela (que deve ser definido na prpria declarao SELECT), como mostra o exemplo
de instruo SQL mostrado a seguir:
SELECT e.First_Name,e.Last_Name,d.Department FROM employee e,department d where (e.dept_no =
d.dept_no)
Nesse caso, e se refere tabela employee e d se refere tabela department.
CRIANDO UM BACKUP DE UM BANCO DE DADOS DO INTERBASE
Para fazer um backup de um banco de dados criado no Interbase, voc deve executar os seguintes
procedimentos:
2. Conectar-se ao servidor de banco de dados, executando os procedimentos descritos nos tpicos
anteriores.
3. Selecionar o banco de dados desejado e, no menu Database do IBConsole, selecionar o item
Maintenance -> Backup/Restore -> Backup. Ser exibida a caixa de dilogo Database Backup,
na qual deve ser selecionado o nome do banco de dados do qual se deseja fazer o backup e o
nome do arquivo no qual o backup ser feito.
4. Selecionar o boto OK, para fechar essa caixa de dilogo e realizar o backup.
Ser exibido um relatrio do backup, e uma caixa de dilogo informando a sua concluso.
RECUPERANDO UM BANCO DE DADOS A PARTIR DE UM BACKUP
Para recuperar um backup de uma base de dados, voc deve executar os seguintes procedimentos:
2. Conectar-se ao servidor de banco de dados, executando os procedimentos descritos nos tpicos
anteriores.
3. Selecionar o banco de dados desejado e, no menu Database do IBConsole, selecionar o item
Maintenance -> Backup/Restore -> Restore. Ser exibida a caixa de dilogo Database Restore,
na qual deve ser selecionado o nome do arquivo a partir do qual ser feita a restaurao do
banco de dados, e o arquvo de destino (que representa o banco de dados que ser restaurado).
4. Selecionar o boto OK, para fechar essa caixa de dilogo e realizar o backup.
CRIANDO UM ALIAS PARA UM BANCO DE DADOS DO INTERBASE
Para criar um alias para um banco de dados do Interbase, voc deve executar os seguintes procedimentos:
1. Selecionar o item Explorer do menu Database do Delphi 7. Ser exibida a caixa de dilogo SQL
Explorer.
2. Selecionar o item New do menu Object. Ser exibida a caixa de dilogo New Database Alias, na qual
dever ser selecionada a opo correspondente ao Interbase, e o boto OK para fechar essa caixa de
dilogo. O novo alias ser criado com um nome default (INTRBASE1, no caso deste exemplo).
3. Alterar o nome do alias para outro nome mais fcil de memorizar (neste exemplo, usou-se o
nome AXCEL).
4. Definir o nome e o path do arquivo que armazena o banco de dados na opo SERVER NAME,
como mostrado na figura a seguir.
Figura 27.11: Criando um alias para um banco de dados do Interbase.
5. Definir o nome do usurio na opo USER NAME.
6. Fechar a janela do SQL Explorer salvando as alteraes feitas no alias, selecionando o item
Apply do menu Object ou o boto Apply da barra de ferramentas do SQL Explorer.
Pronto! Seu alias foi criado e pode ser selecionado na lista de opes disponveis na propriedade
DatabaseName dos componentes Table e Query.
CAPTULO 28 ACESSANDO BANCOS DE DADOS CLIENTE/SERVIDOR
Captulo
Acessando Bancos de
Dados Cliente/Servidor
28
Neste captulo sero apresentados os procedimentos necessrios ao acesso a bancos de dados cliente-
servidor a partir de uma aplicao desenvolvida em Delphi, usando os diversos mecanismos de acesso,
e principalmente os componentes que permitem a execuo de stored procedures (procedimentos
armazenados) a partir de uma aplicao.
KNOW-HOW EM: ACESSO A BANCOS
DE DADOS CLIENTE/SERVIDOR
PR-REQUISITOS
Utilizao dos componentes de acesso e visualizao de bancos de dados do Delphi 7.
METODOLOGIA
Apresentao do problema: Diviso de tarefas entre uma aplicao cliente e o servidor de bancos de dados.
TCNICA
Apresentao dos procedimentos necessrios ao acesso a bancos de dados cliente/servidor usando os diversos mecanismos de acesso.
O desenvolvimento de uma aplicao de acesso a bancos de dados em ambiente cliente/servidor consiste
fundamentalmente em subdividir o trabalho de pesquisa e manuteno de um banco de dados entre a
aplicao cliente e o servidor de bancos de dados.
Essa subdiviso de tarefas, no entanto, no deve se limitar apenas a delegar ao servidor a responsabilidade
pelo armazenamento de informaes. Este deve ser responsvel, tambm, por executar algumas rotinas
predefinidas, de modo a limitar os dados a serem enviados ao cliente, reduzindo-se o trfego de
informaes na rede.
Conforme mostrado no captulo anterior, o servidor executa essas tarefas mediante a utilizao de
triggers e stored procedures.
ACESSANDO BANCO DE DADOS CLIENTE-SERVIDOR DO
INTERBASE EM UMA APLICAO DELPHI VIA BDE
A princpio, o acesso a um banco de dados cliente-servidor criado no Interbase no oferece maiores
dificuldades.
No caso de se usar o acesso via BDE, voc pode inserir, em um formulrio (ou em um Datamodule),
componentes Table ou Query, definir a propriedade Databasename desses componentes como o
alias criado para o banco de dados, definir adequadamente a propriedade TableName (no caso do
componente Table) ou SQL (no caso do componente Query) e definir como True a propriedade
Active do componente empregado.
A principal diferena que, nesses casos, ser exibida uma caixa de dilogo para Login, como mostra a
figura a seguir.
Figura 28.1: A caixa de dilogo Database Login.
Em seguida, basta ligar um DataSource ao componente Table ou Query (atravs da sua propriedade
DataSet), inserir diversos componentes de visualizao no formulrio (configurando adequadamente
suas propriedades DataSource e DataField) e, se for o caso, um componente DBNavigator.
Ao executar esses procedimentos, no entanto, no estaremos aproveitando muitas das vantagens de se
empregar uma ferramenta de desenvolvimento cliente/servidor.
Conforme ser mostrado a seguir, o Delphi tem alguns componentes que nos ajudam a explorar as
potencialidades dessa filosofia.
Por exemplo, para executar uma stored procedure a partir de uma aplicao desenvolvida em Delphi
atravs de mecanismo de acesso do Borland Database Engine, voc deve utilizar o componente
StoredProc, existente na pgina BDE da paleta de componentes.
Apresentam-se a seguir as principais propriedades, mtodos e eventos desse componente, derivado por
herana da classe TDBDataset.
PRINCIPAIS PROPRIEDADES DO COMPONENTE STOREDPROC
Apresentam-se a seguir as principais propriedades desse componente, alm de outras herdadas das
suas classes ancestrais.
Active
Essa propriedade definida como uma varivel booleana, e pode ser definida como True se o
procedimento armazenado se baseia numa simples consulta.
Database
Essa propriedade definida como um objeto da classe TDatabase, e permite o acesso ao componente
que representa o banco de dados ao qual se est conectado.
importante lembrar que, se nenhum componente TDataBase for explicitamente includo na aplicao,
uma instncia dessa classe ser gerada automaticamente pelo Delphi.
DatabaseName
Essa propriedade definida como uma varivel do tipo string, e define o nome do banco de dados ao
qual o componente est conectado. Pode ser o nome de um alias definido no Borland Database Engine
ou o nome definido na propriedade DataBaseName do componente Database associado.
ParamCount
Essa propriedade definida como uma varivel do tipo Word, e define o nmero de parmetros da
stored procedure que ser executada pelo componente, parmetros estes que podem ser visualizados
atravs da propriedade Params do componente.
Params
individualmente os parmetros definidos para a stored procedure. Para acessar a caixa de dilogo na
qual so definidos esses parmetros, basta selecionar, com o boto esquerdo do mouse, as reticncias
exibidas direita do nome da propriedade no Object Inspector.
Prepared
Essa propriedade definida como uma varivel booleana, e define se a stored procedure foi preparada
para ser executada, de modo a melhorar a sua performance.
A preparao de uma stored procedure pode ser feita atribuindo-se o valor True a essa propriedade, ou
mediante uma chamada ao seu mtodo Prepare.
StoredProcName
Essa propriedade definida como uma varivel do tipo string, e define o nome da stored procedure a
ser executada.
As stored procedures disponveis para o banco de dados podem ser selecionadas na lista drop-down
exibida direita do nome da propriedade.
PRINCIPAIS MTODOS DO COMPONENTE STOREDPROC
Apresentam-se a seguir os principais mtodos desse componente, alm de outras herdadas das suas
classes ancestrais.
CopyParams
Declarao
procedure CopyParams(Value: TParams);
Esse mtodo copia a lista de parmetros do componente para outra lista de parmetros (que pode ser a
propriedade Params de outro componente StoredProc).
ExecProc
Declarao
procedure ExecProc;
Esse procedimento executa no servidor a procedure associada ao componente, e cujo nome definido
na sua propriedade StoredProcName.
ParamByName
Declarao
Esse mtodo permite o acesso individual a parmetros definidos em uma stored procedure, sendo o
Prepare
Declarao
procedure Prepare;
Esse mtodo prepara a stored procedure a ser executada, atribuindo o valor True sua propriedade Prepared.
UnPrepare
Declarao
Esse mtodo cancela a preparao da stored procedure a ser executada, atribuindo o valor False sua
propriedade Prepared.
PRINCIPAIS EVENTOS DO COMPONENTE IBOREDPROC
Apresentam-se a seguir os principais eventos deste componente, alm daqueles herdados das suas
classes ancestrais.
OnUpdateError
Esse evento ocorre quando um erro gerado ao se tentar atualizar alteraes pendentes no banco de dados.
OnUpdateRecord
Esse evento ocorre ao se atualizar alteraes pendentes no registro corrente.
EXEMPLO DE APLICAO
Para criar o aplicativo-exemplo, voc deve executar os seguintes procedimentos:
1. Selecionar o item File/New Application no menu do Delphi, para iniciar uma nova aplicao
baseada na VCL.
2. Insira um componente Datasource no formulrio e defina sua propriedade Name como sendo
igual a DatasourceCS.
3. Insira neste formulrio um componente DBGrid e defina sua propriedade Name como DBGridCS.
4. Insira neste formulrio um componente DBNavigator e defina sua propriedade Name como
DBNavigarorCS.
5. Defina a propriedade Datasource destes componentes como DatasourceCS.
6. Insira neste formulrio um componente Label e defina sua propriedade Caption como Valor.
7. Insira neste formulrio um componente Edit e defina sua propriedade Name como EditValor.
Defina como 1.0 o texto exibido na propriedade Text deste componente.
8. Altere a propriedade Caption deste formulrio para Exemplo de Acesso a Banco de Dados
Cliente-Servidor.
9. Insira um componente BitBtn neste formulrio e atribua os seguintes valores para as suas
Name: BotaoAplicar
Kind: bkCustom
Caption: Aplicar
Height: 50
Width: 100
10. Insira um segundo componente BitBtn neste formulrio e atribua os seguintes valores para as
Name: BotaoFechar
Kind: bkClose
Caption: Fechar
Height: 50
Width: 100
11. Altere a propriedade Name deste formulrio para FormCS.
Figura 28.2: Aspecto inicial do Formulrio.
importante destacar que este formulrio ser o mesmo em todos os exemplos apresentados neste
captulo. A diferena estar presente nos componentes de acesso a dados, que iro variar de um
mecanismo para outro.
12. Insira um componente Database neste formulrio e atribua os seguintes valores para as suas
AliasName: AXCEL
Databasename: TESTE
Connected: True
Name: DatabaseCS
13. Insira um componente Table neste formulrio e atribua os seguintes valores para as suas
Databasename: TESTE
TableName: EMPREGADOS
Active: True
Name: TableCS
14. Defina como TableCS o valor da propriedade Dataset do componente DatasorceCS.
15. Insira um componente StoredProc neste formulrio e atribua os seguintes valores para as suas
Databasename: TESTE
StoredProcName: AUMENTO
Name: StoredProcCS
Se voc definir como True a propriedade Active deste componente, ser exibida uma mensagem de erro, pois no se trata de uma
Stored Procedure relacionada a uma consulta.
16. Selecione a propriedade Params do componente StoredProcCS para exibir a caixa de dilogo
para definio de parmetros mostrada na figura a seguir. Nessa caixa de dilogo selecione o
parmetro FATOR (o nico disponvel) e, no Object Inspector, atribua os seguintes valores s
suas principais propriedades: DataType: Float e ParamType: ptInput.
Figura 28.3: Alterando a propriedade Params do componente StoredProcCS.
BotaoAplicar:
procedure TFormCS.BotaoAplicarClick(Sender: TObject);
var
valor : double;
begin
try
valor := StrToFloat(EditValor.Text);
if valor > 1.0
then
begin
StoredProcCS.ParamByName(Fator).AsString := EditValor.Text;
StoredProcCS.Prepare;
StoredProcCS.ExecProc;
TableCS.Refresh;
end
else
ShowMessage(Valor digitado deve ser maior do que 1.0);
except
ShowMessage(Valor Digitado Incompatvel);
end;
end;
18. Defina da seguinte maneira o procedimento associado ao evento OnCreate do formulrio:
procedure TFormCS.FormCreate(Sender: TObject);
begin
DecimalSeparator := .;
DatabaseCS.StartTransaction;
end;
19. Defina da seguinte maneira o procedimento associado ao evento OnClose do formulrio
procedure TFormCS.FormClose(Sender: TObject; var Action: TCloseAction);
begin
DatabaseCS.Commit;
end;
ACESSANDO BANCO DE DADOS DO INTERBASE EM
UMA APLICAO DELPHI VIA INTERBASE EXPRESS
O mecanismo de acesso Interbase Express, cujos componentes esto disponveis na pgina Interbase
da paleta de componentes, possui um componente chamado IBDatabase que exerce um papel
semelhante ao que o componente Database realiza em aplicaes que acessam o Interbase via BDE.
A principal diferena que, no caso do Interbase Express, os componentes IBTable e IBQuery no podem
prescindir do componente IBDatabase, ao qual faro referncia atravs da sua propriedade Database.
Para executar uma stored procedure a partir de uma aplicao desenvolvida em Delphi atravs do
mecanismo de acesso Interbase Express, voc deve utilizar o componente IBStoredProc, existente na
pgina Interbase da paleta de componentes.
herana da classe TIBCustomDataset.
PRINCIPAIS PROPRIEDADES DO COMPONENTE IBSTOREDPROC
Apresentam-se a seguir as principais propriedades desse componente, alm daquelas herdadas das suas
classes ancestrais.
Database
Essa propriedade, herdada da classe ancestral TIBCustomDataset, definida como um objeto da classe
TIBDatabase, e permite o acesso s propriedades e mtodos do componente que representa o banco de
dados ao qual se est conectado.
ParamCount
Essa propriedade definida como uma varivel do tipo Word, e define o nmero de parmetros da
stored procedure que ser executada pelo componente, parmetros estes que podem ser visualizados
atravs da propriedade Params do componente.
Params
Prepared
StoredProcName
ser executada.
Transaction
Essa propriedade definida como um objeto da classe TIBTransaction, e define o componente
IBTransaction ao qual est vinculado.
PRINCIPAIS MTODOS DO COMPONENTE IBSTOREDPROC
Apresentam-se a seguir os principais mtodos desse componente, alm daquelas herdadas das suas
classes ancestrais.
CopyParams
Declarao
Esse mtodo copia a lista de parmetros do componente para outra lista de parmetros (que pode ser a
propriedade Params de outro componente StoredProc).
ExecProc
Declarao
procedure ExecProc;
ParamByName
Declarao
Esse mtodo permite o acesso individual a parmetros definidos em uma stored procedure, sendo o
Prepare
Declarao
procedure Prepare;
Esse mtodo prepara a stored procedure a ser executada, atribuindo o valor True sua propriedade
Prepared.
UnPrepare
Declarao
Esse mtodo cancela a preparao da stored procedure a ser executada, atribuindo o valor False sua
propriedade Prepared.
PRINCIPAIS EVENTOS DO COMPONENTE IBSTOREDPROC
Apresentam-se a seguir os principais eventos deste componente, alm daqueles herdados das suas
classes ancestrais.
OnUpdateError
Esse evento ocorre quando um erro gerado ao se tentar atualizar alteraes pendentes no banco de dados.
OnUpdateRecord
Esse evento ocorre ao se atualizar alteraes pendentes no registro corrente.
EXEMPLO DE APLICAO
Para recriar a aplicao anterior usando os componentes do Interbase Express (situados na pgina
Interbase da paleta de componentes) voc deve executar os seguintes procedimentos:
1. Remova os componentes Database, Storedproc e Table do formulrio.
2. Inclua um componente IBDatabase no formulrio e usando a sua propriedade DatabaseName,
localize o arquivo Exemplo.gdb (repare que neste caso no se utiliza quaisquer alias).
3. Atribua o valor True a sua propriedade Connected. Ser exibida a caixa de dilogo Database
Login. Preencha corretamente os valores dos campos UserName e Password e o boto Ok, para
fechar esta caixa de dilogo e realizar a conexo. Redefina a propriedade Name deste componente
para IBDatabaseCS.
4. Coloque um componente IBTransaction no formulrio e defina o valor da sua propriedade
DefaultDatabase como sendo o nome do componente IBDatabase recm-includo no formulrio
(IBDatabaseCS).
5. Defina o valor da propriedade Active deste componente IBTransaction como True. Redefina
sua propriedade name como IBTransactionCS.
6. Coloque um componente IBTable no formulrio e defina o valor da sua propriedade Database
como sendo o nome do componente IBDatabase recm-includo no formulrio (IBDatabaseCS).
Redefina sua propriedade name como IBTableCS.
7. Defina o valor da sua propriedade Transaction como sendo o nome do componente
IBTransaction inserido no formulrio (IBTransactionCS).
8. Defina o valor da sua propriedade TableName como sendo Empregados.
9. Defina o valor da sua propriedade Active como sendo igual a True.
10. Defina o valor da propriedade Dataset do componente DataSource como sendo o nome do
componente Table inserido no formulrio (IBTableCS).
Repare que, no caso do Interbase Express, os componentes IBTable e IBQuery devem se conectar obrigatoriamente a dois componentes:
Um componente IBDatabase e um componente IBTransaction.
O componente IBTransaction permite um controle discreto sobre diferentes transaes aplicadas ao
banco de dados. Sua propriedade Default Action define como ser processada a transao representada
pelo componente, podendo assumir um dos seguintes valores:
taRollback: Efetua um RollBack sobre a transao.
taCommit: Efetua um Commit sobre a transao.
taRollbackRetaining: Cancela a transao mas mantm localmente as alteraes.
taCommitRetaining: Efetua um Commit sobre a transao mas mantm localmente as alteraes.
Repare que, no caso do Interbase Express, os componentes IBTransaction (E no o componente IBDatabase, como poderamos pensar
inicialmente) so responsveis pelo controle das transaes. A nica funo do componente IBDatabase realizar a conexo o
controle de transaes fica por conta de componentes intransaction. Uma viso mais detalhada dos componentes ser apresentada no
final do livro na seo Referncias.
11. Redefina como IBTableCS o valor da propriedade Dataset do componente DatasorceCS.
12. Insira um componente IBStoredProc neste formulrio e atribua os seguintes valores para as
Database: IBDatabaseCS
Name: IBStoredProcCS
Transaction: IBTransactionCS
13. Selecione a propriedade Params do componente IBStoredProcCS para exibir a caixa de dilogo
para definio de parmetros. Nessa caixa de dilogo selecione o parmetro FATOR (o nico
disponvel) e, no Object Inspector, atribua os seguintes valores s suas principais propriedades:
DataType: Float e ParamType: ptInput.
BotaoAplicar:
var
valor : double;
begin
try
if valor > 1.0
then
begin
IBStoredProcCS.ParamByName(Fator).AsString := EditValor.Text;
IBStoredProcCS.Prepare;
IBStoredProcCS.ExecProc;
IBTableCS.Refresh;
end
else
except
end;
end;
begin
IBTransactionCS.StartTransaction;
end;
begin
IBTransactionCS.Commit;
end;
ACESSANDO BANCO DE DADOS DO INTERBASE EM UMA APLICAO DELPHI VIA DBEXPRESS
O mecanismo de acesso DBExpress, cujos componentes esto disponveis na pgina DBExpress da
paleta de componentes, possui um componente chamado SQLConnection, j visto ao longo do livro,
que exerce um papel semelhante ao que o componente Database realiza em aplicaes que acessam o
Interbase via BDE.
No caso do DBExpress, os componentes SQLTable, SQLQuery e SimpleDataset no podem prescindir
do componente SQLConnection, ao qual faro referncia atravs da sua propriedade Connection.
Para executar uma stored procedure a partir de uma aplicao desenvolvida em Delphi atravs do
mecanismo de acesso DBExpress, voc deve utilizar o componente SQLStoredProc, existente na pgina
dbExpress da paleta de componentes.
herana da classe TCustomSQLDataset.
PRINCIPAIS PROPRIEDADES DO COMPONENTE SQLSTOREDPROC
Apresentam-se a seguir as principais propriedades desse componente, alm daquelas herdadas das suas
classes ancestrais.
Params
Prepared
SQLConnection
Essa propriedade, herdada da classe ancestral TCustomSQLDataset, definida como um objeto da
classe TSQLConnection, e permite o acesso s propriedades e mtodos do componente que representa
o banco de dados ao qual se est conectado.
StoredProcName
ser executada.
PRINCIPAIS MTODOS DO COMPONENTE SQLSTOREDPROC
Apresentam-se a seguir os principais mtodos desse componente, alm daqueles herdados das suas
classes ancestrais.
ExecProc
Declarao
procedure ExecProc;
PRINCIPAIS EVENTOS DO COMPONENTE SQLSTOREDPROC
Este componente no implementa nenhum evento adicional, alm daqueles herdados das suas
classes ancestrais.
EXEMPLO DE APLICAO
Para recriar a aplicao anterior usando os componentes do DBExpress (situados na pgina dBExpress
da paleta de componentes) voc deve executar os seguintes procedimentos:
1. Remova os componentes IBDatabase, IBTransaction, IBStoredproc e IBTable do formulrio.
2. Inclua um componente SQLConnection no formulrio, crie uma nova conexo e configure
suas propriedades para acessar o arquivo Exemplo.gdb (repare que neste caso tambm no se
utiliza qualquer alias).
3. Atribua o valor True a sua propriedade Connected. Ser exibida a caixa de dilogo Database
Login. Preencha corretamente os valores dos campos UserName e Password e o boto Ok, para
fechar esta caixa de dilogo e realizar a conexo. Redefina a propriedade Name deste componente
para SQLConnectionCS.
4. Coloque um componente SimpleDataset no formulrio e defina o valor da sua propriedade
Connection como sendo o nome do componente SQL Connection recm-includo no formulrio
(SQLConnectionCS). Redefina sua propriedade name como SimpleDatasetCS.
5. Altere o valor da subpropriedade CommandType da propriedade Dataset deste componente
para ctTable.
6. Altere o valor da subpropriedade CommandText da propriedade Dataset deste componente
para EMPREGADOS.
7. Defina o valor da sua propriedade Active como sendo igual a True.
8. Defina o valor da propriedade Dataset do componente DataSource como sendo o nome do
componente SimpleDataset inserido no formulrio (SimpleDataset CS).
Repare que, no caso do Interbase Express, os componentes IBTable e IBQuery devem se conectar obrigatoriamente a dois componentes:
Um componente IBDatabase e um componente IBTransaction.
O componente IBTransaction permite um controle discreto sobre diferentes transaes aplicadas ao
banco de dados. Sua propriedade Default Action define como ser processada a transao representada
pelo componente, podendo assumir um dos seguintes valores:
taRollback: Efetua um RollBack sobre a transao.
taCommit: Efetua um Commit sobre a transao.
taRollbackRetaining: Cancela a transao mas mantm localmente as alteraes.
taCommitRetaining: Efetua um Commit sobre a transao mas mantm localmente as alteraes.
Repare que, no caso do Interbase Express, os componentes IBTransaction (E no o componente IBDatabase, como poderamos pensar
inicialmente) so responsveis pelo controle das transaes. A nica funo do componente IBDatabase realizar a conexo o
controle de transaes fica por conta de componentes intransaction. Uma viso mais detalhada dos componentes ser apresentada no
final do livro na seo Referncias.
9. Redefina como SimpleDataset CS o valor da propriedade Dataset do componente DatasorceCS.
10. Insira um componente SQLStoredProc neste formulrio e atribua os seguintes valores para as
SQLConnection: SQLConnection CS
Name: SQLStoredProcCS
11. Selecione a propriedade Params do componente IBStoredProcCS para exibir a caixa de dilogo
para definio de parmetros. Nessa caixa de dilogo selecione o parmetro FATOR (o nico
disponvel) e, no Object Inspector, atribua os seguintes valores s suas principais propriedades:
DataType: Float e ParamType: ptInput.
12. Declare, na seo var da unit, uma varivel chamada TD do tipo TTransactionDesc, como a seguir:
var
FormCS: TFormCS;
TD : TTransactionDesc;
BotaoAplicar:
var
valor : double;
begin
try
if valor > 1.0
then
begin
SQLStoredProcCS.ParamByName(Fator).AsString := EditValor.Text;
SQLStoredProcCS.ExecProc;
SimpleDatasetCS.Refresh;
end
else
except
end;
end;
begin
TD.TransactionID := 1;
TD.IsolationLevel := xilREADCOMMITTED;
SQLConnectionCS.StartTransaction(TD);
end;
15. Defina da seguinte maneira o procedimento associado ao evento OnClose do formulrio
begin
SQLConnectionCS.Commit(TD);
end;
Repare que, no caso do mecanismo dbExpress, deve-se passar como parmetro nas chamadas aos mtodos
StartTransaction e Commit uma varivel do tipo composto TTransactionDesc, que identifica uma
transao (e desempenha um papel semelhante ao do IBTransaction no Interbase Express).
CAPTULO 29 PROGRAMAO GRFICA
Captulo
Programao Grfica
29
Uma das principais diferenas entre o sistema operacional Windows e o antigo DOS que, enquanto
este baseado em caracteres, aquele constitui uma interface grfica em que at mesmo os caracteres
so desenhados. O Windows trata a tela (e suas regies) e reas de impresso como uma superfcie de
desenho, tambm conhecida como Canvas.
As funes relacionadas s atividades de desenho do Windows esto reunidas em um grupo ou biblioteca
de funes denominado GDI Graphical Device Interface. A utilizao dessas funes normalmente
requer um nmero que identifica o objeto sobre o qual a funo vai atuar, e esse nmero costuma ser
denominado handle do objeto.
A fim de facilitar o acesso a estas funcionalidades, o Delphi definiu uma nova classe denominada
TCanvas, que incorporou entre seus mtodos as principais funes da GDI. Ao definir objetos da classe
TCanvas como propriedades ou campos de outras classes e componentes, o Delphi eliminou a
necessidade de utilizao de handles e chamada das funes da GDI estes sero necessrios apenas
quando forem utilizadas funes da GDI existentes na API do Windows, mas que no foram incorporadas
como mtodos da classe TCanvas. Nesse caso, no entanto, a utilizao dessas funes da GDI ainda
ser bastante simplificada, pois o Delphi definiu para esses componentes uma propriedade chamada
handle, que retorna o cdigo que identifica o objeto.
KNOW-HOW EM: DEFINIO DE DESENHOS EM RUN-TIME
PR-REQUISITOS
Experincia prvia na utilizao de componentes no desenvolvimento de aplicaes com Delphi.
Conhecimento das principais propriedades e mtodos das classes TCanvas, TBrush e TPen.
METODOLOGIA
Apresentao do problema: Utilizao das principais propriedades e mtodos das classes TCanvas, TBrush e TPen na definio de desenhos
em run-time para aplicaes desenvolvidas em Delphi.
TCNICA
Apresentao dos procedimentos necessrios definio de desenhos em run-time para aplicaes desenvolvidas em Delphi.
A CLASSE TCANVAS
Para o Windows, qualquer rea a ser manipulada na tela (ou na impressora) tratada como uma
superfcie de desenho.
Para simplificar a vida do programador, o Delphi criou uma nova classe, denominada TCanvas, que
representa uma superfcie de desenho retangular sobre a qual podero ser feitos desenhos, textos, etc.
Em um canvas existe um sistema de coordenadas cartesiano em que a origem est situada no canto
superior esquerdo, as abscissas crescem da esquerda para a direita e as ordenadas de cima para baixo
(ao contrrio do sistema cartesiano convencional). Conforme ser visto posteriormente, existem funes
da GDI do Windows que permitem que se altere a orientao destes eixos do canvas, bem como o
posicionamento da origem desse sistema.
Guarde bem esse conceito: um canvas um objeto da classe TCanvas que define uma rea de
desenho da tela, e que tem, entre seus mtodos, alternativas mais prticas s principais funes da
GDI do Windows.
O desenho de linhas em um canvas feito usando-se uma caneta imaginria, que na realidade um
objeto da classe TPen (outra classe definida pelo Delphi), e o preenchimento de superfcies feito
usando-se um pincel imaginrio, que na realidade um objeto da classe TBrush. Dentre as principais
propriedades de um objeto da classe TPen a caneta imaginria destacam-se aquelas que definem a
sua espessura, a sua cor, modo e estilo de desenho. Para um objeto da classe TBrush, suas principais
propriedades so aquelas que definem a sua cor e estilo.
As principais propriedades e mtodos dessas classes foram apresentados anteriormente e no sero
redefinidos neste captulo, no qual trataremos apenas da sua utilizao em algumas situaes particulares.
O COMPONENTE SHAPE
O componente Shape, situado na pgina Additional da paleta de componentes, utilizado para desenhar
formas geomtricas na tela e, diferentemente de outros componentes, permite que suas propriedades
Brush e Pen sejam definidas durante o projeto da aplicao alterando os seus valores diretamente no
Object Inspector.
Existem componentes, no entanto, que no permitem que se acessem suas propriedades Brush e Pen
na fase de projeto, mas apenas durante a execuo do aplicativo (ou seja, via cdigo).
Esses componentes, no entanto, tm um evento chamado OnPaint, para o qual podemos definir um
procedimento associado, e nesse procedimento definir o cdigo referente a qualquer desenho a ser
feito no seu canvas.
Para que um desenho seja permanentemente visualizado em um formulrio ou componente, o cdigo que o define deve ser digitado no
procedimento associado ao evento OnPaint do formulrio ou componente. Se esse cdigo no for includo no evento OnPaint e a regio do
formulrio ou componente que exibe o desenho for sobreposta por outra janela, este no ser restaurado na tela quando a regio
correspondente se tornar visvel novamente.
Nos prximos tpicos, sero apresentados os procedimentos necessrios exibio de desenhos em
formulrios.
DESENHANDO EM UM FORMULRIO
Todo formulrio tem uma propriedade chamada canvas que , como j foi dito anteriormente, um
objeto da classe TCanvas. Dessa maneira, se quisermos desenhar sobre a superfcie de um formulrio,
devemos faz-lo utilizando a sua propriedade canvas.
Apresentamos a seguir um aplicativo bastante simples, que permite que o usurio defina os pontos que
delimitam um retngulo ou elipse, bem como as suas dimenses.
Para criar esse aplicativo, voc deve executar os seguintes procedimentos:
1. Selecionar o item New Application do menu File, para iniciar um novo projeto de aplicao.
2. Atribua os valores a seguir para as principais propriedades do Formulrio Principal da Aplicao:
Name: FormDesenho
Width: 870
Height: 640
Caption: Exemplo de Utilizao do Canvas de um Formulrio
3. Inclua um componente panel (pgina Standard) no formulrio e atribua os seguintes valores
s suas principais propriedades:
Name: Panel1
Height: 150
Align: alTop
Caption:
4. Inclua um componente GroupBox (pgina Standard) no panel e atribua os seguintes valores
para as suas principais propriedades:
Name: GroupBox1
Left: 8
Top: 8
Width: 260
Height: 75
Caption: Coordenadas iniciais
5. Inclua dois Labels no componente GroupBox1 e atribua os seguintes valores para as suas
Name: Label1
Left: 17
Top: 22
Height: 13
AutoSize: True
Caption: X:
Name: Label2
Left: 17
Top: 50
Height: 13
AutoSize: True
Caption: Y:
6. Inclua dois componentes Edit no componente GroupBox1 e atribua os seguintes valores para
Name: EditX
Left: 41
Top: 18
Width: 40
Height: 21
Text: 10
Name: EditY
Left: 41
Top: 42
Width: 40
Height: 21
Text: 10
7. Inclua um segundo componente GroupBox no panel e atribua os seguintes valores para as suas
Name: GroupBox2
Left: 144
Top: 8
Width: 129
Height: 73
Caption: Dimenses Iniciais
8. Inclua dois Labels no componente GroupBox2 e atribua os seguintes valores para as suas
Name: Label3
Left: 13
Top: 22
Height: 13
AutoSize: True
Caption: Largura:
Name: Label4
Left: 13
Top: 48
Height: 13
AutoSize: True
Caption: Altura:
9. Inclua dois componentes Edit no componente GroupBox2 e atribua os seguintes valores para
Name: EditW
Left: 62
Top: 18
Width: 40
Height: 21
Text: 100
Name: EditH
Left: 62
Top: 44
Width: 40
Height: 21
Text: 100
10. Inclua um componente RadioGroup (pgina Standard) no panel e atribua os seguintes valores
para as suas principais propriedades:
Name: RadioGroupForma
Left: 280
Top: 8
Width: 129
Height: 73
Caption: Forma
ItemIndex: 0
11. Defina a propriedade Items do componente RadioGroupForma usando a caixa de dilogo String
List Editor, como indicado na figura a seguir.
Figura 29.1: Definindo a propriedade Items para o RadioGroup.
12. Inclua um componente BitBtn (pgina Additional) no panel e atribua os seguintes valores para
Name: BotaoDesenho
Left: 424
Top: 20
Width: 100
Height: 50
Caption: Desenha
Kind: bkOK
13. Inclua mais dois Labels no panel e atribua os seguintes valores para as suas principais
propriedades:
Name: Label5
Left: 16
Top: 88
Width: 120
Height: 13
Caption: Estilo de Preenchimento:
Name: Label6
Left: 184
Top: 88
Width: 22
Height: 13
Caption: Cor:
14. Inclua um componente ComboBox no panel e atribua os seguintes valores para as suas principais
propriedades:
Name: ComboBoxEstilo
Left: 16
Top: 112
Width: 145
Height: 21
ItemHeight: 13
15. Defina a propriedade Items do componente ComboBoxEstilo usando a caixa de dilogo String
List Editor, como indicado na figura a seguir.
Figura 29.2: Definindo a propriedade Items para o ComboBox.
16. Inclua um componente Shape (pgina Additional) no panel e atribua os seguintes valores para
Name: ShapeCor
Left: 184
Top: 104
Width: 41
Height: 33
Brush.Color: clWhite
Brush.Style: bsSolid
Shape: stRectangle
17. Inclua um componente ColorDialog (pgina Dialogs) no panel e mantenha os valores default
para as suas propriedades.
A figura a seguir apresenta o aspecto final do formulrio.
Figura 29.3: Aspecto do formulrio.
18. Defina as seguintes variveis na seo var do arquivo de cdigo associado ao formulrio:
x, y, h, w : integer;
BotaoDesenha:
procedure TFormDesenho.BotaoDesenhoClick(Sender: TObject);
begin
FormDesenho.Canvas.Brush.Color := ShapeCor.Brush.Color;
FormDesenho.Canvas.Brush.Style := TBrushStyle(ComboBoxEstilo.ItemIndex);
x := StrToInt(EditX.Text);
y := StrToInt(Edity.Text)+149;
h := StrToInt(Edith.Text);
w := StrToInt(Editw.Text);
if (x<0)or(x+w>FormDesenho.Width)or(Y<0)or(Y+h>FormDesenho.Height)
then
ShowMessage(Parametros Incorretos)
else
FormDesenho.Repaint;
end;
Este cdigo realiza as seguintes tarefas:
Define como valor da propriedade Color da subpropriedade Brush do canvas do formulrio o
valor definido na subpropriedade Color da propriedade Brush do componente ShapeCor, o
que feito na seguinte linha de cdigo:
Define como valor da propriedade Style da subpropriedade Brush do canvas do formulrio o
valor selecionado no componente ComboBoxEstilo.
Atribui s variveis X, Y, H e W os valores definidos nas caixas de texto correspondentes, como
indicado no trecho de cdigo a seguir:
Repare que ao valor de y foi acrescido o valor da altura do panel, para que a figura no seja oculta pelo mesmo.
Verifica se os valores definidos esto dentro de uma faixa que garanta a visualizao da figura,
o que feito no seguinte trecho de cdigo:
then
else
Caso os valores estejam dentro da faixa permitida, o mtodo Repaint do formulrio faz com que o seu
procedimento associado ao evento OnPaint seja executado.
20. Compartilhe esse procedimento com os seguintes eventos:
Evento OnShow do Formulrio.
Evento OnChange do Componente EditX.
Evento OnChange do Componente EditY.
Evento OnChange do Componente EditH.
Evento OnChange do Componente EditW.
Evento OnClick do Componente RadioGroupForma.
Evento OnChange do Componente ComboBoxEstilo.
Isso garante que o efeito de qualquer alterao feita nos valores que definem a figura seja imediatamente
visualizado. Garante tambm que a figura default seja visualizada quando o formulrio for exibido
pela primeira vez.
21. Defina da seguinte maneira o procedimento associado ao evento OnMouseDown do
componente ShapeCor:
procedure TFormDesenho.ShapeCorMouseDown(Sender: TObject;
Button: TMouseButton; Shift: TShiftState; X, Y: Integer);
begin
if ColorDialog1.Execute then
begin
ShapeCor.Brush.Color := ColorDialog1.Color;
BotaoDesenhoClick(Self);
end;
end;
Esse procedimento exibe uma caixa de dilogo de seleo de cores para que o usurio escolha uma
nova cor para a figura.
Caso o mtodo Execute do componente OpenDialog1 retorne o valor True, o procedimento associado
ao evento OnClick do componente BotaoDesenho executado.
22. Defina da seguinte maneira o procedimento associado ao evento OnPaint do formulrio:
procedure TFormDesenho.FormPaint(Sender: TObject);
begin
if RadioGroupForma.ItemIndex = 0
then
FormDesenho.Canvas.Rectangle(x,y,x+w,y+h)
else
FormDesenho.Canvas.Ellipse(x,y,x+w,y+h);
end;
Esse procedimento verifica o tipo de figura selecionada pelo usurio (analisando o valor da propriedade
ItemIndex do componente RadioGroupForma) e executa o mtodo de desenho correspondente.
procedure TFormDesenho.FormCreate(Sender: TObject);
begin
ComboBoxEstilo.ItemIndex := 0;
end;
24. Salve a unidade de cdigo associada a esse formulrio com o nome UnitDesenha.
Apresentamos a seguir a unidade de cdigo associada ao formulrio:
unit UnitDesenha;
interface
uses
StdCtrls, Buttons, ExtCtrls;
type
TFormDesenho = class(TForm)
Panel1: TPanel;
Label1: TLabel;
EditX: TEdit;
Label2: TLabel;
EditY: TEdit;
Label3: TLabel;
EditH: TEdit;
Label4: TLabel;
EditW: TEdit;
RadioGroupForma: TRadioGroup;
BotaoDesenho: TBitBtn;
Label5: TLabel;
ComboBoxEstilo: TComboBox;
Label6: TLabel;
ShapeCor: TShape;
ColorDialog1: TColorDialog;
procedure BotaoDesenhoClick(Sender: TObject);
procedure ShapeCorMouseDown(Sender: TObject; Button: TMouseButton;
Shift: TShiftState; X, Y: Integer);
procedure FormPaint(Sender: TObject);
private
public
end;
var
FormDesenho: TFormDesenho;
x, y, h, w : integer;
implementation
{$R *.DFM}
procedure TFormDesenho.BotaoDesenhoClick(Sender: TObject);
begin
then
else
end;
procedure TFormDesenho.ShapeCorMouseDown(Sender: TObject;
begin
if ColorDialog1.Execute then
begin
ShapeCor.Brush.Color := ColorDialog1.Color;
BotaoDesenhoClick(Self);
end;
end;
procedure TFormDesenho.FormPaint(Sender: TObject);
begin
if RadioGroupForma.ItemIndex = 0
then
FormDesenho.Canvas.Rectangle(x,y,x+w,y+h)
else
FormDesenho.Canvas.Ellipse(x,y,x+w,y+h);
end;
procedure TFormDesenho.FormCreate(Sender: TObject);
begin
ComboBoxEstilo.ItemIndex := 0;
end;
end.
A figura a seguir apresenta o aplicativo sendo executado.
Figura 29.4: Executando o aplicativo.
KNOW-HOW EM: DEFINIO DE DESENHOS DE FORMA INTERATIVA
PR-REQUISITOS
Experincia prvia na utilizao de componentes no desenvolvimento de aplicaes em Delphi.
METODOLOGIA
Apresentao do problema: Utilizao das principais propriedades e mtodos das Classes TCanvas, TBrush e TPen da definio de desenhos
em run-time de forma interativa para aplicaes desenvolvidas com o Borland Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios definio de desenhos em run-time de forma interativa para aplicaes desenvolvidas com o
Borland Delphi 7.
DESENHANDO DE FORMA INTERATIVA
Neste tpico, mostramos os procedimentos necessrios ao desenho interativo em um canvas de um
formulrio.
Conforme j descrito anteriormente, o desenho de uma linha em um canvas feito utilizando-se os
seus mtodos MoveTo (que movimenta a caneta imaginria para a posio desejada) e LineTo (que
realmente desenha a linha).
A fim de ilustrar esses procedimentos, vamos criar um pequeno aplicativo que permita o desenho
interativo de retas no canvas de um formulrio. A lgica desse problema a seguinte:
Quando o usurio pressionar o boto esquerdo do mouse, estar indicando que deseja iniciar o
desenho de uma reta a partir daquele ponto. Vamos chamar de xbase e ybase as coordenadas
desse ponto, que denominaremos ponto-base. O usurio deve manter o boto esquerdo
pressionado e movimentar o mouse pela rea de desenho. A obteno dessas coordenadas do
ponto-base no difcil, pois estes valores so passados como parmetros (denominados X e Y)
no procedimento associado ao evento OnMouseDown do formulrio.
Enquanto o mouse estiver se deslocando pela rea de desenho, uma linha elstica dever ser
desenhada do ponto-base at a posio corrente do mouse. Vamos chamar de xatual e yatual as
coordenadas desse ponto. A obteno das coordenadas do ponto corrente tambm no difcil,
pois esses valores so passados como parmetros (denominados X e Y) no procedimento
associado ao evento OnMouseMove do formulrio.
Para desenhar a linha, devemos executar o mtodo MoveTo(xbase,ybase), para colocar a caneta na
posio do ponto-base, e o Mtodo LineTo(Xatual,Yatual), para desenhar a linha at o ponto corrente.
Quando o usurio soltar o boto esquerdo do mouse, a linha dever ser desenhada na forma
definitiva. Essa tarefa tambm no difcil, pois o procedimento associado ao evento
OnMouseUp tambm passa como parmetros os valores X e Y das coordenadas atuais do mouse.
Para evitar que o programa desenhe linhas quando o boto esquerdo no estiver pressionado,
devemos criar uma varivel booleana que indique se o programa deve ou no executar as
funes de desenho.
Para criar essa aplicao, voc deve executar os seguintes procedimentos:
1. Selecione o item New Application do menu File para iniciar um novo projeto de aplicao.
2. Atribua os valores a seguir para as principais propriedades do Formulrio Principal da Aplicao.
Name: FormInterativo
Width: 870
Height: 640
Caption: Exemplo de Desenho Interativo no Canvas de um Formulrio
Color: clBlack
3. Inclua um componente Panel no formulrio e atribua os seguintes valores s suas principais
propriedades:
Name: Panel1
Align: albotton
Height: 40
Caption:
A Figura 29.5 apresenta o aspecto do formulrio.
4. Declare as seguintes variveis na seo var da unit do formulrio:
desenha : boolean;
xbase, ybase, xatual, yatual : integer;
procedure TFormInterativo.FormCreate(Sender: TObject);
begin
desenha := False;
end;
Isso garante que a varivel desenha seja inicializada com o valor False.
6. Defina da seguinte maneira o procedimento associado ao evento OnMouseDown do formulrio:
procedure TFormInterativo.FormMouseDown(Sender: TObject;
begin
desenha := True;
xbase := X;
ybase := y;
xatual := X;
yatual := y;
end;
Como pode ser verificado, esse procedimento define os valores das variveis xbase e ybase. Inicialmente,
os mesmos valores so atribudos s variveis xatual e yatual.
7. Defina da seguinte maneira o procedimento associado ao evento OnMouseMove do formulrio:
procedure TFormInterativo.FormMouseMove(Sender: TObject;
Begin
Panel1.Caption := X = +IntToStr(X)+ Y = +IntToStr(Y);
If not desenha then exit;
FormInterativo.Canvas.Pen.Color := clBlack;
FormInterativo.Canvas.MoveTo(xbase,ybase);
FormInterativo.Canvas.LineTo(xatual,yatual);
xatual := x;
yatual := y;
FormInterativo.Canvas.Pen.Color := clWhite;
end;
Inicialmente, exibem-se no panel as coordenadas atuais do mouse, o que feito na seguinte linha de cdigo:
Em seguida, verifica-se se a varivel desenha igual a True. Se for False, ento not desenha True e
a procedure no executada.
Em seguida, atribui-se a cor preta caneta do canvas para apagar a linha desenhada anteriormente, o
que feito no seguinte trecho de cdigo:
Por fim, atualizam-se os valores de xatual e yatual, atribui-se a cor branca caneta do canvas e desenha-
se a nova linha, o que feito no seguinte trecho de cdigo:
xatual := x;
yatual := y;
8. Defina da seguinte maneira o procedimento associado ao evento OnMouseUp do formulrio:
procedure TFormInterativo.FormMouseUp(Sender: TObject;
begin
desenha := False;
xatual := x;
yatual := y;
end;
Esse procedimento atribui o valor False varivel desenha e executa um cdigo de desenho semelhante
ao descrito anteriormente.
A figura a seguir apresenta o aplicativo sendo executado.
Figura 29.6: Execuo do aplicativo.
Apresentamos a seguir a unidade de cdigo associada a esse formulrio.
unit UnitPaint;
interface
uses
ExtCtrls;
type
TFormInterativo = class(TForm)
Panel1: TPanel;
procedure FormMouseMove(Sender: TObject; Shift: TShiftState; X,
Y: Integer);
procedure FormMouseDown(Sender: TObject; Button: TMouseButton;
procedure FormMouseUp(Sender: TObject; Button: TMouseButton;
private
public
end;
var
FormInterativo: TFormInterativo;
desenha : boolean;
implementation
{$R *.DFM}
procedure TFormInterativo.FormMouseMove(Sender: TObject; Shift: TShiftState; X,
Y: Integer);
begin
xatual := x;
yatual := y;
end;
begin
desenha := True;
xbase := X;
ybase := y;
xatual := X;
yatual := y;
end;
begin
desenha := False;
xatual := x;
yatual := y;
end;
begin
desenha := False;
end;
end.
Esse aplicativo ainda apresenta, no entanto, alguns problemas:
Se voc ocultar parte do formulrio, ou minimiz-lo e restaur-lo em seguida, o desenho ser perdido!
Isso se deve ao fato de que no foi definido um procedimento associado ao evento OnPaint, e logo
nada existe para ser redesenhado, ou que garanta a persistncia deste desenho.
H vrias alternativas para resolver este problema, sendo que uma delas consiste em realizar sempre
uma cpia do desenho atual em um Bitmap oculto, existente na menria, e copiar a imagem do
Bitmap para o formulrio quando o evento OnPaint for disparado.
A CLASSE TBITMAP
O Delphi possui a classe TBitmap, que permite que se faam coisas incrveis com Bitmaps. Neste tpico,
no entanto, limitaremos nosso estudo a resolver o problema descrito no final do tpico anterior.
A soluo consiste em criar um objeto da classe TBitmap com as mesmas dimenses do formulrio e,
sempre que o desenho do formulrio for alterado (nesse caso, quando uma nova reta for includa),
copiar o desenho do formulrio para o bitmap. Por outro lado, quando o formulrio for redimensionado,
ou ocultado e exibido em seguida, devemos copiar o desenho do Bitmap para o formulrio.
Assim como um formulrio, um objeto da classe TBitmap tambm tem uma propriedade chamada
Canvas (que , obviamente, um objeto da classe TCanvas).
A Classe TCanvas possui um mtodo chamado CopyRect que permite que se copie para o seu interior
uma rea retangular de outro canvas. Esse mtodo tem, como parmetros:
Uma varivel do tipo TRect, representando a rea retangular de destino do canvas que chama
o mtodo.
Uma varivel do tipo TCanvas, que define o canvas de onde ser feita a cpia.
Uma outra varivel do tipo TRect, representando a rea retangular de origem do canvas de
onde feita a cpia.
O tipo composto TRect (que no uma classe, mas um Record) possui os seguintes campos:
Top: Uma varivel inteira, que define a ordenada da extremidade superior esquerda da regio
retangular.
Bottom: Uma varivel inteira, que define a ordenada da extremidade inferior direita da regio
retangular.
Left: Uma varivel inteira, que define a abscissa da extremidade superior esquerda da regio
retangular.
Right: Uma varivel inteira, que define a abscissa da extremidade inferior direita da regio
retangular.
A regio a ser copiada, nesse caso, ser definida pela rea cliente do formulrio, descontada a altura do
panel (definida pela sua propriedade Height).
Para resolver este problema, portanto, voc deve executar os seguintes procedimentos no aplicativo
criado no tpico anterior:
1. Declarar uma varivel chamada MeuBitmap, da classe TBitmap, na seo var da unit do
formulrio, como a seguir:
MeuBitmap : TBitmap;
2. Declarar duas variveis chamadas AreaDestino e AreaOrigem, do tipo TRect, na seo var da
unit do formulrio, como a seguir:
Areadestino, AreaOrigem : TRect;
3. Criar a instncia da classe TBitmap no procedimento associado ao evento OnCreate do
formulrio, que ser redefinido como mostrado a seguir:
begin
desenha := False;
MeuBitmap := TBitmap.Create;
end;
4. Redefinir como a seguir o procedimento associado ao evento OnMouseUp do formulrio,
incluindo as linhas de cdigo responsveis pela cpia do desenho definido no canvas do
formulrio para o canvas do bitmap:
begin
desenha := False;
xatual := x;
yatual := y;
MeuBitmap.Height := FormInterativo.ClientHeight-Panel1.Height;
MeuBitmap.Width := FormInterativo.ClientWidth;
Areadestino.Top := 0;
Areadestino.Left := 0;
Areadestino.Right := FormInterativo.ClientWidth;
Areadestino.Bottom := FormInterativo.ClientHeight-Panel1.Height;
AreaOrigem.Top := 0;
AreaOrigem.Left := 0;
AreaOrigem.Right := FormInterativo.ClientWidth;
AreaOrigem.Bottom := FormInterativo.ClientHeight-Panel1.Height;
MeuBitmap.Canvas.CopyRect(AreaDestino,FormInterativo.Canvas,AreaOrigem);
end;
5. Redefinir como a seguir o procedimento associado ao evento OnPaint do formulrio, incluindo
as linhas de cdigo responsveis pela cpia do desenho definido no canvas do bitmap para o
canvas do formulrio:
procedure TFormInterativo.FormPaint(Sender: TObject);
begin
FormInterativo.Canvas.CopyRect(AreaDestino,MeuBitmap.Canvas,AreaOrigem);
end;
Repare que agora a imagem transferida no sentido inverso.
6. Compartilhe o procedimento associado ao evento OnPaint do formulrio com o seu evento
OnResize.
7. Defina da seguinte maneira o procedimento associado ao evento OnDestroy do formulrio,
para liberar a memria alocada para o objeto MeuBitmap:
procedure TFormInterativo.FormDestroy(Sender: TObject);
begin
MeuBitmap.Free;
end;
Apresenta-se a seguir o cdigo desta unit, aps terem sido feitas as alteraes relacionadas:
unit UnitPaint;
interface
uses
ExtCtrls;
type
TFormInterativo = class(TForm)
Panel1: TPanel;
procedure FormMouseDown(Sender: TObject; Button: TMouseButton;
procedure FormMouseMove(Sender: TObject; Shift: TShiftState; X,
Y: Integer);
procedure FormMouseUp(Sender: TObject; Button: TMouseButton;
procedure FormPaint(Sender: TObject);
procedure FormDestroy(Sender: TObject);
private
public
end;
var
FormInterativo: TFormInterativo;
desenha : boolean;
MeuBitmap : TBitmap;
Areadestino, AreaOrigem : TRect;
implementation
{$R *.DFM}
begin
desenha := False;
MeuBitmap := TBitmap.Create;
end;
begin
desenha := True;
xbase := X;
ybase := y;
xatual := X;
yatual := y;
end;
procedure TFormInterativo.FormMouseMove(Sender: TObject;
begin
xatual := x;
yatual := y;
end;
begin
desenha := False;
xatual := x;
yatual := y;
MeuBitmap.Height := FormInterativo.ClientHeight-Panel1.Height;
MeuBitmap.Width := FormInterativo.ClientWidth;
MeuBitmap.Canvas.CopyRect(AreaDestino,FormInterativo.Canvas,AreaOrigem);
end;
procedure TFormInterativo.FormPaint(Sender: TObject);
begin
FormInterativo.Canvas.CopyRect(AreaDestino,MeuBitmap.Canvas,AreaOrigem);
end;
procedure TFormInterativo.FormDestroy(Sender: TObject);
begin
MeuBitmap.Free;
end;
end.
Pronto! Agora seu desenho no ser mais perdido quando a janela for minimizada ou sobreposta!
Graas ao uso de um objeto da classe TBitmap, garantiu-se a pesistncia do desenho.
MODOS DE MAPEAMENTO
No incio deste captulo, dissemos que as ordenadas crescem de cima para baixo, e voc deve ter
constatado isso ao analisar os valores de Y quando movimentava o mouse no aplicativo desenvolvido
nos tpicos anteriores.
Para alterar as orientaes dos eixos, o posicionamento dos eixos e a escala adotada, devem-se utilizar
as funes de mapeamento existentes na API do Windows.
As funes da GDI da API do Windows operam com as denominadas coordenadas lgicas, que devem
ser convertidas em coordenadas fsicas, ou coordenadas da tela.
Embora as coordenadas fsicas sejam limitadas pelas dimenses em pixels da rea de desenho, nosso
problema pode manipular coordenadas em variadas faixas de valores. O importante que seja possvel
transformar corretamente as coordenadas lgicas em coordenadas fsicas, o que feito usando as funes
de mapeamento de coordenadas da GDI do Windows.
O modo de mapeamento definido utilizando-se a funo SetMapMode da API do Windows. Essa
funo requer como parmetros:
Um handle para o objeto sobre o qual o mapeamento est sendo definido.
Uma constante definindo o modo de mapeamento. Essa constante pode assumir um dos valores
a seguir.
Constante Unidade Lgica Val. Crescentes(X) Val. Crescentes(Y)
MM_TEXT Pixel Para a Direita Para Baixo
MM_LOMETRIC 0.1 mm Para a Direita Para Cima
MM_HIMETRIC 0.01 mm Para a Direita Para Cima
MM_LOENGLISH 0.01 pol. Para a Direita Para Cima
Constante Unidade Lgica Val. Crescentes(X) Val. Crescentes(Y)
MM_HIENGLISH 0.001 pol. Para a Direita Para Cima
MM_TWIPS 1/1440 pol. Para a Direita Para Cima
MM_ISOTROPIC Qualquer (x = y) A definir A definir
MM_ANISOTROPIC Qualquer (x <> y) A definir A definir
Se quisermos, por exemplo, usar o modo de mapeamento MM_LOMETRIC para o canvas do formulrio
usado na aplicao descrita no tpico anterior, devemos empregar uma linha de cdigo como a
mostrada a seguir:
SetMapMode(FormInterativo.Canvas.Handle, MM_LOMETRIC);
Para converter coordenadas de dispositivo em coordenadas lgicas, deve-se utilizar a funo DpToLp,
que recebe como parmetros:
Uma array de variveis do tipo TPoint.
O nmero de elementos da array de variveis do tipo TPoint.
Se voc quiser transformar as coordenadas de um nico ponto, no precisa definir a array basta usar
uma nica varivel do tipo TPoint.
O tipo TPoint usado para representar pontos da tela, e tem dois campos, denominados x e y, que
armazenam as coordenadas do ponto.
Para converter coordenadas lgicas em coordenadas de dispositivo, deve-se utilizar a funo LpToDp,
que recebe como parmetros:
Uma array de variveis do tipo TPoint.
O nmero de elementos da array de variveis do tipo TPoint.
Novamente, se voc quiser transformar as coordenadas de um nico ponto, no precisa definir a array
basta usar uma nica varivel do tipo TPoint.
No caso do exemplo anterior, por exemplo, poderamos redefinir o modo de mapeamento como
MM_LOMETRIC.
Dessa maneira, o procedimento associado ao evento OnMouseMove do formulrio poderia ser reescrito
como mostrado a seguir:
procedure TFormInterativo.FormMouseMove(Sender: TObject; Shift: TShiftState; X,
Y: Integer);
var
pt : TPoint;
begin
pt.x := X;
pt.y := y;
DPToLp(FormInterativo.Canvas.Handle,pt,1);
Panel1.Caption := X = +IntToStr(pt.X)+ Y = +IntToStr(pt.y);
xatual := x;
yatual := y;
end;
Observe que, nesse caso, declarou-se uma varivel local ao procedimento, como mostrado no trecho
de cdigo a seguir:
var
pt : TPoint;
Alm disso, as seguintes linhas de cdigo foram includas, para transformar as coordenadas de dispositivo
em coordenadas lgicas, quando da apresentao dos seus valores para o usurio:
pt.x := X;
pt.y := y;
DPToLp(FormInterativo.Canvas.Handle,pt,1);
Panel1.Caption := X = +IntToStr(pt.X)+ Y = +IntToStr(pt.y);
Os parmetros X e Y dos procedimentos associados aos eventos OnMouseDown, OnMouseMove e OnMouseUp esto sempre definidos
em termos de coordenadas de dispositivo.
Se voc recompilar a aplicao e execut-la novamente, ver que os valores de Y aparecem como
negativos. Isso se deve ao fato de que, nesse modo de mapeamento, o eixo Y dirigido para cima, e
mantivemos nossa origem na extremidade superior esquerda da tela.
Para alterar a posio da origem, devemos utilizar a funo SetViewPortOrgEx.
Essa funo utilizada para definir o posicionamento da origem do sistema de coordenadas fsicas, e
recebe como parmetros:
A coordenada X, em termos de coordenadas de dispositivo, do ponto para o qual dever se
deslocar a origem.
A coordenada Y, em termos de coordenadas de dispositivo, do ponto para o qual dever se
deslocar a origem.
Uma varivel do tipo TPoint, na qual sero armazenadas as coordenadas correntes da origem.
Caso voc no queira utilizar esse parmetro, pode substitu-lo por nil.
Para alterar as dimenses a serem empregadas nas direes X e Y, no caso de se usar os modos de
mapeamento MM_ISOTROPIC e MM_ANISOTROPIC, devem-se empregar as funes SetWindowExtEx
e SetViewportExtEx descritas a seguir.
FUNES PARA TRANSFORMAO DE COORDENADAS
As funes apresentadas a seguir permitem mapear uma rea retangular (Window) em outra (ViewPort).
FUNO SETWINDOWEXTEX
Essa funo recebe como parmetros:
A extenso horizontal, em coordenadas lgicas, utilizada no mapeamento.
A extenso vertical, em coordenadas lgicas, utilizada no mapeamento.
Uma varivel do tipo TPoint, que armazenar os valores correntes das extenses horizontal e
vertical. Caso voc no queira utilizar esse parmetro, pode substitu-lo por nil.
FUNO SETVIEWPORTEXTEX
A extenso horizontal, em coordenadas de dispositivo, utilizada no mapeamento.
A extenso vertical, em coordenadas de dispositivo, utilizada no mapeamento.
Uma varivel do tipo TPoint, que armazenar os valores correntes das extenses horizontal e
vertical. Caso voc no queira utilizar esse parmetro, pode substitu-lo por nil.
CAPTULO 30 TCNICAS DE IMPRESSO
Captulo
Tcnicas de Impresso
30
Conforme descrito no captulo anterior, uma das principais diferenas entre o sistema operacional
Windows e o antigo DOS que, enquanto este baseado em caracteres, o primeiro constitui uma
interface grfica em que at mesmo os caracteres so desenhados. E isso se aplica no apenas tela do
monitor, mas tambm superfcie do papel no qual sero impressas informaes de forma permanente.
Assim como ocorre com a tela, o Windows tambm trata uma pgina a ser impressa como uma superfcie
de desenho, isto , um Canvas.
As funes relacionadas s tarefas de impresso do Windows tambm esto reunidas na biblioteca de
funes denominada GDI Graphical Device Interface. Nesse caso, a utilizao dessas funes tambm
requer, normalmente, um nmero que identifica o objeto sobre o qual a funo vai atuar, nmero este
denominado handle do objeto.
KNOW-HOW EM: IMPRESSO DIRETA NO WINDOWS
PR-REQUISITOS
Fundamentos da programao orientada a objetos em Delphi.
METODOLOGIA
Apresentao do problema: Utilizao das principais propriedades e mtodos da classe TPrinter.
TCNICA
Apresentao dos procedimentos necessrios impresso direta no Windows, utilizando as propriedades e mtodos da classe TPrinter.
Existem situaes em que os componentes e geradores de relatrios no atendem s necessidades
especficas das nossas aplicaes. Nesse caso, as rotinas de codificao devem ser feitas pelo prprio
desenvolvedor.
Como para o sistema operacional Windows a superfcie do papel tambm considerada uma superfcie
de desenho, o Delphi disponibiliza uma classe denominada TPrinter, que representa a impressora
configurada no sistema, e que possui uma propriedade chamada Canvas, que um objeto da classe
TCanvas, e que representa a superfcie do papel no qual ser feita a impresso.
Alm de fornecer a classe TPrinter, o Delphi tambm disponibiliza um objeto dessa classe, chamado
Printer, e declarado na unit Printers. Na realidade, o que a unit Printers fornece uma funo chamada
Printer que retorna um objeto da classe TPrinter, mas voc pode tratar Printer como um objeto da
classe TPrinter, que o tipo retornado por essa funo.
Dessa maneira, para usar um objeto da classe TPrinter, basta incluir a unit Printers na clusula uses da
unit responsvel pela impresso.
Para criar o desenho, basta usar os mtodos da classe TCanvas, da mesma maneira que se faz em um
formulrio.
Nesse caso, no entanto, como a altura do papel finita, voc precisa controlar se a impresso est
sendo feita dentro dos limites da pgina, bem como controlar o incio e o encerramento dos trabalhos
de impresso. Isso ser feito utilizando-se as propriedades e mtodos da classe TPrinter, a serem descritas
nos prximos tpicos.
PRINCIPAIS PROPRIEDADES DA CLASSE TPRINTER
Dentre as principais propriedades da classe TPrinter, destacam-se:
ABORTED
Essa propriedade definida como uma varivel booleana, e define se um trabalho de impresso foi
abortado.
CANVAS
Essa propriedade , na realidade, um objeto da classe TCanvas, sendo utilizado para representar a
superfcie de impresso.
COPIES
Essa propriedade declarada como uma varivel inteira, e retorna o nmero de cpias impressas pelo
dispositivo.
FONTS
Essa propriedade definida como um objeto da classe TStrings, e retorna a lista com as fontes disponveis
para a impressora default do sistema.
ORIENTATION
Essa propriedade, declarada como uma varivel do tipo TPrinterOrientation, define a orientao da
impresso na pgina, podendo assumir os valores poPortrait (impresso vertical) e poLandscape
(impresso horizontal), valores definidos para esse tipo enumerado, como reproduzido a seguir:
type TPrinterOrientation = (poPortrait, poLandscape);
PAGEHEIGHT
Essa propriedade declarada como uma varivel inteira, e define a altura da pgina (em pixels).
PAGENUMBER
Essa propriedade declarada como uma varivel inteira, e retorna o nmero de pginas j impressas,
sendo o seu valor incrementado em uma unidade a cada chamada do mtodo NewPage da classe.
PAGEWIDTH
Essa propriedade declarada como uma varivel inteira, e define a largura da pgina a ser impressa
(em pixels).
PRINTERINDEX
Essa propriedade declarada como uma varivel inteira, e retorna o ndice do elemento da lista de
strings definida pela propriedade Printers que corresponde impressora selecionada no sistema
operacional. Para usar a impressora default do sistema, basta atribuir o valor -1 a essa propriedade.
PRINTERS
Essa propriedade definida como um objeto da classe TStrings, e retorna a lista com a identificao das
impressoras instaladas no sistema, sendo o ndice da impressora selecionada no sistema definido pela
propriedade PrinterIndex.
Conforme descrito anteriormente, quando o valor da PrinterIndex for igual a -1, ser usada a impressora
default do sistema.
PRINTING
Essa propriedade declarada como uma varivel booleana, e define se est se realizando um trabalho
de impresso.
TITLE
Essa propriedade declarada como uma varivel do tipo string, que define o ttulo a ser exibido
no gerenciador de impresso do Windows quando o trabalho de impresso corrente estiver sendo
processado.
PRINCIPAIS MTODOS DA CLASSE TPRINTER
Dentre os principais mtodos da classe TPrinter, destacam-se:
BEGINDOC
Declarao
procedure BeginDoc;
Esse mtodo deve ser chamado antes de se iniciar a impresso. Todo cdigo de impresso dever ser
colocado entre chamadas aos mtodos BeginDoc e EndDoc (a ser visto a seguir).
ENDDOC
Declarao
procedure EndDoc;
Esse mtodo deve ser chamado aps a ltima linha do cdigo que define um trabalho de impresso.
Na realidade, a impresso efetivamente s se inicia aps uma chamada a esse mtodo.
NEWPAGE
Declarao
procedure NewPage;
Esse mtodo inicia a impresso de uma nova pgina, e incrementa em uma unidade o valor da
propriedade PageNumber.
EXEMPLO DE UTILIZAO DA CLASSE TPRINTER
Apresentamos a seguir um exemplo que exibe as caractersticas de cada uma das impressoras instaladas
no sistema, usando-se para isso as propriedades e mtodos da classe TPrinter.
CRIANDO A INTERFACE DA APLICAO
Para criar a interface desse aplicativo-exemplo, voc deve executar os seguintes procedimentos:
1. Selecione o item New Application do menu File, para iniciar o desenvolvimento de uma nova
aplicao.
2. Defina os seguintes valores para as principais propriedades do formulrio principal (e nico)
dessa aplicao-exemplo:
Name: FormImpressoras
Width: 470
Height: 290
Caption: Caractersticas das Impressoras do Sistema
3. Inclua quatro labels nesse formulrio, e atribua os seguintes valores s suas principais propriedades:
Name: LabelImpressoras
Left: 25
Top: 46
Width: 162
Height: 13
Caption: Impressoras Instaladas no Sistema
Name: LabelAltura
Left: 216
Top: 94
Width: 142
Height: 13
Caption: Altura Definida Para a Pgina:
Name: LabelLargura
Left: 216
Top: 126
Width: 151
Height: 13
Caption: Largura Definida Para a Pgina:
Name: LabelFontes
Left: 25
Top: 94
Width: 141
Height: 13
Caption: Fontes Instaladas no Sistema:
4. Inclua um componente ListBox nesse formulrio, e atribua os seguintes valores s suas principais
propriedades:
Name: ListBoxFontes
Left: 25
Top: 126
Width: 176
Height: 97
ItemHeight: 13
Sorted: True
5. Inclua um componente ComboBox nesse formulrio, e atribua os seguintes valores s suas
Name: ComboBoxImpressoras
Left: 216
Top: 42
Width: 209
Height: 21
ItemHeight: 13
6. Inclua um componente BitBtn nesse formulrio, e atribua os seguintes valores s suas principais
propriedades:
Name: BotaoFechar
Left: 283
Top: 162
Width: 75
Height: 25
Caption: &Fechar
Kind: bkClose
Seu formulrio dever ficar com o aspecto apresentado na figura a seguir:
Figura 30.1: Aspecto do formulrio criado para exibir as caractersticas das impressoras instaladas no sistema.
CODIFICANDO A APLICAO
Para codificar esse aplicativo-exemplo, voc deve executar os seguintes procedimentos:
1. Incluir a unit Printers na clusula Uses da unit associada a esse formulrio.
2. Definir da seguinte maneira o procedimento associado ao evento OnCreate do formulrio:
procedure TFormImpressoras.FormCreate(Sender: TObject);
begin
ComboBoxImpressoras.Items := Printer.Printers;
ListBoxFontes.Items := Printer.Fonts;
LabelLargura.caption := Largura Definida Para a Pgina:
+IntToStr(Printer.PageWidth);
LabelAltura.caption := Altura Definida Para a Pgina:
+IntToStr(Printer.PageHeight);
ComboBoxImpressoras.ItemIndex := Printer.PrinterIndex;
end;
Esse procedimento atribui propriedade Items do ComboBox (que um objeto da classe TStrings) a
lista de strings armazenada na propriedade Printers do objeto Printer, o que feito mediante a incluso
da seguinte linha de cdigo:
Em seguida, atribui propriedade Items do ListBox (que um objeto da classe TStrings) a lista de
strings armazenada na propriedade Fonts do objeto Printer, o que feito mediante a incluso da
Alm disso, o valor da propriedade Caption dos Labels LabelLargura e labelAltura atualizado para
exibir, respectivamente, a largura e a altura da pgina definida para a impressora selecionada no sistema,
o que feito mediante a incluso das seguintes linhas de cdigo:
LabelLargura.caption := Largura Definida Para a Pgina: +IntToStr(Printer.PageWidth);
LabelAltura.caption := Altura Definida Para a Pgina: +IntToStr(Printer.PageHeight);
Por fim, atribui-se o valor da propriedade PrinterIndex do objeto Printer propriedade ItemIndex do
ComboBox, para que este exiba o nome da impressora selecionada no sistema, o que feito mediante
a incluso das seguintes linhas de cdigo:
3. Definir da seguinte maneira o procedimento associado ao evento OnChange do ComboBox:
procedure TFormImpressoras.ComboBoxImpressorasChange(Sender: TObject);
begin
Printer.PrinterIndex := ComboBoxImpressoras.ItemIndex;
LabelLargura.caption := Largura Definida Para a Pgina:
+IntToStr(Printer.PageWidth);
LabelAltura.caption := Altura Definida Para a Pgina:
+IntToStr(Printer.PageHeight);
end;
A codificao desse procedimento muito semelhante do procedimento anterior, razo pela qual
no nos deteremos muito em coment-las.
A nica alterao, nesse caso, est no fato de que a impressora do sistema definida de acordo com a
seleo feita pelo usurio no ListBox, mediante a incluso da seguinte linha de cdigo:
Apresentamos a seguir a codificao completa da unit associada a esse formulrio.
unit UnitPrinters;
interface
uses
StdCtrls, Buttons;
type
TFormImpressoras = class(TForm)
ComboBoxImpressoras: TComboBox;
LabelImpressoras: TLabel;
LabelAltura: TLabel;
LabelLargura: TLabel;
ListBoxFontes: TListBox;
LabelFontes: TLabel;
procedure ComboBoxImpressorasChange(Sender: TObject);
private
public
end;
var
FormImpressoras: TFormImpressoras;
implementation
Uses Printers;
{$R *.DFM}
procedure TFormImpressoras.FormCreate(Sender: TObject);
begin
end;
procedure TFormImpressoras.ComboBoxImpressorasChange(Sender: TObject);
begin
end;
end.
IMPRIMINDO O CONTEDO EXIBIDO POR UM COMPONENTE MEMO
Neste tpico, mostraremos os procedimentos necessrios impresso do contedo exibido por um
componente Memo.
Ser utilizado o exemplo criado no captulo referente manipulao de arquivos de texto, ao qual ser
acrescentada a capacidade de impresso do contedo exibido pelo componente Memo1.
1. Selecione o item Open Project do menu File, para abrir o projeto ProjetoMemo.dpr, criado
no captulo.
2. Redefina, da seguinte maneira, o menu Arquivo do formulrio principal da aplicao:
Name: Caption
Novo: &Novo
Abrir: &Abrir
Salvar: &Salvar
SalvarComo: Salvar &Como
Separador1: -
ConfiguraImpressora: Configurar &Impressora
Imprimir: &Imprimir
Fechar: &Fechar
3. Inclua um componente PrinterSetupDialog no formulrio principal da aplicao, e mantenha
os valores default das suas propriedades.
Para codificar esse aplicativo-exemplo, voc deve executar os seguintes procedimentos:
1. Incluir a unit Printers na clusula Uses da unit associada a esse formulrio.
2. Definir da seguinte maneira o procedimento associado ao evento OnClick do item Configurar
Impressora, do menu Arquivo:
PrinterSetupDialog1.Execute;
Essa linha de cdigo faz com que a caixa de dilogo padro para configurao de impressora do Win-
dows seja exibida, de forma a permitir a configurao desejada.
3. Definir da seguinte maneira o procedimento associado ao evento OnClick do item Imprimir
do menu Arquivo:
procedure TFormMemo.ImprimirClick(Sender: TObject);
var
i, linhaatual : integer;
begin
Printer.BeginDoc;
linhaatual := 5*Printer.Canvas.TextHeight(A);
for i := 0 to Memo1.Lines.Count-1 do
begin
if (linhaatual + trunc(1.1*Printer.Canvas.TextHeight(A))) >=
Printer.PageHeight
then
begin
Printer.NewPage;
linhaatual := 20;
end;
Printer.Canvas.TextOut(20, linhaatual, Memo1.Lines[i]);
linhaatual := linhaatual + trunc(1.1*Printer.Canvas.TextHeight(A));
end;
Printer.EndDoc;
end;
Inicialmente faz-se uma chamada ao mtodo BeginDoc do objeto Printer, para iniciar o trabalho de impresso.
Em seguida esse procedimento define um valor para a margem superior da pgina, igual altura de
cinco caracteres, mediante a incluso da seguinte linha de cdigo, na qual o mtodo TextHeight da
propriedade Canvas do Objeto Printer utilizado para obter a altura de um caractere (que vai depender
da fonte correntemente selecionada para a impressora).
Em seguida, o procedimento realiza uma iterao por todas as linhas de texto exibidas pelo componente
Memo (cada uma correspondendo a uma string). Em cada iterao, verifica-se inicialmente se a distncia
ao topo da pgina superior a um valor predefinido, o que feito na seguinte linha de cdigo:
if (linhaatual + trunc(1.1*Printer.Canvas.TextHeight(A))) >= Printer.PageHeight then
Caso isso ocorra, deve-se iniciar uma nova pgina (o que feito mediante uma chamada ao mtodo
NewPage do objeto Printer), reinicializando o valor da varivel linhaatual.
Ao trmino de dada iterao do looping, imprime-se a linha corrente do componente Memo e atualiza-
se o valor da varivel linhaatual, o que feito mediante a incluso das seguintes linhas de cdigo:
Conforme pode ser verificado, a impresso feita usando-se o mtodo TextOut do Canvas.
Para finalizar, faz-se uma chamada ao mtodo EndDoc do objeto Printer, para encerrar o trabalho de impresso.
Apresenta-se a seguir o cdigo completo da unit associada ao formulrio, aps terem sido feitas as
alteraes descritas anteriormente:
unit UnitMemo;
interface
uses
Menus, StdCtrls, ComCtrls;
type
TFormMemo = class(TForm)
MainMenu1: TMainMenu;
Arquivo: TMenuItem;
Abrir: TMenuItem;
Salvar: TMenuItem;
SalvarComo: TMenuItem;
N1: TMenuItem;
Fechar: TMenuItem;
Fonte1: TMenuItem;
Negrito: TMenuItem;
Italico: TMenuItem;
Sublinhado: TMenuItem;
Cortada: TMenuItem;
N2: TMenuItem;
SelecionarCor: TMenuItem;
Memo1: TMemo;
OpenDialog1: TOpenDialog;
SaveDialog1: TSaveDialog;
Novo: TMenuItem;
StatusBar1: TStatusBar;
ConfiguraImpressora: TMenuItem;
Imprimir: TMenuItem;
PrinterSetupDialog1: TPrinterSetupDialog;
procedure AbrirClick(Sender: TObject);
procedure NovoClick(Sender: TObject);
procedure SalvarComoClick(Sender: TObject);
procedure SalvarClick(Sender: TObject);
procedure FecharClick(Sender: TObject);
procedure Memo1KeyPress(Sender: TObject; var Key: Char);
procedure NegritoClick(Sender: TObject);
procedure ItalicoClick(Sender: TObject);
procedure SublinhadoClick(Sender: TObject);
procedure CortadaClick(Sender: TObject);
procedure SelecionarCorClick(Sender: TObject);
procedure ImprimirClick(Sender: TObject);
private
public
end;
var
FormMemo: TFormMemo;
Arquivoalterado: boolean;
ArquivoAtual : string;
implementation
Uses Printers;
{$R *.DFM}
procedure TFormMemo.AbrirClick(Sender: TObject);
begin
if OpenDialog1.Execute = true
then
begin
if arquivoalterado then
begin
if MessageDlg(Deseja Salvar Alteraes no Arquivo Atual?,mtConfirmation,
mbOkCancel,0)= mrOk
then
Memo1.Lines.SaveToFile(arquivoatual);
end;
arquivoatual := OpenDialog1.FileName;
Memo1.Lines.LoadFromFile(arquivoAtual);
arquivoalterado := False;
Negrito.Checked := fsbold in Memo1.Font.Style;
Italico.Checked := fsItalic in Memo1.Font.Style;
Cortada.Checked := fsStrikeOut in Memo1.Font.Style;
Sublinhado.Checked := fsUnderline in Memo1.Font.Style;
StatusBar1.Panels[0].Text := Nome do Arquivo: + arquivoatual;
end;
end;
procedure TFormMemo.NovoClick(Sender: TObject);
begin
begin
mbOkCancel,0)= mrOk
then
end;
arquivoatual := ;
Memo1.Lines.Clear;
Negrito.Checked := False;
Italico.Checked := False;
Cortada.Checked := False;
Sublinhado.Checked := False;
Memo1.Font.Style := Memo1.Font.Style - [fsBold];
Memo1.Font.Style := Memo1.Font.Style - [fsItalic];
Memo1.Font.Style := Memo1.Font.Style - [fsUnderline];
Memo1.Font.Style := Memo1.Font.Style - [fsStrikeOut];
StatusBar1.Panels[0].Text := Nome do Arquivo:;
end;
procedure TFormMemo.SalvarComoClick(Sender: TObject);
begin
if SaveDialog1.Execute = true
then
begin
arquivoatual := SaveDialog1.FileName;
Memo1.Lines.SaveToFile(arquivoAtual);
end;
end;
procedure TFormMemo.SalvarClick(Sender: TObject);
begin
if arquivoatual =
then
SalvarComoClick(Self)
else
begin
end;
end;
procedure TFormMemo.FecharClick(Sender: TObject);
begin
if arquivoalterado = True
then
begin
begin
mbOkCancel,0)= mrOk
then
if arquivoatual =
then
else
end;
end;
end;
procedure TFormMemo.Memo1KeyPress(Sender: TObject; var Key: Char);
begin
Arquivoalterado := True;
end;
procedure TFormMemo.NegritoClick(Sender: TObject);
begin
Negrito.Checked := not Negrito.Checked;
if Negrito.Checked
then
Memo1.Font.Style := Memo1.Font.Style + [fsBold]
else
arquivoalterado := True;
end;
procedure TFormMemo.ItalicoClick(Sender: TObject);
begin
Italico.Checked := not Italico.Checked;
if Italico.Checked
then
Memo1.Font.Style := Memo1.Font.Style + [fsItalic]
else
end;
procedure TFormMemo.SublinhadoClick(Sender: TObject);
begin
Sublinhado.Checked := not Sublinhado.Checked;
if Sublinhado.Checked
then
Memo1.Font.Style := Memo1.Font.Style + [fsUnderline]
else
end;
procedure TFormMemo.CortadaClick(Sender: TObject);
begin
Cortada.Checked := not Cortada.Checked;
if Cortada.Checked
then
Memo1.Font.Style := Memo1.Font.Style + [fsStrikeOut]
else
end;
procedure TFormMemo.SelecionarCorClick(Sender: TObject);
begin
if ColorDialog1.Execute = True
then
begin
Memo1.Font.Color := ColorDialog1.Color;
end;
end;
procedure TFormMemo.ImprimirClick(Sender: TObject);
var
i, linhaatual : integer;
begin
Printer.BeginDoc;
for i := 0 to Memo1.Lines.Count-1 do
begin
if (linhaatual + trunc(1.1*Printer.Canvas.TextHeight(A))) >= Printer.PageHeight
then
begin
Printer.NewPage;
linhaatual := 20;
end;
end;
Printer.EndDoc;
end;
end.
claro que muitas caractersticas adicionais poderiam ser implementadas a este exemplo. O objetivo,
no entanto, foi mostrar os principais procedimentos necessrios impresso direta no Windows, usando-
se o objeto Printer.
CAPTULO 31 CRIAO DE DLLS
Captulo
Criao de DLLs
31
Neste captulo sero apresentados os procedimentos necessrios criao de bibliotecas de vinculao
dinmica DLLs com o Borland Delphi 7.
Sero apresentados os procedimentos necessrios criao de DLLs em Delphi, bem como a sua utilizao.
KNOW-HOW EM: CRIAO DE DLLS
PR-REQUISITOS
Experincia em programao orientada a objetos com a linguagem Object Pascal.
METODOLOGIA
Apresentao do problema: Criao de uma DLL, a ser compartilhada entre diversos aplicativos.
TCNICA
Apresentao dos procedimentos necessrios criao de uma DLL.
INTRODUO
As bibliotecas de vinculao dinmica (Dynamic Link Libraries DLLs) permitem que um conjunto de
funes desenvolvidas em uma linguagem possa ser utilizado em programas, incluindo-se programas
desenvolvidos em outras linguagens.
Voc pode, por exemplo, criar uma DLL em Delphi com um conjunto de funes e utiliz-la em
aplicativos desenvolvidos em C++ ou Visual Basic, por exemplo.
PROCEDIMENTOS BSICOS NECESSRIOS CRIAO DE UMA DLL EM DELPHI
Para iniciar a criao de uma DLL, proceda da seguinte maneira:
1. Selecione o item New, do menu File, para exibir a caixa de dilogo New Items. Nessa caixa de
dilogo, selecione o item DLL como mostrado na figura a seguir e depois o boto OK, para
gerar o cdigo principal da DLL.
Figura 31.1: Selecionando o item DLL na caixa de dilogo New Items.
2. Ser ento gerado o cdigo principal da DLL, reproduzido a seguir:
library Project1;
{ Important note about DLL memory management: ShareMem must be the
first unit in your librarys USES clause AND your projects (select
Project-View Source) USES clause if your DLL exports any procedures or
functions that pass strings as parameters or function results. This
applies to all strings passed to and from your DLLeven those that
are nested in records and classes. ShareMem is the interface unit to
the BORLNDMM.DLL shared memory manager, which must be deployed along
with your DLL. To avoid using BORLNDMM.DLL, pass string information
using PChar or ShortString parameters. }
uses
SysUtils,
Classes;
{$R *.RES}
begin
end.
Inicialmente exibido um comentrio informando ao desenvolvedor que a unit ShareMem deve ser a
primeira unit includa na clusula Uses do cdigo-fonte do seu arquivo de projeto, caso a sua DLL
exporte funes que recebam uma string como parmetro ou que retornem uma string como resultado,
ainda que essas strings estejam embutidas em registros ou classes. Nessa situao, o arquivo
DELPHIMM.DLL deve ser distribudo junto com a sua aplicao.
Para evitar esses inconvenientes, essas strings passadas como parmetros devem ser definidas como
sendo do tipo Pchar ou ShortString (strings com no mximo 255 caracteres).
Apenas a ttulo de exemplificao, vamos criar uma funo que receba como parmetros dois nmeros
reais e retorne o maior deles.
Essa funo pode ser escrita na linguagem Object Pascal como indicado a seguir:
function Max(a, b : double):double;export;stdcall;
begin
if (a > b) then result := a else result := b;
end;
Repare que, nesse caso, foram includas, no cabealho da funo, as palavras reservadas export e stdcall.
A palavra reservada export utilizada para indicar que essa funo ser exportada, isto , poder ser
chamada por outros aplicativos.
A palavra reservada stdcall permite que os aplicativos desenvolvidos em outras linguagens faam
chamadas a essa funo. Isso se deve ao fato de que, no Pascal, a passagem de parmetros feita da
esquerda para a direita, ao passo que, na maioria das outras linguagens de programao, a passagem de
parmetros feita da direita para a esquerda.
Alm disso, o nome das funes a serem exportadas deve ser includo aps a palavra reservada exports,
a ser includa aps a definio das funes. Opcionalmente, poder ser includa a palavra reservada
index, seguida por um nmero (ndice). Dessa maneira, ao ser acessada a partir de outro aplicativo, a
funo poder ser identificada pelo seu nome ou pelo seu ndice.
Aps fazer as alteraes necessrias e salvar o projeto com o nome MaxDLL, nossa DLL ficou com o
aspecto apresentado a seguir:
library Project1;
Project-View Source) USES clause if your DLL exports any procedures or
applies to all strings passed to and from your DLLeven those that
the BORLNDMM.DLL shared memory manager, which must be deployed along
with your DLL. To avoid using BORLNDMM.DLL, pass string information
uses
SysUtils,
Classes;
begin
end;
{$R *.RES}
exports Max Index 1;
begin
end.
Salve este projeto com o nome MaxDLL (este ser o nome do arquivo no qual ser armazenada a
biblioteca de vinculao dinmica MaxDLL.dll).
Uma DLL pode ser compilada da mesma maneira que um projeto de aplicativo e, aps compilada, poder
ser livremente distribuda. Voc no pode, no entanto, executar uma DLL a partir do ambiente de
desenvolvimento do Delphi, selecionando o item Run do menu Run (embora esse item esteja habilitado),
pois uma DLL no uma aplicao (a menos que voc defina um aplicativo como Host, a ser especificado
na caixa de dilogo Run Parameters, exibida quando se seleciona o item Parameters do menu Run).
Entre as palavras reservadas begin e end, que formam o corpo principal da DLL, dever ser inserido
qualquer cdigo a ser executado durante a inicializao da DLL.
Uma DLL pode usar formulrios e objetos definidos em outras units, conforme ser visto posteriormente.
CHAMANDO UMA DLL A PARTIR DE OUTRA APLICAO
Neste tpico ser criada uma aplicao que acesse a funo definida na DLL criada anteriormente.
Essa aplicao ser bastante simples, composta por um nico formulrio no qual sero includas duas
caixas de texto nas quais o usurio dever digitar dois nmeros reais , um boto de comando em
cujo procedimento associado ao evento OnClick ser feita a chamada da funo e um label, no qual
ser exibido o resultado da funo.
Apresentamos, a seguir, o formulrio principal (e nico) da aplicao e a unidade de cdigo a ele associada.
O FORMULRIO PRINCIPAL DA APLICAO
O formulrio principal da aplicao apresentado na figura a seguir:
Figura 31.2: Formulrio principal da aplicao.
ARQUIVO DE CDIGO ASSOCIADO AO FORMULRIO
Apresenta-se a seguir a codificao completa da unit associada ao formulrio.
Arquivo UnitUsaDLL.pas
unit UnitUsaDLL;
interface
uses
StdCtrls, Buttons;
type
TFormUSADLL = class(TForm)
Label1: TLabel;
Edit1: TEdit;
Label2: TLabel;
Edit2: TEdit;
BotaoChamaDLL: TBitBtn;
procedure BotaoChamaDLLClick(Sender: TObject);
private
public
end;
var
FormUSADLL: TFormUSADLL;
implementation
{$R *.DFM}
function Max(a, b : double):double;external MaxDLL;
procedure TFormUSADLL.BotaoChamaDLLClick(Sender: TObject);
var
x, y, resultado : double;
begin
x := StrToFloat(Edit1.Text);
y := StrToFloat(Edit2.Text);
resultado := Max(x,y);
ShowMessage(Valor Mximo +FloatToStr(resultado));
end;
end.
Repare que a funo Max declarada na seo interface e implementada na seo implementation.
Nesse caso, no entanto, informamos que, na realidade, a funo est implementada em uma DLL.
Como no foi informado o diretrio no qual esta DLL est localizada, esta ser procurada no prprio
diretrio da aplicao e no diretrio C:\Windows\SYSTEM.
Execute a aplicao e teste a chamada da funo definida na DLL.
EXIBINDO FORMULRIOS A PARTIR DE UMA DLL
Neste tpico sero apresentados os procedimentos necessrios exibio de uma caixa de dilogo a
partir de uma chamada em uma DLL.
Ser criado um formulrio bastante simples, como indicado na figura a seguir, apenas para ilustrar os
procedimentos adotados. Para criar este formulrio, basta executar os seguintes procedimentos:
1. Selecionar o item New Aplication, do menu File, para criar uma nova aplicao.
2. Altere a propriedade Name do formulrio principal desta aplicao para FormDLL.
3. Defina a propriedade Caption deste formulrio como mostrado na figura a seguir (basta definir
a propriedade Caption como sendo igual ao exibido na barra de ttulos do formulrio mostrado
nesta figura).
4. Inserir um componente Label no formulrio, com a propriedade Caption armazenando o texto
mostrado na figura a seguir,.
5. Inserir um componente BitBtn no formulrio, e definir sua propriedade Kind como bkOk.
Figura 31.3: O formulrio-exemplo.
O arquivo de cdigo associado a esse formulrio ser bastante simples, sem a incluso de nenhum
cdigo especfico, como pode ser constatado a seguir:
unit UnitChamaDLL;
interface
uses
StdCtrls, Buttons;
type
TFormDLL = class(TForm)
Label1: TLabel;
BotaoOk: TBitBtn;
private
public
end;
var
FormDLL: TFormDLL;
implementation
{$R *.DFM}
end.
Vamos incorporar essa unit clusula Uses da nossa DLL e definir, na DLL, o cdigo da funo
MostraDLL, usada para exibir o formulrio, conforme apresentado na listagem a seguir:
library MaxDLL;
View-Project Source) USES clause if your DLL exports any procedures or
applies to all strings passed to and from your DLL even those that
the DELPHIMM.DLL shared memory manager, which must be deployed along
with your DLL. To avoid using DELPHIMM.DLL, pass string information
uses
SysUtils,
Classes,
UnitChamaDLL in UnitChamaDLL.pas {FormDLL};
begin
end;
procedure MostraDLL;export;stdcall;
begin
FormDLL := TFormDLL.Create(nil);
FormDLL.ShowModal;
FormDLL.Free;
end;
exports
Max index 1,
MostraDLL index 2;
begin
end.
Pronto! A partir de agora, nosso formulrio poder ser exibido a partir de qualquer aplicao desenvolvida
para o ambiente Windows que acesse essa DLL. Basta que se inclua, na seo implementation da unit
a partir da qual ser chamado este procedimento, a seguinte linha de cdigo:
function MostraDLL;external MaxDLL;
CARREGAMENTO EXPLCITO DE UMA DLL
Para caregar explicitamente uma DLL a partir de uma aplicao, deve-se usar a funo LoadLibrary, que
recebe como parmetro o nome da DLL e cujo valor retornado deve ser armazenado em uma varivel do
tipo HModuke, varivel esta que posteriormente ser passada como parmetro em uma chamada da
funo FreeLibrary, que descarregar a DLL.
CAPTULO 32 MANIPULAO DE ARQUIVOS, STRINGS E FONTES EM DELPHI
Captulo
Manipulao de Arquivos,
Strings e Fontes em Delphi
32
Por mais que as linguagens de programao tenham evoludo, a maioria dos sistemas desenvolvidos
na atualidade ainda necessita manipular diretamente arquivos e strings.
A fim de facilitar o trabalho do desenvolvedor, o Delphi fornece um amplo conjunto de funes e
componentes que facilitam a manipulao desses tipos de dados.
Neste captulo, sero apresentadas as principais funes, procedimentos e componentes que simplificam
a manipulao de arquivos e strings em aplicaes desenvolvidas em Delphi.
KNOW-HOW EM: MANIPULAO DE ARQUIVOS
PR-REQUISITOS
Experincia em programao orientada a objetos em Delphi.
METODOLOGIA
Apresentao das funes, procedimentos, classes e componentes que permitem a manipulao de arquivos em Delphi.
MANIPULAO DIRETA DE ARQUIVOS ASSOCIADOS A UMA VARIVEL
O Delphi permite a manipulao direta de arquivos da mesma maneira que nas antigas verses da
linguagem Pascal.
Inicialmente deve-se declarar uma varivel que defina o tipo de dado manipulado pelo arquivo, incluindo-se
uma linha de cdigo com a seguinte sintaxe na seo var da unit:
F : Tipo;
Onde Tipo pode ser:
TextFile, para arquivos de texto ASCII.
File Of < tipo predefinido>, para arquivos binrios que armazenam dados de um determinado
tipo. O tipo predefinido pode ser um tipo de varivel ou uma classe.
File, para arquivos binrios que armazenem informaes genricas em formato de dado, no
associadas a um tipo especfico de dado.
Apresenta-se a seguir uma relao das principais funes utilizadas na manipulao direta de arquivos
associados a uma varivel.
APPEND
Declarao
Esse procedimento, declarado na unit System, abre o arquivo associado varivel F e posiciona o ponteiro
de leitura/gravao no final do arquivo.
ASSIGNFILE
Para verificar se o arquivo possui um dos seguintes atributos, basta fazer uma operao lgica and
entre o valor retornado pela funo e a constante que representa cada um dos atributos.
FILEGETDATE
Declarao
function FileGetDate(Handle: Integer): Integer;
Essa funo, declarada na unit SysUtils, retorna a data de um arquivo (no formato data-hora do DOS)
cujo handle passado como primeiro parmetro na forma de um valor inteiro. Esse handle retornado
por uma chamada funo FileOpen, utilizada para abrir o arquivo.
FILEOPEN
Declarao
function FileOpen(const FileName: string; Mode: Integer): Integer;
Essa funo, declarada na unit SysUtils, abre um arquivo cujo nome passado como primeiro parmetro
na forma de uma string, e com o modo de abertura passado como segundo parmetro, retornando um
inteiro que pode ser usado como um handle para o arquivo.
FILESEARCH
Declarao
function FileSearch(const Name, DirList: string): string;
Essa funo, declarada na unit SysUtils, recebe como parmetro duas strings, sendo que a primeira deve
definir o nome do arquivo a ser pesquisado e a segunda deve definir uma lista de diretrios (separados por
ponto-e-vrgula) nos quais deve ser verificada a existncia do arquivo.
Essa funo retorna o valor True, se o arquivo for encontrado na lista de diretrios especificada como
segundo parmetro, e false, em caso contrrio.
Constante Significado
faReadOnly Arquivo apenas de leitura
faHidden Arquivo Oculto
faSysFile Arquivo de sistema
faVolumeID Identificador de dispositivo
faDirectory Diretrio
faArchive Arquivo comum
faAnyFile Qualquer arquivo
FILESETATTR
Declarao
function FileSetAttr(const FileName: string; Attr: Integer): Integer;
Essa funo, declarada na unit SysUtils, recebe como parmetro uma string com o nome do arquivo
e um valor inteiro, que definir o novo valor do atributo (esse valor dever ser resultado de uma
operao entre as vrias constantes usadas para representar os atributos do arquivo, descritas
anteriormente para a funo FileGetAttr, descrita anteriormente) e retorna um valor nulo se a operao
no for realizada com sucesso.
FILESETDATE
Declarao
function FileSetDate(Handle: Integer; Age: Integer): Integer;
Essa funo, declarada na unit SysUtils, recebe como parmetro um handle para um arquivo e um
valor inteiro que representa a data a ser atribuda ao arquivo, que deve estar no formato data-hora do
DOS. A funo DateTimeToFileDate pode ser usada para converter um valor do tipo TDateTime no
formato data-hora do DOS.
FILEWRITE
Declarao
function FileWrite(Handle: Integer; const Buffer; Count: Integer): Integer;
Essa funo, declarada na unit SysUtils, recebe como parmetro um handle para um arquivo e grava
nesse arquivo uma quantidade igual a Count de Bytes (passada como terceiro parmetro) armazenados
em um buffer passado como segundo parmetro.
FINDCLOSE
Declarao
procedure FindClose(var F: TSearchRec);
Esse procedimento, declarado na unit SysUtils, recebe como parmetro uma varivel do tipo TSearchRec
e libera a memria alocada por uma chamada funo FindFirst.
FINDFIRST
Declarao
function FindFirst(const Path: string; Attr: Integer; var F: TSearchRec): Integer;
Essa funo, declarada na unit SysUtils, recebe como parmetros uma string que define um diretrio, um
valor inteiro que define um conjunto de atributos possveis para um arquivo, e uma varivel do tipo
TSearchRec na qual sero retornadas as informaes referentes ao primeiro arquivo encontrado que
atenda aos requisitos especificados. O tipo TSearchRec definido da seguinte maneira na unit SysUtils:
TSearchRec: record
Time: Integer;
Size: Integer;
Attr: Integer;
Name: TFileName;
ExcludeAttr: Integer;
FindHandle: THandle;
FindData: TWin32FindData;
end;
onde TFileName definido como um nome alternativo para uma string, como mostrado na linha de
cdigo a seguir.
TFileName = string;
FINDNEXT
Declarao
function FindNext(var F: TSearchRec): Integer;
Essa funo, declarada na unit SysUtils, retorna o prximo arquivo que atenda s condies especificadas
por uma chamada funo FindFirst.
O parmetro TSearchRec deve ser o mesmo que foi passado na chamada funo FindFirst.
FORCEDIRECTORIES
Declarao
procedure ForceDirectories(Dir: string);
Esse procedimento, declarado na unit FileCtrl, cria o diretrio cujo path completo passado como
parmetro na forma de uma string (incluindo os diretrios que formam o path caso estes no existam).
GETCURRENTDIR
Declarao
Essa funo, declarada na unit SysUtils, retorna na forma de uma string o diretrio corrente para a aplicao.
GETDIR
Declarao
Esse procedimento, declarado na unit SysUtils, retorna na varivel S (passada por referncia) o diretrio
corrente do drive passado como primeiro parmetro.
O parmetro D pode armazenar um dos valores apresentados na tabela a seguir.
Valor Drive
0 Default
1 A
2 B
continua
MKDIR
Declarao
Esse procedimento, declarado na unit SysUtils, cria um novo diretrio, cujo path completo passado
como parmetro na forma de uma string.
REMOVEDIR
Declarao
Essa funo, declarada na unit SysUtils, remove o diretrio cujo path passado como parmetro na
forma de uma string, desde que esse diretrio esteja vazio.
Ao contrrio do procedimento RmDir, apresentado a seguir, essa funo retorna True se o diretrio for
removido (e False, em caso contrrio).
RENAMEFILE
Declarao
Esse procedimento, declarado na unit SysUtils, renomeia o arquivo cujo nome passado como
primeiro parmetro, atribuindo-lhe o nome passado como segundo parmetro (ambos definidos na
forma de uma string).
RMDIR
Declarao
Esse procedimento, declarado na unit SysUtils, remove o diretrio cujo path passado como parmetro
na forma de uma string, desde que esse diretrio esteja vazio.
SETCURRENTDIR
Declarao
Essa funo, declarada na unit SysUtils, define como diretrio corrente aquele passado como parmetro
na forma de uma string, retornando True caso a operao tenha sido realizada com sucesso.
KNOW-HOW EM: MANIPULAO DE STRINGS
PR-REQUISITOS
Experincia em programao orientada a objetos em Delphi.
Valor Drive
3 C
4 D
continuao
METODOLOGIA
Apresentao das funes, procedimentos, classes e componentes que permitem a manipulao de strings em Delphi.
O Delphi suporta vrios tipos de strings, conhecidos como:
Caracteres de um nico byte (Single-Byte Character Set SBCS). Nesse tipo, cada byte de uma
string representa um caractere.
Caracteres de mltiplos bytes (Multiple-Byte Character Set MBCS). Nesse tipo, alguns caracteres
so representados por mais de um byte (usados principalmente em idiomas de pases da sia).
Caracteres Unicode. Nesse tipo, todos os caracteres so representados por dois bytes.
Em geral, as funes cujo nome comeam com a palavra Ansi se referem a strings em que os caracteres
so tratados como caracteres de mltiplos bytes.
Apresenta-se a seguir uma relao das principais funes utilizadas na manipulao direta de strings
em Delphi.
PRINCIPAIS FUNES PARA A MANIPULAO DE STRINGS
ADJUSTLINEBREAKS
Declarao
Essa funo, declarada na unit SysUtils, ajusta todas as seqncias de retorno de carro (CR) / avano de
linha (LF) definidas na string passada como parmetro, retornando uma string com os ajustes necessrios
(a string original no alterada).
Qualquer retorno de carro que no seguido por um avano de linha, ou qualquer avano de linha
no precedido por um retorno de carro, corrigido.
Alm disso, uma seqncia LF/CR corrigida para CR/LF.
ANSICOMPARESTR
Declarao
Essa funo, declarada na unit SysUtils, compara duas strings passadas como parmetros, retornando
um inteiro positivo, nulo ou negativo de acordo com as seguintes regras:
Condio Resultado
S1 > S2 > 0
S1 < S2 < 0
S1 = S2 = 0
Essa funo considera o fato de os caracteres estarem em caixa alta ou caixa baixa. Em geral, na maioria
dos pases, a instalao local do Windows considera caracteres minsculos precedendo os maisculos
(ao contrrio do que ocorre com o cdigo ASCII desses mesmos caracteres). Caso voc queira considerar
a ordenao feita pelo cdigo ASCII, deve utilizar a funo CompareStr.
ANSICOMPARETEXT
Declarao
Essa funo, declarada na unit SysUtils, idntica funo AnsiCompareStr, exceto pelo fato de no
considerar se as letras esto em caixa alta ou em caixa baixa.
ANSIEXTRACTQUOTEDSTR
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros uma string de terminao nula, e um
caractere que representa um delimitador.
Caso esse caractere delimitador no exista como primeiro caractere da string, essa funo retorna uma
string vazia. Em caso contrrio, retorna a string sem os delimitadores inicial e final da string. Alm
disso, pares de delimitadores internos string passada como parmetro so substitudos por um nico
caractere delimitador na string retornada como resultado da chamada da funo.
ANSILOWERCASE
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetro uma string e retorna como resultado a
mesma string com todos os seus caracteres em caixa baixa (minsculos).
ANSIPOS
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetro duas strings e verifica se a primeira
uma substring da segunda. Em caso positivo, retorna a posio ocupada pelo primeiro caractere da
substring. Em caso negativo, retorna o valor 0.
ANSIQUOTEDSTR
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros uma string e um caractere que representa
um delimitador, acrescentando esse caractere no incio e no final da string. A string assim obtida retorna
como resultado da chamada da funo (a string original no alterada).
ANSIUPPERCASE
Declarao
mesma string com todos os seus caracteres em caixa alta (maisculos).
COMPARESTR
Declarao
Essa funo, declarada na unit SysUtils, compara duas strings passadas como parmetros, retornando
um inteiro positivo, nulo ou negativo de acordo com as seguintes regras:
Essa funo considera o fato de os caracteres estarem em caixa alta ou caixa baixa e considera a ordenao
dos caracteres feita pelo seu cdigo ASCII.
COMPARETEXT
Declarao
Essa funo, declarada na unit SysUtils, idntica funo CompareStr, exceto pelo fato de no considerar
se as letras esto em caixa alta ou em caixa baixa.
CONCAT
Declarao
Essa funo, declarada na unit System, retorna uma string obtida como resultado da concatenao de
duas ou mais strings passadas como parmetros.
COPY
Declarao
Essa funo, declarada na unit System, recebe como parmetros uma string e dois nmeros inteiros,
retornando como resultado uma string que na realidade uma substring da string passada como parmetro.
A string resultante contm Count caracteres, sendo o primeiro caractere aquele que ocupa, na string
original, a posio definida pelo parmetro Index.
CURRTOSTR
Declarao
Essa funo, definida na unit SysUtils, converte uma valor que representa um valor monetrio, passado
como parmetro, em uma string.
Condio Resultado
S1 > S2 > 0
S1 < S2 < 0
S1 = S2 = 0
DATETOSTR
Declarao
Essa funo, definida na unit SysUtils, converte em uma string um valor do tipo TDateTime, usado
para representar uma data, e passado como parmetro.
DELETE
Declarao
Esse procedimento, declarado na unit System, recebe como parmetros uma string e dois nmeros
inteiros, removendo da string original Count caracteres, sendo o primeiro caractere aquele que ocupa,
na string original, a posio definida pelo parmetro Index.
FLOATTOSTR
Declarao
Essa funo, definida na unit SysUtils, converte em uma string o nmero real passado como parmetro.
INSERT
Declarao
Esse procedimento, declarado na unit System, recebe como parmetros duas strings e um nmero
inteiro, inserindo na string passada como primeiro parmetro a segunda string, a partir da posio
definida pelo parmetro Index.
INTTOSTR
Declarao
Essa funo, definida na unit SysUtils, converte em uma string o nmero inteiro passado como parmetro.
ISDELIMITER
Declarao
Essa funo, declarada na unit System, recebe como parmetros duas strings e um nmero inteiro, sendo
que a primeira string armazena um conjunto de caracteres a serem pesquisados na segunda string.
Se um dos caracteres especificados pela primeira string estiver presente na segunda string, na posio
indicada pelo parmetro Index, essa funo retorna True (retornando false em caso contrrio).
ISPATHDELIMITER
Declarao
Essa funo, declarada na unit System, recebe como parmetros uma string e um nmero inteiro, e
verifica se o caractere de barra invertida est presente na segunda string, na posio indicada pelo
parmetro Index, retornando True em caso verdadeiro (e False, em caso contrrio).
LASTDELIMITER
Declarao
Essa funo, declarada na unit System, recebe como parmetros duas strings e retorna um inteiro
que define a posio, na string, de qualquer caractere que seja igual a um dos caracteres armazenados
na primeira string.
LENGTH
Declarao
Essa funo, declarada na unit System, recebe como parmetro uma string ou array e retorna como
resultado o nmero de caracteres da string (ou de elementos da array).
LOWERCASE
Declarao
mesma string com todos os seus caracteres em caixa baixa (minsculos).
POS
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetro duas strings e verifica se a primeira
uma substring da segunda. Em caso positivo, retorna a posio ocupada pelo primeiro caractere da
substring. Em caso negativo, retorna o valor 0.
QUOTEDSTR
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros uma string e retorna como resultado
da chamada da funo uma string igual primeira, acrescida do delimitador () no incio e no final da
string (a string original no alterada).
SETLENGTH
Declarao
Esse procedimento, declarado na unit System, redefine o comprimento da string ou array passado
como primeiro parmetro para o valor inteiro passado como segundo parmetro.
SETSTRING
Declarao
Esse procedimento, declarado na unit System, redefine o comprimento e contedo da string passada como
primeiro parmetro. O contedo definido pelo parmetro buffer e o comprimento, pelo parmetro len.
STR
Declarao
Esse procedimento, declarado na unit System, converte o valor X (que pode ser um nmero inteiro ou
real) em uma string, exibindo um nmero de algarismos definidos pelo valor opcional Width e com o
nmero de casas decimais definidos pelo valor opcional Decimals. O valor convertido retornado na
varivel S, passada por referncia.
Por exemplo, para exibir o valor de pi com duas casas decimais, pode-se usar um trecho de cdigo
como o apresentado a seguir.
Str(pi:1:2,S2);
ShowMessage(S2);
STRINGOFCHAR
Declarao
Essa funo, declarada na unit System, recebe como parmetros um caractere e um nmero inteiro, e
retorna uma string com Count caracteres iguais ao passado como primeiro parmetro.
STRINGREPLACE
Declarao
Essa funo, declarada na unit SysUtils, substitui na string passada como primeiro parmetro uma ou mais
ocorrncias da substring OldPattern pela string NewPattern (dependendo do valor do parmetro Flags).
O parmetro Flags uma varivel do tipo TReplaceFlags, definida da seguinte maneira:
TReplaceFlags = set of (rfReplaceAll, rfIgnoreCase);
Se Flags contiver o valor rfReplaceAll, todas as ocorrncias de OldPattern sero substitudas pela string
NewPattern (se no apenas a primeira ocorrncia ser substituda).
Se Flags contiver o valor rfIgnoreCase, todas as ocorrncias de OldPattern sero consideradas,
independentemente do fato de os caracteres estarem em caixa alta ou caixa baixa.
STRTOCURR
Declarao
Essa funo, definida na unit SysUtils, converte em um nmero do tipo currency a string passada
como parmetro.
STRTODATE
Declarao
Essa funo, definida na unit SysUtils, converte em um nmero do tipo TDateTime uma string que
representa uma data, passada como parmetro.
STRTOFLOAT
Declarao
Essa funo, definida na unit SysUtils, converte em um nmero real a string passada como parmetro.
STRTOINT
Declarao
Essa funo, definida na unit SysUtils, converte em um nmero inteiro a string passada como parmetro.
STRTOINTDEF
Declarao
Essa funo, definida na unit SysUtils, converte em um nmero inteiro a string passada como primeiro
parmetro. Se a converso no puder ser realizada, ser retornado o valor inteiro passado como segundo
parmetro (tratado como valor default).
STRTOTIME
Declarao
Essa funo, definida na unit SysUtils, converte em um nmero do tipo TDateTime uma string que representa
uma hora, passada como parmetro.
TIMETOSTR
Declarao
Essa funo, definida na unit SysUtils, converte em uma string um valor do tipo TDateTime, usado para
representar uma hora, e passado como parmetro.
TRIM
Declarao
Essa funo, declarada na unit SysUtils, retorna como resultado uma string, obtida removendo-se os
espaos em branco e caracteres de controle existentes no incio e no final da string passada como
parmetro (no alterando portanto a string original).
TRIMLEFT
Declarao
espaos em branco e caracteres de controle existentes no incio da string passada como parmetro (no
alterando portanto a string original).
TRIMRIGHT
Declarao
espaos em branco e caracteres de controle existentes no final da string passada como parmetro (no
alterando portanto a string original).
UPPERCASE
Declarao
mesma string com todos os seus caracteres em caixa alta (maisculos).
VAL
Declarao
Esse procedimento, declarado na unit System, converte em um valor numrico (a ser armazenado na
varivel passada por referncia como segundo parmetro) a string passada como primeiro parmetro.
Caso a converso no seja possvel, a posio do caractere que impediu a converso armazenada na
varivel Code, tambm passada por referncia.
WRAPTEXT
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros duas strings, uma varivel do tipo
TSysCharSet e um nmero inteiro.
A primeira string define o texto que poder ser subdividido.
A segunda string define a string que representar a subdiviso do texto geralmente um retorno de carro/
avano de linha, representados pela string #13#10.
O parmetro nBreakChars definido como um conjunto de caracteres, separados por vrgulas e definidos
entre colchetes.
O parmetro MaxCol define o nmero mximo de caracteres permitidos antes da incluso da string
passada como segundo parmetro.
Essa funo insere a string passada como segundo parmetro na ltima ocorrncia dos caracteres
definidos no terceiro parmetro, ou na posio definida pelo quarto parmetro.
PRINCIPAIS FUNES PARA A MANIPULAO DE STRINGS DE TERMINAO NULA
Assim como a linguagem C++, o Delphi (que baseado na linguagem Object Pascal) tambm suporta
strings de terminao nula (identificadas como Pchar).
Essas strings so teis, principalmente, nas chamadas s funes da API do Windows, muitas das quais
requerem como parmetros strings de terminao nula.
ANSISTRCOMP
Declarao
Essa funo, declarada na unit SysUtils, compara duas strings de terminao nula passadas como
parmetros, retornando um inteiro positivo, nulo ou negativo de acordo com as seguintes regras:
Essa funo considera o fato de os caracteres estarem em caixa alta ou caixa baixa. Em geral, na maioria
dos pases, a instalao local do Windows considera caracteres minsculos precedendo os maisculos (ao
contrrio do que ocorre com o cdigo ASCII desses mesmos caracteres). Caso voc queira considerar a
ordenao feita pelo cdigo ASCII, deve utilizar a funo CompareStr.
ANSISTRICOMP
Declarao
parmetros, retornando um inteiro positivo, nulo ou negativo de acordo com as regras descritas no tpico
anterior, mas sem considerar se as letras esto em caixa alta ou caixa baixa.
ANSISTRLCOMP
Declarao
parmetros, considerando-se apenas os primeiros MaxLen bytes, retornando um inteiro positivo,
nulo ou negativo de acordo com as regras descritas no tpico anterior, considerando se as letras esto
em caixa alta ou caixa baixa.
ANSISTRLOWER
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetro uma string de terminao nula e
retorna como resultado a mesma string de terminao nula, mas com todos os seus caracteres em caixa
baixa (minsculos).
Condio Resultado
S1 > S2 > 0
S1 < S2 < 0
S1 = S2 = 0
ANSISTRPOS
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetro duas strings de terminao e verifica se
a primeira uma substring da segunda. Em caso positivo, retorna um ponteiro com o endereo da
posio ocupada pelo primeiro caractere da substring. Em caso negativo, retorna o valor nil.
ANSISTRRSCAN
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetro uma string de terminao nula e um
ponteiro para caractere, e retorna um ponteiro para a ltima ocorrncia do caractere na string. Em caso
negativo, retorna o valor nil.
ANSISTRSCAN
Declarao
ponteiro para caractere, e retorna um ponteiro para a primeira ocorrncia do caractere na string. Em caso
ANSISTRUPPER
Declarao
alta (maisculos). A string original no afetada.
STRALLOC
Declarao
Essa funo, declarada na unit SysUtils, aloca memria para uma string de terminao nula capaz de
armazenar um nmero mximo de caracteres igual a Size-1, onde Size um nmero inteiro passado
como parmetro.
STRBUFSIZE
Declarao
Essa funo, declarada na unit SysUtils, retorna o nmero mximo de caracteres que pode ser armazenado
em uma string de terminao nula, e cuja memria foi alocada por uma chamada funo StrAlloc.
STRCAT
Declarao
Essa funo, declarada na unit System, retorna uma string de terminao nula obtida como resultado
da concatenao de duas strings de terminao nula passadas como parmetros.
Essa funo no verifica se a string de terminao nula que ir receber o resultado da chamada dessa
funo capaz de armazenar todos os caracteres resultantes da concatenao. Nessas situaes, deve-
se dar preferncia funo StrLCat, descrita adiante.
STRCOMP
Declarao
parmetros, retornando um inteiro positivo, nulo ou negativo de acordo com as seguintes regras:
STRCOPY
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros duas strings de terminao nula,
copiando o contedo da segunda na primeira e retornando a primeira string (j modificada).
funo capaz de armazenar todos os caracteres resultantes da concatenao. Nessas situaes, deve-se
dar preferncia funo StrLCopy, descrita adiante.
STRECOPY
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros duas strings de terminao nula,
copiando o contedo da segunda na primeira e retornando um ponteiro para o caractere de terminao
da primeira string (j modificada).
funo capaz de armazenar todos os caracteres resultantes da concatenao.
STREND
Declarao
retorna um ponteiro para o caractere de terminao da string.
Condio Resultado
S1 > S2 > 0
S1 < S2 < 0
S1 = S2 = 0
STRLCAT
Declarao
Essa funo, declarada na unit System, retorna uma string de terminao nula obtida como resultado
da concatenao de duas strings de terminao nula passadas como parmetros. Alm disso, recebe
um terceiro parmetro que indica o nmero mximo de caracteres que pode ter a string de terminao
nula resultante dessa concatenao.
STRLCOMP
Declarao
parmetros, at um mximo de MaxLen caracteres, retornando um inteiro positivo, nulo ou negativo de
acordo com as regras j descritas para a funo StrComp.
STRLCOPY
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros duas strings de terminao nula e um
inteiro, copiando o contedo da segunda (limitado a MaxLen caracteres) na primeira e retornando a
primeira string (j modificada).
STRLEN
Declarao
retorna o nmero de caracteres da string (no considerando o caractere de terminao).
STRLICOMP
Declarao
parmetros, at um mximo de MaxLen caracteres, retornando um inteiro positivo, nulo ou negativo de
acordo com as regras j descritas para a funo StrComp.
Essa funo no considera o fato de os caracteres estarem em caixa alta ou caixa baixa e considera a
ordenao dos caracteres feita pelo seu cdigo ASCII.
STRLOWER
Declarao
baixa (minsculos).
STRMOVE
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros duas strings de terminao nula e um
nmero inteiro, copiando exatamente esse nmero de caracteres (passado como terceiro parmetro)
da segunda string na primeira e retornando um ponteiro para a primeira string (j modificada).
STRNEW
Declarao
retorna uma cpia dessa string (aps alocar a memria necessria com uma chamada ao mtodo StrAlloc).
STRPCOPY
Declarao
Essa funo, declarada na unit SysUtils, recebe como parmetros uma string de terminao nula e
uma string no estilo Pascal, retornando uma string de terminao nula obtida copiando-se os caracteres
da string no estilo Pascal passada como segundo parmetro.
STRUPPER
Declarao
alta (maisculos).
STRRSCAN
Declarao
ponteiro para caractere, e retorna um ponteiro para a ltima ocorrncia do caractere na string. Em caso
STRSCAN
Declarao
ponteiro para caractere, e retorna um ponteiro para a primeira ocorrncia do caractere na string. Em
caso negativo, retorna o valor nil.
KNOW-HOW EM: MANIPULAO DE LISTAS DE STRINGS
PR-REQUISITOS
Conhecimento da sintaxe bsica da linguagem Pascal e dos fundamentos da programao orientada a objetos em Delphi.
METODOLOGIA
Apresentao da classe TStrings, que permite a manipulao de listas de strings.
TCNICA
Apresentao das caractersticas principais da classe TStrings, e de componentes que implementam propriedades como objetos da classe TStrings.
A CLASSE TSTRINGS
O Delphi define uma classe chamada TStrings, que define uma srie de propriedades e mtodos que
nos torna capazes de manipular uma lista de strings e de objetos associados a essas strings.
Muitos dos mtodos dessa classe so abstratos, sendo implementados nas classes dela derivadas por
herana, como por exemplo a classe TStringList.
importante salientar que a classe TStrings permite manipular no apenas uma lista de strings, mas
uma lista de objetos associados a essas strings, o que a torna uma classe bastante poderosa.
REFERNCIA: A CLASSE TSTRINGS
A classe TStrings, codificada na unit Classes e reproduzida a seguir, derivada por herana da classe
TPersistent e a classe-base para todas as classes que manipulam listas de strings (e objetos a elas
associados) no Delphi.
DEFINIO DA CLASSE TSTRINGS
Reproduzimos a seguir o trecho de cdigo responsvel pela definio da classe TStrings, extrado da
unit Classes.
TStrings = class(TPersistent)
private
FUpdateCount: Integer;
FAdapter: IStringsAdapter;
function GetCommaText: string;
function GetName(Index: Integer): string;
function GetValue(const Name: string): string;
procedure ReadData(Reader: TReader);
procedure SetCommaText(const Value: string);
procedure SetStringsAdapter(const Value: IStringsAdapter);
procedure SetValue(const Name, Value: string);
procedure WriteData(Writer: TWriter);
protected
procedure DefineProperties(Filer: TFiler); override;
procedure Error(const Msg: string; Data: Integer);
function Get(Index: Integer): string; virtual; abstract;
function GetCapacity: Integer; virtual;
function GetCount: Integer; virtual; abstract;
function GetObject(Index: Integer): TObject; virtual;
function GetTextStr: string; virtual;
procedure Put(Index: Integer; const S: string); virtual;
procedure PutObject(Index: Integer; AObject: TObject); virtual;
procedure SetCapacity(NewCapacity: Integer); virtual;
procedure SetTextStr(const Value: string); virtual;
procedure SetUpdateState(Updating: Boolean); virtual;
public
function Add(const S: string): Integer; virtual;
function AddObject(const S: string; AObject: TObject): Integer; virtual;
procedure Append(const S: string);
procedure AddStrings(Strings: TStrings); virtual;
procedure BeginUpdate;
procedure Clear; virtual; abstract;
procedure Delete(Index: Integer); virtual; abstract;
procedure EndUpdate;
function Equals(Strings: TStrings): Boolean;
procedure Exchange(Index1, Index2: Integer); virtual;
function GetText: PChar; virtual;
function IndexOf(const S: string): Integer; virtual;
function IndexOfName(const Name: string): Integer;
function IndexOfObject(AObject: TObject): Integer;
procedure Insert(Index: Integer; const S: string); virtual; abstract;
procedure InsertObject(Index: Integer; const S: string;
AObject: TObject);
procedure LoadFromFile(const FileName: string); virtual;
procedure LoadFromStream(Stream: TStream); virtual;
procedure Move(CurIndex, NewIndex: Integer); virtual;
procedure SaveToFile(const FileName: string); virtual;
procedure SaveToStream(Stream: TStream); virtual;
procedure SetText(Text: PChar); virtual;
property Capacity: Integer read GetCapacity write SetCapacity;
property CommaText: string read GetCommaText write SetCommaText;
property Count: Integer read GetCount;
property Names[Index: Integer]: string read GetName;
property Objects[Index: Integer]: TObject read GetObject write PutObject;
property Values[const Name: string]: string read GetValue write SetValue;
property Strings[Index: Integer]: string read Get write Put; default;
property Text: string read GetTextStr write SetTextStr;
property StringsAdapter: IStringsAdapter read FAdapter write SetStringsAdapter;
end;
PROPRIEDADES DA CLASSE TSTRINGS
Apresentamos a seguir a descrio das principais propriedades definidas para a classe TStrings.
CAPACITY
Essa propriedade retorna o nmero de strings que a lista capaz de armazenar, e no o nmero de strings
realmente armazenados pela lista, o que definido pela sua propriedade Count (a ser vista a seguir).
COUNT
Essa propriedade declarada como uma varivel inteira, e retorna o nmero de strings armazenadas na
lista e no o nmero de strings que podem vir a ser armazenadas pela mesma, o que definido pela sua
propriedade Capacity, descrita anteriormente.
COMMATEXT
Essa propriedade declarada como uma varivel do tipo string, e retorna em uma nica string, separadas
por vrgulas, todas as strings armazenadas na lista.
Names
Uma lista de string pode armazenar, em cada string, um par de valores na forma:
Nome=Valor.
Quando isso ocorre, a propriedade Names (que uma array) pode ser usada para retornar o valor
armazenado esquerda do sinal de igualdade para a n-zima string da lista.
A linha de cdigo a seguir, por exemplo, exibe o valor armazenado esquerda do sinal de igualdade
para a segunda string da lista.
ShowMessage(Lista.Names[1]);
Nesse caso, Lista um objeto da classe TStrings.
OBJECTS
Essa propriedade definida como uma array de objetos da classe TObject, e retorna o objeto associado
a uma string da lista, cujo ndice indicado entre colchetes.
STRINGS
Essa propriedade definida como uma array de strings, e retorna a string da lista, cujo ndice indicado
entre colchetes.
TEXT
Essa propriedade definida como uma varivel do tipo string, e retorna em uma nica string as strings
armazenadas na lista, separadas por caracteres de retorno de carro e de avano de linha.
VALUES
Conforme descrito anteriormente, uma lista de string pode armazenar, em cada string, um par de
valores na forma:
Nome=Valor.
Quando isso ocorre, a propriedade Values (que uma array) pode ser usada para retornar o valor
armazenado direita do sinal de igualdade para a string cujo ndice referenciado pela string (e no
pela sua ordem na lista de armazenamento).
A linha de cdigo a seguir, por exemplo, exibe o valor armazenado direita do sinal de igualdade para
a string da lista que armazena, esquerda do sinal de igualdade, o valor Axcel.
ShowMessage(Lista.Values[Axcel]);
Nesse caso, Lista um objeto da classe TStrings.
MTODOS DA CLASSE TSTRINGS
Apresentamos a seguir a descrio dos principais mtodos definidos para a classe TStrings.
ADD
Declarao
Esse mtodo adiciona a string passada como parmetro ao final da lista, retornando a posio em que
a string foi inserida.
ADDOBJECT
Declarao
Esse mtodo adiciona a string passada como primeiro parmetro e o endereo do objeto passado como
segundo parmetro ao final da lista retornando a posio em que a string e a referncia ao objeto
foram inseridas.
importante destacar que o objeto (que pode ser uma instncia de qualquer classe, pois todas so
derivadas de TObject) j deve ter sido criado. A lista no cria strings e objetos, apenas gerencia a lista.
ADDSTRINGS
Declarao
Esse mtodo adiciona lista de strings gerenciada pelo objeto uma lista de strings armazenada em
outro objeto da classe TStrings (bem como as referncias a objetos associados s strings da lista).
APPEND
Declarao
Esse mtodo adiciona a string passada como parmetro ao final da lista, mas, ao contrrio do mtodo
Add, no retorna a posio em que a string foi inserida.
ASSIGN
Declarao
Esse mtodo atribui o objeto passado como parmetro ao objeto que chama o mtodo.
Se Source um objeto da classe TStrings, as strings e objetos referenciados pelo objeto Source passam
a ser manipuladas pelo objeto que chamou o mtodo.
CLEAR
Declarao
Esse mtodo remove todas as strings e referncias a objetos gerenciados pela lista.
DELETE
Declarao
Esse mtodo remove da lista a string e a referncia a objeto cujo ndice passado como parmetro.
EQUALS
Declarao
Esse mtodo compara as strings armazenadas pela lista com as strings armazenadas em outra lista de
strings passada como parmetro na chamada do mtodo.
Esse mtodo retorna True se todas as strings forem iguais, retornando False em caso contrrio.
importante destacar que esse mtodo compara apenas strings, e no os objetos referenciados pela lista.
EXCHANGE
Declarao
Esse mtodo troca as strings armazenadas nas posies passadas como parmetros, bem como as
referncias a objetos a elas associadas.
INDEXOF
Declarao
Esse mtodo retorna o ndice que a string passada como parmetro ocupa na lista. Se a string no
estiver armazenada na lista, ser retornado o valor -1. Se a string estiver armazenada em mais de uma
posio da lista, ser retornado o ndice da posio correspondente primeira ocorrncia da string.
INDEXOFNAME
Declarao
Conforme descrito anteriormente, uma lista de string pode armazenar, em cada string, um par de
valores na forma:
Nome=Valor.
Quando isso ocorre, esse mtodo retorna o ndice correspondente posio ocupada pela string que
exibe, esquerda do sinal de igualdade, a string passada como parmetro. Se essa condio no for
encontrada, ser retornado o valor -1.
INDEXOFOBJECT
Declarao
Esse mtodo retorna o ndice que a string da lista associada ao objeto passado como parmetro ocupa
na lista. Se a lista no armazenar nenhuma string associada ao objeto, ser retornado o valor -1.
INSERT
Declarao
Esse mtodo insere na lista, na posio passada como primeiro parmetro, a string passada como
segundo parmetro.
INSERTOBJECT
Declarao
Esse mtodo insere, na posio passada como primeiro parmetro, a string passada como segundo
parmetro, e associa essa string ao objeto passado como terceiro parmetro.
LOADFROMFILE
Declarao
Esse mtodo carrega a lista de strings do objeto com as strings armazenadas em um arquivo-texto cujo
nome passado como parmetro.
Cada linha do arquivo ser armazenada como uma string da lista.
LOADFROMSTREAM
Declarao
Esse mtodo carrega a lista de strings do objeto com as strings armazenadas em um objeto da classe
TStream cujo nome passado como parmetro.
MOVE
Declarao
Esse mtodo move a string armazenada na posio da lista indicada pelo primeiro parmetro para a
posio indicada pelo segundo parmetro.
SAVETOFILE
Declarao
Esse mtodo grava a lista de strings do objeto em um arquivo-texto cujo nome passado como parmetro.
Cada string ser armazenada em uma linha do arquivo.
SAVETOSTREAM
Declarao
Esse mtodo grava a lista de strings do objeto em um objeto da classe TStream cujo nome passado
como parmetro.
COMPONENTES QUE DEFINEM PROPRIEDADES COMO OBJETOS DA CLASSE TSTRINGS
Existem vrios objetos que implementam propriedades como objetos da classe TStrings.
Dentre esses componentes podem-se destacar:
O componente Memo, que define a sua propriedade Lines como um objeto da classe TStrings.
O componente ListBox, que define a sua propriedade Items como um objeto da classe TStrings.
O componente DBListBox, que define a sua propriedade Items como um objeto da classe TStrings.
O componente ComboBox, que define a sua propriedade Items como um objeto da classe TStrings.
O componente DBComboBox, que define a sua propriedade Items como um objeto da classe TStrings.
O componente MainMenu, que define a sua propriedade Items como um objeto da classe TStrings.
O componente RadioGroup, que define a sua propriedade Items como um objeto da classe TStrings.
O componente DBRadioGroup, que define a sua propriedade Items como um objeto da classe TStrings.
O componente RichEdit, que define a sua propriedade Lines como um objeto da classe TStrings.
Alm de outras classes e componentes.
Fica ento a seguinte pergunta: como a propriedade Lines, da classe TMemo, pode utilizar o mtodo
Delete, se este definido como abstrato?
O que ocorre que a unit Classes implementa a classe TMemoStrings que sobrecarrega este e outros
mtodos, conforme indicado no seguinte trecho de cdigo:
TMemoStrings = class(TStrings)
private
Memo: TCustomMemo;
protected
function Get(Index: Integer): string; override;
function GetCount: Integer; override;
function GetTextStr: string; override;
procedure Put(Index: Integer; const S: string); override;
procedure SetTextStr(const Value: string); override;
procedure SetUpdateState(Updating: Boolean); override;
public
procedure Clear; override;
procedure Delete(Index: Integer); override;
procedure Insert(Index: Integer; const S: string); override;
end;
A classe TCustomMemo, da qual a classe TMemo derivada por herana, implementa o objeto FLines
como um objeto da classe TStrings, mas ao alocar memria para esse objeto chama o mtodo construtor
da classe TMemoStrings, como mostra o cdigo do seu mtodo construtor, reproduzido a seguir.
constructor TCustomMemo.Create(AOwner: TComponent);
begin
Width := 185;
Height := 89;
AutoSize := False;
DoubleBuffered := False;
FWordWrap := True;
FWantReturns := True;
FLines := TMemoStrings.Create;
TMemoStrings(FLines).Memo := Self;
end;
Dessa maneira, o campo interno FLines passar a referenciar um objeto da classe TMemoStrings, na
qual vrios mtodos abstratos da classe TStrings so sobrecarregados.
KNOW-HOW EM: MANIPULAO DE FONTES
PR-REQUISITOS
Conhecimento da sintaxe bsica da linguagem Pascal e dos fundamentos da programao orientada a objetos em Delphi.
METODOLOGIA
Apresentao da classe TFont, que permite a manipulao de fontes em aplicaes desenvolvidas em Delphi.
TCNICA
Apresentao das caractersticas principais da classe TFont, e de componentes que implementam propriedades como objetos da classe TFont.
REFERNCIA: A CLASSE TFONT
A classe TFont, codificada na unit Graphics e reproduzida a seguir, derivada por herana da classe
TGraphicObject e a classe que permite a manipulao de fontes em Delphi.
DEFINIO DA CLASSE TFONT
Reproduzimos a seguir o trecho de cdigo responsvel pela definio da classe TFont, extrado da
unit Classes.
TFont = class(TGraphicsObject)
private
FColor: TColor;
FPixelsPerInch: Integer;
FNotify: IChangeNotifier;
procedure GetData(var FontData: TFontData);
procedure SetData(const FontData: TFontData);
protected
procedure Changed; override;
function GetHandle: HFont;
function GetHeight: Integer;
function GetName: TFontName;
function GetPitch: TFontPitch;
function GetSize: Integer;
function GetStyle: TFontStyles;
function GetCharset: TFontCharset;
procedure SetColor(Value: TColor);
procedure SetHandle(Value: HFont);
procedure SetHeight(Value: Integer);
procedure SetName(const Value: TFontName);
procedure SetPitch(Value: TFontPitch);
procedure SetSize(Value: Integer);
procedure SetStyle(Value: TFontStyles);
procedure SetCharset(Value: TFontCharset);
public
constructor Create;
property FontAdapter: IChangeNotifier read FNotify write FNotify;
property Handle: HFont read GetHandle write SetHandle;
property PixelsPerInch: Integer read FPixelsPerInch write FPixelsPerInch;
published
property Charset: TFontCharset read GetCharset write SetCharset;
property Color: TColor read FColor write SetColor;
property Height: Integer read GetHeight write SetHeight;
property Name: TFontName read GetName write SetName;
property Pitch: TFontPitch read GetPitch write SetPitch default fpDefault;
property Size: Integer read GetSize write SetSize stored False;
property Style: TFontStyles read GetStyle write SetStyle;
end;
PROPRIEDADES DA CLASSE TFONT
Apresentamos a seguir a descrio das principais propriedades definidas para a classe TFont.
CHARSET
Essa propriedade definida como uma varivel do tipo TFontCharSet, e define o conjunto de caracteres
a serem utilizados pela fonte.
COLOR
Essa propriedade definida como uma varivel do tipo TColor, e define a cor do texto exibido pela fonte.
HANDLE
Essa propriedade definida como uma varivel do tipo HFont, e retorna um handle para o objeto (a ser
utilizado em chamadas s funes da API do Windows).
HEIGHT
Essa propriedade definida como uma varivel do tipo inteiro, e define a altura da fonte, em pixels.
NAME
Essa propriedade definida como uma varivel do tipo TFontName (que declarado como um alias
para uma string), e define o nome da fonte.
PITCH
Essa propriedade definida como uma varivel do tipo TFontPitch, e define se todos os caracteres da
fonte devem ter a mesma largura (isto , se a fonte ser monoespaada).
O tipo TFontPitch um tipo enumerado, declarado da seguinte maneira:
type TFontPitch = (fpDefault, fpVariable, fpFixed);
onde TfontPitch pode assumir um dos seguintes valores:
fpDefault: Os caracteres da fonte tero a sua largura default, o que depender da fonte escolhida
(especificada na propriedade Name).
FpFixed: Os caracteres da fonte tero largura fixa (ou seja, sero monoespaados).
FpVariable: Os caracteres da fonte tero largura varivel.
PIXELSPERINCH
Essa propriedade declarada como uma varivel inteira que define o nmero de pixels por polegada
aplicvel aos caracteres da fonte.
SIZE
Essa propriedade definida como uma varivel do tipo inteiro, e define a altura da fonte, em pontos.
STYLE
Essa propriedade definida como uma varivel do tipo TFontStyles, que um conjunto que pode
armazenar os valores apresentados na tabela a seguir, e define o estilo da fonte.
TFontStyle = (fsBold, fsItalic, fsUnderline, fsStrikeOut);
TFontStyles = set of TFontStyle;
Valor Significado
fsBold A fonte ser exibida em negrito.
fsItalic A fonte ser exibida em itlico.
fsUnderline A fonte ser sublinhada.
fsStrikeout A fonte ser cortada por uma linha horizontal.
EXEMPLO DE UTILIZAO DAS CLASSES TFONT E TSTRINGS
PARA MANIPULAO DE ARQUIVOS TEXTO ASCII
Ser apresentado a seguir um exemplo que ilustra a utilizao das classes TFont, TStrings e TMemo.
Este exemplo exibir em um componente Memo o texto a ser armazenado em um arquivo. Sero
apresentados os procedimentos individuais para manipulao de arquivos e das caractersticas
individuais das fontes de um componente.
1. Inicie o desenvolvimento de uma nova aplicao, selecionando o item New Application do
menu File.
2. Defina os seguintes valores para as principais propriedades do formulrio principal da aplicao:
Name: FormMemo
Caption: Exemplo de Utilizao do Componente Memo
WindowState: wsMaximized
3. Inclua um componente MainMenu e defina a seguinte estrutura de menus:
Menu Arquivo (caption &Arquivo)
Relao de itens do Menu Arquivo
Name Caption
Novo &Novo
Abrir &Abrir
Salvar &Salvar
SalvarComo Salvar &Como
Separador1 -
Fechar &Fechar
Menu Fonte (caption &Fonte)
Negrito &Negrito
Itlico &Itlico
Sublinhado &Sublinhado
Cortada &Cortada
Separador2 -
SelecionarCor Selecionar &Cor
4. Inclua um componente StatusBar (pgina Win32 da paleta de componentes) no formulrio e
atribua os seguintes valores s suas principais propriedades:
Name: StatusBar1
SimplePanel: True
SimpleText: Nome do Arquivo:
Align: alBottom
5. Inclua um componente Memo e atribua os seguintes valores s suas principais propriedades:
Name: Memo1
Align: alClient
ScrollBars: ssBoth.
6. Apague o texto exibido pela propriedade Lines do componente Memo1.
7. Inclua um componente OpenDialog (pgina Dialogs da paleta de componentes) no formulrio
e atribua os seguintes valores s suas principais propriedades:
Name: OpenDialog1
Filter: Arquivos Texto|*.TXT
DefaultExt: TXT
8. Inclua um componente SaveDialog (pgina Dialogs da paleta de componentes) no formulrio
e atribua os seguintes valores s suas principais propriedades:
Name: SaveDialog1
Filter: Arquivos Texto|*.TXT
DefaultExt: TXT
9. Inclua um componente ColorDialog no formulrio e atribua os seguintes valores s suas
Name: ColorDialog1
Seu formulrio dever ficar com o aspecto apresentado na figura a seguir.
Figura 32.1: Aspecto do formulrio usado no aplicativo-exemplo.
Para codificar corretamente esse aplicativo, voc deve executar os seguintes procedimentos:
1. Declare as seguintes variveis globais na seo var da unit associada ao formulrio:
ArquivoAtual: string;
A varivel booleana arquivoalterado armazena o estado de alterao do arquivo.
A varivel arquivoatual, do tipo string, armazena o nome do arquivo que est sendo manipulado.
2. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Novo do
menu Arquivo:
begin
begin
if MessageDlg(Deseja Salvar Alteraes no Arquivo Atual?,Confirmation, mbOkCancel,0)=
mrOk
then
end;
arquivoatual := ;
Memo1.Lines.Clear;
StatusBar1.SimpleText := Nome do Arquivo:;
end;
Inicialmente esse procedimento verifica se o arquivo foi alterado aps ter sido salvo pela ltima vez,
testando o valor da varivel arquivoalterado.
Caso o arquivo tenha sido alterado e no tenha sido salvo, ser exibida uma mensagem perguntando
ao usurio se deseja salvar as alteraes efetuadas. Caso o usurio queira salvar as alteraes, ser
executado o mtodo SaveToFile da propriedade Lines do componente Memo1.
Por fim, os valores default da fonte do componente Memo e dos diversos itens de menu so
restabelecidos, e uma string nula atribuda varivel arquivoatual.
3. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Abrir do
menu Arquivo:
begin
then
begin
begin
if MessageDlg(Deseja Salvar Alteraes no Arquivo
Atual?,mtConfirmation, mbOkCancel,0)= mrOk
then
end;
StatusBar1.SimpleText := Nome do Arquivo: + arquivoatual;
end;
end;
Esse procedimento exibe a caixa de dilogo padro para abertura de arquivos, mediante uma chamada
ao mtodo Execute do componente OpenDialog1. Caso o usurio selecione o boto Abrir dessa caixa
de dilogo, o mtodo Execute retornar o valor True e o arquivo selecionado (armazenado na propriedade
FileName do componente OpenDialog) armazenado na varivel arquivoatual.
O arquivo carregado usando-se o mtodo LoadFromFile da propriedade Lines do componente Memo
(propriedade esta que , conforme descrito anteriormente, um objeto da classe TStrings) e atribui-se o
valor false varivel arquivo alterado (pois o arquivo acaba de ser carregado e portanto nenhuma
alterao foi feita).
Repare ainda que, caso o arquivo anteriormente manipulado tenha sido alterado e essas alteraes no
tenham sido salvas, solicita-se uma confirmao por parte do usurio.
Por fim, o valor da propriedade Checked de cada um dos diversos itens do menu Fonte definida em
funo dos elementos armazenados na propriedade Style da propriedade Font (que um objeto da
classe TFont) do componente Memo1. Alm disso, o nome do arquivo atual atribudo propriedade
SimpleText do componente StatusBar.
4. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Salvar Como
do menu Arquivo:
begin
then
begin
end;
end;
Esse procedimento exibe a caixa de dilogo padro para gravao de arquivos, mediante uma chamada
ao mtodo Execute do componente SaveDialog1. Caso o usurio selecione o boto Salvar dessa caixa
FileName do componente SaveDialog) ser armazenado na varivel arquivoatual.
O arquivo gravado usando-se o mtodo SaveToFile da propriedade Lines do componente Memo
valor false varivel arquivoalterado (pois o arquivo acaba de ser salvo). Alm disso, o nome do arquivo
atual atribudo propriedade SimpleText do componente StatusBar.
5. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Salvar do
menu Arquivo:
begin
if arquivoatual =
then
else
begin
end;
end;
Esse procedimento verifica, inicialmente, se ainda no foi atribudo um nome para o arquivo e, em
caso positivo, executa o procedimento associado ao evento OnClick do item Salvar Como do menu
Arquivo (repare a utilizao da propriedade Self).
Caso o arquivo j tenha recebido um nome, as ltimas alteraes so salvas mediante uma chamada ao
mtodo SaveToFile da propriedade Lines do componente Memo. Conseqentemente, atribui-se o valor
false varivel arquivoalterado.
Por fim, o nome do arquivo atribudo propriedade SimpleText do componente StatusBar.
6. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Fechar do
menu Arquivo:
begin
then
begin
begin
then
if arquivoatual =
then
else
end;
end;
end;
Esse procedimento verifica, inicialmente, se existem alteraes a serem gravadas e, em caso positivo,
pergunta ao usurio se deseja salvar as alteraes. Em caso positivo esse procedimento verifica se ainda
no foi atribudo um nome para o arquivo e, em caso positivo, executa o procedimento associado ao
evento OnClick do item Salvar Como do menu Arquivo (se no, executa o mtodo SaveToFile da
propriedade Lines do componente Memo1).
Por fim, a aplicao encerrada, mediante a execuo do mtodo Terminate do objeto Application, da
classe TApplication (que representa a aplicao).
7. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Negrito do
menu Fonte:
begin
if Negrito.Checked
then
else
end;
Esse mtodo muda o valor da propriedade Checked do item de Menu.
Caso o valor dessa propriedade passe a ter o valor True, o valor da subpropriedade Style da propriedade
Font do componente Memo1 passa a incluir o elemento fsBold no seu conjunto de valores.
Caso o valor dessa propriedade passe a ter o valor False, o valor da subpropriedade Style da propriedade
Font do componente Memo1 exclui o elemento fsBold do seu conjunto de valores.
8. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Itlico do
menu Fonte:
begin
if Italico.Checked
then
else
end;
Esse mtodo muda o valor da propriedade Checked do item de menu correspondente.
Font do componente Memo1 passa a incluir o elemento fsItalic no seu conjunto de valores.
Font do componente Memo1 exclui o elemento fsItalic do seu conjunto de valores.
9. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Sublinhado
do menu Fonte:
begin
then
else
end;
Esse mtodo muda o valor da propriedade Checked do item de Menu.
Font do componente Memo1 passa a incluir o elemento fsUnderline no seu conjunto de valores.
Font do componente Memo1 exclui o elemento fsUnderline do seu conjunto de valores.
10. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Cortada do
menu Fonte:
begin
if Cortada.Checked
then
else
end;
Esse mtodo muda o valor da propriedade Checked do item de menu correspondente.
Font do componente Memo1 passa a incluir o elemento fsStrikeOut no seu conjunto de valores.
Font do componente Memo1 exclui o elemento fsStrikeOut do seu conjunto de valores.
11. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Selecionar
Cor do menu Fonte:
begin
then
begin
end;
end;
Esse mtodo exibe a caixa de dilogo padro para seleo de cores do Windows, mediante uma chamada
ao mtodo Execute do componente ColorDialog1.
Caso o usurio, aps selecionar a cor desejada, selecione o boto Ok dessa caixa de dilogo, a mesma
ser fechada e retornar o valor True. A cor selecionada (e armazenada na propriedade Color do
componente ColorDialog) ser atribuda subpropriedade Color da propriedade Font do componente
Memo1. Alm disso, o valor True ser atribudo varivel arquivoalterado.
12. Defina da seguinte maneira o procedimento associado ao evento OnKeyPress do componente Memo1:
begin
end;
Esse procedimento apenas atribui o valor True propriedade arquivoalterado, indicando que o arquivo
sofreu modificao.
unit UnitMemo;
interface
uses
type
TFormMemo = class(TForm)
Arquivo: TMenuItem;
Abrir: TMenuItem;
Salvar: TMenuItem;
Separador1: TMenuItem;
Fechar: TMenuItem;
Fonte1: TMenuItem;
Negrito: TMenuItem;
Itlico: TMenuItem;
Sublinhado: TMenuItem;
Cortada: TMenuItem;
Memo1: TMemo;
Novo: TMenuItem;
procedure Memo1KeyPress(Sender: TObject; var Key: Char);
procedure NegritoClick(Sender: TObject);
procedure ItalicoClick(Sender: TObject);
procedure SublinhadoClick(Sender: TObject);
procedure CortadaClick(Sender: TObject);
private
public
end;
var
FormMemo: TFormMemo;
implementation
{$R *.DFM}
begin
then
begin
begin
mbOkCancel,0)= mrOk
then
end;
end;
end;
begin
begin
mbOkCancel,0)= mrOk
then
end;
arquivoatual := ;
Memo1.Lines.Clear;
end;
begin
then
begin
end;
end;
begin
if arquivoatual =
then
else
begin
end;
end;
begin
then
begin
begin
mbOkCancel,0)= mrOk
then
if arquivoatual =
then
else
end;
end;
end;
begin
end;
begin
if Negrito.Checked
then
else
end;
begin
if Italico.Checked
then
else
end;
begin
then
else
end;
begin
if Cortada.Checked
then
else
end;
begin
then
begin
end;
end;
end.
EXEMPLO DE UTILIZAO DAS CLASSES TFONT E
TSTRINGS PARA MANIPULAO DE ARQUIVOS RTF
Ser apresentado a seguir um exemplo que ilustra a utilizao das classes TFont e TStrings, alm de
apresentar algumas caractersticas do componente RichEdit.
Esse exemplo exibir em um componente RichEdit o texto a ser armazenado em um arquivo RTF. Sero
apresentados os procedimentos individuais para manipulao de arquivos e das caractersticas individuais
das fontes de um componente.
1. Inicie o desenvolvimento de uma nova aplicao, selecionando o item New Application do
menu File.
2. Defina os seguintes valores para as principais propriedades do formulrio principal da aplicao:
Name: FormRTF
Caption: Exemplo de Utilizao do Componente RichEdit
WindowState: wsMaximized
3. Inclua um componente MainMenu e defina a seguinte estrutura de menus:
Menu Arquivo (caption &Arquivo)
Relao de itens do Menu Arquivo
Name Caption
Novo &Novo
Abrir &Abrir
Salvar &Salvar
SalvarComo Salvar &Como
Separador1 -
Fechar &Fechar
Menu Fonte (caption &Fonte)
Selecionar &Selecionar
Separador2 -
SelecionarCor Selecionar &Cor
4. Inclua um componente StatusBar no formulrio e atribua os seguintes valores s suas principais
propriedades:
Name: StatusBar1
SimplePanel: True
SimpleText: Nome do Arquivo:
Align: alBottom
5. Inclua um componente RichEdit e atribua os seguintes valores s suas principais propriedades:
Name: RichEdit1
Align: alClient
ScrollBars: ssBoth.
6. Apague o texto exibido pela propriedade Lines do componente RichEdit1.
7. Inclua um componente OpenDialog no formulrio e atribua os seguintes valores s suas
Name: OpenDialog1
Filter: Arquivos RTF|*.RTF
DefaultExt: RTF
8. Inclua um componente SaveDialog no formulrio e atribua os seguintes valores s suas principais
propriedades:
Name: SaveDialog1
Filter: Arquivos RTF|*.RTF
DefaultExt: RTF
9. Inclua um componente ColorDialog no formulrio e atribua os seguintes valores s suas
Name: ColorDialog1
10. Inclua um componente FontDialog no formulrio e atribua os seguintes valores s suas principais
propriedades:
Name: FontDialog1
Seu formulrio dever ficar com o aspecto apresentado na figura a seguir.
Figura 32.2: Aspecto do formulrio usado no aplicativo-exemplo.
Para codificar corretamente esse aplicativo, voc deve executar os seguintes procedimentos:
1. Declare as seguintes variveis globais na seo var unit associada ao formulrio:
A varivel booleana arquivoalterado armazena o estado de alterao do arquivo.
A varivel arquivoatual, do tipo string, armazena o nome do arquivo que est sendo manipulado.
2. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Novo do
menu Arquivo:
procedure TFormRTF.NovoClick(Sender: TObject);
begin
begin
mbOkCancel,0)= mrOk
then
RichEdit1.Lines.SaveToFile(arquivoatual);
end;
arquivoatual := ;
RichEdit1.Lines.Clear;
RichEdit1.Font.Style := RichEdit1.Font.Style - [fsBold];
RichEdit1.Font.Style := RichEdit1.Font.Style - [fsItalic];
RichEdit1.Font.Style := RichEdit1.Font.Style - [fsUnderline];
RichEdit1.Font.Style := RichEdit1.Font.Style - [fsStrikeOut];
end;
Inicialmente esse procedimento verifica se o arquivo foi alterado aps ter sido salvo pela ltima vez,
testando o valor da varivel arquivoalterado.
Caso o arquivo tenha sido alterado e no tenha sido salvo, ser exibida uma mensagem perguntando
ao usurio se deseja salvar as alteraes efetuadas. Caso o usurio queira salvar as alteraes, ser
executado o mtodo SaveToFile do componente RichEdit1.
Por fim, os valores default da fonte do componente RichEdit so restabelecidos, e uma string nula
atribuda varivel arquivoatual.
3. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Abrir do
menu Arquivo:
procedure TFormRTF.AbrirClick(Sender: TObject);
begin
then
begin
begin
then
end;
RichEdit1.Lines.LoadFromFile(arquivoAtual);
end;
end;
Esse procedimento exibe a caixa de dilogo padro para abertura de arquivos, mediante uma chamada
ao mtodo Execute do componente OpenDialog1. Caso o usurio selecione o boto Abrir dessa caixa
FileName do componente OpenDialog) armazenado na varivel arquivoatual.
O arquivo carregado usando-se o mtodo LoadFromFile da propriedade Lines do componente RichEdit
valor False varivel arquivoalterado (pois o arquivo acaba de ser carregado e portanto nenhuma
alterao foi feita).
Repare ainda que, caso o arquivo tenha sido alterado e essas alteraes no tenham sido salvas, solicita-
se uma confirmao por parte do usurio.
4. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Salvar Como
do menu Arquivo:
procedure TFormRTF.SalvarComoClick(Sender: TObject);
begin
then
begin
RichEdit1.Lines.SaveToFile(arquivoAtual);
end;
end;
Esse procedimento exibe a caixa de dilogo padro para gravao de arquivos, mediante uma chamada
ao mtodo Execute do componente SaveDialog1. Caso o usurio selecione o boto Salvar dessa caixa
FileName do componente SaveDialog) armazenado na varivel arquivoatual.
O arquivo gravado usando-se o mtodo SaveToFile da propriedade Lines do componente RichEdit
(propriedade esta que , conforme descrito anteriormente, um objeto da classe TStrings) e atribui-se o valor
False varivel arquivoalterado (pois o arquivo acaba de ser salvo e portanto nenhuma alterao foi feita).
Alm disso, o nome do arquivo atual atribudo propriedade SimpleText do componente StatusBar.
5. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Salvar do
menu Arquivo:
procedure TFormRTF.SalvarClick(Sender: TObject);
begin
if arquivoatual =
then
else
begin
end;
end;
Esse procedimento verifica, inicialmente, se ainda no foi atribudo um nome para o arquivo e, em
caso positivo, executa o procedimento associado ao evento OnClick do item Salvar Como do menu
Arquivo.
Caso o arquivo j tenha recebido um nome, as ltimas alteraes so salvas mediante uma chamada ao
mtodo SaveToFile da propriedade Lines do componente RichEdit. Conseqentemente, atribui-se o
valor False varivel arquivoalterado.
Por fim, o nome do arquivo atribudo propriedade SimpleText do componente StatusBar.
6. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Fechar do
menu Arquivo:
procedure TFormRTF.FecharClick(Sender: TObject);
begin
then
begin
begin
then
if arquivoatual =
then
else
end;
end;
end;
Esse procedimento verifica, inicialmente, se existem alteraes a serem gravadas e, em caso positivo,
pergunta ao usurio se deseja salvar as alteraes. Em caso positivo esse procedimento verifica se ainda
no foi atribudo um nome para o arquivo e, em caso positivo, executa o procedimento associado ao
evento OnClick do item Salvar Como do menu Arquivo (se no, executa o mtodo SaveToFile da
propriedade Lines do componente RichEdit1).
Por fim, a aplicao encerrada, mediante a execuo do mtodo Terminate do objeto Application, da
classe TApplication.
7. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Selecionar
do menu Fonte:
procedure TFormRTF.SelecionarClick(Sender: TObject);
begin
if RichEdit1.SelLength > 0
then
begin
if FontDialog1.Execute = True
then
begin
RichEdit1.SelAttributes.Assign(FontDialog1.Font)
end;
end;
end;
Inicialmente esse procedimento verifica se existe algum texto selecionado (analisando o valor da
propriedade SelLength do componente RichEdit1) e, em caso positivo, exibe a caixa de dilogo de
seleo de fonte, mediante uma chamada ao mtodo Execute do componente FontDialog1.
Caso o usurio selecione o boto Ok para fechar essa caixa de dilogo, a fonte escolhida nessa caixa de
dilogo ser atribuda ao texto selecionado do componente RichEdit, mediante a execuo da seguinte
linha de cdigo:
Por fim, atribui-se o valor True propriedade arquivoalterado, indicando que foram feitas alteraes, e
que estas ainda no foram salvas.
8. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Selecionar Cor
do menu Fonte:
procedure TFormRTF.SelecionarCorClick(Sender: TObject);
begin
then
begin
RichEdit1.SelAttributes.Color := ColorDialog1.Color;
end;
end;
Esse mtodo exibe a caixa de dilogo padro para seleo de cores, mediante uma chamada ao mtodo
Execute do componente ColorDialog1.
Caso o usurio, aps selecionar a cor desejada, selecione o boto Ok dessa caixa de dilogo, a mesma
ser fechada e retornar o valor True. A cor selecionada (e armazenada na propriedade Color do
componente ColorDialog) ser atribuda subpropriedade Color do texto selecionado no componente
RichEdit1. Alm disso, o valor True ser atribudo varivel arquivoalterado.
RichEdit1:
procedure TFormRTF.RichEdit1KeyPress(Sender: TObject; var Key: Char);
begin
end;
Esse procedimento apenas atribui o valor True propriedade arquivoalterado, indicando que o arquivo
sofreu modificao.
unit UnitRichEdit;
interface
uses
type
TFormRTF = class(TForm)
Arquivo: TMenuItem;
Abrir: TMenuItem;
Salvar: TMenuItem;
Fechar: TMenuItem;
Fonte1: TMenuItem;
Selecionar: TMenuItem;
Novo: TMenuItem;
RichEdit1: TRichEdit;
FontDialog1: TFontDialog;
procedure RichEdit1KeyPress(Sender: TObject; var Key: Char);
procedure SelecionarClick(Sender: TObject);
private
public
end;
var
FormRTF: TFormRTF;
implementation
{$R *.DFM}
procedure TFormRTF.AbrirClick(Sender: TObject);
begin
then
begin
begin
then
end;
RichEdit1.Lines.LoadFromFile(arquivoAtual);
end;
end;
procedure TFormRTF.NovoClick(Sender: TObject);
begin
begin
mbOkCancel,0)= mrOk
then
end;
arquivoatual := ;
RichEdit1.Lines.Clear;
RichEdit1.Font.Style := RichEdit1.Font.Style - [fsBold];
RichEdit1.Font.Style := RichEdit1.Font.Style - [fsItalic];
RichEdit1.Font.Style := RichEdit1.Font.Style - [fsUnderline];
RichEdit1.Font.Style := RichEdit1.Font.Style - [fsStrikeOut];
end;
procedure TFormRTF.SalvarComoClick(Sender: TObject);
begin
then
begin
end;
end;
procedure TFormRTF.SalvarClick(Sender: TObject);
begin
if arquivoatual =
then
else
begin
end;
end;
procedure TFormRTF.FecharClick(Sender: TObject);
begin
then
begin
begin
then
if arquivoatual =
then
else
end;
end;
end;
procedure TFormRTF.RichEdit1KeyPress(Sender: TObject; var Key: Char);
begin
end;
procedure TFormRTF.SelecionarClick(Sender: TObject);
begin
if RichEdit1.SelLength > 0
then
begin
if FontDialog1.Execute = True
then
begin
end;
end;
end;
procedure TFormRTF.SelecionarCorClick(Sender: TObject);
begin
then
begin
RichEdit1.SelAttributes.Color := ColorDialog1.Color;
end;
end;
end.
CAPTULO 33 MANIPULAO DE THREADS EM DELPHI
Captulo
Manipulao de Threads em Delphi
33
Neste captulo apresentaremos o conceito de Threads, que permitem que vrios processos sejam
executados simultaneamente em uma aplicao escrita em Delphi.
KNOW-HOW EM: THREADS
PR-REQUISITOS
Utilizao do Ambiente de Desenvolvimento Integrado do Delphi 7.
METODOLOGIA
Apresentao do conceito de Threads e processos.
TCNICA
Apresentao dos procedimentos necessrios utilizao de Threads em uma aplicao desenvolvida em Delphi.
O CONCEITO DE THREADS
Existem situaes em que pode ser desejvel que vrios processos sejam executados simultaneamente
pelo processador, isto , que uma tarefa no deva esperar o processamento completo de outra tarefa
para poder iniciar a sua execuo.
A palavra simultaneamente foi colocada entre aspas porque, exceto no caso de processamento paralelo
(mltiplos processadores em uma mesma mquina ou em um cluster), essa simultaneidade real
no possvel.
Nada impede, no entanto, que o processador possa dedicar uma parte do seu tempo a cada uma de
vrias tarefas (processos), de forma que para o usurio esse processamento parea simultneo.
Consideremos inicialmente a situao descrita a seguir.
Uma aplicao composta por um nico formulrio no qual so inseridos trs componentes ProgressBar
e dois botes de comando. Acrescenta-se manualmente classe do formulrio um mtodo chamado
Progresso, que incrementa o valor da propriedade Position de um componente ProgressBar (passado
como parmetro na chamada ao mtodo) a partir de um valor inicial definido pela sua propriedade
Min, at atingir o valor mximo definido pela sua propriedade Max.
O aspecto desse formulrio e a unidade de cdigo associada so apresentados na Figura 33.1.
Para que os efeitos destes exemplos possam ser visualizados com maior nitidez, altere a propriedade
Max de cada componente ProgressBar para 10000.
UNIDADE DE CDIGO ASSOCIADA:
unit UnitPBThread;
interface
uses
StdCtrls, Buttons, ComCtrls;
type
TFormThread = class(TForm)
ProgressBar1: TProgressBar;
BotaoIniciar: TBitBtn;
procedure BotaoIniciarClick(Sender: TObject);
private
public
procedure Progresso(PB : TProgressBar);
end;
var
FormThread: TFormThread;
implementation
{$R *.DFM}
{ TFormThread }
procedure TFormThread.Progresso(PB: TProgressBar);
begin
While (PB.Position < PB.Max) do
PB.Position := PB.Position+1;
end;
procedure TFormThread.BotaoIniciarClick(Sender: TObject);
begin
ProgressBar1.Position := 0;
Progresso(Progressbar1);
end;
end.
Ao executar essa aplicao e selecionar o boto Iniciar, verifica-se que cada componente ProgressBar
atualiza o valor da sua propriedade Position de forma independente. Os valores da segunda ProgressBar
s comeam a ser atualizados aps o valor da primeira atingir o seu valor mximo, e os valores da
terceira ProgressBar s comeam a ser atualizados aps o valor da segunda atingir o seu valor mximo.
Evidentemente, isso se deve ao fato de que o processo representado pelo mtodo Progresso executado
uma vez para cada componente, e cada novo processo s se inicia aps o processo anterior ter sido concludo.
A figura a seguir apresenta a execuo do segundo processo (aps a concluso do primeiro), sendo
efetuado antes de se iniciar a execuo do terceiro processo.
Figura 33.2: Execuo independente dos diversos processos.
Para permitir a execuo de vrios processos simultaneamente, o Delphi utiliza o conceito de Threads,
implementado atravs da classe TThread.
A classe TThread, definida na unit Classes, a classe-base para todos os processos a serem implementados
e manipulados pela aplicao, sendo descrita no prximo tpico.
A CLASSE TTHREAD
Conforme descrito anteriormente, cada processo a ser executado em uma aplicao pode ser representado
por um objeto de uma classe derivada da classe TThread.
A necessidade de se derivar uma classe a partir da classe TThread se deve ao fato de que o mtodo
Execute, responsvel pela execuo do processo, definido como um mtodo abstrato na classe TThread.
Conseqentemente, para criar um processo, voc deve inicialmente criar uma classe derivada da classe
TThread e obrigatoriamente implementar o seu mtodo Execute.
Para facilitar a criao de novas classes derivadas de TThread voc pode executar os seguintes procedimentos:
1. Selecionar o item New/Other do menu File do Delphi 7 para exibir a caixa de dilogo New Items.
2. Selecionar o item Thread Object da pgina New dessa caixa de dilogo e o boto Ok, para
exibir a caixa de dilogo New Thread Object mostrada na Figura 33.3, na qual deve ser digitado
o nome da classe que representar o novo processo.
Figura 33.3: A caixa de dilogo New Thread Object.
Nesta verso do Delphi voc pode dar um nome a uma Thread de modo a identific-la durante a depurao de um programa que
executa mltiplas Threads. Neste caso, marque a caixa de verificao Named Thread existente na caixa de dilogo New Thread Object,
e defina o nome da Thread na caixa de texto Named Thread. Neste caso, ser ainda criado um outro mtodo, chamado SetName, na
classe da Thread, e que ser o primeiro mtodo a ser disparado quando a Thread estiver sendo executada.
3. Selecione o boto Ok para fechar essa caixa de dilogo. Ser gerado o esqueleto dessa nova
classe, como mostrado a seguir.
unit UnitPBarThread;
interface
uses
Classes;
type
TPBarThread = class(TThread)
private
protected
procedure Execute; override;
end;
implementation
{ Important: Methods and properties of objects in VCL can only be used in a
method called using Synchronize, for example,
Synchronize(UpdateCaption);
and UpdateCaption could look like,
procedure TPBarThread.UpdateCaption;
begin
Form1.Caption := Updated in a thread;
end; }
{ TPBarThread }
procedure TPBarThread.Execute;
begin
{ Place thread code here }
end;
end.
Repare que a definio do mtodo Execute to importante ela j foi gerada automaticamente, juntamente
com um comentrio que indica onde deve ser definido o cdigo da thread.
Ainda aparece comentado um trecho em que se informa que alteraes de propriedades e chamadas de
mtodos de objetos da VCL s podem ser feitas a partir de uma chamada ao mtodo Synchronize
(implementado na classe-base). Dessa maneira, qualquer mtodo que altere uma propriedade de um
componente da VCL deve ser executado passando-se o seu nome como parmetro na chamada ao
mtodo Sinchronize da Thread.
O mtodo construtor da classe TThread, por sua vez, tem um parmetro que indica se a execuo do
processo representado pelo objeto deve ser iniciada assim que o objeto for criado. Para iniciar
imediatamente o processo, voc deve passar o valor False na chamada do construtor.
Caso o objeto seja criado passando-se como parmetro o valor True, voc deve reiniciar posteriormente
a execuo do processo mediante uma chamada ao mtodo Resume da classe TThread. Por outro lado,
para suspender posteriormente a execuo do processo, basta executar o mtodo Suspend da classe (os
mtodos Resume e Suspend no tm parmetros).
Para finalizar a qualquer tempo a execuo de um processo, voc deve usar o mtodo Terminate da
thread (que atribui o valor True propriedade Terminated do objeto que representa o processo). Nesse
caso, se a propriedade FreeOnTerminated do objeto que representa o processo for definida como True,
a memria alocada para o objeto pelo seu construtor ser liberada (caso o valor da propriedade
FreeOnTerminated seja igual a False, deve-se chamar explicitamente o seu mtodo Free).
O mtodo Execute de uma thread deve verificar periodicamente o valor da propriedade Terminated do
objeto que representa a Thread, e finalizar a sua execuo caso o valor dessa propriedade seja igual a True.
Voc pode definir diferentes nveis de prioridade para cada processo, definindo-se adequadamente o
valor da propriedade Priority do objeto que o representa. Essa propriedade pode assumir os valores
descritos na tabela a seguir.
A utilizao dessa propriedade til quando voc quer, por exemplo, que o sistema execute um backup
de dados enquanto o usurio executa outras tarefas mais importantes.
IMPLEMENTANDO A CLASSE TPBTHREAD
Apresenta-se a seguir o cdigo da unit que implementa a thread que ser utilizada no nosso exemplo.
unit UnitPBarThread;
interface
uses
Classes, ComCtrls;
type
TPBarThread = class(TThread)
private
FPB: TProgressBar;
protected
procedure Execute; override;
procedure Progresso;
public
constructor Cria(PB: TProgressBar);
end;
implementation
{ Important: Methods and properties of objects in VCL can only be used in a
method called using Synchronize, for example,
Synchronize(UpdateCaption);
and UpdateCaption could look like,
procedure TPBarThread.UpdateCaption;
begin
Form1.Caption := Updated in a thread;
end; }
{ TPBarThread }
constructor TPBarThread.Cria(PB: TProgressBar);
begin
Create(False);
FPB := PB;
FreeOnTerminate := True;
end;
Valor Significado
TpIdle Indica uma prioridade de uma Thread que s ser executada se o sistema entrar em um
estado Idle (repouso).
TpLowest Indica uma prioridade de dois pontos abaixo do normal.
TpLower Indica uma prioridade de um ponto abaixo do normal.
TpNormal Indica uma prioridade igual dada Thread principal da aplicao (normal).
TpHigher Indica uma prioridade de um ponto acima do normal.
TpHighest Indica uma prioridade de dois pontos acima do normal.
TpTimeCritical Mais alta prioridade.
procedure TPBarThread.Execute;
begin
{ Place thread code here }
While (FPB.Position < FPB.Max) do Synchronize(Progresso);
end;
procedure TPBarThread.Progresso;
begin
FPB.Position := FPB.Position + 1;
end;
end.
Repare que a classe tem como propriedade um objeto da classe TProgressBar (razo pela qual a unit
ComCttls foi includa na clusula uses da unit que declara a classe da TThread).
Observe que o objeto manipulado pela Thread passado como parmetro na chamada do mtodo
construtor Cria da classe, e que este chama o mtodo Create construtor da classe-base com o valor
False, para que a execuo do processo seja iniciada automaticamente.
Atribui-se ainda o valor True propriedade FreeOnTerminated do objeto, para que a memria alocada
seja liberada automaticamente ao se terminar a execuo do processo.
REDEFININDO O CDIGO DA UNIT ASSOCIADA AO FORMULRIO
Apresenta-se a seguir o cdigo da unit associada ao formulrio do nosso exemplo.
unit UnitPBThread;
interface
uses
StdCtrls, Buttons, ComCtrls;
type
TFormThread = class(TForm)
BotaoIniciar: TBitBtn;
Botaofechar: TBitBtn;
procedure BotaoIniciarClick(Sender: TObject);
private
public
end;
var
FormThread: TFormThread;
implementation
uses UnitPBarThread;
{$R *.DFM}
procedure TFormThread.BotaoIniciarClick(Sender: TObject);
var
PBarThread1, PBarThread2, PBarThread3 : TPBarThread;
begin
PBarThread1 := TPBarThread.Cria(Progressbar1);
end;
end.
Repare que, no procedimento associado ao evento OnClick do boto Iniciar, so declarados trs objetos
da classe TPBarThread, instanciados mediante uma chamada ao mtodo Cria da classe.
A Figura 33.4 apresenta a execuo simultnea dos processos.
Evidentemente o exemplo utilizado neste captulo bastante simples, e poderia ter sido criado utilizando-
se outras tcnicas. O objetivo deste exemplo, no entanto, foi apresentar de forma clara e didtica os
conceitos bsicos relacionados execuo simultnea de vrios processos. Na prtica, esses processos
podem ser muito mais complexos, e sua soluo s se torna possvel mediante a utilizao de threads.
CAPTULO 34 IMPLEMENTAO DA TECNOLOGIA COM EM DELPHI
Captulo
Implementao da Tecnologia
COM em Delphi
34
Neste captulo, apresentaremos a tecnologia COM (Component Object Model) e como seus conceitos
so implementados em Delphi. Esta tecnologia est presente apenas no ambiente Windows, razo pela
qual s se aplica a projetos baseados na VCL.
KNOW-HOW EM: TECNOLOGIA COM
PR-REQUISITOS
Fundamentos da linguagem Object Pascal.
Utilizao do ambiente de desenvolvimento integrado do Delphi.
METODOLOGIA
Apresentao dos conceitos relacionados tecnologia COM, e sua implementao em Delphi.
TCNICA
Apresentao dos procedimentos necessrios criao de objetos COM em Delphi.
A TECNOLOGIA COM
A tecnologia COM (na qual esto baseadas as tecnologias OLE e ActiveX) compreende uma especificao
definida pela Microsoft para a criao de componentes reutilizveis de software.
Como essa especificao define componentes em um formato binrio, sua implementao e utilizao
podem, a princpio, ser feitas em qualquer linguagem e sistema operacional.
Assim como um objeto da VCL, um objeto COM pode apresentar uma srie de funcionalidades,
disponibilizadas atravs das suas interfaces (interfaces so semelhantes a classes, pois renem em uma
nica entidade vrias funes e procedimentos).
Uma interface, conforme descrito anteriormente, pode declarar vrios mtodos. Entretanto, importante
salientar que uma interface apenas declara os mtodos sem implement-los. Conseqentemente,
uma interface muito semelhante a uma classe que declara apenas mtodos abstratos.
A implementao desses mtodos deixada a cargo de uma classe denominada CoClass, que pode implementar
uma ou mais interfaces (devendo, no entanto, implementar todos os mtodos de cada interface).
Alm disso, diferentemente de uma classe que identificada por um nome uma interface
identificada por um nmero, denominado GUID (Global Unique Identifier), que identifica
univocamente uma interface (ao menos estatisticamente).
Esse nmero definido em Delphi como um tipo composto, declarado da seguinte maneira na unit
System.pas:
TGUID = record
D1: LongWord;
D2: Word;
D3: Word;
D4: array[0..7] of Byte;
end;
Voc no precisa, no entanto, se preocupar em gerar esse nmero, pois o Delphi cuidar dessa tarefa
para voc sempre que se criar um novo objeto COM.
Se, por alguma razo, voc precisar gerarexplicitamente um GUID, basta pressionar simultaneamente as teclas Ctrl, Shift e G no editor
de cdigos do Delphi.
Um objeto COM deve ser instanciado sempre que uma aplicao precisar utilizar seus servios
(implementados atravs das suas interfaces), e pode ser utilizado por vrias aplicaes simultaneamente.
Alm disso, quando no estiver sendo mais utilizado, deve ser capaz de se autodestruir (e liberar a
memria utilizada).
Para que isso seja possvel, a especificao COM determina que cada objeto deve ser capaz de armazenar
internamente o nmero de clientes que esto utilizando os seus servios (esses clientes podem ser
aplicaes ou DLLs chamados genericamente de processos na literatura) e implementar ao menos os
seguintes mtodos:
AddRef, que incrementa em uma unidade o valor armazenado internamente (que indica o
nmero de clientes do objeto) sempre que um novo cliente solicitar os seus servios.
Release, que decrementa em uma unidade o valor armazenado internamente (que indica o
nmero de clientes do objeto) sempre que um novo cliente no precisar mais dos seus servios
(sempre que a aplicao-cliente for encerrada, por exemplo).
QueryInterface, que informa as interfaces implementadas pelo objeto.
Esses mtodos so declarados em uma interface denominada IUnknown, da qual so derivadas as
demais interfaces. Pode-se, portanto, dizer que IUnknown est para uma interface assim como TObject
est para uma classe.
Para facilitar a vida do programador, o Delphi declara a classe TInterfacedObject que implementa a
interface IUnknown.
Essa classe declarada da seguinte maneira na unit System.pas:
TInterfacedObject = class(TObject, IUnknown)
protected
FRefCount: Integer;
function QueryInterface(const IID: TGUID; out Obj): Integer; stdcall;
function _AddRef: Integer; stdcall;
function _Release: Integer; stdcall;
public
property RefCount: Integer read FRefCount;
end;
Um objeto pode referenciar mais de uma interface simultaneamente, o que permite simular o conceito
de herana mltipla.
A seguir, apresentamos a implementao desses mtodos na unit System.pas.
procedure TInterfacedObject.BeforeDestruction;
begin
if RefCount <> 0 then Error(reInvalidPtr);
end;
function TInterfacedObject.QueryInterface(const IID: TGUID; out Obj): HResult;
const
E_NOINTERFACE = $80004002;
begin
if GetInterface(IID, Obj) then Result := 0 else Result := E_NOINTERFACE;
end;
function TInterfacedObject._AddRef: Integer;
begin
Result := InterlockedIncrement(FRefCount);
end;
function TInterfacedObject._Release: Integer;
begin
Result := InterlockedDecrement(FRefCount);
if Result = 0 then
Destroy;
end;
No se preocupe se voc no compreende a implementao desses mtodos, pois voc no precisar
manipul-los diretamente. importante, no entanto, saber que os mesmos foram realmente
implementados na classe TInterfacedObject.
Observe a definio da classe TComObject (na unit comobj) que implementa duas interfaces:
TComObject = class(TObject, IUnknown, ISupportErrorInfo)
private
FController: Pointer;
FFactory: TComObjectFactory;
FNonCountedObject: Boolean;
FRefCount: Integer;
FServerExceptionHandler: IServerExceptionHandler;
function GetController: IUnknown;
protected
{ IUnknown }
function IUnknown.QueryInterface = ObjQueryInterface;
function IUnknown._AddRef = ObjAddRef;
function IUnknown._Release = ObjRelease;
{ IUnknown methods for other interfaces }
function QueryInterface(const IID: TGUID; out Obj): HResult; stdcall;
function _AddRef: Integer; stdcall;
function _Release: Integer; stdcall;
{ ISupportErrorInfo }
function InterfaceSupportsErrorInfo(const iid: TIID): HResult; stdcall;
public
constructor Create;
constructor CreateAggregated(const Controller: IUnknown);
constructor CreateFromFactory(Factory: TComObjectFactory;
const Controller: IUnknown);
procedure Initialize; virtual;
function ObjAddRef: Integer; virtual; stdcall;
function ObjQueryInterface(const IID: TGUID; out Obj): HResult; virtual; stdcall;
function ObjRelease: Integer; virtual; stdcall;
function SafeCallException(ExceptObject: TObject;
ExceptAddr: Pointer): HResult; override;
property Controller: IUnknown read GetController;
property Factory: TComObjectFactory read FFactory;
property RefCount: Integer read FRefCount;
property ServerExceptionHandler: IServerExceptionHandler
read FServerExceptionHandler write FServerExceptionHandler;
end;
Criando um Objeto COM em Delphi
Para criar um objeto COM em Delphi, voc deve executar os seguintes procedimentos:
1. Fechar todos os projetos abertos no Delphi 7.
3. Selecionar o item ActiveX Library na pgina ActiveX dessa caixa de dilogo.
4. Selecionar novamente o item New/Other do menu File do Delphi 7, para exibir a caixa de
dilogo New Items.
5. Selecionar o item COM Object na pgina ActiveX dessa caixa de dilogo.
6. Selecionar o boto Ok, para fechar essa caixa de dilogo e exibir a caixa de dilogo COM Object
Wizard, mostrada na figura a seguir.
Figura 34.1: A caixa de dilogo COM Object Wizard.
7. Preencher essa caixa de dilogo como indicado na figura anterior.
8. Selecionar o boto Ok para fechar essa caixa de dilogo.
Como foi selecionada a opo Include Type Library, ser exibido o Type Library Editor, mostrado
na Figura 34.12.
Figura 34.2: O Type Library Editor.
ADICIONANDO E IMPLEMENTANDO UM MTODO INTERFACE IUTILITARIO
Para adicionar um mtodo interface IUtilitario, criada no tpico anterior para o nosso
objeto COM, voc deve executar os seguintes procedimentos:
1. Clicar com o boto direito do mouse sobre o nome da Interface e, no menu pop-up que ser
exibido, selecionar o item Method, do submenu New, como mostrado na figura a seguir, ou
selecionar o boto correspondente na barra de botes do Type Library Editor.
Figura 34.3: Adicionando um mtodo a uma interface.
2. Definir um nome para o mtodo (nesse caso denominamos esse mtodo de GetData). Seu
cabealho ser gerado automaticamente, como pode ser visto selecionando-se a guia Text no
painel direito do Type Library Editor (veja a figura a seguir).
Figura 34.4: Visualizando o cabealho de um mtodo no Type Library Editor.
3. Altere o tipo de retorno do mtodo como indicado na Figura 34.5 e selecione o boto Refresh.
Repare que o cabealho do mtodo passa a referenciar este tipo de parmetro, como mostrado
na Figura 34.6.
Figura 34.5: Alterando o tipo de retorno do mtodo.
4. Selecione o boto Refresh Implementation na caixa de dilogo Type Library Editor, para gerar a
implementao do mtodo GetDate.
O Delphi gera automaticamente uma unit na qual devem ser implementados os mtodos da interface
e um arquivo com o mesmo nome do projeto mas acrescido com o sufixo _TLB de extenso .pas no
qual implementado o objeto COM.
Figura 34.6: Visualizando a alterao do cabealho do mtodo no Type Library Editor.
Como nesse caso foi criado um projeto novo, chamado Project1, foram ento criados os arquivos
Project1_TLB.pas e Unit1.pas, reproduzidos a seguir.
Arquivo Unit1.pas:
unit Unit1;
interface
uses
Windows, ActiveX, Classes, ComObj, Project1_TLB, StdVcl;
type
TUtilitario = class(TTypedComObject, IUtilitario)
protected
function GetData: TDateTime; stdcall;
{Declare IUtilitario methods here}
end;
implementation
uses ComServ;
function TUtilitario.GetData: TDateTime;
begin
end;
initialization
TTypedComObjectFactory.Create(ComServer, TUtilitario, Class_Utilitario,
ciMultiInstance, tmApartment);
end.
Arquivo Project1_TLB.pas:
unit Project1_TLB;
// ************************************************************************ //
// WARNING
// -
// The types declared in this file were generated from data read from a
// Type Library. If this type library is explicitly or indirectly (via
// another type library referring to this type library) re-imported, or the
// Refresh command of the Type Library Editor activated while editing the
// Type Library, the contents of this file will be regenerated and all
// manual modifications will be lost.
// ************************************************************************ //
// PASTLWTR : 1.2
// File generated on 21/4/2003 23:45:16 from Type Library described below.
// ************************************************************************ //
// Type Lib: C:\Arquivos de programas\Borland\Delphi7\Projects\Project1.tlb (1)
// LIBID: {E47B5749-BDFD-4624-B397-ECE4170ABCC8}
// LCID: 0
// Helpfile:
// HelpString: Project1 Library
// DepndLst:
// (1) v2.0 stdole, (C:\WINDOWS\System32\stdole2.tlb)
// ************************************************************************ //
{$TYPEDADDRESS OFF} // Unit must be compiled without type-checked pointers.
{$WRITEABLECONST ON}
{$VARPROPSETTER ON}
interface
uses Windows, ActiveX, Classes, Graphics, StdVCL, Variants;
// *********************************************************************//
// GUIDS declared in the TypeLibrary. Following prefixes are used:
// Type Libraries : LIBID_xxxx
// CoClasses : CLASS_xxxx
// DISPInterfaces : DIID_xxxx
// Non-DISP interfaces: IID_xxxx
// *********************************************************************//
const
// TypeLibrary Major and minor versions
Project1MajorVersion = 1;
Project1MinorVersion = 0;
LIBID_Project1: TGUID = {E47B5749-BDFD-4624-B397-ECE4170ABCC8};
IID_IUtilitario: TGUID = {0CF82A81-3789-4245-BC57-44980481DC95};
CLASS_Utilitario: TGUID = {BA9313AC-BA71-4EBC-AB71-D2604975AD71};
type
// *********************************************************************//
// Forward declaration of types defined in TypeLibrary
// *********************************************************************//
IUtilitario = interface;
// *********************************************************************//
// Declaration of CoClasses defined in Type Library
// (NOTE: Here we map each CoClass to its Default Interface)
// *********************************************************************//
Utilitario = IUtilitario;
// *********************************************************************//
// Interface: IUtilitario
// Flags: (256) OleAutomation
// GUID: {0CF82A81-3789-4245-BC57-44980481DC95}
// *********************************************************************//
IUtilitario = interface(IUnknown)
[{0CF82A81-3789-4245-BC57-44980481DC95}]
function GetData: TDateTime; stdcall;
end;
// *********************************************************************//
// The Class CoUtilitario provides a Create and CreateRemote method to
// create instances of the default interface IUtilitario exposed by
// the CoClass Utilitario. The functions are intended to be used by
// clients wishing to automate the CoClass objects exposed by the
// server of this typelibrary.
// *********************************************************************//
CoUtilitario = class
class function Create: IUtilitario;
class function CreateRemote(const MachineName: string): IUtilitario;
end;
implementation
uses ComObj;
class function CoUtilitario.Create: IUtilitario;
begin
Result := CreateComObject(CLASS_Utilitario) as IUtilitario;
end;
class function CoUtilitario.CreateRemote(const MachineName: string): IUtilitario;
begin
Result := CreateRemoteComObject(MachineName, CLASS_Utilitario) as IUtilitario;
end;
end.
Repare que a interface IUtilitario tem um mtodo chamado GetData, que implementado pela sua
CoClass TUtilitario.
A implementao da funo GetData deve ser feita da seguinte maneira no arquivo Unit1.pas:
function TUtilitario.GetData: TDateTime;
begin
result := Date;
end;
Voc deve, evidentemente, incluir a unit SysUtils na clusula Uses da unit que implementa o mtodo. Se isso no for feito, sero gerados
erros de compilao.
A definio de propriedades feita de maneira semelhante, bastando selecionar o boto correspondente
e definir corretamente seus atributos.
COMPILANDO E REGISTRANDO O OBJETO COM NO SEU SISTEMA
Para compilar e registrar seus objetos, voc deve executar os seguintes procedimentos:
1. Selecione File/Save All no menu do Delphi 7. Salve a Unit com o nome unitUtilitrio e o
projeto, com o nome ProjectUtilitario.
2. Compile o projeto.
3. Registre o componente, selecionando o item Register ActiveX Server do menu Run. Caso o
registro seja feito com sucesso, ser exibida uma mensagem indicando que o registro foi feito,
como mostrado na figura a seguir.
Figura 34.7: A caixa de dilogo Run Parameters.
CRIANDO UMA APLICAO QUE UTILIZE O OBJETO COM
Para criar uma aplicao que use esse objeto, voc deve executar os seguintes procedimentos:
1. Inicie uma nova aplicao, selecionando o item New Application do menu File.
2. Altere o valor da propriedade Name do formulrio para FormData.
3. Altere o valor da propriedade Caption do formulrio para Exemplo de Utilizao de Objetos
COM.
4. Inclua um boto de comando centralizado no formulrio.
5. Altere o valor da propriedade Name do boto de comando para BotaoData.
6. Altere o valor da propriedade Caption do boto de comando para Exibir Data.
7. Inclua as units ComObj e PUtilitario_TLB na clusula Uses da unit associada ao formulrio.
8. Salve a unit associada ao formulrio com o nome UnitUsaCOM.pas.
9. Salve o projeto com o nome ProjectUsaCOM.dpr
10. Defina da seguinte maneira o procedimento associado ao evento OnClick do boto de comando:
procedure TFormData.BotaoDataClick(Sender: TObject);
var
Utilitario:IUtilitario;
begin
Utilitario := CoUtilitario.Create;
ShowMessage(DateToStr(Utilitario.GetData));
end;
Dessa maneira, quando a aplicao for executada, o objeto COM ser carregado na memria e, quando
o usurio selecionar o boto, a data corrente do sistema ser exibida.
A TECNOLOGIA OLE
A tecnologia OLE , na realidade, uma extenso da tecnologia COM.
No prximo captulo, ser criada uma aplicao multicamada bastante simples, que acessa uma base
de dados atravs de um componente TClientDataset e que utiliza a tecnologia Datasnap (antiga MIDAS),
baseada na tecnologia OLE.
CAPTULO 35 APLICAES MULTICAMADAS
Captulo
Aplicaes Multicamadas
35
Neste captulo, apresentaremos uma introduo tecnologia Datasnap antiga MIDAS (Multi-tier Distrib-
uted Applications Services Suite), que permite o desenvolvimento de aplicaes denominadas multicamadas.
KNOW-HOW EM: APLICAES MULTICAMADAS
PR-REQUISITOS
Fundamentos da linguagem Object Pascal.
Utilizao do ambiente de desenvolvimento integrado do Delphi.
Utilizao dos componentes de acesso e visualizao de bancos de dados.
METODOLOGIA
Apresentao dos conceitos relacionados tecnologia MIDAS, e sua implementao em Delphi.
TCNICA
Apresentao dos procedimentos necessrios criao de aplicaes multicamadas em Delphi.
APRESENTANDO A TECNOLOGIA
Uma aplicao multicamadas deve ser composta de pelo menos trs camadas:
A camada da aplicao-cliente, responsvel pela interao do usurio com o sistema (tambm
denominada camada de interface).
A camada da aplicao servidora, tambm denominada aplicao intermediria, responsvel por
receber e enviar informaes de/para a aplicao-cliente e de/para o servidor de banco de dados.
Uma camada de armazenamento de informaes, correspondendo ao servidor de bancos de dados.
A CAMADA DE ARMAZENAMENTO DE INFORMAES
A camada de armazenamento de informaes representada pelo banco de dados, o qual pode ser
local ou remoto.
Neste captulo, a fim de simplificar o entendimento por parte do leitor, e a reproduo dos exemplos
apresentados, utilizaremos um banco de dados local, mas isso no compromete de forma alguma a
apresentao dos conceitos fundamentais relacionados a este tpico.
Podemos por exemplo utilizar um banco de dados local, como a tabela Country.db, que acompanha o
Delphi, configurada com o alias DBDEMOS.
A CAMADA INTERMEDIRIA A CAMADA SERVIDORA
Numa aplicao multicamadas, uma aplicao-cliente jamais acessa diretamente a camada de
informaes esse acesso feito por uma aplicao servidora qual se podem conectar diversas
aplicaes clientes.
Uma aplicao servidora deve ter um objeto da classe TRemoteDataModule, no qual sero includos os
componentes de acesso a bancos de dados, a menos que se estejam usando clientes CORBA (quando se
deve usar um objeto TCORBADataModule) ou servidores definidos como DLLs instaladas com o
Microsoft Transaction Server (quando se deve usar um objeto TMTSDataModule).
DCOM um subconjunto de COM, e que se aplica distribuio e acesso a objetos COM atravs de uma rede local ou da Internet.
Para criar uma aplicao servidora, voc deve executar os seguintes procedimentos:
1. Iniciar um novo projeto de aplicao, selecionando o item New Application do menu File.
2. Selecionar o item New/Other do menu File para exibir a caixa de dilogo New Items.
3. Selecionar o item Remote DataModule da pgina MultiTier dessa caixa de dilogo.
4. Selecionar o boto Ok dessa caixa de dilogo. Ser exibida a caixa de dilogo Remote Data
Module Wizard, mostrada na figura a seguir, na qual dever ser fornecido o nome do objeto a
ser criado.
Figura 35.1: A caixa de dilogo Remote Data Module Wizard.
Neste exemplo, o objeto Remote Data Module foi denominado Dados. Repare que foram criadas duas
units, denominadas Project1_TLB.pas (associada aos objetos COM a serem criados no servidor) e
Unit2.pas (associada ao objeto Dados recm-criado).
5. Altere o valor da propriedade Name do formulrio de Form1para FormServer.
6. Altere o valor da propriedade Caption do formulrio para Exemplo de Aplicao Servidora.
7. Salve a unit associada ao formulrio com o nome UnitServerPrincipal.pas.
8. Coloque um componente Table (pgina BDE da paleta de componentes) no objeto Dados e
atribua os seguintes valores para as suas principais propriedades:
Name: TblCountry
TableName: Country.db
Active: True
9. Coloque um componente DatasetProvider (o terceiro componente da pgina Data Access da paleta
de componentes) no objeto Dados e atribua os seguintes valores para as suas principais propriedades:
Name: ProviderCountry
Dataset: TblCountry
Seu objeto RemoteDataModule dever ficar com o aspecto mostrado na figura a seguir.
Figura 35.2: Aspecto do objeto RemoteDataModule Objeto Dados,
aps a incluso dos objetos Table e DatasetProvider.
10. Salve a unit associada ao objeto RemoteDataModule com o nome UnitServerDados.
11. Salve o projeto com o nome ProjectServerDados. Repare que o nome da unit Project1_TLB
automaticamente modificado para ProjectServerDados_TLB, e corresponde a uma biblioteca
de tipos e objetos COM.
12. Exiba a caixa de dilogo Run Parameters, selecionando o item Parameters do menu Run, e
digite a expresso /regserver na caixa de texto Parameters, como mostrado na figura a seguir.
Figura 35.3: A caixa de dilogo Run Parameters.
13. Selecione o boto Ok para fechar a caixa de dilogo Run Parameters.
14. Execute a aplicao servidora, selecionando o item Run do menu Run. A aplicao ser executada
e encerrada imediatamente, tendo como nico objetivo registr-la no sistema.
15. Exiba novamente a caixa de dilogo Run Parameters, selecionando o item Parameters do menu
Run, e deixe em branco a caixa de texto Parameters dessa caixa de dilogo.
16. Selecione o boto Ok para fechar a caixa de dilogo Run Parameters.
17. Selecione o item Build ProjectServerDados do menu Project para recompilar a aplicao servidora.
CRIANDO A CAMADA DE INTERFACE COM O USURIO (A APLICAO-CLIENTE)
Para criar a aplicao-cliente, voc deve executar os seguintes procedimentos:
1. Iniciar um novo projeto de aplicao, selecionando o item New/Application do menu File.
2. Selecionar o item New/Other do menu File para exibir a caixa de dilogo New Items.
3. Selecionar o item DataModule da pgina New dessa caixa de dilogo.
4. Selecionar o boto Ok para fechar essa caixa de dilogo e criar o objeto DataModule.
5. Altere o valor da propriedade Name desse DataModule para Dados.
6. Salve a unit associada a esse DataModule com o nome UnitClienteDados.pas.
7. Altere o valor da propriedade Name do formulrio criado no passo 1 para FormCliente.
8. Altere o valor da propriedade Caption desse formulrio para Exemplo de Aplicao-Cliente.
9. Salve a unit associada a esse formulrio com o nome UnitClientePrincipal.pas.
10. Salve esse projeto com o nome ProjectCliente.dpr.
11. Inclua um componente DCOMConnection (primeiro componente da pgina Datasnap da paleta
de componentes) no DataModule e atribua os seguintes valores s suas principais propriedades:
Name: DCOMConnection1 (seu valor default).
ServerName: ProjectServer.Dados (Se voc registrou corretamente sua aplicao servidora,
esse valor deve aparecer entre as opes disponveis para o valor desta propriedade.)
Connected: True
Observe que, ao se definir o valor da propriedade ServerName do componente DCOMConnection, o valor da propriedade ServerGUID
automaticamente preenchido com o identificador do objeto COM que representa o servidor. Observe ainda que, ao se definir o valor
da propriedade Connected como igual a True, a aplicao servidora inicializada (mantenha-a aberta no Windows, embora voc possa
minimiz-la, enquanto configura as demais propriedades da aplicao cliente).
12. Inclua um componente ClientDataset (segundo componente da pgina Data Access da paleta
de componentes) no DataModule e atribua os seguintes valores s suas principais propriedades:
Name: ClientDataset1 (seu valor default).
RemoteServer: DcomConnection1 (Esse valor deve ser exibido entre as opes disponveis
para o valor desta propriedade.)
ProviderName: ProviderCountry (Esse valor deve ser exibido entre as opes disponveis
para o valor dessa propriedade.)
Active: True.
13. Inclua um componente DataSource no DataModule e atribua os seguintes valores s suas
Name: ClienteSource
DataSet: ClientDataset1(Esse valor deve ser exibido entre as opes disponveis para o valor
dessa propriedade.)
Desse ponto em diante, tudo se passa como se estivssemos em uma aplicao Desktop. De qualquer
forma vamos concluir este exemplo de forma que no permanea qualquer dvida relativa aos
conceitos apresentados.
14. Selecione o formulrio principal da aplicao-cliente.
15. Selecione o item Uses Unit do menu File, para incluir a unit UnitClienteDados na clusula
Uses da unit associada a esse formulrio.
16. Inclua um componente DBGrid no formulrio e defina os seguintes valores para as suas principais
propriedades:
Name: DBGridCountry
DataSource: Dados.ClienteSource
Os dados provenientes da aplicao servidora sero automaticamente visualizados no DBGrid, como
mostra a figura a seguir.
Figura 35.4: Visualizando os dados em um DBGrid.
Pronto! Sua aplicao-cliente (ainda que simplria) j pode ser executada.
O importante neste tpico que voc compreenda os conceitos de aplicaes multicamadas.
Voc pode definir as regras do negcio usando um objeto RemoteDataModule em uma aplicao
servidora, no qual so inseridos vrios componentes Table, Query, StoredProc, etc
Evidentemente, voc deve considerar o fato de que cada aplicao-cliente tem sua prpria cpia dos
dados (manipulados pelo componente ClientDataset), e que os conflitos resultantes do acesso de
vrias aplicaes devem ser resolvidos nos procedimentos associados a eventos dos componentes da
classe TDatasetProvider.
Embora isso no tenha sido citado explicitamente neste tpico, o desenvolvimento de aplicaes
servidoras tambm est baseado na tecnologia COM/DCOM.
Se voc observar o projeto Pserver.dpr, ver que o mesmo tem uma unit denominada
ProjectServerDados_TBL.pas (cujo cdigo reproduzido a seguir), na qual so definidos os objetos
COM atravs dos quais se d acesso s interfaces IProvider implementadas.
unit ProjectServerDados_TLB;
// ************************************************************************ //
// WARNING
//
// The types declared in this file were generated from data read from a
// Type Library. If this type library is explicitly or indirectly (via
// another type library referring to this type library) re-imported, or the
// Refresh command of the Type Library Editor activated while editing the
// Type Library, the contents of this file will be regenerated and all
// manual modifications will be lost.
// ************************************************************************ //
// PASTLWTR : 1.2
// File generated on 27/4/2003 18:24:51 from Type Library described below.
// ************************************************************************ //
// Type Lib: C:\Arquivos de programas\Borland\Delphi7\Projects\ProjectServerDados.tlb (1)
// LIBID: {682E06EB-EF6F-4703-B285-4ABA10FD73AF}
// LCID: 0
// Helpfile:
// HelpString: ProjectServerDados Library
// DepndLst:
// (1) v2.0 stdole, (C:\WINDOWS\System32\stdole2.tlb)
// (2) v1.0 Midas, (C:\WINDOWS\System32\midas.dll)
// (3) v4.0 StdVCL, (C:\WINDOWS\system32\stdvcl40.dll)
// ************************************************************************ //
{$TYPEDADDRESS OFF} // Unit must be compiled without type-checked pointers.
{$WRITEABLECONST ON}
{$VARPROPSETTER ON}
interface
uses Windows, ActiveX, Classes, Graphics, Midas, StdVCL, Variants;
// *********************************************************************//
// GUIDS declared in the TypeLibrary. Following prefixes are used:
// Type Libraries : LIBID_xxxx
// CoClasses : CLASS_xxxx
// DISPInterfaces : DIID_xxxx
// Non-DISP interfaces: IID_xxxx
// *********************************************************************//
const
// TypeLibrary Major and minor versions
ProjectServerDadosMajorVersion = 1;
ProjectServerDadosMinorVersion = 0;
LIBID_ProjectServerDados: TGUID = {682E06EB-EF6F-4703-B285-4ABA10FD73AF};
IID_IDados: TGUID = {5A36954F-937B-495D-AAAA-BFC474685F10};
CLASS_Dados: TGUID = {28E32D34-63F6-42CA-AD01-23FFD01298A4};
type
// *********************************************************************//
// Forward declaration of types defined in TypeLibrary
// *********************************************************************//
IDados = interface;
IDadosDisp = dispinterface;
// *********************************************************************//
// Declaration of CoClasses defined in Type Library
// (NOTE: Here we map each CoClass to its Default Interface)
// *********************************************************************//
Dados = IDados;
// *********************************************************************//
// Interface: IDados
// Flags: (4416) Dual OleAutomation Dispatchable
// GUID: {5A36954F-937B-495D-AAAA-BFC474685F10}
// *********************************************************************//
IDados = interface(IAppServer)
[{5A36954F-937B-495D-AAAA-BFC474685F10}]
end;
// *********************************************************************//
// DispIntf: IDadosDisp
// Flags: (4416) Dual OleAutomation Dispatchable
// GUID: {5A36954F-937B-495D-AAAA-BFC474685F10}
// *********************************************************************//
IDadosDisp = dispinterface
[{5A36954F-937B-495D-AAAA-BFC474685F10}]
function AS_ApplyUpdates(const ProviderName: WideString; Delta: OleVariant; MaxErrors:
Integer;
out ErrorCount: Integer; var OwnerData: OleVariant): OleVariant;
dispid 20000000;
function AS_GetRecords(const ProviderName: WideString; Count: Integer; out RecsOut:
Integer;
Options: Integer; const CommandText: WideString; var Params:
OleVariant;
var OwnerData: OleVariant): OleVariant; dispid 20000001;
function AS_DataRequest(const ProviderName: WideString; Data: OleVariant): OleVariant;
dispid 20000002;
function AS_GetProviderNames: OleVariant; dispid 20000003;
function AS_GetParams(const ProviderName: WideString; var OwnerData: OleVariant):
OleVariant; dispid 20000004;
function AS_RowRequest(const ProviderName: WideString; Row: OleVariant; RequestType:
Integer;
var OwnerData: OleVariant): OleVariant; dispid 20000005;
procedure AS_Execute(const ProviderName: WideString; const CommandText: WideString;
var Params: OleVariant; var OwnerData: OleVariant); dispid 20000006;
end;
// *********************************************************************//
// The Class CoDados provides a Create and CreateRemote method to
// create instances of the default interface IDados exposed by
// the CoClass Dados. The functions are intended to be used by
// clients wishing to automate the CoClass objects exposed by the
// server of this typelibrary.
// *********************************************************************//
CoDados = class
class function Create: IDados;
class function CreateRemote(const MachineName: string): IDados;
end;
implementation
uses ComObj;
class function CoDados.Create: IDados;
begin
Result := CreateComObject(CLASS_Dados) as IDados;
end;
class function CoDados.CreateRemote(const MachineName: string): IDados;
begin
Result := CreateRemoteComObject(MachineName, CLASS_Dados) as IDados;
end;
end.
A aplicao servidora , na realidade, um caso particular de servidor de automao OLE.
CAPTULO 36 TCNICAS TEIS PARA A CRIAO DA INTERFACE COM O USURIO
Captulo
Tcnicas teis Para a Criao
da Interface com o Usurio
36
Neste captulo, sero apresentadas algumas tcnicas teis, que podem simplificar o desenvolvimento
da interface em aplicaes desenvolvidas com o Delphi 7.
KNOW-HOW EM: PARAMETRIZAO DE STRINGS DE AUXLIO
PR-REQUISITOS
Experincia prvia na utilizao de componentes no desenvolvimento de aplicaes com o Delphi 7 e na definio de strings de auxlio,
utilizando-se as propriedades Hint e ShowHint dos componentes.
METODOLOGIA
Apresentao do problema: Utilizao das principais propriedades e mtodos da classe TApplication na parametrizao de strings de auxlio.
TCNICA
Apresentao dos procedimentos necessrios parametrizao de strings de auxlio em aplicaes desenvolvidas com o Delphi 7.
UTILIZAO DAS STRINGS DE AUXLIO (HINTS)
Uma caracterstica predominante na maioria das aplicaes desenvolvidas para um ambiente com
interface grfica so as strings de auxlio, textos explicativos que so exibidos de forma a auxiliar o
usurio a identificar a utilidade ou o significado de um elemento que compe a interface da aplicao.
Essa caracterstica est presente principalmente nos botes localizados nas barras de ferramentas de
diversos aplicativos.
A habilitao desse recurso muito simples, pois basta digitar o texto desejado na propriedade Hint do
componente e definir como True o valor da sua propriedade ShowHint.
Voc pode, no entanto, alterar:
A cor de fundo do texto exibido na string de auxlio.
O tempo decorrido entre o posicionamento do mouse sobre o controle e a exibio do Hint.
O tempo decorrido entre o incio e o trmino da exibio de uma string de auxlio, isto , o seu
tempo de exibio.
O tempo entre a exibio de duas strings de auxlio distintas.
Alm disso, pode ainda exibir uma string de auxlio formada por vrias linhas de texto.
ALTERANDO A COR DE FUNDO DO TEXTO EXIBIDO NA STRING DE AUXLIO
Para alterar a cor de fundo do texto exibido na string de auxlio, voc deve alterar o valor armazenado
na propriedade HintColor do objeto Application, o que pode ser feita mediante a incluso da seguinte
linhas de cdigo no procedimento associado ao evento OnCreate do formulrio principal da aplicao:
Application.HintColor := clWhite;
O valor atribudo pode ser qualquer varivel do tipo TColor ou pode ainda ser obtido utilizando-se a
funo RGB. Dessa maneira, a linha anterior poderia ser reescrita da seguinte maneira:
Application.HintColor := RGB(255,255,255);
A funo RGB recebe como parmetros trs inteiros (cujo valor varia entre 0 e 255) e retorna a cor
resultante de uma combinao das cores Vermelho (Red), Verde (Green) e Azul (Blue), nas propores
definidas pelos trs valores passados como parmetro.
ALTERANDO O TEMPO DE INCIO E TRMINO DE EXIBIO DA STRING DE AUXLIO
Para alterar o tempo de incio e trmino da exibio da string de auxlio, voc deve alterar o valor
armazenado nas propriedades HintPause e HintHidePause do objeto Application, cujos valores default
so 500 e 2500 milissegundos, respectivamente. A alterao do valor dessas propriedades pode ser feito
mediante a incluso das seguintes linha de cdigo no procedimento associado ao evento OnCreate do
formulrio principal da aplicao:
Application.HintPause := 0;
Application.HinhidePause := 10000;
A partir da incluso dessas linhas de cdigo, as strings de auxlio sero exibidas imediatamente (pois a
propriedade HintPause foi definida como sendo igual a 0) e sero exibidas por um intervalo de 10
segundos (pois o valor da propriedade HintHidePause foi definido como sendo igual a 10000
milissegundos, isto , 10 segundos).
ALTERANDO O TEMPO DE EXIBIO ENTRE STRINGS DE AUXLIO DISTINTAS
Para alterar o tempo de exibio entre strings de auxlio distintas (de objetos distintos) voc deve alterar
o valor armazenado na propriedade HintShortPause do objeto Application, cujo valor default de 50
milissegundos. A alterao do valor dessa propriedade pode ser feita mediante a incluso da seguinte
linha de cdigo no procedimento associado ao evento OnCreate do formulrio principal da aplicao:
Application.HintShortPause := 100;
EXIBINDO UMA STRING DE AUXLIO COMPOSTA POR VRIAS LINHAS
Embora o Object Inspector s permita a digitao de strings de auxlio com uma nica linha, voc
pode definir em cdigo uma string de auxlio composta de vrias linhas, concatenando o cdigo ASCII
da tecla Enter com vrias strings em Pascal.
Por exemplo, para definir uma string de auxlio composta de duas linhas em um componente
speedbutton chamado SpeedButton1, podem-se incluir as seguintes linhas de cdigo no procedimento
associado ao evento OnCreate do formulrio principal da aplicao:
SpeedButton1.Hint := Linha 1+#13#10+Linha 2';
SpeedButton1.ShowHint := True;
KNOW-HOW EM: MLTIPLAS INSTNCIAS
PR-REQUISITOS
Experincia prvia no desenvolvimento de aplicaes com Delphi 7.
METODOLOGIA
Apresentao do problema: Definio da quantidade de instncias de uma aplicao, que podem ser executadas simultaneamente.
TCNICA
Apresentao dos procedimentos necessrios verificao de existncia de mltiplas instncias de uma aplicao.
Existem situaes em que no se deseja a execuo simultnea de mltiplas instncias de uma aplicao.
Nesse caso, para verificar se j existe uma instncia da aplicao sendo executada, deve-se utilizar a
funo FindWind da API do Windows.
Uma string com o nome da classe que define o formulrio principal da aplicao.
Uma string que define o caption do formulrio principal da aplicao (pode ser nil).
A maneira mais fcil de impedir a execuo de mltiplas instncias de uma aplicao consiste em
verificar se o valor retornado por essa funo igual a 0.
No caso de uma aplicao composta por um nico formulrio, da classe TFormPrincipal (que o
formulrio principal da aplicao), isso pode ser feito definindo-se da seguinte maneira o arquivo de
projeto da aplicao:
program UmaInstancia;
uses
Windows, Dialogs,
Forms,
UnitPrincipal in UnitPrincipal.pas {Form1};
{$R *.RES}
begin
if FindWindow(TFormPrincipal,nil) = 0
then
begin
Application.CreateForm(TFormPrincipal, FormPrincipal);
Application.Run;
end
else ShowMessage (A Aplicao j est sendo executada);
end.
Antes de executar para testar esta aplicao no Windows, feche o seu projeto no ambiente de desenvolvimento do Delphi.
No adianta tentar usar a varivel HPrevInst, soluo adotada no Delphi 1.0, pois esta no se aplica ao Windows 32 bits.
KNOW-HOW EM: REINICIALIZAO DO SISTEMA
A PARTIR DE UMA APLICAO
PR-REQUISITOS
Experincia prvia no desenvolvimento de aplicaes com Delphi 7.
METODOLOGIA
Apresentao do problema: Reinicializao do sistema a partir de uma aplicao desenvolvida em Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios reinicializao do sistema a partir de uma aplicao desenvolvida em Delphi 7, baseada na VCL.
Muitas aplicaes oferecem ao usurio a opo de reinicializar o Windows ou dar um boot no sistema
aps a sua instalao.
Para incluir essa caracterstica no seu aplicativo, voc deve utilizar a funo ExitWindowsEx da API do
Windows.
Essa funo recebe como parmetros um flag, que pode ser:
EWX_REBOOT: Reinicializa o sistema
ou:
EWX_SHUTDOWN: Desliga o micro.
E um segundo valor, que deve ser igual a 0.
O trecho a seguir executa a funo ExitWindows e reinicializa o sistema, caso o usurio selecione o
boto Ok na caixa de dilogo.
If MessageDlg(Deseja Fechar a Aplicao e Reinicializar o Windows
?,mtConfirmation,mbOkCancel,0)=mrOk
then ExitWindows(EW_REBOOTSYSTEM;0);
Dessa maneira, se o usurio selecionar o boto Ok nessa caixa de dilogo, o sistema ser reinicializado.
KNOW-HOW EM: MANIPULAO DA DATA E HORA DO SISTEMA
PR-REQUISITOS
Experincia prvia no desenvolvimento de aplicaes com Delphi 7, e na codificao de aplicaes em Object Pascal.
METODOLOGIA
Apresentao do problema: Manipulao da data e hora do sistema a partir de uma aplicao desenvolvida em Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios manipulao da data e hora do sistema a partir de uma aplicao desenvolvida em Delphi 7.
O TIPO TDATETIME
O Delphi 7 define o tipo TDateTime na unit System.pas, que na realidade idntico ao tipo double,
como mostra a definio a seguir, extrada desta unit.
type TDateTime = type Double;
Como todo nmero real, uma varivel do tipo TDateTime tem uma parte inteira e uma parte fracionria.
A parte inteira de uma varivel do tipo TDateTime armazena o nmero de dias decorridos desde 30 de
dezembro de 1889, at a data atual do sistema, ao passo que a parte fracionria armazena a quantidade
de horas do dia.
A tabela a seguir, existente no Help On-line do Delphi, apresenta alguns valores reais e seus
correspondentes no formato data-hora.
Como j foi descrito anteriormente, a parte inteira representa o nmero de dias decorridos desde 30/
12/1899. Conseqentemente, se voc somar ou subtrair um valor inteiro a uma varivel do tipo
TDateTime, estar na realidade somando ou subtraindo uma determinada quantidade de dias. Alm
disso, pode comparar duas datas como compara dois nmeros reais.
Para adicionar uma hora, que 1/24 do dia, basta somar ou subtrair 1/24 varivel do tipo TDateTime.
OBTENDO A DATA E HORA DO SISTEMA
O Delphi 7 tem vrias funes que retornam a data e a hora do sistema, algumas das quais oriundas do
velho e bom Pascal.
A funo Now, por exemplo, retorna a data e a hora do sistema, ao passo que as funes Date e Time
retornam apenas a data e a hora, respectivamente.
Valor Real Data/Hora equivalente
0 30/12/1899 12:00 am
2.75 01/01/1900 6:00 pm
-1.25 29/12/1899 6:00 am
35065 01/01/1996 12:00 am
CONVERTENDO UM VALOR DO TIPO DATA/HORA EM UMA STRING
Para converter o valor retornado por essas funes em uma string, podem-se utilizar as seguintes funes:
TimeToStr, que recebe como parmetro uma varivel do tipo TDateTime e retorna o horrio
em uma string.
DateToStr, que recebe como parmetro uma varivel do tipo TDateTime e retorna a data em
uma string.
DateTimeToStr, que recebe como parmetro uma varivel do tipo TDateTime e retorna a data
e a hora em uma string.
CONVERTENDO UMA STRING EM UM VALOR DO TIPO DATA/HORA
Para converter uma string em um valor do tipo Data/Hora, pode-se usar uma das seguintes funes
fornecidas pelo Delphi 7:
StrToDate: Converte uma string que representa uma data em uma varivel do tipo TDateTime.
StrToTime: Converte uma string que representa uma hora em uma varivel do tipo TDateTime.
StrToDateTime: Converte uma string que representa uma data/hora em uma varivel do
tipo TDateTime.
OBTENDO O DIA DA SEMANA CORRESPONDENTE A UMA DATA
Para obter o dia da semana correspondente a uma data, voc deve usar a funo DayOfWeek, que recebe
como parmetro uma varivel do tipo TDateTime e retorna um inteiro entre 1 (Domingo) e 7 (Sbado).
FUNES ESPECIAIS DE CONVERSO DE DATA/HORA
Suponha que voc queira converter o dia 15 de fevereiro de 1999 em um valor do tipo TDateTime.
Voc no precisa efetuar nenhum clculo complexo para resolver esse problema, pois o Delphi 7 fornece
a funo EncodeDate, que recebe como parmetros trs nmeros inteiros positivos representando o
dia (entre 1 e 31), o ms (entre 1 e 12) e o ano.
Nesse caso, por exemplo, se DataNova for uma varivel do tipo TDateTime, a linha de cdigo a ser
utilizada seria:
NovaData := EncodeDate(15,2,1999);
A recproca tambm verdadeira, e voc pode usar o procedimento DecodeDate para obter o dia, ms e ano
correspondentes a uma data definida em uma varivel do tipo TDateTime. Nesse caso, devem ser passados
como parmetros um valor do tipo TDateTime, cujo valor ser convertido, e trs variveis inteiras sem sinal
(tipo Word) representando respectivamente o ano, o ms e o dia a serem obtidos (estes trs ltimos parmetros
so passados por referncia; conseqentemente, seu valor alterado dentro do procedimento).
A seguir, apresentamos a linha de cdigo correspondente utilizao desse procedimento, onde
DataAtual uma varivel do tipo TDateTime e Ano, Ms e Dia so variveis do tipo Word.
DecodeDate(DataAtual, Ano, Ms, Dia);
Da mesma forma existem as funes EncodeTime e DecodeTime, que permitem a converso em um valor
do tipo TDateTime de um horrio passado como hora, minuto, segundo e milissegundos (e vice-versa).
KNOW-HOW EM: PERSONALIZAO DE FORMULRIOS
COM A DEFINIO DE UM PANO DE FUNDO
PR-REQUISITOS
Experincia prvia no desenvolvimento de aplicaes com Delphi 7, e na utilizao dos mtodos e propriedades das classes TCanvas, TBrush,
TPen e TBitmap.
METODOLOGIA
Apresentao do problema: Definio de um pano de fundo para o formulrio principal de uma aplicao desenvolvida em Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios definio de um pano de fundo para o formulrio principal de uma aplicao desenvolvida
em Delphi 7.
INSERINDO UM PANO DE FUNDO EM UM FORMULRIO
Para inserir um pano de fundo em um formulrio, voc deve definir da seguinte maneira os
procedimentos associados aos seus eventos OnCreate e OnPaint:
procedure TFormBitmap.FormCreate(Sender: TObject);
begin
Bitmap := TBitmap.Create;
Bitmap.LoadFromFile(c:\windows\Egito.bmp);
end;
procedure TFormBitmap.FormPaint(Sender: TObject);
var
X, Y, W, H : integer;
begin
W := Bitmap.Width;
H := Bitmap.Height;
Y := 0;
while Y < FormBitmap.Height do
begin
x := 0;
while X < FormBitmap.Width do
begin
FormBitmap.Canvas.Draw(X,Y,Bitmap);
X := X + H;
end;
Y := Y + H;
end;
end;
Neste exemplo, a varivel Bitmap deve ser declarada como um objeto do tipo TBitmap na seo var da
unit do formulrio.
A Figura 36.1 apresenta o resultado da execuo desse cdigo.
Figura 36.1: Preenchendo um formulrio com um bitmap.
KNOW-HOW EM: DESENVOLVIMENTO DE APLICAES MDI
PR-REQUISITOS
Experincia prvia no desenvolvimento de aplicaes com Delphi 7, e na manipulao de formulrios em run-time.
METODOLOGIA
Apresentao do problema: Desenvolvimento de aplicaes MDI utilizando o Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios ao desenvolvimento de aplicaes MDI utilizando o Delphi 7 como ferramenta de
desenvolvimento.
CRIANDO APLICAES MDI
Uma aplicao MDI, ou aplicao composta por uma interface de mltiplos documentos, uma aplicao
composta por uma janela principal e vrias janelas-filhas.
As aplicaes MDI apresentam as seguintes caractersticas:
As janelas-filhas no podem ser deslocadas para fora da rea-cliente da janela principal (tambm
denominada janela-pai).
Um nico menu compartilhado entre a janela principal e as janelas-filhas.
As janelas-filhas podem ser dispostas de uma maneira organizada a partir de uma chamada a
um nico mtodo do formulrio principal.
A janela principal responsvel pela criao e destruio das janelas-filhas.
CRIANDO A JANELA PRINCIPAL DE UMA APLICAO MDI
Para criar a janela principal de uma aplicao MDI, voc deve executar os seguintes procedimentos:
1. Iniciar uma nova aplicao, selecionando o item New/Application do menu File do Delphi 7.
2. Alterar o valor da propriedade FormStyle do formulrio principal para fsMDIForm.
Cada aplicao MDI s pode ter um formulrio cuja propriedade FormStyle tenha o valor fsMDIForm, e esse formulrio deve ser o
formulrio principal da aplicao.
3. Altere o valor das propriedades Name e Caption desse formulrio para FormMDIPai e Exemplo
de Aplicao MDI.
CRIANDO UMA JANELA-FILHA DE UMA APLICAO MDI
Para criar uma janela-filha para essa aplicao MDI, voc deve executar os seguintes procedimentos:
1. Selecionar o item New/Form do menu File do Delphi 7, para criar um novo formulrio.
2. Alterar o valor da propriedade FormStyle do formulrio recm-criado para fsMDIChild.
3. Alterar os valores das propriedades Name e Caption desse formulrio para FormMDIFilho e
Formulrio filho, respectivamente.
4. Retirar esse formulrio da lista Auto-Create Forms, existente na caixa de dilogo Project Op-
tions, que exibida quando se seleciona o item Options do menu Project. No caso de aplicaes
MDI, normalmente cada janela-filha criada dinamicamente quando o usurio seleciona um
item de menu ou um boto de uma barra de ferramentas da janela principal.
A criao de uma janela-filha feita mediante a incluso da seguinte linha de cdigo em um procedimento associado a um evento da janela-pai:
FormMDIFilho : TFormMDIFilho.Create(Self);
Nesse caso, o parmetro Self um ponteiro para o formulrio-pai e FormMDIFilho um objeto da classe TFormMDIFilho.
DESTRUINDO UMA JANELA-FILHA DE UMA APLICAO MDI
A nica preocupao que se deve ter ao fechar uma janela-filha consiste em liberar a memria alocada
para esta janela, e isso pode ser feito atribuindo-se um valor adequado para o parmetro Action do
procedimento associado ao evento OnClose do formulrio que representa a janela-filha, mediante a
incluso da seguinte linha de cdigo nesse procedimento:
Action := caFree;
Onde Action uma varivel passada por referncia no procedimento associado ao evento OnClose do
formulrio.
ORGANIZANDO A EXIBIO DAS JANELAS-FILHAS
Voc pode organizar a disposio das janelas-filhas na rea-cliente da janela-pai, e essa organizao
pode ser feita de diversas formas:
Janelas-filhas dispostas lado a lado horizontalmente.
Janelas-filhas dispostas lado a lado verticalmente.
Janelas-filhas dispostas em cascata.
O tipo de disposio definido atribuindo-se um valor adequado propriedade TileMode do formulrio-
pai, que pode assumir os valores tbHorizontal e tbVertical.
Aps definir o valor adequado para a propriedade TileMode, basta chamar o mtodo Tile do formulrio
que representa a janela-pai.
Se as janelas-filhas estiverem minimizadas, voc pode organizar a sua disposio executando o mtodo
ArrangeIcons da janela-pai.
Para exibir as janelas-filhas em cascata, use o mtodo cascade da janela-pai.
MESCLANDO MENUS
Em uma aplicao MDI, a barra de menus da janela-filha que estiver ativa substitui a barra de menus
da janela-pai. Uma soluo mais elegante, no entanto, consiste em mesclar as barras de menus dessas
duas janelas, conforme ser mostrado neste tpico.
Em geral, a barra de menus da janela principal de uma aplicao MDI apresenta os seguintes menus:
Arquivo, com os itens Novo, Fechar e Sair.
Janela, com as opes Lado a Lado Vertical, Lado a Lado Horizontal, Em Cascata, Organizar
cones e Fechar Todas as Janelas.
Ajuda, com itens que permitem acessar um arquivo de Help On-line, exibir uma caixa de
dilogo de direitos autorais, etc.
As janelas-filhas, por sua vez, podem ter uma barra de menus com itens bastante especficos, dependendo
da finalidade de cada janela e da aplicao propriamente dita.
Suponha que cada janela-filha tenha os seguintes menus e itens de menu, a ttulo simplesmente ilustrativo:
Menu Menu_A, com os itens Opo_A1, Opo_A2 e Opo_A3.
Menu Menu_B, com os itens Opo_B1, Opo_B2 e Opo_B3.
Para que nenhum desses menus da janela-filha sobreponha um menu da janela principal, devemos
configurar adequadamente o valor da propriedade GroupIndex de cada menu. A propriedade
GroupIndex deve receber como valor um nmero inteiro, e apresenta as seguintes caractersticas:
Se a propriedade GroupIndex de um menu da janela-filha tiver o mesmo valor de um dos
menus da janela-pai, este ser sobreposto.
Os menus so exibidos, da esquerda para a direita, na ordem crescente do valor da sua
propriedade GroupIndex.
Crie os menus supracitados nas janelas-pai e filha (usando o componente MainMenu), definindo os
valores mostrados na tabela a seguir para a sua propriedade ItemIndex.
Agora, quando uma janela-filha for exibida, seu menu no ser mesclado com o da janela-pai.
Para exibir as janelas-filhas na disposio lado a lado horizontal, basta atribuir o valor tbHorizontal
propriedade TileMode da janela principal, e executar o seu mtodo Tile.
Para exibir as janelas-filhas na disposio lado a lado vertical, basta atribuir o valor tbVertical
propriedade TileMode da janela principal, e executar o seu mtodo Tile.
Para exibir as janelas-filhas na disposio em cascata, basta executar o mtodo Cascade do formulrio
principal.
Para fechar todas as janelas-filhas, basta executar o mtodo Close de cada uma delas. As janelas-filhas
esto referenciadas na propriedade MDIChildren, que um a array de objetos da classe TForm, iniciando
em 0. Para obter o nmero de janelas-filhas, basta verificar o valor da propriedade MDIChildCount da
janela principal.
Apresentamos, a seguir, o cdigo das units associadas aos formulrios da aplicao.
unit UnitMDIPai;
interface
uses
Menus;
type
TFormMDIPai = class(TForm)
Arquivo1: TMenuItem;
Novo1: TMenuItem;
Fechar1: TMenuItem;
Sair1: TMenuItem;
Menu Propriedade GroupIndex
Arquivo (janela-pai): 0
Janela (janela-pai): 3
Ajuda (janela-pai): 4
Menu_A (janela-filha) 1
Menu_B (janela-filha) 2
Janelas1: TMenuItem;
LadoaLadoHorizontal1: TMenuItem;
LadoaLadoVertical1: TMenuItem;
FecharTodas1: TMenuItem;
Organizarcones1: TMenuItem;
Ajuda1: TMenuItem;
Sobre1: TMenuItem;
EmCasacata1: TMenuItem;
procedure Novo1Click(Sender: TObject);
procedure LadoaLadoHorizontal1Click(Sender: TObject);
procedure LadoaLadoVertical1Click(Sender: TObject);
procedure FecharTodas1Click(Sender: TObject);
procedure EmCasacata1Click(Sender: TObject);
procedure Organizarcones1Click(Sender: TObject);
procedure Sair1Click(Sender: TObject);
private
public
end;
var
FormMDIPai: TFormMDIPai;
nchilds : integer;
implementation
uses UnitMDIFilha;
{$R *.DFM}
procedure TFormMDIPai.Novo1Click(Sender: TObject);
var
FormMDIFilho : TFormMDIFilho;
begin
FormMDIFilho := TFormMDIFilho.Create(Self);
nchilds := nchilds + 1;
FormMDIFilho.Caption := FormMDIFilho.caption + #+inttostr(nchilds);
end;
procedure TFormMDIPai.LadoaLadoHorizontal1Click(Sender: TObject);
begin
Tilemode := tbHorizontal;
Tile;
end;
procedure TFormMDIPai.LadoaLadoVertical1Click(Sender: TObject);
begin
Tilemode := tbVertical;
Tile;
end;
procedure TFormMDIPai.FecharTodas1Click(Sender: TObject);
var
i : integer;
begin
for i:=0 to MDIChildCount-1 do
MDIChildren[i].Close;
end;
procedure TFormMDIPai.EmCasacata1Click(Sender: TObject);
begin
Cascade;
end;
procedure TFormMDIPai.Organizarcones1Click(Sender: TObject);
begin
ArrangeIcons;
end;
procedure TFormMDIPai.Sair1Click(Sender: TObject);
begin
Close;
end;
procedure TFormMDIPai.FormCreate(Sender: TObject);
begin
nchilds := 0;
end;
end.
unit UnitMDIFilha;
interface
uses
Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs;
type
TFormMDIFilho = class(TForm)
A1: TMenuItem;
A11: TMenuItem;
A21: TMenuItem;
A31: TMenuItem;
B1: TMenuItem;
B11: TMenuItem;
B21: TMenuItem;
B31: TMenuItem;
procedure FormClose(Sender: TObject; var Action: TCloseAction);
private
public
end;
var
FormMDIFilho: TFormMDIFilho;
implementation
{$R *.DFM}
procedure TFormMDIFilho.FormClose(Sender: TObject;
begin
Action := caFree;
end;
end.
KNOW-HOW EM: OPERAES DE DRAG-DROP EM COMPONENTES
PR-REQUISITOS
Experincia prvia no desenvolvimento de aplicaes com Delphi 7 e na manipulao de componentes e formulrios.
METODOLOGIA
Apresentao do problema: Desenvolvimento de aplicaes que incorporam o recurso de drag-drop utilizando o Delphi 7 como ferramenta
de desenvolvimento.
TCNICA
Apresentao dos procedimentos necessrios ao desenvolvimento de aplicaes que incorporam o recurso de drag-drop.
O recurso de drag e drop (arrastar e soltar) pode tornar a interface de suas aplicaes mais atrativa e
fcil de utilizar.
Essas operaes podem envolver componentes ou itens de componentes, dependendo da finalidade
da aplicao, e dos objetos utilizados na criao da sua interface.
Neste tpico, sero usados componentes da pgina Win 3.1, inexistente na CLX. Conseqentemente,
ser criada uma aplicao baseada na VCL do Delphi 7.
DESCRIO DAS TCNICAS DE DRAG & DROP
Todo controle tem uma propriedade denominada DragMode, que controla a maneira pela qual um
componente responder s operaes de drag-drop. Essa propriedade pode assumir os seguintes valores:
dmAutomatic: Se o valor da propriedade DragMode for igual a dmAutomatic, a operao de
drag-drop ser iniciada assim que o usurio pressionar o boto esquerdo do mouse quando o
cursor estiver posicionado sobre o componente.
dmManual: Se o valor da propriedade DragMode for igual a dmManual (que a situao de-
fault), a operao de drag-drop ser iniciada mediante a execuo de uma chamada ao mtodo
BeginDrag do componente. Essa opo deve ser empregada quando a operao de drag-drop
interfere com outros eventos do mouse.
O mtodo BeginDrag recebe como parmetro um valor booleano, que indica se a operao de arrastar
e soltar deve ou no ser iniciada imediatamente (permitindo ao componente tratar outros eventos
relacionados ao mouse). Se o parmetro for igual a False, a operao de drag-drop s ser iniciada aps
o mouse se deslocar a uma certa distncia.
Quando o usurio arrasta algum objeto sobre um controle, o evento OnDragOver desse controle
disparado, e o procedimento a ele associado executado. Esse procedimento tem um parmetro
chamado Accept, que dever ser definido como True caso o componente aceite receber o objeto que
est sendo arrastado.
Alm do parmetro Accept, o procedimento tem os seguintes parmetros:
Sender, Source: Identificam respectivamente o objeto atual e aquele que iniciou a operao de
drag-drop.
X, Y: Valores inteiros que retornam a posio corrente do cursor do mouse.
State: Varivel do tipo tDragState, que pode assumir os seguintes valores:
dsDragEnter: o mouse acaba de atingir o controle.
dsDragMove: o mouse acaba de se mover sobre o controle.
dsDragLeave: o mouse est deixando o controle.
A operao a ser feita quando o usurio liberar o boto do mouse sobre o controle, encerrando a
operao de drag-drop, deve ser definida no procedimento associado ao seu evento OnDragDrop. O
procedimento associado a esse evento tem os mesmos parmetros que o procedimento associado ao
evento OnDragOver, exceto o parmetro Accept.
Enquanto isso, no componente que originou a operao, o evento OnEndDrag disparado assim que
a operao de drag-drop termina. O procedimento associado a esse evento recebe como parmetros:
Sender: identifica o objeto atual.
Target: identifica o objeto sobre o qual o objeto que estava sendo arrastado foi liberado. Se esse
valor for igual a nil, indica que nenhum componente aceitou receber o objeto que estava
sendo arrastado.
X, Y: Valores inteiros que retornam a posio corrente do cursor do mouse.
A propriedade DragCursor define a imagem a ser exibida pelo cursor do mouse durante a operao de
drag-drop.
Nos tpicos seguintes ser apresentada uma aplicao-exemplo, na qual sero ilustradas as tcnicas de
drag & drop.
EXEMPLO DE UTILIZAO
Neste tpico, apresentaremos um exemplo de utilizao das tcnicas de drag & drop.
O objetivo deste exemplo ser o de selecionar o nome de um arquivo-texto em uma lista de arquivos,
arrast-lo e, ao solt-lo sobre um componente Memo, carregar neste o texto armazenado no arquivo.
DEFINIO DA INTERFACE
Inicialmente, dever ser definida uma nova aplicao, composta por um formulrio no qual sero
inseridos vrios componentes, com as propriedades descritas a seguir.
Formulrio:
Name: FormDragDrop
Width: 545
Height: 300
Caption: Exemplo de Drag & Drop
Componente Memo:
Name: MemoTXT
Left: 190
Top: 20
Width: 235
Height: 235
ScrollBars: ssBoth
Componente FileListBox:
Name: ListaArquivos
Left: 25
Top: 150
Width: 145
Height: 97
Componente DirectoryListBox:
Name: ListaDiretorios
Left: 25
Top: 45
Width: 145
Height: 97
FileList: ListaArquivos
Componente DriveComboBox:
Name: ListaDrives
Left: 25
Top: 20
Width: 145
Height: 19
DirList: ListaDiretorios
Componente Boto de Comando:
Name: BotaoFechar
Left: 440
Top: 125
Width: 75
Height: 25
Kind: bkClose
Caption: &Fechar
Apague o texto exibido pela propriedade Lines do Componente MemoTXT.
Figura 36.2: Aspecto do formulrio usado no exemplo de drag & drop.
CODIFICAO DO EXEMPLO
A codificao deste exemplo ser feita levando em considerao que o objeto, a partir do qual ser
iniciada a operao de drag e drop, ser o componente ListaArquivos (o Source) e o componente sobre
o qual este ser liberado ser o componente Memo (o Target).
A codificao do incio do processo feita definindo-se da seguinte maneira o procedimento associado
ao evento OnMouseDown do componente ListaArquivos:
procedure TFormDragDrop.ListaArquivosMouseDown(Sender: TObject;
begin
ListaArquivos.BeginDrag(False);
end;
O procedimento associado ao evento OnDragDrop do componente MemoTXT deve ser codificado da
maneira apresentada a seguir:
procedure TFormDragDrop.MemoTXTDragOver(Sender, Source: TObject; X, Y: Integer;
State: TDragState; var Accept: Boolean);
begin
if (Source is TFileListBox)
then
Accept := True
else
Accept := False;
end;
Esse cdigo garante que a operao s ser aceita se o objeto que iniciou o processo de drag e drop for
da classe TFileListBox.
Para encerrar o processo, deve-se codificar da seguinte maneira o procedimento associado ao evento
OnEndDrag do componente ListaArquivos:
procedure TFormDragDrop.MemoTXTDragDrop(Sender, Source: TObject; X, Y: Integer);
begin
if UpperCase(ExtractFileExt((Source as TFileListBox).FileName))= .TXT
then
begin
(Sender as TMemo).Lines.LoadFromFile((Source as TFileListBox).FileName);
ShowMessage(Arquivo Carregado com Sucesso);
end
else
ShowMessage(Esta Operao s pode ser feita em arquivo-texto ASCII com extenso TXT);
end;
Esse procedimento verifica se o nome do arquivo cujo nome est sendo arrastado sobre o componente
tem a extenso TXT e, em caso positivo, carrega o arquivo na propriedade Lines do componente.
Caso a operao tenha sido executada com sucesso, a seguinte mensagem ser exibida:
Arquivo Carregado com Sucesso
Caso a operao no possa ser realizada, a seguinte mensagem ser exibida:
Esta Operao s pode ser feita em arquivo-texto ASCII com extenso TXT
Apresenta-se a seguir o cdigo da unit associada ao formulrio desta aplicao-exemplo, tendo esta
unit sido salva com o nome UnitDragDrop.pas.
unit UnitDragDrop;
interface
uses
StdCtrls, Buttons, FileCtrl;
type
TFormDragDrop = class(TForm)
MemoTXT: TMemo;
ListaArquivos: TFileListBox;
ListaDiretorios: TDirectoryListBox;
ListaDrives: TDriveComboBox;
procedure MemoTXTDragOver(Sender, Source: TObject; X, Y: Integer;
procedure MemoTXTDragDrop(Sender, Source: TObject; X, Y: Integer);
procedure ListaArquivosMouseDown(Sender: TObject; Button: TMouseButton;
private
public
end;
var
FormDragDrop: TFormDragDrop;
implementation
{$R *.DFM}
procedure TFormDragDrop.MemoTXTDragOver(Sender, Source: TObject; X, Y: Integer;
begin
if (Source is TFileListBox)
then
Accept := True
else
Accept := False;
end;
procedure TFormDragDrop.MemoTXTDragDrop(Sender, Source: TObject; X, Y: Integer);
begin
if UpperCase(ExtractFileExt((Source as TFileListBox).FileName))= .TXT
then
begin
(Sender as TMemo).Lines.LoadFromFile((Source as TFileListBox).FileName);
ShowMessage(Arquivo Carregado com Sucesso);
end
else
ShowMessage(Esta Operao s pode ser feita em arquivo-texto ASCII com extenso TXT);
end;
procedure TFormDragDrop.ListaArquivosMouseDown(Sender: TObject;
begin
ListaArquivos.BeginDrag(False);
end;
end.
Esse problema tem vrias solues alternativas, dependendo da estratgia empregada pelo desenvolvedor.
CAPTULO 37 INTERNACIONALIZAO DE APLICATIVOS CRIADOS COM O DELPHI
Captulo
Internacionalizao de
Aplicativos Criados com o Delphi
37
Neste captulo, sero apresentados os principais recursos disponveis nesta verso do Delphi, para a
internacionalizao de aplicativos baseados na VCL.
KNOW-HOW EM: INTERNACIONALIZAO DE APLICATIVOS
PR-REQUISITOS
Experincia na utilizao do ambiente de desenvolvimento integrado do Delphi 7.
METODOLOGIA
Apresentao das principais ferramentas do Delphi 7 para a internacionalizao de aplicativos.
TCNICA
Apresentao dos procedimentos necessrios utilizao do Translation Manager.
O AMBIENTE INTEGRADO DE TRADUO DO DELPHI 7
O ambiente integrado de traduo (Integrated Translation Environment ITE) um conjunto de
ferramentas que permite desenvolver de forma mais produtiva softwares para o mercado internacional,
permitindo gerenciar o desenvolvimento de aplicaes a serem comercializadas em diversas linguagens,
a partir de um nico projeto de aplicativo.
Este ambiente pode ser subdividido nas seguintes ferramentas:
Translation Manager: Exibe um grid que permite a visualizao e edio de recursos a serem
traduzidos para diversos idiomas.
Translation Repository: Consiste em um banco de dados que pode ser compartilhado entre
vrios projetos e desenvolvedores.
Resource DLL wizard: Um assistente que gera e gerencia bibliotecas de vinculao dinmicas
para a manipulao destes recursos.
Desde a verso 5 do Delphi, podem-se compilar arquivos de recursos a partir do prprio ambiente de
desenvolvimento integrado, sem que seja necessrio utilizar um compilador de recursos independente
(como o Resource Workshop).
O ambiente integrado de traduo cria e mantm uma DLL para cada verso de idioma da aplicao
que est sendo desenvolvida. Estas DLLs so organizadas em um grupo de projetos, sendo acessadas
atravs do gerenciador de projetos do Delphi.
INCORPORANDO OS RECUSOS DO AMBIENTE INTEGRADO
DE TRADUO AO SEU PROJETO DE APLICATIVO
Para incorporar os recursos do ambiente integrado de traduo a um projeto de aplicativo, voc deve
1. Salvar o projeto atual.
2. Selecionar o item New/Other do menu File do Delphi 7 para exibir a caixa de dilogo New
Items e, nessa caixa de dilogo, selecionar o item Resource DLL Wizard.
Figura 37.1: Selecionando o item Resource DLL Wizard na caixa de dilogo New Items.
3. Selecione o boto Ok para fechar esta caixa de dilogo e inicializar o assistente, conforme
Figura 37.2: A tela inicial do Resource DLL Wizard.
Esta tela informa que voc poder:
Selecionar mltiplos projetos.
Selecionar mltiplas linguagens para cada projeto.
Atualizar ou sobrecarregar as DLLs de recursos j existentes.
Figura 37.3: Selecionando projetos no Resource DLL Wizard.
5. Selecione o boto Next. Ser exibida uma caixa de dilogo na qual devero ser selecionadas as
linguagens com as quais se deseja trabalhar, como mostrado na figura a seguir.
4. Selecione o boto Next. Ser exibida uma caixa de dilogo na qual devero ser selecionados os
projetos aos quais as DLLs de recurso se aplicam, como mostrado na figura a seguir.
Figura 37.4: Selecionando as linguagens com as quais se deseja trabalhar.
6. Selecione o boto Next. Ser exibida uma caixa de dilogo na qual sero informadas as linguagens
selecionadas, e onde voc poder definir o diretrio em que cada DLL ser armazenada (neste
exemplo foram selecionadas as opes de ingls dos Estados Unidos e Portugus Brasileiro)
como mostrado na Figura 37.5.
Figura 37.5: Selecionando as linguagens com as quais se deseja trabalhar.
7. Selecione o boto Next. Ser exibida a caixa de dilogo mostrada na figura a seguir, na qual
podero ser informados, para cada um dos projetos, arquivos sobre os quais as DLLs de recursos
tambm devero atuar.
Figura 37.6: Caixa de dilogo para incluso de arquivos adicionais.
8. Selecione os arquivos a partir da caixa de dilogo exibida quando se seleciona o boto Add File
e o boto Next. Ser exibida a caixa de dilogo mostrada na figura a seguir, na qual dever ser
informado o modo de atualizao das DLLs de recursos podendo optar por criar novos recursos
ou atualizar os j existentes.
Figura 37.7: Caixa de dilogo para definio do modo de atualizao das DLLs de recursos.
9. Selecione o boto Next. Ser exibida a caixa de dilogo mostrada na Figura 37.8, na qual sero
informadas as providncias que sero realizadas pelo assistente.
10. Selecione o boto Finish. Ser exibida a caixa de dilogo mostrada na Figura 38.9, na qual o
usurio deve informar se o(s) projeto(s) podem ser recompilados, para que o Resource DLL
Wizard seja concludo com xito.
11. Selecione o boto Yes. Ser exibida a caixa de dilogo mostrada na Figura 38.10, na qual
apresentado o resultado da compilao.
Figura 37.8: Caixa de dilogo final do Resource DLL Wizard.
Figura 37.9: Caixa de dilogo exibida para solicitar a recompilao de projetos.
Figura 37.10: Caixa de dilogo com informaes relativas ao resultado da compilao.
12. Selecione o boto Ok para fechar esta caixa de dilogo. Ser exibida a caixa de dilogo Transla-
tion Manager Gerenciador de Tradues mostrada na Figura 37.11.
Posteriormente, para visualizar o Translation Manager, basta selecionar o item Translation manager no menu view do Delphi.
Se os arquivos de recursos estiverem sendo criados pela primeira vez, ser necessrio salvar os arquivos do grupo de projetos que estar
sendo criado automaticamente.
TRADUZINDO CONSTANTES E EXPRESSES
A traduo de constantes e expresses feita na janela do Translate Manager.
Do lado esquerdo da guia Workspace da janela do Translate manager esto dispostos, de forma
hierrquica, os elementos e arquivos de recursos correspondentes a cada um dos idiomas com os quais
voc resolveu trabalhar.
Os arquivos de recurso do Delphi apresentam as principais constantes e mensagens de erro do ambiente,
e tambm podem ser traduzidas.
Figura 37.11: O Translation Manager.
A figura a seguir mostra a seleo do arquivo de recursos para a lngua portuguesa, com algumas das
strings j traduzidas.
Figura 37.12: Traduzindo strings do ambiente de desenvolvimento integrado do Delphi 7.
Aps fazer as tradues necessrias, voc deve selecionar os botes Save (com um desenho de um
disquete) e Refresh para atualizar e salvar o seu projeto.
Figura 37.13: Traduzindo a propriedade Caption de um formulrio.
DEFININDO O IDIOMA CORRENTE
Para definir o idioma corrente de um projeto de aplicao, voc dever executar um dos seguintes
procedimentos:
1. No menu do Delphi 7 selecione Run/Languages/Set Active. Ser exibida a caixa de dilogo
mostrada na figura a seguir, na qual uma das linguagens dever ser selecionada.
O mesmo pode ser feito com propriedades e atributos de objetos, conforme mostrado na figura a seguir.
Figura 37.14: Selecionando o idioma ativo.
2. Selecione o idioma desejado e o boto Finish.
Ao selecionar um idioma ativo, o projeto ser compilado com os recursos e strings definidos para o mesmo.
UTILIZANDO O TRANSLATION REPOSITORY
O Translation Repository, conforme descrito anteriormente, um banco de dados que pode ser
compartilhado entre vrios projetos e desenvolvedores.
Voc pode acessar o Translation Repository selecionando o primeiro boto na barra de ferramentas
superior do Translate Manager ou a partir do item Translation Repository do menu Tools.
Voc pode adicionar recursos ao Translation Repository a partir da grade de strings exibida quando se
seleciona um dos arquivos de recursos.
Para transferir uma string do arquivo de recursos para o Translation Repository, voc deve executar os
1. Selecionar o arquivo de recursos na janela do Translation Manager.
2. Selecione as linhas referentes s strings a serem transferidas para o Translation Repository e
pressione o boto direito do mouse. No menu pop-up que ser exibido, selecione o item Re-
pository/Add Strings to Repository.
Para transferir uma string do Translation Repository para o arquivo de recursos, voc deve executar os
1. Selecionar o arquivo de recursos na janela do Translation Manager.
2. Selecionar o boto direito do mouse. No menu pop-up que ser exibido, selecione o item
Repository/Get Strings From Repository.
O Translation Repository tambm permite a exportao e importao de arquivos com as strings desejadas.
Voc tambm pode selecionar diversas opes de configurao do Translation Manager na caixa de
dilogo Translation Tools Options, exibida quando se seleciona o primeiro boto da barra de ferramentas
superior do Translation Manager, e reproduzida na figura a seguir.
Figura 37.15 A pgina Translation Tools da caixa de dilogo Environment options.
CAPTULO 38 CRIANDO APLICAES PARA A INTERNET
Captulo
Criando Aplicaes Para a Internet
38
A Internet, que inicialmente foi criada com fins militares e acadmicos, teve seu principal foco totalmente
alterado nos ltimos anos, e passou a ter uma importncia comercial indiscutvel. A Internet est cada
vez mais presente no nosso cotidiano, e a demanda por aplicaes voltadas ao comrcio eletrnico
cresce a cada dia. Voc provavelmente j visitou algum site atravs do qual podem ser realizadas compras
de livros, CDs e outros produtos.
Cresce tambm a demanda por servios eletrnicos das mais diversas formas, ainda existindo um
mercado de servios a serem explorados.
Neste captulo, sero apresentados os principais recursos disponveis para o desenvolvimento de
aplicaes para a Internet com o Delphi 7, utilizando-se o recurso das aplicaes CGI (que poderiam
inclusive ser desenvolvidas em outras linguagens como o Pearl, C, C++ e Visual Basic), da tecnologia
Websnap e da Intraweb, recentemente incorporada ao ambiente.
KNOW-HOW EM: DESENVOLVIMENTO DE APLICAES CGI COM WEBBROKER
PR-REQUISITOS
Conhecimentos bsicos da linguagem HTML.
METODOLOGIA
Apresentao do problema: Criao de uma aplicao CGI com a tecnologia WebBroker, utilizando os componentes disponveis no ambiente
de desenvolvimento integrado do Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios ao desenvolvimento de aplicaes CGI.
PROCEDIMENTOS BSICOS NECESSRIOS CRIAO DE APLICAES CGI
Neste tpico, sero apresentados os procedimentos necessrios criao de aplicaes CGI, isto ,
aplicaes que podem ser executadas em um servidor Web e retornar uma resposta ao browser do
cliente que solicitou a execuo da aplicao.
Embora o desenvolvimento de uma aplicao CGI com a tecnologia WebBroker seja mais trabalhoso
do que o desenvolvimento baseado nas tecnologias Websnap e Intraweb, ele permite um maior controle
do sistema por parte do desenvolvedor, e em muitas situaes , sem dvida, a melhor soluo.
Em nossos exemplos sero criadas aplicaes CGI padro, embora os procedimentos a serem utilizados
para criar aplicaes ISAPI e Win-CGI sejam idnticos. Foi utilizado um provedor comercial, capaz de
oferecer suporte no apenas ao desenvolvimento de aplicaes CGI, mas tambm de aplicaes baseadas
em Websnap e Intraweb, abordadas posteriormente.
As aplicaes CGI, no entanto, podem ainda ser testadas usando o Microsoft Personal Web Server, que
apresenta a vantagem de que a sua estrutura de diretrios semelhante existente em servidores Web
baseados no sistema operacional Windows NT. J aplicaes baseadas em Websnap e Intraweb podem
ser testadas a partir do prprio ambiente de desenvolvimento do Delphi 7. Conseqentemente, uma
aplicao CGI desenvolvida localmente (na fase de testes) pode ser facilmente transferida para o seu
verdadeiro servidor Web (do seu provedor).
Caso utilize o Personal Web Server, e tendo sido efetuada a sua instalao padro, os aplicativos CGI
so armazenados no diretrio C:\Inetpub\wwwroot\cgi-bin, e definiu-se o DNS como localhost e o
endereo IP como 127.0.0.1.
Voc pode ainda usar outro servidor Web (como o Apache) e executar procedimentos semelhantes, devendo
inicialmente verificar o tipo de aplicao CGI capaz de ser executada pelo seu servidor e o diretrio em que
essas aplicaes devero ser armazenadas (consulte o seu provedor para obter estas informaes).
UMA APLICAO CGI BASTANTE ELEMENTAR
Neste tpico, mostraremos uma aplicao CGI extremamente simples, com o objetivo de apresentar os
conceitos fundamentais cujo conhecimento indispensvel ao desenvolvimento de aplicaes CGI
com o Delphi 7.
Essa aplicao ser capaz de gerar como resposta uma pgina HTML esttica extremamente simples,
mas que lhe ajudar a compreender os conceitos bsicos. claro que uma aplicao CGI que gere uma
pgina HTML esttica no muito interessante (e nem precisamos de uma aplicao CGI para fazer
isso), mas os conceitos fundamentais so mais fceis de serem assimilados atravs de um exemplo
simples, porm conceitualmente correto.
Para criar essa aplicao CGI, proceda da seguinte maneira:
1. Selecione o item New/Other do menu File do Delphi 7 para exibir a caixa de dilogo New Items.
2. Selecione o item Web Server Application nessa caixa de dilogo, como mostrado na Figura 38.1.
Figura 38.1: Selecionando o cone Web Server Application na caixa de dilogo New Items.
3. Selecione o boto OK para fechar essa caixa de dilogo. Ser exibida a caixa de dilogo New
Web Server Application, mostrada na Figura 38.2, na qual voc deve escolher o tipo de aplicao
CGI capaz de ser executada pelo seu servidor Web. No caso desse exemplo, conforme j indicado
anteriormente, ser selecionada a opo CGI Stand-alone executable.
Figura 38.2: A caixa de dilogo New Web Server Application.
Caso voc queira que esta aplicao CGI possa ser compilada para vrias plataformas, marque o Checkbox correspondente. Neste caso,
no entanto, ter dificuldades em seguir os exemplos que usam o acesso via BDE.
4. Selecione o boto OK para fechar essa caixa de dilogo. Ser criada uma janela semelhante a
um DataModule, mas denominada WebModule1, conforme a Figura 38.3.
Figura 38.3: A criao do WebModule.
Um WebModule muito semelhante a um DataModule (e, conforme ser descrito posteriormente, um
DataModule pode ser facilmente transformado em um WebModule mediante a incluso de um
componente WebDispatcher).
Da mesma maneira que um DataModule, um WebModule serve como um repositrio para componentes
no visuais, como TTable, TQuery, TADOTable, TADOQuery, TSQLTable, TSQLQuery, TPageProducer, etc.
Alm disso, esse componente responsvel por definir como a aplicao deve responder a solicitaes
feitas por clientes atravs de mensagens que seguem o protocolo HTTP.
O gerenciamento dessas respostas feito atravs de um Editor de Aes, que define as respostas a
serem fornecidas para diversas solicitaes. No caso de esta aplicao-exemplo ser testada com o Per-
sonal web Server e salva com o nome WebCGITeste01.exe no diretrio C:\inetpub\wwwroot (o projeto
ser salvo como WebCGITeste01.dpr), a mensagem transmitida pelo browser ao servidor decorre da
digitao do seguinte endereo (URL) no browser:
http://localhost/WebCGITeste01.exe/parmetros.
Conforme descrito anteriormente, no caso de a aplicao estar sendo disponibilizada na Web voc
deve substituir localhost pelo endereo do seu servidor (nesse caso, localhost corresponde a um
servidor que est sendo executado localmente, na mesma mquina do cliente). O diretrio dever ser
substitudo pelo diretrio configurado pelo seu servidor como repositrio de aplicaes CGI. No meu
caso, tive que substituir localhost por marceloleao.com.br/cgi-bin.
WebCGITeste01.exe , obviamente, o nome da nossa aplicao CGI.
Os parmetros, conforme ser descrito posteriormente, informam aplicao CGI o tipo de resposta a
ser fornecida.
Para exibir o Editor de Aes (onde sero definidas as respostas da aplicao CGI), proceda da seguinte maneira:
1. Selecione o WebModule criado anteriormente e pressione o boto direito do mouse para exibir
o seu menu suspenso.
2. Selecione o item Action Editor desse menu para exibir a caixa de dilogo mostrada na figura a
seguir, na qual devero ser definidas as diversas aes a serem respondidas pela aplicao CGI.
Figura 38.4: O editor de aes do WebModule1.
Inicialmente, como era de se esperar, no existe qualquer ao de resposta definida pela aplicao.
Vamos ento definir uma primeira ao, executando os seguintes procedimentos:
1. Selecione o boto Add New (o primeiro no canto superior esquerdo) na caixa de dilogo do
Editor de Aes para criar um item chamado WebActionItem1. Esse item , na realidade, um
objeto da classe THTTPActionItem, e se voc selecion-lo poder visualizar suas propriedades
no Object Inspector.
Opcionalmente, voc pode usar a tecla Ins do seu teclado ou pressionar o boto direito do mouse sobre
o Editor de Aes e, no menu pop-up que ser exibido, selecionar o item Add.
Na realidade, cada item da caixa de dilogo do Editor de Aes um dos elementos da array Actions
(que uma propriedade do objeto WebModule). Por essa razo, a caixa de seleo de objetos do Object
Inspector indica o item WebModule1.Actions[0] mostrando que WebActionItem1 o primeiro
elemento dessa array, cujo ndice comea em 0.
As principais propriedades desse objeto so:
Name: Identifica o nome pelo qual o objeto referenciado no cdigo.
Default: Indica se esse item representar ou no a resposta default da aplicao. Caso nenhum
dos itens satisfaa s especificaes descritas na URL, a ao definida para o item default ser
executada (repare que no WebActionItem recm-criado sua propriedade default foi
automaticamente definida como True).
MethodType: Define os tipos de solicitaes a serem atendidas e pode ter um dos valores
apresentados a seguir: mtGet, mtHead, mtPost, mtPut e mtAny. O significado de cada um
desses valores ser descrito posteriormente e, inicialmente, utilizaremos o valor default mtAny,
que aceita todos os tipos de solicitao.
PathInfo: Esta propriedade uma string que define o texto correspondente ao digitado na URL
logo aps o nome da aplicao CGI.
A URL definida a seguir, por exemplo, executar na aplicao armazenada no Personal web Server a
ao definida pelo item cuja propriedade PathInfo igual a /Exemplo.
http://localhost/WebCGITeste01.exe/ Exemplo
Enabled: Esta propriedade define se o item est ou no habilitado. Se seu valor for igual a False, esse
item ser ignorado, ainda que suas propriedades MethodType e PathInfo correspondam s definidas
pela URL que disparou a execuo do aplicativo CGI. A nica exceo ocorre quando sua propriedade
default igual a True, pois nesse caso o valor da sua propriedade Enabled ignorado.
Para o item recm-criado, defina o valor da sua propriedade PathInfo como Exemplo. Repare que esse
valor ser exibido na caixa de dilogo do Editor de Aes.
Para definir uma resposta da aplicao correspondente a esse item, voc deve executar os seguintes
procedimentos:
1. Selecionar o item WebActionItem1 no Editor de Aes.
2. Selecionar a guia Events no Object Inspector.
3. Dar um duplo clique com o boto esquerdo do mouse sobre o espao em branco direita do
evento OnAction. Ser exibido o corpo principal do procedimento associado a esse evento,
como mostrado a seguir.
procedure TWebModule1.WebModule1WebActionItem1Action(Sender: TObject;
Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
begin
end;
Esse mtodo apresenta os seguintes parmetros:
Sender: TObject. Este parmetro identifica o objeto que disparou o evento.
Request: TwebRequest. Este parmetro , na realidade, um objeto da classe TwebRequest que
tem algumas propriedades que definem parmetros da mensagem. Inicialmente, no
utilizaremos esse parmetro.
Response: TwebResponse. Este parmetro um objeto da classe TwebResponse e define a resposta
que ser enviada ao cliente que enviou a mensagem ao servidor (atravs da URL). A principal
propriedade desse objeto a propriedade Content, que uma string que define a pgina HTML
a ser gerada como resposta mensagem enviada pelo cliente.
Handled: Boolean. Este parmetro passado por referncia e define se a mensagem foi ou no
completamente tratada pela aplicao.
Ao definir a propriedade PathInfo como Exemplo, indicamos que esse item responder mensagem
representada pela seguinte URL:
http://localhost/ WebCGITeste01.exe/Exemplo
Lembre-se que, se a propriedade default do WebActionItem for mantida como True, ser desnecessrio
incluir o PathInfo na URL.
Devemos agora definir a resposta que ser enviada ao cliente por esse item, e para isso precisamos
estabelecer adequadamente o valor da propriedade Content do objeto Response (que uma string).
Nesse caso, pode-se incluir a seguinte linha de cdigo no procedimento recm-criado:
Response.Content := <HTML><BODY><H1>Exemplo de Aplicao CGI</H1></ BODY ></ HTML > ;
Esse procedimento passar ento a ser definido como:
procedure TWebModule1.WebModule1WebActionItem1Action(Sender: TObject;
Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
begin
Response.Content := <HTML><BODY><H1>Exemplo de Aplicao CGI</H1></ BODY ></ HTML > ;
end;
Salve seu projeto com o nome WebCGITeste01 no diretrio C:\inetpub\wwwroot (se voc estiver
usando o PWS) ou no diretrio a partir do qual est sendo desenvolvido seu site (e a partir do qual ser
feito o upload dos arquivos), compile a aplicao (no a execute a partir do ambiente ou do Windows,
apenas compile) e armazene-a no diretrio correto. Em seguida, execute a aplicao CGI a partir de um
browser, digitando a seguinte URL (no caso do PWS):
http://localhost/WebCGITeste01.exe/Exemplo
Voc ver o resultado mostrado na Figura 38.5.
Nesta figura usei o endereo do provedor no qual fiz os testes:
http://www.marceloleao.com.br/cgi-bin/WebCGITeste01.exe/Exemplo
Figura 38.5: Visualizando o resultado no Inernet Explorer.
Conforme j descrito anteriormente, caso voc mantenha o valor da propriedade default do objeto
WebActionItem1 como True, a mesma resposta ser gerada quando voc digitar o seguinte endereo
no seu browser:
http://localhost/WebCGITeste01.exe
ou, no caso do meu provedor de testes:
http://www.marceloleao.com.br/cgi-bin/WebCGITeste01.exe
Conforme indicado pelo ttulo deste tpico, essa uma aplicao CGI extremamente simples, mas que
ilustrou os seguintes conceitos:
Toda aplicao CGI precisa de um objeto WebModule.
As respostas da aplicao so definidas por vrios itens includos no Editor de Aes.
Para cada item que define uma ao deve ser definido um procedimento associado ao evento
OnAction, e a resposta a ser gerada deve ser um cdigo HTML armazenado na string definida
pela propriedade Content do parmetro Response (que um objeto da classe TWebResponse).
Em alguns servidores Web de teste, como o que acompanhava o Front Page 98, o endereo deveria ser
fornecido como http://localhost/cgi-bin/WebCGITeste01.exe
EXIBINDO A DATA E A HORA DO SISTEMA EM UMA PGINA HTML
Neste tpico, aumentaremos um pouco a complexidade do exemplo criado no tpico anterior, de
forma a exibir na pgina gerada pela aplicao CGI a data e a hora do sistema (existindo, neste caso,
alguma interao que faa com que a diferencie de uma pgina completamente esttica).
Para exibir a data e a hora do sistema na pgina HTML gerada em resposta solicitao do cliente, basta
alterar o valor armazenado em Response.Content, redefinindo-o como na linha de cdigo a seguir:
Response.Content := <HTML><BODY><H1>Exemplo de Aplicao CGI</H1><p>Sao exatamente +Ti5:
meToStr(Time)+ do Dia +DatetoStr(Date)+</ BODY ></ HTML > ;
A figura a seguir exibe o resultado dessas alteraes.
Figura 38.6: Visualizando a data e a hora do sistema no Internet Explorer.
Repare que, nestes casos, como o valor da propriedade default do objeto WebActionItem1 foi definido
como True, bastou definir a URL como: http://www.marceloleao.com.br/cgi-bin/WebCGITeste01.exe
(seria http://localhost/ WebCGITeste01.exe no caso de se estar usando o Personal Web Server).
RESPONDENDO A ENTRADA DE DADOS DE FORMULRIOS HTML
Um formulrio definido na linguagem HTML pelas tags <Form> e </Form>, sendo que a primeira
tag tem dois parmetros que representam, respectivamente, uma ao a ser executada e o tipo de
mtodo de envio, que pode ser Get ou Post (trabalharemos com o mtodo Get, mas no caso de
desenvolvimento de aplicaes CGI no faz muita diferena usar Get ou Post, a menos que se trabalhe
com informaes confidenciais).
Inicialmente, nosso formulrio poderia ser representado pelo seguinte cdigo HTML:
<Form action = http://localhost/WebCGITest01.exe method = Get
</Form>
claro que esse cdigo geraria um formulrio em branco, o que no teria muito
significado. Para permitir uma entrada de dados pelo cliente, podem-se utilizar algumas caixas de
texto que, na linguagem HTML, so definidas pela tag <Input>.
A tag Input, ao ser usada para exibir caixas de texto, deve ser digitada obedecendo seguinte sintaxe:
<Input Type = Text Size = n Name = Texto a ser Exibido>
Nessa tag, n representa o nmero de caracteres que a caixa de texto deve ser capaz de exibir.
Alm disso, a tag <Input> tambm pode ser usada para exibir botes do tipo Submit e Reset. Nesses
casos, a tag <Input> deve ser digitada com a seguinte sintaxe:
<Input Type = Submit Value = Texto a Ser Exibido no Boto>
e
<Input Type = Reset Value = Texto a Ser Exibido no Boto>
respectivamente.
Apresentamos a seguir um arquivo bastante simples, que define uma pgina HTML salva com o nome
teste01.htm, e criada usando um editor bastante simples como o Bloco de Notas do Windows:
<HTML>
<BODY>
<H1>Exemplo de Formulrio</H1>
<p>
<Form action = http://www.marceloleao.com.br/cgi-bin/WebCGITeste02.exe method = Get
<p>Nome:
<Input Type = Text Size = 32 Name = Nome>
</p>
<p>Data de Nascimento:
<Input Type = Text Size = 20 Name = Data >
</p>
<Input Type = Submit Value = Ok>
<Input Type = Reset Value = Limpar>
</Form>
</BODY>
</HTML>
Se estiver testando a sua aplicao com o Personal Web Server use
<Form action = http://localhost/WebCGITeste02.exe method = Get
A Figura a 37.8 apresenta o aspecto desse formulrio elementar no Internet Explorer.
Se digitarmos as expresses Marcelo Leo e 28 de Julho de 1966 nas caixas de texto sem incluir
as aspas duplas, evidentemente e selecionarmos o boto OK do formulrio, a seguinte URL ser
exibida no browser:
http://www.marceloleao.com.br/cgi-bin/
WebCGITeste02.exe?Nome=Marcelo+Le%E3o&Data=28+de+julho+de+1966
ou, no caso de se estar usando o Personal Web Server:
http://localhost/WebCGITeste02.exe?Nome=Marcelo+Le%E3o&Data=28+de+Julho+de+1966
Embora seja gerada esta string, a aplicao WebCGITeste02.exe no ser executada, pois a mesma
ainda no foi criada!
Figura 38.7: Visualizando o formulrio no Internet Explorer.
Repare que o endereo da aplicao CGI est separado dos dados enviados pelo formulrio por um ponto
de interrogao. Aps esse ponto de interrogao, os nomes de cada caixa de texto e o valor digitado em
cada uma delas so exibidos aos pares, separados por um sinal de igualdade, =, na forma:
Nome_do_Parmetro=Valor_Digitado
Repare que os vrios pares de informaes so separados por um e comercial & e que os espaos
em branco digitados em cada valor so substitudos por sinais de adio.
Por essa razo, a expresso 28 de Julho de 1966 aparece como
28+de+Julho+de+1966.
Quando utilizamos o mtodo Get, cada par de informaes Nome_do_Parmetro=Valor_Digitado
armazenado, na forma de uma string, como um elemento de um objeto da classe TStrings (que representa
uma lista de strings).
Esse objeto , na realidade, a propriedade QueryFields do objeto Request, que , por sua vez, uma
propriedade do objeto WebModule.
fcil verificar, portanto, que ao proceder dessa forma estaremos na realidade manipulando objetos da
classe TStrings, juntamente com seus mtodos e propriedades.
No caso deste exemplo, os elementos do objeto QueryFields sero:
QueryFields[0] : Nome=Marcelo Leo
QueryFields[1] : Data=28 de Julho de 1966
Para tornar nossas pginas HTML mais dinmicas, podemos utilizar o componente PageProducer,
apresentado no prximo tpico.
O COMPONENTE PAGEPRODUCER
O Delphi 7 tem um componente chamado PageProducer, que permite que se defina um modelo de
pgina HTML a partir de alguns parmetros a serem definidos em run-time.
Esse componente tem uma propriedade chamada HTMLDoc, que um objeto da classe TStrings e
que define o cdigo HTML que servir como modelo da pgina que ser gerada em resposta
solicitao do cliente.
Alternativamente, voc pode digitar o modelo de cdigo HTML em um arquivo e definir o nome desse
arquivo na propriedade HTMLFile. importante salientar, no entanto, que essas propriedades so
mutuamente excludentes, isto , definir um valor para uma delas anula o valor definido para a outra.
A principal caracterstica desse modelo de pgina HTML so as tags <#Nome_da_Tag>, que no existem
na linguagem HTML e cuja funo nica e exclusivamente indicar ao componente PageProducer os
parmetros que sero definidos em run-time.
Para criar uma aplicao CGI que gere uma resposta ao envio de dados pelo formulrio (essa aplicao
ser salva com o nome WebCGITeste02.exe), proceda da seguinte forma:
1. Selecione o item New/Other do menu File do Delphi 7, para exibir a caixa de dilogo New Items.
2. Selecione o item Web Server Application nessa caixa de dilogo.
3. Selecione o boto OK para fechar essa caixa de dilogo. Ser exibida a caixa de dilogo New
Web Server Application, na qual voc deve selecionar a opo CGI Stand-alone executable,
como no exemplo anterior.
4. Selecione o boto OK para fechar essa caixa de dilogo e criar um WebModule com o nome
default WebModule1.
5. Coloque um componente PageProducer (o segundo componente da pgina Internet da paleta
de componentes) no WebModule1, conforme indicado na Figura 38.8 (esse componente receber
o nome default PageProducer1).
6. Selecione as reticncias exibidas direita da propriedade HTMLDoc do componente
PageProducer1. Ser exibida a caixa de dilogo String List Editor.
7. Digite nessa caixa de dilogo o modelo de pgina HTML a ser gerada, conforme mostrado no
trecho de cdigo apresentado a seguir:
<HTML>
<BODY>
<H1>Ol <#Nome></H1>
<p>
<H1>Pelas suas informaes, voc nasceu em <#Data></H1>
<p>
</BODY>
</HTML>
Figura 38.8: Inserindo um componente PageProducer no WebModule.
Esse cdigo define Nome e Data como parmetros a serem definidos em run-time, usando o recurso
de tags transparentes.
8. Crie um novo item na caixa de dilogo do Editor de Aes do WebModule e mantenha o seu
nome default WebActionItem1.
9. Altere o valor da propriedade default desse objeto para True.
10. Defina a propriedade Producer deste objeto como o nome do objeto PageProducer recm-
includo no WebModule.
11. Defina da seguinte maneira o procedimento associado ao evento OnHTMLTag do componente
PageProducer1:
procedure TWebModule1.PageProducer1HTMLTag(Sender: TObject; Tag: TTag;
const TagString: String; TagParams: TStrings; var ReplaceText: String);
begin
ReplaceText := Request.QueryFields.Values[TagString];
end;
A substituio de parmetros na pgina-modelo feita no procedimento associado ao evento
OnHTMLTag, e esse evento chamado sempre que se quer obter o valor a ser atribudo a um parmetro
(esse parmetro passado como a constante TagString no cabealho do procedimento). Conforme
descrito anteriormente, a propriedade QueryFields um objeto da classe TStrings que, no caso de
utilizao do mtodo Get, define uma lista de string em que cada uma delas representa um parmetro.
Essa lista de strings, como descrito anteriormente, armazena strings cujo contedo est na forma
Nome=Valor. A classe TStrings, no entanto, tem propriedades que permitem retornar apenas um dos
valores, situado de um dos lados do sinal de igual.
A propriedade Values do objeto TStrings, por exemplo, retorna os valores exibidos direita do sinal de
igual. Para obter o valor correspondente string Nome, por exemplo, basta digitar essa string entre
colchetes. importante lembrar que esse valor retornado como uma string, mesmo que os caracteres
armazenados sejam todos numricos.
A propriedade Names, por outro lado, retorna os valores exibidos esquerda do sinal de igual.
Por essa razo, basta atribuir varivel ReplaceText o valor armazenado na propriedade
Values, correspondente string TagString.
A figura a seguir apresenta o resultado da execuo desse formulrio no Internet Explorer.
Figura 38.9: Visualizando o resultado no Internet Explorer.
Voc j deve ter reparado que as pginas HTML usadas como exemplo neste captulo so bastante
simples. Isso se deve ao fato de que o nosso principal objetivo neste captulo apresentar os conceitos
relacionados criao de aplicaes CGI com o Delphi 7, e no o de apresentar um tutorial sobre a
linguagem HTML.
No prximo tpico, ser apresentado o componente DataSetTableProducer, que permite gerar pginas
HTML a partir dos valores armazenados nos campos dos registros de uma tabela.
O COMPONENTE DATASETTABLEPRODUCER
O Delphi 7 tem um componente chamado DataSetTableProducer, que permite que se defina um
modelo de pgina HTML que exiba em run-time diversos registros armazenados em uma tabela de
um banco de dados.
Esse componente deve trabalhar sempre em conjunto com um componente PageProducer, apresentado
anteriormente. Neste tpico, ser utilizado o mesmo exemplo apresentado nos tpicos anteriores,
fazendo-se, no entanto, algumas alteraes de forma a poder utilizar o componente
DataSetTableProducer.
Para alterar o exemplo anterior de forma a poder ilustrar a utilizao do componente
DataSetTableProducer, proceda da seguinte forma:
1. Coloque um componente Table no WebModule (da mesma maneira que se faz em um
DataModule) e mantenha o seu nome default Table.
No caso de ter marcado a opo Cross Plataform na criao da aplicao servidora, voc no poder acessar os componentes da pgina
BDE da paleta de componentes. Coloque ento um componente ClientDataset no WebModule (ao invs do Table) e mantenha o seu
nome default ClientDataset1.
2. Defina os valores das suas propriedade Databasename e TableName para apontar para o arquivo
Country.db, geralmente no diretrio C:\Arquivos de Programas\Arquivos Comuns\Borland
Shared\Data, correspondente ao alias DBDEMOS do BDE.
Caso esteja usando o componente ClientDataset pelas razes j descritas, defina o valor da sua propriedade FileName para apontar
para o arquivo Country.cds, geralmente no diretrio C:\Arquivos de Programas\Arquivos Comuns\Borland Shared\Data.
3. Defina da seguinte maneira o procedimento associado ao evento OnCreate do WebModule:
procedure TWebModule1.WebModuleCreate(Sender: TObject);
begin
Table1.Open;
end;
Caso esteja usando o componente ClientDataset pelas razes j descritas, o cdigo ser:
begin
ClientDataset1.Open;
end;
4. Coloque um componente DataSetTableProducer no WebModule e mantenha o seu nome de-
fault DataSetTableProducer1.
5. Defina o valor da propriedade DataSet desse componente como ClientDataset1.
6. Ao menos durante esta fase, defina a propriedade Active do componente Table1 como True (e
neste caso, ao menos temporariamente, sua propriedade Databasename dever ser configurada
como DBDEMOS).
7. Clique com o boto esquerdo do mouse sobre as reticncias exibidas direita da propriedade
Header desse componente. Ser exibida a caixa de dilogo String List Editor, na qual deve ser
digitado um cabealho para a tabela. Digite a expresso Relao dos pases Armazenados na
Tabela Country.
8. Clique com o boto esquerdo do mouse sobre as reticncias exibidas direita da propriedade
Footer desse componente. Ser exibida a caixa de dilogo String List Editor, na qual deve ser
digitado um rodap para a tabela. Digite a expresso Tabela gerada com o componente
DataSetTableProducer.
9. Selecione esse componente com o boto direito do mouse e, no menu suspenso que ser exibido,
selecione o item Response Editor (voc obter o mesmo resultado selecionando as reticncias
existentes direita da propriedade Columns do componente DatasetTableProducer). Ser exibida
a caixa de dilogo mostrada na Figura 38.10, que permite que se definam:
Os campos a serem exibidos.
O alinhamento desses campos.
A cor de fundo das clulas que exibem os campos.
Uma pr-visualizao da tabela gerada.
O alinhamento do texto nas clulas.
E muitas outras opes. Este , sem dvida alguma, um fantstico editor de propriedades!
10. Caso seja necessrio, selecione o boto Add All Fields para especificar a utilizao de todos os campos.
Repare que os campos ainda aparecem de maneira confusa, como mostrado na Figura 38.10, o que ser
corrigido nos prximos procedimentos. Este editor permite que os campos da tabela possam ser tratados
como objetos independentes.
Voc pode deletar um campo (selecionando um boto Delete) e alterar a ordem de exibio desses
campos (selecionando os botes Move Up e Move Down).
Figura 38.10: O editor de colunas do componente DataSetTableProducer1.
11. Selecione cada um dos campos e altere o valor da sua propriedade Align como haCenter.
12. Altere a propriedade bgColor do GroupBox Table Properties para Gray. O editor de colunas
dever ficar com o aspecto apresentado na Figura 38.11. Repare que a pr-visualizao da tabela
melhorou bastante.
13. Altere para 1 o valor da propriedade Border do GroupBox Table Properties. O editor de colunas
dever ficar com o aspecto apresentado na Figura 38.12. Repare que a pr-visualizao da tabela
melhorou ainda mais.
14. Feche o editor de colunas do componente DataSetTableProducer1.
Figura 38.11: O editor de colunas do componente DataSetTableProducer1,
aps a alterao de algumas propriedades.
Figura 38.12: O editor de colunas do componente DataSetTableProducer1,
aps a alterao de algumas propriedades.
15. Crie uma nova pgina HTML chamada Teste02.htm, com o seguinte cdigo:
<HTML>
<BODY>
<H1>Selecione o Boto Abaixo Para Exibir a Tabela</H1>
<p>
<Form action = http://localhost/WebCGITeste02.exe method = GET>
</p>
<Input Type = Submit Value = Exibir tabela>
</Form>
</BODY>
</HTML>
Esse um formulrio ainda mais simples, mas sua nica funo exibir um boto que, ao ser selecionado
pelo usurio, exibe a tabela em uma pgina HTML.
No meu caso, usei para acessar o provedor de testes:
<Form action = http://www.marceloleao.com.br/cgi-bin//WebCGITeste02.exe method = GET>
16. Altere a propriedade HTMLDoc do componente PageProducer1 da maneira indicada a seguir.
Repare que nesse caso teremos apenas um parmetro, chamado tabela, que dever ser substitudo
pelos vrios registros.
<HTML>
<BODY>
<H1>Resultado da Solicitao</H1>
<p>
<#tabela>
</BODY>
</HTML>
17. Redefina da seguinte maneira o procedimento associado ao evento OnHTMLTag do componente
PageProducer1:
begin
ReplaceText := DataSetTableProducer1.Content;
end;
Voc tambm pode excluir o componente PageProducer e definir a propriedade Producer do objeto WebAction1 como sendo igual a
DatasetTableProducer1.
18. Visualize a pgina que contm o formulrio no seu browser. Selecione o boto Exibir Tabela
para visualizar o resultado, como mostrado nas Figuras 38.13 e 38.14.
Voc pode alterar o aspecto da exibio do resultado alterando algumas propriedades do componente
DataSetTableProducer. Como um usurio avanado do Delphi 7, voc deve explorar ao mximo suas
potencialidades.
Figura 38.13: Visualizando o formulrio no Internet Explorer.
importante lembrar que, neste caso, o mecanismo de acesso deve estar corretamente configurado no
servidor, para que o acesso a bancos de dados funcione corretamente. No caso de uma tabela no
formato cds, acessada usando o componente ClientDataset, geralmente nenhuma configurao espe-
cial necessria. No caso do acesso via BDE, a propriedade DatabaseName do componente Table deve
ser redefinida adequadamente.
No prximo tpico, ser apresentado o componente QueryTableProducer, capaz de gerar uma pgina HTML
a partir de uma solicitao do cliente, executando uma declarao SQL. Neste caso, ser usado o BDE.
O COMPONENTE QUERYTABLEPRODUCER
O Delphi 7 tem um componente chamado QueryTableProducer que permite que se defina um modelo
de pgina HTML que exiba em run-time diversos registros armazenados em uma tabela de um banco
de dados, obtidos como resultado de uma consulta SQL parametrizada.
A sua principal vantagem que, se voc definir no formulrio HTML um componente cujo Nome seja
igual a um parmetro da declarao SQL definida em um componente Query colocado no WebModule,
o valor desse parmetro ser igual ao passado na URL.
Para ilustrar um pouco mais estes conceitos, vamos criar um novo formulrio, em um arquivo HTML
chamado Teste03.htm, cujo cdigo apresentado a seguir.
<HTML>
<BODY>
<H1>Selecione Uma Opo e o Boto Para Exibir a Tabela</H1>
<p>
<Form action = http://localhost/WebCGITeste02.exe method = GET>
</p>
<Input Type = Radio Name = Continent Value = South America CHECKED>Amrica do Sul
<p>
<Input Type = Radio Name = Continent Value = North America>Amrica do Norte
<p>
<Input Type = Submit Value = Exibir tabela>
</Form>
</BODY>
</HTML>
No meu caso, usei para acessar o provedor de testes:
<Form action = http://www.marceloleao.com.br/cgi-bin//WebCGITeste02.exe method = GET>
Nesse formulrio, o usurio dever selecionar um continente para obter informaes apenas sobre os
pases nele situados.
A Figura 38.15 apresenta o formulrio gerado.
Quando o usurio selecionar o boto Exibir Tabela, ser gerada uma das seguintes URLs, no caso de se
estar usando o Personal Web Server:
http://localhost/WebCGITeste02.exe?Continent=South+America
Ou:
http://localhost/WebCGITeste02.exe?Continent=North+America
Assim como o componente DataSetTableProducer, o componente QueryTableProducer pode trabalhar
em conjunto com um componente PageProducer.
Sero aplicadas algumas alteraes no exemplo anterior, de modo a permitir a utilizao desse
componente.
Para alterar o exemplo anterior, proceda da seguinte forma:
1. Coloque um componente QueyTableProducer no WebModule e mantenha o seu nome default
QueryTableProducer1.
2. Coloque um componente Query no WebModule e mantenha o seu nome default Query1.
3. Defina os valores das suas propriedade Databasename e TableName para apontar para o arquivo
Country.db, geralmente no diretrio C:\Arquivos de Programas\Arquivos Comuns\Borland
Shared\Data, correspondente ao alias DBDEMOS do BDE. Ao menos durante esta fase, defina
a propriedade Active do componente Table1 como True (e neste caso, ao menos
temporariamente, sua propriedade Databasename dever ser configurada como DBDEMOS).
4. Defina a propriedade SQL do componente Query1 como indicado a seguir.
Select * From Country.db Where Continent = :Continent
5. Selecione as reticncias exibidas direita da propriedade Params do componente Query1 para
exibir a janela de configurao de parmetros, mostrada na Figura 38.16.
6. Selecione o parmetro Continent e altere as suas propriedades no Object Inspector (defina seu
tipo como sendo string).
7. Altere o valor da propriedade Query do componente QueryTableProducer1 para Query1.
8. Altere o valor da Subpropriedade bgColor da propriedade TableAttributes desse componente
para Gray.
9. Altere o valor da Subpropriedade Border da propriedade TableAttributes desse componente para 2.
Figura 38.16: Definindo o valor da propriedade Params do componente Query1.
10. Defina a propriedade Header desse componente digitando a expresso Relao dos pases
Selecionados na Tabela Country.db na caixa de dilogo String List Editor.
11. Defina a propriedade Footer desse componente digitando a expresso Tabela gerada com o
componente QueryTableProducer na caixa de dilogo String List Editor.
12. Redefina da seguinte maneira o procedimento associado ao evento OnHTMLTag do componente
PageProducer1:
begin
ReplaceText := QueryTableProducer1.Content;;
end;
13. Defina da seguinte maneira o procedimento associado ao evento OnCreate do WebModule):
begin
Query1.Open;
end;
14. Salve e recompile a aplicao WebCGITeste02.exe.
15. Selecione uma opo no formulrio e o boto Exibir Tabela, para obter os resultados mostrados
nas figuras a seguir.
Figura 38.17: Visualizando o resultado no Internet Explorer, aps selecionar a opo Amrica do Sul.
Figura 38.18: Visualizando o resultado no Internet Explorer, aps selecionar a opo Amrica do Norte.
Repare que, na utilizao do componente QueryTableProducer, importante garantir que os parmetros
da declarao SQL tenham os mesmos nomes dos parmetros gerados na URL (normalmente definido
pela propriedade Name dos componentes de interface do formulrio HTML).
KNOW-HOW EM: DESENVOLVIMENTO DE APLICAES CGI COM WEBSNAP
PR-REQUISITOS
Conhecimentos bsicos da linguagem HTML.
METODOLOGIA
Apresentao do problema: Criao de uma aplicao CGI com a tecnologia WebAnap, utilizando os componentes disponveis no ambiente de
desenvolvimento integrado do Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios ao desenvolvimento de aplicaes CGI com a tecnologia WebSnap.
A tecnologia Websnap foi incorporada na verso 6 do Delphi e na verso 2 do Kylix, sendo o primeiro
passo no desenvolvimento RADS de aplicaes para a Internet.
Ao contrrio do que ocorre com aplicaes CGI desenvolvidas com a tecnologia WebBroker, muitas
funcionalidades j esto prontas para serem usadas, mas neste caso o desenvolvedor no tem tanto
domnio sobre o cdigo gerado pela aplicao.
Neste exemplo sero apresentadas, atravs de um exemplo, as principais tcnicas para a criao de
aplicaes Web com a tecnologia WebSnap.
CRIANDO O MDULO PRINCIPAL DE UMA APLICAO WEBSNAP
Para criar o mdulo bsico de uma aplicao WebSnap, voc deve executar os seguintes procedimentos:
1. Selecione File/New/Other no menu do Delphi 7. Ser mostrada a caixa de dilogo New Items.
Nesta caixa de dilogo, selecione o item WebSnap Application da guia WebSnap, como mostrado
na figura a seguir.
Figura 38.19: A Guia Websnap da caixa de dilogo New Items.
2. Selecione o boto OK. Ser exibida a caixa de dilogo New WebSnap Application, mostrada na
figura a seguir.
Figura 38.20: A caixa de dilogo New Websnap Application.
Esta caixa de dilogo permite selecionar o tipo de aplicao que ser desenvolvida, e inicialmente ser
selecionada a opo Web App Debugger Executable, que permite testar a aplicao a partir do prprio
ambiente de desenvolvimento integrado do Delphi 7. O Web App Debugger , na realidade, um servidor
http integrado, e que associar uma aplicao servidora COM nossa aplicao.
3. Selecione a opo Web App Debugger Executable, para que se possa depurar a aplicao.
4. Defina CoClassName como ExemploCountry.
5. em Application Module Components selecione a opo Page Module.
6. Em Page Name coloque ExemploClubeDelphi.
7. Se voc selecionar o boto Components do GroupBox Application Module Components, ver
vrias opes disponveis na caixa de dilogo Web App Components, que inicialmente ser
mantida com as opes default.
8. Selecione o boto Page Options situado no grupo Application Module Options, e na caixa de
dilogo que ser exibida defina a opo Producer/Type como AdapterPageProducer, como
Figura 38.21: A caixa de dilogo Application Module Page Options.
9. Selecione o boto OK para fechar esta caixa de dilogo.
10. Selecione o boto OK para criar o Web Page Module, que ser o mdulo principal desta nossa
aplicao webSnap de exemplo, e reproduzida na Figura 38.22.
11. Selecione File/Save e salve a unit associada com o nome UnitPageModule.pas.
12. Selecione File/Save Project As para salvar a unit principal (at ento chamada Unit1) como
UnitServer (pois corresponder ao formulrio da aplicao servidora COM) e o projeto com o
nome ExemploWebSnap.
13. Inclua um componente session e um componente Table (ambos da pgina BDE da paleta de
componentes) no Web Page Module recm-criado.
Figura 38.22: O Mdulo Principal da Aplicao.
14. Defina o nome do componente Session como SessionCountry.
15. Defina o nome do componente Table como TblCountry.
16. Defina a propriedade AutoSessionName do componente Session como sendo igual a True.
17. Configure as propriedades do componente TblCountry para acessar a tabela Country.db.
18. Defina como True a propriedade Active do componente TblCountry.
19. Usando o Fields Editor do componente TblCountry, adicione objetos para representar todos os
campos da tabela, como mostrado na figura a seguir.
Figura 38.23: A janela do Fields Editor.
20. Selecione o campo Name e defina como True a propriedade ProviderFlags/pflnKey do objeto
que representa este campo.
21. Adicione um componente DatasetAdapter (pgina Websnap da paleta de Componentes) ao
Web Page Module, e defina a sua propriedade Dataset como TblCountry.
22. Altere a sua propriedade Name para DatasetAdpterCountry.
23. Selecione o componente Application Adapter e altere a sua propriedade Application Title para
Exemplo de Aplicao WebSnap.
24. No Editor de cdigos, selecione a guia Preview para visualizar a pgina esttica gerada, como
Figura 38.24: Visualizando a pgina gerada no Editor de Cdigos
Cada um dos componentes j existentes na aplicao tem sua prpria finalidade.
O AdapterPageProducer responsvel pela gerao final do cdigo HTML a partir das
informaes obtidas de outros componentes.
O WebAppComponents centraliza o acesso aos demais componentes.
O ApplicationAdapter fornece acesso aos campos e aes da varivel de script Application. Um
exemplo a propriedade Title desta varivel, que igual propriedade ApplicationTiltle deste
componente.
O PageDispatcher trata as requisies http dos usurios, redirecionando-as aos responsveis
pelas respostas.
O AdapterDispatcher responsvel pelo tratamento de informaes provenientes de formulrios
e imagens.
O DatasetAdapter trata da interface com scripts responsveis pelas operaes com registros
provenientes de componentes de acesso a bancos de dados.
ADICIONANDO UM GRID PARA EXIBIO DOS REGISTROS
Vamos incrementar nossa pgina, adicionando um Grid para exibio dos registros provenientes da
tabela Country.db, acessada atravs do componente TblCountry.
Para criar este Grid, voc deve executar os seguintes procedimentos:
1. Selecione o componente AdapterPageProducer e, no seu menu pop-up, o item Web Page Edi-
tor, para exibir a janela mostrada a seguir.
Figura 38.25: A janela do Web Page Editor.
2. No Web Page Editor, selecione o boto New Item e, na caixa de dilogo Add Web Component
que ser exibida, escolha o item AdapterForm e o boto OK.
Figura 38.26: A caixa de dilogo Add Web Component.
3. Altere a propriedade Name do objeto AdapterForm1 para CountryForm. Voc pode encarar
este objeto como um formulrio no qual sero inseridos componentes
4. Selecione o objeto CountryForm e, no seu menu pop-up, o item New Component. Na caixa de
dilogo Add Web Component que ser exibida, selecione o item AdapterGrid e o boto OK.
Considere que voc est inserindo um Grid em um formulrio. Repare que o contedo da
caixa de dilogo Add Web Component varia de acordo com o componente que est selecionado.
Figura 38.27: A caixa de dilogo Add Web Component.
5. Altere a propriedade Name do objeto AdapterGrid1 para CountryGrid.
6. Defina a propriedade Adapter deste componente como DatasetAdapterCountry ( anlogo a
definir o Datasource para um DBGrid).
Repare, como mostrado na figura a seguir, que os registros j podem ser visualizados. Repare ainda na
hierarquia entre os componentes.
Figura 38.28: Visualizando os Registros da Tabela Country.db.
ADICIONANDO BOTES PARA A EDIO DOS REGISTROS DO GRID
1. Selecione o item AdapterPageProducer e, no seu menu pop-up, o item WepPageEditor.
2. Selecione o objeto CountryGrid e, no seu menu pop-up, o item Add All Columns.
3. Selecione o objeto CountryGrid e, no seu menu pop-up, o item New Component. Na caixa de
dilogo que ser exibida, selecione a opo AdapterCommandColumn e o boto OK. Altere a
propriedade Name do Objeto criado para GridCommandColumn.
4. Selecione o objeto GridCommandColumn e, no seu menu pop-up, o item Add Commands.
5. Na caixa de dilogo Add Commands, selecione DeleteRow, EditRow e NewRow, como mostrdo
na figura a seguir.
Figura 38.29: A caixa de dilogo Add Commands.
6. Selecione os objetos que representam estes botes e altere as suas propriedades Caption para Excluir,
Editar e Novo, respectivamente. Sua pgina ficar com o aspecto mostrado na figura a seguir.
Figura 38.30: Aspecto da pgina aps a incluso dos botes.
CRIANDO UMA PGINA COM UM FORMULRIO PARA EDIO DOS REGISTROS
Neste tpico ser criado um novo Web Page Module, responsvel pela edio dos registros da tabela.
Para criar este Web Page Module, voc deve executar os seguintes Procedimentos:
Nesta caixa de dilogo, selecione o item WebSnap Page Module na guia WebSnap e o boto OK.
2. Defina a opo Producer Type como AdapterPageProducer.
3. Defina Page Name como EditaCountry.
4. Desmarque a opo Published.
Sua caixa de dilogo dever ficar com o aspecto mostrado na figura a seguir:
Figura 38.31: Criando o novo Websnap Module.
5. Selecione o boto OK para criar o novo Page Module.
6. Salve a unit associada como UnitPageEditaCountry.
7. Selecione o componente Adapter PageProducer e, no seu menu pop-up, o item WebPageEditor.
8. No Web Page Editor, selecione o boto New Item e, na caixa de dilogo Add Web Component
que ser exibida, escolha o item AdapterForm e o boto OK.
9. Altere a propriedade Name do objeto AdapterForm1 para EditCountryForm.
10. Selecione o objeto EditCountryForm e, no seu menu pop-up, o item New Component. Na
caixa de dilogo Add Web Component que ser exibida, selecione o item AdapterFieldGroup e
o boto OK.
11. Adicione a unit UnitPageModule clusula Uses desta unit, atravs do menu File/Use unit do
Delphi 7.
12. Altere a propriedade Name do objeto AdapterFieldGroup para CountryAdapterFieldGroup.
13. Defina a propriedade Adapter deste componente como ExemploClubeDelphi.DatasetAdapterCountry.
14. Altere a propriedade AdapterMode deste componente para Edit.
15. Selecione o objeto EditCountryForm e, no seu menu pop-up, o item New Component. Na caixa
de dilogo Add Web Component que ser exibida, selecione o item AdapterCommandGroup e o
boto OK.
16. Altere a propriedade Name deste objeto para CountryAdapterCommandGroup.
17. Altere a propriedade DisplayComponent deste objeto para CountryAdapterFieldGroup.
18. Selecione o objeto CountryAdapterCommandGroup e, no seu menu pop-up, o item Add Com-
mands. Na caixa de dilogo que ser exibida, selecione Applyncel e RefreshRow, e o boto OK.
19. Altere a propriedade Caption destes botes para Aplicar, Cancelar e Atualizar, respectivamente.
sua pgina ficar com o aspecto mostrado na figura a seguir.
Figura 38.32: Aspecto da pgina aps a incluso dos botes.
CONECTANDO AS PGINAS
1. Para conectar as pginas, selecione os objetos que representam os botes Aplicar, Atualizar e
Cancelar no Web Page Module EditaCountry, e digite ExemploClubeDelphi na sua propriedade
PageName.
2. Selecione os objetos que representam os botes Novo e Editar no Web Page Module
EditaExemploClubeDelphi, e digite EditaCountry na sua propriedade PageName.
TESTANDO A APLICAO
Como a aplicao foi criada com a opo Web App Debugger Executable, ela pode ser testada a partir
do prprio ambiente do Delphi, bastando para isso executar os seguintes procedimentos:
1. Selecione Run/Run para executar a aplicao servidora, que ser representada pelo Form1.
2. Selecione Tools/Web App Debugger. Ser exibida a caixa de dilogo mostrada na figura a seguir.
Selecione o boto Start e a URL mostrada pata exibir o seu browser default.
3. No browser, selecione a opo correspondente sua aplicao e o boto GO.
4. Teste a aplicao.
Figura 38.33: O Web App Debugger.
Figura 38.34: Selecionando a aplicao.
As figuras a seguir mostram a aplicao sendo executada no browser.
Figura 38.35: Visualizando registros.
Figura 38.36: Editando registros.
TRATANDO ERROS
Para tratar erros referentes edio dos registros, voc deve executar os seguintes procedimentos:
1. Exiba o Web Page Module secundrio EditaCountry.
2. Selecione o componente AdapterPageProducer e, no seu menu pop-up, o item Web Page Editor.
3. Selecione o objeto EditCountryForm e, no seu menu pop-up, o item New Component. Escolha
o item AdapterErrorList e o boto OK. Configure a propriedade Adapter deste objeto como
sendo igual a ExemploClubeDelphi.DatasetAdapterCountry.
4. Escolha Tools/Debugger Options. Na caixa de dilogo que ser exibida, selecione a guia Lan-
guage Exceptions e desmarque a opo Stop on Delphi Exceptions.
5. Execute a aplicao. Tente cadastrar um pas com um valor invlido para o campo Area, por
exemplo, e verifique a mensagem de erro que ser exibida na pgina.
CRIANDO UMA PGINA DE LOGIN
Para criar uma pgina de Login, voc deve executar os seguintes procedimentos:
Nesta caixa de dilogo, selecione o itemWebSnap Page Module na guia WebSnap e o boto OK.
2. Defina Producer Type como AdapterPageProducer.
3. Defina Page Name como LoginPage.
4. Selecione o boto OK para criar o novo Page Module.
5. Salve a unit associada como UnitLoginPage.
6. Inclua um componente LoginFormAdapter (pgina WebSnap da paleta de componentes) neste
Websnap Page Module.
7. Altere sua propriedade Name para LoginFormAdapterCountry.
8. Selecione o componente AdapterPageProducer e, no seu menu pop-up, o item Web Page Editor.
9. Selecione o objeto AdapterPageProducer e, no seu menu pop-up, o item New Component.
Escolha o item AdapterForm e o boto OK.
10. Altere sua propriedade Name para AdapterFormLogin.
11. Selecione o objeto AdapterFormLogin e, no seu menu pop-up, o item New Component. Escolha
o item AdapterFieldGroup e o boto OK.
12. Altere a propriedade Name do objeto criado para AdapterFieldGroupLogin. Configure a sua
propriedade Adapter para o LoginFormAdapter recm-criado.
13. Selecione o objeto AdapterFormLogin e, no seu menu pop-up, o item New Component. Na
caixa de dilogo que ser exibida, selecione o item AdapterCommandGroup e o boto OK.
14. Altere a propriedade Display Component deste objeto AdapterCommandGroup para
AdapterFieldGroupLogin.
15. Selecione o objeto AdapterCommandGroup e, no seu menu pop-up, o item New Component.
Na caixa de dilogo que ser exibida, selecione o item AdapterActionButton e o boto OK.
16. Altere a propriedade ActionName deste objeto AdapterActionButton para Login. Sua pgina
deve ficar com o aspecto mostrado na figura a seguir.
Figura 38.37: Criando a pgina de Login.
17. Altere a propriedade ActionName deste objeto para Login.
18. Exiba o Mdulo Principal da Aplicao (ExemploClubeDelphi).
19. Coloque um componente EndUserSessionAdapter no Web Page Module ExemploClubeDelphi,
e altere a sua propriedade Name para EndUserSessionAdapterCountry. Defina sua propriedade
LoginPage como LoginPage.
20. Inclua tambm um componente SessionsService (pgina WebSnap da paleta de componentes)
e altere a sua propriedade Name para SessionsServiceCountry. Agora a pgina de Login est
disponvel para ser requisitada por todas as demais pginas desta nossa aplicao WebSnap.
O componente LoginFormAdapter possui uma propriedade chamada PasswordRequired que, se definida como sendo igual a True, no
permitir usurios cuja senha seja nula.
21. Coloque um componente WebUsersList no Websnap Page Module ExemploClube Delphi, e
altere a sua propriedade Name para WebUserListCountry.
22. Exiba a caixa de dilogo associada sua propriedade UserItems e crie diversos usurios, com
Username e Password.
DEFININDO AS PGINAS QUE REQUEREM LOGIN
Falta agora definir as pginas cujo acesso requer a autenticao do usurio. A maneira mais simples de
fazer isto consiste em marcar a opo Login Required ao se criar o Web Page Module.
Neste exemplo, em que estes Web Page Modules foram criados sem que tal opo fosse habilitada,
devemos retirar os comentrios existentes em suas units, que consiste em alterar, por exemplo, a linha
de cdigo da seo initialization de cada unit de Initialization
initialization
if WebRequestHandler <> nil then
WebRequestHandler.AddWebModuleFactory(TWebAppPageModuleFactory.Create(TExemploClubeDelphi,
TWebPageInfo.Create([wpPublished {, wpLoginRequired}], .html), caCache)
Para:
initialization
TWebPageInfo.Create([wpPublished, wpLoginRequired], .html), caCache)
DEFININDO DIREITOS DE ACESSO A USURIOS
Cada objeto que representa um usurio na caixa de dilogo associada propriedade UserItems do
componente WebUserList possui uma propriedade chamada AccessRights, que define os seus direitos
de acesso.
Para definir estes direitos de acesso na pgina gerada pelo Web Page Module EditaCountry, faa o seguinte:
1. Selecione o componente AdapterPageProducer deste Web Page Module e, no seu menu pop-
up, selecione Web Page Editor.
2. Selecione o objeto CountryAdapterFieldGroup e, no seu menu pop-up, o item Add All Fields,
para criar objetos que representam os campos da tabela Country.db e, para cada um destes
objetos, defina a sua propriedade ViewMode como vmToggleOnAccess.
3. No Web Page Module principal da aplicao, selecione o componente DatasetAdapterCountry
e defina a sua propriedade ModifyAccess como Modifica.
Apenas usurios cuja propriedade AccessRights for igual a Modifica podero alterar estes campos.
O mesmo vale para Visualizao, caso queira que apenas alguns usurios possam visualizar o contedo de alguns campos.
O mesmo se aplica ao acesso a uma pgina. Voc pode permitir que apenas usurios com determinado
direito de acesso tenham direito a exibir uma pgina, bastando completar a definio do cdigo exibido
na seo initialization de cada unit, como mostrado a seguir para os nossos web page modules:
Initialization
TWebPageInfo.Create([wpPublished, wpLoginRequired],
.html,ExemploClubeDelphi,Modifica), caCache)
Initialization
IfWebRequestHandler<>nil then
WebRequestHandler.AddWebModuleFactory(TWebPageModuleFactory.Create(TEditaCountry,
TWebPageInfo.Create([{wpPublished} {wpLoginRequired}],.html,,,,Modifica), crOnDemand,
caCache));
KNOW-HOW EM: DESENVOLVIMENTO DE APLICAES CGI COM INTRAWEB
PR-REQUISITOS
METODOLOGIA
Apresentao do problema: Criao de uma aplicao ISAPI CGI com a tecnologia Intraweb, utilizando os componentes disponveis no
ambiente de desenvolvimento integrado do Delphi 7.
TCNICA
Apresentao dos procedimentos necessrios ao desenvolvimento de aplicaes ISAPI CGI com a tecnologia IntraWeb.
A tecnologia IntraWeb consiste em um conjunto de componentes desenvolvidos pela empresa Atozed
Software e incorporados pela Borland na verso 7 do Delphi. Isto refora o fato de que o Delphi no
mais uma linguagem de programao, mas um ambiente de desenvolvimento integrado capaz de
incorporar diversas tecnologias, muitas vezes representadas por componentes desenvolvidos por
terceiros. O Delphi pode, portanto, ser comparado com um ambiente capaz de integrar vrias tecnologias.
FUNDAMENTOS DA TECNOLOGIA INTRAWEB
A tecnologia IntraWeb representada por diversos componentes, distribudos nas seguintes pginas da
paleta de componentes do Delphi 7:
IWStandard. Esta pgina possui verses Intraweb dos componentes padres do Delphi, mas
com prefixo IW. O componente IWLabel; por exemplo, a verso Intraweb do Label, o
IWEdit, por exemplo, a verso Intraweb do Edit, e assim por diante.
IWData: Esta pgina possui verses Intraweb dos componentes padres do Delphi, mas com
prefixo IW. O componente IWDBLabel, por exemplo, a verso Intraweb do DBText; o
IWDBEdit, por exemplo, a verso Intraweb do DBEdit, e assim por diante.
IWClientSide: Esta pgina possui componentes que permitem a visualizao de registros de
tabelas do lado cliente de uma aplicao Intraweb.
IWControl: Esta pgina possui componentes que permitem o acesso a tabelas do lado cliente
de uma aplicao Intraweb.
Em nossos exemplos nos concentraremos nos componentes das pginas IWStandard e IWData, que
permitem o acesso a dados em um servidor Web.
Sero criadas aplicaes do tipo ISAPI DLL, pois aplicaes CGI baseadas na Intraweb so, na verdade,
servios a serem disponibilizados pelo servidor, e no simples executveis que geram cdigos HTML,
como no caso da tecnologia WebBroker.
Na fase de teste, no entanto, voc pode criar uma aplicao do tipo Stand Alone, e usar o item Run do
menu Run para testar a sua aplicao.
CRIANDO A APLICAO
A seguir sero apresentados os procedimentos necessrios criao dos formulrios para a nossa aplicao
Intraweb.
CRIANDO O FORMULRIO PRINCIPAL DA APLICAO
Para iniciar o desenvolvimento desta aplicao, voc deve executar os seguintes procedimentos:
1. Selecione File/New/Other, no Delphi 7, para exibir a caixa de dilogo New Items, mostrada na
figura a seguir.
2. Nesta caixa de dilogo, selecione a opo ISAPI Application da guia Intraweb e o boto Ok. Ser
exibida a caixa de dilogo Select Directory mostrada na figura a seguir, na qual voc dever selecionar
um diretrio para a sua aplicao. No Intraweb, voc deve escolher um diretrio para cada aplicao,
a menos que voc esteja convertendo aplicaes ISAPI em Stand Alone (e vice-versa).
Caso voc esteja querendo testar a aplicao localmente, e no em um servidor Web, selecione a opo Stand Alone Application.
Figura 38.39: A caixa de dilogo Select Directory.
3. Selecione o diretrio para a aplicao e o boto Ok. A aplicao ser criada e ter dois formulrios
Intraweb, denominados formMain e IWServerController. No interaja com este ltimo
formulrio use apenas o formulrio principal, inicialmente denominado formMain, e outros
que forem criados ao longo do desenvolvimento da aplicao. A figura a seguir mostra o
formulrio formMain. Repare, a menos na cor inicial, as semelhanas entre este formulrio e
um formulrio de uma aplicao comum em Delphi.
Figura 38.40: O formulrio formMain.
4. Altere a propriedade Title do formulrio formMain para Exemplo de Aplicao Intraweb.
5. Salve o projeto com o nome IWCountry.dpr.
6. Inclua um componente Table no formulrio formMain e altere o valor da sua propriedade
Name para TblCountry.
7. Configure as propriedades Databasename e Tablename deste componente para acessar a tabela
Country.db.
8. Defina da seguinte maneira o procedimento associado ao evento OnCreate do formulrio formMain:
procedure TformMain.IWAppFormCreate(Sender: TObject);
begin
TblCountry.Open;
end;
9. Coloque um componente TMainMenu (pgina Standard da paleta de componentes) no
formulrio principal formMain e crie os seguintes menus:
Menu Pas, com os itens Cadastrar, Alterar e Excluir.
Menu Ajuda, com o item Sobre.
10. Coloque um componente IWMenu (pgina IWStandard da paleta de componentes) e config-
ure a sua propriedade AttachedMenu para MainMenu1 (valor da propriedade Name do
componente MainMenu inserido no passo anterior).
11. Inclua um componente Datasource no formulrio formMain e defina a sua propriedade Dataset
como TblCountry.
12. Inclua um componente IWDBGrid (pgina IWData da paleta de componentes) no formulrio
formMain e configure a sua propriedade Datasource como o nome do Datasource includo no
passo anterior.
Caso esteja criando uma aplicao Stand Alone, ser possvel definir a propriedade Active do componente TblCountry como True, e os
registros ser visualizados.
13. Defina da seguinte maneira as principais propriedades deste componente:
BGColor: clInfoBk
Datasource: Nome do componente Datasource inserido.
HighLightColor: clYellow.
HighlightRpws: True.
Options/dgIndicator: True.
Options/dgShowTitles: True.
RowClick: False.
14. Coloque um componente IWEditt (pgina IWStandard da paleta de componentes) e defina
sua propriedade Name como IWEDitPesquisa.
15. Inclua um componente IWButton (pgina IWStandard da paleta de componentes) e defina
sua propriedade Name como IWBotaoPesquisa.
16. Defina a propriedade Caption deste componente como Pesquisa. Reposicione estes
componentes para que seu formulrio fique com o aspecto mostrado na figura a seguir.
Figura 38.41: Incluso de componentes de visualizao no formulrio formMain.
17. Defina da seguinte maneira o procedimento associado ao evento OnClick deste componente,
que ser usado para pesquisar um pas pelo Nome:
procedure TformMain.IWBotaoPesquisaClick(Sender: TObject);
begin
TblCountry.Locate(Name,IWEditPesquisa.Text,[locaseinsensitive,lopartialkey]);
IWEditPesquisa.Clear;
end;
18. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Sobre do
menu Ajuda:
procedure TformMain.Sobre1Click(Sender: TObject);
begin
WebApplication.ShowMessage(Exemplo de Aplicao Intraweb!);
end;
19. Defina da seguinte maneira o procedimento associado ao evento OnRender deste formulrio:
procedure TformMain.IWAppFormRender(Sender: TObject);
begin
tblcountry.Refresh;
end;
do menu Pases:
procedure TformMain.Cadastrar1Click(Sender: TObject);
var
FormCadastro : TFormCadastro;
begin
FormCadastro := TFormCadastro.Create(WebApplication);
FormCadastro.Show;
end;]
Se tentar compilar a aplicao neste momento ser exibida uma mensagem de erro, pois o formulrio de cadastro ainda no foi criado.
Repare ainda que o formulrio ser criado durante a execuo da aplicao, mediante uma chamada ao mtodo construtor da classe
correspondente.
21. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Alterar do
menu Pases:
procedure TformMain.Alterar1Click(Sender: TObject);
var
FormAltera : TFormAltera;
begin
FormAltera := TFormAltera.Create(WebApplication);
FormAltera.Show;
end;
22. Defina da seguinte maneira o procedimento associado ao evento OnClick do item Excluir do
menu Pases:
procedure TformMain.Excluir1Click(Sender: TObject);
var
FormExclusao : TFormExclusao;
begin
FormExclusao := TFormExclusao.Create(WebApplication);
FormExclusao.Show;
TblCountry.Refresh;
end;
CRIANDO O FORMULRIO DE CADASTRO
Para criar o formulrio de cadastro, voc deve executar os seguintes procedimentos:
1. Selecione File/New/Other, no Delphi 7, para exibir a caixa de dilogo New Items.
2. Nesta caixa de dilogo, selecione a opo Application Form da guia Intraweb e o boto Ok. Ser
criado um formulrio em branco.
3. Altere as propriedades Name e Title deste formulrio para FormCadastro e Cadastro de Pases,
respectivamente.
4. Salve a unit associada a este formulrio com o nome UnitCadastro.pas.
5. Selecione File/Use Unit para incluir o nome da unit correspondente ao formulrio principal na
clusula uses desta unit.
6. Inclua cinco componentes IWLabel (pgina IWStandard da paleta de componentes) e defina
suas propriedades Caption como Name, Capital, Continent, Population e rea. Posicione estes
componentes verticalmente do lado esquerdo do formulrio.
como formMain.TblCountry.
8. Inclua cinco componentes IWDBEdit (pgina IWData da paleta de componentes) e defina a
propriedade Datasource destes componentes como o componente Datasource inserido neste
formulrio. Coloque um componente IWEdit ao lado de cada um dos componentes IWLabel
inseridos no passo anterior e defina a propriedade Datafield de cada um deles como sendo o
nome do campo que ser exibido (e que ser igual propriedade Caption do componente
IWLabel correspondente). Caso o nome do campo no seja exibido (porque ao conexo no
est ativa) digite explicitamente o nome do campo.
9. Defina da seguinte maneira o procedimento associado ao evento OnCreate deste formulrio:
procedure TFormCadastro.IWAppFormCreate(Sender: TObject);
begin
Datasource1.DataSet.Append;
end;
sua propriedade Name como IWBotaoCadastrar.
11. Defina a propriedade Caption deste componente como Cadastrar.
12. Defina da seguinte maneira o procedimento associado ao evento OnClick deste componente:
procedure TFormCadastro.IWBotaoCadastrarClick(Sender: TObject);
begin
Datasource1.DataSet.Post;
Datasource1.DataSet.Append;
end;
13. Inclua outro componente IWButton (pgina IWStandard da paleta de componentes) e defina
sua propriedade Name como IWBotaoVoltar.
14. Defina a propriedade Caption deste componente como Voltar.
procedure TFormCadastro.IWBotaoVoltarClick(Sender: TObject);
begin
Hide;
Free;
end;
Repare que inicialmente se oculta o formulrio com o mtodo Hide (fazendo com que o formulrio
principal volte a ser exibido) e a sua memria liberada com o mtodo Free.
Reposicione estes componentes para que seu formulrio fique com o aspecto mostrado na figura a seguir.
Figura 38.42: Incluso de componentes de visualizao no formulrio formCadastro.
16. No formulrio principal, selecione File/Use Unit para incluir o nome da unit correspondente
ao formulrio de cadastro na clusula uses da unit correspondente ao formulrio principal.
CRIANDO O FORMULRIO DE ALTERAO
Para criar o formulrio de alterao, voc deve executar os seguintes procedimentos:
3. Altere as propriedades Name e Title deste formulrio para FormAltera e Alterao de Pases,
respectivamente.
4. Salve a unit associada a este formulrio com o nome UnitAltera.pas.
8. Inclua cinco componentes IWDBEdit (pgina IWData da paleta de componentes) e defina a
sua propriedade Name como IWBotaoVoltar.
10. Defina a propriedade Caption deste componente como Voltar.
procedure TFormAltera.IWBoiaoVoltarClick(Sender: TObject);
begin
try
Datasource1.DataSet.post;
except
end;
Hide;
Free;
end;
Figura 38.43: Incluso de componentes de visualizao no formulrio formAltera.
12. No formulrio principal, Selecione File/Use Unit para incluir o nome da unit correspondente
ao formulrio de alterao na clusula uses da unit correspondente ao formulrio principal.
CRIANDO O FORMULRIO DE EXCLUSO
Para criar o formulrio de excluso, voc deve executar os seguintes procedimentos:
3. Altere as propriedades Name e Title deste formulrio para FormExclusao e Confirmao de
Excluso, respectivamente.
4. Salve a unit associada a este formulrio com o nome UnitExclusao.pas.
6. Inclua um componente IWLabel (pgina IWStandard da paleta de componentes) e defina sua
propriedade Caption como Confirma a Excluso do Registro?. Posicione este componente
no topo do formulrio.
9. Inclua cinco componente, IWDBEdit (pgina IWData da paleta de componentes) e defina a
sua propriedade Name como IWBotaoExcluir.
11. Defina a propriedade Caption deste componente como Sim.
procedure TFormExclusao.IWBotaoExcluirClick(Sender: TObject);
begin
Datasource1.DataSet.Delete;
Hide;
Free;
end;
sua propriedade Name como IWBotaoCancelar.
14. Defina a propriedade Caption deste componente como No.
procedure TFormExclusao.IWBotaoCancelarClick(Sender: TObject);
begin
Hide;
Free;
end;
Repare que os dois botes ocultam o formulrio e liberam sua memria, mas apenas um deles exclui
o registro.
Figura 38.44: Incluso de componentes de visualizao no formulrio formCadastro.
16. No formulrio principal, Selecione File/Use Unit para incluir o nome da unit correspondente
ao formulrio de excluso na clusula uses da unit correspondente ao formulrio principal.
TESTANDO A APLICAO
Se voc tiver criado uma aplicao do tipo ISAPI, basta seguir as instrues do seu provedor para fazer
o upload dos arquivos necessrios e executar a aplicao a partir de um browser, como mostrado nas
figuras a seguir.
Figura 38.45: Visualizando o Formulrio Principal.
Figura 38.46: Visualizando o Formulrio de Cadastro.
Figura 38.47: Visualizando o Formulrio de Alterao.
Caso voc esteja testando localmente uma aplicao Stand Alone, pode selecionar o item Run do menu Run para exibir a janela do My
Intraweb Application Server e, a partir desta janela, o primeiro boto da sua barra de botes. Repare o endereo 127.0.0.1 na barra de
endereos do browser.
Figura 38.48: Visualizando o Formulrio de Excluso.
Figura 38.49: A janela do My Intraweb Application Server.
Figura 38.50: Executando Localmente a aplicao Stand Alone.
CAPTULO 39 FUNES MATEMTICAS DISPONVEIS EM DELPHI
Parte
Referncia
Foram mantidas as referncias da classe TQuickReport pelo fato da
biblioteca ainda estar disponvel para instalao no CD do Delphi 7.
III
BORLAND DELPHI 7 CURSO COMPLETO PARTE III: REFERNCIA
Captulo
Funes Matemticas
Disponveis em Delphi
39
Neste captulo, sero apresentadas as principais funes matemticas disponveis na linguagem Object Pas-
cal. Destina-se principalmente queles que desejam migrar programas de outras linguagens para o Delphi.
ARCCOS
Descrio
Essa funo retorna o valor do ngulo (entre 0 e p radianos) cujo valor do cosseno (entre -1 e +1)
Declarao
function ArcCos(X: Extended): Extended;
ARCCOSH
Descrio
Essa funo retorna o valor real cujo cosseno hiperblico (maior ou igual a +1) passado como parmetro.
Declarao
function ArcCosh(X: Extended): Extended;
ARCSIN
Descrio
Essa funo retorna o valor do ngulo (entre -p/2 e p/2 radianos) cujo valor do seno (entre -1 e +1)
Declarao
function ArcSin(X: Extended): Extended;
ARCSINH
Descrio
Essa funo retorna o valor real cujo seno hiperblico passado como parmetro.
Declarao
function ArcSinh(X: Extended): Extended;
ARCTANH
Descrio
Essa funo retorna o valor real cuja tangente hiperblica (entre -1 e +1) passada como parmetro.
Declarao
function ArcTanh(X: Extended): Extended;
ARCTAN2
Descrio
Essa funo retorna o ngulo cuja tangente (ArcTan(Y/X)) e quadrante so passados como parmetros.
Declarao
function ArcTan2(Y, X: Extended): Extended;
CEIL
Descrio
Essa funo retorna o menor inteiro maior ou igual ao valor passado como parmetro.
Declarao
function Ceil(X: Extended):Integer;
COSH
Descrio
Essa funo retorna o cosseno hiperblico do ngulo cujo valor passado como parmetro.
Declarao
function Cosh(X: Extended): Extended;
COTAN
Descrio
Essa funo retorna a cotangente do ngulo cujo valor passado como parmetro.
Declarao
function Cotan(X: Extended): Extended;
CYCLETORAD
Descrio
Essa funo converte em radianos o ngulo cujo valor em ciclos passado como parmetro.
Declarao
function CycleToRad(Cycles: Extended): Extended;
DEGTORAD
Descrio
Essa funo converte em radianos o ngulo cujo valor em graus passado como parmetro.
Declarao
function DegToRad(Cycles: Extended): Extended;
FLOOR
Descrio
Essa funo retorna o maior inteiro menor ou igual ao valor passado como parmetro.
Declarao
function Floor(X: Extended):Integer;
FREXP
Descrio
Essa funo retorna a mantissa e o expoente de um valor real passado como parmetro.
Declarao
procedure Frexp(X: Extended; var Mantissa: Extended; var
Exponent: Integer) register;
GRADTORAD
Descrio
Essa funo converte em radianos o ngulo cujo valor em grados passado como parmetro.
Declarao
function GradToRad(Cycles: Extended): Extended;
HYPOT
Descrio
Essa funo retorna o valor da hipotenusa de um tringulo, cujos valores dos catetos so passados
como parmetros.
Declarao
function Hypot(X, Y: Extended): Extended;
INTPOWER
Descrio
Essa funo retorna uma potncia inteira (passada como segundo parmetro) de um valor-base (passado
como primeiro parmetro).
Declarao
function IntPower(Base: Extended; Exponent: Integer): Extended register;
LOG2
Descrio
Essa funo retorna o logaritmo na base 2 de um valor real passado como parmetro.
Declarao
function Log2(X: Extended): Extended;
LOG10
Descrio
Essa funo retorna o logaritmo na base 10 de um valor real passado como parmetro.
Declarao
function Log10(X: Extended): Extended;
LOGN
Descrio
Essa funo retorna o logaritmo numa base (cujo valor passado como primeiro parmetro) de um
nmero real (cujo valor passado como segundo parmetro).
Declarao
function LogN(N, X: Extended): Extended;
MAX
Descrio
Essa funo retorna o maior de dois valores passados como parmetro.
Declarao
Essa funo sobrecarregada, tendo as declaraes apresentadas a seguir:
function Max(A,B: Integer): Integer; overload;
function Max(A,B: Int64): Int64; overload;
function Max(A,B: Single): Single; overload;
function Max(A,B: Double): Double; overload;
function Max(A,B: Extended): Extended; overload;
MAXINTVALUE
Descrio
Essa funo retorna o maior valor dentre os armazenados em uma array de valores inteiros.
Declarao
function MaxIntValue(const Data: array of Integer): Integer;
MAXVALUE
Descrio
Essa funo retorna o maior valor dentre os armazenados em uma array de valores reais.
Declarao
function MaxValue(const Data: array of Double): Double;
MEAN
Descrio
Essa funo retorna a mdia aritmtica dos valores armazenados em uma array de valores reais.
Declarao
function Mean(const Data: array of Double): Extended;
MEANANDSTDDEV
Descrio
Essa funo retorna a mdia aritmtica e o desvio-padro dos valores armazenados em uma array de
valores reais.
Declarao
procedure MeanAndStdDev(const Data: array of Double; var Mean, StdDev: Extended);
MIN
Descrio
Essa funo retorna o menor de dois valores passados como parmetro.
Declarao
Essa funo sobrecarregada, tendo as declaraes apresentadas a seguir:
function Min(A,B: Integer): Integer; overload;
function Min(A,B: Int64): Int64; overload;
function Min(A,B: Single): Single; overload;
function Min(A,B: Double): Double; overload;
function Min(A,B: Extended): Extended; overload;
MININTVALUE
Descrio
Essa funo retorna o menor valor dentre os armazenados em uma array de valores inteiros.
Declarao
function MinIntValue(const Data: array of Integer): Integer;
MINVALUE
Descrio
Essa funo retorna o menor valor dentre os armazenados em uma array de valores reais.
Declarao
function MinValue(const Data: array of Double): Double;
NORM
Descrio
Essa funo retorna a norma euclidiana L-2 dentre os valores armazenados em uma array de valores reais.
Declarao
function Norm(const Data: array of Double): Extended;
POLY
Descrio
Essa funo calcula o valor de um polinmio uniforme para o valor passado como primeiro parmetro,
sendo os coeficientes passados como segundo parmetro na forma de uma array de valores reais.
Declarao
function Poly(X: Extended; const Coefficients: array of Double): Extended;
POPNSTDDEV
Descrio
Essa funo calcula o valor do desvio-padro de um conjunto de valores passados como parmetro na
forma de uma array de valores reais.
Declarao
function PopnStdDev(const Data: array of Double): Extended;
POPNVARIANCE
Descrio
Essa funo calcula o valor da varincia de um conjunto de valores passados como parmetro na forma
de uma array de valores reais.
Declarao
function PopnVariance(const Data: array of Double): Extended;
POWER
Descrio
Essa funo retorna uma potncia real (passada como segundo parmetro) de um valor-base (passado
como primeiro parmetro).
Declarao
function Power(Base, Exponent: Extended): Extended;
RADTOCYCLE
Descrio
Essa funo converte em ciclos o ngulo cujo valor em radianos passado como parmetro.
Declarao
function RadToCycle(Radians: Extended): Extended;
RADTODEG
Descrio
Essa funo converte em graus o ngulo cujo valor em radianos passado como parmetro.
Declarao
function RadToDeg(Radians: Extended): Extended;
RADTOGRAD
Descrio
Essa funo converte em grados o ngulo cujo valor em radianos passado como parmetro.
Declarao
function RadToGrad(Radians: Extended): Extended;
RANDG
Descrio
Essa funo gera nmeros aleatrios com distribuio gaussiana, sendo os valores da mdia e do desvio-
padro passados como parmetros.
Declarao
function RandG(Mean, StdDev: Extended): Extended;
SIN
Descrio
Essa funo calcula o seno de um ngulo, passado como parmetro em radianos.
Declarao
function Sin(X: Extended): Extended;
SINCOS
Descrio
Esse procedimento calcula o seno e o cosseno de um ngulo (passado em radianos, como primeiro
parmetro), sendo estes valores armazenados no segundo e terceiro parmetros.
Declarao
procedure SinCos(Theta: Extended; var Sin, Cos: Extended); register;
SINH
Descrio
Essa funo retorna o seno hiperblico do ngulo cujo valor passado como parmetro.
Declarao
function Sinh(X: Extended): Extended;
STDDEV
Descrio
Essa funo retorna o desvio-padro dos valores armazenados em uma array de valores reais, passada
como parmetro.
Declarao
function StdDev(const Data: array of Double): Extended;
SUM
Descrio
Essa funo retorna a soma dos valores armazenados em uma array de valores reais, passada como
parmetro.
Declarao
function Sum(const Data: array of Double): Extended;
SUMINT
Descrio
Essa funo retorna a soma dos valores armazenados em uma array de valores inteiros, passada como parmetro.
Declarao
function SumInt(const Data: array of integer): Extended;
SUMOFSQUARES
Descrio
Essa funo retorna a soma dos quadrados dos valores armazenados em uma array de valores reais,
passada como parmetro.
Declarao
function SumOfSquares(const Data: array of Double): Extended;
SUMSANDSQUARES
Descrio
Essa funo retorna a soma dos valores e dos quadrados dos valores armazenados em uma array de
valores reais, passada como parmetro.
Declarao
procedure SumsAndSquares(const Data: array of Double; var Sum, SumOfSquares: Extended) register;
TAN
Descrio
Esse procedimento calcula a tangente de um ngulo em radianos.
Declarao
function Tan(X: Extended): Extended;
TANH
Descrio
Essa funo calcula a tangente de um ngulo passado como parmetro (em radianos).
Declarao
function TanH(X: Extended): Extended;
VARIANCE
Descrio
Essa funo retorna a varincia dos valores armazenados em uma array de valores reais, passada como parmetro.
Declarao
function Variance(const Data: array of Double): Extended;
CAPTULO 40 CLASSES, CONTROLES E COMPONENTES
Captulo
Classes, Controles e Componentes
40
EABORT
Descrio
Essa classe permite a gerao de excees sem que seja exibida uma mensagem de erro em uma caixa
de dilogo.
Unit
Na VCL e Na CLX:
Sysutils
Principais Propriedades
HelpContext e Message
Principais Mtodos
Create, CreateFmt, CreateFmtHelp, CreateHelp, CreateRes, CreateResFmt, CreateResFmtHelp, CreateResHelp
Principais Eventos
Essa classe no possui eventos associados.
EABSTRACTERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar executar um mtodo abstrato.
Unit
Na VCL e Na CLX:
Sysutils
Principais Mtodos
Create, CreateFmt, CreateFmtHelp, CreateHelp, CreateRes, CreateResFmt, CreateResFmtHelp,
CreateResHelp
Principais Eventos
EACCESSVIOLATION
Descrio
Essa classe representa uma exceo gerada ao se tentar acessar um endereo de memria invlido.
Unit
Na VCL e Na CLX:
Sysutils
Principais Mtodos
Principais Eventos
EARRAYERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar acessar um endereo invlido em uma array.
Unit
Na VCL:
mxArrays
Principais Mtodos
Principais Eventos
EASSERTIONFAILED
Descrio
Essa classe representa uma exceo gerada ao se executar procedimentos de atribuio em expresses
booleanas que retornam False.
Unit
Na VCL e na CLX:
Sysutils
Principais Mtodos
Principais Eventos
EBITSERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar realizar um acesso invlido a uma array de
valores booleanos.
Unit
Na VCL e Na CLX:
Classes
Principais Mtodos
Principais Eventos
EBROKEREXCEPTION
Descrio
Essa classe representa uma exceo gerada quando um objeto no consegue acessar um servidor.
Unit
Na VCL:
objbrkr
Principais Mtodos
Principais Eventos
ECACHEERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar executar uma operao com o cache de um
componente Decision Cube.
Unit
Na VCL:
mxstore
Principais Mtodos
Principais Eventos
ECLASSNOTFOUND
Descrio
Essa classe representa uma exceo gerada ao se tentar carregar um componente de uma stream e este
no est inserido na aplicao.
Unit
Na VCL e na CLX:
Sysutils
Principais Mtodos
Principais Eventos
ECOMMONCALENDARERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar atribuir um valor invlido a uma propriedade de
um componente derivado da classe TCommonCalendar.
Unit
Na VCL:
ComCtrls
Principais Mtodos
Principais Eventos
ECOMPONENTERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar registrar ou renomear um componente.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
ECONTROLC
Descrio
Essa classe representa uma exceo gerada ao se tentar encerrar uma aplicao do tipo console
pressionando simultaneamente as teclas Ctrl e C.
Unit
Na VCL:
Sysutils
Principais Mtodos
Principais Eventos
ECONVERTERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar executar uma converso de tipos invlida.
Unit
Na VCL e na CLX:
Sysutils
Principais Mtodos
Principais Eventos
EDBCLIENT
Descrio
Essa classe representa uma exceo gerada ao se utilizar um objeto da classe TclientDataSet (ou uma
classe dela derivada por herana).
Unit
Na VCL e na CLX:
DBClient
ErrorCode, HelpContext e Message
Principais Mtodos
Principais Eventos
EDBEDITERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar exibir, em um controle associado a um banco de
dados, um valor incompatvel com a mscara definida para o campo cujo valor exibido pelo componente.
Unit
Na CLX:
QMask
Na VCL:
Mask
Principais Mtodos
Principais Eventos
EDBENGINEERROR
Descrio
Essa classe representa uma exceo genrica, gerada ao se tentar executar uma funo do BDE.
Unit
Na VCL:
DBtables
ErrorCount, Errors, HelpContext e Message
Principais Mtodos
Create, CreateFmt, CreateFmtHelp, CreateHelp, CreateRes, CreateResFmt, CreateResFmtHelp, CreateResHelp e Destroy
Principais Eventos
EDSWRITER
Descrio
Essa classe representa uma exceo genrica, gerada ao se tentar manipular pacotes de dados por meio
de um Dataset.
Unit
Na VCL e na CLX:
Provider
ErrorCode, HelpContext e Message
Principais Mtodos
Principais Eventos
EDATABASEERROR
Descrio
Essa classe representa uma exceo genrica gerada ao se tentar acessar um banco de dados.
Unit
Na VCL e na CLX:
DB
Principais Mtodos
Principais Eventos
EDATETIMEERROR
Descrio
Essa classe representa uma exceo genrica gerada ao se tentar atribuir valores invlidos a variveis do
tipo data/hora.
Unit
Na VCL e na CLX:
ComCtrls
Principais Mtodos
Principais Eventos
EDIMINDEXERROR
Descrio
Essa classe representa uma exceo genrica gerada ao se tentar utilizar um ndice invlido em uma
dimenso de um componente da classe TDecisionSource.
Unit
Na VCL:
mxdb
Principais Mtodos
Principais Eventos
EDIMENSIONMAPERROR
Descrio
Essa classe representa uma exceo genrica gerada por incompatibilidade no formato dos dados
armazenados em um dataset associado a um componente da classe TDecisionCube.
Unit
Na VCL:
mxdb
Principais Mtodos
Principais Eventos
EDIVBYZERO
Descrio
Essa classe representa uma exceo gerada ao se tentar dividir um nmero inteiro por zero.
Unit
Na VCL e na CLX:
Sysutils
Principais Mtodos
Principais Eventos
EEXTERNAL
Descrio
Essa classe representa uma exceo gerada externamente pelo sistema operacional.
Unit
Na VCL e na CLX:
Sysutils
Principais Mtodos
Principais Eventos
EEXTERNALEXCEPTION
Descrio
Essa classe representa uma exceo gerada, cujo cdigo invlido.
Unit
Na VCL e na CLX:
Sysutils
Principais Mtodos
Principais Eventos
EFCREATEERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar criar um arquivo por meio de uma stream.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EFILERERROR
Descrio
Essa classe representa uma exceo genrica gerada ao se tentar manipular um arquivo por meio de
uma stream.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EFOPENERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar abrir um arquivo por meio de uma stream.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EHEAPEXCEPTION
Descrio
Essa classe representa uma exceo gerada ao se tentar alocar memria no Heap do sistema operacional.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
CreateResHelp, FreeInstance
Principais Eventos
EINOUTERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar efetuar operaes de entrada e sada em arquivos,
e desde que a diretiva de compilao $I+ esteja ativada. Valores na faixa 0-99 representam erros nativos
do sistema operacional, ao passo que valores na faixa 100-149 representam erros definidos pela CLX.
Exemplos de cdigo de erros da CLX:
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
CreateResHelp
Principais Eventos
WEINTERPRETERERROR
Descrio
Essa classe representa uma exceo genrica gerada ao se manipular objetos COM.
Unit
Na VCL:
SConnect
Cdigo do Erro Significado
100 Fim de arquivo
101 Disco cheio
102 Varivel no atribuda a arquivo
103 File not open
104 Arquivo no foi aberto para leitura
105 Arquivo no foi aberto para escrita
106 Erro na formatao de sada
107 Arquivo j aberto
Principais Mtodos
Principais Eventos
EINTERROR
Descrio
Essa classe representa uma exceo genrica gerada ao se manipular valores inteiros.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Create, CreateFmt, CreateFmtHelp, CreateHelp, CreateRes, CreateResFmt, CreateResFmtHelp, CreateResHelp,
Principais Eventos
EINTFCASTERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar converter explicitamente uma interface, usando
o operador as.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EINTOVERFLOW
Descrio
Essa classe representa uma exceo gerada ao se tentar atribuir a uma varivel inteira um valor cuja
magnitude superior quela capaz de ser armazenada pelo tipo da varivel.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EINVALIDARGUMENT
Descrio
Essa classe representa uma exceo gerada ao se tentar efetuar uma operao invlida passando-se
valores fora da faixa especificada em parmetros de funes matemticas.
Unit
Na VCL e na CLX:
Math
Principais Mtodos
Principais Eventos
EINVALIDCAST
Descrio
Essa classe representa uma exceo gerada ao se tentar converter explicitamente o tipo de uma varivel
ou objeto.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EINVALIDGRAPHIC
Descrio
Essa classe representa uma exceo gerada ao se tentar manipular um arquivo grfico cujo formato invlido.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Principais Mtodos
Principais Eventos
EINVALIDGRAPHICOPERATION
Descrio
Essa classe representa uma exceo gerada ao se tentar manipular um grfico.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Principais Mtodos
Principais Eventos
EINVALIDGRIDOPERATION
Descrio
Essa classe representa uma exceo gerada ao se tentar manipular um componente do tipo StringGrid
ou componentes derivados por herana.
Unit
Na VCL:
Grids
Na CLX:
QGrids
Principais Mtodos
Principais Eventos
EINVALIDIMAGE
Descrio
Essa classe representa uma exceo gerada ao se tentar manipular um arquivo de recurso que armazena
uma imagem.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EINVALIDOP
Descrio
Essa classe representa uma exceo gerada ao se tentar efetuar uma operao invlida com nmeros de
ponto flutuante.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EINVALIDOPERATION
Descrio
Essa classe representa uma exceo gerada ao se tentar efetuar uma operao invlida com um componente.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EINVALIDPOINTER
Descrio
Essa classe representa uma exceo gerada ao se tentar efetuar uma operao invlida com um ponteiro.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
ELISTERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar efetuar uma operao com listas de objetos,
strings ou listas de strings.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
ELOWCAPACITYERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar alocar mais memria do que a existente para
um componente TDecisionCube.
Unit
Na VCL:
mxArrays
Principais Mtodos
Principais Eventos
EMATHERROR
Descrio
Essa classe representa uma exceo genrica gerada ao se tentar efetuar uma operao invlida com
nmeros de ponto flutuante.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EMCIDEVICEERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar acessar um driver MCI (Media Control Interface).
Unit
Na VCL:
mplayer
Principais Mtodos
Principais Eventos
EMENUERROR
Descrio
Essa classe representa uma exceo gerada ao se manipular itens de menu.
Unit
Na VCL:
Menus
Na CLX:
QMenus
Principais Mtodos
Principais Eventos
EMONTHCALERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar atribuir valores a um componente
TMonthCalendar.
Unit
Na VCL:
ComCtrls
Principais Mtodos
Principais Eventos
ENORESULTSET
Descrio
Essa classe representa uma exceo gerada ao se tentar acessar um banco de dados por meio de uma
declarao SQL em um componente TQuery.
Unit
Na VCL:
DBtables
Principais Mtodos
Principais Eventos
EOLECTRLERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar utilizar um controle ActiveX em uma aplicao.
Unit
Na VCL:
Olectrls
Principais Mtodos
Principais Eventos
EOLEERROR
Descrio
Essa classe representa uma exceo gerada ao se efetuarem operaes de baixo nvel com controles
OLE.
Unit
Na VCL:
ComObj
Principais Mtodos
Principais Eventos
EOLEEXCEPTION
Descrio
Essa classe representa uma exceo gerada ao se tentar acessar propriedades e mtodos em objetos de
automao OLE.
Unit
Na VCL:
ComObj
ErrorCode, HelpContext, HelpKeyword, HelpTypeHelpFile, Message e Source
Principais Mtodos
CreateFmt, CreateFmtHelp, CreateHelp, CreateRes, CreateResFmt, CreateResFmtHelp, CreateResHelp
Principais Eventos
EOLESYSERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar acessar interfaces do tipo IDispatch.
Unit
Na VCL:
ComObj
ErrorCode, HelpContext, HelpKeyword, HelpTypeMessage
Principais Mtodos
Principais Eventos
EOSERROR
Descrio
Essa classe representa uma exceo genrica gerada pelo sistema operacional (Windows ou Linux).
Unit
Na VCL e na CLX:
SysUtils
HelpContext, HelpKeyword, HelpTypeMessage
Principais Mtodos
Principais Eventos
EOUTOFMEMORY
Descrio
Essa classe representa uma exceo gerada ao se tentar alocar memria.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EOUTOFRESOURCES
Descrio
Essa classe representa uma exceo gerada ao se tentar alocar um handle no sistema operacional.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EOUTLINEERROR
Descrio
Essa classe representa uma exceo gerada ao se manipular componentes TOutLine.
Unit
Na VCL:
Outline
HelpContexteMessage
Principais Mtodos
Principais Eventos
EOVERFLOW
Descrio
Essa classe representa uma exceo gerada ao se tentar atribuir valores cuja magnitude superior
suportada pelo tipo de uma varivel de ponto flutuante.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EPACKAGEERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar manipular pacotes de cdigo.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EPARSEERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar converter valores no formato texto para binrio
e vice-versa.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EPRINTER
Descrio
Essa classe representa uma exceo gerada ao se realizar um trabalho de impresso.
Unit
Na VCL:
Printers
Na CLX:
QPrinters
Principais Mtodos
Principais Eventos
EPRIVILEGE
Descrio
Essa classe representa uma exceo gerada ao se tentar executar uma instruo invlida para o
processador.
Unit
Na VCL e na CLX:
Sysutils
Principais Mtodos
Principais Eventos
EPROPERTYERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar atribuir um valor a uma propriedade.
Unit
Na VCL e na CLX:
TypInfo
Principais Mtodos
Principais Eventos
EPROPREADONLY
Descrio
Essa classe representa uma exceo gerada ao se tentar atribuir um valor a uma propriedade que use
automao OLE quando a propriedade apenas de escrita.
Unit
Na VCL:
Sysutils
Principais Mtodos
Principais Eventos
EPROPWRITEONLY
Descrio
Essa classe representa uma exceo gerada ao se tentar ler o valor de uma propriedade que use automao
OLE quando a propriedade apenas de leitura.
Unit
Na VCL:
Sysutils
Principais Mtodos
Principais Eventos
ERangeError
Descrio
Essa classe representa uma exceo gerada ao se obterem valores inteiros fora da faixa permitida para o
seu tipo, principalmente como resultado de operaes aritmticas.
Unit
Na VCL e na CLX:
Sysutils
Principais Mtodos
Principais Eventos
EREADERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar ler valores de uma stream.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
ERECONCILEERROR
Descrio
Essa classe representa uma exceo gerada ao se manipularem componentes do tipo TClientDataSet ou
dele derivados por herana, ao se tentar efetuar uma operao de atualizao de dados.
Unit
Na VCL e na CLX:
DBclient
Context, ErrorCode, HelpContext, HelpKeyword, HelpTypeMessage
Principais Mtodos
Principais Eventos
EREGISTRYEXCEPTION
Descrio
Essa classe representa uma exceo gerada ao se manipular o registro do Windows.
Unit
Na VCL:
Registry
Principais Mtodos
Principais Eventos
ERESNOTFOUND
Descrio
Essa classe representa uma exceo gerada ao se tentar acessar um recurso armazenado em um arquivo
DFM (VCL), XFM (CLX) ou RES.
Unit
Na VCL e na CLX:
classes
Principais Mtodos
Principais Eventos
ESOCKETCONNECTIONERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar enviar ou receber mensagens usando um
componente TSocketConnection.
Unit
Na VCL:
Sconnect
Principais Mtodos
Principais Eventos
ESOCKETERROR
Descrio
Essa classe representa uma exceo gerada ao se manipularem objetos de classes derivadas de
TCustomWinSocket.
Unit
Na VCL:
Sockets
Principais Mtodos
Principais Eventos
ESTACKOVERFLOW
Descrio
Essa classe representa uma exceo gerada quando ocorre um estouro da pilha de memria do sistema
operacional.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
ESTREAMERROR
Descrio
Essa classe representa uma exceo gerada quando se manipulam streams.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
ESTRINGLISTERROR
Descrio
Essa classe representa uma exceo gerada quando se tenta acessar um item de um componente Listbox
com um ndice invlido.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
ETHREAD
Descrio
Essa classe representa uma exceo gerada quando se manipulam mltiplas threads em uma aplicao.
No mais empregada, sendo sua definio mantida para manter a compatibilidade com cdigo escrito
em verses anteriores do Delphi.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
ETREEVIEWERROR
Descrio
Essa classe representa uma exceo gerada quando se tenta acessar um elemento (n) de um componente
TTreeView.
Unit
Na VCL:
Comctrls
Na CLX:
QComctrls
Principais Mtodos
Principais Eventos
EUNDERFLOW
Descrio
Essa classe representa uma exceo gerada ao se tentar atribuir valores cuja magnitude inferior
suportada pelo tipo de uma varivel de ponto flutuante.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EUNSUPPORTEDTYPEERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar acrescentar uma dimenso ao cache de um
componente TDecisionCube.
Unit
Na VCL:
mxArrays
Principais Mtodos
Principais Eventos
EUPDATEERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar manipular um componente
Tprovider, atualizando os dados por ele manipulados.
Unit
Na VCL e na CLX:
DB
Context, ErrorCode, OriginalException, HelpContext, HelpKeyword, HelpTypeMessage, PreviousError
Principais Mtodos
Principais Eventos
EVARIANTERROR
Descrio
Essa classe representa uma exceo gerada ao se manipularem dados do tipo Variant.
Unit
Na VCL e na CLX:
SysUtils
Principais Mtodos
Principais Eventos
EWIN32ERROR
Descrio
Essa classe representa uma exceo genrica gerada pelo Windows. Atualmente substituda pela classe
EOSError, que representa uma exceo genrica gerada pelo sistema operacional (Windows ou Linux).
Unit
Na VCL:
SysUtils
Principais Mtodos
Principais Eventos
EWRITEERROR
Descrio
Essa classe representa uma exceo gerada ao se tentar escrever um valor em uma stream.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EZERODIVIDE
Descrio
Essa classe representa uma exceo gerada ao se tentar dividir um nmero de ponto flutuante por zero.
Unit
Na VCL e na CLX:
Classes
Principais Mtodos
Principais Eventos
EXCEPTION
Descrio
Essa classe representa a classe-base para todas as classes usadas para representar excees.
Unit
Na VCL e na CLX:
SysUtils
HelpContext, HelpKeyword, HelpTypeMessage;
Principais Mtodos
Principais Eventos
TACTION
Descrio
Essa classe representa uma ao definida em um objeto da classe TActionList.
Unit
Na VCL:
ActnList
Na CLX:
QActnList
Autocheck, Caption, Checked, DisableIfNoHandler, Enabled, GroupIndex, HelpContext, HelpKeyword,
HelpTypeHelpKeyword, HelpType, Hint, ImageIndex, Name, ShortCut, Visible, Category e Index
Principais Mtodos
Create, Destroy, DoHint, Execute, GetParentComponent, Update, ExecuteTarget, HandlesTarget,
RegisterChanges, UnRegisterChanges, UpdateTarget
Principais Eventos
OnHint, OnExecute e OnUpdate
TACTIONLIST
Descrio
Essa classe representa um conjunto de aes (cada ao representada por um objeto da classe TAction)
compartilhadas por controles, componentes e itens de menu.
Unit
Na VCL:
ActnList
Na CLX:
QActnList
ActionCount, Actions, Images
Principais Mtodos
Create, Destroy, ExecuteAction, IsShortCut e UpdateAction
Principais Eventos
OnHint, OnExecute e OnUpdate
TADOCOMMAND
Descrio
Este componente permite executar comandos sql e stored procedures em tabelas de bancos de dados
atravs do Mecanismo Activex Data Objects (ADO).
Unit
Na VCL:
AdoDB
CommandObject, CommandText, CommandTimeout, CommandType, ComObject, ComponentCount, ComponentIndex,
Components, ComponentState, ComponentStyle, Connection, ConnectionString, DesignInfo,
ExecuteOptions, Name, Owner, ParamCheck, Parameters, Prepared, Properties, States, Tag, VCLComObject
Principais Mtodos
AfterConstruction, Assign, Assign, BeforeDestruction, Cancel, ClassInfo, ClassName, ClassNameIs,
ClassParent, ClassType, CleanupInstance, Create, DefaultHandler, Destroy, DestroyComponents,
Destroying, Dispatch, Execute, ExecuteAction, FieldAddress, FindComponent, Free, FreeInstance,
FreeNotification, FreeOnRelease, GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath,
GetParentComponent, HasParent, InheritsFrom, InitInstance, InsertComponent, InstanceSize,
MethodAddress, MethodName, NewInstance, RemoveComponent, SafeCallException, UpdateAction
Principais Eventos
Este componente no possui procedimentos associados a eventos
TADOCONNECTION
Descrio
Este componente responsvel pelo acesso a bancos de dados atravs do Mecanismo Activex Data
Objects (ADO).
Unit
Na VCL:
AdODB
Attributes, CommandCount, Commands, CommandTimeout, ComObject, ComponentCount, ComponentIndex,
Components, ComponentState, ComponentStyle, Connected, ConnectionObject, ConnectionString,
ConnectionTimeout, ConnectOptions, CursorLocation, DataSetCount, DataSets, DefaultDatabase,
DesignInfo, Errors, InTransaction, IsolationLevel, LoginPrompt, Mode, Owner, Properties, Provider,
State, Tag, VCLComObject, Version
Principais Mtodos
AfterConstruction, Assign, BeforeDestruction, BeginTrans, Cancel, ClassInfo, ClassName, ClassNameIs,
ClassParent, ClassType, CleanupInstance, Close, CloseDataSets, CommitTrans, Create, DefaultHandler,
Destroy, DestroyComponents, Destroying, Dispatch, Execute, ExecuteAction, FieldAddressm
FindComponent, Free, FreeInstance, FreeNotification, FreeOnRelease, GetInterface, GetInterfaceEntry,
GetInterfaceTable, GetNamePath, GetParentComponent, GetProcedureNames, GetTableNames, HasParent,
InheritsFrom, InitInstance, InsertComponent, InstanceSize, MethodAddress, MethodName, NewInstance,
Open, OpenSchema, RemoveComponent, RollbackTrans, SafeCallException, UpdateAction
Principais Eventos
AfterConnect, AfterDisconnect, BeforeConnect, BeforeDisconnect, OnBeginTransComplete, OnCommitTransComplete,
OnConnectComplete, OnDisconnect, OnExecuteComplete, OnInfoMessage, OnLogin, OnRollbackTransComplete,
OnWillConnect, OnWillExecute
TADODATASET
Descrio
Este componente permite acesso direto ou via declaraes sql a tabelas de bancos de dados atravs do
Mecanismo Activex Data Objects (ADO).
Unit
Na VCL:
AdoDB
Active, ActiveRecord, AggFields, AutoCalcFields, BlobFieldCount, BlockReadSize, Bof, Bookmark,
BookmarkSize, BufferCount, Buffers, CacheSize, CalcBuffer, CalcFieldsSize, CanModify, CommandText,
CommandTimeout, CommandType, ComObject, ComponentCount, ComponentIndex, Components, ComponentState,
ComponentStyle, Connection, ConnectionString, Constraints, CurrentRecord, CursorLocation,
CursorType, DataSetField, DefaultFields, Designer, DesignerData, DesignInfo, Eof, ExecuteOptions,
FieldCount, FieldDefList, FieldDefs, FieldList, FieldNoOfs, Fields, FieldValues, Filter, Filtered,
FilterGroup, FilterOptions, Found, IndexFieldCount, IndexFields, InternalCalcFields, LockType,
MarshalOptions, MaxRecords, Modified, Name, NestedDataSetClass, NestedDataSets, ObjectView, Owner,
ParamCheck, Parameters, Prepared, Properties, RDSConnection, RecNo, RecordCount, RecordSet,
RecordSetState, RecordSize, RecordStatus, Reserved, Sort, SparseArrays, State, Tag, VCLComObject
Principais Mtodos
ActiveBuffer, AfterConstruction, Append, AppendRecord, Assign, BeforeDestruction, BookmarkValid,
Cancel, CancelBatch, CancelUpdates, CheckBrowseMode, ClassInfo, ClassName, ClassNameIs, ClassParent,
ClassType, CleanupInstance, ClearFields, Clone, Close, CompareBookmarks, ControlsDisabled, Create,
CreateBlobStream, CreateDataset, CursorPosChanged, DefaultHandler, Delete, DeleteRecords, Destroy,
DestroyComponents, Destroying, DisableControls, Dispatch, Edit, EnableControls, ExecuteAction,
FieldAddress, FieldByName, FilterOnBookmarks, FindComponent, FindField, FindFirst, FindLast, FindNext,
FindPrior, First, Free, FreeBookmark, FreeInstance, FreeNotification, FreeOnRelease, GetBlobFieldData,
GetBookmark, GetCurrentRecord, GetDetailDataSets, GetDetailLinkFields, GetFieldData, GetFieldList,
GetFieldNames, GetIndexNames, GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath,
GetParentComponent, GotoBookmark, HasParent, InheritsFrom, InitInstance, Insert, InsertComponent,
InsertRecord, InstanceSize, IsEmpty, IsLinkedTo, IsSequenced. Last, LoadFromFile, Locate, Lookup,
MethodAddress, MethodName, MoveBy, NewInstance, Next, NextRecordset, Open, Post, Prior, Refresh,
RemoveComponent, Resync, SafeCallException, SaveToFile, Seek, SetFields, Supports, Translate,
UpdateAction, UpdateBatch, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
AfterCancel, AfterClose, AfterDelete, AfterEdit, AfterInsert, AfterOpen, AfterPost, AfterRefresh,
AfterScroll, BeforeCancel, BeforeClose, BeforeDelete, BeforeEdit, BeforeInsert, BeforeOpen,
BeforePost, BeforeRefresh, BeforeScroll, OnCalcFields, OnDeleteError, OnEditError, OnEndOfRecordset,
OnFetchComplete, OnFetchProgress, OnFieldChangeComplete, OnFilterRecord, OnMoveComplete,
OnNewRecord, OnPostError, OnRecordChangeComplete, OnRecordsetChangeComplete, OnWillChangeField,
OnWillChangeRecord, OnWillChangeRecordset, OnWillMove
TADOQUERY
Descrio
Este componente permite acesso via declaraes sql a tabelas de bancos de dados atravs do Mecanismo
Activex Data Objects (ADO).
Unit
Na VCL:
AdoDB
CursorType, DataSetField, DataSource, DefaultFields, Designer, DesignerData, DesignInfo, Eof,
ExecuteOptions, FieldCount, FieldDefList, FieldDefs, FieldList, FieldNoOfs, Fields, FieldValues,
Filter, Filtered, FilterGroup, FilterOptions, Found, IndexFieldCount, IndexFields,
InternalCalcFields, LockType, MarshalOptions, MaxRecords, Modified, Name, NestedDataSetClass,
NestedDataSets, ObjectView, Owner, ParamCheck, Parameters, Prepared, Properties, RecNo,
RecordCount, RecordSet, RecordSetState, RecordSize, RecordStatus, Reserved, RowsAffected, Sort,
SparseArrays, SQL, State, Tag, VCLComObject
Principais Mtodos
CreateBlobStream, CursorPosChanged, DefaultHandler, Delete, DeleteRecords, Destroy, DestroyComponents,
Destroying, DisableControls, Dispatch, Edit, EnableControls, ExecSQL, ExecuteAction, FieldAddress,
FieldByName, FilterOnBookmarks, FindComponent, FindField, FindFirst, FindLast, FindNext, FindPrior,
First, Free, FreeBookmark, FreeInstance, FreeNotification, FreeOnRelease, GetBlobFieldData,
GetFieldNames, GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent,
GotoBookmark, HasParent, InheritsFrom, InitInstance, Insert, InsertComponent, InsertRecord,
InstanceSize, IsEmpty, IsLinkedTo, IsSequenced. Last, LoadFromFile, Locate, Lookup, MethodAddress,
MethodName, MoveBy, NewInstance, Next, NextRecordset, Open, Post, Prior, Refresh, RemoveComponent,
Resync, SafeCallException, SaveToFile, Seek, SetFields, Supports, Translate, UpdateAction,
UpdateBatch, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
TADOSTOREDPROC
Descrio
Esse componente permite que uma aplicao desenvolvida em Delphi execute procedimentos
armazenados em servidores, atravs do mecanismo Activex Data Objects (ADO).
Unit
Na VCL:
ADODB
ComponentStyle, Connection, ConnectionString, Constraints, CurrentRecord, CursorLocation, CursorType,
DataSetField, DataSource, DefaultFields, Designer, DesignerData, DesignInfo, Eof, ExecuteOptions,
ParamCheck, Parameters, Prepared, ProcedureName, Properties, RecNo, RecordCount, RecordSet,
RecordSetState, RecordSize, RecordStatus, Reserved, Sort, SparseArrays, State, Tag, VCLComObject
Principais Mtodos
CreateBlobStream, CursorPosChanged, DefaultHandler, Delete, DeleteRecords, Destroy,
DestroyComponents, Destroying, DisableControls, Dispatch, Edit, EnableControls, ExecuteAction,
FieldAddress, FieldByName, FilterOnBookmarks, FindComponent, FindField, FindFirst, FindLast,
FindNext, FindPrior, First, Free, FreeBookmark, FreeInstance, FreeNotification, FreeOnRelease,
GetBlobFieldData, GetBookmark, GetCurrentRecord, GetDetailDataSets, GetDetailLinkFields,
GetFieldData, GetFieldList, GetFieldNames, GetInterface, GetInterfaceEntry, GetInterfaceTable,
GetNamePath, GetParentComponent, GotoBookmark, HasParent, InheritsFrom, InitInstance, Insert,
InsertComponent, InsertRecord, InstanceSize, IsEmpty, IsLinkedTo, IsSequenced. Last, LoadFromFile,
Locate, Lookup, MethodAddress, MethodName, MoveBy, NewInstance, Next, NextRecordset, Open, Post,
Prior, Refresh, RemoveComponent, Resync, SafeCallException, SaveToFile, Seek, SetFields, Supports,
Translate, UpdateAction, UpdateBatch, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
TADOTABLE
Descrio
Este componente permite acesso direto a tabelas de bancos de dados atravs do Mecanismo Activex
Data Objects (ADO).
Unit
Na VCL:
AdoDB
CursorType, DataSetField, DataSource, DefaultFields, Designer, DesignerData, DesignInfo, Eof,
ExecuteOptions, FieldCount, FieldDefList, FieldDefs, FieldList, FieldNoOfs, Fields, FieldValues,
Filter, Filtered, FilterGroup, FilterOptions, Found, IndexFieldCount, IndexFieldNames, IndexFields,
InternalCalcFields, LockType, MarshalOptions, MasterFields, MasterSource, MaxRecords, Modified,
Name, NestedDataSetClass, NestedDataSets, ObjectView, Owner, ParamCheck, Parameters, Prepared,
Properties, ReadOnly, RecNo, RecordCount, RecordSet, RecordSetState, RecordSize, RecordStatus,
Reserved, Sort, SparseArrays, State, TableDirect, TableName, Tag, VCLComObject
Principais Mtodos
CreateBlobStream, CursorPosChanged, DefaultHandler, Delete, DeleteRecords, Destroy, DestroyComponents,
Destroying, DisableControls, Dispatch, Edit, EnableControls, ExecuteAction, FieldAddress, FieldByName,
FilterOnBookmarks, FindComponent, FindField, FindFirst, FindLast, FindNext, FindPrior, First, Free,
FreeBookmark, FreeInstance, FreeNotification, FreeOnRelease, GetBlobFieldData, GetBookmark,
GetCurrentRecord, GetDetailDataSets, GetDetailLinkFields, GetFieldData, GetFieldList, GetFieldNames,
GetIndexNames, GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent,
GotoBookmark, HasParent, InheritsFrom, InitInstance, Insert, InsertComponent, InsertRecord,
InstanceSize, IsEmpty, IsLinkedTo, IsSequenced. Last, LoadFromFile, Locate, Lookup, MethodAddress,
MethodName, MoveBy, NewInstance, Next, NextRecordset, Open, Post, Prior, Refresh, RemoveComponent,
Resync, SafeCallException, SaveToFile, Seek, SetFields, Supports, Translate, UpdateAction,
UpdateBatch, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
TANIMATE
Descrio
Esse componente permite que se executem animaes armazenadas em arquivos AVI (sem execuo
de som), componentes e itens de menu.
Unit
Na VCL:
ComCtrls
Active, Cente, CommonAVI, FileName, FrameCount, FrameHeight, FrameWidth, Open, Repetitions,
ResHandle, ResID, ResName, StartFrame, StopFrame, Timers, Transparent
Principais Mtodos
CanAutoSize, Create, Play, Reset, Seek, Stop
Principais Eventos
OnClose, OnOpen, OnStart e OnStop
TAPPLICATION
Descrio
Esse componente est presente em todas as aplicaes do Delphi. automaticamente incorporado a
um projeto durante a sua criao.
Unit
Na VCL:
Forms
Na CLX:
QForms
Active, ComponentCount, ComponentIndex, Components, ExeName, Handle, HelpFile, Hint, HintColr,
HintPause, Icon, MainForm, Name, Owner, ShowHint, Tag, Terminated, Title
Principais Mtodos
Create, CreateForm, Destroy, FindComponent, Free, HandleException, HelpCommand, HelpContext,
HelpKeyword, HelpTypeHelpJunt, InsertComponent, MessageBox, Minimize, NormalizeTopMosts,
ProcessMessages, RemoveComponent, Restore, RestoreTopMosts, Run, ShowException e Terminate
Principais Eventos
OnActivate, OnDeactivate, OnException, OnHelp, OnHint, OnIdle e OnMessage
TAPPLICATIONEVENTS
Descrio
Este componente intercepta eventos da aplicao.
Unit
Na VCL:
AppEvents
ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, DesignInfo,
Name, Owner, Tag e VCLComObject
Principais Mtodos
Activate, AfterConstruction, Assign, BeforeDestruction, CancelDispatch, ClassInfo, ClassName,
ClassNameIs, ClassParent, ClassType, CleanupInstance, Create, DefaultHandler, Destroy,
DestroyComponents, Destroying, Dispatch, FieldAddress, FindComponent, Free, FreeInstance,
GetParentComponent, HasParent, InheritsFrom, InitInstance, InsertComponent, InstanceSize,
MethodAddress, MethodName, NewInstance, RemoveComponent, SafeCallException
Principais Eventos
OnActionExecute, OnActionUpdate, OnActivate, OnDeactivate, OnException, OnHelp, OnHint, OnIdle,
OnMessage, OnMinimize, OnRestore, OnShortCut, OnShowHint
TAUTOINCFIELD
Descrio
Esse componente representa um campo de um registro de um banco de dados que armazena um valor
inteiro auto-incrementado, podendo assumir valores entre -2147483648 e 2147483647.
Unit
Na VCL e na CLX:
DB
Alignment, AsBoolean, AsDateTime, AsFloat, AsInteger, AsString, AsSQLTimeStamp, Calculated,
CanModify, DataSet, DataSize, DataType, DisplayFormat, DisplayLabel, DisplayName, DisplayText,
DisplayWidth, EditFormat, FieldName, FieldNo, Index, IsIndexField, IsNull, MaxValue. MinValue, Name,
Owner, ReadOnly, Required, Size, Tag, Text, Value e Visible
Principais Mtodos
Assign, AssignValue, Clear, Create, Destroy, FocusControl, Free, GetData, IsValidChar e SetData
Principais Eventos
OnChange, OnGetText, OnSetText e OnValidate
TBASEREPORT
Unit
Na VCL:
RpBase
Na CLX:
QRpBase
Descrio
Esta classe a classe-base para os principais componentes de visualizao do Rave Reports.
Aborted, AccuracyMethod, AscentHeight, Bins, BKColor, Bold, BottomWaste, BoxLineColor, Canvas,
Collate, ColumnEnd, ColumnLinesLeft, ColumnNum, Columns, ColumnStart, ColumnWidth, Copies,
CurrentPage, CurrentPass, CursorXPos, CursorYPos, DescentHeight, DeviceName, DevMode, DriverName,
Duplex, FileName, FirstPage, FontAlign, FontBaseline, FontBottom, FontCharset, FontColor,
FontHandle, FontHeight, FontName, FontPitch, FontRotation, Fonts, FontSize, FontTop, FontWidth,
FrameMode, GridVert, Italic, LastPage, LeftWaste, LineBottom, LineHeight, LineHeightMethod,
LineMiddle, LineNum, LinesPerInch, LineTop, MacroData, MarginBottom, MarginLeft, MarginRight,
MarginTop, MaxCopies, NoBufferLine, NoNTColorFix, NoPrinterPageHeight, NoPrinterPageWidth,
Orientation, OriginX, OriginY, OutputInvalid, OutputName, PageHeight, PageInvalid, PageWidth,
Papers, PIVar, Port, PrinterIndex, Printers, Printing, ReportDateTime, RightWaste, ScaleX, ScaleY,
SectionBottom, SectionLeft, SectionRight, SectionTop, Selection, ShadowDepth, StatusFormat,
StatusLabel, StatusText, Stream, StreamMode, Strikeout, Subscript, Superscript, TabColor,
TabJustify, TabShade, TextBKMode, Title, TopWaste, TotalPasses, TransparentBitmaps, TruncateText,
Underline, Units, UnitsFactor, Version, XDPI, XPos, YDPI, YPos
Principais Mtodos
Abort, AbortPage, AdjustLine, AllowAll, AllowPreviewOnly, AllowPrinterOnly, Arc, AssignFont,
BrushCopy, CalcGraphicHeight, CalcGraphicWidth, Chord, ClearAllTabs, ClearColumns, ClearTabs,
CopyRect, CR, Create, CreateBrush, CreateFont, CreatePen, CreatePoint, CreateRect, Destroy,
DrawFocusRect, Draw, Ellipse, Execute, FillRect, Finish, FinishTabBox, FloodFill, FrameRect,
GetMemoLine, GetNextLine, GetTab, GotoFooter, GotoHeader, GotoXY, GraphicFieldToBitmap, Home, LF,
LinesLeft, LineTo, Macro, MemoLines, MoveTo, NewColumn, NewLine, NewPage, NoPrinters, Pie, Polygon,
Polyline, PopFont, PopPos, PopTabs, Print, PrintBitmap, PrintBitmapRect, PrintBlock, PrintCenter,
PrintCharJustify, PrintData, PrintDataStream, PrintFooter, PrintHeader, PrintImageRect, PrintJustify,
PrintLeft, PrintLn, PrintMemo, PrintRight, PrintTab, PrintXY, PushFont, PushPos, PushTabs,
RecoverPrinter, Rectangle, RegisterGraphic, ReleasePrinter, Reset, ResetLineHeight, ResetPrinter,
ResetSection, ResetTabs, RestoreFont, RestorePos, RestoreTabs, ReuseGraphic, RoundRect, SaveFont,
SavePos, SaveTabs, SelectBin, SelectPaper0 SelectPrinter, SetBrush, SetColumns, SetColumnWidth,
SetFont, SetPaperSize, SetPen, SetPIVar, SetTab, SetTopOfPage, ShadeToColor, ShowPrintDialog,
ShowPrinterSetupDialog, Start, StretchDraw, SupportBin, SupportCollate, SupportDuplex,
SupportOrientation, SupportPaper, Tab, TabEnd, TabStart, TabWidth, TextRect, TextWidth,
UnregisterGraphic, UpdateStatus, XD2U, XI2D, XI2U, XU2D, XU2I, YD2I, YD2U, YI2D, YI2U, YU2D, YU2I
Principais Eventos
OnAfterPrint, OnBeforePrint, OnDecodeImage, OnNewColumn, OnNewPage, OnPrint, OnPrintFooter,
OnPrintHeader, OnPrintPage
TBATCHMOVE
Descrio
Esse componente permite que se realizem operaes sobre grupos de registros ou tabelas
inteiras.
Unit
Na VCL:
DBTables
AbortOnKeyViol, AbortOnProblem, ChangedCount, ChangedTableName, Destination, KeyViolCount,
KeyViolTableName, Mappings, Mode, MovedCount, Name, Owner, ProblemCount, ProblemTableName,
RecordCount, Source, Translitarate e Tag
Principais Mtodos
Execute
Principais Eventos
Esse componente no possui eventos associados.
TBCDFIELD
Descrio
em cdigo decimal binrio, com uma preciso de 18 algarismos significativos.
Unit
Na VCL e na CLX:
DB
Alignment, AsBoolean, AsDateTime, AsFloat, AsInteger, AsString, Calculated, CanModify, Currency,
DataSet, DataSize, DataType, DisplayFormat, DisplayLabel, DisplayName, DisplayText, DisplayWidth,
EditFormat, EditMask, EditMaskPtr, FieldName, FieldNo, Index, IndexField, IsNull, MaxValue.
MinValue, Name, Owner, Precision, ReadOnly, Required, Size, Tag, Text, Value e Visible
Principais Mtodos
Assign, AssignValue, Clear, Create, Destroy, FocusControl, Free, GetData, IsValidChar e SetData
Principais Eventos
TBEVEL
Descrio
O controle TBevel permite que sejam colocados quadros, caixas e linhas chanfrados (com aspecto
tridimensional) nos formulrios que compem a sua aplicao.
Unit
Na VCL:
ExtCtrls
Na CLX:
QExtCtrls
Align, BoundsRect, ComponentIndex, Components, ControlCount, Controls, Handle, Height, HelpContext,
HelpKeyword, HelpTypeHelpKeyword, HelpType, Hint, Left, Name, Owner, Parent, ParentShowHint, Shape,
ShowHint, Style, Tag, Top, Visible, Width
Principais Mtodos
BeginDrag, BringToFront, ClientToScreen, Dragging, EndDrag, Hide, Refresh, Repaint, ScreenToClient,
SendToBack, SetBounds, Show e Update
TBITBTN
Descrio
O controle TBitBtn um boto de pressionamento que permite a incluso de um bitmap na sua face.
Unit
Na VCL:
Buttons
Na CLX:
QButtons
Align, BoundsRect, Cancel, Caption, ComponentIndex, Cursor, Default, DragCursor, DragMode, Enabled,
Font, Glyph, Height, HelpContext, HelpKeyword, HelpTypeHint, Kind, Layout, Left, Margin,
ModalResult, Name, NumGlyphs, Owner, Parent, ParentFont, ParentShowHint, PopupMenu, ShowHint,
Showing, Spacing, Style, TabOrder, TabStop, Tag, Top, Visible, Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Click, ClientToScreen, Dragging, EndDrag, Focused, GetTextBuf,
GetTextLen, Hide, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy, SendToBack, SetBounds,
SetFocus, SetTextBuf, Show e Update
Principais Eventos
OnClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown, OnKeyPress, OnKeyUp,
OnMouseDown, OnMouseMove e OnMouseUp
TBITMAP
Descrio
Esse objeto armazena um grfico no formato Bitmap.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Canvas, Empty, Format, Handle, Height, Monochrome, Palette, PixelFormat, ScanLine, Transparent,
TransparentColor, TransparentMode e Width
Principais Mtodos
Assign, ClassName, ClassParent, ClassType, Create, Destroy, Free, LoadFromFile, ReleaseHandle,
ReleasePalette e SaveToFile
Principais Eventos
OnChange, OnProgress
TBLOBFIELD
Descrio
Esse componente representa um campo de um registro de um banco de dados que armazena um
conjunto arbitrrio de bytes cujo tamanho no predefinido.
Unit
Na VCL e na CLX:
DB
Align, AsBoolean, AsDateTime, AsFloat, AsInteger, AsString, BlobSize, BlobType, Calculated,
CanModify, DataSet, DataSize, DataType, DisplayLabel, DisplayName, DisplayText, DisplayWidth,
EditMask, EditMaskPtr, FieldName, FieldNo, GraphicHeader, Index, IsIndexField, IsNull, Name, Owner,
ReadOnly, Required, Size, Tag, Text e Visible
Principais Mtodos
Assign, AssignValue, Clear, FocusControl, GetData, IsValidChar, LoadFromFile, LoadFromStream,
SaveToFile, SaveToStream e SetData
Principais Eventos
TBLOBSTREAM
Descrio
Esse objeto fornece uma maneira simples de acessar e modificar um campo do tipo TBlobField,
TBytesField ou TVarBytesField lendo ou escrevendo nele como se fosse uma stream ou um arquivo.
Unit
Na VCL:
DBTables
Position, Size
Principais Mtodos
ClassName, ClassParent, ClassType, Create, Destroy, Free, Read, Seek, Truncate e Write
Principais Eventos
TBOOLEANFIELD
Descrio
booleano.
Unit
Na VCL e na CLX:
DB
Align, AsBoolean, AsDateTime, AsFloat, AsInteger, AsSQLTimeStamp, AsString, Calculated, CanModify,
DataSet, DataSize, DataType, DisplayLabel, DisplayName, DisplayText, DisplayWisth, EditFormat,
EditMask, EditMaskPtr, FieldName, FieldNo, Index, IsIndexField, IsNull, Name, Owner, ReadOnly,
Required, Size, Tag, Text, Value e Visible
Principais Mtodos
Assign, AssignValue, Clear, FocusControl, GetData, IsValidChar e SetData
Principais Eventos
TBRUSH
Descrio
Esse objeto armazena um pincel para o preenchimento de figuras slidas, como retngulos e elipses.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Bitmap, Color, Handle e Style
Principais Mtodos
Assign, ClassName, ClassParent, ClassType, Create, Destroy e Free
Principais Eventos
OnChange
TBUTTON
Descrio
O controle TButton representa um boto comum na sua face.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, BoundsRect, Cancel, Caption, ComponentIndex, Cursor, Default, DragCursor, DragMode, Enabled,
Font, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, ModalResult, Name, Owner, Parent,
ParentFont, ParentShowHint, PopupMenu, ShowHint, Showing, Spacing, Style, TabOrder, TabStop, Tag,
Top, Visible, Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Click, ClientToScreen, Dragging, EndDrag, Focused, GetTextBuf,
GetTextLen, Hide, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy, SendToBack, SetBounds,
Principais Eventos
TBYTESFIELD
Descrio
conjunto arbitrrio de bytes cujo tamanho no predefinido.
Unit
Na VCL e na CLX:
DB
Align, AsBoolean, AsDateTime, AsFloat, AsInteger, AsString, Calculated, CanModify, DataSet, DataSize,
DataType, DisplayLabel, DisplayName, DisplayText, DisplayWisth, EditMask, EditMaskPtr, FieldName,
FieldNo, Index, IsIndexField, IsNull, Name, Owner, ReadOnly, Required, Size, Tag, Text e Visible
Principais Mtodos
Principais Eventos
TCANVAS
Descrio
Esse objeto define uma superfcie de desenho.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Brush, ClipRect, CopyMode, Font, Handle, LockCount, Pen, PenPos, Pixels, StartCount, TextAlign
Principais Mtodos
Arc, BrushCopy, Chord, ClassName, ClassParent, ClassType, CopyRect, Create, Destroy, Draw,
DrawFocusRect, Ellipse, FillRect, FloodFill, FrameRect, Free, LineTo, MoveTo, Pie, Polygon,
Polyline, Rectangle, RoudRect, StretchDraw, TextHeight, TextOut, TextRect e TextWidth
Principais Eventos
OnChange e OnChanging
TCanvasReport
Unit
Na VCL:
RpCanvas
Na CLX:
QRpCanvas
Descrio
Esta classe usada para definir mtodos a serem usados pelos componentes do Rave Reports que
desenham em um Canvas.
Aborted, AccuracyMethod, AscentHeight, Bins, BKColor, old, BottomWaste, BoxLineColor, Canvas, Collate,
ColumnEnd, ColumnLinesLeft, ColumnNum, Columns, ColumnStart, ColumnWidth, Copies, CurrentPage,
CurrentPass, CursorXPos, CursorYPos, DescentHeight, DeviceName, DevMode, DriverName, Duplex, FileName,
FirstPage, FontAlign, FontBaseline, FontBottom, FontCharset, FontColor, FontHandle, FontHeight,
FontName, FontPitch, FontRotation, Fonts, FontSize, FontTop, FontWidth, FrameMode, GridVert, Italic,
LastPage, LeftWaste, LineBottom, LineHeight, LineHeightMethod, LineMiddle, LineNum, LinesPerInch,
LineTop, MacroData, MarginBottom, MarginLeft, MarginRight, MarginTop, MaxCopies, NoBufferLine,
NoNTColorFix, NoPrinterPageHeight, NoPrinterPageWidth, Orientation, OriginX, OriginY, OutputInvalid,
OutputName, PageHeight, PageInvalid, PageWidth, Papers, PIVar, Port, PrinterIndex, Printers, Printing,
ReportDateTime, RightWaste, ScaleX, ScaleY, SectionBottom, SectionLeft, SectionRight, SectionTop,
Selection, ShadowDepth, StatusFormat, StatusLabel, StatusText, Stream, StreamMode, Strikeout,
Subscript, Superscript, TabColor, TabJustify, TabShade, TextBKMode, Title, TopWaste, TotalPasses,
TransparentBitmaps, TruncateText, Underline, Units, UnitsFactor, XDPI, XPos, YDPI, YPos, Version
Principais Mtodos
SavePos, SaveTabs, SelectBin, SelectPaper, SelectPrinter, SetBrush, SetColumns, SetColumnWidth,
Principais Eventos
TCHART
Descrio
O controle TChart utilizado para exibir grficos nos mais diversos formatos.
Unit
Na VCL:
Chart
AllowPanning, Color, Printing, AllowZoom, Foot, DockClientCount, DockClients, PrintMargins, AnimatedZoom,
Frame, PrintResolution, AnimatedZoomSteps, Gradient, RightAxis, AxisVisible, Height3D, ScaleLastPage,
BackColor, LeftAxis, Series, BackImage, LeftWall, SeriesHeight3D, BackImageInside, Legend, SeriesList,
BottomAxis, MarginBottom, SeriesWidth3D, BackWall, DepthAxis, View3Doptions, BottomWall, MarginLeft,
Title, BufferedDisplay, MarginRight, TopAxis, CancelMouse, MarginTop, View3d, Canvas, MaxPointsPerPage,
View3dWalls, Chart3dPercent, MaxZOrder, Width3D, ChartBounds, Monochrome, ChartHeight, MonochromePrinting,
ChartRect, OriginalCursor, ChartWidth, BackImage, ClipPoints, BackImageMode
Principais Mtodos
ActiveSeriesLegend, TeeCreateMetafile, PrintRect, AddSeries, GetLabelsSeries, ReCalcWidthHeight,
Assign, GetCursorPos, RemoveAllSeries, BackWallRect, GetRectangle, RemoveSeries, CalcClickedpart,
GetWidthHeight, RotateLabel, CalcSize3d, IsFreeSeriesColor, SaveToBitmapFile, CalcSize3dWalls,
IsScreenHighColor, SaveToMetafile, CanvasChanged, IsValidDataSource, SaveToMetafileEnh,
ChartPrintRect, MarkText, SeriesCount, ChartRegionRect, MaxMarkWidth, SeriesDown, ChartXCenter,
MaxTextWidth, SeriesTitleLegend, ChartYCenter, MaxXValue, SeriesUp, CheckDatasource, MaxYValue,
SetInternalCanvas, MinXValue, Size3d, CopyToClipBoardBitmap, MinYValue, CopyToClipBoardMetafile,
NextPage, NumPages, PreviousPage, ExchangeSeries, Print, FontCanvas, PrintLandscape, UndoZoom,
FormattedLegend, PrintOrientation, XLabelText, FormattedValueLegend, PrintPartial, ZoomRect,
GetASeries, PrintPartialCanvas, ZoomPercent, GetAxisSeries, PrintPartialCanvasToScreen,
GetFreeSeriesColor, PrintPortrait, SaveToChartFile
Principais Eventos
OnAfterDraw, OnDblClick, OnMouseUp, OnAllowScroll, OnGetAxisLabel, OnPageChange, OnClick,
OnGetLegendPos, OnResize, OnClickAxis, OnGetLegendRect, OnScroll, OnClickBackground,
OnGetLegendText, OnUndoZoom, OnClickLegend, OnGetNextAxisLabel, OnZoom, OnClickSeries, OnMouseDown
TCHARTSERIES
Descrio
Essa classe representa uma srie de dados a serem exibidos em um grfico criado com o
componente TChart.
Unit
Na VCL:
TEengine
Active, AllowSinglePoint, LinkedSeries, VertAxis, Marks, XLabel, ColorEachPoint, ParentChart,
XLabelsSource, ColorSource, PercentFormat, XValue, Cursor, RecalcOptions, XValues, DataSource,
SeriesColor, YValue, Datasources, ShowInlegend, YValues, DesignMaxPoints, Title, ZOrder, FirstValueIndex,
ValueColor, FunctionType, ValueFormat, HorizAxis, ValueList, LastValueIndex, ValueMarkText
Principais Mtodos
Principais Eventos
TCHECKBOX
Descrio
O controle TCheckBox um boto de opo no-exclusiva, que permite ao usurio selecionar ou no
uma opo no aplicativo.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, Alignment, AllowGrayed, Caption, Checked, Color, ComponentIndex, Ctl3D, Cursor, DragCursor, DragMode,
Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Owner, Parent, ParentColor,
ParentFont, ParentShowHint, PopupMenu, ShowHint, Showing, State, TabOrder, TabStop, Tag, Top, Visible, Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, ClientToScreen, Dragging, EndDrag, FindComponent, Focused,
GetTextBuf, GetTextLen, Hide, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy, SendToBack,
SetBounds, SetTextBuf, Show e Update
Principais Eventos
TCLIENTDATASET
Descrio
Esse componente representa uma tabela de forma independente (no associada diretamente a um banco
de dados), sendo utilizado em aplicaes multicamadas de acesso a bancos de dados ou em aplicaes que
armazenam dados em arquivos sem utilizar o Activex Data Objects ou o Borland Database Engine.
Unit
Na VCL e na CLX:
DBclient
Active, ActiveAggs, Aggregates, AggregatesActive, CanModify, ChangeCount, Data, DataSetField,
DataSize, DataSource, Delta, FetchOnDemand, FileName, Filter, Filtered, FilterOptions,
GroupingLevel, HasProvider, IndexDefs, IndexFieldCount, IndexFieldNames, IndexFields, IndexName,
KeyExclusive, KeyFieldCount, KeySize, LogChanges, MasterFields, MasterSource, PacketRecords, Params,
Provider, ProviderName, ReadOnly, RecNo, RecordCount, RecordSize, RemoteServer, SavePoint,
StatusFilter, StoreDefs, AggFields, AutoCalcFields, BlockReadSize, Bof, Bookmark, DefaultFields,
Designer, Eof, FieldCount, FieldDefList, FieldDefs, FieldList, Fields, FieldValues, Found, Modified,
Name, ObjectView, SparseArrays, State
Principais Mtodos
AddIndex, AppendData, ApplyRange, ApplyUpdates, BookmarkValid, Cancel, CancelRange, CancelUpdates,
CloneCursor, CompareBookmarks, ConstraintsDisabled, Create, CreateBlobStream, CreateDataSet, DeleteIndex,
Destroy, DisableConstraints, EditKey, EditRangeEnd, EditRangeStar, EmptyDataSet, EnableConstraints,
FetchBlobs, FetchDetails, FetchParams, FindKey, FindNearest, GetCurrentRecord, GetFieldData,
GetGroupState, GetIndexInfo, GetIndexNames, GetNextPacket, GetOptionalParam, GotoCurrent, GotoKey,
GotoNearest, LoadFromFile, LoadFromStream, Locate, Lookup, MergeChangeLog, Post, Reconcile, RefreshRecord,
RevertRecord, SaveToFile, SaveToStream, SendParams, SetAltRecBuffers, SetKey, SetOptionalParam, SetRange,
SetRangeEnd, SetRangeStart, UndoLastChange, UpdateStatus, ActiveBuffer, Append, AppendRecord,
CheckBrowseMode, ClearFields, Close, ControlsDisabled, CursorPosChanged, Delete, DisableControls, Edit,
EnableControls, FieldByName, FindField, FindFirst, FindLast, FindNext, FindPrior, First, FreeBookmark,
GetBlobFieldData, GetBookmark, GetDetailDataSets, GetDetailLinkFields, GetFieldList, GetFieldNames,
GetProviderAttributes, GotoBookmark, Insert, InsertRecord, IsEmpty, IsLinkedTo, IsSequenced, Last, MoveBy,
Next, Open, Prior, Refresh, Resync, SetFields, Translate, UpdateCursorPos, UpdateRecordAssign, Clear,
Close, Create, Destroy, GetAsHandle, GetComponent, HasFormat, Open, SetAsHandle, SetComponent e SetTextBuf
Principais Eventos
OnReconcileError, AfterCancel, AfterClose, AfterDelete, AfterEdit, AfterInsert, AfterOpen, AfterPost,
AfterScroll, BeforeCancel, BeforeClose, BeforeDelete, BeforeEdit, BeforeInsert, BeforeOpen, BeforePost,
BeforeScroll, OnCalcFields, OnDeleteError, OnEditError, OnFilterRecord, OnNewRecord, OnPostError,
OnCalcFields, OnDeleteError, OnEditError, OnFilterRecord, OnNewRecord, OnPostError
TCLIENTSOCKET
Descrio
Esse componente gerencia conexes TCP/IP do lado cliente.
Unit
Na VCL:
scktcomp
ClientType, Socket, Active, Address, Host, Port, Service
Principais Mtodos
Create, Destroy, Close e Open
Principais Eventos
OnConnect, OnConnecting, OnDisconnect, OnError, OnLookup, OnRead, OnWrite
TCLIPBOARD
Descrio
Esta classe representa o clipboard (rea de transferncia) do sistema operacional e permite que voc
transfira textos e grficos de e para o clipboard.
Unit
Na VCL:
Clipbrd
Na CLX:
QClipbrd
AsText e Handle
Principais Mtodos
Assign, Clear, Close, Create, Destroy, GetAsHandle, GetComponent, HasFormat, Open, SetAsHandle,
SetComponent e SetTextBuf
Principais Eventos
TCOLORDIALOG
Descrio
O controle TColorDialog fornece uma caixa de dilogo para a seleo de cores.
Unit
Na VCL:
Dialogs
Na CLX:
QDialogs
Color, ComponentIndex, Ctl3D, CustomColors, HelpContext, HelpKeyword, HelpTypeHint, ItemHeight,
ItemIndex, Items, Left, Name, Options, Owner, Tag e Top
Principais Mtodos
Execute
Principais Eventos
TCOMBOBOX
Descrio
O controle TComboBox consiste em uma caixa de edio (na qual o usurio pode digitar um texto) e
uma lista de itens que podem ser selecionados.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, BoundsRect, Canvas, Color, ComponentIndex, Ctl3D, Cursor, DragCursor, DragMode,
DropDownCount, Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, ItemHeight, ItemIndex,
Items, Left, MaxLength, Name, Owner, Parent, ParentColor, ParentCtl3D, ParentFont, ParentShowHint,
PopupMenu, SelLengh, SelStart, SelText, ShowHint, Showing, Sorted, Style, TabOrder, TabStop, Tag,
Text, Top, Visible, Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Clear, ClientToScreen, Dragging, EndDrag, Focused, GetTextBuf,
GetTextLen, Hide, Invalidate, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy, SelectAll,
SendToBack, SetBounds, SetFocus, SetTextBuf, Show e Update
Principais Eventos
OnChange, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnDrawItem, OnDropDown, OnEndDrag, OnEnter,
OnExit, OnKeyDown, OnKeyPress, OnKeyUp, OnMeasureItem
TCOMPONENT
Descrio
A classe Tcomponent a classe-base de todos os componentes da VCL do Delphi.
Unit
Na VCL e na CLX:
Classes
Name, Owner, Tag e VCLComObject
Principais Mtodos
_AddRef, _Release, AfterConstruction, Assign, BeforeDestruction, ChangeName, ClassInfo, ClassName,
ClassNameIs, ClassParent, ClassType, CleanupInstance, Create, DefaultHandler, DefineProperties,
Destroy, DestroyComponents, Destroying, Dispatch, ExecuteAction, FieldAddress, FindComponent, Free,
FreeInstance, FreeNotification, FreeOnRelease, GetChildOwner, GetChildParent, GetChildren,
GetIDsOfNames, GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetOwner,
GetParentComponent, GetTypeInfo, GetTypeInfoCount, HasParent, InheritsFrom, InitInstance,
InsertComponent, InstanceSize, Invoke, Loaded, MethodAddress, MethodName, NewInstance, Notification,
QueryInterface, ReadState, RemoveComponent, SafeCallException, SetAncestor, SetChildOrder,
SetDesigning, SetInline, SetName, SetParentComponent, UpdateAction, Updated, UpdateRegistry,
Updating, ValidateContainer, ValidateInsert, ValidateRename, WriteState
Principais Eventos
esta classe no possui eventos associados
TCONTROLSCROLLBAR
Descrio
Esse objeto define as propriedades HorzScrollBar e VertScrollBar de componentes do tipo TForm e TScrollBox.
Unit
Na VCL:
Forms
Na CLX:
QForms
Align, ComponentIndex, Increment, Kind, Margin, Name, Owner, Position, Range, ScrollPos, Tag e Visible
Principais Mtodos
Esse objeto no possui mtodos associados.
Principais Eventos
TCORBACONNECTION
Descrio
Esse componente responsvel por conectar uma aplicao-cliente CORBA a um servidor remoto em
uma aplicao multicamada.
Unit
corbacon
AppServer, Cancelable, Connected, HostName, ObjectName, RepositoryID
Principais Mtodos
Create, GetProvider, Destroy
Principais Eventos
OnCancel, AfterConnect, AfterDisconnect, BeforeConnect, BeforeDisconnect
TCURRENCYFIELD
Descrio
nmero no formato binrio com 15 ou 16 dgitos de preciso, variando de 5.0 * 10-324 a 1.7 * 10+308.
Unit
Na VCL e na CLX:
DB
Currency, DataSet, DataSize, DataType, DisplayFormat, DisplayLabel, DisplayName, DisplayText,
DisplayWisth, EditFormat, EditMask, EditMaskPtr, FieldName, FieldNo, Index, IsIndexField, IsNull,
MaxValue, MinValue, Name, Owner, Precision, ReadOnly, Required, Size, Tag, Text, Value e Visible
Principais Mtodos
Principais Eventos
TCUSTOMADODATASET
Descrio
Esta classe permite acesso direto ou via declaraes sql a tabelas de bancos de dados atravs do Mecanismo
Activex Data Objects (ADO), sendo a classe-base dos componentes TADODataset, TADOTable,
TADOQuery e TADOStoredproc.
Unit
AdoDB
CursorType, DataSetField, DefaultFields, Designer, DesignerData, DesignInfo, Eof, ExecuteOptions,
ParamCheck, Parameters, Prepared, Properties, RecNo, RecordCount, RecordSet, RecordSetState,
RecordSize, RecordStatus, Reserved, Sort, SparseArrays, State, Tag, VCLComObject,
Principais Mtodos
Cancel, CancelBatch, CancelUpdates, CheckBrowseMode, ClassInfo, ClassName, ClassNameIs,
ClassParent, ClassType, CleanupInstance, ClearFields, Clone, Close, CompareBookmarks,
ControlsDisabled, Create, CreateBlobStream, CursorPosChanged, DefaultHandler, Delete,
DeleteRecords, Destroy, DestroyComponents, Destroying, DisableControls, Dispatch, Edit,
EnableControls, ExecuteAction, FieldAddress, FieldByName, FilterOnBookmarks, FindComponent,
FindField, FindFirst, FindLast, FindNext, FindPrior, First, Free, FreeBookmark, FreeInstance,
FreeNotification, FreeOnRelease, GetBlobFieldData, GetBookmark, GetCurrentRecord,
GetDetailDataSets, GetDetailLinkFields, GetFieldData, GetFieldList, GetFieldNames, GetInterface,
GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, GotoBookmark, HasParent,
InheritsFrom, InitInstance, Insert, InsertComponent, InsertRecord, InstanceSize, IsEmpty,
IsLinkedTo, IsSequenced. Last, LoadFromFile, Locate, Lookup, MethodAddress, MethodName, MoveBy,
NewInstance, Next, NextRecordset, Open, Post, Prior, Refresh, RemoveComponent, Resync,
SafeCallException, SaveToFile, Seek, SetFields, Supports, Translate, UpdateAction, UpdateBatch,
UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
TDATABASE
Descrio
Esse componente permite o acesso a um banco de dados. Caso a aplicao no possua um componente
desse tipo, mas precise acessar uma tabela de um banco de dados, o Delphi criar um componente
TDataBase temporrio.
Unit
Na VCL:
DBTables
AliasName, ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle,
Connected, DatabaseName, DatasetCount, DataSets, DesignInfo, DriverName, Handle, Isolation,
IsSQLBased, KeepConnection, Locale, LoginPrompt, Name, Owner, Params, Tag, Temporary e VCLComObject
Principais Mtodos
Close, CloseDataSets, Commit, Open, Rollback e StartTransaction
Principais Eventos
AfterConnect, AfterDisconnect, BeforeConnect, BeforeDisconnect, OnLogin
TDATASETPAGEPRODUCER
Descrio
Esse componente gera uma string de comandos HTML de um template com os dados provenientes de
um dataset.
Unit
Na VCL e na CLX:
DSProd
DataSet, HTMLFile, HTMLDoc
Principais Mtodos
Content, ContentFromStream, ContentFromString, Create, Destroy
Principais Eventos
OnHTMLTag
TDATASETPROVIDER
Descrio
Esse componente responsvel por fornecer os dados aplicao-cliente baseado em um dataset.
Unit
Na VCL e na CLX:
provider
DataSet, UpdateMode, Options, Resolver, Constraints, Data, Provider
Principais Mtodos
ApplyUpdates, Create, CreateDataPacket, CreateResolver, Destroy, DoGetDataSet, DoGetParams,
FetchData, GetDataSet, GetRecords, LocateRecord, Notification, Reset, SetDataSet, UpdateRecord,
SetParams, DataRequest, GetMetaData
Principais Eventos
OnGetDataSetProperties, AfterUpdateRecord, BeforeUpdateRecord, OnGetData, OnUpdateData,
OnUpdateError, OnDataRequest
TDATASETTABLEPRODUCER
Descrio
Esse componente gera uma string de comandos HTML que forma uma tabela com os dados provenientes
de um Dataset.
Unit
Na VCL e na CLX:
DBWeb
DataSet, Caption, CaptionAlignment, Columns, Editor, Footer, Header, MaxRows, RowAttributes e TableAttributes
Principais Mtodos
Content, BeginUpdate, Create, Destroy, EndUpdate
Principais Eventos
OnCreateContent, OnFormatCell, OnGetTableCaption
TDATASOURCE
Descrio
Esse componente estabelece a conexo entre componentes de acesso a bancos de dados e controles
que exibem os valores de campos de bancos de dados.
Unit
Na VCL e na CLX:
DB
AutoEdit, DataSet, Enabled, Name, Owner, State e Tag
Principais Mtodos
Create, Destroy, Edit e Free
Principais Eventos
OnDataChange, OnStateChange e OnUpdateChange
TDATEFIELD
Descrio
Esse componente representa um campo de um registro de um banco de dados que armazena uma data.
Unit
Na VCL e na CLX:
DB
DataSet, DataSize, DataType, DisplayLabel, DisplayName, DisplayText, DisplayWidth, EditMask,
EditMaskPtr, FieldName, FieldNo, Index, IsIndexField, IsNull, Name, Owner, ReadOnly, Required, Size,
Tag, Text e Visible
Principais Mtodos
Principais Eventos
TDATETIMEFIELD
Descrio
Esse componente representa um campo de um registro de um banco de dados que armazena uma data
e uma hora.
Unit
Na VCL e na CLX:
DB
Align, AsBoolean, AsDateTime, AsFloat, AsInteger, AsString, Calculated, CanModify, DataSet,
DataSize, DataType, DisplayFormat, DisplayLabel, DisplayName, DisplayText, DisplayWidth, EditMask,
Tag, Text, Value e Visible
Principais Mtodos
Principais Eventos
TDBCHART
Descrio
O controle TChart utilizado para exibir grficos nos mais diversos formatos.
Unit
Na VCL:
Chart
AllowPanning, AutoRefresh, RefreshInterval, DockClientCount, DockClients, ShowGlassCursor, Color,
Printing, AllowZoom, Foot, PrintMargins, AnimatedZoom, Frame, PrintResolution, AnimatedZoomSteps,
Gradient, RightAxis, AxisVisible, Height3D, ScaleLastPage, BackColor, LeftAxis, Series, BackImage,
LeftWall, SeriesHeight3D, BackImageInside, Legend, SeriesList, BottomAxis, MarginBottom,
SeriesWidth3D, BackWall, DepthAxis, View3Doptions, BottomWall, MarginLeft, Title, BufferedDisplay,
MarginRight, TopAxis, CancelMouse, MarginTop, View3d, Canvas, MaxPointsPerPage, View3dWalls,
Chart3dPercent, MaxZOrder, Width3D, ChartBounds, Monochrome, ChartHeight, MonochromePrinting,
Principais Mtodos
ActiveSeriesLegend, TeeCreateMetafile, PrintRect, CheckDataSource, IsValidDataSource, RefreshData,
RefreshDataSet, AddSeries, GetLabelsSeries, ReCalcWidthHeight, Assign, GetCursorPos,
RemoveAllSeries, BackWallRect, GetRectangle, RemoveSeries, CalcClickedpart, GetWidthHeight,
RotateLabel, CalcSize3d, IsFreeSeriesColor, SaveToBitmapFile, CalcSize3dWalls, IsScreenHighColor,
SaveToMetafile, CanvasChanged, IsValidDataSource, SaveToMetafileEnh, ChartPrintRect, MarkText,
SeriesCount, ChartRegionRect, MaxMarkWidth, SeriesDown, ChartXCenter, MaxTextWidth,
SeriesTitleLegend, ChartYCenter, MaxXValue, SeriesUp, CheckDatasource, MaxYValue, SetInternalCanvas,
MinXValue, Size3d, CopyToClipBoardBitmap, MinYValue, CopyToClipBoardMetafile, NextPage, NumPages,
PreviousPage, ExchangeSeries, Print, FontCanvas, PrintLandscape, UndoZoom, FormattedLegend,
PrintOrientation, XLabelText, FormattedValueLegend, PrintPartial, ZoomRect, GetASeries,
PrintPartialCanvas, ZoomPercent, GetAxisSeries, PrintPartialCanvasToScreen, GetFreeSeriesColor,
PrintPortrait, SaveToChartFile
Principais Eventos
OnGetLegendText, OnUndoZoom, OnClickLegend, OnGetNextAxisLabel, OnZoom, OnClickSeries, OnMouseDown,
OnProcessRecords
TDBCHECKBOX
Descrio
O controle TDBCheckBox um boto de opo no-exclusiva que permite ao usurio selecionar ou no
uma opo no aplicativo. Esse controle semelhante a TCheckBox, exceto que o seu valor est associado
a um campo de um registro de um banco de dados. Quando o controle estiver selecionado, ento a string
armazenada em sua propriedade ValueChecked ser igual armazenada no campo correspondente do
banco de dados. Se o controle no estiver selecionado, ento a string armazenada em sua propriedade
ValueUnChecked ser igual armazenada no campo correspondente do banco de dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, Alignment, AllowGrayed, Caption, Checked, Color, ComponentIndex, Ctl3D, Cursor, DataField,
DataSource, DragCursor, DragMode, Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHint,
Left, Name, Owner, Parent, ParentColor, ParentFont, ParentShowHint, PopupMenu, ReadOnly, ShowHint,
Showing, State, TabOrder, TabStop, Tag, Top, ValueChecked, ValueUnchecked, Visible, Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, ClientToScreen, Dragging, EndDrag, Focused, GetTextBuf,
GetTextLen, Hide, Invalidate, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy, SendToBack,
Principais Eventos
TDBCOMBOBOX
Descrio
O controle TDBComboBox consiste em uma caixa de edio (na qual o usurio pode digitar um texto) e
uma lista de itens que podem ser selecionados. Esse controle semelhante a TComboBox, exceto que o
seu valor est associado a um campo de um registro de um banco de dados. Quando o usurio digitar ou
selecionar um item, a string correspondente ser armazenada no campo respectivo do banco de dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, BoundsRect, Color, ComponentIndex, Ctl3D, Cursor, DataField, DataSource, DragCursor,
DragMode, DropDownCount, Enabled, Fields, Font, Handle, Height, HelpContext, HelpKeyword,
HelpTypeHint, ItemHeight, ItemIndex, Items, Left, Name, Owner, Parent, ParentColor, ParentCtl3D,
ParentFont, ParentShowHint, PopupMenu, ReadOnly, SelLengh, SelStart, SelText, ShowHint, Showing,
Sorted, Style, TabOrder, TabStop, Tag, Text, Top, Visible, Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Clear, ClientToScreen, CopyToClipBoard, CutToClipBoard, Dragging,
EndDrag, Focused, GetTextBuf, GetTextLen, Hide, Invalidate, PasteFromClipBoard, Refresh, Repaint,
ScaleBy, ScreenToClient, ScrollBy, SelectAll, SendToBack, SetBounds, SetFocus, SetTextBuf, Show e Update
Principais Eventos
OnChange, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnDrawItem, OnDropDown, OnEndDrag, OnEnter,
OnExit, OnKeyDown, OnKeyPress, OnKeyUp, OnMeasureItem
TDBCTRLGRID
Descrio
Esse controle semelhante ao controle TDBGrid, com a diferena de que este permite que se controle
o layout e a aparncia de cada registro de um banco de dados exibido em uma grade. Sua aplicao
pode utilizar a grade para exibir, inserir, deletar ou editar campos do banco de dados associado.
Unit
Na VCL:
DBGrids
AllowDelete, AllowInsert, Canvas, ColCount, Color, Cursor, DataSource, DragCursor, DragMode, EditMode,
Font, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Orientation, PanelBorder,
PanelCount, PanelHeight, PanelIndex, PanelWidth, ParentColor, ParentFont, ParentShowHint, PopupMenu,
RowCount, ShowFocus, ShowHint, TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
GetTextBuf, GetTextLen, Hide, Invalidate, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy,
Principais Eventos
OnColEnter, OnColExit, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown,
OnKeyPress, OnKeyUp
TDBEDIT
Descrio
O controle TDBEdit consiste em uma caixa de edio (na qual o usurio pode digitar um texto). Esse
controle semelhante ao TEdit, exceto que o seu valor est associado a um campo de um registro de
um banco de dados. Quando o usurio digitar um texto na caixa de edio, a string correspondente
ser armazenada no campo respectivo do banco de dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, AutoSelect, AutoSize, BorderStyle, BoundsRect, CharCase, Color, ComponentIndex, Ctl3D,
Cursor, DataField, DataSource, DragCursor, DragMode, EditText, Enabled, Fields, Font, Height,
HelpContext, HelpKeyword, HelpTypeHint, IsMasked, Left, MaxLength, Modified, Name, Owner, Parent,
ParentColor, ParentCtl3D, ParentFont, ParentShowHint, PassWordChar, PopupMenu, ReadOnly, SelLengh,
SelStart, SelText, ShowHint, Showing, Style, TabOrder, TabStop, Tag, Text, Top, Visible, Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Clear, ClearSelection, ClientToScreen, CopyToClipBoard,
CutToClipBoard, Dragging, EndDrag, Focused, GetTextBuf, GetTextLen, Hide, Invalidate,
PasteFromClipBoard, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy, SelectAll, SendToBack,
SetBounds, SetFocus, SetSelTextBuf, SetTextBuf, Show, Update e ValidateEdit
Principais Eventos
OnChange, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown,
OnKeyPress, OnKeyUp, OnMouseDown, OnMouseMove e OnMouseUp
TDBGRID
Descrio
Esse controle permite acesso aos dados de um banco de dados e exibe-os em uma grade. Sua aplicao
pode utilizar a grade para exibir, inserir, deletar ou editar campos do banco de dados associado.
Unit
Na VCL:
DBGrids
Na CLX:
QDBGrids
Align, BorderStyle, BoundsRect, Brush, Canvas, ClientHeight, ClientOrigin, ClientRect, ClientWidth,
Color, ComponentIndex, Ctl3D, Cursor, DataSource, DefaultDrawing, i :=
Panel1.DockClientCount;DragCursor, DragMode, EditorMode, Enabled, Fields, FixedColor, Font, Height,
HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Options, Owner, Parent, ParentColor,
ParentCtl3D, ParentFont, PopupMenu, ReadOnly, SelectedField, SelectedIndex, Showing, TabOrder,
TabStop, Tag, Top, TopRow, Visible, Width
Principais Mtodos
Principais Eventos
OnColEnter, OnColExit, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown,
OnKeyPress, OnKeyUp
TDBIMAGE
Descrio
Esse controle permite exibir uma imagem armazenada em um campo de um registro de um banco de
dados como um objeto BLOB (Bynary Large Object).
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, AutoDisplay, BorderStyle, Center, Color, ComponentIndex, Ctl3D, Cursor, DataField,
DataSource, DragCursor, DragMode, Enabled, Fields, Font, Handle, Height, HelpContext, HelpKeyword,
HelpTypeHint, Left, Name, Owner, Parent, ParentColor, ParentCtl3D, ParentFont, ParentShowHint,
PopupMenu, ReadOnly, ShowHint, Stretch, TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, ClientToScreen, CopyToClipboard, CutToClipboard, Dragging, EndDrag,
Focused, Hide, Invalidate, LoadPicture, PasteFromClipBoard, Refresh, Repaint, ScreenToClient,
SendToBack, SetBounds, Show e Update
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown, OnKeyPress,
OnKeyUp, OnMouseDown, OnMouseMove, OnMouseUp
TDBLISTBOX
Descrio
O controle TDBListBox consiste em uma caixa de listagem. Esse controle semelhante a TListBox,
exceto que o seu valor est associado a um campo de um registro de um banco de dados. Quando o
usurio selecionar um item da caixa de listagem, a string correspondente ser armazenada no campo
respectivo do banco de dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, BorderStyle, BoundsRect, Brush, Canvas, Color, ComponentIndex, Ctl3D, Cursor, DataField,
DataSource, DragCursor, DragMode, Enabled, Fields, Font, Handle, Height, HelpContext, HelpKeyword,
HelpTypeHint, ItemIndex, IntegralHeight, ItemHeight, Items, Left, Name, Owner, Parent, ParentColor,
ParentCtl3D, ParentFont, PopupMenu, ReadOnly, SelCount, Selected, Sorted, Style, TabOrder, TabStop,
Tag, Top, Visible e Width
Principais Mtodos
GetTextLen, Hide, ItemAtPos, ItemRect, Invalidate, Refresh, Repaint, ScaleBy, ScreenToClient,
ScrollBy, SendToBack, SetBounds, SetFocus, SetTextBuf, Show e Update
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnDrawItem, OnEndDrag, OnEnter, OnExit, OnKeyDown,
OnKeyPress, OnKeyUp, OnMeasureItem, OnMouseDown, OnMouseMove e OnMouseUp
TDBLOOKUPCOMBOBOX
Descrio
O controle TDBLookupComboBox consiste em uma caixa combo que est associada aos campos de
um banco de dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Color, Ctl3D, Cursor, DataField, DataSource, DragCursor, DragMode, DropDownAlign, DropDownRows,
DropDownWidth, Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, KeyField, KeyValue,
Left, ListField, ListSource, ListVisible, Name, Owner, ParentColor, ParentCtl3D, ParentFont,
ParentShowHint, PopupMenu, ShowHint, TabOrder, TabStop, Text e Visible
Principais Mtodos
CloseUp e DropDown
Principais Eventos
OnMouseDown, OnMouseMove, OnMouseUp e OnStartDrag
TDBLOOKUPLISTBOX
Descrio
O controle TDBLookupListBox consiste em uma caixa de listagem que est associada aos campos de
um banco de dados. Esse controle semelhante a TListBox, exceto que o seu valor est associado a um
campo de um registro de um banco de dados. Deve ser usado em programas desenvolvidos para os
ambientes Windows 95 ou Windows NT em lugar de TDBLookupList.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, BorderStyle, BoundsRect, Color, ComponentIndex, Ctl3D, Cursor, DataField, DataSource,
DragCursor, DragMode, Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name,
Owner, Parent, ParentColor, ParentCtl3D, ParentFont, ParentShowHint, PopupMenu, ReadOnly, ShowHint,
TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, ClientToScreen, Create, DefaultDrawColumnCell, Dragging, EndDrag,
FindComponent, Focused, Free, GetTextBuf, GetTextLen, Hide, Invalidate, Refresh, Repaint, ScaleBy,
ScreenToClient, ScrollBy, SendToBack, SetBounds, SetFocus, SetTextBuf, Show, Update e ValidFieldIndex
Principais Eventos
OnKeyUp e OnStartDrag
TDBMEMO
Descrio
O controle TDBMemo exibe texto para o usurio e permite que o ele exiba e digite dados no controle.
Esse controle semelhante a TMemo, exceto que o seu valor est associado a um campo de um registro
de um banco de dados. Quando o usurio digitar um texto no controle, esse texto armazenado no
campo respectivo do banco de dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, Alignment, AutoDisplay, BorderStyle, BoundsRect, Color, ComponentIndex, Ctl3D, Cursor,
DataField, DataSource, DragCursor, DragMode, Enabled, Fields, Font, Height, HelpContext,
HelpKeyword, HelpTypeHint, Left, Lines, MaxLength, Modified, Name, Owner, Parent, ParentColor,
ParentCtl3D, ParentFont, ParentShowHint, PopupMenu, ReadOnly, ScrollBars, SelLengh, SelStart,
SelText, ShowHint, Showing, TabOrder, TabStop, Tag, Text, Top, Visible, WantTabs, Width e WordWrap
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Clear, ClientToScreen, Dragging, EndDrag, Focused, GetSelTextBuf,
GetTextBuf, GetTextLen, Hide, Invalidate, LoadMemo, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy,
SelectAll, SendToBack, SetBounds, SetFocus, SetSelTextBuf, SetTextBuf, Show, Update e ValidateEdit
Principais Eventos
TDBMEMOBUF
Unit
Na VCL:
RpDBUtil Na CLX:
QRpDBUtil
Descrio
Adiciona processamento de campos do tipo Memo em bancos de dados classe TMemoBuf.
BaseReport, Buffer, BufferInc, Field, Justify, MaxSize, Memo, NoCRLF, NoNewLine, Pos, PrintEnd,
PrintStart, RichEdit, RTFField, RTFText, Size, Text, Version
Principais Mtodos
Append, AppendMemoBuf, ConstraintHeightLeft, Delete, Empty, FreeSaved, InsertMemoBuf, Insert,
LoadFromFile, LoadFromStream, MemoHeightLeft, MemoLinesLeft, PrintHeight, PrintLines, ReplaceAll,
Reset, RestoreBuffer, RestoreState, RTFLoadFromFile, RTFLoadFromStream, SaveBuffer, SaveState,
SaveToStream, SearchFirst, SearchNext, SetData
Principais Eventos
Esta classe no tem eventos associados.
TDBNAVIGATOR
Descrio
O controle TDBNavigator permite que voc se mova pelos campos de um banco de dados por meio de
componentes do tipo TTable e TQuery, e realize operaes sobre o banco de dados, como inserir um
registro em branco ou posicionar-se sobre um registro. Normalmente esse controle empregado
simultaneamente a outros controles que permitem a edio e exibio dos dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, BoundsRect, ComponentIndex, ConfirmDelete, Ctl3D, Cursor, DataSource, DragCursor, DragMode,
Height, HelpContext, HelpKeyword, HelpTypeHint, Hints, Left, Name, Owner, Parent, ParentCtl3D,
ParentFont, ParentShowHint, PopupMenu, Showing, ShowHint, TabOrder, TabStop, Tag, Top, Visible,
VisibleButtons e Width
Principais Mtodos
BeginDrag, BringToFront, BtnClick, CanFocus, Clear, ClientToScreen, Dragging, EndDrag, Focused,
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnMouseDown, OnMouseMove,
OnMouseUp e OnResize
TDBRADIOGROUP
Descrio
O controle TDBRadioGroup permite a exibio de um conjunto de botes de rdio que representam opes
mutuamente exclusivas. Esse controle semelhante a TRadioGroup, exceto que, nesse caso, as opes
representadas pelos botes de rdio esto associadas a campos de registros de um banco de dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, Caption, Color, Columns, ComponentIndex, Ctl3D, Cursor, DataField, DataSource, DragCursor,
DragMode, Enabled, Fields, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, ItemIndex, Items,
Left, Name, Owner, Parent, ParentColor, ParentCtl3D, ParentFont, ParentShowHint, PopupMenu,
ReadOnly, ShowHint, Showing, TabOrder, TabStop, Tag, Top, Value, Values, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, ClientToScreen, ContainsControl, Dragging, EndDrag, Focused,
Principais Eventos
OnChange, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter e OnExit
TDBRICHEDIT
Descrio
O controle TDBRichEdit semelhante ao controle TMemo, mas permite a aplicao de fontes com
diferentes atributos a partes distintas do texto inserido no controle.
Unit
Na VCL:
DBCtrls
Align, Alignment, BorderStyle, BoundsRect, Brush, ClientHeight, ClientOrigin, ClentRect,
ClientWidth, Color, ComponentCount, ComponentIndex, Components, ControlCount, Controls, Ctl3D,
Cursor, DataSource, DataField, DragMode, Enabled, Font, Handle, Height, HelpContext, HelpKeyword,
HelpTypeHideScrollBars, HideSelection, Hint, Left, Lines, MaxLength, Name, Owner, Paragraph, Parent,
ParentColor, ParentCtl3D, ParentFont, PlainText, PopupMenu, ReadOnly, ScrollBars, SetAttributes,
ShowHint, Showing, TabOrder, TabStop, Tag, Top, Visible, WantTabs, WantReturns, Width e WordWrap
Principais Mtodos
Assign, BeginDrag, BringToFront, CanFocus, ClassName, ClassParent, ClassType, ClientToScreen,
ContainsControl, ControlAtPos, Create, Destroy, DragDrop, Dragging, EndDrag, FindComponent,
FindText, Focused, GetTextBuf, GetTextLen, HandleAllocated, HandleNeeded, Hide, InsertComponent,
InsertControl, Invalidate, Print, Refresh, RemoveComponent, RemoveControl, Repaint, ScaleBy,
ScreenToClient, ScrollBy, SendToBack, SetBounds, SetFocus, SetTextBuf, Show e Update
Principais Eventos
OnChange, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown, OnKeyPress, OnKeyUp,
OnMouseDown, OnMouseMove, OnMouseUp, OnProtectChange, OnResizeRequest, OnSaveClipboard,
OnSelectionChange e OnStartDrag
TDBTEXT
Descrio
O controle TDBText permite a exibio de um texto em um formulrio. Esse controle semelhante ao TLabel,
exceto que, nesse caso, o texto exibido est associado a um campo de um registro de um banco de dados.
Unit
Na VCL:
DBCtrls
Na CLX:
QDBCtrls
Align, Alignment, AutoSize, BoundsRect, Color, ComponentIndex, Cursor, DataField, DataSource,
DragCursor, DragMode, Enabled, Fields, Font, Height, Hint, Left, Name, Owner, Parent, ParentColor,
ParentFont, ParentShowHint, PopupMenu, ShowHint, Tag, Top, Transparent, Visible, Width e WordWrap
Principais Mtodos
BeginDrag, BringToFront, CanFocus, ClientToScreen, ContainsControl, Dragging, EndDrag, GetTextBuf,
GetTextLen, Hide, Invalidate, Refresh, Repaint, ScreenToClient, SendToBack, SetBounds, SetTextBuf,
Show e Update
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnMouseDown, OnMouseMove e OnMouseUp
TDCOMCONNECTION
Descrio
Esse componente responsvel por conectar uma aplicao-cliente DCOM a um servidor remoto em
uma aplicao multicamada.
Unit
Na VCL:
MConnect
ComputerName, Connected, AppServer, LoginPrompt, ObjectBroker, ServerGUID, ServerName
Principais Mtodos
Create, DoConnect, GetProvider, Destroy
Principais Eventos
OnGetUserName, OnLogin, AfterConnect, AfterDisconnect, BeforeConnect, BeforeDisconnect
TDDECLIENTCONV
Descrio
Esse componente estabelece uma conversao DDE com uma aplicao servidora.
Unit
Na VCL:
DDEMan
ComponentIndex, ConnectMode, DDEService, DDETopic, FormatChars, Name, Owner, ServiceApplication e Tag
Principais Mtodos
CloseLink, ExecuteMacro, ExecuteMacroLines, OpenLink, PokeData, PokeDataLines, RequestData e SetLink
Principais Eventos
OnClose e OnOpen
TDDECLIENTITEM
Descrio
Esse componente define o item da aplicao-cliente em uma conversao DDE.
Unit
Na VCL:
DDEMan
ComponentIndex, DDEConv, DDEItem, Lines, Name, Owner, Tag e Text
Principais Mtodos
Esse componente no possui mtodos associados.
Principais Eventos
OnChange
TDDESERVERCONV
Descrio
Esse componente estabelece uma conversao DDE com uma aplicao-cliente.
Unit
Na VCL:
DDEMan
ComponentIndex, Name, Owner e Tag
Principais Mtodos
Principais Eventos
OnClose, OnExecuteMacro e OnOpen
TDDESERVERITEM
Descrio
Esse componente define o item da aplicao servidora em uma conversao DDE.
Unit
Na VCL:
DDEMan
ComponentIndex, Lines, Name, Owner, ServConv, Tag e Text
Principais Mtodos
CopyToClipboard
Principais Eventos
OnChange e OnPokeData
TDECISIONCUBE
Descrio
Esse componente permite a exibio de dados na forma tabular.
Unit
Na VCL:
mxdb
Dataset, DimensionMap, MaxCells, MaxDimensions, MaxSummary, Name, ShowProgressDialog e Tag
Principais Mtodos
Create, Destroy, GetDetailSQL, GetSQL, ShowCubeDialog
Principais Eventos
AfterClose, AfterOpen, BeforeClose, BeforeOpen, OnLowCapacity, OnRefresh
TDECISIONGRAPH
Descrio
O controle TDecisionGraph utilizado para exibir grficos de informaes manipuladas pelos
componentes DecisionCube.
Unit
Na VCL:
Chart
AllowPanning, Color, Printing, AllowZoom,Foot, PrintMargins, AnimatedZoom, DecisionCube, Frame,
PrintResolution, AnimatedZoomSteps, Gradient, RightAxis, AxisVisible, Height3D, ScaleLastPage, BackColor,
LeftAxis, Series, BackImage, LeftWall, SeriesHeight3D, BackImageInside, Legend, SeriesList, BottomAxis,
MarginBottom, SeriesWidth3D, BackWall, DepthAxis, View3Doptions, BottomWall, MarginLeft, Title,
BufferedDisplay, MarginRight, TopAxis, CancelMouse, MarginTop, View3d, Canvas, MaxPointsPerPage,
View3dWalls, Chart3dPercent, MaxZOrder, Width3D, ChartBounds, Monochrome, ChartHeight, MonochromePrinting,
Principais Mtodos
Principais Eventos
TDECISIONGRID
Descrio
Esse componente exibe os dados manipulados pelos componentes DecisionCube, DecisionQuery,
DecisionSource e DecisionPivot.
Unit
Na VCL:
mxgrid
CaptionColor, CaptionFont, Cells, ColCount, DataColor, DataFont, DataSumColor, DecisionSource,
DefaultColWidth, DefaultRowHeight, Dimensions, FixedCols, FixedRows, GridLineColor, GridLineWidth,
LabelColor, LabelFont, LabelSumColor, Options, RowCount, ShowCubeEditor, Totals, BorderStyle,
DefaultDrawing, ScrollBars, BevelEdges, BevelInner, BevelKind, BevelOuter, BevelWidth, Brush,
ClientOrigin, ClientRect, ControlCount, Controls, DockClientCount, DockClients, DoubleBuffered,
Handle, HelpContext, HelpKeyword, HelpTypeParentWindow, Showing, TabOrde, TabStop, Align,
BoundsRect, ClientHeight, ClientWidth, Constraints, ControlState, ControlStyle, Cursor,
DockOrientation, Enabled, Floating, FloatingDockSiteClass, Height, Hint, HostDockSite, Left,
LRDockWidth, Name, Parent, ShowHint, TBDockHeight, Top, UndockHeight, UndockWidth, Visible, Width,
WindowProc, ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle,
DesignInfo, Owner, Tag, VCLComObject
Principais Mtodos
CellDrawState, CellValueArray, Create, Destroy, Notification, MouseCoord, CanFocus, ContainsControl,
ControlAtPos, CreateParented, CreateParentedControl, DefaultHandler, DisableAlign, DockDrop,
EnableAlign, FindChildControl, FlipChildren, Focused, GetTabOrderList, HandleAllocated, HandleNeeded,
InsertControl, Invalidate, MouseWheelHandler, PaintTo, Realign, RemoveControl, Repaint, ScaleBy,
ScrollBy, SetBounds, SetFocus, Update, UpdateControlState, BeginDrag, Dock, DrawTextBiDiModeFlags,
DrawTextBiDiModeFlagsReadingOnly, BringToFront, ClientToScreen, DragDrop, Dragging, EndDrag,
GetControlsAlignment, GetParentComponent, GetTextBuf, GetTextLen, HasParent, Hide, InitiateAction,
IsRightToLeft, ManualDock, ManualFloat, Perform, Refresh, ReplaceDockedControl, ScreenToClient,
SendToBack, SetTextBuf, Show,UseRightToLeftAlignment, UseRightToLeftReading, UseRightToLeftScrollBar,
DestroyComponents, Destroying, ExecuteAction, FindComponent, FreeNotification, FreeOnRelease,
GetNamePath, InsertComponent, RemoveComponent, SafeCallException, UpdateAction, Assign
Principais Eventos
OnDecisionDrawCell, OnDecisionExamineCell, OnTopLeftChanged, OnEnter, OnExit, OnKeyDown, OnKeyPress,
OnKeyUp, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnMouseDown, OnMouseMove,
OnMouseUp, OnResize, OnStartDrag
TDECISIONPIVOT
Descrio
Esse componente define o piv para um conjunto de componentes DecisionCube.
Unit
Na VCL:
mxpivsrc
BorderStyle, BorderWidth, ButtonAutoSize, ButtonHeight, ButtonSpacing, ButtonWidth, DecisionSource,
GroupLayout, Groups, GroupSpacing, Alignment, BevelInner, BevelOuter, BevelWidth, Name, Tag, Top,
Width, Height, Left, Cursor, Font, Align, Ctl3D, TabOrder,TabStop, ShowHint, ParentFont,
ParentColor, ParentShowHint, ParentCtl3D, PopupMenu, Visible
Principais Mtodos
SetBounds, CanFocus, Focused, ContainsControl
Principais Eventos
OnEnter, OnExit, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnResize, OnStartDragTDecisionQuery
TDECISIONQUERY
Descrio
Esse componente uma especializao do componente TQuery para utilizao com o componente
TDecisionCube.
Unit
Na VCL:
mxTables
Active, AutoCalcFilelds, BOB, CanModify, Database, DatabaseName, DatabaseSource, DBHandle, DBLocale, EOF,
FieldCount, FieldDefs, Field, Handle, Local, Locale, Modified, Name, Owner, ParamCount, Params, Prepared,
RecordCount, RequestLive, SQL, SQLBinary, State, StmtHandle, Tag, Text, Unidirecional e UpdateMode
Principais Mtodos
Append, AppendRecord, Cancel, CheckBrowseMode, ClearFields, Close, CursorPosChanged, Delete,
DisableControls, Edit, EnableControls, ExecSQL, FieldByName, FindField, First, FreeBookmark,
GetBookmark, GetFieldNames, GotoBookmark, Insert, InsertRecord, Last, MoveBy, Next, Open,
ParamByName, Post, Prepare, Prior, Refresh, SetFields, UnPrepared, UpdateCursorPos e UpdateRecord
Principais Eventos
AfterCancel, AfterClose, AfterDelete, AfterEdit, AfterInsert, AfterOpen, AfterPost, BeforeCancel,
BeforeClose, BeforeDelete, BeforeEdit, BeforeInsert, BeforeOpen, BeforePost, OnCalcFields e OnNewRecord
TDECISIONSOURCE
Descrio
Esse componente estabelece a conexo entre o componente DecisionCube e os componentes
DecisionPivot, DecisionGrid e DecisionGraph.
Unit
Na VCL:
mxdb
ControlType, CurrentSum, DecisionCube, nColDims, nDataCols, nDataRows, nDims, nOpenColDims,
nOpenRowDims, nRowDims, nSums, Ready, SparseCols, SparseRows
Principais Mtodos
CloseDimIndexRight, Create, Destroy, DrillDimIndex, Get2DdataAsVariant, GetActiveDim,
GetDataAsString, GetDataAsVariant, GetDimensionMemberCount, GetDimensionName, GetGroup,
GetGroupExtent, GetIndex, GetMemberAsString, GetMemberAsVariant, GetRowState, GetState,
GetSummaryName, GetValue, GetValueArray, GetValueIndex, MoveDimIndexes, OpenDimIndexLeft,
OpenDimIndexRight, SetCurrentSummary, SwapDimIndexes, ToggleDimIndex
Principais Eventos
OnAfterPivot, OnBeforePivot, OnLayoutChange, OnNewDimensions, OnStateChange, OnSummaryChange
TDIRECTORYLISTBOX
Descrio
O controle TDirectoryListBox uma caixa de listagem especial que est relacionada estrutura de
diretrios do drive correntemente selecionado no seu computador, e permite ao usurio mudar o
diretrio corrente, atribuindo-o propriedade Directory.
Unit
Na VCL:
FileCtrl
Align, BoundsRect, Color, Columns, ComponentIndex, Ctrl3D, Cursor, Directory, DirLabel, DragCursor, DragMode,
Drive, Enabled, FileList, Font, Handle, Height, HelpContext, HelpKeyword, HelpTypeHint, IntegralHeight,
ItemHeight, Left, Name, Owner, Parent, ParentColor, ParentCtrl3D, ParentFont, ParentShowHint, PopupMenu,
Selected, ShowHint, Showing, TabOrder, TabStop, Tag, Top, TopIndex, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Clear, ClientToScreen, Dragging, EndDrag, Focused, GetItemPath,
GetTextBuf, GetTextLen, Hide, Invalidate, ItemAtPos, ItemRect, Refresh, Repaint, ScaleBy,
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnDropDown, OnEndDrag, OnEnter, OnExit, OnKeyDown,
TDRAWGRID
Descrio
O controle TDrawGrid permite a exibio de um conjunto de dados na forma de um arranjo de
linhas e colunas.
Unit
Na VCL:
Grids
Na CLX:
QGrids
Align, BorderStyle, BoundsRect, Brush, Canvas, Col, ColCount, Color, ColWidthds, ComponentIndex,
Ctrl3D, Cursor, DefaultColWidth, DefaultDrawing, DefaultRowHeight, DragCursor, DragMode, EditorMode,
Enabled, FixedColors, FixedCols, FixedRows, GridHeight, GridLineWidth, GridWidth, Height,
HelpContext, HelpKeyword, HelpTypeHint, Left, LeftCol, Name, Owner, Parent, ParentColor,
ParentCtrl3D, ParentFont, PopupMenu, Row, RowCount, RowHeights, ScrollBars, Selection, Showing,
TabOrder, TabStop, TabStops, Tag, Top, TopRow, Visible, VisibleColCount, VisibleRowCount e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, CellRect, ClassName, ClassParent, ClassType, ClientToScreen,
Dragging, EndDrag, Focused, GetTextBuf, GetTextLen, Hide, Invalidate, MouseToCell, Refresh, Repaint,
ScaleBy, ScreenToClient, ScrollBy, SendToBack, SetBounds, SetFocus, SetTextBuf, Show e Update
Principais Eventos
OnClick, OnColumnMoved, OnDblClick, OnDragDrop, OnDragOver, OnDrawCell, OnEndDrag, OnEnter, OnExit,
OnGetEditMask, OnGetEditText, OnKeyDown, OnKeyPress, OnKeyUp, OnMouseDown, OnMouseMove, OnMouseUp,
OnRowMoved, OnSelectCell, OnSetEditText e OnTopLeftChanged
TDRIVECOMBOBOX
Descrio
O controle TDriveComboBox uma caixa de listagem especial que exibe todos os drives disponveis
quando a aplicao executada.
Unit
Na VCL:
FileCtrl
Align, BoundsRect, Color, ComponentIndex, Ctrl3D, Cursor, DirList, DragCursor, DragMode, Drive,
Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, Item, ItemIndex, Left, Name, Owner,
Parent, ParentColor, ParentCtrl3D, ParentFont, PopupMenu, SelLength, SelStart, SelText, Showing,
TabOrder, TabStop, Tag, Text TextCase, Top, Visible e Width
Principais Mtodos
Principais Eventos
OnChange, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnDropDown, OnEndDrag, OnEnter, OnExit,
OnKeyDown, OnKeyPress e OnKeyUp
TEDIT
Descrio
O controle TEdit consiste em uma caixa de edio (na qual o usurio pode digitar um texto).
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, AutoSelect, AutoSize, BorderStyle, CharCase, Color, ComponentIndex, Ctl3D, Cursor,
DragCursor, DragMode, Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHideSelection, Hint,
Left, MaxLength, Modified, Name, OEMConvert, Owner, Parent, ParentColor, ParentCtl3D, ParentFont,
ParentShowHint, PassWordChar, PopupMenu, ReadOnly, SelLengh, SelStart, SelText, ShowHint, Showing,
TabOrder, TabStop, Tag, Text, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, Clear, ClearSelection, ClientToScreen, CopyToClipBoard, CutToClipBoard,
Dragging, EndDrag, FindComponent, Free, GetSelText, GetTextBuf, GetTextLen, Hide, Invalidate,
SetBounds, SetFocus, SetSelTextBuf, SetTextBuf, Show e Update
Principais Eventos
OnChange, OnClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown, OnKeyPress,
OnKeyUp, OnMouseDown, OnMouseMove e OnMouseUp
TFIELD
Descrio
Esse componente representa um campo de um registro de um banco de dados que armazena qualquer
tipo de dado.
Unit
Na VCL e na CLX:
DB
Tag, Text, e Visible
Principais Mtodos
Principais Eventos
TFIELDDEF
Descrio
Esse objeto representa um campo de um registro de uma tabela de um banco de dados que armazena
qualquer tipo de dado.
Unit
Na VCL e na CLX:
DB
DataType, FieldClass, FieldNo, Name, Required e Size
Principais Mtodos
ClassName, ClassParent, ClassType, Create, CreateField, Destroy e Field
Principais Eventos
Esse objeto no possui eventos associados.
TFILELISTBOX
Descrio
O controle TFileListBox uma caixa de listagem especial que exibe os arquivos do diretrio corrente.
Unit
Na VCL:
FileCtrl
Align, BoundsRect, Canvas, ComponentIndex, Color, Controls, Ctrl3D, Cursor, Directory, DragCursor,
DragMode, Enabled, FileEdit, FileName, FileType, Font, Handle, Height, HelpContext, HelpKeyword,
HelpTypeHint, IntegralHeight, ItemHeight, ItemIndex, Items, Left, Mask, MultiSelect, Name, Owner,
Parent, ParentColor, ParentCtrl3D, ParentFont, ParentShowHint, PopupMenu, Selected, ShowGlyphs,
ShowHint, Showing, TabOrder, TabStop, Tag, Top, TopIndex, Visible e Width
Principais Mtodos
GetTextLen, Hide, Invalidate, ItemAtPos, ItemRect, Refresh, Repaint, ScaleBy, ScreenToClient,
ScrollBy, SendToBack, SetBounds, SetFocus, SetTextBuf, Show e Update
Principais Eventos
TFILTERCOMBOBOX
Descrio
O controle TFilterComboBox uma caixa combo especial que permite ao usurio selecionar filtros de arquivos.
Unit
Na VCL:
FileCtrls
Align, BoundsRect, Color, ComponentIndex, Ctrl3D, Cursor, DragCursor, DragMode, Enabled, FileList,
Filter, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, ItemIndex, Items, Left, Mask, Name,
Owner, Parent, ParentColor, ParentCtrl3D, ParentFont, SelLength, SelStart, Showing, TabOrder,
TabStop, Text, Tag, Top, Visible e Width
Principais Mtodos
Principais Eventos
OnChange, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnDropDown, OnEndDrag, OnEnter, OnExit,
OnKeyDown, OnKeyPress, OnKeyUp
TFINDDIALOG
Descrio
O controle TFindDialog fornece uma caixa de dilogo para pesquisa de texto.
Unit
Na VCL:
Dialogs
Na CLX:
QDialogs
ComponentIndex, Ctl3D, FindText, Handle, HelpContext, HelpKeyword, HelpTypeName, Options, Owner,
Position e Tag
Principais Mtodos
CloseDialog e Execute
Principais Eventos
OnFind
TFLOATFIELD
Descrio
nmero no formato de ponto flutuante.
Unit
Na VCL e na CLX:
DB
Align, AsBoolean, AsDateTime, AsFloat, AsInteger, AsString, Calculated, CanModify, Currency,
DataSet, DataSize, DataType, DisplayFormat, DisplayLabel, DisplayName, DisplayText, DisplayWisth,
EditFormat, EditMask, EditMaskPtr, FieldName, FieldNo, Index, IsIndexField, IsNull, MaxValue,
Principais Mtodos
Principais Eventos
TFONT
Descrio
Esse objeto armazena um tipo de fonte.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Color, Handle, Height, Name, Pitch, PixelsPerInch, Size e Style
Principais Mtodos
Assign, Create, Destroy e Free
Principais Eventos
OnChange
TFONTDIALOG
Descrio
O controle TFontDialog fornece uma caixa de dilogo para a seleo de fontes.
Unit
Na VCL:
Dialogs
Na CLX:
QDialogs
ComponentIndex, Ctl3D, Device, Font, HelpContext, HelpKeyword, HelpTypeMaxFontSize, MinFontSize,
Name, Options, Owner e Tag
Principais Mtodos
Execute
Principais Eventos
OnApply
TFORM
Descrio
O TForm o principal componente de uma aplicao desenvolvida em Delphi, pois nele que so
inseridos os demais controles. Um controle do tipo TForm pode ser usado como uma janela, uma caixa
de dilogo ou qualquer tipo de formulrio para entrada de dados.
Unit
Na VCL:
Forms
Na CLX:
QForms
Active, ActiveControl, ActiveMDIChild, Align, AutoScroll, BorderIcons, BorderStyle, Brush, Caption,
Canvas, ClientHandle, ClientHeight, ClientOrigin, ClientRect, ClientWidth, Color, ComponentCount,
ComponentIndex, Components, Controls, Ctrl3D, Cursor, DockClientCount, DockClients, Enabled, Font,
FormStyle, Handle, Height, HelpContext, HelpFile, HelpKeyword, HelpTypeHint, HorzScrollBar, Icon,
KeyPreview, Left, MDIChildCount, MDIChildren, Menu, ModalResult, Name, Owner, Parent, PixelsPerInch,
PopupMenu, Position, PrintScale, Scaled, ShowHint, TabOrder, TabStop, Tag, TileMode, Top,
VertScrollBar, Visible, Width, WindowMenu e WindowState
Principais Mtodos
ArrangeIcons, BringToFront, CanFocus, Cascade, ClientToScreen, Close, CloseQuery, ContainsControl,
Create, CreateNew, Destroy, Dragging, FindComponent, Focused, Free, GetFormImage, GetTextBuf,
GetTextLen, HandleAllocated, HandleNeeded, Hide, InsertComponent, InsertControl, Invalidate, Next,
Previous, Print, Refresh, Release, RemoveComponent, Repaint, ScaleBy, ScreenToClient, ScrollBy,
ScrolllnView, SendToBack, SetBounds, SetFocus, SetTextBuf, Show, ShowModal, Tile e Update
Principais Eventos
OnActivate, OnClick, OnClose, OnCloseQuery, OnCreate, OnDestroy, OnDblClick, OnDeactivate,
OnDragDrop, OnDragOver, OnEnter, OnExit, OnKeyDown, OnKeyDown, OnKeyPress, OnKeyUp, OnMouseDown,
OnMouseMove, OnMouseUp, OnPaint, OnResize e OnShow
TGRAPHIC
Descrio
Esse objeto representa a classe da qual so derivados os objetos TBitmap, TIcon e
TMetafile.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Height, Empty e Width
Principais Mtodos
ClassName, ClassParent, ClassType, Create, Destroy, Free, LoadFromFile e SaveToFile
Principais Eventos
OnChange
TGRAPHICFIELD
Descrio
Esse componente representa um campo de um registro de um banco de dados que armazena uma
informao grfica em um conjunto arbitrrio de bytes cujo tamanho no predefinido.
Unit
Na VCL e na CLX:
DB
Align, AsBoolean, AsDateTime, AsFloat, AsInteger, AsString, Calculated, CanModify, DataSet, DataSize,
DataType, DisplayLabel, DisplayName, DisplayText, DisplayWisth, EditMask, EditMaskPtr, FieldName,
FieldNo, Index, IsIndexField, IsNull, Name, Owner, ReadOnly, Required, Size, Tag, Text e Visible
Principais Mtodos
Principais Eventos
TGROUPBOX
Descrio
O controle TGroupBox permite agrupar componentes que se relacionam, como botes de rdio, por
exemplo.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, Caption, Color, Controls, Ctl3D, Cursor, DragCursor, DragMode, Enabled, Font, Height,
HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Owner, Parent, ParentColor, ParentCtl3D,
ParentFont, PopupMenu, Showing, TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, ClientToScreen, ContainsControl, Dragging, EndDrag, Focused,
SendToBack, SetBounds, SetFocus e SetTextBuf
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnMouseDown, OnMouseMove e
OnMouseUp
THEADER
Descrio
O controle THeader um controle que exibe texto em sees redimensionveis com o mouse.
Unit
Na VCL:
ExtCtrls
Na CLX:
QExtCtrls
Align, AllowResize, BoundsRect, BorderStyle, ComponentIndex, Cursor, Enabled, Font, Height,
HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Owner, Parent, ParentFont, ParentShowHint,
Sections, SectionWidth, ShowHint, Showing, TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
SetBounds, SetFocus, SetTextBuf, Show e Update
Principais Eventos
OnEnter, OnExit, OnSized e OnSizing
THEADERCONTROL
Descrio
Esse controle semelhante ao controle THeader e exibe texto em sees redimensionveis com o
mouse.
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
Align, BoundsRect, Brush, ClientHeight, ClientOrigin, ClentRect, ClientWidth, ComponentCount,
ComponentIndex, Components, ControlCount, Controls, Cursor, DragCursor, DragMode, Enabled, Font,
Handle, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Owner, Parent, ParentFont,
ParentShowHint, PopupMenu, Sections, ShowHint, Showing, Tag, Top, Visible e Width
Principais Mtodos
ContainsControl, ControlAtPos, Create, Destroy, DragDrop, Dragging, EndDrag, FindComponent, Focused,
Free, GetTextBuf, GetTextLen, HandleAllocated, HandleNeeded, Hide, InsertComponent, InsertControl,
Invalidate, Refresh, RemoveComponent, RemoveControl, Repaint, ScaleBy, ScreenToClient, ScrollBy,
Principais Eventos
OnDragDrop, OnDragOver, OnEndDrag, OnMouseDown, OnMouseMove, OnMouseUp, OnDrawSection, OnResize,
OnSectionClick, OnSectionResize, OnSectionTrack e OnStartDrag
THOTKEY
Descrio
O controle THotKey usado para criar teclas aceleradoras durante a execuo do aplicativo.
Normalmente est associado a outro controle, ao qual se refere a tecla aceleradora.
Unit
Na VCL:
ComCtrls
Align, AutoSize, BoundsRect, Brush, ClientHeight, ClientOrigin, ClientRect, ClientWidth, ComponentCount,
ComponentIndex, Components, ControlCount, Controls, Cursor, Enabled, Handle, Height, HelpContext,
HelpKeyword, HelpTypeHotKey, InvalidKeys, Left, Modifiers, Name, Owner, Parent, ShowHint, Showing,
Principais Mtodos
Free, GetAssigned, GetTextBuf, GetTextLen, HandleAllocated, HandleNeeded, Hide, InsertComponent,
InsertControl, Invalidate, Refresh, RemoveComponent, RemoveControl, Repaint, ScaleBy,
Principais Eventos
OnEnter, OnExit, OnMouseDown, OnMouseMove e OnMouseUp
TIBCLIENTDATASET
Descrio
Este componente pode ser considerado como uma reunio de trs componentes: um IBDataSet, um
DatasetProvider e um ClientDataset.
Unit
Na VCL:
IBCuistomDataset
Active, ActiveAggs, AggFields, Aggregates, AggregatesActive, Appserver, AutoCalcFields,
BlockReadSize, Bof, Bookmark, CanModify, ChangeCount, CloneSource, CommandText, ComObject,
ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, Constraints, Data,
DataSetField, DataSize, DataSource, DBConnection, DBTransaction, DefaultFields, Delta, Designer,
DesignInfo, DisableStringTrim, Eof, FetchOnDemand, FieldCound, FieldDefList, FieldDefs, FieldList,
Fields, FieldValues, FileName, Filter, Filtered, FilterOptions, Found, GroupingLevel, HasAppServer,
IndexDefs, IndexFieldCount, IndexFieldNames, IndexFields, IndexName, IsUnidirecional, KeyExclusive,
KeyFieldCount, KeySize, LogChanges, MasterFields, MasterSource, Modified, Name, ObjectView, Options,
Owner, PacketRecords, Params, ReadOnly, RecNo, RecordCount, RecordSize, SparseArrays, State,
StatusFilter, Tag, UpdateMode, VCLComObject e XMLData.
Principais Mtodos
ActiveBuffer, AddIndex, AfterConstruction, Append, AppendData, AppendRecord, ApplyRange,
ApplyUpdates, Assign, BookmarkValid, Cancel, CancelRange, CancelUpdates, CheckBrowseMode, ClassInfo,
ClassName, ClassNameIs, ClassParent, ClassType, ClenupInstance, ClearFields, CloneCursor, Close,
CompareBookmarks, ConstraintsDisabled, ControlsDisabled, Create, CreateBlobStream, CreateDataSet,
CursorPosChanged, DataRequest, DefaultHandler, Delete, DeleteIndex, Destroy, DestroyComponents,
Destroying, DisableConstraints, DisableControls, Dispatch, Edit, EditKey, EditRangeEnd,
EditRangeStar, EmptyDataSet, EnableConstraints, EnableControls, Execute, ExecuteAction, FetchBlobs,
FetchDetails, FetchParams, FieldAddress, FieldByName, FindComponent, FindField, FindFirst, FindKey,
FindLast, FindNearest, FindNext, FindPrior, First, Free, FreeBookmarl, FreeInstance,
FreeNotification, FreeOnRelease, GetBlobFieldData, GetBookmark, GetCurrentRecord, GetDetailDatasets,
GetDetailLinkFields, GetFieldData, GetFieldList, GetFieldNames, GetGroupState, GetIndexInfo,
GetIndexNames, GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetNextPacket,
GetOptionalParam, GetParentComponent, GetQuoteChar, GotoBookmark, GotoCurrent, GotoKey, GotoNearest,
HasParent, InheritsFrom, InitInstance, Insert, InsertComponent, InsertRecord, InstanceSize, IsEmpty,
IsImplementorOf, IsLinkedTo, IsSequenced, Last, LoadFromFile, LoadFromStream, Locate, Lookup,
MergeChangeLog, MethodAddress, MethodName, MoveBy, NewInstance, Next, Open, Post, Prior, Reconcile,
ReferenceInterface, Refresh, RefreshRecord, RemoveComponent, RemoveFreeNotification, Resync,
RevertRecord, SaveCallException, SaveToFile, SaveToStream, SetAltRecBuffers, SetFields, SetKey,
SetOptionalParam, SetProvider, SetRange, SetRangeEnd, SetRangeStart, SetSubCompnent, Translate,
UndoLastChange, UpdateAction, pdateCursorPos, UpdateRecord e UpdateStatus
Principais Eventos
AfterApplyUpdates, AfterCancel, AfterClose, AfterDelete, AfterEdit, AfterExecute, AfterGetParams,
AfterGetRecords, AfterInsert, AfterOpen, AfterPost, AfterRefresh, AfterRowRequest, AfterScroll,
AfterUpdateRecord, BeforeApplyUpdates, BeforeCancel, BeforeClose, BeforeDelete, BeforeEdit,
BeforeExecute, BeforeGetParams, BeforeGetRecords, BeforeInsert, BeforeOpen, BeforePost,
BeforeRefresh, BeforeRowRequest, BeforeScroll, BeforeUpdateRecord, OnCalcFields, OnDeleteError,
OnEditError, OnFilterRecord, OnGetTableName, OnNewRecord, OnPostError, OnReconcileError,
OnUpdateData e OnUpdateError
TIBDATABASE
Descrio
Este componente encapsula uma conexo a um banco de dados do Interbase, atravs do Mecanismo
Interbase Express
Unit
Na VCL:
IBDatabase
ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, Connected,
DatabaseName, DatasetCount, DataSets, DBParamByDPB, DBSQLDialect, DefaultTransaction, DesignInfo,
Handle, HandleIsShared, IdleTimer, IsReadOnly, LoginPrompt, Name, Owner, Params, SQLDialect,
SQLObjectCount, SQLObjects, Tag, Temporary, TraceFlags, TransactionCount, Transactions, VCLComObject
Principais Mtodos
AfterConstruction, ApplyUpdates, Assign, BeforeDestruction, ClassInfo, ClassName, ClassNameIs,
ClassParent, ClassType, CleanupInstance, Close, CloseDataSets, Commit, Create, DefaultHandler,
Destroy, DestroyComponents, Destroying, Dispatch, Execute, ExecuteAction, FieldAddress,
FindComponent, FlushSchemaCache, Free, FreeInstance, FreeNotification, FreeOnRelease, GetInterface,
GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, HasParent, InheritsFrom,
InitInstance, InsertComponent, InstanceSize, MethodAddress, MethodName, NewInstance, Open,
RemoveComponent, Rollback, SafeCallException, StartTransaction, UpdateAction, ValidateName
Principais Eventos
AfterConnect, AfterDisconnect, BeforeConnect, BeforeDisconnect, OnDialectDowngradeWarnin,
OnIdleTimer, OnLogin
TIBDATABASEINFO
Descrio
Este componente Fornece Informaes sobre um banco de dados do Interbase, atravs do Mecanismo
Interbase Express
Unit
Na VCL:
IBDatabaseInfo
Allocation, BackoutCount, BaseLevel, ComObject, ComponentCount, ComponentIndex, Components,
ComponentState, ComponentStyle, CurrentMemory, Database, DBFileName, DBImplementationClass,
DBImplementationNo, DBSiteName, DBSQLDialect, DeleteCount, DesignInfo, ExpungeCount, Fetches,
ForcedWrites, InsertCount, Marks, MaxMemory, Name, NoReserve, NumBuffers, ODSMajorVersion,
ODSMinorVersion, Owner, PageSize, PurgeCount, ReadIdxCount, ReadOnly, Reads, ReadSeqCount,
SweepInterval, Tag, UpdateCount, UserNames, VCLComObject, Version, Writes
Principais Mtodos
AfterConstruction, Assign, BeforeDestruction, Call, ClassInfo, ClassName, ClassNameIs, ClassParent,
ClassType, CleanupInstance, Create, DefaultHandler, Destroy, DestroyComponents, Destroying,
Dispatch, ExecuteAction, FieldAddress, FindComponent, Free, FreeInstance, FreeNotification,
FreeOnRelease, GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent,
HasParent, InheritsFrom, InitInstance, InsertComponent, InstanceSize, MethodAddress, MethodName,
NewInstance, RemoveComponent, SafeCallException, UpdateAction
Principais Eventos
Este componente no possui eventos associados.
TIBDATASET
Descrio
Este componente Permite que se executem comandos sql diretamente em um banco de dados do
Interbase, atravs do Mecanismo Interbase Express.
Unit
Na VCL:
IBCustomDataset
Active, AggFields, AutoCalcFields, Bof, Bookmark, BufferChunks, CachedUpdates, ComObject,
ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, Database, DatasetField,
DataSource, DBHandle, DefaultFields, DeleteSQL, Designer, DesignInfo, Eof, FieldCount, FieldDefList,
FieldDefs, FieldList, Fields, FieldValues, Found, InsertSQL, Modified, ModifySQL, Name, ObjectView,
Owner, Params, Prepared, Qdelete, Qinsert, Qmodify, Qrefresh, Qselect, RecordCount, RefreshSQL,
SelectSQL, SparseArrays, State, StatementType, Tag, Transaction, TRHandle, UpdateObject,
UpdateRecordTypes, UpdatesPending, VCLComObject
Principais Mtodos
ActiveBuffer, AfterConstruction, Append, AppendRecord, ApplyUpdates, Assign, BeforeDestruction,
CachedUpdateStatus, CancelUpdates, CheckBrowseMode, ClassInfo, ClassName, ClassNameIs, ClassParent,
ClassType, CleanupInstance, ClearFields, Close, CompareBookmarks, ControlsDisabled, Create,
CreateBlobStream, CursorPosChanged, DefaultHandler, Delete, Destroy, DestroyComponents, Destroying,
DisableControls, Dispatch, Edit, EnableControls, ExecuteAction, FetchAll, FieldAddress, FieldByName,
FindComponent, FindField, FindFirst, FindLast, FindNext, FindPrior, First, Free, FreeBookmark,
FreeInstance, FreeNotification, FreeOnRelease, GetBookmark, GetCurrentRecord, GetDetailDataSets,
GetDetailLinkFields, GetFieldData, GetFieldList, GetFieldNames, GetInterface, GetInterfaceEntry,
GetInterfaceTable, GetNamePath, GetParentComponent, GetProviderAttributes, GotoBookmark, HasParent,
InheritsFrom, InitInstance, Insert, InsertComponent, InsertRecord, InstanceSize, IsEmpty, IsLinkedTo,
Last, Locate, LocateNext, Lookup, MethodAddress, MethodName, MoveBy, NewInstance, Next, Open, Post,
Prepare, Prior, RecordModified, Refresh, RemoveComponent, Resync, RevertRecord, SafeCallException,
SetFields, Translate, Undelete, UnPrepare, UpdateAction, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
AfterScroll, BeforeCancel, BeforeClose, BeforeDelete, BeforeEdit, BeforeInsert, BeforeOpen, BeforePost,
BeforeRefresh, BeforeScroll, DatabaseDisconnected, DatabaseDisconnecting, DatabaseFree, OnCalcFields,
OnDeleteError, OnEditError, OnEditError, OnFilterRecord, OnPostError, OnUpdateError, OnUpdateRecord,
TIBEVENTS
Descrio
Este componente Permite a uma aplicao responder a eventos enviados pelo servidor de banco de
dados do Interbase, atravs do Mecanismo Interbase Express.
Unit
Na VCL:
IBEvents
ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, Databases,
DesignInfo, Events, Name, Owner, Queued, Registered, Tag, VCLComObject
Principais Mtodos
AfterConstruction, Assign, BeforeDestruction, CancelEvents, ClassInfo, ClassName, ClassNameIs,
ClassParent, ClassType, CleanupInstance, Create, DefaultHandlerm Destroy, DestroyComponents, Destroying,
Dispatch, ExecuteAction, FieldAddress FindComponent, Free, FreeInstance, FreeNotification, FreeOnRelease,
GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, HasParent,
QueEvents, RegisterEvents, RemoveComponent, SafeCallException, UnregisterEvents, UpdateAction
Principais Eventos
OnEventAlert
TIBQUERY
Descrio
Este componente permite acesso via declaraes SQL a tabelas de bancos de dados do interbase atravs
do Mecanismo Interbase Express.
Unit
Na VCL:
IBQuery
Active, AggFields, AutoCalcFields, BlockReadSize, Bof, Bookmark,
CachedUpdates, ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle,
Constraints, Database, DataSetField, DBHandle, DefaultFields, Designer, DesignInfo, Eof, FieldCount,
FieldDefList, FieldDefs, FieldList, Fields, FieldValues, FilterOptions, Found, GenerateParamNames,
Modified, Name, ObjectView, Owner, ParamCheck, ParamCount, Params, Prepared, RecNo, RecordCount,
RecordSize, RowsAffected, SparseArrays, SQL, State, StmtHandle, TableTypes, Tag, Text, Transaction,
TRHandle, Unidirecional, UpdateObject, UpdateRecordTypes, UpdatesPending, VCLComObject
Principais Mtodos
BookmarkValid, Cancel, CancelUpdates, CheckBrowseMode, ClassInfo, ClassName, ClassNameIs,
ClassParent, ClassType, CleanupInstance, ClearFields, Close, CompareBookmarks, ControlsDisabled,
Create, CreateBlobStream, CursorPosChanged, DefaultHandler, Delete, Destroy, DestroyComponents,
Destroying, DisableControls, Dispatch, Edit, EnableControls, ExecSQL, ExecuteAction, FetchAll,
FieldAddress, FieldByName, FindComponent, FindField, FindFirst, FindLast, FindNext, FindPrior,
GetProviderAttributes, GotoBookmark, HasParent, InheritsFrom, InitInstance, Insert, InsertComponent,
InsertRecord, InstanceSize, IsEmpty, IsLinkedTo, IsSequenced, Last, Locate, Lookup, MethodAddress,
MethodName, MoveBy, NewInstance, Next, Open, ParamByName, Post, Prepare, Prior, Refresh,
RemoveComponent, Resync, RevertRecord, SafeCallException, SetFields, Translate, Unprepare,
UpdateAction, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
BeforePost, BeforeRefresh, BeforeScroll, OnCalcFields, OnDeleteError, OnEditError, OnNewRecord,
OnPostError, OnUpdateError, OnUpdateRecord
TIBSQL
Descrio
Este componente Permite que se executem comandos sql Unidirecionais sem overhead diretamente
em um banco de dados do Interbase, atravs do Mecanismo Interbase Express.
Unit
Na VCL:
IBSQL
Bof, ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, Database,
DBHandle, DesignInfo, Eof, FieldIndex, Fields, GenerateParamNames, GoToFirstRecordOnExecute, Handle,
Name, Open, Owner, ParamCheck, Params, Plan, Prepared, RecordCount, RowsAffected, SQL, SQLType, Tag,
Transaction, TRHandle, UniqueRelationName, VCLComObject
Principais Mtodos
AfterConstruction, Assign, BatchInput, BatchOutput, BeforeDestruction, Call, CheckClosed, CheckOpen,
CheckValidStatement, ClassInfo, ClassName, ClassNameIs, ClassParent, ClassType, CleanupInstance, Close,
Create, Current, DefaultHandler Destroym, DestroyComponents, Destroying, Dispatch, ExecQuery,
ExecuteAction, FieldAddress, FieldByName, FindComponent, Free, FreeHandle, FreeInstance,
GetParentComponent, HasParent, InheritsFrom, InitInstance, InsertComponent, InstanceSize, MethodAddress,
MethodName, NewInstance, Next, Prepare, RemoveComponent, SafeCallException, UpdateAction
Principais Eventos
OnSQLChanging
TIBSQLMONITOR
Descrio
Este componente Permite o monitoramento de comandos SQl enviados para serem executados no
servidor de um banco de dados do Interbase, atravs do Mecanismo Interbase Express.
Unit
Na VCL:
IBSQLMonitor
Name, Owner, Tag, VCLComObject
Principais Mtodos
AfterConstruction, Assign, BeforeDestruction, ClassInfo, ClassName, ClassNameIs, ClassParent,
ClassType, CleanupInstance, Create, DefaultHandlerm Destroy, DestroyComponents, Destroying,
Dispatch, ExecuteAction, FieldAddress FindComponent, Free, FreeInstance, FreeNotification,
NewInstance, RemoveComponent, SafeCallException, UpdateAction
Principais Eventos
OnSQL
TIBSTOREDPROC
Descrio
Este componente permite acesso via declaraes SQL a tabelas de bancos de dados do interbase atravs
do Mecanismo Interbase Express.
Unit
Na VCL:
IBStoredProc
Active, AggFields, AutoCalcFields, BlockReadSize, Bof, Bookmark,
CachedUpdates, ComObject, ComponentCount, ComponentIndex, Components, ComponentState,
ComponentStyle, Constraints, Database, DataSetField, DBHandle, DefaultFields, Designer, DesignInfo,
Eof, FieldCount, FieldDefList, FieldDefs, FieldList, Fields, FieldValues, FilterOptions, Found,
Modified, Name, NameList, ObjectView, Owner, ParamCount, Params, Prepared, RecNo, RecordCount,
RecordSize, SparseArrays, State, StmtHandle, StoredProcName, TableTypes, Tag, Transaction, TRHandle,
UpdateRecordTypes, UpdatesPending, VCLComObject
Principais Mtodos
BookmarkValid, Cancel, CancelUpdates, CheckBrowseMode, ClassInfo, ClassName, ClassNameIs,
ClassParent, ClassType, CleanupInstance, ClearFields, Close, CompareBookmarks, ControlsDisabled,
Create, CreateBlobStream, CursorPosChanged, DefaultHandler, Delete, Destroy, DestroyComponents,
Destroying, DisableControls, Dispatch, Edit, EnableControls, ExecProc, ExecuteAction, FetchAll,
FieldAddress, FieldByName, FindComponent, FindField, FindFirst, FindLast, FindNext, FindPrior,
GetProviderAttributes, GotoBookmark, HasParent, InheritsFrom, InitInstance, Insert, InsertComponent,
InsertRecord, InstanceSize, IsEmpty, IsLinkedTo, IsSequenced, Last, Locate, Lookup, MethodAddress,
MethodName, MoveBy, NewInstance, Next, Open, ParamByName, Post, Prepare, Prior, Refresh,
RemoveComponent, Resync, RevertRecord, SafeCallException, SetFields, Translate, Unprepare,
UpdateAction, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
TIBTABLE
Descrio
Este componente permite acesso direto a tabelas de bancos de dados atravs do Mecanismo Interbase
Express.
Unit
Na VCL:
IBTable
Active, AggFields, AutoCalcFields, BlockReadSize, Bof, Bookmark, BufferChunks, CachedUpdates,
ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, Constraints,
CurrentDBKey, Database, DataSetField, DBHandle, DefaultFields, DefaultIndex, Designer, DesignInfo,
Eof, Exists, FieldCount, FieldDefList, FieldDefs, FieldList, Fields, FieldValues, Filter, Filtered,
FilterOptions, Found, IndexDefs, IndexFieldCount, IndexFieldNames, IndexFields, IndexName,
MasterFields, MasterSource, Modified, Name, ObjectView, Owner, ReadOnly, RecNo, RecordCount,
RecordSize, SparseArrays, State, StoreDefs, TableName, TableNames, TableTypes, Tag, Transaction,
TRHandle, UniDirectional, UpdateObject, UpdateRecordTypes, UpdatesPending, VCLComObject
Principais Mtodos
ActiveBuffer, AddIndex, AfterConstruction, Append, AppendRecord, ApplyUpdates, Assign,
BeforeDestruction, BookmarkValid, Cancel, CancelUpdates, CheckBrowseMode, ClassInfo, ClassName,
ClassNameIs, ClassParent, ClassType, CleanupInstance, ClearFields, Close, CompareBookmarks,
ControlsDisabled, Create, CreateBlobStream, CreateTable, CursorPosChanged, DefaultHandler, Delete,
DeleteIndex, DeleteTable, Destroy, DestroyComponents, Destroying, DisableControls, Dispatch, Edit,
EmptyTable, EnableControls, ExecuteAction, FetchAll, FieldAddress, FieldByName, FindComponent,
FreeNotification, FreeOnRelease, GetBlobFieldData, GetBookmark, GetCurrentRecord, GetDetailDataSets,
GetDetailLinkFields, GetFieldData, GetFieldList, GetFieldNames, GetIndexNames, GetInterface,
GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, GetProviderAttributes,
GotoBookmark, GotoCurrent, HasParent, InheritsFrom, InitInstance, Insert, InsertComponent, InsertRecord,
InstanceSize, IsEmpty, IsLinkedTo, IsSequenced, Last, Locate, Lookup, MethodAddress, MethodName, MoveBy,
NewInstance, Next, Open, Post, Prior, Refresh, RemoveComponent, Resync, RevertRecord, SafeCallException,
SetFields, Translate, UpdateAction, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
T IBTRANSACTION
Descrio
Este componente fornece controle discreto de transaes para uma ou mais conexes a um banco de
dados do Interbase, atravs do Mecanismo Interbase Express
Unit
Na VCL:
IBDatabase
Active, ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle,
DatabaseCount, Databases, DefaultAction, DefaultDatabase, DesignInfo, Handle, HandleIsShared,
IdleTimer, InTransaction, Name, Owner, Params, SQLObjectCount, SQLObjects, Tag, TPB, TPBLength,
VCLComObject
Principais Mtodos
AddDatabase, AfterConstruction, Assign, BeforeDestruction, Call, CheckDatabasesInList, CheckInTransaction,
CheckNotInTransaction, ClassInfo, ClassName, ClassNameIs, ClassParent, ClassType, CleanupInstance, Commit,
CommitRetaining, Create, DefaultHandler, Destroy, DestroyComponents, Destroying, Dispatch, ExecuteAction,
FieldAddress, FindComponent, FindDatabase, Free, FreeInstance, FreeNotification, FreeOnRelease,
GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, HasParent,
RemoveComponent, RemoveDatabase, RemoveDatabases, Rollback, RollbackRetaining, SafeCallException,
StartTransaction, UpdateAction
Principais Eventos
OnIdleTimer
TIBUPDATESQL
Descrio
O componente TUpdateSQL fornece um meio alternativo de se atualizar bancos de dados, atravs do
mecanismo Interbase Express, armazenando um comando para cada tipo de declarao SQL.
Unit
Na VCL:
IBUPdateSQL
ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, DataSet,
DeleteSQL, DesignInfo, InsertSQL, ModifySQL, Name, Owner, Query, RefreshSQL, SQL, Tag, VCLComObject
Principais Mtodos
AfterConstruction, Apply, Assign, BeforeDestruction, ClassInfo, ClassName, ClassNameIs, ClassParent,
Dispatch, ExecSQL, ExecuteAction, FieldAddress, FindComponent, Free, FreeInstance, FreeNotification,
NewInstance, RemoveComponent, SafeCallException, SetParams, UpdateAction
Principais Eventos
TICON
Descrio
Esse objeto representa um cone (arquivo no formato *.ICO).
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Handle, Height, Empty e Width
Principais Mtodos
Assign, ClassName, ClassParent, ClassType, Create, Destroy, Free, LoadFromFile e
SaveToFile
Principais Eventos
OnChange
TIMAGE
Descrio
Esse componente exibe uma imagem em um formulrio.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, AutoSize, BoundsRect, BorderStyle, Center, ComponentIndex, Cursor, DragCursor, DragMode,
Enabled, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Owner, Parent, ParentShowHint,
Picture, PopupMenu, ShowHint, Showing, Stretch, TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, ClientToScreen, Dragging, EndDrag, Focused, Hide, Invalidate, Refresh,
Repaint, ScaleBy, ScreenToClient, SendToBack, SetBounds, Show e Update
Principais Eventos
OnKeyUp, OnMouseDown, OnMouseMove, OnMouseUp
TIMAGELIST
Descrio
Esse controle usado como um continer para imagens grficas, sendo capaz de armazenar um grande
nmero de imagens de mesmo tamanho.
Unit
Na VCL:
Controls
Na CLX:
QImgList
AllocBy, BkColor, BlendColor, ComponentIndex, Count, DragCursor, Dragging, DrawingStyle, Enabled,
Handle, Height, ImageType, Masked, Name, Owner, ShareImages, Tag e Width
Principais Mtodos
Add, AddIcon, AddMasked, Assign, BeginDrag, Clear, Create, CreateSize, Delete, Destroy, DragLock,
DragMode, DragUnLock, Draw, DrawOverlay, EndDrag, FileLoad, Free, GetBitmap, GetHotSpot, GetIcon,
GetImageBitmap, GetMaskBitmap, GetResource, HandleAllocated, HideDragImage, Insert, InsertIcon,
InsertMasked, Move, Overlay, RegisterChanges, Replace, ReplaceIcon, ReplaceMasked, ResourceLoad,
SetDragImage, ShowDragImage e UnRegisterChanges
Principais Eventos
OnChange
TINIFILE
Descrio
Esse objeto permite que sua aplicao realize operaes de leitura e gravao em arquivos com extenso .INI.
Unit
Na VCL e na CLX:
IniFiles
Esse objeto no possui propriedades associadas.
Principais Mtodos
ClassName, ClassParent, ClassType, Create, Destroy, EraseSection, FileName, Free, ReadBool,
ReadInteger, ReadSection, ReadSectionValues, ReadString, WriteBool, WriteInteger e WriteString
Principais Eventos
TINTEGERFIELD
Descrio
nmero no formato inteiro, variando de -2,147,483,648 a 2,147,483,647.
Unit
Na VCL e na CLX:
DB
Principais Mtodos
Principais Eventos
THTTPFILE
Unit
Na VCL e na CLX:
IWFileParser
Descrio
Realiza o Parser para a gerao da resposta HTML.
Propriedades
Esta classe no possui propriedades associadas.
Mtodos
Create, Destroy
Eventos
Esta classe no possui eventos associados.
TIWAPPFORM
Unit
Na VCL e na CLX:
IWAppForm
Descrio
Esta classe representa um formulrio em uma aplicao Intraweb.
Propriedades
ActiveControl, Background, BackgroundColor, DataSetList, ExtraHeader, FormAction, HandleTabs,
HiddenParams, JavaScript, JavaScriptOnce, LinkColor, Params, Released, ScriptFiles, ShowHint, StyleSheet,
SupportedBrowsers, TabOrderList, TemplateProcessor, TextColor, Title, VLinkColor, WebApplication
Mtodos
AddScriptFile, AddToControlList, AddToInitProc, AddToIWCLInitProc, AddValidation, CacheImage,
Create, CreateNew, Destroy, DoDefaultAction, DoPreview, ExecuteForm, FixupTabList, GenerateForm,
Hide, Release, RenderControl, Show
Eventos
OnAfterRender, OnCreate, OnDefaultAction, OnDestroy, OnRender
TIWAPPLET
Unit
Na VCL e na CLX:
IWApplet
Descrio
Este componente permite executar uma applet em uma aplicao Intraweb.
Propriedades
Align, Alignment, AltText, Anchors, AppletName, Archive, Canvas, Caption, ClassFile, CodeBase, Clip,
Color, ControlEncode, DesignMode, ExtraTagParams, Font, Form, FriendlyName, HorizSpace, HTML,
HTMLLeft, HTMLName, HTMLTop, InitProcCode, IWCLInitProc, JavaScriptOnce, Params, ParentShowHint,
RenderSize, ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, Text, UseFrame, VertSpace,
Visible, WebApplication, ZIndex
Mtodos
AddScriptFile, AddToInitProc, AddToIWCLInitProc, AddToJavaScriptOnce, Clear, ColorToRGBString,
Create, Destroy, DoSubmit, HTMLColor, Invalidate, MakeHTMLTag, PaintTo, RenderCSSClass, RenderHTML,
RenderScripts, RenderStyle, SetLayoutMgr, SetRenderData, SupportsSubmit, ToJPEGFile
Eventos
OnHTMLTag
TIWAPPLICATION
Unit
Na VCL e na CLX:
IWApplication
Descrio
Esta classe representa uma aplicao Intraweb.
Propriedades
ActiveForm, AppID, AuthUser, Browser, Data, FileList, FormAction, FormCount, Forms, IP, LastAccess,
ReferringURL, Request, Response, RunParams, Terminated, TerminateMessage, TerminateURL, TrackID, URLBase
Mtodos
AddDataModule, Create, Destroy, ExecuteActiveForm, GenerateActiveForm, Initialize, MarkAccess,
RemoveDataModule, RemoveForm, SendFile, SendStream, SetActiveForm, ShowMessage, Terminate,
TerminateAndRedirect
Eventos
TIWBUTTON
Unit
Na VCL e na CLX:
IWCompButton
Descrio
Verso Intraweb do componente Button.
Propriedades
Align, Anchors, ButtonType, Canvas, Caption, Clip, Color, Confirmation, ControlEncode, DesignMode,
DoSubmitValidation, Enabled, ExtraTagParams, Font, Form, FriendlyName, HotKey, HTML, HTMLLeft,
HTMLName, HTMLTop, InitProcCode, IWCLInitProc, JavaScriptOnce, ParentShowHint, RenderSize,
ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, TabOrder, Text, UseFrame, Visible,
WebApplication, ZIndex
Mtodos
Eventos
OnClick, OnHTMLTag
TIWCHECKBOX
Unit
Na VCL e na CLX:
IWCompCheckBox
Descrio
Verso Intraweb do componente CheckBox.
Propriedades
Align, Anchors, Canvas, Caption, Checked, Clip, Color, ControlEncode, DesignMode,
DoSubmitValidation, Editable, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName,
HTMLTop, InitProcCode, IWCLInitProc, JavaScriptOnce, ParentShowHint, RenderSize, ScriptEvents,
ScriptFiles, ShowHint, Style, SupportedScriptEvents, TabOrder, Text, UseFrame, Visible,
Mtodos
Eventos
OnClick, OnHTMLTag
TIWCOMBOBOX
Unit
Na VCL e na CLX:
IWCompListbox.
Descrio
Verso Intraweb do componente ComboBox.
Propriedades
Align, Anchors, Canvas, Caption, Clip, Color, ControlEncode, DesignMode, ExtraTagParams, Font, Form,
FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, ItemIndex, Items, IWCLInitProc,
JavaScriptOnce, ParentShowHint, RenderSize, ScriptEvents, ScriptFiles, Selected, ShowHint, Sorted,
SupportedScriptEvents, Text, UseFrame, Visible, WebApplication, ZIndex
Mtodos
RenderScripts, RenderStyle, ResetSelection, SetLayoutMgr, SetRenderData, SupportsSubmit, ToJPEGFile
Eventos
OnChange, OnHTMLTag
TIWCONTROL
Unit
Na VCL e na CLX:
Descrio
Esta a classe-base da maioria dos controles e componentes Intraweb.
Propriedades
FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, IWCLInitProc, JavaScriptOnce,
ParentShowHint, RenderSize, ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, Text,
UseFrame, Visible, WebApplication, ZIndex
Mtodos
Eventos
OnHTMLTag
TIWDBCHECKBOX
Unit
Na VCL e na CLX:
IWDBStdCtrls
Descrio
Verso Intraweb do componente DBCheckBox.
Propriedades
Align, Anchors, Canvas, Caption, Checked, Clip, Color, ControlEncode, DataField,
Datasource,DesignMode, DoSubmitValidation, Editable, ExtraTagParams, Font, Form, FriendlyName, HTML,
HTMLLeft, HTMLName, HTMLTop, InitProcCode, IWCLInitProc, JavaScriptOnce, ParentShowHint, RenderSize,
ScriptEvents, ScriptFiles, ShowHint, Style, SupportedScriptEvents, TabOrder, Text, UseFrame,
Visible, WebApplication, ZIndex
Mtodos
Eventos
OnClick, OnHTMLTag
TIWDBCOMBOBOX
Unit
Na VCL e na CLX:
IWDBStdCtrls
Descrio
Verso Intraweb do componente DBComboBox.
Propriedades
Align, Anchors, Canvas, Caption, Clip, Color, ControlEncode, DataField, Datasource, DesignMode,
ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode,
ItemIndex, Items, IWCLInitProc, JavaScriptOnce, ParentShowHint, RenderSize, ScriptEvents,
ScriptFiles, Selected, ShowHint, Sorted, SupportedScriptEvents, Text, UseFrame, Visible,
Mtodos
Eventos
OnChange, OnHTMLTag
TIWDBEDIT
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Verso Intraweb do componente DBEdit.
Propriedades
Align, Anchors, BGColor, Canvas, Caption, Clip, Color, ControlEncode, DataField, Datasource,
DesignMode, DoSubmitValidation, Editable, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft,
HTMLName, HTMLTop, InitProcCode, IWCLInitProc, JavaScriptOnce, MaxLength, PasswordPrompt,
ParentShowHint, ReadOnly, RenderSize, Required, ScriptEvents, ScriptFiles, ShowHint,
Mtodos
Eventos
OnHTMLTag, OnSubmit
TIWDBFILE
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Permite armazenar um arquivo em um banco de dados.
Propriedades
Align, Anchors, AutoEditable, BGColor, Canvas, Caption, Clip, Color, ContentType, ControlEncode,
DataField, Datasource, DesignMode, DoSubmitValidation, Editable, ExtraTagParams, FileData,
FileName, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, IWCLInitProc,
JavaScriptOnce, MaxLength, ParentShowHint, ReadOnly, RenderSize, Required, ScriptEvents,
ScriptFiles, ShowHint, SupportedScriptEvents, TabOrder, Text, UseFrame, ValueChecked,
ValueUnchecked, Visible, WebApplication, ZIndex
Mtodos
AddScriptFile, AddToInitProc, AddToIWCLInitProc, AddToJavaScriptOnce, Clear, ColorToRGBString, Create,
Destroy, DoSubmit, HTMLColor, Invalidate, MakeHTMLTag, PaintTo, RenderCSSClass, RenderHTML, RenderScripts,
RenderStyle, SaveToFile, SaveToStream, SetLayoutMgr, SetRenderData, SupportsSubmit, ToJPEGFile
Eventos
OnHTMLTag, OnReceivedFile, OnSubmit
TIWDBGRID
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Verso Intraweb do componente DBGrid.
Propriedades
Align, Anchors, BGColor, BorderColors, BorderSize, Borderstyle, Canvas, Caption, Cell, CellPadding,
CellSpacing, Clip, Color, ColumnCount, Columns, ControlEncode, CurrentField, DataField, Datasource,
DesignMode, ExtraTagParams, Font, FooterRowCount, Form, FrameBuffer, FriendlyName, FromStart,
HighlightColor, HighlightRows, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, IWCLInitProc,
JavaScriptOnce, Lines, Options, ParentShowHint, RecordCount, RefreshMode, RenderSize, RollOver,
RollOverColor, RowAlternateColor, RowClick, RowCount, RowCurrentColor, RowHeaderColor, RowIsCurrent,
RowLimit, ScriptEvents, ScriptFiles, ShowHint, Summary, SupportedScriptEvents, Text, UseFrame,
UseWidth, Visible, WebApplication, ZIndex
Mtodos
AddScriptFile, AddToInitProc, AddToIWCLInitProc, AddToJavaScriptOnce, CellExists, Clear,
ColorToRGBString, Create, CreateImplicitColors, DeleteColumn, DeleteRow, Destroy, DoSubmit,
HTMLColor, Invalidate, MakeHTMLTag, PaintTo, RefreshData, RenderCSSClass, RenderHTML, RenderScripts,
RenderStyle, SetLayoutMgr, SetRenderData, SupportsSubmit, ToJPEGFile
Eventos
OnHTMLTag, OnRenderCell
TIWDBIMAGE
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Verso Intraweb do componente DBImage.
Propriedades
Align, AllText, Anchors, AutoSize, Canvas, Caption, Clip, Color, Confirmation, ControlEncode,
Cursosr, DataField, Datasource, DesignMode, DoSubmitValidation, ExtraTagParams, Font, Form,
JPegOptions, ParentShowHint, Picture, RenderSize, ScriptEvents, ScriptFiles, ShowHint,
SupportedScriptEvents, Text, UseBorder, UseFrame, UseSize, Visible, WebApplication, ZIndex
Mtodos
Eventos
OnHTMLTag
TIWDBLISTBOX
Unit
Na VCL e na CLX:
IWDBStdCtrls.
]Descrio
Verso Intraweb do componente DBListBox.
Propriedades
Align, Anchors, Canvas, Caption, Clip, Color, ControlEncode, Datafield, Datasource, DesignMode,
ItemIndex, Items, IWCLInitProc, JavaScriptOnce, ParentShowHint, RenderSize, ScriptEvents,
ScriptFiles, Selected, ShowHint, Sorted, SupportedScriptEvents, Text, UseFrame, Visible,
Mtodos
Eventos
OnChange, OnHTMLTag
TIWDBLOOKUPCOMBOBOX
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Verso Intraweb do componente DBLookupComboBox.
Propriedades
ItemIndex, Items, IWCLInitProc, JavaScriptOnce, KeyField, ListField, Listsource, ParentShowHint,
RenderSize, ScriptEvents, ScriptFiles, Selected, ShowHint, Sorted, SupportedScriptEvents, Text,
Mtodos
Eventos
OnChange, OnHTMLTag
TIWDBLOOKUPLISTBOX
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Verso Intraweb do componente DBLookupListBox.
Propriedades
ItemIndex, Items, IWCLInitProc, JavaScriptOnce, KeyField, ListField, Listsource, ParentShowHint,
RenderSize, ScriptEvents, ScriptFiles, Selected, ShowHint, Sorted, SupportedScriptEvents, Text,
Mtodos
Eventos
OnChange, OnHTMLTag
TIWDBMEMO
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Verso Intraweb do componente DBMemo.
Propriedades
Align, Anchors, AutoEditable, Canvas, Caption, Clip, Color, ControlEncode, DataField, Datasource,
DesignMode, Editable, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop,
InitProcCode, IWCLInitProc, JavaScriptOnce, Lines, ParentShowHint, RawText, ReadOnly, RenderSize,
Required, ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, TabOrder, Text, UseFrame,
Visible, WantReturns, WebApplication, ZIndex
Mtodos
Eventos
OnHTMLTag
TIWDBNAVIGATOR
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Verso Intraweb do componente DBNavigator.
Propriedades
Align, Anchors, Canvas, Caption, Clip, Color, Confirmations, CustomImages, ControlEncode,
Datasource, DesignMode, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop,
ImageHeight, ImageWidth, InitProcCode, IWCLInitProc, JavaScriptOnce, ParentShowHint, RenderSize,
ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, Text, UseFrame, Visible, VisibleButtons,
Mtodos
RenderScripts, RenderStyle, SetLayoutMgr, SetRenderData, Submit, SupportsSubmit, ToJPEGFile
Eventos
OnCancel, OnDelete, OnEdit, OnFirst, OnHTMLTag, OnInsert, OnLast, OnNext, OnPost, OnPrior,
OnRefresh, Orientation
TIWDBTEXT
Unit
Na VCL e na CLX:
IWDBStdCtrls.
Descrio
Verso Intraweb do componente DBText.
Propriedades
IWCLInitProc, JavaScriptOnce, Lines, ParentShowHint, RaeText, RenderSize, ScriptEvents, ScriptFiles,
ShowHint, SupportedScriptEvents, Text, UseFrame, Visible, WantReturns, WebApplication, ZIndex
Mtodos
Eventos
OnHTMLTag
TIWEDIT
Unit
Na VCL e na CLX:
IWCompEdit
Descrio
Verso Intraweb do componente Edit.
Propriedades
Align, Anchors, BGColor, Canvas, Caption, Clip, Color, ControlEncode, DesignMode,
DoSubmitValidation, Editable, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName,
HTMLTop, InitProcCode, IWCLInitProc, JavaScriptOnce, MaxLength, PasswordPrompt, ParentShowHint,
ReadOnly, RenderSize, Required, ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, Text,
Mtodos
Eventos
OnHTMLTag, OnSubmit
TIWFILE
Unit
Na VCL e na CLX:
IWCompEdit
Descrio
Exibe o texto de um arquivo.
Propriedades
Align, Anchors, AutoEditable, BGColor, Canvas, Caption, Clip, Color, ContentType, ControlEncode,
DesignMode, DoSubmitValidation, Editable, ExtraTagParams, FileData, FileName, Font, Form,
MaxLength, ParentShowHint, ReadOnly, RenderSize, Required, ScriptEvents, ScriptFiles, ShowHint,
SupportedScriptEvents, TabOrder, Text, UseFrame, ValueChecked, ValueUnchecked, Visible,
Mtodos
RenderScripts, RenderStyle, SaveToFile, SaveToStream, SetLayoutMgr, SetRenderData, SupportsSubmit,
ToJPEGFile
Eventos
OnHTMLTag, OnReceivedFile, OnSubmit
TIWFORM
Unit
Na VCL e na CLX:
IWForm.
Descrio
Classe-base de formulrios Intraweb.
Propriedades
ActiveControl, Background, BackgroundColor, DataSetList, ExtraHeader, FormAction, HandleTabs,
HiddenParams, JavaScript, JavaScriptOnce, LinkColor, Params, ScriptFiles, ShowHint, StyleSheet,
SupportedBrowsers, TabOrderList, TemplateProcessor, TextColor, Title, VLinkColor, WebApplication
Mtodos
AddScriptFile, AddToControlList, AddToInitProc, AddToIWCLInitProc, AddValidation, CacheImage,
Create, CreateNew, Destroy, DoDefaultAction, DoPreview, ExecuteForm, FixupTabList, GenerateForm,
RenderControl
Eventos
OnAfterRender, OnCreate, OnDefaultAction, OnDestroy, OnRender
TIWGRID
Unit
Na VCL e na CLX:
IWGrid
Descrio
Verso Intraweb do componente Grid.
Propriedades
Align, Anchors, BGColor, BorderColors, BorderSize, Borderstyle, Canvas, Caption, Cell, CellPadding,
CellSpacing, Clip, Color, ColumnCount, ControlEncode, DesignMode, ExtraTagParams, Font, Form,
FrameBuffer, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, IWCLInitProc,
JavaScriptOnce, Lines, ParentShowHint, RenderSize, RowCount, ScriptEvents, ScriptFiles, ShowHint,
Summary, SupportedScriptEvents, Text, UseFrame, UseWidth, Visible, WebApplication, ZIndex
Mtodos
AddScriptFile, AddToInitProc, AddToIWCLInitProc, AddToJavaScriptOnce, CellExists, Clear,
ColorToRGBString, Create, DeleteColumn, DeleteRow, Destroy, DoSubmit, HTMLColor, Invalidate,
MakeHTMLTag, PaintTo, RenderCSSClass, RenderHTML, RenderScripts, RenderStyle, SetLayoutMgr,
SetRenderData, SupportsSubmit, ToJPEGFile
Eventos
OnCellClick, OnHTMLTag, OnRenderCell
TIWIMAGE
Unit
Na VCL e na CLX:
IWExtCtrls
Descrio
Verso Intraweb do componente Image.
Propriedades
Cursosr, DesignMode, DoSubmitValidation, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft,
HTMLName, HTMLTop, InitProcCode, IWCLInitProc, JavaScriptOnce, JPegOptions, ParentShowHint, Picture,
RenderSize, ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, Text, UseBorder, UseFrame,
UseSize, Visible, WebApplication, ZIndex
Mtodos
Eventos
OnClick, OnHTMLTag e OnMouseDown
TIWIMAGEFILE
Unit
Na VCL e na CLX:
IWExtCtrls
Descrio
Exibe uma imagem proveniente de um arquivo.
Propriedades
Cursosr, DesignMode, DoSubmitValidation, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft,
HTMLName, HTMLTop, ImageFile, InitProcCode, IWCLInitProc, JavaScriptOnce, JPegOptions,
ParentShowHint, RenderSize, ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, Text,
UseBorder, UseFrame, UseSize, Visible, WebApplication, ZIndex
Mtodos
Eventos
OnClick, OnHTMLTag e OnMouseDown
TIWLABEL
Unit
Na VCL e na CLX:
IWCompLabel
Descrio
Verso Intraweb do componente Label.
Propriedades
Align, Anchors, AutoSize, Canvas, Caption, Clip, Color, ControlEncode, DesignMode, ExtraTagParams,
Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, IWCLInitProc,
JavaScriptOnce, ParentShowHint, RawText, RenderSize, ScriptEvents, ScriptFiles, ShowHint,
Mtodos
Eventos
OnHTMLTag
TIWLINK
Unit
Na VCL e na CLX:
IWHTMLCtrls
Descrio
Representa um link de uma pgina HTML
Propriedades
Align, Anchors, AutoEditable, Canvas, Caption, Clip, Color, ControlEncode, DesignMode,
DoSubmitValidation, Enabled, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName,
ScriptFiles, ShowHint, SupportedScriptEvents, Text, UseFrame, ValueChecked, ValueUnchecked, Visible,
Mtodos
Create, Destroy, DoSubmit, HookEvents, HTMLColor, Invalidate, MakeHTMLTag, PaintTo, RenderCSSClass,
RenderHTML, RenderScripts, RenderStyle, SetLayoutMgr, SetRenderData, SupportsSubmit, ToJPEGFile
Eventos
OnClick, OnHTMLTag
TIWLIST
Unit
Na VCL e na CLX:
IWHTMLCtrls
Descrio
Representa uma lista de itens de uma pgina HTML.
Propriedades
Align, Anchors, AutoEditable, Canvas, Caption, Clip, Color, ControlEncode, DataField, Datasource,
DesignMode, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop,
InitProcCode, Items, IWCLInitProc, JavaScriptOnce, Numbered, ParentShowHint, RenderSize,
ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents, Text, UseFrame, ValueChecked,
ValueUnchecked, Visible, WebApplication, ZIndex
Mtodos
Eventos
OnHTMLTag
TIWLISTBOX
Unit
Na VCL e na CLX:
IWCompListbox
Descrio
Verso Intraweb do componente ListBox.
Propriedades
FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, ItemIndex, Items, IWCLInitProc,
JavaScriptOnce, Multiselect, ParentShowHint, RenderSize, ScriptEvents, ScriptFiles, Selected,
ShowHint, Sorted, SupportedScriptEvents, Text, UseFrame, Visible, WebApplication, ZIndex
Mtodos
Eventos
OnChange, OnHTMLTag
TIWMEMO
Unit
Na VCL e na CLX:
IWCompMemo
Descrio
Verso Intraweb do componente Memo.
Propriedades
Align, Anchors, Canvas, Caption, Clip, Color, ControlEncode, DesignMode, Editable, ExtraTagParams,
Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, IWCLInitProc,
JavaScriptOnce, Lines, ParentShowHint, RawText, ReadOnly, RenderSize, Required, ScriptEvents,
ScriptFiles, ShowHint, SupportedScriptEvents, TabOrder, Text, UseFrame, Visible, WantReturns,
Mtodos
Eventos
OnHTMLTag
TIWRECTANGLE
Unit
Na VCL e na CLX:
IWHTMLCtrls
Descrio
Representa uma figura retangular em uma pgina HTML.
Propriedades
Align, Alignment, nchors, AutoEditable, Canvas, Caption, Clip, Color, ControlEncode, DataField,
Datasource, DesignMode, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop,
InitProcCode, IWCLInitProc, JavaScriptOnce, ParentShowHint, RenderSize, ScriptEvents, ScriptFiles,
ShowHint, SupportedScriptEvents, Text, UseFrame, VAlign, ValueChecked, ValueUnchecked, Visible,
Mtodos
Eventos
OnHTMLTag
TIWREGION
Unit
Na VCL e na CLX:
IWHTMLCtrls
Descrio
Representa uma regio de uma pgina HTML.
Propriedades
Align, Anchors, Color, Rectangle, TabOrder, Visible
Mtodos
Create, Destroy
Eventos
TIWTIMER
Unit
Na VCL e na CLX:
IWExtCtrls
Descrio
Verso Intraweb do componente Timer.
Propriedades
Align, Anchors, Canvas, Caption, Clip, Color, ControlEncode, DesignMode, Enabled, ExtraTagParams,
Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, Interval, IWCLInitProc,
JavaScriptOnce, ParentShowHint, RenderSize, ScriptEvents, ScriptFiles, ShowHint,
Mtodos
Eventos
OnHTMLTag, OnTimer
TIWTREEVIEW
Unit
Na VCL e na CLX:
IWTreeView
Descrio
Verso Intraweb do componente TreeView.
Propriedades
FriendlyName, HorScrollbarVisible, HTML, HTMLLeft, HTMLName, HTMLTop, InitProcCode, Items, IWCLInitProc,
JavaScriptOnce, ParentShowHint, RenderSize, ScriptEvents, ScriptFiles, ShowHint, SupportedScriptEvents,
Text, TreeViewImages, UseFrame, VertScrollbarVisible, Visible, WebApplication, ZIndex
Mtodos
Eventos
OnHTMLTag
TIWURL
Unit
Na VCL e na CLX:
IWHTMLControls
Descrio
Representa um link para uma URL em uma pgina HTML.
Propriedades
Align, Anchors, AutoEditable, Canvas, Caption, Clip, Color, ControlEncode, DesignMode,
DoSubmitValidation, Enabled, ExtraTagParams, Font, Form, FriendlyName, HTML, HTMLLeft, HTMLName,
ScriptFiles, ShowHint, SupportedScriptEvents, TargetOptions, TerminateApp, Text, URL, UseFrame,
UseTarget, ValueChecked, ValueUnchecked, Visible, WebApplication, ZIndex
Mtodos
Create, Destroy, DoSubmit, HookEvents, HTMLColor, Invalidate, MakeHTMLTag, PaintTo, RenderCSSClass,
RenderHTML, RenderScripts, RenderStyle, SetLayoutMgr, SetRenderData, SupportsSubmit, ToJPEGFile
Eventos
OnClick, OnHTMLTag
TLABEL
Descrio
O controle TLabel permite a exibio de um texto em um formulrio.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, Alignment, AutoSize, BoundsRect, Caption, Color, ComponentIndex, Cursor, DragCursor,
DragMode, Enabled, FocusControl, Font, Height, Hint, Left, Name, Owner, Parent, ParentColor,
ParentFont, ParentShowHint, PopupMenu, ShowAccelChar, ShowHint, Tag, Top, Transparent, Visible,
Width e WordWrap
Principais Mtodos
BeginDrag, BringToFront, ClientToScreen, Dragging, EndDrag, GetTextBuf, GetTextLen, Hide, Invalidate,
Refresh, Repaint, ScaleBy, ScreenToClient, SendToBack, SetBounds, SetTextBuf, Show e Update
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnMouseDown, OnMouseMove e OnMouseUp
TLIST
Descrio
Esse objeto utilizado para manter uma lista de objetos.
Unit
Na VCL e na CLX:
Classes
Capacity, Count, Items e List
Principais Mtodos
Add, ClassName, ClassParent, ClassType, Create, Clear, Delete, Destroy, Exchange, Expand, First,
Free, IndexOf, Insert, Last, Pack e Remove
Principais Eventos
TLISTBOX
Descrio
O controle TListBox consiste em uma caixa de listagem na qual o usurio pode selecionar um ou mais
itens.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, BorderStyle, Canvas, Color, Columns, ComponentIndex, Ctl3D, Cursor, DragCursor, DragMode,
Enabled, ExtendedSelect, Fields, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, ItemIndex,
IntegralHeight, ItemHeight, Items, Left, MultiSelect, Name, Owner, Parent, ParentColor, ParentCtl3D,
ParentFont, ParentShowHint, PopupMenu, SelCount, Selected, ShowHint, Showing, Sorted, Style,
TabOrder, TabStop, Tag, Top, TopIndex, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, Clear, ClientToScreen, Dragging, EndDrag, GetTextBuf, GetTextLen, Hide,
ItemAtPos, Invalidate, Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy, SendToBack, SetBounds,
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnDrawItem, OnEndDrag, OnEnter, OnExit, OnKeyDown,
OnKeyPress, OnKeyUp, OnMeasureItem, OnMouseDown, OnMouseMove e OnMouseUp
TLISTVIEW
Descrio
Esse controle permite a exibio de uma lista de itens contendo textos e imagens (cones).
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
Align, AllocBy, BorderStyle, BoundsRect, Brush, ClientHeight, ClientOrigin, ClentRect, ClientWidth,
Color, Columns, ComponentCount, ComponentIndex, Components, ControlCount, Controls, Ctl3D, Cursor,
DragCursor, DragMode, DropTarget, Focused, Font, Handle, Height, HelpContext, HelpKeyword,
HelpTypeHideSelection, IconOptions, Items, LargeImages, Left, MultiSelect, Name, Owner, Parent,
ParentShowHont, PopupMenu, ReadOnly, Selected, ShowColumnHeaders, ShowHint, Showing, SmallImages,
StateImages, TabStop, Tag, Top, TopItem, ViewOrigin, ViewStyle, Visible, VisibleRowCount e Width
Principais Mtodos
Arrange, Assign, BeginDrag, BringToFront, CanFocus, ClassName, ClassParent, ClassType, ClientToScreen,
ContainsControl, ControlAtPos, Create, Destroy, DragDrop, Dragging, EndDrag, FindCaption,
FindComponent, FindData, Focused, Free, GetItemAt, GetNearestItem, GetNextItem, GetTextBuf,
GetTextLen, HandleAllocated, HandleNeeded, Hide, InsertComponent, InsertControl, Invalidate,
IsEditing, Refresh, RemoveComponent, RemoveControl, Repaint, ScaleBy, ScreenToClient, Scroll,
ScrollBy, SendToBack, SetBounds, SetFocus, SetTextBuf, Show, Sort, StringWidth, Update e UpdateItems
Principais Eventos
OnChange, OnChanging, OnClick, OnColumnClick, OnCompare, OnDblClick, OnDeletion, OnDragDrop,
OnDragOver, OnEdited, OnEditing, OnEndDrag, OnEnter, OnExit, OnInsert, OnKeyDown, OnKeyPress,
OnKeyUp, OnMouseDown, OnMouseMove, OnMouseUp e OnStartDrag
TMainMenu
Descrio
Esse componente representa uma barra de menu em um formulrio.
Unit
Na VCL:
Menus
Na CLX:
QMenus
AutoMerge, ComponentIndex, Images, Items, Name, Owner e Tag
Principais Mtodos
FindItem, Free, GetHelpContext, HelpKeyword, HelpTypeMerge e UnMerge
Principais Eventos
TMASKEDIT
Descrio
O controle TMaskEdit consiste em uma caixa de edio especial, na qual o usurio s pode digitar um
conjunto de caracteres definidos como vlidos.
Unit
Na VCL:
Mask
Na CLX:
QMask
Align, AutoSelect, AutoSize, BorderStyle, CharCase, Color, ComponentIndex, Ctl3D, Cursor,
DragCursor, DragMode, EditMask, EditText, Enabled, Font, Height, HelpContext, HelpKeyword,
HelpTypeHint, IsMasked, Left, MaxLength, Modified, Name, Owner, Parent, ParentColor, ParentCtl3D,
ParentFont, ParentShowHint, PassWordChar, ReadOnly, SelLengh, SelStart, SelText, ShowHint, Showing,
TabOrder, TabStop, Tag, Text, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Clear, ClearSelection, ClientToScreen, CopyToClipBoard,
CutToClipBoard, Dragging, EndDrag, Focused, GetSelTextBuf, GetTextBuf, GetTextLen, Hide, Invalidate,
SetBounds, SetFocus, SetSelTextBuf, SetTextBuf, Show, Update e ValidateEdit
Principais Eventos
TMEDIAPLAYER
Descrio
O componente TMediaPlayer controla dispositivos que dispem de um driver MCI (Media Control
Interface). O componente consiste em um conjunto de botes (Play, Stop, Eject, Next, Prev, Step, Back
e Record), que controla dispositivos multimdia, como CD-ROM, VCR, etc.
Unit
Na VCL:
MPlayer
Align, AutoEnecle, AutoOpen, AutoRewind, BoundsRect, Capabilities, ColredButtons, ComponentIndex,
Cursor, DeviceID, DeviceType, Display, DisplayRect, Enabled, EnabledButtons, EndPos, Error,
ErrorMessage, FileName, Frame, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Mode, Name,
Notify, NotifyValue, Owner, Parent, ParentShowHint, Position, Shareable, ShowHint, Showing, Start,
StartPos, TabOrder, TabStop, Tag, TimeFormat, Top, TrackLength, TrackPosition, Tracks, Visible,
VisibleButtons, Wait e Width
Principais Mtodos
Back, BeginDrag, BringToFront, CanFocus, ClientToScreen, Close, Dragging, Eject, EndDrag, Focused,
GetTextBuf, GetTextLen, Hide, Invalidate, Next, Open, Pause, PauseOnly, Play, Previous, Refresh,
Repaint, Resume, Rewind, ScaleBy, Save, ScreenToClient, SendToBack, SetBounds, SetFocus,
SetSelTextBuf, Show, ShowRecording, Step, Stop e Update
Principais Eventos
OnClick, OnEnter, OnExit, OnNotify e OnPostClick
TMEMO
Descrio
O controle TMemo exibe texto para o usurio e permite que o usurio exiba e digite dados no controle.
Ao contrrio do controle TEdit, esse controle permite texto de mltiplas linhas.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, Alignment, BorderStyle, Color, ComponentIndex, Ctl3D, Cursor, DragCursor, DragMode, Enabled,
Font, Height, HelpContext, HelpKeyword, HelpTypeHideSelection, Hint, Left, Lines, MaxLength,
Modified, Name, Owner, Parent, ParentColor, ParentCtl3D, ParentFont, ParentShowHint, PopupMenu,
ReadOnly, ScrollBars, SelLengh, SelStart, SelText, ShowHint, Showing, TabOrder, TabStop, Tag, Text,
Top, Visible, WantReturns, WantTabs, Width e WordWrap
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Clear, ClearSelection, ClientToScreen, CopyToClipboard, Create,
CutToClipboard, Dragging, EndDrag, Focused, GetSelTextBuf, GetTextBuf, GetTextLen, Hide, Invalidate,
PastFromClipboard, Refresh, RemoveComponent, Repaint, ScaleBy, ScreenToClient, ScrollBy, SelectAll,
SendToBack, SetBounds, SetFocus, SetSelTextBuf, SetTextBuf, Show e Update
Principais Eventos
TMEMOBUF
Unit
Na VCL:
RpMemo Na CLX:
QRpMemo
Descrio
Fornece a funcionalidade de textos de mltiplas linhas em componentes do Rave Reports.
BaseReport, Buffer, BufferInc, Field, Justify, MaxSize, Memo, NoCRLF, NoNewLine, Pos, PrintEnd,
PrintStart, RichEdit, RTFField, RTFText, Size, Text, Version
Principais Mtodos
Append, AppendMemoBuf, ConstraintHeightLeft, Delete, Empty, FreeSaved, InsertMemoBuf, Insert,
LoadFromFile, LoadFromStream, MemoHeightLeft, MemoLinesLeft, PrintHeight, PrintLines, ReplaceAll,
Reset, RestoreBuffer, RestoreState, RTFLoadFromFile, RTFLoadFromStream, SaveBuffer, SaveState,
SaveToStream, SearchFirst, SearchNext, SetData
Principais Eventos
Esta classe no tem eventos associados.
TMEMOFIELD
Descrio
informao de texto em um conjunto arbitrrio de bytes cujo tamanho no predefinido.
Unit
Na VCL e na CLX:
DB
DataSet, DataSize, DataType, DisplayLabel, DisplayName, DisplayText, DisplayWisth, EditMask,
Tag, Text, Transliterate e Visible
Principais Mtodos
Principais Eventos
TMENUITEM
Descrio
Esse componente representa um item de menu.
Unit
Na VCL:
Menus
Na CLX:
QMenus
Break, Caption, Checked, Command, ComponentIndex, Count, Enabled, GroupIndex, HelpContext,
HelpKeyword, HelpTypeHint, Items, Name, Owner, Parent, ShortCut, Tag e Visible
Principais Mtodos
Add, Click, IndexOf, Insert e Remove
Principais Eventos
OnClick
TMETAFILE
Descrio
Esse objeto representa um grfico no formato Metafile do Windows (arquivo no formato *.WMF).
Unit
Na VCL:
Graphics
Handle, Height, Inch, Empty e Width
Principais Mtodos
Assign, ClassName, ClassParent, ClassType, Create, Destroy, Free, LoadFromFile e SaveToFile
Principais Eventos
OnChange
TMIDASCONNECTION
Descrio
Esse componente responsvel por manter uma conexo a um servidor remoto em uma aplicao
multicamada.
Unit
Na VCL:
MIDAScon
ConnectType, ServerPort, UseBroker, ComputerName, Connected, AppServer, LoginPrompt, ObjectBroker,
ServerGUID, ServerName
Principais Mtodos
Create, Destroy e GetProvider
Principais Eventos
TMIDASPAGEPRODUCER
Descrio
Esse componente gera uma string de comandos HTML a partir de um template, retornando dados
acessados por uma aplicao servidora.
Unit
Na VCL:
Midprod
Dispatcher, EnableXMLIslands, HTMLDoc, HTMLFile, IncludePathURL, Name, Owner, StripParamQuotes,
Styles, StylesFile, Tag, VCLComObject, WebPageItems
Principais Mtodos
ClassType, CleanupInstance, Contentm ContentFromStream, ContentFromString, Create, DefaultHandler,
Destroy, DestroyComponents, Destroying, Dispatch, ExecuteAction, FieldAddress, FindComponent,
FindXMLBroker, FindXMLBrokerName, Free, FreeInstance, FreeNotification, FreeOnRelease, GetInterface,
GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, GetXMLData, HasParent,
RemoveComponent, SafeCallException, SetIncludePathURL, SetStyles, SetStylesFile, UpdateAction
Principais Eventos
OnAfterGetContent, OnAfterGetXMLData, OnBeforeGetContent, OnBeforeGetXMLData, OnHTMLTag
TNMDAYTIME
Descrio
Esse componente obtm a data e a hora de um servidor Internet.
Unit
Na VCL:
NMDayTim
DayTimeStr, Host, Port, ReportLevel, Status, TimeOut
Principais Mtodos
Esse componente no possui mtodos.
Principais Eventos
OnConnect, OnConnectionFailed, OnDisconnect, OnHostResolved, OnInvalidHost, OnStatus
TNMECHO
Descrio
Esse componente envia um texto para o servidor Internet (recebendo-o de volta, como um eco).
Unit
Na VCL:
NMEcho
ElapsedTime, Host, LocalIP, Port, RemoteIP, ReportLevel, Status, TimeOut, WSAInfo
Principais Mtodos
Abort, Echo, Connect, Disconnect
Principais Eventos
OnConnect, OnConnectionFailed, OnConnectionRequired, OnDisconnect, OnHostResolved, OnInvalidHost, OnStatus
TNMFINGER
Descrio
Esse componente permite a conexo a um servidor Finger da Internet.
Unit
Na VCL:
NMFinger
FingerStr, Host, LocalIP, Port, RemoteIP, ReportLevel, TimeOut, User, WSAInfo
Principais Mtodos
Principais Eventos
OnConnect, OnConnectionFailed, OnConnectionRequired, OnDisconnect, OnHostResolved, OnInvalidHost, OnStatus
TNMFTP
Descrio
Esse componente permite a conexo a um servidor FTP da Internet.
Unit
Na VCL:
NMFtp
BytesRecvd, BytesSent, BytesTotal, CurrentDir, FTPDirectoryList, Host, LocalIP, ParseList, Password,
Port, Proxy, ProxyPort, RemoteIP, ReplyNumber, ReportLevel, Status, TimeOut, TransactionReply,
UserID, Vendor, WSAInfo
Principais Mtodos
Abort, Allocate, ChangeDir, Connect, Delete, Disconnect, DoCommand, Download, DownloadRestore, List,
MakeDirectory, Mode, Nlist, Reinitialize, RemoveDir, Rename, Upload, UploadAppend, UploadRestore,
UploadUnique
Principais Eventos
OnAuthenticationFailed, OnConnect, OnConnectionFailed, OnConnectionRequired, OnDisconnect,
OnFailure, OnError, OnHostResolved, OnInvalidHost, OnListItem, OnPacketRecvd, OnPacketSent,
OnStatus, OnSuccess, OnTransactionStart, OnTransactionStop, OnUnSupportedFunction
TNMHTTP
Descrio
Esse componente permite a conexo a um servidor HTTP da Internet.
Unit
Na VCL:
NMHtttp
Body, BytesRecvd, BytesSent, BytesTotal, CookieIn, Header, HeaderInfo, Host, InputFileMode,
LastErrorNo, LocalIP, OutputFileMode, Port, Proxy, ProxyPort, RemoteIP, ReplyNumber, ReportLevel,
SendHeader, Status, TimeOut, TransactionReply, WSAInfo
Principais Mtodos
Abort, Copy, Delete, Get, Head, Link, Move, Options, Patch, Post, Trace, UnLink, Wrapped
Principais Eventos
OnAboutToSend, OnConnect, OnConnectionFailed, OnDisconnect, OnFailure, OnHostResolved,
OnInvalidHost, OnPacketRecvd, OnPacketSent, OnRedirect, OnStatus, OnSuccess
TNMMSG
Descrio
Esse componente permite o envio de texto ASCII pela Internet utilizando uma conexo TCP/IP.
Unit
Na VCL:
NMMsg
FromName, Host, LocalIP, Port, ReportLevel, Status, TimeOut, WSAInfo
Principais Mtodos
Abort, Create, PostIt
Principais Eventos
OnConnect, OnConnectionFailed, OnDisconnect, OnHostResolved, OnInvalidHost, OnMessageSent, OnStatus
TNMMSGSERV
Descrio
Esse componente permite a recepo de texto ASCII enviado pela Internet utilizando o componente TNMMSG.
Unit
Na VCL:
NMMsg
LocalIP, Port, ReportLevel, Status, TimeOut, WSAInfo
Principais Mtodos
Principais Eventos
OnClientContact, OnMSG, OnStatus
TNMNNTP
Descrio
Esse componente permite o envio e a recepo de artigos para grupos de notcias da Internet.
Unit
Na VCL:
NMNNTP
AttachFilePath, Attachments, Body, BytesRecvd, BytesSent, BytesTotal, CacheMode, Connected,
CurrentArticle, GroupList, Header, HeaderRecord, HiMessage, Host, LocalIP, LoMessage, NewsDir,
ParseAttachments, Password, Port, PostBody, PostHeader, PostRecord, Posting, RemoteIP, ReplyNumber,
ReportLevel, SelectedGroup, Status, TimeOut, TransactionReply, UserId, WSAInfo
Principais Mtodos
Abort, Connect, Disconnect, GetArticle, GetArticleBody, GetArticleHeader, GetArticleList,
GetGroupList, PostArticle e SetGroup
Principais Eventos
OnAbort, OnArticle, OnArticleCacheUpdate, OnAuthenticationFailed, OnAuthenticationNeeded, OnBody,
OnBodyCacheUpdate, OnConnect, OnConnectionFailed, OnDisconnect, OnGroupListCacheUpdate,
OnGroupListUpdate, OnGroupSelect, OnGroupSelectRequired, OnHeader OnHeaderCacheUpdate, OnHeaderList,
OnHostResolved, OnInvalidArticle, OnInvalidHost, OnPacketRecvd, OnPacketSent, OnPosted,
OnPostFailed, OnStatus
TNMPOP3
Descrio
Esse componente permite o recebimento de e-mails de um servidor POP3 da Internet.
Unit
Na VCL:
NMPOP3
AttachFilePath, BytesRecvd, BytesTotal, Connected, DeleteOnRead, Host, LocalIP, MailCount,
MailMessage, Password, Port, RemoteIP, ReportLevel, Status, Summary, TimeOut, TransactionReply,
UserID, WSAInfo
Principais Mtodos
Abort, Connect, DeleteMailMessage, Disconnect, GetMailMessage, GetSummary, List, Reset
Principais Eventos
OnAuthenticationFailed, OnAuthenticationNeeded, OnConnect, OnConnectionFailed, OnConnectionRequired,
OnHostResolved, OnStatus, OnDisconnect, OnFailure, OnInvalidHost, OnList, OnPacketRecvd, OnReset,
OnRetrieveEnd, OnRetrieveStart e OnSuccess
TNMUUPROCESSOR
Descrio
Esse componente permite codificar e decodificar arquivos no formato MIME.
Unit
Na VCL:
NMUUP
InputStream, Methos e OutputStream
Principais Mtodos
Encode e Decode
Principais Eventos
OnBeginEncode, OnEndEncode, OnBeginDecode, OnEndDecode e OnError
TNMSMTP
Descrio
Esse componente permite enviar e-mails pela Internet.
Unit
Na VCL:
NMSMTP
ClearParams, EncodeType, FinalHeader, Host, LocalIP, Port, PostMessage, ReplyNumber, Status,
TimeOut, TransactionReply, UserID e WSAInfo
Principais Mtodos
Abort, ClearParameters, Connect, Disconnect, ExpandList, SendMail, Verify
Principais Eventos
OnAttachmentNotFound, OnAuthenticationFailed, OnConnect, OnConnectionFailed, OnConnectionRequired,
OnDisconnect, OnEncodeEnd, OnEncodeStart, OnFailure, OnHeaderIncomplete, OnHostResolved,
OnInvalidHost, OnMailListReturn, OnRecipientNotFound, OnSendStart, OnStatus
TNMSTRM
Descrio
Esse componente permite enviar streams pela Internet.
Unit
Na VCL:
NMSTRM
FromName, Host, LocalIP, Port, ReportLevel, Status, TimeOut, WSAInfo
Principais Mtodos
Create e PostIt
Principais Eventos
OnConnect, OnConnectionFailed, OnDisconnect, OnHostResolved, OnStatus, OnInvalidHost, OnMessageSent,
OnPacketSent
TNMSTRMSERV
Descrio
Esse componente permite receber streams pela Internet, enviadas pelo componente
TNMSTRM.
Unit
Na VCL:
NMSTRM
LocalIP, Port, ReportLevel, Status, TimeOut, WSAInfo
Principais Mtodos
Principais Eventos
OnMSG, OnClientContact, OnStatus
TNMTIME
Descrio
Esse componente obtm a data e a hora de um servidor Internet, pelo protocolo RFC 868.
Unit
Na VCL:
NMTime
Host, Port, ReportLevel, Status, TimeOut, TimeStr
Principais Mtodos
Create
Principais Eventos
OnConnect, OnConnectionFailed, OnDisconnect, OnHostResolved, OnInvalidHost, OnStatus
TNMUDP
Descrio
Esse componente permite o envio de pacotes pela Internet usando o protocolo UDP.
Unit
Na VCL:
NMUDP
LocalHost, RemoteHost, RemoteLevel e RemotePort
Principais Mtodos
Create, ReadBuffer, ReadStream, SendBuffer, SendStream
Principais Eventos
OnBufferInvalid, OnDataSend, OnInvalidHost, OnDataReceived, OnStatus, OnStreamInvalid
TNMGeneralServer
Descrio
Esse componente , na realidade, a classe-base de muitos outros componentes para acesso a Internet
do Delphi.
Unit
Na VCL:
PSock
Esse componente no possui propriedades.
Principais Mtodos
CaptureFile, CaptureStream, CaptureString, Read, ReadLn, SendBuffer, SendFile, SendStream, Serve,
Transaction, Write, Writeln
Principais Eventos
OnClientContact
TNMURL
Descrio
Esse componente converte strings em URLs e vice-versa.
Unit
Na VCL:
NMUrl
Decode, Encode e InputString
Principais Mtodos
Principais Eventos
OnError
TNOTEBOOK
Descrio
O componente TNotebook um componente que pode exibir muitas pginas, cada uma com os seus
prprios controles.
Unit
Na VCL:
ExtCtrls
ActivePage, Align, BoundsRect, Color, ComponentCount, ComponentIndex, Components, ControlCount, Controls,
Ctl3D, Cursor, DragCursor, DragMode, Enabled, Font, Handle, Height, HelpContext, HelpKeyword, HelpTypeLeft,
Name, Owner, PageIndex, Pages, Parent, ParentColor, ParentCtl3D, ParentFont, ParentShowHint, PopupMenu,
ShowHint, Showing, TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Clear, ClientToScreen, ContainsControl, Create, Destroy,
Dragging, EndDrag, FindComponent, Focused, Free, GetTextBuf, GetTextLen, Hide, InsertComponent,
InsertControl, Invalidate, Refresh, RemoveComponent, Repaint, ScaleBy, ScreenToClient, ScrollBy,
SendToBack, SetBounds, SetTextBuf, Show e Update
Principais Eventos
OnChange, OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnMouseDown,
OnMouseMove e OnMouseUp
TOLECONTAINER
Descrio
O componente TOLEContainer faz a ligao entre a sua aplicao e um servidor OLE.
Unit
Na VCL:
OleCtrls
Active, Align, AllowlnPlace, AutoActivate, AutoSize, BorederStyle, BoundsRect, ComponentIndex, ConvertDlgHelp,
Ctl3D, Cursor, DragCursor, DragMode, Enabled, Handle, Height, HelpContext, HelpKeyword, HelpTypeHint,
InPlaceActive, Left, Modified, Name, ObjClass, ObjDoc, ObjItem, Owner, Parent, ParentCtl3D, PrintInfo,
ShowHint, Showing, Storage, TabOrder, TabStop, Tag, Top, Visible, Width e Zoom
Principais Mtodos
BeginDrag, BringToFront, CanFocus, ClientToScreen, CopyToClipboard, Dragging, EndDrag, Focused,
GetTextBuf, GetTextLen, HandleAllocated, HandleNeeded, Hide, Invalidate, LoadFromFile,
OLEObjAllocated, Refresh, Repaint, SaveToFile, ScaleBy, ScreenToClient, ScrollBy, SendToBack,
Principais Eventos
OnActivate, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown, OnKeyPress,
OnKeyUp, OnMouseDown, OnMouseMove, OnMouseUp e OnStatusLineEvent
TOPENDIALOG
Descrio
O controle TOpenDialog fornece uma caixa de dilogo para a abertura de arquivos.
Unit
Na VCL:
Dialogs
Na CLX:
QDialogs
ComponentIndex, Ctl3D, DefaultExt, FileEditStyle, FileName, Files, Filter, FilterIndex, HelpContext,
HelpKeyword, HelpTypeHistoryList, InitialDir, Name, Options, Owner, Tag e Title
Principais Mtodos
Execute
Principais Eventos
TOPENPICTUREDIALOG
Descrio
O controle TOpenPictureDialog fornece uma caixa de dilogo para a abertura de arquivos que
armazenam imagens.
Unit
Na VCL:
Dialogs
Principais Mtodos
Execute
Principais Eventos
TOUTLINE
Descrio
O controle TOutline usado para exibir dados em vrios nveis hierrquicos.
Unit
Na VCL:
Outline
Align, BorderStyle, BoundsRect, Canvas, Color, ComponentIndex, Ctrl3D, Cursor, Directory,
DragCursor, DragMode, Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, ItemCount,
ItemHeight, Items, ItemSeparator, Left, Lines, Name, Options, OutlineStyle, Owner, Parent,
ParentColor, ParentCtrl3D, ParentFont, ParentShowHint, PictureClosed, PictureLeaf, PictureMinus,
PictureOpen, PicturePlus, PopupMenu, Row, ScrollBars, SelectedItem, ShowHint, Showing, Style,
Principais Mtodos
Add, AddChild, AddChildObject, AddObject, BeginDrag, BeginUpdate, BringToFront, CanFocus, Clear,
ClientToScreen, Dragging, EndDrag, EndUpdate, Focused, FullCollapse, FullExpand, GetDataItem,
GetItem, GetTextBuf, GetTextItem, GetTextLen, Hide, Insert, InsertObject, Invalidate, LoadFromFile,
Refresh, Repaint, SaveToFile, ScaleBy, ScreenToClient, ScrollBy, SendToBack, SetBounds, SetFocus,
SetTextBuf, SetUpdateState, Show e Update
Principais Eventos
OnClick, OnCollapse, OnDblClick, OnDragDrop, OnDragOver, OnDrawItem, OnEndDrag, OnEnter, OnExit,
OnExpand, OnKeyDown, OnKeyPress, OnKeyUp, OnMouseDown, OnMouseMove e OnMouseUp
TOUTLINENODE
Descrio
Esse objeto contm um item de um componente TOutline.
Unit
Na VCL:
Outline
Data, Expanded, FullPath, HasItems, Index, IsVisible, Level, Parent, Text e TopItem
Principais Mtodos
ChangeLevelBy, ClassName, ClassParent, ClassType, Create, Destroy, Expand, Free, FullExpand,
GetFirstChild, GetLastChild, GetNextChild, GetPrevChild e MoveTo
Principais Eventos
TPAGECONTROL
Descrio
O componente TPageControl um componente que pode exibir muitas pginas, cada uma com os
seus prprios controles.
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
ActivePage, Align, BoundsRect, Brush, ClientHeight, ClientOrigin, ClentRect, ClientWidth, Color,
ComponentCount, ComponentIndex, Components, ControlCount, Controls, Cursor, DragCursor, DragMode,
Enabled, Font, Handle, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, MultiLine, Name, Owner,
PageIndex, Pages, Parent, ParentColor, ParentFont, ParentShowHint, PopupMenu, ShowHint, Showing,
TabHeight, TabOrder, TabStop, TabWidth, Tag, Top, Visible e Width
Principais Mtodos
Assign, BeginDrag, BringToFront, CanFocus, ClassName, ClassParent, ClassType, ClientToScreen, ContainsControl,
ControlAtPos, Create, Destroy, DragDrop, Dragging, EndDrag, FindComponent, FindNextPage, Focused, Free,
GetTextBuf, GetTextLen, HandleAllocated, HandleNeeded, Hide, InsertComponent, InsertControl, Invalidate,
Refresh, RemoveComponent, RemoveControl, Repaint, ScaleBy, ScreenToClient, ScrollBy, SelectNextPage,
Principais Eventos
OnChange, OnChanging, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnMouseDown, OnMouseMove,
OnMouseUp e OnStartDrag
TPAGEPRODUCER
Descrio
Esse componente gera uma string de comandos HTML a partir de um template.
Unit
Na VCL e na CLX:
HTTPProd
Dispatcher, HTMLDoc, HTMLFile, Name, Owner, StripParamQuotes, Tag, VCLComObject
Principais Mtodos
ClassType, CleanupInstance, Content, ContentFromStream, ContentFromString, Create, DefaultHandler,
Destroy, DestroyComponents, Destroying, Dispatch, ExecuteAction, FieldAddress, FindComponent, Free,
FreeInstance, FreeNotification, FreeOnRelease, GetInterface, GetInterfaceEntry, GetInterfaceTable,
GetNamePath, GetParentComponent, HasParent, InheritsFrom, InitInstance, InsertComponent, InstanceSize,
MethodAddress, MethodName, NewInstance, RemoveComponent, SafeCallException, UpdateAction
Principais Eventos
OnHTMLTag
TPAINTBOX
Descrio
Esse componente fornece uma rea retangular na qual a sua aplicao pode exibir um desenho em
um formulrio.
Unit
Na VCL:
ExtCtrls
Na CLX:
QExtCtrls
Align, BoundsRect, Canvas, ComponentIndex, Color, Cursor, DragCursor, DragMode, Enabled, Font,
Height, Hint, Left, Name, Owner, Parent, ParentColor, ParentFont, ParentShowHint, PopupMenu,
ShowHint, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, ClientToScreen, Dragging, EndDrag, Focused, GetTextBuf, GetTextLen,
Invalidate, Refresh, Repaint, ScreenToClient, SendToBack, SetBounds, SetTextBuf e Update
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnMouseDown, OnMouseMove, OnMouseUp e OnPaint
TPANEL
Descrio
O componente TPanel permite que se coloquem painis em formulrios, nos quais podem ser inseridos
outros controles, criando barras de ferramentas e barras de status.
Unit
Na VCL:
ExtCtrls
Na CLX:
QExtCtrls
Align, Alignment, Bevelinner, BevelOuter, BevelWidth, BorderStyle, BorderWidth, BoundsRect, Caption,
Color, ComponentCount, ComponentIndex, Components, ControlCount, Controls, Ctl3D, Cursor,
DockClientCount, DockClients, DragCursor, DragMode, Enabled, Font, Height, HelpContext, HelpKeyword,
HelpTypeHint, Left, Locked, Name, Owner, Parent, ParentColor, ParentCtl3D, ParentFont,
ParentShowHint, PopupMenu, ShowHint, Showing, TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, ClientToScreen, ContainsControl, Dragging, EndDrag,
FindComponent, Focused, GetTextBuf, GetTextLen, Hide, InsertComponent, InsertControl, Invalidate,
Refresh, RemoveComponent, Repaint, ScaleBy, ScreenToClient, ScrollBy, SendToBack, SetBounds,
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnEndDrag, OnMouseDown, OnMouseMove, OnMouseUp e OnResize
TPEN
Descrio
Esse objeto usado para desenhar linhas em um objeto do tipo TCanvas.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Color, Handle, Mode, Style e Width
Principais Mtodos
Assign, ClassName, ClassParent, ClassType, Create, Destroy e Free
Principais Eventos
OnChange
TPICTURE
Descrio
Esse objeto representa um bitmap, um cone ou um grfico no formato Metafile do Windows.
Unit
Na VCL:
Graphics
Na CLX:
QGraphics
Bitmap, Graphic, Icon, Height, Metafile e Width
Principais Mtodos
Assign, ClassName, ClassParent, ClassType, Create, Destroy, Free, LoadFromFile e SaveToFile
Principais Eventos
OnChange
TPOPUPMENU
Descrio
Esse componente representa um menu flutuante (pop-up).
Unit
Na VCL:
Menus
Na CLX:
QMenus
Alignment, AutoPopup, ComponentCount, ComponentIndex, Components, Handle, HelpContext, HelpKeyword,
HelpTypeImages, Name, Owner, PopupComponent e Tag
Principais Mtodos
FindComponent, FindItem, Free e Popup
Principais Eventos
OnPopup
TPRINTDIALOG
Descrio
O controle TPrintDialog fornece uma caixa de dilogo de impresso na qual o usurio pode selecionar
a impressora, o nmero de cpias, as pginas a serem impressas, se deve ser usada a opo de cpias
agrupadas, etc.
Unit
Na VCL:
Dialogs
Collate, ComponentIndex, Copies, FromPage, HelpContext, HelpKeyword, HelpTypeMaxPage, MinPage, Name,
Options, Owner, PrintRange, PrintToFile, Tag e ToPage
Principais Mtodos
Execute
Principais Eventos
TPRINTER
Descrio
Esse objeto representa a impressora corrente do sistema.
Unit
Na VCL:
Printers
Na CLX:
QPrinters
Aborted, Canvas, Fonts, Handle, Orientation, PageHeight, PageWidth, PageNumber, PrinterIndex,
Printing, Printers e Title
Principais Mtodos
Abort, BeginDoc, ClaassName, ClassParent, ClassType, Create, Destroy, EndDoc, Free, GetPrinter,
NewPage e SetPrinter
Principais Eventos
TPRINTERSETUPDIALOG
Descrio
O controle TPrinterSetupDialog fornece uma caixa de dilogo de configurao de impressora na qual o
usurio pode configurar a impressora a ser usada.
Unit
Na VCL:
Dialogs
ComponentIndex, HelpContext, HelpKeyword, HelpTypeName, Owner e Tag
Principais Mtodos
Execute
Principais Eventos
TPROGRESSBAR
Descrio
O controle TProgressBar um componente que pode ser utilizado para exibir o progresso da execuo
de uma tarefa.
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
ComponentIndex, Components, ControlCount, Controls, Cursor, Enabled, Handle, Height, HelpContext,
HelpKeyword, HelpTypeHint, Left, Max, Min, Name, Owner, Parent, ParentShowHint, PopupMenu, Position,
ShowHint, Showing, Step, TabOrder, TabStop, Tag, Top, Visible e Width
Principais Mtodos
Invalidate, Refresh, RemoveComponent, RemoveControl, Repaint, ScaleBy, ScreenToClient, SendToBack,
SetBounds, SetFocus, SetTextBuf, Show Stepit, StepBy e Update
Principais Eventos
OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnMouseDown, OnMouseMove e OnMouseUp e OnStartDrag
TPROVIDER
Descrio
Esse componente responsvel por fornecer os dados de um dataset aplicao-cliente.
Unit
Na VCL:
Provider
DataSet, UpdateMode, Options, ResolveToDataSet, Resolver, Constraints, Data, Provider
Principais Mtodos
ApplyUpdates, Create, FetchData, Reset, SetParams, Destroy, GetRecords, DataRequest, GetMetaData
Principais Eventos
OnGetDataSetProperties, AfterUpdateRecord, BeforeUpdateRecord, OnGetData, OnUpdateData,
OnUpdateError, OnDataRequest
TQRDBTEXT
Descrio
Esse controle usado para exibir, em um relatrio, o valor de um campo de um banco de dados.
Unit
Na VCL:
QRCtrls
Alignment, AutoSize, Color, Cursor, DataField, DataSource, Font, Height, Hint, Left, Name,
ParentFont, Tag, Top, Transparent, Visible e Width
Principais Mtodos
Esse controle no possui mtodos associados.
Principais Eventos
OnPrint
TQRLABEL
Descrio
O controle TQRLabel usado na exibio de texto como cabealho de coluna em um relatrio.
Unit
Na VCL:
QRCtrls
Alignment, AlignToBand, AutoSize, Caption, Color, Cursor, Font, Height, Hint, Left, Name,
ParentFont, Tag, Top, Transparent, Visible e Width
Principais Mtodos
Principais Eventos
OnPrint
TQRMEMO
Descrio
Esse controle usado para inserir um texto com mltiplas linhas em um relatrio.
Unit
Na VCL:
QRCtrls
Alignment, Color, Cursor, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Lines, Name,
ParentFont, TabStop, Tag, Top, Width e WordWrap
Principais Mtodos
Principais Eventos
Esse controle no possui eventos associados.
TQRPREVIEW
Descrio
Esse controle facilita a criao de formulrios para a pr-visualizao de pginas de relatrios.
Unit
Na VCL:
QRCtrls
Align. AutoScroll, BorderStyle, Color, Ctl3D, Cursor, DragCursor, DragMode, Enabled, Font, Height,
HelpContext, HelpKeyword, HelpTypeHint, HorzScrollBar, Left, Name, PageNumber, ParentColor,
ParentCtl3d, ParentFont, ParentShowHint, PopupMenu, ShowHint, TabOrder, TabStop, Tag, Top,
VertScrollBar, Visible, Width e Zoom
Principais Mtodos
Show, ZoomToWidth e ZoomToFit
Principais Eventos
TQRPRINTER
Descrio
O controle TQRPrinter usado como um objeto de impresso (representa uma impressora), com
capacidades de pr-visualizao, leitura e gravao. Um objeto desse tipo, chamado QRPrinter, sempre
criado quando a sua aplicao comea a ser executada. Os objetos do tipo TQuickReport usam esse
objeto nas suas tarefas de impresso.
Unit
Na VCL:
QRCtrls
Canceled, Canvas, EnableOpenBtn, EnablePrintBtn, EnableSaveBtn, FromPage, Orientation, Page,
PageCount, PageHeight, PageNumber, PageWidth, PrinterOk, ShowProgress, Status, Thumbs, Title e ToPage
Principais Mtodos
BeginDoc, Cancel, CleanUp, EndDoc, Load, NewPage, Preview, Print e Save
Principais Eventos
OnPreview
TQRSHAPE
Descrio
Esse controle usado para exibir figuras em um relatrio.
Unit
Na VCL:
QRCtrls
Brush, Cursor, Height, Hint, Left, Name, Pen, Shape, Tag, Top, Visible e Width
Principais Mtodos
Principais Eventos
Esse controle no possui eventos associados.
TQRSYSDATA
Descrio
Esse controle usado para exibir dados do sistema em um relatrio.
Unit
Na VCL:
QRCtrls
Alignment, AlignToBand, AutoSize, Color, Cursor, Data, Font, Height, Hint, Left, Name, ParentFont,
Tag, Text, Top, Transparent, Visible e Width
Principais Mtodos
BeginDoc, Cancel, CleanUp, EndDoc, Load, NewPage, Preview, Print e Save
Principais Eventos
OnPrint
TQUERY
Descrio
Esse componente permite que o Delphi execute declaraes SQL no Borland Database Engine ou em
um servidor SQL.
Unit
DBTables
Active, AutoCalcFilelds, BOB, CanModify, Database, DatabaseName, DatabaseSource, DBHandle, DBLocale, EOF,
FieldCount, FieldDefs, Field, Handle, Local, Locale, Modified, Name, Owner, ParamCount, Params, Prepared,
RecordCount, RequestLive, SQL, SQLBinary, State, StmtHandle, Tag, Text, Unidirecional e UpdateMode
Principais Mtodos
Append, AppendRecord, Cancel, CheckBrowseMode, ClearFields, Close, CursorPosChanged, Delete,
DisableControls, Edit, EnableControls, ExecSQL, FieldByName, FindField, First, FreeBookmark,
GetBookmark, GetFieldNames, GotoBookmark, Insert, InsertRecord, Last, MoveBy, Next, Open,
ParamByName, Post, Prepare, Prior, Refresh, SetFields, UnPrepared, UpdateCursorPos e UpdateRecord
Principais Eventos
BeforeClose, BeforeDelete, BeforeEdit, BeforeInsert, BeforeOpen, BeforePost, OnCalcFields e OnNewRecord
TQUERYTABLEPRODUCER
Descrio
Esse componente gera uma string de comandos HTML que forma uma tabela com os dados provenientes
de uma consulta SQL.
Unit
Na VCL:
DBBDEWeb
DataSet, Query, Caption, CaptionAlignment, Columns, Editor, Footer, Header, MaxRows, RowAttributes e
TableAttributes
Principais Mtodos
Content, BeginUpdate, Create, Destroy, EndUpdate
Principais Eventos
OnCreateContent, OnFormatCell, OnGetTableCaption
TQUEUE
Descrio
Esta classe permite manipular objetos usando uma estrutura de dados do tipo Fila. Neste tipo de estrutura
de dados, o primeiro elemento a entrar o primeiro a sair, sendo comumente denominada estrutura
do tipo FIFO First In, First Out.
Unit
Contnrs
Principais Mtodos
AfterConstruction,. AtLeast, BeforeDestruction, ClassInfo, ClassName, ClassNameIs, ClassParent,
ClassType, CleanupInstance, Count, Create, DefaultHandler, Destroy, Dispatch, FieldAddress, Free,
FreeInstance, GetInterface, GetInterfaceEntry, GetInterfaceTable, InheritsFrom, InitInstance,
InstanceSize, MethodAddress, MethodName, NewInstance, Peek, Pop, Push, SafeCallException
Principais Eventos
TQUICKREP
Descrio
O controle TQuickReport responsvel pela funcionalidade da impresso de dados, transformando
formulrios em relatrios.
Unit
Na VCL:
QuickRpt
ColumnMarginInches, ColumnMarginsMM, Columns, DataSet, DisplayPrintDialog, LeftMarginInches,
LeftMarginsMM, Name, Orientation, PageCount, PageHeight, PageNumber, PageWidth, RecordCount,
RecordNo, ReportTitle, ReportType, RestartData, ShowProgress, SQLCompatible Tag e TitleBeforeHeader
Principais Mtodos
NewPage, Prepare, Preview e Print
Principais Eventos
AfterDetail, AfterPrint, BeforeDetail, BeforePrint, OnEndPage, OnFilter, OnNeedData e OnStartPage
TRADIOBUTTON
Descrio
O controle TRadioButton um boto de opo exclusiva que permite ao usurio selecionar ou no
uma opo no aplicativo.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, Alignment, Caption, Checked, Color, ComponentIndex, Ctl3D, Cursor, DragCursor, DragMode,
Enabled, Edit, Font, Handle, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Owner,
Parent, ParentColor, ParentCtl3D, ParentFont, ParentShowHint, PopupMenu, ShowHint, Showing,
Principais Mtodos
Principais Eventos
OnKeyUp, OnMouseDown, OnMouseMove e OnMouseUp
TRADIOGROUP
Descrio
O controle TRadioGroup permite a exibio de um conjunto de botes de rdio que representam
opes mutuamente exclusivas.
Unit
Na VCL:
ExtCtrls
Na CLX:
QExtCtrls
Align, Caption, Color, Columns, ComponentIndex, Ctl3D, Cursor, DragCursor, DragMode, Enabled, Font,
Handle, Height, HelpContext, HelpKeyword, HelpTypeHint, ItemIndex, Items, Left, Name, Owner, Parent,
ParentColor, ParentCtl3D, ParentFont, ParentShowHint, PopupMenu, ShowHint, Showing, TabOrder,
TabStop, Tag, Top, Visible e Width
Principais Mtodos
FindComponent, Focused, GetTextBuf, GetTextLen, Hide, Invalidate, Refresh, Repaint, ScaleBy,
ScreenToClient, ScrollBy, SendToBack, SetBounds, SetFocus e SetTextBuf
Principais Eventos
OnClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter e OnExit
TRDSCONNECTION
Descrio
Este componente responsvel pela Conexo e acesso Remoto a bancos de dados atravs do Mecanismo
Activex Data Objects (ADO).
Unit
Na VCL:
AdODB
AppServer, ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle,
ComputerName, Connected, DataSetCount, DataSets, DataSpaceObject, DesignInfo, InternetTimeout,
LoginPrompt, Name, Owner, ServerName, StreamedConnected, Tag, VCLComObject
Principais Mtodos
ClassType, CleanupInstance, Close, Create, DefaultHandler, Destroy, DestroyComponents, Destroying,
Dispatch, DoConnect, DoDisconnect, ExecuteAction, FieldAddress, FindComponent, Free, FreeInstance,
FreeNotification, FreeOnRelease, GetConnected, GetDataSet, GetDataSetCount, GetInterface,
GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, GetRecordset, HasParent,
InheritsFrom, InitInstance, InsertComponent, InstanceSize, Loaded, MethodAddress, MethodName,
NewInstance, Open, RegisterClient, RemoveComponent, SafeCallException, SendConnectEvent,
SetConnected, UnRegisterClient, UpdateAction
Principais Eventos
AfterConnect, AfterDisconnect, BeforeConnect, BeforeDisconnect, OnLogin.
TREGISTRY
Descrio
Essa classe representa o registro do Windows, permitindo que uma aplicao possa acess-lo e alter-lo.
Unit
Na VCL:
Registry
CurrentKey, CurrentPath, LazyWrite, RootKey
Principais Mtodos
CloseKey, Create, CreateKey, DeleteKey, DeleteValue, Destroy, GetDataInfo, GetDataSize, GetDataType,
GetKeyInfo, GetKeyNames, GetValueNames, HasSubKeys, KeyExists, LoadKey, MoveKey, OpenKey,
OpenKeyReadOnly, ReadBool, ReadCurrency, ReadDate, ReadDateTime, ReadFloat, ReadInteger, ReadString,
ReadTime, RegistryConnect, RenameValue, ReplaceKey, RestoreKey, SaveKey, UnLoadKey, ValueExists,
WriteBinaryData, WriteBool, WriteCurrency, WriteDate, WriteDateTime, WriteExpandString, WriteFloat,
WriteInteger, WriteString, WriteTime
Principais Eventos
TREGISTRYINIFILE
Descrio
Essa classe representa o registro do Windows, permitindo que uma aplicao possa acess-lo e alter-lo.
Unit
Na VCL:
Registry
RegIniFile, FileName
Principais Mtodos
Creat, DeleteKey, EraseSection, ReadDate, ReadDateTime, ReadFloat, ReadInteger, ReadSection,
ReadSections, ReadSectionValues, ReadString, ReadTime, UpdateFile, WriteDate, WriteDateTime,
WriteFloat, WriteInteger, WriteString, WriteTime, ReadBool, SectionExists, ValueExists, WriteBool
Principais Eventos
TREMOTESERVER
Descrio
Esse componente responsvel por manter uma conexo a um servidor remoto em uma aplicao
multicamada.
Unit
Na VCL:
MIDAScon
ComputerName, Connected, AppServer, LoginPrompt, ObjectBroker, ServerGUID, ServerName
Principais Mtodos
Create, Destroy e GetProvider
Principais Eventos
TREPLACEDIALOG
Descrio
O controle TReplaceDialog fornece uma caixa de dilogo para pesquisa e substituio de texto.
Unit
Na VCL:
Dialogs
Na CLX:
QDialogs
ComponentIndex, Ctl3D, FindText, HelpContext, HelpKeyword, HelpTypeName, Options, Owner, Replacetext e Tag
Principais Mtodos
CloseDialog e Execute
Principais Eventos
OnFind e OnReplace
TRICHEDIT
Descrio
O controle TRichEdit semelhante ao controle TMemo, mas permite a aplicao de fontes com diferentes
atributos a partes distintas do texto inserido no controle.
Unit
Na VCL:
ComCtrls
Align, Alignment, BorderStyle, BoundsRect, Brush, ClientHeight, ClientOrigin, ClentRect,
ClientWidth, Color, ComponentCount, ComponentIndex, Components, ControlCount, Controls, Ctl3D,
Cursor, DragMode, Enabled, Font, Handle, Height, HelpContext, HelpKeyword, HelpTypeHideScrollBars,
HideSelection, Hint, Left, Lines, MaxLength, Name, Owner, Paragraph, Parent, ParentColor,
ParentCtl3D, ParentFont, PlainText, PopupMenu, ReadOnly, ScrollBars, SetAttributes, ShowHint,
Showing, TabOrder, TabStop, Tag, Top, Visible, WantTabs, WantReturns, Width e WordWrap
Principais Mtodos
ContainsControl, ControlAtPos, Create, Destroy, DragDrop, Dragging, EndDrag, FindComponent,
FindText, Focused, GetTextBuf, GetTextLen, HandleAllocated, HandleNeeded, Hide, InsertComponent,
InsertControl, Invalidate, Print, Refresh, RemoveComponent, RemoveControl, Repaint, ScaleBy,
Principais Eventos
OnChange, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown, OnKeyPress, OnKeyUp,
OnMouseDown, OnMouseMove, OnMouseUp, OnProtectChange, OnResizeRequest, OnSaveClipboard,
OnSelectionChange e OnStartDrag
TRPBARSBASE
Unit
Na VCL:
RpBars
Na CLX:
QRpBars
Descrio
Esta classe a classe-base para a gerao de cdigos de barra em componentes do Rave Reports.
BarBottom, BarCodeJustify, BarCodeRotation, BarHeight, BarTop, BarWidth, BaseReport, Bottom, Center,
CheckSum, CodePage, Extended, ExtendedText, Height, Left, Position, PrintChecksum, PrintReadable,
PrintTop, ReadableHeight, Right, Text, TextJustify, Top, UseChecksum, WideFactor, Width
Principais Mtodos
Create, IsValidChar, Print, PrintFimA, PrintFimB, PrintFimC, PrintXY
Principais Eventos
TRPBASECOMPONENT
Unit
Na VCL:
RpBase
Na CLX:
QRpBase
Descrio
Esta classe a classe-base para todos os components do Rave Reports relacionados com a formatao
de sada de relatrios.
Version
Principais Mtodos
Essa classe no possui mtodos associados.
Principais Eventos
TRPCOMPONENT
Unit
Na VCL:
RpDefine
Na CLX:
QRpDefine
Descrio
Esta classe a classe-base para todos os componentes do Rave Reports no vinculados formatao de
sada.
Version
Principais Mtodos
Principais Eventos
TRPRENDER
Unit
Na VCL:
RpRender
Na CLX:
RpRender
Esta a classe-base para renderizao de relatrios.
Active, CacheDir, DisplayName, ImageQuality, MetafileDPI, OnCompress, ServerMode, UseCompression, Version
Principais Eventos
TRPRENDERCANVAS
Unit
Na VCL:
RpRender
Na CLX:
QRpRender
Descrio
Esta a classe-base para renderizao em tela de relatrios.
Principais Eventos
TRPRENDERSTREAM
Unit
Na VCL:
RpRender Na CLX:
RpRenderDescrio
Esta a classe-base para renderizao de relatrios com stream.
Principais Eventos
TRVCUSTOMCONNECTION
Unit
Na VCL:
RpCon
Na CLX:
QRpCon
Descrio
Permite customizar o acesso a dados no provenientes de componentes de acesso a bancos de dados.
FieldAliasList, LocalFilter, RuntimeVisibility, Version
Principais Mtodos
WriteBCDData, WriteBlobData, WriteBoolData, WriteCurrData, WriteDateTime, WriteFloatData,
WriteIntData, WriteNullData, WriteStrData
Principais Eventos
OnFirst, OnGetCols, OnGetRow, OnGetSorts, OnNext, OnOpen, OnRestore, OnSetFilter, OnSetSort, OnValidateRow
TRVDATASETCONNECTION
Unit
Na VCL:
RpConDS
Na CLX:
QRpConDS
Descrio
Classe-base para conexo a dados provenientes de componentes de acesso a bancos de dados.
DataSet, FieldAliasList, LocalFilter, RuntimeVisibility, Version
Principais Mtodos
Principais Eventos
OnFirst, OnGetCols, OnGetRow, OnGetSorts, OnNext, OnOpen, OnRestore, OnSetFilter, OnSetSort,
OnValidateRow
TRVNDRWRITER
Unit
Na VCL:
RpFiler
Na CLX:
QRpFiler
Descrio
Este componente, em conjuto com TRvRenderPrinter e TRvRenderPreview, responsvel por armazenar
um relatrio em formato binrio at que esteja pronto para impresso ou pr-visualizao.
FrameMode, GridVert, Italic, LastPage, LeftWaste, LineBottom, LineHeight, LineHeightMethod,
LineMiddle, LineNum, LinesPerInch, LineTop, MacroData, MarginBottom, MarginLeft, MarginRight,
MarginTop, MaxCopies, NoBufferLine, NoNTColorFix, NoPrinterPageHeight, NoPrinterPageWidth,
Orientation, OriginX, OriginY, OutputInvalid, OutputName, PageHeight, PageInvalid, PageWidth,
Papers, PIVar, Port, PrinterIndex, Printers, Printing, ReportDateTime, RightWaste, ScaleX, ScaleY,
SectionBottom, SectionLeft, SectionRight, SectionTop, Selection, ShadowDepth, StatusFormat,
StatusLabel, StatusText, Stream, StreamMode, Strikeout, Subscript, Superscript, TabColor,
TabJustify, TabShade, TextBKMode, Title, TopWaste, TotalPasses, TransparentBitmaps, TruncateText,
Underline, Units, UnitsFactor, Version, XDPI, XPos, YDPI, YPos
Principais Mtodos
Abort, AbortPage, AdjustLine, AllowAll, AllowPreviewOnly, AllowPrinterOnly, Arc, AssignFont, BrushCopy,
CalcGraphicHeight, CalcGraphicWidth, Chord, ClearAllTabs, ClearColumns, ClearTabs, CopyRect, CR, Create,
CreateBrush, CreateFont, CreatePen, CreatePoint, CreateRect, Destroy, DrawFocusRect, Draw, Ellipse,
Execute, FillRect, Finish, FinishTabBox, FloodFill, FrameRect, GetMemoLine, GetNextLine, GetTab,
GotoFooter, GotoHeader, GotoXY, GraphicFieldToBitmap, Home, LF, LinesLeft, LineTo, Macro, MemoLines,
MoveTo, NewColumn, NewLine, NewPage, NoPrinters, Pie, Polygon, Polyline, PopFont, PopPos, PopTabs, Print,
PrintBitmap, PrintBitmapRect, PrintBlock, PrintCenter, PrintCharJustify, PrintData, PrintDataStream,
PrintFooter, PrintHeader, PrintImageRect, PrintJustify, PrintLeft, PrintLn, PrintMemo, PrintRight,
PrintTab, PrintXY, PushFont, PushPos, PushTabs, RecoverPrinter, Rectangle, RegisterGraphic,
ReleasePrinter, Reset, ResetLineHeight, ResetPrinter, ResetSection, ResetTabs, RestoreFont, RestorePos,
RestoreTabs, ReuseGraphic, RoundRect, SaveFont, SavePos, SaveTabs, SelectBin, SelectPaper0 SelectPrinter,
SetBrush, SetColumns, SetColumnWidth, SetFont, SetPaperSize, SetPen, SetPIVar, SetTab, SetTopOfPage,
ShadeToColor, ShowPrintDialog, ShowPrinterSetupDialog, Start, StretchDraw, SupportBin, SupportCollate,
SupportDuplex, SupportOrientation, SupportPaper, Tab, TabEnd, TabStart, TabWidth, TextRect, TextWidth,
Principais Eventos
TRVPROJECT
Unit
Na VCL:
RpRave
Na CLX:
QRpRave
Descrio
Este componente fornece acesso ao editor visual de relatrios do Rave. Em geral usa-se apenas um
componente desta classe em uma aplicao, podendo no entanto usar-se mais de um, se necessrio. A
sua propriedade ProjectFile define o projeto de relatrio (no confundir com o projeto de aplicao
Delphi) usado pela aplicao e acessado por este componente. Este arquivo de projeto ter a extenso
.RAV e, mesmo constituindo-se em um nico arquivo, pode conter a definio de diversos relatrios
acessados pela aplicao.
Active, DLLFile, Engine, LoadDesigner, ProjectFile, RaveBlobDateTime, ReportDesc, ReportFullName,
ReportName, StoreRAV, Version
Principais Mtodos
ClearRaveBlob, Close, Design, DesignReport, Execute, ExecuteReport, GetReportCategoryList,
GetReportList, LoadFromFile, LoadFromStream, LoadRaveBlob, Open, ReportDescToMemo, Save,
SaveRaveBlob, SaveToFile, SaveToStream, SelectReport, SetParam
Principais Eventos
OnAfterClose, OnAfterOpen, OnBeforeClose, OnBeforeOpen, OnCreate, OnDesignerSave, OnDesignerSaveAs,
OnDesignerShow e OnDestroy
TRVRENDERPDF
Unit
Na VCL:
RvRenderPDF
Na CLX:
RvRenderPDF
Descrio
Este componente responsvel pela gerao de um relatrio no formato PDF.
Active, CacheDir, DisplayName, FileExtension, ImageQuality, MetafileDPI, OnCompress, ServerMode,
UseCompression, Version
Principais Mtodos
Esta classe no possui mtodos associados.
Principais Eventos
OnCompress, OnDecodeImage
TRVRENDERHTML
Unit
Na VCL:
RvRenderHTML
Na CLX:
RvRenderHTML
Descrio
Este componente responsvel pela gerao de um relatrio no formato HTML.
Principais Mtodos
Principais Eventos
TRVRENDERPREVIEW
Unit
Na VCL:
RpRenderPreview
Na CLX:
QRpRenderPreview
Descrio
Esta classe responsvel pela pr-visualizao de um relatrio a partir de um arquivo gerado pelo
componenteTRvNDRWriter.
Duplex, FileName, FirstPage, FontAlign, FontBaseline, FontBottom, FontCharset, FontColor, FontHandle,
FontHeight, FontName, FontPitch, FontRotation, Fonts, FontSize, FontTop, FontWidth, FrameMode,
GridVert, IgnoreFileSettings, Italic, LastPage, LeftWaste, LineBottom, LineHeight, LineHeightMethod,
LineMiddle, LineNum, LinesPerInch, LineTop, MacroData, MarginBottom, MarginLeft, MarginMethod,
MarginPercent, MarginRight, MarginTop, MaxCopies, Monochrome, NoBufferLine, NoNTColorFix,
NoPrinterPageHeight, NoPrinterPageWidth, Orientation, OriginX, OriginY, OutputInvalid, OutputName,
PageHeight, PageInc, PageInvalid, Pages, PageWidth, Papers, PIVar, Port, PrinterIndex, Printers,
Printing, ReportDateTime, RightWaste, ScaleX, ScaleY, ScrollBox, SectionBottom, SectionLeft,
SectionRight, SectionTop, Selection, ShadowDepth, StatusFormat, StatusLabel, StatusText, Stream,
StreamMode, Strikeout, Subscript, Superscript, TabColor, TabJustify, TabShade, TextBKMode, Title,
TopWaste, TotalPasses, TransparentBitmaps, TruncateText, Underline, Units, UnitsFactor, Version, XDPI,
XPos, YDPI, YPos, ZoomFactor, ZoomInc, ZoomPageFactor, ZoomPageWidthFactor
Principais Mtodos
BrushCopy, CalcGraphicHeight, CalcGraphicWidth, Chord, Clear, ClearAllTabs, ClearColumns, ClearTabs,
DrawFocusRect, Draw, Ellipse, Execute, ExecuteCustom, FillRect, Finish, FinishTabBox, FloodFill,
FrameRect, GetMemoLine, GetNextLine, GetTab, GotoFooter, GotoHeader, GotoXY, GraphicFieldToBitmap,
Home, LF, LinesLeft, LineTo, Macro, MemoLines, MoveTo, NewColumn, NewLine, NewPage, NextPage,
NoPrinters, Pie, Polygon, Polyline, PopFont, PopPos, PopTabs, PrevPage, Print, PrintBitmap,
PrintBitmapRect, PrintBlock, PrintCenter, PrintCharJustify, PrintData, PrintDataStream, PrintFooter,
PrintHeader, PrintImageRect, PrintJustify, PrintLeft, PrintLn, PrintMemo, PrintPage, PrintRight,
PrintTab, PrintXY, PushFont, PushPos, PushTabs, RecoverPrinter, Rectangle, RedrawPage,
RegisterGraphic, ReleasePrinter, Reset, ResetLineHeight, ResetPrinter, ResetSection, ResetTabs,
RestoreFont, RestorePos, RestoreTabs, ReuseGraphic, RoundRect, SaveFont, SavePos, SaveTabs,
SelectBin, SelectPaper0 SelectPrinter, SetBrush, SetColumns, SetColumnWidth, SetFont, SetPaperSize,
SetPen, SetPIVar, SetTab, SetTopOfPage, ShadeToColor, ShowPrintDialog, ShowPrinterSetupDialog,
Start, StretchDraw, SupportBin, SupportCollate, SupportDuplex, SupportOrientation, SupportPaper,
Tab, TabEnd, TabStart, TabWidth, TextRect, TextWidth, UnregisterGraphic, UpdateStatus, XD2I, XD2U,
XI2D, XI2U, XU2D, XU2I, YD2I, YD2U, YI2D, YI2U, YU2D, YU2I, ZoomIn, ZoomOut
Principais Eventos
OnAfterPrint, OnBeforePrint, OnDecodeImage, OnNewColumn, OnNewPage, OnPageChange, OnPrint,
OnPrintFooter, OnPrintHeader, OnPrintPage, OnZoomChange
TRVRENDERPRINTER
Unit
Na VCL:
RpRenderPrinter
Na CLX:
QRpRenderPrinter
Descrio
Esta classe responsvel pela impresso de um relatrio a partir de um arquivo gerado pelo
componenteTRvNDRWriter
FrameMode, GridVert, IgnoreFileSettings, Italic, LastPage, LeftWaste, LineBottom, LineHeight,
LineHeightMethod, LineMiddle, LineNum, LinesPerInch, LineTop, MacroData, MarginBottom, MarginLeft,
MarginRight, MarginTop, MaxCopies, NoBufferLine, NoNTColorFix, NoPrinterPageHeight,
NoPrinterPageWidth, Orientation, OriginX, OriginY, OutputInvalid, OutputName, PageHeight,
PageInvalid, PageWidth, Papers, PIVar, Port, PrinterIndex, Printers, Printing, ReportDateTime,
RightWaste, ScaleX, ScaleY, SectionBottom, SectionLeft, SectionRight, SectionTop, Selection,
ShadowDepth, StatusFormat, StatusLabel, StatusText, Stream, StreamMode, Strikeout, Subscript,
Superscript, TabColor, TabJustify, TabShade, TextBKMode, Title, TopWaste, TotalPasses,
TransparentBitmaps, TruncateText, Underline, Units, UnitsFactor, Version, XDPI, XPos, YDPI, YPos
Mtodos
SavePos, SaveTabs, SelectBin, SelectPaper0 SelectPrinter, SetBrush, SetColumns, SetColumnWidth,
Eventos
TRVRENDERRTF
Unit
Na VCL:
RvRenderRTF
Na CLX:
RvRenderRTF
Descrio
Este componente responsvel pela gerao de um relatrio no formato RTF.
Principais Mtodos
Principais Eventos
TRVRENDERTEXT
Unit
Na VCL:
RvRenderText
Na CLX:
RvRenderTextDescrio
Este componente responsvel pela gerao de um relatrio no formato de Texto ASCII.
Principais Mtodos
Principais Eventos
TRVQUERYCONNECTION
Na VCL:
RpConBDE
Na CLX:
QRpConBDE
Descrio
Usado para gerao de relatrios vinculados a dados provenientes de um componente TQuery.
FieldAliasList, LocalFilter, RuntimeVisibility, Query, Version
Principais Mtodos
Principais Eventos
OnValidateRow
TRVSYSTEM
Unit
Na VCL:
RpSystem
Na CLX:
QRpSystem
Descrio
Este componente trabalha em conjunto com componentes das classes TRvRenderPreview,
TRvRenderPrinter e TRvNDRWriter para enviar um relatrio para pr-visualizao na tela ou para impresso.
BaseReport, DefaultDest, GridHoriz, GridPen, OutputFileName, ReportDest, RulerType, SystemFiler,
SystemOptions, SystemPreview, SystemPrinter, SystemSetups, TitlePreview, TitleSetup, TitleStatus, Version
Principais Mtodos
Este componente no possui mtodos associados.
Principais Eventos
OnPreviewSetup, OnPreviewShow, OverridePreview, OverrideSetup, OverrideStatus
TRVTABLECONNECTION
Unit
Na VCL:
RpConBDE
Na CLX:
QRpConBDE
Descrio
Usado para gerao de relatrios vinculados a dados provenientes de um componente TTable.
FieldAliasList, LocalFilter, RuntimeVisibility, Table, UseSetRange, Version
Principais Mtodos
Principais Eventos
OnValidateRow
TSAVEDIALOG
Descrio
O controle TSaveDialog fornece uma caixa de dilogo para salvar arquivos.
Unit
Na VCL:
Dialogs
Na CLX:
QDialogs
Principais Mtodos
Execute
Principais Eventos
TSAVEPICTUREDIALOG
Descrio
O controle TSavePictureDialog fornece uma caixa de dilogo para salvar arquivos que armazenam imagens.
Unit
Na VCL :
Dialogs
Principais Mtodos
Execute
Principais Eventos
TSCREEN
Descrio
Esse componente representa a tela do computador no qual a aplicao est sendo executada. O Delphi
sempre cria automaticamente um componente chamado Screen do tipo TScreen para a sua aplicao.
Unit
Na VCL:
Forms
Na CLX:
QForms
ActiveControl, ActiveForm, ComponentCount, ComponentIndex, Components, Cursor, Cursors, FormCount,
Forms, Fonts, Heigth, Name, Owner, PixelsPerInch, Tag e Width
Principais Mtodos
FindComponent, InsertComponent e RemoveComponent
Principais Eventos
OnActiveControlChange e OnActiveFormChange
TSCROLLBAR
Descrio
O controle TScrollBar consiste em uma barra de rolamento, usada para rolar o contedo de uma
janela, formulrio ou controle.
Unit
Na VCL:
StdCtrls
Na CLX:
QStdCtrls
Align, ComponentIndex, Ctrl3D, Cursor, DragCursor, DragMode, Enabled, Handle, Height, HelpContext,
HelpKeyword, HelpTypeHint, Kind, LargeChange, Left, Max, Min, Name, Owner, Parent, ParentCtl3D,
ParentShowHint, PopupMenu, Position, ShowHint, Showing, SmallChange, TabOrder, TabStop, Tag, Top,
Visible e Width
Principais Mtodos
GetTextLen, Hide, Invalidate, Refresh, Repaint, ScaleBy, ScreenToClient, SendToBack, SetBounds,
SetFocus, SetParams, SetTextBuf, Show e Update
Principais Eventos
OnChange, OnClick, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown, OnKeyDown,
OnKeyPress, OnKeyUp e OnScroll
TSCROLLBOX
Descrio
O controle TScrollBox permite que se defina uma rea de rolagem retangular interna a um formulrio.
Voc pode, por exemplo, colocar dois controles do tipo TPanel, um para ser usado como barra de
ferramentas (com propriedade Align igual a alTop) e o outro como barra de status (com propriedade
Align igual a alBottom) e definir uma caixa de rolagem que ocupe a rea-cliente restante, de forma que
o seu contedo possa ser rolado sem afetar a barra de ferramentas e a barra de status.
Unit
Na VCL:
Forms
Na CLX:
QForms
Align, BorderStyle, Brush, Color, ComponentCount, ComponentIndex, Components, ControlCount, Controls,
Ctrl3D, Cursor, DragCursor, DragMode, Enabled, Font, Height, HelpContext, HelpKeyword, HelpTypeHint,
HorzScrollBar, Left, Name, Owner, Parent, ParentColor, ParentCtl3d, ParentFont, ParentShowHint,
PopupMenu, ShowHint, Showing, TabOrder, TabStop, Tag, Top, VertScrollBar, Visible e Width
Principais Mtodos
FindComponent, Focused, GetTextBuf, GetTextLen, Hide, InsertComponent, InsertControl, Invalidate,
Refresh, RemoveComponent, Repaint, ScaleBy, ScreenToClient, ScrollBy, ScrolllnView, SendToBack,
SetBounds, SetFocus, SetTextBuf, Show, e Update
Principais Eventos
TSERVERSOCKET
Descrio
Esse componente gerencia conexes TCP/IP do lado servidor.
Unit
Na VCL:
scktcomp
Socket, ServerType, ThreadCacheSize, Active, Port, Service
Principais Mtodos
Create, Destroy, Close e Open
Principais Eventos
OnClientConnect, OnClientDisconnect, OnClientError, OnClientRead, OnClientWrite, OnGetSocket,
OnGetThread, OnThreadEnd, OnThreadStart, OnAccept, OnListen
TSESSION
Descrio
Esse componente no pode ser explicitamente criado pelo programador, mas o Delphi sempre cria
automaticamente um componente chamado Session do tipo TSession para a sua aplicao. Esse
componente se encarrega de controlar a conexo aos bancos de dados relacionados com a aplicao.
Unit
Na VCL:
DBTables
DataBaseCount, DataBases, Handle, KeepConnections, Locale, Name, NetFileDir, Owner, PrivateDir e Tag
Principais Mtodos
AddPassword, CloseDataBase, DropConnections, FindDataBase, GetAliasNames, GetAliasParams,
GetDatabaseNames, GetDriverNames, GetDriverParams, GetPassword, GetTableNames, GetStoredProcNames,
OpenDatabase, RemoveAllPasswords e RemovePassWord
Principais Eventos
OnPassword
TSHAPE
Descrio
O componente TShape permite a exibio de formas geomtricas em um formulrio.
Unit
Na VCL:
ExtCtrls
Na CLX:
QExtCtrls
Align, BoundsRect, Brush, ComponentIndex, Cursor, DragCursor, DragMode, Enabled, Height, Hint, Left,
Name, Owner, Parent, ParentShowHint, Pen, Shape, ShowHint, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, ClientToScreen, Dragging, EndDrag, Hide, Invalidate, Refresh, Repaint,
ScaleBy, ScreenToClient, SendToBack, SetBounds, Show e Update
Principais Eventos
OnDragDrop, OnDragOver, OnEndDrag, OnMouseDown, OnMouseMove e OnMouseUp
TSIMPLEDATASET
Descrio
Este componente pode ser considerado como uma reunio de trs componentes: um SQLDataSet, um
DatasetProvider e um ClientDataset. Substitui o componente SQLClientDataset da verso 6.
Unit
Na VCL e na CLX:
SimpleDS
Active, ActiveAggs, AggFields, Aggregates, AggregatesActive, Appserver, AutoCalcFields,
BlockReadSize, Bof, Bookmark, CanModify, ChangeCount, CloneSource, CommandText, CommandType,
ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle,
ConnectionName, Constraints, Data, DataSetField, DataSize, DataSource, DBConnection, DefaultFields,
Delta, Designer, DesignInfor, DisableStringTrim, Eof, FetchOnDemand, FieldCound, FieldDefList,
FieldDefs, FieldList, Fields, FieldValues, FileName, Filter, Filtered, FilterOptions, Found,
GroupingLevel, HasProvider, IndexDefs, IndexFieldCount, IndexFieldNames, IndexFields, IndexName,
IsUnidirecional, KeyExclusive, KeyFieldCount, KeySize, LogChanges, MasterFields, MasterSource,
Modified, Name, ObjectView, Options, Owner, PacketRecords, Params, ReadOnly, RecNo, RecordCount,
RecordSize, SparseArrays, State, StatusFilter, Tag, UpdateMode, VCLComObject e XMLData
Principais Mtodos
ActiveBuffer, AddIndex, AfterConstruction, Append, AppendData, AppendRecord, ApplyRange,
ApplyUpdates, Assign, BookmarkValid, Cancel, CancelRange, CancelUpdates, CheckBrowseMode, ClassInfo,
ClassName, ClassNameIs, ClassParent, ClassType, ClenupInstance, ClearFields, CloneCursor,
CompareBookmarks, ConstraintsDisabled, ControlsDisabled, Create, CreateBlobStream, CreateDataSet,
CursorPosChanged, DataRequest, DefaultHandler, Delete, DeleteIndex, Destroy, DestroyComponents,
Destroying, DisableConstraints, DisableControls, Dispatch, Edit, EditKey, EditRangeEnd,
EditRangeStar, EmptyDataSet, EnableConstraints, EnableControls, Execute, ExecuteAction, FetchBlobs,
FetchDetails, FetchParams, FieldAddress, FieldByName, FindComponent, FindField, FindFirst, FindKey,
FindLast, FindNearest, FindNext, FindPrior, First, Free, FreeBookmarl, FreeInstance,
FreeNotification, FreeOnRelease, GetBlobFieldData, GetBookmark, GetCurrentRecord, GetDetailDatasets,
GetDetailLinkFields, GetFieldData, GetFieldList, GetFieldNames, GetGroupState, GetIndexInfo,
GetIndexNames, GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetNextPacket,
GetOptionalParam, GetParentComponent, GetQuoteChar, GotoBookmark, GotoCurrent, GotoKey, GotoNearest,
IsImplementorOf, IsLinkedTo, IsSequenced, Last, LoadFromFile, LoadFromStream, Locate, Lookup,
MergeChangeLog, MethodAddress, MethodName, MoveBy, NewInstance, Next, Open, Post, Prior, Reconcile,
ReferenceInterface, Refresh, RefreshRecord, RemoveComponent, RemoveFreeNotification, Resync,
RevertRecord, SaveCallException, SaveToFile, SaveToStream, SetAltRecBuffers, SetFields, SetKey,
SetOptionalParam, SetProvider, SetRange, SetRangeEnd, SetRangeStart, SetSubCompnent, Translate,
UndoLastChange, UpdateAction, pdateCursorPos, UpdateRecord e UpdateStatus
Principais Eventos
AfterApplyUpdates, AfterCancel, AfterClose, AfterDelete, AfterEdit, AfterExecute, AfterGetParams,
AfterGetRecords, AfterInsert, AfterOpen, AfterPost, AfterRefresh, AfterRowRequest, AfterScroll,
AfterUpdateRecord, BeforeApplyUpdates, BeforeCancel, BeforeClose, BeforeDelete, BeforeEdit,
BeforeExecute, BeforeGetParams, BeforeGetRecords, BeforeInsert, BeforeOpen, BeforePost,
BeforeRefresh, BeforeRowRequest, BeforeScroll, BeforeUpdateRecord, OnCalcFields, OnDeleteError,
OnEditError, OnFilterRecord, OnGetTableName, OnNewRecord, OnPostError, OnReconcileError,
OnUpdateData e OnUpdateError
TSIMPLEOBJECTBROKER
Descrio
Esse componente responsvel por fornecer uma lista de aplicaes-servidoras a um componente de conexo.
Unit
Na VCL:
ObjBrkr
LoadBalanced, ServerData, Servers
Principais Mtodos
Create, Destroy, GetComputerForGUID, GetComputerForProgID, GetPortForComputer, LoadFromStream,
SaveToStream, SetConnectStatus
Principais Eventos
TSMALLINTFIELD
Descrio
nmero inteiro, variando de -32,768 a 32,767.
Unit
Na VCL e na CLX:
DB
Principais Mtodos
Principais Eventos
TSOCKETCONNECTION
Descrio
Esse componente responsvel por conectar uma aplicao-cliente a um servidor remoto em uma
aplicao multicamada usando o Windows Socket.
Unit
Na VCL:
Sconnect
Address, Host, InterceptGUID, Port, AppServer, Connected, LoginPrompt, ObjectBroker, ServerGUID,
ServerName
Principais Mtodos
Create, CreateTransport, GetProvider, Destroy e DoConnect
Principais Eventos
AfterConnect, AfterDisconnect, BeforeConnect, BeforeDisconnect, OnGetUserName, OnLogin
TSPEEDBUTTON
Descrio
O controle TSpeedButton um boto de pressionamento especial, que permite a incluso de um
bitmap na sua face, e normalmente usado como boto de uma barra de ferramentas.
Unit
Na VCL:
Buttons
Na CLX:
QButtons
Align, AllowAllUp, BoundsRect, Caption, ComponentIndex, Cursor, Down, Enabled, Font, Glyph,
GroupIndex, Height, Hint, Layout, Left, Margin, Name, NumGlyphs, Owner, Parent, ParentFont,
ParentShowHint, ShowHint, Showing, Spacing, Tag, Top, Visible e Width
Principais Mtodos
BeginDrag, BringToFront, CanFocus, Click, ClientToScreen, Dragging, EndDrag, GetTextBuf, GetTextLen,
Hide, Invalidate, Refresh, Repaint, ScaleBy, ScreenToClient, SendToBack, SetBounds, SetTextBuf, Show
e Update
Principais Eventos
OnClick, OnDblClick, OnMouseDown, OnMouseMove e OnMouseUp
TSQLCONNECTION
Descrio
Este componente responsvel pelo acesso a bancos de dados atravs do Mecanismo DBExpress.
Unit
Na VCL e na CLX:
sqlExpr
ActiveStatements,AutoClone, ComponentCount, ComponentIndex, Components, ComponentState,
ComponentStyle, Connected, ConnectionName, ConnectionState, DataSetCount, DataSets, DesignInfo,
DriverName, GetDriverFunc, InTransaction, KeepConnection, LibraryName, LoadParamsOnConnect,
LocaleCode, LoginPrompt, MaxStmtsPerConn, MetaData, Name, Owner, Params, ParamsLoaded,
SQLConnection, SQLHourGlass, TableScope, Tag, TraceCallbackEvent, TransactionsSupported, VendorLib
Principais Mtodos
ClassType, CleanupInstance, CloneConnection, Close, CloseDataSets, Commit, Create, DefaultHandler,
Destroy, DestroyComponents, Destroying, Dispatch, Execute, ExecuteAction, ExecuteDirect,
FieldAddress, FindComponent, Free, FreeInstance, FreeNotification, GetFieldNames, GetIndexNames,
GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent,
GetProcedureNames, GetProcedureParams, GetTableNames, HasParent, InheritsFrom, InitInstance,
InsertComponent, InstanceSize, IsImplementorOf, LoadParamsFromIniFile, MethodAddress, MethodName,
NewInstance, Open, ReferenceInterface, RemoveComponent, RemoveFreeNotification, Rollback,
SafeCallException, SetSubComponent, SetTraceCallbackEvent, StartTransaction, UpdateAction
Principais Eventos
AfterConnect, AfterDisconnect, BeforeConnect, BeforeDisconnect, OnLogin.
TSQLDATASET
Descrio
Este componente permite acesso direto ou via declaraes sql a tabelas de bancos de dados atravs do
Mecanismo DBExpress.
Unit
Na VCL e na CLX:
sqlExpr
Active, AggFields, AutoCalcFields, BlockReadSize, Bof, Bookmark, CanModify, CommandText,
CommandType, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle,
DataSetField, Datasource, DefaultFields, Designer, DesignerData, DesignInfo, Eof, FieldCount,
FieldDefList, FieldDefs, FieldList, Fields, FieldValues, Filter, Filtered, FilterOptions, Found,
IndexFields, IsUnidirecional, MaxBlobSize, Modified, Name, ObjectView, Owner, ParamCheck, Params,
Prepared, RecNo, RecordCount, RecordSize, SortFieldNames, SparseArrays, SQLConnection, State, Tag,
TransactionLevel.
Principais Mtodos
ActiveBuffer, AfterConstruction, Append, AppendRecord, Assign, BeforeDestruction, BookmarkValid, Cancel,
CheckBrowseMode, ClassInfo, ClassName, ClassNameIs, ClassParent, ClassType, CleanupInstance, ClearFields,
Close, CompareBookmarks, ControlsDisabled, Create, CreateBlobStream, CursorPosChanged, DefaultHandler, Delete,
Destroy, DestroyComponents, Destroying, DisableControls, Dispatch, Edit, EnableControls, ExecSQL,
ExecuteAction, FieldAddress, FieldByName, FindComponent, FindField, FindFirst, FindLast, FindNext, FindPrior,
First, Free, FreeBookmark, FreeInstance, FreeNotification, GetBlobFieldData, GetBookmark, GetCurrentRecord,
GetDetailDataSets, GetDetailLinkFields, GetFieldData, GetFieldList, GetFieldNames, GetInterface,
GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, GotoBookmark, HasParent, InheritsFrom,
InitInstance, Insert, InsertComponent, InsertRecord, InstanceSize, IsEmpty, IsImplementorOf, IsLinkedTo,
IsSequenced. Last, Locate, Lookup, MethodAddress, MethodName, MoveBy, NewInstance, Next, Open, ParamByName,
Post, Prior, ReferenceInatance, Refresh, RemoveComponent, Resync, SafeCallException, SetFields, SetSchemaInfo,
SetSubComponent, Translate, UpdateAction, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
BeforePost, BeforeRefresh, BeforeScroll, OnCalcFields, OnDeleteError, OnEditError, OnFilterRecord,
OnNewRecord, OnPostError
TSQLMONITOR
Descrio
Este componente Permite interceptar comandos sql entre componentes de acesso e o serevidor de
banco de dados, atravs do Mecanismo DBExpress.
Unit
Na VCL e na CLX:
sqlExpr
Active, AutoSave, ComObject, ComponentCount, ComponentIndex, Components, ComponentState,
ComponentStyle,DesignInfo, FileName, MaxTraceCount, Name, Owner, SQLConnection, Tag, TraceCount,
TraceList e VCLComObject.
Principais Mtodos
ClassType, CleanupInstance, Create, Destroy, DestroyComponents, Destroying, Dispatch, ExecuteAction,
FieldAddress, FindComponent, Free, FreeInstance, FreeNotification, FreeOnRelease, GetInterface,
GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, HasParent, InheritsFrom,
InitInstance, InsertComponent, InstanceSize, IsImplementorOf, LoadFromFile, MethodAddress,
MethodName, NewInstance, ReferenceInterface, RemoveComponent, RemoveFreeNotification,
SafeCallException, SaveToFile, SetSubComponent e UpdateAction
Principais Eventos
OnLogTrace e OnTrace
TSQLQUERY
Descrio
Este componente permite acesso via declaraes sql a tabelas de bancos de dados atravs do Mecanismo
DBExpress.
Unit
Na VCL e na CLX:
sqlExpr
Active, AggFields, AutoCalcFields, BlockReadSize, Bof, Bookmark, BookmarkSize, BufferCount, Buffers,
CacheSize, CalcBuffer, CalcFieldsSize, CanModify, ComObject, ComponentCount, ComponentIndex,
Components, ComponentState, ComponentStyle, DataSetField, DataSource, DefaultFields, Designer,
DesignerData, DesignInfo, Eof, FieldCount, FieldDefList, FieldDefs, FieldList, Fields, FieldValues,
Filter, Filtered, FilterOptions, Found, IndexFields, IsUnidirecional, MaxBlobSize, Modified, Name,
NoMetadata, ObjectView, Owner, ParamCheck, Params, Prepared, RecNo, RecordCount, RecordSize,
RowsAffected, SparseArrays, SQL, SQLConnection, State, Tag, Text, TransisolationLevel, VCLComObject,
Principais Mtodos
Cancel, CheckBrowseMode, ClassInfo, ClassName, ClassNameIs, ClassParent, ClassType, CleanupInstance,
ClearFields, Close, CompareBookmarks, ControlsDisabled, Create, CreateBlobStream, CursorPosChanged,
DefaultHandler, Delete, DeleteRecords, Destroy, DestroyComponents, Destroying, DisableControls,
Dispatch, Edit, EnableControls, ExecSQL, ExecuteAction, FieldAddress, FieldByName, FindComponent,
FreeNotification, FreeOnRelease, GetBlobFieldData, GetBookmark, GetCurrentRecord, GetDetailDataSets,
GetInterfaceTable, GETKEYFIELDNAMES, GetNamePath, GetParentComponent, GetQuoteChar, GotoBookmark,
IsImplementorOf, IsLinkedTo, IsSequenced. Last, Locate, Lookup, MethodAddress, MethodName, MoveBy,
NewInstance, Next, Open, ParamByName, Post, PrepareStatement, Prior, ReferenceInterface, Refresh,
RemoveComponent, RemoveFreeNotification, Resync, SafeCallException, SetFields, SetSchemaInfo,
Principais Eventos
TSQLSTOREDPROC
Descrio
Esse componente permite que uma aplicao desenvolvida em Delphi execute procedimentos
armazenados em servidores, atravs do mecanismo DBExpress.
Unit
Na VCL e na CLX:
sqlExpr
Active, AggFields, AutoCalcFields, BlockReadSize, Bof, Bookmark, CanModify, ComObject,
ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, DataSetField,
DataSource, DefaultFields, Designer, DesignerData, DesignInfo, Eof, FieldCount, FieldDefList,
FieldDefs, FieldList, Fields, FieldValues, Filter, Filtered, FilterOptions, Found, IndexDefs,
IsUnidirecional, MaxBlobSize, Modified, Name, ObjectView, Owner, ParamCheck, Params, Prepared,
RecNo, RecordCount, RecordSize, SparseArrays, SQLConnection, State, Tag, VCLComObject
Principais Mtodos
DefaultHandler, Delete, Destroy, DestroyComponents, Destroying, DisableControls, Dispatch, Edit,
EnableControls, ExecProc, ExecuteAction, FieldAddress, FieldByName, FindComponent, FindField,
FindFirst, FindLast, FindNext, FindPrior, First, Free, FreeBookmark, FreeInstance, FreeNotification,
FreeOnRelease, GetBlobFieldData, GetBookmark, GetCurrentRecord, GetDetailDataSets,
GetInterfaceTable, GetKeyFieldNames, GetNamePath, GetParentComponent, GotoBookmark, HasParent,
InheritsFrom, InitInstance, Insert, InsertComponent, InsertRecord, InstanceSize, IsEmpty,
NewInstance, Next, NextRecordset, Open, ParamByName, Post, PrepareStatement, Prior,
ReferenceInstance, Refresh, RemoveComponent, RemoveFreeNotification, Resync, SafeCallException,
SetSchemaInfo, SetSubComponent, Translate, UpdateAction, UpdateCursorPos, UpdateRecord, UpdateStatus
Principais Eventos
TSQLTABLE
Descrio
Este componente permite acesso direto a tabelas de bancos de dados atravs do Mecanismo Activex
Data Objects (ADO).
Unit
Na VCL e na CLX:
sqlExpr
Active, AggFields, AutoCalcFields, BlockReadSize, Bof, Bookmark, CanModify, ComObject,
ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, DataSetField,
DataSource, DefaultFields, Designer, DesignerData, DesignInfo, Eof, FieldCount, FieldDefList,
FieldDefs, FieldList, Fields, FieldValues, Filter, Filtered, FilterOptions, Found, IndexFields,
IndexName, IsUnidirecional, MasterFields, Mastersource, MaxBlobSize, Modified, Name, NoMetadata,
ObjectView, Owner, Prepared, RecNo, RecordCount, RecordSize, SparseArrays, SQL, SQLConnection,
State, TableName, Tag, TransisolationLevel, VCLComObject,
Principais Mtodos
DefaultHandler, Delete, DeleteRecords, Destroy, DestroyComponents, Destroying, DisableControls,
Dispatch, Edit, EnableControls, ExecuteAction, FieldAddress, FieldByName, FindComponent, FindField,
FindFirst, FindLast, FindNext, FindPrior, First, Free, FreeBookmark, FreeInstance, FreeNotification,
FreeOnRelease, GetBlobFieldData, GetBookmark, GetCurrentRecord, GetDetailDataSets,
GetInterfaceTable, GetKeyFieldNames, GetNamePath, GetParentComponent, GetQuoteChar, GotoBookmark,
NewInstance, Next, Open, ParamByName, Post, PrepareStatement, Prior, ReferenceInterface, Refresh,
RemoveComponent, RemoveFreeNotification, Resync, SafeCallException, SetFields, SetSchemaInfo,
Principais Eventos
OnNewRecord, OnPostError.
TSTACK
Descrio
Esta classe permite manipular objetos usando uma estrutura de dados do tipo Pilha. Neste tipo de
estrutura de dados, o primeiro elemento a entrar o ltimo a sair, sendo comumente denominada
estrutura do tipo LIFO Last In, First Out
Unit
Contnrs
Principais Mtodos
AfterConstruction, AtLeast, BeforeDestruction, ClassInfo, ClassName, ClassNameIs, ClassParent,
ClassType, CleanupInstance, Count, Create, DefaultHandler, Destroy, Dispatch, FieldAddress, Free,
FreeInstance, GetInterface, GetInterfaceEntry, GetInterfaceTable, InheritsFrom, InitInstance,
InstanceSize, MethodAddress, MethodName, NewInstance, Peek, Pop, Push, SafeCallException
Principais Eventos
TSTATUSBAR
Descrio
O controle TStatusBar um componente que permite que se exiba uma barra de status na janela
principal de uma aplicao (geralmente a barra de status horizontal e fica situada na parte inferior da
janela) para transmitir informaes ao usurio.
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
ComponentIndex, Components, ControlCount, Controls, Cursor, DragCursor, DragMode, Enabled, Font,
Handle, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Owner, Panels, Parent,
ParentFont, ParentShowHint, PopupMenu, ShowHint, SimplePanel, SimpleText, SizeGrip, Tag, Top,
Visible e Width
Principais Mtodos
Principais Eventos
OnClick, OnDblClick, OnDragDrop, OnDragOver, OnDrawPanel, OnEndDrag, OnMouseDown, OnMouseMove,
OnMouseUp, OnResize e OnStartDrag
TSTOREDPROC
Descrio
Esse componente permite que o Delphi execute procedimentos armazenados em servidores.
Unit
Na VCL:
DBTables
Active, AutoCalcFilelds, BOB, CanModify, Database, DatabaseName, DBHandle, DBLocale, EOF,
FieldCount, FieldDefs, Field, Handle, Locale, Modified, Name, Owner, Overload, ParamBindMode,
ParamCount, Params, Prepared, RecordCount, State, StmtHandle, StoredProcName e Tag
Principais Mtodos
Append, AppendRecord, Cancel, CheckBrowseMode, ClearFields, Close, CopyParams, CursorPosChanged,
Delete, DescriosAvailable, DisableControls, Edit, EnableControls, ExecProc, FieldByName,
FindField, First, FreeBookmark, GetBookmark, GetFieldNames, GetResults, GotoBookmark, Insert,
InsertRecord, Last, MoveBy, Next, Open, ParamByName, Post, Prepare, Prior, Refresh, SetFields,
UnPrepared, UpdateCursorPos e UpdateRecord
Principais Eventos
BeforeClose, BeforeDelete, BeforeEdit, BeforeInsert, BeforeOpen, BeforePost, OnCalcFields e
OnNewRecord
TSTRINGFIELD
Descrio
informao de texto com at 255 caracteres (string).
Unit
Na VCL e na CLX:
DB
Align, AsBoolean, AsDateTime, AsFloat, AsInteger, ASSQLTimeStamp, AsString, Calculated, CanModify,
DataSet, DataSize, DataType, DisplayLabel, DisplayName, DisplayText, DisplayWisth, EditMask,
Tag, Text, Transliterate, Value e Visible
Principais Mtodos
Principais Eventos
TSTRINGGRID
Descrio
O controle TStringGrid permite a exibio de um conjunto de strings e dados na forma de um arranjo
de linhas e colunas.
Unit
Na VCL:
Grids
Na CLX:
QGrids
Align, BorderStyle, BoundsRect, Canvas, Cells, ClientHeigth, ClentOrigin, ClientRect, ClientWidth,
Col, ColCount, Color, Cols, ColWidthds, ComponentCount, ComponentIndex, Components, ControlCount,
Controls, DefaultRow, DockClirentCount, DockClients, DragCursor, DragMode, EditorMode, Enabled,
FixedColors, FixedCols, FixedRows, Font, GridHeight, GridLineWidth, GridWidth, Handle, Height,
HelpContext, HelpKeyword, HelpTypeHint, Left, LeftCol, Name, ParentColor, ParentCtrl3D, ParentFont,
ParentShowHint, PopupMenu, Row, RowCount, RowHeights, Rows, ScrollBars, Selection, ShowHint,
Showing, TabOrder, TabStop, TabStops, Tag, Top, TopRow
Principais Mtodos
BeginDrag, BringToFront, CanFocus, CellRect, ClientToScreen, Dragging, EndDrag, Focused, GetTextBuf,
GetTextLen, Hide, Invalidate, MouseToCell, Refresh, RemoveComponent, Repaint, ScaleBy,
ScreenToClient, SendToBack, SetBounds, SetFocus, SetTextBuf, Show e Update
Principais Eventos
OnClick, OnColumnMoved, OnDblClick, OnDragDrop, OnDragOver, OnDrawCell, OnEndDrag, OnEnter, OnExit,
OnGetEditMask, OnGetEditText, OnKeyDown, OnKeyPress, OnKeyUp, OnMouseDown, OnMouseMove, OnMouseUp,
OnRowMoved, OnSelectCell, OnSetEditText e OnTopLeftChanged
TSTRINGLIST
Descrio
Esse objeto utilizado para manter uma lista de strings.
Unit
Na VCL e na CLX:
Classes
Count, Duplicates, Objects, Sorted, Strings e Values
Principais Mtodos
Add, AddObject, AddStrings, Assign, BeginUpdate, ClassName, ClassParent, ClassType, Clear, Delete,
EndUpdate, Exchange, Free, GetText, IndexOf, IndexOfObject, Insert, InsertObject, LoadFromFile,
SaveToFile, SetText e Sort
Principais Eventos
OnChange
TSTRINGS
Descrio
Esse objeto utilizado para manipular strings.
Unit
Na VCL e na CLX:
Classes
Count, Objects, Strings e Values
Principais Mtodos
Add, AddObject, AddStrings, Assign, BeginUpdate, ClassName, ClassParent, ClassType, Clear, Delete,
EndUpdate, Exchange, Free, GetText, IndexOf, IndexOfObject, Insert, InsertObject, LoadFromFile,
Move, SaveToFile, SetText e Sort
Principais Eventos
OnChange
TTABBEDNOTEBOOK
Descrio
O componente TTabbedNotebook um componente que possui muitas pginas, cada uma com os seus
prprios controles. O usurio pode selecionar uma pgina clicando com o mouse sobre a guia correspondente.
Unit
Na VCL:
TabNotBk
ActivePage, Align, BoundsRect, ComponentIndex, ControlCount, Controls, Cursor, Enabled, Font,
Handle, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name, Owner, PageIndex, Pages, Parent,
TabOrder, TabsPerRow, TabStop, Tag, Top, Visible e Width
Principais Mtodos
FindComponent, Focused, GetIndexForPage, GetTextBuf, GetTextLen, Hide, InsertControl, Invalidate,
Refresh, Repaint, ScaleBy, ScreenToClient, ScrollBy, SendToBack, SetBounds, SetFocus, SetTabFocus,
SetTextBuf, Show e Update
Principais Eventos
OnEnter e OnExit
TTABCONTROL
Descrio
Esse controle semelhante ao controle TTabSet, e fornece um conjunto de guias horizontais que o
usurio pode selecionar para iniciar determinadas aes. Normalmente, esse controle usado em
conjunto com um controle do tipo TPageControl.
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
ComponentIndex, Components, ControlCount, Controls, Cursor, DesignInfo, DisplayRect, DragCursor,
DragMode, Enabled, Font, Handle, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, MultiLine,
Name, Owner, Parent, ParentFont, ParentShowHint, PopupMenu, ShowHint, TabHeight, TabIndex, TabOrder,
TabStop, TabWidth, Tabs, Tag, Top, Visible e Width
Principais Mtodos
Assign, BeginDrag, BringToFront, BroadCast, CanFocus, ClassInfo, ClassName, ClassNamels,
ClassParent, ClassType, CleanupInstance, ClientToScreen, ContainsControl, ControlAtPos, Create,
Destroy, DestroyComponents, Destroying, DisableAlign, Dispatch, DragDrop, Dragging, EnableAlign,
EndDrag, FieldAddress, FindComponent, Focused, Free, FreeInstance, FreeNotification,
GetTabOrderList, GetTextBuf, GetTextLen, HandleAllocated, HandleNeeded, Hide, InheritsFrom,
InitInstance, InsertComponent, InsertControl, InstanceSize, Invalidate, MethodAddress, MethodName,
NewInstance, PaintTo, Perform, Realign, Refresh, RemoveComponent, RemoveControl, Repaint, ScaleBy,
ScreenToClient, ScrollBy, SendToBack, SetBounds, SetFocus, SetTextBuf, Show, Update e
UpdateControlState
Principais Eventos
OnChange, OnChanging, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnMouseDown, OnMouseMove,
OnMouseUp, OnStartDrag
TTABLE
Descrio
Esse componente permite acesso a tabelas de bancos de dados por meio do Borland Database Engine.
Unit
Na VCL:
DBTables
Active, AutoCalcFilelds, BOB, CanModify, Database, DatabaseName, DBHandle, DBLocale, DatabaseSource,
DBLocale, EOF, Exclusive, FieldCount, FieldDefs, Fields, Handle, IndexDefs, IndexFieldCount,
IndexFieldNames, IndexName, IndexFields, KeyExclusive, KeyFieldCount, Local, MasterField,
MasterSource, Locale, Modified, Name, Owner, ReadOnly, RecordCount, State, StoredDefs, TableLevel,
TableName, TableType, Tag e UpdateMode
Principais Mtodos
AddIndex, ApplyRange, Append, AppendRecord, BatchMove, Cancel, CancelRange, CheckBrowseMode,
ClearFields, Close, CreateTable, CursorPosChanged, Delete, DeleteIndex, DeleteTable,
DisableControls, Edit, EditKey, EditRangeEnd, EditRangeStart, EmptyTable, EnableControls,
FieldByName, FindField, FindKey, FindNearest, First, FreeBookmark, GetBookmark, GetFieldNames,
GetIndexNames, GotoBookmark, GotoCurrent, GotoKey, GotoNearest, Insert, InsertRecord, Last, MoveBy,
Next, Open, Post, Prior, Refresh, SetFields, SetKey, SetRange, SetRamgeEnd, SetRamgeStart e
UpdateRecord
Principais Eventos
BeforeClose, BeforeDelete, BeforeEdit, BeforeInsert, BeforeOpen, BeforePost, OnCalcFields e
OnNewRecord
TTABSET
Descrio
O componente TTabSet fornece um conjunto de guias horizontais que o usurio pode selecionar para
iniciar determinadas aes. Normalmente, esse controle usado em conjunto com um controle do
tipo TNotebook.
Unit
Na VCL:
Tabs
Align, AutoScroll, BackgroundColor, Canvas, ComponentIndex, Cursor, DitherBackground, DragMode,
Enabled, EndMargin, FirstIndex, Font, Height, HelpContext, HelpKeyword, HelpTypeHint, Left, Name,
Owner, Parent, ParentShowHint, SelectedColor, ShowHint, Showing, StartMargin, Style, TabHeigth,
TabIndex, Tabs, Tag, Top, UnselectedColor, Visible, VisibleTabs e Width
Principais Mtodos
GetTextLen, Hide, Invalidate, ItemAtPos, ItemRect, Refresh, Repaint, ScaleBy, ScreenToClient,
ScrollBy, SelectNext, SendToBack, SetBounds, SetFocus, SetTextBuf e Update
Principais Eventos
OnChange, OnClick, OnDragDrop, OnDragOver, OnDrawTab, OnEndDrag, OnEnter, OnExit e OnMeasureItem
TTABSHEET
Descrio
Esse componente representa uma pgina de um controle do tipo TPageControl.
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
Align, BoundsRect, Brush, Caption, ClientHeight, ClientOrigin, ClentRect, ClientWidth,
ComponentCount, ComponentIndex, Components, ControlCount, Controls, Cursor, Enabled, Handle, Height,
HelpContext, HelpKeyword, HelpTypeLeft, Name, Owner, PageControl, PageIndex, Parent, ParentShowHint,
PopupMenu, ShowHint, TabIndex, TabOrder, TabStop, TabVisible, Tag, Top, Visible e Width
Principais Mtodos
Principais Eventos
OnEnter e OnExit
TTHREAD
Descrio
Essa classe permite desenvolver aplicaes com vrios processos independentes (cada processo
denominado um thread ou canal de execuo).
Unit
Na VCL e na CLX:
classes
FreeOnTerminate, Handle, Priority, ReturnValue, Suspended, Terminated, ThreadID
Principais Mtodos
Create, Destroy, DoTerminate, Execute, Resume, Suspend, Synchronize, Terminate e WaitFor
Principais Eventos
OnTerminate
TTIMEFIELD
Descrio
informao de uma hora.
Unit
Na VCL e na CLX:
DB
Tag, Text, e Visible
Principais Mtodos
Principais Eventos
TTIMER
Descrio
Esse componente dispara um evento OnTimer a intervalos regulares de tempo.
Unit
Na VCL:
ExtCtrls
Na CLX:
QExtCtrls
ComponentIndex, Enabled, Interval, Name, Owner e Tag
Principais Mtodos
Principais Eventos
OnTimer
TTOOLBAR
Descrio
O componente TToolBar utilizado para criao de barras de ferramentas no padro Windows.
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
ButtonCount, ButtonHeight, Buttons, ButtonWidth, Constraints, DisabledImages, DockSite, DragKind,
Flat, HotImages, Images, Indent, List, RowCount, ShowCaptions, Transparent, Wrapable, BorderWidth,
EdgeBorders, EdgeInner, EdgeOuter, Brush, ClientOrigin, ClientRect, ControlCount, Controls, Ctl3D,
Handle, HelpContext, HelpKeyword, HelpTypeParentWindow, Showing, TabOrder, TabStop, Align, Anchors,
AutoSize, BoundsRect, Caption, ClientHeight, ClientWidth, Color, ControlState, ControlStyle, Cursor,
DragCursor, DragMode, Enabled, Font, Height, Hint, Left, Name, Parent, ParentColor, ParentFont,
ParentShowHint, PopupMenu, ShowHint, Top, Visible, Width, WindowProc, ComObject, ComponentCount,
ComponentIndex, Components, ComponentState, ComponentStyle, DesignInfo, Owner, Tag, VCLComObject
Principais Mtodos
CanAutoSize, CancelMenu, ChangeScale, CheckMenuDropdown, ClickButton, Create, Destroy,
FindButtonFromAccel, InitMenu, TrackMenu, WrapButtons
Principais Eventos
OnDockDrop, OnDockOver, OnEnter, OnExit, OnGetSiteInfo, OnUnDock, OnClick, OnDblClick, OnDragDrop,
OnDragOver, OnEndDock, OnEndDrag, OnMouseDown, OnMouseMove, OnMouseUp, OnResize, OnStartDock,
OnStartDrag
TTRACKBAR
Descrio
O controle TTrackBar consiste em uma barra opcionalmente graduada, usada para definir valores em
uma escala e possuindo um controle deslizante que permite alterar o valor corrente.
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
ComponentIndex, Components, ControlCount, Controls, Ctl3D, Cursor, DragCursor, DragMode, Enabled,
Frequency, Handle, Height, Hint, HelpContext, HelpKeyword, HelpTypeLeft, LineSize, Max, Min, Name,
Orientation, Owner, PageSize, Parent, ParentCtl3D, ParentShowHint, PopupMenu, Position, ReadOnly,
SelEnd, SelStart, ShowHint, Showing, TabOrder, TabStop, Tag, TickMarks, TickStyle, Top, Visible e
Width
Principais Mtodos
Principais Eventos
OnChange, OnDragDrop, OnDragOver, OnEndDrag, OnEnter, OnExit, OnKeyDown, OnKeyPress, OnKeyUp e
OnStartDrag
TTREEVIEW
Descrio
O controle TTreeView um componente que permite a exibio de itens em vrios nveis hierrquicos,
nos quais cada item composto de um rtulo e de um nmero varivel de bitmaps (opcional).
Unit
Na VCL:
ComCtrls
Na CLX:
QComCtrls
Align, BorderStyle, BoundsRect, Brush, ClientHeight, ClientOrigin, ClentRect, ClientWidth, Color,
ComponentCount, ComponentIndex, Components, ControlCount, Controls, Ctl3D, Cursor, DragCursor,
DragMode, DropTarget, Enabled, Font, Handle, Height, HelpContext, HelpKeyword, HelpTypeHideSelection,
Hint, Images, Indent, Items, Left, Name, Owner, Parent, ParentColor, ParentCtl3D, ParentFont,
ParentShowHint, PopupMenu, ReadOnly, Selected, ShareImages, ShowButtons, ShowHint, Showing, ShowLines,
ShowRoot, Sorted, SortType, StateImages, TabOrder, TabStop, Tag, Top, TopItem, Visible e Width
Principais Mtodos
AlphaSort, Assign, BeginDrag, BringToFront, CanFocus, ClassName, ClassParent, ClassType,
ClientToScreen, ContainsControl, ControlAtPos, Create, CustomSort, Destroy, DragDrop, Dragging,
EndDrag, FindComponent, Focused, Free, FullCollapse, FullExpand, GetHitTestInfoAt, GetNodeAt,
GetTextBuf, GetTextLen, HandleAllocated, HandleNeeded, Hide, InsertComponent, InsertControl,
Invalidate, IsEditing, LoadFromFile, LoadFromStream, Refresh, RemoveComponent, RemoveControl,
Repaint, SaveToFile, SaveToStream, ScaleBy, ScreenToClient, ScrollBy, SendToBack, SetBounds,
Principais Eventos
OnChange, OnChanging, OnClick, OnCollapsed, OnCollapsing, OnCompare, OnDblClick, OnDeletion,
OnDragDrop, OnDragOver, OnEdited, OnEditing, OnEndDrag, OnEnter, OnExit, OnExpanded, OnExpanding,
OnGetImageIndex, OnGetSelectedIndex, OnKeyDown, OnKeyPress, OnKeyUp, OnMouseDown, OnMouseMove,
OnMouseUp e OnStartDrag
TUPDATESQL
Descrio
O componente TUpdateSQL fornece um meio alternativo de se atualizar bancos de dados, atravs do
mecanismo do Borland Database Engine, armazenando um comando para cada tipo de declarao SQL.
Unit
Na VCL:
DBTables
ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle, DataSet,
DeleteSQL, DesignInfo, InsertSQL, ModifySQL, Name, Owner, Query, SQL, Tag, VCLComObject
Principais Mtodos
AfterConstruction, Apply, Assign, BeforeDestruction, ClassInfo, ClassName, ClassNameIs, ClassParent,
Dispatch, ExecSQL, ExecuteAction, FieldAddress, FindComponent, Free, FreeInstance, FreeNotification,
NewInstance, RemoveComponent, SafeCallException, SetParams, UpdateAction
Principais Eventos
TUPDOWN
Descrio
O controle TUpDown consiste em um par de botes de seta, uma apontando para cima (Up) e outra
apontando para baixo (Down), que, ao serem selecionadas com o boto esquerdo do mouse, provocam
o incremento ou decremento de um valor numrico, armazenado na sua propriedade Position.
Normalmente esse controle usado em conjunto com outro controle (geralmente TEdit), que exibe o
valor numrico armazenado na propriedade Position.
Unit
Na VCL:
ComCtrls
Align, AlignButton, Associate, ArrowKeys, BoundsRect, Brush, ClientHeight, ClientOrigin, ClentRect,
ClientWidth, ComponentCount, ComponentIndex, Components, ControlCount, Controls, Cursor, Enabled,
Handle, Height, Hint, HelpContext, HelpKeyword, HelpTypeIncrement, Left, Max, Min, Name,
Orientation, Owner, Parent, ParentShowHint, PopupMenu, Position, ShowHint, Showing, TabOrder,
TabStop, Tag, Thousands, Top, Visible, Width e Wrap
Principais Mtodos
Principais Eventos
OnChanging, OnClick, OnEnter, OnExit, OnMouseDown, OnMouseMove e OnMouseUp
TVARBYTESFIELD
Descrio
conjunto arbitrrio de at 65535 bytes.
Unit
Na VCL e na CLX:
DB
Tag, Text e Visible
Principais Mtodos
Principais Eventos
TWEBDISPATCHER
Descrio
Esse componente gerencia resposta a mensagens HTTP.
Unit
Na VCL e na CLX:
httpapp
Action, Actions, Request, Response, DesignOffset, DesignSize, OldCreateOrder
Principais Mtodos
ActionByName, Create, Destroy, AfterConstruction, BeforeDestruction, CreateNew
Principais Eventos
AfterDispatch, BeforeDispatch, OnCreate, OnDestroy
TWORDFIELD
Descrio
nmero inteiro sem sinal, variando de 0 a 65535.
Unit
Na VCL e na CLX:
DB
Principais Mtodos
Principais Eventos
OnChange, OnGetText, OnSetText e OnValidate.
TXMLBROKER
Descrio
Este componente Permite a Manipulao de Pacotes de dados no formato XML fornecidos por uma
aplicao Servidora.
Unit
xmlbrokr
AppServer, ComObject, ComponentCount, ComponentIndex, Components, ComponentState, ComponentStyle,
Connected, DesignInfo, HasAppServer, MaxErrors, MaxRecords, Name, Notify, NotifyCount, Owner,
Params, ProviderName, ReconcileProducer, RemoteServer, Tag, VCLComObject, WebDispatch
Principais Mtodos
AddNotify, AfterConstruction, ApplyXMLUpdates, Assign, BeforeDestruction, ClassInfo, ClassName,
ClassNameIs, ClassParent, ClassType, CleanupInstance, Create, DefaultHandler, Destroy,
DestroyComponents, Destroying, Dispatch, ExecuteAction, FetchParams, FieldAddress, FindComponent,
Free, FreeInstance, FreeNotification, FreeOnRelease, GetDelta, GetErrorCount, GetErrors,
GetInterface, GetInterfaceEntry, GetInterfaceTable, GetNamePath, GetParentComponent, GetXMLRecords,
HasParent, HTMLSubmitFormName, InheritsFrom, InitInstance, InsertComponent, InstanceSize,
MasterRowSetVarName, MethodAddress, MethodName, NewInstance, RemoveComponent, RemoveNotify,
RequestRecords, RequestUpdate, RowSetVarName, SafeCallException, SetProvider, SubmitFormVarName
UpdateAction
Principais Eventos
AfterDispatch, BeforeDispatch, OnGetErrorResponse, OnGetResponse, OnRequestRecords e OnRequestUpdate
CAPTULO 41 PROPRIEDADES
Captulo
Propriedades
41
ABORTED
Descrio
A propriedade Aborted declarada como uma varivel do tipo booleana, e indica se o usurio
interrompeu o trabalho de impresso corrente. Essa propriedade s est disponvel durante a execuo
do aplicativo, e no pode ter o seu valor diretamente alterado pelo usurio.
Componentes aos quais se aplica:
Durante a execuo do aplicativo:
TBaseReport, TCanvasReport, TPrinter, TRvNDRWriter, TRvRenderPreview, TRvRenderPrinter.
ABORTONKEYVIOL
Descrio
Essa propriedade definida como uma varivel booleana que determina se a execuo do Mtodo
Execute deve ser interrompida caso ocorra uma violao de integridade durante uma operao sobre
um grupo de registros ou uma tabela.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou mediante uma linha
de cdigo como:
BatchMove1.AbortOnKeyViol := False;
onde BatchMove1 um componente do tipo TBatchMove.
Na fase de projeto:
TBatchMove
TBatchMove
ABORTONPROBLEM
Descrio
Essa propriedade definida como uma varivel booleana que determina se a execuo do Mtodo
Execute deve ser interrompida caso ocorra uma violao de integridade durante uma operao sobre
um grupo de registros ou uma tabela, descartando a movimentao de dados realizada.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector, ou mediante uma linha
de cdigo como:
BatchMove1.AbortOnProblem := False;
onde BatchMove1 um componente do tipo TBatchMove.
Na fase de projeto:
TBatchMove
TBatchMove
ACCURACYMETHOD
Descrio
Esta propriedade declarada como uma varivel do tipo TAccuracyMethod, e indica como o texto ser
escrito no arquivo de projeto. Se seu valor for igual a amPositioning o texto ser escrito de forma a ser
reproduzido to precisa quanto possvel na tela ou em qualquer impressora. Se seu valor for igual a
amAppearance o texto no ser ajustado da melhor forma possvel, de forma a ter a mesma aparncia
na tela e na impressora.
TBaseReport, TCanvasReport, TPrinter, TRvNDRWriter, TRvRenderPreview, TRvRenderPrinter
ACTIONCOUNT
Descrio
Essa propriedade definida como uma varivel inteira, e retorna o nmero de aes (representadas por
objetos da classe TAction) definidas no componente.
Na fase de projeto:
TActionList
TActionList
ACTIONLIST
Descrio
Essa propriedade definida como um objeto da classe TCustomActionList, e define o componente
TAction ao qual o objeto est vinculado.
Na fase de projeto:
TAction
TAction
ACTIONS
Descrio
Essa propriedade definida como uma array de objetos da classe TAction, e referencia as aes definidas
no componente.
Na fase de projeto:
TActionList
TActionList
ACTIVE
Descrio
A propriedade Active definida como uma varivel booleana que diz se um controle est ou no ativo.
Essa propriedade s est disponvel durante a execuo do aplicativo.
Para componentes do tipo TForm, essa propriedade no pode ter o seu valor diretamente alterado pelo
usurio.
Para componentes do tipo TOLEContainer essa propriedade determina se o objeto OLE contido no
componente est ou no ativo.
Para componentes dos tipos TADODataset, TADOQuery, TADOStoredProc, TADOTable, TClientDataSet,
TIBDataset, TIBQuery, TIBStoredProc, TIBTable, TIBTransaction, TTable, TQuery, TdecisionQuery,
TStoredProc, TSQLDataset, TSQLQuery, TSQLStoredProc, TSQLTable e TSQLClientDataSet, essa
propriedade determina se o banco de dados associado est ativo (aberto). Mudar o valor da propriedade
para True ou False equivale a chamar os mtodos Open e Close, respectivamente.
Para componentes do tipo TAnimate, indica se o clipe AVI definido na sua propriedade FileName est
sendo executado.
Para objetos da classe TChartSeries, indica se a srie representada pelo componente deve ou no ser
exibida.
Para componentes do tipo TRvProject, indica se o projeto de relatrio est ou no ativo.
Exemplo
Voc pode alterar o valor da propriedade Active do componente diretamente no Object Inspector ou
durante a execuo do aplicativo, incluindo uma linha de cdigo como:
OLEContainer1.Active := True;
Na fase de projeto:
TAnimate, TChartSeries, TClientDataSet, TADODataset, TADOQuery, TADOStoredProc, TADOTable,
TClientDataSet, TIBDataset, TIBQuery, TIBStoredProc, TIBTable, TIBTransaction, TRvProject, TTable,
TQuery, TDecisionQuery e TStoredProc
TAnimate, TChartSeries, TForm, TOLEContainer, TClientDataSet, TADODataset, TADOQuery,
TADOStoredProc, TADOTable, TClientDataSet, TIBDataset, TIBQuery, TIBStoredProc, TIBTable,
TIBTransaction, TRvProject, TTable, TQuery, TDecisionQuery e TStoredProc
ACTIVECONTROL
Descrio
A propriedade Active definida como uma varivel do tipo TWinControl, cujo significado depende do
componente ao qual se aplica.
Para componentes do tipo TForm, essa propriedade indica o componente que possui o foco da aplicao.
Para componentes do tipo TScreen, essa propriedade indica o componente que tem o foco da aplicao,
mas s est disponvel durante a execuo do aplicativo e no pode ter o seu valor diretamente alterado
pelo usurio.
Exemplo
Voc pode alterar a propriedade ActiveControl do componente diretamente no Object Inspector ou
Form1.ActiveControl := Button1;
Na fase de projeto:
TForm
TForm e TScreen
ACTIVEFORM
Descrio
A propriedade ActiveForm definida como uma varivel do tipo TForm e indica o formulrio corrente
ou que receber o foco quando a aplicao estiver ativa (no caso de o Windows estar executando uma
outra aplicao). Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter
o seu valor diretamente alterado pelo usurio.
Exemplo
O trecho de cdigo a seguir muda a cor do formulrio corrente para amarelo quando recebe um clique
do mouse:
procedure TForm1.FormClick(Sender: TObject);
begin
Screen.ActiveForm.Color := clYellow;
end;
TScreen
ACTIVEMDICHILD
Descrio
A propriedade ActiveMDIChild definida como uma varivel do tipo TForm, que retorna a janela-
filha que possui o foco em uma aplicao MDI. Essa propriedade s est disponvel durante a execuo
do aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
Exemplo
Voc no pode alterar a propriedade ActiveMDIChild do componente, mas pode usar o seu resultado.
O trecho de cdigo abaixo faz com que, quando o usurio clicar sobre um boto Button do tipo
TButton, a janela-filha ativa de uma aplicao MDI assuma a cor amarela.
var
YellowForm: TForm;
begin
YellowForm := Form1.ActiveMDIChild;
YellowForm.Color := clYellow;
end;
TForm
ACTIVEPAGE
Descrio
A propriedade ActivePage definida como uma varivel do tipo string, que retorna a pgina exibida
pelo componente.
Para componentes do tipo TPageControl, definida como uma varivel do tipo TTabSheet, que retorna
a pgina exibida pelo componente.
Exemplo
Voc pode alterar a propriedade ActivePage do componente diretamente no Object Inspector ou
mediante uma linha de cdigo, como:
Notebook1.ActivePage := Primeira pgina;
Na fase de projeto:
TPageControl, TNotebook e TTabbedNotebook
TPageControl, TNotebook e TTabbedNotebook
ALIASNAME
Descrio
A propriedade AliasName definida como uma varivel do tipo TSymbolstr que especifica seu alias no
Borland Database Engine (BDE).
Exemplo
Voc pode alterar a propriedade AliasName diretamente no Object Inspector ou mediante uma linha
de cdigo, como:
TDatabase1.AliasName := USER;
Na fase de projeto:
TDatabase
TDatabase
ALIGN
Descrio
A propriedade Align declarada como uma varivel do tipo TAlign e determina como deve ser o
alinhamento do controle em relao ao seu controle-pai (aquele que o contm).
Tabela de Valores:
Se o componente-pai redimensionado, as dimenses do componente considerado sero automaticamente ajustadas, em correspondncia
ao valor especificado na propriedade Align.
Exemplo
Coloque um componente Panel em um formulrio vazio e defina a sua propriedade Align como alTop.
Em seguida, coloque um componente Tabbed Notebook dentro do componente Panel e defina sua
propriedade Align como alClient.
importante notar que, nesse caso, o componente-pai do componente Panel o formulrio Form1,
enquanto que o componente-pai de Tabbed Notebook o componente Panel. Conseqentemente, a
rea-cliente a ser ocupada pelo componente Tabbed Notebook a do componente Panel e no a do
formulrio Form1.
Na fase de projeto:
TBevel, TDBGrid, TDBRadioGroup, TDecisionPivot, TDirectoryListBox, TDrawGrid, TFileListBox,
TGroupBox, THeader, THeaderControl, TImage, TIWDBGrid, TLabel, TListBox, TListView, TMaskEdit,
TMemo, TNotebook, TOutline, TPaintBox, TPageControl, TPanel, TProgressBar, TRadioGroup, TRichEdit,
TScrollBox, TStatusBar, TStringGrid, TTabControl, TTabbedNotebook, TTabSet e TTreeView
TBevel, TDBGrid, TDBRadioGroup, TDecisionPivot, TDirectoryListBox, TDrawGrid, TFileListBox,
TGroupBox, THeader, THeaderControl, TImage, TIWDBGrid, TLabel, TListBox, TListView, TMaskEdit,
TMemo, TNotebook, TOutline, TPaintBox, TPageControl, TPanel, TProgressBar, TRadioGroup, TRichEdit,
TScrollBox, TStatusBar, TStringGrid, TTabControl, TTabbedNotebook, TTabSet e TTreeView
Valor Significado
alNone O componente permanece no local em que foi colocado no formulrio (valor default).
alTop O componente se desloca para o topo do componente-pai e automaticamente
redimensionado, de forma a ocupar toda a largura do componente-pai, mantendo-se
a sua altura original.
alBottom O componente se desloca para a base do componente-pai e automaticamente
redimensionado, de forma a ocupar toda a largura do componente-pai, mantendo-se
a sua altura original.
alLeft O componente se desloca para a extremidade esquerda do componente-pai e
automaticamente redimensionado, de forma a ocupar toda a altura do componente-
pai, mantendo-se a sua largura original.
alRight O componente se desloca para a extremidade esquerda do componente-pai e
automaticamente redimensionado, de forma a ocupar toda a altura do componente-
pai, mantendo-se a sua largura original.
alClient O componente redimensionado para ocupar toda a rea-cliente do componente-pai.
ALIGNBUTTON
Descrio
Essa propriedade declarada como uma varivel do tipo TUDAlignButton e determina a posio do
componente em relao ao controle definido na sua propriedade Associate.
Tabela de Valores:
Na fase de projeto:
TUpDown
TUpDown
ALIGNMENT
Descrio
Para controles dos tipos TCheckBox, TDBCheckBox e TRadioButton, a propriedade Alignment uma
varivel do tipo TLeftRight que determina como deve ser o alinhamento do texto da propriedade
Caption do componente.
Para componentes dos tipos TPopupMenu, essa propriedade definida como uma varivel do tipo
TPopupAlignment, que determina onde o menu flutuante deve aparecer quando o usurio selecionar
o boto direito do mouse.
Para componentes do tipo TBCDField, TBooleanField, TCurrencyField, TDateField, TDateTimeField,
TDRLabel, TFloatField, TIntegerField, TSmallintField, TStringField, TTimeField, TWordField,
THeaderSection, TParaAttributes, TStatusPanel, TListColumn, Tcolumn, TColumnTitle, TLabel, TMemo,
TPanel, TDecisionPivot e TRichEdit, a propriedade Alignment declarada como uma varivel do tipo
TAlignment e define como deve ser o alinhamento do texto no componente. Para esses componentes,
essa propriedade s est disponvel durante a execuo do aplicativo.
Tabela de Valores para Controles dos tipos TCheckBox, TDBCheckBox e TRadioButton:
Valor Significado
udLeft O componente permanece do lado esquerdo do controle associado.
udRight O componente permanece do lado direito do controle associado.
Valor Significado
taLeftJustify O texto exibido do lado esquerdo do controle.
taRightJustify O texto exibido do lado direito do controle.
Tabela de Valores para Componentes dos tipos TBCDField, TBooleanField, TCurrencyField, TDateField,
TDateTimeField, TFloatField, TIntegerField, TSmallintField, TStringField, TTimeField e TWordField,
THeaderSection, TParaAttributes, TStatusPanel, TListColumn, Tcolumn, TColumnTitle, TLabel, TMemo,
TPanel, TDecisionPivot e TRichEdit:
Tabela de Valores para Componentes do tipo TPopupMenu:
Tabela de Valores para Componentes do tipo TQRLabel:
Exemplo
Voc pode alterar a propriedade Alignment do componente diretamente no Object Inspector ou du-
rante a execuo do aplicativo, incluindo uma linha de cdigo como:
CheckBox1.Alignment:= taLeftJustify;
Na fase de projeto:
TQRLabel, TPopupMenu, TLabel, TMemo, TPanel, TRichEdit, TCheckBox, TDBCheckBox e TRadioButton
TQRLabel, TPopupMenu, TCheckBox, TRadioButton, TBCDField, TBooleanField, TCurrencyField, TDateField,
TDateTimeField, TDBCheckBox, TFloatField, TIntegerField, TSmallintField, TStringField, TTimeField,
TWordField, THeaderSection, TParaAttributes, TStatusPanel, TListColumn, TColumn, TColumnTitle,
TLabel, TMemo, TPanel e TRichEdit
ALIGNTOBAND
Descrio
A propriedade AlignToBand declarada como uma varivel booleana, que especifica se o valor definido
na propriedade Alignment ser ou no aplicado ao componente.
Valor Significado
taCenter O texto exibido centralizado no controle.
taLeftJustify O texto exibido do lado esquerdo do controle.
taRightJustify O texto exibido do lado direito do controle.
Valor Significado
paLeftta O menu flutuante exibido com o seu canto superior esquerdo sob o ponteiro do mouse.
paCenter O menu flutuante exibido com o centro da sua borda superior sob o ponteiro do mouse.
paRight O menu flutuante exibido com o seu canto superior direito sob o ponteiro do mouse.
Valor Significado
taLeft O texto exibido do lado esquerdo do controle.
taCenter O texto exibido centralizado no controle.
taRight O texto exibido do lado direito do controle.
Na fase de projeto:
TQRLabel
TQRLabel
ALLOCATION
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro longo, e define o nmero de pginas
configuradas para o banco de dados.
Na fase de projeto:
TIBDatabaseInfo
TIBDatabaseInfo
ALLOCBY
Descrio
Para controles dos tipos TListView e TImageList, a propriedade AllocBy uma varivel inteira que
prepara o controle para a adio de um grande nmero de itens.
Exemplo
Voc pode alterar a propriedade AllocBy diretamente no Object Inspector ou durante a execuo do
aplicativo, incluindo uma linha de cdigo como:
ListView1.AllocBy:= 10;
Na fase de projeto:
TListView e TImageList
TListView e TImageList
ALLOWALLUP
Descrio
A propriedade AllowAllUp uma varivel do tipo booleano que determina se, em um grupo de
componentes do tipo TSpeedButton, pode ocorrer a situao em que nenhum deles esteja selecionado
(o grupo de um componente TSpeedButton definido pela sua propriedade GroupIndex). Alterar essa
propriedade para um dos componentes do grupo altera tambm seu valor para os demais componentes.
Exemplo
Voc pode alterar a propriedade AllowAllUp diretamente no Object Inspector ou durante a execuo
do aplicativo, incluindo uma linha de cdigo como:
SpeedButton1.AllowAllUp := True;
Na fase de projeto:
TSpeedButton
TSpeedButton
ALLOWDELETE
Descrio
A propriedade AllowDelete uma varivel do tipo booleana que determina se o usurio pode deletar o
registro corrente usando a combinao de teclas Ctrl + Delete.
Exemplo
Voc pode alterar a propriedade AllowDelete diretamente no Object Inspector ou durante a execuo
DBCtrlGrid1.AllowDelete:= True;
Na fase de projeto:
TDBCtrlGrid
TDBCtrlGrid
ALLOWGRAYED
Descrio
A propriedade AllowGrayed uma varivel do tipo booleana que determina se o controle possuir dois
ou trs estados. Se for igual a True, o controle poder possuir trs estados: cbChecked, cbUnchecked e
cbGrayed. A diferena entre os estados cbGrayed e cbChecked que no primeiro caso a marca de
verificao aparece com uma cor cinza.
Exemplo
Voc pode alterar a propriedade AllowGrayed do componente diretamente no Object Inspector ou
CheckBox1.AllowGrayed := True;
Na fase de projeto:
TCheckBox e TDBCheckBox
TCheckBox e TDBCheckBox
ALLOWINPLACE
Descrio
A propriedade AllowInPlace uma varivel do tipo booleano que determina se um objeto OLE pode
ser ativado.
Exemplo
Voc pode alterar a propriedade AllowInPlace diretamente no Object Inspector ou durante a execuo
OLEContainer1.AllowInPlace := True;
Na fase de projeto:
TOLEContainer
TOLEContainer
ALLOWINSERT
Descrio
A propriedade AllowInsert uma varivel do tipo booleana que determina se o usurio pode inserir ou
adicionar um registro usando a tecla Insert ou Ctrl+Insert, respectivamente, e desde que o registro
corrente no esteja sendo editado.
Exemplo
Voc pode alterar a propriedade AllowInsert diretamente no Object Inspector ou durante a execuo
DBCtrlGrid1.AllowInsert:= True;
Na fase de projeto:
TDBCtrlGrid
TDBCtrlGrid
ALLOWPANNING
Descrio
A propriedade AllowPanning uma varivel do tipo TPanningMode, que define como a rolagem do
grfico pode ser feita durante a execuo do aplicativo.
Essa propriedade pode receber um dos valores descritos na tabela a seguir.
Na fase de projeto:
TChart, TDBChart
Valor Significado
pmNone No permite qualquer tipo de rolagem.
pmHorizontal Permite rolagem do grfico apenas na direo horizontal.
pmVertical Permite rolagem do grfico apenas na direo vertical.
pmBoth Permite rolagem do grfico nas duas direes.
TChart, TDBChart
ALLOWRESIZE
Descrio
A propriedade AllowResize uma varivel booleana que define se o usurio pode ou no redimensionar
as sees de um componente do tipo THeader.
Exemplo
Voc pode alterar a propriedade AllowResize de um componente diretamente no Object Inspector ou
atravs de uma linha de cdigo como:
Header1.AllowResize := True;
Na fase de projeto:
THeader
THeader
ALLOWSINGLEPOINT
Descrio
A propriedade AllowSinglePoint uma varivel do tipo booleano que determina se a srie representada
pelo objeto deve ser exibida ainda que contenha um nico ponto.
TChartSeries
ALLOWZOOM
Descrio
A propriedade AllowZoom uma varivel booleana que define se o usurio pode ou no aplicar o
recurso de zoom ao componente durante a execuo do aplicativo.
Na fase de projeto:
TChart, TDBChart
TChart, TDBChart
ARROWKEYS
Descrio
Essa propriedade declarada como uma varivel booleana que define se as teclas de seta para cima e seta
para baixo podem ser usadas para alterar o valor armazenado na propriedade Position do componente.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou mediante a incluso
de uma linha de cdigo como:
UpDown1.ArrowKeys:= True;
Na fase de projeto:
TUpDown
TUpDown
ASBOOLEAN
Descrio
A propriedade AsBoolean uma varivel booleana que realiza uma converso de tipo.
Para componentes do tipo TBooleanField, pode ser usada para ler ou definir o valor do campo. Para
componentes do tipo TStringField, AsBoolean retorna True se o texto armazenado comea com as
letras Y, y, T ou t (de Yes ou True); se no retorna False. Para atribuir um valor ao campo,
use T ou F. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir verifica se a string armazenada em um campo chamado Telefone tem um
texto armazenado que comea com Y, y, T ou t, exibindo uma mensagem em caso positivo.
if Table1.FieldByName(Telefone).AsBoolean then ShowMessage(Verdadeiro);
TAutoIncField, TBooleanField e TStringField
ASDATETIME
Descrio
A propriedade AsDateTime declarada como uma varivel do tipo TDateTime que realiza uma converso
de tipo. Para componentes dos tipos TDateField, TDateTimeField e TTimeField, pode ser usada para ler
ou definir o valor do campo. Para componentes do tipo TStringField, faz a converso de uma string em
TDateTime na leitura de um campo e de TDateTime para string no sentido inverso. Essa propriedade s
est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir converte uma string em uma varivel do tipo TDateTime antes de escrever
o seu valor em um campo.
Table1.FieldByName(Variavel_Time).AsDateTime:= StrToDateTime(Now);
TAutoIncField, TDateField, TDateTimeField, TStringField e TTimeField
ASFLOAT
Descrio
A propriedade AsFloat declarada como uma varivel do tipo Double que realiza uma converso de
tipo. Para componentes dos tipos TBCDField, TCurrencyField e TFloatField, pode ser usada para ler ou
definir o valor do campo. Para componentes do tipo TStringField, faz a converso de uma string em
Double na leitura de um campo e de Double para string no sentido inverso. Essa propriedade s est
disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir converte uma string em uma varivel do tipo Double antes de escrever o
seu valor em um campo.
Table1.FieldByName(Variavel_Float).AsFloat:= StrToFloat(string);
TAutoIncField, TBCDField, TCurrencyField, TFloatField e TStringField
ASINTEGER
Descrio
A propriedade AsInteger declarada como uma varivel do tipo inteiro longo (Longint) que realiza
uma converso de tipo. Para componentes dos tipos TIntegerField, TSmallintField e TWordField pode
ser usada para ler ou definir o valor do campo. Para componentes do tipo TStringField, faz a converso
de uma string em Longint na leitura de um campo e de Longint para string no sentido inverso. Essa
propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir converte uma string em uma varivel do tipo Double antes de escrever o
seu valor em um campo.
Table1.FieldByName(Variavel_Inteira).AsInteger:= StrToInt(string);
TAutoIncField, TIntegerField, TSmallintField, TStringField e TWordField
ASSOCIATE
Descrio
A propriedade Associate declarada como uma varivel do tipo TWinControl que define o controle
associado ao componente e que refletir o valor armazenado na sua propriedade Position.
Exemplo
Voc pode alterar o valor da propriedade Associate de um componente diretamente no Object Inspec-
tor ou atravs de uma linha de cdigo, como:
UpDown1.Associate:= Edit1;
Na fase de projeto:
TUpDown
TUpDown
ASSTRING
Descrio
A propriedade AsString declarada como uma varivel do tipo string que realiza uma converso de tipo.
Para componentes dos tipos TAutoIncField e TStringField, pode ser usada para ler ou definir o
valor do campo.
Para componentes dos tipos TBCDField, TCurrencyField, TDateField, TDateTimeField, TFloatField,
TIntegerField, TSmallintField, TTimeField e TWordField faz a converso do tipo apropriado em uma
string na leitura de um campo e de string para o tipo apropriado no sentido inverso. Essa propriedade
s est disponvel durante a execuo do aplicativo.
Para componentes do tipo TBooleanField, define AsString como True se o texto comea com a letra
Y, y, T ou t; se no define como False. Na leitura, retorna T ou F.
Para os demais tipos de componentes, essa propriedade deve ser usada apenas para leitura do campo e
converso no tipo apropriado, gerando um erro de exceo caso se tente realizar uma operao de
atribuio/gravao.
TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField, TCurrencyField, TDateField,
TDateTimeField, TFloatField, TGraphicField, TIntegerField, TMemoField, TSmallintField, TStringField,
TTimeField, TVarBytesField e TWordField
ASTEXT
Descrio
Essa propriedade retorna o contedo do Clipboard como uma string. Se o contedo do Clipboard no for
um texto, gera um erro de exceo. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir exibe em um componente Label1 do tipo Tlabel o texto armazenado no
Clipboard.
TClipboard
AUTOACTIVATE
Descrio
A propriedade AutoActivate uma varivel do tipo TAutoActivate que determina como um objeto
pode ser ativado em um componente do tipo TOLEContainer.
Tabela de Valores:
Valor Significado
aaManual O objeto OLE deve ser ativado manualmente, definindo-se a sua propriedade
Active igual a True.
aaGetFocus O objeto OLE se torna ativo quando o componente que o contm recebe o
foco da aplicao.
aaDoubleClick O objeto OLE se torna ativo quando o componente que o contm possui o foco
da aplicao e o usurio pressiona a tecla Enter ou d um duplo clique sobre o mesmo.
Exemplo
Voc pode alterar a propriedade AutoActivate de um componente diretamente no Object Inspector ou
atravs de uma linha de cdigo, como:
OLEContainer1.AutoActivate := aaManual;
Na fase de projeto:
TOLEContainer
TOLEContainer
AUTOCALCFIELDS
Descrio
A propriedade AutoCalcFields uma varivel booleana que determina se o evento OnCalcFields deve
ser disparado quando a aplicao carrega um novo registro do banco de dados associado.
Exemplo
Voc pode alterar a propriedade AutoCalcFields de um componente diretamente no Object Inspector
ou atravs de uma linha de cdigo, como:
Query1.AutoCalcFields := True;
Na fase de projeto:
TADODataset, TADOQuery, TADOStoredProc, TADOTable, TDecisionQuery, TIBDataset, TIBQuery,
TIBStoredProc, TIBTable, TIBTransaction, TTable, TQuery, TDecisionQuery e TStoredProc
TADODataset, TADOQuery, TADOStoredProc, TADOTable, TDecisionQuery, TIBDataset, TIBQuery,
TIBStoredProc, TIBTable, TIBTransaction, TTable, TQuery, TDecisionQuery e TStoredProc
AUTODISPLAY
Descrio
A propriedade AutoDisplay uma varivel booleana que determina se o contedo do controle deve ser
exibido automaticamente.
Exemplo
Voc pode alterar a propriedade AutoDisplay de um componente diretamente no Object Inspector ou
DBImage1.AutoDisplay := True;
Na fase de projeto:
TDBImage e TDBMemo
TDBImage e TDBMemo
AUTOEDIT
Descrio
Essa propriedade declarada como uma varivel booleana que define se os controles conectados a um
componente do tipo TDataSource estaro ou no em modo de edio.
Exemplo
de uma linha de cdigo, como:
DataSource1.AutoEdit:= True;
Na fase de projeto:
TDataSource
TDataSource
AUTOENABLE
Descrio
A propriedade AutoEnable uma varivel booleana que determina se o componente pode habilitar e
desabilitar automaticamente seus botes.
Exemplo
Voc pode alterar a propriedade AutoEnable de um componente diretamente no Object Inspector ou
MediaPlayer1.AutoEnable := True;
Na fase de projeto:
TMediaPlayer
TMediaPlayer
AUTOMERGE
Descrio
A propriedade AutoMerge uma varivel booleana que determina se os menus de diversos formulrios
devem ser combinados automaticamente.
Exemplo
Voc pode alterar a propriedade AutoMerge de um componente diretamente no Object Inspector ou
MainMenu1.AutoMerge := True;
Na fase de projeto:
TMainMenu
TMainMenu
AUTOOPEN
Descrio
A propriedade AutoOpen uma varivel booleana que determina se o componente pode tentar abrir
automaticamente o dispositivo multimdia associado quando a aplicao executada.
Exemplo
Voc pode alterar a propriedade AutoOpen de um componente diretamente no Object Inspector ou
MediaPlayer1.AutoOpen := True;
Na fase de projeto:
TMediaPlayer
TMediaPlayer
AUTOPOPUP
Descrio
A propriedade AutoPopup uma varivel booleana que determina se o menu deve aparecer quando o
usurio clica com o boto direito do mouse sobre o controle que tem esse componente especificado na
sua propriedade PopupMenu.
Exemplo
Voc pode alterar a propriedade AutoPopup de um componente diretamente no Object Inspector ou
Popupmenu1.AutoPopup := True;
Na fase de projeto:
TPopupMenu
TPopupMenu
AUTOREWIND
Descrio
A propriedade AutoRewind uma varivel booleana que determina se o componente deve ser rebobinado
automaticamente durante uma execuo ou gravao.
Exemplo
Voc pode alterar a propriedade AutoRewind de um componente diretamente no Object Inspector ou
MediaPlayer1.AutoRewind := True;
Na fase de projeto:
TMediaPlayer
TMediaPlayer
AUTOSCROLL
Descrio
Para componentes dos tipos TForm, TFrame, e TScrollBox, a propriedade AutoScroll uma varivel
booleana que determina se o controle exibir automaticamente as barras de rolagem quando for grande
o suficiente para exibir todos os controles que contm.
Para componentes do tipo TTabSet, a propriedade AutoScroll uma varivel booleana que determina
se o controle exibir automaticamente botes de rolagem quando for grande o suficiente para exibir
todos os controles que contm.
Exemplo
Voc pode alterar a propriedade AutoScroll de um componente diretamente no Object Inspector ou
Form1.AutoScroll := True;
Na fase de projeto:
TForm, TFrame, TScrollBox e TTabSet
TForm, TFrame, TScrollBox e TTabSet
AUTOSELECT
Descrio
A propriedade AutoSelect uma varivel booleana que determina se o texto exibido pelo controle ser
selecionado quando este receber o foco da aplicao.
Exemplo
Voc pode alterar a propriedade AutoSelect de um componente diretamente no Object Inspector ou
Edit1.AutoSelect := False;
Na fase de projeto:
TDBEdit, TDBLookupCombo, TEdit e TMaskEdit
TDBEdit, TDBLookupCombo, TEdit e TMaskEdit
AUTOSIZE
Descrio
Para componentes dos tipos TDBText e TLabel, a propriedade AutoSize uma varivel booleana que
determina se o controle ser automaticamente redimensionado para acomodar o texto definido na sua
propriedade Caption.
Para componentes dos tipos TDBEdit, TDBLookupCombo, TEdit, THotKey e TMaskEdit, a propriedade
AutoSize uma varivel booleana que determina se a altura do controle ser redimensionada quando
o tamanho da fonte de texto for alterado.
Para componentes dos tipos TDBImage e TImage, a propriedade AutoSize uma varivel booleana que
determina se o controle ser automaticamente redimensionado para acomodar a imagem definida na
sua propriedade Picture.
Exemplo
Voc pode alterar a propriedade AutoSize de um componente diretamente no Object Inspector ou
Edit1.AutoSize := False;
Na fase de projeto:
TDBText, TLabel, TDBEdit, TDBLookupCombo, TEdit, THotKey, TMaskEdit, TDBImage e TImage
TDBText, TLabel, TDBEdit, TDBLookupCombo, TEdit, THotKey, TMaskEdit, TDBImage e TImage
AXISVISIBLE
Descrio
A propriedade AxisVisible uma varivel booleana que define se todos os quatro eixos do grfico (dois
horizontais e dois verticais) devem ou no ser exibidos. Voc pode definir essa propriedade como False
e, posteriormente, habilitar individualmente a exibio de cada eixo.
Na fase de projeto:
TChart, TDBChart
TChart, TDBChart
BACKCOLOR
Descrio
A propriedade BackColor declarada como uma varivel do tipo TColor e define a cor de fundo do
grfico.
Para o componente THTML, define a cor de fundo da pgina HTML exibida pelo componente.
Na fase de projeto:
TChart, TDBChart, THTML
BACKGROUNDCOLOR
Descrio
A propriedade BackgroundColor declarada como uma varivel do tipo TColor e define a cor de fundo
do componente.
Exemplo
Voc pode alterar a propriedade BackgroundColor de um componente diretamente no Object Inspec-
TabSet1.BackgroundColor := clRed;
Na fase de projeto:
TTabSet
TTabSet
BACKIMAGE
Descrio
A propriedade BackImage declarada como um objeto da classe TPicture, e define a imagem de fundo
a ser exibida juntamente com o grfico.
Para o componente THTML, define uma URL que armazena a imagem de fundo a ser exibida em uma
pgina Web.
Na fase de projeto:
BEVELINNER
Descrio
A propriedade BevelInner declarada como uma varivel do tipo TPanelBevel e define o estilo do
chanfro interno de um componente do tipo TPanel.
Tabela de Valores:
Exemplo
Voc pode alterar a propriedade BevelInner de um componente diretamente no Object Inspector ou
Panel1.BevelInner := bvNone;
Na fase de projeto:
TChart, TDBChart, TDecisionGraph, TPanel, TDecisionGrid, TDecisionPivot
Valor Significado
bvNone No existe chanfro interno.
bvLowered O chanfro interno existe na forma de um entalhe (depresso).
bvRaised O chanfro interno saliente (elevado).
BEVELOUTER
Descrio
A propriedade BevelOuter declarada como uma varivel do tipo TPanelBevel e define o estilo do
chanfro externo de um componente do tipo TPanel.
Tabela de Valores:
Exemplo
Voc pode alterar a propriedade BevelOuter de um componente diretamente no Object Inspector ou
Panel1.BevelOuter := bvNone;
Na fase de projeto:
BEVELWIDTH
Descrio
A propriedade BevelWidth declarada como uma varivel do tipo TBevelWidth e define a espessura,
em pixels, da linha que separa os chanfros interno e externo em um componente do tipo TPanel.
Exemplo
Voc pode alterar a propriedade BevelWidth de um componente diretamente no Object Inspector ou
Panel1.BevelWidth := 4;
Na fase de projeto:
Valor Significado
bvNone No existe chanfro externo.
bvLowered O chanfro externo existe na forma de um entalhe (depresso).
bvRaised O chanfro externo saliente (elevado).
BITMAP
Descrio
A propriedade Bitmap declarada como uma varivel do tipo TBitmap e define um padro de
preenchimento para um objeto do tipo TBrush.
Para componentes do tipo TPicture, essa propriedade declarada como uma varivel do tipo TBitmap
e representa o contedo do objeto na forma de um Bitmap.
TBitmap e TPicture
BKCOLOR
Descrio
Essa propriedade declarada como uma varivel do tipo TColor e especifica a cor de fundo das imagens
a serem exibidas.
Exemplo
Voc pode alterar a propriedade BkColor diretamente no Object Inspector ou durante a execuo do
ImageList1.BkColor:= clRed;
Na fase de projeto:
TImageList
TImageList
BLENDCOLOR
Descrio
Essa propriedade declarada como uma varivel do tipo TColor e especifica a cor de primeiro plano
das imagens a serem exibidas.
Exemplo
Voc pode alterar a propriedade BlendColor diretamente no Object Inspector ou durante a execuo
ImageList1.BlendColor:= clYellow;
Na fase de projeto:
TImageList
TImageList
BLOBSIZE
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro e especifica o nmero de bytes
armazenados no registro corrente para um campo do tipo blob.
TBlobField
BOF
Descrio
A propriedade BOF uma varivel booleana que determina se um banco de dados est no seu primeiro
registro. Isto ocorre aps uma tabela ser aberta e ocorrer uma chamada aos eventos First ou Prior. Essa
propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu valor diretamente
TADODataset, TADOQuery, TADOStoredProc, TADOTable, TClientDataset, TDecisionQuery, TIBDataset, TIBQuery,
TIBStoredProc, TIBSQL, TIBTable, TIBTransaction, TTable, TQuery, TDecisionQuery e TStoredProc
BORDERICONS
Descrio
A propriedade BorderIcons declarada como uma varivel do tipo TBorderIcons e consiste em um
conjunto de variveis que determina os cones a serem exibidos na barra de ttulo de um formulrio.
Tabela de Valores:
Exemplo
Voc pode alterar a propriedade BorderIcons de um formulrio diretamente no Object Inspector ou
Form1.BorderIcons := [biSystemMenu,biMinimize,biMaximize] ;
Na fase de projeto:
TForm
TForm
BORDERSTYLE
Descrio
Para componentes do tipo TForm, essa propriedade declarada como uma varivel do tipo
TFormBorderStyle, que determina o estilo de borda do componente.
Para os demais componentes, a propriedade BorderStyle declarada como uma varivel do tipo
TBorderStyle, que determina se o componente ter ou no uma borda.
Valor Significado
biSystemMenu O formulrio possui um menu de sistema.
biMinimize O formulrio possui um boto de minimizao.
biMaximize O formulrio possui um boto de maximizao.
Tabela de Valores para componentes do Tipo TForm:
Para janelas cuja propriedade FormStyle fsMDIChild, bsDialog ou bsNone e no afeta sua aparncia.
Tabela de Valores para os demais componentes:
Exemplo
Voc pode alterar a propriedade AutoSize de um componente diretamente no Object Inspector ou
Edit1.BorderStyle:= bsSingle;
Na fase de projeto:
TDBEdit, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo, TDrawGrid, TEdit,
TForm, THeader, TIWDBGrid, TListBox, TListView, TMaskEdit, TMemo, TOutline, TPanel, TDecisionPivot,
TRichEdit, TScrollBox, TStringGrid e TTreeView
TDBEdit, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo, TDrawGrid, TEdit,
TForm, THeader, TIWDBGrid, TListBox, TListView, TMaskEdit, TMemo, TOutline, TPanel, TDecisionPivot,
TRichEdit, TScrollBox, TStringGrid e TTreeView
BORDERWIDTH
Descrio
A propriedade BorderWidth declarada como uma varivel do tipo TBorderWidth e define a espessura,
em pixels, da borda de um componente dos tipos TPanel e TDecisionPivot.
Exemplo
Voc pode alterar a propriedade BorderWidth de um componente diretamente no Object Inspector ou
Panel1.BorderWidth := 4;
Valor Significado
bsNone Sem borda
bsSingle Borda Simples
Valor Significado
bsDialog Borda no redimensionvel, comum em quadros de dilogo.
bsSingle Borda simples e redimensionvel.
bsNone Borda invisvel, no redimensionvel, sem botes de maximizao, minimizao e
menu de sistema.
bsSizeable Borda padro redimensionvel.
Na fase de projeto:
TPanel, TDecisionPivot.
TPanel, TDecisionPivot
BOTTOMAXIS
Descrio
A propriedade BottomAxis declarada como um objeto da classe TChartAxis, e representa o eixo
horizontal inferior do grfico exibido no componente.
Na fase de projeto:
TChart, TDBChart
TChart, TDBChart
BOUNDSRECT
Descrio
A propriedade BoundsRect uma varivel do tipo TRect, cujos campos estabelecem, nas coordenadas
do sistema definido pelo controle-pai, o retngulo circunscrito ao controle atual.
Os campos da propriedade BoundsRect (como qualquer varivel do tipo TRect) so: Left, Top,
Right e Bottom.
Tabela de Valores:
Exemplo
Com relao s propriedades Left, Top, Right e Bottom de um formulrio, podemos afirmar que:
BoundsRect.Left = Left
BoundsRect.Top = Top
BoundsRect.Right = Left + Width
BoundsRect.Bottom = Top + Height
Todos os controles.
Valor Significado
BoundsRect.Left Valor da coordenada X da extremidade superior esquerda do retngulo
circunscrito ao controle.
BoundsRect.Top Valor da coordenada Y da extremidade superior esquerda do retngulo
BoundsRect.Right Valor da coordenada X da extremidade inferior direita do retngulo
BoundsRect.Bottom Valor da coordenada Y da extremidade inferior direita do retngulo
BREAK
Descrio
Essa propriedade declarada como uma varivel do tipo TMenuBreak e permite dividir um menu em colunas.
Tabela de Valores:
Exemplo
MenuItem1.Break := mbNone;
Na fase de projeto:
TMenuItem
TMenuItem
BRUSH
Descrio
Essa propriedade declarada como uma varivel do tipo TBrush que especifica a cor e o padro de
preenchimento usados para pintar formas grficas, e como cor e pano de fundo.
No caso de controles, especifica a cor e o padro de preenchimento usados como cor e pano de fundo.
Exemplo
Voc pode criar um formulrio Form1 do tipo TForm com a cor amarela e hachuras em diagonal com
o seguinte trecho de cdigo:
procedure TForm1.FormCreate(Sender: TObject);
begin
Form1.Brush.Color := clYellow;
Form1.Brush.Style := bsFDiagonal;
end;
Na fase de projeto:
TShape
Todos os controles e Tcanvas.
Valor Significado
mbNone O menu no dividido em colunas.
mbBarBreak A quebra ocorre com o item de menu aparecendo no topo da nova coluna.
Uma barra vertical separa as colunas.
mbBreak A quebra ocorre com o item de menu aparecendo no topo da nova coluna.
Nesse caso no surge uma barra vertical separando as colunas.
BUTTONAUTOSIZE
Descrio
Essa propriedade declarada como uma varivel booleana, e define se os botes exibidos no componente
devem ser redimensionados automaticamente.
Na fase de projeto:
TDecisionPivot
TDecisionPivot
BUTTONHEIGHT
Descrio
Essa propriedade declarada como uma varivel inteira e define o valor, em pixels, da altura dos
botes exibidos no componente.
Na fase de projeto:
TDecisionPivot
TDecisionPivot
BUTTONSPACING
Descrio
Essa propriedade declarada como uma varivel inteira e define o valor, em pixels, do espaamento
dos botes exibidos no componente.
Na fase de projeto:
TDecisionPivot
TDecisionPivot
BUTTONWIDTH
Descrio
Essa propriedade declarada como uma varivel inteira e define o valor, em pixels, da largura dos
botes exibidos no componente.
Na fase de projeto:
TDecisionPivot
TDecisionPivot
BYTESRCVD
Descrio
Essa propriedade declarada como uma varivel inteira e define o nmero de bytes j recebidos em
uma conexo.
TNMFTP, TNMHTTP, TNMNNTP, TNMPOP3, TPowerSock
BYTESSENT
Descrio
Essa propriedade declarada como uma varivel inteira e define o nmero de bytes j enviados em
uma conexo.
TNMFTP, TNMHTTP, TNMNNTP, TPowerSock
BYTESTOTAL
Descrio
Essa propriedade declarada como uma varivel inteira e define o nmero total de bytes a serem
recebidos em uma conexo.
TNMFTP, TNMHTTP, TNMNNTP, TNMPOP3, TPowerSock
CACHEDSIZE
Descrio
Essa propriedade definida como uma varivel inteira, e define o nmero de registros armazenados na
memria local pelo componente. Indica portanto o nmero de registros carregados quando a conexo
atravs do componente se torna ativa.
Na fase de projeto:
TClientDataSet, TADODataset, TADOTable, TADOQuery, TIBTable
TClientDataSet, TADODataset, TADOTable, TADOQuery, TIBTable
CACHEDUPDATES
Descrio
Esta propriedade declarada como uma varivel do tipo booleana e indica se o recurso de Cached
Updates est sendo utilizado pelo componente.
Na fase de projeto:
TClientDataSet, TADODataset, TADOTable, TIBTable
TClientDataSet, TADODataset, TADOTable, TIBTable
CALCULATED
Descrio
A propriedade Calculated declarada como uma varivel do tipo booleana e indica se o valor do
campo foi calculado em um evento OnCalcFields. Essa propriedade s est disponvel durante a execuo
do aplicativo.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem informando se o campo foi calculado num evento
OnCalcFields, onde WordField uma varivel do tipo TWordField.
if WordField.Calculated:= True then ShowMessage(Valor calculado em evento);
CANCEL
Descrio
A propriedade Cancel declarada como uma varivel do tipo booleano e indica se um controle do tipo
TButton ou TBitBtn associa o seu evento OnClick ao pressionamento da tecla Esc.
Exemplo
Coloque um boto chamado Button1 num formulrio chamado Form1 e defina a sua propriedade Can-
cel como True no Object Inspector. No evento OnClick de Button1 inclua a seguinte linha de cdigo:
if Form1.Color := clYellow then Form1.Color := clRed else Form1.Color := clYellow;
Execute o aplicativo e pressione seguidamente a tecla Esc e voc ver a cor do formulrio alternar entre
vermelho e amarelo.
Na fase de projeto:
TBitBtn e TButton
TBitBtn e TButton
CANCELED
Descrio
Essa propriedade declarada como uma varivel booleana e define se o mtodo Cancel do componente
foi acionado.
TQRPrinter
CANMODIFY
Descrio
A propriedade CanModify declarada como uma varivel do tipo booleana, e indica se o valor do
campo pode ser alterado. Essa propriedade s est disponvel durante a execuo do aplicativo e no
pode ter o seu valor diretamente alterado pelo usurio. Para componentes do tipo TTable, TQuery,
TDecisionQuery e TStoredProc, define se um campo do banco de dados pode ser alterado.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem informando se o valor do campo pode ser modificado,
onde WordField uma varivel do tipo TWordField.
if WordField.CanModify := True then ShowMessage(Valor pode ser modificado);
TTimeField, TVarBytesField, TWordField, TClientDataSet, TADODataset, TADOTable, TADOQuery, TTable,
CANVAS
Descrio
A propriedade Canvas declarada como uma varivel do tipo TCanvas e fornece uma rea grfica na
qual o programa pode realizar desenhos durante a sua execuo. Essa propriedade s est disponvel
Para componentes dos tipos TForm, TImage e TPaintBox, voc desenha com a propriedade Canvas
quando disparado um evento OnPaint.
Para componentes dos tipos TComboBox, TDirectoryListBox, TFileListBox, TListBox e TOutline voc
desenha com a propriedade Canvas quando disparado um evento OnDrawItem.
Para componentes dos tipos TDBGrid, TDBCtrlGrid, TDrawGrid, TIWDBGrid e TStringGrid, voc
desenha com a propriedade Canvas quando disparado um evento OnDrawCell ou OnDrawDataCell.
Para componentes dos tipos TPrinter e TQRPrinter, voc desenha com a propriedade Canvas atravs
dos mtodos Draw, StretchDraw e CopyRect (desde que a impressora associada ao objeto TPrinter seja
capaz de imprimir grficos).
Para componentes dos tipos TChart e TDBChart, voc desenha com a propriedade Canvas nos
procedimentos associados aos eventos AfterDrawValues e BeforeDrawValues.
Para componentes dos tipos TBaseReport, TCanvasReport, TRvNDRWriter, TRVRenderPreview e
TRvRenderPrinter, define a superfcie de desenho do relatrio.
A propriedade Canvas por si s um objeto da GDI do Windows e tem subpropriedades como Pen, Brush, Font e Color, que tambm so
objetos da GDI.
Exemplo
Se voc quiser que o seu programa desenhe sempre um retngulo vermelho dentro de um componente
PaintBox1 do tipo TPaintBox, defina o evento OnPaint de PaintBox1 da seguinte forma:
procedure TForm1.PaintBox1Paint(Sender: Tobject); begin
PaintBox1.Canvas.Brush.Color:= clRed;
PaintBox1.Canvas.Rectangle(10,10,150,150);
end;
TBaseReport, TBitmap, TCanvasReport, TComboBox, TChart, TDBChart, TDBComboBox, TDBGrid, TDBCtrlGrid,
TDBListBox, TDirectoryListBox, TDrawGrid, TFileListBox, TForm, TImage, TIWDBGrid, TListBox,
TOutline, TPaintBox, TPrinter, TQRPrinter, TRvNDRWriter, TRVRenderPreview, TRvRenderPrinter, e
TStringGrid
CAPABILITIES
Descrio
A propriedade Capabilities declarada como uma varivel do tipo TMPDevCapsSet e consiste num
conjunto de propriedades que definem as capacidades do dispositivo multimdia corrente. Essa
propriedade s est disponvel durante a execuo do aplicativo, e no pode ter o seu valor diretamente
Tabela de Valores:
Exemplo
O trecho de cdigo a seguir verifica se o dispositivo mostra uma janela de exibio dos resultados e, em
caso positivo, emite uma mensagem.
if mpUsesWindows in MediaPlayer1.Capabilities then ShowMessage(Dispositivo exibe janela);
TMediaPlayer
CAPACITY
Descrio
Para objetos da classe TList, a propriedade Capacity declarada como uma varivel inteira que define
o espao alocado para armazenar a lista de objetos.
Para componentes DecisionCube, a propriedade Capacity declarada como uma varivel inteira que
define a memria mxima a ser alocada para o cache do componente.
Valor Significado
mpCanEject Pode realizar operaes de ejeo.
mpCanPlay Pode executar o dispositivo.
mpCanRecord Pode realizar operaes de gravao.
mpCanStep Pode avanar e retroceder no dispositivo.
mpUsesWindows Usa uma janela para exibio de resultados.
Essa varivel s est disponvel durante a execuo do aplicativo.
TDecisionCube, TList
CAPTION
Descrio
A propriedade Caption declarada como uma varivel do tipo string, e indica o rtulo exibido para o
componente. Para transformar um dos caracteres do rtulo em uma tecla aceleradora, basta colocar
um E comercial - (&) antes do caractere, e o caractere ser exibido sublinhado.
Para formulrios, essa propriedade indica o texto exibido na sua barra de ttulos, e o rtulo associado
ao seu cone, quando o controle estiver minimizado.
Para objetos da classe TAction, que representam aes definidas em um componente TactionList, essa
propriedade define o texto a ser exibido nos controles e itens de menu associados.
Observao: Essa capacidade de transformar um caractere em tecla aceleradora no se aplica
propriedade Caption de um formulrio.
Exemplo
Coloque um boto chamado Button1 num formulrio chamado Form1 e defina a sua propriedade
Caption como &Boto (o rtulo exibido ser Boto) no Object Inspector. A seqncia de teclas Alt+B
gera um evento OnClick de Button1.
Na fase de projeto:
TAction, TBitBtn, TButton, TCheckBox, TDBCheckBox, TDBRadioGroup, TForm, TGroupBox, TIWButton,
TIWCheckBox, TIWControl, TIWDBCheckBox, TIWDBFile, TIWFile, TIWLabel, TLabel, TPanel, TRadioButton,
TSpeedButton, TTabSheet e TMenuItem
TAction, TBitBtn, TButton, TCheckBox, TDBCheckBox, TDBRadioGroup, TForm, TGroupBox, TIWButton,
TIWCheckBox, TIWDBCheckBox, TIWLabel, TLabel, TPanel, TRadioButton, TSpeedButton, TTabSheet e TMenuItem
CAPTIONCOLOR
Descrio
A propriedade CaptionColor declarada como uma varivel do tipo TColor e define a cor de
fundo do texto que exibe o nome das linhas e colunas correspondentes s dimenses de dados
exibidas pelo componente.
TDecisionGraph
CAPTIONFONT
Descrio
A propriedade CaptionColor declarada como uma varivel do tipo TFont e define a fonte do texto que
exibe o nome das linhas e colunas correspondentes s dimenses de dados exibidas pelo componente.
TDecisionGraph
CATEGORY
Descrio
A propriedade Category declarada como uma varivel do tipo string, e define a categoria qual o
objeto pertence. Voc pode digitar seu valor diretamente no Object Inspector, quando o objeto estiver
selecionado no editor de aes do Delphi.
Na fase de projeto:
TAction
TAction
CELLS
Descrio
A propriedade Cells declarada como uma array de strings onde cada item da array corresponde ao texto
exibido em uma clula da grade, definida pelos ndices ARow e ACol, que variam de zero at RowCount-
1 e ColCount-1, respectivamente. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode alterar o texto exibido na primeira clula da grade atravs de uma linha de cdigo, como:
StringGrid1.Cells[0,0] := Primeira clula ;
TStringGrid, TDecisionGrid
CENTER
Descrio
A propriedade Center uma varivel booleana que determina se a imagem deve ser exibida centralizada
no controle. Se for igual a False, o alinhamento da imagem e do controle feito coincidindo-se a
extremidade superior esquerda.
Exemplo
Voc pode alterar a propriedade Center de um componente diretamente no Object Inspector ou atravs
Image1.Center := False;
Na fase de projeto:
TAnimate, TImage e TDBImage
TAnimate, TImage e TDBImage
CHANGEDCOUNT
Descrio
A propriedade ChangedCount declarada como uma varivel inteira que armazena o nmero de
registros adicionados tabela definida na propriedade ChangedTableName do componente. Essa
propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu valor diretamente
TBatchMove
CHANGEDTABLENAME
Descrio
A propriedade ChangedTableName declarada como uma varivel do tipo TFileName que armazena os
registros que sofreram alterao devido a uma operao realizada por um componente do tipo TBatchMove.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou atravs de uma linha
de cdigo, como:
BatchMove1.ChangedTableName := registro.db;
Na fase de projeto:
TBatchMove
TBatchMove
CHARCASE
Descrio
A propriedade CharCase declarada como uma varivel do tipo TEditCharCase que define se o texto
exibido pelo componente deve aparecer apenas em letras maisculas, apenas em letras minsculas ou
em letras maisculas e minsculas.
Tabela de Valores:
Exemplo
Voc pode alterar a propriedade CharCase de um componente diretamente no Object Inspector ou
Edit1.CharCase := ecNormal;
Valor Significado
ecLowerCase Texto exibido em letras minsculas.
ecNormal Texto exibido em letras maisculas e minsculas.
ecUpperCase Texto exibido em letras maisculas.
Na fase de projeto:
TDBEdit, TEdit e TMaskEdit
CHECKED
Descrio
A propriedade Checked declarada como uma varivel do tipo booleana que determina se o controle
est selecionado.
Tabela de Valores para controles dos tipos TCheckBox e TDBCheckBox:
Tabela de Valores para controles do tipo TRadioButton:
Tabela de Valores para controles do tipo TMenuItem:
Para objetos da classe TAction, que representam aes definidas em um componente TactionList, essa
propriedade define o texto a ser exibido nos controles e itens de menu associados.
Exemplo
Voc pode alterar a propriedade Checked do componente diretamente no Object Inspector ou durante
a execuo do aplicativo, incluindo uma linha de cdigo como:
CheckBox1.Checked := True;
Valor Significado
True O componente est selecionado e apresenta uma marca de verificao na cor preta.
False O componente no est selecionado; apresenta uma marca de verificao na cor cinza
ou no apresenta uma marca de verificao.
Valor Significado
True O componente est selecionado e apresenta um crculo na cor preta.
False O componente no est selecionado e no apresenta um crculo na cor preta.
Valor Significado
True Uma marca de verificao aparece ao lado do item de menu, indicando que ele
est selecionado.
False Nenhuma marca de verificao aparece ao lado do item de menu, indicando que
ele no est selecionado.
Na fase de projeto:
TAction, TCheckBox, TDBCheckBox, TIWCheckBox, TIWDBCheckBox, TMenuItem e TRadioButton
TAction, TCheckBox, TDBCheckBox, TIWCheckBox, TIWDBCheckBox, TMenuItem e TRadioButton
CLIENTHANDLE
Descrio
A propriedade ClientHandle uma varivel do tipo HWND que define um handle para a rea-cliente
de uma janela MDI. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode
ter o seu valor diretamente alterado pelo usurio.
Exemplo
O trecho de cdigo a seguir faz com que a altura da rea-cliente de um formulrio seja reduzida
metade cada vez que o usurio d um clique com o mouse sobre o formulrio.
begin
Form1.ClientHeight := Form1.ClientHeight div 2;
end;
Na fase de projeto:
TForm
Todos os controles.
CLIENTHEIGHT
Descrio
A propriedade ClientHeight uma varivel inteira que define a altura, em pixels, da rea-cliente de um
controle. Com exceo de componentes do tipo TForm, essa propriedade s est disponvel durante a
execuo do aplicativo.
Exemplo
Voc pode usar essa propriedade para chamadas s funes da API do Windows.
Todos os controles, TFrame e TForm.
CLIENTORIGIN
Descrio
A propriedade ClientOrigin declarada como uma varivel do tipo TPoint que fornece, em pixels, as
coordenadas do canto superior esquerdo da rea-cliente de um controle, no sistema de coordenadas da
tela. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu valor
Exemplo
O trecho de cdigo a seguir faz com que as coordenadas da origem da rea-cliente de um formulrio
sejam exibidas em um componente Label1 do tipo TLabel.
Label1.Caption := X = +IntToStr(Form1.ClientOrigin.X)+ Y = + IntToStr(Form1.ClientOrigin.Y);
Todos os controles.
CLIENTRECT
Descrio
A propriedade ClientRect declarada como uma varivel do tipo TRect que define o tamanho, em
pixels, da rea-cliente de um controle. Os campos Top, Left, Bottom e Right de ClientRect definem as
coordenadas do canto superior esquerdo (Left,Top) e inferior direito (Right, Bottom) da rea-cliente.
Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu valor
Exemplo
O trecho de cdigo a seguir desenha uma linha do canto superior esquerdo ao canto inferior direito da
rea-cliente do formulrio corrente.
with ClientRect do
begin
Canvas.MoveTo(Left,Top);
Canvas.LineTo(Right, Bottom);
end;
Todos os controles.
CLIENTWIDTH
Descrio
A propriedade ClientWidth uma varivel inteira que define a largura, em pixels, da rea-cliente de
um controle. Com exceo de componentes do tipo TForm, essa propriedade s est disponvel du-
rante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir faz com que a largura da rea-cliente de um formulrio seja reduzida
metade cada vez que o usurio d um clique com o mouse sobre o formulrio.
begin
Form1.ClientWidth := Form1.ClientWidth div 2;
end;
Na fase de projeto:
TForm e TFrame
Todos os controles.
CLIPRECT
Descrio
A propriedade ClipRect define um retngulo de clipping na superfcie do desenho. Essa propriedade s est
disponvel durante a execuo do aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
TCanvas
COL
Descrio
A propriedade Col declarada como uma varivel do tipo inteiro longo (Longint) que define a que coluna
pertence a clula que possui o foco. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Label1 do tipo TLabel informe a
coluna que possui o foco em um componente StringGrid1 do tipo TStringGrid quando o usurio
seleciona uma clula com o mouse.
procedure TForm1.StringGrid1Click(Sender: TObject);
begin
Label1.Caption := Coluna + IntToStr(StringGrid1.Col + 1);
end;
TDrawGrid e TStringGrid
COLCOUNT
Descrio
A propriedade ColCount declarada como uma varivel do tipo inteiro longo (Longint) que define o
nmero de colunas do controle. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Label1 do tipo TLabel informe o
nmero de colunas de um componente StringGrid1 do tipo TStringGrid quando o usurio seleciona
uma clula com o mouse.
procedure TForm1.StringGrid1Click(Sender: Tobject);
begin
Label1.Caption:= IntToStr(StringGrid1.ColCount);
end;
TDBCtrlGrid, TDrawGrid, TDecisionGrid e TStringGrid
COLLATE
Descrio
A propriedade Collate declarada como uma varivel booleana que define se as pginas sero
impressas agrupadas.
Exemplo
PrintDialog1.Collate := True;
Na fase de projeto:
TPrintDialog
TPrintDialog
COLOR
Descrio
A propriedade Color declarada como uma varivel do tipo TColor e define a cor de fundo de um componente.
Tabela de Valores:
continua
Valor Significado
clBlack Preto
clMaroon Marrom
clGreen Verde
clOlive Verde-Oliva
clNavy Azul-Marinho
clPurple Roxo
clTeal Teal
clGray Cinza
clSilver Prata
clRed Vermelho
clLime Verde-Limo
clBlue Azul
clFuchsia Rosa
clAqua Azul-Claro
clWhite Branco
clBackground Cor de fundo de janela definida no Painel de Controle do Windows.
clActiveCaption Cor da barra de ttulo da janela ativa, definida no Painel de Controle do Windows.
clInactiveCaption Cor da barra de ttulo da janela inativa, definida no Painel de Controle do Windows.
clMenu Cor de fundo de Menu, definida no Painel de Controle do Windows.
clWindow Cor de fundo da janela ativa, definida no Painel de Controle do Windows.
clWindowFrame Cor do contorno das janelas, definida no Painel de Controle do Windows.
Exemplo
Voc pode alterar a propriedade Color de um componente diretamente no Object Inspector ou du-
CheckBox1.Color := ClYellow;
Na fase de projeto:
TBrush, TFont, TPen; TCheckBox, TColorDialog, TComboBox, TDBCheckBox, TDBComboBox, TDBCtrlGrid,
TDBEdit, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupComboBox, TDBLookupList,
TDBLookupListBox, TDBMemo, TDBRadioGroup, TDBText, TDirectoryListBox, TDrawGrid, TDriveComboBox,
TEdit, TFileListBox, , TFrame TForm, TGroupBox, TIWCheckBox, TIWControl, TIWDBCheckBox, TIWDBEdit,
TIWDBFile, T IWDBGrid, TIWDBImage, TIWDBListBox, TIWEdit, TIWFile, TIWLabel, TIWListBox,
TIWLookupCombobox, TLabel, TListBox, TListView, TMaskEdit, TMemo, TNotebook, TOutline, TPageControl,
TPaintBox, TPanel, TQRBand, TQRBand, TQRDBText, TQRLabel, TQRMemo, TQRPreview e TQRSysData,
TRadioButton, TRichEdit, TScrollBox, TStringGrid, TTreeView
TBrush, TFont, TPen; TCheckBox, TColorDialog, TComboBox, TDBCheckBox, TDBComboBox, TDBCtrlGrid,
TDBEdit, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupComboBox, TDBLookupList,
TDBLookupListBox, TDBMemo, TDBRadioGroup, TDBText, TDirectoryListBox, TDrawGrid, TDriveComboBox,
TEdit, TFileListBox, , TFrame TForm, TGroupBox, TIWCheckBox, TIWControl, TIWDBCheckBox, TIWDBEdit,
TIWDBFile, T IWDBGrid, TIWDBImage, TIWDBListBox, TIWEdit, TIWFile, TIWLabel, TIWListBox,
TIWLookupCombobox, TLabel, TListBox, TListView, TMaskEdit, TMemo, TNotebook, TOutline, TPageControl,
TPaintBox, TPanel, TQRBand, TQRBand, TQRDBText, TQRLabel, TQRMemo, TQRPreview e TQRSysData,
TRadioButton, TRichEdit, TScrollBox, TStringGrid, TTreeView
continuao
Valor Significado
clMenuText Cor do texto em menus, definida no Painel de Controle do Windows.
clWindowText Cor do texto em janelas, definida no Painel de Controle do Windows.
clCaptionText Cor do texto na barra de ttulo da janela ativa, definida no Painel de Controle
do Windows.
clActiveBorder Cor da borda da janela ativa, definida no Painel de Controle do Windows.
clInactiveBorder Cor da borda da janela inativa, definida no Painel de Controle do Windows.
clAppWorkSpace Cor da rea de trabalho do aplicativo, definida no Painel de Controle do Windows.
clHighlight Cor de fundo de um texto selecionado, definida no Painel de Controle do Windows.
clHighlightText Cor de um texto selecionado, definida no Painel de Controle do Windows.
clBtnFace Cor da face de um boto, definida no Painel de Controle do Windows.
clBtnShadow Cor da sombra de um boto, definida no Painel de Controle do Windows.
clGrayText Cor do texto obscuro em um boto, definida no Painel de Controle do Windows.
clBtnText Cor do texto exibido em um boto, definida no Painel de Controle do Windows.
clInactiveCaptionText Cor do texto da barra de ttulo de uma janela inativa, definida no Painel de
Controle do Windows.
clBtnHighlight Cor de um boto, definida no Painel de Controle do Windows.
COLOREACHPOINT
Descrio
A propriedade ColorEachPoint uma varivel do tipo booleano que determina se cada ponto da srie
representada pelo objeto deve ser desenhado com uma cor distinta.
Na fase de projeto:
TChartSeries
TChartSeries
COLOREDBUTTONS
Descrio
A propriedade ColoredButtons declarada como uma varivel do tipo TButtonSet e consiste num
conjunto que define os botes do componente que devem aparecer coloridos.
Exemplo
O trecho de cdigo a seguir faz com que todos os botes apaream em cores.
TMediaPlayer1.ColoredButtons := [btPlay, btPause, btStop, btNext, btPrev, btStep, btBack, btRecord,
btEject]
Na fase de projeto:
TMediaPlayer
TMediaPlayer
COLS
Descrio
A propriedade Cols declarada como uma array de listas de strings, onde cada lista armazena as strings
das clulas de uma coluna da grade. O ndice da array define o nmero da coluna a ser acessada,
comeando com 0. Na realidade, cada coluna tratada como uma lista de strings. Essa propriedade s
Exemplo
A linha de cdigo a seguir adiciona a string Nova string lista de strings correspondente terceira
coluna de um componente chamado StringGrid1 do tipo TStringGrid:
StringGrid1.Cols[2].Add(Nova string);
TStringGrid
COLUMNMARGININCHES
Descrio
A propriedade ColumnMarginInches uma varivel do tipo inteiro longo que define, em dcimos de
polegada, o espao entre colunas para um relatrio de mltiplas colunas.
Na fase de projeto:
TQuickReport
TQuickReport
COLUMNMARGINMM
Descrio
A propriedade ColumnMarginMM uma varivel do tipo inteiro longo que define, em milmetros, o
espao entre colunas para um relatrio de mltiplas colunas.
Na fase de projeto:
TQuickReport
TQuickReport
COLUMNS
Descrio
Para componentes do tipo TQuickReport, a propriedade Columns declarada como uma varivel do
tipo booleana, e define o nmero de colunas do relatrio.
Para componentes dos tipos TDBRadioGroup, TDirectoryListBox, TListBox e TRadioGroup, essa
propriedade declarada como uma varivel do tipo inteiro longo (Longint), e indica o nmero de
colunas do controle.
Para controles do tipo TListView, essa propriedade declarada como uma varivel do tipo TListColumns,
e define o cabealho de uma coluna do componente.
Exemplo
Voc pode alterar a propriedade Columns de um componente diretamente no Object Inspector ou
durante a execuo do aplicativo incluindo uma linha de cdigo como:
ListBox1.Columns := 3;
Na fase de projeto:
TDBRadioGroup, TDirectoryListBox, TListBox, TListView, TQuickReport e TRadioGroup
TDBRadioGroup, TDirectoryListBox, TListBox, TListView, TQuickReport e TRadioGroup
COLWIDTHS
Descrio
A propriedade ColWidths declarada com uma array de inteiros, onde cada item da array define a
largura, em pixels, das clulas da coluna especificada pelo ndice. Essa propriedade s est disponvel
Exemplo
largura das clulas da primeira coluna de um componente StringGrid1 do tipo TStringGrid quando o
usurio seleciona uma clula com o mouse.
begin
Label1.Caption := IntToStr(StringGrid1.ColWidths[0]);
end;
COMMAND
Descrio
Essa propriedade declarada como uma varivel do tipo Word inteira e indica o nmero do comando
passado para o Windows usar na mensagem WM_COMMAND a ser enviada para o formulrio quando o
usurio seleciona um item de menu. Esse comando s til se voc quiser manipular diretamente a
mensagem WM_COMMAND, o que raramente necessrio com o Delphi. Essa propriedade s pode ser
acessada durante a execuo do aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
TMenuItem
COMMANDTEXT
Descrio
Essa propriedade definida como uma varivel do tipo String, e define o comando a ser executado
Na fase de projeto:
TADOCommand e TSQLDataset
TADOCommand, TADODataset, TADOTable, TADOQuery, TADOStoredProc e TSQLDataset
COMMANDTIMEOUT
Descrio
a execuo de um comando (seno considera-se que o comando no foi executado com successo). Seu
Na fase de projeto:
TADOCommand, TADOConnection, TADODataset
TADOCommand, TADOConnection, TADODataset, TADOTable, TADOQuery e TADOStoredProc
COMMANDTYPE
Descrio
Para componentes do tipo TADOCommand e TADODataset, essa propriedade definida como uma
varivel do tipo TCommandType, e define o tipo de comando a ser executado.
Para estes componentes, esta propriedade pode assumir um dos seguintes valores:
As constantes cmdTable, cmdTableDirect e cmdOpenFile no so usadas com o componente TADOCommand.
Para o componente TSQLDataset, essa propriedade definida como uma varivel do tipo
TSQLCommandType, e define o tipo de comando a ser executado.
Para este componente, esta propriedade pode assumir um dos seguintes valores:
Na fase de projeto:
TADOCommand, TADODataset e TSQLDataset
TADOCommand, TADODataset, TADOTable, TADOQuery, TADOStoredProc e TSQLDataset
COMMONAVI
Descrio
Essa propriedade declarada como uma varivel booleana, e define se o clipe a ser exibido pelo
componente corresponde a uma das animaes armazenadas no arquivo Shell32.dll.
Valor Significado
CmdUnknown: O tipo de comando desconhecido
cmdText O comando uma definio textual de uma declarao SQL ou chamada de uma
Stored Procedure
cmdTable O comando , na realidade, o nome de uma tabela.
cmdStoredProc O comando , na realidade, o nome de uma stored procedure.
cmdFile O comando se refere ao nome de um arquivo no qual um conjunto de registros
est armazenado..
cmdTableDirect O comando , na realidade, o nome de uma tabela; sendo todos os campos
retornados.
Valor Significado
ctTable O comando , na realidade, o nome de uma tabela.
ctStoredProc O comando , na realidade, o nome de uma stored procedure.
ctQuery O comando uma instruo SQL.
Na fase de projeto:
TAnimate
TAnimate
COMPONENTCOUNT
Descrio
A propriedade ComponentCount declarada como uma varivel inteira e indica o nmero de
componentes possudos pelo componente atual, e listados na sua propriedade Components. Essa
propriedade s pode ser acessada durante a execuo do aplicativo e no pode ter o seu valor diretamente
Exemplo
Crie um formulrio em branco (chamado Form1) e inclua um componente TLabel (chamado Label1).
Se durante a execuo do aplicativo voc quiser exibir o valor da propriedade ComponentCount em
Label1, inclua as seguintes linhas de cdigo:
Label1.Caption := IntToStr(Form1.ComponentCount);
Todos.
COMPONENTINDEX
Descrio
A propriedade ComponentIndex declarada como uma varivel do tipo inteiro e indica a posio do
componente na lista do seu componente-proprietrio. O primeiro componente da lista possui o valor
da propriedade ComponentIndex igual a 0, o segundo possui o valor 1 e assim por diante. Essa
propriedade s pode ser acessada durante a execuo do aplicativo e, ao contrrio do que consta no
Help On-line do Delphi, pode ter o seu valor diretamente alterado pelo usurio.
Exemplo
Crie um formulrio em branco (chamado Form1) e inclua um componente TButton (chamado But-
ton1), um componente TPanel (chamado Panel1) e um componente TRadioButton (chamado
TRadioButton1).
Se durante a execuo do aplicativo voc quiser colocar o valor da propriedade ComponentIndex de
cada um dos componentes acima em trs variveis inteiras a, b e c, inclua as seguintes linhas de cdigo:
a := Form1.Button1.ComponentIndex;
b := Form1.Panel1.ComponentIndex;
c := Form1.RadioButton11.ComponentIndex;
Para alterar a propriedade ComponentIndex de um componente, basta incluir uma linha de cdigo
do tipo:
Form1.Panel1.ComponentIndex := a;
Nesse caso, o Delphi se encarrega de redefinir a propriedade ComponentIndex dos demais controles,
de modo que no ocorra duplicao de ndice.
Todos.
COMPONENTS
Descrio
A propriedade Components declarada como uma array que contm todos os componentes que
pertencem ao componente atual. Essa propriedade s pode ser acessada durante a execuo do aplicativo
e no pode ter o seu valor diretamente alterado pelo usurio.
Observao: No confundir a propriedade Components com a propriedade Controls. A propriedade Com-
ponents contm todos os componentes que pertencem ao componente atual, enquanto a propriedade
Controls contm todos os controles que pertencem ao componente atual, no caso de este ser um controle
(lembre-se de que todo controle um componente mas nem todo componente um controle).
Exemplo
Se voc quiser que um componente chamado Label1 tenha a sua propriedade Caption igual do
terceiro componente da propriedade Components de um formulrio chamado Form1, basta digitar a
Label1.Caption := TButton(Form1.Components[2]).Caption;
Todos.
CONFIRMDELETE
Descrio
A propriedade ConfirmDelete declarada como uma varivel booleana e determina se deve ser exibida
uma mensagem de confirmao quando o usurio tentar deletar um registro do banco de dados com o
controle TDBNavigator.
Exemplo
Voc pode alterar a propriedade ConfirmDelete diretamente no Object Inspector ou durante a execuo
DBNavigator1.ConfirmDelete := False;
Na fase de projeto:
TDBNavigator
TDBNavigator
CONNECTED
Descrio
A propriedade Connected uma varivel booleana que define se o componente est ou no conectado
a um banco de dados.
Exemplo
Voc pode alterar a propriedade Connected de um componente diretamente no Object Inspector ou
Database1.Connected := True;
Na fase de projeto:
TSQLConnection, TADOConnection, TIBDatabase, Tdatabase, TRDSConnection
TSQLConnection, TADOConnection, TDatabase
CONNECTION
Descrio
Para componentes de acesso via ADO, essa propriedade definida como uma varivel do tipo
TADOConnection, e define o tipo de conexo que ser usada pelo componente.
Para componentes de acesso via DBExpress (TSQLConnection), essa propriedade definida como uma
varivel do tipo string, e identifica a conexo representada pelo componente.
Na fase de projeto:
TSQLConnection, TADOCommand, TADODataset, TADOTable, TADOQuery e TADOStoredProc
TSQLConnection, TADOCommand, TADODataset, TADOTable, TADOQuery e TADOStoredProc
CONNECTIONSTRING
Descrio
ao banco de dados.
Na fase de projeto:
CONNECTMODE
Descrio
A propriedade ConnectMode declarada como uma varivel do tipo TDataMode que estabelece como
ser feita a ligao com a aplicao servidora.
Tabela de Valores:
Exemplo
Voc pode alterar o valor da propriedade ConnectMode de um componente diretamente no Object
Inspector ou atravs de uma linha de cdigo, como:
DdeClientConv1.ConnectMode := ddeManual;
Na fase de projeto:
TDDEClientConv
TDDEClientConv
CONTEXT
Descrio
A propriedade Context declarada como uma varivel do tipo string, e contm informaes sobre o
erro que gerou a exceo.
EReconcileError, EUpdateError
CONTROLCOUNT
Descrio
A propriedade ControlCount declarada como uma varivel inteira e indica o nmero de controles
pertencentes ao controle atual. Essa propriedade s pode ser acessada durante a execuo do aplicativo
Exemplo
Se voc quiser saber quantos controles pertencem a um componente Panel (chamado Panel1) de um
formulrio chamado Form1 e atribuir esse valor a uma varivel inteira a, basta digitar a seguinte linha
de cdigo:
a := Form1.Panel1.ControlCount;
Todos os controles.
Valor Significado
ddeAutomatic A ligao feita automaticamente quando o formulrio que contm o componente
TDDEClientConv criado, durante a execuo do aplicativo.
ddeManual A ligao feita atravs do mtodo OpenLink, durante a execuo do aplicativo.
CONTROLS
Descrio
A propriedade Controls declarada como uma array que contm todos os controles que pertencem ao
controle atual. Essa propriedade s pode ser acessada durante a execuo do aplicativo e no pode ter
No confundir a propriedade Controls com a propriedade Components. A propriedade Components contm todos os componentes que
pertencem ao componente atual, enquanto a propriedade Controls contm todos os controles que pertencem ao controle atual (lembre-
se de que todo controle um componente mas nem todo componente um controle).
Exemplo
Se voc quiser que um componente chamado Label1 tenha a sua propriedade Caption igual do
terceiro elemento da propriedade Controls de um formulrio chamado Form1, basta digitar a seguinte
linha de cdigo:
Label1.Caption := TButton(Form1.Controls[2]).Caption;
Todos os controles.
CONTROLTYPE
Descrio
Essa propriedade declarada como uma varivel do tipo TDecisionControlType e responde a alteraes
no componente DecisionPivot.
Essa propriedade pode receber um dos valores mostrados na tabela a seguir.
Na fase de projeto:
TDecisionSource
TDecisionSource
Valor Significado
xtCheck A seleo de um dos botes correspondentes s dimenses manipuladas pelo componente
abre ou fecha a dimenso associada ao boto.
xtRadio A seleo de um dos botes correspondentes s dimenses manipuladas pelo componente
abre ou fecha a dimenso associada ao boto e fecha as demais dimenses associadas
quela direo.
xtRadionEx A seleo de um dos botes correspondentes s dimenses manipuladas pelo componente
abre ou fecha a dimenso associada ao boto e fecha ou abre outra dimenso associada
quela direo.
CONVERTDLGHELP
Descrio
A propriedade ConvertDlgHelp uma varivel do tipo THelpContext que fornece um nmero ao qual
est associado um tpico de auxlio sensvel ao contexto para a caixa de dilogo Convert. A caixa de
dilogo Convert permite que o usurio converta um objeto OLE em outro tipo de objeto.
Exemplo
Voc pode definir o valor da propriedade ConvertDlgHelp diretamente no Object Inspector ou mediante
uma linha de cdigo, como:
OLEContainer1.ConvertDlgHelp := 8;
Na fase de projeto:
TOLEContainer
TOLEContainer
COPIES
Descrio
A propriedade Copies uma varivel inteira que define o nmero de cpias a serem
impressas.
Exemplo
PrintDialog1.Copies := 1;
Na fase de projeto:
TPrintDialog, TRvNDRWriter, TRvRenderPreview, TRvRenderPrinter
TBaseReport, TCanvasReport, TPrintDialog, TRvNDRWriter, TRvRenderPreview, TRvRenderPrinter
COUNT
Descrio
Para componentes do tipo TIndexDefs, essa propriedade declarada como uma varivel inteira e de-
fine o nmero de elementos armazenados na propriedade Items.
Para componentes do tipo TFieldDefs, essa propriedade declarada como uma varivel inteira e define
o nmero de objetos armazenados.
Para componentes dos tipos TList, TStringList, Tstrings e TMenuItem, essa propriedade declarada
como uma varivel inteira e define o nmero de itens armazenados em uma lista ou item de menu.
TIndexDefs, TFieldDefs, TList, TStringList, Tstrings e TMenuItem
CTL3D
Descrio
A propriedade Ctl3D declarada como uma varivel booleana e determina se o controle ter um
aspecto tridimensional (True) ou bidimensional (False).
Exemplo
Voc pode alterar a propriedade Ctl3D de um componente diretamente no Object Inspector ou du-
RadioButton1.Ctl3D := False;
Observao: Para que a propriedade Ctl3D funcione com componentes dos tipos TRadioButton,
TCheckBox e dilogos comuns do Windows, o arquivo CTL3DV2.DLL deve estar presente no path do
sistema.
Na fase de projeto:
TCheckBox, TColorDialog, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage,
TDBListBox, TDBLookupCombo, TDBLookupComboBox, TDBLookupList, TDBLookupListBox, TDBMemo,
TDBNavigator, TDBRadioGroup, TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox,
TFindDialog, TFilterComboBox, TFontDialog, TFrame, TForm, TGroupBox, TListBox, TListView, TMaskEdit,
TMemo, TNotebook, TOLEContainer, TOpenDialog, TOpenPictureDialog, TOutline, TPanel, TQRPreview,
TRadioButton, TReplaceDialog, TRichEdit, TSaveDialog, TSavePictureDialog, TScrollBar, TScrollBox,
TStringGrid, TTrackBar e TTreeView
TCheckBox, TColorDialog, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage,
TDBListBox, TDBLookupCombo, TDBLookupComboBox, TDBLookupList, TDBLookupListBox, TDBMemo,
TDBNavigator, TDBRadioGroup, TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox,
TFindDialog, TFilterComboBox, TFontDialog, ,TFrame , TForm, TGroupBox, TListBox, TListView,
TMaskEdit, TMemo, TNotebook, TOLEContainer, TOpenDialog, TOpenPictureDialog, TOutline, TPanel,
TQRPreview, TRadioButton, TReplaceDialog, TRichEdit, TSaveDialog, TSavePictureDialog, TScrollBar,
TScrollBox, TStringGrid, TTrackBar e TTreeView
CURRENCY
Descrio
A propriedade Currency uma varivel booleana usada para controlar o formato de exibio do campo.
Quando Currency igual a True a formatao feita com a funo FloatToText usando ffCurrency
como parmetro para exibir texto ou ffFixed como parmetro para editar texto. Quando Currency
igual a False, a formatao feita com a funo FloatToTextFmt. Essa propriedade s est disponvel
Exemplo
Voc pode alterar a propriedade Currency de um componente atravs de uma linha de cdigo, como:
FloatField1.Currency := True;
TBCDField, TCurrencyField e TFloatField
CURRENTMEMORY
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro longo, e define a quantidade de memria
do servidor usada pelo banco de dados.
Na fase de projeto:
TIBDatabaseInfo
TIBDatabaseInfo
CURRENTPAGE
Descrio
A propriedade Currentpage uma varivel inteira que define o nmero da pgina corrente do relatrio.
TBaseReport, TCanvasReport, TRvNDRWriter, TRvRenderPreview, TRvRenderPrinter
CURRENTSUM
Descrio
Essa propriedade declarada como uma varivel inteira, e define o sumrio corrente do componente
DecisionCube ao qual est vinculado.
Na fase de projeto:
TDecisionSource
TDecisionSource
CURSOR
Descrio
A propriedade Cursor declarada como uma varivel do tipo TCursor e indica a imagem exibida pelo
ponteiro do mouse quando este passa sobre o controle.
Tabela de Valores:
continua
Valor Significado
crDefault Ponteiro do mouse em forma de seta inclinada.
crArrow Ponteiro do mouse em forma de seta inclinada.
crCross Ponteiro do mouse em forma de cruz.
crIBeam Ponteiro do mouse em forma de I.
crSize Ponteiro do mouse com quatro setas.
crSizeNESW Ponteiro do mouse com duas setas na direo NE-SW.
Exemplo
Se voc quiser que o ponteiro do mouse tenha o formato de uma cruz ao passar sobre um componente
Shape1 do tipo TShape, basta definir a sua propriedade Cursor como crCross no Object Inspector.
Na fase de projeto:
Todos os controles, objetos da classe TChartSeries.
Todos os controles, objetos da classe TChartSeries.
CURSORS
Descrio
Para um componente TScreen, a propriedade Cursors declarada como uma varivel do tipo HCursor
e d acesso a uma lista de cursores disponveis para a sua aplicao. Essa propriedade s est disponvel
Tabela de Valores:
continuao
continua
Valor Significado
crSizeNS Ponteiro do mouse com duas setas na direo N-S.
crSizeNWSE Ponteiro do mouse com duas setas na direo NW-SE.
crSizeWE Ponteiro do mouse com duas setas na direo W-E.
crUpArrow Ponteiro do mouse em forma de seta apontando para cima.
crHourglass Ponteiro do mouse em forma de ampulheta.
crDrag Ponteiro do mouse em forma de smbolo de arraste.
crNoDrop Ponteiro do mouse indicando que um componente no pode ser solto
sobre outro.
crHSplit Ponteiro do mouse em forma de dupla seta horizontal.
crVSplit Ponteiro do mouse em forma de dupla seta vertical.
Valor ndice Significado
crDefault 0 Ponteiro do mouse em forma de seta inclinada.
crNone -1 Invisvel.
crArrow -2 Ponteiro do mouse em forma de seta inclinada.
crCross -3 Ponteiro do mouse em forma de cruz.
crIBeam -4 Ponteiro do mouse em forma de I.
crSize -6 Ponteiro do mouse com quatro setas.
crSizeNESW -7 Ponteiro do mouse com duas setas na direo NE-SW.
crSizeNS -8 Ponteiro do mouse com duas setas na direo N-S.
crSizeNWSE -9 Ponteiro do mouse com duas setas na direo NW-SE.
crSizeWE -8 Ponteiro do mouse com duas setas na direo W-E.
Exemplo
Se voc possuir um cone com nome MyCursor e quiser torn-lo a imagem do ponteiro do mouse ao
passar sobre um formulrio, inclua o seguinte trecho de cdigo:
const
crMyCursor = 5;
begin
Screen.Cursors[crMyCursor] := LoadCursor(1, NewCursor);
Cursor := crMyCursor;
end;
TScreen
CURSORXPOS
Descrio
A propriedade CursorXPos uma varivel inteira que define a posio horizontal do texto, em unidades
de impresso (pontos).
CURSORYPOS
Descrio
A propriedade CursorYPos uma varivel inteira que define a posio vertical do texto, em unidades
de impresso (pontos).
continuao
Valor ndice Significado
crUpArrow -10 Ponteiro do mouse em forma de seta apontando para cima.
crHourGlass -11 Ponteiro do mouse em forma de ampulheta.
crDrag -12 Ponteiro do mouse em forma de smbolo de arraste.
crNoDrop -13 Ponteiro do mouse indicando que um componente no pode ser solto
sobre outro.
crHSplit -14 Ponteiro do mouse em forma de dupla seta horizontal.
crVSplit -15 Ponteiro do mouse em forma de dupla seta vertical.
crMultiDrag -16 Ponteiro do mouse em forma de arraste mltiplo.
CUSTOMCOLORS
Descrio
A propriedade CustomColors, que declarada como uma varivel do tipo TStrings, armazena uma
lista de strings e especifica as cores personalizadas que estaro disponveis na caixa de dilogo.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector (com o string list editor)
ou mediante a incluso de um trecho de cdigo, como:
if ColorDialog1.Execute then ListBox1.Items.AddStrings(ColorDialog1.CustomColor
Na fase de projeto:
TColorDialog
TColorDialog
DATA
Descrio
A propriedade Data declarada como uma varivel do tipo Pointer e especifica qualquer dado que
voc queira associar com um item de um componente do tipo TOutline. Essa propriedade s est
TOutlineNode
DATABASE
Descrio
A propriedade Database declarada como uma varivel do tipo TDataSet que define o componente de
banco de dados associado. Essa propriedade s est disponvel durante a execuo do aplicativo e no
pode ter o seu valor diretamente alterado pelo usurio.
TIBDatabaseinfo, TIBEvents, TIBSQL, TTable e TQuery, TDecisionQuery
DATABASECOUNT
Descrio
A propriedade DatabaseCount declarada como uma varivel inteira e especifica o nmero de
componentes TDataBase (no caso de TSession) ou TIBDatabase (no caso de TIBTransaction) existentes
na aplicao. Essa propriedade s est definida durante a execuo do aplicativo e no pode ter o seu
valor diretamente alterado pelo usurio.
TIBTransaction, TSession
DATABASENAME
Descrio
A propriedade Database declarada como uma varivel do tipo string e define o nome ou alias do
banco de dados acessado pelo componente.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector (com o string list editor)
ou mediante a incluso de um trecho de cdigo, como:
Table1.DatabaseName := Banco_de_Dados;
Na fase de projeto:
TDataBase, TIBDataBase, TIBTable, TIBQuery, TIBStoredProc
TTable, TQuery, TDecisionQuery e TStoredProc
TDataBase, TTable, TQuery, TDecisionQuery e TStoredProc
DATABASES
Descrio
A propriedade DataBases declarada como uma array de objetos do tipo TDataBase e mantm uma lista
dos objetos do tipo TDataBase ou TIBDatabase disponveis em uma aplicao. Essa propriedade s est
definida durante a execuo do aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
Exemplo
O trecho de cdigo a seguir fecha todos os bancos de dados associados a uma aplicao.
with Session do
while DatabaseCount <> 0 do
Databases[0].Close;
TIBTransaction, TSession
DATAFIELD
Descrio
A propriedade DataField declarada como uma varivel do tipo string e indica o campo a que esse
controle corresponde no registro de um banco de dados.
Exemplo
Voc pode definir a propriedade DataField diretamente no Object Inspector ou atravs de uma linha
de cdigo como:
DBEdit1.DataField := NOME;
que define a propriedade DataField de um componente chamado DBEdit1 do tipo TDBEdit como
sendo igual a NOME.
Na fase de projeto:
TDBCheckBox, TDBComboBox, TDBEdit, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupComboBox,
TDBLookupList, TDBLookupListBox, TDBMemo, TDBRadioGroup, TDBText, TIWDBCheckBox, TIWDBComboBox,
TIWDBEdit, TIWDBImage, TIWDBListBox, TIWDBLookupCombo, TIWDBLookupComboBox, TIWDBLookupListBox,
TIWDBMemo, TIWDBText, TQRCustomControl, TQRDBCalc, TQRDBText e TQRGroup
TDBCheckBox, TDBComboBox, TDBEdit, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupComboBox,
TDBLookupList, TDBLookupListBox, TDBMemo, TDBRadioGroup, TDBText, TIWDBCheckBox, TIWDBComboBox,
TIWDBEdit, TIWDBImage, TIWDBListBox, TIWDBLookupCombo, TIWDBLookupComboBox, TIWDBLookupListBox,
TIWDBMemo, TIWDBText,TQRCustomControl, TQRDBCalc, TQRDBText e TQRGroup
DATASET
Descrio
Para componentes dos tipos TDataSource, TIBUpdateSQL e TUpdateSQL, essa propriedade declarada
como uma varivel do tipo TDataSet e indica o componente que representa um banco de dados ao
qual o componente est associado.
Para componentes dos tipos TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField,
TCurrencyField, TDateField, TDecisionCube, TDateTimeField, TFloatField, TGraphicField, TIntegerField,
TMemoField, TRvDatasetConnection, TSmallintField, TStringField, TTimeField, TVarBytesField,
TUpdateSQL e TWordField essa propriedade declarada como uma varivel do tipo TDataSet e indica
o banco de dados ao qual o campo se refere. Para esses componentes, essa propriedade s est disponvel
Exemplo
Voc pode alterar o valor da propriedade DataSet mediante uma linha de cdigo como a seguir, onde
WordField uma varivel do tipo TWordField.
WordField.DataSet:= Banco_de_Dados
Na fase de projeto:
TDecisionCube, TDataSource, TRvDatasetConnection
TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField, TCurrencyField, TDataSource,
TDateField, TDateTimeField, TFloatField, TDecisionCube, TGraphicField, TIntegerField, TMemoField,
TRvDatasetConnection, TSmallintField, TStringField, TTimeField, TVarBytesField, TUpdateSQL e
TWordField
DATASETCOUNT
Descrio
A propriedade DataSetCount declarada como uma varivel inteira que define quantos componentes
dos tipos TIBDataset, TIBTable, TIBQuery, TIBStoredProc, TTable, TQuery, TDecisionQuery e TStoredProc
esto acessando o banco de dados representado por esse componente. Essa propriedade s est disponvel
durante a execuo do aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
TIBDatabase, TDatabase
DATASETS
Descrio
A propriedade DataSets declarada como uma array de componentes derivados de TDBDataSet que
define os componentes dos tipos TTable, TQuery, TDecisionQuery e TStoredProc que esto acessando
o banco de dados representado por esse componente.
TADOConnection, TIBDatabase, Tdatabase, TRDSConnection
DATASIZE
Descrio
A propriedade DataSize declarada como uma varivel inteira e define o nmero de bytes ocupados
pelo campo na memria. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem informando o nmero de bytes ocupado por
WordField, que uma varivel do tipo TWordField.
ShowMessage(IntToStr(WordField.DataSize);
DATASOURCE
Descrio
Para componentes dos tipos TDBCheckBox, TDBComboBox, TDBEdit, TDBCtrlGrid, TDBGrid, TDBImage,
TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo, TDBNavigator, TDBRadioGroup,
TIWDBCheckBox, TIWDBComboBox, TIWDBEdit, TIWDBGrid, TIWDBImage, TIWDBListBox,
TIWDBLookupCombo, IWDBLookupList, TIWDBMemo, TIWDBNavigator, TQuickReport, TQRDetailLink
e TDBText, a propriedade DataSource declarada como uma varivel do tipo TDataSource e indica o
componente ao qual est vinculado o banco de dados cujos campos se quer exibir.
Para componentes dos tipos TADOCommand, TADODataset, TADOTable, TADOQuery, e
TADOStoredProc, TQuery, TDecisionQuery e TClientDataSet a propriedade DataSource declarada
como uma varivel do tipo TDataSource e indica o componente ao qual est vinculado o banco de
dados ao qual se pode atribuir valores no limitados aos definidos por sua propriedades Params ou seu
mtodo ParamByName.
Para objetos da classe TChartSeries, determina a fonte de dados que definem os pontos da srie.
Exemplo
Voc pode definir a propriedade DataSource diretamente no Object Inspector ou atravs de uma linha
de cdigo, como:
DBEdit1.DataSource:= DataSource1;
Na fase de projeto:
TChartSeries, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBCtrlGrid, TDBImage, TDBListBox,
TDBLookupCombo, TDBLookupComboBox, TDBLookupList, TDBLookupListBox, TDBMemo, TDBNavigator,
TDBRadioGroup, TDBText, TIWDBCheckBox, TIWDBComboBox, TIWDBEdit, TIWDBGrid, TIWDBImage,
TIWDBListBox, TIWDBLookupCombo, IWDBLookupList, TIWDBMemo, TIWDBNavigator, TQRCustomControl,
TQRDBCalc, TQRDBText, TQRDetailLink, TQRGroup, TQuickReport, TQRDetailLink TClientDataSet, TQuery,
TdecisionQuery, TADOCommand, TADODataset, TADOTable, TADOQuery, e TADOStoredProc
TChartSeries, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBCtrlGrid, TDBImage, TDBListBox,
TDBLookupCombo, TDBLookupComboBox, TDBLookupList, TDBLookupListBox, TDBMemo, TDBNavigator,
TDBRadioGroup, TDBText, TIWDBCheckBox, TIWDBComboBox, TIWDBEdit, TIWDBGrid, TIWDBImage,
TIWDBListBox, TIWDBLookupCombo, IWDBLookupList, TIWDBMemo, TIWDBNavigator, TQRCustomControl,
TQRDBCalc, TQRDBText, TQRDetailLink, TQRGroup, TQuickReport, TQRDetailLink TClientDataSet, TQuery,
TDecisionQuery TADOCommand, TADODataset, TADOTable, TADOQuery, e TADOStoredProc
DATATYPE
Descrio
A propriedade DataType declarada como do tipo TFieldType e define o tipo do campo.
TDateTimeField, TFieldDef, TFloatField, TGraphicField, TIntegerField, TMemoField, TSmallintField,
TStringField, TTimeField, TVarBytesField e TWordField
DBFILENAME
Descrio
Esta propriedade declarada como uma varivel do tipo string, e define o nome do arquivo no qual o
banco de dados est armazenado.
Na fase de projeto:
TIBDatabaseInfo
TIBDatabaseInfo
DBHANDLE
Descrio
A propriedade DBHandle declarada como uma varivel do tipo HDBIDB, que permite acesso direto s
funes da API do Borland Database Engine (BDE). Essa propriedade s est disponvel durante a
execuo do aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
DBLOCALE
Descrio
A propriedade DBLocale declarada como uma varivel do tipo TLocale, que permite acesso direto ao
Borland Database Engine (BDE). Essa propriedade s est disponvel durante a execuo do aplicativo,
DBSQLDIALECT
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro e define o tipo de dialeto SQL usado
pelo banco de dados.
TIBDatabaseinfo, TIBDataBase
DDECONV
Descrio
A propriedade DDEConv declarada como uma varivel do tipo TDDEClientConv e define o
componente do tipo TDDEClientConv ao qual esse item est associado em uma conversao DDE.
Exemplo
Voc pode alterar o valor da propriedade DDEConv de um componente diretamente no Object Inspec-
DDEClientItem1.DDEConv := DDEClientConv1
Na fase de projeto:
TDDEClientConv
TDDEClientConv
DDEITEM
Descrio
A propriedade DDEItem declarada como uma varivel do tipo string e define o item de uma
conversao DDE.
Exemplo
Voc pode alterar o valor da propriedade DDEItem de um componente diretamente no Object Inspec-
DDEClientItem1.DDEItem := DDEC1;
Na fase de projeto:
TDDEClientConv
TDDEClientConv
DDESERVICE
Descrio
A propriedade DDEService declarada como uma varivel do tipo string que define o nome da
aplicao servidora.
Exemplo
Voc pode alterar o valor da propriedade DDEService de um componente diretamente no Object In-
spector ou atravs de uma linha de cdigo, como:
DdeClientConv1.DDEService := Programa;
Na fase de projeto:
TDDEClientConv
TDDEClientConv
DDETOPIC
Descrio
A propriedade DDETopic declarada como uma varivel do tipo string que define o tpico da
conversao DDE.
Exemplo
Voc pode alterar o valor da propriedade DDETopic de um componente diretamente no Object Inspec-
DdeClientConv1.DDETopic := Topico;
Na fase de projeto:
TDDEClientConv
TDDEClientConv
DECISIONCUBE
Descrio
Essa propriedade define o componente DecisionCube associado.
Na fase de projeto:
TDecisionSource
TDecisionSource
DECISIONSOURCE
Descrio
Essa propriedade define o componente DecisionSource associado.
Na fase de projeto:
TDecisionGrid, TDecisionGraph, TDecisionPivot
TDecisionGrid, TDecisionGraph, TDecisionPivot
DEFAULT
Descrio
A propriedade Default declarada como uma varivel do tipo booleano e indica se um controle do tipo
TButton ou TBitBtn associa o seu evento OnClick ao pressionamento da tecla Enter.
Exemplo
Coloque dois botes chamados Button1 e Button2 num formulrio chamado Form1 e defina a
propriedade Default de Button1 como True no Object Inspector. No evento OnClick de Button1, inclua
a seguinte linha de cdigo:
if Form1.Color := clYellow then Form1.Color := clRed else Form1.Color := clYellow;
Execute o aplicativo, pressione seguidamente a tecla Enter e voc ver a cor do formulrio alternar
entre vermelho e amarelo, a menos que Button2 receba o foco da aplicao.
Se durante a execuo do aplicativo um outro boto chamado Button2 obtiver o Foco, passar temporariamente a ser o boto default,
at que o foco seja dirigido para um componente que no seja um boto, quando Button1 voltar a ser o boto Default.
Na fase de projeto:
TBitBtn e TButton
TBitBtn e TButton
DEFAULTCOLWIDTH
Descrio
A propriedade DefaultColWidth uma varivel inteira que especifica a largura de todas as colunas do
componente. Se voc quiser alterar a largura de uma nica coluna, redefina a propriedade ColWidths
Exemplo
Voc pode alterar a propriedade DefaultColWidth de um componente diretamente no Object Inspec-
tor ou durante a execuo do aplicativo, incluindo uma linha de cdigo como:
DrawGrid1.DefaultColWidth := 50;
Na fase de projeto:
TDrawGrid, TDecisionGrid e TStringGrid
TDrawGrid, TDecisionGrid e TStringGrid
DEFAULTDATABASE
Descrio
Esta propriedade declarada como um objeto da classe TIBTransaction, e define o componente default
que representa um banco de dados associado a transao.
Na fase de projeto:
TIBTransaction
TIBTransaction
DEFAULTDRAWING
Descrio
A propriedade DefaultDrawing uma varivel booleana que determina se uma clula deve ser pintada
e o item que ela contm deve ser desenhado automaticamente. Se o valor da varivel for False, o
desenho da clula deve ser programado nos eventos OnDrawCell e OnDrawDataCell.
Exemplo
Voc pode alterar a propriedade DefaultDrawing de um componente diretamente no Object Inspector
ou durante a execuo do aplicativo, incluindo uma linha de cdigo como:
DBGrid1.DefaultDrawing := False;
Na fase de projeto:
TDBGrid, TDrawGrid e TString
TDBGrid, TDrawGrid e TString
DEFAULTEXT
Descrio
A propriedade DefaultExt declarada como uma varivel do tipo TFileExt que especifica a extenso a ser
adicionada ao nome de um arquivo quando o usurio digita o nome de um arquivo sem a sua extenso.
Exemplo
Voc pode alterar a propriedade DefaultExt de um componente diretamente no Object Inspector ou
OpenDialog1.DefaultExt := TXT;
Na fase de projeto:
TOpenDialog, TOpenPictureDialog e TSaveDialog, TSavePictureDialog
DEFAULTINDEX
Descrio
A propriedade DefaultIndex declarada como uma varivel booleana, e define se os registros da tabela
representada pelo componente devem ser ordenados por um ndice default quando a tabela aberta.
Na fase de projeto:
TIBTable, TTable
TTable
DEFAULTROWHEIGHT
Descrio
A propriedade DefaultRowHeight uma varivel inteira que especifica a altura de todas as linhas do
componente. Se voc quiser alterar a altura de uma nica linha, redefina a propriedade RowHeigths
Exemplo
Voc pode alterar a propriedade DefaultRowHeigth de um componente diretamente no Object Inspec-
DrawGrid1. DefaultRowHeigth := 50;
Na fase de projeto:
DEFAULTTRANSACTION
Descrio
A propriedade DefaultTransaction declarada como um objeto da classe TIBTransaction e define a
transao default associada ao banco de dados representado pelo componente.
Na fase de projeto:
TIBDataBase
TIBDataBase
DELETESQL
Descrio
Essa propriedade armazena uma lista de strings contendo a declarao SQL usada para deletar um registro.
Na fase de projeto:
TIBDataset, TIBUpdateSQL, TUpdateSQL
DESTINATION
Descrio
A propriedade Destination declarada como uma varivel do tipo TTable que define o componente ao
qual est associada uma tabela de um banco de dados qual sero adicionados os registros operados
pelo mtodo Execute de um componente do tipo TBatchMove.
Exemplo
BatchMove1.Destination := Table1;
Na fase de projeto:
TBatchMove
TBatchMove
DEVICE
Descrio
A propriedade Device declarada como uma varivel do tipo TFontDialogDevice e define o(s)
dispositivo(s) afetado(s) pela fonte selecionada.
Tabela de Valores:
Exemplo
FontDialog1.Device := fdBoth;
Na fase de projeto:
TFontDialog
Valor Significado
fdScreen Afeta a tela.
fdPrinter Afeta a impressora.
fdBoth Afeta a tela e a impressora.
TFontDialog
DEVICEID
Descrio
A propriedade DeviceID declarada como uma varivel do tipo Word e define uma ID para o dispositivo.
Essa propriedade s est definida durante a execuo do aplicativo e no pode ter o seu valor diretamente
Exemplo
O trecho de cdigo a seguir faz com que um componente Edit1 do tipo TEdit exiba a ID do dispositivo
multimdia corrente:
Edit1.Text := IntToStr(MediaPlayer1.DeviceID);
TMediaPlayer
DEVICETYPE
Descrio
A propriedade DeviceType declarada como uma varivel do tipo TMPDeviceTypes e define o tipo de
dispositivo a ser aberto com o mtodo Open. Os valores possveis para essa propriedade so dtAutoSelect,
dtAVIVideo, dtCDAudio, dtDAT, dtDigitalVideo, dtMMMovie, dtOther, dtOverlay, dtScanner,
dtSequencer, dtVCR, dtVideodisc e dtWaveAudio.
Exemplo
MediaPlayer1.DeviceType := dtDat;
Na fase de projeto:
TMediaPlayer
TMediaPlayer
DIMENSIONMAP
Descrio
Essa propriedade declarada como um objeto da classe TcubeDims e define as dimenses e sumrios
manipulados pelo componente.
Na fase de projeto:
TDecisionSource
TDecisionSource
DIRECTORY
Descrio
A propriedade Directory declarada como uma varivel do tipo string e define o diretrio apontado
pelo componente.
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado FileListBox1 do tipo TFileListBox
exiba os arquivos existentes no diretrio apontado pelo componente DirectoryListBox1 do tipo
TDirectoryListBox.
procedure TForm1.DirectoryListBox1Change(Sender: TObject);
begin
FileListBox1.Directory := DirectoryListBox1.Directory;
end;
TDirectoryListBox e TFileListBox
DIRLABEL
Descrio
A propriedade DirLabel declarada como uma varivel do tipo TLabel, que permite exibir o diretrio
corrente como a propriedade Caption de um componente do tipo TLabel.
Exemplo
Coloque um componente chamado Label1 do tipo TLabel e um componente chamado DirectoryListBox1
do tipo TDirectoryListBox em um formulrio. Defina a propriedade DirLabel de DirectoryListBox1 como
Label1 diretamente no Object Inspector ou mediante uma linha de cdigo, como:
DirectoryListBox1.DirLabel := Label1;
Isto faz com que Label1 exiba sempre o diretrio apontado por DirectoryListBox1.
Na fase de projeto:
TDirectoryListBox
TDirectoryListBox
DIRLIST
Descrio
A propriedade FileList declarada como uma varivel do tipo TDirectoryListBox e serve para fazer a
conexo com um componente do tipo TDirectoryListBox. Ao fazer esse tipo de conexo, o componente
TDirectoryListBox apontado por DirList exibir sempre o diretrio atual do drive corrente.
Exemplo
Coloque um componente chamado DriveComboBox1 do tipo TDriveComboBox e um componente
chamado DirectoryListBox1 do tipo TDirectoryListBox em um Formulrio.
Defina a propriedade DirList de DriveComboBox 1 como DirectoryListBox1 diretamente no Object
Inspector ou mediante uma linha de cdigo como:
DriveComboBox 1.DirList := DirectoryListBox 1;
Isto faz com que DirectoryListBox1 exiba sempre os diretrios do drive apontado por DriveComboBox 1.
Na fase de projeto:
TDriveComboBox
TDriveComboBox
DISABLEIFNOHANDLER
Descrio
A propriedade DisableIfNoHandler declarada como uma varivel booleana, e define se os controles e
itens de menu associados ao objeto devem ser desabilitados caso no exista nenhum procedimento
associado a evento definido para esse objeto.
Na fase de projeto:
TAction
TAction
DISPLAY
Descrio
A propriedade Display declarada como uma varivel do tipo TWinControl e define o controle a ser
usado para exibio dos resultados durante a execuo de um dispositivo multimdia.
Exemplo
MediaPlayer1.Display := Form1;
Na fase de projeto:
TMediaPlayer
TMediaPlayer
DISPLAYFORMAT
Descrio
A propriedade DisplayFormat declarada como uma varivel do tipo string e define o formato de
exibio de um campo. Essa propriedade s est disponvel durante a execuo do aplicativo.
TAutoIncField, TDateField, TDateTimeField, TIntegerField, TSmallintField, TTimeField e TWordField
DISPLAYLABEL
Descrio
A propriedade DisplayLabel declarada como uma varivel do tipo string e define o cabealho a ser
exibido na coluna que exibe o valor de um campo num componente do tipo TDBGrid. Se seu valor for
igual a Null, o valor armazenado na propriedade FieldName ser usado. Essa propriedade s est
Exemplo
Voc pode alterar o valor dessa propriedade mediante a incluso de uma linha de cdigo, como:
WordField1.DisplayLabel:= coluna;
onde WordField1 uma varivel do tipo TWordField.
TDateTimeField, TFloatField, TGraphicField, TIntegerField, TMemoField, TSmallintField,
DISPLAYNAME
Descrio
A propriedade DisplayLabel declarada como uma varivel do tipo Pstring e retorna o nome do campo.
DISPLAYPRINTDIALOG
Descrio
Essa propriedade declarada como uma varivel booleana e define se uma caixa de dilogo de impresso
deve ser exibida antes de o relatrio ser impresso.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou durante a execuo do
aplicativo, mediante a incluso de uma linha de cdigo como:
QuickReport1.DisplayPrintDialog:= True;
Na fase de projeto:
TquickReport
TQuickReport
DISPLAYRECT
Descrio
Para controles do tipo TMediaPlayer, a propriedade DisplayRect declarada como uma varivel do tipo
TRect, define uma rea retangular no controle a ser usado para exibio dos resultados durante a
execuo de um dispositivo multimdia e s est disponvel durante a execuo do aplicativo.
Para componentes do tipo TTabControl, essa propriedade declarada como uma varivel do tipo
TRect e define a altura, em pixels, da rea-cliente de um controle.
Exemplo
MediaPlayer1.DisplayRect:= Rect(10, 10, 100, 200);
TMediaPlayer e TTabControl
DISPLAYTEXT
Descrio
A propriedade DisplayText declarada como uma varivel do tipo string e retorna o texto exibido em um
controle de exibio de campos de bancos de dados (exceto TEdit). Essa propriedade s est disponvel
Exemplo
Voc pode exibir o valor dessa propriedade mediante a incluso de uma linha de cdigo, como:
ShowMessage(IntToStr(IntegerField1.DisplayText));
onde IntegerField1 uma varivel do tipo TIntegerField.
DISPLAYVALUE
Descrio
A propriedade DisplayValue declarada como uma varivel do tipo string e define a string exibida pelo
controle. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir faz com que um componente Label1 do tipo TLabel exiba a string armazenada
na propriedade DisplayValue de um componente DBLookupCombo1 do tipo TDBLookupCombo:
Label1.Caption := DBLookupCombo1.DisplayValue;
TDBLookupCombo e TDBLookupList
DISPLAYWIDTH
Descrio
A propriedade DisplayWidth declarada como uma varivel inteira que define o nmero de caracteres
usados para exibir o valor do campo em um controle do tipo TDBGrid. Essa propriedade s est disponvel
Exemplo
IntegerField1.DisplayWidth:= 15;
DITHERBACKGROUND
Descrio
A propriedade DitherBackground declarada como uma varivel booleana e define se a cor de fundo
do componente deve ser ajustada por um processo de Dithering.
Exemplo
Voc pode alterar a propriedade DitherBackground de um componente diretamente no Object Inspec-
TabSet1.DitherBackground := True;
Na fase de projeto:
TTabSet
TTabSet
DOCBACKCOLOR
Descrio
A propriedade DocBackColor declarada como uma varivel do tipo TColor e define a cor de fundo
default de uma pgina Web.
THTML
DOCFORECOLOR
Descrio
A propriedade DocForeColor declarada como uma varivel do tipo TColor e define a cor default do
texto exibido em uma pgina Web.
Na fase de projeto:
THTML
THTML
DOCKCLIENTCOUNT
Descrio
A propriedade DockClientCount declarada como uma varivel do tipo inteiro que define o nmero
de controles ancorados no componente.
TPanel, TChart, TDBChart, TDecisionGraph, TFrame, TForm, TDBCtrlGrid, TDrawGrid, TDecisionGrid
e TStringGrid
DOCKCLIENTS
Descrio
Essa propriedade armazena em uma array as referncias aos controles ancorados no componente.
e TStringGrid
DOCKRECT
Descrio
A propriedade DockRect declarada como uma varivel do tipo TRect que define uma rea retangular
na qual, se liberados, os controles sero ancorados.
e TStringGrid
DOCKSITE
Descrio
A propriedade DockSite declarada como uma varivel do tipo booleano que define se o controle
poder ancorar outros componentes, isto , se ser o alvo de uma operao de drag-e-dock.
e TStringGrid
DOCLINKCOLOR
Descrio
A propriedade DocLinkColor declarada como uma varivel do tipo TColor e define a cor default do
texto que representa um link em uma pgina Web.
THTML
DOCLINKCOLOR
Descrio
A propriedade DocVisitedColor declarada como uma varivel do tipo TColor e define a cor default do
texto que representa um link j visitado em uma pgina Web.
THTML
DOWN
Descrio
A propriedade Down declarada como uma varivel do tipo booleana, e indica se o componente est
selecionado (True) ou no (False).
Na fase de projeto:
TSpeedButton
TSpeedButton
DRAGCURSOR
Descrio
A propriedade DragCursor declarada como uma varivel do tipo TCursor e indica a imagem exibida
pelo ponteiro do mouse quando este passa sobre um controle que pode aceitar o objeto sendo arrastado.
Tabela de Valores:
Consulte a propriedade Cursor.
Exemplo
Se voc quiser alterar a propriedade DragCursor de um componente chamado Memo1 do tipo TMemo
para crIBeam, basta incluir a seguinte linha de cdigo:
Memo1.DragCursor:= crIBeam;
Na fase de projeto:
TBitBtn, TButton, TCheckBox, TComboBox, TDBCheckBox, TDBEdit, TDBGrid, TDBCtrlGrid, TDBImage,
TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo, TDBNavigator, TDBRadioGroup, TDBText,
TDirectoryListBox, TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TGroupBox, TImage,
TLabel, TListBox, TMaskEdit, TMemo, .TOutline, TPaintBox, TPanel, TRadioButton, TScrollBar,
TScrollBox, TShape, TDBLookupComboBox, TDBLookupListBox, TTabControl, THeaderControl,
TListView, TPageControl, TStatusBar, TTreeView, TTrackBar, TQRPreview e TNotebook
TBitBtn, TButton, TCheckBox, TComboBox, TDBCheckBox, TDBEdit, TDBGrid, TDBCtrlGrid, TDBImage,
TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo, TDBNavigator, TDBRadioGroup, TDBText,
TDirectoryListBox, TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TGroupBox, TImage,
TLabel, TListBox, TMaskEdit, TMemo, .TOutline, TPaintBox, TPanel, TRadioButton, TScrollBar,
TScrollBox, TShape, TDBLookupComboBox, TDBLookupListBox, TTabControl, THeaderControl,
TListView, TPageControl, TStatusBar, TTreeView, TTrackBar, TQRPreview e TNotebook
DRAGGING
Descrio
A propriedade Dragging declarada como uma varivel do tipo booleana que determina se o controle
est sendo arrastado. Essa propriedade s est disponvel durante a execuo do aplicativo.
Todos os controles.
DRAGMODE
Descrio
A propriedade DragMode declarada como uma varivel do tipo TDragMode e define o comportamento
de um controle no processo de arrastar e soltar.
Tabela de Valores:
Valor Significado
dmAutomatic O controle est pronto para ser arrastado, sem necessidade de programar o incio do processo de arraste.
dmManual O incio do processo de arraste deve ser feito por uma chamada ao mtodo BeginDrag.
Exemplo
Se voc quiser alterar a propriedade DragMode de um componente chamado Memo1 do tipo TMemo
para dmManual, basta incluir a seguinte linha de cdigo:
Memo1.DragMode:= dmManual;
Na fase de projeto:
TBitBtn, TButton, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid,
TDBCtrlGrid, TDBImage, TDBText, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo,
TDBNavigator, TDBRadioGroup, TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit,
TFileListBox, TFilterComboBox, TGroupBox, TImage, TLabel, TListBox, TMaskEdit, TMemo,
TOLEContainer, TOutline, TPaintBox, TRadioButton, TScrollBar, TScrollBox, TShape,
TDBLookupComboBox, TDBLookupListBox, TTabControl, THeaderControl, TListView, TPageControl,
TStatusBar, TTreeView, TTrackBar, TQRPreview, TStringGrid e TNotebook
TBitBtn, TButton, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid,
TDBCtrlGrid, TDBImage, TDBText, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo,
TFileListBox, TFilterComboBox, TGroupBox, TImage, TLabel, TListBox, TMaskEdit, TMemo,
TOLEContainer, TOutline, TPaintBox, TRadioButton, TScrollBar, TScrollBox, TShape,
TDBLookupComboBox, TDBLookupListBox, TTabControl, THeaderControl, TListView, TPageControl,
TStatusBar, TTreeView, TTrackBar, TQRPreview, TStringGrid e TNotebook
DRAWINGSTYLE
Descrio
Essa propriedade declarada como uma varivel do tipo TDrawingStyle, e especifica como a imagem
ser desenhada.
Tabela de Valores:
Na fase de projeto:
TImageList
TImageList
DRIVE
Descrio
A propriedade Drive declarada como uma varivel do tipo Char que determina o drive exibido em
um componente do tipo TDriveComboBox, o drive a que pertence o diretrio exibido em um
Valor Significado
dsFocused Desenha com uma combinao em 50% da cor do sistema.
dsSelected Desenha com uma combinao em 25% da cor do sistema.
dsNormal Desenha a imagem com a cor especificada na propriedade BkColor.
dsTransparent Desenha com uma mscara, independentemente do valor definido na propriedade BkColor.
componente TDirectoryListBox ou o drive a que pertencem os arquivos exibidos em um componente
TFileListBox. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode fazer com que um componente DirectoryListBox1 do tipo TDirectoryListBox exiba os
diretrios no drive C com a seguinte linha de cdigo:
DirectoryListBox1.Drive := C;
TDirectoryListBox, TDriveComboBox e TFileListBox
DRIVERNAME
Descrio
A propriedade DriverName especifica o driver do Borland Database Engine (BDE) ou do DBExpress
usado com o banco de dados associado ao componente. Essa propriedade s est disponvel durante a
TDatabase, TSQLConnection
DROPDOWNALIGN
Descrio
A propriedade DropDownAlign define o tipo de alinhamento do texto exibido na lista drop-down
mostrada pelo componente.
Tabela de Valores:
Exemplo
Voc pode alterar o valor da propriedade DropDownAlign diretamente no Object Inspector ou durante
a execuo do aplicativo, incluindo uma linha de cdigo como:
DBLookupComboBox1.DropDownAlign:= daLeft;
Na fase de projeto:
TDBLookupComboBox
TDBLookupComboBox
Valor Significado
daLeft Alinhamento esquerda.
daCenter Alinhamento pelo centro.
daRight Alinhamento direita.
DROPDOWNCOUNT
Descrio
A propriedade DropDownCount declarada como uma varivel inteira que define o nmero mximo
de elementos a serem exibidos simultaneamente numa lista DropDown.
Exemplo
Voc pode alterar a propriedade DropDownCount de um componente diretamente no Object Inspec-
ComboBox1.DropDownCount := 6;
Na fase de projeto:
TComboBox, TDBComboBox e TDBLookupCombo
TComboBox, TDBComboBox e TDBLookupCombo
DROPDOWNWIDTH
Descrio
A propriedade DropDownWidth declarada como uma varivel inteira que define, em pixels, a largura
da lista drop-down exibida pelo componente.
Exemplo
Voc pode alterar a propriedade DropDownWidth diretamente no Object Inspector ou durante a
execuo do aplicativo, incluindo uma linha de cdigo como:
DBLookupComboBox1.DropDownWidth:= 6;
Na fase de projeto:
TDBLookupCombo e TDBLookupComboBox
DROPTARGET
Descrio
Para componentes do tipo TListView, essa propriedade declarada como uma varivel do tipo TListItem
e retorna o item sobre o qual outro est sendo solto em uma operao de drag-drop. Essa propriedade
s est definida durante a execuo do aplicativo.
Para componentes do tipo TTreeView, essa propriedade declarada como uma varivel do tipo TTreeNode
e retorna o item sobre o qual outro est sendo solto em uma operao de drag-drop. Essa propriedade
s est definida durante a execuo do aplicativo.
Para componentes do tipo TTreeNode, essa propriedade declarada como uma varivel do tipo booleana,
e especifica se o item est sendo o alvo em uma operao de drag-drop. Essa propriedade s est
definida durante a execuo do aplicativo.
TListView e TTreeView
EDITFORMAT
Descrio
A propriedade EditFormat declarada como uma varivel do tipo string, usada para formatar o valor
de um campo para fins de edio. Essa propriedade s est disponvel durante a execuo do aplicativo.
TAutoIncField, TIntegerField, TSmallintField e TWordField
EDITMASK
Descrio
A propriedade EditMask uma varivel do tipo string que define a mscara que limita os dados que
podem ser digitados num componente do tipo EditMask ou em um campo de um registro de um
banco de dados. A mscara limita os caracteres considerados vlidos a serem digitados pelo usurio.
Uma mscara consiste em trs campos separados por ponto-e-vrgula. O primeiro campo a mscara
propriamente dita; o segundo campo consiste num caractere que define se os caracteres ou a mscara
devem ser salvos como parte dos dados; o terceiro campo define o caractere usado para representar
espaos em branco na mscara.
Existe um conjunto de caracteres especiais para definir uma mscara:
!: Se um ! aparecer na mscara, caracteres em branco no so armazenados como dados.
>: Se um > aparecer na mscara, todos os caracteres seguintes estaro em letras maisculas, at
que seja encontrado um caractere igual a <.
<: Se um < aparecer na mscara, todos os caracteres seguintes estaro em letras minsculas, at
que seja encontrado um caractere igual a >.
<>: Esse sinal significa que as letras maisculas e minsculas sero armazenadas como digitadas
pelo usurio.
\: Os caracteres que seguem esse sinal sero tratados como caracteres literais.
L: Esse caractere faz com que apenas caracteres alfabticos (a-z e A-Z) sejam aceitos nessa posio.
l: Esse caractere faz com que apenas caracteres alfabticos (a-z e A-Z) sejam aceitos nessa posio,
A: Esse caractere faz com que apenas caracteres alfanumricos (0-9, a-z e A-Z) sejam aceitos
nessa posio.
a: Esse caractere faz com que apenas caracteres alfanumricos (0-9, a-z e A-Z) sejam aceitos
nessa posio, mas aceita que sejam omitidos.
C: Esse caractere faz com que quaisquer caracteres sejam aceitos nessa posio.
c: Esse caractere faz com que quaisquer caracteres sejam aceitos nessa posio.
0: Esse caractere faz com que apenas caracteres numricos (0-9) sejam aceitos nessa posio.
9: Esse caractere faz com que apenas caracteres numricos (0-9) sejam aceitos nessa posio,
#: Esse caractere faz com que apenas caracteres numricos (0-9) e sinais de mais (+) ou menos
(-) sejam aceitos nessa posio, mas aceita que sejam omitidos.
: Esse caractere (dois pontos) usado para separar horas, minutos e segundos em dados horrios.
Se outro caractere separador de horas, minutos e segundos definido nos atributos internacionais
do Painel de Controle do seu sistema, esse caractere ser usado em vez de dois pontos.
/: Esse caractere usado para separar meses, dias, horas, minutos e segundos em dados de
datas. Se outro caractere separador de meses, dias e anos definido nos atributos internacionais
do Painel de Controle do seu sistema, ele ser usado em vez do caractere /.
;: O ponto-e-vrgula usado para separar mscaras.
_: O caractere _ insere espaos em branco na caixa de edio.
Exemplo
Voc pode alterar a propriedade EditMask diretamente no Object Inspector ou durante a execuo do
MaskEdit1.EditMask:= 999-999,1,@;
Na fase de projeto:
TDateField, TDateTimeField, TmaskEdit, TStringField e TTimeField
TDateField, TDateTimeField, TmaskEdit, TStringField e TTimeField
EDITMASKPTR
Descrio
A propriedade EditMaskPtr declarada como uma varivel do tipo string, usada como um ponteiro
para a propriedade EditMask. Essa propriedade s est disponvel durante a execuo do aplicativo e
no pode ter o seu valor diretamente alterado pelo usurio.
Na fase de projeto:
EDITMODE
Descrio
A propriedade EditMode uma varivel booleana que define se a grade est ou no no modo de edio.
Quando o seu valor True, o usurio pode digitar texto em uma clula sem ter que antes pressionar
Enter ou F2. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Durante a execuo do aplicativo, voc pode alterar o valor da propriedade EditMode com uma linha
de cdigo semelhante a:
DBCtrlGrid1.EditMode:= True;
TDBCtrlGrid
EDITORMODE
Descrio
Para componentes dos tipos TDBCtrlGrid, essa propriedade declarada como uma varivel booleana,
e indica se o registro corrente do banco de dados est sendo editado pelo usurio.
Para componentes do tipo TDBGrid, TDrawGrid, TStringGrid e TDBLookupList, essa propriedade
declarada como uma varivel booleana, e indica se o componente est no modo automtico de edio.
O valor dessa propriedade depende dos valores das propriedades Options e EditMode dos componentes.
Essa propriedade s est disponvel durante a execuo do aplicativo, e no pode ter o seu valor
TDBGrid, TDrawGrid, TStringGrid e TDBLookupList
EDITTEXT
Descrio
A propriedade EditText uma varivel do tipo string que armazena o valor da propriedade Text como
ela exibida durante a execuo do aplicativo, com a mscara definida na propriedade EditMask. Em
outras palavras, essa propriedade armazena o texto que realmente exibido durante a execuo do
aplicativo. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir faz com que um componente Label1 do tipo TLabel exiba o valor da
propriedade EditText de um componente DBEdit1 do tipo TDBEdit:
Label1.Caption := DBEdit1.EditText;
TDBEdit e TMaskEdit
EMPTY
Descrio
A propriedade Empty declarada como uma varivel booleana e determina se o objeto contm ou no
um grfico. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu
Exemplo
Voc pode verificar o valor dessa propriedade durante a execuo do aplicativo, incluindo uma linha
de cdigo como:
if Graphic1.Empty then ShowMessage(objeto vazio);
TBitmap, TGraphic, Ticon e TMetafile
ENABLED
Descrio
A propriedade Enabled declarada como uma varivel do tipo booleana e define se o componente
responde a eventos do mouse, do teclado e do temporizador, isto , define se o componente est habilitado.
Pata objetos da classe TAction, define o valor atribudo propriedade Enabled dos controles e itens de
menu associados ao objeto.
Exemplo
Se voc quiser que um boto chamado Button1 s responda a um nico clique do mouse, coloque a
seguinte linha de cdigo em seu evento OnClick:
Button1.Enabled := False;
Na fase de projeto:
Todos os controles e os componentes, alm de TAction, TMenuItem e TTimer.
Todos os controles e os componentes, alm de TAction, TMenuItem e TTimer.
ENABLEDBUTTONS
Descrio
A propriedade EnabledButtons declarada como uma varivel do tipo TButtonSet e consiste num
conjunto que define os botes do componente que esto habilitados.
Exemplo
de um trecho de cdigo.
O trecho de cdigo a seguir faz com que todos os botes estejam habilitados:
TMediaPlayer1.EnabledButtons := [btPlay, btPause, btStop, btNext, btPrev, btStep, btBack,
btRecord, btEject]
Na fase de projeto:
TMediaPlayer
TMediaPlayer
ENABLEOPENBTN
Descrio
Essa propriedade declarada como uma varivel booleana e define se o boto Open file ser exibido
num formulrio padro de pr-visualizao de relatrios.
TQRPrinter
ENABLEPRINTBTN
Descrio
Essa propriedade declarada como uma varivel booleana e define se o boto Print ser exibido num
formulrio padro de pr-visualizao de relatrios.
TQRPrinter
ENABLESAVEBTN
Descrio
Essa propriedade declarada como uma varivel booleana e define se o boto Save file ser exibido
num formulrio padro de pr-visualizao de relatrios.
TQRPrinter
ENDMARGIN
Descrio
A propriedade EndMargin declarada como uma varivel inteira e determina a distncia, em pixels, da
guia mais direita dentre as visveis no controle e a extremidade direita do controle.
Exemplo
O valor da propriedade EndMargin pode ser alterado diretamente no Object Inspector ou mediante a
incluso de uma linha de cdigo, como:
TabSet1.EndMargin := 6;
Na fase de projeto:
TTabSet
TTabSet
ENDPOS
Descrio
A propriedade EndPos declarada como uma varivel do tipo inteiro longo (Longint) que define a
posio final da execuo ou gravao em um dispositivo multimdia. Essa propriedade s est disponvel
Exemplo
O trecho de cdigo a seguir faz com que um arquivo de udio do tipo WAV seja executado pela metade
quando o usurio selecionar um boto chamado Button1 do tipo TButton:
begin
with MediaPlayer1 do
begin
FileName := D:\WINAPPS\SOUNDS\CARTOON.WAV;
Open;
EndPos := TrackLength[1] div 2;
Play;
end;
end;
TMediaPlayer
EOF
Descrio
A propriedade EOF uma varivel booleana que determina se um banco de dados est no seu ltimo
registro. Isto acontece depois que uma tabela aberta e ocorre uma chamada aos eventos Last ou Next.
TADODataset, TADOQuery, TADOStoredProc, TADOTable, TClientDataset, TDecisionQuery, TIBDataset,
TIBQuery, TIBStoredProc, TIBTable, TIBTransaction, TTable, TQuery, TDecisionQuery e TStoredProc
ERROR
Descrio
A propriedade Error declarada como uma varivel do tipo inteiro longo (Longint) que define o cdigo
do erro ocorrido na execuo ou gravao em um dispositivo multimdia.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com o cdigo do erro ocorrido durante a execuo
de um dispositivo multimdia.
ShowMessage(Erro +IntToStr(MediaPlayer1.Error));
TMediaPlayer
ERRORCODE
Descrio
Para objetos das classes EDBClient e EReconcileError, a propriedade ErrorCode declarada como uma
varivel do tipo string, e retorna o cdigo de erro fornecido pelo BDE.
Para objetos das classes EoleException e EOleSysError, a propriedade ErrorCode declarada como uma
varivel do tipo string, e retorna o cdigo de erro numa operao OLE.
EDBClient, EReconcileError , EOLEException, EOleSysError, EUpdateError
ERRORCOUNT
Descrio
A propriedade ErrorCount declarada como uma varivel do tipo integer, e retorna o nmero de erros
referenciados pela propriedade Errors.
EDBEngineError
ERRORMESSAGE
Descrio
A propriedade ErrorMessage declarada como uma varivel do tipo string que define a mensagem de
erro correspondente ao cdigo do erro ocorrido na execuo ou gravao em um dispositivo multimdia.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com o cdigo do erro ocorrido durante a execuo
de um dispositivo multimdia.
ShowMessage(MediaPlayer1.ErrorMessage);
TMediaPlayer
ERRORS
Descrio
A propriedade Errors declarada como um array de objetos da classe TDBError e retorna os erros
ocorridos com o BDE.
EDBEngineError
EVENTS
Descrio
A propriedade Events declarada como uma lista de strings que armazena os nomes dos eventos
interceptados pelo componente.
Na fase de projeto:
TIBEvents
TIBEvents
EXCLUSIVE
Descrio
A propriedade Exclusive declarada como uma varivel booleana e define se outros usurios podem
ter acesso mesma tabela que a representada por esse componente (isto no ser possvel se a propriedade
tiver o valor True).
Exemplo
Table1.Exclusive := True;
Na fase de projeto:
TTable
TTable
EXENAME
Descrio
A propriedade ExeName declarada como uma varivel do tipo string que armazena o nome do arquivo
executvel da aplicao, incluindo-se o Path. Essa propriedade s est disponvel durante a execuo
do aplicativo.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com o nome do arquivo executvel da aplicao.
ShowMessage(Application.ExeName);
TApplication
EXISTS
Descrio
A propriedade Exists declarada como uma varivel booleana e define se a tabela referenciada pelo
componente j existe ou se deve ser criada durante a execuo do aplicativo.
TIBTable, TTable
EXPANDED
Descrio
A propriedade Expanded declarada como uma varivel booleana e define se o item est expandido (se
seus subitens esto sendo exibidos). Essa propriedade s est disponvel durante a execuo do aplicativo.
TOutlineNode e TTreeNode
EXTENDSELECT
Descrio
A propriedade ExtendSelect declarada como uma varivel do tipo booleana e define se o usurio
pode selecionar uma faixa de itens usando a tecla Shift, ou vrios itens descontguos usando a tecla
Ctrl, desde que a propriedade Multiselect seja igual a True.
Exemplo
de cdigo, como:
ListBox1.ExtendSelect := False;
Na fase de projeto:
TListBox
TListBox
FIELDCLASS
Descrio
A propriedade FieldClass declarada como uma varivel do tipo TFieldClass que define o tipo de
componente correspondente ao campo. Essa propriedade s est disponvel durante a execuo do
aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
TField
FIELDCOUNT
Descrio
A propriedade FieldCount uma varivel inteira que especifica o nmero de campos (controles) em
um banco de dados. Esse nmero no corresponde necessariamente ao nmero de campos em uma
tabela relacionada a esse banco de dados, pois podemos adicionar novos campos a uma tabela (cujos
valores so calculados a partir dos existentes no banco de dados) ou remover campos com o Fields
Designer. Em componentes do tipo TDBGrid e TDBLookupList, o valor dessa propriedade corresponde
ao nmero de campos exibido pelo controle. Essa propriedade s est disponvel durante a execuo
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Label1 do tipo TLabel mostre o
nmero de colunas exibidas por um componente DBGrid1 do tipo TDBGrid.
Label1.Caption := IntToStr(DBGrid1.FieldCount);
TClientDataset, TDBGrid, TDBLookupList, TQuery, TDecisionQuery, TStoredProc, TTable
FIELDDEFS
Descrio
A propriedade FieldDefs declarada como uma varivel do tipo TFieldDef que armazena informaes sobre
cada campo em um banco de dados. Essa propriedade s est disponvel durante a execuo do aplicativo.
FIELDLIST
Descrio
A propriedade FieldList declarada como um objeto da classe TFieldList, que armazena uma lista de
objetos descendentes de TField associados ao dataset.
FIELDNAME
Descrio
A propriedade FieldName declarada como uma varivel do tipo string e define o nome da coluna que
armazena o valor de um campo num banco de dados. Essa propriedade s est disponvel durante a
FIELDNO
Descrio
A propriedade FieldNo declarada como uma varivel inteira e define a posio ordinal de um campo
num banco de dados. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode
TDateTimeField, TFieldDef, TFloatField, TGraphicField, TIntegerField, TMemoField,
TSmallintField, TStringField, TTimeField, TVarBytesField e TWordField
FIELDS
Descrio
Para objetos do tipo TIndexDef, a propriedade Fields declarada como uma varivel do tipo string
compreendendo os nomes e nmeros que compem o ndice, separados por ponto-e-virgula (;).
Para objetos dos tipos TDBGrid, TDBLookupList, TQuery, TDecisionQuery, TStoredProc e TTable, a
propriedade Fields declarada como uma array do tipo TField e se refere a um campo especfico de um
banco de dados. O primeiro campo do banco de dados corresponde ao ndice 0 da array.
Exemplo
O trecho de cdigo a seguir faz com que o texto mostrado no primeiro campo de um banco de dados
seja exibido justificado esquerda em um componente DBGrid1 do tipo
TBGrid.
DBGrid1.Fields[0].Alignment := taLeftJustify;
TADODataset, TADOQuery, TADOStoredProc, TADOTable, TClientDataset, TDBGrid, TDBLookupList,
TDecisionQuery, TIBDataset, TIBQuery, TIBStoredProc, TIBTable, TIBTransaction, TIndexDef,
FIELDVALUES
Descrio
A propriedade FieldValues declarada como uma array que d acesso direto aos valores armazenados
em todos os campos armazenados na tabela representada pelo componente.
TClientDataset
FILEEDIT
Descrio
A propriedade FileEdit declarada como uma varivel do tipo TEdit que define uma caixa de edio
que exibir o arquivo atualmente selecionado. Caso nenhum arquivo esteja selecionado, exibe a
propriedade Mask.
Exemplo
Coloque um componente chamado FileListBox1 do tipo TFileListBox e um componente chamado
Edit1 do tipo TDEdit em um formulrio. Defina a propriedade FileEdit de FileListBox1 como Edit1
diretamente no Object Inspector ou mediante uma linha de cdigo como:
FileListBox1.FileEdit := Edit1;
Isto faz com que Edit1 exiba sempre o arquivo selecionado em FileListBox1.
Na fase de projeto:
TFileListBox
TFileListBox
FILEEDITSTYLE
Descrio
Essa propriedade define se deve ser oferecida ao usurio uma caixa de edio ou uma caixa combo para
que o usurio digite o nome do arquivo.
Tabela de Valores:
Exemplo
Voc pode alterar a propriedade FileEditStyle de um componente diretamente no Object Inspector ou
OpenDialog1.FileEditStyle := fsEdit;
Na fase de projeto:
FILEEXTENSION
Descrio
A propriedade FileExtension declarada como uma varivel do tipo string que define a(s) extenso(es)
de arquivo default (separados por ponto-e-vrgula) para o relatrio gerado pelo componente.
Valor Significado
fsEdit Caixa de Edio.
fsComboBox Caixa Combo.
Na fase de projeto:
TRenderHTML, TRenderPDF, TRenderRTF e TRenderText
TRenderHTML, TRenderPDF, TRenderRTF e TRenderText
FILELIST
Descrio
A propriedade FileList declarada como uma varivel do tipo TFileListBox cuja funo depende do
componente ao qual se aplica.
Para componentes do tipo TDirectoryListBox, ela serve para fazer a conexo com um componente do
tipo TFileListBox. Ao fazer esse tipo de conexo, o componente TFileListBox apontado por FileList
exibir sempre a lista de arquivos do diretrio corrente.
Para componentes do tipo TFilterComboBox, ela serve para fazer a conexo com um componente do
tipo TFileListBox. Ao fazer esse tipo de conexo, o componente TFileListBox exibe automaticamente
os arquivos com a extenso definida no componente do tipo TFilterComboBox.
Exemplo
Coloque um componente chamado FileListBox1 do tipo TFileListBox e um componente chamado
DirectoryListBox1 do tipo TDirectoryListBox em um Formulrio. Defina a propriedade FileList de
DirectoryListBox1 como FileListBox1 diretamente no Object Inspector ou mediante uma linha de
cdigo, como:
DirectoryListBox1.FileList := FileListBox1;
Isto faz com que FileListBox1 exiba sempre os arquivos do diretrio apontado por
DirectoryListBox1.
Na fase de projeto:
TDirectoryListBox e TfilterComboBox
TDirectoryListBox e TFilterComboBox
FILENAME
Descrio
A propriedade FileName declarada como uma varivel do tipo string que define o arquivo selecionado
no componente. Essa propriedade s est disponvel durante a execuo do aplicativo.
Para componentes do tipo TMediaPlayer, ela define o nome do arquivo a ser aberto pelo mtodo Open
ou salvo pelo comando Save.
Para componentes dos tipos TOpenDialog, TOpenPictureDialog e TSaveDialog, TSavePictureDialog,
essa propriedade declarada como uma varivel do tipo TFileName e define o nome do arquivo a ser
exibido quando a aplicao exibe a caixa de dilogo.
Quando o usurio digita o nome de um arquivo e seleciona o boto OK, o nome do arquivo digitado
armazenado nessa propriedade.
Para objetos do tipo TIniFile, define o nome do arquivo INI sobre o qual sero realizadas operaes de
leitura e gravao.
Para componentes do tipo TAnimate, ela define o nome do arquivo que armazena o clipe de vdeo a ser
exibido pelo componente.
Para componentes do tipo TClientDataset, define o nome do arquivo onde sero armazenadas as
informaes e os dados dos registros da tabela.
Para componentes dos tipos TBaseReport, TCanvasReport, TRvNDRWriter, TRvRenderPreview,
TRvRenderPrinter, define o nome do arquivo que ser criado durante a execuo do relatrio.
Na fase de projeto:
TAnimate, TClientDataset, TMediaPlayer, TOpenDialog, TOpenPictureDialog, TRvNDRWriter,
TRvRenderPreview, TRvRenderPrinter, TSaveDialog, TSavePictureDialog e TIniFile
TAnimate, TBaseReport, TCanvasReport, TClientDataset, TMediaPlayer, TOpenDialog,
TOpenPictureDialog, TRvNDRWriter, TRvRenderPreview, TRvRenderPrinter, TSaveDialog,
TSavePictureDialog e TIniFile
FILETYPE
Descrio
A propriedade FileType declarada como uma varivel do tipo TFileType que define os tipos de arquivo
a serem exibidos pelo componente. Essa propriedade , na realidade, composta por um conjunto de
subpropriedades booleanas, listadas na tabela abaixo:
Tabela de Valores:
Exemplo
Voc pode alterar a propriedade FileType diretamente no Object Inspector ou mediante uma linha de
cdigo, como:
FileListBox1.FileType := ftNormal;
Valor Significado
ftReadOnly Se igual a True, exibe tambm os arquivos apenas de leitura.
ftHidden Se igual a True, exibe tambm os arquivos ocultos.
ftSystem Se igual a True, exibe tambm os arquivos de sistema.
ftVolumeID Se igual a True, exibe tambm o nome do drive.
ftDirectory Se igual a True, exibe tambm os diretrios.
ftArchive Se igual a True, exibe tambm os arquivos comuns de trabalho.
ftNormal Se igual a True, exibe qualquer tipo de arquivo.
Na fase de projeto:
TFileListBox
TFileListBox
FILTER
Descrio
Para componentes dos tipos TFilterComboBox, TOpenDialog, TOpenPictureDialog e TSaveDialog,
TSavePictureDialog, a propriedade Filter declarada como uma varivel do tipo string e define as
mscaras de filtro de arquivo a serem exibidas pelo componente.
Para componentes dos tipos TClientDataSet, TIBTable e TTable, a propriedade Filter declarada como
uma varivel do tipo string e define um filtro a ser aplicado tabela representada pelo componente.
Exemplo
de cdigo, como:
FilterComboBox1.Filter := Text files|*.TXT;
Na fase de projeto:
TClientDataset, TTable, TFilterComboBox, TIBTable, TOpenDialog, TOpenPictureDialog e
TSaveDialog, TSavePictureDialog
TClientDataset, TTable, TFilterComboBox, TIBTable, TOpenDialog, TOpenPictureDialog e
TSaveDialog, TSavePictureDialog
FILTERED
Descrio
Essa varivel declarada como uma varivel booleana que define se h um filtro aplicado tabela
representada pelo componente.
Na fase de projeto:
TClientDataSet, TIBTable e TTable
TClientDataSet e TTable
FILTERINDEX
Descrio
A propriedade FilterIndex declarada como uma varivel inteira e define o filtro default (dentre os estabelecidos
na propriedade Filter) a ser exibido na lista drop-down que define os tipos de arquivos selecionveis.
Exemplo
de cdigo, como:
OpenDialog1.FilterIndex := 1;
Na fase de projeto:
FINDTEXT
Descrio
A propriedade FindText declarada como uma varivel do tipo string e contm o texto a ser pesquisado
pela aplicao.
Exemplo
Voc pode definir o valor dessa propriedade diretamente no Object Inspector ou mediante a incluso
FindDialog1.FindText := Texto a ser pesquisado;
Na fase de projeto:
TFindDialog e TReplaceDialog
FIRSTINDEX
Descrio
A propriedade FirstIndex declarada como uma varivel inteira que define a guia que vai aparecer
mais esquerda entre as guias visveis no controle. Essa propriedade s est disponvel durante a
Exemplo
Voc pode alterar a propriedade FirstIndex mediante a incluso de uma linha de cdigo, como:
TabSet1. FirstIndex = 1
TTabSet
FIRSTPAGE
Descrio
A propriedade FirstPage declarada como uma varivel inteira que define o nmero da primeira pgina
do intervalo de pginas a serem impressas de um relatrio.
Na fase de Projeto:
TRvNDRWriter
FIXEDCOLOR
Descrio
A propriedade FixedColor declarada como uma varivel do tipo TColor e especifica a cor das colunas
e linhas fixas em um componente de grade.
Exemplo
Voc pode alterar a propriedade FixedColor diretamente no Object Inspector ou mediante uma linha
de cdigo, como:
DrawGrid1.FixedColor = clBlue
Na fase de projeto:
TDBGrid, TDrawGrid e TStringGrid
TDBGrid, TDrawGrid e TStringGrid
FIXEDCOLS
Descrio
A propriedade FixedCols declarada como uma varivel inteira que define o nmero de colunas fixas
em um componente de grade.
Exemplo
Voc pode alterar a propriedade FixedCols diretamente no Object Inspector ou mediante uma linha de
cdigo, como:
DrawGrid1.FixedCols = 1
Na fase de projeto:
TDrawGrid TDecisionGrid e TStringGrid
FIXEDROWS
Descrio
A propriedade FixedRows declarada como uma varivel inteira que define o nmero de linhas fixas
em um componente de grade.
Exemplo
Voc pode alterar a propriedade FixedRows diretamente no Object Inspector ou mediante uma linha
de cdigo, como:
DrawGrid1.FixedRows = 1
Na fase de projeto:
TDrawGrid TDecisionGrid e TstringGrid
FOCUSCONTROL
Descrio
A propriedade FocusControl declarada como uma varivel do tipo TWinControl que define o controle que
receber o foco quando o usurio selecionar a combinao de teclas aceleradoras do componente (se existir).
Exemplo
Voc pode alterar a propriedade FocusControl diretamente no Object Inspector ou mediante uma
linha de cdigo, como:
Label1.FocusControl = Edit1
Na fase de projeto:
TLabel
TLabel
FOCUSED
Descrio
Essa varivel declarada como uma varivel booleana que define se o componente possui ou no o
foco. Essa propriedade s est disponvel durante a execuo do aplicativo.
TTreeNode e TListItem
FONT
Descrio
A propriedade Font declarada como uma varivel do tipo TFont e controla os atributos do texto
exibido por um componente ou enviado para uma impressora. A propriedade Font possui as seguintes
subpropriedades: Color, Name, Size e Style.
Exemplo
A linha de cdigo seguinte altera a cor do texto exibido numa caixa de edio chamada
Edit1 para amarelo:
Edit1.Font.Color:= clYellow;
Na fase de projeto:
TCanvas, TBitBtn, TButton, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit,
TDBCtrlGrid, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo,
TDBRadioGroup, TDBText, TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox,
TFilterComboBox, TFontDialog, TFrame, TForm, TGroupBox, THeader, TIWButton, TIWCheckBox,
TIWComboBox, TIWDBCheckBox, TIWDBComboBox, TIWDBEdit, TIWDBLookupComboBox, TIWDBLookupListBox,
TIWForm, TIWLabel, TIWListBox, TIWMemo, TLabel, TListBox, TMaskEdit, TMemo, TNotebook,
TOutline, TPaintBox, TPanel, TRadioButton, TScrollBox, TSpeedButton, TStringGrid,
TTabbedNotebook, TDBLookupComboBox, TDBLookupListBox, TTabControl, THeaderControl, TListView,
TPageControl, TStatusBar, TTreeView, TRichEdit, TQRBand, TQRCustomControl, TQRDBCalc,
TQRDBText, TQRLabel, TQRMemo, TQRPreview, TQRSysData e TTabSet
TCanvas, TBitBtn, TButton, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit,
TDBCtrlGrid, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo,
TDBRadioGroup, TDBText, TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox,
TFilterComboBox, TFontDialog, TFrame, TForm, TGroupBox, THeader, TIWButton, TIWCheckBox,
TIWComboBox, TIWDBCheckBox, TIWDBComboBox, TIWDBEdit, TIWDBLookupComboBox, TIWDBLookupListBox,
TIWForm, TIWLabel, TIWListBox, TIWMemo, TLabel, TListBox, TMaskEdit, TMemo, TNotebook,
TOutline, TPaintBox, TPanel, TRadioButton, TScrollBox, TSpeedButton, TStringGrid,
TTabbedNotebook, TDBLookupComboBox, TDBLookupListBox, TTabControl, THeaderControl, TListView,
TPageControl, TStatusBar, TTreeView, TRichEdit, TQRBand, TQRCustomControl, TQRDBCalc,
TQRDBText, TQRLabel, TQRMemo, TQRPreview, TQRSysData e TTabSet
FONTS
Descrio
A propriedade Fonts declarada como uma varivel do tipo Tstrings, que retorna uma lista de strings
com as fontes suportadas pelo componente. Essa propriedade s est disponvel durante a execuo do
Exemplo
O trecho de cdigo a seguir copia em um componente FontList do tipo TListBox a lista de fontes
disponveis no componente Screen do tipo TScreen (a tela).
var
FontIndex: Integer;
begin
FontList.Clear;
FontList.Sorted := True;
FontList.Items := Screen.Fonts;
end;
Tprinter e TScreen
FOOTERBAND
Descrio
A propriedade FooterBand declarada como uma varivel do tipo TQRBand e define o objeto do tipo
TQRBand exibido pelo componente aps todos os registros da tabela principal.
Na fase de projeto:
TQRDetailLink
TQRDetailLink
FORCENEWPAGE
Descrio
Essa propriedade declarada como uma varivel do tipo booleana e especifica se haver sempre uma
quebra de pgina antes da impresso de um objeto do tipo TQRBand.
Exemplo
QRBand1.ForceNewPage:= True;
Na fase de projeto:
TQRBand
TQRBand
FORMATCHARS
Descrio
A propriedade FormatChars declarada como uma varivel booleana que define se os caracteres devem
ser filtrados quando um texto transferido numa conversao DDE.
Exemplo
Voc pode alterar o valor da propriedade FormatChars de um componente diretamente no Object
Inspector ou atravs de uma linha de cdigo, como:
DdeClientConv1. FormatChars := False;
Na fase de projeto:
TDDEClientConv
TDDEClientConv
FORMATS
Descrio
A propriedade Formats um array que armazena os formatos mantidos pelo Clipboard.
Objetos aos quais se aplica:
TClipBoard
FORMCOUNT
Descrio
A propriedade FormCount declarada como uma varivel inteira e define o nmero de formulrios
existentes na aplicao. Essa propriedade s est disponvel durante a execuo do aplicativo e no
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Label1 do tipo Tlabel exiba o
nmero de formulrios presentes em uma aplicao.
Label1.Caption := IntToStr(Screen.FormCount);
TScreen
FORMS
Descrio
A propriedade Forms declarada como uma array de formulrios onde cada item da array um dos
formulrios da aplicao. Essa propriedade s est disponvel durante a execuo do aplicativo e no
Exemplo
O trecho de cdigo a seguir adiciona o nome de todos os formulrios da aplicao em um componente
ListBox1 do tipo TListBox.
var
I: Integer;
begin
For I := 0 to Screen.FormCount-1 do
ListBox1.Items.Add(Screen.Forms[I].Name);
end;
TScreen
FORMSTYLE
Descrio
A propriedade FormStyle declarada como uma varivel do tipo TFormStyle que determina o estilo
do formulrio.
Tabela de Valores:
Valor Significado
fsNormal Definio padro de formulrio.
fsMDIChild O formulrio ser uma janela-filha de uma aplicao MDI.
fsMDIForm O formulrio ser o formulrio-pai de uma aplicao MDI.
fsStayOnTop O formulrio permanece sobre todos os outros formulrios do projeto, exceto
aqueles que tambm tm a propriedade FormStyle igual a fsStayOnTop.
Exemplo
Voc pode alterar o valor desta propriedade diretamente no Object Inspector.
Observao: Voc no deve tentar alterar essa propriedade durante a execuo do aplicativo, pois pode
originar verdadeiros desastres.
Na fase de projeto:
TForm
TForm
FRAME
Descrio
Essa propriedade declarada como uma varivel do tipo TPen e especifica o objeto desse tipo usado
para desenhar a moldura do componente.
Na fase de projeto:
TQRBand
TQRBand
FRAMECOUNT
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro e define o nmero de quadros que
formam o clipe de vdeo exibido pelo componente.
TAnimate
FRAMEHEIGHT
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro e define a altura, em pixels, dos quadros
que formam o clipe de vdeo exibido pelo componente.
TAnimate
FRAMEWIDTH
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro e define a largura, em pixels, dos
quadros que formam o clipe de vdeo exibido pelo componente.
TAnimate
FRAMES
Descrio
A propriedade Frames declarada como uma varivel do tipo inteiro longo (Longint) que define o
nmero de quadros a ser avanado ou retrocedido com os mtodos Back e Step. Essa propriedade s
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com o valor da propriedade Frames de um componente
do tipo TMediaPlayer.
ShowMessage(Frames = +IntToStr(MediaPlayer1.Frames));
TMediaPlayer
FREEONTERMINATED
Descrio
Essa varivel declarada como uma varivel booleana que define se o objeto deve ser destrudo quando
a Thread finalizada.
TThread
FREQUENCY
Descrio
A propriedade Frequency declarada como uma varivel inteira e define a freqncia com que as
marcas (TickMarks) so exibidas pelo controle.
Na fase de projeto:
TTrackBar
TTrackBar
FROMPAGE
Descrio
A propriedade FromPage uma varivel inteira que define o nmero da primeira pgina a ser impressa.
Exemplo
PrintDialog1.FromPage:= 1;
Na fase de projeto:
TPrintDialog
TPrintDialog e TQRPrinter
FULLPATH
Descrio
A propriedade Fullpath declarada como uma varivel do tipo string e define se o path completo de
um item em um componente do tipo TOutline, comea no nvel 1. Essa propriedade s est disponvel
TOutlineNode
GLYPH
Descrio
A propriedade Glyph uma varivel do tipo TBitmap que define o bitmap que aparece em um boto
do tipo TBitBtn ou TSpeedButton. Voc pode fornecer at quatro imagens em um boto do tipo TBitBtn
ou TSpeedButton com um nico arquivo Bitmap. O Delphi exibir uma dessas imagens em
correspondncia ao estado do boto.
Tabela de Valores:
Exemplo
O trecho de cdigo a seguir carrega um bitmap num componente do tipo TSpeedButton chamado
SpeedButton1 durante a execuo do aplicativo, onde USER.BMP um arquivo de bitmap definido
pelo usurio.
SpeedButton1.Glyph.LoadFromFile(USER.BMP);
Posio Estado do boto Descrio
da Imagem
no Bitmap
Primeira Liberado Essa imagem aparece quando o boto no est
selecionado ou quando no existem outras imagens
definidas no Bitmap.
Segunda Desabilitado Essa imagem aparece quando o boto no est
habilitado e portanto no pode ser selecionado.
Terceira Pressionado Essa imagem aparece enquanto o boto esquerdo do mouse
estiver sendo pressionado sobre o boto, desde que este
esteja habilitado.
Quarta Mantido Essa imagem aparece enquanto o boto permanece
selecionado e s se aplica ao controle do tipo
TSpeedButton.
Na fase de projeto:
TBitBtn e TSpeedButton
GRAPHIC
Descrio
Essa propriedade declarada como uma varivel do tipo TGraphic e define o grfico armazenado no
componente.
TPicture
GRIDHEIGHT
Descrio
A propriedade GridHeight declarada como uma varivel inteira que define a altura da grade, em
pixels. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu valor
Exemplo
altura, em pixels, de um componente StringGrid1 do tipo TStringGrid quando o usurio seleciona
begin
Label1.Caption := IntToStr(StringGrid1.GridHeigth);
end;
GRIDLINEWIDTH
Descrio
A propriedade GridLineWidth declarada como uma varivel inteira que define a largura, em pixels,
da linha que divide as clulas da grade.
Exemplo
Voc pode alterar a propriedade GridLineWidth diretamente no Object Inspector ou mediante uma
StringGrid1.GridLineWidth := 1;
Na fase de projeto:
GRIDWIDTH
Descrio
A propriedade GridWidth declarada como uma varivel inteira que define a largura da grade, em
pixels. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu valor
Exemplo
largura, em pixels, de um componente StringGrid1 do tipo TStringGrid quando o usurio seleciona
begin
Label1.Caption := IntToStr(StringGrid1.GridWidth);
end;
GROUPINDEX
Descrio
Para componentes do tipo TSpeedButton, a propriedade GroupIndex declarada como uma varivel
inteira que define o grupo a que pertence um componente.
Para componentes do tipo TMenuItem, a propriedade GroupIndex declarada como uma varivel do
tipo Byte que define os menus a serem mesclados em uma aplicao com vrios formulrios.
Exemplo
Voc pode alterar a propriedade GroupIndex de um componente diretamente no Object Inspector ou
mediante a incluso de uma linha de cdigo, como:
SpeedButton1.GroupIndex := 2;
Na fase de projeto:
TSpeedButton
TSpeedButton
HANDLE
Descrio
A propriedade Handle lhe fornece um handle do Windows, de forma que voc possa acessar objetos da
GDI e usar funes da API do Windows que um handle como parmetro. O tipo de handle fornecido
vai depender do objeto que ser usado. No caso de objetos de banco de dados, a propriedade Handle
permite que voc acesse as funes da API do Borland Database Engine (BDE). Essa propriedade s
pode ser acessada durante a execuo do aplicativo e no pode ter o seu valor diretamente alterado
pelo usurio. No caso de objetos de banco de dados do Interbase acessados pelo Interbase Express, a
propriedade Handle permite que voc acesse as funes da API deste mecanismo de acesso.
Tabela de Valores:
Tipo de Objeto Tipo de Handle
TBitmap HBitmap
TBrush HBrush
TCanvas HDC
TFont HFont
TIcon HIcon
TMetafile HMetafile
TPen HPen
TBitBtn HWND
TDBNavigator HWND
TMediaPlayer HWND
TButton HWND
TDBRadioGroup HWND
TMemo HWND
TCheckBox HWND
TDirectoryListBox HWND
TNotebook HWND
TComboBox HWND
TDrawGrid HWND
TDBCtrlGrid HWND
TDBCtrlPanel HWND
TOLEContainer HWND
TDBCheckBox HWND
TDriveComboBox HWND
TOutline HWND
TDBComboBox HWND
TEdit HWND
TPanel HWND
TDBEdit HWND
TFileListBox HWND
TRadioButton HWND
TDBGrid HWND
TFilterComboBox HWND
TRadioGroup HWND
continua
TDBImage HWND
TForm HWND
TScrollBar HWND
TDatabase HDBIDB
TDBListBox HWND
TGroupBox HWND
TScrollBox HWND
TDBLookupCombo HWND
TDBLookupComboBox HWND
THeader HWND
TIBDatabase TISC_DB_Handle
TIBTransaction TISC_TR_HANDLE
TStringGrid HWND
TDBLookupList HWND
TDBLookupListBox HWND
THotKey HWND
TListBox HWND
TListView HWND
TTabbedNotebook HWND
TStatusBar HWND
TTabControl HWND
TTabSheet HWND
TTrackBar HWND
TTreeView HWND
TUpDown HWND
TProgressBar HWND
TRichEdit HWND
TPageControl HWND
TDBMemo HWND
TMaskEdit HWND
TTabSet HWND
TApplication HWND
TFindDialog HWND
TReplaceDialog HWND
TMainMenu HMENU
TMenuItem HMENU
TPopupMenu HMENU
continuao
continua
Exemplo
Coloque as seguintes linhas de cdigo no evento OnPaint de um formulrio, e ser desenhado um
crculo no seu interior.
Crie um novo projeto com dois formulrios chamados Form1 e Form2; no Formulrio Form1, insira
um boto chamado Button1 e, no seu evento OnClick, coloque a seguinte linha de cdigo (no se
esquea de incluir Unit2 na clusula uses de Form1):
ShowWindow(Form2.Handle, SW_SHOWNORMAL)
Ao clicar com o mouse sobre Button1, ser exibido na tela o formulrio Form2.
evidente que seria muito mais simples usar o cdigo Form2.Show, mas o objetivo deste exemplo foi mostrar a utilizao da propriedade
handle na chamada a uma funo da API do Windows.
Todos os componentes relacionados na tabela de valores.
HANDLEISSHARED
Descrio
A propriedade HandleIsShared declarada como uma varivel booleana e define se um handle (ponteiro)
para um banco de dados ou no compartilhado.
TDatabase, TIBDatabase, TIBTransaction
HASITEMS
Descrio
A propriedade HasItems declarada como uma varivel booleana e define se um item de um componente
TOutline possui ou no subitens. Essa propriedade s est disponvel durante a execuo do aplicativo
TPrinter HDC
TDataBase HDBIDB
TSession HDBISES
TTable HDBICur
TQuery, TDecisionQuery HDBICur
TStoredProc HDBICur
continuao
TOutlineNode
HASPROVIDER
Descrio
A propriedade HasProvider declarada como uma varivel booleana, e informa se o objeto recebe
dados atravs de uma interface IProvider.
TClientDataset
HEAD1FONT
Descrio
A propriedade Head1Font declarada como um objeto da classe TFont, e define a fonte do texto de
uma pgina HTML delimitado pelas tags <H1> e </H1>.
Na fase de projeto:
THTML
THTML
HEAD2FONT
Descrio
Na fase de projeto:
THTML
THTML
HEAD3FONT
Descrio
Na fase de projeto:
THTML
THTML
HEAD4FONT
Descrio
Na fase de projeto:
THTML
THTML
HEAD5FONT
Descrio
uma pgina HTML delimitado pelas Tags <H5> e </H5>.
Na fase de projeto:
THTML
THTML
HEAD6FONT
Descrio
uma pgina HTML delimitado pelas Tags <H6> e </H6>.
Na fase de projeto:
THTML
THTML
HEADERBAND
Descrio
A propriedade HeaderBand declarada como uma varivel do tipo TQRBand e define o objeto do tipo
TQRBand exibido pelo componente.
Na fase de projeto:
TQRDetailLink
TQRDetailLink
HEIGHT
Descrio
A propriedade Height uma varivel inteira que define a dimenso vertical, em pixels, de um controle
ou componente grfico.
Para componentes do tipo TScreen, retorna a altura da tela, em pixels.
Para objetos do tipo TFont, define a altura da fonte, em pixels.
Exemplo
Para alterar a dimenso vertical de um formulrio chamado Form1 durante a execuo de um aplicativo,
basta incluir a seguinte linha de cdigo no evento correspondente:
Form1.Height := valor;
Na fase de projeto:
Todos os controles.
Todos os controles; TBitmap, TFont, TGraphic, TIcon, TMetafile, TPicture e TScreen.
HELPCONTEXT
Descrio
A propriedade HelpContext uma varivel do tipo THelpContext que fornece um nmero ao qual est
associado um tpico de auxlio sensvel ao contexto. Ao ser pressionada a tecla F1 quando um
componente possuir o foco, ser exibida uma tela de auxlio correspondente ao nmero definido na
propriedade HelpContext.
Exemplo
Voc pode definir o valor da propriedade HelpContext diretamente no Object Inspector.
O trecho de cdigo a seguir associa um arquivo de auxlio ao aplicativo e define para a propriedade
HelpContext de um componente Edit1 do tipo TEdit o valor 7.
procedure TForm1.FormActivate(Sender: Tobject);
begin
Application.HelpFile := HELP.HLP;
Edit1.HelpContext := 7;
end;
Na fase de projeto:
Todos os controles visuais, TColorDialog, TFindDialog, TAction, TFontDialog, TMenuItem,
TPopupMenu, TOpenDialog, TOpenPictureDialog, TPrintDialog, TPrinterSetupDialog, TReplaceDialog
e TSaveDialog, TSavePictureDialog
EAbort, EAbstractError, EAccessViolation, EarrayError, EassertinFailed, EbitsError,
EbrokerException, EcacheError, EclassNotFound, EcommomCalendarError, EcomponentError,
EcontrolC, EconvertError, EDatabaseError, EdateTimeError, EDBClient, EDBEditError,
EDBEngineError, EdimensionMapError, EDimIndexError, EdivByZero, EDSWriter, Eexternal,
EexternalException, EFCreateError, EfilerError, EFOpenError, EHeapException, EInOutError,
EInterpreterError, EintError, EIntCastError, EIntOverFlow, EInvalidArgument, EInvalidCast,
EInvalidGraphic, EInvalidGraphicOperation, EinvalidGridOperation, EinvalidImage, EinvalidOp,
EinvalidOperation, EinvalidPointer, ElistError, ElowCapacityError, EmathError,
EMCIDeviceError, EmenuError, EmonthCalError, EnoResultError, EoleCtrlError, EOLEError,
EoleException, EOleSysError, EoutLineError, EoutOfMemory, EoutOfResources, Eoverflow,
EpackageError, EparserError, Eprinter, Eprivilege, EpropertyError, EpropReadOnly,
EpropWriteOnky, ErangeError, EradError, EreconcileError, EregistryError, EresNotFound,
EsocketConnectionError, EsocketError, EstackOverflow, EstreamError, EstringListError, Ethread,
EtreeViewError, EunderFlow, EunSupportedTypeError, EUpdateError, EVariantError, EWin32Error,
EWriteError, Exception, EzeroDivide. Todos os controles visuais,:TAction, TColorDialog,
TFindDialog, TFontDialog, TMenuItem, TPopupMenu, TOpenDialog, TOpenPictureDialog,
TPrintDialog, TPrinterSetupDialog, TReplaceDialog e TSaveDialog, TSavePictureDialog
HELPFILE
Descrio
Para objetos das classes Tapplication e TForm, a propriedade HelpFile declarada como uma varivel
do tipo string que armazena o nome do arquivo de Help On-line da aplicao. Essa propriedade s est
Para objetos da classe EOLEException, a propriedade HelpFile declarada como uma varivel do tipo
string que armazena o nome do arquivo de Help On-line no qual est armazenada a descrio do erro.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com o nome do arquivo de auxlio da aplicao.
ShowMessage(Application.HelpFile);
TApplication, EOLEException
HELPKEYWORD
Descrio
Essa propriedade declarada como uma varivel do tipo string e define a string de contexto do arquivo
de Help associada ao controle ou componente.
Na fase de projeto:
Todos os controles e componentes.
HELPTYPE
Descrio
Essa propriedade declarada como uma varivel do tipo ThelpType, que define como controles e itens
de menu acessaro o arquivio de Help vinculado aplicao. Pode assumir o valor htKeyword (para
identificar o tpico por uma string de contexto) ou htContent (para identificar o tpico pelo valor
numrico a ele associado).
Na fase de projeto:
HIDESCROLLBARS
Descrio
Essa propriedade declarada como uma varivel do tipo booleana que define se as barras de rolagem
no devem ser exibidas quando no forem necessrias. Seu valor default igual a True.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou durante a execuo do
aplicativo, mediante a incluso de uma linha de cdigo como:
RichEdit1.HideScrollBars:= False;
Na fase de projeto:
TRichEdit
TRichEdit
HIDESELECTION
Descrio
A propriedade HideSelection uma varivel booleana que define se um texto selecionado permanece
selecionado quando o componente perde o foco.
Exemplo
Voc pode alterar a propriedade HideSelection diretamente no Object Inspector ou mediante uma
Edit1.HideSelection := True;
Na fase de projeto:
TEdit e TMemo
TEdit e TMemo
HINT
Descrio
A propriedade Hint uma varivel string que pode ser usada para exibir um texto de auxlio quando o
usurio mantm o ponteiro do mouse sobre um controle ou quando ocorre um evento OnHint.
No primeiro caso, basta definir o valor da propriedade ShowHint como True e o valor da propriedade
Hint como a string a ser exibida no Object Inspector (durante a fase do projeto) ou mediante cdigo
(durante a execuo do aplicativo).
No segundo caso, o cdigo do evento OnHint do objeto TApplication ser responsvel pela exibio da string
em um controle ou item de menu (Veja mais detalhes sobre o evento OnHint na seo Eventos deste guia).
Exemplo
Voc pode alterar a propriedade Hint diretamente no Object Inspector ou mediante um trecho de
cdigo. Para alterar a propriedade Hint de um boto chamado Button1 de um formulrio chamado
Form1, inclua a seguinte linha de cdigo:
Form1.Button1.Hint := String de Auxlio;
Na fase de projeto:
Todos os controles, alm de objetos da classe TAction.
Todos os controles e os componentes, alm de objetos da classe TAction, TApplication e TMenuItem.
HINTCOLOR
Descrio
A propriedade HintColor declarada como uma varivel do tipo TColor que define a cor dos boxes que
circundam o texto de auxlio definido na propriedade Hint de um controle de uma aplicao. Essa
Exemplo
O trecho de cdigo a seguir define como azul a cor dos boxes de auxlio dos controles de uma aplicao.
Application.HintColr := clBlue;
TApplication
HINTPAUSE
Descrio
A propriedade HintPause declarada como uma varivel inteira que define o intervalo de tempo (em
milissegundos) que o ponteiro do mouse deve permanecer sobre um controle de uma aplicao para
que seja exibida a string de auxlio definida na sua propriedade Hint. Essa propriedade s est disponvel
Exemplo
O trecho de cdigo a seguir define como sendo igual a 1 segundo (1000 milissegundos) o valor da
propriedade HintPause dos controles de uma aplicao.
Application.HintPause := 1000;
TApplication
HINTS
Descrio
A propriedade Hints declarada como uma varivel do tipo Tstrings que associa, mediante uma lista
de strings, um texto de auxlio a cada um dos botes do controle, a ser exibido quando o usurio
mantm o ponteiro do mouse sobre um boto ou quando ocorre um evento OnHint.
Exemplo
Voc pode definir essa propriedade diretamente no Object Inspector com o String List Editor. Nesse
caso, a primeira linha ser o texto de auxlio para o primeiro boto (o da esquerda), a segunda linha
ser o texto de auxlio para o segundo boto (o segundo, da esquerda para a direita) e assim por diante.
O trecho de cdigo a seguir altera o texto de auxlio do primeiro boto de um controle DBNavigator1 do
tipo TDBNavigator, quando o usurio d um clique com o mouse sobre um formulrio chamado Form1:
var
NovaHints : TStringList;
begin
NovaHints := TStringList.Create;
NovaHints.Add(Texto de auxlio do primeiro boto);
DBNavigator1.Hints := NovaHints;
end;
Na fase de projeto:
TDBNavigator
TDBNavigator
HISTORYLIST
Descrio
A propriedade HistoryList declarada como uma varivel do tipo Tstrings e consiste em uma lista de strings
que define o nome dos arquivos a serem exibidos na lista drop-down da caixa combo File Name quando a
caixa de dilogo aberta, e desde que a propriedade FileEditStyle da caixa de dilogo seja fsComboBox.
Na fase de projeto:
HORIZAXIS
Descrio
A propriedade HorizAxis declarada como uma varivel do tipo ThorizAxis e define o eixo horizontal
cuja escala ser usada na exibio dos pontos da srie.
O tipo ThorizAxis definido da seguinte maneira:
THorizAxis = (aTopAxis,aBottomAxis);
Na fase de projeto:
TChartSeries
TChartSeries
HORZSCROLLBAR
Descrio
A propriedade HorzScrollBar declarada como uma varivel do tipo TControlScrollBar, cujas
subpropriedades definem o comportamento de uma barra de rolagem horizontal em um componente
dos tipos TForm, TFrame ou TScrollBox.
Exemplo
Voc pode alterar as subpropriedades da propriedade HorzScrollBar de um componente diretamente
no Object Inspector ou durante a execuo do aplicativo, incluindo uma linha de cdigo como:
Form1.HorzScrollBar.Visible := True;
Na fase de projeto:
TForm, TFrame e TScrollBox
HOST
Descrio
Essa propriedade declarada como uma varivel do tipo string e define o nome ou endereo IP de um
servidor remoto.
Na fase de projeto:
TNMDayTime, TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMNNTP, TNMPOP3, TNMSMTP, TNMSTRM,
TNMTime, TPowerSock
TNMDayTime, TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMNNTP, TNMPOP3, TNMSMTP, TNMSTRM,
TNMTime, TPowerSock
HOTKEY
Descrio
A propriedade HotKey declarada como uma varivel do tipo TShortCut e define a combinao de
teclas usada como tecla aceleradora.
Na fase de projeto:
THotKey
THotKey
ICON
Descrio
A propriedade Icon declarada como uma varivel do tipo TIcon que define o cone a ser exibido
quando a aplicao for minimizada. Se nenhum valor for atribudo a essa propriedade, ser usado o
cone padro da aplicao. Para objetos do tipo TPicture, declarada como uma varivel do tipo TIcon
e representa o objeto do tipo TIcon armazenado.
Exemplo
Voc pode alterar a propriedade Icon de um componente diretamente no Object Inspector ou durante
a execuo do aplicativo, incluindo um trecho de cdigo como:
begin
Icon.LoadFromFile(ICONE.ICO);
end;
Na fase de projeto:
TForm
TApplication e TForm
IDLETIMER
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro, e define o tempo que o banco de
dados deve aguardar antes de terminar uma conexo ociosa.
Na fase de projeto:
TIBDatabse, TIBTransaction
TIBDatabse, TIBTransaction
IMAGEINDEX
Descrio
A propriedade ImageIndex declarada como uma varivel inteira e define a imagem de um componente
ImageList a ser exibida nos controles e itens de menu associados ao objeto.
Na fase de projeto:
TAction, TMenuItem
TAction, TMenuItem
IMAGES
Descrio
A propriedade Images declarada como uma varivel do tipo TImageList e define a lista de imagens
(bitmaps) associada ao componente.
Na fase de projeto:
TAction, TMainMenu, TPopupMenu, TTreeView
TAction, TMainMenu, TPopupMenu, TTreeView
IMAGETYPE
Descrio
A propriedade ImageType declarada como uma varivel do tipo TImageType e define se o controle
desenhar a imagem ou a mscara a ela associada.
Tabela de Valores:
Na fase de projeto:
TImageList
TImageList
INCREMENT
Descrio
Para componentes do tipo TControlScrollBar, a propriedade Increment uma varivel inteira que
define quantas posies a caixa de rolagem deve se mover em uma barra de rolagem quando o usurio
seleciona uma das setas nas extremidades de uma barra de rolagem.
Para componentes do tipo TUpDown, essa propriedade definida como uma varivel booleana e
determina a variao do valor armazenado na propriedade Position quando o usurio seleciona com o
boto esquerdo do mouse uma das setas do controle.
Exemplo
Form1.HorzScrollBar.Range:= 8;
Valor Significado
itImage Desenha a imagem.
itMask Desenha a mscara.
Na fase de projeto:
TControlScrollBar e TUpDown
TControlScrollBar e TUpDown
INDENT
Descrio
A propriedade Indent declarada como uma varivel inteira e define a endentao, em pixels, a ser
usada na exibio de subitens quando uma lista de itens expandida.
Na fase de projeto:
TTreeView
TTreeView
INDEX
Descrio
A propriedade Index declarada como uma varivel inteira e define o ndice de um campo na propriedade
Fields de um banco de dados. Para componentes do tipo TOutlineNode, declarada como uma varivel
do tipo inteiro longo (Longint) e define seu ndice dentro do componente TOutline que o contm.
Para objetos da classe TAction, define o ndice que o identifica entre as aes definidas para um
componente TactionList.
Exemplo
Voc pode alterar o valor dessa propriedade na fase de projeto com o Fields Editor.
Na fase de projeto:
TAction, TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField, TCurrencyField,
TDateField, TDateTimeField, TFloatField, TGraphicField, TIntegerField, TMemoField,
TAction, TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField, TCurrencyField,
TSmallintField, TStringField, TTimeField, TVarBytesField, TOutlineNode e TWordField
INDEXDEFS
Descrio
A propriedade IndexDefs declarada como uma varivel do tipo TIndexDefs e armazena informaes
sobre todos os ndices da tabela. Essa propriedade s est disponvel durante a execuo do aplicativo
Na fase de projeto:
TClientDataSet
TIBTable, TTable, TClientDataSet
INDEXFIELDCOUNT
Descrio
Essa propriedade declarada como uma varivel inteira que armazena o nmero de campos com o
ndice corrente. Ela s est disponvel durante a execuo do aplicativo.
INDEXFIELDNAMES
Descrio
Essa propriedade declarada como uma varivel do tipo string, usada com um servidor SQL, para
identificar as colunas a serem usadas como ndice na tabela.
Na fase de projeto:
TADOTable, TIBTable, TTable, TClientDataSet
TADOTable, TTable, TclientDataSet
INDEXFIELDS
Descrio
Essa propriedade declarada como uma varivel do tipo TField e d acesso informao armazenada
em cada campo no ndice corrente do banco de dados. Essa propriedade s est disponvel durante a
Na fase de projeto:
TClientDataSet
INDEXNAME
Descrio
Essa propriedade declarada como uma varivel do tipo string, usada para definir um ndice secundrio
da tabela.
Na fase de projeto:
INITIALDIR
Descrio
A propriedade InitialDir declarada como uma varivel do tipo string que define o diretrio atual
quando a caixa de dilogo aberta.
Exemplo
OpenDialog1.InitialDir := C:\delphi\teste;
Na fase de projeto:
INPLACEACTIVE
Descrio
A propriedade InPlaceActive uma varivel do tipo booleana que determina se um objeto OLE est
ativo. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu valor
Exemplo
O trecho de cdigo a seguir exibe uma mensagem se InPlaceActive for igual a True:
if InPlaceActive = True then ShowMessage(Objeto Ativo);
TOLEContainer
INSERTSQL
Descrio
Essa propriedade armazena uma lista de strings contendo a declarao SQL usada para inserir um registro.
Na fase de projeto:
INTEGRALHEIGHT
Descrio
A propriedade IntegralHeight uma varivel booleana que define como o componente ser exibido no
formulrio. Se for igual a True, sua altura ajustada de forma que nenhum dos itens seja exibido
parcialmente. Se a propriedade Style do componente tiver o valor igual a lbOwerDrawVariable, a
propriedade ItemHeight no tem nenhum efeito.
Exemplo
Voc pode alterar a propriedade ItemHeight de um componente diretamente no Object Inspector ou
ListBox1.IntegralHeight := True;
Na fase de projeto:
TDBListBox, TDirectoryListBox, TFileListBox e TListBox
INTERVAL
Descrio
A propriedade Interval declarada como uma varivel inteira e define o intervalo de tempo, em
milissegundos, para ativao do evento OnTimer.
Exemplo
O valor da propriedade EndMargin pode ser alterado diretamente no Object Inspector ou mediante a
Timer1.Interval := 6000;
Na fase de projeto:
TTimer
TTimer
INTRANSACTION
Descrio
A propriedade Intransaction uma varivel booleana que define se a transao representada pelo
componente est em progresso.
Na fase de projeto:
TIBTransaction
TIBTransaction
INVALIDKEYS
Descrio
A propriedade InvalidKeys declarada como uma varivel do tipo THKInvalidKeys e define um conjunto
de teclas consideradas invlidas:
Tabela de Valores:
Na fase de projeto:
THotKey
THotKey
ISINDEXFIELD
Descrio
A propriedade IsIndexField declarada como uma varivel booleana, que define se um campo ou
no indexado. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o
seu valor diretamente alterado pelo usurio.
ISMASKED
Descrio
A propriedade IsMasked uma varivel booleana que define se o componente possui ou no uma
mscara para exibio de texto.
Exemplo
Voc pode alterar a propriedade IsMasked de um componente diretamente no Object Inspector ou
MaskEdit1.EditMask := !99/99/00;1;_;
Valor Significado
hcNone Teclas inalteradas so consideradas invlidas.
hcShift A tecla Shift considerada invlida.
hcCtrl A tecla Ctrl considerada invlida.
hcAlt A tecla Alt considerada invlida.
hcShiftCtrl A combinao de teclas Shift+Ctrl considerada invlida.
hcShiftAlt A combinao de teclas Shift+Alt considerada invlida.
hcCtrlAlt A combinao de teclas Ctrl+Alt considerada invlida.
hcShiftCtrlAlt A combinao de teclas Shift+Ctrl+Alt considerada invlida.
O trecho de cdigo acima define uma mscara para exibio de texto no formato
MM/DD/YY.
Na fase de projeto:
TDBEdit e TMaskEdit
TDBEdit e TMaskEdit
ISNULL
Descrio
A propriedade IsNull declarada como uma varivel booleana, que define se o valor de um campo
igual a Null. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu
Exemplo
O trecho de cdigo a seguir exibe uma mensagem se o valor armazenado em um campo GraphicField1
do tipo TGraphicField igual a Null:
if GraphicField1,IsNull = Null then ShowMessage(O valor armazenado no campo NULL);
ISREADONLY
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro, e define se o banco de dados deve ser
acessado apenas para leitura (apenas para a verso 6 do Interbase).
TIBDatabse
ISSQLBASED
Descrio
A propriedade IsSQLBased declarada como uma varivel booleana, que define se o driver usado
diferente de STANDARD. Essa propriedade s est disponvel durante a execuo do aplicativo, e no
TDatabase
ISVISIBLE
Descrio
A propriedade IsVisible declarada como uma varivel booleana e define se um item est visvel
dentro do componente TOutline que o contm. Essa propriedade s est disponvel durante a execuo
TOutlineNode
ITEMCOUNT
Descrio
A propriedade ItemCount declarada como uma varivel do tipo inteiro longo (Longint) que define o
nmero de itens de um componente do tipo TOutline. Essa propriedade s est disponvel durante a
Exemplo
Voc pode exibir o nmero de itens em um componente Outline1 do tipo TOutline em um componente
Label1 do tipo TLabel com a seguinte linha de cdigo:
Label1.Caption := IntToStr(Outline1.ItemCount);
TOutline
ITEMHEIGHT
Descrio
A propriedade ItemHeight uma varivel inteira que define a altura dos itens de componentes dos
tipos TComboBox, TDBComboBox, TDBListBox, TDirectoryListBox, TFileListBox, TListBox e TOutline,
quando os itens tm altura fixa, o que definido pela propriedade Style de cada componente. A
propriedade Style deve ser igual a:
lsOwnerDrawFixed, para componentes do tipo TListBox, TDBListBox, TFileListBox e
TDirectoryListBox;
lsOwnerDrawFixed, para componentes do tipo TComboBox e TDBComboBox;
lsOwnerDrawFixed, para componentes do tipo TOutline.
Exemplo
Voc pode alterar a propriedade ItemHeight de um componente diretamente no Object Inspector ou
ComboBox1.ItemHeight := 20;
Na fase de projeto:
TComboBox, TDBComboBox, TDBListBox, TDirectoryListBox, TFileListBox, TListBox e TOutline.
TComboBox, TDBComboBox, TDBListBox, TDirectoryListBox, TFileListBox, TListBox e TOutline
ITEMINDEX
Descrio
A propriedade ItemIndex uma varivel inteira que define a posio de um item selecionado dentro
da lista de itens do componente. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode atribuir o nmero que identifica a posio do item selecionado em uma caixa de listagem
chamada ListBox1 a uma varivel inteira a durante a execuo do aplicativo, incluindo a seguinte
linha de cdigo:
a := ListBox1.ItemIndex;
Se nenhum item estiver selecionado, ItemIndex retorna o valor -1.
O primeiro item da lista ocupa a posio 0, isto , se uma lista tem n itens, ento o n-zimo item
ocupar a posio n-1. Se a propriedade MultiSelect do componente for True e houver mais de um
elemento selecionado, ItemIndex retornar a posio do elemento que possui o foco.
TComboBox, TDBComboBox, TDBRadioGroup, TDirectoryListBox, TDriveComboBox, TFileListBox,
TFilterComboBox, TListBox e TRadioGroup
ITEMS
Descrio
Para componentes dos tipos TComboBox, TDBRadioGroup, TDirectoryListBox, TDriveComboBox,
TFileListBox, TFilterComboBox, TListBox e TRadioGroup, essa propriedade uma varivel do tipo
TStrings que define a lista de strings que aparecem no componente. A propriedade Items por si s um
objeto do tipo Tstrings, no qual voc pode adicionar, remover, inserir e mover componentes com os
mtodos Add, Delete, Insert, Exchange e Move.
Para componentes do tipo TListView, essa propriedade uma varivel do tipo TListItems, que define a
lista de itens que aparecem no componente.
Para componentes do tipo TTreeView, essa propriedade uma varivel do tipo TTreeNodes, que define
a lista de itens que aparecem no componente.
Para objetos do tipo TList, essa propriedade declarada como uma array de ponteiros que permite o
acesso direto aos ponteiros da lista,
Exemplo
Voc pode adicionar uma string novo item a um componente ComboBox1 do tipo TComboBox com
ComboBox1.Items.Add(novo item);
Na fase de projeto, voc pode operar sobre os itens do componente acionando o String
List Editor, na propriedade Items do Object Inspector.
Na fase de projeto:
TComboBox, TDBCombobox, TDBRadioGroup, TDirectoryListBox, TDriveComboBox, TFileListBox,
TFilterComboBox, TIWComboBox, TIWDBCombobox, TIWList, TIWListBox, TListBox, TIWTreeview,
TListView, TTreeView e TRadioGroup
TComboBox, TDBCombobox, TDBRadioGroup, TDirectoryListBox, TDriveComboBox, TFileListBox,
TFilterComboBox, TIWComboBox, TIWDBCombobox, TIWList, TIWListBox, TListBox, TIWTreeview,
TListView, TTreeView e TRadioGroup
ITEMSEPARATOR
Descrio
A propriedade ItemSeparator declarada como uma varivel string que define a string usada para
separar os itens em um componente do tipo TOutline.
Exemplo
Voc pode alterar a propriedade ItemSeparator diretamente no Object Inspector ou durante a execuo
Outline1.ItemSeparator := \;
Na fase de projeto:
TOutline
TOutline
KEEPCONNECTION
Descrio
Essa propriedade declarada como uma varivel Booleana e indica se a conexo com um componente
do tipo TSQLConnection deve ser mantida quando no houver tabelas abertas.
TSQLConnection
KEEPCONNECTIONS
Descrio
Essa propriedade declarada como uma varivel Booleana e indica se a conexo com um componente
do tipo TDataBase deve ser mantida quando no houver tabelas abertas. Essa propriedade s est
Exemplo
Voc pode alterar o valor dessa propriedade mediante a incluso de uma linha de cdigo como:
Session.KeepConnections := False;
TSession
KEYEXCLUSIVE
Descrio
A propriedade KeyExclusive uma varivel booleana que define se funes de pesquisa e busca excluiro
os registros especificados nas funes FindNearest, GotoNearest, EditRangeStart e EditRangeEnd. Essa
TTable, TclientDataSet
KEYFIELD
Descrio
A propriedade KeyField declarada como uma varivel do tipo string e define o nome do campo do
banco de dados definido na sua propriedade ListSource que corresponde ao campo definido na
propriedade DataField.
Na fase de projeto:
TDBLookupListBox e TDBLookupComboBox
KEYFIELDCOUNT
Descrio
A propriedade KeyFieldCount uma varivel booleana que define o nmero de campos-chave usados
pelas funes de busca (GotoKey, FindKey, EditKey, etc.).
TTable e TClientDataset
KEYPREVIEW
Descrio
A propriedade KeyPreview uma varivel booleana que define se o formulrio deve ou no responder
a um pressionamento de tecla, atravs dos eventos OnKeyDown, OnKeyPress e OnKeyUp, em vez de
acionar os eventos do componente selecionado.
Exemplo
Voc pode alterar a propriedade KeyPreview de um formulrio diretamente no Object Inspector ou
Form1.KeyPreview := True;
Na fase de projeto:
TForm
TForm
KEYVALUE
Descrio
A propriedade KeyValue declarada como uma varivel do tipo Variant e reflete o valor armazenado
no campo especificado na propriedade KeyField. Essa propriedade s est disponvel durante a execuo
do aplicativo.
KEYVIOLCOUNT
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro longo (Longint) que define o nmero
de registros que deixaram de sofrer uma operao pelo mtodo Execute de um componente do tipo
TBatchMove, devido a ocorrncia de um erro de violao de integridade. Essa propriedade s est
definida durante a execuo do aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
Exemplo
O trecho de cdigo a seguir verifica se houve violao de integridade durante a execuo do mtodo
Execute de um componente BatchMove1 do tipo TBatchMove:
BatchMove1.Execute;
if BatchMove1.KeyViolCount <> 0 then ShowMessage(ocorreram violaes em +
IntToStr(KeyViolCount)+ registros );
TBatchMove
KEYVIOLTABLENAME
Descrio
Essa propriedade declarada como uma varivel do tipo TFileName que cria uma tabela local, do tipo
Paradox, com todos os registros que sofreram violao de integridade durante uma operao pelo
mtodo Execute de um componente do tipo TBatchMove.
Na fase de projeto:
TBatchMove
TBatchMove
KIND
Descrio
Para componentes do tipo TBitBtn, a propriedade Kind uma varivel do tipo TBitBtnKind que define
o tipo de Bitmap exibido pelo boto.
Para componentes do tipo TScrollBar, a propriedade Kind uma varivel do tipo TScrollBarKind que
define o tipo de barra de rolagem.
Tabela de Valores para componentes do Tipo TBitBtn:
Tabela de Valores para componentes do Tipo TScrollBar:
Valor Significado
bkCustom Bitmap definido pelo usurio.
bkOK Boto OK padro, com uma marca de verificao na cor verde e propriedade
Default igual a True.
bkCancel Boto Cancel padro, com um x na cor vermelha e propriedade Cancel igual a True.
bkYes Boto Yes padro, com uma marca de verificao na cor verde e propriedade
Default igual a True. A diferena entre esse tipo de boto e o boto OK que,
nesse caso, quando o usurio clica sobre o boto, as alteraes feitas na caixa de
dilogo so aceitas antes que ela se feche.
bkNo Boto No padro, com uma marca vermelha representando um crculo cortado e
propriedade Cancel igual a True. A diferena desse tipo de boto e o boto Cancel
que, nesse caso, quando o usurio clica sobre o boto, as alteraes feitas na caixa
de dilogo so descartadas antes que ela se feche.
bkHelp Boto de auxlio padro, com uma marca de interrogao na cor cyan. Quando o
usurio clica sobre o boto, uma tela de auxlio deve ser exibida (eu disse deve,
pois isso depende de trabalho de codificao feito pelo programador).
bkClose Boto Close padro, com o desenho de uma porta e um sinal de Exit e
propriedade Default igual a True. Quando o usurio clica sobre o boto, o
formulrio a que ele pertence se fecha.
bkAbort Boto Abort padro, com um x na cor vermelha e propriedade Cancel igual a True.
bkRetry Boto Retry padro, com uma seta circular verde.
bkIgnore Boto Ignore padro, com o desenho de um homem verde se afastando.
bkAll Boto All padro, com uma marca de verificao dupla na cor verde e propriedade
default igual a True.
Exemplo
A seguinte linha de cdigo define como bkOk a propriedade Kind de um boto chamado BitBtn1 do
tipo TBitBtn
BitBtn1.Kind := bkOK;
Valor Significado
sbHorizontal A barra de rolagem horizontal.
sbVertical A barra de rolagem vertical.
Na fase de projeto:
TBitBtn e TScrollBar
TBitBtn e TScrollBar
LARGECHANGE
Descrio
A propriedade LargeChange declarada como uma varivel do tipo TScrollBarInc que define quantas
posies devem ser deslocadas na barra de rolagem quando o usurio d um clique nela em qualquer
um dos lados da caixa de rolagem ou pressiona as teclas PageUp e PageDn.
Exemplo
ScrollBar1.LargeChange := 100
Na fase de projeto:
TScrollBar
TScrollBar
LARGEIMAGES
Descrio
Essa propriedade define as imagens exibidas pelo componente quando a sua propriedade ViewStyle
possui o valor vsIcon.
TListView
LASTPAGE
Descrio
A propriedade LastPage declarada como uma varivel inteira que define o nmero da ltima pgina
do intervalo de pginas a serem impressas de um relatrio.
Na fase de Projeto:
TRvNDRWriter
LAYOUT
Descrio
A propriedade Layout uma varivel do tipo TButtonLayout que define onde o bitmap aparece em um
boto do tipo TBitBtn ou TSpeedButton.
Tabela de Valores:
Exemplo
O trecho de cdigo a seguir define a propriedade Layout de um boto chamado BitBtn1 do tipo TBitBtn
como blGlyphLeft:
BitBtn1.Layout := blGlyphLeft;
Na fase de projeto:
LEFT
Descrio
A propriedade Left uma varivel inteira que define, em pixels, a coordenada da extremidade esquerda
de um componente em relao extremidade esquerda do formulrio que o contm. No caso de um
formulrio, essa propriedade medida em relao tela.
Exemplo
Para alterar a propriedade Left de um boto chamado Button1 durante a execuo de um aplicativo,
Button1.Left:= valor;
Na fase de projeto:
Todos os controles.
Todos os controles e os componentes TFindDialog e TReplaceDialog.
Valor Significado
blGlyphLeft A imagem aparece prxima ao lado esquerdo do boto.
blGlyphRight A imagem aparece prxima ao lado direito do boto.
blGlyphTop A imagem aparece prxima ao topo do boto.
blGlyphBottom A imagem aparece prxima base do boto.
LEFTAXIS
Descrio
A propriedade RightAxis declarada como um objeto da classe TChartAxis, e representa o eixo vertical
esquerdo do grfico exibido no componente.
Na fase de projeto:
TChart, TDBChart
TChart, TDBChart
LEFTCOL
Descrio
A propriedade LeftCol declarada como uma varivel inteira que define a coluna que deve ser exibida
do lado esquerdo da grade (sem alterar as colunas definidas como fixas). Essa propriedade s est
Exemplo
Se voc quiser que a terceira coluna de um componente StringGrid1 do tipo TStingGrid seja posicionada
do lado esquerdo da grade, basta incluir uma linha de cdigo como:
StringGrid1.LeftCol := 2;
LEFTMARGININCHES
Descrio
A propriedade LeftMarginInches uma varivel inteira que define, em dcimos de polegada, o valor da
margem esquerda do relatrio (sem considerar o espao deixado pela impressora).
Exemplo
Voc pode alterar a propriedade Max diretamente no Object Inspector ou mediante uma linha de
cdigo como:
QuickReport1.LeftMarginInches:= 10;
Na fase de projeto:
TQuickReport
TQuickReport
LEFTMARGINMM
Descrio
A propriedade LeftMarginMM uma varivel inteira que define, em milmetros, o valor da margem
esquerda do relatrio (sem considerar o espao deixado pela impressora).
Exemplo
de cdigo como:
QuickReport1.LeftMarginMM:= 10;
Na fase de projeto:
TQuickReport
TQuickReport
LENGTH
Descrio
A propriedade Length declarada como uma varivel do tipo inteiro longo (Longint) que define o
comprimento do meio a ser executado em um dispositivo multimdia. Essa propriedade s est disponvel
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com o comprimento do meio a ser executado em
dispositivo multimdia:
ShowMessage(Comprimento = +IntToStr(MediaPlayer1.Length));
TMediaPlayer
LEVEL
Descrio
A propriedade Level declarada como uma varivel do tipo Word, e define o nvel de um item dentro
do componente TOutline que o contm. Essa propriedade s est disponvel durante a execuo do
aplicativo, e no pode ter o seu valor diretamente alterado pelo usurio.
TOutlineNode
LINES
Descrio
Para componentes do tipo TMemo, essa propriedade declarada como uma varivel do tipo TStrings
que contm as linhas de texto do componente.
Para componentes dos tipos TDDEClientItem e TDDEServerItem, essa propriedade declarada como
uma varivel do tipo TStrings que contm as linhas do texto a ser transferido numa conversao DDE.
Exemplo
Voc pode definir a propriedade Lines diretamente no Object Inspector ou mediante um trecho de
programa.
No trecho de cdigo a seguir, o arquivo config.sys exibido em um componente Memo1 do tipo TMemo
quando o usurio d um clique com o mouse sobre um boto chamado Button1 do tipo TButton:
begin
Memo1.Lines.LoadFromFile(C:\CONFIG.SYS);
end;
LoadFromFile um mtodo de Lines, que um objeto do tipo Tstrings, conforme descrito anteriormente.
Na fase de projeto:
TDDEClientItem, TDDEServerItem, TDBMemo e TMemo
TDDEClientItem, TDDEServerItem, TDBMemo e TMemo
LINKBAND
Descrio
Essa propriedade declarada como uma varivel do tipo TQRBand que permite que mais do que um
componente do tipo TQRBand seja exibido em uma nica pgina.
Na fase de projeto:
TQRBand
TQRBand
LIST
Descrio
A propriedade List declarada como uma varivel do tipo PPointerList que mantm uma lista de
ponteiros que pode referenciar objetos de qualquer tipo. Essa propriedade s est disponvel durante a
execuo do aplicativo, e no pode ter o seu valor diretamente alterado pelo usurio.
TList
LISTFIELD
Descrio
A propriedade ListField declarada como uma varivel do tipo string, e define o nome do campo do
banco de dados cujos valor exibido no controle. Se no for especificado um valor para essa propriedade,
ser usado o valor armazenado na propriedade KeyField.
Na fase de projeto:
LISTSOURCE
Descrio
A propriedade ListSource declarada como uma varivel do tipo TDataSource, e define o nome do
controle que faz a conexo ao componente que representa o banco de dados do qual ser selecionado
um campo cujo valor ser exibido pelo controle.
Na fase de projeto:
LOCAL
Descrio
A propriedade Local uma varivel booleana que define se a tabela referenciada pelo componente
uma tabela local do tipo Paradox ou dBASE ou de um servidor SQL. Essa propriedade s est disponvel
durante a execuo do aplicativo, e no pode ter o seu valor diretamente alterado pelo usurio.
TQuery, TDecisionQuery
LOCALE
Descrio
Essa propriedade declarada como uma varivel do tipo TLocale e indica o driver de linguagem usado
pelo componente. Essa propriedade s est disponvel durante a execuo do aplicativo, e no pode ter
TDatabase e TSession
LOCALIP
Descrio
Essa propriedade declarada como uma varivel do tipo string, e define o endereo IP da mquina cliente.
TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMMSGServ, TNMNNTP, TNMPOP3, TNMSMTP, TNMSTRM,
TNMSTRMServ e TPowerSock
LOCKED
Descrio
A propriedade Locked declarada como uma varivel booleana que define se um componente do tipo
TPanel pode ser substitudo por um objeto OLE.
Exemplo
O valor dessa propriedade pode ser definido diretamente no Object Inspector ou mediante uma linha
de cdigo como:
Panel1.Locked := False;
Na fase de projeto:
TPanel
TPanel
LOGINPROMPT
Descrio
A propriedade LoginPrompt declarada como uma varivel booleana que define como controlado o
acesso a um banco de dados SQL.
Exemplo
O valor dessa propriedade pode ser definido diretamente no Object Inspector ou mediante uma linha
de cdigo como:
Database1.LoginPrompt := False;
Na fase de projeto:
TADOConnection, TIBDatabase, Tdatabase, TRDSConnection
TADOConnection, TIBDatabase, TDatabase
LOOKUPDISPLAY
Descrio
Essa propriedade declarada como uma varivel string que define o campo do banco de dados a ser
exibido pelo componente.
Exemplo
O valor dessa propriedade pode ser definido diretamente no Object Inspector. O trecho de cdigo a
seguir faz com que o campo Nome seja exibido pelo componente DBLookupCombo1 do tipo
TDBLookupCombo.
DBLookupCombo1.LookupDisplay := Nome;
LOOKUPFIELD
Descrio
Essa propriedade declarada como uma varivel do tipo string que faz a ligao entre o banco de dados
e o componente.
Exemplo
seguir faz com que um componente chamado DBLookupCombo1 do tipo TDBLookupCombo use o
campo Cliente como campo de busca:
DBLookupCombo1.LookupField := Cliente;
Na fase de projeto:
LOOKUPSOURCE
Descrio
Essa propriedade declarada como uma varivel do tipo TDataSource que identifica o componente do
tipo TDataSource a que est associado o banco de dados no qual deve ser feita a pesquisa.
Exemplo
seguir faz com que um componente chamado DBLookupCombo1 do tipo TDBLookupCombo seja
associado ao banco de dados especificado no componente DataSource1 do tipo TDataSource:
DBLookupCombo1.LookupSource := DataSource1;
Na fase de projeto:
MAINFORM
Descrio
A propriedade MainForm declarada como uma varivel do tipo TForm que define o formulrio prin-
cipal de uma aplicao. Esse formulrio o primeiro a ser criado quando a aplicao executada, e
quando ele fechado, finaliza a execuo da aplicao. Essa propriedade s est disponvel durante a
Exemplo
O trecho de cdigo a seguir mostra uma mensagem com o texto exibido na barra de ttulos da janela
principal de uma aplicao.
ShowMessage(Application.MainForm.Caption);
TApplication
MAPPINGS
Descrio
Essa propriedade declarada como uma varivel do tipo TStrings, e define o modo de mapeamento de
colunas entre a tabela-fonte e a tabela de destino durante a execuo do mtodo Execute de um
componente do tipo TBatchMove.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector usando o String List
Editor ou mediante a incluso de uma linha de cdigo como:
DestColName = SourceColName;
que mapeia SourceColName da tabela-fonte em DestColName da tabela-destino.
Na fase de projeto:
TBatchMove
TBatchMove
MARGIN
Descrio
Para componentes dos tipos TBitBtn e TSpeedButton , a propriedade Margin uma varivel inteira que
define, em pixels, a distncia entre um dos lados do bitmap e o lado correspondente do boto que o
contm, dependendo da propriedade Layout do boto.
Para componentes do tipo TControlScrollBar, a propriedade Margin uma varivel do tipo Word que
define o nmero mnimo de pixels que deve existir entre os controles de um formulrio e suas bordas
ou entre os controles de um componente do tipo TScrollBox e suas bordas. importante ressaltar que,
nesse caso, Margin uma propriedade de um componente do tipo TScrollBar, e que este est embutido
em componentes dos tipos TForm e TScrollBox. Nesse caso, o valor da propriedade Margin
automaticamente adicionado ao valor armazenado na propriedade Range, de forma que a barra de
rolagem se torne visvel sempre que a distncia entre o controle e as laterais de um componente do
tipo TForm ou TScrollBox torne-se menor que o valor da propriedade Margin.
Exemplo
Para alterar a propriedade Margin de um boto chamado BitBtn1 do tipo TBitBtn ou TSpeedButton
durante a execuo de um aplicativo, basta incluir a seguinte linha de cdigo no evento correspondente:
BitBtn1.Margin := valor;
Na fase de projeto:
TBitBtn, TSpeedButton, TControlScrollBar e TScrollBar
TBitBtn, TSpeedButton, TControlScrollBar e TScrollBar
MARGINBOTTON
Descrio
Essa propriedade declarada como uma varivel inteira e define a dimenso da margem inferior do
grfico ou relatrio associado ao componente.
Na fase de projeto:
TChart, TDBChart, TRvNDRWriter
TBaseReport, TCanvasReport, TChart, TDBChart, TRvNDRWriter, TRvRenderPreview, TRvRenderPrinter
MARGINLEFT
Descrio
Essa propriedade declarada como uma varivel inteira e define a dimenso, da margem esquerda do
Na fase de projeto:
MARGINRIGHT
Descrio
Essa propriedade declarada como uma varivel inteira e define a dimenso, da margem direita do
Na fase de projeto:
MARGINTOP
Descrio
Essa propriedade declarada como uma varivel inteira e define a dimenso da margem superior do
Na fase de projeto:
MASK
Descrio
A propriedade Mask uma varivel do tipo string que define um filtro para os arquivos a serem exibidos
pelo componente. Podem ser includos caracteres curinga como * e ?.
Exemplo
Voc pode alterar a propriedade Mask diretamente no Object Inspector ou mediante uma linha de
cdigo como:
FileListBox1.Mask := *.PAS;
Na fase de projeto:
TFileListBox
TFileListBox e TFilterComboBox
MASKED
Descrio
A propriedade Masked declarada como uma varivel booleana, que define se as imagens contidas
sero ou no transparentes.
Exemplo
ImageList1,Masked:= True;
Na fase de projeto:
TImageList
TImageList
MASTER
Descrio
A propriedade Master declarada como uma varivel do tipo TQRController, que especifica a tabela
principal num relacionamento entre duas tabelas, onde uma a principal e a outra, a secundria.
Na fase de projeto:
TQRDetailLink
TQRDetailLink
MASTERFIELDS
Descrio
A propriedade MasterFields declarada como uma varivel do tipo string que define os campos que
faro a ligao entre duas tabelas. Os nomes dos campos devem ser separados por ponto-e-vrgula.
Na fase de projeto:
TADOTable, TIBTable, TSQLTable, TTable, TClientDataSet, TIBClientDataset, TSimpleDataset
MASTERSOURCE
Descrio
A propriedade MasterSource declarada como uma varivel do tipo TDataSource e especifica a tabela-
mestre ao qual o componente ser ligado.
Na fase de projeto:
MAX
Descrio
A propriedade Max uma varivel inteira que define o valor mximo de posio para um componente.
Exemplo
Voc pode alterar a propriedade Max diretamente no Object Inspector ou mediante uma linha de
cdigo como:
ScrollBar1.Max:= 1000;
Na fase de projeto:
TProgressBar, TTrackBar, TUpDown e TScrollBar
MAXCELLS
Descrio
Essa propriedade uma varivel inteira que define o nmero mximo de clulas manipuladas pelo
cache do componente.
Na fase de projeto:
TDecisionCube
TDecisionCube
MAXFONTSIZE
Descrio
A propriedade MaxFontSize uma varivel inteira que define o maior tamanho da fonte disponvel na
caixa de dilogo. Um valor nulo significa que no existe valor mximo.
Exemplo
Voc pode alterar a propriedade MaxFontSize diretamente no Object Inspector ou mediante uma linha
de cdigo como:
FontDialog1.MaxFontSize := 36;
Na fase de projeto:
TFontDialog
TFontDialog
MAXLENGTH
Descrio
A propriedade MaxLength uma varivel inteira que define o nmero mximo de caracteres que
podem ser digitados em um componente dos tipos TEdit, TDBEdit, TMaskEdit, TRichEdit, TDBMemo,
TMemo, TDBLookupComboBox ou TComboBox.
Exemplo
Voc pode alterar a propriedade MaxLength de um componente diretamente no Object Inspector ou
mediante a incluso de uma linha de cdigo:
Edit1.MaxLength:= 80;
Na fase de projeto:
TComboBox, TDBEdit, TDBLookupCombo, TDBMemo, TEdit, TMaskEdit, TRichEdit e TMemo
TComboBox, TDBEdit, TDBLookupCombo, TDBMemo, TEdit, TMaskEdit, TRichEdit e TMemo
MAXPAGE
Descrio
A propriedade MaxPage uma varivel inteira que define o maior nmero para uma
pgina a ser impressa.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector, ou mediante a incluso
PrintDialog1.MaxPage := 1000;
Na fase de projeto:
TPrintDialog
TPrintDialog
MAXSUMMARIES
Descrio
Essa propriedade uma varivel inteira que define o nmero mximo de sumrios de dados manipuladas
pelo cache do componente.
Na fase de projeto:
TDecisionCube
TDecisionCube
MAXVALUE
Descrio
A propriedade MaxValue declarada como uma varivel do tipo inteiro longo (Longint) que define o
valor mximo que pode ser atribudo a um campo. Atribuir um valor maior do que MaxValue gera
uma exceo. Essa propriedade s est disponvel durante a execuo de um aplicativo.
Exemplo
Voc pode alterar o valor da propriedade MaxValue mediante uma linha de cdigo como:
IntegerField1.MaxValue:= 1000;
TAutoIncField, TCurrencyField, TFloatField, TIntegerField, TSmallintField e TWordField
MDICHILDCOUNT
Descrio
A propriedade MDIChildCount uma varivel inteira que define o nmero de janelas-filhas de uma
aplicao MDI. Essa propriedade s est disponvel durante a execuo do aplicativo, e no pode ter o
seu valor diretamente alterado pelo usurio.
Exemplo
Voc pode exibir o valor da propriedade MDIChildCount em um componente Label1 do tipo TLabel
mediante a incluso de uma linha de cdigo:
Label1.Caption := Form1.MDIChildCount;
TForm
MDICHILDREN
Descrio
A propriedade MDIChildren declarada como uma array que contm todas as janelas-filhas de um
formulrio MDI. Essa propriedade s pode ser acessada durante a execuo do aplicativo, e no pode
Exemplo
Se voc quiser que um componente chamado Label1 tenha a sua propriedade Caption igual da
terceira janela-filha de um formulrio MDI chamado Form1, basta digitar a seguinte linha de cdigo:
Label1.Caption := TButton(Form1.MDIChildren[2]).Caption;
TForm
MENU
Descrio
A propriedade Menu declarada como uma varivel do tipo TMainMenu que identifica o menu de
um formulrio.
Exemplo
Voc pode alterar a propriedade Menu de um formulrio diretamente no Object Inspector, ou mediante
a incluso de uma linha de cdigo como:
Form1.Menu := MainMenu1;
Na fase de projeto:
TForm
TForm
MESSAGE
Descrio
A propriedade Message declarada como uma varivel do tipo string, define o texto a ser exibido na
caixa de dilogo que mostrada quando ocorre um erro definido por essa exceo.
EAbort, EAbstractError, EAccessViolation, EarrayError, EassertinFailed, EbitsError,
EbrokerException, EcacheError, EclassNotFound, EcommomCalendarError, EcomponentError,
EcontrolC, EconvertError, EDatabaseError, EdateTimeError, EDBClient, EDBEditError,
EDBEngineError, EdimensionMapError, EDimIndexError, EdivByZero, EDSWriter, Eexternal,
EexternalException, EFCreateError, EfilerError, EFOpenError, EHeapException, EInOutError,
EInterpreterError, EintError, EIntCastError, EIntOverFlow, EInvalidArgument, EInvalidCast,
EInvalidGraphic, EInvalidGraphicOperation, EinvalidGridOperation, EinvalidImage, EinvalidOp,
EinvalidOperation, EinvalidPointer, ElistError, ElowCapacityError, EmathError,
EMCIDeviceError, EmenuError, EmonthCalError, EnoResultError, EoleCtrlError, EOLEError,
EoleException, EOleSysError, EoutLineError, EoutOfMemory, EoutOfResources, Eoverflow,
EpackageError, EparserError, Eprinter, Eprivilege, EpropertyError, EpropReadOnly,
EpropWriteOnky, ErangeError, EradError, EreconcileError, EregistryError, EresNotFound,
EsocketConnectionError, EsocketError, EstackOverflow, EstreamError, EstringListError, Ethread,
EtreeViewError, EunderFlow, EunSupportedTypeError, EUpdateError, EVariantError, EWin32Error,
EWriteError, Exception, EzeroDivide
METAFILE
Descrio
Essa propriedade declarada como uma varivel do tipo TMetafile, e define o grfico armazenado no
componente. Essa propriedade s est disponvel durante a execuo do aplicativo.
TPicture
MIN
Descrio
A propriedade Min uma varivel inteira que define o valor mnimo de posio para um componente.
Exemplo
Voc pode alterar a propriedade Min diretamente no Object Inspector ou mediante uma linha de
cdigo como:
ScrollBar1.Min:= 10;
Na fase de projeto:
MINFONTSIZE
Descrio
A propriedade MinFontSize uma varivel inteira que define o menor tamanho da fonte disponvel na
caixa de dilogo. Um valor nulo significa que no existe valor mnimo.
Exemplo
Voc pode alterar a propriedade MinFontSize diretamente no Object Inspector ou mediante uma linha
de cdigo como:
FontDialog1.MinFontSize := 6;
Na fase de projeto:
TFontDialog
TFontDialog
MINPAGE
Descrio
A propriedade MinPage uma varivel inteira que define o menor nmero para uma pgina a ser impressa.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector, ou mediante a incluso
PrintDialog1.MinPage := 1;
Na fase de projeto:
TPrintDialog
TPrintDialog
MINVALUE
Descrio
A propriedade MinValue declarada como uma varivel do tipo inteiro longo (Longint) que define o
valor mnimo que pode ser atribudo a um campo. Atribuir um valor menor do que MinValue gera
uma exceo. Essa propriedade s est disponvel durante a execuo de um aplicativo.
Exemplo
Voc pode alterar o valor da propriedade MinValue mediante uma linha de cdigo como:
IntegerField1.MinValue:= 1;
TAutoIncField, TCurrencyField, TFloatField, TIntegerField, TSmallintField e TWordField
MODALRESULT
Descrio
A propriedade ModalResult uma varivel do tipo TModalResult usada para encerrar a execuo de
um formulrio Modal. Definir o valor da propriedade ModalResult com um valor diferente de zero
encerra a execuo de um dilogo modal. Normalmente, isto feito colocando-se botes do tipo
TButton ou TBitBtn no formulrio e definindo o valor da sua propriedade ModalResult como um dos
valores da tabela abaixo. O valor da propriedade ModalResult ser o valor retornado pelo mtodo
ShowModal que exibe um formulrio modal.
Tabela de Valores:
Valor Significado
mrNone 0
mrOk idOK (1)
mrCancel idCancel (2)
continua
Exemplo
Crie dois formulrios chamados Form1 e Form2, cada um com um boto do tipo TButton;
No evento OnClick do boto Button1 de Form1 inclua a seguinte linha de cdigo, e inclua Unit2 na
clusula Uses de Form1:
Form2.ShowModal;
No evento OnClick do boto Button1 de Form2 inclua a seguinte linha de cdigo:
ModalResult := 4;
Rode o aplicativo e d um clique no o boto Button1 de Form1, para exibir Form2. Ao clicar no boto
Button1 de Form2, este se fechar, pois o valor da sua propriedade Modal Result diferente de zero.
Faa agora a seguinte modificao:
No evento OnClick do boto Button1 de Form2 inclua a seguinte linha de cdigo:
ModalResult := 0;
Rode o aplicativo e d um clique no o boto Button1 de Form1, para exibir Form2. Ao clicar no boto
Button1 de Form2 este no se fechar, pois o valor da sua propriedade Modal Result igual a zero.
Observao: A melhor maneira de se trabalhar com um formulrio modal atravs da incluso de
botes do tipo TButton ou TBitBtn e definir diretamente a propriedade ModalResult dos botes.
Na fase de projeto:
TForm, TBitBtn e TSpeedButton
TForm, TBitBtn e TSpeedButton
MODE
Descrio
A propriedade Mode declarada como uma varivel do tipo TMPModes que define o estado em que se
encontra um dispositivo multimdia. Essa propriedade s est disponvel durante a execuo do
Para componentes do tipo TBatchMove, essa propriedade declarada como uma varivel do tipo
TBatchMode, e define o tipo de operao a ser realizada pelo componente.
Valor Significado
mrAbort idAbort (3)
mrRetry idRetry (4)
mrIgnore idIgnore (5)
mrYes idYes (6)
mrNo idNo (7)
mrAll mrNo + 1 (8)
continuao
Para objetos do tipo TPen, define como as linhas sero desenhadas sobre um objeto do tipo Tcanvas.
Tabela de Valores para objetos do Tipo TPen:
Tabela de Valores para componentes do Tipo TBatchMove:
Valor Significado
pmBlack Sempre preto.
pmWhite Sempre branco.
pmNop Transparente.
pmNot Cor inversa da tela.
pmCopy Cor especificada na propriedade Color.
pmNotCopy Cor inversa da especificada na propriedade Color.
pmMergePenNot Combinao da cor definida na propriedade Color e a inversa da existente na tela.
pmMaskPenNot Combinao das cores comuns cor atual com a inversa da existente na tela.
pmMergeNotPen Combinao da cor existente na tela com a inversa da cor atual.
pmMaskNotPen Combinao das cores comuns existente na tela e a inversa da cor atual.
pmMerge Combinao da cor atual com a existente na tela.
pmNotMerge Inverso de pmMerge.
pmMask Combinao das cores comuns existente na tela e a cor atual.
pmNotMask Inverso de pmMask.
pmXor Combinao das cores comuns na tela e a cor atual, mas no em ambas.
pmNotXor Inverso de pmXor.
Tabela de Valores para componentes do Tipo TMediaPlayer:
Valor Significado
batAppend Adiciona os registros numa tabela j existente, definida como destino da operao.
batUpdate Atualiza os registros na tabela definida como destino da operao.
batAppendUpdate Se um registro correspondente existe na tabela-destino, ele atualizado,;
se no adicionado um novo registro.
batCopy Cria a tabela-destino com a mesma estrutura da tabela de origem.
batDelete Deleta os registros da tabela-destino que tm correspondncia com os registros da
tabela de origem.
Valor Significado
mpNotReady No est pronto.
mpStopped Execuo terminada.
mpPlaying Em execuo.
continua
Exemplo
O trecho de cdigo a seguir exibe uma mensagem informando se um dispositivo est pronto:
if MediaPlayer1.Mode = mpNotReady then ShowMessage(Dispositivo no est pronto)
else ShowMessage(Dispositivo est pronto);
Na fase de projeto:
TBatchMove
TBatchMove e TMediaPlayer
MODIFIED
Descrio
Para componentes dos tipos TEdit, TMaskEdit e TMemo, a propriedade Modified uma varivel booleana
que define se o texto do componente foi alterado desde que ele foi criado, ou desde a ltima vez que essa
propriedade teve seu valor igual a False. Essa propriedade s est disponvel durante a execuo do aplicativo.
Para componentes dos tipos TClientDataset, TTable, TQuery, TDecisionQuery e TStoredProc, determina
se o registro corrente foi alterado.
Exemplo
Voc pode verificar se o texto exibido pelo controle foi alterado durante a execuo do aplicativo com
if Edit1.Modified = True then MessageDlg(texto modificado,mtInformation, [mbOK], 0);
TClientDataset, TEdit, TMaskEdit, TTable, TQuery, TDecisionQuery, TStoredProc e TMemo
MODIFIERS
Descrio
A propriedade Modifiers declarada como uma varivel do tipo THKModifiers, e define a tecla
modificadora na definio de uma tecla aceleradora.
Valor Significado
mpRecording Gravando.
mpSeeking Procurando.
mpPaused Pausa.
mpOpen Aberto
continuao
Tabela de Valores:
Na fase de projeto:
THotKey
THotKey
MODIFYSQL
Descrio
Essa propriedade armazena uma lista de strings contendo a declarao SQL usada para modificar um registro.
Na fase de projeto:
MONOCHROME
Descrio
A propriedade Monochrome declarada como uma varivel booleana, e determina se o objeto contm
ou no um grfico monocromtico. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode verificar o valor dessa propriedade durante a execuo do aplicativo incluindo uma linha
de cdigo como:
if Graphic1.Monochrome then ShowMessage(Monocromtico);
TBitmap
MOVEDCOUNT
Descrio
A propriedade MovedCount declarada como uma varivel do tipo inteiro longo (Longint) que define
o nmero de registros realmente processados pelo mtodo Execute de um componente do tipo
TBatchMove. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu
Valor Significado
hkShift A tecla Shift usada como tecla modificadora.
hkCtrl A tecla Ctrl usada como tecla modificadora.
hkAlt A tecla Alt usada como tecla modificadora.
hkExt Outra tecla usada como tecla modificadora.
Exemplo
O trecho de cdigo a seguir faz com que um controle chamado Label1 do tipo Tlabel exiba o nmero
de registros realmente processados em um componente do tipo TBatchMove:
Label1.Caption := IntToStr(BatchMove1.MovedCount);
TBatchMove
MULTILINE
Descrio
A propriedade Multiline declarada como uma varivel booleana, que define se as guias de um controle
podem ser dispostas em mais de uma linha.
Na fase de projeto:
TPageControl e TTabControl
MULTISELECT
Descrio
A propriedade MultiSelect uma varivel booleana que define possvel selecionar simultaneamente
mais de um arquivo no componente.
Exemplo
Voc pode alterar a propriedade MultiSelect diretamente no Object Inspector ou mediante uma linha
de cdigo como:
FileListBox1.MultiSelect:= True;
Na fase de projeto:
TFileListBox, TListView e TListBox
TFileListBox, TListView e TListBox
NAME
Descrio
A propriedade Name uma varivel do tipo TComponentName (que , na realidade, uma string) que
identifica o componente dentro da sua aplicao.
Para objetos do tipo TFont, define o nome da fonte utilizada.
Para objetos da classe EcorbaException, identifica o tipo da exceo gerada.
Exemplo
Para alterar a propriedade Name de um boto chamado Button1 durante a execuo de um aplicativo,
Button1.Name := Novo Nome;
Embora o Delphi permita que voc altere a propriedade Name de um componente durante a execuo de um aplicativo, isto deve ser
feito com muita cautela, pois pode provocar verdadeiros desastres! A princpio no deve haver razo para se definir a propriedade
Name de um componente durante a execuo de um aplicativo, a no ser que o componente esteja sendo criado em tempo de execuo.
Na fase de projeto:
Todos os controles e componentes, alm de objetos da classe TAction e TMenuItem.
Todos os controles e componentes, alm de objetos da classe TAction e TMenuItem.
NAMELIST
Descrio
Esta propriedade declarada como uma lista de strings, e armazena os nomes dos procedimentos
armazenados existentes no banco de dados.
TIBStoredProc
NETFILEDIR
Descrio
Essa propriedade declarada como uma varivel do tipo string, e indica o diretrio onde est localizado
o arquivo de controle PDOXUSRS.EXE. Essa propriedade s est disponvel durante a execuo do
TSession
NOTIFY
Descrio
A propriedade Notify uma varivel booleana que define se a chamada a um de seus mtodos deve
gerar um evento OnNotify. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode alterar a propriedade Notify mediante uma linha de cdigo como:
MediaPlayer1.Notify := True;
TMediaPlayer
NOTIFYVALUE
Descrio
A propriedade NotifyValue uma varivel do tipo TMPNotifyValues que define o resultado do ltimo
mtodo executado em um componente do tipo TMediaPlayer. Essa propriedade s est disponvel
Tabela de Valores:
Exemplo
O trecho de cdigo a seguir exibe uma mensagem informando se o ltimo mtodo foi executado com sucesso:
if MediaPlayer1.NotifyValue = nvSuccessful then ShowMessage(O mtodo foi executado com sucesso);
TMediaPlayer
NUMGLYPHS
Descrio
A propriedade NumGlyphs uma varivel inteira, variando entre 1 e 4, que define o nmero de
imagens armazenadas no grfico definido pela propriedade Glyph do componente.
Exemplo
Voc pode alterar a propriedade NumGlyphs diretamente no Object Inspector ou mediante uma linha
de cdigo como:
SpeedButton1.NumGlyphs := 1;
Na fase de projeto:
Valor Significado
nvSuccessful O mtodo foi executado com sucesso.
nvSuperseded O mtodo foi superposto por outro mtodo.
nvAborted O mtodo teve a sua execuo interrompida pelo usurio.
nvFailure O mtodo no foi executado com sucesso.
OBJCLASS
Descrio
A propriedade ObjClass uma varivel do tipo string que especifica a classe OLE de um objeto.
Normalmente, a classe do objeto o nome da aplicao sem a extenso .EXE.
Exemplo
Voc pode alterar a propriedade ObjClass diretamente no Object Inspector ou mediante uma linha de
cdigo como:
OLEContainer1.ObjClass = Figura do PaintBrush;
Na fase de projeto:
TOLEContainer
TOLEContainer
OBJDOC
Descrio
A propriedade ObjDoc uma varivel do tipo string que especifica o arquivo de um objeto OLE.
Normalmente, a classe do objeto o nome do arquivo que contm o objeto OLE.
Exemplo
Voc pode alterar a propriedade ObjDoc diretamente no Object Inspector ou mediante uma linha de
cdigo como:
OLEContainer1.ObjDoc = c:\windows\256color.bmp;
Na fase de projeto:
TOLEContainer
TOLEContainer
OBJECTS
Descrio
Essa varivel declarada como uma array de objetos do tipo TObjects, e d acesso a um objeto de uma
lista de objetos associada a uma lista de strings.
TStringList e Tstrings
OBJITEM
Descrio
A propriedade ObjItem uma varivel do tipo string que especifica o item de dado de um objeto OLE.
Exemplo
Voc pode alterar a propriedade ObjItem diretamente no Object Inspector ou mediante uma linha de
cdigo como:
OLEContainer1.ObjItem = Item;
Na fase de projeto:
TOLEContainer
TOLEContainer
OEMCONVERT
Descrio
A propriedade OEMConvert uma varivel booleana que define se um texto do controle convertido
em caracteres OEM.
Exemplo
Voc pode alterar a propriedade OEMConvert diretamente no Object Inspector ou mediante uma
linha de cdigo como:
Edit1. OEMConvert := True;
Na fase de projeto:
TEdit e TMemo
TEdit e TMemo
OPEN
Descrio
Essa propriedade declarada como uma varivel booleana, e indica se o arquivo que armazena o clipe
de vdeo exibido pelo componente est carregado na memria.
TClientDataset, TAnimate
OPERATION
Descrio
A propriedade Operation define a operao que o componente realiza sobre um campo nos registros
de um banco de dados.
Tabela de Valores:
Na fase de projeto:
TQRDBCalc
TQRDBCalc
OPTIONS
Descrio
O significado dessa propriedade depende do componente a que se refere, como pode ser verificado nas
tabelas de valores que se seguem:
Tabela de Valores para objetos do tipo TColorDialog:
Nesse caso, a propriedade uma varivel do tipo TColorDialogOptions e consiste de trs subpropriedades
booleanas, listadas na tabela abaixo.
Valor Significado
qrcSUM Calcula a soma do valor armazenado nesse campo em todos os registros.
qrcCOUNT Conta o nmero de registros.
qrcAVERAGE Calcula a mdia dos valores armazenados nesse campo em todos os registros.
qrcMIN Retorna o menor dos valores armazenados nesse campo em todos os registros.
qrcMAX Retorna o menor dos valores armazenados nesse campo em todos os registros.
Tabela de Valores para objetos do Tipo TFontDialog:
Nesse caso, a propriedade uma varivel do tipo TFontDialogOptions e consiste das subpropriedades
booleanas listadas na tabela abaixo.
Valor Significado
cdFullOpen Exibe prontamente as opes de cores personalizadas.
cdPreventFullOpen Desabilita o boto Create Custom Colors (Definir Cores Personalizadas), impedindo que
o usurio possa definir suas prprias cores (S se aplica se cdFullOpen for False).
cdShowHelp Exibe um boto de Help na caixa de dilogo.
Valor Significado
fdAnsiOnly Se igual a True, s permite que o usurio possa selecionar fontes que usam o
conjunto de caracteres do Windows, isto , no permite ao usurio selecionar um
estilo de fonte que s contenha smbolos, pois estes no sero exibidos na caixa
combo Font.
fdEffects Seu valor define se as caixas de verificao e a lista de cores devem aparecer
no dilogo.
continua
continuao
Tabela de Valores para Objetos do Tipo TPrintDialog:
Nesse caso, a propriedade uma varivel do tipo TPrintDialogOptions e consiste das subpropriedades
booleanas listadas na tabela abaixo.
Valor Significado
fdFixedPitchOnly Se igual a True, apenas as fontes monoespaadas sero exibidas na caixa combo Font.
fdForceFontExist Indica se deve ser exibida uma mensagem informando ao usurio que ele
digitou um nome de fonte invlido.
fdLimitSize Se igual a True, os valores de MinFontSize e MaxFontSize limitam o nmero de
fontes disponveis atravs da caixa de dilogo.
fdNoFaceSel Se igual a True, nenhuma fonte pr-selecionada pela caixa de dilogo.
fdNoOEMFonts Se igual a True, as fontes vetoriais no so exibidas.
fdScalableOnly Se igual a True, s so exibidas fontes escalveis.
fdNoSimulations Se igual a True, s exibe fontes que no so simuladas pela GDI.
fdNoSizeSel Se igual a True, nenhum tamanho de fonte pr-selecionado pela caixa de dilogo.
fdNoStyleSel Se igual a True, nenhum estilo de fonte pr-selecionado pela caixa de dilogo.
fdNoVectorFonts O mesmo que fdNoOEMFonts.
fdShowHelp Se igual a True, a caixa de dilogo exibe um boto de Help.
fdTrueTypeOnly Se igual a True, somente fontes True Type so pela caixa de dilogo.
fdWysiwyg Se igual a True, somente fontes disponveis na tela e na impressora so exibidas
pela caixa de dilogo.
Tabela de Valores para Objetos do Tipo TOpenDialog, TOpenPictureDialog e TSaveDialog,
TSavePictureDialog:
Nesse caso, a propriedade uma varivel do tipo TOpenDialogOptions e consiste das subpropriedades
booleanas listadas na tabela a seguir.
Valor Significado
poHelp Se igual a True, a caixa de dilogo exibe um boto de Help.
poPageNums Se igual a True, o boto de rdio Pages habilitado e o usurio pode definir
a faixa de pginas a serem impressas.
poPrintToFile Se igual a True, a caixa de verificao Print to File exibida, permitindo que
o usurio direcione a impresso para um arquivo e no para a impressora.
poSelection Se igual a True, o boto de rdio Selections habilitado e o usurio pode
optar por imprimir apenas o texto selecionado.
poWarning Se igual a True, uma mensagem de advertncia aparece quando no houver
uma impressora instalada.
poDisablePrintToFile Se igual a True e a opo poPrintToFile tambm True, a caixa de verificao
Print To File aparece acinzentada. Se poPrintToFile False, esta opo no
tem nenhum efeito.
Tabela de Valores para objetos do tipos TFindDialog e TReplaceDialog:
Nesse caso, a propriedade uma varivel do tipo TFindOptions e consiste das subpropriedades booleanas
listadas na tabela a seguir.
Valor Significado
ofAllowMultiSelect Se igual a True, permite a seleo de mais de um arquivo na caixa de listagem
File Name.
ofCreatePrompt Se igual a True, quando o usurio digita um nome de arquivo inexistente xibe
uma mensagem de advertncia e pergunta se deseja criar um arquivo novo
com o nome digitado.
ofExtensionDifferent Essa opo retorna True se a extenso do arquivo selecionado igual
extenso default, definida na propriedade DefaultExt.
ofFileMustExist Se igual a True, quando o usurio digita um nome de arquivo inexistente
exibe uma mensagem de advertncia informando que o arquivo com o nome
especificado no foi encontrado, e pergunta se o caminho (path) e o nome
digitados esto corretos, no permitindo a criao de novos arquivos.
ofHideReadOnly Se igual a True, a caixa de verificao Read Only no exibida na caixa de dilogo.
ofNoChangeDir Se igual a True, essa opo faz com que o diretrio corrente na abertura da
caixa de dilogo seja igual ao definido quando a caixa de dilogo apareceu
pela primeira vez, ignorando qualquer alterao feita pelo usurio.
ofNoReadOnlyReturn Se igual a True, uma mensagem de advertncia informa ao usurio que o
arquivo somente para leitura.
ofNoTestFileCreate Essa opo s se aplica quando o usurio tenta salvar um arquivo em um
ponto de uma rede do tipo create-no-modify, que no permite que um arquivo
seja aberto mais de uma vez e simultaneamente. Se o seu valor True, a
aplicao no verificar se h proteo contra gravao no disco, se o disco
est cheio, se uma porta de um drive est aberta, ou se h proteo contra
escrita na rede.
ofNoValidate Se igual a True, essa opo impede que o usurio digite caracteres invlidos
para o nome de um arquivo. Se igual a False e o usurio digitar caracteres
invlidos para o nome de um arquivo, surge uma mensagem de advertncia.
ofOverwritePrompt Se igual a True, a aplicao exibe uma mensagem de advertncia quando o
usurio tenta salvar um arquivo que j existe, permitindo que usurio
selecione outro nome para o arquivo ou sobreponha o arquivo j existente.
ofReadOnly Se igual a True, a caixa de verificao aparece marcada quando a caixa de
dilogo exibido.
ofPathMustExist Se igual a True, s permite que o usurio digite um path j existente para o
arquivo. Se o usurio digitar um path invlido, ser exibida uma mensagem
de advertncia.
ofShareAware Se igual a True, ignora erros de compartilhamento de arquivos. Se False, exibe
uma mensagem de advertncia quando isto ocorre.
ofShowHelp Se igual a True, a caixa de dilogo exibe um boto de Help.
Tabela de Valores para objetos do Tipo TOutline:
Nesse caso, a propriedade uma varivel do tipo TOutlineOptions e consiste das subpropriedades
booleanas listadas a seguir, que definem como os seus itens sero exibidos.
Valor Significado
frDisableMatchCase Se igual a True, a caixa de verificao MatchCase aparece acinzentada, e essa
opo no pode ser selecionada pelo usurio.
frDisableUpDown Se igual a True, os botes de rdio Up e Down so desabilitados e no podem ser
selecionados pelo usurio.
frDisableWholeWord Se igual a True, a caixa de verificao Match Whole Word aparece acinzentada, e
essa opo no pode ser selecionada pelo usurio.
frDown Se igual a True, o boto de rdio Down pr-selecionado pela caixa de dilogo.
Se igual a False, o boto de rdio Up pr-selecionado pela caixa de dilogo.
frFindNext Se igual a True, faz com que a string definida na propriedade FindText seja pr-selecionada.
frHideMatchCase Se igual a True, a caixa de verificao MatchCase no exibida.
frHideWholeWord Se igual a True, a caixa de verificao Match Whole Word no exibida.
frHideUpDown Se igual a True, os botes de rdio Up e Down no so exibidos.
frMatchCase Se igual a True, a caixa de verificao MatchCase pr-selecionada pela caixa de dilogo.
frReplace Se igual a True, a ocorrncia atual da string FindText substituda pela string
armazenada na propriedade ReplaceText Essa propriedade s se aplica a objetos
do tipo TReplaceDialog.
frReplaceAll Se igual a True, toda ocorrncia da string FindText substituda pela string
armazenada na propriedade ReplaceText Essa propriedade s se aplica a objetos
do tipo TReplaceDialog.
frShowHelp Se igual a True, a caixa de dilogo exibe um boto de Help.
frWholeWord Se igual a True, a caixa de verificao Match Whole Word pr-selecionada pela
caixa de dilogo.
Tabela de Valores para objetos do Tipo TDrawGrid e TStringGrid:
Nesse caso, a propriedade uma varivel dos tipos TGridOptions e consiste das subpropriedades
booleanas listadas a seguir.
Valor Significado
ooDrawTreeRoot O primeiro item (cujo valor igual a 1) conectado ao item-raiz.
ooDrawFocusRect Se igual a True, um retngulo desenhado em torno do item selecionado,
indicando que ele possui o foco.
ooStretchBitmaps Se igual a True, os itens de Bitmap so redimensionados para caber no
tamanho de um item.
Valor Significado
goFixedHorzLine Se igual a True, exibe linhas horizontais entre linhas de clulas fixas.
goFixedVertLine Se igual a True, exibe linhas verticais entre colunas de clulas fixas.
goHorzLine Se igual a True, exibe linhas horizontais entre linhas de clulas.
goVertLine Se igual a True, exibe linhas verticais entre colunas de clulas.
goRangeSelect Se igual a True, e desde que goEditing seja False, permite que o usurio
selecione um grupo de clulas de uma s vez.
goDrawFocusSelected Se igual a True, a clula que possui o foco possui a mesma cor das outras
clulas de um bloco selecionado. Se igual a False, a clula que possui o foco
possui a mesma cor das clulas que no esto selecionadas, isto , com a cor
definida na propriedade Color.
goRowSizing Se igual a True, as linhas de clulas podem ser redimensionadas
individualmente, exceto as fixas.
goColSizing Se igual a True, as colunas de clulas podem ser redimensionadas
individualmente, exceto as fixas.
goRowMoving Se igual a True, o usurio pode deslocar uma linha de clulas com o mouse.
goColMoving Se igual a True, o usurio pode deslocar uma linha de clulas com o mouse.
goEditing Se igual a True, o usurio pode editar o texto da grade, mas no pode
selecionar um grupo de clulas de uma s vez.
goAlwaysShowEditor Se igual a True e goEditing tambm True, a grade est no modo de edio
automtico, e o usurio no precisa pressionar Enter ou F2 antes de editar o
contedo de uma clula. Se igual a False com goEditing igual a True, o
usurio precisa pressionar Enter ou F2 antes de editar o contedo de uma
clula. Se goEditing for False, essa propriedade no tem efeito.
goTabs Se igual a True, o usurio pode usar Tab e Shift+Tab para se deslocar pelas
colunas da grade.
goRowSelect Se igual a True, o usurio no pode selecionar uma clula individual, mas
toda a linha que contm a clula.
goThumbTracking Se igual a True, o contedo da grade rola simultaneamente quando o usurio
movimenta a caixa de rolagem da barra de rolagem correspondente. Se igual
a False, o rolamento no simultneo, ocorrendo apenas quando o usurio
libera a caixa de rolagem.
Tabela de Valores para objetos do Tipo TDBGrid e TIWDBGrid:
Nesse caso, a propriedade uma varivel do tipo TDBGridOptions e consiste das subpropriedades
Valor Significado
dgEditing Se igual a True, o usurio pode editar os dados da grade. Se a propriedade
ReadOnly tambm True, o usurio pode inserir linhas em branco com a
tecla Insert, ou, quando estiver na extremidade inferior do componente, usar
a tecla de seta para baixo para acrescentar uma linha em branco.
Tabela de Valores para objetos do Tipo TDBLookupCombo, TDBLookupList, TIWDBLookupCombo e
TIWDBLookupList:
Nesse caso, a propriedade uma varivel do tipo TDBLookupListOptions e consiste das subpropriedades
Valor Significado
dgAlwaysShowEditor Se igual a True e goEditing tambm True, a grade est no modo de edio
automtico, e o usurio no precisa pressionar Enter ou F2 antes de editar o
contedo de uma clula. Se igual a False com goEditing igual a True, o
usurio precisa pressionar Enter ou F2 antes de editar o contedo de uma
clula. Se goEditing for False, essa propriedade no tem efeito.
dgTitles Se igual a True, os ttulos das colunas so exibidos.
dgIndicator Se igual a True, exibe um ponteiro que indica a coluna corrente.
dgColumnResize Se igual a True, as colunas podem ser redimensionadas.
dgColLines Se igual a True, exibe linhas entre colunas de clulas.
dgRowLines Se igual a True, exibe linhas entre linhas de clulas.
dgTabs Se igual a True, o usurio pode usar Tab e Shift+Tab para se deslocar pelas colunas da grade.
dgRowSelect Se igual a True, o usurio no pode selecionar uma clula individual, mas
toda a linha que contm a clula.
dgAlwaysShowSelection Se igual a True, as clulas selecionadas permanecem selecionadas quando perdem o foco.
dgConfirmDelete Se igual a True, uma mensagem de confirmao exibida quando o usurio
tenta deletar uma linha de clulas com Ctrl+Delete.
dgCancelOnExit Se igual a True e nenhuma modificao tiver sido feita nas clulas inseridas
pelo usurio, a insero ser cancelada quando a grade perder o foco da aplicao.
Tabela de Valores para objetos do Tipo TIndexDef:
Para esses objetos essa propriedade s est disponvel durante a execuo do aplicativo, no pode ter o
seu valor diretamente alterado pelo usurio e corresponde ao conjunto de caractersticas do ndice,
como ixPrimary, ixUnique, ixDescending, ixNonMaintained e ixCaseInsensitive.
Exemplo
Com exceo de TIndexDef, os valores das subpropriedades da propriedade Options de um componente
podem ser alterados diretamente no Object Inspector.
Caso queira alter-las durante a execuo do aplicativo, as subpropriedades devem ser listadas entre
colchetes, separadas por vrgulas e, ento, o conjunto deve ser atribudo propriedade Options, como
na linha de cdigo seguinte:
Valor Significado
loColLines Se igual a True, as colunas do controle aparecem separadas por linhas verticais.
loRowLines Se igual a True, as linhas do controle aparecem separadas por linhas horizontais.
loTitles Se igual a True, os nomes dos campos so exibidos como ttulos das colunas do controle.
procedure TForm1.FormDblClick(Sender: TObject);
begin
FindDialog1.Options := [frShowHelp];
FindDialog1.Execute;
end;
Nesse caso, ao se dar um duplo clique com o mouse sobre um formulrio chamado Form1, ser exibida
uma caixa de dilogo do tipo TFindDialog, denominado FindDialog1, com o boto de rdio Up pr-
selecionado e exibindo um boto de Help.
As subpropriedades listadas entre colchetes tero o valor True e as demais o valor False, independentemente do valor que lhes tenha
sido atribudo no Object Inspector.
Na fase de projeto:
TColorDialog, TDBGrid, TDecisionGrid , TDBLookupCombo, TDBLookupList, TDrawGrid, TFontDialog,
TFindDialog, TIWDBGrid, TIWDBLookupCombo, TIWDBLookupList, TOpenDialog, TOpenPictureDialog,
TOutline, TPrintDialog, TReplaceDialog, TSaveDialog, TSavePictureDialog e TStringGrid
TColorDialog, TDBGrid, TDecisionGrid , TDBLookupCombo, TDBLookupList, TDrawGrid, TFontDialog,
TFindDialog, TIndexDef, TIWDBGrid, TIWDBLookupCombo, TIWDBLookupList, TOpenDialog, TOpenPictureDialog,
TOutline, TPrintDialog, TReplaceDialog, TSaveDialog, TSavePictureDialog e TStringGrid
ORIENTATION
Descrio
Para componentes do tipo TPrinter, essa propriedade declarada como uma varivel do tipo
TPrinterOrientation, e determina se a impresso da pgina ser vertical ou horizontal, e s pode ter o
seu valor alterado durante a execuo do aplicativo.
Para componentes do tipo TTrackBar, essa propriedade declarada como uma varivel do tipo
TTrackBarrOrientation, e determina se o controle ser vertical ou horizontal.
Para componentes do tipo TUPDown, essa propriedade declarada como uma varivel do tipo
TUDOrientation, e define a orientao das setas exibidas no componente.
Para componentes dos tipos TDBCtrlGrid, essa propriedade declarada como uma varivel do tipo
TDBCtrlOrientation, e define se os painis internos ao controle sero dispostos horizontalmente (um
ao lado do outro) ou verticalmente (um sobre o outro).
Para componentes do tipo TQuickReport e TQRPrinter, essa propriedade declarada como uma varivel
do tipo TPrinterOrientation, e seleciona a orientao do papel na impresso do relatrio.
Tabela de Valores para componentes dos Tipos TPrinter, TQRPrinter e TQuickReport:
Valor Significado
poPortrait Pgina impressa verticalmente.
poLandscape Pgina impressa horizontalmente.
Tabela de Valores para componentes do Tipo TTrackBar:
Tabela de Valores para componentes do Tipo TUPDown:
Tabela de Valores para componentes do Tipo TDBCtrlGrid:
Exemplo
Para alterar a propriedade Orientation de um componente chamado UpDown1 do tipo TUpDown
durante a execuo de um aplicativo, basta incluir a seguinte linha de cdigo no evento correspondente:
TUpDown1.Orientation:= valor;
Na fase de projeto:
TPrinter, TTrackBar, TUpDown, TQuickReport e TDBCtrlGrid
TTrackBar, TUpDown, TDBCtrlGrid, TQuickReport, TPrinter e TQRPrinter
ORIGINALEXCEPTION
Descrio
A propriedade OriginalException definida como um objeto da classe Exception , e indica o objeto
que representa o erro ocorrido ao se tentar manipular um componente TProvider.
EUpdateError
Valor Significado
tbHorizontal Controle horizontal.
tbVertical Controle vertical.
Valor Significado
udHorizontal Setas para a esquerda e para a direita.
udVertical Setas para cima e para baixo.
Valor Significado
roHorizontal Painis internos dispostos horizontalmente.
roVertical Painis internos dispostos verticalmente.
OUTLINESTYLE
Descrio
A propriedade OutlineStyle declarada como uma varivel do tipo TOutlineStyle que define como a
estrutura de dados exibida em um componente do tipo TOutlineStyle.
Tabela de Valores:
Exemplo
Voc pode alterar o valor da propriedade OutlineStyle diretamente no Object Inspector ou mediante
uma linha de cdigo como:
Outline1.OutlineStyle := osPictureText
Na fase de projeto:
TOutline
TOutline
OVERLOAD
Descrio
Essa propriedade declarada como uma varivel do tipo Word que define o procedimento a ser executado
em um servidor Oracle.
Exemplo
Voc pode alterar o valor da propriedade Overload diretamente no Object Inspector ou mediante uma
StoredProc1.Overload := 1;
Valor Significado
osPictureText Exibe pastas abertas (com a figura especificada na propriedade PictureOpen), pastas
fechadas (com a figura especificada na propriedade PictureClosed), pastas de extremidade
(com a figura especificada na propriedade PictureLeaf) e itens de texto (especificado na
propriedade Text).
osPlusMinusPictureText Exibe figuras representando um sinal de menos (especificadas na propriedade
PictureMinus), figuras representando um sinal de mais (especificadas na propriedade
PicturePlus), pastas abertas, pastas fechadas, pastas de extremidade e itens de texto.
osPlusMinusText Exibe figuras representando um sinal de menos (especificadas na propriedade PictureMinus),
figuras representando um sinal de mais (especificadas na propriedade PicturePlus),
e itens de texto.
osText Exibe apenas itens de texto.
osTreePictureText Exibe figuras representando a rvore hierrquica, pastas abertas, pastas
fechadas, pastas de extremidade e itens de texto.
osTreeText Exibe figuras representando a rvore hierrquica e itens de texto.
Na fase de projeto:
TStoredProc
TStoredProc
OWNER
Descrio
A propriedade Owner uma varivel do tipo TComponent que indica o componente proprietrio do
componente atual. Essa propriedade s pode ser acessada durante a execuo do aplicativo, e no pode
Exemplo
Se quisermos saber qual o componente proprietrio de um boto de rdio chamado RadioButton1,
devemos incluir a seguinte linha de cdigo, na qual Comp um objeto do tipo TComponent:
Comp := RadioButton1.Owner;
Todos os componentes.
PAGECOUNT
Descrio
Para componentes do tipo TQuickReport, essa propriedade declarada como uma varivel do tipo
inteiro longo, e especifica o nmero de pginas do relatrio.
Para componentes do tipo TQRPrinter, essa propriedade declarada como uma varivel do tipo inteiro,
e especifica o nmero de pginas do relatrio que est sendo impresso.
TQRPrinter e TQuickReport
PAGEHEIGHT
Descrio
inteiro longo, e especifica a altura, em pixels, da pgina no relatrio, obtida do objeto QRPrinter
associado. Essa propriedade s est disponvel durante a execuo do aplicativo.
Para componentes do tipo TPrinter, essa propriedade declarada como uma varivel do tipo inteiro, e
especifica a altura da pgina que est sendo impressa. Essa propriedade s est disponvel durante a
execuo do aplicativo, e no pode ter o seu valor alterado pelo usurio.
Para componentes do tipo TQRPrinter, essa propriedade declarada como uma varivel do tipo inteiro,
e especifica a altura da pgina corrente em pixels. Essa propriedade s est disponvel durante a execuo
do aplicativo.
Na fase de projeto:
TQuickReport
TPrinter, TQuickReport e TQRPrinter
PAGEINDEX
Descrio
Para componentes dos tipos TTabbedNotebook e TNotebook, essa propriedade definida como uma
varivel inteira que define o nmero da pgina ativa.
Para componentes do tipo TTabSheet, essa propriedade definida como uma varivel inteira que
define o nmero da pgina ativa no controle TPageControl associado.
Exemplo
Voc pode alterar a propriedade PageIndex do componente diretamente no Object Inspector ou mediante
Notebook1. PageIndex:= 1;
Na fase de projeto:
TTabSheet, TNotebook e TTabbedNotebook
TTabSheet, TNotebook e TTabbedNotebook
PAGENUMBER
Descrio
Para componentes do tipo TQRPreview, a propriedade PageNumber declarada como uma varivel
inteira que especifica a pgina a ser pr-visualizada no componente.
Para componentes do tipo TQuickReport, a propriedade PageNumber declarada como uma varivel
do tipo inteiro longo que especifica o nmero da pgina corrente. Essa propriedade pode ser acessada
em eventos durante a preparao de um relatrio.
Para componentes do tipo TPrinter, essa propriedade declarada como uma varivel do tipo inteiro e
especifica o nmero da pgina corrente em um trabalho de impresso. Essa propriedade s est disponvel
durante a execuo do aplicativo, e no pode ter o seu valor alterado pelo usurio.
Para componentes do tipo TQRPrinter, essa propriedade declarada como uma varivel do tipo inteiro
e especifica o nmero da pgina disponvel para ser visualizada ou copiada para o Clipboard.
Na fase de projeto:
TQRPreview
TPrinter, TQRPrinter, TQuickReport e TQRPreview
PAGES
Descrio
A propriedade Pages definida como uma varivel do tipo TStrings, que uma lista de strings em que
cada string est associada a uma pgina do componente. A primeira string est associada primeira
pgina, a segunda string est associada segunda pgina, e assim por diante.
Exemplo
Voc pode alterar a propriedade Pages do componente diretamente no Object Inspector, com o String
List Editor, ou mediante uma linha de cdigo, como:
TabbedNotebook1.Pages[0] := Pgina 1;
Na fase de projeto:
TNotebook e TTabbedNotebook
TNotebook e TTabbedNotebook
PAGESIZE
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro longo, e define o nmero de bytes por
pgina configurado para o banco de dados.
Na fase de projeto:
TIBDatabaseInfo
TIBDatabaseInfo
PAGEWIDTH
Descrio
inteiro longo e especifica a largura da pgina no relatrio, obtida do objeto QRPrinter associado. Essa
Para componentes do tipo TPrinter, essa propriedade declarada como uma varivel do tipo inteiro e
especifica a largura da pgina que est sendo impressa. Essa propriedade s est disponvel durante a
Para componentes do tipo TQRPrinter, essa propriedade declarada como uma varivel do tipo
inteiro e especifica a largura da pgina corrente. Essa propriedade s est disponvel durante a
TPrinter, TQRPrinter e TQuickReport
PALETTE
Descrio
Essa propriedade declarada como uma varivel do tipo HPalette e define a paleta de cores usada pelo
objeto. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir copia a paleta de cores de Form2 para Form1:
SelectPalette(Form2.Canvas.Handle, Form1.Canvas.Palette, True);
TBitmap
PANELBORDER
Descrio
A propriedade PanelBorder declarada como uma varivel do tipo TDBCtrlGridBorder e define o tipo
de borda desenhada ao redor de cada um dos seus painis internos.
Tabela de Valores:
Exemplo
Voc pode alterar o valor da propriedade PanelBorder diretamente no Object Inspector ou mediante a
incluso uma linha de cdigo como:
DBCtrlGrid1.PanelBorder:= gbNone;
Na fase de projeto:
TDBCtrlGrid
TDBCtrlGrid
PANELCOUNT
Descrio
A propriedade PanelCount declarada como uma varivel inteira que especifica o nmero de painis
visveis na grade. Essa propriedade s est disponvel durante a execuo do aplicativo, e no pode ter
TDBCtrlGrid
Valor Significado
gbNone Painis sem borda.
gbRaised Painis com bordas elevadas.
PANELHEIGHT
Descrio
A propriedade PanelHeight declarada como uma varivel inteira que especifica a altura, em pixels, de
cada painel do componente.
Exemplo
DBCtrlGrid1.PanelHeight:= valor;
Na fase de projeto:
TDBCtrlGrid
TDBCtrlGrid
PANELINDEX
Descrio
A propriedade PanelIndex declarada como uma varivel inteira que especifica o nmero do painel
correspondente ao registro corrente. Essa propriedade s est disponvel durante a execuo do aplicativo.
TDBCtrlGrid
PANELS
Descrio
A propriedade Panels declarada como uma varivel do tipo TStatusPanels que d acesso caixa de
dilogo para edio de painis de um componente que representa uma barra de status.
Na fase de projeto:
TStatusBar
TStatusBar
PANELWIDTH
Descrio
A propriedade PanelWidth declarada como uma varivel inteira que especifica a largura, em pixels,
de cada painel do componente.
Exemplo
DBCtrlGrid1.PanelWidth:= valor;
Na fase de projeto:
TDBCtrlGrid
TDBCtrlGrid
PARAGRAPH
Descrio
Essa propriedade declarada como uma varivel do tipo TParaAttributes e contm informaes sobre a
formatao do pargrafo que contm o texto selecionado. Caso no exista um texto selecionado, define
as informaes do pargrafo correspondente posio atual do cursor. Essa propriedade s est disponvel
TRichEdit
PARAMBINDMODE
Descrio
Essa propriedade declarada como uma varivel do tipo TParamBindMode que define como os elementos
da array Params estaro relacionados aos parmetros de procedimentos armazenados em servidores.
Exemplo
Voc pode alterar o valor da propriedade ParamBindMode diretamente no Object Inspector ou mediante
StoredProc1. ParamBindMode := pbByName;
Na fase de projeto:
TStoredProc
TStoredProc
PARAMCHECK
Descrio
Na fase de projeto:
TADOCommand, TADODataset, TADOQuery e TADOStoredProc
TADOCommand, TADODataset, TADOQuery e TADOStoredProc
PARAMCOUNT
Descrio
Para componentes dos tipos TQuery e TDecisionQuery, essa propriedade declarada como uma varivel
do tipo Word e indica o nmero de elementos na array Params do componente.
Para componentes do tipo TStoredProc, essa propriedade declarada como uma varivel do tipo Word
e indica o nmero de parmetros de input e output para procedimentos localizados em um servidor.
TIBStoredProc, TIBQuery,TStoredProc, Tquery e TDecisionQuery
PARAMETERS
Descrio
Essa propriedade definida como um objeto da classe TParameters, e define ao parmetros usados em
uma declarao SQL.
Na fase de projeto:
TADOCommand, TADODataset, TADOTable, TADOQuery e TADOStoredProc
TADOCommand, TADODataset, TADOTable, TADOQuery e TADOStoredProc
PARAMS
Descrio
Para componentes dos tipos TDatabase, TIBTransaction e TIBDatabase, essa propriedade declarada
como uma lista de strings que armazena os parmetros definidos para acessar um banco de dados
representado pelo componente.
Para componentes dos tipos TIBDataset, TIBQuery, TQuery e TDecisionQuery, essa propriedade declarada
como uma array de itens do tipo TParam, que contm os parmetros de uma declarao SQL dinmica.
Para componentes dos tipos TIBStoredproc e TStoredProc, essa propriedade armazena os parmetros a
serem passados para procedimentos localizados em um servidor.
Para componentes do tipo TClientDataSet, essa propriedade declarada como uma array de itens do
tipo TParam, que contm os parmetros a serem enviados ao servidor.
Na fase de projeto:
TClientDataset, TIBTransaction, TIBStoredproc, TIBDataset, TIBQuery, TStoredProc e TQuery, TDecisionQuery
TClientDataset, TIBTransaction, TIBStoredproc, TIBDataset, TIBQuery, TStoredProc e TQuery, TDecisionQuery
PARENT
Descrio
A propriedade Parent uma varivel do tipo TWinControl que indica o componente-pai do componente
atual. Essa propriedade s pode ser acessada durante a execuo do aplicativo, e no pode ter o seu
Para objetos do tipo TOutlineNode, declarada como uma propriedade do tipo TOutlineNode e define
o componente TOutline que o contm.
Exemplo
Se quisermos saber qual o componente-pai de um boto de rdio chamado RadioButton1, devemos
incluir a seguinte linha de cdigo, na qual Comp um objeto do tipo TWinControl:
Comp := RadioButton1.Parent;
No confunda componente-pai com componente proprietrio. Se voc criar um formulrio chamado Form1 com um componente GroupBox
chamado GroupBox1 e dentro deste inserir um boto de rdio chamado RadioButton1, ento os componentes proprietrio e pai de
RadioButton1 sero, respectivamente, Form1 e GroupBox1.
Todos os controles e TOutlineNode.
PARENTCHART
Descrio
A propriedade ParentChart define o componente grfico ao qual a srie representada pelo objeto est
associada.
Na fase de projeto:
TChartSeries
TChartSeries
PARENTCOLOR
Descrio
A propriedade ParentColor uma varivel do tipo booleana que define se o valor da propriedade Color
do componente atual deve ou no ser igual propriedade Color do seu componente-pai.
Na fase de projeto:
TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBText, TDBListBox,
TDBLookupCombo, TDBLookupList, TDBMemo, TDBRadioGroup, TDirectoryListBox, TDrawGrid,
TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TGroupBox, TLabel, TListBox, TMaskEdit,
TMemo, TNotebook, TOutline, TPaintBox, TPanel, TRadioButton, TRichEdit, TScrollBox e TStringGrid
TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBText, TDBListBox,
TDBLookupCombo, TDBLookupList, TDBMemo, TDBRadioGroup, TDirectoryListBox, TDrawGrid,
TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TGroupBox, TLabel, TListBox, TMaskEdit,
TMemo, TNotebook, TOutline, TPaintBox, TPanel, TRadioButton, TRichEdit, TScrollBox e TStringGrid
PARENTCTL3D
Descrio
A propriedade ParentCtl3D uma varivel do tipo booleana que define se o valor da propriedade
Ctl3D do componente atual deve ou no ser igual propriedade Ctl3D do seu componente-pai. Se em
um formulrio fizermos a propriedade ParentCtl3D de todos os controles igual a True, isso garante que
todos os controles inseridos no formulrio tero o mesmo aspecto (tridimensional ou bidimensional).
Exemplo
Coloque em um formulrio chamado Form1 um boto de rdio chamado RadioButton1 e defina, no
Object Inspector, sua propriedade ParentCtl3D como False. Nesse caso, voc pode definir para o boto
de rdio um aspecto diferente do adotado pelo formulrio (que o seu componente-pai).
Na fase de projeto:
TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage, TDBLookupCombo,
TDBLookupList, TDBListBox, TDBNavigator, TDBMemo, TDBRadioGroup, TDirectoryListBox, TDrawGrid,
TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TGroupBox, TListBox, TMaskEdit, TMemo,
TNotebook, TOutline, TPanel, TRadioButton, TRichEdit, TScrollBox, TStringGrid, TTrackBar e TTreeView
TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage, TDBLookupCombo,
TDBLookupList, TDBListBox, TDBNavigator, TDBMemo, TDBRadioGroup, TDirectoryListBox, TDrawGrid,
TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TGroupBox, TListBox, TMaskEdit, TMemo,
TNotebook, TOutline, TPanel, TRadioButton, TRichEdit, TScrollBox, TStringGrid, TTrackBar e TTreeView
PARENTFONT
Descrio
A propriedade ParentFont uma varivel do tipo booleana que define se o valor da propriedade Font
do componente atual deve ou no ser igual propriedade Font do seu componente-pai. Se em um
formulrio fizermos a propriedade ParentFont de todos os controles igual a True, isso garantir que
todos os controles inseridos no formulrio usaro o mesmo tipo de fonte na exibio de textos.
Exemplo
Coloque em um formulrio Form1 um boto chamado Button1 e defina, no Object Inspector, sua
propriedade ParentFont como False. Nesse caso, voc pode definir para o boto um estilo de fonte
diferente do adotado pelo formulrio (que o seu componente-pai).
Na fase de projeto:
TBitBtn, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage,
TDBLookupCombo, TDBLookupList, TDBListBox, TDBMemo, TDBRadioGroup, TDBText, TDirectoryListBox,
TDrawGrid, TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TForm, TGroupBox, THeader,
THeaderControl, TListBox, TMaskEdit, TMemo, TNotebook, TOutline, TPaintBox, TPanel,
TRadioButton, TRichEdit, TScrollBox, TSpeedButton, TStatusBar, TStringGrid e TtreeView
TBitBtn, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage,
TDBLookupCombo, TDBLookupList, TDBListBox, TDBMemo, TDBRadioGroup, TDBText, TDirectoryListBox,
TDrawGrid, TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TForm, TGroupBox, THeader,
THeaderControl, TListBox, TMaskEdit, TMemo, TNotebook, TOutline, TPaintBox, TPanel,
TRadioButton, TRichEdit, TScrollBox, TSpeedButton, TStatusBar, TStringGrid e TTreeView
PARENTSHOWHINT
Descrio
A propriedade ParentShowHint uma varivel do tipo booleana que define se o valor da propriedade
ShowHint do controle atual deve ou no ser igual propriedade ShowHint do seu componente-pai.
Seu valor default True, o que indica que, se em um formulrio fizermos a sua propriedade ShowHint
igual a False, e todos os controles nele inseridos tiverem a propriedade ParentShowHint igual a True,
nenhuma string de auxlio ser exibida.
Exemplo
Coloque em um formulrio Form1 um boto chamado Button1 e defina, no Object Inspector, sua
propriedade Hint como Boto e ShowHint como True. Execute o aplicativo e a string de auxlio ser
exibida quando o mouse estiver sobre o boto. Defina a propriedade ParentShowHint de Button1
como True e execute novamente o aplicativo. Nesse caso a string de auxlio no ser exibida.
Na fase de projeto:
Todos os controles.
Todos os controles.
PASSWORDCHAR
Descrio
A propriedade PasswordChar uma varivel do tipo Char que permite a criao de uma caixa de
edio que exiba caracteres especiais em vez do texto digitado.
Exemplo
Voc pode definir o valor da propriedade PasswordChar de um componente diretamente no Object
Inspector, ou mediante uma linha de cdigo:
Edit1.PasswordChar := @;
Definir a propriedade PasswordChar igual a #0 faz com que o texto digitado seja exibido normalmente.
Na fase de projeto:
PEN
Descrio
A propriedade Pen declarada como uma varivel do tipo TPen que define o tipo de caneta a ser usada
pelo componente.
Exemplo
Voc pode alterar as subpropriedades da caneta de um componente diretamente no Object Inspector
(apenas controles do tipo TShape) ou mediante a incluso de uma linha de cdigo como:
Shape1.Pen.Width := 40;
Na fase de projeto:
TShape
TCanvas e TShape
PENPOS
Descrio
A propriedade PenPos declarada como uma varivel do tipo TPoint e define a posio corrente da
caneta no desenho.
TCanvas
PICTURE
Descrio
A propriedade Picture declarada como uma varivel do tipo TPicture que define a imagem a ser
exibida pelo controle.
Exemplo
Voc pode alterar o valor da propriedade Picture de um componente Image1 do tipo TImage diretamente
no Object Inspector ou mediante a incluso de uma linha de cdigo como:
Image1.Picture.LoadFromFile(BITMAP1.BMP);
Na fase de projeto:
TImage
TDBImage e TImage
PICTURECLOSED
Descrio
A propriedade PictureClosed declarada como uma varivel do tipo TBitmap que define a imagem a
ser exibida em um componente do tipo TOutline para representar um item que possui subitens mas
no est expandido.
Exemplo
Voc pode alterar o valor da propriedade PictureClosed de um componente Outline1 do tipo TOutline
diretamente no Object Inspector ou mediante a incluso de uma linha de cdigo como:
Outline1.PictureClosed.LoadFromFile(c:\BITMAP1.BMP);
Na fase de projeto:
TOutline
TOutline
PICTURELEAF
Descrio
A propriedade PictureLeaf declarada como uma varivel do tipo TBitmap que define a imagem a ser
exibida em um componente do tipo TOutline para representar um item que no possui subitens.
Exemplo
Voc pode alterar o valor da propriedade PictureLeaf de um componente Outline1 do tipo TOutline
Outline1.PictureLeaf.LoadFromFile(c:\BITMAP1.BMP);
Na fase de projeto:
TOutline
TOutline
PICTUREMINUS
Descrio
A propriedade PictureMinus declarada como uma varivel do tipo TBitmap que define a imagem a
ser exibida em um componente do tipo TOutline para representar um item que possui subitens e
est expandido.
Exemplo
Voc pode alterar o valor da propriedade PictureMinus de um componente Outline1 do tipo TOutline
Outline1.PictureMinus.LoadFromFile(c:\BITMAP1.BMP);
Na fase de projeto:
TOutline
TOutline
PICTUREOPEN
Descrio
A propriedade PictureOpen declarada como uma varivel do tipo TBitmap que define a imagem a
ser exibida em um componente do tipo TOutline para representar um item que possui subitens e
est expandido.
Exemplo
Voc pode alterar o valor da propriedade PictureOpen de um componente Outline1 do tipo TOutline
Outline1.PictureOpen.LoadFromFile(c:\BITMAP1.BMP);
Na fase de projeto:
TOutline
TOutline
PICTUREPLUS
Descrio
A propriedade PicturePlus declarada como uma varivel do tipo TBitmap que define a imagem a ser
exibida em um componente do tipo TOutline para representar um item que possui subitens mas no
est expandido.
Exemplo
Voc pode alterar o valor da propriedade PicturePlus de um componente Outline1 do tipo TOutline
Outline1.PicturePlus.LoadFromFile(c:\BITMAP1.BMP);
Na fase de projeto:
TOutline
TOutline
PIXELS
Descrio
A propriedade Pixels declarada como uma varivel do tipo TColor e permite que voc acesse
diretamente um pixel no desenho, para ler ou atribuir uma cor. Essa propriedade s est disponvel
Exemplo
Voc pode definir como amarela a cor do pixel nas coordenadas (10,10) com a seguinte linha de cdigo:
Pixels[10,10] := clYellow;
TCanvas
PIXELSPERINCH
Descrio
A propriedade PixelsPerInch declarada como uma varivel inteira que define o nmero de pixels por
polegada em um formulrio, no driver de vdeo corrente.
Exemplo
Voc pode alterar o valor da propriedade PixelsPerInch diretamente no Object Inspector ou mediante
Form1.PixelsPerInch := 80;
Na fase de projeto:
TForm
TForm e TScreen
PLAINTEXT
Descrio
Essa propriedade declarada como uma varivel do tipo booleana que define se o texto ser exibido com
um nico tipo de formatao ou com atributos de formatao distintos. Seu valor default igual a False.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou, durante a execuo
do aplicativo, mediante a incluso de uma linha de cdigo como:
RichEdit1.PlainText:= False;
Na fase de projeto:
TRichEdit
TRichEdit
POPUPCOMPONENT
Descrio
A propriedade PopupComponent declarada como uma varivel do tipo TComponent que define o
ltimo componente selecionado pelo usurio que fez com que o menu Popup representado por esse
controle fosse exibido. Essa propriedade s est disponvel durante a execuo do aplicativo.
TPopupMenu
POPUPMENU
Descrio
A propriedade PopupMenu uma varivel do tipo TPopupMenu que define o nome do menu flutuante
que aparece quando o usurio seleciona um componente e pressiona o boto direito do mouse (desde
que a propriedade AutoPopup do menu flutuante seja igual a True) ou quando se executa o mtodo
Popup do menu flutuante.
Exemplo
Voc pode definir o valor da propriedade PopupMenu de um componente diretamente no Object
Inspector, ou mediante uma linha de cdigo:
Form1.PopupMenu:= PopupMenu1;
Na fase de projeto:
TBitBtn, TButton, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage,
TDBLookupCombo, TDBLookupList, TDBListBox, TDBMemo, TDBNavigator, TDBText, TDBRadioGroup,
TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox, TForm, TGroupBox,
THeaderControl, TImage, TLabel, TListBox, TListView, TMaskEdit, TMemo, TNotebook, TPageControl,
TPanel, TPaintBox, TRadioButton, TRichEdit, TScrollBar, TScrollBox, TStatusBar, TStringGrid,
TTabControl, TTabSheet, TTrackBar e TTreeView
TDBLookupCombo, TDBLookupList, TDBListBox, TDBMemo, TDBNavigator, TDBText, TDBRadioGroup,
TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox, TForm, TGroupBox,
THeaderControl, TImage, TLabel, TListBox, TListView, TMaskEdit, TMemo, TNotebook,
TPageControl, TPanel, TPaintBox, TRadioButton, TRichEdit, TScrollBar, TScrollBox, TStatusBar,
TStringGrid, TTabControl, TTabSheet, TTrackBar e TTreeView
PORT
Descrio
Essa propriedade declarada como uma varivel inteira e identifica a porta pela qual se efetua a conexo
ao servidor.
Na fase de projeto:
TNMDayTime, TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMMSGServ, TNMNNTP, TNMPOP3,
TNMSMTP, TNMSTRM, TNMSTRMServ, TNMTime, TpowerSock
TNMDayTime, TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMMSGServ, TNMNNTP, TNMPOP3,
TNMSMTP, TNMSTRM, TNMSTRMServ, TNMTime, TPowerSock
POSITION
Descrio
Para componentes do tipo TForm, a propriedade Position declarada como uma varivel do tipo TPosition
que define o tamanho e posio de um formulrio, no momento em que ele aparece na sua aplicao.
Para componentes do tipo TMediaPlayer, a propriedade Position declarada como uma varivel do
tipo inteiro longo (Longint) e define a posio atual durante a execuo de um dispositivo multimdia.
Para componentes dos tipos TControlScrollBar e TScrollBar, a propriedade Position declarada como
uma varivel inteira que define a posio atual da caixa de rolagem em uma barra de rolamento.
Para componentes dos tipos TFindDialog e TReplaceDialog, a propriedade Position declarada como
uma varivel do tipo TPoint que define a posio em que o quadro de dilogo exibido na tela.
Para componentes do tipo TProgressBar, a propriedade Position declarada como uma varivel inteira
que define a posio corrente na execuo de uma tarefa.
Para componentes do tipo TTrackBar, a propriedade Position declarada como uma varivel inteira
que define a posio corrente indicada pelo controle.
Para componentes do tipo TUpDown, a propriedade Position declarada como uma varivel inteira
que define a posio corrente indicada pelo controle.
Tabela de Valores Para componentes do Tipo TForm:
Exemplo
Voc pode definir o valor da propriedade Position de um formulrio diretamente no Object Inspector,
ou mediante uma linha de cdigo como:
Form1.Position := poScreenCenter;
Na fase de projeto:
TForm, TMediaPlayer, TControlScrollBar, TProgressBar, TTrackBar, TUpDown e TScrollBar
TForm, TFindDialog, TMediaPlayer, TControlScrollBar, TProgressBar, TTrackBar, TUpDown,
TReplaceDialog e TScrollBar
POSTMESSAGE
Descrio
Essa propriedade declarada como um objeto da classe TPostMessage e contm todas as informaes
referentes mensagem a ser enviada por correio eletrnico.
Na fase de projeto:
TNMSMTP
Valor Significado
poDesigned O formulrio aparece no mesmo tamanho e posio exibidos na fase de projeto.
poDefault O formulrio aparece com o tamanho e posio a serem definidos pelo Delphi.
poDefaultPosOnly O formulrio aparece no mesmo tamanho exibido na fase de projeto, mas a
posio definida pelo Delphi.
poDefaultSizeOnly O formulrio aparece na mesma posio exibida na fase de projeto, mas o
tamanho definido pelo Delphi.
poScreenCenter O formulrio aparece no mesmo tamanho exibido na fase de projeto, mas a
posio sempre no centro da tela.
TNMSMTP
PRECISION
Descrio
A propriedade Precision declarada como uma varivel inteira que define o nmero de casas decimais
a serem exibidas por um campo numrico. Essa propriedade s est disponvel durante a execuo de
um aplicativo.
Exemplo
Voc pode alterar o valor da propriedade Precision mediante uma linha de cdigo como:
FloatField1.Precision := 2;
onde FloatField1 uma varivel do tipo TFloatField.
TBCDField, TCurrencyField e TFloatField
PREPARED
Descrio
Para componentes dos tipos TIBDataset, TIBQuery, TQuery, TDecisionQuery, essa propriedade declarada
como uma varivel booleana e define se foi feita uma chamada ao mtodo Prepare do componente.
Para componentes dos tipos TIBStoredProc, TStoredProc, essa propriedade declarada como uma varivel
booleana e define se foi feita uma otimizao do procedimento armazenado no servidor.
TADOCommand, TADODataset, TADOTable, TADOQuery, TADOStoredProc, TIBStoredProc, TIBDataset,
TIBQuery, TStoredProc e TQuery, TDecisionQuery
PREVIOUSERROR
Descrio
Essa propriedade definida como um a varivel inteira e retorna o cdigo do erro anterior ao que
gerou a exceo. Caso o erro no esteja relacionado ao BDE, ser retornado o valor 0.
EUpdateError
PRINTBEFORE
Descrio
A propriedade PrintBefore declarada como uma varivel booleana que especifica se a tabela secundria
deve ser impressa antes da tabela principal.
Na fase de projeto:
TQRDetailLink
TQRDetailLink
PRINTERINDEX
Descrio
A propriedade PrinterIndex declarada como uma varivel do tipo inteiro e retorna o ndice da
impressora corrente dentre as listadas na propriedade Printers. Essa propriedade s est disponvel
TPrinter
PRINTEROK
Descrio
Essa propriedade declarada como uma varivel booleana e define se um driver de impresso est
instalado. Essa propriedade s est disponvel durante a execuo do aplicativo, e no pode ter o seu
valor alterado pelo usurio.
TQRPrinter
PRINTERS
Descrio
A propriedade Printers declarada como uma varivel do tipo TStrings, e consiste em uma lista de
strings que identificam todas as impressoras instaladas pelo Windows. Essa propriedade s est disponvel
Exemplo
Voc pode exibir os nomes de todas as impressoras instaladas em um componente ListBox1 do Tipo
TListBox mediante a incluso da seguinte linha de cdigo:
ListBox1.Items := Printer1.Printers;
TPrinter
PRINTING
Descrio
A propriedade Printing declarada como uma varivel do tipo booleana e indica se o sistema est
executando um trabalho de impresso. Essa propriedade s est disponvel durante a execuo do
Para componentes TChart e TDBChart, essa propriedade indica se o grfico exibido no componente
est sendo impresso.
TChart, TDBChart e TPrinter
PRINTMASK
Descrio
A propriedade PrintMask declarada como uma varivel do tipo String e define um formato para a
exibio do valor armazenado no componente. A formatao ser a mesma usada na funo FormatFloat.
Na fase de projeto:
TQRDBCalc
TQRDBCalc
PRINTRANGE
Descrio
A varivel PrintRange declarada como uma varivel do tipo TPrintRange que define o tipo de faixa de
pginas a ser usado durante uma impresso.
Tabela de Valores:
Valor Significado
prAllPages Todas as pginas so impressas.
prSelection Imprime apenas o texto ou objeto selecionado.
prPageNums Permite que o usurio selecione as pginas a serem impressas.
Exemplo
Voc pode definir o valor da propriedade PrintRange diretamente no Object Inspector, ou mediante
PrintDialog1.PrintRange := prAllPages;
Na fase de projeto:
TPrintDialog
TPrintDialog
PRINTSCALE
Descrio
A varivel PrintScale declarada como uma varivel do tipo TPrintScale que define as propores de
um formulrio impresso.
Tabela de Valores:
Exemplo
Voc pode definir o valor da propriedade PrintScale de um formulrio diretamente no Object Inspec-
tor ou mediante uma linha de cdigo como:
Form1.PrintScale := poNone;
Na fase de projeto:
TForm
TForm
PRINTTOFILE
Descrio
A propriedade PrintToFile declarada como uma varivel booleana que define se a impresso deve ser
dirigida para um arquivo.
Exemplo
PrintDialog1.PrintToFile := False;
Na fase de projeto:
TPrintDialog
TPrintDialog
PRIVATEDIR
Descrio
Essa propriedade declarada como uma varivel do tipo string e indica o diretrio no qual os arquivos
temporrios devem ser armazenados. Essa propriedade s est disponvel durante a execuo do aplicativo.
Valor Significado
poNone Nesse caso, o formulrio impresso praticamente como aparece na tela,
podendo haver pequenos ajustes.
poProportional O formulrio impresso com o mesmo tamanho que aparece na tela (com o
mesmo nmero de pixels por polegada).
poPrintToFit As dimenses do formulrio mantm a mesma proporo, mas so alteradas
por um fator de escala, de forma a preencher a pgina a ser impressa.
TSession
PROBLEMCOUNT
Descrio
A propriedade ProblemCount declarada como uma varivel do tipo inteiro longo (Longint) que define
o nmero de registros que no foram adicionados tabela-destino devido a algum erro no processamento
do mtodo Execute de um componente do tipo TBatchMove. Essa propriedade s est disponvel du-
rante a execuo do aplicativo e no pode ter o seu valor diretamente alterado pelo usurio.
Exemplo
O trecho de cdigo a seguir faz com que um controle chamado Label1 do tipo Tlabel exiba o valor da
propriedade ProblemCount de um componente do tipo TBatchMove:
Label1.Caption := IntToStr(BatchMove1.ProblemCount);
TBatchMove
PROBLEMTABLENAME
Descrio
A propriedade ProblemTableName declarada como uma varivel do tipo TFileName que armazena os
registros que no puderam ser movidos devido a um erro em uma operao realizada por um componente
do tipo TBatchMove.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou por meio
BatchMove1.ProblemTableName := registro.db;
Na fase de projeto:
TBatchMove
TBatchMove
PROCEDURENAME
Descrio
Essa propriedade declarada como uma varivel do tipo string que define o nome do procedimento a ser
executado em um servidor de banco de dados acessado atravs do mecanismo Activex Data Objects.
Na fase de projeto:
TADOStoredProc
TADOStoredProc
PROJECTFILE
Descrio
Essa propriedade declarada como uma varivel do tipo string que define o nome do arquivo de
projeto de relatrio criado com o Rave Reports, com a extenso .RAV.
Na fase de projeto:
TRvProject
TRvProject
PROVIDER
Descrio
A propriedade Provider especifica a interface do tipo IProvider por meio da qual esse componente se
comunica com um componente TProvider.
TClientDataset
PROVIDERNAME
Descrio
A propriedade Provider declarada como uma varivel do tipo string e define o nome do componente
TProvider por meio do qual feita a comunicao com o servidor.
TClientDataset
QDELETE
Descrio
Essa propriedade declarada como um objeto da classe TIBSQL, e permite acessar diretamente o objeto
que armazena o comando SQL para excluso de registros.
Na fase de projeto:
TIBDataset
TIBDataset
QINSERT
Descrio
que armazena o comando SQL para incluso de registros.
Na fase de projeto:
TIBDataset
TIBDataset
QMODIFY
Descrio
que armazena o comando SQL para atualizao de registros.
Na fase de projeto:
TIBDataset
TIBDataset
QREFRESH
Descrio
que armazena o comando SQL para atualizar a exibio de registros.
Na fase de projeto:
TIBDataset
TIBDataset
QSELECT
Descrio
que armazena o comando SQL para exibio de registros.
Na fase de projeto:
TIBDataset
TIBDataset
QUERY
Descrio
Para componentes dos tipos TIBUpdateSQL e TUpdateSQL essa propriedade retorna um componente
do tipo TQuery, correspondente declarao SQL cujo ndice igual a UpdateKind. UpdateKind pode
ser igual a ukModify, ukDelete ou ukInsert. Essa propriedade s est disponvel durante a execuo do
Para componentes do tipo TRvQueryConnection, essa propriedade define o componente do tipo TQuery
ao qual est vinculado.
Na fase de projeto:
TRvQueryConnection
TIBUpdateSQL, TRvQueryConnection, TUpdateSQL
QUEUED
Descrio
A propriedade Queued declarada como uma varivel booleana que indica se h evento pendentes.
Na fase de projeto:
TIBEvents
TIBEvents
READONLY
Descrio
TCurrencyField, TDateField, TDateTimeField, TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid,
TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TFloatField, TGraphicField, TIntegerField,
TMemoField, TSmallintField, TStringField, TTimeField, TVarBytesField, TWordField, TDBMemo,
TDBRadioGroup, TEdit, TMaskEdit e TMemo a propriedade ReadOnly uma varivel booleana que
define se o usurio pode alterar o valor exibido por um controle. No caso de controles correspondentes
a bancos de dados, especifica se o usurio pode alterar o valor armazenado em um campo de um
registro; em componentes do tipo TDBGrid, define se o usurio pode inserir linhas e colunas; em
componentes do tipo TTable, define se o usurio pode alterar o contedo de uma tabela.
Exemplo
Voc pode definir o valor da propriedade ReadOnly de um componente diretamente no Object Inspec-
tor ou mediante uma linha de cdigo:
DBEdit1.ReadOnly:= True;
Na fase de projeto:
TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo,
TDBLookupList, TDBMemo, TDBRadioGroup, TEdit, TMaskEdit, TMemo, TADOTable, TClientDataset,
TIBTable e TTable
TDBCheckBox, TDBComboBox, TDBEdit, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList,
TDBMemo, TDBRadioGroup, TEdit, TMaskEdit, TMemo, TClientDataset, TADOTable, TClientDataset,
TIBTable, TTable, TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField,
TCurrencyField, TDateField, TDateTimeField, TFloatField, TGraphicField, TIntegerField,
TMemoField, TSmallintField, TStringField, TTimeField, TVarBytesField, TWordField
RECORDCOUNT
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro longo e especifica o nmero de registros
do banco de dados associado. Essa propriedade s est disponvel durante a execuo do aplicativo.
RECNO
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro longo e especifica o registro corrente
do banco de dados associado. Essa propriedade s est disponvel durante a execuo do aplicativo.
RECORDSIZE
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro longo e especifica o tamanho em bytes
de um registro da tabela associada ao componente. Essa propriedade s est disponvel durante a
RDSCONNECTION
Descrio
Essa propriedade declarada como um objeto da classe TRDSConnection, e indica o componente
atravs do qual ser feita a conexo atravs do mecanismo Activex Data Objects.
Na fase de projeto:
TADODataset
TADODataset
REFRESHSQL
Descrio
Essa propriedade armazena uma lista de strings contendo a declarao SQL usada para atualizar o
resultado de uma declarao SQL.
Na fase de projeto:
TIBDataset, TIBUpdateSQL
REGISTERED
Descrio
A propriedade Queued declarada como uma varivel booleana que indica se o evento definido pelo
componente foi registrado.
Na fase de projeto:
TIBEvents
TIBEvents
REMOTESERVER
Descrio
A propriedade RemoteServer define o componente de conexo por meio da qual feita a comunicao
com a aplicao servidora.
TClientDataset
REPETITIONS
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro e define o nmero de execues
contnuas do clipe de vdeo exibido pelo componente. Atribuir o valor 0 a essa propriedade faz com
que o clipe seja executado continuamente, at que se atribua o valor False sua propriedade Active.
TAnimate
REPLACETEXT
Descrio
A propriedade ReplaceText declarada como uma varivel do tipo string e contm o texto que substituir
aquele a ser pesquisado na aplicao.
Exemplo
Voc pode definir o valor dessa propriedade diretamente no Object Inspector ou mediante a incluso
ReplaceDialog1.ReplaceText := Texto substituto;
Na fase de projeto:
TReplaceDialog
TReplaceDialog
REPORTTITLE
Descrio
Essa propriedade declarada como uma varivel do tipo string e define o ttulo exibido no gerenciador
de impresso do Windows quando o relatrio impresso.
Na fase de projeto:
TQuickReport
TQuickReport
REPORTTYPE
Descrio
Essa propriedade declarada como um conjunto que pode assumir um dos valores citados na tabela a
seguir e define o tipo de relatrio gerado pelo componente. Essa propriedade s est disponvel du-
rante a execuo do aplicativo.
Tabela de Valores:
Valor Significado
qrStandard Gera um relatrio padro, a partir do banco de dados associado a
um componente do tipo TTable ou TQuery, TDecisionQuery.
qrMasterDetail Gera um relatrio do tipo Formulrio principal/Formulrio
secundrio, usando componentes do tipo TQRDetailLink.
TQuickReport
REQUESTURL
Descrio
Essa propriedade declarada como uma varivel do tipo string e define a URL do documento carregado
no Browser representado pelo componente.
THTML
REQUIRED
Descrio
A propriedade Required uma varivel booleana que define se um campo deve ter obrigatoriamente
um valor no-nulo. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode alterar o valor dessa propriedade mediante uma linha de cdigo como:
if FloatField1.Required = True then ShowMessage(Requer valor no-nulo);
onde FloatField1 uma varivel do tipo TFloatField.
TDateTimeField, TFieldDef, TFloatField, TGraphicField, TIntegerField, TMemoField,
RESETGROUP
Descrio
A propriedade ResetGroup declarada como uma varivel do tipo TQRBand e define se o componente
ser reinicializado aps a impresso do valor definido na sua propriedade ResetBand.
Na fase de projeto:
TQRDBCalc
TQRDBCalc
RESHANDLE
Descrio
Essa propriedade declarada como uma varivel do tipo THandle (que , na realidade, um inteiro) e
retorna um Handle do Windows para o mdulo que armazena o clipe de vdeo exibido pelo componente.
TAnimate
RESID
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro e define o recurso do Windows que
armazena o clipe de vdeo exibido pelo componente.
TAnimate
RESNAME
Descrio
Essa propriedade declarada como uma varivel do tipo string e define o nome do arquivo de recurso
do Windows que armazena o clipe de vdeo exibido pelo componente.
TAnimate
RESTARTDATA
Descrio
Essa propriedade declarada como uma varivel booleana e define se a impresso deve ser iniciada no
primeiro registro (True) ou no registro corrente (False).
Exemplo
QuickReport1.RestartData:= True;
Na fase de projeto:
TQuickReport
TQuickReport
RIGHTAXIS
Descrio
A propriedade RightAxis declarada como um objeto da classe TChartAxis e representa o eixo vertical
direito do grfico exibido no componente.
Na fase de projeto:
TChart, TDBChart
TChart, TDBChart
ROW
Descrio
A propriedade Row declarada como uma varivel do tipo inteiro longo (Longint) que define a que linha
pertence a clula que possui o foco. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
linha que possui o foco em um componente StringGrid1 do tipo TStringGrid quando o usurio seleciona
begin
Label1.Caption := Linha + IntToStr(StringGrid1.Row + 1);
end;
TDrawGrid, TOutline e TStringGrid
ROWCOUNT
Descrio
Para componentes dos tipos TDrawGrid, TIWDBGrid e TStringGrid, essa propriedade declarada como
uma varivel do tipo inteiro longo (Longint) que define o nmero de linhas do controle.
Para esses componentes, essa propriedade s est disponvel durante a execuo do aplicativo.
Para componentes dos tipos TDBCtrlGrid e TDecisionGrid, essa propriedade declarada como uma
varivel do tipo inteiro que define o nmero de linhas do controle. Essa propriedade s est disponvel
Para componentes dos tipos TDBLookupListBox e TIWDBLookupListBox, essa propriedade declarada
como uma varivel do tipo inteiro que define o nmero de linhas exibidas pelo controle.
Exemplo
nmero de linhas de um componente StringGrid1 do tipo TStringGrid quando o usurio seleciona
begin
Label1.Caption:= IntToStr(StringGrid1.RowCpunt);
end;
Na fase de projeto:
TDBLookupListBox, TDecisionGrid, TIWDBGrid, TIWDBLookupListBox e TDBCtrlGrid
TDBLookupListBox, TDecisionGrid, TIWDBGrid, TIWDBLookupListBox e TDBCtrlGrid
ROWHEIGHTS
Descrio
A propriedade RowHeights declarada com uma array de inteiros, no qual cada item da array define a
altura, em pixels, das clulas da linha especificada pelo ndice. Essa propriedade s est disponvel
Exemplo
altura das clulas da primeira linha de um componente StringGrid1 do tipo TStringGrid quando o
usurio seleciona uma clula com o mouse.
begin
Label1.Caption := IntToStr(StringGrid1.RowHeights[0]);
end;
ROWS
Descrio
A propriedade Rows declarada como uma array de listas de strings, no qual cada lista armazena as
strings das clulas de uma linha da grade. O ndice da array define o nmero da linha a ser acessada,
comeando com 0. Na realidade, cada linha tratada como uma lista de strings. Essa propriedade s
Exemplo
A linha de cdigo a seguir adiciona a string Nova string lista de strings correspondente terceira
linha de um componente chamado StringGrid1, do tipo TStringGrid:
StringGrid1.Rows[2].Add(Nova string);
TStringGrid
ROWSAFFECTED
Descrio
Esta propriedade declarada como uma varivel SQL e retorna o nmero de registros afetados por uma
declarao SQL
TADOCommand, TADODataset, TADOTable, TADOQuery, TADOStoredproc
RULER
Descrio
Essa propriedade declarada como uma varivel do tipo TQRRuler e permite que se exiba, na fase de projeto,
uma rgua em um componente do tipo TQRBand para facilitar o posicionamento de outros componentes.
Tabela de Valores:
Na fase de projeto:
TQRBand
TQRBand
SCALED
Descrio
A propriedade Scaled declarada como uma varivel booleana que determina se o formulrio deve
ser multiplicado por um fator de escala, de forma a que o valor definido na propriedade PixelsPerInch
seja satisfeito.
Exemplo
Voc pode definir o valor da propriedade Scaled de um formulrio diretamente no Object Inspector ou
mediante uma linha de cdigo como:
Form1.Scaled := True;
Na fase de projeto:
TForm
TForm
SCROLLBARS
Descrio
A propriedade ScrollBars declarada como uma varivel do tipo TScrollStyle que define se o controle
possui ou no barras de rolamento.
Valor Significado
qrrNone Nenhuma rgua ser exibida.
qrrInchesH Rgua horizontal graduada em polegadas.
qrrInchesV Rgua vertical graduada em polegadas.
qrrInchesHV Rguas horizontal e vertical graduadas em polegadas.
qrrCmH Rgua horizontal graduada em centmetros.
qrrCmV Rgua vertical graduada em centmetros.
qrrCmHV Rguas horizontal e vertical graduadas em centmetros.
Tabela de Valores:
Exemplo
Voc pode definir o valor da propriedade ScrollBars de um componente diretamente no Object Inspec-
DBMemo1.ScrollBars:= ssBoth;
Na fase de projeto
TDBMemo, TDrawGrid, TMemo, TOutline, TRichEdit e TStringGrid
TDBMemo, TDrawGrid, TMemo, TOutline, TRichEdit e TStringGrid
SCROLLPOS
Descrio
Essa propriedade declarada como uma varivel inteira e armazena o valor corrente da propriedade
Position. Essa propriedade s est disponvel durante a execuo do aplicativo, e no pode ter o seu
Exemplo
O trecho de cdigo a seguir exibe o valor da propriedade ScrollPos de um objeto ControlScrollBar1, do
tipo TControlScrollBar:
ShowMessage(IntToStr(ControlScrollBar1.ScrollPos);
TControlScrollBar
SECTIONS
Descrio
Para controles do tipo THeader, a propriedade Sections declarada como uma varivel do tipo TStrings que
associa, mediante uma lista de strings, um texto a cada uma das sees de um componente do tipo THeader.
Para controles do tipo THeaderControl, essa propriedade usada na insero de uma nova seo.
Exemplo
Voc pode definir essa propriedade diretamente no Object Inspector com o String List Editor. Nesse
caso, a primeira linha ser o texto exibido pela a primeira seo (a da esquerda), a segunda linha ser o
texto exibido pela segunda seo (a segunda, da esquerda para a direita) e assim por diante.
Valor Significado
ssNone Nenhuma barra de rolamento.
ssHorizontal Barra de rolamento horizontal na base do controle.
ssVertical Barra de rolamento vertical do lado direito do controle.
ssBoth Barras de rolamento horizontal e vertical.
O trecho de cdigo a seguir altera o texto da primeira seo de um controle Header1 do tipo THeader
quando o usurio d um clique com o mouse sobre um formulrio chamado Form1:
var
NovaHints: TStringList;
begin
NovaHints:= TStringList.Create;
NovaHints.Add(Texto da primeira seo);
Header1.Hints:= NovaHints;
end;
Na fase de projeto:
THeader e THeaderControl
THeader e THeaderControl
SECTIONWIDTH
Descrio
A propriedade SectionWidth declarada com uma array de inteiros, no qual cada item da array define
a largura, em pixels, de uma seo de um componente do tipo THeader. Essa propriedade s est
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Edit1 do tipo TEdit informe a
largura da primeira seo de um componente Header1 do tipo THeader quando o usurio seleciona
um boto chamado Button1 do tipo TButton.
begin
Edit1.Text := IntToStr(Header1.SectionWidth[0]);
end;
THeader
SELCOUNT
Descrio
A propriedade SelCount uma varivel inteira que especifica o nmero de itens selecionados no controle
quando a sua propriedade MultiSelect True. Essa propriedade s est disponvel durante a execuo
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Label1 do tipo TLabel exiba o
nmero de itens selecionados em um componente ListBox1 do tipo TListBox quando o usurio clicar
com o mouse sobre Label1:
procedure TForm1.Label1Click(Sender: TObject);
begin
Label1.Caption := IntToStr(ListBox1.SelCount);
end;
SELECTED
Descrio
A propriedade Selected declarada como uma array de variveis booleanas que informa se um item de
um controle est selecionado. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Label1 do tipo TLabel informe se
o primeiro item em um componente ListBox1 do tipo TListBox est selecionado quando o usurio
clicar com o mouse sobre Label1:
procedure TForm1.Label1Click(Sender: TObject);
begin
if ListBox1.Selected[0] = True then Label1.Caption:= Primeiro Item Selecionado;
end;
TDBListBox, TDirectoryListBox, TFileListBox, TTreeView, TListView e TListBox
SELECTEDCOLOR
Descrio
A propriedade SelectedColor declarada como uma varivel do tipo TColor e define a cor da guia
selecionada em um componente do tipo TTabSet.
Exemplo
Voc pode alterar a propriedade SelectedColor de um componente diretamente no Object Inspector
ou por meio de uma linha de cdigo, como:
TabSet1. SelectedColor := clRed;
Na fase de projeto:
TTabSet
TTabSet
SELECTEDFIELD
Descrio
A propriedade SelectedField declarada como uma varivel do tipo TField que indica o campo do
banco de dados selecionado pelo componente. Essa propriedade s est disponvel durante a execuo
Exemplo
Voc pode usar um componente chamado Label1 do tipo TLabel para exibir o nome do campo
selecionado em um componente DBGrid1 do tipo TDBGrid, com a seguinte linha de cdigo:
Label1.Caption := DBGrid1.SelectedField.FieldName;
TDBGrid e TDBLookupList
SELECTEDINDEX
Descrio
A propriedade SelectedIndex uma varivel inteira que indica o ndice do campo do banco de dados
selecionado pelo componente. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode usar um componente chamado Label1 do tipo TLabel para exibir o ndice do campo
selecionado em um componente DBGrid1 do tipo TDBGrid, com a seguinte linha
de cdigo:
Label1.Caption := IntToStr(DBGrid1.SelectedIndex);
TDBGrid e TDBLookupList
SELECTEDITEM
Descrio
A propriedade SelectedItem uma varivel do tipo inteiro longo (Longint) que indica o item que
possui o foco em um componente do tipo TOutline. Essa propriedade s est disponvel durante a
execuo de um aplicativo.
Exemplo
Voc pode usar um componente chamado Label1 do tipo TLabel para exibir o nmero do item que
possui o foco em um componente do tipo TOutline com a seguinte linha de cdigo:
Label1.Caption := IntToStr(Outline1.SelectedItem);
TOutline
SELECTION
Descrio
A propriedade Selection declarada como uma varivel do tipo TGridRect que contm as coordenadas
da(s) linha(s) e coluna(s) da(s) clula(s) selecionadas na grade.
Exemplo
O trecho de cdigo a seguir seleciona as clulas contidas nas linhas 1 e 2 e nas colunas 3 e 4:
var
SRect: TGridRect;
begin
SRect.Top := 1;
SRect.Left := 3;
SRect.Bottom := 2;
SRect.Right := 4;
StringGrid1.Selection := SRect;
end;
TDBGrid e TStringGrid
SELECTSQL
Descrio
Essa propriedade armazena uma lista de strings contendo a declarao SQL usada para exibir o resultado
de uma declarao SQL.
Na fase de projeto:
SELEND
Descrio
Essa propriedade declarada como uma varivel inteira que define o valor final da faixa de valores do componente.
Exemplo
Voc pode definir o valor dessa propriedade diretamente no Object Inspector ou mediante uma linha
de cdigo como:
TrackBar1.SelEnd:= 100;
Na fase de projeto:
TTrackBar
TTrackBar
SELLENGTH
Descrio
A propriedade SelLength uma varivel inteira que retorna o comprimento (em caracteres) do texto
selecionado no componente.
Exemplo
Voc pode atribuir o valor da propriedade SelLength de um componente a uma varivel inteira a
com a seguinte linha de cdigo:
a := Edit1.SelLength;
TComboBox, TDBComboBox, TDBEdit, TDBMemo, TDriveComboBox, TEdit, TFilterComboBox, TMaskEdit e TMemo
SELSTART
Descrio
Para componentes dos tipos TComboBox, TDBComboBox, TDBEdit, TDBMemo, TDriveComboBox, TEdit,
TFilterComboBox, TMaskEdit e TMemo, a propriedade SelStart uma varivel inteira que retorna a posio
inicial da parte selecionada do texto de um controle, em que o primeiro caractere do texto do controle ocupa
uma posio cujo valor igual a 0. Essa propriedade s est disponvel durante a execuo do aplicativo.
Para componentes do tipo TTrackBar, essa propriedade declarada como uma varivel inteira que
define o valor inicial da faixa de valores do componente.
Exemplo
Voc pode atribuir o valor da propriedade SelStart do texto selecionado de um componente a uma
varivel inteira a com a seguinte linha de cdigo:
a:= Edit1.SellStart;
Na fase de projeto:
TTrackBar
TTrackBar, TComboBox, TDBComboBox, TDBEdit, TDBMemo, TDriveComboBox, TEdit, TFilterComboBox,
TMaskEdit e TMemo
SELTEXT
Descrio
A propriedade SelText uma varivel do tipo string que contm a poro de texto do controle que se
encontra selecionada. Voc pode substituir o texto selecionado atribuindo uma string varivel SelText.
Exemplo
Voc pode atribuir o texto selecionado em um componente propriedade Caption de um componente
Label1 do tipo TLabel da seguinte forma:
procedure TForm1.Edit1MouseUp(Sender: TObject; Button: TMouseButton; Shift: TShiftState; X, Y: Integer);
begin
Label1.Caption := Edit1.SelText;
end;
TComboBox, TDBComboBox, TDBEdit, TDriveComboBox, TEdit, TFilterComboBox e TMaskEdit
SERIES
Descrio
Essa propriedade declarada como uma array de objetos da classe TChartSeries e referencia todas as
sries definidas para o grfico exibido no componente.
Na fase de projeto:
TChart, TDBChart
TChart, TDBChart
SERIESCOLOR
Descrio
A propriedade SelectedColor declarada como uma varivel do tipo TColor e define a cor default dos
pontos da srie representada pelo objeto.
Na fase de projeto:
TChartSeries
TChartSeries
SERVERCONV
Descrio
A propriedade ServerConv declarada como uma varivel do tipo TDDEServerConv e define o
componente do tipo TDDEServerConv ao qual esse item est associado em uma conversao DDE.
Exemplo
Voc pode alterar o valor da propriedade ServerConv de um componente diretamente no Object In-
spector ou por meio de uma linha de cdigo, como:
DDEServerItem1. ServerConv := DDEServerConv1
Na fase de projeto:
TDDEServerConv
TDDEServerConv
SERVICEAPPLICATION
Descrio
A propriedade ServiceApplication declarada como uma varivel do tipo string que define o nome do
arquivo executvel (sem a extenso .EXE) da aplicao servidora.
Exemplo
Voc pode alterar o valor da propriedade ServiceApplication de um componente diretamente no Ob-
ject Inspector ou por meio de uma linha de cdigo, como:
DdeClientConv1. ServiceApplication := Programa;
Na fase de projeto:
TDDEClientConv
TDDEClientConv
SHAPE
Descrio
A propriedade Shape uma varivel que define o formato geomtrico de um componente. No caso de
um componente do tipo TBevel, uma varivel do tipo TBevelShape, enquanto que no caso de um
componente do tipo TShape, do tipo TShapeType.
Tabela de Valores para componentes do tipo TBevel.
Nesse caso, a propriedade uma varivel do tipo TBevelShape.
Tabela de Valores para componentes do tipo TShape.
Nesse caso, a propriedade uma varivel do tipo TShapeType.
Valor Significado
bsBox O chanfro assume a forma de uma caixa.
bsFrame O chanfro assume a forma de um quadro.
bsTopLine O chanfro se apresenta como uma linha no topo do controle.
bsBottomLine O chanfro se apresenta como uma linha na base do controle.
bsLeftLine O chanfro se apresenta como uma linha na lateral esquerda do controle.
bsRightLine O chanfro se apresenta como uma linha na lateral direita do controle.
Exemplo
Voc pode alterar a propriedade Shape de um componente Bevel1 do tipo TBevel com a seguinte
linha de cdigo:
Bevel1.Shape := bsFrame;
Na fase de projeto:
TBevel e TShape
Valor Significado
stEllipse O componente tem o formato de uma elipse.
stRectangle O componente tem o formato de um retngulo.
stRoundRect O componente tem o formato de um retngulo com cantos arredondados.
stRoundSquare O componente tem o formato de um quadrado com cantos arredondados.
stSquare O componente tem o formato de um quadrado.
stCircle O componente tem o formato de um crculo.
TBevel e TShape
SHARABLE
Descrio
A propriedade Sharable declarada como uma varivel booleana que determina se mais de um aplicativo
pode compartilhar um dispositivo multimdia.
Exemplo
Voc pode definir o valor da propriedade Sharable diretamente no Object Inspector ou mediante uma
MediaPlayer1.Sharable := True;
Na fase de projeto:
TMediaPlayer
TMediaPlayer
SHAREIMAGES
Descrio
Essa propriedade declarada como uma varivel do tipo booleana e indica se o controle destri o seu
handle quando a lista de imagens destruda.
Na fase de projeto:
TImageList
TImageList
SHORTCUT
Descrio
A propriedade ShortCut consiste em uma seqncia de teclas que permite que um usurio acesse
rapidamente um item de menu.
Para objetos da classe TAction, define a propriedade ShortCut dos itens de menu associados ao controle.
Exemplo
Voc pode definir o valor da propriedade ShortCut diretamente no Object Inspector ou mediante uma
MenuItem1.ShortCut := ShortCut(Word(C), [ssCtrl]);
Na fase de projeto:
TAction, TMenuItem
TAction, TMenuItem
SHOWACCELCHAR
Descrio
A propriedade ShowAccelChar uma varivel do tipo booleana que define se um caractere &
deve ser utilizado para sublinhar a tecla aceleradora do componente ou ser realmente utilizado
como o caractere & .
Exemplo
Label1.ShowAccelChar := True;
Na fase de projeto:
TLabel
TLabel
SHOWBUTTONS
Descrio
Essa propriedade declarada como uma varivel do tipo booleana e indica se o controle deve exibir os
sinais (+) e (-) esquerda de cada item que possui uma lista de subitens. Esses botes, se exibidos,
podem ser usados pelo usurio para exibir ou ocultar uma lista de subitens.
Na fase de projeto:
TTreeView
TTreeView
SHOWCOLUMNHEADERS
Descrio
Essa propriedade declarada como uma varivel booleana e define se os cabealhos das colunas do
controle devem ser exibidos.
Na fase de projeto:
TListView
TListView
SHOWFOCUS
Descrio
Essa propriedade declarada como uma varivel booleana que define se um retngulo de foco deve ser
desenhado no painel que exibe o registro corrente.
Exemplo
DBCtrlGrid1.ShowFocus:= True;
Na fase de projeto:
TDBCtrlGrid
TDBCtrlGrid
SHOWHINT
Descrio
A propriedade ShowHint uma varivel do tipo booleana que define se uma string de auxlio deve ou
no ser exibida quando o usurio mantm o ponteiro do mouse sobre um controle. No caso de um
componente do tipo TApplication, essa propriedade definida apenas durante a execuo do aplicativo;
se o seu valor for False, nenhuma string de auxlio ser exibida durante a execuo do aplicativo, ainda
que a propriedade ShowHint de todos os controles seja igual a True.
Exemplo
Coloque, em um formulrio chamado Form1, um boto chamado Button1 e defina, no Object Inspec-
tor, sua propriedade Hint como Boto e ShowHint como True. Execute o aplicativo e a string de auxlio
ser exibida quando o mouse estiver sobre o boto. No arquivo de projeto, inclua a seguinte linha de
cdigo, antes de Application.Run:
Application.ShowHint := False;
Execute novamente o aplicativo. Nesse caso a string de auxlio no ser exibida.
Na fase de projeto:
Todos os controles.
Todos os controles e os componentes do tipo TApplication.
SHOWING
Descrio
A propriedade Showing uma varivel do tipo booleana que especifica se um componente est ou no
sendo exibido na tela. Se um componente-pai do componente atual tiver a sua propriedade Visible
igual a False, ento sua propriedade Showing ter o valor False. Essa propriedade s pode ser acessada
Exemplo
Se um formulrio estiver visvel, voc pode ocult-lo com a seguinte linha de cdigo:
Visible := not Showing;
Todos os controles.
SHAREINLEGEND
Descrio
Essa propriedade declarada como uma varivel do tipo booleana e define se a legenda da srie deve
ser exibida no componente Chart associado.
Na fase de projeto:
TChartSeries
TChartSeries
SHOWLINES
Descrio
Essa propriedade declarada como uma varivel booleana que define se o controle deve exibir linhas
conectando itens ao seu componente-pai.
Exemplo
TreeView1.ShowLines:= True;
Na fase de projeto:
TTreeView
TTreeView
SHOWPROGRESS
Descrio
Essa propriedade declarada como uma varivel booleana e define se uma caixa de dilogo com uma
barra, que indica o progresso da tarefa de impresso do relatrio, deve ser exibida.
Exemplo
QuickReport1.ShowProgress:= True;
TQuickReport e TQRPrinter
Na fase de projeto:
SHOWROOT
Descrio
Essa propriedade declarada como uma varivel booleana que define se o controle deve exibir linhas
conectando itens ao componente-raiz.
Exemplo
TreeView1.ShowRoot:= True;
Na fase de projeto:
TTreeView
TTreeView
SIMPLEPANEL
Descrio
Essa propriedade declarada como uma varivel booleana e define se a barra de status exibe um nico
painel ou mltiplos painis.
Na fase de projeto:
TStatusBar
TStatusBar
SIMPLETEXT
Descrio
Essa propriedade declarada como uma varivel do tipo string e define o texto exibido na barra de
status quando o valor da propriedade SimplePanel igual a True.
Na fase de projeto:
TStatusBar
TStatusBar
SIZE
Descrio
Para componentes do tipo TStringField, essa propriedade define o nmero de Bytes reservado para o campo.
Para componentes do tipo TBCDField, essa propriedade define o nmero de dgitos aps o ponto
decimal.
Para componentes dos tipos TAutoIncField, TFieldDef, TBlobField, TBytesField, TVarBytesField,
TMemoField e TGraphicField, define o espao que o campo ocupa quando armazenado em uma tabela.
TAutoIncField, TBCDField, TBlobField, TBytesField, TFieldDef, TGraphicField, TIntegerField,
TMemoField, TStringField, TTimeField e TVarBytesField
SMALLCHANGE
Descrio
A propriedade SmallChange declarada como uma varivel do tipo TScrollBarInc que define quantas
posies devem ser deslocadas na barra de rolagem quando o usurio d um clique nas setas situadas
nas extremidades da barra de rolagem ou pressiona as teclas de seta.
Exemplo
ScrollBar1.SmallChange := 10
Na fase de projeto:
TScrollBar
TScrollBar
SMALLIMAGES
Descrio
Essa propriedade define as imagens exibidas pelo componente quando a sua propriedade ViewStyle
possui o valor vsSmallIcon.
TListView
SORTED
Descrio
A propriedade Sorted uma varivel booleana que define se os itens de um componente dos tipos
TComboBox, TIWComboBox, TIWListBox ou TListBox estaro alfabeticamente ordenados. Se quiser
ordenar alfabeticamente os itens do controle, basta atribuir o valor True sua propriedade Sorted.
Quando voc adiciona ou insere itens a um controle cuja propriedade Sorted True, o Delphi os coloca
automaticamente na posio correta.
Exemplo
Voc pode alterar a propriedade Sorted de um componente diretamente no Object Inspector ou incluindo
ListBox1Sorted:= True;
Na fase de projeto:
TComboBox, TDBComboBox, TDBListBox, TIWComboBox, TIWDBComboBox, TIWDBListBox e TListBox
TComboBox, TDBComboBox, TDBListBox, TIWComboBox, TIWDBComboBox, TIWDBListBox, TListBox e TStringList
SORTTYPE
Descrio
A propriedade SortType declarada como uma varivel do tipo TSortType que define quando e como
uma lista de itens deve ser ordenada.
Tabela de Valores:
Exemplo
Voc pode definir o valor da propriedade ScrollBars de um componente diretamente no Object Inspec-
TreeView1.SortType:= nsBoth;
Na fase de projeto:
TTreeView e TListView
TTreeView e TListView
SOURCE
Descrio
Para componentes do tipo TBatchMove, a propriedade Source declarada como uma varivel do tipo
TDatasSet (TTable ou TQuery, TDecisionQuery) que especifica o componente ao qual est associada a
tabela-origem em uma operao realizada por um componente do tipo TBatchMove.
Valor Significado
nsNone Nenhuma reordenao.
nsData Os itens so reordenados quando um objeto de dados alterado.
nsText Os itens so reordenados quando um rtulo alterado.
nsBoth Os itens so reordenados quando um objeto de dados ou um rtulo alterado.
Para componentes do tipo EOLEException, a propriedade Source declarada como uma varivel do
tipo string e retorna o nome da aplicao que gerou a exceo.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou por meio de uma
BatchMove1.Source := Table1;
Na fase de projeto:
TBatchMove
EoleException, TBatchMove
SPACING
Descrio
A propriedade Spacing declarada como uma varivel inteira que define a distncia, em pixels, entre
a imagem grfica (definida na propriedade Glyph) e o texto (definido na propriedade Caption). Se for
igual a 0, no haver espao, e se for igual a -1, o texto aparecer centralizado no espao entre a
imagem e a extremidade do boto.
Exemplo
BitBtn1.Spacing := 4
Na fase de projeto:
TBitBtn1 e TSpeedButton
TBitBtn1 e TSpeedButton
SPARSECOLS
Descrio
Essa propriedade declarada como uma varivel booleana e define se as colunas em branco devem ser
removidas da projeo corrente.
Na fase de projeto:
TDecisionSource
TDecisionSource
SPARSEROWS
Descrio
Essa propriedade declarada como uma varivel booleana e define se as linhas em branco devem ser
removidas da projeo corrente.
Na fase de projeto:
TDecisionSource
TDecisionSource
SQL
Descrio
Para componentes dos tipos TIBSQL, TQuery, TDecisionQuery, a propriedade SQL declarada como
uma varivel do tipo TStrings que armazena a declarao ou comando SQL a ser executado quando os
mtodos Open e SQL forem chamados.
Para componentes dos tipos TUpdateSQL e TIBUpdateSQL, essa propriedade retorna declarao SQL
cujo ndice igual a UpdateKind. UpdateKind pode ser igual a ukModify, ukDelete ou ukInsert. Essa
Na fase de projeto:
TIBSQL, TADOQuery, TQuery, TDecisionQuery
TIBSQL, TADOQuery, TQuery, TdecisionQuery, TIBUpdateSQL e TUpdateSQL
SQLCOMPATIBLE
Descrio
Essa propriedade declarada como uma varivel booleana e deve ser usada quando uma mensagem de
erro do Borland Database Engine indicar que o banco de dados utilizado no suporta a funo RecordCount.
Exemplo
QuickReport1.SQLCompatible:= True;
Na fase de projeto:
TQuickReport
TQuickReport
SQLCONNECTION
Descrio
Essa propriedade definida como um objeto da classe TSQLConnection, e define o nome do componente
SQLConnection atravs do qual ser feita a conexo ao servidor do banco de dados.
Na fase de projeto:
TSimpleDataset, TSQLDataset, TSQLTable, TSQLQuery e TSQLStoredproc
TSimpleDataset, TSQLDataset, TSQLTable, TSQLQuery e TSQLStoredproc
SQLDIALECT
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro e define o tipo de dialeto SQL usado
pela aplicao cliente que acessa o banco de dados.
Na fase de projeto:
TIBDataBase
TIBDataBase
SQLOBJECTCOUNT
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro que define o nmero de objetos de
acesso via SQL associados ao componente que representa o banco de dados e que se encontram ativos.
Na fase de projeto:
TIBDatabase, TIBTransaction
SQLOBJECTS
Descrio
Esta propriedade declarada como uma varivel do tipo inteiro que define o nmero de objetos SQL
do banco de dados.
Na fase de projeto:
TIBDatabase
TIBDatabase
START
Descrio
A propriedade Start declarada como uma varivel do tipo inteiro longo (Longint) que define a posio
onde ser iniciada a execuo ou gravao em um dispositivo multimdia. Essa propriedade s est
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com o valor da propriedade Start durante a execuo
de um dispositivo multimdia:
ShowMessage(IntToStr(MediaPlayer1.Start));
TMediaPlayer
STARTFRAME
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro e define o primeiro quadro a ser
executado pelo clipe de vdeo exibido pelo componente.
TAnimate
STARTMARGIN
Descrio
A propriedade StartMargin declarada como uma varivel inteira e determina a distncia, em pixels,
da guia mais esquerda entre as visveis no controle e a extremidade esquerda do controle.
Exemplo
O valor da propriedade StartMargin pode ser alterado diretamente no Object Inspector ou mediante a
TabSet1. StartMargin := 6;
Na fase de projeto:
TTabSet
TTabSet
STARTPOS
Descrio
A propriedade StartPos declarada como uma varivel do tipo inteiro longo (Longint) que define a
posio inicial para execuo ou gravao em um dispositivo multimdia. Essa propriedade s est
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com o valor da propriedade StartPos durante a
execuo de um dispositivo multimdia:
ShowMessage(IntToStr(MediaPlayer1.StartPos));
TMediaPlayer
STATE
Descrio
Para componentes dos tipos TCheckBox e TDBCheckBox, a propriedade State uma varivel do tipo
TCheckBoxState que define os vrios estados que podem ser assumidos pelo componente.
Para componentes dos tipos TDataSource, TTable, TQuery, TDecisionQuery e TStoredProc, a propriedade
State uma varivel do tipo TDataSetState que define os estados que podem ser assumidos por um
banco de dados associado. Para esses componentes, essa propriedade s est disponvel durante a
Tabela de Valores para componentes dos Tipos TCheckBox e TDVCheckBox.
Tabela de Valores para componentes dos tipos TDataSource, TTable, TQuery, TDecisionQuery e TStoredProc:
Valor Significado
cbUnchecked O componente no apresenta um marca de verificao, o que indica que o
componente no est selecionado.
cbChecked O componente apresenta um marca de verificao na cor preta, o que indica que
o componente est selecionado.
cbGrayed O componente apresenta um marca de verificao na cor cinza, o que indica que
o componente est em um terceiro estado. Esse terceiro estado s possvel se o
componente tiver a sua propriedade AllowGrayed igual a True.
Valor Significado
dsInactive O banco de dados est fechado.
dsBrowse O banco de dados est fechado.
dsEdit O banco de dados est sendo editado.
dsInsert O banco de dados permite insero de registros.
dsSetKey O banco de dados est definindo registros-chave.
dsCalcFields O evento OnCalcFields foi acionado.
Exemplo
Voc pode definir o valor da propriedade State de um componente diretamente no Object Inspector
ou mediante uma linha de cdigo:
CheckBox1.State:= cbChecked;
Na fase de projeto:
TCheckBox TDBCheckBox, TADODataset, TADOQuery, TADOStoredProc, TADOTable, TClientDataset,
TDecisionQuery, TIBDataset, TIBQuery, TIBStoredProc, TIBTable, TIBTransaction, TTable, TQuery,
TDecisionQuery e TStoredProc
STATEIMAGES
Descrio
Essa propriedade define a imagem exibida esquerda do cone de um item.
Na fase de projeto:
STATUS
Descrio
A propriedade Status declarada como uma varivel do tipo TQRPrinterStatus que define o estado do
objeto que representa a impressora. Essa propriedade s est disponvel durante a execuo do aplicativo.
Tabela de Valores:
Valor Significado
mpReady Componente pronto para iniciar um novo trabalho de impresso.
mpBusy Componente ocupado com um trabalho de impresso.
mpFinished Trabalho de impresso finalizado.
mpPrinting Trabalho de impresso sendo enviado para a impressora.
mpPreviewing Pr-visualizao de impresso ativa.
TDRPrinter
STEP
Descrio
A propriedade Step uma varivel inteira que define o incremento usado na variao do valor da
propriedade Position do componente.
Exemplo
Voc pode alterar o valor da propriedade Step diretamente no Object Inspector ou mediante a incluso
ProgressBar1.Step:= 10;
Na fase de projeto:
TProgressBar
TProgressBar
STMTHANDLE
Descrio
A propriedade StmtHandle declarada como uma varivel do tipo HDBIStmt que permite acesso direto
s funes da API do Borland Database Engine (BDE). Essa propriedade s est disponvel durante a
STOPFRAME
Descrio
Essa propriedade declarada como uma varivel do tipo inteiro e define o ltimo quadro a ser executado
pelo clipe de vdeo exibido pelo componente.
TAnimate
STORAGE
Descrio
A propriedade Storage declarada como uma varivel do tipo TStorage que permite o acesso interface
IStorage de um componente do tipo TOLEContainer. Essa propriedade s est disponvel durante a
Exemplo
Voc pode exibir o valor da propriedade Storage de um componente do tipo TOLEContainer mediante
ShowMessage(OLEContainer1.Storage);
Na fase de projeto:
TOLEContainer
TOLEContainer
STOREDDEFS
Descrio
A propriedade StoredDefs declarada como uma varivel booleana que determina se as definies de
campos e ndices devem ser armazenadas de forma persistente no arquivo DFM que armazena a definio
do formulrio.
Na fase de projeto:
TADOTable, TIBTable, TTable, TClientDataset
TADOTable, TIBTable, TTable, TClientDataset
STOREDPROCNAME
Descrio
Essa propriedade declarada como uma varivel do tipo string que define o nome do procedimento a
ser executado em um servidor.
Exemplo
Voc pode alterar o valor da propriedade StoredProcName diretamente no Object Inspector ou mediante
StoredProc1. StoredProcName := Exemplo;
Na fase de projeto:
TIBStoredproc, TStoredProc
TIBStoredproc, TStoredProc
STRETCH
Descrio
A propriedade Stretch uma varivel booleana que define se uma imagem na forma de Bitmap ou
Metafile deve ser redimensionada de forma a assumir o tamanho e a forma do controle que ir exibi-la.
Exemplo
Voc pode definir o valor da propriedade Stretch de um componente diretamente no Object Inspector
ou mediante uma linha de cdigo:
Image1.Stretch := True;
Na fase de projeto:
TImage e TDBImage
TImage e TDBImage
STRINGS
Descrio
Essa varivel declarada como um array de strings e permite o acesso a uma string de uma lista de
strings. Essa propriedade s est disponvel durante a execuo do aplicativo.
TStringList e TStrings
STYLE
Descrio
A propriedade Style est associada ao estilo de apresentao de um controle ou componente.
Tabela de Valores para um componente do tipo TBevel:
Nesse caso, a propriedade define se o chanfro ser apresentado em relevo ou como uma depresso.
Tabela de Valores para um objeto do tipo TPen.
Nesse caso, a propriedade uma varivel do tipo TPenStyle que define o estilo de desenho da caneta.
Valor Significado
bsLowered O chanfro representado como uma depresso.
bsRaised O chanfro representado em relevo.
Valor Significado
psSolid A caneta desenha uma linha slida.
psDash A caneta desenha uma linha tracejada.
psDot A caneta desenha uma linha pontilhada.
psDashDot A caneta desenha uma linha no estilo trao-ponto.
psDashDotDot A caneta desenha uma linha no estilo trao-dois pontos.
psClear A caneta desenha uma linha invisvel.
psInsideFrame A caneta desenha uma linha interna ao quadro de figuras fechadas que possuem
um retngulo circunscrito.
Tabela de Valores para um objeto do tipo TBrush:
Nesse caso, a propriedade uma varivel do tipo TBrushStyle que define o estilo de preenchimento de
um pincel para janelas e formas grficas.
Tabela de Valores para um objeto do tipo TFont:
Nesse caso, a propriedade um conjunto de variveis do tipo TFontStyles que define o estilo da fonte.
Valor Significado
bsSolid Preenchimento total (slido).
bsClear Transparente.
bsBDiagonal Hachura em diagonal com a seguinte inclinao: ///.
bsFDiagonal Hachura em diagonal com a seguinte inclinao: \ \ \ .
bsCross Hachuras ortogonais cruzadas.
bsDiagCross Hachuras diagonais cruzadas.
bsHorizontal Hachuras horizontais.
bsVertical Hachuras verticais.
Valor Significado
fsBold A fonte est em negrito.
fsItalic A fonte est em itlico.
fsUnderline A fonte est sublinhada.
fsStrikeout A fonte cortada por uma linha horizontal.
Tabela de Valores para componentes dos tipos TComboBox e FDBCombo:
Nesse caso, a propriedade uma varivel do tipo TComboBoxStyle que define o estilo de exibio dos
itens do componente.
Valor Significado
csDropDown Cria uma lista drop-down com uma caixa de edio na qual o usurio pode digitar texto.
csSimple Cria uma caixa de edio sem uma lista drop-down.
csDropDownList Cria uma lista drop-down sem uma caixa de edio.
csOwnerDrawFixed Cria uma lista drop-down sem caixa de edio em que os itens podem ser qualquer
objeto definido pelo usurio e no apenas strings, sendo que todos tm altura fixa.
csOwnerDrawVariable Cria uma lista drop-down sem caixa de edio em que os itens podem ser qualquer
objeto definido pelo usurio e no apenas strings, sendo que no tm altura fixa.
Tabela de Valores para um componente do tipo TListBox e TDBListBox:
Nesse caso, a propriedade uma varivel do tipo TListBoxStyle que define o estilo de exibio dos itens
do componente.
Tabela de Valores para um componente dos tipos TBitBtn e TSpeedButton:
Nesse caso, a propriedade uma varivel do tipo TButtonStyle que define o aspecto de um boto com bitmap.
Valor Significado
lbStandard Todos os itens so strings e possuem a mesma altura.
lbOwnerDrawFixed Os itens podem ser qualquer objeto definido pelo usurio e no apenas strings,
sendo que todos tm altura fixa, definida pela propriedade ItemHeight.
lbOwnerDrawVariable Os itens podem ser qualquer objeto definido pelo usurio e no apenas
strings, sendo que no tm altura fixa.
Tabela de Valores para um componente do tipo TTabSet:
Nesse caso, a propriedade uma varivel do tipo TTabStyle que define o aspecto do componente.
Valor Significado
bsAutoDetect O bitmap possui o aspecto da verso do Windows sob a qual o aplicativo est
sendo executado.
bsWin31 O bitmap possui o aspecto da verso 3.1 do Windows, independentemente da
verso do Windows sob a qual o aplicativo est sendo executado.
bsNew O bitmap possui um novo aspecto, independentemente da verso do Windows sob
a qual o aplicativo est sendo executado.
Tabela de Valores para um componente do tipo TOutline:
Nesse caso, a propriedade uma varivel do tipo TOutline que define como o componente exibe seus itens.
Valor Significado
tsStandard Cada componente tab do conjunto TabSet tem o tamanho e a aparncia default.
tsOwnerDraw Cada componente tab do conjunto TabSet tem a altura definida pela propriedade
TabHeight e a largura necessria para conter o texto ou glyph. Nesse caso, o
componente tab pode exibir objetos que no sejam strings.
Valor Significado
otStandard Os itens so desenhados de acordo com o valor especificado na propriedade OutlineStyle.
otOwnerDraw Os itens so desenhados no Canvas de acordo com o cdigo escrito no programa.
Tabela de Valores para um componente do tipo TDBLookupCombo:
Nesse caso, a propriedade uma varivel do tipo TDBLookupComboStyle que define como o
componente exibe seus itens.
Exemplo
Voc pode alterar a propriedade Style de um componente Bevel1 do tipo TBevel com a seguinte linha
de cdigo:
Bevel1.Style := bsRaised;
Na fase de projeto:
TFont, TPen, TBrush, TBevel, TBitBtn, TComboBox, TDBComboBox, TDBListBox, TDBLookupCombo,
TListBox, TOutline e TTabSet
TFont, TPen ; TBrush, TBevel, TBitBtn, TComboBox, TDBComboBox, TDBListBox, TDBLookupCombo,
TListBox, TOutline e TTabSet
SUSPENDED
Descrio
Essa varivel declarada como uma varivel booleana que define se a execuo da Thread representada
pelo objeto foi suspensa.
TThread
TABHEIGHT
Descrio
A propriedade TabHeight declarada como uma varivel inteira que define a altura, em pixels, das
guias de um controle.
Na fase de projeto:
TPageControl, TTabSet e TTabControl
Valor Significado
csDropDown Cria uma lista drop-down com uma caixa de edio na qual o usurio pode
digitar texto.
csDropDownList Cria uma lista drop-down sem uma caixa de edio.
TABINDEX
Descrio
A propriedade TabIndex declarada como uma varivel inteira que define a guia correntemente selecionada.
Na fase de projeto:
TABLE
Descrio
Essa propriedade retorna o nome do componente Table ao qual o relatrio est vinculado.
Na fase de projeto:
TRvTableConnection
TRvTableConnection
TABLEDIRECT
Descrio
Essa propriedade definida como uma varivel booleana, e define se o acesso tabela feito de forma
direta, ou se necessria a criao de uma declarao SQL em background.
Na fase de projeto:
TADOTable
TADOTable
TABLELEVEL
Descrio
A propriedade TableLevel declarada como uma varivel inteira que define o driver do BDE vinculado
tabela representada pelo componente.
TTable
TABLENAME
Descrio
Essa propriedade declarada como uma varivel do tipo TFileName e especifica a tabela a que o
componente estar ligado.
Na fase de projeto:
TADOTable, TIBTable, TTable
TADOTable, TIBTable, TTable
TABLETYPE
Descrio
Essa propriedade declarada como uma varivel do tipo TTableType e especifica o tipo da tabela a que
o componente estar ligado (no vale para tabelas SQL).
Na fase de projeto:
TTable
TTable
TABORDER
Descrio
A propriedade TabOrder uma varivel do tipo TTabOrder que define a ordem segundo a qual os diversos
controles de um formulrio recebem o foco da aplicao quando o usurio pressiona a tecla Tab. Se voc
altera a propriedade TabOrder de qualquer componente, o Delphi altera automaticamente o valor da
propriedade TabOrder dos demais componentes, de forma que no haja duplicao do valor da propriedade.
Exemplo
Voc pode definir o valor da propriedade TabOrder de um componente diretamente no Object Inspec-
BitBtn1.TabOrder:= 5;
Na fase de projeto:
TBitBtn, TDirectoryListBox, TPageControl, TButton, TDrawGrid, TPanel, TCheckBox,
TDriveComboBox, TProgressBar, TComboBox, TEdit, TRadioButton, TDBCheckBox, TFileListBox,
TRadioGroup, TDBComboBox, TFilterComboBox, TRichEdit, TDBCtrlGrid, TScrollBar, TDBCtrlPanel,
TGroupBox, TScrollBox, TDBEdit, THeader, TStatusBar, TDBGrid, THeaderControl, TStringGrid,
TDBImage, THotKey, TTabbedNotebook, TDBListBox, TListBox, TTabControl, TDBLookupCombo,
TListView, TTabSet, TDBLookupComboBox, TMaskEdit, TTabSheet, TDBLookupList, TMediaPlayer,
TTrackBar, TDBLookupListBox, TMemo, TTreeView, TDBMemo, TNotebook, TUpDown, TDBNavigator,
TOLEContainer, TDBRadioGroup e TOutline
TBitBtn, TDirectoryListBox, TPageControl, TButton, TDrawGrid, TPanel, TCheckBox,
TDriveComboBox, TProgressBar, TComboBox, TEdit, TRadioButton, TDBCheckBox, TFileListBox,
TRadioGroup, TDBComboBox, TFilterComboBox, TRichEdit, TDBCtrlGrid, TScrollBar, TDBCtrlPanel,
TGroupBox, TScrollBox, TDBEdit, THeader, TStatusBar, TDBGrid, THeaderControl, TStringGrid,
TDBImage, THotKey, TTabbedNotebook, TDBListBox, TListBox, TTabControl, TDBLookupCombo,
TListView, TTabSet, TDBLookupComboBox, TMaskEdit, TTabSheet, TDBLookupList, TMediaPlayer,
TTrackBar, TDBLookupListBox, TMemo, TTreeView, TDBMemo, TNotebook, TUpDown, TDBNavigator,
TOLEContainer, TDBRadioGroup e TOutline
TABS
Descrio
A propriedade Tabs declarada como uma lista de strings que armazena o texto exibido para as diversas
guias do controle.
Exemplo
Voc pode definir o valor da propriedade Tabs de um controle diretamente no Object Inspector, usando
o String List Editor, ou mediante uma linha de cdigo como:
TabSet1.Tabs.Add(Nova guia);
Essa linha de cdigo, alm de acrescentar uma string lista definida na propriedade Tabs, cria uma nova guia que exibir o texto da string.
Na fase de projeto:
TTabControl e TTabSet
TTabControl e TTabSet
TABSPERROW
Descrio
A propriedade TabsPerRow uma varivel inteira que define o nmero de guias que aparecem em cada
linha no topo do controle.
Exemplo
Voc pode definir o valor da propriedade TabsPerRow de um controle diretamente no Object Inspector
TabbedNotebook1.TabsPerRow := 2;
Na fase de projeto:
TTabbedNotebook
TTabbedNotebook
TABSTOP
Descrio
A propriedade TabStop uma varivel do tipo booleana que define se um controle pode ou no receber
o foco da aplicao quando o usurio pressiona a tecla Tab.
Exemplo
Voc pode definir o valor da propriedade TabStop de um controle diretamente no Object Inspector ou
mediante uma linha de cdigo:
BitBtn1.TabStop:= False;
Na fase de projeto:
TBitBtn, TDirectoryListBox, TPageControl, TButton, TDrawGrid, TPanel, TCheckBox, TDriveComboBox,
TProgressBar, TComboBox, TEdit, TRadioButton, TDBCheckBox, TFileListBox, TRadioGroup, TDBComboBox,
TFilterComboBox, TRichEdit, TDBCtrlGrid, TScrollBar, TDBCtrlPanel, TGroupBox, TScrollBox, TDBEdit,
THeader, TStatusBar, TDBGrid, THeaderControl, TStringGrid, TDBImage, THotKey, TTabbedNotebook,
TDBListBox, TListBox, TTabControl, TDBLookupCombo, TListView, TTabSet, TDBLookupComboBox,
TMaskEdit, TTabSheet, TDBLookupList, TMediaPlayer, TTrackBar, TDBLookupListBox, TMemo, TTreeView,
TDBMemo, TNotebook, TUpDown, TDBNavigator, TOLEContainer, TDBRadioGroup e TOutline
TBitBtn, TDirectoryListBox, TPageControl, TButton, TDrawGrid, TPanel, TCheckBox, TDriveComboBox,
TProgressBar, TComboBox, TEdit, TRadioButton, TDBCheckBox, TFileListBox, TRadioGroup, TDBComboBox,
TFilterComboBox, TRichEdit, TDBCtrlGrid, TScrollBar, TDBCtrlPanel, TGroupBox, TScrollBox, TDBEdit,
THeader, TStatusBar, TDBGrid, THeaderControl, TStringGrid, TDBImage, THotKey, TTabbedNotebook,
TDBListBox, TListBox, TTabControl, TDBLookupCombo, TListView, TTabSet, TDBLookupComboBox,
TMaskEdit, TTabSheet, TDBLookupList, TMediaPlayer, TTrackBar, TDBLookupListBox, TMemo, TTreeView,
TDBMemo, TNotebook, TUpDown, TDBNavigator, TOLEContainer, TDBRadioGroup e TOutline
TABSTOPS
Descrio
A propriedade TabStops declarada como uma array de variveis booleanas que define as colunas para
as quais o usurio pode se mover usando a tecla Tab ou Shift+Tab. Essa propriedade s est disponvel
Exemplo
Se voc no quiser que o usurio se desloque para a segunda coluna de uma grade usando Tab ou
Shift+Tab, inclua a seguinte linha de cdigo:
StringGrid1.TabStops[1] := False;
TDBGrid e TStringGrid
TABWIDTH
Descrio
A propriedade TabWidth declarada como uma varivel inteira que define a largura, em pixels, das
guias de um controle.
Na fase de projeto:
TAG
Descrio
A propriedade Tag uma varivel do tipo Longint que o Delphi coloca disposio do usurio, que
pode atribuir o significado mais conveniente.
Exemplo
Voc pode alterar a propriedade Tag de um componente Button1 do tipo TButton com a seguinte linha
de cdigo:
Button1.Tag := varivel_inteira;
Na fase de projeto:
TEMPORARY
Descrio
A propriedade Temporary declarada como uma varivel booleana e determina se o componente foi
criado apenas porque no havia um componente do tipo TDatabase disponvel quando uma tabela foi
aberta. Essa propriedade s est disponvel durante a execuo do aplicativo e no pode ter o seu valor
TDatabase
TERMINATED
Descrio
A propriedade Terminated uma varivel do tipo booleana que especifica se a aplicao recebeu do
Windows a mensagem WM_QUIT para que seja encerrada, o que ocorre normalmente quando se
fecha o formulrio principal. Essa propriedade s est disponvel durante a execuo do aplicativo, e
no pode ter o seu valor diretamente alterado pelo usurio.
Para objetos da classe TThread, indica se sua execuo deve ser finalizada.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem quando a aplicao estiver para ser encerrada:
if Application.Terminated = True then ShowMessage(A aplicao ser encerrada);
TApplication
TEXT
Descrio
A propriedade Text uma varivel do tipo string cujo significado depende do tipo de componente a
que se refere:
Para componentes dos tipos TComboBox, TDBComboBox, TIWComboBox e TIWDBComboBox, a
propriedade Text define o primeiro item que aparece na lista de itens do componente quando a aplicao
executada.
Para componentes do tipo TDriveComboBox, a propriedade Text igual propriedade Drive.
Para componentes do tipo TFilterComboBox, a propriedade Text define o primeiro filtro que aparece
na lista de filtros do componente quando a aplicao executada.
Para componentes dos tipos TDBLookupCombo, TDBLookupComboBox, TIWDBLookupCombo,
TIWDBLookupComboBox, a propriedade Text define o valor do campo do registro corrente.
Para componentes dos tipos TDBEdit, TDBMemo, TEdit, TIWDBEdit, TIWDBMemo, TIWEdit,
TIWMemo, TMaskEdit e TMemo, essa propriedade declarada como uma varivel TCaption que de-
fine o texto exibido pelo componente, com um mximo de 255 caracteres.
Para qualquer um dos componentes citados, exceto TEdit, TMaskEdit e TComboBox com a propriedade
Style igual a csDropDown, essa propriedade s est disponvel durante a execuo do aplicativo.
Para componentes dos tipos TDDEClientItem e TDDEServerItem, essa propriedade define o texto a ser
transferido em uma conversao DDE.
Para objetos do tipo TOutlineNode, declarada como uma varivel do tipo string e armazena o texto
que identifica o item.
Para componentes dos tipos TAutoIncField, TBCDField, TBlobField, TBytesField, TFieldDef,
TGraphicField, TIntegerField, TMemoField, TStringField, TTimeField e TVarBytesField, essa propriedade
declarada como uma varivel do tipo string que armazena como uma string o valor da propriedade.
Exemplo
Voc pode alterar a propriedade Text de um componente ComboBox1 do tipo TComboBox com a
propriedade Style igual a csDropDown diretamente no Object Inspector ou com a seguinte linha de cdigo:
ComboBox1.Text:= Texto;
Na fase de projeto:
TDDEClientItem, TDDEServerItem, TEdit, TIWEdit, TMaskEdit e TComboBox com a propriedade Style
igual a csDropDown
TAutoIncField, TOutlineNode, TParam, TTreeNode, TStrings, TStringList, THeaderSection,
TDBComboBox, TDBEdit, TDBMemo, TDDEClientItem, TDDEServerItem, TDriveComboBox, TEdit,
TFilterComboBox, TIWDBComboBox, TIWDBEdit, TIWEdit, TIWDBMemo, TMaskEdit, TMemo, TQuery,
TDecisionQuery, TBCDField, TBooleanField, TCurrencyField, TDateField, TDateTimeField,
TFloatField, TIntegerField, TSmallintField, TStringField, TTimeField, TWordField e TComboBox
com a propriedade Style igual a csDropDown
TEXTALIGN
Descrio
Esta propriedade define como um texto ser alinhado verticalmente em um Canvas, podendso assumir
o valor taTop ou taBottom
TCanvas
TEXTCASE
Descrio
A propriedade TextCase declarada como uma varivel do tipo TTextCase que define se o nome exibido
pela propriedade Text deve aparecer em letras maisculas ou minsculas.
Tabela de Valores:
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou por meio de uma
DriveComboBox1.TextCase := tcUpperCase;
Na fase de projeto:
TDriveComboBox
TDriveComboBox
THREADID
Descrio
Essa varivel declarada como uma varivel do tipo THandle que identifica a Thread com o sistema
operacional e permite que esta possa ser passada como parmetros em funes da API do Windows.
TThread
TICKMARKS
Descrio
A propriedade TickMarks declarada como uma varivel do tipo TTickMark que define o tipo de marca
usada para graduar os valores exibidos no componente.
Tabela de Valores:
Valor Significado
tcLowerCase O nome exibido pela propriedade Text apresentado em letras minsculas.
tcUpperCase O nome exibido pela propriedade Text apresentado em letras maisculas.
Valor Significado
tmBottomRight As marcas so exibidas abaixo ou direita do componente.
tmTopLeft As marcas so exibidas acima ou esquerda do componente.
tmBoth As marcas so exibidas dos dois lados do componente.
Exemplo
Voc pode definir o valor da propriedade TickMarks de um componente diretamente no Object In-
spector ou mediante uma linha de cdigo:
TrackBar1.TickMarks:= tmBoth;
Na fase de projeto:
TTrackBar
TTrackBar
TICKSTYLE
Descrio
A propriedade TickStyle declarada como uma varivel do tipo TTickStyle que define o estilo de marca
usada para graduar os valores exibidos no componente.
Tabela de Valores:
Exemplo
Voc pode definir o valor da propriedade TickStyle de um componente diretamente no Object Inspec-
TrackBar1.TickStyle:= tsAuto;
Na fase de projeto:
TTrackBar
TTrackBar
TILEMODE
Descrio
Essa propriedade declarada como uma varivel do tipo TTileMode e determina se as janelas-filhas de
uma aplicao MDI devem ser automaticamente reposicionadas e redimensionadas quando a aplicao
chama o mtodo Tile. Essa propriedade s est disponvel durante a execuo do aplicativo.
Valor Significado
tsAuto As marcas so exibidas automaticamente a cada incremento de valor. A propriedade
Frequency s pode ser usada quando esse o estilo definido para o componente.
tsManual As marcas so exibidas nas extremidades do componente e nas posies definidas
pelo mtodo SetTick.
tsNone O componente no exibe nenhuma marca.
Tabela de Valores:
Exemplo
Voc pode alterar o valor da propriedade TileMode mediante a incluso de uma linha de cdigo, como:
Form1.TileMode := tbHorizontal;
TForm
TIMEFORMAT
Descrio
A propriedade TimeFormat declarada como uma varivel do tipo TMPTimeFormats e define o formato
usado para interpretar informaes de posio em propriedades como StartPos, Length, Position, Start e
EndPos em um dispositivo multimdia. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode alterar o valor da propriedade TimeFormat mediante a incluso de uma linha de cdigo como:
TimeFormat := tfHMS;
TMediaPlayer
TIMERS
Descrio
Essa propriedade declarada como uma varivel do tipo booleana e define se o clipe de vdeo exibido
pelo componente ser executado em uma thread independente (quando seu valor for igual a False).
Na fase de projeto:
TAnimate
TAnimate
TITLE
Descrio
Para componentes do tipo TApplication, a propriedade Title declarada como uma varivel do tipo
string e define o nome que ser exibido com o cone da aplicao quando ela for minimizada. Essa
Valor Significado
tbHorizontal Cada formulrio ter suas dimenses alteradas de forma a preencher toda a
largura da janela-pai.
tbVertical Cada formulrio ter suas dimenses alteradas de forma a preencher toda a
altura da janela-pai.
propriedade s est disponvel durante a execuo do aplicativo. Voc tambm pode alterar a propriedade
Title de uma aplicao na pgina Application do quadro de dilogo Project Options do menu Options.
Para componentes do tipo TPrinter, a propriedade Title declarada como uma varivel do tipo string
e define o nome que ser exibido no gerenciador de impresso do Windows durante a impresso do
documento. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir define o valor da propriedade Title de uma aplicao:
Application.Title := Nome;
TApplication e TPrinter
TITLEBEFOREHEADER
Descrio
Essa propriedade declarada como uma varivel booleana que define se o ttulo do primeiro componente
do tipo TQRBando ser exibido ou no antes do cabealho da pgina.
Exemplo
QuickReport1.TitleBeforeHeader:= True;
Na fase de projeto:
TQuickReport
TQuickReport
TITLEFONT
Descrio
Essa propriedade declarada como uma varivel do tipo TFont e determina o tipo de fonte usada para
exibir os ttulos das colunas da grade.
Exemplo
Voc pode alterar o valor dessa propriedade diretamente no Object Inspector ou por meio da seleo
de uma fonte em uma caixa de dilogo, com o seguinte trecho de cdigo:
if FontDialog1.Execute then DBGrid1.TitleFont := FontDialog1.Font;
Na fase de projeto:
TDBGrid
TDBGrid
TOP
Descrio
A propriedade Top uma varivel inteira que define, em pixels, a coordenada da extremidade superior
de um componente em relao extremidade superior do formulrio que o contm. No caso de um
formulrio, essa propriedade medida em relao tela.
Exemplo
Para alterar a propriedade Top de um boto chamado Button1 durante a execuo de um aplicativo,
Button1.Top := valor;
Na fase de projeto:
Todos os controles.
Todos os controles e componentes TFindDialog e TReplceDialog.
TOPAGE
Descrio
A propriedade ToPage uma varivel inteira que define o nmero da ltima pgina a ser impressa.
Exemplo
PrintDialog1.ToPage:= 100;
Na fase de projeto:
TPrintDialog
TPrintDialog e TQRPrinter
TOPAXIS
Descrio
A propriedade TopAxis declarada como um objeto da classe TChartAxis e representa o eixo horizon-
tal superior do grfico exibido no componente.
Na fase de projeto:
TChart, TDBChart
TChart, TDBChart
TOPINDEX
Descrio
A propriedade TopIndex uma varivel inteira que define o ndice do item que aparece no topo de
uma caixa de listagem. Essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Voc pode usar um componente chamado Edit1 do tipo TEdit para exibir o item exibido no topo de
uma caixa de listagem chamada ListBox1 do tipo TListBox com a seguinte linha de cdigo:
Edit1.Text := IntToStr(ListBox1.TopIndex);
TDirectoryListBox, TFileListBox e TListBox
TOPITEM
Descrio
Para componentes do tipo TOutlineNode, essa propriedade declarada como uma varivel do tipo
inteiro longo (Longint) que define o ndice do seu ancestral cuja propriedade Level igual a 1. Essa
Para componentes do tipo TListView, essa propriedade declarada como uma varivel do tipo TListItem
que define o item visvel no topo do componente. Essa propriedade s est disponvel durante a
Para componentes do tipo TTreeView, essa propriedade declarada como uma varivel do tipo TTreeNode
que define o item visvel no topo do componente. Essa propriedade s est disponvel durante a
TListView, TTreeView e TOutlineNode
TOPROW
Descrio
A propriedade TopRow uma varivel do tipo inteiro longo (Longint) que define a linha de clulas da
grade que deve ser exibida no topo, imediatamente abaixo das linhas fixas.
Exemplo
Voc pode alterar a propriedade TopRow diretamente no Object Inspector ou com a seguinte linha de
cdigo, na qual StringGrid1 um componente do tipo TStringGrid1:
StringGrid1.TopRow := 1;
Na fase de projeto:
TRACEFLAGS
Descrio
Esta propriedade declarada como uma varivel do tipo TTraceFlag que define as operaes a serem
monitoradas pelo SQL Monitor.
TDatabase, TIBDatabase
TRACKLENGTH
Descrio
A propriedade TrackLength declarada com um array de inteiros longos (Longint), no qual cada item
do array define o comprimento de uma trilha a ser executada por um dispositivo multimdia. Essa
propriedade s est disponvel durante a execuo de um aplicativo, e no pode ter o seu valor
Exemplo
comprimento da segunda trilha a ser executada por um componente chamado MediaPlayer1 em um
dispositivo multimdia.
Label1.Caption := IntToStr(MediaPlayer1.TrackLength[1]);
TMediaPlayer
TRACKPOSITION
Descrio
A propriedade TrackPosition declarada com uma array de inteiros longos (Longint) e retorna a posio
inicial da trilha especificada pelo ndice TrackNum.
Exemplo
posio inicial da segunda trilha a ser executada por um componente chamado MediaPlayer1 em um
dispositivo multimdia.
Label1.Caption := IntToStr(MediaPlayer1.TrackPosition[1]);
TMediaPlayer
TRACKS
Descrio
A propriedade Tracks declarada com uma varivel inteira longa (Longint) e retorna o nmero de
trilhas que podem ser executadas no dispositivo multimdia corrente. Essa propriedade s est disponvel
durante a execuo de um aplicativo, e no pode ter o seu valor diretamente alterado pelo usurio.
Exemplo
nmero de trilhas existentes em um componente chamado MediaPlayer1 em um dispositivo multimdia.
Label1.Caption := IntToStr(MediaPlayer1.Tracks);
TMediaPlayer
TRANSACTIONCOUNT
Descrio
Esta propriedade declarada como uma varivel inteira, e define o nmero de transaes associadas ao
componente.
TIBDatabase
TRANSACTIONS
Descrio
Esta propriedade declarada como uma array de objetos da classe TIBTransaction e permite acessar,
atravs de um ndice, um dos objetos TIBTransaction associados ao componente.
TIBDatabase
TRANSISOLATION
Descrio
A propriedade Transisolation declarada como uma varivel do tipo TTransisolation e define o nvel
do isolamento das transaes com um servidor SQL.
Exemplo
Voc pode definir o valor dessa propriedade diretamente no Object Inspector ou mediante uma linha
de cdigo como:
Database1.Transisolation := ReadCommited;
Na fase de projeto:
TDatabase
TDatabase
TRANSLITERATE
Descrio
A propriedade Transliterate uma varivel booleana que define se feita alguma transformao ao se
passar um dado de um componente para outro.
Exemplo
Voc pode definir o valor dessa propriedade mediante uma linha de cdigo como:
BatchMove1.Transliterate := False;
onde BatchMove um componente do tipo TBatchMove.
TBatchMove, TMemoField e TStringField
TRANSPARENT
Descrio
Essa propriedade declarada como uma varivel booleana que define se o componente ser exibido
com a cor definida na sua propriedade Color ou com a cor do componente sobre o qual est posicionado.
Exemplo
Voc pode definir a propriedade Transparent de um componente diretamente no Object Inspector ou
mediante uma linha de cdigo. Para tornar um componente chamado Label1 do tipo TLabel transparente
durante a execuo de um aplicativo, basta incluir a seguinte linha de cdigo:
Label1.Transparent := False;
Na fase de projeto:
TAnimate, TQRLabel, TLabel e TDBText
TAnimate, TQRLabel, TLabel e TDBText
UNIDIRECIONAL
Descrio
A propriedade Unidirecional uma varivel booleana que define se a movimentao pelos registros de
um conjunto de dados s pode ser feita em uma direo.
Exemplo
Voc pode definir a propriedade Unidirecional de um componente diretamente no Object Inspector
Query1.Unidirecional := False;
Na fase de projeto:
UNSELECTEDCOLOR
Descrio
A propriedade UnSelectedColor declarada como uma varivel do tipo TColor e define a cor das guias
que no esto selecionadas em um componente do tipo TTabSet.
Exemplo
Voc pode alterar a propriedade UnSelectedColor de um componente diretamente no Object Inspec-
tor ou por meio de uma linha de cdigo, como:
TabSet1. UnSelectedColor := clBlue;
Na fase de projeto:
TTabSet
TTabSet
UPDATEDMODE
Descrio
A propriedade UpdatedMode uma varivel que define como o Delphi pesquisar os registros alterados
em um banco de dados SQL.
Tabela de Valores:
Valor Significado
WhereAll A pesquisa feita por todas as colunas.
WhereKeyOnly A pesquisa feita pelas colunas-chave.
WhereChanged A pesquisa feita pelas colunas-chave e as que j sofreram alterao.
Exemplo
Voc pode definir a propriedade UpdatedMode de um componente diretamente no Object Inspector
Query1.UpdatedMode := WhereAll;
Na fase de projeto:
USECOMPRESSION
Descrio
A propriedade UseCompression uma varivel do tipo booleano que define se deve-se ou no aplicar
compresso ao relatrio gerado.
Na fase de projeto:
TRenderPDF.
TRenderPDF.
VALUE
Descrio
Para componentes do tipo TDBRadioGroup, essa propriedade declarada como uma varivel do tipo
string e armazena o contedo do campo correspondente no registro do banco de dados associado. A
propriedade Items desse componente armazena uma lista de strings, na qual a primeira string
corresponde ao primeiro boto de rdio, a segunda string ao segundo boto de rdio, e assim por
diante. Quando o usurio seleciona um dos botes de rdio do grupo, a string correspondente
armazenada no campo correspondente do registro corrente do banco de dados associado.
Para componentes dos tipos TDBLookupCombo e TDBLookupList, essa propriedade declarada como uma
varivel do tipo string e armazena o contedo do campo correspondente no registro do banco de dados
associado. Para esses componentes, essa propriedade s est disponvel durante a execuo do aplicativo.
Nos demais casos, em componentes derivados de TField, armazena o valor correspondente ao campo
que ele representa em registro de um banco de dados. Nesses casos, a varivel ser declarada como de um
tipo compatvel com o campo a ser representado, ou seja, ser declarada como uma varivel do tipo:
String, para componentes do tipo TStringField.
Longint, para componentes dos tipos TAutoIncField, TIntegerField, TSmallintField e TWordField.
Double, para componentes dos tipos TBCDField, TCurrencyField e TFloatField.
Boolean, para componentes do tipo TBooleanField.
TDateTime, para componentes dos tipos TDateField, TDateTimeField e TTimeField.
Para esses componentes, essa propriedade s est disponvel durante a execuo do aplicativo.
Exemplo
Durante a execuo do aplicativo, voc pode atribuir uma data propriedade Value de um componente
do tipo TDateField com a seguinte linha de cdigo:
DateField1.Value:= StrToDateTime(01/15/96 10:30:00');
TAutoIncField, TBCDField, TBooleanField, TCurrencyField, TDateField, TDateTimeField,
TDBLookupCombo, TDBLookupList, TFloatField, TIntegerField, TDBRadioGroup. TSmallintField,
TStringField, TTimeField e TWordField
VALUECHECKED
Descrio
A propriedade ValueChecked uma varivel do tipo string cujo valor ser atribudo a um campo (definido
pela propriedade DataField de TDBCheckBox) do registro corrente do banco de dados (definido pela
propriedade DataSource de TDBCheckBox) quando o usurio selecionar a opo correspondente ao controle.
De modo inverso, se no campo do banco de dados for atribudo um valor diferente do armazenado em
ValueChecked, a opo ser desmarcada (o controle no ser mais selecionado). Nesse caso, se a string
armazenada no campo tambm no for igual definida na propriedade ValueUnchecked, o controle
ficar com aspecto acinzentado.
Voc pode definir mais de uma string para a propriedade, desde que separadas por um ponto-e-vrgula.
Nesse caso, basta que uma delas corresponda ao valor armazenado no campo para que o controle seja
selecionado.
Exemplo
Voc pode alterar a propriedade ValueChecked diretamente no Object Inspector ou com a seguinte
linha de cdigo:
DBCheckBox1.ValueChecked := Valor;
Na fase de projeto:
TDBCheckBox
TDBCheckBox
VALUES
Descrio
A propriedade Values declarada como uma varivel do tipo TStrings que armazena uma lista de
strings em que cada item corresponder a um possvel valor de um campo em um registro do banco de
dados associado. Cada item dessa lista corresponde a um item da lista de strings armazenada na
propriedade Items do componente. O primeiro item corresponder ao primeiro boto de rdio, o
segundo item ao segundo boto de rdio, e assim por diante. O contedo da propriedade Values que
ser comparado com o valor corrente do campo, isto , se uma das strings da propriedade Values
coincidir com o armazenado no campo do banco de dados, o boto de rdio correspondente ser
selecionado. De maneira inversa, se um boto de rdio for selecionado, a string correspondente na
propriedade Values ser armazenada no campo de dados (desde que a propriedade Read Only seja
False). Caso seja omitida a lista de strings na propriedade Values, ser considerada a lista armazenada
na propriedade Items. Voc pode operar sobre a propriedade Values da mesma forma que opera sobre
qualquer item de uma lista de strings, para adicionar, remover ou inserir uma string.
Para objetos dos tipos TStrings e TStringList, d acesso direto a uma lista de strings.
Exemplo
Voc pode alterar a propriedade Values diretamente no Object Inspector ou mediante um trecho de
cdigo, como exemplificado a seguir. Nesse caso, quando o formulrio criado, atribui-se propriedade
Items de um componente DBRadioGroup1, do tipo TDBRadioGroup, a lista de strings composta por
Vermelho, Verde e Amarelo, e sua propriedade Values, a lista de strings composta por Red,
Green e Yellow.
begin
with DBRadioGroup1 do
begin
Items.Add(Vermelho);
Items.Add(Verde);
Items.Add(Amarelo);
Values.Add(Red);
Values.Add(Green);
Values.Add(Yellow);
end;
end;
Quando o aplicativo executado, surgem trs botes de rdio no componente DBRadioGroup, com
rtulos iguais a Vermelho, Verde e Amarelo. Se o valor armazenado no campo do registro correspondente
ao banco de dados associado for igual a Red, Green ou Blue, o boto correspondente ser selecionado.
Por outro lado, se o usurio selecionar um dos botes de rdio, a string correspondente na propriedade
Values ser armazenada no campo do banco de dados.
Na fase de projeto:
TDBRadioGroup
TStrings, TStringList e TDBRadioGroup
VALUEUNCHECKED
Descrio
A propriedade ValueUnChecked uma varivel do tipo string cujo valor ser atribudo a um campo
(definido pela propriedade DataField de TDBCheckBox) do registro corrente do banco de dados (definido
pela propriedade DataSource de TDBCheckBox) quando o usurio desfizer a seleo da opo
correspondente ao controle.
De modo inverso, se no campo do banco de dados for atribudo um valor diferente do armazenado em
ValueUnChecked, a opo ser desmarcada (o controle no ser mais selecionado). Nesse caso, se a
string armazenada no campo tambm no for igual definida na propriedade ValueChecked, o controle
ficar com aspecto acinzentado.
Voc pode definir mais de uma string para a propriedade, desde que separadas por um ponto-e-vrgula.
Nesse caso, basta que uma delas corresponda ao valor armazenado no campo para que o controle no
seja selecionado.
Exemplo
Voc pode alterar a propriedade ValueUnChecked diretamente no Object Inspector ou com a seguinte
linha de cdigo:
DBCheckBox1.ValueUnChecked := Valor;
Na fase de projeto:
TDBCheckBox
TDBCheckBox
VERTSCROLLBAR
Descrio
A propriedade VertScrollBar declarada como uma varivel do tipo TControlScrollBar cujas
subpropriedades definem o comportamento de uma barra de rolagem vertical em um componente do
tipo TForm, TFrame ou TScrollBox.
Exemplo
Voc pode alterar as subpropriedades da propriedade VertScrollBar de um componente diretamente no
Object Inspector ou durante a execuo do aplicativo incluindo uma linha de cdigo como:
Form1.VertScrollBar.Visible := True;
Na fase de projeto:
TForm e TScrollBox
VIEWORIGIN
Descrio
Essa propriedade declarada como uma varivel do tipo TPoint e retorna as coordenadas da origem do
controle. Essa propriedade s est disponvel durante a execuo do aplicativo, e no pode ter o seu
TListView
VIEWSTYLE
Descrio
A propriedade ViewStyle declarada como uma varivel do tipo TViewStyle que define como os itens
sero exibidos no controle.
Tabela de Valores:
Valor Significado
vsIcon Cada item aparece como um cone em verdadeira grandeza sobre um rtulo. Os
itens podem ser arrastados pelo usurio.
vsSmallIcon Cada item aparece como um pequeno cone com um rtulo sua direita. Os itens
podem ser arrastados pelo usurio.
vsList Cada item aparece como um pequeno cone com um rtulo sua direita. Os itens
so dispostos em colunas e no podem ser arrastados pelo usurio.
vsReport Cada item exibido em sua prpria linha, com informaes dispostas em colunas.
Na fase de projeto:
TListView
TListView
VISIBLE
Descrio
A propriedade Visible uma varivel booleana que define se o componente aparece ou no na tela.
Para objetos da classe TAction, define o valor da propriedade Visible dos controles e itens de menu
associados ao objeto.
Exemplo
Voc pode definir a propriedade Visible de um componente diretamente no Object Inspector ou
mediante uma linha de cdigo. Para tornar um boto Button1 invisvel durante a execuo de um
aplicativo, basta incluir a seguinte linha de cdigo:
Button1.Visible:= False;
Na fase de projeto:
Todos os controles; componentes, TAction TBCDField, TBlobField, TBooleanField, TBytesField,
TControlScrollBar, TCurrencyField, TDateField, TDateTimeField, TFloatField, TForm,
TGraphicField, TIntegerField, TMenuItem, TMemoField, TSmallintField, TStringField, TTimeField,
TVarBytesField, TWordField
Todos os controles; componentes, TAction TBCDField, TBlobField, TBooleanField, TBytesField,
TControlScrollBar, TCurrencyField, TDateField, TDateTimeField, TFloatField, TForm,
TGraphicField, TIntegerField, TMenuItem, TMemoField, TSmallintField, TStringField, TTimeField,
TVarBytesField, TWordField
VISIBLEBUTTONS
Descrio
A propriedade VisibleButtons declarada como uma varivel do tipo TButtonSet que define os botes
a serem exibidos por um controle dos tipos TDBNavigator ou TMediaPlayer.
Tabela de Valores para controles do tipo TDBNavigator.
Boto Valor Significado
First nbFirst Exibe o primeiro registro do banco de dados.
Prior nbPrior Exibe o registro anterior do banco de dados.
Next nbNext Exibe o prximo registro do banco de dados.
Last nbLast Exibe o ltimo registro do banco de dados.
Insert nbInsert Insere um registro em branco no banco de dados.
Delete nbDelete Deleta o registro corrente do banco de dados.
continua
Tabela de Valores para controles do tipo TMediaPlayer.
Edit nbEdit Permite a edio do registro corrente do banco de dados.
Post nbPost Grava o registro corrente no banco de dados.
Cancel nbCancel Cancela a edio do registro corrente do banco de dados.
Refresh nbRefresh Atualiza a exibio dos registros do banco de dados.
Exemplo
Os valores das subpropriedades da propriedade VisibleButtons do controle podem ser alterados
diretamente no Object Inspector.
Caso queira alter-las durante a execuo do aplicativo, as subpropriedades devem ser listadas entre
colchetes, separadas por vrgulas e, ento, o conjunto deve ser atribudo propriedade VisibleButtons,
como na linha de cdigo abaixo:
procedure TForm1.FormDblClick(Sender: TObject);
begin
DBNavigator1.VisibleButtons := [nbFirst,nbPrior,nbNext,nbLast];
end;
Nesse caso, ao se dar um duplo clique com o mouse sobre um formulrio chamado Form1, ser redefinida
a propriedade VisibleButtons do controle DBNavigator1, do tipo TDBNavigator.
As subpropriedades listadas entre colchetes tero o valor True e as demais, o valor False, independentemente do valor que lhes
tenha sido atribudo no Object Inspector.
Na fase de projeto:
TDBNavigator e TMediaPlayer
Play btPlay Inicia reproduo.
Record btRecord Inicia gravao.
Stop btStop Interrompe uma reproduo ou gravao.
Next btNext Passa para a trilha seguinte.
Prev btPrev Passa para a trilha seguinte.
Step btStep Desloca um certo nmero de quadros para frente.
Back btBack Desloca um certo nmero de quadros para frente.
Pause btPause Pausa durante a reproduo ou gravao.
Eject btEject Ejeo.
continuao
TDBNavigator e TMediaPlayer
VISIBLECOLCOUNT
Descrio
A propriedade VisibleColCount uma varivel inteira que define o nmero de colunas (exceto as
fixas) que so integralmente exibidas pela grade. Essa propriedade s est disponvel durante a execuo
Exemplo
nmero de colunas integralmente exibidas por um componente StringGrid1 do tipo TStringGrid quando
o usurio seleciona uma clula com o mouse.
begin
Label1.Caption := IntToStr(StringGrid1.VisibleColCount);
end;
VISIBLEROWCOUNT
Descrio
Para componentes dos tipos TDrawGrid e TStringGrid, a propriedade VisibleRowCount uma varivel
inteira que define o nmero de linhas (exceto as fixas) integralmente exibidas pela grade. Essa
Para componentes do tipo TListView, a propriedade VisibleRowCount uma varivel inteira que define
o nmero de itens que podem ser exibidos na rea visvel do controle. Essa propriedade s est disponvel
Exemplo
nmero de linhas integralmente exibidas por um componente StringGrid1 do tipo TStringGrid quando
o usurio seleciona uma clula com o mouse.
begin
Label1.Caption:= IntToStr(StringGrid1.VisibleRowCount);
end;
TListView, TDrawGrid e TStringGrid
VISIBLETABS
Descrio
A propriedade VisibleTabs uma varivel inteira que define o nmero de guias visveis no controle.
Exemplo
nmero de guias visveis em um componente TabSet1 do tipo TTabSet quando o usurio seleciona
uma guia do controle com o mouse.
procedure TForm1.TabSet1Click(Sender: TObject);
begin
Label1.Caption := IntToStr(TabSet1.VisibleTabs);
end;
TTabSet
WAIT
Descrio
A propriedade Wait uma varivel booleana que define se um mtodo de controle do tipo TMediaPlayer
s deve retornar o controle para a aplicao aps encerrar a sua execuo. Essa propriedade s est
Exemplo
Voc pode alterar o valor da propriedade Wait mediante uma linha de cdigo como:
MediaPlayer1,Wait := False;
TMediaPlayer
WANTRETURNS
Descrio
A propriedade WantReturns uma varivel booleana que define se a tecla Enter est habilitada em um
componente.
Exemplo
Voc pode definir a propriedade WantReturns de um componente diretamente no Object Inspector ou
mediante uma linha de cdigo. Para habilitar a tecla Enter em um controle durante a execuo de um
Memo1.WantsReturns:= True;
Na fase de projeto:
TMemo, TDBMemo e TRichEdit
TMemo, TDBMemo e TRichEdit
WANTTABS
Descrio
A propriedade WantTabs uma varivel booleana que define se a tabulao est habilitada em um componente.
Exemplo
Voc pode definir a propriedade WantTabs de um componente diretamente no Object Inspector ou
mediante uma linha de cdigo. Para habilitar a tabulao em um controle durante a execuo de um
Memo1.WantsTabs := True;
Na fase de projeto:
TMemo e TDBMemo
TMemo e TDBMemo
WIDTH
Descrio
A propriedade Width uma varivel inteira que define a dimenso horizontal, em pixels, de um
controle ou componente grfico. Para componentes do tipo TScreen, retorna a largura da tela, em
pixels. Para objetos grficos, define a sua espessura em Pixels.
Exemplo
Para alterar a dimenso horizontal de um formulrio chamado Form1 durante a execuo de um
aplicativo, basta incluir a seguinte linha de cdigo no evento correspondente:
Form1.Width := valor;
Na fase de projeto:
Todos os controles.
Todos os controles; TBitmap, TFont, TGraphic, TIcon, TMetafile, TPen e TPicture.
WINDOWMENU
Descrio
A propriedade WindowMenu declarada como uma varivel do tipo TMenuItem que define o menu
que manipular as janelas-filhas de uma aplicao MDI.
Exemplo
Voc pode definir a propriedade WindowMenu de um formulrio diretamente no Object Inspector ou
Form1.WindowMenu := Janelas;
Na fase de projeto:
TForm
TForm
WINDOWSTATE
Descrio
A propriedade WindowState declarada como uma varivel do tipo TWindowState que define o estado
de exibio de um formulrio.
Tabela de Valores:
Exemplo
Voc pode definir a propriedade WindowState de um formulrio diretamente no Object Inspector ou
Form1.WindowState := wsNormal;
Na fase de projeto:
TForm
TForm
WORDWRAP
Descrio
A propriedade WordWrap uma varivel booleana que define se o texto digitado deve passar para a
linha seguinte quando atingir a margem direita do controle.
Exemplo
Voc pode definir a propriedade WordWrap de um componente diretamente no Object Inspector ou
Memo1.WordWrap:= True;
Na fase de projeto:
TDBMemo, TDBText, TLabel, TRichEdit e TMemo
TDBMemo, TDBText, TLabel, TRichEdit e TMemo
Valor Significado
wsNormal O formulrio no est minimizado ou maximizado.
wsMaximized O formulrio est maximizado.
wsMinimized O formulrio est minimizado.
WRAP
Descrio
A propriedade Wrap uma varivel booleana que define se, caso o valor armazenado na propriedade Position
ultrapasse o valor definido na propriedade Max, Position assume o valor definido na propriedade Min.
Exemplo
Voc pode definir a propriedade Wrap de um componente diretamente no Object Inspector ou mediante
UpDown1.Wrap:= True;
Na fase de projeto:
TUpDown
TUpDown
WSAINFO
Descrio
Essa propriedade declarada como um objeto da classe TStringList e armazena informaes sobre a
verso do WinSock usada em uma conexo.
TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMMSGServ, TNMNNTP, TNMPOP3, TNMSMTP, TNMSTRM,
TNMSTRMServ e TPowerSock
ZOOM
Descrio
Para componentes do tipo TOLEContainer, a propriedade Zoom declarada como uma varivel do
tipo TZoomFactor que define o fator de amplificao ou reduo a ser aplicado em um objeto OLE a ser
exibido dentro do componente.
Para componentes dos tipos TQRPreview, a propriedade Zoom declarada como uma varivel inteira
que especifica o nvel de zoom (em percentagem) aplicado sobre a imagem.
Tabela de Valores:
Valor Significado
z025 O objeto OLE exibido com 25% do seu tamanho original.
z100 O objeto OLE exibido com seu tamanho original.
Se o objeto OLE ficar maior do que o componente do tipo TOLEContainer que o contm, ocorrer um clipping (recorte) da imagem,
mas o objeto no ser alterado apenas a sua exibio ser alterada.
Exemplo
Voc pode definir a propriedade Zoom de um componente do tipo TOLEContainer diretamente no
Object Inspector ou mediante uma linha de cdigo, como:
OLEContainer1.Zoom:= z150;
Na fase de projeto:
TOLEContainer e TQRPreview
TOLEContainer e TQRPreview
CAPTULO 42 MTODOS
Captulo
Mtodos
42
BORLAND DELPHI 7 PARTE III: REFERNCIA
ABORT
Descrio
O mtodo Abort interrompe o trabalho de impresso corrente.
Declarao
procedure Abort;
TPrinter
ACTIVATE
Descrio
O mtodo Activate garante que este componente ser o primeiro a responder aos eventos gerados
na aplicao.
Declarao
procedure Activate;
TApplicationEvents
ADD
Descrio
O mtodo Add adiciona um item a uma lista de objetos e, para objetos dos tipos TList, TStrings, TStringList
e TOutline, retorna a posio do item na lista. O tipo de item depende dos objetos armazenados na lista.
Declarao
A declarao depende do tipo de item armazenado na lista.
Para objetos do tipo TList:
Para objetos dos tipos TStrings e TStringList:
function Add(const S: string): Integer;
Para objetos do tipo TMenuItem:
procedure Add(Item: TMenuItem);
Para objetos do tipo TOutline:
function Add(Index: LongInt; const Text: string): LongInt;
Para objetos do tipo TFieldDefs:
procedure Add(const Name: string; DataType: TFieldType; Size: Word);
Para objetos do tipo TIndexDefs:
procedure Add(const Name, Fields: string; Options: TIndexOptions);
Exemplo
O trecho de cdigo a seguir acrescenta um item a uma lista de strings que representa a propriedade
Items de um componente chamado ListBox1 do tipo TListBox e retorna a posio do item em uma
varivel chamada Position:
Position:= ListBox1.Items.Add(Novo item);
TList, TStrings, TStringList, TMenuItem, TOutline, TFieldDefs e TIndexDefs
CAPTULO 42 MTODOS
ADDCHILD
Descrio
O mtodo AddChild adiciona um item como um subitem do item definido no parmetro Index em
um componente do tipo TOutline.
Declarao
function AddChild(Index: LongInt; const Text:
string): LongInt;
Exemplo
O trecho de cdigo a seguir acrescenta um item como subitem do item selecionado em um componente
chamado Outline1 do tipo TOutline:
Outline1.AddChild(Outline1.SelectedItem, Novo item);
TOutline
ADDCHILDOBJECT
Descrio
O mtodo AddChildObject adiciona um item contendo dados como um subitem do item definido no
parmetro Index em um componente do tipo TOutline.
Declarao
function AddChildObject(Index: LongInt; const Text: string; const Data: Pointer): LongInt;
Exemplo
Veja o exemplo do mtodo AddChild.
TOutline
ADDDATABASE
Descrio
Esse mtodo associa um banco de dados, representado por um objeto da classe TIBDatabase,
transao corrente.
Declarao
TIBTransaction
ADDDATASET
Descrio
Esse mtodo associa um banco de dados, representado por um objeto da classe TIBDatabase,
transao corrente.
Declarao
TIBTransaction
ADDICON
Descrio
Esse mtodo adiciona um cone a um objeto do tipo TImageList.
Declarao
function AddIcon(Image: TIcon): Integer;
TImageList
ADDINDEX
Descrio
O mtodo AddIndex adiciona um ndice tabela.
Declarao
TClientDataSet, TSimpleDataset, TIBClientDataset, TIBTable, TTable
ADDMASKED
Descrio
Esse mtodo adiciona um cone a um objeto do tipo TImageList e uma cor usada como mscara
transparente (passada pelo parmetro MaskColor).
Declarao
function AddMasked(Image: TBitmap; MaskColor: TColor): Integer;
TImageList
ADDOBJECT
Descrio
Para objetos do tipo TOutline, esse mtodo adiciona um item contendo dados ao componente.
Para componentes dos tipos TStrings e TStringList, adiciona a string definida no parmetro S, e o
objeto definido no parmetro AObject.
Declarao
Para componentes do tipo TOutline: function AddObject(Index: LongInt; const Text: string; const
Data: Pointer): LongInt;
Para componentes dos tipos TStrings e TStringList: function AddObject(const S: string; AObject:
TObject): Integer;
TStrings, TStringList e TOutline
ADDPASSWORD
Descrio
O mtodo AddPassword usado para adicionar uma nova senha, definida pelo parmetro Password,
ao componente do tipo TSession para uso com tabelas do Paradox.
CAPTULO 42 MTODOS
Declarao
procedure AddPassword(const Password: string);
Exemplo
O trecho de cdigo a seguir adiciona uma senha a um componente do tipo TSession:
Session.AddPassword(Senha);
TSession
ADDSCRIPTFILE
Descrio
Esse mtodo adiciona um arquivo de script, cujo nome passado como parmetro, Applet representada
pelo componente.
Declarao
procedure AddScriptFile(const AFilename: String);
TIWApplet, TIWButton, TIWCheckbox, TIWCombobox, TIWControl, TIWDBCheckbox, TIWDBEdit,
TIWDBFile, TIWDBGrid, TIWDBImage, TIWDBListbox, TIWDBLookupCombobox, TIWDBLookupListbox,
TIWDBMemo, TIWDBNavigator, TIWDBText, TIWEdit, TIWForm, TIWGrid, TIWImage, TIWImageFile,
TIWLabel, TIWLink, TIWList, TIWListbox, TIWMemo, TIWRectangle, TIWTimer, TIWTreeview e TIWURL
ADDSERIES
Descrio
Esse mtodo adiciona uma srie ao grfico exibido no componente.
Declarao
procedure AddSeries(ASeries: TChartSeries);
TChart e TDBChart
ADDSTRINGS
Descrio
Esse mtodo adiciona um grupo de strings, definido pelo parmetro Strings, lista mantida pelo objeto.
Declarao
procedure AddStrings(Strings: TStrings);
TStrings e TStringList
ADDTRANSACTION
Descrio
Esse mtodo associa uma transao representada por um componente TIBTransaction e passada como
parmetro a um banco de dados representado pelo componente.
Declarao
function AddTransaction(TR: TIBTransaction): Integer;
TIBDatabase
ADDXY
Descrio
O mtodo AddXY adiciona um ponto srie representada pelo objeto.
Declarao
function AddXY(Const AXValue, AYValue: Double; Const AXLabel: String; AColor: TColor):
Longint;Exemplo
SCOMPONENTES AOS QUAIS SE APLICA:
TChartSeries
ADDY
Descrio
O mtodo AddY adiciona um ponto srie representada pelo objeto, quando os pontos no possuem
uma abscissa (ex.: grfico de torta).
Declarao
function AddY(Const AYValue: Double; Const AXLabel: String; AColor: TColor): LongInt;
TChartSeries
APPEND
Descrio
Esse mtodo adiciona um registro aps o ltimo registro existente em um banco de dados, depois de
coloc-lo no modo de insero e chamar o seu mtodo Post.
Declarao
procedure Append;
TADODataset, TADOTable, TADOQuery, TADOStoredProc,TIBDataset, TIBTable, TIBQuery,
TIBStoredProc, TTable, TQuery, TStoredProc, TSimpleDataset, TSQLDataset, TSQLTable, TSQLQuery
e TSQLStoredProc
APPENDRECORD
Descrio
Esse mtodo adiciona um registro aps o ltimo registro existente em um banco de dados, usando os
valores passados pelo parmetro Values.
Declarao
procedure AppendRecord(const Values: array of const);
e TSQLStoredProc
APPLYRANGE
Descrio
O mtodo ApplyRange usado para aplicar os valores definidos pelos mtodos SetRangeStart,
SetRangeEnd, EditRangeStart e EditRangeEnd tabela.
CAPTULO 42 MTODOS
Declarao
procedure ApplyRange;
TClientDataSet, TSimpleDataset e TTable
APPLYUPDATES
Descrio
O mtodo ApplyUpdates usado para atualizar os valores de uma tabela com os armazenados no seu cache.
Declarao
TADOQuery, TIBDataset, TIBQuery, TIBTransaction, TClientDataset, TIBClientDataset,
TSimpleDataset e TQuery
ARC
Descrio
O mtodo Arc desenha um arco no permetro da elipse limitada pelo retngulo definido pelas
coordenadas (X1,Y1) e (X2,Y2). O arco comea no ponto de interseo da linha que vai do centro da
elipse ao ponto (X3,Y3) com o retngulo e vai at o ponto em que o retngulo intercepta a linha que
vai do centro da elipse ao ponto (X4,Y4). O desenho feito no sentido anti-horrio.
Declarao
procedure Arc(X1, Y1, X2, Y2, X3, Y3, X4, Y4: Integer);
TCanvas
ARRANGEICONS
Descrio
Em aplicaes MDI, esse mtodo organiza as janelas-filhas que esto minimizadas, de forma que fiquem
igualmente espaadas e no se sobreponham.
Declarao
procedure ArrangeIcons;
Exemplo
O trecho de cdigo a seguir faz com que o mtodo ArrangeIcons seja acionado quando o usurio
seleciona um item de menu Window OrganizarIcones:
procedure TForm1.WindowOrganizarIconesClick(Sender: TObject);
begin
Form1.ArrangeIcons;
end;
TForm
ASSIGN
Descrio
TCurrencyField, TDateField, TDateTimeField, TFloatField, TGraphicField, TIntegerField, TMemoField,
TSmallintField, TStringField, TTimeField, TVarBytesField e TWordField, o mtodo Assign copia o valor
de um campo (definido pelo parmetro Source) em outro (desde que sejam compatveis).
Para objetos do tipo TClipBoard, copia o objeto definido pelo parmetro Source no Clipboard.
Para objetos do tipo TIndexDefs, copia os objetos definidos na propriedade Index do parmetro IndexDefs.
Para objetos do tipo TParams, transfere as informaes do parmetro Params.
Para os demais tipos de objetos, atribui um objeto a outro.
Declarao
Para objetos do tipo TIndexDefs:
procedure Assign(IndexDefs: TIndexDefs);
Para objetos do tipo TParams:
procedure Assign(Param: TParam);
Para os demais objetos:
procedure Assign(Source: TPersistent);
Exemplo
O trecho de cdigo a seguir copia o texto armazenado em um componente Memo1 do tipo TMemo em
um campo MemoField1 do tipo TMemoField:
MemoField1.Assign(Memo1.Lines);
TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField, TClipBoards, TCurrencyField,
TDateField, TDateTimeField, TFloatField, TGraphicField, TIndexDefs, TIntegerField, TMemoField,
TParams, TSmallintField, TStringField, TTimeField, TVarBytesField, TBitmap, TBrush,
TControlScrollBar, TFieldDef, TFont, TIcon, TIndexDef, TMetafile, TPen, TPicture, TStringList,
TStrings e TWordField
ASSIGNVALUE
Descrio
O mtodo AssignValue atribui um valor (especificado no parmetro Value) a um campo.
Declarao
procedure AssignValue(const Value: TVarRec);
Exemplo
O trecho de cdigo atribui uma string a um campo StringField1, do tipo TStringField:
StringField1.AssignValue(nova string atribuda ao valor);
ATLEAST
Descrio
Este mtodo verifica se o nmero de elementos referenciados pela estrutura representada pela classe
(que pode ser uma Fila ou uma Pilha) no mnimo igual ao valor passado como parmetro.
Declarao
function AtLeast(ACount: Integer): Boolean;
TQueue e TStack.
CAPTULO 42 MTODOS
BACK
Descrio
O mtodo Back faz com que o dispositivo multimdia retorne um certo nmero de quadros, especificado
na propriedade Frames.
Declarao
procedure Back;
Exemplo
O trecho de cdigo a seguir faz com que um dispositivo multimdia acione seu mtodo Back com um
boto chamado Back do tipo TButton:
procedure TForm1.BackClick(Sender: TObject);
begin
MediaPlayer1.Back;
end;
TMediaPlayer
BATCHMOVE
Descrio
O mtodo BatchMove usado para copiar, atualizar, adicionar ou deletar registros de uma tabela
representada pelo parmetro ASource e de acordo com o parmetro AMode, que pode ter um dos
seguintes valores: batAppend, batUpdate, batAppendUpdate, batDelete ou batCopy.
Declarao
function BatchMove(ASource: TDataSet; AMode: TBatchMode): LongInt;
TClientDataSet, TTable
BEGINDOC
Descrio
Para componentes do tipo TQRPrinter, esse mtodo inicia o trabalho de impresso de um relatrio e
atribui o valor mbBusy propriedade Status do componente.
Para componentes do tipo TPrinter, indica o incio de um trabalho de impresso.
Declarao
procedure BeginDoc;
TPrinter e TQRPrinter
BEGINDRAG
Descrio
O mtodo BeginDrag inicia o processo de arrastar o controle. Se o valor da varivel Immediate True,
o processo de arrastar ocorre imediatamente. Se Immediate False, o processo no se inicia at que o
usurio mova o ponteiro do mouse a uma distncia de aproximadamente 5 pixels. Isso permite que
um controle aceite um clique de mouse antes de iniciar um processo de arrastar.
Observao: Voc no precisa usar o mtodo BeginDrag quando a propriedade DragMode do controle
tem o valor dmAutomatic.
Declarao
procedure BeginDrag(Immediate: Boolean);
Exemplo
O trecho de cdigo a seguir faz com que um boto chamado Button1 execute o mtodo BeginDrag se
a sua propriedade DragMode for dmManual L:
begin
if Button1.DragMode = dmManual then
Button1.BeginDrag(True);
end;
Todos os controles.
BEGINTRANS
Declarao
Esse mtodo inicializa uma nova transao com o banco de dados.
Descrio
function BeginTrans: Integer;
TADOConnection
BEGINUPDATE
Declarao
Esse mtodo evita que a exibio de um objeto dos tipos TStrings, TStringList ou TOutline seja atualizada
at que se chame o mtodo EndUpdate.
Descrio
procedure BeginUpdate;
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Outline1 execute o seu mtodo
BeginUpdate:
Outline1.BeginUpdate;
TStringList, TStrings e TOutline
BOOKMARKVALID
Descrio
O mtodo BookMarkValid usado para verificar se existe um valor atribudo a um objeto da classe
TBookmark passado como parmetro.
Declarao
function BookmarkValid(Bookmark: TBookmark): Boolean; override;
TClientDataSet, TIBSQLClientDataset, TSimpleDataset e TTable
CAPTULO 42 MTODOS
BRINGTOFRONT
Descrio
O mtodo BringToFront coloca o controle na frente de todos os outros controles que existem no
mesmo formulrio. Uma forma de garantir que um controle est visvel durante a execuo de um
aplicativo definir a sua propriedade Visible como True e utilizar o mtodo BringToFront.
Declarao
procedure BringToFront;
Exemplo
O trecho de cdigo a seguir faz com que um boto de rdio chamado RadioButton1 seja colocado na
frente de todos os outros componentes que existem no mesmo formulrio e que possam estar impedindo
a sua visibilidade:
RadioButton1.BringToFront;
Todos os controles e componentes do tipo TForm.
BROADCAST
Descrio
Esse mtodo envia a mensagem definida no parmetro Message para cada um dos controles-filhos do
controle corrente.
Declarao
procedure Broadcast(var Message);
Todos os controles.
BRUSHCOPY
Descrio
Esse mtodo copia uma poro de um bitmap para o canvas. O parmetro Dest representa a rea
retangular do canvas na qual a rea retangular do bitmap ser copiada. O parmetro Bitmap representa
o bitmap a ser copiado. O parmetro Source representa a rea retangular do bitmap. O parmetro
Color define a cor do bitmap a ser substituda pela cor do canvas.
Declarao
procedure BrushCopy(const Dest: TRect; Bitmap: TBitmap; const Source: TRect; Color: TColor);
TCanvas
CALL
Descrio
Esse mtodo retorna a mensagem de erro cujo cdigo passado como parmetro.
Declarao
function Call(ErrCode: ISC_STATUS; RaiseError: Boolean): ISC_STATUS;
TapplicationEvents, TIBTransaction, TIBDatabase, TIBSQL
CANAUTOSIZE
Descrio
Esse mtodo atribui novos valores s dimenses dos quadros que formam o clipe de vdeo AVI exibido
pelo componente.
Declarao
function CanAutoSize(var NewWidth, NewHeight: Integer): Boolean; override;
TAnimate
CANCEL
Descrio
Para componentes derivados da classe TDataset, esse mtodo cancela as alteraes feitas em um
banco de dados.
Para componentes do tipo TQRPrinter, esse mtodo cancela o trabalho de impresso de um relatrio e
atribui o valor mbReady propriedade Status do componente.
Declarao
procedure Cancel;
TIBStoredProc, TTable, TQuery, TStoredProc, TClientDataset, TIBSQLClientDataset e
TSimpleDataset
CANCELDISPATCH
Descrio
Este mtodo evita que outros objetos desta classe respondam aos eventos gerados pela aplicao.
Declarao
procedure CancelDispatch;
TApplicationEvents
CANCELEVENTS
Descrio
Este mtodo cancela a execuo de eventos pendentes do servidor.
Declarao
procedure CancelEvents;
TIBEvents
CANCELRANGE
Descrio
Esse mtodo remove qualquer limitao de faixas anteriormente estabelecidas pelos mtodos ApplyRange
ou SetRange.
Declarao
procedure CancelRange;
CAPTULO 42 MTODOS
TClientDataSet, TIBSQLClientDataset, TSimpleDataset e TTable
CANCELUPDATES
Descrio
O mtodo CancelUpdates usado para cancelar as modificaes efetuadas nos valores de uma tabela,
armazenados no seu cache.
Declarao
TClientDataSet, TIBSQLClientDataset, TSimpleDataset, TIBTable, TADOTable e TTable
CANFOCUS
Descrio
Esse mtodo determina se o controle pode receber o foco da aplicao.
Declarao
function CanFocus: Boolean;
Exemplo
O trecho de cdigo a seguir faz com que um boto chamado Button1 fique invisvel se um boto
chamado Button2 puder receber o foco:
begin
Button1.Visible := not CanFocus;
end;
Todos os controles.
CASCADE
Descrio
Em aplicaes MDI, esse mtodo faz com que as janelas-filhas se sobreponham em cascata, de forma
que a barra de ttulos das janelas permanea visvel e possa ser selecionada.
Declarao
procedure Cascade;
Exemplo
O trecho de cdigo a seguir faz com que o mtodo Cascade seja acionado quando o usurio seleciona
um item de menu Window| Cascata:
procedure TForm1.WindowCascataClick(Sender: TObject);
begin
Form1.Cascade;
end;
TForm
CELLRECT
Descrio
Esse mtodo retorna uma varivel do tipo TRect para a clula definida pela linha e coluna especificadas
pelos parmetros ARow e ACol, respectivamente.
Declarao
function CellRect(ACol, ARow: LongInt): TRect;
CHANGE
Descrio
Esse mtodo executa o procedimento associado ao evento OnChange do componente.
Declarao
procedure Change; virtual;
TActionList
CHANGELEVELBY
Descrio
Esse mtodo muda o nvel, definido na propriedade Level, de um item do tipo
TOutlineNode.
Declarao
procedure ChangeLevelBy(Value: TChangeRange);
TOutlineNode
CHECKACTIVE
Descrio
Esse mtodo verifica se uma conexo a um banco de dados do Interbase est ativa.
Declarao
procedure CheckActive;
TIBDatabase
CHECKBROWSEMODE
Descrio
Esse mtodo verifica se o banco de dados est aberto e se possui alteraes pendentes. Se sua propriedade
State igual a dsEdit, dsInsert ou dsSetKey, o mtodo Post chamado para concluir as operaes
pendentes. Se o banco de dados estiver fechado, gera um erro de exceo do tipo EDataBaseError.
Declarao
procedure CheckBrowseMode;
TIBStoredProc, TTable, TQuery e TStoredProc, TIBSQLClientDataset, TSimpleDataset, TSQLDataset,
TSQLTable e TSQLQuery
CHECKCLOSED
Descrio
Esse mtodo gera uma exceo se a query definida pelo componente no estiver inativa.
CAPTULO 42 MTODOS
Declarao
procedure CheckClosed;
TIBSQL
CHECKDATABASEINLIST
Descrio
Esse mtodo verifica se s existem componentes TIBDatabase na lista de objetos manipulada pelo componente.
Declarao
procedure CheckDatabasesInList;
TIBTransaction
CHECKDATABASENAME
Descrio
Esse mtodo verifica se a propriedade DatabaseName do componente est em branco.
Declarao
procedure CheckDatabaseName;
TIBDatabase
CHECKINACTIVE
Descrio
Esse mtodo verifica se uma conexo a um banco de dados do Interbase est inativa.
Declarao
procedure CheckInctive;
TIBDatabase
CHECKINTRANSACTION
Descrio
Esse mtodo verifica se a transao est ativa e se s existem componentes TIBDatabase na lista de
objetos manipulada pelo componente.
Declarao
procedure CheckInTransaction;
TIBTransaction
CHECKNOTINTRANSACTION
Descrio
Esse mtodo verifica se a transao no est ativa e se no existem componentes TIBDatabase na lista
de objetos manipulada pelo componente.
Declarao
procedure CheckNotInTransaction;
TIBTransaction
CHECKOPEN
Descrio
Esse mtodo gera uma exceo se a query definida pelo componente no estiver ativa.
Declarao
procedure CheckOpen;
TIBSQL
CHECKVALIDSTATEMENT
Descrio
Esse mtodo gera uma exceo se a query definida pelo componente no possuir uma declarao SQL vlida.
Declarao
procedure CheckValidStatement;
TIBSQL
CLASSINFO
Descrio
Esse mtodo retorna um ponteiro para a tabela RTTI (run time type information) que contm
informaes sobre o objeto corrente.
Declarao
Todos os objetos.
CLASSNAME
Descrio
Esse mtodo retorna em uma string o nome da classe ou objeto do componente.
Declarao
class function ClassName: string;
Exemplo
O trecho de cdigo a seguir faz com que um componente Label1 do tipo TLabel exiba o nome da sua
classe quando o usurio d um clique com o mouse sobre um componente Button1 do tipo TButton:
begin
Label1.Caption := Label1.ClassName;
end;
Observao: Ser exibido TLabel.
Todos os objetos e componentes.
CAPTULO 42 MTODOS
CLASSNAMEIS
Descrio
Esse mtodo define se a string passada no parmetro Name igual ao nome da classe.
Declarao
Todos os objetos.
CLASSPARENT
Descrio
Esse mtodo retorna em uma varivel TClass a classe ou objeto ancestral do qual o componente derivado.
Declarao
Exemplo
O trecho de cdigo a seguir faz com que um componente Label1 do tipo TLabel exiba o nome da
classe da qual derivado quando o usurio d um clique com o mouse sobre um componente But-
ton1 do tipo TButton:
var
classe : TClass;
begin
classe := Label1.ClassParent;
Label1.Caption := classe.ClassName;
end;
Observao: Ser exibido TCustomLabel.
CLASSTYPE
Descrio
Esse mtodo retorna a classe ou objeto do componente.
Declarao
Exemplo
O trecho de cdigo a seguir faz com que um componente Label1 do tipo TLabel exiba o nome da sua
classe quando o usurio d um clique com o mouse sobre um componente Button1 do tipo TButton:
var
classe : TClass;
begin
classe := Label1.ClassType;
Label1.Caption := classe.ClassName;
end;
Observao: Ser exibido TLabel.
CLEANUP
Descrio
Esse mtodo libera a memria ocupada pelas pginas de um relatrio aps o trmino do trabalho de
impresso de um relatrio e atribui o valor mbReady propriedade Status do componente.
Declarao
procedure CleanUp;
TQRPrinter
CLEANUPINSTANCE
Descrio
Esse mtodo finaliza qualquer string ou registro definido na classe e chamado pelo mtodo
FreeInstance.
Declarao
Todos os objetos.
CLEAR
Descrio
TCurrencyField, TDateField, TDateTimeField, TFloatField, TGraphicField, TIntegerField, TMemoField,
TSmallintField, TStringField, TTimeField, TVarBytesField e TWordField, esse mtodo atribui NULL ao
valor do campo correspondente.
Para componentes dos tipos TFieldDefs e TIndexDefs, esse mtodo libera todas as entradas da sua
propriedade Items.
Para objetos do tipo TParam, esse mtodo tem seu valor como NULL.
Para objetos do tipo TParams, esse mtodo deleta toda a informao da sua propriedade Items.
Para objetos dos tipos TClipBoard, esse mtodo remove o contedo da rea de transferncia. Isso
ocorre automaticamente cada vez que um dado colocado na rea de transferncia por meio das
operaes Cut e Copy.
Para objetos dos tipos TList, TStringList, TStrings, TComboBox, TDBComboBox, TDBListBox, TDBMemo,
TDirectoryListBox, TDriveComboBox, TFileListBox, TFilterComboBox, TListBox, TMemo e TOutline,
esse mtodo deleta todas as entradas na propriedade Items.
Para controles dos tipos TDBEdit, TEdit e TMaskEdit, esse mtodo remove o texto da propriedade
Text do controle.
Para objetos da classe TChartSeries, remove todos os pontos da srie.
Para componentes das classes TIWApplet, TIWButton, TIWCheckbox, TIWCombobox, TIWControl,
TIWDBCheckbox, TIWDBEdit, TIWDBFile, TIWDBGrid, TIWDBImage, TIWDBListbox,
TIWDBLookupCombobox, TIWDBLookupListbox, TIWDBMemo, TIWDBNavigator, TIWDBText, TIWEdit,
TIWForm, TIWGrid, TIWImage, TIWImageFile, TIWLabel, TIWLink, TIWList, TIWListbox, TIWMemo,
TIWRectangle, TIWTimer, TIWTreeview e TIWURL, limpa a renderizao atual antes de uma nova renderizao.
CAPTULO 42 MTODOS
Declarao
procedure Clear;
Exemplo
O trecho de cdigo abaixo remove todos os itens de um componente ListBox1 do tipo
TListBox:
ListBox1.Clear;
TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField, TChartSeries,
TCurrencyField, TDateField, TDateTimeField, TFloatField, TGraphicField, TIntegerField,
TMemoField, TSmallintField, TStringField, TTimeField, TVarBytesField, TWordField, TFieldDefs,
TIndexDefs, TParam, TParams, TClipBoard, TList, TStringList, TStrings, TComboBox, TDBComboBox,
TDBListBox, TDBMemo, TDirectoryListBox, TDriveComboBox, TFileListBox, TFilterComboBox,
TListBox, TMemo, TOutline, TDBEdit, TEdit e TMaskEdit
CLEARFIELDS
Descrio
Esse mtodo atribui o valor default a todos os campos do registro corrente em um banco de dados se
sua propriedade State igual a dsEdit; se no, gera um erro de exceo do tipo EDataBaseError.
Declarao
procedure ClearFields;
TIBStoredProc, TTable, TQuery e TStoredProc
CLEARSELECTION
Descrio
Esse mtodo deleta o texto selecionado em um componente.
Declarao
procedure ClearSelection;
Exemplo
O trecho de cdigo abaixo deleta o item selecionado em um componente Memo1 do tipo
TMemo:
Memo1.ClearSelection;
TDBEdit, TDBMemo, TEdit, TMaskEdit e TMemo
CLICK
Descrio
Esse mtodo simula um clique do mouse sobre um componente, forando a execuo do cdigo
associado ao evento OnClick.
Declarao
Para componentes do tipo TDBNavigator:
procedure Click(Button: TNavigateBtn);
Para componentes dos tipos TBitBtn, TButton, TMenuItem e TSpeedButton:
procedure Click;
Exemplo
O trecho de cdigo a seguir faz com que o efeito de clicar sobre um boto chamado Button1 seja o
mesmo de clicar sobre um boto chamado Button2.
begin
Button2.Click;
end;
Componentes TBitBtn, TButton, TDBNavigator, TMenuItem e TSpeedButton
CLIENTTOSCREEN
Descrio
Esse mtodo faz a transformao das coordenadas de um ponto do sistema de coordenadas da rea-
cliente para o sistema de coordenadas da tela.
Declarao
function ClientToScreen(Point: TPoint): TPoint;
Exemplo
O trecho de cdigo que se segue define P e Q como variveis do tipo TPoint no evento OnMouseDown
de um formulrio. Ao ponto P so atribudas as coordenadas do ponto em que o boto do mouse foi
pressionado (sistema de coordenadas da rea-cliente o formulrio) e esses valores so armazenados
no ponto Q aps a transformao para o sistema de coordenadas da tela.
procedure TForm1.FormMouseDown(Sender: TObject; Button: TMouseButton;
var
P, Q: TPoint;
begin
P.X:= X;
P.Y:= Y;
Q:= ClientToScreen(P);
end;
Observao: Note que esse mtodo uma funo e, conseqentemente, o seu valor de retorno pode ser
atribudo a uma varivel.
Todos os controles.
CLOSE
Descrio
Para componentes do tipo TForm, esse mtodo executa o cdigo correspondente ao evento OnClose
aps tentar fechar um formulrio chamando o mtodo CloseQuery cujo valor booleano de retorno
(True ou False) determina se o formulrio pode realmente ser fechado.
Para componentes do tipo TMediaPlayer, esse mtodo fecha o dispositivo multimdia atualmente aberto.
Para objetos do tipo TClipBoard, fecha o objeto.
Para componentes dos tipos TClientDataSet, TTable, TQuery e TStoredProc, fecha o banco de dados
associado e o deixa inativo.
CAPTULO 42 MTODOS
Para componentes dos tipos TADOConnection, TIBDatabase, TDatabase, fecha o banco de dados e
todos os componentes dos tipos TTable, TQuery e TStoredProc a ele relacionados.
Para componentes do tipo TRvProject, fecha o projeto de relatrio representado pelo componente.
Declarao
procedure Close;
Exemplo
O trecho de cdigo a seguir faz com que o mtodo Close de um formulrio denominado Form1 seja
chamado ao se clicar sobre um boto denominado Button1 do tipo TButton.
begin
Form1.Close;
end;
TADOConnection, TADODataset, TADOTable, TADOQuery, TADOStoredProc, TClipBoard, TForm,
TIBDatabase, IBDataset, TIBTable, TIBQuery, TIBStoredProc, TMediaPlayer, TQuery, TRvProject,
TStoredProc e TTable
CLOSEDATABASE
Descrio
O mtodo CloseDatabase usado para fechar um componente do tipo TDatabase usado pela aplicao,
definido no parmetro Database.
Declarao
procedure CloseDatabase(Database: TDatabase);
Exemplo
O trecho de cdigo a seguir fecha um banco de dados chamado Dados:
Session.CloseDatabase(DADOS);
TSession
CLOSEDATASETS
Descrio
Fecha todos os componentes dos tipos derivados de TDataset a ele relacionados, sem fechar o banco de dados.
Declarao
TDatabase, TADOConnection, TSQLConnection e TIBDatabase
CLOSEDIALOG
Descrio
Esse mtodo fecha a caixa de dilogo.
Declarao
procedure CloseDialog;
Exemplo
O trecho de cdigo a seguir fecha a caixa de dilogo FindDialog1 do tipo TFindDialog:
FindDialog1.CloseDialog;
CLOSELINK
Descrio
Esse mtodo encerra uma conversao DDE.
Declarao
function CloseLink;
Exemplo
O trecho de cdigo a seguir encerra uma conversao DDE.
DDEClientConv1.CloseLink;
TDDEClientConv
CLOSEQUERY
Descrio
Esse mtodo executa o cdigo associado ao evento OnCloseQuery de um formulrio e seu valor de
retorno determina se um formulrio poder ou no ser fechado. Se o formulrio for do tipo MDI,
chamar o mtodo OnCloseQuery de todas as suas janelas-filhas, e se uma delas retornar False, este
tambm retornar False.
Declarao
function CloseQuery: Boolean;
Exemplo
O trecho de cdigo a seguir faz com que uma mensagem de confirmao seja exibida quando o usurio
tentar fechar um formulrio:
procedure TForm1.FormCloseQuery(Sender: TObject; var CanClose: Boolean);
var
BotResp: Word;
begin
BotResp:= MessageDlg(Fechar o formulrio?, mtInformation,[mbOk, mbNo],0);
if BotResp = mrOk then
CanClose:= True
else
CanClose:= False;
end;
TForm
CLOSEUP
Descrio
Esse mtodo fecha a lista drop-down aberta no componente.
Declarao
procedure CloseUp;
Exemplo
O trecho de cdigo a seguir executa o mtodo CloseUp em um componente DBLookupCombo1 do
tipo TDBLookupCombo.
DBLookupCombo1.CloseUp;
CAPTULO 42 MTODOS
COLLAPSE
Descrio
Esse mtodo fecha um item do tipo TOutlineNode, atribuindo o valor False sua propriedade Expanded.
Declarao
procedure Collapse;
TOutlineNode
COLORTORGBSTRING
Descrio
Esse mtodo converte uma varivel do tipo TColor passada como parmetro em uma string que define
a representao no formato RGB desta mesma cor.
Declarao
class function ColorToRGBString(AColor: TColor): string;
TIWApplet, TIWButton, TIWCheckbox,
COMMIT
Descrio
Esse mtodo finaliza as transaes pendentes com o banco de dados.
Declarao
procedure Commit;
TDatabase, TIBTransaction e TSQLConnection.
COMMITRETAINING
Descrio
Esse mtodo finaliza as transaes pendentes com o banco de dados e mantm a transao ativa.
Declarao
procedure CommitRetaining;
TDatabase, TIBTransaction
COMMITTRANS
Descrio
Esse mtodo finaliza as transaes pendentes com o banco de dados.
Declarao
procedure CommitTrans;
TADOConnection
COMMITUPDATES
Descrio
O mtodo CommitUpdates usado para gravar permanentemente as modificaes efetuadas nos valores
de uma tabela armazenados no seu cache.
Declarao
procedure CommitUpdates;
TTable
CONNECT
Descrio
Esse mtodo inicializa a conexo desejada.
Declarao
procedure Connect; override;
TNMEcho, TNMFTP, TNMNNTP, TNMPOP3, TNMSMTP, TpowerSock
CONTAINSCONTROL
Descrio
Esse mtodo verifica se um controle contm ou no um outro controle.
Declarao
function ContainsControl(Control: TControl): Boolean;
Exemplo
O trecho de cdigo a seguir verifica se um componente chamado Panel1 do tipo TPanel contm um
componente Edit1 do tipo TEdit.
if Panel1.ContainsControl(Edit1) then ShowMessage(Contm) else ShowMessage(No Contm);
Todos os controles.
CONTENT
Descrio
Esse mtodo retorna em uma string a pgina HTML gerada pelo componente.
Declarao
function Content: string; override;
TMidasPageProducer, TpageProducer, TdataseTTableProducer, TQueryTableproducer,
TDatasetPageProducer
CONTROLATPOS
Descrio
Esse mtodo retorna o controle localizado na posio definida pelo parmetro Pos.
Declarao
function ControlAtPos(Pos: TPoint; AllowDisabled: Boolean): TControl;
CAPTULO 42 MTODOS
Todos os controles.
COPYPARAMS
Descrio
Esse mtodo copia as informaes do procedimento armazenado no servidor no parmetro Value.
Declarao
TStoredProc
COPYRECT
Descrio
Esse mtodo copia uma rea retangular (definida no parmetro Source) de um canvas (definido no
parmetro Canvas) em uma rea retangular (definida no parmetro Dest) do canvas corrente.
Declarao
procedure CopyRect(Dest: TRect; Canvas: TCanvas; Source: TRect);
TCanvas
COPYTOCLIPBOARD
Descrio
Para componentes do tipo TDDEServerConv, esse mtodo transfere o texto definido na propriedade
Lines ou na propriedade Text para o clipboard.
Para componentes dos tipos TDBEdit, TDBMemo, TEdit, TMaskEdit e TMemo, esse mtodo copia o
texto selecionado no controle para o clipboard, substituindo qualquer texto j existente.
Declarao
procedure CopyToClipboard;
Exemplo
O trecho de cdigo a seguir copia o texto selecionado em um controle Edit1 do tipo TEdit para o clipboard:
Edit1.CopyToClipboard;
CORBAOBJECT
Descrio
Esse mtodo retorna um ponteiro para o objeto CORBA associado a essa interface.
Declarao
function CorbaObject: PCorbaObject; stdcall;
Interfaces s quais se aplica:
ICorbaObj
CREATE
Descrio
Esse mtodo faz com que um objeto ou componente seja criado.
Para objetos do tipo TIniFile, aloca a memria necessria para a criao do objeto e passa como argumento
um arquivo .INI. Caso o arquivo no esteja no diretrio do Windows, deve-se passar tambm o seu
path completo.
Para objetos do tipo TOutline, cria um novo n para o objeto TOutline passado pelo parmetro AOwner.
Para objetos do tipo TOutline, cria um novo n para o objeto TOutline passado pelo parmetro AOwner.
Para objetos do tipo TControlScrollBar, cria uma nova barra de rolagem no controle definido pelo
parmetro AControl. O tipo da barra de rolagem definido no parmetro AKind, que pode ser
sbHorizontal ou sbVertical.
Para objetos do tipo TIndexDef, cria um novo objeto com os parmetros Name, Fields e Options e o
adiciona propriedade Items de um objeto definido pelo parmetro Owner.
Para objetos do tipo TBlobStream, cria e faz a ligao de um objeto dos tipos TBlobField, TBytesField ou
TVarBytesField. O parmetro Mode pode ser igual a bmRead, para acessar os dados existentes; bmWrite,
para substituir o valor do campo; e bmReadWrite, para alterar um valor existente.
Para os demais componentes, aloca memria para o componente e inicializa os dados necessrios.
Para os demais objetos, aloca memria para o objeto e inicializa os dados necessrios.
Declarao
A declarao do mtodo depender do objeto a que se refere.
Para objetos do tipo TIniFile:
constructor Create(const FileName: string);
Para objetos do tipo TOutline:
constructor Create(AOwner: TCustomOutline);
Para objetos do tipo TControlScrollBar:
constructor Create (AControl: TScrollingWinControl; AKind: TScrollBarKind);
Para objetos do tipo TIndexDef:
constructor Create(Owner: TIndexDefs; const Name, Fields: string; Options: TIndexOptions);
Para objetos do tipo TBlobStream:
constructor Create(Field: TBlobField; Mode: TBlobStreamMode);
Para os demais componentes:
constructor Create(AOwner: TComponent);
Para os demais objetos:
constructor Create;
Exemplo
O trecho de cdigo a seguir cria um boto chamado Button1 do tipo TButton, pertencente
a um formulrio chamado Form1.
var
Button1 : TButton;
begin
Button1 := TButton.Create(Form1);
end;
CAPTULO 42 MTODOS
Todas as classes, componentes e objetos.
CREATEDATABASE
Descrio
Esse mtodo cria um novo banco de dados, configurando-o de acordo com os valores armazenados na
sua propriedade Params.
Declarao
procedure CreateDatabase;
TIBDatabase
CREATEFIELD
Descrio
Esse mtodo cria um novo objeto do tipo TField, pertencente ao componente definido pelo parmetro Owner.
Declarao
function CreateField(Owner: TComponent): TField;
TFieldDef
CREATEFORM
Descrio
Esse mtodo cria um novo formulrio para a aplicao, cujo tipo especificado no parmetro FormClass,
e o atribui varivel definida pelo parmetro Reference.
Declarao
procedure CreateForm(FormClass: TFormClass; var Reference);
TApplication
CREATEFMT
Descrio
Esse outro mtodo construtor de classes derivadas de Exception e recebe como parmetros uma
string, que ser mostrada na caixa de dilogo exibida quando a exceo ocorrer durante a execuo do
programa, e uma array contendo cdigos de formatao para essa string.
Declarao
constructor CreateFmt (const Msg: string; const Args: array of const)
EAbort, EAbstractError, EAccessViolation, EArrayError, EAssertinFailed, EBitsError,
EBrokerException, ECacheError, EClassNotFound, ECommomCalendarError, EComponentError,
EControlC, EConvertError, EDataBaseError, EDateTimeError, EDBClient, EDBEditError,
EDBEngineError, EDimensionMapError, EDimIndexError, EDivByZero, EDSWriter, EExternal,
EExternalException, EFCreateError, EFilerError, EFOpenError, EHeapException, EInOutError,
EInterpreterError, EIntError, EIntCastError, EIntOverFlow, EInvalidArgument, EInvalidCast,
EInvalidGraphic, EInvalidGraphicOperation, EInvalidGridOperation, EInvalidImage, EInvalidOp,
EInvalidOperation, EInvalidPointer, EListError, ELowCapacityError, EMathError,
EMCIDeviceError, EMenuError, EMonthCalError, ENoResultError, EOLECtrlError, EOLEError,
EOLEException, EOLESysError, EOutLineError, EOutOfMemory, EOutOfResources, EOverflow,
EPackageError, EParserError, EPrinter, EPrivilege, EPropertyError, EPropReadOnly,
EPropWriteOnly, ERangeError, ERadError, EReconcileError, ERegistryError, EResNotFound,
ESocketConnectionError, ESocketError, EStackOverflow, EStreamError, EStringListError, EThread,
ETreeViewError, EUnderFlow, EUnSupportedTypeError, EUpdateError, EVariantError, EWin32Error,
EWriteError, Exception, EZeroDivide
CREATEFMTHELP
Descrio
programa; uma array, contendo cdigos de formatao para essa string; e um inteiro, identificando o
tpico do arquivo de Help On-line a ser associado classe.
Declarao
constructor CreateFmtHelp (const Msg: string; const Args: array of const; AHelpContext: Integer);
CREATEHELP
Descrio
programa, e um inteiro, identificando o tpico do arquivo
de Help On-line a ser associado classe.
Declarao
constructor CreateHelp (const Msg: string; AHelpContext: Integer);
EWriteError, Exception, EzeroDivide
CAPTULO 42 MTODOS
CREATEINDEXFILE
Descrio
Esse mtodo cria um arquivo de ndices para tabelas no formato dBASE.
Declarao
procedure CloseIndexFile(const IndexFileName: string);
TTable
CREATENEW
Descrio
Esse mtodo cria uma nova instncia do formulrio corrente.
Declarao
constructor CreateNew(AOwner: TComponent);
TForm
CREATERES
Descrio
Esse outro mtodo construtor de classes derivadas de Exception e recebe como parmetro um inteiro
que identifica uma string armazenada no arquivo de recursos do seu aplicativo.
Declarao
constructor CreateRes (Ident: Integer; Dummy: Extended = 0);
CREATERESFMT
Descrio
Esse outro mtodo construtor de classes derivadas de Exception e recebe como parmetros um inteiro,
que identifica uma string armazenada no arquivo de recursos do seu aplicativo, e uma array, contendo
cdigos de formatao para essa string.
Declarao
CREATERESFMTHELP
Descrio
Esse outro mtodo construtor de classes derivadas de Exception e recebe como parmetros um inteiro,
que identifica uma string armazenada no arquivo de recursos do seu aplicativo; uma array, contendo
cdigos de formatao para essa string; e um valor inteiro, que identifica o cdigo do arquivo de Help
associado a essa classe.
Declarao
constructor CreateResFmtHelp(Ident: Integer; const Args: array of const; AHelpContext:
Integer);
CREATESIZE
Descrio
Esse mtodo cria um objeto do tipo TImageList cujo tamanho definido pelos parmetros Height
(altura) e Width (largura).
Declarao
constructor CreateSize(AWidth, AHeight: Integer);
TImageList
CREATETABLE
Descrio
Esse mtodo cria uma nova tabela para o banco de dados associado.
CAPTULO 42 MTODOS
Declarao
TIBTable, TTable
CURSORPOSCHANGED
Descrio
Esse mtodo s utilizado quando a propriedade Handle usada para obter acesso direto API do
Borland Database Engine ou outro mecanismo de acesso para notificar o banco de dados sobre a
mudana da posio do cursor.
Declarao
procedure CursorPosChanged;
TADODataset, TADOTable, TADOQuery, TADOStoredProc, TIBDataset, TIBTable, TIBQuery,
TIBStoredProc, TTable, TQuery, TStoredProc, TSQLDataset, TSQLTable, TSQLQuery e TSQLStoredProc
CUTTOCLIPBOARD
Descrio
Esse mtodo copia o texto selecionado no controle para o clipboard, deletando-o e substituindo qualquer
texto j existente no clipboard.
Declarao
procedure CutToClipboard;
Exemplo
O trecho de cdigo a seguir copia o texto selecionado em um controle Edit1 do tipo TEdit para o clipboard.
Edit1.CutToClipboard;
TDBEdit, TDBImage, TDBMemo, TEdit, TMaskEdit e TMemo
DELETE
Descrio
Para componentes derivados da classe TDataset, esse mtodo s usado para deletar um registro de um
banco de dados (o registro anterior passa a ser o registro corrente, exceto se o registro deletado for o
ltimo do banco de dados nesse caso o registro anterior passa a ser o corrente).
Para objetos dos tipos TImageList, TList, TStringList e TStrings e componentes do tipo TMenuItem,
deleta o item especificado no parmetro Index.
Declarao
Para componentes dos tipos TADODataset, TADOTable, TADOQuery, TADOStoredProc, TIBDataset,
TIBTable, TIBQuery, TIBStoredProc, TTable, TQuery, TStoredProc, TSimpleDataset, TSQLDataset,
TSQLTable, TSQLQuery e TSQLStoredProc.
procedure Delete;
Para objetos dos tipos TImageList, TList, TStringList e TStrings e componentes do tipo TMenuItem:
TImageList, TList, TStringList, TStrings, TMenuItem, TADODataset, TADOTable, TADOQuery,
TADOStoredProc, TIBDataset, TIBTable, TIBQuery, TIBStoredProc, TTable, TQuery, TStoredProc,
TSimpleDataset, TSQLDataset, TSQLTable, TSQLQuery e TSQLStoredProc
DELETEINDEX
Descrio
Esse mtodo deleta um ndice secundrio (definido no parmetro Name) em uma tabela.
Declarao
TIBTable, TTable
DELETETABLE
Descrio
Esse mtodo deleta uma tabela de um banco de dados.
Declarao
TIBTable, TTable
DESCRIPTIONAVAILABLE
Descrio
Esse mtodo verifica se as informaes do procedimento armazenado no servidor esto disponveis.
Declarao
function DescriptionsAvailable: Boolean;
TStoredProc
DESIGNREPORT
Descrio
Esse mtodo abre o arquivo de projeto de relatrio para edio.
Declarao
procedure DesignReport(ReportName: string);
TRvProject
DESTROY
Descrio
Esse mtodo destri um componente ou objeto, liberando a memria a ele alocada.
Declarao
destructor Destroy;
Exemplo
A linha de cdigo a seguir mostra um boto Button1 do tipo TButton executando o seu mtodo Destroy.
Button1.Destroy;
CAPTULO 42 MTODOS
Todos os objetos, controles e componentes.
DESTROYCOMPONENTS
Descrio
Esse mtodo destri os componentes-filhos do componente corrente.
Declarao
procedure DestroyComponents;
DESTROYING
Descrio
Esse mtodo altera o valor da propriedade ComponentState dos componentes-filhos do componente
corrente e os destri.
Declarao
procedure Destroying;
DISABLEALIGN
Descrio
Esse mtodo desabilita o realinhamento automtico dos controles-filhos do controle corrente.
Declarao
procedure DisableAlign;
Todos os controles.
DISABLECONTROLS
Descrio
Esse mtodo desconecta temporariamente o banco de dados de todos os componentes a ele associados
(do tipo TDataSource).
Declarao
procedure DisableControls;
TIBStoredProc, TTable, TQuery, TStoredProc, TSimpleDataset, TSQLDataset, TSQLTable, TSQLQuery,
TSQLStoredProc, TClientDataset, TSimpleDataset e TIBClientDataset
DISCONNECT
Descrio
Esse mtodo encerra a conexo atual.
Declarao
procedure DisConnect; override;
TNMEcho, TNMFTP, TNMNNTP, TNMPOP3, TNMSMTP, TPowerSock
DISPATCH
Descrio
Esse mtodo chama os mtodos de manipulao de mensagens, dependendo do valor passado no
parmetro Message.
Declarao
procedure Dispatch(var Message);
Todos os objetos.
DOHINT
Descrio
Esse mtodo executa o procedimento associado ao evento OnHint do objeto (se este estiver definido),
passando como parmetro uma string representando seu hint.
Declarao
function DoHint(var HintStr: string): Boolean;
TAction
DOTERMINATE
Descrio
Esse mtodo dispara o procedimento associado ao evento OnTerminate de uma thread, sem, no
entanto, finaliz-la.
Declarao
procedure DoTerminate; virtual;
TThread
DRAGGING
Descrio
Esse mtodo especifica se um componente est sendo arrastado ou no.
Declarao
function Dragging: Boolean;
Exemplo
O trecho de cdigo a seguir verifica se um boto de rdio chamado RadioButton1 est ou no sendo
arrastado, se o resultado do mtodo Dragging for True ou False. Em caso positivo, lhe atribui a cor amarela.
if RadioButton1.Dragging then RadioButton1.Color := clYellow;
Todos os controles.
CAPTULO 42 MTODOS
DRAGLOCK
Descrio
Esse mtodo associa a imagem que est sendo arrastada com o handle passado no
parmetro Window e a desenha na posio definida pelos parmetros XPos e YPos.
Declarao
function DragLock(Window: HWND; XPos, YPos: Integer): Boolean;
TListImage
DRAGUNLOCK
Descrio
Esse mtodo remove uma associao feita pelo mtodo DragLock.
Declarao
procedure DragUnLock;
TListImage
DRAW
Descrio
Esse mtodo desenha um objeto grfico (definido no parmetro Graphic) nas coordenadas (X,Y) do
canvas corrente.
Declarao
procedure Draw(X, Y: Integer; Graphic: TGraphic);
TCanvas
DRAWFOCUSRECT
Descrio
Esse mtodo desenha um retngulo de foco definido pelo parmetro Rect.
Declarao
TCanvas
DRAWOVERLAY
Descrio
Esse mtodo desenha uma imagem e um overlay no objeto do tipo TCanvas passado pelo parmetro Canvas.
Declarao
procedure DrawOverlay(Canvas: TCanvas; X, Y: Integer; ImageIndex: Integer; Overlay: TOverlay);
TListImage
DROPCONNECTIONS
Descrio
O mtodo DropConnections desfaz todas as conexes com bancos de dados inativos.
Declarao
procedure DropConnections;
Exemplo
O trecho de cdigo a seguir desfaz todas as conexes com bancos de dados inativos.
Session. DropConnections;;
TSession
DROPDATABASE
Descrio
Esse mtodo remove o banco de dados representado pelo componente.
Declarao
procedure DropDatabase;
TIBDatabase
DROPDOWN
Descrio
Esse mtodo faz com que seja exibida a lista drop-down correspondente ao controle, para que o usurio
possa escolher um dos valores apresentados.
Declarao
procedure DropDown;
Exemplo
O trecho de cdigo a seguir executa o mtodo DropDown em um componente DBLookupCombo1 do
tipo TDBLookupCombo.
DBLookupCombo1.DropDown;
EDIT
Descrio
Para componentes derivados da classe TDataset, esse mtodo prepara o registro corrente do banco de
dados para edio e atribui o valor dsEdit propriedade State.
Para componentes do tipo TDataSource, se sua propriedade AutoEdit possuir o valor True e sua
propriedade State possuir o valor dsBrowse, esse mtodo executa o mtodo de mesmo nome dos
componentes derivados da classe TDataset.
Declarao
procedure Edit;
TDataSource, TClientDataset, TSimpleDataset, TIBClientDataset, TTable e TQuery
EDITKEY
Descrio
Esse mtodo modifica o contedo do buffer de pesquisa.
CAPTULO 42 MTODOS
Declarao
procedure EditKey;
TClientDataSet, TSimpleDataset, TIBClientDataset e TTable
EDITRANGEEND
Descrio
Esse mtodo permite que se modifique o valor definido pelo mtodo SetRangeEnd.
Declarao
procedure EditRangeEnd;
TClientDataset, TSimpleDataset, TIBClientDataset e TTable
EDITRANGESTART
Descrio
Esse mtodo permite que se modifique o valor definido pelo mtodo SetRangeStart.
Declarao
procedure EditRangeStart;
TClientDataset, TSimpleDataset, TIBClientDataset e TTable
EJECT
Descrio
O mtodo Eject executa a ejeo em um dispositivo multimdia.
Declarao
procedure Eject;
Exemplo
O trecho de cdigo a seguir faz com que um dispositivo multimdia acione seu mtodo Eject com um
boto chamado Eject do tipo TButton:
procedure TForm1.EjectClick(Sender: TObject);
begin
MediaPlayer1.Eject;
end;
TMediaPlayer
ELLIPSE
Descrio
Esse mtodo desenha no canvas uma elipse inscrita em um retngulo definido por (X1,Y1) vrtice
superior esquerdo e (X2,Y2) vrtice inferior direito.
Declarao
procedure Ellipse(X1, Y1, X2, Y2: Integer);
TCanvas
EMPTYTABLE
Descrio
Esse mtodo deleta todos os registros da tabela especificada na propriedade TableName.
Declarao
TClientDataset, TSimpleDataset, TIBClientDataset, TIBTable, TTable
ENABLEALIGN
Descrio
Esse mtodo habilita o realinhamento automtico dos controles-filhos do controle corrente.
Declarao
procedure EnableAlign;
Todos os controles.
ENABLECONTROLS
Descrio
Esse mtodo restaura a conexo do banco de dados de todos os componentes a ele associados (do tipo
TDataSource) que haviam sido desconectados por uma chamada ao mtodo DisableControls.
Declarao
procedure EnableControls;
TIBStoredProc, TTable, TQuery,TStoredProc, TSQLDataset, TSQLTable, TSQLQuery, TSQLStoredProc,
TClientDataset, TSimpleDataset e TIBClientDataset
ENDDOC
Descrio
Para componentes do tipo TQRPrinter, esse mtodo indica o trmino do trabalho de impresso de um
relatrio e atribui o valor mbFinished propriedade Status do componente.
Para componentes do tipo TPrinter, indica o trmino do trabalho corrente de impresso.
Declarao
procedure EndDoc;
TQRPrinter e TPrinter
ENDDRAG
Descrio
O mtodo EndDrag encerra o processo de arrastar o controle. Se o valor da varivel Drop True, o
controle solto sobre um controle receptor.
Declarao
procedure EndDrag(Drop: Boolean);
CAPTULO 42 MTODOS
Exemplo
O trecho de cdigo a seguir encerra o processo de arrastar um boto chamado Button1 e o solta sobre
o seu componente.
Button1.EndDrag(True);
Todos os controles.
ENDUPDATE
Descrio
Esse mtodo atualiza a exibio de um objeto dos tipos TStrings, TStringList ou TOutline.
Declarao
procedure EndUpdate;
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Outline1 execute o seu mtodo
EndUpdate:
Outline1.EndUpdate;
TStringList, TStrings e TOutline
ERASESECTION
Descrio
Esse mtodo apaga uma seo (definida no parmetro Section) no arquivo INI.
Declarao
procedure EraseSection(const Section: string);
TIniFile
EXCHANGE
Descrio
Esse mtodo muda a posio de dois itens de uma lista de objetos, definidos por seus ndices nos
parmetros Index1 e Index2.
Declarao
TList, TStrings e TOutline
EXECPROC
Descrio
Esse mtodo executa o procedimento armazenado no servidor.
Declarao
procedure ExecProc;
TADOStoredProc, TIBStoredProc, TSQLStoredProc e TStoredProc
EXECQUERY
Descrio
Esse mtodo executa a query definida pelo componente.
Declarao
procedure ExecQuery;
TIBSQL
EXECSQL
Descrio
Esse mtodo executa uma declarao SQL definida na propriedade SQL do componente. Use-o para
declaraes dos tipos INSERT, UPDATE, DELETE.
Declarao
procedure ExecSQL;
TIBSQL, TIBQuery, TADOQuery, TSQLQuery e TQuery
EXECUTE
Descrio
Para componentes do tipo TBatchMove, esse mtodo realiza a operao de transferncia de dados da
tabela-origem (especificada na sua propriedade Source) para a tabela-destino (especificada na sua
propriedade Destination).
Para componentes dos tipos TColorDialog, TFontDialog, TOpenDialog, TOpenPictureDialog,
TPrintDialog, TPrintSetupDialog e TSaveDialog, TSavePictureDialog exibe a caixa de dilogo e define
se o usurio pressionou o boto OK.
Para objetos da classe TAction, executa o procedimento associado ao evento OnExecute.
Para objetos da classe TThread, define o cdigo a ser executado quando a thread inicializada.
Para objetos da classe TADOCommand, executa o comando definido na sua propriedade CommandText.
Para objetos da classe TSQLConnection, executa um comando SQL no banco de dados.
Para objetos da classe TRvProject, inicia a impresso do projeto de relatrio representado pelo componente.
Declarao
Para objetos da classe TAction:
function Execute: Boolean; override;
Para componentes do tipo TADOCommand, este mtodo sobrecarregado com as seguintes declaraes:
function Execute: _RecordSet; overload;
function Execute(const Parameters: OleVariant): _Recordset; overload;
function Execute(var RecordsAffected: Integer; var Parameters: OleVariant; ExecuteOptions:
TExecuteOption[]): _RecordSet; overload;
Para componentes dos tipos TbatchMove, TPrinterSetupDialog e TRvProject:
procedure Execute;
CAPTULO 42 MTODOS
Para componentes do tipo TColorDialog, TFontDialog, TOpenDialog, TOpenPictureDialog,
TPrintDialog, TSaveDialog e TSavePictureDialog:
function Execute: Boolean;
Para objetos da classe TThread:
procedure Execute; virtual; abstract;
Para objetos da classe TSQLConnection:
function Execute(const SQL: string; Params: TParams
; ResultSet:Pointer=nil): Integer;
Exemplo
O trecho de cdigo a seguir faz com que um componente TBatchMove execute o seu mtodo Execute:
BatchMove1.Execute;
TADOCommand, TAction, TBatchMove, TThread, TPrinterSetupDialog, TColorDialog, TFontDialog,
TOpenDialog, TOpenPictureDialog, TPrintDialog e TSaveDialog, TsavePictureDialog e
TSQLConnection
EXECUTEACTION
Descrio
Esse mtodo executa o procedimento associado ao evento OnExecute do componente.
Declarao
function ExecuteAction(Action: TBasicAction): Boolean; override;
TActionList
EXECUTEMACRO
Descrio
Esse mtodo tenta executar uma macro, definida em uma string, em uma aplicao servidora. O
parmetro WaitFlg define se sua aplicao deve aguardar a execuo da macro na aplicao servidora.
Declarao
function ExecuteMacro(Cmd: PChar; WaitFlg: Boolean): Boolean;
TDDEClientConv
EXECUTEMACROLINES
Descrio
Esse mtodo tenta executar uma macro, definida em uma lista de strings, em uma aplicao servidora.
O parmetro WaitFlg define se sua aplicao deve aguardar a execuo da macro na aplicao servidora.
Declarao
function ExecuteMacroLines(Cmd: TStrings; WaitFlg: Boolean): Boolean;
TDDEClientConv
EXECUTEREPORT
Descrio
Esse mtodo inicia a impresso do projeto de relatrio representado pelo componente, e cujo nome
Declarao
procedure ExecuteReport(ReportName: string);
TRvProject
EXPAND
Descrio
Para objetos do tipo TOutlineNode, esse mtodo abre um item do tipo TOutlineNode, atribuindo o
valor True sua propriedade Expanded.
Para objetos do tipo TList, esse mtodo aumenta a capacidade de armazenamento de uma lista de
objetos, alterando o valor da sua propriedade Capacity.
Declarao
Para objetos do tipo TOutlineNode:
procedure Expand;
Para objetos do tipo TList:
TList e TOutlineNode
FIELDADDRESS
Descrio
Esse mtodo retorna em um ponteiro o endereo do objeto definido pelo parmetro Name.
Declarao
Todos os objetos.
FIELDBYNAME
Descrio
Esse mtodo retorna o objeto do tipo TField especificado no parmetro FieldName. Se no for encontrado,
gera um erro de exceo.
Declarao
function FieldByName(const FieldName: string): TField;
TADODataset, TADOTable, TADOQuery, TADOStoredProc, TIBDataset, TIBTable, TIBQuery, TIBSQL,
TIBStoredProc, TTable, TQuery, TStoredProc, TSQLDataset, TSQLTable, TSQLQuery, TSQLStoredProc,
CAPTULO 42 MTODOS
FILELOAD
Descrio
Esse mtodo carrega um arquivo do tipo TResType em um objeto do tipo TImageList. O
parmetro MaskColor define a cor da mscara transparente da imagem.
Declarao
function FileLoad(ResType: TResType; Name: string; MaskColor: TColor): Boolean;
TImageList
FILLRECT
Descrio
Esse mtodo preenche a rea retangular do canvas definida pelo parmetro Rect com o pincel corrente.
Declarao
procedure FillRect(const Rect: TRect);
TCanvas
FINDCOMPONENT
Descrio
O mtodo FindComponent retorna o componente pertencente array Components cuja propriedade
Name igual definida no parmetro AName.
Declarao
function FindComponent(const AName: string): TComponent;
Exemplo
Coloque vrios componentes em um formulrioForm1, incluindo um componente Edit1 do tipo TEdit
e um boto Button1. Quando o usurio selecionar o boto Button1, o valor da propriedade
ComponentIndex de Edit1 ser exibido pelo prprio componente Edit1:
var
TheComponent: TComponent;
begin
TheComponent := FindComponent(Edit1);
Edit1.Text := IntToStr(TheComponent.ComponentIndex);
end;
FINDDATABASE
Descrio
Para objetos da classe TIBTransaction, retorna o ndice, na sua propriedade Databases, do objeto da
classe TIBDatabase, passado como parmetro.
Para objetos da classe TSession, retorna o ndice, na sua propriedade Databases, do objeto da classe
TDatabase, cujo nome passado como parmetro.
Declarao
Para objetos da classe TIBTransaction:
function FindDatabase (db: TIBDatabase): Integer;
Para objetos da classe TSession:
function FindDatabase(const DatabaseName: String): TDatabase;
TSession, TIBTransaction
FINDFIELD
Descrio
Esse mtodo retorna o objeto do tipo TField especificado no parmetro FieldName. Se no for
encontrado, retorna nil.
Declarao
function FindField(const FieldName: string): TField;
FINDKEY
Descrio
Esse mtodo pesquisa todos os registros em uma tabela at encontrar aquele cujos ndices dos campos
correspondam aos definidos no parmetro KeyValues.
Declarao
function FindKey(const KeyValues: array of const): Boolean;
TClientDataSet, TIBClientDataset, TSimpleDataset e TTable
FINDNEAREST
Descrio
Esse mtodo pesquisa todos os registros em uma tabela at encontrar o prximo registro cujos ndices
dos campos forem iguais ou superiores aos definidos no parmetro KeyValues.
Declarao
procedure FindNearest(const KeyValues: array of const);
TClientDataSet, TIBClientDataset, TSimpleDataset e TTable
FINDNEXTPAGE
Descrio
Esse mtodo retorna a prxima pgina do controle. Se o parmetro GoForWard for igual a True, a
prxima pgina ser a pgina numericamente subseqente. Se o parmetro GoForWard for igual a
False, a prxima pgina ser a pgina numericamente anterior.
Declarao
function FindNextPage(CurPage: TTabSheet; GoForward, CheckTabVisible: Boolean): TTabSheet
CAPTULO 42 MTODOS
TPageControl
FINDTRANSACTION
Descrio
Esse mtodo retorna o ndice da transao representada por um objeto da classe TIBTransaction passado
como parmetro.
Declarao
function FindTransaction (TR: TIBTransaction): Integer;
TIBDatabase
FIRST
Descrio
Para componentes do tipo TTable, TStoredProc e TQuery, esse mtodo move o ponteiro
para o primeiro registro do banco de dados.
Para componentes do tipo TList, esse mtodo retorna um ponteiro que aponta para o primeiro
objeto da lista.
Declarao
Para componentes dos tipos derivados da classe TDataset:
procedure First;
Para componentes do tipo TList:
TADODataset, TADOTable, TADOQuery, TADOStoredProc, TClientDataset, TIBClientDataset,
TIBDataset, TIBTable, TIBQuery, TIBStoredProc, TTable, TQuery, TStoredProc, TSimpleDataset,
TSQLDataset, TSQLTable, TSQLQuery e TSQLStoredProc
FLOODFILL
Descrio
Esse mtodo preenche a superfcie da tela com o pincel corrente, comeando no ponto (X,Y) e
espalhando-se por todas as direes at encontrar a cor definida com o contorno (parmetro Color).
Declarao
procedure FloodFill(X, Y: Integer; Color: TColor; FillStyle: TFillStyle);
TCanvas
FOCUSCONTROL
Descrio
Esse mtodo coloca o foco da aplicao no primeiro controle associado ao banco de dados que contm
o campo que chama o mtodo.
Declarao
function FocusControl;
Exemplo
O trecho de cdigo a seguir faz com que um campo StringField1, do tipo TStringField, acione seu
mtodo FocusControl:
StringField1.FocusControl;
FOCUSED
Descrio
O mtodo Focused informa se o controle possui o foco da aplicao, isto , se ele o controle ativo.
Declarao
function Focused: Boolean;
Exemplo
O trecho de cdigo a seguir verifica se um controle chamado Edit1 do tipo TEdit possui o foco da
aplicao quando o usurio tenta encerr-la. Se Edit1 possuir o foco, ser exibida uma mensagem.
procedure TForm1.FormClose(Sender: TObject; var Action: TCloseAction);
begin
If Edit1.Focused then ShowMessage(Edit1 possui o foco);
end;
Todos os controles.
FRAMERECT
Descrio
Esse mtodo desenha um retngulo definido pelo parmetro Rect, pintando a sua borda com o
pincel corrente.
Declarao
procedure FrameRect(const Rect: TRect);
TCanvas
FREE
Descrio
Esse mtodo destri um componente, liberando toda a memria a ele alocada. Este apresenta uma
vantagem sobre o mtodo Destroy, pois no gera um erro quando o objeto no existe.
Declarao
procedure Free;
Exemplo
A linha de cdigo a seguir mostra um boto Button1 do tipo TButton executando o seu mtodo Free.
Button1.Free;
Todos os objetos, controles e componentes.
CAPTULO 42 MTODOS
FREEBOOKMARK
Descrio
Esse mtodo libera os recursos do sistema reservados por uma chamada ao mtodo GetBookmark.
Declarao
procedure FreeBookmark(Bookmark: TBookmark);
TIBStoredProc, TTable, TQuery, TStoredProc,TSQLDataset, TSQLTable, TSQLQuery, TSQLStoredProc,
FREEINSTANCE
Descrio
Esse mtodo libera a memria alocada pelo mtodo NewInstance, aps chamar o mtodo IntanceSize.
Declarao
Todos os objetos.
FREENOTIFICATION
Descrio
Esse mtodo notifica o componente definido no parmetro AComponent antes de destru-lo.
Declarao
procedure FreeNotification(AComponent: TComponent);
FULLCOLLAPSE
Descrio
Esse mtodo oculta todos os subitens em um componente do tipo TOutline.
Declarao
procedure FullCollapse;
Exemplo
O trecho de cdigo a seguir faz com que um componente Outline1 execute o seu mtodo FullCollapse:
Outline1. FullCollapse;
TOutline
FULLEXPAND
Descrio
Esse mtodo exibe todos os subitens em um componente do tipo TOutlineNode ou todos os subitens
de todos os itens de um componente TOutline.
Descrio
procedure FullExpand;
Exemplo
O trecho de cdigo a seguir faz com que um componente Outline1 execute o seu mtodo FullExpand:
Outline1. FullExpand;
TOutline
GETALIASNAMES
Descrio
Esse mtodo armazena, em uma lista de strings, os nomes dos aliases definidos no Borland DataBase Engine.
Declarao
procedure GetAliasNames(List: TStrings);
Exemplo
O trecho de cdigo a seguir armazena, em uma lista de strings chamada Lista_Aliases, os nomes dos
aliases definidos no Borland DataBase Engine:
Session.GetAliasNames(Lista_aliases);
TSession
GETALIASPARAMS
Descrio
Esse mtodo armazena, em uma lista de strings, os parmetros associados a um alias do BDE definido
pelo parmetro AliasName.
Declarao
procedure GetAliasParams(const AliasName: string; List: TStrings);
TSession
GETASHANDLE
Descrio
Esse mtodo retorna um handle para o objeto armazenado no clipboard.
Declarao
function GetAsHandle (Format: Word): THandle;
TClipBoard
GETBITMAP
Descrio
Esse mtodo retorna a imagem especificada no parmetro Index como um bitmap no parmetro
Image do tipo TBitmap.
Declarao
procedure GetBitmap(Index: Integer; Image: TBitmap);
TImageList
CAPTULO 42 MTODOS
GETBOOKMARK
Descrio
Esse mtodo salva a informao de um registro de um banco de dados, de forma a poder acess-lo por
uma chamada posterior ao mtodo GotoBookmark.
Declarao
procedure GetBookmark(Bookmark: TBookmark);
GETCHILDREN
Descrio
Esse mtodo executa o procedimento passado como parmetro para cada uma das aes definidas no
componente (definidas como objetos da classe TAction).
Declarao
procedure GetChildren(Proc: TGetChildProc; Root: TComponent); override;
TActionList
GETCOMPONENT
Descrio
Esse mtodo retorna um componente armazenado no clipboard e o ajusta de acordo com os parmetros
Owner e Parent.
Declarao
function GetComponent(Owner, Parent: TComponent): TComponent;
TClipBoard
GETDATA
Descrio
Esse mtodo retorna no parmetro Buffer o dado armazenado no campo. Se o buffer no tiver espao
suficiente para armazenar o dado, retorna False.
Declarao
function GetData(Buffer: Pointer): Boolean;
Exemplo
O trecho de cdigo a seguir transfere o dado de um campo StringField1, do tipo TStringField, para um
buffer temporrio:
with StringField1 do
begin
GetMem(Buffer, DataSize);
if not Field1.GetData(Buffer) then ShowMessage(FieldName + is NULL);
end;
GETDATABASENAMES
Descrio
Esse mtodo armazena, em uma lista de strings, os nomes dos bancos de dados e respectivos aliases
definidos no Borland DataBase Engine para a aplicao.
Declarao
procedure GetDatabaseNames(List: TStrings);
Exemplo
O trecho de cdigo a seguir armazena, em uma lista de strings denominada Lista, os nomes dos bancos
de dados e respectivos aliases definidos no Borland DataBase Engine para a aplicao:
Session.GetDatabaseNames(Lista);
TSession
GETDATAITEM
Descrio
O mtodo GetDataItem retorna o ndice do primeiro item de um componente do tipo TOutline em
um dado especificado no parmetro Value.
Declarao
function GetDataItem(Value: Pointer): Longint;
TOutline
GETDELTAPACKET
Descrio
Esse mtodo retorna um pacote delta de informaes a partir de uma solicitao http..
Declarao
function GetDelta(Request: TWebRequest
): string;
TXMLBroker
GETDETAILLINKFIELDS
Descrio
Esse mtodo armazena, em dois objetos da classe TList, referncias aos objetos que representam os
campos utilizados em um relacionamento.
Declarao
GetDetailLinkFields(MasterFields, DetailFields: TList); override;
GETDETAILSQL
Descrio
Esse mtodo retorna uma Declarao SQL capaz de produzir o mesmo resultado exibido pelo componente.
CAPTULO 42 MTODOS
Declarao
function GetDetailSQL(ValueArray: TSmallIntArray; SelectList: string; bActive: Boolean): string;
TDecisionCube
GETDRIVERNAMES
Descrio
Esse mtodo armazena, em uma lista de strings, os nomes dos drivers atualmente instalados no Borland
Database Engine, exceto os do PARADOX e DBASE, que so manipulados pelo driver STANDARD.
Declarao
procedure GetDriverNames(List: TStrings);
Exemplo
O trecho de cdigo a seguir armazena, em uma lista de strings Lista, os nomes dos drivers atualmente
instalados no Borland Database Engine:
Session.GetDriverNames(Lista);
TSession
GETDRIVERPARAMS
Descrio
Esse mtodo armazena, em uma lista de strings, os nomes dos parmetros usados pelo driver do Borland
Database Engine especificado no parmetro DriverName.
Declarao
procedure GetDriverParams(const DriverName: string;
List: TStrings);
TSession
GETERRORCOUNT
Descrio
Esse mtodo retorna o nmero de erros no pacote delta recebido.
Declarao
function GetDelta(Request: TWebRequest): string;
TXMLBroker
GETFIELDNAMES
Descrio
Esse mtodo limpa a lista de strings definida no parmetro List e adiciona a ela o nome de cada campo
do banco de dados.
Declarao
procedure GetFieldNames(List: TStrings);
GETFIRSTCHILD
Descrio
Esse mtodo retorna o ndice do primeiro subitem de um item do tipo TOutlineNode.
Declarao
function GetFirstChild: Longint;
TOutlineNode
GETFORMIMAGE
Descrio
O mtodo GetFormImage cria um bitmap com a imagem do formulrio, como ele seria impresso.
Declarao
function GetFormImage: TBitmap;
Exemplo
O trecho de cdigo a seguir copia, em um bitmap, a imagem de um formulrio:
var
Bitmap1 : TBitmap;
begin
Bitmap1 := Form1.GetFormImage;
TForm
GETHOTSPOT
Descrio
Esse mtodo retorna o hotspot associado imagem sendo arrastada.
Declarao
function GetHotSpot: TPoint;
TImageList
GETICON
Descrio
Esse mtodo retorna a imagem especificada no parmetro Index como um cone no parmetro Image
do tipo TIcone.
Declarao
procedure GetIcon(Index: Integer; Image: TIcon);
TImageList
GETIMAGEBITMAP
Descrio
Esse mtodo retorna um handle para um bitmap que contm todas as imagens do componente.
Declarao
function GetImageBitmap: HBITMAP;
CAPTULO 42 MTODOS
TImageList
GETINDEXFORPAGE
Descrio
O mtodo GetIndexForPage retorna o valor da propriedade PageIndex da pgina cuja string de exibio,
definida na propriedade Strings, especificada no parmetro PageName.
Declarao
function GetIndexForPage(const PageName: string): Integer;
Exemplo
O trecho de cdigo a seguir faz com que um componente chamado Label1 do tipo TLabel exiba o
ndice da pgina cujo nome, definido na propriedade Strings, igual a Exemplo.
Label1.Caption := IntToStr(TabbedNotebook1.GetIndexForPage(Exemplo));
TTabbedNotebook
GETINDEXNAMES
Descrio
Esse mtodo armazena, em uma lista de strings, os nomes dos ndices definidos para a tabela.
Declarao
TADOTable, TIBTable, TTable, TSQLDataset, TSQLTable, TSQLQuery, TSQLStoredProc,
GETITEM
Descrio
O mtodo GetItem retorna o ndice do item de um componente do tipo TOutline que est situado nas
coordenadas (X,Y) em pixels.
Declarao
function GetItem(X, Y: Integer): Longint;
TOutline
GETITEMPATH
Descrio
O mtodo GetItemPath retorna em uma string o path de um diretrio definido por um ndice em um
componente do tipo TDirectoryListBox. O primeiro diretrio da lista possui ndice igual a 0.
Declarao
function GetItemPath(Index : Integer): string;
TDirectoryListBox
GETLASTCHILD
Descrio
Retorna o ndice do ltimo subitem de um item do tipo TOutlineNode.
Declarao
function GetLastChild: Longint;
TOutlineNode
GETMASKBITMAP
Descrio
Esse mtodo retorna um handle para um bitmap que contm todas as mscaras das imagens do componente.
Declarao
function GetMaskBitmap: HBITMAP;
TImageList
GETNAMEPATH
Descrio
Esse mtodo retorna o nome do objeto como aparece no Object Inspector.
Declarao
function GetNamePath: string; dynamic;
TADOCommand
GETNEXTCHILD
Descrio
Esse mtodo retorna o ndice do prximo item do tipo TOutlineNode com o mesmo item-pai do item atual.
Declarao
function GetNextChild(Value: Longint): Longint;
TOutlineNode
GETPARENTCOMPONENT
Descrio
Esse mtodo retorna o componente TActionList ao qual o objeto est vinculado.
Declarao
function GetParentComponent: TComponent; override;
TAction
GETPASSWORD
Descrio
Esse mtodo dispara um evento OnPassword (se existir) ou exibe a caixa de dilogo padro de pass-
word. Retorna True, se o usurio selecionar o boto OK, e False, se o usurio selecionar o boto Cancel.
Declarao
function GetPassword: Boolean;
CAPTULO 42 MTODOS
Exemplo
O trecho de cdigo a seguir aciona o mtodo GetPassword:
Session.GetPassword;
TSession
GETPREVCHILD
Descrio
Esse mtodo retorna o ndice do item anterior do tipo TOutlineNode com o mesmo item-pai do item atual.
Declarao
function GetPrevChild(Value: Longint): Longint;
TOutlineNode
GETPRINTER
Descrio
Esse mtodo retorna a impressora corrente.
Declarao
procedure GetPrinter (ADevice, ADriver, APort: PChar; var ADeviceMode: THandle);
TPrinter
GETPROCEDURENAMES
Descrio
Esse mtodo armazena, em uma lista de strings, os nomes dos procedimentos armazenados definidos
para o banco de dados acessado pelo componente.
Declarao
TADOConnection e TSQLConnection.
GETRESULTS
Descrio
Esse mtodo retorna os valores dos parmetros de sada em um procedimento armazenado em um
servidor do tipo Sybase.
Declarao
procedure GetResults;
TStoredProc
GETSELTEXTBUF
Descrio
O mtodo GetSelTextBuf copia o texto selecionado de um controle no buffer apontado pela varivel
Buffer, at o nmero de caracteres definido no parmetro BufSize. O texto colocado em buffer uma
string terminada em zero. O mtodo retorna o nmero de caracteres copiados.
Declarao
function GetSelTextBuf(Buffer: PChar; BufSize: Integer): Integer;
Exemplo
O exemplo a seguir copia o texto selecionado em um componente TEdit chamado Edit1 em uma string
terminada em zero, e depois coloca essa string em outro componente TLabel denominado Label1
quando o usurio d um clique sobre um boto chamado Button1 do tipo TButton.
var
Buffer: PChar;
Size: Integer;
begin
Size := Edit1.SelLength;
Inc(Size);
GetMem(Buffer, Size);
Edit1.GetSelTextBuf(Buffer,Size);
Label1.Caption := StrPas(Buffer);
FreeMem(Buffer, Size);
end;
GETSQL
Descrio
Esse mtodo retorna uma Declarao SQL capaz de produzir o mesmo resultado exibido pelo componente.
Declarao
function GetSQL(ValueArray: TSmallIntArray; bActive: Boolean): string;
TDecisionCube
GETSTOREDPROCNAMES
Descrio
Esse mtodo armazena, em uma lista de strings, os nomes das procedures definidas para um banco de
dados SQL determinado no parmetro DatabaseName (no se aplica ao dBASE e Paradox).
Declarao
procedure GeTStoredProcNames(const DatabaseName: string; List: TStrings);
TSession
GETTABLENAMES
Descrio
Esse mtodo armazena, em uma lista de strings, os nomes das tabelas associadas ao banco de dados
definido no parmetro DatabaseName. O parmetro Pattern limita os nomes de tabelas a serem procuradas.
Declarao
procedure GeTTableNames(const DatabaseName, Pattern: string;Extensions, SystemTables: Boolean;
List: TStrings);
TADOConnection, TSQLConnection, Tssession e TIBDatabase
CAPTULO 42 MTODOS
GETTABORDERLIST
Descrio
Esse mtodo retorna uma lista dos controles-filhos do controle corrente, ordenados pelo valor
armazenado na sua propriedade TabOrder.
Declarao
procedure GetTabOrderList(List: TList);
Todos os controles.
GETTEXT
Descrio
Esse mtodo retorna uma lista de strings como uma string de terminao nula.
Declarao
function GetText: PChar;
GETTEXTBUF
Descrio
O mtodo GetTextBuf copia o texto de um controle no buffer apontado pela varivel Buffer, at o
nmero de caracteres definido no parmetro BufSize. O texto colocado em buffer uma string terminada
em zero. O mtodo retorna o nmero de caracteres copiados.
Declarao
function GetTextBuf(Buffer: PChar; BufSize: Integer): Integer;
Exemplo
O exemplo a seguir copia o texto exibido em um componente TLabel denominado Label1 em uma
string terminada em zero e depois coloca essa string em outro componente TLabel chamado Label2
quando o usurio d um clique sobre um boto denominado Button1.
var
Buffer: PChar;
Size: Byte;
begin
Size := Label1.GetTextLen;
Inc(Size);
GetMem(Buffer, Size);
Label1.GetTextBuf(Buffer,Size);
Label2.Caption := StrPas(Buffer);
FreeMem(Buffer, Size);
end;
Todos os controles e objetos do tipo TClipboard.
GETTEXTLEN
Descrio
O mtodo GetTextLen retorna o comprimento do texto exibido por um controle.
Declarao
function GetTextLen: Integer;
Exemplo
A linha de cdigo abaixo atribui a uma varivel inteira Size o comprimento do texto exibido em um
componente Edit1 do tipo TEdit.
Size := Edit1.GetTextLen;
Todos os controles.
GETXMLRECORDS
Descrio
Esse mtodo retorna em uma string os registros do pacote delta enviado pelo servidor de aplicaes.
Declarao
function GetXMLRecords(var RecsOut: Integer; var OwnerData: OleVariant; XMLOptions:
TXMLOptions): string;
TXMLBroker
GOTOBOOKMARK
Descrio
Esse mtodo move o cursor para o registro definido em uma chamada a um mtodo GetBookmark.
Declarao
procedure GotoBookmark(Bookmark: TBookmark);
GOTOCURRENT
Descrio
Esse mtodo sincroniza duas tabelas de um banco de dados.
Declarao
TTable, TClientDataset, TSimpleDataset e TIBClientDataset
GOTOKEY
Descrio
Esse mtodo usado com os mtodos SetKey e GetKey para se mover para um registro da tabela.
Declarao
function GotoKey: Boolean;
CAPTULO 42 MTODOS
GOTONEAREST
Descrio
Esse mtodo usado com os mtodos SetKey e GetKey para se mover para o prximo registro cujos
ndices dos campos sejam iguais ou superiores aos definidos no parmetro KeyValues.
Declarao
procedure GotoNearest;
HANDLEALLOCATED
Descrio
Esse mtodo retorna um valor booleano que indica se existe ou no um handle alocado para o controle.
Declarao
function HandleAllocated: Boolean;
Exemplo
O trecho de cdigo a seguir verifica se existe um handle alocado para um componente GroupBox1 do
tipo TGroupBox, exibindo-o como um componente Label1 do tipo TLabel. Caso o handle no tenha
sido alocado, exibe uma mensagem.
var
TheValue: string;
begin
if GroupBox1.HandleAllocated then
TheValue := IntToStr(GroupBox1.Handle)
else TheValue := Handle no alocado.;
Label1.Caption := TheValue;
end;
Todos os controles.
HANDLEEXCEPTION
Descrio
Esse mtodo manipula as excees de uma aplicao.
Declarao
procedure HandleException(Sender: TObject);
Exemplo
O trecho de cdigo a seguir faz a manipulao default das excees de uma aplicao.
try
{Cdigo gerador de excees}
except
Application.HandleException(Self);
end;
TApplication
HANDLENEEDED
Descrio
Esse mtodo cria um handle para um controle, se ele j no possuir um.
Declarao
procedure HandleNeeded;
Exemplo
A linha de cdigo a seguir cria um handle para um boto chamado Button1 do tipo
TButton:
Button1.HandleNeeded;
Todos os controles.
HASFORMAT
Descrio
Esse mtodo determina se o objeto armazenado no clipboard possui o formato definido pelo parmetro
Format. Os valores possveis para o parmetro Format so CF_TEXT (texto), CF_BITMAP (grfico de
bitmap), CF_METAFILE (grfico metafile), CF_PICTURE (objeto do tipo Tpicture) e CF_OBJECT (qualquer
objeto persistente).
Declarao
procedure HasFormat(Format: Word): Boolean;
TClipboard
HASH
Descrio
Esse mtodo retorna um valor que identifica a instncia do objeto.
Declarao
function Hash(Maximum: Integer): Integer;
ICorbaObject
HELPCOMMAND
Descrio
Esse mtodo d acesso aos comandos do arquivo WinHelp da API do Windows. O
comando passado pelo parmetro Command.
Declarao
function HelpCommand(Command: Word; Data: Longint): Boolean;
Exemplo
O trecho de cdigo a seguir acessa o tpico Contents do Help On-line da API do Windows.
Application.HelpCommand(HELP_CONTENTS, 0);
TApplication
CAPTULO 42 MTODOS
HELPCONTEXT
Descrio
Esse mtodo chama o programa WinHelp, o sistema de Help On-line do Windows, desde que haja um
arquivo de Help da aplicao definido na sua propriedade HelpFile. O parmetro Context especifica o
nmero da ID que define a tela de auxlio.
Declarao
function HelpContext(Context: THelpContext): Boolean;
Exemplo
O trecho de cdigo a seguir faz com que a tela de auxlio, cuja ID igual a 715 no arquivo definido na
propriedade HelpFile, seja exibida.
Application.HelpContext(715);
TApplication
HELPJUMP
Descrio
Esse mtodo chama o programa WinHelp, o sistema de Help On-line do Windows, desde que haja um
arquivo de Help da aplicao definido na sua propriedade HelpFile. O parmetro JumpID a string de
contexto que define a tela de auxlio a ser exibida.
Declarao
function HelpJump(const JumpID: string): Boolean;
Exemplo
O trecho de cdigo a seguir faz com que a tela de auxlio, cuja string de contexto igual string de
contexto no arquivo definido na propriedade HelpFile, seja exibida.
Application.HelpJump(string de contexto);
TApplication
HIDE
Descrio
O mtodo Hide torna invisvel um componente, fazendo sua propriedade Visible := False.
Declarao
procedure Hide;
Exemplo
Se voc quiser que um boto chamado Button1 desaparea de um formulrio que o contm (form1) ao
se clicar sobre ele com o boto esquerdo do mouse, defina o seu evento OnClick da seguinte forma:
begin
Button1.Hide;
end;
HIDEDRAGIMAGE
Descrio
Esse mtodo oculta a imagem correntemente arrastada.
Declarao
procedure HideDragImage;
TImageList
INDEXOF
Descrio
Para componentes do tipo TmenuItem, esse mtodo retorna a posio de um item de menu (especificado
no parmetro Item) em um menu. Para o primeiro item de um menu, IndexOf retorna 0. Se o item
especificado no fizer parte do menu, retorna -1.
Para objetos dos tipos TStrings e TStringList, esse mtodo retorna a posio da string definida pelo parmetro
S.
Declarao
Para componentes do tipo TMenuItem:
function IndexOf(Item: TMenuItem): Integer;
function IndexOf(const S: string): Integer;
Exemplo
O trecho de cdigo a seguir exibe, em um componente Label1 do tipo TLabel, o ndice de um item de
menu chamado Sair, de um menu Arquivo.
Label1.Caption := IntToStr(Arquivo.IndexOf(Sair));
TStrings, TStringList e TMenuItem
INDEXOFOBJECT
Descrio
Esse mtodo retorna a posio do objeto definido pelo parmetro AObject.
Declarao
function IndexOfObject(AObject: TObject): Integer;
INHERITSFROM
Descrio
Esse mtodo define se o objeto passado pelo parmetro AClass um ancestral do objeto corrente.
Declarao
class function InheritsFrom(AClass: TClass): Boolean;
Todos os objetos.
CAPTULO 42 MTODOS
INITINSTANCE
Descrio
Esse mtodo cria uma nova instncia de um objeto.
Declarao
class procedure InitInstance(Instance: Pointer): TObject;
Todos os objetos.
INSERT
Descrio
Para componentes do tipo TOutline, esse mtodo insere um item na posio especificada pelo
parmetro Index.
Para componentes do tipo TMenuItem, esse mtodo insere um item de menu na posio especificada
pelo parmetro Index.
Para componentes derivados da classe TDataset, coloca o banco de dados no modo de insero e insere
um registro em branco na posio atual do cursor.
Para objetos do tipo Tlist, insere um item, definido pelo parmetro Item, na posio especificada pelo
parmetro Index.
Para objetos dos tipos TStrings e TStringList, insere uma string, definida pelo parmetro S,
na posio especificada pelo parmetro Index.
Declarao
Para componentes do tipo TOutline:
function Insert(Index: Longint; const Text: string): Longint;
Para componentes do tipo TMenuItem:
procedure Insert(Index: Integer; Item: TMenuItem);
Para componentes derivados da classe TDataset:
procedure Insert;
Para objetos do tipo Tlist:
procedure Insert(Index: Integer; const S: string);
Exemplo
O trecho de cdigo a seguir insere um item, na posio do item atualmente selecionado, em um
componente Outline1 do tipo TOutline:
Outline1.Insert(Outline1.SelectedItem, Novo item);
TStrings, TStringList, Tlist e TMenuItem
INSERTCOMPONENT
Descrio
Esse mtodo insere um componente passado no parmetro AComponent na lista de componentes
definida pela propriedade Components do componente atual.
Declarao
procedure InsertComponent(AComponent: TComponent);
Exemplo
O trecho de cdigo a seguir insere um boto Button1 do tipo TButton no array de componentes de um
formulrio chamado Form1.
Form1.InsertComponent(Button1);
INSERTCONTROL
Descrio
Esse mtodo insere um controle passado no parmetro AControl na lista de controles definida pela
propriedade Controls do controle atual.
Declarao
procedure InsertControl(AControl: TControl);
Exemplo
O trecho de cdigo a seguir insere um boto Button1 do tipo TButton na array de controles de um
formulrio chamado Form1.
Form1.InsertControl(Button1);
Todos os controles.
INSERTICON
Descrio
Esse mtodo insere um cone no componente aps a imagem definida pelo parmetro Index.
Declarao
procedure InsertIcon(Index: Integer; Image: TIcon);
TImageList
INSERTMASKED
Descrio
Esse mtodo insere um bitmap no componente aps a imagem definida pelo parmetro Index, criando
uma mscara definida pelo parmetro MaskColor.
Declarao
procedure InsertMasked(Index: Integer; Image: TBitmap; MaskColor: TColor);
TImageList
CAPTULO 42 MTODOS
INSERTOBJECT
Descrio
Esse mtodo insere um item contendo dados na posio especificada pelo parmetro Index em um
componente do tipo TOutline.
Declarao
function InsertObject(Index: Longint; const Text: string; const Data: Pointer): Longint;
Exemplo
O trecho de cdigo a seguir insere um objeto chamado Bitmap1 do tipo TBitmap na posio do item
atualmente selecionado em um componente Outline1 do tipo TOutline:
Outline1.InsertObject(Outline1.SelectedItem, Novo item, Bitmap1);
TOutline
INSERTRECORD
Descrio
Esse mtodo insere um novo registro no banco de dados utilizando os valores de campos passados pelo
parmetro Values.
Declarao
procedure InsertRecord(const Values: array of const);
TStrings, TStringList, Tlist e TMenuItem
INSTANCESIZE
Descrio
Esse mtodo retorna o tamanho, em bytes, de cada instncia de um objeto.
Declarao
Todos os objetos.
INVALIDATE
Descrio
Esse mtodo faz com que o contedo de um controle seja redesenhado.
Declarao
procedure Invalidate;
ISA
Descrio
Esse mtodo verifica se o objeto associado do tipo passado como parmetro.
Declarao
function IsA(const LogicalTypeId: string): Boolean;
ICorbaObject
ISEMPTY
Descrio
Esse mtodo determina se a tabela representada pelo componente est vazia.
Declarao
function IsEmpty: Boolean;
TADOTable, TIBTable, TSQLTable, TTable, TADOQuery, TIBQuery
ISLOCAL
Descrio
Esse mtodo retorna um inteiro diferente de zero se o objeto CORBA referenciado pela
interface for instanciado localmente.
Declarao
function IsLocal: CorbaBoolean; stdcall;
ICorbaObj
ISVALIDCHAR
Descrio
Esse mtodo determina se o caractere digitado em um controle que representa o campo caractere vlido.
Declarao
function IsValidChar(InputChar: Char): Boolean; virtual;
ITEMATPOS
Descrio
Para componentes dos tipos TDBListBox, TDirectoryListBox, TFileListBox e TListBox, esse mtodo
retorna o ndice do item de uma caixa de listagem situado na posio especificada por um parmetro
Pos, do tipo Tpoint, ou -1, se no existir um item naquele ponto.
Para componentes do tipo TTabSet, esse mtodo retorna o ndice da guia situada na posio definida
por dois parmetros inteiros X e Y.
Declarao
Para componentes dos tipos TDBListBox, TDirectoryListBox, TFileListBox eTListBox:
function ItemAtPos(Pos: TPoint; Existing: Boolean): Integer;
Para componentes do tipo TTabSet:
function ItemAtPos(Pos: TPoint; Existing: Boolean): Integer;
CAPTULO 42 MTODOS
Exemplo
O trecho de cdigo a seguir seleciona a guia que est nas coordenadas (100,1) de
TabSet1:
TbSet1.TabIndex := TabSet1.ItemAtPos(100, 1);
TDBListBox, TDirectoryListBox, TFileListBox, TListBox e TabSet
ITEMRECT
Descrio
Esse mtodo retorna o retngulo circunscrito a um item, especificado no parmetro Item.
Declarao
function ItemRect(Item: Integer): TRect;
Exemplo
O trecho de cdigo a seguir copia o retngulo circunscrito ao primeiro item de uma varivel chamada
ListBox1, do tipo TListBox, em uma varivel CircRect do tipo Trect:
CircRect := ListBox1.ItemRect(0);
TDBListBox, TDirectoryListBox, TDrawGrid, TFileListBox, TListBox, TStringGrid e TTabSet
LAST
Descrio
Para componentes derivados da classe TDataset, esse mtodo move o ponteiro para o ltimo registro
do banco de dados.
Para objetos do tipo TList, esse mtodo retorna o ponteiro para o ltimo objeto da lista.
Declarao
Para componentes derivados da classe TDataset:
procedure Last;
Para componentes do tipo TList:
TList, TADODataset, TADOTable, TADOQuery, TADOStoredProc, TIBDataset, TIBTable, TIBQuery,
e TSQLStoredProc
LINETO
Descrio
Esse mtodo desenha uma linha da posio corrente at o ponto (X,Y).
Declarao
procedure LineTo(X, Y: Integer);
TCanvas
LOAD
Descrio
Esse mtodo recupera a impresso de um relatrio que foi direcionada para um arquivo.
Declarao
procedure Load(Filename: String)
TQRPrinter
LOADFROMFILE
Descrio
Esse mtodo l o arquivo especificado no parmetro FileName e carrega seus dados no objeto ou componente.
No caso de componentes do tipo TRvProject, carrega o relatrio a partir do arquivo especificado
como parmetro.
Declarao
procedure LoadFromFile(const FileName: string);
Exemplo
O trecho de cdigo a seguir carrega o arquivo autoexec.bat em um componente TStrings que, nesse
caso, a propriedade Lines de um componente chamado Memo1 do tipo
TMemo.
Memo1.Lines.LoadFromFile(c:\autoexec.bat.);
NOTA = Note que, nesse caso, LoadFromFile um mtodo de Lines, que um componente do tipo
TStrings. Por outro lado, Lines ainda uma propriedade de TMemo.
TClientDataset, TDBMemoBuf, TIBClientDataset, TSimpleDataset, TBitmap, TBlobField,
TGraphicField, TMemoBuf, TMemoField, TGraphic, TIcon, TMetaFile, TPicture, TOutline,
TrvProject, TStringList e TStrings
LOADFROMSTREAM
Descrio
Esse mtodo l a stream especificada no parmetro Stream e carrega seu contedo no
Campo ou no relatrio.
Declarao
procedure LoadFromStream(Stream: TStream);
Exemplo
O trecho de cdigo a seguir carrega uma stream chamada Stream1 em um campo BlobField1 do tipo
TBlobField.
BlobField1.LoadFromStream(Stream1);
TBlobField, TClientDataset, TDBMemoBuf, TIBClientDataset, TGraphicField, TMemoBuf, TMemoField,
TRvProject e TSimpleDataset
LOADMEMO
Descrio
Esse mtodo copia um texto em um controle do tipo TDBMemo.
Declarao
procedure LoadMemo;
CAPTULO 42 MTODOS
Exemplo
O trecho de cdigo a seguir copia o texto armazenado em um campo do tipo TBLOBField em um
componente DBMemo1 do tipo TDBMemo.
DBMemo1.LoadMemo;
TDBMemo
LOADPICTURE
Descrio
Esse mtodo copia a imagem definida pela propriedade Picture para o controle.
Declarao
procedure LoadPicture;
Exemplo
O trecho de cdigo a seguir copia a imagem definida na propriedade Picture para ser exibida pelo controle.
DBImage1.LoadPicture;
TDBImage
LOCATE
Descrio
Esse mtodo permite uma pesquisa por campos no-indexados de uma tabela.
Declarao
Boolean;
TClientDataset, TIBClientDataset, TSimpleDataset, TADOTable, TADOStoredproc, TIBTable,
TIBStoredproc, TTable, TStoredProc
LOCKTABLE
Descrio
Esse mtodo impede que outras aplicaes acessem a tabela para leitura e/ou gravao.
Declarao
onde TLockType um tipo enumerado definido da seguinte maneira:
type TLockType = (ltReadLock, ltWriteLock);
TTable
MERGE
Descrio
Esse mtodo mescla os menus de diversos formulrios em uma aplicao no-MDI. O parmetro Menu
define o menu a ser mesclado.
Declarao
procedure Merge(Menu: TMainMenu);
TMainMenu
MESSAGEBOX
Descrio
Esse mtodo encapsula a funo MessageBox da API do Windows, sem que seja necessrio especificar
um handle. Esse mtodo exibe uma mensagem e um conjunto de botes. O texto da mensagem,
passado no parmetro Text, no pode ter mais do que 255 caracteres. O parmetro Caption define o
texto a ser exibido na barra de ttulos do quadro de mensagem (pode ter mais do que 255 caracteres).
O parmetro Flags define os botes que devem ser exibidos (veja maiores informaes no arquivo de
auxlio da API do Windows WINAPI.HLP).
Declarao
function MessageBox(Text, Caption: PChar; Flags: Word): Integer;
Exemplo
O trecho de cdigo a seguir exibe uma mensagem com um boto OK e um boto Cancel:
Application.MessageBox(Bem-vindo ao Delphi!, Mensagem, mb_OKCancel);
TApplication
METHODADDRESS
Descrio
Esse mtodo retorna o endereo do mtodo do tipo published especificado no parmetro Name.
Declarao
Todos os objetos.
METHODNAME
Descrio
Esse mtodo retorna o nome do mtodo especificado no parmetro Address.
Declarao
Todos os objetos.
MINIMIZE
Descrio
Esse mtodo minimiza a aplicao.
Declarao
procedure Minimize;
Exemplo
O trecho de cdigo a seguir minimiza a aplicao.
Application.Minimize;
CAPTULO 42 MTODOS
TApplication
MOUSETOCELL
Descrio
Esse mtodo retorna nos parmetros ARow e ACol a linha e a coluna da clula na qual o mouse
est posicionado.
Declarao
procedure MouseToCell(X, Y: Integer; var ACol, ARow: Longint);
Exemplo
O trecho de cdigo a seguir faz com que, ao se clicar com o mouse sobre uma clula de um componente
StringGrid1do tipo TStringGrid, a clula exiba o nmero da linha e coluna em que se situa.
procedure TForm1.StringGrid1MouseUp(Sender: TObject; Button: TMouseButton;
var
Column, Row: Longint;
begin
StringGrid1.MouseToCell(X, Y, Column, Row);
StringGrid1.Cells[Column, Row] := Col +
IntToStr(Column) +
,Row + IntToStr(Row);
end;
MOVE
Descrio
Esse mtodo muda a posio de um item em uma lista de objetos ou em uma lista de strings da posio
definida pelo parmetro CurIndex para a posio definida pelo parmetro NewIndex.
Declarao
TList, TStringList e TStrings
MOVEBY
Descrio
Esse mtodo move o ponteiro do nmero de registros definido no parmetro Distance.
Declarao
procedure MoveBy(Distance: Integer);
MOVETO
Descrio
Para objetos do tipo TCanvas, esse mtodo muda a posio corrente da caneta para o ponto (X,Y).
Para objetos do tipo TOutlineNode, esse mtodo muda a posio corrente do item dentro do
componente TOutline.
Declarao
Para objetos do tipo TCanvas:
procedure MoveTo(X, Y: Integer);
Para objetos do tipo TOutlineNode:
procedure MoveTo(Destination: Longint; AttachMode: TAttachMode);
TCanvas e TOutlineNode
NEXT
Descrio
Para componentes do tipo TForm, esse mtodo torna ativa a prxima janela-filha de uma aplicao MDI.
Para componentes do tipo TMediaPlayer, esse mtodo faz com que o dispositivo multimdia avance
uma trilha.
Para componentes derivados da classe TDataset, move o ponteiro para o prximo registro de um
banco de dados.
Declarao
procedure Next;
Exemplo
A linha de cdigo a seguir torna ativa a prxima janela-filha de um formulrio Form1 com a propriedade
FormStyle igual a fsMDIForm:
Form1.Next;
TADODataset, TADOTable, TADOQuery, TADOStoredProc, TIBDataset, TIBTable, TIBQuery, TIBSQL,
TIBStoredProc, TTable, TQuery, TStoredProc,
Tform, TmediaPlayer, TSimpleDataset, TSQLDataset, TSQLTable, TSQLQuery e TSQLStoredProc
NEWINSTANCE
Descrio
Esse mtodo aloca memria para uma nova instncia de um objeto e retorna um ponteiro para o
objeto criado.
Declarao
Todos os objetos.
NEWPAGE
Descrio
Para componentes do tipo TQuickReport, esse mtodo fora uma quebra de pgina durante a preparao
de um relatrio.
Para componentes do tipo TPrinter e TQRPrinter, esse mtodo inicia a impresso de uma nova pgina.
Declarao
procedure NewPage
CAPTULO 42 MTODOS
TQuickReport, TPrinter e TQRPrinter
NONEXISTENT
Descrio
Esse mtodo verifica se o objeto associado foi desativado.
Declarao
function NonExistent: Boolean;
ICorbaObject
NORMALIZETOPMOSTS
Descrio
Esse mtodo faz com que os formulrios com propriedade FormStyle igual a fsStayOnTop se comportem
como formulrios comuns (com propriedade FormStyle igual a fsNormal).
Declarao
procedure NormalizeTopMosts;
Exemplo
O trecho de cdigo a seguir executa o mtodo NormalizeTopMosts em uma aplicao.
Application. NormalizeTopMosts;
TApplication
OLEOBJALLOCATED
Descrio
Esse mtodo verifica se um componente do tipo TOLEContainer possui ou no um objeto OLE.
Declarao
function OleObjAllocated: Boolean;
Exemplo
O cdigo a seguir exibe uma mensagem se um objeto OLEContainer1 do tipo TOLEContainer contiver
um objeto OLE.
if OLEContainer1.OleObjAllocated = True then ShowMessage(Contm um objeto OLE);
TOLEContainer
OPEN
Descrio
Para componentes do tipo TMediaPlayer, o mtodo Open faz com que um dispositivo multimdia seja aberto.
Para objetos do tipo TClipboard, o mtodo Open abre o objeto que representa o clipboard e evita que
outra aplicao altere o seu contedo at ser fechado pelo mtodo Close.
Para componentes do tipo TADOConnection, TADODataset, TADOTable, TADOQuery, TADOStoredProc,
TIBDataset, TIBTable, TIBQuery, TIBStoredProc, TTable, TQuery e TStoredProc, abre o banco de dados
associado e o deixa ativo.
Para componentes do tipo TDatabase, esse mtodo realiza a conexo com o servidor.
Para componentes do tipo TRvProject, abre o projeto de relatrio representado pelo componente.
Declarao
procedure Open;
Exemplo
O trecho de cdigo a seguir faz com que um dispositivo multimdia acione seu mtodo
Open com um boto chamado Open do tipo TButton:
procedure TForm1.OpenClick(Sender: TObject);
begin
MediaPlayer1.Open;
end;
TClipBoard, TClientDataset, TDatabase, TMediaPlayer, TADOConnection, TADODataset, TADOTable,
TADOQuery, TADOStoredProc, TIBDataset, TIBTable, TIBQuery, TIBStoredProc, TTable, TQuery,
TStoredProc, TSimpleDataset, TSQLDataset, TSQLTable, TSQLQuery e TSQLStoredProc.
OPENDATABASE
Descrio
O mtodo OpenDatabase usado para abrir um componente do tipo TDatabase, cuja propriedade
DatabaseName igual ao parmetro DatabaseName, e se no o localizar cria um novo componente.
Declarao
function OpenDatabase(const DatabaseName: string): TDatabase;
Exemplo
O trecho de cdigo a seguir abre um componente do tipo TDatabase associado a um banco de dados
denominado Dados:
Session.OpenDatabase(DADOS);
TSession
OPENINDEXFILE
Descrio
Esse mtodo abre um arquivo de ndices definido para tabelas no formato dBase.
Declarao
procedure OpenIndexFile(const IndexFileName: string);
TTable
OPENLINK
Descrio
Esse mtodo inicia uma conversao DDE.
Declarao
function OpenLink: Boolean;
Exemplo
O trecho de cdigo a seguir inicia uma conversao DDE:
DDEClientConv1.OpenLink;
CAPTULO 42 MTODOS
TDDEClientConv
OVERLAY
Descrio
Esse mtodo transforma a imagem definida pelo parmetro ImageIndex em uma imagem de
superposio, retornando-a no parmetro Overlay.
Declarao
function Overlay(ImageIndex: Integer; Overlay: TOverlay): Boolean;
TImageList
PACK
Descrio
Esse mtodo deleta os elementos de uma lista cujo ponteiro tem valor nil.
Declarao
procedure Pack;
TList
PARAMBYNAME
Descrio
Esse mtodo retorna o elemento da propriedade Params cuja propriedade Name igual ao parmetro Value.
Declarao
TIBStoredproc, TStoredProc, TIBQuery e TQuery
PASTEFROMCLIPBOARD
Descrio
Esse mtodo copia o texto do clipboard para o controle na posio atual do cursor, substituindo qualquer
texto selecionado no controle.
Declarao
procedure PasteFromClipboard;
Exemplo
O trecho de cdigo a seguir copia o texto do clipboard para um controle Edit1 do tipo TEdit.
Edit1.PasteFromClipboard;
TDBEdit, TDBImage, TDBMemo, TEdit, TMaskEdit e TMemo
PAUSE
Descrio
O mtodo Pause provoca uma parada (pausa) em um dispositivo multimdia. Caso o dispositivo j
esteja sob uma pausa causada por uma chamada a esse mtodo, o mtodo Resume ser acionado.
Declarao
procedure Pause;
Exemplo
O trecho de cdigo a seguir faz com que um dispositivo multimdia acione seu mtodo Pause com um
boto chamado Pause do tipo TButton:
procedure TForm1.PauseClick(Sender: TObject);
begin
MediaPlayer1.Pause;
end;
TMediaPlayer
PAUSEONLY
Descrio
O mtodo PauseOnly idntico ao mtodo Pause, exceto por no acionar o mtodo Resume caso o
dispositivo j esteja sob uma pausa causada por uma chamada a um mtodo Pause.
Declarao
procedure PauseOnly;
Exemplo
Veja o mtodo Pause.
TMediaPlayer
PEEK
Descrio
Este mtodo retorna um ponteiro para o prximo elemento armazenado na estrutura de dados
representada pelo objeto, que pode ser uma Pilha ou uma Fila.
Este mtodo, ao contrrio do que ocorre com o mtodo Pop, no remove o ponteiro da estrutura.
Declarao
function Peek: Pointer;
TQueue e TStack.
PERFORM
Descrio
Esse mtodo habilita um controle a enviar uma mensagem para si. A mensagem passada por meio do
parmetro Msg.
Declarao
function Perform(Msg, WParam: Word; LParam: Longint): Longint;
Todos os controles.
CAPTULO 42 MTODOS
PIE
Descrio
Esse mtodo desenha um setor elptico, sendo a elipse circunscrita pelo retngulo definido pelos pontos
(X1, Y1) e (X2,Y2), e limitada pelas linhas radiais que vo do centro da elipse aos pontos (X3,Y3) e (X4,Y4).
Declarao
procedure Pie(X1, Y1, X2, Y2, X3, Y3, X4, Y4: Longint);
TCanvas
PLAY
Descrio
O mtodo Play inicia a reproduo em um dispositivo multimdia (para um componente TMediaPlayer)
ou de um clip AVI (para um componente TAnimate) nesse caso, os nmeros que identificam os
quadros inicial e final, bem como o nmero de execues, so passados como parmetros.
Declarao
Para componentes TMediaPlayer:
procedure Play;
Para componentes TAnimate:
procedure Play(FromFrame, ToFrame: Word; Count: Integer);
Exemplo
O trecho de cdigo a seguir inicia a reproduo em um dispositivo multimdia quando um boto Play
do tipo TButton selecionado:
procedure TForm1.PlayClick(Sender: TObject);
begin
MediaPlayer1.Play;
end;
TAnimate e TMediaPlayer
POKEDATA
Descrio
Esse mtodo envia um dado (definido no parmetro Data) para um item (definido no parmetro Item)
de uma aplicao servidora em uma conversao DDE.
Declarao
function PokeData(Item: string; Data: PChar): Boolean;
TDDEClientConv
POKEDATALINES
Descrio
Esse mtodo envia um dado (definido como uma lista de strings no parmetro Data) para um item
(definido no parmetro Item) de uma aplicao servidora em uma conversao.
Declarao
function PokeDataLines(Item: string; Data: TStrings): Boolean;
TDDEClientConv
POLYGON
Descrio
Esse mtodo desenha um polgono cujos vrtices esto definidos na array de pontos passada no
parmetro Points e pintado com o pincel corrente.
Declarao
procedure Polygon(Points: array of TPoint);
TCanvas
POLYLINE
Descrio
Esse mtodo desenha uma linha poligonal cujos vrtices esto definidos na array de pontos passada no
parmetro Points, utilizando-se a caneta corrente.
Declarao
procedure Polyline(Points: array of TPoint);
TCanvas
POP
Descrio
Este mtodo retorna um ponteiro para o prximo elemento armazenado na estrutura de dados
representada pelo objeto, que pode ser uma Pilha ou uma Fila.
Este mtodo remove o ponteiro da estrutura.
Declarao
function Pop: Pointer;
TQueue e TStack.
POPUP
Descrio
O mtodo Popup exibe um menu flutuante na posio especificada pelos parmetros X e Y.
Declarao
procedure Popup(X, Y: Integer);
TPopup
POST
Descrio
Esse mtodo grava o registro corrente no banco de dados.
Declarao
procedure Post;
CAPTULO 42 MTODOS
TIBStoredProc, TTable, TQuery, TStoredProc, TClientDataset, TIBClientDataset e TSimpleDataset
PREPARE
Descrio
Para componentes do tipo TIBSQL, TIBQuery, TIBStoredoroc, TADOQuery, TADOStoredproc,
TStoredProc e TQuery, esse mtodo envia uma busca parametrizada para o Borland Database Engine
ou outro mecanismo de acesso a banco de dados.
Para componentes do tipo TQuickReport, esse mtodo permite que se crie um relatrio sem uma pr-
visualizao ou impresso.
Declarao
procedure Prepare;
TQuickReport, TADOQuery, TADOStoredProc, TIBDataset, TIBQuery, TIBSQL, TIBStoredproc,
TStoredProc e TQuery
PREVIEW
Descrio
Esse mtodo permite a pr-visualizao de um relatrio.
Declarao
procedure Preview
PREVIOUS
Descrio
Para objetos do tipo TForm, esse mtodo torna ativa a janela-filha anterior de uma aplicao MDI.
Para objetos do tipo TMediaPlayer, faz com que a trilha apontada pelo componente seja a anterior
trilha atual.
Declarao
procedure Previous;
Exemplo
A linha de cdigo a seguir torna ativa a janela-filha anterior de um formulrio Form1 com a propriedade
FormStyle igual a fsMDIForm.
Form1.Previous;
TForm e TMediaPlayer
PRINT
Descrio
Para componentes do tipo Tform, o mtodo Print faz com que o formulrio seja impresso.
Para componentes do tipo TQRPrinter, o mtodo Print imprime um relatrio.
Declarao
Para componentes do tipo TForm e TQRPrinter: procedure Print;
Exemplo
A linha de cdigo a seguir faz com que o formulrio Form1 seja impresso:
Form1.Print;
TForm, TQRPrinter
PRIOR
Descrio
Esse mtodo move o ponteiro para o registro anterior de um banco de dados.
Declarao
procedure Prior;
TIBStoredProc, TTable, TQuery, TStoredProc, TClientDataset, TIBClientDataset e TSimpleDataset
PROCESSMESSAGES
Descrio
Esse mtodo interrompe a execuo da aplicao de forma que o Windows possa responder a
mensagens pendentes.
Declarao
procedure ProcessMessages;
Exemplo
O trecho de cdigo a seguir executa o mtodo ProcessMessages em uma aplicao.
Application. ProcessMessages;
TApplication
PUSH
Descrio
Este mtodo adiciona um ponteiro para um objeto em uma estrutura de dados representada pelo
objeto, que pode ser uma Pilha ou uma Fila.
Declarao
procedure Push(AItem: Pointer);
TQueue e TStack.
QUEUEEVENTS
Descrio
Este mtodo inicia a notificao de eventos para a aplicao.
Declarao
procedure QueueEvents;
CAPTULO 42 MTODOS
TIBEvents
READ
Descrio
Esse mtodo copia os bytes armazenados em um campo para a varivel definida no parmetro Buffer.
Declarao
function Read(var Buffer; Count: Longint): Longint;
TBlobStream
READBOOL
Descrio
Esse mtodo l um valor booleano (definido no parmetro Ident) de uma seo (definida no parmetro
Section) de um arquivo INI.
Declarao
function ReadBool(const Section, Ident: string; Default: Boolean): Boolean;
TIniFile
READINTEGER
Descrio
Esse mtodo l um valor inteiro (definido no parmetro Ident) de uma seo (definida no parmetro
Declarao
function ReadInteger(const Section, Ident: string; Default: Longint): Longint;
TIniFile
READSECTION
Descrio
Esse mtodo l todas as variveis de uma seo (definida no parmetro Section) de um arquivo INI e as
armazena na lista de strings definida pelo parmetro Strings.
Declarao
procedure ReadSection (const Section: string; Strings: TStrings);
TIniFile
READSECTIONVALUES
Descrio
Esse mtodo l todas as variveis e seus valores de uma seo (definida no parmetro Section) de um
arquivo INI e os armazena na lista de strings definida pelo parmetro
Strings.
Declarao
procedure ReadSectionValues(const Section: string; Strings: TStrings);
TIniFile
READSTRING
Descrio
Esse mtodo l o valor de uma string (definida no parmetro Ident) de uma seo (definida no parmetro
Declarao
function ReadString(const Section, Ident, Default: string): string;
TIniFile
REALIGN
Descrio
Esse mtodo fora um realinhamento dos controles-filhos do controle corrente.
Declarao
procedure Realign;
Todos os controles.
RECTANGLE
Descrio
Esse mtodo desenha um retngulo definido pelos pontos (X1,Y1) vrtice superior
esquerdo e (X2,Y2) vrtice inferior direito, com o pincel e a caneta corrente.
Declarao
procedure Rectangle(X1, Y1, X2, Y2: Integer);
TCanvas
REFRESH
Descrio
No caso de componentes TTable, TQuery e TStoredProc, esse mtodo garante a atualizao do conjunto
de dados exibidos. Para os demais controles, o mtodo Refresh atualiza as imagens exibidas pelos
controles, chamando internamente os mtodos Invalidate (que apaga o contedo atual) e Update.
Declarao
procedure Refresh;
Exemplo
O trecho de cdigo a seguir fora a atualizao da imagem exibida em um controle Image1 do tipo
TImage ao se clicar sobre um boto chamado Button1 com o boto esquerdo do mouse.
procedure TForm1.Button1Click(Sender: Tobject);
begin
Image1.Refresh;
end;
Todos os controles e os componentes derivados de TDataset.
CAPTULO 42 MTODOS
REGISTERCHANGES
Descrio
Esse mtodo chamado por um objeto que deseja ser informado de alteraes ocorridas na lista de imagens.
Declarao
procedure RegisterChanges(Value: TChangeLink);
TListImages
REGISTEREVENTS
Descrio
Este mtodo registra, para a aplicao, os eventos definidos pela propriedade Events do componente.
Declarao
procedure RegisterEvents;
TIBEvents
RELEASE
Descrio
Esse mtodo idntico ao mtodo Free, exceto que aguarda que a execuo de cdigo de todos os
eventos pendentes do formulrio ou componentes nele inseridos seja finalizada.
Declarao
procedure Release;
Exemplo
A linha de cdigo a seguir mostra um formulrio chamado Form1 executando o seu mtodo Release.
Form1.Release;
TForm
RELEASEHANDLE
Descrio
Esse mtodo libera o handle usado pelo objeto.
Declarao
function ReleaseHandle: HBitmap;
Exemplo
A linha de cdigo a seguir libera o handle de um objeto Bitmap1 do tipo TBitmap.
Bitmap1.ReleaseHandle;
TBitmap
RELEASEPALETTE
Descrio
Esse mtodo libera o handle da paleta de cores usada pelo objeto.
Declarao
function ReleasePalette: HPalette;
Exemplo
A linha de cdigo a seguir libera o handle da paleta de cores de um objeto Bitmap1 do tipo TBitmap.
Bitmap1.ReleasePalette;
TBitmap
REMOVE
Descrio
Para componentes dos tipos TList e TMenuItem, esse mtodo remove o item especificado pelo parmetro
Item e retorna o valor da posio que era ocupada pelo Item.
Declarao
Tlist e TMenuItem
REMOVEALLPASSWORD
Descrio
Esse mtodo, que s se aplica a componentes relacionados a bancos de dados do tipo Paradox, desconsidera
todas as senhas fornecidas pelo usurio, solicitando nova senha para que as tabelas possam ser reabertas.
Declarao
procedure RemoveAllPasswords;
Exemplo
O trecho de cdigo a seguir aciona o mtodo RemoveAllPassword:
Session.RemoveAllPassword;
TSession
REMOVEALLSERIES
Descrio
Esse mtodo remove todas as sries do grfico exibido no componente.
Declarao
procedure RemoveAllSeries;
TChart e TDBChart
REMOVECOMPONENT
Descrio
Esse mtodo remove um componente passado no parmetro AComponent na lista de componentes
definida pela propriedade Components do componente atual.
Declarao
procedure RemoveComponent(AComponent: Tcomponent);
CAPTULO 42 MTODOS
Exemplo
O trecho de cdigo a seguir remove um boto Button1 do tipo TButton na array de componentes de
um formulrio chamado Form1.
Form1.RemoveComponent(Button1);
REMOVEDATABASE
Descrio
Este mtodo remove da sua propriedade Databases o objeto da classe TIBDatabase cujo ndice passado
como parmetro.
Declarao
procedure RemoveDatabase(Idx: Integer);
TIBTransaction
REMOVEDATABASES
Descrio
Este mtodo remove da sua propriedade Databases todos os objetos da classe TIBDatabase por ela
referenciados.
Declarao
procedure RemoveDatabases;
TIBTransaction
REMOVEPASSWORD
Descrio
Esse mtodo, que s se aplica a componentes relacionados a bancos de dados do tipo Paradox, elimina
a senha definida no parmetro Password do conjunto de senhas autorizadas.
Declarao
Exemplo
O trecho de cdigo a seguir aciona o mtodo RemovePassword para eliminar uma senha:
Session.RemovePassword(Senha);
TSession
REMOVESERIES
Descrio
Esse mtodo remove uma srie do grfico exibido no componente.
Declarao
procedure RemoveSeries(ASeries : TChartSeries);
TChart e TDBChart
REMOVETRANSACTION
Descrio
Esse mtodo cancela a associao da transao cujo ndice passado como parmetro.
Declarao
procedure RemoveTransaction(Idx: Integer);
TIBDatabase
REMOVETRANSACTIONS
Descrio
Esse mtodo cancela a associao de todas as transaes.
Declarao
procedure RemoveTransactions;
TIBDatabase
REPAINT
Descrio
O mtodo Repaint atualiza as imagens exibidas pelos controles sem apagar a imagem atual.
Declarao
procedure Repaint;
Exemplo
O trecho de cdigo a seguir fora a atualizao da imagem exibida em um controle chamado Image1
do tipo TImage ao se clicar sobre um boto chamado Button1 com o boto esquerdo do mouse.
procedure TForm1.Button1Click(Sender: Tobject);
begin
Image1.Repaint;
end;
Observao: Ao contrrio do que ocorre com o mtodo Refresh, a imagem atual no apagada.
Todos os controles.
REPLACEICON
Descrio
Esse mtodo substitui a imagem armazenada na posio definida pelo parmetro Index pelo cone
passado pelo parmetro Image.
Declarao
procedure ReplaceIcon(Index: Integer; Image: TIcon);
TListImages
REPLACEMASKED
Descrio
Esse mtodo substitui a imagem armazenada na posio definida pelo parmetro Index pela imagem
passada no parmetro NewImage e com a mscara transparente definida na propriedade MaskColor.
CAPTULO 42 MTODOS
Declarao
procedure ReplaceMasked(Index: Integer; NewImage: TBitmap; MaskColor: TColor);
TListImages
REQUESTDATA
Descrio
Esse mtodo obtm um dado (definido no parmetro Item) de uma aplicao servidora em uma
conversao DDE.
Declarao
function RequestData(const Item: string): PChar;
TDDEClientConv
RESET
Descrio
Esse mtodo redefine os valores default para as propriedades StartFrame e StopFrame do componente,
exibe o seu primeiro quadro e atribui o valor False sua propriedade Active.
Declarao
Procedure Reset;
TAnimate
RESOURCELOAD
Descrio
Esse mtodo carrega um recurso do tipo TResType na lista de imagens do componente, com a mscara
transparente definida na propriedade MaskColor.
Declarao
function ResourceLoad(ResType: TResType; Name: string; MaskColor: TColor): Boolean;
TListImages
RESTORE
Descrio
Esse mtodo restaura o tamanho que o formulrio principal de uma aplicao tinha antes de ser
minimizado ou maximizado.
Declarao
procedure Restore;
Exemplo
O trecho de cdigo a seguir executa o mtodo Restore em uma aplicao.
Application. Restore;
TApplication
RESTORETOPMOSTS
Descrio
Esse mtodo faz com que os formulrios recuperem seu comportamento definido pela propriedade
FormStyle igual a fsStayOnTop aps terem seu comportamento alterado pela execuo do mtodo
NormalizeTopMosts.
Declarao
procedure RestoreTopMosts;
Exemplo
O trecho de cdigo a seguir executa o mtodo RestoreTopMosts em uma aplicao.
Application. RestoreTopMosts;
TApplication
RESUME
Descrio
Para objetos da classe TMediaPlayer, reinicia a reproduo em um dispositivo multimdia interrompida
pelo mtodo Pause.
Para objetos da classe Tthread, reinicia a sua execuo.
Declarao
procedure Resume;
Exemplo
O trecho de cdigo a seguir reinicia a reproduo em um dispositivo multimdia interrompida com
um mtodo Pause.
MediaPlayer1.Resume;
TMediaPlayer e TThread
REWIND
Descrio
O mtodo Rewind define a posio corrente em um dispositivo multimdia como a definida na
propriedade Start.
Declarao
procedure Rewind;
Exemplo
O trecho de cdigo a seguir comea a reproduo no incio de um dispositivo multimdia quando um
boto chamado Rewind do tipo TButton selecionado:
procedure TForm1.RewindClick(Sender: TObject);
begin
MediaPlayer1.Rewind;
MediaPlayer1.Play;
end;
TMediaPlayer
CAPTULO 42 MTODOS
ROLLBACK
Descrio
Esse mtodo desfaz a transao corrente e todas as modificaes feitas nos registros do banco de dados
associado desde a ltima chamada ao mtodo StartTransaction.
Declarao
procedure RollBack;
ROLLBACKRETAINING
Descrio
Esse mtodo desfaz a transao corrente e todas as modificaes feitas nos registros do banco de dados
associado desde a ltima chamada ao mtodo StartTransaction, mantendo o contexto de transao corrente.
Declarao
procedure RollBackRetaining;
ROUNDRECT
Descrio
Esse mtodo desenha um retngulo definido pelos pontos (X1,Y1) vrtice superior esquerdo e (X2,Y2)
vrtice inferior direito, com os cantos arredondados por um quadrante elptico de dimenses X3 e
Y3, usando o pincel e a caneta correntes.
Declarao
procedure RoundRect(X1, Y1, X2, Y2, X3, Y3: Integer);
TCanvas
RUN
Descrio
Para componentes do tipo TApplication, esse mtodo executa a aplicao. Normalmente, a chamada a
esse mtodo feita no arquivo de projeto (*.DPR) e includa automaticamente pelo Delphi.
Declarao
procedure Run;
Exemplo
O trecho de cdigo a seguir executa uma aplicao:
Application.Run
TApplication
SAVE
Descrio
Para componentes do tipo TMediaPlayer, esse mtodo salva o registro corrente em um dispositivo
multimdia, em um arquivo definido pela propriedade FileName.
Para componentes do tipo TQRPrinter, esse mtodo salva o relatrio corrente em um arquivo, definido
pelo parmetro Filename.
Declarao
Para componentes do tipo TMediaPlayer:
procedure Save;
Para componentes do tipo TQRPrinter:
procedure Save(Filename : String)
Exemplo
O trecho de cdigo a seguir inicia a gravao em um dispositivo multimdia quando um boto Save do
tipo TButton selecionado:
procedure TForm1.SaveClick(Sender: TObject);
begin
MediaPlayer1.Save;
end;
TMediaPlayer e TQRPrinter
SAVETOBITMAPFILE
Descrio
Esse mtodo grava, em um arquivo no formato bitmap, o grfico exibido no componente.
Declarao
procedure SaveToBitmapFile( Const FileName : String ) ;
TChart e TDBChart
SAVETOFILE
Descrio
O mtodo SaveToFile salva um objeto ou relatrio no arquivo definido pelo parmetro FileName.
Declarao
procedure SaveToFile(const FileName: string);
Exemplo
A linha de cdigo a seguir faz com que a lista de strings, armazenada na propriedade Lines de um
componente Memo1 do tipo TMemo, seja salva em um arquivo chamado temp.txt:
Memo1.Lines.SaveToFile(TEMP.TXT);
TBitmap, TBlobField, TClientDataset, TGraphic, TGraphicField, TIcon, TMemoField, TMetaFile,
TPicture, TStringList, TStrings, TOLEContainer, TOutline e TrvProject.
SAVETOMETAFILE
Descrio
Esse mtodo grava, em um arquivo no formato windows metafile (wmf), o grfico exibido no componente.
Declarao
procedure SaveToMetafile(Const FileName : String);
CAPTULO 42 MTODOS
TChart e TDBChart
SAVETOMETAFILEENH
Descrio
Esse mtodo grava, em um arquivo no formato enhanced windows metafile, o grfico exibido no componente.
Declarao
procedure SaveToMetafileEnh(Const FileName : String);
TChart e TDBChart
SAVETOSTREAM
Descrio
Esse mtodo copia o contedo do campo ou relatrio na stream especificada no parmetro Stream.
Declarao
procedure SaveToStream(Stream: TStream);
Exemplo
O trecho de cdigo a seguir salva o contedo do campo BlobField1 do tipo TBlobField em uma stream
chamada Stream1.
BlobField1.SaveToStream(Stream1);
TClientDataset, TBlobField, TDBMemoBuf, TGraphicField, TmemoBuf, TmemoField e TrvProject.
SCALEBY
Descrio
Esse mtodo faz uma transformao de escala nas dimenses de um componente, em relao s suas
dimenses iniciais. Para isso, devem ser fornecidos os parmetros inteiros M e D que so,
respectivamente, o Numerador e o Denominador do fator de escala.
Declarao
procedure ScaleBy(M, D: Integer);
Exemplo
Se voc quiser que um boto Button1 dobre as suas dimenses quando o usurio der um clique sobre
ele com o boto do mouse, inclua a seguinte linha de cdigo no seu evento OnClick:
Button1.ScaleBy(2,1);
Todos os controles.
SCREENTOCLIENT
Descrio
Esse mtodo faz a transformao das coordenadas de um ponto do sistema de coordenadas da tela para
o sistema de coordenadas da rea-cliente (o inverso do mtodo ClientToScreen).
Declarao
function ScreenToClient (Point: TPoint): TPoint;
Exemplo
O trecho de cdigo que se segue define P e Q como variveis do tipo TPoint no evento OnMouseDown
de um formulrio. Ao ponto P so atribudas as coordenadas do ponto em que o boto do mouse foi
pressionado (sistema de coordenadas da tela), e esses valores so armazenados no ponto Q aps a
transformao para o sistema de coordenadas da rea-cliente o formulrio.
var
P, Q: TPoint;
begin
P.X:= Left + X;
P.Y:= Top + Y;
Q:= ScreenToClient(P);
end;
Esse mtodo uma funo e, conseqentemente, o seu valor de retorno pode ser atribudo a uma varivel.
Todos os controles.
SCROLLBY
Descrio
O mtodo ScrollBy faz a rolagem do contedo de um formulrio ou controle-pai. Os parmetros
DeltaX e DeltaY definem a variao, em pixels, ao longo dos eixos X e Y, respectivamente. Um valor
positivo de DeltaX provoca uma rolagem para a direita e um valor negativo provoca uma rolagem
para a esquerda. Um valor positivo de DeltaY provoca uma rolagem para baixo e um valor negativo
provoca uma rolagem para cima.
Declarao
procedure ScrollBy(DeltaX, DeltaY: Integer);
Exemplo
Se voc quiser que o contedo de um formulrio Form1 role 10 unidades para a direita e para baixo
cada vez que o usurio clicar sobre um boto chamado Button1, defina o evento OnClick de Button1
da seguinte forma:
begin
ScrollBy(10,10);
end;
Todos os controles.
SCROLLINVIEW
Descrio
Esse mtodo rola o contedo de um componente do tipo TForm ou TScrollBox de forma que o controle
especificado no parmetro AControl seja ao menos parcialmente visvel.
CAPTULO 42 MTODOS
Declarao
procedure ScrollInView(AControl: TControl);
Exemplo
A linha de cdigo a seguir rola o contedo de um formulrio chamado Form1 at que um boto
chamado Button1 do tipo TButton esteja ao menos parcialmente visvel.
ScrollInView(Button1);
TForm e TScrollBox
SEEK
Descrio
Para objetos da classe TBlobStream, esse mtodo reposiciona o ponteiro de leitura em um campo
de um dado.
Para objetos da classe TAnimate, esse mtodo reposiciona o clipe no quadro cujo ndice passado
como parmetro.
Declarao
Para objetos da classe TBlobStream:
function Seek(Offset: Longint; Origin: Word): Longint;
Para objetos da classe TAnimate:
procedure Seek(Frame: SmallInt);
TAnimate, TBlobStream
SELECTALL
Descrio
O mtodo SelectAll seleciona todos os itens de um componente.
Declarao
procedure SelectAll;
Exemplo
Se voc quiser selecionar todos os itens de um componente Memo1 do tipo TMemo, basta incluir a
Memo1.SelectAll;
TComboBox, TDBComboBox, TDBEdit, TDBMemo, TDriveComboBox, TEdit, TFilterComboBox, TMaskEdit e
TMemo
SELECTNEXT
Descrio
O mtodo SelectNext seleciona a prxima guia em um controle do tipo TTabSet. O parmetro booleano
Direction define se a prxima guia a ser selecionada deve ser a da direita (True) ou a da esquerda (False).
Declarao
procedure SelectNext(Direction: Boolean);
Exemplo
A linha de cdigo a seguir seleciona a guia da esquerda da guia correntemente selecionada.
TabSet1.SelectNext(False);
TTabSet
SELECTNEXTPAGE
Descrio
Esse mtodo permite que se especifique a prxima pgina a ser exibida pelo controle. Se o parmetro
GoForWard for igual a True, a prxima pgina ser a numericamente subseqente. Se o parmetro
GoForWard for igual a False, a prxima pgina ser a numericamente anterior.
Declarao
procedure SelectNextPage(GoForward: Boolean);
TPageControl
SENDTOBACK
Descrio
O mtodo SendToBack coloca o controle atrs de todos os controles que existem no mesmo formulrio
( o inverso do mtodo BringToFront).
Declarao
procedure SendToBack;
Exemplo
O trecho de cdigo a seguir faz com que um boto de rdio chamado RadioButton1 seja colocado atrs
de todos os outros componentes que existem no mesmo formulrio:
RadioButton1.Bring SendToBack;
SERIESCOUNT
Descrio
Esse mtodo retorna o nmero de sries mostradas no grfico exibido no componente.
Declarao
function SeriesCount : Longint ;
TChart e TDBChart
SETASHANDLE
Descrio
Esse mtodo define um handle para um objeto com o formato definido no parmetro Format a ser
armazenado no clipboard.
Declarao
function SetAsHandle (Format: Word): THandle;
CAPTULO 42 MTODOS
TClipboard
SETBOUNDS
Descrio
O mtodo SetBounds define de uma s vez o valor das variveis Left, Top, Width e Height de um componente,
por meio dos valores passados pelos parmetros ALeft, ATop, AWidth e Aheight, respectivamente.
Declarao
procedure Setbounds(ALeft, ATop, AWidth, AHeight: Integer);
Exemplo
O trecho de cdigo a seguir dobra o tamanho de um boto chamado Button1 quando o usurio clica
sobre ele com o boto esquerdo do mouse:
begin
Button1.SetBounds(Left, Top, Width * 2, Height * 2);
end;
Todos os controles.
SETCOMPONENT
Descrio
Esse mtodo copia um componente (definido pelo parmetro Component) no clipboard.
Declarao
procedure SetComponent(Component: TComponent);
TClipboard
SETDATA
Descrio
Esse mtodo armazena no campo o valor do parmetro Buffer.
Declarao
procedure SetData(Buffer: Pointer);
SETFIELDS
Descrio
Esse mtodo atribui aos campos de um banco de dados os valores definidos na array passado pelo
parmetro Values.
Declarao
procedure SetFields(const Values: array of const);
SETFOCUS
Descrio
O mtodo SetFocus faz com que o controle receba o foco da aplicao.
Declarao
procedure SetFocus;
Exemplo
O trecho de cdigo a seguir faz com que um controle Edit1 do tipo TEdit receba o foco da aplicao:
Edit1.SetFocus;
Todos os controles.
SETKEY
Descrio
Esse mtodo usado para definir valores para o buffer de pesquisa em uma tabela.
Declarao
procedure SetKey;
TClientDataset, TIBClientDataset, TSimpleDataset e TTable
SETLINK
Descrio
Esse mtodo define a aplicao servidora e o tpico em uma conversao DDE.
Declarao
function SetLink(Service: string; Topic: string): Boolean;
TDDEClientConv
SETPARAMS
Descrio
O mtodo SetParams define com os parmetros Aposition, AMin e AMax os valores das propriedades
Position, Min e Max de uma barra de rolamento.
Declarao
procedure SetParams(APosition, AMin, AMax: Integer);
Exemplo
Voc pode definir os parmetros de uma barra de rolamento com uma chamada ao mtodo SetParams,
como no trecho de cdigo a seguir:
ScrollBar1.SetParams(10,0,100);
TScrollBar
SETPRINCIPAL
Descrio
Esse mtodo envia uma array de bytes para a aplicao servidora.
CAPTULO 42 MTODOS
Declarao
procedure SetPrincipal(const Principal: TCorbaPrincipal);
onde TCorbaPrincipal definido como:
TCorbaPrincipal = array of Byte;
ICorbaObject
SETPRINTER
Descrio
Esse mtodo especifica uma impressora como a impressora corrente.
Declarao
procedure SetPrinter(ADevvice, ADriver, APort: PChar; ADeviceMode: THandle);
TPrinter
SETRANGE
Descrio
Esse mtodo corresponde a chamar os mtodos SetRangeStart, SetRangeEnd e
ApplyRange.
Declarao
procedure SetRange(const StartValues, EndValues: array of const);
TClientDataset, TIBClientDataset, TSimpleDataset e TTable
SETRANGEEND
Descrio
Esse mtodo indica que as atribuies de campo que se seguirem definiro o trmino da faixa de
registros a incluir no banco de dados associado.
Declarao
procedure SetRangeEnd;
TClientDataset, TTable
SETRANGESTART
Descrio
Esse mtodo indica que as atribuies de campo que se seguirem definiro o incio da faixa de registros
a incluir no banco de dados associado.
Declarao
procedure SetRangeStart;
TClientDataset, TTable
SETSELTEXTBUF
Descrio
O mtodo SetSelTextBuf atribui, ao texto selecionado em um controle, a string terminada em zero
apontada pela varivel Buffer.
Declarao
procedure SetSelTextBuf(Buffer: PChar);
Exemplo
Se voc quiser que um componente Edit1 do tipo TEdit substitua o texto selecionado pela mensagem
Voc pressionou o boto 1 quando o usurio clicar sobre um boto chamado Button1, pode incluir a
seguinte linha de cdigo no evento OnClick associado ao boto:
Edit1.SetSelTextBuf(Voc pressionou o boto 1);
TComboBox, TDBComboBox, TDBEdit, TDBMemo, TEdit, TMaskEdit e TMemo
SETTABFOCUS
Descrio
O mtodo SetTabFocus faz com que a pgina ativa seja aquela cujo valor da propriedade PageIndex
igual ao parmetro Index.
Declarao
procedure SetTabFocus(Index: Integer);
Exemplo
O trecho de cdigo a seguir faz com que a segunda pgina de um componente TabbedNotebook1 do
tipo TTabbedNotebook seja a pgina ativa.
TabbedNotebook1.SetTabFocus[1];
TTabbedNotebook
SETTEXT
Descrio
Esse mtodo armazena uma lista de strings, definida como uma string de terminao nula no
parmetro Text.
Declarao
procedure SetText(Text: PChar);
Tstrings e TStringList
SETTEXTBUF
Descrio
O mtodo SetTextBuf atribui ao texto exibido por um controle a string terminada em zero apontada
pela varivel Buffer.
Declarao
procedure SetTextBuf(Buffer: PChar);
CAPTULO 42 MTODOS
Exemplo
Se voc quiser que um componente Edit1 do tipo TEdit exiba a mensagem Voc pressionou o boto 1
quando o usurio clicar sobre um boto chamado Button1, pode incluir a seguinte linha de cdigo no
evento OnClick associado ao boto:
Edit1.SetTextBuf(Voc pressionou o boto 1);
Todos os controles e objetos do tipo TClipboard.
SETUPDATESTATE
Descrio
O mtodo SetUpdateState define se a reindexao dos itens em um componente do tipo TOutline deve
ou no ser feita automaticamente, de acordo com o valor passado pelo parmetro Value.
Declarao
procedure SetUpdateState(Value: Boolean);
Exemplo
Voc pode acionar o mtodo SetUpdateState de um componente Outline1 do tipo TOutline mediante
Outline1.SetUpdateState(True);
TOutline;
SHOW
Descrio
O mtodo Show torna visvel um componente, fazendo sua propriedade Visible igual a True ( o
inverso do mtodo Hide).
Declarao
procedure Show;
Exemplo
Se voc quiser que um boto chamado Button1 aparea em um formulrio que o contm (Form1) ao se
clicar sobre o formulrio com o boto esquerdo do mouse, defina o evento OnClick do formulrio da
seguinte forma:
begin
Button1.Show;
end;
SHOWCUBEDIALOG
Descrio
Esse mtodo exibe a caixa de dilogo do editor de propriedades do componente.
Declarao
procedure ShowCubeDialog;
TDecisionCube
SHOWDRAGIMAGE
Descrio
Esse mtodo exibe a imagem correntemente arrastada, que havia sido ocultada por uma chamada ao
mtodo HideDragImage.
Declarao
procedure ShowDragImage;
TImageList
SHOWEXCEPTION
Descrio
Esse mtodo exibe uma mensagem informando uma exceo ocorrida durante a execuo da aplicao.
Declarao
procedure ShowException(E: Exception);
Exemplo
O trecho de cdigo a seguir executa o mtodo ShowException em uma aplicao:
var
E : Exception;
begin
E := Exception.Create(Exceo);
Application.ShowException(E);
end;
Tapplication
SHOWMODAL
Descrio
O mtodo ShowModal exibe um formulrio de forma modal, isto , a aplicao s pode continuar fora
do formulrio depois que este fechado pelo usurio. Quando isso ocorre, a propriedade ModalResult do
formulrio retorna um valor diferente de zero.
Declarao
procedure ShowModal;
Exemplo
Se voc quiser que um formulrio chamado Form2 aparea de forma modal ao se clicar sobre um boto
Button1 de um formulrio chamado Form1, defina o evento OnClick de Button1 da seguinte forma:
begin
Form2.ShowModal;
end;
TForm
CAPTULO 42 MTODOS
STARTRECORDING
Descrio
O mtodo StartRecording inicia a gravao no registro corrente ou na posio definida pela propriedade
StartPos em um dispositivo multimdia.
Declarao
procedure StartRecording;
Exemplo
O trecho de cdigo a seguir executa o mtodo StartRecording em um dispositivo multimdia:
MediaPlayer1.StartRecording;
TMediaPlayer
STARTTRANSACTION
Descrio
Esse mtodo inicia uma transao no nvel de isolamento definido pela propriedade Transisolation.
Declarao
STEP
Descrio
O mtodo Step faz com que o dispositivo multimdia avance um certo nmero de quadros, especificado
na propriedade Frames.
Declarao
procedure Step;
Exemplo
O trecho de cdigo a seguir faz com que um dispositivo multimdia acione seu mtodo Step com um
boto Step do tipo TButton:
procedure TForm1.StepClick(Sender: TObject);
begin
MediaPlayer1.Step;
end;
TMediaPlayer
STOP
Descrio
O mtodo Stop interrompe a reproduo ou a gravao em um dispositivo multimdia (no caso do
componente TMediaPlayer) ou do clipe AVI (no caso do componente TAnimate).
Declarao
procedure Stop;
Exemplo
O trecho de cdigo a seguir interrompe a reproduo ou gravao em um dispositivo multimdia
quando um boto Stop do tipo TButton selecionado:
procedure TForm1.StopClick(Sender: TObject);
begin
MediaPlayer1.Stop;
end;
TAnimate e TMediaPlayer
STRETCHDRAW
Descrio
Esse mtodo desenha o objeto grfico definido no parmetro Graphic na rea retangular definida pelo
parmetro Rect, redimensionando o grfico de forma a ocupar toda a rea retangular.
Declarao
procedure StretchDraw(const Rect: TRect; Graphic: TGraphic);
TCanvas
SUSPEND
Descrio
Esse mtodo suspende a execuo de uma thread.
Declarao
procedure Suspend;
TThread
SYNCHRONIZE
Descrio
Esse mtodo sincroniza a execuo do mtodo passado como parmetro com a thread principal da VCL.
Declarao
procedure Synchronize(Method: TThreadMethod);
TThread
TERMINATE
Descrio
Para objetos da classe TApplication, esse mtodo finaliza a aplicao.
Para objetos da classe TThread, esse mtodo finaliza a sua execuo.
Declarao
Para TApplication e TThread:
procedure Terminate;
Para TIWApplication
procedure Terminate(const AMsg: string);
Exemplo
O trecho de cdigo finaliza a execuo de uma aplicao:
CAPTULO 42 MTODOS
TApplication, TIWApplication e TThread
TESTCONNECTED
Descrio
Esse mtodo verifica se a conexo ao banco de dados representado pelo componente est ativa.
Declarao
function TestConnected: Boolean;
TIBDatabase
TEXTHEIGHT
Descrio
Esse mtodo retorna a altura, em pixels, da string passada no parmetro text para a fonte corrente.
Declarao
function TextHeight(const Text: string): Integer;
TCanvas
TEXTOUT
Descrio
Esse mtodo desenha a string passada no parmetro Text para a fonte corrente na posio X,Y (canto
superior esquerdo da string).
Declarao
procedure TextOut(X, Y: Integer; const Text: string);
TCanvas
TEXTRECT
Descrio
Esse mtodo desenha a string passada no parmetro Text para a fonte corrente na posio X,Y (canto
superior esquerdo da string), em um retngulo de clipping definido no parmetro Rect.
Declarao
procedure TextRect(Rect: TRect; X, Y: Integer; const Text: string);
TCanvas
TEXTWIDTH
Descrio
Esse mtodo retorna a largura, em pixels, da string passada no parmetro text para a fonte corrente.
Declarao
function TextWidth(const Text: string): Integer;
TCanvas
TILE
Descrio
O mtodo Tile exibe todos os formulrios-filhos ativos de um formulrio-pai com o mesmo tamanho
e ocupando toda a rea-cliente do formulrio-pai. Esse mtodo s se aplica aos formulrios-pais cuja
propriedade FormStyle vale fsMDIForm. A forma de exibio depende do valor da propriedade TileMode.
Declarao
procedure Tile;
Exemplo
Crie um item de menu chamado TileFormsClick no menu principal do formulrio-pai MDI e defina o
seu evento OnClick da seguinte forma, para que os formulrios-filhos sejam exibidos lado a lado e
verticalmente:
procedure TForm1.TileForms1Click(Sender: TObject);
begin
TileMode := tbVertical;
Tile;
end;
TForm
TRUNCATE
Descrio
Esse mtodo trunca o contedo do campo definido pelo objeto na posio corrente do ponteiro,
descartando os dados restantes.
Declarao
procedure Truncate;
TBlobStream
UNLOCKTABLE
Descrio
Esse mtodo remove uma restrio imposta a outras aplicaes que acessam a tabela para leitura e/ou
gravao, feita por uma chamada ao mtodo LockTable.
Declarao
onde TLockType um tipo enumerado definido da seguinte maneira:
type TLockType = (ltReadLock, ltWriteLock);
TTable
UNMERGE
Descrio
Esse mtodo desfaz a mesclagem de dois menus de formulrios diversos em uma aplicao no-MDI. O
parmetro Menu define o menu a ser retirado da combinao.
Declarao
procedure Unmerge(Menu: TMainMenu);
CAPTULO 42 MTODOS
TMainMenu
UNPREPARE
Descrio
Para componentes do tipo TIBDataset, TADOQuery, TIBQuery, TQuery, esse mtodo atribui o valor
False propriedade Prepared do componente.
Para componentes dos tipos TADOStoredProc, TIBStoredproc, e TStoredProc, esse mtodo informa ao
servidor que o procedimento armazenado no ser mais usado, possibilitando a liberao de recursos
do sistema.
Declarao
TADOQuery, TADOStoredProc, TIBDataset, TIBQuery, TIBStoredproc, TStoredProc e TQuery
UNREGISTERCHANGES
Descrio
Esse mtodo cancela os efeitos da chamada ao mtodo RegisterChanges.
Declarao
procedure UnRegisterChanges(Value: TChangeLink);
TListImages
UNREGISTEREVENTS
Descrio
Este mtodo cancela o registro dos eventos definidos pela propriedade Events do componente.
Declarao
procedure UnregisterEvents;
TIBEvents
UPDATE
Descrio
No caso dos controles em geral, o mtodo Update chama a funo UpdateWindow da API do Windows
para atualizar a sua exibio. No caso de objetos do tipo TFileListBox e TDirectoryListBox, o mtodo
fora a atualizao da lista de diretrios e arquivos. Para componentes dos tipos TFieldDefs e TIndexDefs,
o mtodo atualiza a propriedade Items.
Para objetos da classe TAction, executa o procedimento associado ao evento OnUpdate (se este
estiver definido).
Declarao
Para objetos da classe TAction:
function Update: Boolean; override;
Para as demais classes e componentes:
procedure Update;
Exemplo
Para forar um componente Memo1 do tipo TMemo a atualizar a sua exibio, use a seguinte linha de cdigo:
Memo1.Update;
Todos os controles, objetos dos tipos TAction, TFieldDefs e TIndexDefs, e componentes dos tipos
TDirectoryListBox e TFileListBox.
UPDATECURSORPOS
Descrio
Esse mtodo ajusta a posio corrente do cursor no banco de dados de acordo com a posio atual do
cursor no Borland Database Engine.
Declarao
procedure UpdateCursorPos;
TTable, TStoredProc e TQuery
UPDATERECORD
Descrio
Esse mtodo atualiza os registros em todos os componentes do tipo TDataSource.
Declarao
procedure UpdateRecord;
TIBStoredProc, TTable, TQuery , TStoredProc, TClientDataset, TIBClientDataset, TSimpleDataset
e TTable
VALIDATEEDIT
Descrio
Esse mtodo analisa o valor da propriedade EditText para verificar a existncia de espaos em branco
nos quais requerida a presena de um caractere. Se ocorrer, provoca uma exceo do tipo EDBEditError.
Declarao
procedure ValidateEdit;
Exemplo
O trecho de cdigo a seguir usa o mtodo ValidateEdit no evento OnExit de um componente DBEdit1
do tipo TDBEdit:
procedure TForm1.DBEdit1Exit(Sender: TObject);
begin
ValidateEdit;
end;
TDBEdit e TMaskEdit
WRITE
Descrio
Esse mtodo copia os bytes, armazenados na varivel definida pelo parmetro Buffer, no campo
representado pelo objeto.
CAPTULO 42 MTODOS
Declarao
function Write(const Buffer; Count: Longint): Longint; override;
TBlobStream
WRITEBCDDATA
Descrio
Esse mtodo escreve um valor do tipo Binrio quando da ocorrncia de um evento OnGetRow do
componente de acesso vinculado ao relatrio que est sendo gerado.
Declarao
function WriteBCDData(FormatData: String; NativeData: Currency): String;
TTRvCustomConnection, TRvDatasetConnection, TRvQueryConnection e TRvTableConnection.
WRITEBLOBDATA
Descrio
Esse mtodo escreve um valor do tipo Blob (Binary Large Objects) quando da ocorrncia de um evento
OnGetRow do componente de acesso vinculado ao relatrio que est sendo gerado.
Declarao
function WriteBlobData(var: Buffer; Len: Longint): String;
TTRvCustomConnection, TRvDatasetConnection, TRvQueryConnection e TRvTableConnection
WRITEBOOL
Descrio
Esse mtodo escreve um valor booleano (definido no parmetro Ident) em uma seo (definida no
parmetro Section) de um arquivo INI.
Declarao
procedure WriteBool(const Section, Ident: string; Value: Boolean);
TIniFile
WRITEBOOLDATA
Descrio
Esse mtodo escreve um valor do tipo Booleano quando da ocorrncia de um evento OnGetRow do
Declarao
function WriteBoolData(FormatData: String; NativeData: Boolean): String;
WRITECURRDATA
Descrio
Esse mtodo escreve um valor do tipo Currency quando da ocorrncia de um evento OnGetRow do
Declarao
function WriteCurrData(FormatData: String; NativeData: Currency): String;
WRITEDATETIME
Descrio
Esse mtodo escreve um valor do tipo DateTime quando da ocorrncia de um evento OnGetRow do
Declarao
function WriteDateTime(FormatData: String; NativeData: TDateTime);
WRITEFLOATDATA
Descrio
Esse mtodo escreve um valor do tipo float (real) quando da ocorrncia de um evento OnGetRow do
Declarao
function WriteFloatData(FormatData: String; NativeData: Extended): String;
WRITEINTDATA
Descrio
Esse mtodo escreve um valor do tipo inteiro quando da ocorrncia de um evento OnGetRow do
Declarao
function WriteIntData(FormatData: String; NativeData: Integer): String;
WRITEINTEGER
Descrio
Esse mtodo escreve um valor inteiro (definido no parmetro Ident) em uma seo (definida no
Declarao
procedure WriteInteger(const Section, Ident: string; Value: Longint);
TIniFile
WRITENULLDATA
Descrio
Esse mtodo escreve um valor do tipo NULL quando da ocorrncia de um evento OnGetRow do
CAPTULO 42 MTODOS
Declarao
function WriteNullData( no parameters );
WRITESTRDATA
Descrio
Esse mtodo escreve um valor do tipo string quando da ocorrncia de um evento OnGetRow do
Declarao
function WriteStrData(FormatData: String; NativeData: String): String;
WRITESTRING
Descrio
Esse mtodo escreve o valor de uma string (definida no parmetro Ident) em uma seo (definida no
Declarao
procedure WriteString(const Section, Ident, Value: String);
TIniFile
ZOOMTOFIT
Descrio
Esse mtodo executa um zoom na pr-visualizao do relatrio, de forma a ocupar toda a rea do componente.
Declarao
procedure ZoomToFit;
TQRPreview
ZOOMTOWIDTH
Descrio
Esse mtodo executa um zoom na pr-visualizao do relatrio, de forma a ocupar toda a largura do
componente.
Declarao
procedure ZoomToWidth;
TQRPreview.
CAPTULO 43 EVENTOS
Captulo
Eventos
43
AFTERCANCEL
Descrio
Esse evento ocorre aps uma chamada ao mtodo Cancel do componente.
TADOTable, TADOQuery, TADODataset, TADOStoredproc, TIBTable, TIBQuery, TIBDataset,
TIBStoredproc, TClientDataset, TTable, TStoredProc TQuery, TDecisionQuery, TIBClientDataset e
TSQLClientDataset
AFTERCLOSE
Descrio
Esse evento ocorre aps uma chamada ao mtodo Close do componente.
TIBStoredproc, TClientDataset, TDecisionCube, TTable, TSQLTable, TSQLQuery, TSQLStoredProc,
TStoredProc, TQuery, TDecisionQuery, TIBClientDataset e TSQLClientDataset
AFTERCONNECT
Descrio
Esse evento ocorre aps se estabelecer uma conexo a um banco de dados.
TDatabase, TIBDatabase, TADOConnection, TRDSConnection, TSQLConnection
AFTERDELETE
Descrio
Esse evento ocorre aps uma chamada ao mtodo Delete do componente.
TSQLClientDataset.
AFTERDETAIL
Descrio
Esse evento ocorre logo aps a impresso de um registro acessado atravs de um componente do tipo
TQRBand.
TQuickReport
AFTERDISCONNECT
Descrio
Esse evento ocorre imediatamente aps se encerrar uma conexo a um banco de dados.
AFTERDISPATCH
Descrio
Esse evento ocorre quando o componente gera o contedo a ser enviado como mensagem de resposta
a uma solicitao.
CAPTULO 43 EVENTOS
TXMLBroker e TWebDispatcher
AFTERDRAWVALUES
Descrio
Esse evento ocorre logo aps os pontos de uma srie terem sido plotados em um grfico.
TChartSeries
AFTEREDIT
Descrio
Esse evento ocorre aps uma chamada ao mtodo Edit do componente.
TSQLClientDataset.
AFTERINSERT
Descrio
Esse evento ocorre aps uma chamada ao mtodo Insert do componente.
TSQLClientDataset.
AFTEROPEN
Descrio
Esse evento ocorre aps uma chamada ao mtodo Open do componente.
TStoredProc, TQuery, TDecisionQuery, , TIBClientDataset e TSQLClientDataset.
AFTERPOST
Descrio
Esse evento ocorre aps uma chamada ao mtodo Post do componente.
TSQLClientDataset
AFTERPRINT
Descrio
Esse evento ocorre logo aps a impresso em um componente do tipo TQRBand.
TQRBand
AFTERREFRESH
Descrio
Esse evento ocorre aps uma chamada ao mtodo Refresh do componente.
AFTERSCROLL
Descrio
Esse evento ocorre imediatamente aps se alterar o registro corrente, mediante uma chamada a um dos
mtodos de navegao do componente.
TStoredProc, TQuery, TDecisionQuery, , TIBClientDataset e TSQLClientDataset.
BEFORECANCEL
Descrio
Esse evento ocorre no incio da execuo do mtodo Cancel do componente.
TSQLClientDataset
BEFORECLOSE
Descrio
Esse evento ocorre no incio da execuo do mtodo Close do componente.
BEFORECONNECT
Descrio
Esse evento imediatamente antes de se estabelecer uma conexo a um banco de dados.
BEFOREDELETE
Descrio
Esse evento ocorre no incio da execuo do mtodo Delete do componente.
TSQLClientDataset.
CAPTULO 43 EVENTOS
BEFOREDETAIL
Descrio
Esse evento ocorre imediatamente antes da impresso de um registro acessado atravs de um componente
do tipo TQRBand.
TQuickReport
BEFOREDISCONNECT
Descrio
Esse evento imediatamente antes de se encerrar uma conexo a um banco de dados.
BEFOREDISPATCH
Descrio
Esse evento ocorre quando o componente recebe uma mensagem de solicitao atravs do protocolo http.
TXMLBroker e TWebDispatcher
BEFOREDRAWVALUES
Descrio
Esse evento ocorre antes que os pontos de uma srie sejam plotados em um grfico.
TChartSeries
BEFOREEDIT
Descrio
Esse evento ocorre no incio da execuo do mtodo Edit do componente.
TSQLClientDataset.
BEFOREINSERT
Descrio
Esse evento ocorre no incio da execuo do mtodo Insert do componente.
TSQLClientDataset
BEFOREOPEN
Descrio
Esse evento ocorre no incio da execuo do mtodo Open do componente.
BEFOREPOST
Descrio
Esse evento ocorre no incio da execuo do mtodo Post do componente.
TSQLClientDataset
BEFOREPRINT
Descrio
Esse evento ocorre imediatamente antes da impresso em um componente do tipo TQRBand
TQRBand
BEFOREREFRESH
Descrio
Esse evento ocorre no incio da execuo do mtodo Refresh do componente.
BEFORESCROLL
Descrio
Esse evento ocorre antes de se alterar o registro corrente, mediante uma chamada a um dos mtodos de
navegao do componente.
DATABASEDISONNECTED
Descrio
Esse evento ocorre quando o banco de dados, acessado atravs do mecanismo Interbase Express,
desconectado da aplicao.
TIBDatabase
DATABASEDISONNECTING
Descrio
Esse evento ocorre quando o banco de dados, acessado atravs do mecanismo Interbase Express, est
sendo desconectado da aplicao.
CAPTULO 43 EVENTOS
TIBDatabase
DATABASEFREE
Descrio
Esse evento ocorre quando o componente libera a memria por ele alocada.
TIBDatabase
ONACTIONEXECUTE
Descrio
Este evento ocorre quando o mtodo Execute de um objeto TAction executado, e no tratado pela
lista de aes tratadas pelo componente.
TApplicationEvents
ONACTIONUPDATE
Descrio
Este evento ocorre quando o mtodo Update de um objeto TAction executado, e no tratado pela
lista de aes tratadas pelo componente.
TApplicationEvents
ONACTIVATE
Descrio
Para componentes do tipo TForm, o mtodo OnActivate ocorre quando um formulrio se torna ativo,
isto , quando ele recebe o foco.
Para componentes do tipo TApplication, o mtodo OnActivate ocorre quando a aplicao se torna
ativa, isto , quando o Windows alterna entre outra aplicao e a representada pelo componente.
Exemplo
O trecho de cdigo a seguir faz com que um formulrio chamado Form1 do tipo TForm alterne a sua
cor entre vermelho e amarelo cada vez que o formulrio se torna ativo.
procedure TForm1.FormActivate(Sender: TObject);
begin
if Form1.Color = clRed then Form1.Color: = clYellow else Form1.Color: = clRed;
end;
TApplication, TApplicationEvents e TForm
ONACTIVECONTROLCHANGE
Descrio
Para componentes do tipo TScreen, o mtodo OnActiveControlChange ocorre quando muda o controle
que tem o foco da aplicao (definido na propriedade ActiveControl).
Declarao
property OnActiveFormChange: TNotifyEvent;
TScreen
ONACTIVEFORMCHANGE
Descrio
Para componentes do tipo TScreen, o mtodo OnActiveFormChange ocorre quando muda o formulrio
ativo da aplicao (definido na propriedade ActiveForm).
Declarao
property OnActiveFormChange: TNotifyEvent;
TScreen
ONAFTERADD
Descrio
Esse evento ocorre logo aps um ponto ser adicionado a uma srie.
TChartSeries
ONAFTERCLOSE
Descrio
Esse evento ocorre logo aps o projeto de relatrio representado pelo componente ser fechado.
TRvProject
ONAFTERDRAW
Descrio
Esse evento ocorre logo aps o componente ter exibido todas as sries a ele associadas.
TChart, TDBChart
ONAFTEROPEN
Descrio
Esse evento ocorre logo aps o projeto de relatrio representado pelo componente ser aberto.
TRvProject
ONAFTERPIVOT
Descrio
Esse evento ocorre logo aps uma alterao no estado do piv corrente.
TDecisionSource
ONAFTERPRINT
Descrio
Esse evento ocorre logo aps ao impresso do relatrio representado pelo componente.
CAPTULO 43 EVENTOS
TBaseReport, TRvNDRWriter,TRvRenderPreview e TRvRenderPrinter
ONAFTERRENDER
Descrio
Esse evento ocorre logo aps o formulrio ser exibido como uma pgina HTML.
TIWForm
ONAPPLY
Descrio
Para componentes do tipo TFontDialog, o mtodo OnApply ocorre quando o usurio clica no boto
Apply da caixa de dilogo.
Exemplo
O trecho de cdigo a seguir faz com que a fonte selecionada em uma caixa de dilogo do tipo TFontDialog
seja aplicada ao texto exibido num controle chamado Edit1 do tipo Tedit quando o usurio seleciona
o boto Apply.
procedure TForm1.FontDialog1Apply(Sender: TObject; Wnd: Word);
begin
Edit1.Font: = FontDialog1.Font;
end;
TFontDialog
ONBEFOREADD
Descrio
Esse evento ocorre antes de um ponto ser adicionado a uma srie.
TChartSeries
ONBEFORECLOSE
Descrio
Esse evento ocorre imediatamente aps o projeto de relatrio representado pelo componente ser fechado.
TRvProject
ONBEFOREOPEN
Descrio
Esse evento ocorre imediatamente antes de o projeto de relatrio representado pelo componente ser
aberto.
TRvProject
ONBEFOREPIVOT
Descrio
Esse evento ocorre imediatamente antes de uma alterao no estado do piv corrente.
TDecisionSource
ONBEFOREPRINT
Descrio
Esse evento ocorre imediatamente antes da impresso do relatrio representado pelo componente.
ONBEGINRETRIEVAL
Descrio
Esse evento ocorre quando um documento HTML comea a ser carregado.
THTML
ONBEGINTRANSCOMPLETE
Descrio
Esse evento ocorre aps o incio de uma transao.
TADOConnection
ONCALCFIELDS
Descrio
Esse evento ocorre no incio da leitura de um registro de um banco de dados.
TClientDataset, TTable, TStoredProc e TQuery, TDecisionQuery
ONCANCEL
Descrio
Esse evento ocorre ao se cancelar a atualizao de um registro.
TIWDBNavigator
ONCHANGE
Descrio
O evento OnChange ocorre quando uma propriedade de um componente ou objeto alterada durante
a execuo do aplicativo.
Exemplo
O trecho de cdigo a seguir faz com que uma caixa de edio alterne sua cor entre vermelho e amarelo
quando o usurio altera seu texto (sua propriedade Text) durante a execuo do aplicativo.
procedure TForm1.Edit1Change(Sender: TObject);
begin
if Edit1.Color = clRed then Edit1.Color:= clYellow else Edit1.Color:= clRed;
end;
CAPTULO 43 EVENTOS
TActionList, TBitmap, TBrush, TCanvas, TComboBox, TFont, TGraphic, TGraphicsObject, TMetafile,
TPen, TPicture, TStringList objects, TComboBox, TDirectoryListBox, TDriveComboBox, TEdit,
TFileListBox, TFilterComboBox, TIWCombobox, TIWDBCombobox, TIWDBLookupCombobox,
TIWDBLookupListbox, TMaskEdit, TMemo, TQuery, TDecisionQuery, TScrollBar, TClientDataset,
TTable, TAutoIncField, TBCDField, TBlobField, TBooleanField, TBytesField, TCurrencyField,
TSmallintField, TStringField, TTimeField, TVarBytesField, TWordField e TTabSet, TDDEClientItem
e TDDEServerItem
ONCHANGING
Descrio
Para componentes do tipo Tcanvas, esse evento ocorre imediatamente antes de se modificar o grfico
exibido por um objeto do tipo TCanvas.
Para componentes do tipo TUpDown, esse evento ocorre quando o valor armazenado na propriedade
Position do controle est para ser alterado, aps o usurio selecionar uma das setas do
controle.
Para componentes do tipo TTreeView e TListView, esse evento ocorre quando se altera o item
selecionado no controle.
Para componentes do tipo TTabControl e TPageControl, esse evento ocorre quando se altera a
guia selecionada, e antes que esta receba o foco.
TCanvas, TUpDown, TListView, TTreeView, TTabControl e TPageControl
ONCLEARVALUES
Descrio
Esse evento ocorre logo aps os pontos de uma srie terem sido removidos.
TChartSeries
ONCLICK
Descrio
O evento OnClick ocorre quando o usurio d um clique com o boto do mouse sobre um componente,
isto , quando o usurio pressiona e solta o boto primrio do mouse (geralmente o boto esquerdo).
Esse evento tambm ocorre quando:
O usurio seleciona um item de uma Grade, Outline, caixa de lista ou caixa combo com uma
das teclas de seta.
O usurio pressiona a barra de espao enquanto um boto ou caixa de verificao tem o foco
da aplicao.
O usurio pressiona a tecla Enter quando o formulrio ativo tem um boto com a propriedade
Default igual a True.
O usurio pressiona a tecla Esc quando o formulrio ativo tem um boto com a propriedade
Cancel igual a True.
O usurio pressiona a tecla aceleradora correspondente a um boto ou caixa de verificao.
A propriedade Checked de um boto de rdio igual a True.
A propriedade Checked de uma caixa de verificao tem seu valor alterado.
O mtodo Click de um item de menu executado.
O usurio d um clique sobre uma rea em branco de um formulrio.
O usurio d um clique sobre uma das setas em um controle do tipo TUpDown.
O usurio d um clique sobre um dos pontos de uma srie representada por um objeto da
classe TChartSeries.
Exemplo
O trecho de cdigo a seguir faz com que um boto chamado Button1 exiba em sua propriedade Cap-
tion o nmero de vezes que o usurio clicou sobre ele.
begin
n:= n + 1;
Button1.Caption:= IntToStr(n) + Cliques;
end;
TBitBtn, TButton, TChartSeries, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBEdit,
TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo, TDBNavigator, TDBRadioGroup,
TDBText, TDirectoryListBox, TDrawGrid, TDriveComboBox, TFileListBox, TFilterComboBox, TForm,
TFrame, TGroupBox, TImage, TIWButton, TIWCheckbox, TIWDBCheckbox, TIWImage, TIWImagefile,
TIWLink, TIWURL, TLabel, TListBox, TListView, TMaskEdit, TMediaPlayer, TMemo, TMenuItem,
TNotebook, TOutline, TPaintBox, TDecisionPivot,TPanel, TRadioButton, TScrollBar, TScrollBox,
TSpeedButton, TStatusBar, TStringGrid, TTabSet, TtreeView, THTML e TUpDown
ONCLICKAXIS
Descrio
Esse evento ocorre quando o usurio clica sobre um dos eixos do grfico exibido no componente.
TChart, TDBChart
ONCLICKLEGEND
Descrio
Esse evento ocorre quando o usurio clica sobre a rea retangular que define a legenda do grfico
exibido no componente.
TChart, TDBChart
ONCLOSE
Descrio
Para componentes do tipo TForm, esse evento define que manipulador de eventos deve ser chamado
quando um formulrio est prestes a ser fechado. O manipulador de eventos depende do parmetro
Action, que pode ter um dos seguintes valores:
caNone: O formulrio no pode ser fechado.
caHide: O formulrio no fechado, mas no mais visvel.
caFree: O formulrio fechado e toda memria alocada liberada.
caMinimize: O formulrio no fechado, porm minimizado.
CAPTULO 43 EVENTOS
Para componentes dos tipos TDDEClientConv e TDDEServConv esse evento ocorre quando a
conversao encerrada.
Para componentes do tipo TAnimate, esse evento ocorre quando o componente fechado.
Exemplo
O trecho de cdigo a seguir faz com que um dilogo de confirmao seja exibido quando o usurio
tenta fechar um formulrio chamado Form1 do tipo TForm.
procedure TForm1.FormClose(Sender: TObject; var Action: TCloseAction);
begin
if MessageDlg(Fechar o formulrio ?, mtConfirmation,[mbYes, mbNo], 0) = mrYes
then
Action: = caFree
else
Action: = caNone;
end;
TAnimate, TDDEClientConv, TDDEServConv e TForm
ONCLOSEQUERY
Descrio
Para componentes do tipo TForm, esse evento chamado quando se tenta fechar um formulrio, e tem
uma propriedade booleana chamada CanClose cujo valor define se o formulrio pode ou no ser fechado.
Exemplo
O trecho de cdigo a seguir faz com que um dilogo de confirmao seja exibido quando o usurio
tenta fechar um formulrio chamado Form1 do tipo TForm.
procedure TForm1.FormCloseQuery(Sender: TObject; var CanClose: Boolean);
begin
if MessageDlg(Fechar o formulrio?, mtConfirmation,[mbOk, mbCancel], 0) = mrCancel then
CanClose: = False;
end;
TForm
ONCOLENTER
Descrio
Esse evento ocorre quando o usurio seleciona uma clula de uma determinada coluna, ou move-se
para essa coluna com a tecla Tab.
Exemplo
O trecho de cdigo a seguir faz com que um componente Label1 do tipo TLabel exiba uma mensagem
quando o usurio se mover para uma determinada coluna.
procedure TForm1.DBGrid1ColEnter(Sender: TObject);
begin
Label1.Caption:= A coluna foi selecionada;
end;
TDBCtrlGrid e TDBGrid
ONCOLEXIT
Descrio
Esse evento ocorre quando o usurio seleciona uma clula de uma outra coluna, ou move-se para outra
coluna com a tecla Tab.
Exemplo
O trecho de cdigo a seguir faz com que um componente Label1 do tipo TLabel exiba uma mensagem
quando o usurio se mover para uma outra coluna:
procedure TForm1.DBGrid1ColExit(Sender: TObject);
begin
Label1.Caption:= Outra coluna foi selecionada;
end;
TDBCtrlGrid e TDBGrid
ONCOLLAPSE
Descrio
O evento OnCollapse ocorre quando um item em um componente do tipo TOutline oculta os seus subitens.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem quando ocorre um evento OnCollapse.
procedure TForm1.Outline1Collapse(Sender: TObject; Index: Longint);
begin
ShowMessage(Ocultando os subitens de um item em um componente TOutline);
end;
TOutline
ONCOLUMNCLICK
Descrio
Esse evento ocorre quando o usurio seleciona, com o boto esquerdo do mouse, o cabealho de uma
coluna do componente.
TListView
ONCOLUMNMOVED
Descrio
O evento OnColumnMoved ocorre quando o usurio movimenta uma coluna com o mouse.
Exemplo
O trecho de cdigo a seguir bloqueia movimentos posteriores de uma coluna.
procedure TForm1.StringGrid1ColumnMoved(Sender: TObject; FromIndex, ToIndex: Longint);
begin
StringGrid1.Options: = StringGrid1.Options [goColMoving];
end;
Observao: Para que o evento ocorra preciso que, inicialmente, a propriedade Options inclua a
subpropriedade goColMoving.
CAPTULO 43 EVENTOS
ONCOMMITTRANSCOMPLETE
Descrio
Esse evento ocorre aps o trmino de uma transao.
TADOConnection
ONCOMPARE
Descrio
Esse evento ocorre durante a reordenao dos itens do componente.
ONCONNECT
Descrio
Esse evento ocorre assim que se estabelece uma conexo ao servidor.
TNMDayTime, TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMNNTP, TNMPop3, TNMSTRM, TPowerSock
ONCONNECTCOMPLETE
Descrio
Esse evento ocorre quando se estabelece uma conexo a um banco de dados atravs do mecanismo
Activex Data Objects.
TADOConnection
ONCONNECTIONFAILED
Descrio
Esse evento ocorre assim que uma tentativa de conexo falha.
TNMDayTime, TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMNNTP, TNMPop3, TNMSTRM, TNMTimer,
TPowerSock
ONCONNECTIONREQUIRED
Descrio
Esse evento ocorre sempre que se executa um mtodo que requer uma conexo ao servidor.
TNMEcho, TNMPop3
ONCREATE
Descrio
O evento OnCreate especifica que manipuladores de eventos devem ser chamados quando o formulrio
criado. nesse evento que deve ser escrito o cdigo que inicializa propriedades e realiza qualquer
processamento antes que o usurio possa interagir com o formulrio.
Quando um formulrio est sendo criado e a sua propriedade Visible igual a True, ocorrem os seguintes
eventos, na ordem listada: OnActivate, OnShow, OnCreate e OnPaint.
Exemplo
O trecho de cdigo a seguir faz com que um formulrio chamado Form1 seja criado na cor Azul.
begin
Form1.Color: = clBlue;
end;
TForm e TIWForm
ONDATACHANGE
Descrio
O evento OnDataChange ocorre quando a propriedade State do componente deixa de ter o valor dsInactive,
ou recebe uma notificao de um componente de exibio de dados durante a execuo do aplicativo.
TDataSource
ONDBLCLICK
Descrio
O evento OnDblClick ocorre quando o usurio d um duplo clique com o boto do mouse sobre um
componente, isto , quando o usurio pressiona e solta duas vezes num curto intervalo de tempo o
boto primrio do mouse (geralmente o boto esquerdo).
Exemplo
O trecho de cdigo a seguir faz com que uma mensagem seja exibida quando o usurio der um duplo
clique sobre o formulrio de uma aplicao.
begin
MessageDlg(Voc deu um duplo-clique sobre o formulrio, mtInformation, [mbOk], 0);
end;
TComboBox, TDBComboBox, TDBEdit, TDBCtrlGrid, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo,
TDBLookupList, TDBMemo, TDBNavigator, TDBText, TDirectoryListBox, TDrawGrid, TDriveComboBox,
TEdit, TFileListBox, TFilterComboBox, TForm, TFrame, TGroupBox, TImage, TLabel, TListBox,
TMaskEdit, TMemo, TNotebook, TOLEContainer, TOutline, TPaintBox, TDecisionPivot,TPanel,
TRadioButton, TScrollBox, TSpeedButton, THTML e TStringGrid
ONDEACTIVATE
Descrio
Para componentes do tipo TApplication, o mtodo OnDeActivate ocorre quando a aplicao perde o
foco, isto , quando o Windows alterna para outra aplicao diferente da representada pelo componente.
Exemplo
O trecho de cdigo a seguir faz com que um formulrio chamado Form1 do tipo TForm de uma
aplicao seja minimizado quando o Windows seleciona outra aplicao como ativa.
procedure TForm1.AppDeactivate(Sender: TObject);
begin
Application.Minimize;
end;
CAPTULO 43 EVENTOS
Tapplication, TApplicationEvents
ONDEFAULTACTION
Descrio
Esse evento ocorre logo aps a execuo default do formulrio exibido, como uma pgina HTML
sendo executada.
TIWForm
ONDELETE
Descrio
Esse evento ocorre ao se remover um registro.
TIWDBNavigator
ONDELETION
Descrio
Esse evento ocorre durante a eliminao de um item do componente.
ONDESIGNERSAVE
Descrio
Se este evento for definido, um item de menu intitulado Save ser exibido no editor de relatrios,
permitindo que o mesmo seja salvo pelo usurio final aps realizar alteraes no mesmo.
TRvProject
ONDESIGNERSAVEAS
Descrio
Se este evento for definido, um item de menu intitulado Save As ser exibido no editor de relatrios,
permitindo que o mesmo seja salvo pelo usurio final em outro nome ou formato.
TRvProject
ONDESIGNERSHOW
Descrio
Esse evento ocorre imediatamente antes de o editor de relatrios ser aberto e exibido.
TRvProject
ONDESTROY
Descrio
O evento OnDestroy ocorre quando um formulrio est para ser destrudo, como resposta a um mtodo
como Destroy, Free ou Release.
Exemplo
O trecho de cdigo a seguir faz com que a memria alocada para um ponteiro seja liberada ao se fechar
um formulrio chamado Form1.
begin
Dispose(pointer);
end;
TForm e TIWForm
ONDIALECTDOWNGRADEWARNING
Descrio
O evento OnDialectDowngradeWarning ocorre quando se altera a verso do dialeto SQL usado por
uma aplicao cliente durante o acesso a um banco de dados atravs do mecanismo Interbase Express.
TIBDatabase
ONDISCONNECT
Descrio
Para objetos das classes TNMDayTime, TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMNNTP,
TNMPop3, TNMSTRM, TpowerSock, esse evento ocorre assim que se encerra uma conexo ao servidor.
Para objetos da classe TADOConnection este evento ocorre ao se encerrar uma conexo a um banco de
dados atravs do mecanismo Activex Data Objects.
TADOConnection, TNMDayTime, TNMEcho, TNMFinger, TNMFTP, TNMHTTP, TNMMSG, TNMNNTP, TNMPop3,
TNMSTRM, TPowerSock
ONDOCKDROP
Descrio
O evento OnDockDrop ocorre quando o usurio solta um componente que est sendo ancorado sobre
outro componente.
TPanel, TChart, TDBChart, TDecisionGraph, TForm, TFrame, TDBCtrlGrid, TdrawGrid, TDecisionGrid
e TStringGrid
ONDOCKOVER
Descrio
O evento OnDragOver ocorre quando o usurio arrasta um componente sobre outro numa operao
de drag-e-dock.
TPanel, TChart, TDBChart, TDecisionGraph, TForm, TFrame, TDBCtrlGrid, TdrawGrid, TDecisionGrid
e TStringGrid
CAPTULO 43 EVENTOS
ONDRAGDROP
Descrio
O evento OnDragDrop ocorre quando o usurio solta um componente que est sendo arrastado sobre
outro componente. Observe que esse evento corresponde ao objeto receptor (Sender) e no ao que est
sendo arrastado (Source).
Exemplo
Coloque em um formulrio chamado Form1 trs componentes do tipo TLabel chamados Label1, La-
bel2 e Label3, com propriedade Color igual a clYellow, clRed e clBlue respectivamente, e a propriedade
DragMode igual a dmAutomatic. Coloque um componente do tipo TListBox chamado ListBox1 e
defina seu evento OnDragDrop da seguinte forma:
procedure TForm1.ListBox1DragDrop(Sender, Source: TObject; X, Y: Integer);
begin
ListBox1.Color:= (Source as TLabel).Color;
end;
Quando voc arrastar e soltar os componentes TLabel sobre o ListBox, este assumir a cor do componente
que foi arrastado.
TBitBtn, TButton, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox, TDBCtrlGrid, TDBEdit,
TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo, TDBNavigator, TDBText,
TDBRadioGroup, TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox,
TFilterComboBox, TForm, TFrame, TGroupBox, TImage, TListBox, TMaskEdit, TMemo, TNotebook,
TOLEContainer, TOutline, TPaintBox, TDecisionPivot,TPanel, TRadioButton, TScrollBar,
TScrollBox, TShape, TStringGrid e TTabSet
ONDRAGOVER
Descrio
O evento OnDragOver ocorre quando o usurio arrasta um componente sobre outro numa operao
de drag-e-drop.
Exemplo
Se voc no quiser que um componente TListBox permita que um componente qualquer seja arrastado
sobre ele, basta incluir a seguinte linha de cdigo em seu evento
OnDragOver:
Accept:= False;
TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo, TDBNavigator, TDBText,
TDBRadioGroup, TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox,
TFilterComboBox, TForm, TFrame, TGroupBox, TImage, TListBox, TMaskEdit, TMemo, TNotebook,
TOLEContainer, TOutline, TPaintBox, TDecisionPivot,TPanel, TRadioButton, TScrollBar,
TScrollBox, TShape, TStringGrid e TTabSet
ONDRAWCELL
Descrio
O evento OnDrawItem ocorre quando uma clula do componente precisa ser redesenhada.
Exemplo
O trecho de cdigo a seguir desenha um retngulo de foco em torno de cada uma das clulas de um
componente StringGrid1 do tipo TStringGrid.
procedure TForm1.StringGrid1DrawCell(Sender: TObject; Col, Row: Longint;
Rect: TRect; State: TGridDrawState);
begin
StringGrid1.Canvas.DrawFocusRect(Rect);
end;
ONDRAWITEM
Descrio
O evento OnDrawItem ocorre quando um item de um componente owner-draw precisa ser redesenhado.
Exemplo
O trecho de cdigo abaixo define o evento OnDrawItem para um componente chamado ListBox1 do tipo
TListBox com propriedade Style igual a lbOwnerDrawFixed e desenha um bitmap esquerda de cada string.
procedure TForm1.ListBox1DrawItem(Control: TWinControl; Index: Integer; Rect: TRect;
State: TOwnerDrawState);
var
Bitmap: TBitmap;
Offset: Integer;
begin
with (Control as TListBox).Canvas do
begin
FillRect(Rect);
Offset: = 2;
Bitmap: = TBitmap(Items.Objects[Index]);
if Bitmap <> nil then
begin
BrushCopy(Bounds(Rect.Left + 2, Rect.Top, Bitmap.Width, Bitmap.Height), Bitmap,
Bounds(0, 0, Bitmap.Width, Bitmap.Height), clRed);
Offset: = Bitmap.width + 6;
end;
TextOut(Rect.Left + Offset, Rect.Top, Items[Index])
end;
end;
TComboBox, TDBComboBox, TDBListBox, TListBox e TOutline
ONDRAWTAB
Descrio
O evento OnDrawTab ocorre quando uma guia do controle precisa ser redesenhada, e o controle
possui a propriedade Style igual a tsOwnerDraw.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem quando ocorre o evento OnDrawTab.
procedure TForm1.TabSet1DrawTab(Sender: TObject; TabCanvas: TCanvas; R: TRect;
Index: Integer; Selected: Boolean);
begin
ShowMessage(A guia vai ser redesenhada);
end;
TTabSet
CAPTULO 43 EVENTOS
ONDROPDOWN
Descrio
O evento OnDropDown ocorre quando o usurio exibe o contedo de uma caixa de listagem ou
caixa combo.
Exemplo
O trecho de cdigo a seguir faz com que a caixa de listagem de um componente do tipo TComboBox
alterne sua cor entre vermelho e amarelo sempre que for exibida.
procedure TForm1.ComboBox1DropDown(Sender: TObject);
begin
if ComboBox1.Color = clRed then ComboBox1.Color: = clYellow else ComboBox1.Color: = clRed;
end;
TComboBox, TDBListBox, TDBComboBox, TDBLookupCombo e TListBox
ONEDIT
Descrio
Esse evento ocorre ao se iniciar a edio de um registro.
TIWDBNavigator
ONEDITERROR
Descrio
O evento OnEditError ocorre quando uma exceo gerada ao se tentar editar um registro.
TClientDataset, TTable, TQuery, TDecisionQuery
ONENDDOCK
Descrio
O evento OnEndDock ocorre quando o usurio termina de arrastar um componente sobre outro,
sendo ancorado em outro objeto. Esse evento corresponde ao componente que est sendo arrastado.
TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBMemo, TDBNavigator, TDBText, TDBRadioGroup,
TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TFrame,
TGroupBox, TImage, TListBox, TMaskEdit, TMemo, TNotebook, TOLEContainer, TOutline,
TDecisionPivot,TPanel, TRadioButton, TScrollBar, TScrollBox, TShape, TStringGrid e TTabSet
ONENDDRAG
Descrio
O evento OnEndDrag ocorre quando o usurio termina de arrastar um componente sobre outro. Esse
evento corresponde ao componente que est sendo arrastado.
Exemplo
Se voc quiser que um componente TLabel chamado Label1 se movimente 20 pixels para a direita ao
terminar de ser arrastado, basta incluir a seguinte linha de cdigo em seu evento OnEndDrag:
Label1.Left:= Label1.Left + 10;
ONENDOFRECORDSET
Descrio
Esse evento ocorre quando o cursor atinge o ltimo registro de um Recordset (conjunto de registros de
uma tabela ou resultantes de uma consulta SQL).
TIBStoredproc, TClientDataset, TTable, TStoredProc e TQuery, TDecisionQuery
ONENDPAGE
Descrio
Esse evento ocorre imediatamente antes do surgimento de uma quebra de pgina no relatrio.
TQuickReport
ONENTER
Descrio
O evento OnEnter ocorre quando um componente se torna ativo, isto , assim que ele recebe o
foco da aplicao.
Exemplo
Se voc incluir a linha de cdigo abaixo no evento OnEnter de um componente Edit1 do tipo TEdit,
ele exibir o texto Estou ativo sempre que receber o foco da aplicao:
Edit1.text:= Estou ativo;
TBitBtn, TButton, TChart, TDBChart,TCheckBox, TComboBox, TDBCheckBox, TDBComboBox,
TDBCtrlGrid, TDBEdit, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo,
TFileListBox, TFilterComboBox, TForm, TFrame, TGroupBox, TListBox, TMaskEdit, TMediaPlayer,
TMemo, TNotebook, TOLEContainer, TOutline, TRadioButton, TRadioGroup, TScrollBar, TScrollBox,
TStringGrid, TTabbedNotebook, TTabSet
ONENDRETRIEVAL
Descrio
Esse evento ocorre quando um documento HTML termina de ser carregado.
THTML
ONEVENTALERT
Descrio
Esse evento ocorre quando se verifica a ocorrncia de um evento do prprio banco de dados do Interbase,
acessado atravs do mecanismo Interbase Express, a ser tratado pela aplicao.
CAPTULO 43 EVENTOS
TIBEvents
ONEXCEPTION
Descrio
O evento OnException ativado quando ocorre uma exceo no manipulada pela aplicao.
TApplication, TApplicationEvents
ONEXECUTE
Descrio
O evento OnExecute ocorre quando o procedimento associado ao evento a ele vinculado executado.
TAction, TActionList
ONEXECUTECOMPLETE
Descrio
O evento OnExecuteComplete ocorre quando um comando executado na manipulao de registros
de um banco de dados acessado atravs do mecanismo Activex Data Objects.
TADOConnection
ONEXECUTEMACRO
Descrio
O evento OnExecuteMacro ocorre quando a aplicao-cliente envia uma macro para ser executada na
aplicao servidora em uma conversao DDE.
TDDEServerConv
ONEXIT
Descrio
O evento OnExit ocorre quando um componente perde o foco da aplicao.
Exemplo
Se voc incluir a linha de cdigo abaixo no evento OnExit de um componente Edit1 do tipo TEdit, ele
no exibir nenhum texto quando perder o foco da aplicao:
Edit1.text:= ;
TBitBtn, TButton, TChart, TDBChart, TCheckBox, TComboBox, TDBCheckBox, TDBComboBox,
TDBCtrlGrid, TDBEdit, TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBLookupList, TDBMemo,
TFileListBox, TFilterComboBox, TForm, TFrame, TGroupBox, TListBox, TMaskEdit, TMediaPlayer,
TMemo, TNotebook, TOLEContainer, TOutline, TRadioButton, TRadioGroup, TScrollBar, TScrollBox,
TStringGrid, TTabbedNotebook, TTabSet
ONEXPAND
Descrio
O evento OnExpand ocorre quando um item em um componente do tipo TOutline exibe os seus subitens.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem quando ocorre um evento OnExpand.
procedure TForm1.Outline1Expand(Sender: TObject; Index: Longint);
begin
ShowMessage(Exibindo os subitens de um item em um componente TOutline);
end;
TOutline
ONFETCHCOMPLETE
Descrio
Esse evento ocorre quando se carrega todos os registros de um Recordset (conjunto de registrios de
uma tabela ou resultantes de uma consulta SQL)
ONFETCHPROGRESS
Descrio
Esse evento ocorre enquanto se carrega todos os registros de um Recordset (conjunto de registrios de
uma tabela ou resultantes de uma consulta SQL)
ONFILTER
Descrio
Esse evento pode ser usado para fazer uma filtragem local de registros durante a preparao de um relatrio.
TQRDetailLink
ONFILTERRECORD
Descrio
O evento OnFilterRecord ocorre quando se altera o registro corrente de uma tabela na qual est
definido um filtro.
ONFIND
Descrio
O evento OnFind ocorre quando o usurio seleciona o boto Find Next (Localizar prxima) em uma
caixa de dilogo.
CAPTULO 43 EVENTOS
ONFIRST
Descrio
Esse evento ocorre ao se deslocar o cursor do componente que indica o registro corrente para o
primeiro registro.
TIWDBNavigator
ONGETEDITMASK
Descrio
O evento OnGetEditMask ocorre quando o texto de uma clula precisa ser exibido ou atualizado usando-
se uma mscara.
Exemplo
O trecho de cdigo a seguir faz com que as clulas de um componente StringGrid1 do tipo TStringGrid
exibam texto com uma mscara para nmeros de telefone:
procedure TForm1.StringGrid1GetEditMask(Sender: TObject; ACol,
ARow: Longint; var Value: OpenString);
begin
Value: = !$999$000-0000;1;
end;
ONGETEDITTEXT
Descrio
O evento OnGetEditText ocorre quando o texto de uma clula precisa ser exibido ou atualizado.
Exemplo
O trecho de cdigo a seguir faz com que as clulas de um componente StringGrid1 do tipo TStringGrid
exibam texto com indicao dos nmeros da linha e coluna em que se localiza.
procedure TForm1.StringGrid1GetEditMask(Sender: TObject; ACol,
ARow: Longint; var Value: OpenString);
begin
Value: = Linha +IntToStr(StringGrid1.Row)+ e Coluna +IntToStr(StringGrid1.Col);
end;
ONGETERRORRESPONSE
Descrio
Esse evento ocorre quando so detectados erros ao se aplicar atualizaes na aplicao servidora.
TXMLBroker
ONGETRESPONSE
Descrio
Esse evento ocorre quando no so detectados erros ao se aplicar atualizaes na aplicao servidora.
TXMLBroker
ONGETTEXT
Descrio
O evento OnGetText disparado quando se faz uma referncia s propriedades DisplayText e Text.
ONHELP
Descrio
O evento OnHelp ocorre quando a aplicao vai exibir uma mensagem ou tela de auxlio.
ONHIDE
Descrio
Esse evento ocorre imediatamente antes de um formulrio se tornar invisvel.
Exemplo
O trecho de cdigo a seguir emite uma mensagem informando que um formulrio vai se tornar invisvel.
procedure TForm1.FormHide(Sender: TObject);
begin
ShowMessage(O formulrio vai ficar invisvel);
end;
TForm
ONHINT
Descrio
O evento OnHint ocorre imediatamente antes de um controle exibir uma string de auxlio (definida
pela sua propriedade Hint). Para objetos da classe TAction, sobrepe o comportamento default dos
controles e itens de menu associados.
TAction, Tapplication, TApplicationEvents
ONHTMLTAG
Descrio
Esse evento ocorre quando necessrio substituir uma tag transparente por um valor durante a gerao
de uma pgina HTML a partir de um template de documento HTML.
TIWApplet, TIWButton, TIWCheckBox, TIWComboBox, TIWControl, TIWDBCheckBox, TIWDBCombobox,
TIWEdit, TIWDBFile, TIWDBGrid, TIWDBImage, TIWDBListbox, TIWDBLookupCombobox,
TIWDBLookupListbox, TIWDBMemo, TIWDBNavigator, TIWDBText, TIWEdit, TIWFile, TIWGrid, TIWImage,
TIWImageFile, TIWLabel, TIWLink, TIWList, TIWListbox, TIWMemo, TIWRectangle, TIWTimer,
TIWTreeview, TIWURL, TMidasPageProducer e TPageproducer
CAPTULO 43 EVENTOS
ONIDLE
Descrio
O evento OnIdle ocorre quando a sua aplicao est executando cdigo ou aguardando uma ao do
usurio.
ONIDLETIMER
Descrio
O evento OnIdleTimer ocorre quando se desconecta o acesso a um banco de dados atravs do mecanismo
Interbase Express quando o tempo ocioso de conexo ultrapassa o valor especificado na propriedade
IdleTimer do componente responsvel pelo acesso.
ONINFOMESSAGE
Descrio
O evento OnInfoMessage ocorre quando alguma mensagem do servidor de dados recebida atravs da
conexo a um banco de dados acessado atravs do mecanismo Activex Data Objects.
TADOConnection
ONINSERT
Descrio
Esse evento ocorre ao se inserir um novo registro.
TIWDBNavigator
ONKEYDOWN
Descrio
O evento OnKeyDown ocorre quando o usurio pressiona uma tecla enquanto o controle tem o foco
da aplicao.
Exemplo
Se voc incluir a linha de cdigo abaixo no evento OnKeyDown de um componente Edit1 do tipo
TEdit, ele exibir o texto Uma tecla foi pressionada aps o caractere digitado quando o usurio
pressionar qualquer tecla enquanto o componente possuir o foco da aplicao:
Edit1.text:= Uma tecla foi pressionada;
TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBMemo, TDirectoryListBox, TDrawGrid,
TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TForm, TListBox, TMaskEdit, TMemo,
TOLEContainer, TOutline, THTML, TRadioButton, TScrollBar e TStringGridDeclaration
ONKEYPRESS
Descrio
O evento OnKeyPress ocorre quando o usurio pressiona uma tecla que corresponda a um caractere
ASCII enquanto o controle tem o foco da aplicao.
Exemplo
Se voc incluir a linha de cdigo abaixo no evento OnKeyPress de um componente Edit1 do tipo TEdit,
ele exibir o texto Uma tecla ASCII foi pressionada aps o caractere digitado quando o usurio pressionar
qualquer tecla que corresponda a um caractere ASCII enquanto o componente possuir o foco da aplicao:
Edit1.text:= Uma tecla ASCII foi pressionada;
TDBGrid, TDBImage, TDBListBox, TDBLookupCombo, TDBMemo, TDirectoryListBox, TDrawGrid,
TDriveComboBox, TEdit, TFileListBox, TFilterComboBox, TForm, TListBox, TMaskEdit, TMemo,
TOLEContainer, THTML, TOutline, TRadioButton, TScrollBar e TStringGrid
ONKEYUP
Descrio
O evento OnKeyUp ocorre quando o usurio solta uma tecla enquanto o controle tem o foco da aplicao.
Exemplo
Se voc incluir a linha de cdigo abaixo no evento OnKeyUp de um componente Edit1 do tipo TEdit,
ele exibir o texto Uma tecla foi solta quando o usurio liberar uma tecla enquanto o componente
tiver o foco da aplicao:
Edit1.text:= Uma tecla foi solta;
TDBListBox, TDBLookupCombo, TDBMemo, TDirectoryListBox, TDrawGrid, TDriveComboBox, TEdit,
TFileListBox, TFilterComboBox, TForm, TListBox, TListView, TMaskEdit, TMemo, TOutline, THTML,
TRadioButton, TRichEdit, TScrollBar, TStringGrid, TTrackBar e TTreeView
ONLAST
Descrio
ltimo registro.
TIWDBNavigator
ONLOGIN
Descrio
O evento OnLogin ocorre quando se estabelece uma conexo a um banco de dados.
TDatabase, TADOConnection, TRDSConnection, TIBDatabase, TSQLConnection
ONLOWCAPACITY
Descrio
Esse evento ocorre quando a memria alocada para o cache do componente (definida pela sua
propriedade Capacity) no suficiente.
CAPTULO 43 EVENTOS
TDecisionCube
ONMEASUREITEM
Descrio
O evento OnMeasureItem ocorre quando a aplicao precisa redesenhar um item em um componente.
Para um componente do tipo TListBox, esse evento ocorre se ele possuir a propriedade Style igual a
lbOwnerDrawVariable, e para um componente do tipo TComboBox, esse evento ocorre se ele possuir
a propriedade Style igual a csOwnerDraw.
Esse evento passa trs parmetros que descrevem o item a ser medido:
O controle que contm o item.
O ndice do item no controle.
A altura do item (em pixels).
Exemplo
O trecho de cdigo a seguir define o evento OnMeasureItem para um componente do tipo TListBox com
propriedade Style igual a lbOwnerDrawn, cujos itens a serem exibidos so Bitmaps. Se a altura do Bitmap
a ser exibido for maior que a altura default, ele define a altura do item como sendo igual do Bitmap.
procedure TForm1.ListBox1MeasureItem(Control: TWinControl; Index: Integer;
var Height: Integer);
var
Bitmap: TBitmap;
begin
with Control as TListBox do
begin
Bitmap: = TBitmap(Items.Objects[Index]);
if Bitmap <> nil then
if Bitmap.Height > Height then Height: = Bitmap.Height;
end;
end;
TComboBox, TDBComboBox, TDBListBox e TListBox
ONMEASURETAB
Descrio
O evento OnMeasureTab ocorre imediatamente antes do evento OnDrawTab quando a aplicao precisa
redesenhar uma guia em um controle. Para um componente do tipo TTabSet, esse evento ocorre se ele
tiver a propriedade Style igual a tsOwnerDraw.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem quando ocorre o evento
OnMeasureTab.
procedure TForm1.TabSet1DrawTab(Sender: TObject; TabCanvas: TCanvas; R:
TRect;
Index: Integer; Selected: Boolean);
begin
ShowMessage(A guia vai ser redesenhada);
end;
TTabSet
ONMESSAGE
Descrio
O evento OnMessage ocorre quando a aplicao recebe uma mensagem do Windows.
ONMINIMIZE
Descrio
O evento OnMinimize ocorre quando a aplicao minimizada.
TApplicationEvents
ONMOUSEDOWN
Descrio
O evento OnMouseDown ocorre quando o usurio pressiona o boto do mouse sobre um controle.
Exemplo
Se voc quiser que um componente Label1 do tipo TLabel exiba as coordenadas do ponto em que o
usurio pressionou um boto do mouse sobre um formulrio chamado Form1, defina o evento
OnMouseDown de Form1 da seguinte forma:
begin
Label1.Caption:= Boto do Mouse pressionado em X = + IntToStr(X) + , Y = +
IntToStr(Y);
end;
TBitBtn, TButton, TChart, TDBChart, TCheckBox, TDBCheckBox, TDBEdit, TDBImage, TDBListBox,
TDBLookupCombo, TDBMemo, TDBNavigator, TDBText, TDirectoryListBox, TDrawGrid, TEdit,
TFileListBox, TForm, TIWImage, TIWImageFile
ONMOUSEMOVE
Descrio
O evento OnMouseMove ocorre quando o usurio movimenta o mouse sobre um controle.
Exemplo
mouse se encontra sobre um formulrio chamado Form1, defina o evento OnMouseMove de Form1
da seguinte forma:
procedure TForm1.FormMouseMove(Sender: TObject; Shift: TShiftState; X,
Y: Integer);
begin
Label1.Caption:= Mouse em X = + IntToStr(X) + , Y = + IntToStr(Y);
end;
TDBLookupCombo, TDBMemo, TDBNavigator, TDirectoryListBox, TDrawGrid, TEdit, TFileListBox,
TForm, TFrame, TGroupBox, THeaderControl, TImage, TLabel, TListBox, TListView, TMaskEdit,
TMemo, TNotebook, TOutline, TPageControl, TPaintBox, TDecisionPivot,TPanel, TProgressBar,
TRadioButton, TRichEdit, TTScrollBox, TShape, TSpeedButton, TStatusBar, TStringGrid, THTML,
TTabControl, TTabSet, TTreeView e TUpDown
CAPTULO 43 EVENTOS
ONMOUSEUP
Descrio
O evento OnMouseUp ocorre quando o usurio libera o boto do mouse sobre um controle.
Exemplo
usurio liberou um boto do mouse sobre um formulrio chamado Form1, defina o evento OnMouseUp
de Form1 da seguinte forma:
procedure TForm1.FormMouseUp(Sender: TObject; Button: TMouseButton;
begin
Label1.Caption:= Boto do Mouse liberado em X = + IntToStr(X) + , Y = + IntToStr(Y);
end;
TBitBtn, TButton, TChart, TDBChart., TCheckBox, TDBCheckBox, TDBEdit, TDBImage, TDBListBox,
TFileListBox, TForm, TFrame, TGroupBox, THTML, THeaderControl, TImage, TLabel, TListBox,
TListView, TMaskEdit, TMemo, TNotebook, TOutline, TPageControl, TPaintBox,
TDecisionPivot,TPanel, TRadioButton, TRichEdit, TScrollBox, TShape, TSpeedButton, TStatusBar,
TStringGrid, TTabControl, TTabSet, TTreeView e TUpDown
ONMOUSEWHEEL
Descrio
Este evento ocorre quando o usurio seleciona o boto de rolagem de pgina do mouse.
ONMOUSEWHEELDOWN
Descrio
Este evento ocorre quando o usurio seleciona o boto de rolagem de pgina do mouse de forma a
rolar a pgina para baixo.
ONMOUSEWHEELUP
Descrio
Este evento ocorre quando o usurio seleciona o boto de rolagem de pgina do mouse de forma a
rolar a pgina para cima.
ONMOVECOMPLETE
Descrio
Esse evento ocorre quando se altera o registro corrente de um Recordset (conjunto de registros de uma
tabela ou resultantes de uma consulta SQL).
ONNEEDDATA
Descrio
Para componentes do tipo TQRDetailLink, esse evento pode ser usado para obter dados a serem impressos
a partir de outra fonte que no seja um componente do tipo TDataSource.
Para componentes do tipo TQRGroup, esse evento pode ser usado para definir a quebra de grupos de
componentes.
TQRDetailLink e TQRGroup
ONNEWDIMENSIONS
Descrio
Esse evento ocorre quando se alteram os dados acessados pelo componente DecisionCube associado.
TDecisionSource
ONNEWPAGE
Descrio
Esse evento ocorre sempre que uma nova pgina gerada para o relatrio representado pelo componente.
TBaseReport, TRvNDRWriter,TRvRenderPreview e TRvRenderPrinter.
ONNEWRECORD
Descrio
Esse evento ocorre quando um registro adicionado ao banco de dados.
TClientDataset, TTable, TStoredProc e TQuery, TDecisionQuery
ONNEXT
Descrio
prximo registro.
CAPTULO 43 EVENTOS
TIWDBNavigator
ONNOTIFY
Descrio
O evento OnNotify ocorre durante a finalizao de um mtodo em um controle do tipo TMediaPlayer,
fazendo com que sua propriedade Notify seja igual a True.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem quando o evento OnNotify executado.
procedure TForm1.MediaPlayer1Notify(Sender: TObject);
begin
ShowMessage(Ocorreu o evento OnNotify);
end;
TMediaPlayer
ONOPEN
Descrio
Para componentes dos tipos TDDEClientConv e TDDEServerConv, esse evento ocorre quando uma
conversao DDE iniciada.
Para componentes do tipo TAnimate, esse evento ocorre quando o componente aberto.
TAnimate, TDDEClientConv e TDDEServerConv
ONPAINT
Descrio
O evento OnPaint ocorre quando um componente do tipo TForm ou TPaintBox precisa redesenhar o
seu contedo.
Exemplo
O trecho de cdigo a seguir faz com que um formulrio se torne amarelo ao ser restaurado aps ser
minimizado ou ter sido tornado invisvel.
procedure TForm1.FormPaint(Sender: TObject);
begin
Form1.Color: = clYellow;
end;
TForm e TPaintBox
ONPASSWORD
Descrio
O evento OnPassword ocorre quando uma tabela do Paradox aberta e o Borland Database Engine
verifica a necessidade de se fornecer uma senha (Password).
TSession
ONPOPUP
Descrio
O evento OnPopup ocorre quando um menu flutuante exibido.
TPopup
ONPOKEDATA
Descrio
O evento OnPokeData ocorre quando a aplicao cliente transfere dados para a aplicao servidora em
uma conversao DDE.
TDDEServerItem
ONPOST
Descrio
Esse evento ocorre ao se gravar um registro.
TIWDBNavigator
ONPOSTCLICK
Descrio
O evento OnPostClick ocorre aps a execuo do cdigo do evento OnClick.
Exemplo
O trecho de cdigo a seguir exibe uma mensagem quando o evento OnPostClick executado.
procedure TForm1.MediaPlayer1PostClick(Sender: Tobject; Button: TMPBtnType);
begin
ShowMessage(Evento OnPostClick);
end;
TMediaPlayer
ONPOSTERROR
Descrio
O evento OnPostError ocorre quando uma exceo gerada ao se tentar gravar ou alterar um registro.
ONPREVIEW
Descrio
Esse evento ocorre durante a pr-visualizao de um relatrio.
TQRPrinter
CAPTULO 43 EVENTOS
ONPRINT
Descrio
Para componentes dos tipos TQRLabel, TQRDBCalc e TQRDBText esse evento ocorre imediatamente
antes da impresso do relatrio representado pelo componente.
Para componentes dos tipos TBaseReport, TRvNDRWriter,TRvRenderPreview e TRvRenderPrinter esse
evento ocorre imediatamente antes da impresso do corpo do relatrio representado pelo componente.
TQRLabel, TQRDBCalc, TQRDBText, TBaseReport, TRvNDRWriter,TRvRenderPreview e TRvRenderPrinter
ONPRINTFOOTER
Descrio
Esse evento ocorre imediatamente aps a impresso do corpo do relatrio representado pelo
componente, e imediatamente antes da impresso do seu rodap.
ONPRINTHEADER
Descrio
Esse evento ocorre imediatamente aps a impresso do cabealho e imediatamente antes da impresso
do corpo do relatrio representado pelo componente.
TBaseReport, TRvNDRWriter,TRvRenderPreview e TRvRenderPrinter.
ONPRIOR
Descrio
registro anterior.
TIWDBNavigator
ONRECEIVEDFILE
Descrio
Esse evento ocorre quando o componente recebe os dados provenientes de um arquivo,
TIWDBFile e TIWFile
ONRECORDCHANGECOMPLETE
Descrio
Esse evento ocorre quando se alteram os valores armazenados em alguns registros de um Recordset
(conjunto de registros de uma tabela ou resultantes de uma consulta SQL).
ONRECORDSETCHANGECOMPLETE
Descrio
Esse evento ocorre quando se alteram os valores armazenados em todos os registros de um Recordset
(conjunto de registrios de uma tabela ou resultantes de uma consulta SQL).
ONREFRESH
Descrio
Esse evento ocorre ao se alterar a propriedade DimensionMap do componente TDecisioncube ou, no
caso do componente TIWDBNavigator, ao se atualizar a exibio dos registros.
TDecisionCube e TIWDBNavigator
ONRENDER
Descrio
Esse evento ocorre cada vez que o formulrio for exibido como uma pgina HTML.
TIWForm.
ONRENDERCELL
Descrio
Esse evento ocorre cada vez que uma clula do componente for exibida em uma pgina HTML.
TIWDBGrid e TIWGrid.
ONREPLACE
Descrio
O evento OnReplace ocorre quando o usurio seleciona o boto Replace (Substituir) ou Replace All
(Substituir Todas) em uma caixa de dilogo.
TReplaceDialog
ONRESIZE
Descrio
O evento OnResize ocorre quando o componente redimensionado durante a execuo do aplicativo.
Exemplo
Se voc quiser que um componente Label1 do tipo TLabel alterne sua cor entre vermelho e amarelo
quando um formulrio chamado Form1 redimensionado, inclua o seguinte trecho de cdigo:
procedure TForm1.FormResize(Sender: TObject);
begin
if Label1.Color = clRed then Label1.Color: = clYellow else Label1.Color: = clRed;
end;
CAPTULO 43 EVENTOS
TChart, TDBChart, TDBNavigator, TForm, TFrameTDecisionPivot,TPanel e TScrollBox
ONRESTORE
Descrio
O evento OnRestore ocorre quando uma aplicao minimizada restaura sua configurao default de janelas.
TApplicationEvents
ONROLLBACKTRANSCOMPLETE
Descrio
Esse evento ocorre aps o cancelamento de uma transao.
TADOConnection
ONROWMOVED
Descrio
O evento OnRowMoved ocorre quando o usurio movimenta uma linha com o mouse.
Exemplo
O trecho de cdigo a seguir bloqueia movimentos posteriores de uma linha.
procedure TForm1.StringGrid1RowMoved(Sender: TObject; FromIndex, ToIndex: Longint);
begin
StringGrid1.Options: = StringGrid1.Options [goRowMoving];
end;
Observao: Para que o evento ocorra preciso que, inicialmente, a propriedade Options inclua a
subpropriedade goRowMoving.
ONSCROLL
Descrio
Esse evento ocorre quando o usurio usa uma barra de rolagem, ou quando rola o grfico exibido em
um componente.
Exemplo
O trecho de cdigo a seguir alterna a cor de um formulrio entre branco e preto, quando o usurio usa
uma barra de rolagem:
procedure TForm1.ScrollBar1Scroll(Sender: TObject; ScrollCode: TScrollCode;
var ScrollPos: Integer);
begin
if Form1.Color = clBlack then Form1.Color: = clWhite else Form1.Color: = clBlack;
end;
TChart, TDBChart e TScrollBar
ONSECTIONCLICK
Descrio
Esse evento ocorre quando uma seo do componente selecionada com o boto esquerdo do mouse.
THeaderControl
ONSECTIONRESIZE
Descrio
Esse evento ocorre quando uma seo do componente redimensionada.
THeaderControl
ONSECTIONTRACK
Descrio
Esse evento ocorre quando uma seo do controle deslocada, arrastando-se uma de suas divisrias. O
procedimento associado a esse evento possui um parmetro chamado State que indica o estado atual
de arraste do componente, como indica a tabela a seguir.
Tabela de valores Para o Parmetro State.
ValorSignificado
tsTrackBegin Indica o incio do arraste.
tsTrackMove Indica que a divisria continua sendo arrastada.
tsTrackEnd Sinaliza o trmino do arraste.
THeaderControl
ONSELECTCELL
Descrio
O evento OnSelectCell ocorre quando o usurio seleciona uma clula do componente com o mouse.
Exemplo
O trecho de cdigo a seguir faz com que uma clula selecionada em um componente StringGrid1 do
tipo TStringGrid exiba os nmeros de sua linha e coluna:
procedure TForm1.StringGrid1SelectCell(Sender: TObject; Col, Row: Longint;
var CanSelect: Boolean);
begin
Value: = Linha +IntToStr(StringGrid1.Row)+ e Coluna +IntToStr(StringGrid1.Col);
end;
ONSETEDITTEXT
Descrio
O evento OnSetEditText ocorre quando o usurio edita o texto em uma clula do componente.
Exemplo
O trecho de cdigo a seguir faz com que a cor das clulas em um componente StringGrid1 do tipo
TStringGrid alterne entre vermelho e amarelo quando o usurio edita uma clula.
CAPTULO 43 EVENTOS
procedure TForm1.StringGrid1SetEditText(Sender: TObject; ACol,
ARow: Longint; const Value: String);
begin
if StringGrid1.Color = clYellow then StringGrid1.Color: = clRed
else StringGrid1.Color: = clYellow;
end;
ONSETTEXT
Descrio
O evento OnSetText disparado quando se atribui um valor propriedade Text de um campo.
ONSHORTCUT
Descrio
O evento OnShortcut ocorre quando o usurio da aplicao pressiona uma tecla (este evento ocorre
antes do evento OnKeyDown).
TApplicationEvents
ONSHOW
Descrio
Para componentes do tipo TForm, esse evento ocorre imediatamente antes de o formulrio se tornar
visvel.
Para componentes do tipo TQRPreview, esse evento ocorre imediatamente antes da pr-visualizao
do relatrio.
Exemplo
O trecho de cdigo a seguir emite uma mensagem informando que um formulrio vai se tornar visvel.
procedure TForm1.FormShow(Sender: TObject);
begin
ShowMessage(O formulrio vai ficar visvel);
end;
TForm e TQRPreview
ONSHOWHINT
Descrio
O evento OnShowHint ocorre quando a aplicao vai exibir uma string de auxlio.
TApplicationEvents
ONSIZED
Descrio
Esse evento ocorre sempre que um componente do tipo THeader terminar de ser redimensionado.
Exemplo
O trecho de cdigo a seguir emite uma mensagem informando que uma seo de um componente
Header1 do tipo THeader foi redimensionada.
procedure TForm1.Header1Sized(Sender: TObject; ASection, AWidth: Integer);
begin
ShowMessage(O componente foi redimensionado);
end;
Theader
ONSIZING
Descrio
Esse evento ocorre enquanto uma seo de um componente do tipo THeader est sendo redimensionada.
Exemplo
O trecho de cdigo a seguir faz com que a cor de um componente Edit1 do tipo TEdit alterne entre vermelho
e azul enquanto uma seo de um componente Header1 do tipo THeader est sendo redimensionada.
procedure TForm1.Header1Sizing(Sender: TObject; ASection, AWidth: Integer);
begin
if Edit1.Color = clBlue then Edit1.Color: = clRed else Edit1.Color: = clBlue;;
end;
THeader
ONSQL
Descrio
Esse evento ocorre quando se verifica a execuo de comandos SQL em uma aplicao que acessa um
banco de dados do Interbase atravs do mecanismo Interbase Express.
TIBSQLMonitor
ONSTART
Descrio
Esse evento ocorre quando se inicia a exibio do clip de vdeo associado ao componente.
TAnimate
ONSTARTPAGE
Descrio
Esse evento ocorre imediatamente antes da criao de uma nova pgina no relatrio.
TQuickReport
CAPTULO 43 EVENTOS
ONSTATECHANGE
Descrio
Para componentes TDataSource, o evento OnStateChange ocorre quando o valor da sua propriedade
State alterado durante a execuo do aplicativo.
Para componentes TDecisionSource, o evento OnStateChange ocorre quando se altera o valor da sua
propriedade DecisionCube.
TDecisionSource e TDataSource
ONSTATUSLINEEVENT
Descrio
O evento OnStatusLine ocorre quando a aplicao OLE servidora tem uma mensagem para ser exibida
na linha de Status de uma aplicao OLE receptora (com um componente do tipo TOLEContainer ativo).
Exemplo
O trecho de cdigo a seguir exibe uma mensagem de um servidor OLE em uma barra de Status
representada por um componente Panel1 do tipo TPanel.
procedure TForm1.OleContainer1StatusLineEvent(Sender: TObject; Msg: string);
begin
Panel1.Caption: = Msg;
end;
TOLEContainer
ONSTOP
Descrio
Esse evento ocorre quando se finaliza a exibio do clip de vdeo associado ao componente.
TAnimate
ONSUBMIT
Descrio
Esse evento ocorre quando o componente e os dados sero enviados a partir da pgina HTML na qual
est inserido o componente.
TIWDBEdit, TIWDBFile, TIWEdit e TIWFile
ONSUMMARYCHANGE
Descrio
Esse evento ocorre quando se altera o valor da sua propriedade CurrentSum.
TDecisionSource
ONTIMER
Descrio
Esse evento usado para executar um cdigo a intervalos regulares (esse intervalo definido na
propriedade Interval do componente).
TTimer
ONTOPLEFTCHANGED
Descrio
O evento OnTopLeftChanged ocorre quando uma das propriedades LeftCol ou TopRow tem o seu
valor alterado.
Exemplo
O trecho de cdigo a seguir exibe os novos valores das propriedades LeftCol e TopRow quando seus
valores se alteram.
procedure TForm1.StringGrid1TopLeftChanged(Sender: TObject);
begin
with StringGrid1 do
MessageDlg(TopRow = +IntToStr(TopRow)+
e LeftCol = +IntToStr(LeftCol), mtInformation, [mbOK],0);
end;
ONUNDOCK
Descrio
O evento OnUnDock ocorre quando o usurio comea a arrastar um componente que est ancorado
em outro objeto. Esse evento corresponde ao componente que est sendo arrastado.
ONUNDOZOOM
Descrio
Esse evento ocorre quando o usurio desfaz a aplicao de um zoom ao grfico exibido no componente.
TChart, TDBChart
ONUPDATE
Descrio
O evento OnUpdate ocorre quando a lista de aes de um componente ActionList atualizada.
TAction, TActionList
CAPTULO 43 EVENTOS
ONUPDATEDATA
Descrio
O evento OnUpdateData ocorre quando o mtodo Post ou UpdateRecord de um componente que
representa um banco de dados executado durante a execuo do aplicativo.
TDataSource
ONUPDATEERROR
Descrio
O evento OnUpdateError ocorre quando alguma exceo gerada ao se utilizar o recurso de cached
updates em um banco de dados acessado atravs do mecanismo Interbase Express.
TIBStoredProc, TIBDataset, TIBTable, TIBQuery
ONUPDATERECORD
Descrio
O evento OnUpdateRecord ocorre quando alguma exceo gerada ao se utilizar o recurso de cached
updates em um registro de banco de dados acessado atravs do mecanismo Interbase Express.
TIBStoredProc, TIBDataset, TIBTable, TIBQuery
ONVALIDATE
Descrio
O evento OnValidate disparado quando o valor de um campo modificado. Quando se faz uma
alterao num controle que exibe o valor do campo, esse evento s ocorre quando o valor do campo (e
no do que exibido) atualizado.
ONWILLCHANGERECORD
Descrio
Esse evento ocorre quando se inicia a alterao dos valores armazenados em um registro de um Recordset
(conjunto de registros de uma tabela ou resultantes de uma consulta SQL).
ONWILLCHANGERECORDSET
Descrio
Esse evento ocorre quando se inicia a alterao dos valores armazenados em todos os registros de um
Recordset (conjunto de registros de uma tabela ou resultantes de uma consulta SQL).
ONWILLCONNECT
Descrio
Esse evento ocorre quando se recebe um pedido para se iniciar uma conexo.
TADOConnection
ONWILLEXECUTE
Descrio
Esse evento ocorre quando o servidor de banco de dados informa a aceitao de um comando.
TADOConnection
ONZOOM
Descrio
Esse evento ocorre quando o usurio aplica um zoom ao grfico exibido no componente.
TChart, TDBChart
ONWILLMOVE
Descrio
Esse evento ocorre imediatamente antes de se alterar o registro corrente de um Recordset (conjunto de
registros de uma tabela ou resultantes de uma consulta SQL).
NDICE REMISSIVO
NDICE REMISSIVO
A
Abort, Mtodo, 1230
Aborted, Propriedade, 978
AbortOnKeyViol,
Propriedade, 978
AbortOnProblem,
Propriedade, 978
AccuracyMethod, 979
Acesso a Bancos de Dados,
Mecanismos de, 126, 394
Aes, editor de, 773
ActionCount, Propriedade, 979
ActionList, Propriedade, 979
Actions, Propriedade, 979
Activate, Mtodo, 1230
Active, Propriedade, 980
ActiveControl, Propriedade, 980
ActiveForm, Propriedade, 981
ActiveMDIChild,
Propriedade, 981
ActivePage, Propriedade, 982
Add, Mtodo, 1230
AddChild, Mtodo, 1231
AddChildObject, Mtodo, 1231
AddDatabase, Mtodo, 1231
AddDataset, Mtodo, 1231
AddIcon, Mtodo, 1232
AddIndex, Mtodo, 1232
AddMasked, Mtodo, 1232
AddObject, Mtodo, 1232
AddPassword, Mtodo, 1232
AddScriptFile, Mtodo, 1233
AddSeries, Mtodo, 1233
AddStrings, Mtodo, 1233
AddTo Repository, caixa de
dilogo, 212
AddTransaction, Mtodo, 1233
AddXY, Mtodo, 1234
AddY, Mtodo, 1234
AdjustLineBreaks, funo, 663
AfterCancel, Evento, 1340
AfterClose, Evento, 1340
AfterConnect, Evento, 1340
AfterConstruction, Mtodo, 288
AfterDelete, Evento, 1340
AfterDetail, Evento, 1340
AfterDisConnect, Evento, 1340
AfterDispatch, Evento, 1340
AfterDrawValues, Evento, 1341
AfterEdit, Evento, 1341
AfterInsert, Evento, 1341
AfterOpen, Evento, 1341
AfterPost, Evento, 1341
AfterPrint, Evento, 1341
AfterScroll, Evento, 1342
Alias, criao de, 134
AliasName, Propriedade, 982
Align, Propriedade, 982
AlignButton, Propriedade, 984
Alignment, Propriedade, 984
AlignToBand, Propriedade, 985
Allocation, Propriedade, 986
AllocBy, Propriedade, 986
AllowAllUp, Propriedade, 986
AllowDelete, Propriedade, 987
AllowGrayed, Propriedade, 987
AllowInPlace, Propriedade, 987
AllowInsert, Propriedade, 988
AllowPaning, Propriedade, 988
AllowResize, Propriedade, 989
AllowSinglePoint,
Propriedade, 989
AllowZoom, Propriedade, 989
Ambiente de Desenvolvimento
Integrado, 10
barra de menus do, 11
barra de ttulos do, 11
caixa de ferramentas, 11
janela principal do, 11
janelas do, 11
paleta de componentes, 11
Ancoragem de janelas,
recurso de, 36
AnsiCompareStr, funo, 663
AnsiCompareText, funo, 664
AnsiExtractQuotedStr,
funo, 664
AnsiLowerCase, funo, 664
AnsiPos, funo, 664
AnsiQuotedStr, funo, 664
AnsiStrComp, funo, 671
AnsiStrIComp, funo, 671
AnsiStrLComp, funo, 671
AnsiStrLower, funo, 671
AnsiStrPos, funo, 672
AnsiStrRScan, funo, 672
AnsiStrScan, funo, 672
AnsiStrUpper, funo, 672
AnsiUpperCase, funo, 664
Aplicaes CGI, criao de, 770
Aplicaes MDI, 745
Aplicaes Multicamadas, 728
Aplicaes Websnap, 791
Aplicaes,
internacionalizao de, 758
Aplicaes, planejamento de, 74
Append, funo, 658
Append, Mtodo, 1234
AppendRecord, Mtodo, 1234
ApplyRange, Mtodo, 1234
ApplyUpdates, Mtodo, 1235
Arc, Mtodo, 1235
ArcCos, funo, 822
ArcCosH, funo, 822
ArcSin, funo, 822
ArcSinH, funo, 822
ArcTan2, funo, 822
ArcTanH, funo, 822
Aritmticos, operadores, 51
Arquivos, manipulao de, 658
ArrangeIcons, Mtodo, 1235
ArrowKeys, Propriedade, 989
As, operador, 295
AsBoolean, Propriedade, 990
AsDateTime, Propriedade, 990
AsFloat, Propriedade, 990
AsInteger, Propriedade, 991
Assign, Mtodo, 1235
AssignFile, procedimento, 659
AssignValue, Mtodo, 1236
Associate, Propriedade, 991
AsString, Propriedade, 991
AsText, Propriedade, 992
AtLeast, Mtodo, 1236
AutoActivate, Propriedade, 992
AutoCalcFields, Propriedade, 993
AutoDisplay, Propriedade, 993
AutoEdit, Propriedade, 994
AutoEnable, Propriedade, 994
AutoMerge, Propriedade, 994
AutoOpen, Propriedade, 995
AutoPopup, Propriedade, 995
AutoRewind, Propriedade, 995
AutoScroll, Propriedade, 996
AutoSelect, Propriedade, 996
AutoSize, Propriedade, 996
AxisVisible, Propriedade, 997
B
Back, Mtodo, 1237
BackColor, Propriedade, 997
BackgroundColor,
Propriedade, 997
BackImage, Propriedade, 998
Bancos de Dados,
Cliente-Servidor, 572
conceitos e definio, 127
mecanismos de acesso a,
126, 394
metadados de, 589
Band Style Editor, caixa de
dilogo, 240
BatchMove, Mtodo, 1237
BeforeCancel, Evento, 1342
BeforeClose, Evento, 1342
BeforeConnect, Evento, 1342
BeforeConstruction,
Mtodo, 288
BeforeDelete, Evento, 1342
BeforeDetail, Evento, 1343
BeforeDisconnect, Evento, 1343
BeforeDispatch, Evento, 1343
BeforeDrawValues, Evento,
1343
BeforeEdit, Evento, 1343
BeforeInsert, Evento, 1343
BeforeOpen, Evento, 1343
BeforePost, Evento, 1344
BeforePrintt, Evento, 1344
BeforeRefresh, Evento, 1344
BeforeScroll, Evento, 1344
BeginDoc, Mtodo, 1237
BeginDrag, Mtodo, 1237
BeginTrans, Mtodo, 1238
BeginUpdate, Mtodo, 1238
BevelInner, Propriedade, 998
BevelOuter, Propriedade, 999
BevelWidth, Propriedade, 999
Bitmap, Propriedade, 1000
BkColor, Propriedade, 1000
BlendColor, Propriedade, 1000
BlobSize, Propriedade, 1000
Blocos de Comandos, 46, 54, 55
BOF, Propriedade, 1001
BookMarkValid, Mtodo, 1238
BorderIcons, Propriedade, 1001
BorderStyle, Propriedade, 1001
BorderWidth, Propriedade,
1002
Boto de comando,
componente, 122
BottomAxis, Propriedade, 1003
BoundsRect, Propriedade,
1003
Break, Propriedade, 1004
BringToFront, Mtodo, 1239
BroadCast, Mtodo, 1239
Brush, Propriedade, 1004
BrushCopy, Mtodo, 1239
ButtonAutoSize, Propriedade,
1005
ButtonHeight, Propriedade,
1005
ButtonSpacing, Propriedade,
1005
ButtonWidth, Propriedade,
1005
BytesRcvd, Propriedade, 1006
BytesSent, Propriedade, 1006
BytesTotal, Propriedade, 1006
C
CachedSize, Propriedade, 1006
CachedUpdates, Propriedade,
1006
CachedUpdates, uso de, 495
Caixas de dilogo, criao, 118
Caixas de dilogo, definio,
118
Caixas de dilogo, exibio,
120
Caixas de dilogo, modal, 120
Caixas de dilogo, no-
modal, 120
Calculated, Propriedade, 1007
Call, Mtodo, 1239
Campos calculados, definio
de, 196, 445
Campos Lookup, definio
de, 449
CanAutoSize, Mtodo, 1240
Cancel, Mtodo, 1240
Cancel, Propriedade, 1007
CancelDispatch, Mtodo, 1240
Canceled, Propriedade, 1007
CancelEvents, Mtodo, 1240
CancelRange, Mtodo, 1240
CancelUpdates, Mtodo, 1241
CanFocus, Mtodo, 1241
CanModify, Propriedade, 1008
Canvas, Propriedade, 1008
Capabilities, Propriedade, 1009
Capacity, Propriedade, 1009
Caption, Propriedade, 1010
CaptionColor, Propriedade,
1010
CaptionFont, Propriedade, 1010
Cascade, Mtodo, 1241
Category, Propriedade, 1011
Ceil, funo, 822
CellRect, Mtodo, 1241
Cells, Propriedade, 1011
Center, Propriedade, 1011
Change, Mtodo, 1242
ChangedCount, Propriedade,
1012
ChangedTableName,
Propriedade, 1012
ChangeLevelBy, Mtodo, 1242
CharCase, Propriedade, 1012
Chave Primria, 438
CheckActive, Mtodo, 1242
CheckBrowseMode, Mtodo,
1242
CheckClosed, Mtodo, 1242
CheckDatabaseInList,
Mtodo, 1243
CheckDatabasename,
Mtodo, 1243
Checked, Propriedade, 1013
CheckInactive, Mtodo, 1243
CheckInTransaction,
Mtodo, 1243
CheckNotInTransaction,
Mtodo, 1243
CheckOpen, Mtodo, 1244
CheckValidStatement,
Mtodo, 1244
Classes,
EAbort, 830
EAbstractError, 830
EAccessViolation, 830
EArrayError, 831
EAssertionFailed, 831
EBitsError, 831
EBrokerException, 832
ECacheError, 832
EClassNotFound, 832
ECommonCalendarError,
833
EComponentError, 833
EControlC, 833
EConvertError, 834
EDatabaseError, 835
EdateTimeError, 836
EDBClient, 834
EDBEditError, 834
EDBEngineError, 835
EdimensionMapError, 836
EDimIndexError, 836
EdivByZero, 837
EDSWriter, 835
EExternal, 837
EExternalException, 837
EFCreateError, 837
EFilerError, 838
EFOpenError, 838
EHeapException, 838
EInOutError, 839
EIntError, 840
EIntfCastError, 840
EIntOverFlow, 840
EInvalidArgument, 841
EInvalidCast, 841
EInvalidGraphic, 841
EInvalidGraphicOperation,
842
EInvalidGridOperation,
842
EInvalidImage, 842
EInvalidOp, 843
EInvalidOperation, 843
EInvalidPointer, 843
EListError, 844
ElowCapacityError, 844
EMathError, 844
EMCIDeviceError, 845
EMenuError, 845
EMonthCalError, 845
EndResultSet, 846
EOLECtrlError, 846
EOLEError, 846
EOLEException, 847
EOLESysError, 847
EOSError, 847
EOutlineError, 848
EOutOfMemory, 848
EOutOfResources, 848
EOverflow, 849
EPackageError, 849
EParseError, 849
EPrinter, 850
EPrivilege, 850
EPropertyError, 850
EPropReadOnly, 851
EPropWriteOnly, 851
EreadError, 852
EReconcileError, 852
ERegistryException, 852
EResNotFound, 853
ESocketConnectionError,
853
ESocketError, 853
EStackoverflow, 854
EStreamError, 854
EStringListError, 854
EThread, 855
ETreeViewError, 855
EUnderflow, 855
EUpdateError, 856
EVariantError, 856
EWin32Error, 857
EWriteError, 857
Exception, 298
EZeroDivide, 857
TAction, 858
TActionList, 858
TADOCommand, 525, 859
TADOConnection, 512, 859
TADODataSet, 527, 860
TADOQuery, 530, 860
TADOStoredProc, 861
TADOTable, 529, 862
TAnimate, 863
TApplication, 863
TApplicationEvents, 863
TAutoIncField, 864
TBaseReport, 864
TBatchMove, 865
TBCDField, 865
TBDEDataset, 416
TBevel, 866
TBitBtn, 866
TBitmap, 626, 866
TBlobField, 867
TBlobStream, 867
TBooleanField, 868
TBrush, 868
TButton, 868
TBytesField, 869
TCanvas, 335
TChart, 870
TChartSeries, 871
TCheckBox, 871
TClientDataSet, 872
TClientSocket, 873
TClipboard, 873
TColorDialog, 873
TComboBox, 874
TComponent, 874
TControlScrollBar, 875
TCorbaConnection, 875
TCorbaDatamodule, 729
TCurrencyField, 875
TCustomADODataSet,
518, 876
TCustomConnection, 411
TCustomSQLDataset, 544
TDataBase, 419, 876
TDataSet, 395
TDataSetPageProducer,
877
TDataSetProvider, 877
TDataSetTableProducer,
877
TDataSource, 878
TDateField, 878
TDateTimeField, 878
TDBChart, 879
TDBCheckBox, 879
TDBComboBox, 880
TDBCtrlGrid, 880
TDBDataset, 418
TDBEdit, 881
TDBGrid, 881
TDBImage, 882
TDBListBox, 882
TDBLookupComboBox,
883
TDBLookupListBox, 883
TDBMemo, 884
TDBMemoBuf, 884
TDBNavigator, 885
TDBRadioGroup, 885
TDBRichEdit, 886
TDBText, 886
TDCOMConnection, 887
TDDEClientConv, 887
TDDEClientItem, 887
TDDEServerConv, 888
TDDEServerItem, 888
TDecisionCube, 888
TDecisionGraph, 888
TDecisionGrid, 889
TDecisionPivot, 890
TDecisionQuery, 890
TDecisionSource, 890
TDirectoryListBox, 891
TDrawGrid, 891
TDriveComboBox, 892
TEdit, 892
TField, 893
TFieldDef, 893
TFileListBox, 893
TFilterComboBox, 894
TFindDialog, 894
TFloatField, 895
TFont, 895
TFontDialog, 895
TForm, 68, 896
TGraphic, 896
TGraphicsField, 897
TGroupBox, 897
THeader, 897
THeaderControl, 898
THotKey, 898
THTTPFile, 907
TIBClientDataSet, 899
TIBCustomDataSet, 558
TIBDatabase, 552, 900
TIBDatabaseInfo, 900
TIBDataSet, 561, 901
TIBEvents, 901
TIBQuery, 567, 902
TIBSQL, 902
TIBSQLMonitor, 903
TIBStoredProc, 903
TIBTable, 563, 904
TIBTransaction, 558, 905
TIBUpdateSQL, 568, 905
TIcon, 905
TImage, 906
TImageList, 906
TIniFile, 907
TIntegerField, 907
TIWAppForm, 908
NDICE REMISSIVO
TIWApplet, 908
TIWApplication, 908
TIWButton, 909
TIWCheckBox, 909
TIWComboBox, 910
TIWControl, 910
TIWDBCheckBox, 910
TIWDBComboBox, 911
TIWDBEdit, 911
TIWDBFile, 911
TIWDBGrid, 912
TIWDBImage, 912
TIWDBListBox, 913
TIWDBLookupComboBox,
913
TIWDBLookupListBox,
913
TIWDBMemo, 914
TIWDBNavigator, 914
TIWDBText, 915
TIWEdit, 915
TIWFile, 915
TIWForm, 916
TIWGrid, 916
TIWImage, 917
TIWImageFile, 917
TIWLabel, 917
TIWLink, 918
TIWList, 918
TIWListBox, 918
TIWMemo, 919
TIWRectangle, 919
TIWRegion, 920
TIWTimer, 920
TIWTreeView, 920
TIWURL, 921
TLabel, 921
TList, 305, 921
TListBox, 922
TListView, 922
TMaskEdit, 923
TMediaPlayer, 924
TMemo, 924
TMemoBuf, 925
TMemoField, 925
TMenuItem, 925
TMetafile, 926
TMIDASConnection, 926
TMIDASPageProducer, 926
TMTSDatamodule, 729
TNMDayTime, 927
TNMEcho, 927
TNMFinger, 927
TNMFTP, 928
TNMHTTP, 928
TNMMSG, 928
TNMMSGServ, 929
TNMNNTP, 929
TNMPOP3, 929
TNMSMTP, 930
TNMSTRM, 930
TNMSTRMServ, 931
TNMTime, 931
TNMUDP, 931
TNMURL, 932
TNMUUProcessor, 930
Tnotebook, 932
TObject, 287
TOLEContainer, 933
TOpenDialog, 933
TOpenPictureDialog, 933
TOutline, 934
TOutlineNode, 934
TPageControl, 935
TPageProducer, 935
TPaintBox, 935
TPanel, 936
TPen, 341, 936
TPicture, 937
TPopupMenu, 937
TPrintDialog, 937
TPrinter, 637, 938
TPrinterSetupDialog, 938
TProgressBar, 939
TProvider, 939
TQRDBText, 939
TQRLabel, 940
TQRMemo, 940
TQRPreview, 940
TQRPrinter, 941
TQRShape, 941
TQRSysData, 941
TQuery, 434, 942
TQueryTableProducer, 942
TQueue, 942
TQuickRep, 943
TRadioButton, 943
TRadioGroup, 944
TRDSConnection, 517, 944
TRegistry, 945
TRegistryIniFile, 945
TRemoteServer, 945
TReplaceDialog, 946
TRichEdit, 946
TRpBarsBase, 946
TRpBaseComponent, 947
TRpComponent, 947
TRpRender, 948
TRpRenderCanvas, 948
TRpRenderStream, 948
TRvCustomConnection,
949
TRvDatsetConnection, 949
TRvNDRWriter, 949
TRvProject, 950
TRvQueryConnection, 954
TRvRenderHTML, 951
TRvRenderPDF, 951
TRvRenderPreview, 951
TRvRenderPrinter, 952
TRvRenderRTF, 953
TRvRenderText, 954
TRvSystem, 954
TRvTableConnection, 955
TSaveDialog, 955
TSavePictureDialog, 955
TScreen, 956
TScrollBar, 956
TScrollBox, 957
TServerSocket, 957
TSession, 422, 958
TShape, 958
TSimpleDataset, 548, 958
TSimpleObjectBroker, 959
TSmallIntField, 960
TSocketConnection, 960
TSpeedButton, 960
TSQLConnection, 540, 961
TSQLData Set, 544, 961
TSQLMonitor, 962
TSQLQuery, 547, 962
TSQLStoredProc, 963
TSQLTable, 546, 964
TStack, 964
TStatusBar, 965
TStoredProc, 595, 965
TStringField, 966
TStringGrid, 966
TStringList, 966
TStrings, 967
TTabbedNotebook, 967
TTabControl, 968
TTable, 428, 968
TTabSet, 969
TTabSheet, 969
TThread, 708, 970
TTimeField, 970
TTimer, 970
TToolBar, 971
TTrackBar, 971
TTreeView, 972
TUpdateSQL, 437, 500, 972
TUpDown, 973
TVarBytesField, 973
TWebDispatcher, 974
TWordField, 974
TXMLBroker, 974
wEInterpreterError, 839
Classes e objetos, noes de,
63
Classes,
conceito de, 64
herana de, 69, 275
implementao de, 272
Mtodos Abstratos, 284
Mtodos de, 65, 285
Mtodos e campos,
privados, 71, 280
protegidos, 71, 280
pblicos, 70, 279
Mtodos Estticos, Virtuais
e Dinmicos, 282
Propriedades, 285
Sobreposio de Mtodos,
281
visibilidade de Mtodos e
campos, 279
ClassInfo, Mtodo 288,
Mtodo, 1244
ClassName, Mtodo 289, 1244
ClassNameLs, Mtodo 289,
1245
ClassParent, Mtodo 289, 1245
ClassType, Mtodo 290, 1245
CleanUp, Mtodo, 1246
CleanupInstance, Mtodo
290, 1246
Clear, Mtodo, 1246
ClearFields, Mtodo, 1247
ClearSelection, Mtodo, 1247
Click, Mtodo, 1247
ClientDataset, componente,
732
ClientHandle, Propriedade,
1014
ClientHeight, Propriedade,
1014
ClientOrigin, Propriedade, 1014
ClientRect, Propriedade, 1015
ClientToScreen, Mtodo, 1248
ClientWidth, Propriedade, 1015
ClipRect, 1016
Close, Mtodo, 1248
CloseDatabase, Mtodo, 1249
CloseDataSets, Mtodo, 1249
CloseDialog, Mtodo, 1249
CloseLink, Mtodo, 1250
CloseQuery, Mtodo, 1250
CloseUp, Mtodo, 1250
Code Explorer, janela 35
Cdigos, Editor de, 12
Col, Propriedade, 1016
ColCount, Propriedade, 1016
Collapse, Mtodo, 1251
Collate, Propriedade, 1016
Color, Propriedade, 1017
ColorEachPoint, Propriedade,
1019
ColoredButtons, Propriedade,
1019
ColorToRGBString, Mtodo,
1251
Cols, Propriedade, 1019
ColumnMarginInches,
Propriedade, 1019
ColumnMarginMM,
Propriedade, 1020
Columns, Propriedade, 1020
ColWidths, Propriedade, 1020
COM, criao de objeto, 716
COM, tecnologia, 716, 729
Comandos, blocos de, 46, 54,
55
Comentrios, 46
Command, Propriedade, 1021
CommandText, Propriedade,
1021
CommandTimeOut,
Propriedade, 1021
CommandType, Propriedade,
1022
Commit, Mtodo, 1251
CommitRetaining, Mtodo,
1251
CommitTrans, Mtodo, 1251
CommitUpdates, Mtodo, 1252
CommonAVI, 1022
CompareStr, funo, 665
CompareText, funo, 665
ComponentCount,
Propriedade, 1023
Componente,
Boto de Comando, 122
ClientDataset, 159
ClientDataset, principais
Mtodos, 179
ClientDataset, principais
Propriedades, 178
DatasetProvider, 159
DatasetTableProducer, 611
Datasource, 154, 180
DBComboBox, 168
DBEdit, 145, 164
DBGrid, 210
DBNavigator, 205
MaskEdit, 167
RvProject, 236
Shape, 343, 611,
SimpleDataset, 180
Componentes,
conceito de, 15
criao de Eventos, 360
criao de Propriedades,
352
criao de, 348
definio de, 15, 328, 329
nomenclatura de, 76
paleta de, 12
redimensionando, 93
renomeando, 92
reposicionando, 92
templates de, 200
ComponentIndex,
Propriedade, 1023
Components, Propriedade,
1024
Concat, funo, 665
Condicionais, Estruturas, 54,
55
ConfirmDelete, Propriedade,
1024
Conjuntos, 47
operaes sobre, 48
Connect, Mtodo, 1252
Connected, Propriedade,
1024
Connection, Propriedade, 1025
ConnectionString,
Propriedade, 1025
ConnectMode, Propriedade,
1025
Construtores, Mtodos, 277
ContainsControl, Mtodo,
1252
Content, Mtodo, 1252
Context, Propriedade, 1026
ControlAtPos, Mtodo, 1252
ControlCount, Propriedade,
1026
Controles ActiveX, criao
de, 379
Controles e componentes,
definio de, 15
Controls, Propriedade, 1027
ControlType, Propriedade,
1027
ConvertDlgHelp,
Propriedade, 1028
Copies, Propriedade, 1028
Copy, funo, 665
CopyParams, Mtodo, 1253
CopyRect, Mtodo, 1253
CopyToClipboard, Mtodo,
1253
CorbaObject, Mtodo, 1253
CosH, funo, 823
Cotan, funo, 823
Count, Propriedade, 1028
Create Database, caixa de
dilogo, 132
Create, Mtodo, 288, 299,
1253
CreateDatabase, Mtodo,
1255
CreateField, Mtodo, 1255
CreateFmt, Mtodo 299,
1255
CreateFmtHelp, Mtodo, 300,
1256
CreateHelp, Mtodo, 300,
1256
CreateIndexFile, Mtodo,
1257
CreateNew, Mtodo, 1257
CreateRes, Mtodo, 300,
1257
CreateResFmt, Mtodo, 301,
1257
CreateResFmtHelp, Mtodo,
301, 1258
CreateSize, Mtodo, 1258
CreateTable, Mtodo, 1258
Ctl3D, Propriedade, 1029
CurrebtPage, 1030
Currency, Propriedade, 1029
CurrentMemory,
Propriedade, 1030
CurrentSum, Propriedade,
1030
CurrToStr, funo, 665
Cursor, Propriedade, 1030
CursorPosChanged, Mtodo,
1259
Cursors, Propriedade, 1031
CursorXPos, 1032
CursorYPos, 1032
CustomColors, Propriedade,
1033
Customize, Caixa de dilogo,
14
CutToClipboard, Mtodo,
1259
CycleToRad, funo, 823
D
Data Connection, caixa de
dilogo, 238
Data View Dictionary, 238
Data, Propriedade, 1033
Database Desktop, utilitrio
133
Database, Propriedade, 1033
DatabaseCount, Propriedade,
1033
DatabaseDisconnected,
Evento, 1344
DatabaseDisconnecting,
Evento, 1344
DatabaseFree, Evento, 1345
DatabaseName, Propriedade,
1034
Databases, Propriedade, 1034
DataField, Propriedade, 155,
1034
Datamodule, definio de, 174
DataSet, Propriedade, 1035
DataSetCount, Propriedade,
1035
DatasetProvider,
componente, 730
DataSets, Propriedade, 1035
DatasetTableProducer
Componente, 782
DataSize, Propriedade, 1036
DataSource, componente, 154
DataSource, Propriedade, 1036
DataSource, Propriedade, 155
DataType, Propriedade, 1037
Dataview, Propriedade, 241
DateToStr, funo, 666
DBCombobox, componente,
168
DBCombobox, componente,
Propriedades, 168
DBEdit, componente, 155,
164
DBExpress Connection
Editor, caixa de dilogo, 153
DBExpress, mecanismo de
acesso a dados, 152
DBFileName, Propriedade,
1037
DBHandle, Propriedade, 1037
DBLocale, Propriedade, 1037
DBNavigator, componente,
205
DBSQLDialect, Propriedade,
1038
DCOM, Tecnologia, 729
DCOMConnection,
Componente, 731
DDEConv, Propriedade, 1038
DDEItem, Propriedade, 1038
DDEService, Propriedade,
1039
DDETopic, Propriedade, 1039
DecisionCube, Propriedade,
1039
DecisionSource, Propriedade,
1039
Default, Propriedade, 1040
DefaultColWidth,
Propriedade, 1040
DefaultDatabase,
Propriedade, 1041
DefaultDrawing, Propriedade,
1041
DefaultExt, Propriedade, 1041
DefaultHandler, Mtodo, 290
DefaultIndex, Propriedade,
1042
DefaultRowHeight,
Propriedade, 1042
DefaultTransaction,
Propriedade, 1042
DegToRad, funo, 823
Delete, funo, 666
Delete, Mtodo, 1259
DeleteIndex, Mtodo, 1260
DeleteSQL, Propriedade, 1042
DeleteTable, Mtodo, 1260
DescriptionAvailable,
Mtodo, 1260
Desenvolvimento,
ferramentas de, 4
DesignReport, Mtodo, 1260
Destination, Propriedade,
1043
Destroy, Mtodo 291, 1260
Destroy, Mtodo, 290
DestroyComponents,
Mtodo, 1261
Destroying, Mtodo, 1261
Destrutores, Mtodos, 278
Device, Propriedade, 1043
DeviceID, Propriedade, 1044
DeviceType, Propriedade,
1044
DimensionMap, Propriedade,
1044
Directory, Propriedade, 1045
DirLabel, Propriedade, 1045
DirList, Propriedade, 1045
DisableAlign, Mtodo, 1261
DisableControls, Mtodo,
1261
DisableIfNoHandler,
Propriedade, 1046
DisConnect, Mtodo, 1261
Dispatch, Mtodo 290, 1262
Display, Propriedade, 1046
DisplayFormat, Propriedade,
182, 1047
DisplayLabel, Propriedade,
1047
DisplayName, Propriedade,
1047
DisplayPrintDialog,
Propriedade, 1047
DisplayRect, Propriedade,
1048
DisplayText, Propriedade,
1048
DisplayValue, Propriedade,
1049
DisplayWidth, Propriedade,
1049
DitherBackground,
Propriedade, 1049
DLLs, criao de, 650
DocBackColor, Propriedade,
1050
DocForeColor, Propriedade,
1050
DockClientCount,
Propriedade, 1050
DockClients, Propriedade,
1050
DockRect, Propriedade, 1050
DockSite, Propriedade, 1051
DocLinkColor, Propriedade,
1051
DoHint, Mtodo, 1262
DoTerminate, Mtodo, 1262
Down, Propriedade, 1051
Drag-And-Drop, operaes
de, 751
DragCursor, Propriedade,
1052
Dragging, Mtodo, 1262
Dragging, Propriedade, 1052
NDICE REMISSIVO
DragLock, Mtodo, 1263
DragMode, Propriedade, 1052
DragUnLock, Mtodo, 1263
Draw, Mtodo, 1263
DrawFocusRect, Mtodo, 1263
DrawingStyle, Propriedade,
1053
DrawOverlay, Mtodo, 1263
Drive, Propriedade, 1053
DriverName, Propriedade, 1054
DropConnections, Mtodo,
1263
DropDatabase, Mtodo, 1264
DropDown, Mtodo, 1264
DropDownAlign,
Propriedade, 1054
DropDownCount,
Propriedade, 1055
DropDownWidth,
Propriedade, 1055
DropTarget, Propriedade, 1055
E
EAbort, Classe, 830
EAbstractError, Classe, 830
EAccessViolation, Classe, 830
EArrayError, Classe, 831
EAssertionFailed, Classe, 831
EBitsError, Classe, 831
EBrokerException, Classe, 832
ECacheError, Classe, 832
EClassNotFound, Classe, 832
ECommonCalendarError,
Classe, 833
EComponentError, Classe, 833
EControlC, Classe, 833
EConvertError, Classe, 834
EDatabaseError, Classe, 835
EDateTimeError, Classe, 836
EDBClient, Classe, 834
EDBEditError, Classe, 834
EDBEngineError, Classe, 835
EDimensionMapError, Classe,
836
EDimIndexError, Classe, 836
Edit Tab Order, Caixa de
dilogo, 171
Edit, Mtodo, 1264
EditFormat, Propriedade, 182,
1056
EditKey, Mtodo, 1264
EditMask, Propriedade, 165,
1056
EditMaskPtr, Propriedade, 1057
EditMode, Propriedade, 1058
Editor de Cdigo, 12
EditorMode, Propriedade, 1058
EditRangeEnd, Mtodo, 1265
EditRangeStart, Mtodo, 1265
EditText, Propriedade, 1058
EdivByZero, Classe, 837
EDSWriter, Classe, 835
EExternal, Classe, 837
EExternalException, Classe, 837
EFCreateError, Classe, 837
EFilerError, Classe, 838
EFOpenError, Classe, 838
EHeapException, Classe, 838
EInOutError, Classe, 839
EInterpreterError, Classe, 839
EIntError, Classe, 840
EIntfCastError, Classe, 840
EIntOverFlow, Classe, 840
EInvalidArgument, Classe, 841
EInvalidCast, Classe, 841
EInvalidGraphic, Classe, 841
EInvalidGraphicOperation,
Classe, 842
EInvalidGridOperation,
Classe, 842
EInvalidImage, Classe, 842
EInvalidOp, Classe, 843
EInvalidOperation, Classe, 843
EInvalidPointer, Classe, 843
Eject, Mtodo, 1265
EListError, Classe, 844
Ellipse, Mtodo, 1265
ElowCapacityError, Classe, 844
EMathError, Classe, 844
EMCIDeviceError, Classe, 845
EMenuError, Classe, 845
EMonthCalError, Classe, 845
Empty, Propriedade, 1059
EmptyTable, Mtodo, 1266
EnableAlign, Mtodo, 1266
EnableControls, Mtodo, 1266
Enabled, Propriedade, 1059
EnabledButtons, Propriedade,
1059
EnableOpenBtn, Propriedade,
1060
EnablePrintBtn, Propriedade,
1060
EnableSaveBtn, Propriedade,
1060
EndDoc, Mtodo, 1266
EndDrag, Mtodo, 1266
EndMargin, Propriedade, 1060
EndPos, Propriedade, 1061
EndUpdate, Mtodo, 1267
EnoResultSet, Classe, 846
EOF, Propriedade, 1061
EOLECtrlError, Classe, 846
EOLEError, Classe, 846
EOLEException, Classe, 847
EOLESysError, Classe, 847
EOSError, Classe, 847
EOutlineError, Classe, 848
EOutOfMemory, Classe, 848
EOutOfResources, Classe, 848
EOverflow, Classe, 849
EPackageError, Classe, 849
EParseError, Classe, 849
EPrinter, Classe, 850
EPrivilege, Classe, 850
EPropertyError, Classe, 850
EPropReadOnly, Classe, 851
EPropWriteOnly, Classe, 851
EraseSection, Mtodo, 1267
EReadError, Classe, 852
EReconcileError, Classe, 852
ERegistryException, Classe, 852
EResNotFound, Classe, 853
Error, Propriedade, 1061
ErrorCode, Propriedade, 1062
ErrorCount, Propriedade, 1062
ErrorMessage, Propriedade,
1062
Errors, Propriedade, 1063
ESocketConnectionError,
Classe, 853
ESocketError, Classe, 853
EStackOverflow, Classe, 854
EStreamError, Classe, 854
EStringListError, Classe, 854
Estruturas Condicionais, 54, 55
Estruturas de repetio, 54, 57
EThread, Classe, 855
ETreeViewError, Classe, 855
EUnderflow, Classe, 855
EUpdateError, Classe, 856
EVariantError, Classe, 856
Evento,
AfterCancel, 1340
AfterClose, 1340
AfterConnect, 1340
AfterDelete, 1340
AfterDetail, 1340
AfterDisConnect, 1340
AfterDispatch, 1340
AfterDrawValues, 1341
AfterEdit, 1341
AfterInsert, 1341
AfterOpen, 1341
AfterPost, 1341
AfterPrint, 1341
AfterScroll, 1342
BeforeCancel, 1342
BeforeClose, 1342
BeforeConnect, 1342
BeforeDelete, 1342
BeforeDetail, 1343
BeforeDisconnect, 1343
BeforeDispatch, 1343
BeforeDrawValues, 1343
BeforeEdit, 1343
BeforeInsert, 1343
BeforeOpen, 1343
BeforePost, 1344
BeforePrintt, 1344
BeforeRefresh, 1344
BeforeScroll, 1344
DatabaseDisconnected, 1344
DatabaseDisconnecting,
1344
DatabaseFree, 1345
OnActionExecute, 1345
OnActionUpdate, 1345
OnActivate, 1345
OnActiveControlChange,
1345
OnActiveFormChange,
1346
OnAfterAdd, 1346
OnAfterClose, 1346
OnAfterDraw, 1346
OnAfterOpen, 1346
OnAfterPivot, 1346
OnAfterPrint, 1346
OnAfterRender, 1347
OnApply, 1347
OnBeforeAdd, 1347
OnBeforeClose, 1347
OnBeforeOpen, 1347
OnBeforePivot, 1347
OnBeforePrint, 1348
OnBeginRetrieval, 1348
OnBeginTransComplete,
1348
OnCalcFields, 1348
OnCancel, 1348
OnChange, 1348
OnChanging, 1349
OnClearValues, 1349
OnClick, 1349
OnClickAxis, 1350
OnClickLegend, 1350
OnClose, 1350
OnCloseQuery, 1351
OnColEnter, 1351
OnColExit, 1352
OnCollapse, 1352
OnColumnClick, 1352
OnColumnMoved, 1352
OnCompare, 1353
OnConnect, 1353
OnConnectComplete, 1353
OnConnectionFailed, 1353
OnCreate, 1353
OnDataChange, 1354
OnDblClick, 1354
OnDeActivate, 1354
OnDefault, 1355
OnDelete, 1355
OnDeletion, 1355
OnDesignerSave, 1355
OnDesignerSaveAs, 1355
OnDesignerShow, 1355
OnDestroy, 1355
OnDisConnect, 1356
OnDockDrop, 1356
OnDockOver, 1356
OnDragDrop, 1357
OnDragOver, 1357
OnDrawCell, 1357
OnDrawItem, 1358
OnDrawTab, 1358
OnDropDown, 1359
OnEdit, 1359
OnEditError, 1359
OnEndDock, 1359
OnEndDrag, 1359
OnEndOfRecordset, 1360
OnEndPage, 1360
OnEndRetrieval, 1360
OnEnter, 1360
OnEventAlert, 1360
OnException, 1361
OnExecute, 1361
OnExecuteComplete, 1361
OnExecuteMacro, 1361
OnExit, 1361
OnExpand, 1361
OnFetchComplete, 1362
OnFetchProgress, 1362
OnFilter, 1362
OnFilterRecord, 1362
OnFind, 1362
OnFirst, 1363
OnGetEditMask, 1363
OnGetEditText, 1363
OnGetErrorResponse, 1363
OnGetResponse, 1363
OnGetText, 1364
OnHelp, 1364
OnHide, 1364
OnHint, 1364
OnHTMLTag, 1364
OnIdle, 1365
OnIdleTimer, 1365
OnInfoMessage, 1365
OnInsert, 1365
OnKeyDown, 1365
OnKeyPress, 1366
OnKeyUp, 1366
OnLast, 1366
OnLogin, 1366
OnLowCapacity, 1366
OnMeasureItem, 1367
OnMeasureTab, 1367
OnMessage, 1368
OnMinimize, 1368
OnMouseDown, 1368
OnMouseUp, 1369
OnMouseWheel, 1369
OnMouseWheelUp, 1369
OnMoveComplete, 1370
OnNeedData, 1370
OnNewDimensions, 1370
OnNewPage, 1370
OnNewRecord, 1370
OnNext, 1370
OnNotify, 1371
OnOpen, 1371
OnPaint, 1371
OnPassword, 1371
OnPokeData, 1372
OnPopup, 1372
OnPost, 1372
OnPostClick, 1372
OnPostError, 1372
OnPreview, 1372
OnPrint, 1373
OnPrintFooter, 1373
OnPrintHeader, 1373
OnPrior, 1373
OnReceivedFile, 1373
OnRefresh, 1374
OnRender, 1374
OnRenderCell, 1374
OnReplace, 1374
OnResize, 1374
OnRestore, 1375
OnRowMoved, 1375
OnScroll, 1375
OnSectionClick, 1376
OnSectionResize, 1376
OnSectionTrack, 1376
OnSelectCell, 1376
OnSetEditText, 1376
OnSetText, 1377
OnShortcut, 1377
OnShow, 1377
OnShowHint, 1377
OnSized, 1378
OnSizing, 1378
OnSQL, 1378
OnStart, 1378
OnStartPage, 1378
OnStateChange, 1379
OnStatusLineEvent, 1379
OnStop, 1379
OnSubmit, 1379
OnSummaryChange, 1379
OnTimer, 1380
OnTopLeftChanged, 1380
OnUnDock, 1380
OnUndoZoom, 1380
OnUpdate, 1380
OnUpdateData, 1381
OnUpdateError, 1381
OnUpdateRecord, 1381
OnValidate, 1381
OnWillConnect, 1382
OnWillExecute, 1382
OnWillMove, 1382
OnZoom, 1382
Eventos, definio de, 18
Events, Propriedade, 1063
EWin32Error, Classe, 857
EWriteError, Classe, 857
Excees,
conceito de, 296
tratamento de, 296
Exception, Classe, 298
Exchange, Mtodo, 1267
Exclusive, Propriedade, 1063
ExecProc, Mtodo, 1267
ExecQuery, Mtodo, 1268
ExecSQL, Mtodo, 1268
Execute, Mtodo, 1268
ExecuteAction, Mtodo, 1269
ExecuteMacro, Mtodo, 1269
ExecuteMacroLines, Mtodo,
1269
ExecuteReport, Mtodo, 1270
ExeName, Propriedade, 1063
Exists, Propriedade, 1064
Expand, Mtodo, 1270
Expanded, Propriedade, 1064
ExtendSelect, Propriedade,
1064
EZeroDivide, Classe, 857
F
Ferramentas, caixa de, 11
Ferramentas RAD, conceito, 4
FieldAddress, Mtodo 291, 1270
FieldByName, Mtodo, 1270
FieldClass, Propriedade, 1064
FieldCount, Propriedade, 1065
FieldDefs, Propriedade, 1065
FieldList, Propriedade, 1065
FieldName, Propriedade,
1065
FieldNo, Propriedade, 1066
Fields Editor, definio, 160
Fields, Propriedade, 1066
FieldValues, Propriedade, 1066
FileEdit, Propriedade, 1067
FileEditStyle, Propriedade,
1067
FileExtension, Propriedade,
1067
FileGetDate, Mtodo, 659
FileList, Propriedade, 1068
FileLoad, Mtodo, 1271
FileName, Propriedade, 1068
FileOpen, Mtodo, 659
FileSearch, funo, 659
FileSetAttr, funo, 660
FileSetDate, funo, 660
FileType, Propriedade, 1069
FileWrite, funo, 660
FillRect, Mtodo, 1271
Filter, Propriedade, 1070
Filtered, Propriedade, 1070
FilterIndex, Propriedade, 1070
FindClose, funo, 660
FindComponent, Mtodo,
1271
FindDatabase, Mtodo, 1271
FindField, Mtodo, 1272
FindFirst, funo, 660
FindKey, Mtodo, 1272
FindNearest, Mtodo, 1272
FindNext, funo, 661
FindNextPage, Mtodo, 1272
FindText, Propriedade, 1071
FindTransaction, Mtodo, 1273
First, Mtodo, 1273
FirstIndex, Propriedade, 1071
FirstPage, Propriedade, 1071
FixedColor, Propriedade, 1072
FixedCols, Propriedade, 1072
FixedRows, Propriedade, 1072
FloatToStr, funo, 666
FloodFill, Mtodo, 1273
FocusControl, Mtodo, 1273
FocusControl, Propriedade,
1073
Focused, Mtodo, 1274
Focused, Propriedade, 1073
Font, Propriedade, 85, 1073
Fonts, Propriedade, 1074
FooterBand, Propriedade, 1074
ForceDirectories, funo, 661
ForceNewPage, Propriedade,
1075
FormatChars, Propriedade,
1075
Formats, Propriedade, 1075
FormCount, Propriedade, 1076
Forms, Propriedade, 1076
FormStyle, Propriedade, 1076
Formulrios, alinhando
componentes, 97
Formulrios, definio de, 15
Formulrios, inserindo
componentes, 90, 96
Formulrios, manipulao de,
84
Formulrios, selecionando
componentes, 92
Formulrios, templates de,
210
Frame, Propriedade, 1077
FrameCount, Propriedade,
1077
FrameHeight, Propriedade,
1077
FrameRect, Mtodo, 1274
Frames, Propriedade, 1078
FrameWidth, Propriedade,
1077
Free, Mtodo 290, 291, 1274
FreeBookMark, Mtodo, 1275
FreeInstance, Mtodo, 290,
291, 1275
FreeNotification, Mtodo,
1275
FreeOnTerminated,
Propriedade, 1078
Frequency, Propriedade, 1078
Frexp, funo, 823
FromPage, Propriedade, 1078
FullCollapse, Mtodo, 1275
FullExpand, Mtodo, 1275
FullPath, Propriedade, 1079
Funes, 59, 61
para manipulao de
arquivos, 62
G
GetAliasNames, Mtodo,
1276
GetAliasParams, Mtodo,
1276
GetAsHandle, Mtodo, 1276
GetBitmap, Mtodo, 1276
GetBookmark, Mtodo, 1277
GetChildren, Mtodo, 1277
GetComponent, Mtodo,
1277
GetCurrentDir, funo, 661
GetData, Mtodo, 1277
GetDatabaseNames, Mtodo,
1278
GetDataItem, Mtodo, 1278
GetDeltaPacket, Mtodo,
1278
GetDetailLinkFields, Mtodo,
1278
GetDetailSQL, Mtodo, 1278
GetDir, funo, 661
GetDriverNames, Mtodo,
1279
GetDriverParams, Mtodo,
1279
GetErrorCount, Mtodo, 1279
GetFieldNames, Mtodo, 1279
GetFirstChild, Mtodo, 1280
GetFormImage, Mtodo, 1280
GetHotSpot, Mtodo, 1280
GetIcon, Mtodo, 1280
GetImageBitmap, Mtodo,
1280
GetIndexForPage, Mtodo,
1281
GetIndexNames, Mtodo, 1281
GetItem, Mtodo, 1281
GetItemPath, Mtodo, 1281
NDICE REMISSIVO
GetLastChild, Mtodo, 1281
GetMaskBitmap, Mtodo, 1282
GetNamePath, Mtodo, 1282
GetNextChild, Mtodo, 1282
GetParentComponent,
Mtodo, 1282
GetPassword, Mtodo, 1282
GetPrevChild, Mtodo, 1283
GetPrinter, Mtodo, 1283
GetProcedureNames,
Mtodo, 1283
GetResults, Mtodo, 1283
GetSelTextBuf, Mtodo, 1283
GetSQL, Mtodo, 1284
GetStoredProcNames,
Mtodo, 1284
GetTableNames, Mtodo,
1284
GetTabOrderList, Mtodo,
1285
GetText, Mtodo, 1285
GetTextBuf, Mtodo, 1285
GetTextLen, Mtodo, 1285
GetXMLRecords, Mtodo,
1286
Glyph, Propriedade, 211, 1079
GotoBookmark, Mtodo, 1286
GotoCurrent, Mtodo, 1286
GotoKey, Mtodo, 1286
GotoNearest, Mtodo, 1287
GradToRad, funo, 823
Graphic, Propriedade, 1080
GridHeight, Propriedade,
1080
GridLineWidth, Propriedade,
1080
GridWidth, Propriedade,
1081
GroupIndex, Propriedade, 1081
Grupos de Projeto,
Manipulao de, 32
H
Handle, Propriedade, 1081
HandleAllocated, Mtodo,
1287
HandleException, Mtodo,
1287
HandleIsShared, Propriedade,
1084
HandleNeeded, Mtodo, 1287
HasFormat, Mtodo, 1288
Hash, Mtodo, 1288
HasItems, Propriedade, 1084
HasProvider, Propriedade, 1085
Head1Font, Propriedade, 1085
HeaderBand, Propriedade, 1086
Height, Propriedade, 1087
Help, criao de arquivos de,
248
HelpCommand, Mtodo, 1288
HelpContext, Mtodo, 1289
HelpContext, Propriedade,
302, 1087
HelpFile, Propriedade, 1088
HelpJump, Mtodo, 1289
HelpKeyWord, Propriedade,
1088
HelpType, Propriedade, 1088
Hide, Mtodo, 1289
HideDragImage, Mtodo, 1290
HideScrollBars, Propriedade,
1089
HideSelection, Propriedade, 1089
Hint, Propriedade, 1089
HintColor, Propriedade, 1090
HintPause, Propriedade, 1090
Hints, Propriedade, 206, 1091
HistoryList, Propriedade, 1091
HorizAxis, Propriedade, 1091
HorzScrollBar, Propriedade,
1092
Host, Propriedade, 1092
HotKey, Propriedade, 1092
HTML, formulrios, 777
HTMLDoc, Propriedade, 780
HTMLFile, Propriedade, 780
Hypot, funo, 824
I
IBConsole, utilitrio, 131
Icon, Propriedade, 89, 1093
IdleTimer, Propriedade, 1093
ImageIndex, Propriedade,
1093
Images, Propriedade, 1094
ImageType, Propriedade, 1094
Impresso, tcnicas de, 637
Increment, Propriedade, 1094
Indent, Propriedade, 1095
Index, Propriedade, 1095
IndexDefs, Propriedade, 1095
IndexFieldCount,
Propriedade, 1096
IndexFieldNames,
Propriedade, 1096
IndexFields, Propriedade, 1096
IndexName, Propriedade, 1096
IndexOf, Mtodo, 1290
IndexOfObject, Mtodo, 1290
ndices, criao de, 141, 183
InheritsFrom, Mtodo, 293
InitialDir, Propriedade, 1097
InitInstance, Mtodo 292, 1291
InitInstance, Mtodo, 292
InPlaceActive, Propriedade,
1097
Input Mask Editor, caixa de
dilogo, 166
Insert,
comando, 583
funo, 666
Mtodo, 170, 1291
InsertComponent, Mtodo,
1292
InsertControl, Mtodo, 1292
InsertIcon, Mtodo, 1292
InsertMasked, Mtodo, 1292
InsertObject, Mtodo, 1293
InsertRecord, Mtodo, 1293
InsertSQL, Propriedade, 1097
InstanceSize, Mtodo 292, 1293
IntegralHeight, Propriedade,
1098
Interbase Interactive SQL,
utilitrio, 576
Interbase Server Manager,
utilitrio, 573
Interbase,
acesso via BDE, 594
acesso via DBExpress, 605
acesso via Interbase
Express, 600
Alterando um Usurio,
575
Cadastrando um Novo
Usurio, 574
Criando um Banco de
Dados no, 576
Criando uma Tabela no, 579
linguagem de codificao
do, 587
Removendo um Usurio,
575
Tipos de dados do, 578
Interval, Propriedade, 1098
IntPower, funo, 824
Intransaction, Propriedade,
1098
Intraweb, tecnologia, 806
IntToStr, funo, 666
InValidate, Mtodo, 1293
InvalidKeys, Propriedade, 1099
Is, operador, 294
IsA, Mtodo, 1293
IsDelimiter, funo, 666
IsEmpty, Mtodo, 1294
IsIndexField, Propriedade, 1099
IsLocal, Mtodo, 1294
IsMasked, Propriedade, 1099
IsNull, Propriedade, 1100
IsPathDelimiter, funo, 666
IsReadOnly, Propriedade, 1100
IsSQLBased, Propriedade, 1100
IsValidChar, Mtodo, 1294
IsVisible, Propriedade, 1101
ItemAtPos, Mtodo, 1294
ItemCount, Propriedade, 1101
ItemHeight, Propriedade, 1101
ItemIndex, Propriedade, 1102
ItemRect, Mtodo, 1295
Items,
objeto, 169
objeto, Mtodos, 169
objeto, Propriedades, 169
Propriedade, 169, 1102
ItemSeparator, Propriedade,
1103
J
Janela, garantindo a
visibilidade de uma, 37
K
KeepConnections,
Propriedade, 1103
KeyExclusive, Propriedade,
1104
KeyField, Propriedade, 1104
KeyFieldCount, Propriedade,
1104
KeyPreview, Propriedade, 1104
KeyValue, Propriedade, 1105
KeyViolCount, Propriedade,
1105
KeyViolTableName,
Propriedade, 1105
Kind, Propriedade, 1106
L
Label, componente, 155
LargeChange, Propriedade,
1107
LargeImages, Propriedade,
1107
Last, Mtodo, 1295
LastDelimiter, funo, 667
LastPage, Propriedade, 1107
Layout, Propriedade, 1108
Left, Propriedade, 1108
LeftAxis, Propriedade, 1109
LeftCol, Propriedade, 1109
LeftMarginInches,
Propriedade, 1109
LeftMarginMM, Propriedade,
1109
Length, funo, 667
Length, Propriedade, 1110
Level, Propriedade, 1110
Lines, Propriedade, 1110
LineTo, Mtodo, 1295
Linguagem SQL, 216
LinkBand, Propriedade, 1111
List, Propriedade, 1111
ListField, Propriedade, 1111
ListSource, Propriedade, 1112
Load, Mtodo, 1295
LoadFromFile, Mtodo, 170,
1296
LoadFromStream, Mtodo,
1296
LoadMemo, Mtodo, 1296
LoadPicture, Mtodo, 1297
Local, Propriedade, 1112
Locale, Propriedade, 1112
LocalIP, Propriedade, 1112
Locate, Mtodo, 1297
Locked, Propriedade, 1113
LockTable, Mtodo, 1297
Log10, funo, 824
Log2, funo, 824
Lgicos, operadores, 59
LoginPrompt, Propriedade,
1113
LogN, funo, 824
LookupDisplay, Propriedade,
1113
LookupField, Propriedade,
1114
LookupSource, Propriedade,
1114
LowerCase, funo, 667
M
MainForm, Propriedade, 1114
Mapeamento, modos de, 670
Mappings, Propriedade, 1115
Margin, Propriedade, 1115
MarginBotton, Propriedade,
1116
MarginLeft, Propriedade, 1116
MarginRight, Propriedade,
1116
MarginTop, Propriedade, 1116
Mscaras, definio de, 164
Mask, Propriedade, 1117
Masked, Propriedade, 1117
MaskEdit, componente, 167
Master, Propriedade, 1117
MasterFields, Propriedade,
1118
MasterSource, Propriedade,
1118
Max, funo, 824
Max, Propriedade, 1118
MaxCells, Propriedade, 1118
MaxFontSize, Propriedade,
1119
MaxIntValue, funo, 825
MaxLength, Propriedade,
1119
MaxPage, Propriedade, 1119
MaxSummaries, Propriedade,
1120
MaxValue, funo, 825
MaxValue, Propriedade, 1120
MDI, aplicaes, 745
MDIChildCount,
Propriedade, 1120
MDIChildren, Propriedade,
1121
Mean, funo, 825
MeanAndStdDev, funo, 825
Menu, Propriedade, 1121
Menus pop-up,
associando Eventos a itens
de, 115
criando itens de, 110
criando submenus de, 112
incluso de, 109
Menus,
associando Eventos a itens
de, 114
barra de, 11
criando itens de, 105
criando separador de itens
de, 107
criando teclas aceleradoras
para itens de, 108
definio de, 102
editor de, 103
incluso de, 102
mesclando, 747
Merge, Mtodo, 1297
Message, Propriedade, 302,
1121
MessageBox, Mtodo, 1298
Metafile, Propriedade, 1122
MethodAddress, Mtodo 293,
1298
MethodName, Mtodo, 293,
1298
Mtodo,
Abort, 1230
Activate, 1230
Add, 1230
AddChild, 1231
AddChildObject, 1231
AddDatabase, 1231
AddDataset, 1231
AddIcon, 1232
AddIndex, 1232
AddMasked, 1232
AddObject, 1232
AddPassword, 1232
AddScriptFile, 1233
AddSeries, 1233
AddStrings, 1233
AddTransaction, 1233
AddXY, 1234
AddY, 1234
Append, 1234
AppendRecord, 1234
ApplyRange, 1234
ApplyUpdates, 1235
Arc, 1235
ArrangeIcons, 1235
Assign, 1235
AssignValue, 1236
AtLeast, 1236
Back, 1237
BatchMove, 1237
BeginDoc, 1237
BeginDrag, 1237
BeginTrans, 1238
BeginUpdate, 1238
BookMarkValid, 1238
BringToFront, 1239
BroadCast, 1239
BrushCopy, 1239
Call, 1239
CanAutoSize, 1240
Cancel, 1240
CancelDispatch, 1240
CancelEvents, 1240
CancelRange, 1240
CancelUpdates, 1241
CanFocus, 1241
Cascade, 1241
CellRect, 1241
Change, 1242
ChangeLevelBy, 1242
CheckActive, 1242
CheckBrowseMode, 1242
CheckClosed, 1242
CheckDatabaseInList, 1243
CheckDatabasename, 1243
CheckInactive, 1243
CheckInTransaction, 1243
CheckNotInTransaction,
1243
CheckOpen, 1244
CheckValidStatement,
1244
ClassInfo, 288, 1244
ClassName, 289, 1244
ClassNameLs, 289, 1245
ClassParent, 289, 1245
ClassType, 290, 1245
CleanUp, 1246
CleanupInstance, 290,
1246
Clear, 1246
ClearFields, 1247
ClearSelection, 1247
Click, 1247
ClientToScreen, 1248
Close, 1248
CloseDatabase, 1249
CloseDataSets, 1249
CloseDialog, 1249
CloseLink, 1250
CloseQuery, 1250
CloseUp, 1250
Collapse, 1251
ColorToRGBString, 1251
Commit, 1251
CommitRetaining, 1251
CommitTrans, 1251
CommitUpdates, 1252
Connect, 1252
ContainsControl, 1252
Content, 1252
ControlAtPos, 1252
CopyParams, 1253
CopyRect, 1253
CopyToClipboard, 1253
CorbaObject, 1253
Create, 288, 299, 1253
CreateDatabase, 1255
CreateField, 1255
CreateFmt, 299, 1255
CreateFmtHelp, 300, 1256
CreateForm, 1256
CreateHelp, 300, 1256
CreateIndexFile, 1257
CreateNew, 1257
CreateRes, 300, 1257
CreateResFmt, 301, 1257
CreateResFmtHelp, 301,
1258
CreateSize, 1258
CreateTable, 1258
CursorPosChanged, 1259
CutToClipboard, 1259
Delete, 1259
DeleteIndex, 1260
DeleteTable, 1260
DescriptionAvailable, 1260
DesignReport, 1260
Destroy, 291, 1260
DestroyComponents, 1261
Destroying, 1261
DisableAlign, 1261
DisableControls, 1261
DisConnect, 1261
Dispatch, 290, 1262
DoHint, 1262
DoTerminate, 1262
Dragging, 1262
DragLock, 1263
DragUnLock, 1263
Draw, 1263
DrawFocusRect, 1263
DrawOverlay, 1263
DropConnections, 1263
DropDatabase, 1264
DropDown, 1264
Edit, 1264
EditKey, 1264
EditRangeEnd, 1265
EditRangeStart, 1265
Eject, 1265
Ellipse, 1265
EmptyTable, 1266
EnableAlign, 1266
EnableControls, 1266
EndDoc, 1266
EndDrag, 1266
EndUpdate, 1267
EraseSection, 1267
Exchange, 1267
ExecProc, 1267
ExecQuery, 1268
ExecSQL, 1268
Execute, 1268
ExecuteAction, 1269
ExecuteMacro, 1269
ExecuteMacroLines, 1269
ExecuteReport, 1270
Expand, 1270
FieldAddress, 291, 1270
FieldByName, 1270
FileLoad, 1271
FillRect, 1271
FindComponent, 1271
FindDatabase, 1271
FindField, 1272
FindKey, 1272
FindNearest, 1272
FindNextPage, 1272
FindTransaction, 1273
First, 1273
FloodFill, 1273
FocusControl, 1273
Focused, 1274
FrameRect, 1274
Free, 290, 1274
FreeBookMark, 1275
FreeInstance, 290, 1275
FreeNotification, 1275
FullCollapse, 1275
FullExpand, 1275
GetAliasNames, 1276
GetAliasParams, 1276
GetAsHandle, 1276
GetBitmap, 1276
GetBookmark, 1277
GetChildren, 1277
GetComponent, 1277
GetData, 1277
GetDatabaseNames, 1278
NDICE REMISSIVO
GetDataItem, 1278
GetDeltaPacket, 1278
GetDetailLinkFields, 1278
GetDetailSQL, 1278
GetDriverNames, 1279
GetDriverParams, 1279
GetErrorCount, 1279
GetFieldNames, 1279
GetFirstChild, 1280
GetFormImage, 1280
GetHotSpot, 1280
GetIcon, 1280
GetImageBitmap, 1280
GetIndexForPage, 1281
GetIndexNames, 1281
GetItem, 1281
GetItemPath, 1281
GetLastChild, 1281
GetMaskBitmap, 1282
GetNamePath, 1282
GetNextChild, 1282
GetParentComponent,
1282
GetPassword, 1282
GetPrevChild, 1283
GetPrinter, 1283
GetProcedureNames, 1283
GetResults, 1283
GetSelTextBuf, 1283
GetSQL, 1284
GetStoredProcNames, 1284
GetTableNames, 1284
GetTabOrderList, 1285
GetText, 1285
GetTextBuf, 1285
GetTextLen, 1285
GetXMLRecords, 1286
GotoBookmark, 1286
GotoCurrent, 1286
GotoKey, 1286
GotoNearest, 1287
HandleAllocated, 1287
HandleException, 1287
HandleNeeded, 1287
HasFormat, 1288
Hash, 1288
HelpCommand, 1288
HelpContext, 1289
HelpJump, 1289
Hide, 1289
HideDragImage, 1290
IndexOf, 1290
IndexOfObject, 1290
InheritsFrom, 293, 1290
InitInstance, 292, 1291
Insert, 170, 1291
InsertComponent, 1292
InsertControl, 1292
InsertIcon, 1292
InsertMasked, 1292
InsertObject, 1293
InsertRecord, 1293
InstanceSize, 292, 1293
InValidate, 1293
IsA, 1293
IsEmpty, 1294
IsLocal, 1294
IsValidChar, 1294
ItemAtPos, 1294
ItemRect, 1295
Last, 1295
LineTo, 1295
Load, 1295
LoadFromFile, 170, 1296
LoadFromStream, 1296
LoadMemo, 1296
LoadPicture, 1297
Locate, 1297
LockTable, 1297
Merge, 1297
MessageBox, 1298
MethodAddress, 293, 1298
MethodName, 293, 1298
Minimize, 1298
MouseToCell, 1299
Move, 1299
MoveBy, 1299
MoveTo, 1299
NewInstance, 292, 1300
NewPage, 1300
Next, 1300
NonExistent, 1301
NormalizeTopMosts, 1301
OLE., 1301
OleObjAllocated, 1301
Open, 1301
OpenDatabase, 1302
OpenIndexFile, 1302
OpenLink, 1302
Overlay, 1303
Pack, 1303
ParamByName, 1303
PasteFromClipboard, 1303
Pause, 1303
PauseOnly, 1304
Peek, 1304
Perform, 1304
Pie, 1305
Play, 1305
PokeData, 1305
PokeDataLines, 1305
Polygon, 1306
Polyline, 1306
Pop, 1306
Pop-up, 1306
Post, 1306
Prepare, 1307
Preview, 1307
Previous, 1307
Print, 1307
Prior, 1308
ProcessMessages, 1308
Push, 1308
QueueEvents, 1308
Read, 1309
ReadBool, 1309
ReadInteger, 1309
ReadSection, 1309
ReadSectionValues, 1309
ReadString, 1310
Realign, 1310
Rectangle, 1310
Refresh, 1310
RegisterChanges, 1311
RegisterEvents, 1311
Release, 1311
ReleaseHandle, 1311
ReleasePalette, 1311
Remove, 1312
RemoveAllPassword, 1312
RemoveAllSeries, 1312
RemoveComponent, 1312
RemoveDatabase, 1313
RemoveDatabases, 1313
RemovePassword, 1313
RemoveSeries, 1313
RemoveTransaction, 1314
Repaint, 1314
ReplaceIcon, 1314
ReplaceMasked, 1314
RequestData, 1315
Reset, 1315
ResourceLoad, 1315
Restore, 1315
RestoreTopMosts, 1316
Resume, 1316
Rewind, 1316
Rollback, 1317
RollBackRetaining, 1317
RoundRect, 1317
Run, 1317
Save, 1317
SaveToBitmapFile, 1318
SaveToFile, 170, 1318
SaveToMetaFile, 1318
SaveToMetaFileEnh, 1319
SaveToStream, 1319
ScaleBy, 1319
ScreenToClient, 1319
ScrollBy, 1320
ScrollInView, 1320
Seek, 1321
SelectAll, 1321
SelectNext, 1321
SelectNextPage, 1322
SendToBack, 1322
SeriesCount, 1322
SetAsHandle, 1322
SetBounds, 1323
SetComponent, 1323
SetData, 1323
SetFields, 1323
SetFocus, 1324
SetKey, 1324
SetLink, 1324
SetParams, 1324
SetPrincipal, 1324
SetPrinter, 1325
SetRange, 1325
SetRangeEnd, 1325
SetRangeStart, 1325
SetSelTextBuf, 1326
SetTabFocus, 1326
SetText, 1326
SetTextBuf, 1326
SetUpdateState, 1327
Show, 1327
ShowCubeDialog, 1327
ShowDragImage, 1328
ShowException, 1328
ShowModal, 1328
StartRecording, 1329
StartTransaction, 1329
Step, 1329
Stop, 1329
StretchDraw, 1330
Suspend, 1330
Synchronize, 1330
Terminate, 1330
TestConnected, 1331
TextHeight, 1331
TextOut, 1331
TextRect, 1331
TextWidth, 1331
Tile, 1332
Truncate, 1332
UnlockTable, 1332
UnMerge, 1332
UnPrepare, 1333
UnRegisterChanges, 1333
UnRegisterEvents, 1333
Update, 1333
UpdateCursrPos, 1334
UpdateRecord, 1334
ValidateEdit, 1334
Write, 1334
WriteBCDData, 1335
WriteBlobData, 1335
WriteBool, 1335
WriteBoolData, 1335
WriteCurrData, 1335
WriteDateTime, 1336
WriteFloatData, 1336
WriteIntData, 1336
WriteInteger, 1366
WriteNullData, 1336
WriteStrData, 1337
WriteString, 1337
ZoomToFit, 1337
ZoomToWidth, 1337
Mtodos,
definio de, 17
sobrecarga de, 322
sobreposio de, 281
Min, funo, 825
Min, Propriedade, 1122
MinFontSize, Propriedade,
1122
Minimize, Mtodo, 1298
MinIntValue, funo, 825
MinPage, Propriedade, 1123
MinValue, funo, 825
MinValue, Propriedade, 1123
MKDir, funo, 662
ModalResult, Propriedade,
1123
Mode, Propriedade, 1124
Modified, Propriedade, 1126
Modifiers, Propriedade, 1126
ModifySQL, Propriedade,
1127
Monochrome, Propriedade,
1127
MouseToCell, Mtodo, 1299
Move, Mtodo, 1299
MoveBy, Mtodo,1299
MovedCount, Propriedade,
1127
MoveTo, Mtodo, 1299
Multicamadas, aplicaes,
728
Multiline, Propriedade, 1128
MultiSelect, Propriedade,
1128
N
Name, Propriedade, 1128
NameList, Propriedade, 1129
Navegao, componentes e
Mtodos de, 473
NetFileDir, Propriedade, 1129
New Connection, caixa de
dilogo, 153
New Items, caixa de dilogo,
29, 214
NewInstance, Mtodo, 292,
1300
NewPage, Mtodo, 1300
Next, Mtodo, 1300
NonExistent, Mtodo, 1301
Norm, funo, 826
NormalizeTopMosts, Mtodo,
1301
Notify, Propriedade, 1129
NotifyValue, Propriedade,
1130
NumGlyphs, Propriedade,
1130
O
ObjClass, Propriedade, 1131
ObjDoc, Propriedade, 1131
Object Inspector, 11, 18
Object Inspector,
definindo procedimentos
associados a Eventos, 20
exibindo Propriedades no,
331
Object Treeview, janela, 12
Objects, Propriedade, 1131
Objetos, definio de, 63
ObjItem, Propriedade, 1131
OEMConvert, Propriedade,
1132
OLE, Mtodo, 1301
OleObjAllocated, Mtodo,
1301
OnActionExecute, Evento,
1345
OnActionUpdate, Evento,
1345
OnActivate, Evento, 1345
OnActiveControlChange,
Evento, 1345
OnActiveFormChange,
Evento, 1346
OnAfterAdd, Evento, 1346
OnAfterClose, Evento, 1346
OnAfterDraw, Evento, 1346
OnAfterOpen, Evento, 1346
OnAfterPivot, Evento, 1346
OnAfterPrint, Evento, 1346
OnAfterRender, Evento, 1347
OnApply, Evento, 1347
OnBeforeAdd, Evento, 1347
OnBeforeClose, Evento, 1347
OnBeforeOpen, Evento, 1347
OnBeforePivot, Evento, 1347
OnBeforePrint, Evento, 1348
OnBeginRetrieval, Evento,
1348
OnBeginTransComplete,
Evento, 1348
OnCalcFields, Evento, 1348
OnCancel, Evento, 1348
OnChange, Evento, 1348
OnChanging, Evento, 1349
OnClearValues, Evento, 1349
OnClick, Evento, 1349
OnClickAxis, Evento, 1350
OnClickLegend, Evento, 1350
OnClose, Evento, 1350
OnCloseQuery, Evento, 1351
OnColEnter, Evento, 1351
OnColExit, Evento, 1352
OnCollapse, Evento, 1352
OnColumnClick, Evento,
1352
OnColumnMoved, Evento,
1352
OnCommitTransComplete,
Evento, 1353
OnCompare, Evento, 1353
OnConnect, Evento, 1353
OnConnectComplete,
Evento, 1353
OnConnectionFailed,
Evento, 1353
OnConnectionRequired,
Evento, 1353
OnCreate, Evento, 1353
OnDataChange, Evento, 1354
OnDblClick, Evento, 1354
OnDeActivate, Evento, 1354
OnDefault, Evento, 1355
OnDelete, Evento, 1355
OnDeletion, Evento, 1355
OnDesignerSave, Evento,
1355
OnDesignerSaveAs, Evento,
1355
OnDesignerShow, Evento,
1355
OnDestroy, Evento, 1355
OnDialectDowngradeWarning,
Evento, 1356
OnDisConnect, Evento, 1356
OnDockDrop, Evento, 1356
OnDockOver, Evento, 1356
OnDragDrop, Evento, 1357
OnDragOver, Evento, 1357
OnDrawCell, Evento, 1357
OnDrawItem, Evento, 1358
OnDrawTab, Evento, 1358
OnDropDown, Evento, 1359
OnEdit, Evento, 1359
OnEditError, Evento, 1359
OnEndDock, Evento, 1359
OnEndDrag, Evento, 1359
OnEndOfRecordset, Evento,
1360
OnEndPage, Evento, 1360
OnEndRetrieval, Evento, 1360
OnEnter, Evento, 1360
OnEventAlert, Evento, 1360
OnException, Evento, 1361
OnExecute, Evento, 1361
OnExecuteComplete, Evento,
1361
OnExecuteMacro, Evento, 1361
OnExit, Evento, 1361
OnExpand, Evento, 1361
OnFetchComplete, Evento,
1362
OnFetchProgress, Evento,
1362
OnFilter, Evento, 1362
OnFilterRecord, Evento, 1362
OnFind, Evento, 1362
OnFirst, Evento, 1363
OnGetEditMask, Evento, 1363
OnGetEditText, Evento, 1363
OnGetErrorResponse,
Evento, 1363
OnGetResponse, Evento,
1363
OnGetText, Evento, 1364
OnHelp, Evento, 1364
OnHide, Evento, 1364
OnHint, Evento, 1364
OnHTMLTag, Evento, 1364
OnIdle, Evento, 1365
OnIdleTimer, Evento, 1365
OnInfoMessage, Evento, 1365
OnInsert, Evento, 1365
OnKeyDown, Evento, 1365
OnKeyPress, Evento, 1366
OnKeyUp, Evento, 1366
OnLast, Evento, 1366
OnLogin, Evento, 1366
OnLowCapacity, Evento,
1366
OnMeasureItem, Evento,
1367
OnMeasureTab, Evento, 1367
OnMessage, Evento, 1368
OnMinimize, Evento, 1368
OnMouseDown, Evento, 1368
OnMouseMove, Evento,
1368
OnMouseUp, Evento, 1369
OnMouseWheel, Evento,
1369
OnMouseWheelDown,
Evento, 1369
OnMouseWheelUp, Evento,
1369
OnMoveComplete, Evento,
1370
OnNeedData, Evento, 1370
OnNewDimensions, Evento,
1370
OnNewPage, Evento, 1370
OnNewRecord, Evento, 1370
OnNext, Evento, 1370
OnNotify, Evento, 1371
OnOpen, Evento, 1371
OnPaint, Evento, 1371
OnPassword, Evento, 1371
OnPokeData, Evento, 1372
OnPopup, Evento, 1372
OnPost, Evento, 1372
OnPostClick, Evento, 1372
OnPostError, Evento, 1372
OnPreview, Evento, 1372
OnPrint, Evento, 1373
OnPrintFooter, Evento, 1373
OnPrintHeader, Evento, 1373
OnPrior, Evento, 1373
OnReceivedFile, Evento, 1373
OnRecordChangeComplete,
Evento, 1372
OnRecordsetChangeComplete,
Evento, 1374
OnRefresh, Evento, 1374
OnRender, Evento, 1374
OnRenderCell, Evento, 1374
OnReplace, Evento, 1374
OnResize, Evento, 1374
OnRestore, Evento, 1375
OnRollBackTransComplete,
Evento, 1375
OnRowMoved, Evento, 1375
OnScroll, Evento, 1375
OnSectionClick, Evento,
1376
OnSectionResize, Evento,
1376
OnSectionTrack, Evento,
1376
OnSelectCell, Evento, 1376
OnSetEditText, Evento, 1376
OnSetText, Evento, 1377
OnShortcut, Evento, 1377
OnShow, Evento, 1377
OnShowHint, Evento, 1377
OnSized, Evento, 1378
OnSizing, Evento, 1378
OnSQL, Evento, 1378
OnStart, Evento, 1378
OnStartPage, Evento, 1378
OnStateChange, Evento,
1379
OnStatusLineEvent, Evento,
1379
OnStop, Evento, 1379
OnSubmit, Evento, 1379
OnSummaryChange, Evento,
1379
OnTimer, Evento, 1380
OnTopLeftChanged, Evento,
1380
OnUnDock, Evento, 1380
OnUndoZoom, Evento, 1380
OnUpdate, Evento, 1380
OnUpdateData, Evento, 1381
OnUpdateError, Evento, 1381
OnUpdateRecord, Evento,
1381
NDICE REMISSIVO
OnValidate, Evento, 1381
OnWillChangeRecord,
Evento, 1381
OnWillChangeRecordset,
Evento, 1381
OnWillConnect, Evento,
1382
OnWillExecute, Evento, 1382
OnWillMove, Evento, 1382
OnZoom, Evento, 1382
Open, Mtodo, 1301
Open, Propriedade, 1132
OpenDatabase, Mtodo,
1302
OpenIndexFile, Mtodo,
1302
OpenLink, Mtodo, 1302
Operadores aritmticos, 51
Operadores de Converso de
tipos, 294
Operadores Lgicos, 58
Operadores relacionais, 56
Operation, Propriedade, 1132
Options, Propriedade, 1133
Orientation, Propriedade,
1139
OriginalException,
Propriedade, 1140
OutlineStyle, Propriedade,
1141
Output Options, caixa de
dilogo, 241
Overlay, Mtodo, 1303
Overload, Propriedade, 1141
Owner, Propriedade, 1142
Pc
Pack, Mtodo, 1303
PageCount, Propriedade,
1142
PageHeight, Propriedade,
1142
PageIndex, Propriedade, 1143
PageNumber, Propriedade,
1143
PageProducer Componente,
780
Pages, Propriedade, 1144
PageSize, Propriedade, 1144
PageWidth, Propriedade,
1144
Palette, Propriedade, 1145
PanelBorder, Propriedade,
1145
PanelCount, Propriedade,
1145
PanelHeight, Propriedade,
1146
PanelIndex, Propriedade,
1146
Panels, Propriedade, 1146
PanelWidth, Propriedade,
1146
Paragraph, Propriedade, 1147
ParamBindMode,
Propriedade, 1147
ParamByName, Mtodo, 1303
ParamCheck, Propriedade, 1147
ParamCount, Propriedade,
1148
Parameters, Propriedade,
1148
Parmetros Default,
definio, 324
Params, Propriedade, 1148
Parent, Propriedade, 1149
ParentChart, Propriedade,
1149
ParentColor, Propriedade,
1149
ParentCtl3D, Propriedade,
1150
ParentFont, Propriedade,
1150
ParentShowHint,
Propriedade, 1151
PasswordChar, Propriedade,
1151
PasteFromClipboard,
Mtodo, 1303
Pause, Mtodo, 1303
PauseOnly, Mtodo, 1304
Peek, Mtodo, 1304
Pen, Propriedade, 1152
PenPos, Propriedade, 1152
Perform, Mtodo, 1304
Picture, Propriedade, 1152
PictureClosed, Propriedade,
1152
PictureLeaf, Propriedade,
1153
PictureMinus, Propriedade,
1153
PictureOpen, Propriedade,
1154
PicturePlus, Propriedade,
1154
Pie, Mtodo, 1305
Pixels, Propriedade, 1154
PixelsPerInch, Propriedade,
1155
PlainText, Propriedade, 1155
Play, Mtodo, 1305
PokeData, Mtodo, 1305
PokeDataLines, Mtodo,
1305
Poly, funo, 826
Polygon, Mtodo, 1306
Polyline, Mtodo, 1306
Pop, Mtodo, 1306
PopNStdDev, funo, 826
PopNVariance, funo, 826
Pop-up, Mtodo, 1306
PopupComponent,
Propriedade, 1155
PopupMenu, Propriedade,
1156
Port, Propriedade, 1156
Pos, funo, 667
Position, Propriedade, 1156
Post, Mtodo, 1306
PostMessage, Propriedade,
1157
Power, funo, 826
Precision, Propriedade, 1158
Prepare, Mtodo, 1307
Prepared, Propriedade, 1158
Preview, Mtodo, 1307
Previous, Mtodo, 1307
PreviousError, Propriedade,
1158
Print, Mtodo, 1307
PrintBefore, Propriedade,
1158
PrinterIndex, Propriedade,
1159
PrinterOK, Propriedade, 1159
Printers, Propriedade, 1159
Printing, Propriedade, 1159
PrintMask, Propriedade, 1160
PrintRange, Propriedade,
1160
PrintScale, Propriedade, 1160
PrintToFile, Propriedade,
1161
Prior, Mtodo, 1308
PrivateDir, Propriedade, 1161
ProblemCount, Propriedade,
1162
ProblemTableName,
Propriedade, 1162
Procedimentos associados a
Eventos, 20, 71
Procedimentos, 59, 60
ProcedureName, Propriedade,
1162
ProcessMessages, Mtodo,
1308
Programao Orientada a
Objetos, filosofia da, 269
Programao procedural, 264
ProjectFile, Propriedade, 1163
Projeto de Aplicao,
arquivo de, 23
conceito de, 22
fechando, 31
grupos de, 32
iniciando um novo, 28
salvando, 29
Propriedade,
Aborted, 978
AbortOnKeyViol, 978
AbortOnProblem, 978
AccuracyMethod, 979
ActionCount, 979
ActionList, 979
Actions, 979
Active, 980
ActiveControl, 980
ActiveForm, 981
ActiveMDIChild, 981
ActivePage, 982
AliasName, 982
Align, 982
AlignButton, 984
Alignment, 984
AlignToBand, 985
Allocation, 986
AllocBy, 986
AllowAllUp, 986
AllowDelete, 987
AllowGrayed, 987
AllowInPlace, 987
AllowInsert, 988
AllowPaning, 988
AllowResize, 989
AllowSinglePoint, 989
AllowZoom, 989
ArrowKeys, 989
AsBoolean, 990
AsDateTime, 990
AsFloat, 990
AsInteger, 991
Associate, 991
AsString, 991
AsText, 992
AutoActivate, 992
AutoCalcFields, 993
AutoDisplay, 993
AutoEdit, 994
AutoEnable, 994
AutoMerge, 994
AutoOpen, 995
AutoPopup, 995
AutoRewind, 995
AutoScroll, 996
AutoSelect, 996
AutoSize, 996
AxisVisible, 997
BackColor, 997
BackgroundColor, 997
BackImage, 998
BevelInner, 998
BevelOuter, 999
BevelWidth, 999
Bitmap, 1000
BkColor, 1000
BlendColor, 1000
BlobSize, 1000
BOF, 1001
BorderIcons, 1001
BorderStyle, 1001
BorderWidth, 1002
BottomAxis, 1003
BoundsRect, 1003
Break, 1004
Brush, 1004
ButtonAutoSize, 1005
ButtonHeight, 1005
ButtonSpacing, 1005
ButtonWidth, 1005
BytesRcvd, 1006
BytesSent, 1006
BytesTotal, 1006
CachedSize, 1006
CachedUpdates, 1006
Calculated, 1007
Cancel, 1007
Canceled, 1007
CanModify, 1008
Canvas, 1008
Capabilities, 1009
Capacity, 1009
Caption, 1010
CaptionColor, 1010
CaptionFont, 1010
Category, 1011
Cells, 1011
Center, 1011
ChangedCount, 1012
ChangedTableName, 1012
CharCase, 1012
Checked, 1013
ClientHandle, 1014
ClientHeight, 1014
ClientOrigin, 1014
ClientRect, 1015
ClientWidth, 1015
ClipRect, 1016
Col, 1016
ColCount, 1016
Collate, 1016
Color, 1017
ColorEachPoint, 1019
ColoredButtons, 1019
Cols, 1019
ColumnMarginMM, 1020
Columns, 1020
ColWidths, 1020
Command, 1021
CommandText, 1021
CommandTimeOut, 1021
CommandType, 1022
CommonAVI, 1022
ComponentCount, 1023
ComponentIndex, 1023
Components, 1024
ConfirmDelete, 1024
Connected, 1024
Connection, 1025
ConnectionString, 1025
ConnectMode, 1025
Context, 1026
ControlCount, 1026
Controls, 1027
ControlType, 1027
ConvertDlgHelp, 1028
Copies, 1028
Count, 1028
Ctl3D, 1029
Currency, 1029
CurrentMemory, 1030
CurrentPage, 1030
CurrentSum, 1030
Cursor, 1030
Cursors, 1031
CursorXPos, 1032
CursorYPos, 1032
CustomColors, 1033
Data, 1033
Database, 1033
DatabaseCount, 1033
DatabaseName, 1034
Databases, 1034
DataField, 1034
DataSet, 1035
DataSetCount, 1035
DataSets, 1035
DataSize, 1036
DataSource, 1036
DataType, 1037
DBFileName, 1037
DBHandle, 1037
DBLocale, 1037
DBSQLDialect, 1038
DDEConv, 1038
DDEItem, 1038
DDEService, 1039
DDETopic, 1039
DecisionCube, 1039
DecisionSource, 1039
Default, 1040
DefaultColWidth, 1040
DefaultDatabase, 1041
DefaultDrawing, 1041
DefaultExt, 1041
DefaultIndex, 1042
DefaultRowHeight, 1042
DefaultTransaction, 1042
DeleteSQL, 1042
Destination, 1043
Device, 1043
DeviceID, 1044
DeviceType, 1044
DimensionMap, 1044
Directory, 1045
DirLabel, 1045
DirList, 1045
DisableIfNoHandler, 1046
Display, 1046
DisplayFormat, 1047
DisplayLabel, 1047
DisplayName, 1047
DisplayPrintDialog, 1047
DisplayRect, 1048
DisplayText, 1048
DisplayValue, 1049
DisplayWidth, 1049
DitherBackground, 1049
DocBackColor, 1050
DocForeColor, 1050
DockClientCount, 1050
DockClients, 1050
DockRect, 1050
DockSite, 1051
DocLinkColor, 1051
Down, 1051
DragCursor, 1052
Dragging, 1052
DragMode, 1052
DrawingStyle, 1053
Drive, 1053
DriverName, 1054
DropDownAlign, 1054
DropDownCount, 1055
DropDownWidth, 1055
DropTarget, 1055
EditFormat, 1056
EditMask, 165, 1056
EditMaskPtr, 1057
EditMode, 1058
EditorMode, 1058
EditText, 1058
Empty, 1059
Enabled, 1059
EnabledButtons, 1059
EnableOpenBtn, 1060
EnablePrintBtn, 1060
EnableSaveBtn, 1060
EndMargin, 1060
EndPos, 1061
EOF, 1061
Error, 1061
ErrorCode, 1062
ErrorCount, 1062
ErrorMessage, 1062
Errors, 1063
Events, 1063
Exclusive, 1063
ExeName, 1063
Exists, 1064
Expanded, 1064
ExtendSelect, 1064
FieldClass, 1064
FieldCount, 1065
FieldDefs, 1065
FieldList, 1065
FieldName, 1065
FieldNo, 1066
Fields, 1066
FieldValues, 1066
FileEdit, 1067
FileEditStyle, 1067
FileExtension, 1067
FileList, 1068
FileName, 1068
FileType, 1069
Filter, 1070
Filtered, 1070
FilterIndex, 1070
FindText, 1071
FirstIndex, 1071
FirstPage, 1071
FixedColor, 1072
FixedCols, 1072
FixedRows, 1072
FocusControl, 1073
Focused, 1073
Font, 1073
Fonts, 1074
FooterBand, 1074
ForceNewPage, 1075
FormatChars, 1075
Formats, 1075
FormCount, 1076
Forms, 1076
FormStyle, 1076
Frame, 1077
FrameCount, 1077
FrameHeight, 1077
Frames, 1078
FrameWidth, 1077
FreeOnTerminated, 1078
Frequency, 1078
FromPage, 1078
FullPath, 1079
Glyph, 211, 1079
Graphic, 1080
GridHeight, 1080
GridLineWidth, 1080
GridWidth, 1081
GroupIndex, 1081
Handle, 1081
HandleIsShared, 1084
HasItems, 1084
HasProvider, 1085
Head1Font, 1085
Head2Font, 1085
Head3Font, 1085
Head4Font, 1086
Head5Font, 1086
Head6Font, 1086
HeaderBand, 1086
Height, 1087
HelpContext, 302, 1087
HelpFile, 1088
HelpKeyWord, 1088
HelpType, 1088
HideScrollBars, 1089
HideSelection, 1089
Hint, 1089
HintColor, 1090
HintPause, 1090
Hints, 206, 1091
HistoryList, 1091
HorizAxis, 1091
HorzScrollBar, 1092
Host, 1092
HotKey, 1092
Icon, 1093
IdleTimer, 1093
ImageIndex, 1093
Images, 1094
ImageType, 1094
Increment, 1094
Indent, 1095
Index, 1095
IndexDefs, 1095
IndexFieldCount, 1096
IndexFieldNames, 1096
IndexFields, 1096
IndexName, 1096
InitialDir, 1097
InPlaceActive, 1097
InsertSQL, 1097
IntegralHeight, 1098
Interval, 1098
Intransaction, 1098
InvalidKeys, 1099
IsIndexField, 1099
IsMasked, 1099
IsNull, 1100
IsReadOnly, 1100
IsSQLBased, 1100
IsVisible, 1101
ItemCount, 1101
ItemHeight, 1101
ItemIndex, 1102
Items, 1102
ItemSeparator, 1103
KeepConection, 1103
KeepConnections, 1103
KeyExclusive, 1104
KeyField, 1104
KeyFieldCount, 1104
KeyPreview, 1104
KeyValue, 1105
KeyViolCount, 1105
KeyViolTableName, 1105
Kind, 1106
LargeChange, 1107
LargeImages, 1107
NDICE REMISSIVO
LastPage, 1107
Layout, 1108
Left, 1108
LeftAxis, 1109
LeftCol, 1109
LeftMarginInches, 1109
LeftMarginMM, 1109
Length, 1110
Level, 1110
Lines, 1110
LinkBand, 1111
List, 1111
ListField, 1111
ListSource, 1112
Local, 1112
Locale, 1112
LocalIP, 1112
Locked, 1113
LoginPrompt, 1113
LookupDisplay, 1113
LookupField, 1114
LookupSource, 1114
MainForm, 1114
Mappings, 1115
Margin, 1115
MarginBotton, 1116
MarginLeft, 1116
MarginRight, 1116
MarginTop, 1116
Mask, 1117
Masked, 1117
Master, 1117
MasterFields, 1118
MasterSource, 1118
Max, 1118
MaxCells, 1118
MaxFontSize, 1119
MaxLength, 1119
MaxPage, 1119
MaxSummaries, 1120
MaxValue, 1120
MDIChildCount, 1120
MDIChildren, 1121
Menu, 1121
Message, 302, 1121
Metafile, 1122
Min, 1122
MinFontSize, 1122
MinPage, 1123
MinValue, 1123
ModalResult, 1123
Mode, 1124
Modified, 1126
Modifiers, 1126
ModifySQL, 1127
Monochrome, 1127
MovedCount, 1127
Multiline, 1128
MultiSelect, 1128
Name, 1128
NameList, 1129
NetFileDir, 1129
Notify, 1129
NotifyValue, 1130
NumGlyphs, 1130
ObjClass, 1131
ObjDoc, 1131
Objects, 1131
ObjItem, 1131
OEMConvert, 1132
Open, 1132
Operation, 1132
Options, 1133
Orientation, 1139
OriginalException, 1140
OutlineStyle, 1141
Overload, 1141
Owner, 1142
PageCount, 1142
PageHeight, 1142
PageIndex, 1143
PageNumber, 1143
Pages, 1144
PageSize, 1144
PageWidth, 1144
Palette, 1145
PanelBorder, 1145
PanelCount, 1145
PanelHeight, 1146
PanelIndex, 1146
Panels, 1146
PanelWidth, 1146
Paragraph, 1147
ParamBindMode, 1147
ParamCheck, 1147
ParamCount, 1148
Parameters, 1148
Params, 1148
Parent, 1149
ParentChart, 1149
ParentColor, 1149
ParentCtl3D, 1150
ParentFont, 1150
ParentShowHint, 1151
PasswordChar, 1151
Pen, 1152
PenPos, 1152
Picture, 1152
PictureClosed, 1152
PictureLeaf, 1153
PictureMinus, 1153
PictureOpen, 1154
PicturePlus, 1154
Pixels, 1154
PixelsPerInch, 1155
PlainText, 1155
PopupComponent, 1155
PopupMenu, 1156
Port, 1156
Position, 1156
PostMessage, 1157
Precision, 1158
Prepared, 1158
PreviousError, 1158
PrintBefore, 1158
PrinterIndex, 1159
PrinterOK, 1159
Printers, 1159
Printing, 1159
PrintMask, 1160
PrintRange, 1160
PrintScale, 1160
PrintToFile, 1161
PrivateDir, 1161
ProblemCount, 1162
ProblemTableName, 1162
ProcedureName, 1162
ProjectFile, 1163
Provider, 1163
ProviderName, 1163
QDelete, 1163
QInsert, 1164
QModify, 1164
QRefresh, 1164
QSelect, 1164
Query, 1165
Queued, 1165
RDSConnection, 1166
ReadOnly, 1165
RecNo, 1166
RecordCount, 1166
RecordSize, 1196
RefreshSQL, 1167
Registered, 1167
RemoteServer, 1167
Repetitions, 1167
ReplaceText, 1168
ReportTitle, 1168
ReportType, 1168
RequestURL, 1169
Required, 1169
ResetGroup, 1169
ResHandle, 1169
ResId, 1170
ResName, 1170
RestartData, 1170
RightAxis, 1170
Row, 1171
RowCount, 1171
RowHeights, 1172
Rows, 1172
RowsAffected, 1172
Ruler, 1173
Scaled, 1173
ScrollBars, 1173
ScrollPos, 1174
Sections, 1174
SectionWidth, 1175
SelCount, 1175
Selected, 1176
SelectedColor, 1176
SelectedField, 1176
SelectedIndex, 1176
Selection, 1177
SelectSQL, 1178
SelEnd, 1178
SelLength, 1178
SelStart, 1179
SelText, 1179
Series, 1179
SeriesColor, 1180
ServerConv, 1180
ServiceApplication, 1180
Shape, 1181
Sharable, 1182
ShareImages, 1182
ShareInLegend, 1185
ShortCurt, 1182
ShowAccelChar, 1183
ShowButtons, 1183
ShowFocus, 1184
ShowHint, 1184
Showing, 1184
ShowLines, 1185
ShowProgress, 1185
ShowRoot, 1186
SimplePanel, 1186
SimpleText, 1186
Size, 1187
SmallChange, 1187
SmallImages, 1187
Sorted, 1187
SortType, 1188
Source, 1188
Spacing, 1189
SparseCols, 1189
SparseRows, 1190
SQL, 1190
SQLCompatible, 1190
SQLConnection, 1191
SQLDialect, 1191
SQLObjectCount, 1191
SQLObjects, 1191
Start, 1192
StartFrame, 1192
StartMargin, 1192
StartPos, 1192
State, 1193
StateImages, 1194
Status, 1194
Step, 1195
StmtHandle, 1195
StopFrame, 1195
Storage, 1195
StoredDefs, 1196
StoredProcName, 1196
Stretch, 1196
Strings, 1197
Style, 1197
Suspended, 1200
TabHeight, 1200
TabIndex, 1201
Table, 1201
TableDirect, 1201
TableLevel, 1201
TableName, 1201
TableType, 1202
TabOrder, 1202
Tabs, 1203
TabsPerRow, 1203
TabStop, 1203
TabStops, 1204
TabWidth, 1204
Tag, 1204
Temporary , 1205
Terminated, 1205
Text, 1205
TextAlign, 1206
TextCase, 1207
ThreadID, 1207
TickMarks, 1207
TickStyle, 1208
TileMode, 1208
TimeFormat, 1209
Timers, 1209
Title, 1209
TitleBeforeHeader, 1210
TitleFont, 1210
Top, 1211
ToPage, 1211
TopAxis, 1211
TopIndex, 1212
TopItem, 1212
TopRow, 1212
TraceFlags, 1213
TrackLength, 1213
TrackPosition, 1213
Tracks, 1214
TransactionCount, 1214
Transactions, 1214
Transisolation, 1214
Transliterate, 1215
Transparent, 1215
Unidirecional, 1215
UnSelectedColor, 1216
UpdatedMode, 1216
UseCompression, 1217
Value, 1217
ValueChecked, 1218
Values, 1218
ValueUnChecked, 1219
VertScrollBar, 1220
ViewOrigin, 1220
ViewStyle, 1220
Visible, 1221
VisibleButtons, 1221
VisibleColCount, 1223
VisibleRowCount, 1223
VisibleTabs, 1224
Wait, 1224
WantReturns, 1224
WantTabs, 1225
Width, 1225
WindowMenu, 1225
WindowState, 1226
WordWrap, 1226
Wrap, 1227
WSAInfo, 1227
Zoom, 1227
Propriedades, definio de, 16
Provider, Propriedade, 1163
ProviderName, Propriedade,
1163
Push, Mtodo, 1308
Q
QDelete, Propriedade, 1163
QInsert, Propriedade, 1164
QModify, Propriedade, 1164
QRefresh, Propriedade, 1164
QSelect, Propriedade, 1164
Query, Propriedade, 1165
QueryTableProducer
Componente, 788
Queued, Propriedade, 1165
QueueEvents, Mtodo, 1308
QuotedStr, funo, 667
R
RAD, ferramentas, 4
RadToCicle, funo, 826
RadToDeg, funo, 827
RadToGrad, funo, 827
RandG, funo, 827
Rave Reports, 236
Rave Reports, ambiente de
desenvolvimento, 237
RDSConnection,
Propriedade, 1166
Read, Mtodo, 1309
ReadBool, Mtodo, 1309
ReadInteger, Mtodo, 1309
ReadOnly, Propriedade, 1165
ReadSection, Mtodo, 1309
ReadSectionValues, Mtodo,
1309
ReadString, Mtodo, 1310
Realign, Mtodo, 1310
RecNo, Propriedade, 1166
RecordCount, Propriedade,
1166
RecordSize, Propriedade, 1196
Rectangle, Mtodo, 1310
Refresh, Mtodo, 1310
RefreshSQL, Propriedade, 1167
RegisterChanges, Mtodo,
1311
Registered, Propriedade, 1167
RegisterEvents, Mtodo, 1311
Relacionais, operadores, 56
Relatrios, criao de, 236
Release, Mtodo, 1311
ReleaseHandle, Mtodo, 1311
ReleasePalette, Mtodo, 1311
RemoteServer, Propriedade,
1167
Remove, Mtodo, 1312
RemoveAllPassword, Mtodo,
1312
RemoveAllSeries, Mtodo, 1312
RemoveComponent,
Mtodo, 1312
RemoveDatabase, Mtodo,
1313
RemoveDatabases, Mtodo,
1313
RemoveDir, funo, 662
RemovePassword, Mtodo,
1313
RemoveSeries, Mtodo, 1313
RemoveTransaction, Mtodo,
1314
RenameFile, Mtodo, 662
Repaint, Mtodo, 1314
Repetitions, Propriedade,
1167
ReplaceIcon, Mtodo, 1314
ReplaceMasked, Mtodo,
1314
ReplaceText, Propriedade,
1168
ReportTitle, Propriedade, 1168
ReportType, Propriedade, 1168
RequestData, Mtodo, 1315
RequestURL, Propriedade,
1169
Required, Propriedade, 1169
Reset, Mtodo, 1315
ResetGroup, Propriedade,
1169
ResHandle, Propriedade,
1169
ResId, Propriedade, 1170
ResName, Propriedade, 1170
ResourceLoad, Mtodo, 1315
RestartData, Propriedade,
1170
Restore, Mtodo, 1315
RestoreTopMosts, Mtodo,
1316
Rewind, Mtodo, 1316
RightAxis, Propriedade, 1170
RmDir, funo, 662
Rollback, Mtodo, 1317
RollBackRetaining, Mtodo,
1317
RoundRect, Mtodo, 1317
Row, Propriedade, 1171
RowCount, Propriedade,
1171
RowHeights, Propriedade,
1172
Rows, Propriedade, 1172
RowsAffected, Propriedade,
1172
Ruler, Propriedade, 1173
Run, Mtodo, 1317
RvProject, componente, 236
S
Save, Mtodo, 1317
SaveToBitmapFile, Mtodo,
1318
SaveToFile, Mtodo, 170,
1318
SaveToMetaFile, Mtodo,
1318
SaveToMetaFileEnh,
Mtodo,1319
SaveToStream, Mtodo, 1319
ScaleBy, Mtodo,1319
Scaled, Propriedade, 1173
ScreenToClient, Mtodo,
1319
ScrollBars, Propriedade, 1173
ScrollBy, Mtodo, 1320
ScrollInView, Mtodo, 1320
ScrollPos, Propriedade, 1174
Sections, Propriedade, 1174
SectionWidth, Propriedade,
1175
Seek, Mtodo, 1321
SelCount, Propriedade, 1175
SelectAll, Mtodo, 1321
Selected, Propriedade, 1176
SelectedColor, Propriedade,
1176
SelectedField, Propriedade,
1176
SelectedIndex, Propriedade,
1176
Selection, Propriedade, 1177
SelectNext, Mtodo, 1321
SelectNextPage, Mtodo,
1322
SelectSQL, Propriedade, 1178
SelEnd, Propriedade, 1178
Self, identificador, 296
SelLength, Propriedade, 1178
SelStart, Propriedade, 1179
SelText, Propriedade, 1179
SendToBack, Mtodo, 1322
Series, Propriedade, 1179
SeriesColor, Propriedade,
1180
SeriesCount, Mtodo, 1322
Server Login, caixa de
dilogo, 131
ServerConv, Propriedade, 1180
ServiceApplication,
Propriedade, 1180
SetAsHandle, Mtodo, 1322
SetBounds, Mtodo, 1323
SetComponent, Mtodo,
1323
SetCurrentDir, funo, 662
SetData, Mtodo, 1323
SetFields, Mtodo, 1323
SetFocus, Mtodo, 1324
SetKey, Mtodo, 1324
SetLength, funo, 667
SetLink, Mtodo, 1324
SetParams, Mtodo, 1324
SetPrincipal, Mtodo, 1324
SetPrinter, Mtodo, 1325
SetRange, Mtodo, 1325
SetRangeEnd, Mtodo, 1325
SetRangeStart, Mtodo, 1325
SetSelTextBuf, Mtodo, 1326
SetString, funo, 667
SetTabFocus, Mtodo, 1326
SetText, Mtodo, 1326
SetTextBuf, Mtodo, 1326
SetUpdateState, Mtodo, 1327
SetWindowExtEx, funo, 632
Shape, componente, 343
Shape, Propriedade, 1181
Sharable, Propriedade, 1182
ShareImages, Propriedade,
1182
ShareInLegend, Propriedade,
1185
ShortCurt, Propriedade, 1182
Show, Mtodo, 1327
ShowAccelChar, Propriedade,
1183
ShowButtons, Propriedade,
1183
ShowColumnHeaders,
Propriedade, 1183
ShowCubeDialog, Mtodo,
1327
ShowDragImage, Mtodo,
1328
NDICE REMISSIVO
ShowException, Mtodo,
1328
ShowFocus, Propriedade, 1184
ShowHint, Propriedade, 1184
Showing, Propriedade, 1184
ShowLines, Propriedade, 1185
ShowMessage, procedimento,
60
ShowModal, Mtodo, 1328
ShowProgress, Propriedade,
1185
ShowRoot, Propriedade, 1186
SimplePanel, Propriedade,
1186
SimpleText, Propriedade,
1186
Sin, funo, 827
SinCos, funo, 827
SinH, funo, 827
Size, Propriedade, 1187
SmallChange, Propriedade,
1187
Sorted, Propriedade, 1187
SortType, Propriedade, 1188
Source, Propriedade, 1188
Spacing, Propriedade, 1189
SparseCols, Propriedade,
1189
SparseRows, Propriedade,
1190
SQL, linguagem, 216
SQL, Propriedade, 1190
SQLCompatible, Propriedade,
1190
SQLConnection,
Propriedade, 1191
SQLDialect, Propriedade,
1191
SQLObjectCount,
Propriedade, 1191
SQLObjects, Propriedade,
1191
Start, Propriedade, 1192
StartFrame, Propriedade,
1192
StartMargin, Propriedade, 1192
StartPos, Propriedade, 1192
StartRecording, Mtodo, 1329
StartTransaction, Mtodo,
1329
State, Propriedade, 1193
StateImages, Propriedade,
1194
Status, Propriedade, 1194
StdDev, funo, 827
Step, Mtodo, 1329
Step, Propriedade, 1195
StmtHandle, Propriedade, 1195
Stop, Mtodo, 1329
StopFrame, Propriedade,
1195
Storage, Propriedade, 1195
Stored Procedures, definio
de, 586
StoredDefs, Propriedade, 1196
StoredProcName,
Propriedade, 1196
Str, funo, 668
StrAlloc, funo, 672
StrBufSize, funo, 672
StrCat, funo, 672
StrComp, funo, 673
StrCopy, funo, 673
StrEnd, funo, 673
Stretch, Propriedade, 1196
StretchDraw, Mtodo, 1330
StringOfChar, funo, 668
StringReplace, funo, 668
Strings de auxlio,
parametrizao de, 738
Strings, manipulao de, 662
Strings, Propriedade, 1197
StrLCat, funo, 674
StrLComp, funo, 674
StrLCopy, funo, 674
StrLen, funo, 674
StrLIComp, funo, 674
StrLower, funo, 674
StrMove, funo, 675
StrNew, funo, 675
StrPCopy, funo, 675
StrRScan, funo, 675
StrScan, funo, 675
StrToCurr, funo, 668
StrToDate, funo, 668
StrToFloat, funo, 669
StrToInt, funo, 669
StrToIntDef, funo, 669
StrToTime, funo, 669
StrUpper, funo, 675
Style, Propriedade, 1197
SubPropriedades, 86
Sum, funo, 828
SumAndSquares, funo, 828
SumInt, funo, 828
SumOfSquares, funo, 828
Suspend, Mtodo, 1330
Suspended, Propriedade, 1200
Synchronize, Mtodo, 1330
T
Tabelas,
criao de, 130, 463
definindo campos de
preenchimento obrigatrio
de, 141
definindo chaves primrias
de, 184, 438
definindo ndices de, 141
definindo nomes de
campos de, 136
definindo tamanhos de
campos de, 139
definindo tipos de campos
de, 138
TabHeight, Propriedade, 1200
TabIndex, Propriedade, 1201
Table, Propriedade, 1201
TableDirect, Propriedade,
1201
TableLevel, Propriedade, 1201
TableName, Propriedade, 1201
TableType, Propriedade, 1202
TabOrder, Propriedade, 1202
Tabs, Propriedade, 1203
TabsPerRow, Propriedade,
1203
TabStop, Propriedade, 1203
TabStops, Propriedade, 1204
TabWidth, Propriedade, 1204
TAction, Classe, 858
TActionList, Classe, 858
TADOCommand, Classe,
525, 859
principais Mtodos, 526
principais Propriedades,
525
TADOConnection, Classe,
512, 859
principais Eventos, 516
512
TADODataSet, Classe, 527,
860
TADODataset, Classe,
TADODataset, Classe,
527
TADOQuery, Classe, 530, 860
530
TADOStoredProc, Classe, 861
TADOTable, Classe, 529, 862
529
Tag, Propriedade, 1204
Tan, funo, 828
Tanh, funo, 828
TAnimate, Classe, 863
TApplication, Classe, 863
TApplicationEvents, Classe,
863
TAutoIncField, Classe, 864
TBaseReport, Classe, 864
TBatchMove, Classe, 865
TBCDField, Classe, 865
TBDEDataset, Classe, 416
TBevel, Classe, 866
TBitBtn, Classe, 866
TBitmap, Classe, 626, 866
TBlobField, Classe, 867
TBlobStream, Classe, 867
TBooleanField, Classe, 868
TBrush, Classe, 868
TButton, Classe, 868
TBytesField, Classe, 869
TCanvas, Classe, 335
TChart, Classe, 870
TChartSeries, Classe, 871
TCheckBox, Classe, 871
TClientDataSet, Classe, 872
TClientSocket, Classe, 873
TClipboard, Classe, 873
TColorDialog, Classe, 873
TComboBox, Classe, 874
TComponent, Classe, 874
TControlScrollBar, Classe,
875
TCorbaConnection, Classe,
875
TCorbaDatamodule, Classe,
729
TCurrencyField, Classe, 875
TCustomADODataSet,
Classe, 518, 876
TCustomConnection, Classe,
411
TCustomSQLDataset, Classe,
543
TDataBase, Classe, 419, 876
TDataSet, Classe, 395
TDataSetPageProducer,
Classe, 877
TDataSetProvider, Classe, 877
TDataSetTableProducer,
Classe, 877
TDataSource, Classe, 878
TDateField, Classe, 878
TDateTime, tipo, 742
TDateTimeField, Classe, 878
TDBChart, Classe, 879
TDBCheckBox, Classe, 879
TDBComboBox, Classe, 880
TDBCtrlGrid, Classe, 880
TDBDataset, Classe, 418
TDBEdit, Classe, 881
TDBGrid, Classe, 881
TDBImage, Classe, 882
TDBListBox, Classe, 882
TDBLookupComboBox,
Classe, 883
TDBLookupListBox, Classe,
883
TDBMemo, Classe, 884
TDBMemoBuf, Classe, 884
TDBNavigator, Classe, 885
TDBRadioGroup, Classe, 885
TDBRichEdit, Classe, 886
TDBText, Classe, 886
TDCOMConnection, Classe,
887
TDDEClientConv, Classe, 887
TDDEClientItem, Classe, 887
TDDEServerConv, Classe, 888
TDDEServerItem, Classe, 888
TDecisionCube, Classe, 888
TDecisionGraph, Classe, 888
TDecisionGrid, Classe, 889
TDecisionPivot, Classe, 890
TDecisionQuery, Classe, 890
TDecisionSource, Classe, 890
TDirectoryListBox, Classe, 891
TDrawGrid, Classe, 891
TDriveComboBox, Classe, 892
TEdit, Classe, 892
Template de formulrios,
definio, 210
Temporary, Propriedade, 1205
Terminate, Mtodo, 1330
Terminated, Propriedade, 1205
TestConnected, Mtodo, 1331
Testes condicionais, 56
Text, Propriedade, 1205
TextAlign, Propriedade, 1206
TextCase, Propriedade, 1207
TextHeight, Mtodo, 1331
TextOut, Mtodo, 1331
TextRect, Mtodo, 1331
TextWidth, Mtodo, 1331
TField, Classe, 893
TFieldDef, Classe, 893
TFileListBox, Classe, 893
TFilterComboBox, Classe, 894
TFindDialog, Classe, 894
TFloatField, Classe, 895
TFont, Classe, 895
TFontDialog, Classe, 895
TForm, Classe, 68, 896
TGraphic, Classe, 896
TGraphicsField, Classe, 897
TGroupBox, Classe, 897
THeader, Classe, 897
THeaderControl, Classe, 898
THotKey, Classe, 898
ThreadID, Propriedade, 1207
Threads, conceito de, 706
THTTPFile, Classe, 907
TIBClientDataSet, Classe, 899
TIBCustomDataSet, Classe,
558
principais Propriedades, 559
TIBDatabaseInfo, Classe, 900
TIBDataSet, Classe, 561, 901
TIBEvents, Classe, 901
TIBQuery, Classe, 567, 902
TIBSQL, Classe, 902
TIBSQLMonitor, Classe, 903
TIBStoredProc, Classe,
TIBStoredProc, Classe, 903
TIBTable, Classe, 563, 904
TIBTransaction, Classe, 558,
905
TIBUpdateSQL, Classe, 568,
905
TickMarks, Propriedade, 1207
TickStyle, Propriedade, 1208
TIcon, Classe, 905
Tile, Mtodo, 1332
TileMode, Propriedade, 1208
TImage, Classe, 906
TImageList, Classe, 906
TimeFormat, Propriedade,
1209
Timers, Propriedade, 1209
TimeToStr, funo, 669
TIniFile, Classe, 907
TIntegerField, Classe, 907
Tipos de dados enumerados,
47
Tipos ordinais, 52
Tipos, converso de, 294
Title, Propriedade, 1209
TitleBeforeHeader,
Propriedade, 1210
TitleFont, Propriedade, 1210
Ttulos, barra de, 11
TIWAppForm, Classe, 908
TIWApplet, Classe, 908
TIWApplication, Classe, 908
TIWButton, Classe, 909
TIWCheckBox, Classe, 909
TIWComboBox, Classe, 910
TIWControl, Classe, 910
TIWDBCheckBox, Classe, 910
TIWDBComboBox, Classe, 911
TIWDBEdit, Classe, 911
TIWDBFile, Classe, 911
TIWDBGrid, Classe, 912
TIWDBImage, Classe, 912
TIWDBListBox, Classe, 913
TIWDBLookupComboBox,
Classe, 913
TIWDBLookupListBox,
Classe, 913
TIWDBMemo, Classe, 914
TIWDBNavigator, Classe, 914
TIWDBText, Classe, 915
TIWEdit, Classe, 915
TIWFile, Classe, 915
TIWForm, Classe, 916
TIWGrid, Classe, 916
TIWImage, Classe, 917
TIWImageFile, Classe, 917
TIWLabel, Classe, 917
TIWLink, Classe, 918
TIWList, Classe, 918
TIWListBox, Classe, 918
TIWMemo, Classe, 919
TIWRectangle, Classe, 919
TIWRegion, Classe, 920
TIWTimer, Classe, 920
TIWTreeView, Classe, 920
TIWURL, Classe, 921
TLabel, Classe, 921
TList, Classe, 305, 921
TListBox, Classe, 922
TListView, Classe, 922
TMaskEdit, Classe, 923
TMediaPlayer, Classe, 924
TMemo, Classe, 924
TMemoBuf, Classe, 925
TMemoField, Classe, 925
TMenuItem, Classe, 925
TMetafile, Classe, 926
TMIDASConnection, Classe,
926
TMIDASPageProducer, Classe,
926
TMTSDatamodule, Classe,
729
TNMDayTime, Classe, 927
TNMEcho, Classe, 927
TNMFinger, Classe, 927
TNMFTP, Classe, 928
TNMHTTP, Classe, 928
TNMMSG, Classe, 928
TNMMSGServ, Classe, 929
TNMNNTP, Classe, 929
TNMPOP3, Classe, 929
TNMSMTP, Classe, 930
TNMSTRM, Classe, 930
TNMSTRMServ, Classe, 931
TNMTime, Classe, 931
TNMUDP, Classe, 931
TNMURL, Classe, 932
TNMUUProcessor, Classe, 930
Tnotebook, Classe, 932
TObject, Classe, Classe,
Classe, 287
TODO Lists,
adicionando um item a
uma, 77, 80
conceito, 77
copiando a relao de itens
de uma, 81
editando um item de
uma, 78
excluindo um item de
uma, 79
filtrando itens de uma, 81
TOLEContainer, Classe, 933
Top, Propriedade, 1211
ToPage, Propriedade, 1211
TopAxis, Propriedade, 1211
TOpenDialog, Classe, 933
TOpenPictureDialog, Classe,
933
TopIndex, Propriedade, 1212
TopItem, Propriedade, 1212
TopRow, Propriedade, 1212
TOutline, Classe, 934
TOutlineNode, Classe, 934
TPageControl, Classe, 935
TPageProducer, Classe, 935
TPaintBox, Classe, 935
TPanel, Classe, 936
TPen, Classe, 341, 936
TPicture, Classe, 937
TPopupMenu, Classe, 937
TPrintDialog, Classe, 937
TPrinter, Classe, 637, 938
TPrinterSetupDialog, Classe,
938
TProgressBar, Classe, 939
TProvider, Classe, 939
TQRDBText, Classe, 939
TQRLabel, Classe, 940
TQRMemo, Classe, 940
TQRPreview, Classe, 940
TQRPrinter, Classe, 941
TQRShape, Classe, 941
TQRSysData, Classe, 941
TQuery, Classe, 434, 942
TQueryTableProducer, Classe,
942
TQueue, Classe, 942
TQuickRep, Classe, 943
TraceFlags, Propriedade, 1213
TrackLength, Propriedade,
1213
TrackPosition, Propriedade,
1213
Tracks, Propriedade, 1214
TRadioButton, Classe, 943
TRadioGroup, Classe, 944
Traduo, ambiente
integrado de, 758
Transaes, conceito de, 583
TransactionCount,
Propriedade, 1214
Transactions, Propriedade,
1214
Transisolation, Propriedade,
1214
Translation Repository, 766
Transliterate, Propriedade,
1215
Transparent, Propriedade,
1215
TRDSConnection, Classe,
517, 944
TRegistry, Classe, 945
TRegistryIniFile, Classe, 945
TRemoteServer, Classe, 945
TReplaceDialog, Classe, 946
TRichEdit, Classe, 946
Triggers, definio de, 585
Triggers, tipos de, 585
Trim, funo, 669
TrimLeft, funo, 669
TrimRight, funo, 670
TRpBarsBase, Classe, 946
TRpBaseComponent, Classe,
947
TRpComponent, Classe, 947
TRpRender, Classe, 948
TRpRenderCanvas, Classe,
948
TRpRenderStream, Classe,
948
Truncate, Mtodo, 1332
TRvCustomConnection,
Classe, 949
TRvDatsetConnection,
Classe, 949
TRvNDRWriter, Classe, 949
TRvProject, Classe, 950
TRvQueryConnection,
Classe, 954
TRvRenderHTML, Classe, 951
TRvRenderPDF, Classe, 951
TRvRenderPreview, Classe,
951
TRvRenderPrinter, Classe,
952
TRvRenderRTF, Classe, 953
TRvRenderText, Classe, 954
NDICE REMISSIVO
TRvSystem, Classe, 954
TRvTableConnection, Classe,
955
TSaveDialog, Classe, 955
TSavePictureDialog, Classe,
955
TScreen, Classe, 956
TScrollBar, Classe, 956
TScrollBox, Classe, 957
TServerSocket, Classe, 957
TSession, Classe, 422, 958
TShape, Classe, 958
TSimpleDataset, Classe, 548
TSimpleObjectBroker, Classe,
959
TSmallIntField, Classe, 960
TSocketConnecttion, Classe,
960
TSpeedButton, Classe, 960
TSQLConnection, Classe,
540, 961
TSQLDataSet, Classe, 544, 961
TSQLDataSet Classe,
TSQLMonitor, Classe, 962
TSQLQuery Classe, 547, 962
TSQLStoredProc, Classe, 605,
963
TSQLTable Classe, 546, 964
TSQLTable, componente, 154
TStack, Classe, 964
TStatusBar, Classe, 965
TStoredProc, Classe, 595, 965
TStringField, Classe, 966
TStringGrid, Classe, 966
TStringList, Classe, 966
TStrings, Classe, 967
TTabbedNotebook, Classe, 967
TTabControl, Classe, 968
TTable, Classe, 428, 968
TTabSet, Classe, 969
TTabSheet, 969
TThread, Classe, 708, 970
TTimeField, Classe, 970
TTimer, Classe, 970
TToolBar, Classe, 971
TTrackBar, Classe, 971
TTreeView, Classe, 972
TUpdateSQL, Classe, 437,
500, 972
TUpDown, Classe, 973
TVarBytesField, Classe, 973
TWebDispatcher, Classe, 974
TWordField, Classe, 974
TXMLBroker, Classe, 974
U
Unidade de cdigo, 40
estrutura de uma, 40
sees de, 41
Unidirecional, Propriedade,
1215
UnlockTable, Mtodo, 1332
UnMerge, Mtodo, 1332
UnPrepare, Mtodo, 1333
UnRegisterChanges, Mtodo,
1333
UnRegisterEvents, Mtodo,
1333
UnSelectedColor,
Propriedade, 1216
Update, Mtodo, 1333
UpdateCursrPos, Mtodo, 1334
UpdatedMode, Propriedade,
1216
UpdateRecord, Mtodo, 1334
Uppercase, funo, 670
UseCompression,
Propriedade, 1217
V
Val, funo, 670
ValidateEdit, Mtodo, 1334
Value List Editor, caixa de
dilogo, 1
Value, Propriedade, 1217
ValueChecked, Propriedade,
1218
Values, Propriedade, 1218
ValueUnChecked,
Propriedade, 1219
Variance, funo, 828
Variveis,
atribuio de valor a, 43
booleanas, 44
compostas, 49
conceito de, 43
declarao de, 42
escopo, 52
globais, 53
inteiras, 43
locais, 52
para manipulao de
arquivos, 45
para manipulao de
caracteres, 44
reais, 44
tipo genrico de, 46
tipos de, 43
VertScrollBar, Propriedade,
1220
Vetores, 49
ViewOrigin, Propriedade,
1220
ViewStyle, Propriedade, 1220
Visible, Propriedade, 1221
VisibleButtons, Propriedade,
1221
VisibleColCount,
Propriedade, 1223
VisibleRowCount,
Propriedade, 1223
VisibleTabs, Propriedade,
1224
Vises, 582
W
Wait, Propriedade, 1224
WantReturns, Propriedade,
1224
WantTabs, Propriedade, 1225
WebModule, criao de, 772
WebSnap, Tecnologia, 791
Width, Propriedade, 1225
WindowMenu, Propriedade,
1225
WindowState, Propriedade,
1226
WordWrap, Propriedade,
1226
Wrap, Propriedade, 1227
WrapText, funo, 670
Write, Mtodo, 1334
WriteBCDData, Mtodo,
1335
WriteBlobData, Mtodo,
1335
WriteBool, Mtodo, 1335
WriteBoolData, Mtodo,
1335
WriteCurrData, Mtodo,
1335
WriteDateTime, Mtodo,
1336
WriteFloatData, Mtodo,
1336
WriteIntData, Mtodo, 1336
WriteInteger, Mtodo, 1366
WriteNullData, Mtodo, 1336
WriteStrData, Mtodo, 1337
WriteString, Mtodo, 1337
WSAInfo, Propriedade, 1227
Z
Zoom, Propriedade, 1227
ZoomToFit, Mtodo, 1337
ZoomToWidth, Mtodo,
1337

Delphi - 7 - Curso - Completo - Blog - Conhecimentovaleouro - Blogspot.com by @viniciusf666

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Delphi - 7 - Curso - Completo - Blog - Conhecimentovaleouro - Blogspot.com by @viniciusf666

Enviado por

Direitos autorais:

Formatos disponíveis

CURSO COMPLETO

Você também pode gostar