Beruflich Dokumente
Kultur Dokumente
Copyright 1998
Lcia M. A Fernandes
Gerente de Treinamento
i
Developer/2000 - Forms 4.5
i
Developer/2000 - Forms 4.5
ii
Developer/2000 - Forms 4.5
iii
Developer/2000 - Forms 4.5
EDITOR ............................................................................................................................. 132
CRIANDO UM EDITOR ESPECFICO......................................................................... 132
PROPRIEDADES DOS EDITORES............................................................................... 133
MODIFICANDO A POSIO DE APRESENTAO DE UM EDITOR ...................... 134
USANDO UM EDITOR DO SISTEMA .......................................................................... 134
LISTA DE VALORES (LOVS)......................................................................................... 135
CRIANDO UMA LOV..................................................................................................... 136
PROPRIEDADES DE UMA LOV................................................................................... 137
MAPEANDO AS COLUNAS A SEREM APRESENTADAS............................................ 139
ASSOCIAO DA LOV A UM ITEM............................................................................. 139
CONTROLANDO A APRESENTAO DE UMA LOV ................................................. 140
RECORD GROUPS ........................................................................................................... 141
CRIANDO RECORD GROUPS...................................................................................... 142
PROPRIEDADES DE UM RECORD GROUP .............................................................. 143
CONTROLANDO O PREENCHIMENTO DE UM RECORD GROUP ......................... 144
VISUAL ATTRIBUTE ...................................................................................................... 146
PROPRIEDADES DOS ATRIBUTOS VISUAIS ............................................................. 147
CLASSE DE PROPRIEDADES ........................................................................................ 148
CRIANDO UMA CLASSE .............................................................................................. 149
CAPTULO 6 : USO DE ROTINAS NO FORMS ............................................................ 151
FALANDO DE PL/SQL .................................................................................................... 151
CRIANDO UMA PROGRAM UNIT ................................................................................ 152
IDENTIFICADORES NO ORACLE FORMS .................................................................. 153
USANDO O NOME DO OBJETO.................................................................................. 154
USANDO O ID DO OBJETO......................................................................................... 154
STORED PROCEDURES E DATABASE TRIGGERS ................................................... 155
PARMETROS ................................................................................................................. 157
CRIANDO PARMETROS............................................................................................. 157
PROPRIEDADES DOS PARMETROS ........................................................................ 157
USANDO OS PARMETROS NO FORMS.................................................................... 158
OBTENDO O VALOR DOS PARMETROS.................................................................. 158
CAPTULO 7 : CARACTERSTICAS GERAIS.............................................................. 159
PROPRIEDADES DO FORM ........................................................................................... 160
O DILOGO COORDINATE INFO............................................................................... 163
OPTIONS ........................................................................................................................... 165
DESIGNER OPTIONS.................................................................................................... 165
RUNTIME OPTIONS ..................................................................................................... 168
iv
Developer/2000 - Forms 4.5
v
Developer/2000 - Forms 4.5
vi
Developer/2000 - Forms 4.5
MDULOS
Quando desenhamos uma aplicao no Designer, na verdade trabalhamos com
componentes do aplicativo, chamados mdulos, os quais se dividem nos seguintes
tipos:
HIERARQUIA FUNCIONAL
HIERARQUIA VISUAL
FORM MODULE
WINDOW
ITENS
CANVAS
ITENS
FORM
O Form a aplicao principal, em sua estrutura definimos todos os objetos e
instrues necessrias a uma aplicao.
MENU
Uma coleo de menus (um menu principal e qualquer nmero de submenus) e
comandos, que juntos criam uma aplicao de menu.
LIBRARY
Uma coleo de procedures, funes e packages criados pelo usurio, que podem ser
chamados dos outros mdulos.
INTEGRAO DE MDULOS
Pode-se efetuar a integrao destes mdulos, conforme necessrio, para construir
uma aplicao completa.
O MDULO ATIVO
Quando abrimos um mdulo (Form, menu ou library), ele torna-se um mdulo ativo
para o Designer e seu nome apresentado na linha de status.
Quando vrios mdulos esto abertos ao mesmo tempo, podemos ativar aquele que
desejamos trabalhar, executando os seguintes passos:
Pode-se, tambm, usar o mdulo Generate para criar arquivo em disco legvel (texto)
que portvel entre plataformas.
OBJETOS E PROPRIEDADES
Quando construmos uma aplicao em Oracle Forms, podemos criar objetos tais
como windows, campos, check boxes e lista de valores.
Cada tipo de objeto possui um conjunto de propriedades, que definem sua aparncia
e funcionalidade. Cada propriedade possui um nome.
A visualizao das propriedades de qualquer objeto do Oracle Forms pode ser feita
facilmente com o uso do boto direito do mouse no Object Navigator.
RECORDS
Um registro uma estrutura de dados que contm uma coleo de itens. Quando um
operador recupera dados em um Form (executa uma consulta por exemplo), cada
registro apresentado proveniente de uma row na tabela.
BLOCOS
Cada item pertence a um objeto chamado bloco. Os blocos tem o objetivo de agrupar
itens relacionados dentro de uma unidade funcional. As propriedades do bloco
determinam como um Forms ir interagir com os itens que o contm.
WINDOWS E CANVAS-VIEWS
Quando definimos as telas de uma aplicao, na verdade trabalhamos com dois tipos
de objetos do Oracle Forms: Windows e Canvas-views.
WINDOWS
Uma window pode ser entendida como um frame (moldura) vazio. Um frame (window)
prov um modo de interao, a tempo de execuo, com o ambiente, incluindo a
habilidade para rolagem, movimentao e redimensionamento da window.
CANVAS-VIEW
A canvas-view o objeto de fundo no qual especificamos os itens (itens de texto,
check boxes, radio groups, e assim por diante) e os boilerplates que o operador v a
tempo de execuo.
Somente itens que tenham sido associados a uma canvas-view podem ser vistos pelo
operador. Por outro lado a canvas-view deve ser apresentada em uma window
especfica.
FORMS
MENUS
LIBRARIES
BUILT-IN PACKAGES
DATABASE OBJECTS
Abrir e Copiar e
Salvar o colar propriedades.
mdulo ativo
Executar e Criar ou
Depurar o excluir objetos.
mdulo ativo
Recortar, Expandir ou contrair uma entrada
Copiar e na hierarquia
Colar objetos
PROPRIEDADES DE UM OBJETO
A Janela de propriedades pode ser chamada invocando o menu Tools -> Properties
ou clicando-se 2 vezes no cone do elemento do Object Navigator.
2. Criar um novo Form ou utilizar o MODULE 1 criado por default pelo Oracle Forms.
4. Criar um bloco do tipo base table. (Os itens sero criados simultaneamente).
5. Usar o editor grfico (Layout) para rearrumar os itens e acrescentar outros, tais
como: buttons e itens no associados tabela bsica.
A incluso do objeto BLOCK pode ser feita atravs do Object Navigator bastando que
selecionemos (click) o n BLOCK e pressionemos a ferramenta CREATE (+) da paleta
de ferramentas do Navigator.
General
Items
Layout
Master Detail
A PASTA GENERAL
Base Table - Nome da tabela ou View do banco de dados no qual o bloco se basear.
Caso no seja informado o bloco ser do tipo CONTROL BLOCK.
Aps o preenchimento do
dilogo anterior, sero
apresentados os objetos que
atendam s especificaes
fornecidas (dilogo ao lado).
Sequence ID - Seqncia de
navegao para o bloco na
CANVAS.
A PASTA ITEMS
Nesta pasta faremos a escolha dos itens que desejamos adicionar a nosso bloco.
A PASTA LAYOUT
Nesta pasta escolheremos o tipo do layout que desejamos seja criado (na canvas)
para os itens deste bloco.
Style - Indica a disposio dos itens a serem desenhados pelo Oracle Forms na
canvas. Pode ser Form (o nome de cada item preceder o espao destino a seu
contedo) ou tabular (os nomes de cada item ficaro acima ou ao lado do conjunto de
registros).
cd_mat
Records - Indica a quantidade de registros
nm_func
que o bloco deve apresentar. O valor default
1. Caso seja informado mais de 1, o bloco vl_sal
ser Multi-Record. nr_ramal
1 2 3
Button Palette - Especifica que o Oracle Forms deve criar um outro bloco contendo
um conjunto de botes de navegao para o base table block.
Scroll Bar - Especifica se o Oracle Forms deve criar uma barra de rolagem para o
bloco. A opo orientation determina se a barra ser vertical ou horizontal.
Master Block - Indica o nome do bloco master ao qual o bloco atual (detail) se
subordinar. O bloco master j deve existir no Form.
Ser apresentada uma tela composta dos itens selecionados, da barra de botes
(button palette), barra de rolagem (scroll bar) e menu.
Neste menu esto presentes todas as aes que podemos realizar no Form gerado,
ou seja, a funcionalidade default criada pelo Oracle Forms.
ACTION
Clear All - limpa (esvazia) todos os itens do(s) bloco(s).
EDIT
Cut/ Copy/Paste - Estas funes se aplicam ao item (campo) que detm o
foco.
BLOCK
Previous/Next - Navega para o prximo bloco ou para o bloco anterior.
FIELD
Previous/Next - Navega para o prximo /anterior campo em relao quele
que detm o foco.
RECORD
Previous/Next - Navega para o prximo/anterior registro do bloco que detm o
foco.
Clear - Faz com que o Oracle Forms retire o registro do bloco. O registro no
removido da tabela.
QUERY
Enter - Limpa todos os registros do bloco corrente e coloca o Form no modo
Enter Query. Se houverem modificaes pendentes para a base de dados
(incluses, excluses ou alteraes), ser apresentado ao operador um dilogo
solicitando que seja feito um commit.
HELP
Help - Esta opo mostra na linha de mensagem o texto Hint do item no qual
est o foco (default) ou o texto de ajuda associado pelo programador.
List - apresentada uma lista de valores (Lov) associada ao item no qual est
o foco.
Devemos criar um bloco antes de criar os itens associados quele bloco. No existe
limite para o nmero de blocos que podem ser definidos em um Form.
Um bloco somente um grupamento lgico. Os itens dentro deste bloco podem ser
colocados em diferentes canvas e podem ser mostrados em janelas diferentes.
CRIANDO BLOCOS
A criao dos blocos pode ser feita com a ferramenta CREATE (+) presente na barra
de ferramentas do Navigator ou com a opo New Block do menu Tools.
EXCLUINDO BLOCOS
Podemos remover um bloco (a tempo de Design) da seguinte forma:
Funcionalidade do Forms - 26
Developer/2000 - Forms 4.5
Os blocos podem ser de 2 tipos:
Por default, o Oracle gera rotinas para consultar, alterar, incluir ou excluir linhas nas
tabelas associadas a este tipo de bloco.
CONTROL BLOCK
Um Control Block um bloco que no est associado a uma tabela do database,
portanto, os itens em um Control Block no esto associados a colunas da base de
dados.
Funcionalidade do Forms - 27
Developer/2000 - Forms 4.5
Funcionalidade do Forms - 28
Developer/2000 - Forms 4.5
DISPLAY
Scroll Bar - indica se o Oracle Forms deve criar uma barra de rolagem para o
bloco. Quando esta propriedade True o Oracle Forms cria a barra na canvas
nomeada na propriedade Scroll Bar Canvas.
Scroll Bar Canvas - indica o nome da canvas na qual desejamos que a barra
seja colocada. A barra separada dos itens do bloco e pode ser apresentada em
qualquer canvas do form. Tanto blocos MULTI-RECORD como SINGLE-RECORD
podem ter uma Scroll Bar.
Funcionalidade do Forms - 29
Developer/2000 - Forms 4.5
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada com
as cores definidas pelos atributos Foreground Color e Background Color.
RECORDS
Records Displayed - determina o nmero mximo de registros que sero
visveis no bloco. O default 1.
Funcionalidade do Forms - 30
Developer/2000 - Forms 4.5
NAVIGATION
Navigational Style - indica como uma operao next item, ou um previous
item processada entre o ltimo item navegvel e o primeiro item navegvel de
um bloco.
Same Record (default) - A operao NEXT ITEM (do ltimo item para o
primeiro) move o foco para o primeiro item navegvel no bloco
conservando o mesmo registro.
Change Record - A operao NEXT ITEM (do ltimo item para o primeiro)
move o foco para o primeiro item navegvel no bloco no prximo registro.
Se o registro atual for o ltimo, o Oracle cria um novo registro.
Funcionalidade do Forms - 31
Developer/2000 - Forms 4.5
DATABASE
Base Table - nome da tabela da base de dados associada ao bloco.
Primary Key - indica que existem itens PK no bloco para os quais o Oracle
Forms deve assegurar valores nicos. Os itens que correspondem s PK devem
ter a propriedade Primary Key setada a nvel de item.
Funcionalidade do Forms - 32
Developer/2000 - Forms 4.5
Update Allowed - indica se haver alterao de rows no bloco (na tabela
correspondente na base de dados).
Key Mode - indica como o Oracle identifica a unicidade das rows (propriedade
especfica para databases non-Oracle). Para databases Oracle mantenha o valor
em Unique (default).
FUNCTIONAL
Direction - especifica a direo de desenvolvimento do objeto (para NLS
applications).
MISCELLANEOUS
In Menu - esta opo, quando setada, permitir que o operador (a tempo de
execuo) selecione uma lista de blocos pressionando a tecla [BLOCK MENU] e
que navegue para qualquer um daqueles da lista. Na lista sero mostrados os
nomes dos blocos, que podero ser substitudos pelo texto descrito na propriedade
Block Description.
Funcionalidade do Forms - 33
Developer/2000 - Forms 4.5
ITENS
Os itens so os objetos que apresentam informaes para os operadores, iniciam
uma ao, armazenam valores, mostram imagens, etc. Tanto podem representar a
interface entre os operadores e a aplicao, quanto ser utilizados como elementos de
trabalho para a aplicao.
TIPOS DE ITENS
BUTTON
Um retngulo com um texto ou um cone
grfico. Os buttons tem o objetivo de
iniciar aes ou executar comandos.
DISPLAY ITEM
Um item read-only cujo valor deve ser
preenchido por programao.
CHECK BOX
Um label com um indicador de estado
que indica o valor corrente (checado ou
no).
IMAGE
Um retngulo com bordas, de qualquer tamanho que mostra imagens armazenadas
no database ou em arquivo.
CHART ITEM
Um retngulo com bordas, de qualquer tamanho que mostra um grfico gerado pelo
Oracle Graphics. Um operador no pode navegar para ou manipular chart itens.
LIST ITEM
Uma lista de opes. Sua funcionalidade pode ser a de uma Pop-list, uma Text-list ou
uma combo box.
RADIO GROUP
um controle que mostra um nmero fixo de opes que so mutuamente exclusivas.
Cada opo representada por um radio button individual.
Funcionalidade do Forms - 34
Developer/2000 - Forms 4.5
USER AREA
Um retngulo com bordas de qualquer tamanho. O display e a funcionalidade de uma
user area controlado por uma user exit escrita em uma 3GL que , ento, linkada ao
Form.
VBX CONTROL
Foram, originalmente, desenvolvidos como extenses ao MS Visual Basic e incluem
itens como sliders, grids, etc.
OLE CONTAINER
OLE (Object Linking and Embedding) prov a capacidade de integrarmos objetos de
muitos programas de aplicao em um nico documento.
Uma OLE server application cria objetos OLE que so embutidos ou ligados a uma
OLE container application, as quais armazenam e mostram objetos OLE.
As aplicaes podem ser OLE server, OLE container ou ambas. O Oracle Forms
uma aplicao OLE container e o Oracle Graphics e o Microsoft Word so exemplos
de aplicaes OLE server.
Funcionalidade do Forms - 35
Developer/2000 - Forms 4.5
Funcionalidade do Forms - 36
Developer/2000 - Forms 4.5
Funcionalidade do Forms - 37
Developer/2000 - Forms 4.5
TEXT ITEM
Name - nome do item.
Class - nome da classe do item.
TYPE
Item Type - Text Item
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se o item ser mostrado na execuo. Default TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Bevel - Indica se o item ter aspecto tridimensional.
Rendered - indica que o item ser mostrado como um rendered object quando
ele no estiver como foco.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Current Record Attribute - indica o nome de um atributo visual usado quando
o item for parte do registro corrente.
Funcionalidade do Forms - 38
Developer/2000 - Forms 4.5
DATA
Mirror item - especifica o nome do item do qual o item corrente derivado.
Esta propriedade sincroniza o valor de ambos os itens uma vez que quando o
operador altera o valor de um deles o outro, automaticamente, se altera tambm.
Como restrio temos que os itens devem estar no mesmo bloco.
Data Type - tipos de valores que o item pode armazenar.
Format Mask - mscara para formatao do item tanto para display quanto
para input. Aplicveis a itens do tipo NUMBER, DATE, TIME e DATETIME.
Funcionalidade do Forms - 39
Developer/2000 - Forms 4.5
MM ms (de 1 a 12)
Mon nome do ms abreviado para 3 letras.
Month nome do ms (9 caracteres)
DD dia (1 a 31)
DY nome do dia (3 letras)
Day nome do dia (9 caracteres)
YYYY, YYY, YY, Y 4, 3, 2 ou 1 caracter do ano.
HH ou HH12 hora do dia (1 a 12)
HH24 hora do dia (0 a 23)
MI minuto (0-59)
SS segundo (0-59)
Copy Value From Item - identifica a origem do valor para popular o item. Em
uma relao master-detail, o Oracle marca esta propriedade automaticamente no
item foreign key no bloco detalhe. Neste caso informado o nome da primary key
do bloco master, cujo valor copiado para o item foreign key quando um registro
criado ou consultado.
Funcionalidade do Forms - 40
Developer/2000 - Forms 4.5
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
NAVIGATION
Enabled - determina se o operador poder usar o mouse para manipular um
item que tenha a propriedade NAVIGABLE setada para OFF. A tabela abaixo
mostra a relao entre ENABLED e NAVIGABLE
Funcionalidade do Forms - 41
Developer/2000 - Forms 4.5
Database
Base Table Item - indica se o item correspondente a uma coluna na base table do
bloco.
Query Only - indica se o item ser exclusivamente para consulta.
Primary Key - deve ser setado para TRUE para todos os itens que
correspondam a PK na base table do bloco.
Insert Allowed - determina se o operador poder modificar o valor do item em
um registro novo.
Query Allowed - indica que o operador poder navegar para o item quando
estiver no modo de ENTER QUERY. Quando um Form est no modo ENTER
QUERY, o Oracle pula todos os campos que tem a propriedade Query Allowed
OFF, mesmo se os itens forem navegveis normalmente.
Query Length - especifica o nmero de caracteres que um operador poder
informar para pesquisa quando o Forms estiver no modo ENTER QUERY.
Case Insensitive Query - se aplica somente a text items e indica que o Oracle
deve tratar letras minsculas e maisculas do mesmo modo quando processar um
query.
Update Allowed - mutuamente exclusivo com UPDATE IF NULL. Especifica
que o valor do item poder ser alterado independente do seu contedo.
Update Only If Null - mutualmente exclusivo com UPDATE ALLOWED.
Especifica que o valor do item somente poder ser alterado se for NULL.
Lock Record - especifica que o Oracle deve tentar lock a row no database que
corresponda ao registro corrente no bloco quando o valor do item for modificado,
seja pelo operador ou por programao.
Funcionalidade do Forms - 42
Developer/2000 - Forms 4.5
FUNCTIONAL
Case Restriction - esta opo aplicvel apenas a valores informados pelo
operador, ou seja, no altera valores lidos da base ou associados pela
programao.
Secure - torna o texto que o operador digita invisvel. Usado para password
protection.
Keep Position - quando esta propriedade TRUE, o Oracle coloca o cursor
no item exatamente onde ele estava na ltima vez que este item recebeu o foco
nesta sesso.
Auto Skip - com esta propriedade TRUE, o foco automaticamente se move
para o prximo item navegvel quando o operador entra ou altera o ltimo caracter
do item (tamanho mximo).
Reading Order - ordem de leitura, que pode ser Default, Left-to-Right ou Right-to-
Left.
Initial Keyboard State - indica o estado inicial do teclado para o item.
Somente vlido para aplicaes NLS.
Vertical Scroll Bar - indica se deve ser criada uma barra de rolagem para o item.
Funcionalidade do Forms - 43
Developer/2000 - Forms 4.5
Miscellaneous
LOV - especifica o nome de um LOV (list of value) a ser associado ao item.
LOV X E Y Position - localizao da apresentao do Lov quando acionado
por este item.
LOV for Validation - indica se os valores apresentados pelo Lov sero os
nicos aceitveis para o item.
Editor - especifica o nome de um editor a ser associado ao item. Para usar o
editor default do sistema deve-se preencher com SYSTEM - EDITOR.
Editor X E Y Position - localizao da apresentao do editor quando
acionado por este item.
Hint - texto a ser apresentado na linha de mensagem quando o operador se
posicionar no item.
Auto Hint - marcando esta propriedade o Oracle mostra o contedo da
propriedade Hint quando o foco passa para o item. Desmarcando-se esta opo o
Oracle mostrar o contedo do Hint quando o operador teclar [HELP] ou
selecionar a opo HELP do menu default enquanto posicionado sobre o item.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 44
Developer/2000 - Forms 4.5
BUTTONS
Name - nome do item.
Class - nome da classe do item.
TYPE
Item Type Button
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.).
Font Width - largura da fonte (Normal, Expand, Dense, etc.).
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.).
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background).
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Funcionalidade do Forms - 45
Developer/2000 - Forms 4.5
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
NAVIGATION
Enabled - determina se o operador poder usar o mouse para manipular um
item que tenha a propriedade NAVIGABLE setada para OFF. A tabela abaixo
mostra a relao entre ENABLED e NAVIGABLE
Funcionalidade do Forms - 46
Developer/2000 - Forms 4.5
FUNCTIONAL
Access Key - especifica o caracter que ser a chave de acesso, permitindo
que a operador faa acesso ao item pressionando uma combinao de teclas. (ex.:
ALT-C). O caracter faz parte do label.
Direction - especifica a direo de desenvolvimento do objeto (para NLS
applications).
Label - texto a ser apresentado no boto.
Iconic - indica que o boto deve receber cone
Icon Name - nome do arquivo do cone.
Default Button - indica que o boto deve ser o default.
MISCELLANEOUS
Hint - texto a ser apresentado na linha de mensagem quando o operador se
posicionar no item.
Auto Hint - marcando esta propriedade o Oracle mostra o contedo da
propriedade Hint quando o foco passa para o item. Desmarcando-se esta opo o
Oracle mostrar o contedo do Hint quando o operador teclar [HELP] ou
selecionar a opo HELP do menu default enquanto posicionado sobre o item.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 47
Developer/2000 - Forms 4.5
CHECK BOXES
Name - nome do item.
Class - nome da classe do item.
TYPE
Item Type - Check Box
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Current Record Attribute - indica o nome de um atributo visual usado quando
o item for parte do registro corrente.
Funcionalidade do Forms - 48
Developer/2000 - Forms 4.5
DATA
Mirror item - especifica o nome do item do qual o item corrente derivado.
Esta propriedade sincroniza o valor de ambos os itens uma vez que quando o
operador altera o valor de um deles o outro, automaticamente, se altera tambm.
Como restrio temos que os itens devem estar no mesmo bloco.
Data Type - tipos de valores que o item pode armazenar. (Char, Date,
Number).
Maximum Length - o nmero mximo de caracteres que um item pode
armazenar.
Default Value - um valor default para o item, que deve ser compatvel com o
tipo do item.
Copy Value from Item - identifica a origem do valor para popular o item. Em
uma relao master-detail, o Oracle seta esta propriedade automaticamente no
item foreign key no bloco detalhe. Neste caso informado o nome da primary key
do bloco master, cujo valor copiado para o item foreign key quando um registro
criado ou consultado.
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
Funcionalidade do Forms - 49
Developer/2000 - Forms 4.5
NAVIGATION
Enabled - determina se o operador poder usar o mouse para manipular um
item que tenha a propriedade NAVIGABLE setada para OFF. A tabela abaixo
mostra a relao entre ENABLED e NAVIGABLE
DATABASE
Base Table Item - indica se o item correspondente a uma coluna na base table do
bloco.
Query Only - indica se o item ser exclusivamente para consulta.
Primary Key - deve ser setado para TRUE para todos os itens que
correspondam a PK na base table do bloco.
Insert Allowed - determina se o operador poder modificar o valor do item em
um registro novo.
Query Allowed - indica que o operador poder navegar para o item quando
estiver no modo de ENTER QUERY. Quando um Form est no modo ENTER
QUERY, o Oracle pula todos os campos que tem a propriedade Query Allowed
OFF, mesmo se os itens forem navegveis normalmente.
Update Allowed - mutuamente exclusivo com UPDATE IF NULL. Especifica
que o valor do item poder ser alterado independente do seu contedo.
Funcionalidade do Forms - 50
Developer/2000 - Forms 4.5
FUNCTIONAL
Access Key - especifica o caracter que ser a chave de acesso, permitindo
que o operador faa acesso ao item pressionando uma combinao de teclas. (ex.:
ALT-C). O caracter faz parte do label.
Direction - especifica a direo de desenvolvimento do objeto (para NLS
applications).
Label - texto a ser mostrado ao lado do Check Box.
Checked Value - valor que ser considerado estado Checked para o Check Box.
Unchecked Value - valor que ser considerado estado Unchecked para o Check
Box.
Check Box Other Values - indica que se outros valores forem lidos ou
atribudos ao item Check Box. O estado do Check Box deve ser:
MISCELLANEOUS
Hint - texto a ser apresentado na linha de mensagem quando o operador se
posicionar no item.
Auto Hint - marcando esta propriedade o Oracle mostra o contedo da
propriedade Hint quando o foco passa para o item. Desmarcando-se esta opo o
Oracle mostrar o contedo do Hint quando o operador teclar [HELP] ou selecionar
a opo HELP do menu default enquanto posicionado sobre o item.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 51
Developer/2000 - Forms 4.5
CHART ITEMS
Name - nome do item.
Class - nome da classe do item.
TYPE
Item Type - Chart Item
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Bevel - Indica se o item ter aspecto tridimensional.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Funcionalidade do Forms - 52
Developer/2000 - Forms 4.5
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
NAVIGATION
Next Navigation Item - prximo item na seqncia de navegao em relao a
este.
Previous Navigation Item - item anterior na seqncia de navegao em relao a
este.
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 53
Developer/2000 - Forms 4.5
DISPLAY ITEMS
Name - nome do item.
Class - nome da classe do item.
TYPE
Item Type - Display Item
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Bevel - Indica se o item ter aspecto tridimensional.
Rendered - indica que o item ser mostrado como um rendered object quando
ele no estiver como foco.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Current Record Attribute - indica o nome de um atributo visual usado quando
o item for parte do registro corrente.
Funcionalidade do Forms - 54
Developer/2000 - Forms 4.5
DATA
Mirror item - especifica o nome do item do qual o item corrente derivado.
Esta propriedade sincroniza o valor de ambos os itens uma vez que quando o
operador altera o valor de um deles o outro, automaticamente, se altera tambm.
Como restrio temos que os itens devem estar no mesmo bloco.
Data Type - tipos de valores que o item pode armazenar (Char, Date,
Number).
Maximum Length - o nmero mximo de caracteres que um item pode
armazenar.
Default Value - um valor default para o item, que deve ser compatvel com o
tipo do item. O valor default pode ser um dos seguintes:
Copy Value from Item - identifica a origem do valor para popular o item. Em
uma relao master-detail, o Oracle seta esta propriedade automaticamente no
item foreign key no bloco detalhe. Neste caso informado o nome da primary key
do bloco master, cujo valor copiado para o item foreign key quando um registro
criado ou consultado.
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
NAVIGATION
Next Navigation Item - prximo item na seqncia de navegao em relao a
este.
Previous Navigation Item - item anterior na seqncia de navegao em relao a
este.
Funcionalidade do Forms - 55
Developer/2000 - Forms 4.5
DATABASE
Base Table Item - indica se o item correspondente a uma coluna na base table do
bloco.
Query Only - indica se o item ser exclusivamente para consulta.
Primary Key - deve ser setado para TRUE para todos os itens que
correspondam a PK na base table do bloco.
FUNCTIONAL
Alignment - alinhamento do texto dentro do campo(start, left, right, center,
end).
Reading Order - ordem de leitura, que pode ser Default, Left-to-Right ou Right-to-
Left.
Initial Keyboard State - indica o estado inicial do teclado para o item.
Somente vlido para aplicaes NLS.
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 56
Developer/2000 - Forms 4.5
IMAGE ITEMS
Name - nome do item.
Class - nome da classe do item.
TYPE
Item Type Image
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Bevel - Indica se o item ter aspecto tridimensional.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Current Record Attribute - indica o nome de um atributo visual usado quando
o item for parte do registro corrente.
Funcionalidade do Forms - 57
Developer/2000 - Forms 4.5
DATA
Mirror item - especifica o nome do item do qual o item corrente derivado.
Esta propriedade sincroniza o valor de ambos os itens uma vez que quando o
operador altera o valor de um deles o outro, automaticamente, se altera tambm.
Como restrio temos que os itens devem estar no mesmo bloco.
Required - quando esta propriedade est TRUE obriga o operador a
preencher o campo :
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
NAVIGATION
Enabled - determina se o operador poder usar o mouse para manipular um
item que tenha a propriedade NAVIGABLE setada para OFF. A tabela abaixo
mostra a relao entre ENABLED e NAVIGABLE.
Funcionalidade do Forms - 58
Developer/2000 - Forms 4.5
DATABASE
Base Table Item - indica se o item correspondente a uma coluna na base table do
bloco.
Query Only - indica se o item ser exclusivamente para consulta.
Insert Allowed - determina se o operador poder modificar o valor do item em
um registro novo.
Update Allowed - mutuamente exclusivo com UPDATE IF NULL. Especifica
que o valor do item poder ser alterado independente do seu contedo.
Update Only If Null - mutualmente exclusivo com UPDATE ALLOWED.
Especifica que o valor do item somente poder ser alterado se for NULL.
FUNCTIONAL
Compression - indica quando uma imagem lida de um arquivo deve ser
comprimida quando convertida para o formato interno do Oracle.
Quality - indica o nvel de qualidade da imagem. proporcional necessidade
de memria.
Sizing Style - determina o tamanho da imagem quando seu tamanho no
igual ao do item.
Horizontal Scroll Bar - indica se deve ser criada uma barra de rolagem
horizontal para o item.
Vertical Scroll Bar - indica se deve ser criada uma barra de rolagem vertical para o
item.
MISCELLANEOUS
Hint - texto a ser apresentado na linha de mensagem quando o operador se
posicionar no item.
Auto Hint - marcando esta propriedade o Oracle mostra o contedo da
propriedade Hint quando o foco passa para o item. Desmarcando-se esta opo o
Oracle mostrar o contedo do Hint quando o operador teclar [HELP] ou
selecionar a opo HELP do menu default enquanto posicionado sobre o item.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 59
Developer/2000 - Forms 4.5
RADIO GROUP
Name - nome do item.
Class - nome da classe do item.
TYPE
Item Type - Radio Group
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Funcionalidade do Forms - 60
Developer/2000 - Forms 4.5
DATA
Mirror item - especifica o nome do item do qual o item corrente derivado.
Esta propriedade sincroniza o valor de ambos os itens uma vez que quando o
operador altera o valor de um deles o outro, automaticamente, se altera tambm.
Como restrio temos que os itens devem estar no mesmo bloco.
Data Type - tipos de valores que o item pode armazenar (Char, Number ou
Date).
Maximum Length - o nmero mximo de caracteres que um item pode
armazenar.
Default Value - um valor default para o item, que deve ser compatvel com o
tipo do item.
Copy Value from Item - identifica a origem do valor para popular o item. Em
uma relao master-detail, o Oracle seta esta propriedade automaticamente no
item foreign key no bloco detalhe. Neste caso informado o nome da primary key
do bloco master, cujo valor copiado para o item foreign key quando um registro
criado ou consultado.
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
NAVIGATION
Navigable - indica se o operador poder ou no navegar para este item.
Mouse Navigate - indica se o operador poder ou no navegar para este item
com o mouse, isto , se o Oracle Forms deve direcionar o foco para o item.
Next Navigation Item - prximo item na seqncia de navegao em relao a
este.
Previous Navigation Item - item anterior na seqncia de navegao em relao a
este.
Funcionalidade do Forms - 61
Developer/2000 - Forms 4.5
DATABASE
Base Table Item - indica se o item correspondente a uma coluna na base table do
bloco.
Query Only - indica se o item ser exclusivamente para consulta.
Primary Key - deve ser setado para TRUE para todos os itens que
correspondam a PK na base table do bloco.
Insert Allowed - determina se o operador poder modificar o valor do item em
um registro novo.
Query Allowed - indica que o operador poder navegar para o item quando
estiver no modo de ENTER QUERY. Quando um Form est no modo ENTER
QUERY, o Oracle pula todos os campos que tem a propriedade Query Allowed
OFF, mesmo se os itens forem navegveis normalmente.
Update Allowed - mutuamente exclusivo com UPDATE IF NULL. Especifica
que o valor do item poder ser alterado independente do seu contedo.
FUNCTIONAL
Access Key - especifica o caracter que ser a chave de acesso, permitindo
que a operador faa acesso ao item pressionando uma combinao de teclas. (ex.:
ALT-C). O caracter faz parte do label.
Direction - especifica a direo de desenvolvimento do objeto (para NLS
applications).
Other Values - indica como um valor lido ou atribudo a um radio button deve
ser interpretado. O valor pode ser um daqueles associados a um radio item ou o
nome de um radio item.
MISCELLANEOUS
Hint - texto a ser apresentado na linha de mensagem quando o operador se
posicionar no item.
Auto Hint - marcando esta propriedade o Oracle mostra o contedo da
propriedade Hint quando o foco passa para o item. Desmarcando-se esta opo o
Oracle mostrar o contedo do Hint quando o operador teclar [HELP] ou
selecionar a opo HELP do menu default enquanto posicionado sobre o item.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 62
Developer/2000 - Forms 4.5
RADIO BUTTON
Name - nome do item.
Class - nome da classe do item.
DISPLAY
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Funcionalidade do Forms - 63
Developer/2000 - Forms 4.5
NAVIGATION
Enabled - determina se o operador poder manipular o item.
FUNCTIONAL
Access Key - especifica o caracter que ser a chave de acesso, permitindo
que a operador faa acesso ao item pressionando uma combinao de teclas. (ex.:
ALT-C). O caracter faz parte do label.
Label - texto a ser apresentado ao lado do Radio Button.
Value - Valor a ser atribudo ao Radio Button no caso do operador marcar esta
opo. Deve ser compatvel com o tipo do item (Data Type). Deve ser nico dentro
dos valores associados para o mesmo Radio Group. Quando deixamos esta
propriedade em branco, o valor default associado NULL.
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 64
Developer/2000 - Forms 4.5
LIST ITEM
Name - nome do item.
Class - nome da classe do item.
TYPE
Item Type - List Item
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Current Record Attribute - indica o nome de um atributo visual usado quando
o item for parte do registro corrente.
Funcionalidade do Forms - 65
Developer/2000 - Forms 4.5
DATA
Mirror item - especifica o nome do item do qual o item corrente derivado.
Esta propriedade sincroniza o valor de ambos os itens uma vez que quando o
operador altera o valor de um deles o outro, automaticamente, se altera tambm.
Como restrio temos que os itens devem estar no mesmo bloco.
Data Type - tipos de valores que o item pode armazenar (Char, Date,
Number).
Maximum Length - o nmero mximo de caracteres que um item pode
armazenar.
Default Value - um valor default para o item, que deve ser compatvel com o
tipo do item.
Copy Value from Item - identifica a origem do valor para popular o item. Em
uma relao master-detail, o Oracle seta esta propriedade automaticamente no
item foreign key no bloco detalhe. Neste caso informado o nome da primary key
do bloco master, cujo valor copiado para o item foreign key quando um registro
criado ou consultado.
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
Funcionalidade do Forms - 66
Developer/2000 - Forms 4.5
NAVIGATION
Enabled - determina se o operador poder usar o mouse para manipular um
item que tenha a propriedade NAVIGABLE setada para OFF. A tabela abaixo
mostra a relao entre ENABLED e NAVIGABLE
DATABASE
Base Table Item - indica se o item correspondente a uma coluna na base table do
bloco.
Query Only - indica se o item ser exclusivamente para consulta.
Primary Key - deve ser setado para TRUE para todos os itens que
correspondam a PK na base table do bloco.
Insert Allowed - determina se o operador poder modificar o valor do item em
um registro novo.
Query Allowed - indica que o operador poder navegar para o item quando
estiver no modo de ENTER QUERY. Quando um Form est no modo ENTER
QUERY, o Oracle pula todos os campos que tem a propriedade Query Allowed
OFF, mesmo se os itens forem navegveis normalmente.
Update Allowed - mutuamente exclusivo com UPDATE IF NULL. Especifica
que o valor do item poder ser alterado independente do seu contedo.
Funcionalidade do Forms - 67
Developer/2000 - Forms 4.5
FUNCTIONAL
Access Key - especifica o caracter que ser a chave de acesso, permitindo
que a operador faa acesso ao item pressionando uma combinao de teclas. (ex.:
ALT-C). O caracter faz parte do label.
Direction - especifica a direo de desenvolvimento do objeto (para NLS
pplications).
Initial Keyboard State - indica o estado rudo do teclado para o item. Somente
vlido para aplicaes NLS.
MISCELLANEOUS
Hint - texto a ser apresentado na
linha de mensagem quando o operador
se posicionar no item.
Auto Hint - marcando esta propriedade o Oracle mostra o contedo da
propriedade Hint quando o foco passa para o item. Desmarcando-se esta opo o
Oracle mostrar o contedo do Hint quando o operador teclar [HELP] ou
selecionar a opo HELP do menu default enquanto posicionado sobre o item.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Funcionalidade do Forms - 68
Developer/2000 - Forms 4.5
ESCOPO DE UM TRIGGER
Um trigger deve ser associado a um objeto especfico no Form, isto , um item, um
bloco ou ao prprio Form. O objeto ao qual o trigger associado define seu escopo.
OBSERVAES
Alguns triggers s podem ser definidos em um nvel particular. Por exemplo: o
trigger WHEN-VALIDATE-RECORD s vlido se definido a nvel de bloco ou
Form.
Outros triggers, podem ser definidos a nvel de item, bloco ou Form, de acordo
com a funcionalidade desejada.
Eventos e Triggers - 69
Developer/2000 - Forms 4.5
CRIANDO TRIGGERS
A criao de um trigger pode ser
feita com a ferramenta CREATE
(+) no Object Navigator dentro do
escopo desejado (Form, Bloco ou
Item).
Na janela apresentada
observamos o conjunto de eventos
(tipos de triggers) que podemos
definir.
Eventos e Triggers - 70
Developer/2000 - Forms 4.5
O EDITOR DE PL/SQL
TYPE - tipo da rotina. As opes vlidas para este campo so: trigger ou
program unit.
Eventos e Triggers - 71
Developer/2000 - Forms 4.5
QUERY TIME
So acionados imediatamente antes e imediatamente aps o operador ou a
aplicao executar uma query em um bloco.
Eventos e Triggers - 72
Developer/2000 - Forms 4.5
INTERFACE EVENT
Este tipo de trigger acionado em resposta a uma ao do usurio (ou por
programao).
Eventos e Triggers - 73
Developer/2000 - Forms 4.5
NAVIGATIONAL TRIGGERS
So acionados em resposta a eventos de navegao.
PRE / POST e
WHEN-NEW-INSTANCE
Eventos e Triggers - 74
Developer/2000 - Forms 4.5
WHEN-NEW-INSTANCE TRIGGERS
So acionados ao fim de uma seqncia de navegao que coloca o foco em um item
diferente.
Este tipo de trigger acionado imediatamente aps o Oracle Forms mover o foco
para um item, quando o Form retorna para o estado de espera pela digitao do
operador.
Eventos e Triggers - 75
Developer/2000 - Forms 4.5
Eventos e Triggers - 76
Developer/2000 - Forms 4.5
FUNCTIONAL
Trigger Text - texto do trigger.
Trigger Type - tipo do trigger. Os valores vlidos para esta propriedade so:
Fire in Enter Query Mode - indica se o trigger deve ser disparado quando o
Forms estiver no modo de consulta. Esta opo s aplicvel aos seguintes
tipos de triggers :
KEY-*
ON-ERROR / ON-MESSAGE
WHEN - <evento>, exceto:
When-Database-Record When-Create-Record
When-Image-Activated When-Remove-Record
When-New-Block-Instance When-Validate-Record
When-New-Form-Instance When-Validate-Item
Override (default) - este trigger ser acionado no lugar do outro de mais alto nvel.
Before/After - este trigger ser acionado antes ou depois do outro de mais alto
nvel.
Eventos e Triggers - 77
Developer/2000 - Forms 4.5
EXEMPLO
IF :VL_SAL < 500 THEN
RAISE FORM_TRIGGER_FAILURE;
END IF;
Eventos e Triggers - 78
Developer/2000 - Forms 4.5
ROTINAS PR DEFINIDAS
O Oracle Forms possui em torno
de 100 rotinas pr definidas que
podem ser usadas nos triggers.
STANDARD Extensions -
corresponde ao conjunto de
rotinas padro do Oracle
Forms.
Os outros pacotes possuem rotinas com funcionalidade especfica.
Eventos e Triggers - 79
Developer/2000 - Forms 4.5
TOOL_ENV - Permite que faamos a interao com variveis do ambiente
Oracle. Por exemplo, suponhamos que desejssemos obter o USERID corrente.
Poderamos usar o seguinte PL/SQL : TOOL_ENV.GETVAR('USER', :resposta);
Eventos e Triggers - 80
Developer/2000 - Forms 4.5
ROTINAS DE NAVEGAO
Down
First_Record
Go_Block(Block_name)
Go_Form(Formmodule_Id)
Go_Form(Formmodule_Name)
Go_Item(Item_Id)
Go_Item(Item_Name)
Go_Record(Record_number)
Last_Record
Next_Block
Next_Form
Next_Item
Next_Record
Previous_Block
Previous_Form
Previous_Item
Previous_Record
Up
Todas as rotinas restritas, porm, podem ser chamadas de um trigger do tipo WHEN-
NEW-INSTANCE, porque este trigger somente ser acionado aps a navegao para
o item ter ocorrido.
Eventos e Triggers - 81
Developer/2000 - Forms 4.5
Eventos e Triggers - 82
Developer/2000 - Forms 4.5
ROTINAS DE TEMPORIZAO
Create_Timer(Timer_Name, Milliseconds, Iterate)
Delete_Timer(Timer_Id)
Delete_Timer(Timer_Name)
Set_Timer(Timer_Id, Milliseconds, Iterate)
Set_Timer(Timer_Name, Milliseconds, Iterate)
Eventos e Triggers - 83
Developer/2000 - Forms 4.5
Para obter o sucesso ou fracasso de uma rotina (pr definida), podemos usar as
seguintes funes:
GO_BLOCK (xyz_block);
IF NOT FORM_SUCCESS THEN
RAISE FORM_TRIGGER_FAILURE;
END IF;
OBS: no exemplo anterior, quando foi detectado um erro na rotina GO_BLOCK, foi
necessrio forar um erro no trigger atravs do comando RAISE.
Eventos e Triggers - 84
Developer/2000 - Forms 4.5
Windows
Canvas-views
A canvas-view o objeto de
fundo no qual desenhamos os
itens (text items, check boxes,
radio groups, etc.) e os
boilerplates.
A tempo de execuo os operadores podem ver somente os itens que tenham sido
associados a uma canvas especfica. Cada canvas, por outro lado, deve ser mostrada
em uma window especfica.
Quando criamos uma window, marcamos propriedades que indicam seu tamanho,
localizao e funcionalidade. Desta forma podemos indicar quando o operador pode
mover, redimensionar ou rolar uma window.
Interface Visual - 85
Developer/2000 - Forms 4.5
Mais de uma modeless window pode ser mostrada ao mesmo tempo e os operadores
podem navegar atravs delas se a aplicao permitir.
Uma modal window mais restrita que uma modeless window, uma vez que o
operador s poder passar para outra window aps encerr-la.
Interface Visual - 86
Developer/2000 - Forms 4.5
Se desejarmos que uma canvas-view seja mostrada em uma outra window, devemos
criar a nova window e ento, re-associar a canvas-view para aquela nova window.
Interface Visual - 87
Developer/2000 - Forms 4.5
DISPLAY
X/Y Position - Indica a posio onde a window aparecer na tela.
Width/Heigth - Especifica a largura e altura da window.
Bevel - Esta opo pode ser setada para Raised ou Lowered para formatar a
borda do item quando executarmos em um gerenciador que suporte 3 dimenses.
Title - Ttulo da window.
Visual Atribute Name - Indica o nome de um atributo visual para o objeto.
Font Name - Nome da fonte usada para textos no objeto.
Font Size - Tamanho da fonte, especificado em points.
Font Style - Estilo da fonte (itlico, plain, underline, etc.)
Font Width - Largura da fonte (Normal, Expand, Dense, etc.).
Font Weigth - Granulao da corda fonte (Bold, Medium, Ligth, etc.).
Foreground Color - Cor da regio do objeto de foreground. Para itens a cor do
texto.
Background Color - Cor da regio do objeto de fundo (background).
Fill Pattern - Textura da regio de preenchimento (fill). A textura ser montada com
as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - Especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao.
White on Black - Indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Interface Visual - 88
Developer/2000 - Forms 4.5
FUNCTIONAL
View - Especifica a canvas-view que ser a view content primria da window.
Horiz/Vert Toolbar - Nome da canvas que ser a barra de ferramentas da window.
Style - Estilo da window.
Modal - Indica se a window modal (on) ou modeless (off-default).
Remove On Exit - Indica que o Oracle Forms esconde a window corrente
automaticamente quando o operador navega para um item em outra window.
Direction - Direcionamento de desenvolvimento de objetos bidirecionais.
Especfico para aplicaes NLS.
Icon Name - Especifica o cone que o Oracle deve mostrar quando o operador
minimiza a window. O cone deve existir a tempo de execuo no disco.
Iconifiable deve ser on.
Icon Title - Especifica o texto (string) que deve ser mostrado na window
iconizada. Iconifiable deve ser on.
Horz / Vert Scroll Bar - Indica se a window ter uma scroll bar e se ela ser
horizontal ou vertical. bordered deve ser on.
GUI HINTS
Closeable - Indica se a window fechvel.
Fixed Size - Especifica que a window ter tamanho fixo e no pode ser
redimensionada a tempo de execuo.
Iconifiable - Especifica que a window pode ser iconizada.
Inherit Menu - Indica que a window deve mostrar o menu corrente.
Moveable - Indica que o operador pode mover a window de uma localizao
para outra na tela.
Zoomable - Indica se o operador pode redimensionar a window usando a
capacidade de zoom provida pelo gerenciador de windows (a tempo de execuo).
Fixed size deve ser off.
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Interface Visual - 89
Developer/2000 - Forms 4.5
CANVAS-VIEW
Sabemos que uma window corresponde a uma moldura vazia. J a canvas-view o
objeto de fundo no qual desenhamos os itens (text items, check boxes, radio groups,
etc.) e os boilerplates.
A tempo de execuo os operadores podem ver somente os itens que tenham sido
associados a uma canvas.
Cada canvas tem um atributo chamado viewport. Podemos entender o viewport como um
retngulo invisvel posicionado sobre a canvas.
Interface Visual - 90
Developer/2000 - Forms 4.5
TIPOS DE CANVAS-VIEW
Existem quatro tipos de canvas-view :
CONTENT VIEW
uma view base que ocupa o painel inteiro da janela na qual ela mostrada. A
tempo de execuo s podemos associar uma content view na window de cada
vez.
STACKED VIEW
Esta view difere da outra no fato que ela no uma view base para a window a qual
ela est sendo associada. Por esta razo ela pode ser apresentada em qualquer
coordenada x e y dentro da rea da window.
Uma stacked view pode ser mostrada em uma window ao mesmo tempo que
uma content view e qualquer nmero de outras stacked views.
Interface Visual - 91
Developer/2000 - Forms 4.5
PROPRIEDADES DA CANVAS-VIEW
Name - Nome da canvas. Deve ser nico.
Class - classe da canvas.
TYPE
Canvas - View Type - Tipo da Canvas (Content, Stacked, Vertical Toolbar,
Horizontal Toolbar).
DISPLAY
Displayed - Determina se a view ser mostrada imediatamente ou ficar
escondida quando a window for mostrada. O default ON (mostrada)
Width/Height - Especifica o tamanho da canvas nas unidades setadas para o
mdulo. O tamanho default 80 x 24 (caracter) ou seu equivalente na unidade em
uso.
Bevel - Determina se a view ter a borda visvel. Para que no tenha borda
colocamos none.
Visual Atribute Name - Indica o nome de um atributo visual para o objeto.
Font Name - Nome da fonte usada para textos no objeto.
Font Size - Tamanho da fonte, especificado em points.
Font Style - Estilo da fonte (itlico, plain, underline, etc.)
Font Width - Largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - Granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - Cor da regio do objeto de fouground. Para itens a cor do
texto.
Background Color - Cor da regio do objeto de fundo (background)
Fill Pattern - Textura da regio de preenchimento (fill). A textura ser montada com
as cores definidas pelos atributos Foreground Color e Baclground Color.
Charmode Logical Attribute - Especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - Indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Interface Visual - 92
Developer/2000 - Forms 4.5
FUNCTIONAL
Window - A window na qual a canvas ser mostrada. Esta propriedade
obrigatria e deve ser setada para window0 (default) ou o nome de uma outra window.
Raise on Entry - Aplicvel apenas quando existem outras views associadas
mesma window. Quando raise on entry est OFF (default), o Oracle Forms coloca
a view na frente de todas as outras views somente se o item para o qual o
operador navegou est escondido (atrs de) outra view. Se esta propriedade
estiver ON o Oracle ir sempre colocar a view na frente das demais quando um
operador navegar para um item desta view.
X/Y Position on Canvas - Especifica a posio do canto esquerdo superior do
viewport na canvas. O default 0, o que permite que a canvas inteira seja
mostrada dentro da view.
Direction - Direcionamento de desenvolvimento de objetos bidirecionais.
Especfico para aplicaes NLS.
STACKED VIEW
View Width/Height - Determina o tamanho do viewport, o qual no pode ser
maior que o tamanho da canvas.
Display X Position/Display Y Position - Define as coordenadas do canto
esquerdo superior da view em relao ao canto esquerdo superior da window
corrente.
Vertical / Horizontal Scroll Bar - Determina se a canvas-view ter uma scroll
bar e se ela ser horizontal ou vertical.
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Interface Visual - 93
Developer/2000 - Forms 4.5
Cada window tem uma propriedade opcional que indica a view primria para aquela
window.
A tempo de execuo somente uma content view pode ser mostrada de cada vez
na window.
Uma stacked view, porm, pode ser mostrada ao mesmo tempo que a content view e
qualquer nmero de outras stacked views.
Da mesma forma que com a content, somente uma canvas do tipo Horizontal Toolbar
pode ser mostrada em uma window de cada vez. O mesmo vale para Vertical Toolbar.
Interface Visual - 94
Developer/2000 - Forms 4.5
O EDITOR LAYOUT
o editor grfico para a criao e arrumao de itens, boilerplates de textos e
grficos na interface visual da aplicao.
No Layout podemos:
Interface Visual - 95
Developer/2000 - Forms 4.5
WORKSPACE
a rea de janela do Layout. Seu tamanho independente do tamanho atual da
janela, isto , o WORKSPACE pode ser maior ou menor que a rea da janela.
Quando o WORKSPACE maior que a janela, podemos rolar a janela para ver outras
partes do WORKSPACE.
TITLE BAR
uma barra de informaes que aparece na parte superior da janela, com:
onde:
Interface Visual - 96
Developer/2000 - Forms 4.5
RULERS
Uma rgua horizontal (em cima) e uma vertical (lateral esquerda).
Guias
Podem ser selecionadas guias (tracejadas) horizontais e verticais para referncia.
Para selecionarmos uma guia basta que posicionemos o mouse sobre a rgua,
pressionemos e arrastemos a guia at a posio desejada.
GRID
Existe uma grade dentro do WORKSPACE para auxlio no posicionamento de objetos.
STATUS LINE
A linha de status no p da pgina do layout mostra as seguintes informaes:
Interface Visual - 97
Developer/2000 - Forms 4.5
PALETA DE FERRAMENTAS
A paleta de ferramentas subdividida em grupos:
FERRAMENTAS DE MANIPULAO
Select - seleciona um objeto ou grupo de objetos, marcando-se
sobre ele.
Rotate - gira os objetos (boilerplates, itens no podem ser
rodados) ou grupos.
Magnify - aumenta ou reduz a apresentao do Layout (fator - 2x),
isto , zoom.
Reshape - permite que se modifique um objeto (boilerplate)
selecionado (ex.: ngulo de um arco).
FERRAMENTAS GRFICAS
Rectangle - cria retngulos.
Line - cria objetos lineares (linha).
Elipse - cria objetos ovais.
Arc - cria objetos em forma de arco.
Polygon - cria polgonos.
Polyline - cria linhas quebradas.
Rounded Rectangle - cria retngulos com as bordas
arredondadas.
Freehand - cria desenhos livres (linhas curvas).
Boilerplate Text - cria textos.
Interface Visual - 98
Developer/2000 - Forms 4.5
FERRAMENTAS DE ITENS
Button - cria buttons (botes).
Check Box - cria check box.
Rdio Button - cria radio buttons (pertencentes a um grupo).
Text Item - cria campos (text items).
Imagem Item - cria em item do tipo imagem.
Chart Item - cria um grfico desenhado no Oracle Graphics.
OLE2 Object - cria um objeto OLE2 no form.
VBX Control - permite que se incluam controles do tipo VBX na aplicao.
Display Item - cria um item display. Os itens do tipo display so similares aos text
itens, exceto que o operador no poder digitar ou modificar seu valor.
List Item - Cria um item do tipo list, que podem ser mostrados em pop-lists ou list boxes.
Interface Visual - 99
Developer/2000 - Forms 4.5
ATTRIBUTES BOX
Mostra os atributos escolhidos para o objeto selecionado:
FILL COLOR
Indica as caractersticas de preenchimento do objeto:
LINE COLOR
Indica as caractersticas da linha que envolve o objeto (borda):
TEXT COLOR
Indica a cor do texto:
Cada canvas possui um atributo chamado de viewport. Este atributo define a rea da
canvas que ser apresentada na janela (window, tela) a tempo de execuo.
REDIMENSIONAR A CANVAS
O redimensionamento feito com o cursor, clicando-se no canto superior ou
inferior da canvas e arrastando-se o mouse at a posio desejada (ou alterando-se
suas propriedades de dimensionamento width e height).
MOVER O VIEWPORT
Para mover o viewport, usamos o mouse. Esta opo ir alterar as coordenadas da
view, que podem ser verificadas no conjunto de propriedades da canvas.
CRIANDO ITENS
Para criarmos um novo item, devemos:
O Oracle Forms vai associar o novo item ao bloco corrente. Se este bloco for do
tipo multi-record, o Oracle mostrar n desenhos do item, um para cada
registro do bloco.
MOVER OS ITENS
Para mover um item, usamos o mouse. Esta opo ir alterar as coordenadas do item,
que podem ser verificadas no conjunto de propriedades do item selecionado.
Este valor pode ser fornecido nas unidades: polegadas, centmetros, pontos ou
caracteres.
BOILERPLATE TEXT
Para criar um boilerplate text :
BOILERPLATE GRFICO
Para adicionarmos um boilerplate grfico a canvas, usamos as ferramentas da paleta
de ferramentas listadas a seguir:
Arc Tool
Ellipse Tool
Freehand Tool
Line Tool
Polygon Tool
Polyline Tool
Rectangle Tool
Rounded Rectangle Tool
O modo de criao semelhante aos vistos anteriormente para Boilerplate Text, Items, etc.
FONTE
O dilogo abaixo mostrado quando escolhemos a opo FONT.
Nele podemos determinar a fonte, estilo de letra, tamanho e efeitos para o item ou
boilerplate selecionado.
LINHA
Existem quatro opes para customizao de linha
ALINHAMENTO E ESPACEJAMENTO
O alinhamento e espacejamento dos textos dos itens pode ser feito com as opes
Spacing e Alignment. A opo Direction pode ser usada quando estivermos
trabalhando em sistemas multi-lngua.
SELEO
Para manipular objetos (redimensionar, cortar, copiar, mover, colar, etc.), devemos
inicialmente selecion-los. Para isto usamos as opes SELECT da paleta de
ferramentas.
OPERAES
As seguintes operaes podem ser feitas com objetos (itens e boilerplates):
COMANDOS DE EDIO
Seleo de texto - Pressionar e arrastar o mouse para selecionar a
quantidade de texto desejada.
Seleo de todos os textos - No menu EDIT, escolher ALL.
Copiar o texto selecionado - No menu EDIT, escolher COPY.
Recortar o texto - No menu EDIT, escolher CUT.
Remover o texto selecionado - No menu EDIT, escolher CLEAR
Colar o texto - No menu EDIT, escolher PASTE.
FORMATOS DRAWING
CGM
Oracle Format
FORMATOS IMAGE
BMP
TIFF
IFIF
ORACLE FORMAT
PICT
PCX
IMPORTANDO BOILERPLATES
Para realizarmos a importao de boilerplates, devemos:
BLOCO-DETALHE.FK-ITEM = BLOCO-PRINCIPAL.PK-ITEM
cd_depto nm_depto
DEPTO
PK-Depto
FK-Func
FUNC
cd_mat nm_func cd_depto vl_sal nr_cargo
O OBJETO RELATION
Para definirmos um relacionamento Master-Detail entre blocos devemos criar um
objeto RELATION. Quando este objeto criado o Oracle Forms gera os triggers e
procedures necessrias para assegurar o relacionamento entre os blocos.
Quando criamos uma relao o Oracle Forms gera diferentes triggers de acordo
com as propriedades Master Deletes e Coordination.
VALIDATION TRIGGERS
So acionados quando o Oracle Forms valida dados em um item ou registro. O
Oracle Forms executa a validao durante a navegao que ocorre em resposta a
uma ao do operador, programao ou processamento default (ex.: um commit ).
BLOCK PROCESSING
Este tipo de trigger acionado em resposta a eventos relacionados a gerenciamento
de registros de um bloco.
TRANSACTIONAL TRIGGERS
So acionados em resposta a uma grande variedade de eventos que ocorrem quando
um Forms interage com os dados.
Esta uma lista parcial dos triggers transacionais disponveis. Muitos dos no
apresentados existem apenas para aplicaes que iro executar contra bancos
de dados no Oracle.
MESSAGE-HANDLING
O Oracle Forms, automaticamente, informa os erros e mensagens (avisos) em
resposta a eventos de execuo. Os triggers do tipo message-handling so acionados
em resposta a estes eventos de informao.
INTERFACE EVENT
Este tipo de trigger acionado em resposta a uma ao do usurio (ou por
programao). Deste grupo faltou mencionarmos os triggers do tipo Key-*.
OUTRA CLASSIFICAO
Os triggers, tambm, podem ser subdivididos por nome. Desta forma, existem 5
categorias de triggers; cada uma relacionada a um tipo particular de evento que
ocorre durante o processo de execuo.
KEY-* - possuem uma ligao direta (1 para 1) com a tecla especfica, ou seja,
o trigger acionado quando o operador pressiona a seqncia de teclas
especficas.
Para que um trigger seja executvel no modo ENTER QUERY, a propriedade ENTER
QUERY MODE deve estar TRUE.
VARIVEIS DO FORMS
So itens que no esto associados a uma canvas, desta forma eles nunca so
visveis, pelo usurio, a tempo de execuo.
Para fazer referncia a uma varivel global (PL/SQL) devemos prefixar seu nome com
a palavra GLOBAL.
VARIVEIS DE SISTEMA
O Oracle Forms possui um conjunto de variveis pr definidas, chamadas de System
Variables, s quais so atribudos valores a tempo de execuo pelo prprio Oracle.
CHANGED - indica que o Form contm pelo menos um bloco com registro
alterado.
NEW - indica que o Form contm apenas registros novos.
QUERY - indica que existe uma consulta em andamento, ou seja, o Form
contm pelo menos um bloco em QUERY e nenhum bloco com
CHANGED.
ALERTAS
Um alerta uma modal window que mostra uma mensagem para notificar o operador
de alguma condio da aplicao. Os alertas aparecem em resposta a eventos.
DISPLAY
Title - texto a ser apresentado na janela do alerta.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
FUNCTIONAL
Alert Style - Determina o estilo do alerta: Stop, Caution ou Note.
Button 1 - Ttulo do primeiro boto do alerta.
Button 2 - Ttulo do segundo boto do alerta (se existir).
Button 3 - Ttulo do terceiro boto do alerta (se existir).
Default Alert Button - Indica qual dos botes ser o default (aparecer
selecionado). O usurio poder pressionar a tecla [Enter].
Message - Mensagem a ser mostrada para o usurio.
Direction - especifica a direo de desenvolvimento do objeto (para NLS
applications).
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Uma vez criado o alerta, devemos definir os triggers ou rotinas para mostrar o alerta
em resposta a um evento em particular.
EDITOR
Existe um editor de texto associado a
cada Form. Por default, os operadores
utilizam o editor quando navegam para
um text item e pressionam a tecla
[EDIT] ou selecionando EDIT no menu
default.
DISPLAY
X Position / Y Position - posicionamento defaut para o editor
Width / Height - define o tamanho para o editor
Title/Bottom Title - ttulos de cabealho e rodap.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
FUNCTIONAL
Wrap Style - estilo de apresentao do texto que ocupe mais de uma linha no
limite da janela do editor, ou seja, na quebra da linha (none, character, word).
Horizontal / Vertical Scroll Bar -Uso ou no de barra de scroll.
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Este dilogo tem o objetivo de determinar a origem dos dados que sero
mostrados no LOV:
DISPLAY
X Position / Y Position - indica o
posicionamento defaut para a
LOV.
Width / Height - define o
tamanho para a janela da LOV.
Title - Especifica o texto que o
Oracle Forms ir mostrar na barra
Ttulo da janela da LOV.
Visual Atribute Name - indica
o nome de um atributo visual para
o objeto.
Font Name - nome da fonte
usada para textos no objeto.
Font Size - tamanho da fonte,
especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
FUNCTIONAL
LOV Type - Determina em que o LOV est baseado (Record Group ou V2-
Style).
Record Group - Nome do Record Group
Column Mapping - Pressionar a tecla More para que seja mostrado o
dilogoColumn Mapping.
Auto-Cofirm - Determina o que acontece quando o operador reduz a lista de
opes do LOV para uma nica opo, seja fazendo uma pesquisa (searching) ou
usando auto-reduo (que ocorre quando o operador digita a informao
desejada).
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Desta forma utilizaremos as rotinas do pacote Standard Extensions para permitir esta
forma de trabalho.
RECORD GROUPS
Um record group uma estrutura interna do Oracle Forms que semelhante a uma
tabela da base de dados, s que em memria.
A tempo de execuo podemos, por programao, criar query record groups e non-
query record groups.
Pressionamos o boto OK
FUNCTIONAL
Record Group Type - Tipo do Record Group. Os valores vlidos para esta
opo so: Query ou Static.
Record Group Query - Texto da query.
Column Specification - Pressionar a tecla More para que seja mostrado o
dilogo Column Specification.
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Populate_Group(Recordgroup_Id)
Populate_Group(Recordgroup_Name)
Populate_Group_With_Query(Recordgroup_Id, Query)
Populate_Group_With_Query(Recordgroup_Name, Query)
Reset_Group_Selection(Recordgroup_Id)
Reset_Group_Selection(Recordgroup_Name)
Set_Group_Char_Cell(Groupcolumn_Id, Row_Number, Cell_Value)
Set_Group_Char_Cell(Groupcolumn_Name, Row_Number, Cell_Value)
Set_Group_Date_Cell(Groupcolumn_Id, Row_Number, Cell_Value)
Set_Group_Date_Cell(Groupcolumn_Name, Row_Number, Cell_Value)
Set_Group_Number_Cell(Groupcolumn_Id, Row_Number, Cell_Value)
Set_Group_Number_Cell(Groupcolumn_Name, Row_Number, Cell_Value)
Set_Group_Selection(Recordgroup_Id, Row_Number)
Set_Group_Selection(Recordgroup_Name, Row_Number)
Unset_Group_Selection(Recordgroup_Id, Row_Number)
Unset_Group_Selection(Recordgroup_Name, Row_Number)
VISUAL ATTRIBUTE
Um atributo visual um grupamento de propriedades visuais que podemos criar com
o intuito de estabelecer um padro para determinadas situaes dos objetos do
Oracle.
Nos blocos e nos itens a propriedade Current Record Attribute pode ser preenchida
com o nome de um atributo visual para que o usurio possa identificar com facilidade
o registro atualmente em uso.
A propriedade Visual Attribute Name pode estabelecer um padro visual para os itens
que no pertencerem ao registro corrente.
Os objetos visveis pelo usurio (Alertas, Lovs, Editores, etc) possuem propriedade
que permite a identificao de um padro visual.
DISPLAY
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
MISCELLANEOUS
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
CLASSE DE PROPRIEDADES
As propriedades podem ser agrupadas em classes, nos mdulos Menu e Forms.
Estas classes podem ser alteradas de modo a servir de base para tipos padres de itens (de
blocos, de alertas, etc, ou seja, de objetos).
FALANDO DE PL/SQL
A PL/SQL uma extenso para a linguagem SQL. Ela combina manipulao de
dados e transaes (capacidades do SQL) com construes tipicamente encontradas
em linguagens de programao estruturada tais como declaraes de variveis e
constantes, atribuies, looping, desvios, etc.
criamos um trigger
O dilogo acima ser apresentado para que faamos a opo do tipo de unidade de
programa desejada.
ALERT ITEM
BLOCK LOV
CANVAS MENUITEM
GROUPCOLUMN PARAMLIST
EDITOR RELATION
FORM MODULE TIMER
RECORDGROUP VIEWPORT
WINDOW
No Oracle Forms, existem tipos de variveis para cada um dos tipos de objetos
existentes.
Ele associa um identificador (ID) para cada objeto criado, ou seja, um indexador
interno, cujo valor nunca apresentado.
Declare
id_var window;
Begin
id_var := Find_Window(my_window);
End;
Performance
Tornar o cdigo mais genrico (mais fcil de dar manuteno)
Cada vez que referenciamos um objeto pelo nome, o Oracle Forms faz o processamento
necessrio para obter o ID correspondente internamente.
Se fizermos referncia a um objeto mais de uma vez, o Oracle Forms repetir o processamento
o mesmo nmero de vezes.
Declare
dummy_var number;
conta number;
Begin
dummy_var := populate_group (my_group);
conta := get_group_row_count (my_group);
if conta > 20 then
delete_group_row (my_group, ALL_ROWS);
end_if;
End;
USANDO O ID DO OBJETO
Declare
dummy_var number;
count number;
group recordgroup := find_group (my_group);
Begin
dummy_var := populate_group (group);
count := get_group_row_count (group);
if count > 20 then
delete_group_row (group, ALL_ROWS);
end_if;
End;
Para cada User so apresentados quatro ns: Stored Program Units, Libraries,
Tables, Views.
Uma Stored Procedure pode ser copiada do banco de dados para o Forms e vice e
versa, bastando que efetuemos a seleo do objeto desejado e com o boto do
mouse pressionado arrastemos para o n Program Units correspondente.
PARMETROS
Os parmetros so variveis do tipo char, number ou date definidas a tempo de
Design para que sejam informados no momento da ativao do Form.
F45RUN module = trade userid = scott / tiger debug = yes city = "BOGOTA"
CRIANDO PARMETROS
DATA
Data Type - tipo do parmetro(char,
number ou date)
Maximum Length - Nmero
mximo de caracteres(s vlido para
char)
Default Value - Valor default do
parmetro
MISCELLANEOUS
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Copy(Source, Destination)
Name_In(F)
Encerrar o dilogo
PROPRIEDADES DO FORM
Name - o nome interno do
FORM. A tempo de desenvolvimento o
nome do mdulo apresentado na
linha de status.
DISPLAY
Coordinate Information - Ao
pressionarmos (selecionamos) esta opo
apresentada o boto more Este boto
Apresentar um dilogo no qual
poderemos determinar o tipo de fonte a
ser usada no Forms.
Horiz. MDI Toolbar - Vlido somente para Microsoft Windows. Especifica qual
canvas deve ser mostrada como uma barra de ferramentas horizontal para a MDI
application Window. A canvas especificada deve ter a propriedade type setada
para horizontal toolbar.
Use 3D Controls - Indica que o Oracle Forms deve mostrar os itens com um
aspecto tridimensional (perspectiva). S vlido para MS Windows.
FUNCTIONAL
Cursor Mode - Define o estado dos cursores durante as transaes. Esta
propriedade til para aplicaes executando para bases de dados no Oracle.
MENU
Menu Module - A propriedade menu module indica o tipo de menu a ser usado
com o Form corrente. O menu chamado automaticamente no incio do form.
A referncia poder ser direta (TRUE), neste caso o local dever ser
informado no campo Menu Module.
Para a referncia indireta (FALSE), deve-se informar o nome do mdulo
Menu armazenado no banco de dados o qual indicar o nome e
localizao do Menu.
MISCELLANEOUS
Comment - Comentrio para o item.
CHARACTER
Quando desenhamos em unidades de caracteres, todas as coordenadas e posies
so expressas em character cells. Isto significa que o Oracle Forms aceita somente
nmeros inteiros para as propriedades SIZE e POSITION.
REAL
A propriedade REAL UNIT, neste caso, deve receber como valor a unidade desejada
(pixel, centimeter, inch ou point).
OBSERVAES
OPTIONS
No menu TOOLS, ao escolhermos OPTIONS, ser apresentado um dilogo referente
ao modo de trabalhar do Oracle Forms enquanto em desenvolvimento.
DESIGNER OPTIONS
Save Before Generate - Determina que o Oracle Forms salve o mdulo
corrente automaticamente quando escolhemos File, Administration, Generate no
menu principal.
Use System Editor - Determina que editor o Oracle Forms usa quando
invocamos um editor de um campo multi-line. Quando esta opo OFF, o Oracle
Forms mostra o editor default. Quanto esta opo ON, o Oracle Forms mostra o
editor default definido para o sistema operacional.
RUNTIME OPTIONS
Debug Mode - Esta opo far com que a execuo mostre mensagens sobre
o trigger em execuo e outros estados do Form corrente. Debug mode executar
uma interrupo (break) se a procedure BREAK for usada em algum trigger ou se
usarmos o comando HELP, DEBUG do menu principal do Oracle Forms.
KEYWORD = <VALOR>|ON|OFF
O Debug se torna ativo sempre que a execuo do programa for interrompida (via
breakpoint) ou atravs do menu Help->Debug.
Painel de fonte
Navigator
Linha de comando
BREAKPOINTS
CRIANDO BREAKPOINTS
Devemos utilizar o Object Navigator do debug.
TRIGGERS
Triggers de debug permitem que se associe um bloco PL/SQL numa determinada
linha do programa.
Este cdigo pode ser usado para: alterar variveis, itens, fazer atualizaes ou
qualquer outra ao necessria depurao do programa.
Para incluir uma trigger, devemos selecionar a linha desejada e utilizar a opo do
menu Debug->Trigger a fim de adicionar o cdigo PL/SQL.
Este cdigo se utiliza da package Debug (este package s est disponvel a tempo de
depurao) para gerar um breakpoint quando o valor de my_sal for maior que 5000.
EDIO
Pode-se editar uma program unit durante a execuo do programa utilizando-se a
opo do menu Debug->Edit.
Para isto basta que se tenha os 2 mdulos abertos simultaneamente (fonte e destino)
e que se arraste o objeto de um mdulo para o outro.
CPIA
Caso se escolha copiar o objeto para o novo mdulo, o mesmo ser duplicado.
Sero levados, tambm, todos os objetos dependentes deste mdulo: itens no caso de um
bloco, triggers no caso itens, etc.
REFERNCIA
Neste caso o objeto no fisicamente copiado e sim feita uma referncia ao objeto do
outro mdulo pelo sistema operacional.
Este novo objeto tem a maioria das propriedades read-only refletindo assim as
definies do objeto pai.
Caso se torne necessrio uma atualizao dos dados de referncia, estes podem ser
obtidos atravs da janela de propriedades do objeto em questo.
No se pode fazer referncia a program units, para isto estas devem ser criadas em
uma biblioteca.
OBJECT GROUPS
Grupos de objetos podem ser criados de modo a facilitar a cpia ou referncia para
outros mdulos. Para se criar um object group basta que no Object Navigator
utilizemos a opo Create(+) para o n Object Group.
Poderemos, agora, arrastar, com o mouse todos os objetos que desejamos grupar
para dentro do Object Group criado.
CONTROLES VBX
Controles do tipo VBX so controles fornecidos por terceiros adotados hoje como
padro em vrias linguagens de programao, tais como o Visual Basic (inventor do
padro), SQLWINDOWS, DELPHI, POWERBUILDER e outros.
Controle
VBX
TYPE
Item Type - VBX Control.
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Bevel - Indica se o item ter aspecto tridimensional.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Current Record Attribute - indica o nome de um atributo visual usado quando
o item for parte do registro corrente.
DATA
Mirror item - especifica o nome do item do qual o item corrente derivado.
Esta propriedade sincroniza o valor de ambos os itens uma vez que quando o
operador altera o valor de um deles o outro, automaticamente, se altera tambm.
Como restrio temos que os itens devem estar no mesmo bloco.
Data Type - tipos de valores que o item pode armazenar (Char, Number,
Date).
Maximum Length - o nmero mximo de caracteres que um item pode
armazenar.
Required - quando esta propriedade est TRUE obriga o operador a
preencher o campo :
Default Value - um valor default para o item, que deve ser compatvel com o
tipo do item. O valor default pode ser um dos seguintes:
Copy Value from Item - identifica a origem do valor para popular o item. Em
uma relao master-detail, o Oracle seta esta propriedade automaticamente no
item foreign key no bloco detalhe. Neste caso informado o nome da primary key
do bloco master, cujo valor copiado para o item foreign key quando um registro
criado ou consultado.
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
NAVIGATION
Enabled - determina se o operador poder usar o mouse para manipular um
item que tenha a propriedade NAVIGABLE setada para OFF.
Navigable - indica se o operador poder ou no navegar para este item.
Mouse Navigate - indica se o operador poder ou no navegar para este item
com o mouse, isto , se o Oracle Forms deve direcionar o foco para o item.
Next Navigation Item - prximo item na seqncia de navegao em relao a
este.
Previous Navigation Item - item anterior na seqncia de navegao em relao a
este.
DATABASE
Base Table Item - indica se o item correspondente a uma coluna na base table do
bloco.
Query Only - indica se o item ser exclusivamente para consulta.
Primary Key - deve ser setado para TRUE para todos os itens que
correspondam a PK na base table do bloco.
Insert Allowed - determina se o operador poder modificar o valor do item em
um registro novo.
Query Allowed - indica que o operador poder navegar para o item quando
estiver no modo de ENTER QUERY. Quando um Form est no modo ENTER
QUERY, o Oracle pula todos os campos que tem a propriedade Query Allowed
OFF, mesmo se os itens forem navegveis normalmente.
Update Allowed - mutuamente exclusivo com UPDATE IF NULL. Especifica
que o valor do item poder ser alterado independente do seu contedo.
FUNCTIONAL
VBX Control File - Nome do arquivo VBX.
VBX Control Name - Nome do controle existente dentro do arquivo VBX.
VBX Control Value Property - Nome da propriedade do controle que a
responsvel pelo armazenamento do valor.
MISCELLANEOUS
Hint - texto a ser apresentado na linha de mensagem quando o operador se
posicionar no item.
Auto Hint - marcando esta propriedade o Oracle mostra o contedo da
propriedade Hint quando o foco passa para o item. Desmarcando-se esta opo o
Oracle mostrar o contedo do Hint quando o operador teclar [HELP] ou
selecionar a opo HELP do menu default enquanto posicionado sobre o item.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
desta forma que poderemos fazer acesso ao valor, normalmente, como nos demais
itens Forms.
begin
:vbxKnob := 30;
end;
O PACKAGE VBX
Este pacote tem a finalidade de permitir o acesso e manipulao de propriedades,
eventos e mtodos do VBX que anexarmos nossa aplicao.
Esta trigger ser disparada sempre que um dos eventos do VBX for acionado.
Para identificar qual o evento original disparado, deve-se checar a varivel de sistema
System.Custom_Item_Event, que conter o nome original do evento.
OS MTODOS DE UM VBX
O acesso a um mtodo feito, exclusivamente, com o auxlio do pacote VBX.
TYPE
Item Type - OLE Container.
DISPLAY
Canvas - nome da canvas em que o item ser mostrado.
Displayed - indica se um item ser mostrado a tempo de execuo. O default
TRUE.
X e Y Position - marca a localizao do canto esquerdo superior do retngulo
que envolve o item nas canvas que o item est associado.
Width e Height - correspondem especificao de comprimento (Width) e
altura (Height), do item, ou seja, sua representao na canvas.
Space Between Records - indica o espao entre os registros na canvas para
blocos multi-record.
Bevel - Indica se o item ter aspecto tridimensional.
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
Foreground Color - cor da regio do objeto de foreground. Para itens a cor
do texto.
Background Color - cor da regio do objeto de fundo (background)
Fill Pattern - textura da regio de preenchimento (fill). A textura ser montada
com as cores definidas pelos atributos Foreground Color e Background Color.
Charmode Logical Attribute - especifica o nome de um atributo definido em
um arquivo (Oracle Terminal resouce file) a ser usado como bsico para a
aplicao (ex.: VT100).
White on Black - indica que o objeto ser visto em um vdeo monocromtico
(texto branco sobre fundo preto).
Current Record Attribute - indica o nome de um atributo visual usado quando
o item for parte do registro corrente.
DATA
Mirror item - especifica o nome do item do qual o item corrente derivado.
Esta propriedade sincroniza o valor de ambos os itens uma vez que quando o
operador altera o valor de um deles o outro, automaticamente, se altera tambm.
Como restrio temos que os itens devem estar no mesmo bloco.
Required - quando esta propriedade est TRUE obriga o operador a
preencher o campo.
RECORDS
Items Displayed - especifica o nmero de instncias mostradas para o item
quando o mesmo pertencer a um bloco multi-record.
NAVIGATION
Enabled - determina se o operador poder usar o mouse para manipular um
item que tenha a propriedade NAVIGABLE setada para OFF.
Navigable - indica se o operador poder ou no navegar para este item.
Mouse Navigate - indica se o operador poder ou no navegar para este item
com o mouse, isto , se o Oracle Forms deve direcionar o foco para o item.
Next Navigation Item - prximo item na seqncia de navegao em relao a
este.
Previous Navigation Item - item anterior na seqncia de navegao em relao a
este.
DATABASE
Base Table Item - indica se o item correspondente a uma coluna na base table do
bloco.
Query Only - indica se o item ser exclusivamente para consulta.
Insert Allowed - determina se o operador poder modificar o valor do item em
um registro novo.
Query Allowed - indica que o operador poder navegar para o item quando
estiver no modo de ENTER QUERY. Quando um Form est no modo ENTER
QUERY, o Oracle pula todos os campos que tem a propriedade Query Allowed
OFF, mesmo se os itens forem navegveis normalmente.
Update Allowed - mutuamente exclusivo com UPDATE IF NULL. Especifica
que o valor do item poder ser alterado independente do seu contedo.
FUNCTIONAL
IN PLACE
EXTERNA
OLE Activation Style - indica o evento que ir ativar o item OLE (DOUBLE
CLICK - default, Focus-in, Manual). Manual indica que deve-se usar o comando EDIT
ou OPEN do submenu do OLE popup Menu. Neste caso a propriedade Show OLE
popup Menu deve ser TRUE.
OLE Resize Style - indica como o Objeto OLE ser mostrado na rea
reservada para ele (OLE container).
ANY - todos
NONE - nenhum
STATIC - apenas OLE statics
EMBEDDED - apenas OLE embedded
LINKED - apenas OLE linked
MISCELLANEOUS
Hint - texto a ser apresentado na linha de mensagem quando o operador se
posicionar no item.
Auto Hint - marcando esta propriedade o Oracle mostra o contedo da
propriedade Hint quando o foco passa para o item. Desmarcando-se esta opo o
Oracle mostrar o contedo do Hint quando o operador teclar [HELP] ou
selecionar a opo HELP do menu default enquanto posicionado sobre o item.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
O PACKAGE FORMS_OLE
As rotinas deste pacote utilizam o objeto OLE2 Container criado no Form.
O PACKAGE OLE2
As rotinas deste pacote no utilizam nenhum item OLE2 do Form, a criao do objeto
feita, explicitamente, por rotinas do prprio pacote.
O PACKAGE TEXT_IO
FOPEN
Abre um arquivo para leitura ou gravao. O PATH do diretrio j deve existir, uma
vez que no feita criao pelo FOPEN. A funo FOPEN retorna um file handle que
deve ser usado em todas as operaes de I/O subseqentes no arquivo.
Deve ser declarada uma varivel do tipo TEXT_IO.FILE_TYPE para receber o file
handle.
IS_OPEN
Testa um file handle para ver se ele identifica um arquivo aberto.
Obs: Esta funo indica apenas se o arquivo est aberto ou no, ou seja se o file
handle vlido ou no. Ela no garante que uma operao de I / O posterior usando
o file handle no venha a receber um erro de sistema operacional.
FCLOSE
Fecha um arquivo identificado por um file handle.
GET_LINE
L uma linha de texto de um arquivo aberto identificado pelo file handle e coloca o
texto no buffer de sada (parmetro).
PUT
Armazena o texto presente no buffer no arquivo identificado pelo file handle. A linha
includa no recebe nenhum caracter de fim de linha. necessrio a execuo do
comando NEW_LINE para gerar este caracter quando desejado.
NEW_LINE
Grava um ou mais caracteres de fim de linha para o arquivo identificado por um file
handle.
PUT_LINE
Grava o texto presente no buffer para o arquivo. Este comando adiciona um caracter
de fim de linha ao texto.
PUTF
uma procedure que trabalha de forma semelhante a um printf (do C), porm com
limitaes. A string de formatao pode conter qualquer texto, sendo que os
caracteres %s e \n possuem significado especial.
EXEMPLO
Deseja-se carregar na tabela Projetos X Atividades as atividades realizadas num
determinado mes. O arquivo com estas informaes possui o layout abaixo:
Informao Coluna
Cdigo do projeto 1a6
Cdigo da atividade 7a9
Data de incio 10 a 17 (dd/mm/yy)
Data de fim 18 a 25 (dd/mm/yy)
DECLARE
ARQ TEXT_IO.FILE_TYPE;
BUFFER VARCHAR2(50);
WROW PRJATV%ROWTYPE;
BEGIN
ARQ := TEXT_IO.FOPEN ('C:\LUCIA\CURSO\CARGA.SQL', 'R');
LOOP
TEXT_IO.GET_LINE(ARQ, BUFFER);
WROW.CD_PROJ:= SUBSTR(BUFFER,1,6);
WROW.CD_ATIV := TO_NUMBER(SUBSTR(BUFFER,7,3));
WROW.DT_INI := TO_DATE(SUBSTR(BUFFER,10,8), 'DD/MM/YY');
WROW.DT_FIM := TO_DATE(SUBSTR(BUFFER,18,8), 'DD/MM/YY');
INSERT INTO PRJATV
(CD_PROJ, CD_ATIV, DT_INI, DT_FIM)
VALUES
(WROW.CD_PROJ, WROW.CD_ATIV, WROW.DT_INI, WROW.DT_FIM);
END LOOP;
EXCEPTION
WHEN NO_DATA_FOUND THEN
COMMIT;
TEXT_IO.FCLOSE(ARQ);
END;
GET_APPLICATION_PROPERTY(property);
SET_APPLICATION_PROPERTY(property, value)
BUSY
CROSSHAIR
DEFAULT
HELP
INSERTION
O PACKAGE ORA_FFI
ORA_FFI.FIND_FUNCTION(LIBHANDLE, FUNCNAME)
ORA_FFI.FIND_FUNCTION(LIBNAME, FUNCNAME)
ORA_FFI.FIND_LIBRARY(LIBNAME)
ORA_FFI.GENERATE_FOREIGN(HANDLE)
ORA_FFI.GENERATE_FOREIGN(HANDLE, PKGNAME)
ORA_FFI.IS_NULL_PTR(HANDLE)
ORA_FFI.IS_NULL_PTR(HANDLE)
ORA_FFI.IS_NULL_PTR(HANDLE)
ORA_FFI.LOAD_LIBRARY(DIRNAME, LIBNAME)
ORA_FFI.REGISTER_FUNCTION(LIBHANDLE, FUNCNAME)
ORA_FFI.REGISTER_FUNCTION(LIBHANDLE, FUNCNAME, CALLSTD)
ORA_FFI.REGISTER_LIBRARY(DIRNAME, LIBNAME)
ORA_FFI.REGISTER_PARAMETER(FUNCHANDLE, CARGTYPE)
ORA_FFI.REGISTER_PARAMETER(FUNCHANDLE, CARGTYPE,
LSARGTYPE)
ORA_FFI.REGISTER_RETURN(FUNCHANDLE, CRETURNTYPE)
ORA_FFI.REGISTER_RETURN(FUNCHANDLE,CRETURNTYPE,
PLSRETURNTYPE)
ORA_FFI.UNLOAD_LIBRARY(LIBHANDLE)
No caso do ambiente windows as funes externas devem ser DLLs que depois de
registradas via funes da ORA_FFI podem ser usadas no Forms.
BOILERPLATE IMAGES
So vetores ou bitmap images que importamos de arquivos do sistema ou do
database para uma canvas especfica no mdulo form.
IMAGE ITEMS
So tipos especiais de itens que mostram imagens obtidas da base de dados ou
arquivos do sistema a tempo de execuo.
FORMATOS VLIDOS
Na tabela a seguir so apresentados os formatos de arquivo suportados pelo Oracle
Forms.
MANIPULANDO IMAGENS
O Oracle fornece um conjunto de rotinas para que possamos trabalhar com imagens.
Image_Add(Item1_Id, Item2_Id)
Image_Add(Item1_Id, Item2_Name)
Image_Add(Item1_Name, Item2_Id)
Image_Add(Item1_Name, Item2_Name)
Image_And(Item1_Id, Item2_Id)
Image_And(Item1_Id, Item2_Name)
Image_And(Item1_Name, Item2_Id)
Image_And(Item1_Name, Item2_Name)
Image_Subtract(Item1_Id, Item2_Id)
Image_Subtract(Item1_Id, Item2_Name)
Image_Subtract(Item1_Name, Item2_Id)
Image_Subtract(Item1_Name, Item2_Name)
Image_Xor(Item1_Id, Item2_Id)
Image_Xor(Item1_Id, Item2_Name)
Image_Xor(Item1_Name, Item2_Id)
Image_Xor(Item1_Name, Item2_Name)
Image_Zoom(Item_Id, Zoom_Type, Zoom_Factor)
Image_Zoom(Item_Name, Zoom_Type, Zoom_Factor)
READ_IMAGE_FILE(FILE_NAME, FILE_TYPE, ITEM_ID)
READ_IMAGE_FILE(FILE_NAME, FILE_TYPE, ITEM_NAME)
WRITE_IMAGE_FILE(FILE_NAME, FILE_TYPE, ITEM_ID)
WRITE_IMAGE_FILE(FILE_NAME, FILE_TYPE, ITEM_NAME)
Os PCX e PICT podem ser lidos de arquivos do sistema mas no podem ser gravados
com WRITE_IMAGE_FILE.
Um image item tambm pode ser preenchido por programao com as rotinas
READ_IMAGE_FILE (esta procedure obtm a imagem de um arquivo do sistema e
coloca no item apropriado) e WRITE_IMAGE_FILE (para gravar uma imagem em um
arquivo do sistema).
Uma vez criada, uma Library pode ser associada a qualquer outro mdulo (Form,
Menu ou outra Library).
Desta forma o cdigo criado poder ser chamado de triggers, itens de menu ou outras
rotinas criadas no mdulo chamador.
A mesma Library pode ser associada a mltiplos Forms e Menus, da mesma forma
que um Form ou Menu pode ser associado a mais de uma Library.
Ser mostrado um dilogo (ao lado) para que selecionemos a localizao do arquivo
desejado.
Salve o Form para incorporar a referncia Library como parte da definio do Form.
:bloco.item
:GLOBAL.varivel
:SYSTEM.varivel
:PARAMETER.varivel
pull-down
bar
full-screen
Apesar do mesmo mdulo menu poder executar em diferentes estilos nem todas as
caractersticas esto disponveis em todos os estilos. Por este motivo, quando criamos
um menu, devemos considerar o estilo no qual ele ser apresentado.
plain text
check
radio
separator
magic
prprio mdulo
menus pull-down individuais na hierarquia do mdulo
itens de menu de cada menu individual e seus respectivos comandos
parmetros
rotinas
startup code
Display Menu - Mostra qual o menu (e seus menus dependentes) ser mostrado no
editor.
Cut, Copy, Paste - Opes para o Clipboard (recortar, copiar e colar).
Copy Properties - Copia somente as propriedades de um item de menu para
o Clipboard.
Paste Properties - Copia as propriedades do presentes no Clipboard para o
item de menu.
Create Dow - Cria um item abaixo, se necessrio cria um novo sub-menu.
Create Right - Cria um item direita. Se necessrio cria um novo sub-menu.
Delete - Remove o item do menu.
Expand - Expande o item de menu mostrando o sub-menu dependente.
Collapse - Esconde os menus detalhes de um item de menu.
Expand All - Expande todos os itens de menu incluindo os sub-tens.
Collapse All - Esconde todos os itens e sub-tens de menu.
DISPLAY
Visual Atribute Name - indica o nome de um atributo visual para o objeto.
Font Name - nome da fonte usada para textos no objeto.
Font Size - tamanho da fonte, especificado em points.
Font Style - estilo da fonte (itlico, plain, underline, etc.)
Font Width - largura da fonte (Normal, Expand, Dense, etc.)
Font Weigth - granulao da corda fonte (Bold, Medium, Ligth, etc.)
FUNCTIONAL
Menu Item Type - Pode receber um dos seguintes valores:
Menu Item Radio Group - especifica o radio group ao qual o item pertence.
SECURITY
Menu Item Roles - roles do banco de dados com acesso ao item de menu.
Display w/o Privilege - indica se o item deve ser apresentado ou no para os
usurios que no tenham acesso a ele.
MICELLANEOUS
Hint - texto explicativo presente na linha de mensagem quando o foco estiver
sobre o item de menu,
Help - texto explicativo mais detalhado que o hint. Aparece quando o operador
teclar help para o item de menu.
Comment - Comentrio para o item.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
Devemos usar o tipo de comando NULL para um item check ou radio se aquele item
for usado somente para definir um modo de operao ou um contexto para
operaes na aplicao.
PROPRIEDADES DO MENU
Name - nome do menu.
Class - nome da classe a que o menu pertence.
DISPLAY
Title - ttulo para o menu. Tamanho mximo de 40 caracteres.
Subtitle - subttulo (para menus mostrados em full-screen). Tamanho mximo
de 40 caracteres.
Bottom Title - rodap (para menus mostrados em full-screen). Tamanho de 72
caracteres.
MISCELLANEOUS
Tear-off - um submenu que os operadores podem retirar do menu bar e
reposicionar em qualquer lugar da tela. Pode-se habilitar a funcionalidade tear-off
para qualquer submenu, porm, somente no estilo pull-down. Para isto basta que
marquemos TRUE na propriedade tear-off (na window de propriedades do menu).
Comment - Comentrio para o menu.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
DISPLAY
Main Menu - Indica o menu principal (inicial) do grupo de menus.
Startup Code - Especifica um cdigo PL/SQL (opcional) que o Oracle Forms
executa quanto o mdulo carregado na memria no momento da inicializao do
Form (Form startup).
SECURITY
Menu Module Roles - roles do banco de dados com acesso ao mdulo menu.
Use Security - Indica se o Oracle Forms deve usar controle de segurana
para o menu a tempo de execuo. Se desejarmos testar uma aplicao e o
username utilizado no pertencer a nenhuma das roles habilitadas para o menu,
devemos deixar esta propriedade com o valor False.
MISCELLANEOUS
Identification - Para aplicaes que estiverem sendo executadas em ambiente
caracter, esta propriedade especifica uma string que ser apresentada na linha de
mensagem quando o operador navegar para o menu (se o estilo for pull-down ou
bar). Se o estilo for full-screen esta propriedade especifica a string que identifica o
mdulo de menu.
Directory - Especifica o diretrio no qual o Oracle Forms deve procurar o
arquivo .MMX. Esta propriedade s aplicvel quando desejamos que o Oracle
Forms localize o arquivo .MMX atravs de Database Lookup.
Quando usamos Database Lookup, o mdulo menu deve estar armazenado no
banco de dados. A tempo de execuo, o Oracle Forms consulta a definio do
mdulo de menu armazenada no banco de dados para encontrar o diretrio e
nome do arquivo do arquivo "executvel" .MMX.
File - Especifica o nome do arquivo "executvel" .MMX que o Oracle Forms
deve obter a tempo de Form Startup (s vlida para Database Lookup).
Comment - Comentrio para o mdulo.
PARMETROS
Um substitution parameter uma varivel de 2 letras (ex: RN, UN, PW, AD) que pode
ser referenciada no comando de um item de menu.
UN - username corrente
PW - password corrente
AD - diretrio onde o executvel do menu corrente est armazenado
SO - item de menu corrente
TT - tipo de terminal usado no login
LN - linguagem
DATA
Maximum Length - tamanho mximo
Fixed Length - indica que o valor informado pelo operador deve ter o nmero
mximo de caracteres informado pela propriedade size.
Required - indica se o parmetro obrigatrio.
Default Value - este valor mostrado no campo correspondente quando o
dilogo enter parameter values for executado.
FUNCTIONAL
Case Restriction - informe none, upper ou lower. Converte o valor fornecido
para a opo selecionada.
Secure - indica que o valor fornecido pelo operador deve ficar invisvel (ex.:
password).
Label - ttulo do parmetro (aparecer no prompt ao operador)
Parameter Menus - (aplicvel somente a full-screen menus). Os nome dos
menus com os quais desejamos que os parmetros sejam associados.
MICELLANEOUS
Hint - mensagem que aparecer na linha apropriada quando o dilogo enter
parameter values for executado.
Comment - Comentrio para o parmetro.
Reference Information - indica o objeto ao qual este se refere (mdulo,
localizao e nome).
MENU
Menu Module - Nome do mdulo Menu.
Menu Style - Indica o estilo de apresentao do menu: Bar, Full-Screen, Pull-
Down.
Use File - Quando True, indica que a propriedade Menu Module contm o
nome do arquivo .MMX do menu. Quando False, indica que a propriedade Menu
Module contm o nome de um mdulo Menu salvo no banco de dados.
Starting Menu - Esta propriedade permite que seja feita a substituio da
indicao de Menu Principal dentro de um mdulo. Os operadores no podero
navegar para menus acima daquele indicado como starting menu.
Menu Role - Especifica a role de segurana que o Oracle Forms deve usar
para executar o menu. Quando esta propriedade especificada, o Oracle Forms
executa o menu indicado como se o operador corrente fosse um membro da role
de segurana especificada.
DIRECT REFERENCE
Para fazermos referncia ao arquivo .MMX diretamente, no painel de propriedades do
Form ao qual desejamos associar o Menu informamos o diretrio e o nome do arquivo
de Menu na propriedade Menu module e preenchemos a propriedade Use File para
TRUE.
DATABASE LOOKUP
Se o menu estiver armazenado no database e se o Form for conectado quele
database a tempo de execuo, devemos: