AcuBench - Carlos Piergentile

Transcrição

AcuBench
Manual
Desenvolvendo com AcuBench
Manual Inicial
Centro de Serviços INTERON – CSI
AcuBench
Apostila
Índice
Capítulo I – Introdução ao Acubench............................................................................. 005
Capítulo II – Componentes.............................................................................................
– Workspace..................................................................................................
– Projeto.........................................................................................................
– Propriedades / Configurações....................................................................
– Layout de Arquivos.....................................................................................
– Programa....................................................................................................
– Menu e Barra de Ferramentas do Acubench.............................................
– File...........................................................................................................
– Edit...........................................................................................................
– View.........................................................................................................
– Project......................................................................................................
– Build.........................................................................................................
– Debug......................................................................................................
– Align.........................................................................................................
– Format......................................................................................................
– Tools........................................................................................................
006
007
007
007
007
007
007
008
009
010
011
011
012
013
014
014
Capítulo III – Definição de Projeto.................................................................................. 016
Capítulo IV – Configuração do Projeto..........................................................................
– Compiler....................................................................................................
– Runtime.....................................................................................................
– Environment..............................................................................................
– Library.......................................................................................................
018
018
019
020
021
Capítulo V – Workspace................................................................................................
– Structure...................................................................................................
– Projeto....................................................................................................
– Programa...............................................................................................
– File............................................................................................................
– Data..........................................................................................................
022
022
023
023
024
026
Capítulo VI – Layout de Arquivo (fd e sl)........................................................................
– File Designer.............................................................................................
– File Control.............................................................................................
– Definition................................................................................................
– Key.........................................................................................................
– IO Handling............................................................................................
028
029
029
032
034
035
Página 1
AcuBench
Apostila
– XFD……................................................................................................. 036
Capítulo VII – Definição de Programa........................................................................... 037
Capítulo VIII – Configuração do Programa..................................................................... 040
Capítulo IX – Definição da Screen – Programa............................................................
– Componente Toolbox..............................................................................
– Property Window.....................................................................................
– Alphabetic (Propriedades)...................................................................
– Label.................................................................................................
– Push Button......................................................................................
– Entry Field.........................................................................................
– Check Box.........................................................................................
– Radio Button.....................................................................................
– ScrollBar...........................................................................................
– Combo Box.......................................................................................
– Bitmap...............................................................................................
– Bar....................................................................................................
– Frame................................................................................................
– List Box.............................................................................................
– Menu.................................................................................................
– Toolbar..............................................................................................
– Tab....................................................................................................
– Grid...................................................................................................
– Treeview...........................................................................................
– Web Browser....................................................................................
– Status Bar.........................................................................................
– Date Entry.........................................................................................
– Window.............................................................................................
– Event (Eventos)...................................................................................
– Label.................................................................................................
– Push Button......................................................................................
– Entry Field.........................................................................................
– Check Box.........................................................................................
– Radio Button.....................................................................................
– ScrollBar...........................................................................................
– Combo Box.......................................................................................
– Bitmap...............................................................................................
– Bar....................................................................................................
– Frame................................................................................................
– List Box.............................................................................................
Página 2
045
048
049
049
049
050
052
054
056
057
058
060
061
062
064
067
067
067
069
075
078
079
080
081
083
083
084
084
085
086
087
087
088
088
089
089
AcuBench
Capítulo
Apostila
– Menu.................................................................................................
– Toolbar..............................................................................................
– Tab....................................................................................................
– Grid...................................................................................................
– Treeview...........................................................................................
– Web Browser....................................................................................
– Status Bar.........................................................................................
– Date Entry.........................................................................................
– Window.............................................................................................
– Drag And Drop........................................................................................
– Bitmap...............................................................................................
– Check Box.........................................................................................
– Combo Box.......................................................................................
– Date Entry.........................................................................................
– Entry Field.........................................................................................
– Grid...................................................................................................
– Label.................................................................................................
– List Box.............................................................................................
– Paged Grid........................................................................................
– Paged List Box..................................................................................
– Radio Button.....................................................................................
– Web Browser....................................................................................
091
091
091
092
094
094
095
095
096
097
098
098
098
100
100
101
103
104
106
109
114
114
X – Definição do Report – Programa.............................................................
– Section Controller…................................................................................
– Header & Footer..................................................................................
– Detail Section…...................................................................................
– Group Section…..................................................................................
– Report Componente Toolbox..................................................................
– Property Window.....................................................................................
– Report Label.....................................................................................
– Report Entry Field.............................................................................
– Report Line……….............................................................................
– Report Radio Button.........................................................................
– Report Check Box.............................................................................
– Report Box……….............................................................................
– Report Image....................................................................................
– Report Grid.......................................................................................
– Report Occurs…...............................................................................
– Report Date Time..............................................................................
– Report Table.....................................................................................
115
116
117
117
117
118
119
119
119
120
121
121
121
122
122
123
124
125
126
Página 3
AcuBench
Apostila
– Report...............................................................................................
– Report Header..................................................................................
– Page Header.....................................................................................
– Group Header...................................................................................
– Detail.................................................................................................
– Group Footer.....................................................................................
– Page Footer…...................................................................................
– Report Footer....................................................................................
– Event (Eventos)...................................................................................
– Drag And Drop........................................................................................
– Principais Parágrafos do Relatório.........................................................
126
127
127
128
128
128
128
128
129
129
130
Capítulo XI – Definição da Working Section – Programa............................................. 133
Capítulo XII – Definição da Linkage Section – Programa.............................................. 135
Capítulo XIII – Event Paragraph – Programa................................................................. 137
Capítulo XIV – Data Set – Programa..............................................................................
– Property Window.....................................................................................
– Event (Eventos)...................................................................................
– Principais Parágrafos do Data Set.......................................................
138
138
138
138
139
Capítulo XV – Geração, Compilação e Execução ........................................................
– Gerar o Programa..................................................................................
– Compilar o Programa.............................................................................
– Executar o Programa.............................................................................
– Correção de Erros de Compilação.........................................................
– IO-Handling.........................................................................................
– Eventos...............................................................................................
– Relatório..............................................................................................
140
140
140
141
142
142
142
142
Capítulo XVI – Passo a Passo no Acubench......... ........................................................
– Criando o Projeto...................................................................................
– Criando e Importando a FD/SL..............................................................
– Criando o Programa...............................................................................
– Criando o Data Set................................................................................
– Criando a Tela.......................................................................................
– Criando o Relatório................................................................................
– Gerando, Compilando e Executando o Programa.................................
143
143
143
145
145
146
147
149
Página 4
AcuBench
Apostila
Capitulo I – Introdução ao AcuBench
O AcuBench é uma ferramenta de desenvolvimento integrada (IDE) que possibilita a
criação e manutenção de aplicações COBOL em ambiente gráfico, customizando o
desenvolvimento, facilitando a administração e
disponibilizando a execução das
aplicações em 600 plataformas suportadas pelo Acucobol.
Principais Características:
o Interface integrada: WORKSPACE, PROJECT e PROGRAM;
o Automatização na geração de código;
o Interface gráfica para a criação e manutenção de parágrafo lógico e seções como
event procedures, working storage, linkage section, data layout (fd e sl) e
associação entre arquivos;
o Suporte à tecnologia Thin Client;
o Interface gráfica para utilitários Acucobol (cblutl,vio,logutl,vutil,axdefgen, acu4glfd,
xml2fd...);
o Version control system;
o Integração com o depurador (debuger);
o Interface gráfica para definição de telas/relatórios gráfico ou caracter;
o Administração e desenvolvimento de múltiplos projetos;
o Acesso a programas e utilitários externos;
o Editor gráfico sensitivo a sintaxe COBOL;
o Inserção de arquivos templates;
o Suporte a ActiveX e .NET;
o Importação de telas;
o Conversão de telas caracter para telas gráficas;
o Definição de Diagrama de Fluxo do Controle (CFD) Control Flow Diagram.
Configuração Mínima Recomendada
Hardware
- Pentium Intel, III megahertz ou superior.
- 64 megabytes de RAM ou superior.
- Mouse.
- Resolução de vídeo 800 X 600 VGA.
Software
- Windows 98, 2000, 2003, ME, NT 4.0, ou XP.
- Acucobol (compilador e runtime).
Página 5
AcuBench
Apostila
Capitulo II – Componentes
O AcuBench organiza o ambiente de desenvolvimento das aplicações em:
Workspace, Projeto e Programa. Um Workspace padrão fornece uma área de trabalho
comum para um ou mais projetos. Um projeto contém todos os arquivos e recursos para
um ou mais programas. Cada projeto consiste em código fonte COBOL, arquivos de
estrutura de dados e configurações do projeto.
Página 6
AcuBench
Apostila
o WORKSPACE
O workspace é a interface de desenvolvimento que organiza a visualização e a
interação de elementos, contendo os locais utilizados pelo projeto, arquivos e recursos do
compilador e runtime. Este tópico será detalhado no capitulo V.
O workspace é criado no momento da definição do projeto e divide-se em três
partes:
Aloja as informações estruturais do projeto e programas relacionados a ele.
Exibe as pastas criadas para o projeto corrente e o respectivo conteúdo de
cada uma. Permite a inclusão de fontes externos ao projeto.
Aloja as informações estruturais do layout dos arquivos utilizados no
projeto (fd e sl).
o PROJETO
Projeto é a coleção dos arquivos necessários para compilar, executar e depurar uma
aplicação, composto por arquivos fontes, bibliotecas, arquivos de definição de tela, layout
de arquivo, log’s, arquivos de imagem e áudio. Cada projeto contém um conjunto de
pastas para organizar seus arquivos e uma definição de configuração para o compilador e
o runtime.
o PROPRIEDADES / CONFIGURAÇÕES
O Acubench permite relacionar configurações e templates para o projeto, ou para
programas individualmente.
o LAYOUT DE ARQUIVOS
Consiste na criação ou importação de layouts de arquivos (fd‘s e select),
relacionando a eles parágrafos lógicos e definindo associação entre os layouts existentes
no projeto.
o PROGRAMA
A definição do programa é caracterizada pelo tipo de tela ou relatório utilizado
(caracter/gráfico), definições e associação de variáveis, controles, parágrafos lógicos e
layout de arquivos.
Página 7
AcuBench
Apostila
o MENU E BARRA DE FERRAMENTAS DO ACUBENCH
File: Contém os atributos para o Workspace e o Projeto.
Item
New
Open
Close
Open Workspace
Save Workspace
Close Workspace
Open Project
Save Project
Save
Save As
Save All
Page Setup
Print Setup
Print Preview
Print
Recent Workspaces
Exit
Descrição
Cria o projeto, o programa, a screen, o report, o
documento, a fd e sl.
Abre documento existente.
Fecha o documento aberto.
Abre um Workspace.
Salva o Workspace.
Finaliza o Workspace.
Abre um projeto existente no Workspace corrente
(*.psf).
Salva o projeto (*.pjf).
Salva o documento aberto.
Salva o documento corrente com outro nome ou
local diferente.
Salva Workspace, Projeto e todos documentos
abertos.
Configura pagina (cabeçalho, rodapé, cores, etc).
Configura a impressora a ser impresso o documento
Preview da impressão.
Imprime documento aberto.
Lista os últimos projetos abertos.
Finaliza o AcuBench.
Edit: Contêm atributos do editor e do screen design.
Página 8
Atalho
Ctrl+N
Ctrl+O
Ctrl+Q
Ctrl+S
Ctrl+M
Ctrl+K
Ctrl+E
AcuBench
Apostila
Item
Descrição
Undo
Desfaz a última ação.
Redo
Refaz a última ação.
Cut
Recorta controle ou string.
Copy
Copia controle ou string.
Paste
Cola controle ou string.
Delete
Elimina o controle ou a string.
Seleciona todo documento ou todos controles do
Select All
formulário.
Find
Localiza uma string.
Find Next
Localiza a próxima string no documento.
Find in Files
Localiza string em arquivos específicos.
Find in Objects
Localiza string nos controles do Workspace.
Replace
Substitui string no documento corrente.
Replace in Files
Substitui string em arquivos específicos.
Posiciona o cursor no documento.
Begin
No inicio da linha.
End
No fim da linha.
Go To
Line
Na linha optada.
Previous Error
No erro acima da linha.
Next Error
No erro abaixo da linha.
Insere um marcador no documento.
Toggle Bookmark
Insere o marcador.
Posiciona o cursor no
Next Bookmark
marcador abaixo.
BookMark
Posiciona o cursor no
Previous Bookmark
marcador acima.
Apaga todos os
Clear All Bookmarks
marcadores.
List Paragraphs
Lista todos os parágrafos
List Variables
Lista todas as variáveis.
Lista as variáveis de
List Constants
nível 78.
Lista o nome dos copy´s
List Copy Files
contido no programa.
Insere código template
Advanced
Code Template
no documento.
Open Copy File
Abre o copy selecionado.
Adiciona o conteúdo de
Insert File
um arquivo.
Find Scope
Seleciona um bloco.
Posiciona no final de
Verb Block Match
uma instrução lógica.
Create/Update CFD Define o Diagrama de Fluxo de Controle de um fonte
View: Contêm os atributos da barra de ferramenta.
Página 9
Atalho
Ctrl+Z
Ctrl+Y
Ctrl+X
Ctrl+C
Ctrl+V
DEL
Ctrl+A
Ctrl+F
F3
Ctrl+H
Ctrl+J
AcuBench
Apostila
Item
Descrição
Atalho
Standard
Visualiza a barra.
Project
Visualiza a barra.
Editor
Visualiza a barra.
Debug
Visualiza a barra.
Toolbars
Align
Visualiza a barra.
Inclui um link de um
Launch Bar
aplicativo externo.
Customize
Personaliza as barras.
Status Bar
Visualização da barra de status do Acubench.
Visualiza janela de propriedades do
Workspace
Workspace.
Visualiza janela responsável pelo status de
Output Window
busca, compilação, etc.
Visualiza janela de propriedades do controle
Property Window
e do data set.
Visualiza janela dos controles da screen
Screen Component Toolbox
design.
Visualiza janela dos controles do report
Report Component Toolbox
design.
Visualiza janela de associação entre variável
Drag and Drop
e controle.
Visualiza monitoramento de
Watch
variáveis.
Visualiza o nome do arquivo
Call Stack que
se
encontra
cada
parágrafo.
Debug Window
Visualiza a quantidade de
Memory
memória utilizada.
Mostra todas as threads e
Threads
permite
manipulação
de
execução das mesmas.
Visualiza o path dos arquivos relacionados ao
Full Path Filename
projeto.
Rule Bar
Visualiza a régua no editor.
Visualiza no lado esquerdo do editor o
Line Number Pane
número da linha.
Disponibiliza área no editor para inserir o
Bookmak Pane
marcador de página.
Project: Contêm os atributos do projeto. Este tópico será detalhado no capitulo III.
Página 10
AcuBench
Item
Add/Remove Files
New Folder
Settings
Set Active Mode
Properties
Create Alias
Apostila
Descrição
Atalho
Insere arquivos externos no projeto corrente.
Cria uma nova pasta para ser utilizada pelo
projeto.
Configura as opções do compilador, runtime e
variáveis de ambiente para o projeto.
Habilita conjunto de configurações do compilador
e do runtime para o projeto.
Visualiza o nome, diretórios do projeto e indica o
servidor utilizado com a tecnologia Thin Client.
Configura o servidor que contem o runtime e os
programas para serem executados remotamente
(Thin Client).
Build: Contêm os atributos para os programas.
Item
Generate
Regenerate Workspace
Compile
Build Workspace
Rebuild Workspace
Reparse
Reparse All
Execute
Debug (Runtime)
Allow Parameters
Use Thin Client
Descrição
Atalho
Gera o código fonte do componente estrutural
selecionado (programa, data layout, etc...).
Gera o código fonte para todos os
componentes do Workspace.
Compila o programa selecionado (ccbl32 / ccbl) Ctrl+F7
Gera os fontes dos programas que foram
alterados (indicados pelo símbolo *) e compila
F7
todos os programas de todos os projetos
pertencentes ao Workspace.
Compila todos os programas de todos os
projetos contidos no Workspace (ccbl32 / ccbl).
Identifica os copy´s contidos no fonte
selecionado.
Identifica os copy´s contidos nos fontes de
todos os programas dos projetos pertencentes
ao Workspace.
Executa o programa selecionado (wrun32 /
Ctrl+F5
runcbl).
Executa o programa selecionado com o debug.
Executa o programa selecionado com outros
parâmetros de execução.
Parâmetro do projeto que usa a tecnologia Thin
Client.
Debug: Contêm os parâmetros pré-definidos para depuração dos programas que
possui total interação com o editor.
Página 11
AcuBench
Apostila
Item
Descrição
Cria log de seqüência do
Trace File
arquivo.
Cria log de seqüência de
Trace Paragraphs
parágrafos.
Cria log de seqüência de
Trace Screens
sintaxes de screen.
Apaga o conteúdo do log
Trace Option
Trace Flush
após a operação de Write.
Cria log de todas as
Trace General
seqüências descritas acima.
Nível de detalhamento do
Trace Levels
log.
Trace to Debug Cria log de todas as
Window
seqüências, menos de nível.
Go
Inicia a execução do programa.
Finaliza a seção do debug corrente e inicia uma nova
Restart
seção.
Finaliza a seção do debug corrente e continua com o
Exit Debbuger
debug aberto.
Quit Debbuging
Finaliza a seção e o debug.
Finaliza a execução do programa e retorna para o
Interrupt
debug.
Step Into
Executa o debug na seqüência lógica (passo a passo)
Step Over
Executa o debug na seqüência lógica dos parágrafos.
Executa o programa na sessão do debug durante a
Step Out Paragraph
execução de um parágrafo.
Executa o programa na sessão do debug durante a
Step Out Program
execução da sintaxe “call”.
Auto Step
Executa automaticamente o programa passo a passo.
Executa o programa e retorna ao debug na linha
Skip To Line
solicitada.
Executa o programa e retorna ao debug na posição
Run To Cursor
do cursor.
Record Script
Salva as configurações feitas no debug.
Executa o debug com as configurações salvas
Run Script
anteriormente.
Marca o parágrafo onde o cursor deverá retornar
Breakpoints
durante o debug.
Threads
Visualiza os threads em execução.
Quick Watch
Visualiza monitoramento de variáveis.
Atalho
F8
F12
F11
F10
Align: Contém os parâmetros para o alinhamento dos controles no Screen Design.
Página 12
AcuBench
Item
Align Control
Space Evenly
Adjacent
Make Same Size
Size to Content
Lock Controls
Tab Order
View Grid
Toggle Guide
Apostila
Descrição
Centraliza o controle na
Center Horizontal
horizontal com relação à tela.
Centraliza o controle na
Center Vertical
vertical com relação à tela.
Ajusta
os
controles
a
esquerda a partir do que
Left
possuir a borda de seleção
azul.
Ajusta os controles a direita a
Right
partir do que possuir a borda
de seleção azul.
Ajusta os controles pelo topo
Top
a partir do que possuir a
borda de seleção azul.
Ajusta os controles pelo
rodapé a partir do que
Bottom
possuir a borda de seleção
azul.
Posiciona o controle a partir
To Grid
de
um
ponto
de
posicionamento.
Ajusta espaço vertical a partir
Across
do que possuir a borda de
seleção azul.
Ajusta espaço horizontal a
Down
de seleção azul.
Une
os
controles
na
Horizontal
horizontal.
Vertical
Une os controles na vertical.
Define a largura a partir do
Width
que possuir a borda de
seleção azul.
Define a altura a partir do
Heigth
que possuir a borda de
seleção azul.
Define a altura e largura a
Both
de seleção azul.
Ajusta o tamanho do controle de acordo com o
tamanho do título. (Label, check, radio, etc...).
Impede a movimentação do controle.
Define a seqüência de accept dos campos.
Visualiza pontos de posicionamento no formulário.
Habilita a régua.
Format: Contêm parâmetros para o editor.
Página 13
Atalho
Alt+Left
Alt+Reght
Alt+Up
Alt+Down
Shift+F7
Ctrl+L
Ctrl+D
Ctrl+G
AcuBench
Apostila
Item
Descrição
Atalho
Altera a primeira letra da palavra
Capitalize
Ctrl+G
selecionada para maiúscula.
Altera a palavra selecionada para
Uppercase
Ctrl+Shift+U
maiúscula.
Altera a palavra selecionada para
Lowercase
Ctrl+U
minúscula.
Comenta
o
bloco
selecionado
Comment Block
acrescentando “*”.
Descomenta o bloco selecionado retirando
Uncomment Block
“*”.
Reorganiza o documento a partir das linhas
Sequence Number
informadas.
Altera o recuo da linha de acordo com a
Indent To Next
próxima linha .
Altera o recuo da linha de acordo com a
Indent To Previous
linha anterior.
Altera o formato do documente de Ansi para
ANSI To Terminal Font
Terminal.
Tools : Contêm os utilitários Acucobol e configurações gerais para o Acubench.
Item
Descrição
Exibe graficamente o utilitário Acucobol cblutl32 responsável pela
Cblutl
união de objetos e bibliotecas em um único objeto.
Vio
Backup do projeto (.vio)
Exibe graficamente o utilitário Acucobol logutl, visualizador de log
Logutl
de transação de arquivos vision.
Exibe graficamente o utilitário Acucobol vutil, manipulador de
Vision File Utility
arquivos indexados vision.
Executa o aplicativo Alfred, sua funcionalidade é interpretação
Alfred
dos arquivos XFD e visualização dos registros.
ActiveX Definitions Generator, utilitário para criação das
Axdefgen
bibliotecas de componentes ActiveX.
.Net Definitions Generator, utilitário para manipulação de
Netdefgen
componentes .Net
Utilitário Acucobol Acu4glfd para criar fd e sl de uma tabela lida
Acu4glFD
através do ODBC.
Utilitário Acucobol que cria fd e sl no formato binary sequential
Xml2FD
baseado num documento xml.
Customize
Personaliza a barra de ferramentas.
Options
Configurações Gerais do Acubench
Environment
General
Parâmetros default para a abertura do projeto no Workspace.
Template
Insere Templates padrão para Tela, Relatório e Documentos.
Version Control Parâmetros para o controlador de versão para o projeto.
Build
Parâmetros default para a compilação do Workspace.
Página 14
AcuBench
Apostila
Debug
Keyboard
Prefix
Miscellaneous
Parâmetros default para o debug do Workspace.
Configuração de teclas de atalho.
Prefixo default para a criação de variáveis.
Configuração geral do projeto.
Code Editor
General
Parâmetro default para quantidade de caracteres por linha.
Format
Tipo de documento default e delimitação de áreas.
Tabs
Tabulação do editor.
Keyword
Teclas de atalho utilizadas no editor.
Code Insight
Códigos padrão utilizados no editor.
Paragraph List Parâmetros para a visualização de parágrafos.
Variable List
Parâmetros para a visualização de variáveis.
Constant List
Parâmetros para a visualização de variáveis constantes.
Copy File List
Parâmetros para a visualização de copy’s.
Screen Design
General
Define o espaço entre os pontos de posicionamento no formulário
Default
Define valor padrão para as propriedades de cada controle.
Visibility
Define as propriedades a serem visualizadas no formulário.
Code Generator
Generate Documment Arquivos a serem gerados para os programas.
Program Tag
Seções e copy’s a serem gerados com os programas.
Data Design
General
Definição de comentários e cores para os níveis da fd e Working
Graphical FD
Definição default de níveis e prefixo de variável para a FD.
Graphical WS
Definição default de níveis e prefixo de variável para Working.
Graphical Linkage Definição default de níveis e prefixo de variável para Linkage.
Report Writer
General
Define o espaço entre os pontos de posicionamento no report.
Default
Define valor padrão para as propriedades de cada controle.
Visibility
Define as propriedades a serem visualizadas no report.
Capitulo III – Definição de Projeto
Página 15
AcuBench
Apostila
Ao definir um projeto o Workspace será criado automaticamente permitindo a
inclusão de outros projetos, assim, facilitando a manipulação e administração de múltiplos
projetos entre os desenvolvedores.
O Acubench utiliza o Version Control (TOOLS  OPTIONS  ENVIRONMENT 
VERSION CONTROL) para definir usuários, permissões de acesso, entre outras prioridades
no acesso e definição de projetos e programas.
Procedimentos para criação do projeto.
- No menu principal, selecionar: FILE  NEW, abrirá janela com opções, selecionar a
aba Project que será visualizada a seguinte janela:
Após a definição das propriedades, confirme-as pressionando o botão OK.
A-) Define a forma de criação do projeto, existe as opções:
Cria o projeto definindo apenas os diretórios e o seu nome.
Página 16
AcuBench
Apostila
Cria o projeto e define os diretórios, o nome do projeto e um programa
com formulário gráfico.
B-) Project Name: Define o nome do projeto.
C-) Location: Define o diretório principal onde será criado o projeto.
D-) Define o Workspace a ser utilizado. O desenvolvedor pode optar em criar um
novo ou utilizar o Workspace aberto.
E-) Mode Info: Exibe os subdiretórios a serem criados para o projeto. O Acubench
por default cria um subdiretório para armazenar cada tipo de arquivo gerado ou
administrado por ele. Esta área permite indicar locais comuns entre os projetos e
configurar o local do servidor para utilização da tecnologia Thin Client.
Capitulo IV – Configuração do Projeto
Página 17
AcuBench
Apostila
Após definir o projeto é necessário configurar os atributos de compilação, execução
e valores default para os controles.
O item de menu SETTINGS é responsável pelas diretivas de compilação e execução
do projeto, para aciona-lo selecione o item PROJECT  SETTINGS onde:
Compiler: Define as diretivas utilizadas pelo compilador, por exemplo, o item
Catalog  File Option possui a diretiva FX responsável pela criação dos dicionários de
dados (XFD) utilizados pelos produtos Acuodbc e Viewvix.
A-) Settings For: Habilita e define conjunto de configurações do compilador.
B-) Área onde informa as diretivas de compilação.
C-) Funções :
Página 18
AcuBench
Apostila
Habilita as configurações default do AcuBench definidas no arquivo
DEFAULT.POF
Salva as diretivas definidas, num arquivo com extensão POF.
Habilita configurações contidas num arquivo com extensão POF.
Confirma Alterações.
Finaliza a janela e não salva as alterações.
Runtime: Define as diretivas utilizadas pelo runtime, destacando-se a –C que indica
o local e o nome do configurador utilizado pelos programas do projeto corrente.
A-) Settings For: Habilita e define conjunto de configurações do runtime.
B-) Área onde informa as diretivas de execução.
Página 19
AcuBench
Apostila
Environment: Define as variáveis de ambiente utilizada pelo projeto:
A-) Manipula as variáveis de ambiente.
Define uma variável de ambiente para o projeto.
Exclui uma variável de ambiente existente.
Adiciona a variável de ambiente na lista.
B-) Variáveis de ambiente utilizadas para o projeto. Valores default.
RUNNAME
COMPILERNAME
CODE_PREFIX
ACUPATH
COPY_PATH
THINNAME
Indica o runtime utilizado pelo projeto (wrun32/runcbl)
Indica o compilador utilizado pelo projeto (ccbl32/ccbl)
Indica os diretórios onde se encontram os programas acucobol (call)
Indica o diretório de instalação dos produtos acucobol
Indica os diretórios onde se encontram os copy´s dos programas.
Indica o utilitário utilizado para a tecnologia Thin Client
Página 20
AcuBench
Apostila
C-) Variable: Variável de ambiente a ser definida/alterada no projeto.
D-) Value: Valor associado à variável de ambiente.
Library: Define um único objeto contendo todos os programas do projeto.
A-) Manipula os itens a serem incorporados no objeto (programa, imagem, etc...).
Exclui um item do objeto.
Adiciona um item ao objeto.
Movimenta o item para cima.
Movimenta o item para baixo.
Página 21
AcuBench
Apostila
Capitulo V – Workspace
O Workspace é a interface de desenvolvimento que organiza a visualização e a
interação dos componentes e elementos dos programas e projetos que o compõem.
O Workspace é dividido em três partes: Structure, File e Data.
programas
Aloja as informações estruturais do projeto e
relacionados
a ele.
Através do clique do botão direito do mouse sobre a janela do workspace será obtido
as seguintes informações :
Item
Save Workspace
Close Workspace
Open Project
Descrição
Salva as alterações realizadas no Workspace.
Fecha o Workspace corrente.
Abre o projeto (*.pjt) no Workspace corrente.
Habilita um conjunto de configurações do compilador e runtime
Set Active Mode
definidas para o projeto (Settings).
Gera os fontes dos programas que foram alterados (indicados
Build Workspace
pelo símbolo *) e compila todos os programas de todos os
projetos pertencente ao Workspace.
Compila todos os programas de todos os projetos
Rebuild Workspace
Identifica os copy´s contidos nos fontes dos programas dos
Reparse All
projetos pertencentes ao Workspace.
Localiza uma palavra nos objetos de todos os projetos
Find in Objects
Altera a janela do Workspace para floating, permitindo o
Allow Docking
deslocamento da mesma sem fixar a posição nas laterais da
ferramenta Acubench.
Hide
Oculta a janela do Workspace.
Página 22
AcuBench
Apostila
Projeto: Exibe as principais propriedades do projeto.
Através do clique direito do mouse sobre o nome do projeto será obtido as seguintes
informações :
Item
New Program
Add Program
Delete
Settings
Save Project
Build
Rebuild
Find in Objects
Properties
Vio
Descrição
Define um novo programa ao projeto.
Adiciona um programa existente ao projeto. (.psf)
Exclui o projeto do Workspace.
Aciona as configurações do compilador, runtime e variáveis de
ambiente para o projeto selecionado.
Salva alterações feitas no projeto. (.pjt)
pelo símbolo *) e compila todos os programas do projeto.
Compila todos os programas do projeto.
Localiza uma palavra nos objetos dos programas do projeto.
Visualiza o nome do projeto, diretórios e indica o servidor utilizado
para a tecnologia Thin Client.
Backup do Projeto. (.vio)
Programa: Exibe as seguintes seções de um programa na forma estruturada.
Item
Screen
Report
Working
Linkage
Event Paragraph
Data Set
Descrição
Habilita área para o desenvolvimento de delas gráficas e
caracter, permitindo a utilização de templates. Arquivos
relacionados à seção (*.stf, *.out, *.scr).
Habilita área para o desenvolvimento de relatórios gráficos e
caracter, permitindo a utilização de templates. Arquivos
relacionados à seção (*.rpt)
Habilita área para definição de variáveis e bibliotecas utilizadas
no programa. Arquivos relacionados à seção (*.wrk).
Habilita área para definição de variáveis e bibliotecas de linkage
utilizadas no programa. Arquivos relacionados à seção (.lnk).
Aciona o editor para definição de parágrafos lógicos
relacionados ao programa e seus controles. Arquivos
relacionados à seção (.evt).
Associa os arquivos de dados definidos no projeto e a forma de
abertura no programa.
Através do clique do botão direito do mouse sobre o nome do programa será obtido
as seguintes propriedades:
Página 23
AcuBench
Apostila
Item
Descrição
View
Visualiza o fonte principal do programa (*.cbl).
Generate Source
Gera fonte Cobol.
Cria screen (caracter ou gráfica) para o programa utilizando
New Screen
templates (*.stf).
Add Screen
Adiciona screen já existente (*.out, *.stf) ao programa.
Cria relatório (caracter ou gráfico) para o programa utilizando
New Report
templates (*.wif).
Add Report
Adiciona relatório existente (*.wif) ao programa.
Define os arquivos de dados, definidos no projeto, e a forma
New Data Set
de abertura pelo programa.
External Paragraph Indica parágrafos contidos em bibliotecas externas.
External Variable
Indica as variáveis contidas em bibliotecas externas.
Save
Salva as alterações feitas na estrutura do programa.
Delete
Exclui o programa do projeto.
Delete From Disk
Exclui fisicamente o arquivo do programa (*.psf).
Compile
Compila o fonte do programa (ccbl32/ccbl).
Reparse
Identifica os copy´s contidos no fonte do programa.
Executa o programa uma vez que o mesmo não contenha
Execute
erros (wrun32/runcbl).
Debug (Runtime)
Depura o programa.
Find in Objects
Localiza uma palavra nos objetos do programa.
Habilita configuração para definir tela inicial, variáveis de
Properties
teclado (crt status) e arquivos a serem gerados pelo programa.
Exibe as pastas criadas para o projeto corrente e o respectivo
conteúdo de cada uma. Permite a inclusão de fontes externos ao
projeto.
Página 24
AcuBench
Apostila
O File exibe o fonte dos arquivos do projeto por categorias. As extensões dos
arquivos são associadas à sua categoria correspondente, como segue:
Source
*.cbl; *.cob
Screen
*.scr; *.stf
Report
*.rpt; *.rtf
Copylib
*.cpy; *.wrk; *.lnk; *.lks; *.mnu; *.prd; *.evt; *.def.
*.acu; *.cbx; *.obj; *.lib
Object
List
*.lst; *.log; *.arq
Resource *.ico; *.bmp; *.jpg; *.jpe; *.jpeg
FD
*.fd;*.sd;*.sl
Remote
*.acu; *.cbx; *.obj; *.lib
Ao adicionar um fonte externo ao projeto, é necessário especificar em qual categoria
ele pertence.
Através do clique do botão direito do mouse sobre o nome do projeto será obtido as
seguintes propriedades:
Item
Add/Remove Files
New Folder
Delete
Settings
Save Project
Build
Rebuild
Find in Objects
Properties
Vio
Descrição
Adiciona fontes externos ao projeto.
Cria uma nova pasta para o projeto.
Exclui o projeto do Workspace.
Aciona as configurações do compilador, runtime e variáveis de
ambiente para o projeto.
Salva alterações feitas no projeto (.pjt).
pelo símbolo *) e compila todos os programas do projeto.
Compila todos os programas do projeto.
Localiza uma palavra nos objetos dos programas do projeto.
Visualiza o nome do projeto, diretório e indica o servidor
utilizado para a tecnologia Thin Client.
Através do clique do botão direito do mouse sobre uma das pastas será obtido as
Item
New File
Add/Remove Files
Empty
Find in Objects
Properties
Descrição
Cria um novo arquivo na pasta selecionada.
Adiciona ou remove arquivos na pasta selecionada.
Limpa o conteúdo da pasta, excluindo fisicamente os arquivos
existentes na mesma.
Localiza uma palavra nos objetos do projeto.
Habilita as propriedades da pasta selecionada, informando os
tipos de arquivos suportados e localização.
Página 25
AcuBench
Apostila
Aloja as informações estruturais do layout dos arquivos utilizados no
projeto (*.fd e *.sl).
O Data exibe ícones representando arquivos de dados que possuem um Data
Layout File (.dlt) correspondente. Nessa seção é possível estabelecer relacionamento
entre os arquivos.
O Data Layout Files é a representação estrutural do layout de arquivo e pode ser
associado a um ou mais programas no projeto. O Data pode ser criado ou importado
através de uma FD e SL existente.
Através do clique do botão direito do mouse sobre o nome do projeto será obtido as
seguintes informações:
Item
New FD/SL
Add FD/SL
XML2FD
Associate FD/SL Files
Refresh All
Delete
Settings
Save Project
Build
Rebuild
Find in Objects
Properties
Descrição
Cria layout de dados FD e SL (*.dlt).
Adiciona layout de arquivo existente ao projeto (*.dlt).
Aciona o utilitário Acucobol XML2FD para criar fd/sl no
formato binary sequential baseado num documento XML.
Estabelece relacionamento entre arquivos.
Atualiza o conteúdo dos arquivos *.fd e *.sl com os *.dlt.
Exclui o projeto do Workspace corrente.
Configura diretivas de compilação, execução e variáveis de
ambiente.
Salva alterações feitas no projeto. (.pjt)
Gera os fontes dos layout´s que foram alterados (indicados
pelo símbolo *).
Gera todos os layout´s do projeto.
Localiza uma palavra nos objetos dos programas..
Visualiza o nome e diretório do projeto e indica o servidor
utilizado para a tecnologia Thin Client.
Página 26
AcuBench
Vio
Apostila
Através do clique do botão direito do mouse sobre o ícone do data layout será obtido
as seguintes informações:
Item
View arquivo .fd
View arquivo .sl
Open
Event Editor
Generate FD/SL
Descrição
Visualiza o fonte gerado do arquivo .fd.
Visualiza o fonte gerado do arquivo .sl.
Abre a estrutura gráfica do layout do arquivo (*.dlt)
Abre o Editor para inserção de rotinas lógicas.
Gera o fonte para fd e sl.
Cria um programa contendo o copy da fd e sl, para que o
Make XFD File
mesmo seja compilado com a opção –FX, criando assim o
dicionário de dados (XFD).
Find in Objects
Localiza uma palavra nos objetos do projeto.
Delete arquivo.dlt Exclui o arquivo de layout (.dlt) do projeto.
Delete From Disk Exclui fisicamente o arquivo de layout (*.dlt).
Save arquivo.dlt
Salva as alterações feitas no arquivo.
Refresh
Atualiza o conteúdo do arquivo *.fd e *.sl com o *.dlt.
Informa o nome dos arquivos fd e sl, o diretório e o nome do
Properties
arquivo Vision. Esta propriedade permite alterar o nome do
arquivo fd/sl e o prefixo utilizado nos campos da fd.
Página 27
AcuBench
Apostila
Capitulo VI – Layout de Arquivo (fd e sl)
Após definir e configurar o projeto, é necessário criar ou importar as fd´s e sl´s que
serão utilizadas nos programas pertencentes ao projeto.
Ao definir o layout de arquivo o Acubench irá criar automaticamente o arquivo de
estrutura *.DLT.
Procedimentos para a definição de um arquivo de dados.
No menu principal, selecionar FILE  NEW, abrirá janela com opções, selecionar a
aba FD/SL que será visualizada a seguinte opção:
A-) Identifica o tipo de arquivo a ser criado, existe as opções:
Cria um arquivo (FD/SL) no projeto.
Importa uma FD/SL já existente.
Página 28
AcuBench
Apostila
B-) FD/SL Name: Define o nome da FD/SL.
C-) Unique Prefix: Define o prefixo utilizado para os campos da FD.
D-) File Name: Visualiza o nome do arquivo estrutural utilizado para a FD/SL.
E-) Location: Indica o local da criação da FD/SL.
F-) Add To Existing Project: Indica o projeto onde será criada a FD/SL.
Para a opção IMPORT FROM FILES será exibida tela para indicar o local da fd e sl
existente.
A-) .FD File Path: Encaminhamento da FD.
B-) .SL File Path: Encaminhamento da SL.
Selecionando a opção BLANK, será visualizada a tela estrutural para a definição do
layout do arquivo, chamado de File Designer, que é dividido em 5 partes: File Control,
Definition, Key, IO Handling e XFD.
File Control: Representa a definição da Select. Esta área disponibiliza todas as
opções permitidas para os atributos de uma Select.
Página 29
AcuBench
Apostila
A-) File Name: Nome da FD/SL.
B-) Advanced: Opções adicionais para a Select do arquivo. Utilizada somente para
o arquivo Seqüencial, Relativo e Indexado. Para cada tipo de arquivo uma será
visualizada a seguinte janela:
B1-) Reserve: Habilita a sintaxe RESERVE na Select do arquivo.
B2-) Padding: Informa o caracter a ser adicionado na clausula PADDING.
Página 30
AcuBench
Apostila
B3-) Record delimiter is standard 1: Habilita a sintaxe RECORD DELIMITER.
B4-) With: Habilita a sintaxe WITH, podendo optar por ENCRYPTION, que fará
a criptografia do arquivo ou COMPRESSION que fará a compactação do arquivo.
B5-) Collating: Informa uma palavra que será declarada na SPECIAL-NAMES.
C-) Device: Define o tipo de abertura do arquivo para o projeto.
D-) Name: Define o nome físico para o arquivo de dados, se colocar nome fixo
usar entre “ “, caso contrário apenas digitar o nome da variável que no programa será
criado automaticamente na Working.
E-) Format: Define o formato do arquivo, podendo optar por:
F-) Access Mode: Define o modo de acesso ao arquivo, podendo optar por:
G-) Lock Mode: Define o modo de bloqueio do registro, podendo optar por:
H-) File Status: Define a variável de status, no programa será criada
automaticamente na Working, definida com um sub-nivel 88 composto pela palavra valid.
77 stat-arquivo pic xx .
88 valid-arquivo value "00" THRU "09".
Página 31
AcuBench
Apostila
I-) Comment: Comentário que ficará no arquivo da SL.
Definition: Representa a definição do File Description. Esta área disponibiliza todas
as opções permitidas para os atributos de uma FD.
A-) Advanced: Habilita atributo à FD.
A1-) Declared: Informa o tipo de arquivo, se é EXTERNAL ou GLOBAL.
Página 32
AcuBench
Apostila
A2- ) Detailed Attribute: Informa os atributos do arquivo.
B-) Data item definition: Área para definição das variáveis. A coluna MORE possui
atributos específicos para os campos.
B1-) Atributos adicionais para o campo.
B2-) Comment: Comentário que ficará abaixo do campo no arquivo FD.
C-) Funções para manipulação das variáveis pertencentes à FD.
Exclui variável selecionada.
Exclui todas as variáveis da FD.
Adiciona uma variável acima da selecionada.
Adiciona uma variável abaixo da selecionada.
Adiciona uma variável de sub-nível da selecionada.
D-) Add Item: Define o nível da variável a ser incluída na FD e adiciona copy´s de
outros book's.
E-) Comment: Comentários que ficará no arquivo da FD.
Página 33
AcuBench
Apostila
Key: Define os campos chaves.
A-) Key List: Informações sobre a chave a ser criada, No campo Key Name informa
o nome da chave, em Fields visualiza os campos que compõem a chave, em Comment,
informa o comentário para a chave que ficará na SL do arquivo abaixo a chave e no
campo Type, define o tipo de chave a ser criada, podendo ser:
B-) Funções para manipulação das variáveis da chave.
Adiciona a chave utilizando os campos definidos no item D. A primeira
chave adicionada, automaticamente assumirá o tipo de PRIMARY KEY.
Modifica a chave selecionada.
Exclui a chave selecionada.
Exclui todas as chaves definidas.
C-) Fields Description: Exibe os campos que compõem a Fd para a seleção dos
campos chave. A seleção é feita através do botão (>) que irá transferir os campos
selecionados para a opção Selected Fields compondo as chaves.
Página 34
AcuBench
Apostila
D-) Selected Fields: Indica os campos para a composição da chave. Após a
seleção dos campos, clicar no botão
para confirmar a definição da chave.
IO Handling: Associa parágrafos lógicos à fd e sl, disponibilizando os mesmos para
os programas que possuírem a fd e a sl definida no programa.
A-) Define os parágrafos lógicos relacionados ao layout de arquivo a serem criados.
Utiliza os parágrafos default criados pela
ferramenta, onde não há validação de status. (read, write, rewrite e delete).
Utiliza os parágrafos lógicos definidos nessa
seção.
Não cria parágrafos lógicos associados ao
arquivo.
B-) User-definied IO Paragraphs: Área para definição dos parágrafos lógicos
associados às funções do arquivo.
Página 35
AcuBench
Apostila
C-) Funções para a criação de parágrafos.
Exclui a seção e o parágrafo criado.
Exclui apenas o parágrafo criado, permanecendo a seção.
Adiciona uma seção para a criação do parágrafo.
XFD: Define os parâmetros que serão dados ao arquivo criado com a extensão XDF.
A-) File Directive: Nome que será dado ao arquivo criado com a extensão XFD.
B-) Name Directive: Nome que será dado ao campo da FD.
C-) Use Group Directive: Aplica diretivas para um grupo de campos.
D-) Data Type Directive: Informa o tido de dado do campo.
E-) When Directive: Inclui definições para múltiplos registros.
F-) Comment Directive: Comentário que ficará no arquivo XFD.
Página 36
AcuBench
Apostila
Capitulo VII – Definição de Programa
O programa é composto por variáveis de Working, Linkage, Data Set, Screen,
Report e Event Procedure. Ao definir um programa o Acubench criará automaticamente o
arquivo de estrutura gráfica .PSF. As propriedades e definições do programa estão
localizadas na aba Structure, pertencentes ao componente Workspace.
Procedimentos para a definição de um programa.
aba Program que será visualizada a seguinte opção:
A-) Identifica o tipo de programa a ser criado, existe as opções:
Cria um programa vazio no projeto.
Cria um programa com uma tela gráfica em branco no projeto.
Página 37
AcuBench
Apostila
B-) Program Name: Define o nome do programa.
C-) File Name: Visualiza o nome do arquivo estrutural utilizado para a SCREEN.
D-) Location: Local onde o arquivo estrutural será salvo.
E-) Base Source File: Indica um fonte existente para o arquivo estrutural. Uma vez
indicada essa opção, a ferramenta não criará o fonte principal do mesmo.
F-) Add to Existing Project: Indica o projeto onde será criado o programa.
A aba Structure do componente Workspace, disponibiliza as seguintes seções
relacionadas ao programa.
Define e habilita a área para o desenvolvimento de telas gráficas
e caracter, permitindo a utilização de templates. Arquivos relacionados à seção (*.stf, *.out
e *.scr).
Define e habilita a área para o desenvolvimento de relatórios
gráficos e caracter, permitindo a utilização de templates. Arquivos relacionados à seção
(*.rpt)
Habilita área para definição das variáveis e bibliotecas de
usadas no programa. Arquivos relacionados à seção (*.wrk).
Habilita área para definição das variáveis e bibliotecas de
linkage utilizadas no programa. Arquivos relacionados à seção (*.lnk).
Página 38
AcuBench
Apostila
Aciona o editor para definição de parágrafos lógicos
relacionados ao programa e controles pertencentes ao mesmo. Arquivos relacionados à
seção (*.evt).
Associa os arquivos de dados definidos no projeto e a forma de
abertura dos mesmos no programa.
Página 39
AcuBench
Apostila
Capitulo VIII – Configuração do Programa
Ao definir o programa, o mesmo irá utilizar as configurações e atributos do projeto
TOOLS  OPTIONS, porém é possível alterar os atributos e propriedades de um programa
específico, acessando a opção Properties.
Através do clique do botão direito do mouse sobre o nome do programa
(WORKSPACE), obteremos as seguintes propriedades:
Contém informações gerais do programa.
A-) Program Name: Exibe o nome do programa. Esta propriedade é utilizada para
alterar o nome do programa se necessário.
B-) On program startup, set logo screen to: Indica a tela que possui imagem a ser
visualizada antes do accept das demais.
Página 40
AcuBench
Apostila
C-) On program startup, set main screen to: Indica a tela inicial do programa.
D-) Icon File: Indica ícone para as janelas do programa.
E-) Description: Comentários do programa (REMARKS).
F-) Prompt when program exists: Habilita janela de confirmação para finalizar o
programa quando o usuário selecionar o X da janela ou pressionar uma função cujo valor
da propriedade exception seja igual a 27. Para traduzir ou alterar a mensagem, utilize o
arquivo SHOWMSG.CPY. (\ACUCORP\ACUCBL??\ACUGT\SAMPLE\DEF).
G-) Set as initial program: Indica o programa como menu (inicial) sendo executado
uma única vez.
Visualiza o local e os arquivos definidos para o programa.
Página 41
AcuBench
Apostila
A-) File Name: Exibe o nome do arquivo estrutural.
B-) Generated output files: Visualiza local e arquivos gerados pelo programa.
C-) Last modified: Visualiza atributos do arquivo selecionado.
Configura as variáveis utilizadas para as funções do programa.
A-) Indica a variável definida como CRT STATUS.
B-) Manipula os sub-níveis da variável definida como CRT-STATUS.
Importa as variáveis de nível 88 de um arquivo existente.
Insere variável de sub-nível 88.
Página 42
AcuBench
Apostila
Apaga as variáveis selecionadas.
Seleciona todas as variáveis definidas.
C-) Visualiza as variáveis de sub-nível definidas. Executando o duplo clique sobre a
variável é possível alterar seus atributos.
D-) Do not generate CRT STATUS variable in .wrk: Desabilita a geração da variável
CRT STATUS na working do programa. (*.WRK).
E-) Funções:
Utiliza as configurações definidas em arquivo com a extensão .PRF.
Salva as configurações definidas em arquivo com a extensão .PRF.
Habilita configurações contidas num arquivo com a extensão .PRF.
Confirma as alterações.
Finaliza a janela sem salvar as alterações feitas.
Página 43
AcuBench
Apostila
Define os arquivos e atributos a serem gerados:
A-) Follow project default options: Utiliza as configurações definidas para o
projeto em TOLLS  OPTIONS.
B-) Generated documents: Indica os arquivos que serão gerados pelo programa.
C-) Attributes of generated documents: Determina se os arquivos gerados pelo
programa, serão apenas para leitura, ou poderá haver alteração.
D-) Screen Control Focus: Determina a forma do accept nos controles do
programa. Essa variável aceita 4 valores:
1 – Trabalha em conjunto com a variável CONTROL-VALUE , onde o foco retornará
para o valor informado nessa variável, que respeita a posição de accept da mesma com
relação à tela. Ex: Deseja posicionar o foco no 3º controle de accept na tela, então move
1 para ACCEPT-CONTROL e 3 para CONTROL-VALUE.
Página 44
AcuBench
Apostila
para o valor informado nessa variável, quando ocorrer uma terminação na tela
(TERMINATION-KEY). Ex: Deseja posicionar o foco no 3º controle quando ocorrer uma
termination na tela, então move 2 para ACCEPT-CONTROL e 3 para CONTROL-VALUE.
para o valor informado nessa variável, quando ocorrer uma exceção na tela (EXCEPTIONKEY). Ex: Deseja posicionar o foco no 3º controle quando ocorrer uma exceção na tela,
então move 3 para ACCEPT-CONTROL e 3 para CONTROL-VALUE.
4 – Trabalha em conjunto com a variável CONTROL-ID , onde o foco retornará para o
valor informado nessa variável, que representa o identificador do campo, e não a
seqüência de accept com relação à tela . Ex: Deseja posicionar o foco no 3º controle da
tela, então move 4 para ACCEPT-CONTROL e move o valor referente à propriedade ID para
CONTROL-ID.
E-) Generated Document Format: Define a forma que o programa será gerado. A
opção MERGE TO ONE PROGRAM FILE cria um único fonte (*.cbl) contendo toda a procedure
lógica e a opção SPLIT TO MULTIPLE COPY FILE irá gerar um fonte principal (*.cbl) contendo
copy´s das principais seções do programa (working - *.wrk, screen - *.scr, procedure *.prd, report - *.rpt e rotinas definidas pelo programador - *.evt).
F-) Generate source format: Define a forma de como o fonte será gerado. A opção
ANSI gera o fonte respeitando colunas e a opção TERMINAL não trabalha com respeito
de colunas.
G-) Attributes of Data Set Code Generation: Não permite abrir os arquivos de link.
Página 45
AcuBench
Apostila
Capitulo IX – Definição da Screen – Programa
Após a definição do programa, o desenvolvedor pode adiciona tela(s) ao programa,
selecionando o tipo (gráfica ou caracter) e o modelo (templates).
Procedimentos para a definição de tela.
No menu principal, seleciona FILE  NEW, abrirá janela com opções, selecionar a aba
Screen que será visualizada a seguinte opção:
A-) Tipos de janelas a serem criadas, optando por gráfica ou caracter, existe as
opções:
Cria uma janela gráfica sem controles.
Cria uma janela gráfica com os controles Menu e Push Button.
Página 46
AcuBench
Apostila
Cria uma janela gráfica de logon, com os controles Entry Field, Label e
Push Button.
Cria uma janela caracter sem controles.
Cria uma janela caracter com os controles Menu e Push Button.
Cria uma janela caracter de logon, com os controles Entry Field, Label
e Push Button.
B-) Tipo de janelas gráfica e caracter criadas através de TEMPLATES.
Janela template com os controles que optar.
C-) Form Name: Define o nome da janela.
D-) Unique Prefix: Define o prefixo que será criado como parte do nome de cada
controle.
E-) Create with new program, and add to program: Cria essa janela em um
prorama novo e adiciona esse programa ao projeto aberto.
F-) Add to existing program: Indica o programa onde será criada a janela.
Os principais componentes do Screen Design são: Component Toolbox, Property
Window e Drag and Drop.
Página 47
AcuBench
Apostila
o COMPONENTE TOOLBOX: Componente utilizado para adicionar um controle na
tela.
A-)
Visualiza os controles nativos do Acucobol.
Controle estático utilizado para exibição de texto descritivo.
Botão.
Entrada e visualização de dados.
Seleção de item.
Controle caracterizado pela seleção de um único item pertencente a
um grupo.
Barra de Rolagem.
Caixa para múltiplos itens.
Imagem.
Barra, espécie de Draw.
Moldura.
Lista de visualização de múltiplos registros.
Controle para seleção de itens para executar chamada a um
programa.
Barra de ferramentas.
Controle de abas.
Geração de tabelas (ocorrências).
Visualizador em módulos.
Browser.
Barra de Status.
Visualizador de Data e Hora.
B-)
Visualiza controles ActiveX.
Página 48
AcuBench
Apostila
o PROPERTY WINDOW: Componente utilizado para configurar propriedades para
os controles e programar seus eventos .
A-) Alphabetic: Seção utilizada para a configuração das propriedades de cada
controle, visualizada em ordem alfabética.
Segue lista com todas as propriedades de cada controle.
Propriedade
(Name)
Descrição
Nome do Controle
Ajusta a coluna onde o controle se inicia, em relação à tela.
Ccol
(Somente caracter).
Ajusta a linha onde o controle se inicia, em relação à tela.
Cline
(Somente caracter).
Clines
Ajusta a altura do controle. (Somente caracter).
Color
Informa a cor do título, background e foreground.
Column
Ajusta a coluna onde o controle se inicia, em relação à tela, em
Column in Pixels
pixel.
Csize
Ajusta a largura do controle. (Somente caracter).
Automatic
Na finalização da tela o controle será destruído.
O controle será destruído apenas com o verbo
Permanent
Destroy Type
destroy e não assume modify.
O controle se auto destrói se for adicionado um
Temporary
novo na mesma posição da tela.
Font
Informa a fonte do controle.
Format Picture
Informa a pic do controle, ou a mascara.
Trabalha em conjunto com a variável de ambiente HELPHelp ID
PROGRAM, informa o valor do ID criado no help do controle.
ID
Identificação do controle.
Center
Centraliza o título do label.
Left
Alinha o título do label à esquerda.
Justification
Right
Alinha o título do label à direita.
Unaligned Não ajusta o título do label.
Página 49
AcuBench
Key
Label Offset
Layout Data
Line
Lines in Pixels
No Key Letter
Size
Size in Pixels
Tab Order
Title
Transparent
Visible
Propriedade
(Name)
Bitmap
Bitmap Frame
Bitmap Handle
Bitmap Number
Bitmap Square
Ccol
Cline
Clines
Column
Column in Pixels
Copy Resource
Csize
Destroy Type
Enable
Exception Value
Flat
Apostila
Chave de ativação do controle. Para controles nativos não tem
necessidade da criação do mesmo.
Não utilizado com pixels, ajusta a altura do label em relação ao
Entry Field.
Ajusta o controle, conforme o resize da tela, podendo apenas
mover o controle ou então alterar o seu tamanho.
Ajusta a altura do controle em pixels.
Não ativa o “&” para se tornar uma chave, e sim visualiza o
caracter.
Ajusta a largura do controle.
Ajusta a largura do controle em pixels.
Posição de accept do controle com relação à tela.
Texto que será apresentado no controle.
Não mostra o fundo do label.
Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).
Descrição
Nome do Controle
Adiciona uma imagem ao controle. (aceita BMP ou JPEG).
Cria uma borda em volta do botão se tiver imagem.
Define uma variável HANDLE para a imagem.
Utilizada somente para uma tira de imagens num único
arquivo, informa o número da imagem desejada.
Utilizado somente quando possui imagem, deixa os cantos do
botão quadrado.
(Somente caracter).
(Somente caracter).
Ajusta a coluna onde o controle se inicia, em relação à tela,
em pixel.
Se configurado para verdadeiro, ao gerar o programa o
Acucobol adicionará a imagem ao objeto do programa.
Automatic
Permanent
Temporary
Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).
Determina a tecla de exceção para o controle.
Não apresenta o contorno do botão se tiver imagem.
Página 50
AcuBench
Font
Format Picture
Help ID
ID
Key
Layout Data
Line
Line in Pixels
Lines
Lines in Pixels
Multiline
No Auto Default
No Tab
Pop-Up Menu
Self Act
Size
Size in Pixels
Style
Apostila
Trabalha em conjunto com a variável de ambiente HELPPROGRAM, informa o valor do ID criado no help do controle.
Ajusta a linha onde o controle se inicia, em relação à tela em
pixels.
Ajusta a altura do controle.
Ajusta a altura do controle, em pixels.
Se o título estiver maior que o botão, é adicionada linha para o
título.
O botão não será acionado através do “Enter”.
Não passa pelo foco do controle através da tecla “TAB”.
Determina que o controle menu será acionado através do
clique com o botão direito do mouse.
Ativa o valor setado no Exception Value ou Termination Value.
Ajusta a largura, em pixels.
Cria o efeito de cancelar, é o mesmo que
utilizar TITLE “Cancel”
Cancel
ESCAPE-BUTTON
EXCEPTION-VALUE = 27
Button
OBS.: Pode ser alterado o valor de Title e
Exception, fornecido pela ferramenta.
Default
Cria o efeito do “Enter”, é o mesmo que utilizar
Button
EXCEPTION-VALUE = 13.
Escape
Define o efeito de ESC, é o mesmo que utilizar
Button
EXCEPTION-VALUE = 27.
Cria o efeito de “Enter” é o mesmo que
TITLE "OK"
Ok Button
DEFAULT-BUTTON
TERMINATION-VALUE =
13
OBS.: Pode ser alterado o valor de Title e
Exception, forneceido pela ferramenta.
Não cria nenhum estilo para o controle,
Other
assumindo
o
valor
configurado
nas
propriedades.
Tab Order
Seqüência de accept do controle com relação à tela.
Termination Value Determina uma tecla de terminação para controle.
Title
Visible
Aditional Properties
Unframed
Não cria uma borda em volta do botão se tiver imagem.
Página 51
AcuBench
Apostila
Propriedade
(Name)
Descrição
Nome do Controle
O Foco pula para o próximo controle sem pressionar o “Enter”
Auto
ou “Tab”.
Auto Decimal
Informa a quantidade de casas decimais para o campo.
3D
Borda do controle com efeito 3D.
Border
Boxed
Borda do controle como efeito 2D. (apenas modify).
No Box Não coloca nenhuma borda no controle.
Todos os caracteres serão visualizados em
Lower
minúsculo.
Case
Mixed
Será aceito caracteres MAIÚSCULOS e MINÚSCULOS.
Upper
maiúsculo.
Ccol
(Somente caracter).
Cline
(Somente caracter).
Clines
Color
Informa a cor do controle, background e foreground.
Column
Ajusta a coluna onde o controle se inicia, em relação à tela, em
Column in Pixels
pixel.
Csize
Utilizado em conjunto com a propriedade NO-AUTOSEL, ele
Cursor
reposiciona o cursor no caracter desejado.
Para campos multiline ele posiciona o cursor na coluna
Cursor Col
desejada costuma ser utilizado em conjunto com a propriedade
CURSOR-ROW.
Para campos multiline ele posiciona o cursor na linha desejada
Cursor Row
costuma ser utilizado em conjunto com a propriedade CURSORCOL.
Automatic
Permanent
Destroy Type
Temporary
Enable
Font
Format Picture
PROGRAM Informa o valor do ID criado no help do controle.
ID
Página 52
AcuBench
Justification
Key
Layout Data
Line
Line in Pixels
Lines
Lines in Pixels
Max Lines
Max Text
Max Value
Min Value
No AutoSel
No Tab
Notify Change
Numeric
Pop-Up Menu
Read Only
Required
Secure
Size
Size in Pixels
Apostila
Center
Centraliza o conteúdo no Entry Field.
Left
Alinha o conteúdo do Entry Field à esquerda.
Right
Alinha o conteúdo do Entry Field à direita.
Unaligned Não alinha o conteúdo do Entry Field.
pixel.
Ajusta a altura do controle em pixel.
Utilizado em conjunto com a propriedade MULTLINE, delimita a
quantidade de linhas que o controle terá.
Determina a quantidade máxima de caracteres a ser digitado.
Máximo valor numérico que pode ser digitado no campo.
Costuma ser utilizado em conjunto com a propriedade AUTOSPIN.
Mínimo valor numérico que pode ser digitado no campo.
Costuma ser utilizado em conjunto com a propriedade AUTOSPIN.
No accept do campo não será selecionado o conteúdo digitado.
Gera o evento NTF-SELCHANGE. Permitindo assim, quando
houver alguma alteração na digitação do controle, executar o
evento.
Aceitará somente valor numérico.
Determina que o controle menu será acionado através do clique
com o botão direito do mouse.
Não haverá accept no campo, porém passa pelo foco do
controle.
Obriga a digitação no campo.
No lugar do caracter digitado será visualizado “*”.
Ajusta a largura do controle em pixel.
Página 53
AcuBench
Apostila
Todo o conteúdo digitado no entry field ficará
numa única linha.
Multiline
Permite a entrada de dados em mais de uma linha.
Em campos multiline, é executada a quebra de
Vscroll
linha.
Em campos multiline, cria uma barra de rolagem
Vscroll Bar
na vertical.
Mesmo efeito do AUTO-SPIN, porém usa as teclas
Spinner
de setas no entry field. Quando pressiona a seta, é
recebido o evento MSG-SPIN-UP e MSG-SPIN-DOWN.
Utilizado em conjunto com as propriedades MINVALUE e MAX-VALUE, clicando no scrool são
Auto-Spin
mostrados todos os valores que estão entre essas
propriedades.
Finaliza a entrada de dados através do “Enter”.
Finaliza a entrada de dados através do “Tab”.
Informa o conteúdo do controle.
Inicia o entry field multiline já com um conteúdo.
Informa a PIC da variável do entry field
Informa uma variável para o entry field, podendo ser do arquivo,
working, linkage...
Valor numérico para receber a ação a ser tomada, Aceita os
seguintes valores:
1 - ACTION-CUT
Corta o conteúdo selecionado.
2 - ACTION-COPY
Copia o conteúdo selecionado.
3 - ACTION-PASTE Cola o conteúdo no entry field.
4 - ACTION-DELETE Apaga o conteúdo selecionado.
5 - ACTION-UNDO
Desfaz a última alteração.
Modifica o texto selecionado atualmente no controle com o valor
atribuído a SELECTION-TEXT. Se nenhum texto for selecionado, o
valor será incluído na posição do cursor. Quando é dado inquire
é retornado o texto selecionado, ou espaços se nada for
selecionado.
Singleline
Style
Tab Order
Use Return
Use Tab
Value
Value Multiple
Value Picture
Value Variable
Visible
Action
Selection-Text
Propriedade
(Name)
Bitmap
Bitmap Frame
Bitmap Handle
Descrição
Nome do Controle.
Adiciona uma imagem ao controle, (BMP ou JPEG) no lugar da
caixa de seleção e título, Ficando com a aparência de um
botão.
Cria uma borda em volta do check se tiver imagem.
Página 54
AcuBench
Bitmap Number
Bitmap Square
Ccol
Cline
Clines
Color
Column
Column in Pixels
Copy Resource
Csize
Destroy Type
Enable
Exception Value
Flat
Font
Framed
Help ID
ID
Key
Layout Data
Left Text
Line
Line in Pixels
Lines
Lines in Pixels
Multiline
No Tab
Notify
Pop-Up Menu
Self Act
Size
Apostila
botão quadrado.
(Somente caracter).
(Somente caracter).
em pixel.
Automatic
Permanent
Temporary
Não apresenta o contorno do check box se tiver imagem.
Cria uma borda em volta do check box se tiver imagem.
Trabalha em conjunto com a variável de ambiente HELPPROGRAM Informa o valor do ID criado no help do controle.
O título ficara à esquerda da caixa de seleção.
pixels.
Ajusta a altura do controle, em pixel.
Se o título estiver maior que o check, é adicionada linha para o
título.
Gera o evento CMD-CLICKED sempre que for selecionada a
caixa de seleção, gerando uma resposta imediata da ação.
Página 55
AcuBench
Size in Pixels
Tab Order
Termination Value
Title
Value
Value Variable
Visible
Vtop
Unframed
Propriedade
(Name)
Bitmap
Bitmap Frame
Bitmap Handle
Bitmap Number
Bitmap Square
Ccol
Cline
Clines
Color
Column
Column in Pixels
Copy Resource
Csize
Destroy Type
Enable
Exception Value
Flat
Font
Apostila
Determina uma tecla de terminação para controle.
Recebe dois valores 1 quando selecionado e 0 quando não
selecionado.
Variável do arquivo, working ou linkage a ser vinculada ao
controle.
O título será alinhado verticalmente no alto do controle.
Não cria uma borda em volta do check se tiver imagem.
Descrição
Nome do Controle.
Adiciona uma imagem ao controle, (BMP ou JPEG) no lugar da
caixa de seleção e título, Ficando com a aparência de um
botão.
Cria uma borda em volta do radio se tiver imagem.
botão quadrado.
(Somente caracter).
(Somente caracter).
em pixel.
Automatic
Permanent
Temporary
Não apresenta o contorno do radio se tiver imagem.
Página 56
AcuBench
Apostila
Group
Group Value
Valor que informa em qual grupo o radio da tela pertence.
Valor recebido para cada radio de um mesmo grupo.
ID
Key
Layout Data
Left Text
O título ficara à esquerda da caixa de seleção.
Line
Line in Pixels
pixels.
Lines
Lines in Pixels
Se o título estiver maior que o radio, é adicionada linha para o
Multiline
título.
Não passa pelo foco dos radios do mesmo grupo através da
No Group Tab
tecla “TAB”
No Tab
Gera o evento CMD-CLICKED sempre que for selecionada a
Notify
caixa de seleção, gerando uma resposta imediata da ação.
Pop-Up Menu
Self Act
Size
Size in Pixels
Tab Order
Termination Value Determina uma tecla de terminação para controle.
Title
Recebe o valor do radio selecionado, o informado no GroupValue
Value.
Variável do arquivo, working ou linkage a ser vinculada ao
Value Variable
controle.
Visible
Vtop
O título será alinhado verticalmente no alto do controle.
Unframed
Não cria uma borda em volta do radio se tiver imagem.
Propriedade
(Name)
Ccol
Cline
Descrição
Nome do Controle.
(Somente caracter).
(Somente caracter).
Página 57
AcuBench
Clines
Column
Column in Pixels
Csize
Destroy Type
Enable
Help ID
ID
Kind
Layout Data
Line
Line in Pixels
Lines
Lines in Pixels
Max Value
Min Value
No Tab
Page Size
Pop-Up Menu
Size
Size in Pixels
Tab Order
Track Thumb
Value
Visible
Propriedade
(Name)
Auto Load
Apostila
em pixel.
Automatic
Permanent
Temporary
Horizontal Informa que a barra de rolagem será na horizontal.
Vertical
Informa que a barra de rolagem será na vertical.
pixels.
Ajusta o valor o máximo na escala de valores legais da barra
de rolagem (máximo 65536). O valor default é "100".
Ajusta o valor o minimo na escala de valores legais da barra
de rolagem. O valor default é "0".
Ajustado para valores indefinidos, descreve o número de
dados que aparecem em um "page".
Gera o evento MSG-SB-THUMBTRACK quando a barra for movida
pelo usuário. Use este estilo para quiser atualizar a tela
quando o usuário mover a barra.
Recebe o valor do scrool.
Descrição
Nome do Controle
Monta a leitura do arquivo para carregar os dados no controle.
Página 58
AcuBench
Border
Case
Ccol
Cline
Clines
Color
Column
Column in Pixels
Csize
Destroy Type
Enable
Exception Value
Font
Format Picture
Help ID
ID
Item to Add
Key
Layout Data
Line
Line in Pixels
Lines
Lines in Pixels
Mass Update
Max Text
No Tab
Apostila
3D
Boxed
No Box
Borda do controle como efeito 2D.
Não coloca nenhuma borda no controle.
Lower
minúsculo.
Mixed
Upper
maiúsculo.
(Somente caracter).
(Somente caracter).
em pixel.
Automatic
Permanent
Temporary
Adiciona um item no controle.
pixel.
Quando setado para 1, os dados serão carregados e/ou
atualizados em memória e somente quando setado para 0
será atualizado na tela. Melhora a performance da leitura do
controle.
Determina a quantidade máxima de caracteres a ser digitado.
Página 59
AcuBench
Apostila
Gera o evento de CMD-DBLCLICK. Utilizado em conjunto com a
propriedade STATIC-LIST, quando for dado um duplo clique
poderá ser executado o evento.
Notify SelChange
houver alguma seleção no controle, executar o evento.
Pop-Up Menu
Size
Size in Pixels
A seleção do registro pode ser feita pelo mouse
Drop Down
ou digitando.
Mesmo que o DROP-DOWN, porém se digitar
Style
Drop List
uma letra, é visualizado o primeiro registro
começado por tal.
O Combo ficará com o aspecto do list box, ou
Stact List
seja todo o conteúdo será visualizado.
Tab Order
Termination Value Determina uma tecla de terminação para o controle.
Unsorted
Os dados serão listados conforme serão adicionados.
Value
Informa o conteúdo do controle, podendo ter mais de um item.
Cria variável na working com nível 88 de todo o conteúdo do
Value Container
combo para o caso de ter sido adicionado valores fixos.
Toda vez que iniciar a tela o controle mostrará item
Value Default
selecionado como padrão.
Value Picture
Informa a PIC da variável do controle.
Informa uma variável para o controle, podendo ser do arquivo,
Value Variable
working, linkage...
Visible
Se fixado para um valor positivo, o item a ser adicionado no
Insertion-Index
controle, ficará na posição informada, se fixado para 0 (zero) o
próximo item será adicionado sempre por último.
Item to Delete
Exclui um item no controle.
Reset List
Limpa todo o conteúdo do controle.
Notify DblClick
Propriedade
(Name)
Bitmap
Bitmap End
Bitmap Handle
Bitmap Number
Descrição
Nome do Controle.
Adiciona uma imagem ao controle, (BMP ou JPEG).
Utilizado somente para uma tira de imagens num único
arquivo,
informa o número da última imagem a ser
visualizada.
Página 60
AcuBench
Apostila
arquivo, informa o número da primeira imagem a ser
visualizada.
Utilizado em animação, informa o tempo (em centésimos de
Bitmap Timer
segundo) onde cada imagem aparecerá na tela durante a
animação, quando ajustada para "0", não tem animação.
Column
Column in Pixels
em pixel.
Copy Resource
Automatic
Permanent
Destroy Type
Temporary
ID
Key
Layout Data
Line
Line in Pixels
pixels.
Lines in Pixels
Size in Pixels
Tab Order
Transparent Color Torna o fundo ou determinada área da imagem transparente.
Visible
Bitmap Start
Propriedade
(Name)
Ccol
Cline
Clines
Color
Column
Column in Pixels
Csize
Descrição
Nome do Controle.
(Somente caracter).
(Somente caracter).
em pixel.
Página 61
AcuBench
Apostila
Automatic
Destroy Type
Help ID
ID
Kind
Layout Data
Line
Line in Pixels
Line Styles
Position Shift
Row´s Setting
Size
Size in Pixels
Tab Order
Visible
Width
Permanent
Temporary
Horizontal Informa que a barra será na horizontal.
Vertical
Informa que a barra será na vertical.
pixels.
Dashed
Cria uma linha tracejada.
Dot Dash Cria uma linha que alterna entre ponto e traços.
Dotted
Cria uma linha pontilhada.
Solid
Barra sólida.
Ajusta a posição da barra. Valores positivos posiciona a barra
para baixo (horizontais) ou movem para a direita (verticais)
pelo número especificado em pixels. Os valores negativos
deslocam a barra para cima ou para esquerda. A finalidade
desta propriedade é o posicionamento manual mais
específico.
Configuração das seguintes propriedades da barra.
Ao término da linha criada, adiciona-se uma
nova linha em pixels na horizontal e apaga a
Leading Shift criada. Valores acima de zero a linha será
criada a direita, e abaixo de zero será criada a
esquerda.
Permite a variação da cor de barras individuais
ou de colunas através de pixels. Trabalha
semelhante a propriedade COLORS, porém ao
invés de especificar uma cor, é especificado
um número que indica o ajuste da cor.
Aceita os seguintes valores:
Shading
2 16 cores (branco brilhante)
1 Cor normal brilhante
0 Cor normal
-1 Cor normal escurecida
-2 Cor preta
Trailing Shift Ajusta o comprimento da barra em pixels.
Informa a espessura da barra, em pixels.
Página 62
AcuBench
Propriedade
(Name)
3D Style
Alternate
Ccol
Cline
Clines
Color
Column
Column in Pixels
Csize
Destroy Type
Fill Color
Font
Format Picture
Full Height
Apostila
Descrição
Nome do Controle.
Faz com que o frame apareça mais baixo do que a
Engraved
superfície da tela.
Faz com que o interior do frame apareça mais
Lowered
baixo do que a superfície da tela.
Normal
Aparece apenas uma linha
Faz com que o interior do frame apareça levantado
Raised
acima da superfície da tela.
Faz com que o frame apareça acima da superfície
Rimmed
da tela e o interior no nível da tela.
Utilizado em conjunto com a propriedade HEAVY ou VERYHEAVY. Será criada uma barra mais escura no meio das linhas
do frame.
(Somente caracter).
(Somente caracter).
Ajusta a cor do frame e do título.
em pixel.
Automatic
Permanent
Temporary
Configuração das seguintes propriedades de cor.
Fill Color
Preenche o interior do frame.
Colore uma parte do frame. O valor da
propriedade é em porcentagem do frame
Fill Percent preenchido variando de 0 a 100. Essa
propriedade é usada para criar uma barra de
progresso (ou de status).
Utilizado somente se o valor de FILL-PERCENT for
menor do que "100". A cor especificada por esta
Fill Color 2
propriedade é aplicada à parte do frame que não
foi preenchido pelo FILL-COLOR.
Utilizado em conjunto com a propriedade TITLE POSITION, faz
com que o título fique para dentro do controle.
Página 63
AcuBench
Help ID
High Color
ID
Key
Layout Data
Line
Line in Pixels
Lines
Lines in Pixels
Low Color
Size
Size in Pixels
Tab Order
Thickness
Title
Title Position
Visible
Propriedade
(Name)
Auto Load
Border
Apostila
Para obter efeitos 3-D, o runtime necessita de três cores
relacionadas: a cor do fundo, um tom mais claro e um mais
escuro. HIGH-COLOR especifica o número da cor mais clara.
pixels.
Ajusta a altura do controle em pixels.
Especifica o número da cor mais escura para obter o efeito
3D.
Default
A borda do frame fica numa espessura padrão.
A borda do frame fica mais grossa do que o
Heavy
padrão.
A borda do frame fica mais grossa do que o
Very Heavy
padrão e que HEAVY.
Posição onde será apresentado o título do controle. Aceita os
seguintes valores:
1 Acima à esquerda
2 Acima centralizado
3 Acima à direita
4 Abaixo à esquerda
5 Abaixo centralizado
6 Abaixo à direita
7 Centralizado verticalmente e horizontalmente.
Descrição
Nome do Controle
Monta a leitura do arquivo para carregar os dados no controle.
3D
Boxed
Página 64
AcuBench
Apostila
minúsculo.
Mixed
Upper
maiúsculo.
(Somente caracter).
(Somente caracter).
em pixel.
Configuração das seguintes propriedades de cada coluna do
list.
Column Name
Cria uma variável para cada coluna.
Column Picture Informa o tamanho de cada coluna.
Define a quantidade de caracteres que
Column Display
serão visualizados em cada coluna.
Especifica o alinhamento dos dados em cada
coluna. Aceita os seguintes valores:
Centered Alinhamento centralizado.
Justification
Left
Alinhamento à esquerda.
Right
Alinhamento à direita.
Unaligned Não alinhado.
Adiciona um espaço em branco no término de
Separation
cada coluna.
Adiciona uma linha divisória entre as colunas. O
Divider
valor será em pixel.
Automatic
Permanent
Temporary
Adiciona um item no controle.
Recebe o valor de um item dentro do list box.
Lower
Case
Ccol
Cline
Clines
Color
Column
Column in Pixels
Columns’ Setting
Csize
Destroy Type
Enable
Exception Value
Font
Help ID
ID
Item to Add
Item Value
Key
Layout Data
Página 65
AcuBench
Apostila
Line
Line in Pixels
pixel.
Lines
Lines in Pixels
Quando setado para 1, os dados serão carregados e/ou
Mass Update
será atualizado na tela. Melhora a performance da leitura do
controle.
No Search
Desabilita a opção de busca no controle.
No Tab
Gera o evento de CMD-DBLCLICK. Utilizado em conjunto com a
Notify DblClick
propriedade STATIC-LIST, quando for dado um duplo clique
poderá ser executado o evento.
Notify SelChange
houver alguma seleção no controle, executar o evento.
Habilita o paged para o controle, fazendo com que seja
Paged
montado o list box e lido os registros por páginas.
Pop-Up Menu
Modifica o item indicado. No comando inquire retorna o
Selection Index
indexador do item selecionado.
Size
Size in Pixels
Tab Order
Termination Value Determina uma tecla de terminação para o controle.
Unsorted
Os dados serão listados conforme serão adicionados.
Value
Informa o conteúdo do controle, podendo ter mais de um item.
Cria variável na working com nível 88 de todo o conteúdo do
Value Container
combo para o caso de ter sido adicionado valores fixos.
Value Picture
Informa a PIC da variável do controle.
Value Variable
working, linkage...
Visible
Se fixado para um valor positivo, o item a ser adicionado no
Insertion-Index
controle, ficará na posição informada, se fixado para 0 (zero) o
Item to Delete
Exclui um item no controle.
Utilizado em conjunto com a propriedade ITEM-VALUE, retorna
Query Index
a posição do item no controle.
Reset List
Limpa todo o conteúdo do controle.
Utilizado apenas com a propriedade PAGED, retorna o valor
Search Text
fornecido pelo texto de procura.
Página 66
AcuBench
Sort Order
Thumb Position
Propriedade
(Name)
Handle Variable
Style
Tab Order
Checked
Enable
Exception Value
Label
Separator
Apostila
Utilizado apenas com a propriedade PAGED, esta propriedade
verifica a forma de como será a procura de um item. Aceita os
seguintes valores:
PL-SORT-DEFAULT (0)
Usa o tipo de ordem padrão.
Todo o tipo de caractér resultará
PL-SORT-NONE (1)
uma notificação.
Será
procurado
conforme
o
PL-SORT-NATIVE (2)
caractér é digitado.
Ignora a forma do caractér
PL-SORT-IGNORE-CASE (3) retornando
todos os valores
informados.
Exibe o número da linha do item acima do list. No comando
inquire esta propriedade retorna o número da linha do item
que está sendo exibido.
Descrição
Nome do Controle.
Define uma variável HANDLE para o menu.
Static Menu
Cria um menu estático.
Determina que o menu será acionado através
Pop-Up Menu
do clique com o botão direito do mouse.
Propriedades dos itens de Menu
O item do menu aparecerá com um check (sinal de
conferimento).
Habilita ou desabilita o item de menu.
Determina valor de exceção para o item de menu.
Título que aparece em cada item de menu.
Cria uma linha separadora entre os itens de menu.
Obs.: O Controle MENU é criado através da Rotina W$MENU, para manipular
qualquer item de menu, basta utilizar a rotina citada com as suas propriedades.
Propriedade
(Name)
Cell
Color
Font
Handle Variable
Help ID
Lines
Tab Order
Descrição
Nome do Controle.
Informa se tamanho será em Cells
Define uma variável HANDLE para o toolbar
Página 67
AcuBench
Propriedade
(Name)
Bitmap
Bitmap Handle
Bitmap Width
Column
Column in Pixels
Copy Resource
Destroy Type
Enable
Fixed Width
Font
Help ID
ID
Key
Layout Data
Line
Line in Pixels
Lines
Lines in Pixels
Multiline
No Tab
Pop-Up Menu
Size
Size in Pixels
Style
Tab Order
Apostila
Descrição
Nome do Controle.
Adiciona uma imagem ao controle, (BMP ou JPEG) ela
aparecerá ao lado do título de cada aba.
Informa a largura da imagem, em pixel.
em pixel.
Automatic
Permanent
Temporary
A aba ocupa o mesmo tamanho de espaço independente do
título.
pixels.
O título aparece em mais de uma linha.
Tabs
A aba fica com a sua aparência padrão
Buttons A aba fica com aparência de botão.
Página 68
AcuBench
Apostila
Top
Tab Orientation
Tab to Add
Value
Value Variable
Visible
(Name)
Bitmap Number
Tab Order
Title
Visible Variable
Flat Buttons
Hot Track
No Dividers
No Focus
Reset List
Tab To Delete
Propriedade
(Name)
Action
Ajustable Columns
A aba fica no início do controle.
A aba aparecerá na vertical do controle, do
Vertical Left
lado esquerdo .
A aba aparecerá na vertical do controle, do
Vertical Right
lado direito.
Bottom
A aba aparece na parte inferior do controle.
Adiciona uma nova aba para o controle.
Valor de cada aba do controle.
working, linkage...
Propriedades de cada aba
Nome de determinada aba do Controle.
Seqüência de accept da aba com relação ao controle.
Título que aparece em cada aba do controle.
Variável para visualizar ou não a aba no controle.
Utilizado apenas com a propriedade BUTTONS, o mesmo ficará
sem a borda.
Ao passar com o mouse sobre o título da aba, seu texto será
destacado.
Utilizado apenas com a propriedade FLAT-BUTTONS, não
aparecerá divisória entre as abas.
Não seta o foco na aba.
Remove todas as abas do controle.
Exclui determinada aba do controle.
Descrição
Nome do Controle.
Utilizado em conjunto com a propriedade PAGED, controla a
lógica de paginação. Aceita os seguintes valores.
Gera
o
evento
MSG-PAGED-FIRST,
First Page
preenchendo com dados a primeira página
do controle.
Gera
o
evento
MSG-PAGED-LAST,
Last Page
preenchendo com dados a última página do
controle.
Gera o evento MSG-PAGED-NEXTPAGE,
Current Page preenchendo com dados a próxima página
do controle a partir do Start do arquivo.
Altera o tamanho da coluna arrastando o divisor com o
mouse.
Página 69
AcuBench
Auto Load
Border
Cells’ Setting
Centered Headings
Color
Column
Column Headings
Column in Pixels
Apostila
Monta a leitura do arquivo para carregar os dados no
controle.
3D
Boxed
Configuração das seguintes propriedades, referente ao
título de cada coluna do grid.
Informa a cor do título da coluna,
Cell Color
background e foreground.
Cell Font
Informa a font do título da coluna.
Cell Data
Descrição do título de cada coluna.
Protege a célula para que não ocorra
Cell Protection
entrada de dados.
Permite armazenar um dado que não
Hidden Data
será exibido na célula.
Bitmap
Adiciona uma imagem na célula.
Define uma variável HANDLE para a
Bitmap Hanlde
imagem.
Setado para 1 a imagem aparecerá após
Bitmap Trailing
o texto da célula, se setado para 0
aparecerá antes. (apenas modify).
Utilizado somente para uma tira de
Bitmap Number imagens num único arquivo, informa o
número da imagem desejada.
Bitmap Width
Se configurado para verdadeiro, ao
Copy Resource gerar o programa o Acucobol adicionará
a imagem ao objeto do programa.
Título do cabeçalho fica centralizado independente do
alinhamento da coluna
Trata a primeira coluna como cabeçalho.
em pixel.
Página 70
AcuBench
Apostila
Configuração das seguintes propriedades, referente a cada
coluna do grid.
Column Name
Cria uma variável para cada coluna.
Column Color
Ajusta a cor de determinada coluna.
Column Font
Ajusta fonte para cada coluna.
Protege a coluna para que não ocorra
Column Protection
entrada de dados.
Permite armazenar um dado que não
Hidden Data
será exibido na célula.
Column Picture
Informa o tamanho de cada coluna.
Define a quantidade de caractér a ser
Display Columns
visualizado em cada coluna.
Centered Alinhamento centralizado.
Justification
Left
Alinhamento à esquerda.
Right
Alinhamento à direita.
Descreve as características dos dados
de cada coluna. Aceita os seguintes
valores:
Carac.
“X”
“U”
Columns’ Setting
“L”
Data Types
“9”
“Z”
“I”
“P”
Página 71
“D”
Carac.
Permitido
Todos
os
Alfanumérico
caracteres.
Todos
os
caracteres,
Alfanumérico convertidos
Maiúsculo
automaticamen
te
para
maiúsculo.
Todos
os
caracteres,
Alfanumérico convertidos
Minúsculo
automaticamen
te
para
minúsculo.
Dígitos, ponto
Numérico
decimal, sinal e
espaço.
Dígitos, sinal,
período,
vírgula,
Numérico
símbolo
de
Editado
moeda, “$”, “*”,
“/”,
“%”
e
espaço.
Dígitos, sinal e
Inteiro
espaço.
Inteiro
Dígitos
e
Positivo
espaço.
Dígitos, “/” e
Data
Desc.
AcuBench
Apostila
Cursor Color
Cursor Frame Width
Cursor X
Cursor Y
Ajusta a cor do cursor.
Ajusta a largura do cursor, em pixel, na célula.
Identifica a coluna que está focada.
Identifica a linha que está focada.
Na finalização da tela o controle será
Automatic
destruído.
O controle será destruído apenas com o
Destroy Type
Permanent
verbo destroy e não assume modify.
O controle se auto destrói se for adicionado
Temporary
um novo na mesma posição da tela.
Divider Color
Define cor para as linhas divisórias.
Drag Color
Define cor para a área selecionada do grid.
Habilita ou não o accept do controle. (1 verdadeiro, 0
Enable
falso).
End Color
Ajusta cor para a área do grid que não contém células.
Font
Heading Color
Define a cor das células de cabeçalho.
Heading Divider Color Define a cor das divisórias do cabeçalho.
Heading Font
Define a fonte das células de cabeçalho.
Hscroll
Adiciona uma barra de rolagem na horizontal.
ID
Chave de ativação do controle. Para controles nativos não
Key
tem necessidade da criação do mesmo.
Last Row
Verifica o número da última linha com conteúdo.
Ajusta o controle, conforme o resize da tela, podendo
Layout Data
apenas mover o controle ou então alterar o seu tamanho.
Line
Ajusta a linha onde o controle se inicia, em relação à tela
Line in Pixels
em pixel.
Lines
Lines in Pixels
No Tab
Num Columns
Determina a quantidade de colunas.
Determina a quantidade de linhas, se informar –1 ficará
Num Rows
como indeterminado.
Habilita o paged para o controle, fazendo com que seja
Paged
montado o grid e lido os registros por páginas.
Pop-Up Menu
Record Data
Informa o conteúdo de toda uma linha.
Record To Add
Adiciona o conteúdo de toda uma linha no grid.
Region Color
Informa uma cor para toda uma região selecionada.
Row Color Pattern
Intercala cores por linha.
Row Dividers
Fixa a largura dos divisores, em pixel, de cada linha.
Row Headings
Trata a primeira linha como cabeçalho.
Página 72
AcuBench
Row’s Setting
Size
Size in Pixels
Tab Order
Tiled Headings
Use Tab
Virtual Width
Visible
Vpadding
Vscroll
Action
Action Hide Drag
Entry Reason
Apostila
linha do grid.
Row Name
Cria uma variável para cada linha.
Row Color
Ajusta a cor de determinada linha.
Row Font
Ajusta fonte para cada linha.
Protege a linha para que não ocorra
Row Protection
entrada de dados.
Permite armazenar um dado que não será
Hidden Data
exibido na célula.
Deixa o título das células de cabeçalho com sombreado.
Trabalha as teclas <TAB> e <BACKTAB> como teclas de
navegação.
Utilizada com a propriedade HSCROLL, informa uma largura
lógica total para o grid.
Informa a altura da célula, valor passado em porcentagem.
Adiciona uma barra de rolagem na vertical.
Gera o evento MSG-PAGED-PREVPAGE,
Previous Page preenchendo com dados a página anterior
do controle.
Gera
o
evento
MSG-PAGED-PREV,
preenchendo com dados os itens
Previous
anteriores à página atual, rolando por
item.
Gera
o
evento
MSG-PAGED-NEXT,
Next
preenchendo com dados os próximos
itens à página atual, rolando por item.
Gera o evento MSG-PAGED-NEXTPAGE,
Next Page
preenchendo com dados a próxima página
do controle a partir do Start do arquivo.
Remove os valores da propriedade DRAG-COLOR.
Registra a ação do usuário na entrada do dado. É efetuado
antes do evento MSG-BEGIN-ENTRY. Aceita os valores ASCII:
X”00”
Indica que houve um duplo clique na célula.
X”0D”
Indica que foi teclado o <ENTER> na célula.
OUTRO Indica o caractér digitado.
Página 73
AcuBench
File Pos
Apostila
Utilizado somente com a propriedade PAGED, verifica a
quantidade de registros que deve ser lido, para encontrar
determinado registro no grid. O grid use esse valor quando
gera os eventos MSG-PAGED-NEXT e MSG-PAGED-PREV.
Aceita os seguintes valores:
Quando informado esse valor o grid não
PAGED-AT-START
gera os eventos MSG-PAGED-PREV e
(2147418113):
MSG-PAGED-PREVPAGE.
PAGED-AT-END
gera os eventos MSG-PAGED-NEXT e
(2147418114):
MSG-PAGED-NEXTPAGE.
PAGED-EMPTY
gera os eventos MSG-PAGED-NEXT, MSG(2147418115):
PAGED-NEXTPAGE,
MSG-PAGE-PREV
e
MSG-PAGED-PREVPAGE.
Finish Reason
Hscroll Pos
Insert Rows
Insertion Index
Mass Update
Num Col Headings
Record To Delete
Reset Grid
Registra a ação do usuário no término da digitação do
dado. É efetuado antes do evento MSG-FINISH-ENTRY ou
MSG-CANCEL-ENTRY. Aceita os seguintes valores:
A entrada foi finalizada pelo
-1 GRFR-BLANK-PAST-END usuário, porém cancelada pelo
controle.
Foi finalizado o grid para ser
-2 GRFR-TERMINATING
executado algum outro evento.
-3 GRFR-CELL-CLICKED
Foi clicado em outra célula.
Foi pressionada uma tecla de
-4 GRFR-NAVIGATION-KEY
navegação.
-5 GRFR-ESCAPE-KEY
Foi pressionada a tecla <ESC>.
Foi
pressionada
a
tecla
-6 GRFR-ENTER-KEY
<ENTER>.
-7 GRFR-TAB-KEY
Foi pressionada a tecla <TAB>.
Controla a posição atual da barra de rolagem na horizontal.
Insere novas linhas em branco.
Se fixado para um valor positivo, o próximo item será
adicionado na posição informada, se fixado para 0 (zero) o
Quando setado para 1 os dados serão carregados e/ou
será
atualizado na tela. Melhora a performance do
controle.
Determina o número de linhas que serão tratados como
cabeçalho de coluna.
Exclui o conteúdo de toda uma linha.
Limpa todo o conteúdo e modificações do controle,
voltando para configuração inicial. (sem cabeçalho).
Página 74
AcuBench
Search Options
Search Text
Start X
Start Y
Vscroll Pos
X
Apostila
Controla como será apresentada a procura no grid.
Recebe os seguintes valores:
A procura funcionará da esquerda para
GRID-SEARCHFORWARDS
direita e de cima para baixo.
A procura será realizada apenas em
GRID-SEARCHcélulas já carregadas na memória. Obs.:
WRAP
sem a propriedade PAGED.
A procura será realizada nas letras em
GRID-SEARCHIGNORE-CASE
minúscula ou maiúscula.
A procura será realizada independente da
GRID-SEARCHMATCH-ANY
posição do conteúdo indicado.
A procura será realizada a partir da
GRID-SEARCHMATCH-LEADING posição inicial do conteúdo indicado.
A procura será realizada somente quando
GRID-SEARCHMATCH-ALL
o conteúdo indicado for igual.
A procura será realizada nas células onde
GRID-SEARCHVISIBLE
o conteúdo está sendo visualizado.
A procura será realizada somente nas
GRID-SEARCHcélulas que possuem valores configurados
HIDDEN
na propriedade HIDEN-DATA.
A procura será realizada tanto para
valores que estão sendo visualizado
GRID-SEARCHALL-DATA
quanto
para
os
configurados
na
propriedade HIDDEN-DATA.
A procura será realizada somente para o
GRID-SEARCHconteúdo que não começam com o
SKIP-CURRENT
conteúdo indicado.
O cursor se posicionará na célula com o
GRID-SEARCHMOVES-CURSOR conteúdo encontrado.
Recebe o valor da coluna onde a busca
deve ver realizada, se deseja efetuar a
GRID-SEARCHbusca para todas as colunas deve-se
COLUMN
informar a propriedade GRID-SEARCH-ALLCOLUMNS para 1.
A busca será realizada a partir do conteúdo informado
nessa propriedade. Aceita os seguintes valores de retorno:
Não foi encontrado nenhum
GRDSRCH-NOT-FOUND (0)
dado comparado.
GRDSRCH-FOUND (1)
A procura foi bem sucedida.
A procura foi bem sucedida
GRDSRCH-WRAPPED (2)
porém em conteúdo escondido.
Utilizado com as propriedades START-Y, X, Y e REGIONCOLOR, informa a coluna inicial para a região a ser
informada.
Utilizado com as propriedades START-X, X, Y e REGIONCOLOR, informa a linha inicial para a região a ser
informada.
Utilizada com a propriedade VSCROOL, controla a posição
atual da barra.
Informa o número da coluna do grid.
Página 75
AcuBench
Y
Propriedade
(Name)
Bitmap
Bitmap Handle
Bitmap Width
Border
Buttons
Ccol
Cline
Clines
Color
Column
Column in Pixels
Copy Resource
Csize
Destroy Type
Enable
Font
Help ID
ID
Key
Layout Data
Line
Line in Pixels
Apostila
Informa o número da linha do grid.
Descrição
Nome do Controle.
Adiciona uma imagem ao controle, (BMP ou JPEG) ela
aparecerá ao lado de cada item.
3D
Boxed
Imagem com o sinal de “+” ou “-“ que aparece ao lado de
cada item.
Ajusta a coluna onde o controle se inicia, em relação à
tela. (Somente caracter).
(Somente caracter).
tela.
tela, em pixel.
Automatic
destruído.
Permanent
Temporary
falso).
Trabalha em conjunto com a variável de ambiente HELPPROGRAM Informa o valor do ID criado no help do
controle.
Chave de ativação do controle. Para controles nativos
não tem necessidade da criação do mesmo.
em pixel.
Página 76
AcuBench
Lines
Lines At Root
Lines in Pixels
No Tab
Pop-Up Menu
Show Lines
Show Selecton Always
Size
Size in Pixels
Tab Order
Value Variable
Visible
(Name)
Bitmap Number
Ensure Visible
Expand
Has Children
Hidden Data
Identified Pointer
Label
Placement
Item
Item Text
Item to Add
Item to Delete
Item to Empty
Apostila
Permite que as propriedades SHOW-LINES e BUTTONS
sejam aplicadas aos itens de nível superior.
Adiciona linhas entre um item e seu sub-item.
Mostra a seleção atual do item.
Informa uma variável para o controle, podendo ser do
arquivo, working, linkage...
Visualiza ou não o controle na tela. (1 verdadeiro, 0
falso).
Propriedades de cada item
Nome de cada item do controle.
Se o item possuir um ID válido, o item será visualizado no
controle.
Configurado para verdadeiro o item aparecerá expandido.
Indica a quantidade de sub-itens que possui determinado
item, através da propriedade ITEM, independente de estar
sendo visualizado ou não.
Permite armazenar um dado que não será exibido em um
item.
Variável de ponteiro para identificar cada item do
controle.
Título que será apresentado em cada item do controle.
Determina onde os itens são localizados na hierarquia de
sub-item. Aceita os seguintes valores:
First
Item adicionado na primeira posição da lista.
Last
Item adicionado na última posição da lista.
Sort
Item adicionado por ordem alfabética na lista.
Utilizada em conjunto com outras propriedades, identifica
qual o item que foi acionado para executar determinada
tarefa.
Título que cada item do controle receberá.
Adiciona um novo item ao controle. Sua posição na
hierarquia é determinada através das propriedades
PARENT e PLACEMENT.
Apaga determinado item do controle.
Apaga todos os sub-itens de um determinado item.
Página 77
AcuBench
Next Item
Parent
Reset List
Propriedade
(Name)
Column
Column in Pixels
Destroy Type
Enable
Help ID
ID
Key
Layout Data
Line
Line in Pixels
Lines
Apostila
Retorna o tipo de item encontrado. Aceita os seguintes
valores:
Primeiro sub-item de um item
TVNI-CHILD
principal
Primeiro item atualmente visível
TVNI-FIRST-VISIBLE
no controle.
TVNI-NEXT
Próximo sub-item do item atual.
TVNI-NEXT-VISIBLE
Próximo item visível.
TVNI-PARENT
Item principal.
TVNI-PREVIOUS
Sub-item anterior do item atual.
TVNI-PREVIOUS-VISIBLE Item anterior visível.
O item de nível principal em todo
TVNI-ROOT
o controle.
Se informar o ID de um item já existente, cria um subitem do mesmo, se deixar zero, cria um item novo de
nível principal.
Remove todos os itens do controle.
Descrição
Nome do Controle.
tela.
tela, em pixel.
Automatic
destruído.
Permanent
Temporary
falso).
Trabalha em conjunto com a variável de ambiente HELPPROGRAM Informa o valor do ID criado no help do
controle.
Chave de ativação do controle. Para controles nativos
não tem necessidade da criação do mesmo.
em pixels.
Página 78
AcuBench
Lines in Pixels
No Tab
Size
Size in Pixels
Tab Order
Value
Value Variable
Visible
Busy
Clear Selection
Copy Selection
Custom Print Template
File Name
Apostila
Informa a URL que está sendo exibida no momento.
Informa uma variável para o controle, podendo ser do
arquivo, working, linkage...
Visualiza ou não o controle na tela. (1 verdadeiro, 0
falso).
Indica se o download ou a navegação ainda está sendo
carregado.
Limpa a seleção atual.
Copia a seleção atual.
Para versões do Internet Explorer 5.5 ou superior,
permite a chamada de Modelos de Impressão
Personalizados.
Informa o caminho e nome do arquivo para ser usado
quando executa o Salvar Como do Browser.
Os métodos foram implementados como propriedades.
Para executar um método, deve-se trabalhar com as
propriedades correspondente. Os seguintes métodos e
propriedades são aceitos:
Método
Page Setup
Print
Print no Prompt
Print Preview
Properties
Save AS
Save As no Prompt
Select All
Title
Descrição
Volta para a URL
anterior acessada.
GOFORWARD
GO-FORWARD
Avança a URL.
Acessa
a
URL
GOHOME
GO-HOME
configurada
como
inicial.
Acessa o Portal da
GOSEARCH
GO-SEARCH
Microsoft.
Acessa uma URL ou
NAVIGATE
VALUE
arquivo.
REFRESH
REFRESH
Atualiza a página atual.
Finaliza um acesso ou
STOPBROWSER STOP-BROWSER
download.
Aciona a janela de Configurar Página.
Aciona a janela de Impressão.
Envia direto para a impressora.
Aciona a janela de Visualizar Impressão.
Aciona a janela de Propriedades da página.
Aciona a janela de Salvar Como.
Salva um documento com o nome informado na
propriedade FILE-NAME, sem adicionar a janela.
Seleciona todos os dados de uma página.
Informa o título da página.
GOBACK
Methods
Propriedade
Página 79
GO-BACK
AcuBench
Type
Propriedade
(Name)
Font
Grip
Handle Variable
Panel’s Setting
Tab Order
Propriedade
(Name)
Calendar Font
Column
Column in Pixels
Destroy Type
Display Format
Enable
Font
Apostila
Informa o tipo de documento acionado do browser.
Descrição
Nome do Controle.
O Controle sempre seguirá o tamanho da tela.
Define uma variável HANDLE para o toolbar
Configura as propriedades de cada divisão da barra.
Especifica qual divisão da barra de status irá
Panel-Index
trabalhar.
Especifica uma borda para a divisão da barra
de status. Aceita os seguintes valores:
A divisão terá a mesma altura que o
Flat
resto da janela, sem bordas visuais.
Panel Style
A divisão aparece afundada na
Lowered
janela.
A divisão aparece levantada na
Raised
janela.
Especifica o texto a ser visualizado em
Panel Text
determinada divisão.
Panel Width Especifica a largura da divisão
Descrição
Nome do Controle.
Informa a fonte do calendário que é aberto.
Ajusta a coluna onde o controle se inicia, em relação a tela.
Ajusta a coluna onde o controle se inicia em pixels, em relação
a tela.
Automatic
Permanent
Temporary
Forma de como será visualizado o controle. Aceita os
seguintes valores:
Short Date Apresenta no formato DD/MM/AA.
Apresenta o formato exato de toda a data Ex:
Long Date
Segunda-feira 16 de maio de 2005
Time
Apresenta a hora da máquina local
Página 80
AcuBench
Help ID
ID
Key
Layout Data
Line
Line in Pixels
Lines
Lines in Pixels
No F4
No Tab
No Updown
Notify Change
Pop-Up Menu
Right Aligment
Show None
Size
Size in Pixels
Spinner
Tab Order
Value
Value Format
Value Variable
Visible
Apostila
pixel.
Ao pressionar a tecla <F4> o calendário é aberto, com essa
propriedade configurada, desabilita essa função.
Ao pressionar as teclas de seta de movimentação, o combo
vai rolando os próximos valores de data ou hora, com essa
propriedade configurada desabilita essa função.
houver alguma alteração na digitação do controle, executar o
evento.
Faz com que o calendário seja alinhado a direita com relação
ao controle.
Adiciona um check-box dentro do controle, quando o checkbox está secionado deixa a data/hora habilitada, quando não
selecionado desabilita a data/hora
Habilita as teclas de movimentação para mover os valores do
campo
Recebe o mesmo que VALUE-FORMAT.
Formato da data/ hora. Aceita os seguintes valores:
Apresentará 8 dígitos, 4 para o ano, 2
YYYYMMDD
para o mês e 2 para o dia.
Apresentará 6 dígitos, 2 para o ano, 2
YYMMDD
para o mês e 2 para o dia.
Apresentará 8 dígitos, de 24 horas
HHMMSStt
incluindo os centésimos de segundo.
HHMMSS
Apresentará 6 dígitos, de 24 horas
Apresentará 16 dígitos que é a
YYYYMMDD HHMMSStt
combinação de YYYYMMDD mais
HHMMSSHH.
working, linkage...
Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso)
Página 81
AcuBench
Apostila
Propriedade
(Name)
Descrição
Nome do Controle.
Informa a coluna inicial, onde a window será visualizada, em
Absolute Column
pixels.
Informa a linha inicial, onde a window será visualizada em
Absolute Line
pixels.
Utilizada em conjunto com as propriedades
RESIZABLE ou AUTO-RESIZE, esta ação maximiza
Maximize
a janela, tendo o mesmo efeito de ter clicado
no botão Maximizar.
Action
Utilizada em conjunto com a propriedade
AUTO-MINIMIZE
e somente em janelas
Minimize
INDEPENDENT, esta ação minimiza a janela,
tendo o mesmo efeito de ter clicado no botão
Minimizar.
Permite enviar e receber mensagens de todas
Any Thread
as threads.
Allowing Messages
Permite enviar e receber mensagens da ultima
Last Thread
thread ativa.
Utilizada em janelas INDEPENDENT ou INITIAL, o botão de
Auto Minimize
minimizar será habilitado.
Auto Resize
Esta propriedade permite maximizar e restaurar uma janela.
Permite finalizar a tela perante um determinado período em
Before Time
milésimos de segundo sem que ocorra exceção.
Utilizado para thread, ao fechar a janela principal, a que está
Bind To Thread
com essa propriedade será finalizada.
Boxed
Borda da janela. (Somente caracter).
Cell
Informa que a largura ou altura da janela será em cell.
Cell Height
Define a altura da janela em cell.
Pixels
Cordenadas de tamanho será em pixel.
Cell Measure
Cordenadas de tamanho será de acordo com
Control Font
a font.
Cell Width
Define a largura da janela em cell.
Color
Ajusta uma variável informando o valor da coluna que a
Column Variable
janela será iniciada.
Controls Uncropped Não permite o display de um controle maior que a janela.
Description
Comentario para antes do display da tela.
Erase Screen
Ao iniciar a tela todos os controles serão inicializados.
Font
Informa a fonte de todos os controles da janela.
Handle Variable
Define uma variável HANDLE para a janela.
ID
Página 82
AcuBench
Label Offset
Layout Manager
Line Variable
Lines
Link To Thread
Main Menu
Max Lines
Max Size
Min Lines
Min Size
Modeless
Pop-Up Menu
Resizable
Scroll
Size
System Menu
Title
Title Bar
Unit
User Gray
User White
Visible
Window Type
Action Restore
Modal
Apostila
Não utilizado com pixels, ajusta a altura do label em relação
ao Entry Field.
LM_RESIZE, ativa o resize da tela para poder trabalhar com
o layout data nos controles.
Ajusta uma variável informando o valor da linha que a janela
será iniciada.
Utilizado para thread, ao fechar a janela principal, a que está
com essa propriedade não será finalizada.
Informa a handle do menu que deseja vincular a tela.
Informa o maior valor de altura que a janela pode ter.
Informa o maior valor de largura que a janela pode ter.
Informa o menor valor de altura que a janela pode ter.
Informa o menor valor de largura que a janela pode ter.
Utilizado para thread, permite obter mais de uma janela
ativa, não precisando fechar uma janela para poder abrir
outra.
Permite restaurar a janela manualmente, não sendo
automático como no AUTO-RESIZE.
Adiciona uma barra de rolagem na janela
Habilita ou não os botões de minimizar, maximizar e fechar.
Informa o título da janela.
Habilita ou não a barra de título da janela.
Cells
Unidade de medida em Cells
Pixels Unidade de medida em Pixels
Ajusta a cor dos controles em 3D para o valor 8 (cinza) .
Ajusta a cor dos controles em 3D para o valor 16 (branco) .
Visualiza ou não a janela. (1 verdadeiro, 0 falso)
Tipo de Window a ser criada. Aceita os seguintes valores:
É uma sub-window, e sempre estará
Floating
vinculada a uma window principal.
É uma sub-window, e não se vincula a
Independent
nenhuma window principal.
É uma window principal, tendo propriedades
Initial
específicas, porém sempre estará vinculada
nas sub-window’s.
É uma window principal, tendo propriedades
Standard
específicas e pode trabalhar em paralelo das
sub-window’s.
Se a window estiver Maximizada ou Minimizada, esta ação
restaura a mesma para o seu tamanho original.
Não permite objer mais de uma janela ativa.
Página 83
AcuBench
Apostila
B-) Categorized: Seção utilizada para a configuração das propriedades de cada
controle, igual a Properties, porém visualizada em ordem de categoria das propriedades.
C-) Event: Seção utilizada para criar os parágrafos lógicos relacionados a
determinado evento que o controle gerar.
Segue lista com todos os eventos de cada controle.
Não possui eventos.
Item
Cmd-Clicked
Cmd-Goto
Cmd-Help
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Validate
Other
Cmd-Clicked
Cmd-Goto
Value
Event Procedure
A rotina será executada no momento que ocorrer o clique no
botão, ou então quando o foco estiver no controle e for
pressionada a tecla “ENTER”. OBS: Não terá tecla de Exceção.
controle para o foco ficar no mesmo.
A rotina será executada quando for selecionado o help do
controle.
A rotina será executada quando sair do menu pop-up
vinculado ao controle.
A rotina será executada quando clicar com o botão direito para
chamar o menu pop-up vinculado ao controle.
A rotina será executada quando clicar em um item do menu.
A rotina será executada quando finalizar o foco do controle.
Qualquer outro evento não mencionado acima.
Exception Procedure
botão, ou então quando o foco estiver no controle e for
pressionada a tecla “ENTER”, após ocorrer o EVENTO CMDCLICKED .
controle para o foco ficar no mesmo, após ocorrer o EVENTO
CMD-GOTO.
Other
controle, após ocorrer o EVENTO CMD-HELP, .
Qualquer outra exceção não mencionada acima.
Before Procedure
After Procedure
A rotina será executada antes do foco chegar no controle.
A rotina será executada após o foco sair do controle.
Cmd-Help
Página 84
AcuBench
Link To
Item
Cmd-Goto
Cmd-Help
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Spin-Down
Msg-Spin-Up
Msg-Validate
Ntf-Changed
Other
Cmd-Goto
Apostila
A rotina será executada quando for pressionada a tecla de
exceção. Obrigatoriamente a propriedade EXCEPTION-VALUE
deverá ter um valor.
Value
Event Procedure
controle.
Utilizada para a propriedade SPINNER, a rotina será executada
quando for clicado na seta para baixo do campo.
Utilizada somente com propriedade SPINNER, a rotina será
executada quando for clicado na seta para cima no campo.
Utilizado somente com a propriedade NOTIFY-CHANGE, a rotina
será executada quando houver qualquer entrada de dados.
Exception Procedure
botão para o foco ficar no mesmo, após ocorrer o EVENTO
CMD-GOTO.
Other
controle, após ocorrer o EVENTO CMD-HELP.
será executada quando houver qualquer entrada de dados,
antes do EVENTO NTF-CHANGED.
Before Procedure
After Procedure
Cmd-Help
Ntf-Changed
Item
Cmd-Clicked
Cmd-Goto
Value
Event Procedure
controle, tanto para selecionar quanto para tirar a seleção.
Página 85
AcuBench
Cmd-Help
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Validate
Other
Cmd-Clicked
Cmd-Goto
Apostila
controle.
Exception Procedure
controle, tanto para selecionar quanto para tirar a seleção, se
não houver rotina no EVENTO CMD-CLICKED.
CMD-GOTO.
Cmd-Help
Other
Before Procedure
After Procedure
Link To
Item
Cmd-Clicked
Cmd-Goto
Cmd-Help
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Validate
Other
Cmd-Clicked
Value
Event Procedure
controle, para a sua seleção.
controle.
Exception Procedure
controle para a sua seleção, se não houver rotina no EVENTO
CMD-CLICKED.
Página 86
AcuBench
Cmd-Goto
Apostila
CMD-GOTO.
Cmd-Help
Other
Before Procedure
After Procedure
Link To
Item
Value
Event Procedure
Cmd-Help
controle.
Msg-End-Menu
A rotina será executada quando clicar com o botão direito
Msg-Init-Menu
para chamar o menu pop-up vinculado ao controle.
Msg-Menu-Input
A rotina será executada quando for clicado no botão down /
Msg-Sb-Next
right do scrool bar.
A rotina será executada quando for clicado na região de
Msg-Sb-NextPage
página down / right do scrool bar.
A rotina será executada quando for clicado no botão up / left
Msg-Sb-Prev
do scrool bar.
A rotina será executada quando for clicado na região de
Msg-Sb-PrevPage
page up / left do scrool bar.
A rotina será executada quando for reposicionado o slider do
Msg-Sb-Thumb
scrool bar.
Utilizada com a propriedade TRACK THUMB, a rotina será
Msg-sb-Thumbtrack
executada quando for reposicionado o slider do scrool bar.
Msg-Validate
A rotina será executada, quando finalizar o foco do controle.
Other
Exception Procedure
Cmd-Help
Other
Before Procedure
After Procedure
Página 87
AcuBench
Item
Cmd-Dblclick
Cmd-Goto
Cmd-Help
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Validate
Ntf-Selchange
Other
Cmd-Dblclick
Apostila
Value
Event Procedure
Utilizada com a propriedade NOTIFY DBLCLICK, a rotina será
executada no momento que ocorrer um duplo clique. Este
evento funciona apenas se não tiver valor nas propriedades
TERMINATION-VALUE e EXCEPTION-VALUE.
controle.
Utilizado somente com a propriedade NOTIFY-SELCHANGE, a
rotina será executada quando houver qualquer alteração na
seleção de um dado.
Exception Procedure
TERMINATION-VALUE e EXCEPTION-VALUE, após ocorrer o EVENT
CMD-DBLCLICK.
Cmd-Goto
CMD-GOTO.
Cmd-Help
Ntf-Selchange
Other
Before Procedure
After Procedure
Link To
seleção de um dado, antes do EVENTO NTF-CHANGED.
Item
Value
Página 88
AcuBench
Cmd-Help
Other
Cmd-Help
Other
Apostila
Event Procedure
controle.
Exception Procedure
Item
Cmd-Dblclick
Cmd-Goto
Cmd-Help
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Validate
Ntf-Pl-First
Ntf-Pl-Last
Ntf-Pl-Next
Ntf-Pl-Nextpage
Value
Event Procedure
TERMINATION-VALUE e EXCEPTION-VALUE.
controle.
Utilizada somente com a propriedade PAGED, a rotina será
executada quando for clicado no botão para ir ao primeiro
registro do list.
executada quando for clicado no botão para ir no ultimo
registro do list.
executada quando for clicado no botão para ir ao próximo
registro a partir do selecionado.
executada quando for clicado no botão para ir ao próximo
bloco de registros a partir do selecionado.
Página 89
AcuBench
Ntf-Pl-Prev
Ntf-Pl-Prevpage
Ntf-Pl-Search
Ntf-Selchange
Other
Cmd-Dblclick
Apostila
executada quando for clicado no botão para ir ao registro
anterior a partir do selecionado.
executada quando for clicado no botão para ir ao bloco
anterior de registros a partir do selecionado.
executada, quando selecionar para ir na página que contem o
texto de busca informado.
Utilizada somente com a propriedade NOTIFY-SELCHANGE, a
Exception Procedure
TERMINATION-VALUE e EXCEPTION-VALUE, após ocorrer o EVENT
CMD-DBLCLICK.
Cmd-Goto
CMD-GOTO.
Cmd-Help
Ntf-Pl-First
Ntf-Pl-Last
Ntf-Pl-Next
Ntf-Pl-Nextpage
Ntf-Pl-Prev
Ntf-Pl-Prevpage
Ntf-Pl-Search
Ntf-Selchange
executada quando for pressionada a tecla “Home” para ir ao
primeiro registro do list.
executada quando for pressionada a tecla “End” para ir no
ultimo registro do list.
executada quando for pressionada a tecla down, para ir ao
próximo registro a partir do selecionado.
executada quando for pressionada a tecla page down para ir
ao próximo bloco de registros a partir do selecionado.
executada quando for pressionada a tecla up, para ir ao
registro anterior a partir do selecionado.
executada quando for pressionada a tecla page up, para ir ao
bloco anterior de registros a partir do selecionado.
executada, quando selecionar para ir à página que contem o
texto de busca informado.
Utilizada somente com a propriedade NOTIFY-SELCHANGE, a
Página 90
AcuBench
Ntf-Selchange
Other
Before Procedure
After Procedure
Link To
Item
Link To
Apostila
seleção de um dado, antes do EVENTO NTF-CHANGED.
Value
exceção, ou clicado no item de menu. Obrigatoriamente a
propriedade EXCEPTION-VALUE deverá ter um valor.
Item
Cmd-Help
Cmd-Tabchanged
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Validate
Other
Cmd-Help
Other
Value
Event Procedure
controle.
A rotina será executada quando for clicado em alguma
aba do controle.
A rotina será executada quando clicar com o botão direito
para chamar o menu pop-up vinculado ao controle.
A rotina será executada quando clicar em um item do
menu.
A rotina será executada, quando finalizar o foco do
controle.
Exception Procedure
Página 91
AcuBench
Before Procedure
After Procedure
Before-Tabchg-Display
After-Tabchg-Display
Apostila
A rotina será executada depois que ocorrer o evento
CMD-TABCHANGED, antes do display da página.
A rotina será executada depois que ocorrer o evento
CMD-TABCHANGED, depois do display da página.
Item
Value
Event Procedure
A rotina será executada no momento que ocorrer o
Cmd-Goto
clique no controle para o foco ficar no mesmo.
A rotina será executada quando for selecionado o help
Cmd-Help
do controle.
A rotina será executada quando clicar com o mouse na
Msg-Begin-Drag
célula e arrastar, antes de soltar novamente.
A rotina será executada quando iniciar o accept da
Msg-Begin-Entry
célula.
Msg-Begin-Heading-Drag célula de cabeçalho e arrastar, antes de soltar
novamente.
A rotina será executada quando clicar apenas 1 vez
sobre a imagem. OBS: O clique necessariamente deve
Msg-Bitmap-Clicked
ser sobre a imagem, se clicar fora ocorrerá outro
evento.
A rotina será executada quando houver um duplo clique
sobre a imagem. OBS: O clique necessariamente deve
Msg-Bitmap-Dblclick
ser sobre a imagem, se clicar fora ocorrerá outro
evento.
A rotina será executada quando for pressionada a tecla
Msg-Cancel-Entry
ESC em uma célula acceptada (no meio de uma
digitação)
A rotina será executada quando for alterada a largura
Msg-Col-Width-Changed
de uma coluna.
Msg-End-Drag
célula e arrastar, depois que soltou novamente.
Msg-End-Heading-Drag célula de cabeçalho e arrastar, depois que soltou
novamente.
Msg-End-Menu
Página 92
AcuBench
Msg-Finish-Entry
Msg-Goto-Cell
Msg-Goto-Cell-Drag
Msg-Goto-Cell-Mouse
Msg-Grid-Rbutton-Down
Msg-Grid-Rbutton-Up
Msg-Heading-Clicked
Msg-Heading-Dblclick
Msg-Heading-Dragged
Msg-Init-Menu
Msg-Menu-Input
Msg-Paged-First
Msg-Paged-Last
Msg-Paged-Next
Msg-Paged-Nextpage
Msg-Paged-Prev
Msg-Paged-Prevpage
Msg-Validate
Apostila
A rotina será executada quando finalizar o accept de
uma célula.
A rotina será executada quando passar por uma célula
através das teclas de movimentação.
A rotina será executada equanto o conjunto de células
está sendo arrastado para um outro controle grid.
A rotina será executada quando for clicado em
determinada célula.
A rotina será executada quando for clicado e mantido
abaixado o botão direito do mouse.
A rotina será executada quando for clicado e soltado o
botão direito do mouse.
A rotina será executada ocorrer 1 clique na célula de
cabeçalho.
A rotina será executada ocorrer o duplo clique na célula
de cabeçalho.
célula de cabeçalho e arrastar, mantendo o botão
pressionado.
A rotina será executada quando clicar com o botão
direito para chamar o menu pop-up vinculado ao
controle.
menu.
Utilizada somente com a propriedade PAGED, a rotina
será executada quando for clicado no botão, ou
pressionado a tecla home, para ir ao primeiro registro
do grid.
pressionado a tecla end, para ir ao último registro do
grid.
pressionado a tecla down, para ir ao próximo registro do
grid.
pressionado a tecla page down, para ir ao próximo
bloco de registros do grid.
pressionado a tecla up, para ir ao registro anterior ao
selecionado do grid.
pressionado a tecla page up, para ir ao bloco anterior
de registros do grid.
controle.
Página 93
AcuBench
Other
Apostila
Exception Procedure
clique do controle para o foco ficar no mesmo, após
ocorrer o EVENTO CMD-GOTO.
do controle, após ocorrer o EVENTO CMD-HELP.
Cmd-Goto
Cmd-Help
Other
Before Procedure
After Procedure
A rotina será executada antes do foco chegar no
controle.
Item
Cmd-Goto
Cmd-Help
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Tv-Dblclick
Msg-Tv-Expanded
Msg-Tv-Expanding
Msg-Tv-Selchange
Msg-Tv-Selchanging
Msg-Validate
Other
Cmd-Goto
Cmd-Help
Value
Event Procedure
do controle.
A rotina será executada quando clicar com o botão
direito para chamar o menu pop-up vinculado ao
controle.
menu.
A rotina será executada quando ocorrer o duplo clique
em algum item do controle.
A rotina será executada logo após o clique no item para
abrir os sub-níveis.
A rotina será executada quando clica no item para abrir
os sub-níveis.
A rotina será executada quando ocorre a alteração da
seleção de item no controle.
A rotina será executada quando vai ocorrer a alteração
da seleção de item no controle.
controle.
Exception Procedure
clique no controle para o foco ficar no mesmo, após
ocorrer o EVENTO CMD-GOTO.
do controle, após ocorrer o EVENTO CMD-HELP.
Página 94
AcuBench
Other
Apostila
Before Procedure
After Procedure
controle.
Item
Value
Event Procedure
Cmd-Goto
A rotina será executada quando for selecionado o
Cmd-Help
help do controle.
A rotina será executada quando for informada uma
Msg-Wb-Before-Navigate
nova URL para o controle.
A rotina será executada quando uma operação de
Msg-Wb-Download-Begin
navegação for executada, logo após o EVENTO
MSG-WB-BEFORE-NAVIGATE.
A rotina será executada quando uma operação de
Msg-Wb-Download-Complete
navegação for finalizada
A rotina será executada depois que o browser
Msg-Wb-Navigate-Complete
navegou na nova URL informada.
A rotina será executada na alteração do status de
Msg-Wb-Progress-Change
progresso de um download.
A rotina será executada quando houver alteração
Msg-Wb-Status-Text-Change
de texto na barra de status.
A rotina será executada quando houver alteração
Msg-Wb-Title-Change
do título de um documento aberto no browser.
Other
Exception Procedure
A rotina será executada quando for selecionado o
Cmd-Help
help do controle, após ocorrer o EVENTO CMDHELP.
Other
Before Procedure
After Procedure
controle.
A rotina será executada após o foco sair do
controle.
Página 95
AcuBench
Item
Cmd-Goto
Cmd-Help
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Msg-Spin-Down
Msg-Spin-Up
Msg-Validate
Ntf-Changed
Other
Cmd-Goto
Apostila
Value
Event Procedure
controle.
Utilizada para a propriedade SPINNER, a rotina será executada
quando for clicado na seta para baixo do campo.
Utilizada somente com a propriedade SPINNER, a rotina será
executada quando for clicado na seta para cima do campo.
será executada quando houver qualquer entrada de dados.
Exception Procedure
CMD-GOTO.
Other
será executada quando houver qualquer entrada de dados,
antes do EVENTO NTF-CHANGED.
Before Procedure
After Procedure
Cmd-Help
Ntf-Changed
Item
Cmd-Activate
Cmd-Close
Msg-End-Menu
Msg-Init-Menu
Msg-Menu-Input
Value
Event Procedure
A rotina será executada quando a janela for ativada.
A rotina será executada quando for clicado no botão X (sair)
da janela.
Página 96
AcuBench
Ntf-Resized
Other
Cmd-Activate
Cmd-Close
Ntf-Resized
Other
Before Create
After Create
Before Initdata
After Initdata
Before Procedure
After Procedure
Before Routine
After Routine
Link To
Apostila
Utilizado em conjunto com a propriedade RESIZABLE, a rotina
será executada quando for clicado no botão de restaurar.
Exception Procedure
A rotina será executada quando a janela for ativada.
A rotina será executada quando for clicado no botão X (sair)
da janela.
Utilizado em conjunto com a propriedade RESIZABLE, a rotina
será executada quando for clicado no botão de restaurar.
A rotina será executada antes da criação da tela.
A rotina será executada após a criação da tela.
A rotina será executada após o display da tela, porém antes
do accept da mesma e antes dos parágrafos lógicos dos
controles COMBO-BOX, LIST-BOX e GRID.
A rotina será executada após o display da tela, porém antes
do accept da mesma e depois dos parágrafos lógicos dos
controles COMBO-BOX, LIST-BOX e GRID..
A rotina será executada antes do foco chegar em cada
controle da tela.
A rotina será executada após o foco sair de cada controle da
tela.
A rotina será executada antes do display da tela.
A rotina será executada após o destroy da tela.
exceção de qualquer controle que estiver na tela.
Obrigatoriamente a propriedade EXCEPTION-VALUE deverá ter
um valor.
o DRAG AND DROP: Componente utilizado para adicionar um controle na tela já
vinculado a alguma variável.
Para visualizar a janela do Drag and Drog, no menu selecionar a opção VIEW  DRAG
AND DROP.
Página 97
AcuBench
Apostila
A-) Informa o local da variável a ser inserida na tela, podendo optar por: variáveis
de FD, variáveis do Working ou variáveis de Lankage.
B-) Informa o tipo de controle a ser inserido na tela, podendo optar por: Bitmap,
Check-Box, Combo-Box, Date-Entry, Grid, Label, List-Box, Paged Grid, Paged List-Box,
Radio-Button ou Web Browser.
C-) Local onde é visualizada a variável para poder seleciona-la e arrastar para a tela.
Para arrastar um controle já vinculado a uma variável, basta no item A informar o
local, no item B escolher o controle e no item C selecionar uma ou mais variáveis, clicar,
segurar e arrastar até a tela.
Para cada controle a ser inserido na tela, o Acubench abre uma janela para a
definição de suas propriedades, abaixo segue seqüência dessas propriedades.
Não abre nenhuma janela para configuração de propriedades, apenas vincula o
nome da variável do arquivo à propriedade VALUE VARIABLE do controle.
As propriedades configuradas nessa tela, servem para o Acubench gerar o
parágrafo que carrega os registros no combo box, após ter finalizado essa janela, se
desejar voltar, selecione o controle, na seção PROPERTY WINDOW, selecionar a
propriedade AUTO LOAD.
Página 98
AcuBench
Apostila
A-) Source: Informa o nome do arquivo a ser lido para gerar o parágrafo do
controle.
B-) Informa os campos do arquivo, os quais os registros serão carregados no
controle.
C-) Botões para seleção dos campos a serem adicionados.
D-) ComboBox Column: Visualiza os campos do arquivo que foram selecionados
para ser carregados os registros no controle.
E-) Condições para gerar o parágrafo de leitura do arquivo, aceitando as seguintes
sintaxes:
Item
Value
Start Key
Informa a chave do arquivo para dar o start.
Start Value
Informa o valor que a chave deve receber antes do start.
Informa o nome de uma variável, que a chave deve
Start Value Variable
receber o seu conteúdo antes do start.
Start Value Variable Pic Informa o tamanho da variável.
Informa a maneira de comparação da chave para o
Start Direction
start, podendo ser >=, <=, >, <, = ,<>, etc...
Informa o nome de um parágrafo a ser executado se der
Invalid Key Perform
erro no start do arquivo.
Direção da leitura dos registros, podendo ser next,
Read Direction
previous, etc…
Informa a condição para sair do loop. Ex: not valid wsPerform Until Condition
variável.
End Value Variable
Informa o nome da variável criada no item acima.
End Value Variable Pic Informa o tamanho da variável.
Informa o nome de um parágrafo a ser executado quando
At End Perform
for final de arquivo.
Informa o nome de um parágrafo a ser executado
Not At End Perform
enquanto não for final de arquivo.
Página 99
AcuBench
Add Item Condition
Apostila
Informa uma condição verdadeira para realizar a
atualização no combo. Não é necessário colocar a
sintaxe IF.
F-) Funções:
Finaliza a janela sem salvar as configurações.
Salva as configurações.
Após salvar as configurações o Acubench irá gerar os parágrafos:
Acu-nomecontrole-Autoload.
MODIFY nomecontrole, MASS-UPDATE = 1
MOVE low-value TO var-arquivo |Conteúdo do item Start Value ou Start Value Variable
START arquivo, KEY >= chave
|Conteúdo dos itens Start Direction e Start Key
INVALID KEY…
|Se colocar o item Invalid Key Perform
END-START
PERFORM UNTIL condição
|Conteúdo do item Perform Until Condition e/ou
|End Value Variable
READ arquivo next RECORD
|Conteúdo do item Read Direction
AT END…
|Se colocar o item At End Perform
NOT AT END…
|Se colocar o item Not At End Perform, não será
| acionado o parágrafo abaixo, gerado pelo Acubench
IF condição
|Se colocar o item Add Item Condition
PERFORM Acu-nomecontrole-Autoload-Add
END-IF
END-READ
END-PERFORM
MODIFY nomecontrole, MASS-UPDATE = 0.
Acu-nomecontrole-Autoload-Add.
PERFORM Acu-nomecontrole-Autoload-Load
MODIFY nomecontrole, ITEM-TO-ADD var-controle
INITIALIZE var-controle.
Acu-nomecontrole-Autoload-Load.
MOVE var-arquivo TO var-controle.
nomecontrole = nome do controle dado ao combo-box, na propriedade name
var-arquivo = nome da variável do arquivo que compõe a chave
arquivo = nome do arquivo a ser lido
chave = nome do campo chave
var-controle = variável do controle combo-box, na propriedade value variable
Página 100
AcuBench
Apostila
parágrafo que carrega os registros no grid, após ter finalizado essa janela, se desejar
voltar, selecione o controle, na seção PROPERTY WINDOW, selecionar a propriedade AUTO
LOAD.
Página 101
AcuBench
Apostila
A-) Source: Informa o nome do arquivo a ser lido para
controle.
gerar o parágrafo do
controle.
D-) Grid Column(s): Visualiza os campos do arquivo que foram selecionados para
serem carregados os registros em cada coluna do controle.
sintaxes:
Item
Value
Start Key
Start Value
Start Direction
Invalid Key Perform
Read Direction
previous, etc…
variável.
End Value Variable
At End Perform
Not At End Perform
Add Item Condition
atualização no grid. Não é necessário colocar a sintaxe
IF.
F-) Funções:
Página 102
AcuBench
Apostila
MODIFY nomecontrole, X = 1, Y = 1 CELL-DATA = nome-var-arq-col1
INVALID KEY…
END-START
|End Value Variable
AT END…
NOT AT END…
IF condição
END-IF
END-READ
END-PERFORM
MODIFY nomecontrole, RECORD-TO-ADD var-controle
MOVE var-arquivo-col1 TO var-controle-col1.
nomecontrole = nome do controle dado ao grid, na propriedade name
nome-var-arq-col1= nome da variável do arquivo que aparece na coluna 1
var-controle = variável do controle grid, na propriedade value variable
var-controle-col1 = variável do controle grid, subnivel da variável var-controle
Página 103
var-controle-col2 = variável do controle
grid, subnivel da variável var-controle
AcuBench
Apostila
parágrafo que carrega os registros no list box, após ter finalizado essa janela, se desejar
voltar, selecione o controle, na seção PROPERTY WINDOW, selecionar a propriedade AUTO
LOAD.
Página 104
AcuBench
Apostila
controle.
controle.
D-) ListBox Column(s): Visualiza os campos do arquivo que foram selecionados
para serem carregados os registros em cada coluna do controle.
sintaxes:
Item
Value
Start Key
Start Value
Start Direction
Invalid Key Perform
Read Direction
previous, etc…
variável.
End Value Variable
At End Perform
Not At End Perform
Add Item Condition
atualização no list box. Não é necessário colocar a
sintaxe IF.
F-) Funções:
Página 105
AcuBench
Apostila
INVALID KEY…
END-START
|End Value Variable
AT END…
NOT AT END…
IF condição
END-IF
END-READ
END-PERFORM
nomecontrole = nome do controle dado ao list-box, na propriedade name
var-controle = variável do controle list-box, na propriedade value variable
var-controle-col1 = variável do controle list-box, subnivel da variável var-controle
var-controle-col2 = variável do controle
list-box,
subnivel da variável var-controle
Página
106
AcuBench
Apostila
parágrafo que carrega os registros no grid com paged, após ter finalizado essa janela, se
desejar voltar, selecione o controle, na seção PROPERTY WINDOW, selecionar a
controle.
controle.
Página 107
AcuBench
Apostila
D-) Grid Column(s): Visualiza os campos do arquivo que foram selecionados para
serem carregados os registros em cada coluna do controle.
sintaxes:
Item
Start Key
Invalid Key Perform
Value
F-) Funções:
MODIFY nomecontrole, ACTION = ACTION-FIRST-PAGE.
MODIFY nomecontrole, RECORD-TO-ADD var-controle
var-controle = variável do controle grid, na propriedade value variable
Página 108
AcuBench
Apostila
E os parágrafos abaixo, permitindo a intervenção do desenvolvedor:
* Autoload Paged control code generated by Drag-And-Drop
Nomecontrole-Ev-Msg-Paged-Next.
perform event-data-2 times
read arquivo next record
at end
move event-action-fail to event-action
exit paragraph
end-read
end-perform.
PERFORM ACU-nomecontrole-Autoload-Add.
Nomecontrole-Ev-Msg-Paged-Prev.
PERFORM event-data-2 times
read arquivo previous record
at end
exit paragraph
end-read
end-perform.
PERFORM nomecontrole-Autoload-Load.
MODIFY nomecontrole, INSERTION-INDEX=2,
RECORD-TO-ADD = nomecontrole -Autoload.
Nomecontrole-Ev-Msg-Paged-First.
move low-values to var-chave
start estado, key >= var-chave
invalid key
end-start.
Nomecontrole -Ev-Msg-Paged-Last.
move high-values to var-chave
start estado, key <= var-chave
invalid key
end-start.
Página 109
var-chave = nome da variável do arquivo que compõe a chave
AcuBench
Apostila
parágrafo que carrega os registros no list box com paged, após ter finalizado essa janela,
se desejar voltar, selecione o controle, na seção PROPERTY WINDOW, selecionar a
controle.
controle.
Página 110
AcuBench
Apostila
D-) ListBox Column(s): Visualiza os campos do arquivo que foram selecionados
para serem carregados os registros em cada coluna do controle.
sintaxes:
Item
Start Key
Invalid Key Perform
Value
F-) Funções:
Apóslow-value
salvar asTO
configurações
MOVE
var-arquivo o Acubench irá gerar
END-START
PERFORM nomecontrole-page-size TIMES
AT END
SET nomecontrole-at-end TO TRUE
EXIT PERFORM
NOT AT END
END-READ
END-PERFORM
os parágrafos:
nomecontrole = nome do controle dado ao list-box, na propriedade name
arquivo = nome do arquivo a ser lido Página 111
var-controle = variável do controle list-box, na propriedade value variable
AcuBench
Apostila
nomecontrole-Ntf-Pl-Next.
PERFORM nomecontrole-get-next-item.
nomecontrole-Ev-Ntf-Pl-Prev.
PERFORM nomecontrole-get-prev-item .
E os parágrafos abaixo, permitindo a intervenção do desenvolvedor:
nomecontrole-Ev-Ntf-Pl-Nextpage.
PERFORM nomecontrole-Get-Next-Item
nomecontrole-page-size TIMES
nomecontrole-Ev-Ntf-Pl-Prevpage.
PERFORM nomecontrole-Get-Prev-Item
nomecontrole -page-size TIMES
nomecontrole-Ev-Ntf-Pl-First.
MOVE LOW-VALUES TO var-chave
START arquivo, KEY NOT < var-chave
END-START.
SET nomecontrole-READING-FORWARDS TO TRUE
RESET-LIST = 1.
PERFORM nomecontrole-get-next-item
nomecontrole-page-size times
nomecontrole-Ev-Ntf-Pl-Last.
MOVE HIGH-VALUES TO var-chave
START arquivo, KEY NOT > var-chave
END-START.
SET nomecontrole-READING-BACKWARDS TO TRUE
RESET-LIST = 1.
PERFORM nomecontrole-get-prev-item
nomecontrole-page-size TIMES
Página 112
AcuBench
nomecontrole -get-next-item.
EVALUATE TRUE
WHEN nomecontrole -at-start
MOVE low-value TO var-chave
START arquivo, KEY NOT < var-chave
END-START
ADD 1 TO nomecontrole-page-size
GIVING nomecontrole-number-reads-needed
WHEN nomecontrole-at-end
EXIT paragraph
WHEN nomecontrole-reading-backwards
MOVE nomecontrole-page-size TO
nomecontrole-number-reads-needed
WHEN nomecontrole-reading-forwards
MOVE 1 TO nomecontrole-number-reads-needed
END-EVALUATE.
PERFORM nomecontrole-number-reads-needed TIMES
READ arquivo NEXT RECORD
AT END
SET nomecontrole-at-end TO TRUE
EXIT paragraph
END-READ
END-PERFORM.
INITIALIZE nomecontrole-Autoload
PERFORM nomecontrole-Autoload-Load
MODIFY nomecontrole, ITEM-TO-ADD = nomecontrole-Autoload
SET nomecontrole-reading-forwards TO TRUE.
nomecontrole-get-prev-item.
EVALUATE TRUE
WHEN nomecontrole-at-end
MOVE high-value TO var-chave
START arquivo KEY NOT > var-chave
END-START
ADD 1 TO nomecontrole-page-size
GIVING T nomecontrole-number-reads-needed
WHEN nomecontrole-at-start
EXIT paragraph
WHEN nomecontrole-reading-forwards
MOVE nomecontrole-page-size TO
nomecontrole-number-reads-needed
WHEN T1-Lb-2-reading-backwards
MOVE 1 TO nomecontrole-number-reads-needed
END-EVALUATE.
PERFORM nomecontrole-number-reads-needed TIMES
READ arquivo PREVIOUS RECORD
AT END
SET nomecontrole-at-start TO TRUE
EXIT paragraph
END-READ
END-PERFORM.
Página 113
INITIALIZE nomecontrole-Autoload
PERFORM Acu- nomecontrole-Autoload-Load
MODIFY nomecontrole, INSERTION-INDEX = 1
ITEM-TO-ADD = nomecontrole-Autoload
SET nomecontrole-reading-backwards TO TRUE.
Apostila
AcuBench
Apostila
As propriedades configuradas nessa tela, servem para o Acubench criar na window
todos os rádios buttons vinculados à mesma variável na propriedadeVALUE VARIABLE, ao
mesmo grupo na propriedade GROUP, porem cada um com o seu valor na propriedade
GROUP-VALUE.
A-) Variable: Informa o nome da variável que será vinculada ao controle.
B-) Group: Informa a quantidade de radio’s que fará parte desse grupo e o valor de
cada um deles (1, 2, 3,, etc...).
C-) Funções para criação do radio.
Adiciona um radio ao grupo.
Página 114
AcuBench
Apostila
Apaga o radio selecionado.
Apaga todos os radios selecionados.
D-) Prompt: Informa o título de cada radio para ser visualizado na window.
F-) Funções:
Capitulo X – Definição do Report – Programa
Após a definição do programa, o desenvolvedor pode adicionar relatório(s) ao
programa, selecionando o tipo (gráfico ou caracter) e o modelo (templates).
Para relatórios gráficos, o Acubench irá criar em seu fonte uma estrutura HTML,
assim sendo comandado pela DLL ACUBENCHPRINT.DLL, responsável por toda a criação,
visualização e impressão do relatório.
Para relatórios caracter, o Acubench irá criar a estrutura padrão, gerando um arquivo
para impressão, ou até mesmo enviando para o spool da impressora.
Procedimentos para a definição de relatório.
aba Report que será visualizada a seguinte opção:
Página 115
AcuBench
Apostila
A-) Tipos de relatórios a serem criados, optando por gráfico ou caracter, existe as
opções:
Cria um relatório gráfico em branco.
Cria um relatório caracter em branco.
B-) Tipo de relatórios gráfico e caracter criados através de TEMPLATES.
Relatório template com os controles e seções que optar .
C-) Form Name: Define o nome do relatório.
D-) Unique Prefix: Define o prefixo que será criado como parte do nome de cada
controle.
E-) Create with new program, and add to program: Cria esse relatório em um
prorama novo e adiciona esse programa ao projeto aberto.
F-) Add to existing program: Indica o programa onde será criado o relatório.
Página 116
AcuBench
Apostila
Os principais componentes do Report Design são: Section Controller, Report
Component Toolbox, Property Window e Drag and Drop.
o SECTION CONTROLLER: Componente responsável por adicionar ou remover as
seções do relatório, que são: Report Header, Report Footer, Page Header, Page
Footer, Detail, Group Header e Group Footer.
Procedimentos para acionar o componente Section Controller. Com o Report aberto,
clicar com o botão direito sobre a sua área e selecionar
, que será
visualizada a seguinte janela:
A-) Header & Footer: Seção destinada a Cabeçalho e Rodapé, assume as seções:
Report Header A impressão será no inicio do relatório apenas.
A impressão será no final do relatório apenas, independendo de
Report Footer
sua posição da página.
Page Header
Será impresso sempre no início de cada página.
Page Footer
Será impresso sempre no final de cada página.
B-) Detail Section: Seção destinada ao corpo do Relatório, aceitando mais de um.
Página 117
AcuBench
Apostila
C-) Funções para criação do detalhe.
Movimenta o detalhe para cima.
Movimenta o detalhe para baixo.
Adiciona um detalhe.
Exclui o detalhe selecionado.
Exclui todos os detalhes criados.
D-) Group Section: Seção destinada as quebras do relatório, informando as
Informa a maneira de como será a quebra do relatório. Aceita:
Field
A quebra será efetuada pelo campo informado.
Type
A quebra será efetuada pelo conteúdo do campo
Record
gravado no arquivo, respeitando os parâmetros
informados em Grouped By.
Informa qual o campo do arquivo que será responsável pela
Grouped By
quebra.
Informa quais seções referentes à quebra será impressa no
relatório. Aceita:
Header
A seção será impressa no inicio de cada quebra.
Show What
Footer
A seção será impressa no final de cada quebra.
Both
Irá criar as duas seções citadas acima.
Calcula a quantidade de linhas de acordo com o layout da pagina
para realizar a quebra. Aceita:
None
Não fará calculo de linhas.
Count Height
Both
Fará o calculo para Header e Footer.
Header
Fará calculo para o inicío da quebra.
Footer
Fará calculo para o final da quebra.
C-) Funções para criação da quebra.
Movimenta o detalhe para cima.
Movimenta o detalhe para baixo.
Adiciona um detalhe.
Exclui o detalhe selecionado.
Exclui todos os detalhes criados.
o REPORT COMPONENTE TOOLBOX: Componente utilizado para adicionar um
controle no relatório.
Página 118
AcuBench
A-)
Apostila
Visualiza os controles nativos do Acucobol.
Controle estático utilizado para exibição de texto descritivo.
Visualização de dados.
Barra, espécie de Draw.
Controle caracterizado pela visualização de um único item
pertencente a um grupo.
Visualização de um item selecionado (valor 1).
Borda.
Visualização de imagem (bmp ou jpg).
Visualização de diversos registros para um mesmo campo.
Visualização de registros de ocorrências.
Visualização de Data e Hora.
Visualização de dados em tabela.
o PROPERTY WINDOW: Componente utilizado para configurar propriedade para os
controles e programar seus eventos.
A-) Alphabetic: Seção utilizada para a configuração das propriedades de cada
controle, visualizada em ordem alfabética.
Segue lista com todas as propriedades de cada controle.
Propriedade
Descrição
Página 119
AcuBench
Apostila
(Name)
Border Color
Nome do Controle
Informa a cor da borda do controle.
Boxed
Aciona uma borda do controle.
Border Style
No Box
O controle não terá borda.
Border Width
Largura da borda em pixel.
Color
Informa a cor do texto, background e foreground.
Column
Ajusta a coluna onde o controle se inicia, em relação ao relatório
Font
Hyperlink
Informa o endereço de hyperlink para vincular ao controle.
Center
Centraliza o texto do controle.
Left
Alinha o texto do controle à esquerda.
Justification
Right
Alinha o texto do controle à direita.
Unaligned Não ajusta o texto do controle.
Line
Ajusta a linha onde o controle se inicia, em relação ao relatório.
Lines
Informa uma condição para que esse campo seja impresso,
Print Condition
podendo ser uma operação aritmética ou comando If.
Size
Title
Visible
Visualiza ou não o controle no relatório. (1 verdadeiro, 0 falso).
Propriedade
(Name)
Border Color
Descrição
Nome do Controle
Boxed
Border Style
No Box O controle não terá borda.
Border Width
Color
Ajusta a coluna onde o controle se inicia, em relação ao
Column
relatório.
Aceita qualquer quantidade de espaços entre
Keep Space
as string’s.
Display Type
Preformatted Assume a formatação do campo.
Collapse
Adiciona somente um espaço entre string’s.
Font
Para campos com decimal, informa o espaço que conterá
Horizontal Spacing
entre cada caracter.
Hyperlink
Center
Left
Justification
Right
Ajusta a linha onde o controle se inicia, em relação ao
Line
relatório.
Lines
Página 120
AcuBench
Print Condition
Print If Repeate
Size
Value
Value Picture
Value Variable
Visible
Apostila
Se selecionado, imprime o conteúdo do controle mesmo sendo
igual ao anteriormente impresso.
Visualiza o conteúdo do controle.
Informa a pic da variável relacionada ao controle.
Informa variável que será relacionada ao controle e que
receberá o seu valor.
Propriedade
(Name)
Color
Column
Descrição
Propriedade
(Name)
Color
Column
Font
Group
Line
Lines
Descrição
Nome do Controle
Informa a cor da barra.
Ajusta a coluna onde o controle se inicia, em relação ao relatório.
Horizontal
Assume que a linha será impressa na horizontal.
Kind
Vertical
Assume que a linha será impressa na vertical.
Line
Print Condition
Print If
Repeate
Size
Visible
Width
Largura da linha em pixel.
Nome do Controle.
Ajusta a coluna onde o controle se inicia, em relação ao relatório.
Valor que informa em qual grupo o radio do relatório pertence.
Print Condition
Size
Title
Value
Visualiza o conteúdo do controle.
Value Picture
Informa variável que será relacionada ao controle e que receberá
Value Variable
o seu valor.
Visible
Página 121
AcuBench
Apostila
Propriedade
(Name)
Color
Column
Font
Line
Lines
Descrição
Propriedade
(Name)
Border Color
Descrição
Nome do Controle.
Print Condition
Size
Title
Visualiza o conteúdo do controle, podendo ser 0 para falso ou 1
Value
para verdadeiro.
Informa variável que será relacionada ao controle e que receberá
Value Variable
o seu valor.
Visible
Nome do Controle.
Boxed
Border Style
No Box
Border Width
Color
Informa a cor da borda.
Column
Line
Lines
Print Condition
Size
Visible
Propriedade
(Name)
Bitmap
Bitmap Path
Descrição
Nome do Controle.
Adiciona uma imagem ao controle, (BMP ou JPEG).
Informa todo o caminho da imagem para ser
Full Path
localizada.
O caminho da imagem será localizado
Dynamic Full Path
através da rotina “C$FULLNAME”.
A imagem será localizada no mesmo
User Defined
diretório que se encontra o arquivo .HTML.
Página 122
AcuBench
Apostila
Center
Bitmap Position
Bitmap Style
Border Color
Border Style
Border Width
Color
Column
Hyperlink
Line
Lines
Print Condition
Print If Repeat
Size
Value Variable
Visible
Propriedade
(Name)
Auto Resize
Border Color
Border Style
Border Width
Color
Column
Column Headings
Alinha a imagem centralizada ao controle.
Alinha a imagem do lado esquedo e no inicio do
Left Top
controle.
Alinha a imagem do lado esquedo e no final do
Left Bottom
controle.
Alinha a imagem do lado direito e no inicio do
Right Top
controle.
Alinha a imagem do lado direito e no final do
Right Bottom
controle.
A altura e a largura da imagem será modificada
Stretch
conforme o tamanho do controle.
A altura e largura da imagem serão preservadas
Ratio
mesmo alterando o tamanho do controle.
Boxed
No Box
relatório.
Descrição
Nome do Controle.
Se verdadeiro, no momento da leitura dos dados o grid
reajusta o tamanho das divisões do controle.
Boxed
relatório.
Página 123
AcuBench
Apostila
coluna do grid.
Name Cria uma variável para cada coluna.
Pic
Informa o título a ser visualizado no cabeçalho da
Head
coluna.
Column’s Setting Width Informa a largura da coluna.
Center
Left
Align
Right
Informa outras configurações para a coluna, como
More
fonte, cor e hyperlink.
Font
Heading Color
Line
relatório.
Lines
Print Condition
Row Color Pattern Intercala cores por linha.
Show Grid Line
Se verdadeira visualiza todas as linhas do grid.
Size
Visible
Propriedade
(Name)
Auto Resize
Border Color
Border Style
Border Width
Color
Column
Column Headings
Descrição
Nome do Controle.
Se verdadeiro, no momento da leitura dos dados o controle
tem as divisões reajustadas.
Boxed
relatório
Página 124
AcuBench
Apostila
variável de ocorrencia.
Name Cria uma variável para cada coluna.
Pic
Informa o título a ser visualizado no cabeçalho da
Head
coluna.
Column’s Setting Width Informa a largura da coluna.
Center
Left
Align
Right
Informa outras configurações para a coluna, como
More
fonte, cor e hyperlink.
Font
Heading Color
Line
relatório.
Lines
Print Condition
Row Color Pattern Intercala cores por linha.
Show Grid Line
Se verdadeira visualiza todas as linhas do occurs.
Size
Visible
Propriedade
(Name)
Border Color
Descrição
Nome do Controle.
Boxed
Border Style
Border Width
Color
Column
relatório.
Date Format
Formato de como o campo será visualizado.
Date Picture Format Formato de como o campo será gravado.
Font
Hyperlink
Center
Left
Justification
Right
Line
relatório.
Página 125
AcuBench
Apostila
Lines
Print Condition
Se selecionado, imprime o conteúdo do controle mesmo
Print If Repeat
sendo igual ao anteriormente impresso.
Size
Time Format
Formato de como o campo será visualizado.
Time Picture Format Formato de como o campo será gravado.
Value Picture
Value Variable
Visualiza ou não o controle no relatório. (1 verdadeiro, 0
Visible
falso).
Propriedade
(Name)
Descrição
Nome do Controle.
Informa todo o caminho da imagem para
ser localizada.
O caminho da imagem será localizado
Bitmap Path
Dynamic Full Path
através da rotina “C$FULLNAME”.
A imagem será localizada no mesmo
User Defined
diretório que se encontra o arquivo .HTML.
Border Color
Boxed
Border Style
No Box
Border Width
Cell Padding
Ajusta a altura da célula.
Cell Spacing
Elimina linhas em branco na tabela.
Color
Column
relatório.
Font
Line
Lines
Merge Cell
Aumenta ou diminui o tamanho das células da tabela
Print Condition
Show Grid Line Se verdadeira visualiza todas as linhas da tabela.
Size
Table Rearrange Formatação de quantidade de linhas e colunas
Configurações das linhas, colunas e tipos de variáveis de cada
Table Setting
célula.
Full Path
Página 126
AcuBench
Visible
Apostila
Propriedade
(Name)
Descrição
Nome do Relatório.
Utilizada somente com a propriedade Report Style = N-TOP,
Num Columns
informa o número de colunas .
Output File Name
Informa o nome físico do arquivo HTML a ser gerado.
Informa o nome de uma variável que receberá o nome físico
Output File Variable
do arquivo HTML a ser gerado.
Informa o tamanho do papel, a horientação do mesmo
Paper Size
(paisagem ou retrato) e o tamanho das margens.
Utilizada para impressão, pois controla as
Standard
quebras.
Report Style
Utilizada apenas para visualização pois não
N-Top
controla as quebras.
Visualiza todas as propriedades
Specify Internet Explorer
adicionadas ao relatório.
Target Browser
Gera com puro HTML não
Standard HTML
assumindo
determinadas
propriedades.
Texto a ser visualizado na barra Azul quando o HTML do
Title
relatório for aberto.
Watermark
Informa uma imagem para aparecer como marca d’agua.
None Não assume nenhum estilo para a marca d’agua.
Centraliza a imagem, mais ulitizado para imagens
Center
Watermark Style
grandes.
Mostra varias vezes a mesma imagem, mais
Tile
utilizadas para imagens pequenas.
Todas as seções do relatório também possuem propriedades, segue lista de
propriedades de cada seção do relatório.
Report Header
Propriedade
(Name)
Color
Font
Lines
Print Before Page Header
Print Condition
Size
Skip Page after Print
Descrição
Nome para o item Report Header.
Cor de fundo da seção e dos controles.
Fonte da seção.
Ajusta a altura da Seção.
Informa se a impressão dessa seção será antes da
impressão da seção Page Header.
Condições para que a seção seja impressa.
Ajusta a largura da seção.
Se verdadeiro após a impressão dessa seção, será
impresso uma página em branco.
Página 127
AcuBench
Apostila
Visualiza ou não a seção no relatório. (1 verdadeiro, 0
falso).
Visible
Page Header
Propriedade
(Name)
Color
Font
Lines
Print Condition
Size
Visible
Descrição
Nome para o item Page Header.
Fonte da seção.
Visualiza ou não a seção no relatório. (1 verdadeiro, 0 falso).
Group Header
Propriedade
(Name)
Color
Font
Lines
Print Condition
Size
Skip Page before Print
Visible
Descrição
Nome para o item Group Header.
Fonte da seção.
Se verdadeiro antes da impressão dessa seção, será
falso).
Detail
Propriedade
(Name)
Color
Font
Lines
Print Condition
Size
Visible
Zebra
Descrição
Nome para o item Detail.
Fonte da seção.
falso).
Alterna as cores das linhas do detalhe.
Group Footer
Propriedade
Descrição
Página 128
AcuBench
Apostila
(Name)
Color
Font
Lines
Print Condition
Size
Visible
Page Footer
Propriedade
(Name)
Color
Font
Lines
Print Condition
Size
Visible
Descrição
Nome para o item Page Footer.
Fonte da seção.
Visualiza ou não a seção no relatório. (1 verdadeiro, 0 falso).
Report Footer
Propriedade
(Name)
Color
Font
Lines
Print After Page Footer
Print Condition
Size
Visible
Nome para o item Group Footer.
Fonte da seção.
falso).
Descrição
Nome para o item Report Footer.
Fonte da seção.
Informa se a impressão dessa seção será depois da
impressão da seção Page Footer.
falso).
B-) Categorized: Seção utilizada para a configuração das propriedades de cada
controle, igual a Properties, porém visualizada em ordem de categoria das propriedades.
C-) Event: Seção utilizada para criar os parágrafos lógicos relacionados a cada
controle. Para o relatório, todos os controle possui apenas:
Before Print A rotina será executada antes da impressão do controle.
Página 129
AcuBench
After Print
Apostila
A rotina será executada após a impressão do controle.
o DRAG AND DROP: Componente utilizado para adicionar um controle no relatório
já vinculado a alguma variável.
Para visualizar a janela do Drag and Drog, no menu selecionar a opção VIEW  DRAG
AND DROP.
A-) Informa o local da variável a ser inserida no relatório, podendo optar por:
variáveis de FD, variáveis do Working ou variáveis de Lankage.
B-) Informa o tipo de controle a ser inserido na tela, podendo optar por: Rpt-CheckBox, Rpt-Date-Time, Rpt-Entry-Field, Rpt-Image, Rpt-Label, Rpt-Occurs, Rpt-Radio-Button
e Rpt-Table.
C-) Local onde é visualizada a variável para poder seleciona-la e arrastar para o
relatório.
Para arrastar um controle já vinculado a uma variável, basta no item A informar o
local, no item B escolher o controle e no item C selecionar uma ou mais variável, clicar,
segurar e arrastar até o relatório.
Principais Parágrafos do Relatório
As rotinas referente ao relatório deverão ser feitas diretamente no Fonte do
programa, para isso, clicar com o botão direito no programa (no Workspace, aba
Página 130
AcuBench
Apostila
Structure) selecionar a opção
para gerar o fonte do programa, em seguida
clicar novamente com o botão direito e selecionar a opção View Programa.cbl
No final do fonte, será gerado a seção REPORT COMPOSER, responsável pelo
parágrafo de leitura dos registros.
Está seção contem o parágrafo Acu-Rpt-nomerel-Master-Print-Loop, dentro desse
parágrafo que deve ficar a rotina de leitura.
Não esquecer de colocar a rotina após a tag
ao gerar o programa NÃO, apague o conteúdo do parágrafo.
Parágrafos referentes à impressão e visualização:
Página 131
para que o Acubench,
AcuBench
Apostila
-Acu-Rpt-nomerel-Setup-Print: Executa a função da dll ACUBENCHPRINT.DLL,
que abre a janela de setup para a seleção da impressora desejada.
-Acu-Rpt-nomerel-Preview: Executa a função da dll ACUBENCHPRINT.DLL, que
abre o preview do Internet Explorer.
-Acu-Rpt-nomerel-Print: Executa a função da dll ACUBENCHPRINT.DLL, que envia
o relatório direto para a impressora, ou no caso de caracter envia direto para o
spool de impressão.
O perform desses parágrafos devem ficar dentro do parágrafo Acu-Main-Logic,
após o perform Acu-Initial-Routine.
Demais parágrafos.
-Acu-Rpt-nomerel-Print-Para: Monta a estrutura do arquivo físico, verificando
encaminhamento e nome para o mesmo.
-Acu-Rpt-nomerel-Print-toFile: Gera o arquivo físico, sendo para gráfico HTML
e para caracter arquivo texto.
-Acu-Rpt-nomerel-Print-Loop: Parágrafo chamado para montar o conteúdo do
relatório após a leitura de cada registro.
Página 132
AcuBench
Apostila
Capitulo XI – Definição da Working Section – Programa
Após a definição do programa, o desenvolvedor pode adicionar variável temporária,
que são as chamadas variáveis de Working.
Procedimentos para a criação de variáveis de Working.
Com o
Workspace aberto, na aba Structure, dar um duplo clique na seção
que será visualizada a seguinte janela:
A-) Data Description Entry: Área para definição das variáveis e seus atributos.
Level
Informa o nivel da variável.
Field Name Informa o nome da variável.
Pic
Informa o tamnho e tipo de variável.
Página 133
AcuBench
Usage
Value
Redefines
Occurs
Apostila
Informa a forma de uso para a variável, abre um combo aceitando as
seguintes opções:
Variáveis COMP, BINARY, PACKED-DECIMAL, DISPLAY, INDEX, POINTER,
FLOAT, DOUBLE, SIGNED, UNSIGNED e HANDLE.
Informa um valor para o campo.
Informa uma variável para redefinir.
Informa se a variável vai possuir ocorrencias, aceitando os seguintes
atributos:
Field Name
Nome da variável selecionada.
Occurs Clause
Aciona ou não a opção de occurs para a variável.
Occurs
Aciona o verbo Occurs para a variável.
Fixed
Informa um valor fixo para a ocorrencia.
Aciona a ocorrencia variável informando um valor
Variable
mínimo e máximo e uma outra variável para
DEPENDING ON.
Key
Habilita a sintaxe KEY IS.
Visualiza todas as variáveis que possam ser
Available Fields
adicionadas como chave.
Key List
Informa todas chaves selecionadas.
Informa a ordem da chave, podendo ser
Order
ASCENDING ou DESCENDING.
Indexed by
Habilita a sintaxe INDEXED BY.
Index Name
Informa o nome do índice.
Index List
Lista todas as variáveis de índice.
Informa atributos especiais para o campo. Aceitando os seguintes
atributos:
Global
Habilita a sintaxe IS GLOBAL.
External
Habilita a sintaxe IS EXTERNAL.
Informa que a variável será SPECIAL- NAMES,
aceitando os seguintes valores: CURSOR, CRTSpecial Names
STATUS, CHART STATUS, SCREEN CONTROL e
EVENT STATUS.
Informa que a variável será SIGN IS, aceitando
os seguintes valores: LEADING e TRAILING.
Habilita a sintaxe SYNCHRONIZED, aceitando
Syncronize
os valores LEFT e RIGHT.
Justified Right
Habilita a sintaxe JUSTIFIED RIGHT.
Blank when Zero
Habilita a sintaxe BLANK WHEN ZERO.
Habilita somente para variável que pertence a
Copy File
um copy.
Inporta a variável para pertencer ao
Convert Link to Import
programa.
Name
Visualiza o nome do arquivo de cópia.
Comentário para a variável que aparecerá no
Comment
arquivo de working.
Sign
More
B-) Funções para manipulação das variáveis pertencentes a Working:
Página 134
AcuBench
Apostila
Exclui todas as variáveis da Working.
Adiciona uma variável acima da variável selecionada.
Adiciona uma variável na posição do cursor.
Adiciona um sub-item à variável seleciona.
C-) Define o nível da variável à ser inserida.
Link Copy File: Cria um copy de determinado arquivo.
Import Copy File: Importa o conteúdo do copy para o
programa.
Capitulo XII – Definição da Linkage Section – Programa
Após a definição do programa, o desenvolvedor pode adicionar variáveis de Linkage.
Procedimentos para a criação de variáveis de Linkage.
Com o
Workspace aberto, na aba Structure, dar um duplo clique na seção
A-) Data Description Entry: Área para definição das variáveis e seus atributos.
Level
Informa o nivel da variável.
Field Name Informa o nome da variável.
Pic
Informa o tamnho e tipo de variável.
Informa a forma de uso para a variável, abre um combo aceitando as
seguintes opções:
Usage
Variáveis COMP, BINARY, PACKED-DECIMAL, DISPLAY, INDEX, POINTER,
FLOAT, DOUBLE, SIGNED, UNSIGNED e HANDLE.
Página 135
AcuBench
Value
Redefines
Occurs
Apostila
Informa um valor para o campo.
Informa uma variável para redefinir.
Informa se a variável vai possuir ocorrencias, aceitando os seguintes
atributos:
Field Name
Nome da variável selecionada.
Occurs Clause
Aciona ou não a opção de occurs para a variável.
Occurs
Aciona o verbo Occurs para a variável.
Fixed
Informa um valor fixo para a ocorrencia.
Aciona a ocorrencia variável informando um valor
Variable
mínimo e máximo e uma outra variável para
DEPENDING ON.
Key
Habilita a sintaxe KEY IS.
Visualiza todas as variáveis que possam ser
Available Fields
adicionadas como chave.
Key List
Informa todas chaves selecionadas.
Informa a ordem da chave, podendo ser
Order
ASCENDING ou DESCENDING.
Indexed by
Habilita a sintaxe INDEXED BY.
Index Name
Informa o nome do índice.
Index List
Lista todas as variáveis de índice.
Informa atributos especiais para o campo. Aceitando os seguintes
atributos:
Global
Habilita a sintaxe IS GLOBAL.
External
Habilita a sintaxe IS EXTERNAL.
Informa que a variável será SPECIAL- NAMES,
aceitando os seguintes valores: CURSOR, CRTSpecial Names
STATUS, CHART STATUS, SCREEN CONTROL e
EVENT STATUS.
Informa que a variável será SIGN IS, aceitando
os seguintes valores: LEADING e TRAILING.
Habilita a sintaxe SYNCHRONIZED, aceitando
Syncronize
os valores LEFT e RIGHT.
Justified Right
Habilita a sintaxe JUSTIFIED RIGHT.
Blank when Zero
Habilita a sintaxe BLANK WHEN ZERO.
Habilita somente para variável que pertence a
Copy File
um copy.
Inporta a variável para pertencer ao
Convert Link to Import
programa.
Name
Visualiza o nome do arquivo de cópia.
Comentário para a variável que aparecerá no
Comment
arquivo de linkage.
Sign
More
B-) Funções para manipulação das variáveis pertencentes a Linkage:
Exclui todas as variáveis da Linkage.
Adiciona uma variável acima da variável selecionada.
Adiciona uma variável na posição do cursor.
Página 136
AcuBench
Apostila
Adiciona um sub-item à variável seleciona.
C-) Define o nível da variável à ser inserida.
Link Copy File: Cria um copy de determinado arquivo.
Import Copy File: Importa o conteúdo do copy para o
programa.
Capitulo XIII – Event Paragraph – Programa
Após a definição do programa, o desenvolvedor criará parágrafos lógicos, que
estarão vinculdas ou não a um controle.
Procedimentos para a criação de parágrafos lógicos no Event Paragraph.
Com o Workspace aberto, na aba Structure, dar um duplo clique na seção
A-) Manipula os principais atributos do Code Editor.
Página 137
AcuBench
Apostila
Control: Indica o controle, criado na tela ou relatório, onde será vinculado o
parágrafo criado.
Message: Indica o evento do controle onde será vinculado o parágrafo criado.
Paragraph: Informa o nome do parágrafo a ser criado.
Obs.: Para arquivos (abrir e fechar) e programas, selecionar diretamente nessa
seção.
Capitulo XIV – Data Set – Programa
Após a definição do programa, o desenvolvedor especificará os arquivos (data layout
- *.dlt) que serão abertos e suas formas de abertura.
Procedimentos para definição de um Data Set.
Com o Workspace aberto, na aba Structure, clicar com o botão direito na seção
e selecionar a opção New Data Set, será visualizada a seguinte janela:
A-) Data Set criado para o arquivo.
Obs.: Para cada arquivo é necessário criar um novo Data Set.
B-) Alphabetic: Seção utilizada para a configuração das propriedades do Data Set,
visualizada em ordem alfabética.
Propriedade
(Name)
Descrição
Define o nome do Data Set. O nome definido nesta
propriedade irá compor o nome dos parágrafos gerados
para o arquivo aqui relacionado.
Página 138
AcuBench
Data Layout
Key
Referenced Data Set
Apostila
Seleciona o arquivo (Data Layout - *.dlt) criado no projeto
para ser vinculado ao programa.
Seleciona a chave a ser utilizada pelo Data Set do
programa.
Cria um relacionamento entre um campo desse arquivo
com o campo de um outro arquivo (também definido no
programa).
B-) Categorized: Seção utilizada para a configuração das propriedades do Data
Set, igual a Properties, porém visualizada em ordem de categoria das propriedades.
C-) Event: Seção utilizada para criar os parágrafos lógicos relacionados a
determinado evento que o controle gerar.
Item
Value
A rotina será executada logo após a execução do parágrafo AcuAfter Delete
nomedataset-Delete definido para o data set.
A rotina será executada logo após a execução do parágrafo AcuAfter Read
nomedataset-Read definido para o data set.
A rotina será executada logo após a execução do parágrafo AcuAfter Rewrite
nomedataset-Rewrite definido para o data set.
A rotina será executada logo após a execução do parágrafo AcuAfter Write
nomedataset-Write definido para o data set.
A rotina será executada antes da execução do parágrafo AcuBefore Delete
nomedataset-Delete definido para o data set.
A rotina será executada antes da execução do parágrafo AcuBefore Read
nomedataset-Read definido para o data set.
A rotina será executada antes da execução do parágrafo AcuBefore Rewrite
nomedataset-Rewrite definido para o data set.
A rotina será executada antes da execução do parágrafo AcuBefore Write
nomedataset- Write definido para o data set.
Através do clique do botão direito do mouse sobre a janela que possui os ícones do
Data Set, será obtido as seguintes propriedades:
Item
New Data Set
Undo
Redo
Cut
Copy
Past
Delete
Select All
Referenced FD/SL Files
Find in Objects
Descrição
Cria um Data Set para o programa.
Desfaz a última ação.
Refaz a última ação desfeita.
Recorta o Data Set selecionado.
Copia o Data Set selecionado.
Cola o Data Set selecionado.
Exclui o Data Set selecionado.
Seleciona todos os Data Set’s.
Define a forma de abertura dos arquivos de cada Data
Set e os parágrafos que serão gerados referentes a ele.
Localiza uma palavra nos Data Set’s.
Página 139
AcuBench
Apostila
Principais Parágrafos do Data Set
-Acu-nomedataset-Read: Executa a leitura do arquivo.
-Acu-nomedataset-Read-Next: Executa a leitura do próximo registro do arquivo.
-Acu-nomedataset-Read-Prev: Executa a leitura do registro anterior do arquivo.
-Acu-nomedataset-Write: Executa a gravação do registro no arquivo.
-Acu-nomedataset-Rewrite: Executa a alteração do registro no arquivo.
-Acu-nomedataset-Delete: Executa a exclusão do registro no arquivo.
-Acu-nomedataset1-Ref-nomedatase2: Referência de campos entre arquivos.
Capitulo XV – Geração, Compilação e Execução
Após a criação do programa ou de um arquivo (Data Layout - *.dlt), é necessário
gerar para que o Acubench crie o fonte e os arquivos necessários, em seguida é
necessário compilar para que possa ser criado o objeto desse programa e por último a
execução do objeto criado.
Como o Acubench é uma ferramenta gráfica, existe diversas formas de se fazer um
mesmo processo, como no caso de Gerar, Compilar e Executar um programa, está sendo
informado uma das maneiras, porém lembramos que existem outras formas.
- Gerar o arquivo ou programa.
Clicar com o botão direito sobre o nome do programa (Workspace aberta, aba
Structure) ou arquivo (Workspace aberta, aba Data) e selecionar:
Para gerar o fonte do programa e toda a alteração que tenha sido
feita pelo Acubench.
Para gerar o arquivo estruturado do dlt criado no Acubench.
Obs.: Sempre que criar ou importar uma FD/SL deverá gerar o arquivo. Se fizer
alguma alteração do IO-HANDLE do arquivo, necessariamente deverá gerar o arquivo e por
conseqüência o programa, para que seja atualizado.
- Compilar o programa.
Página 140
AcuBench
Apostila
Structure) e selecionar:
Compila o programa com um fonte existente. Se ocorrer algum
erro, na janela Output Window (MENU  VIEW  OUTPUT WINDOW) será visualizado a linha
do erro e o tipo de erro, dando um duplo clique sobre o erro o Acubench abrirá o arquivo e
posicionará o cursor no local.
Se não tiver erro, a seguinte imagem será visualizada.
Página 141
AcuBench
Apostila
- Executar o programa.
Structure) e selecionar:
Executa o programa objeto.
Executa o programa objeto com a opção de Debug (Depurador).
Correção de Erros de Compilação
IO-Handle: Se ao der um duplo clique no erro e abrir o EVENT EDITOR com o cursor
na última linha do editor, e o erro não estiver na linha de cima, o erro está no IO-Handle,
para corrigir, através do Workspace, na aba Data, clicar com o botão direito no nome do
arquivo, selecionar EVENT EDITOR e fazer a correção necessária. Gerar novamente o
arquivo clicando com o botão direito no nome e selecionando GENERATE FD/SL.
Obs.: Nesse caso é obrigatória a geração e compilação do programa novamente.
No Workspace, aba Structural, botão direito no nome do programa e GENERATE SOURCE.
Eventos: Se ao der um duplo clique no erro e abrir o EVENT EDITOR em qualquer
posição, provavelmente o erro se encontra na mesma linha ou na linha de cima.
Obs.: Se aparecer o sinal de erro no editor, significa que foi aberto o arquivo .EVT e
não pode fazer alteração por ele. Quando isso ocorrer, fechar a janela, selecionar o EVENT
EDITOR e fazer a alteração necessária.
Relatórios: Se o erro for no parágrafo de leitura do arquivo, fazer a correção
diretamente no fonte do programa no Workspace, aba Structural, botão direito no nome
do programa selecionar VIEW PROGRAMA.CBL Se não, o erro deve ser corrigido direto no
EVENT EDITOR.
Página 142
AcuBench
Apostila
Capitulo XVI – Passo a Passo no Acubench
Um resumo de como criar Projetos, Arquivos e Programas no Acubench.
Criando o Projeto
aba Project e selecionar a opção Blank, em Project Name colocar o nome do Projeto e
em Location informar o diretório que será salvo o projeto. Clicar no botão OK.
Ao criar o projeto será criado o Workspace (MENU  VIEW  WORKSPACE).
Criando e Importando a FD/SL
Com o Workspace aberto, selecionar a aba Data.
Clicar com o botão direito sobre o nome do projeto e selecionar a opção New FD/SL.
Criando nova FD/SL
Página 143
AcuBench
Apostila
Para criar uma nova FD/SL, selecionar a opção Blank, em FD/SL Name colocar o
nome do arquivo e em Unique Prefix, informar o prefixo das variáveis. Clicar no botão
OK.
Importando FD/SL
Para importar uma FD/SL já existente, selecione a opção Import From Files, será
viualizado janela pedindo a Fd e a Sl a ser importada.
Após criar ou importar uma FD/SL, o Acubench criará um arquivo chamado File
Designer.
O File Designer visualiza estruturalmente o layout do arquivo (Fd e SL), ele é
dividido em 5 abas, que são: File Control, Definition, Key, IO-Handle e XFD.
A aba File Control, informa a estrutura do arquivo (SL). Na propriedade Name,
informar o nome físico do arquivo entr “ “, ou digitar o nome da variável que vai conter o
nome do arquivo, em Format , selecionar o formato do arquivo, em Access Mode,
selecionar o modo de acesso, em Lock Mode, selecionar a forma de bloqueio de
registros e em File Status, informar a variável de status para o arquivo.
A aba Definition, informa a estrutura dos campos no arquivo (FD). Adicionar as
variáveis clicando no botão Add, em Level, informar o nível da variável, em Field Name,
informar o nome da variável e em PIC, informar o tipo e tamanho da variável.
A aba Key, informa as chaves que irão compor o arquivo (SL). Em Fields
Description, selecionar o campo desejado com um duplo clique, esse campo aparecerá
em Selected Fileds, adicionar todos os campos desejados para a chave, em seguida
clicar no botão Add, em Type, selecionar o tipo de chave desejada.
A aba IO-Handle, define os parágrafos lógicos relacionados ao arquivo. Selecionar a
opção Use User Definied IO Paragraphs, para criar os parágrafos que serão criados,
para criar o parágrafo, selecionar a seção desejada, dar um duplo clique na área branca,
clicar no botão (...), aparecerá janela com um nome de parágrafo, se desejar, alterar,
clicar no botão Ok, o editor será visualizado, apenas inserir a rotina.
A Aba XFD, define os parâmetros utilizados para o dicionário de dados. Informar o
nome do arquivo em File Directive.
Após montar o arquivo, clicar no botão Ok. Com o Workspace aberto, na aba Data,
clicar com o botão direito sobre o nome do arquivo e selecionar a opção Generate FD/SL.
Página 144
AcuBench
Apostila
Criando o Programa.
Com o Workspace aberto, selecionar a aba Structure
Clicar com o botão direito sobre o nome do projeto e selecionar a opção New
Program.
Abrirá janela com opções, selecionar a opção Blank, em Program Name informar o
nome do programa. Clicar no botão Ok.
No Workspace, ficará da seguinte forma:
Essas são as seções que o programa possui.
Página 145
AcuBench
Apostila
Criando o Data Set.
Com o programa aberto, clicar com o botão direito sobre a seção Data Set e
selecionar a opção New Data Set.
Abrirá janela com o Data Set criado e será visualizado também a janela de
propriedades (Propertie Window). Na propriedade Name, informar um nome para o Data
Set, na propriedade Data Layout, selecionar o nome do arquivo e em Key, selecionar a
chave.
Para informar a forma de abertura do arquivo no programa, clicar com o botão direito
sobre o Data Set e selecionar a opção Referenced FD/SL Files. Abrirá janela com
opções, em Mode selecionar a forma desejada.
Criando a Tela.
Com o programa aberto, clicar com o botão direito sobre a seção Screen e
selecionar a opção New Screen.
Página 146
AcuBench
Apostila
Abrirá janela com as opções de Window a serem criadas, selecionar a window
desejada, em Form Name, informar o nome da window e em Unique Prefix informar o
nome do prefixo para os controles que serão criados. Clicar no botão Ok.
Depois de selecionado o tipo de window, colocar os controles desejados. Para
adicionar os controles, existem 2 formas:
1º Selecionar o controle desejado através da janela Screen Conponent Toolbox (
MENU  VIEW  SCREEN COMPONENT TOOLBOX) e arrastar até a window na posição
desejada..
2º Selecinar o controle e já vincular a uma variável, através da opção Drag And
Drop (MENU  VIEW  DRAG AND DROP). Selecionar o arquivo desejado, depois selecionar
o tipo de controle, clicar na variável e arrastar até o local desejado da window.
Ao criar um controle na window, pode-se alterar as suas propriedades e criar
eventos, para isso selecionar a janela Property Window (MENU  VIEW  PROPERTY
WINDOW), abrindo a janela serão visualizadas 3 abas, Alphabetic, Categorized e Event.
A aba Alphabetic e Categorized, configura as propriedades do controle
selecionado, listando por ordem alfabética ou por categoria.
A aba Event, disponibiliza os evetos relacionados ao controle para a definição de
um parágrafo lógico.
Página 147
AcuBench
Apostila
Criando o Relatório.
Com o programa aberto, clicar com o botão direito sobre a seção Report e
selecionar a opção New Report.
Abrirá janela com as opções de relatórios a serem criados, selecionar o relatório
desejado, em Form Name, informar o nome do relatório e em Unique Prefix informar o
nome do prefixo para os controles que serão criados. Clicar no botão Ok.
Depois de selecionado o tipo de relatório, colocar os controles desejados. Para
adicionar os controles, existem 2 formas:
1º Selecionar o controle desejado através da janela Report Conponent Toolbox (
MENU  VIEW  REPORT COMPONENT TOOLBOX) e arrastar até o relatório na posição
desejada..
Página 148
AcuBench
Apostila
2º Selecinar o controle e já vincular a uma variável, através da opção Drag And
Drop (MENU  VIEW  DRAG AND DROP). Selecionar o arquivo desejado, depois selecionar
o tipo de controle, clicar na variável e arrastar até o local desejado do relatório.
Ao criar um controle no relatório, pode-se alterar as suas propriedades e criar
eventos, para isso selecionar a janela Property Window (MENU  VIEW  PROPERTY
WINDOW), abrindo a janela seão visualizadas 3 abas, Alphabetic, Categorized e Event.
A aba Alphabetic e Categorized, configura as propriedades do controle
selecionado, listando por ordem alfabética ou por categoria.
A aba Event, disponibiliza os evetos relacionados ao controle para a definição de
um parágrafo lógico.
Com o relatório aberto, pode-se definir as seções desejadas, para isso clique com o
botão direito sobre o relatório e selecione a opção Section Controller, será visualizado
janela com as seções, apenas incluir ou excluir as seções desejadas.
A rotina de leitura do arquivo deverá ser feita diretamente no Fonte do programa,
para isso, clicar com o botão direito sobre o nome do programa (no Workspace, aba
Structure) selecionar a opção Generate Source para gerar o fonte do programa, em
seguida clicar novamente com o botão direito sobre o nome do programa e selecionar a
opção View Programa.cbl
No fonte do programa, colocar a rotina no parágrafo Acu-Rpt-nomerel-MasterPrint-Loop.
Página 149
AcuBench
Apostila
Obs.: Não esquecer de colocar a rotina após a tag
Acubench, ao gerar o programa NÃO, apague o conteúdo do parágrafo.
para que o
Gerando, Compilado e Executando o programa.
Clicar com o botão direito sobre o nome do programa (Workspace, aba Strutucture)
e selecionar a opção desejada. Generate Source para gerar o programa, Compile
Programa.cbl para compilar um fonte já existente, Execute Programa.cbl para executar
o objeto gerado e Debug (Runtime) para exeutar o objeto com o depurador.
Página 150

AcuBench - Carlos Piergentile

Transcrição

Documentos relacionados

08 de janeiro de 2007 - Câmara de Vereadores

7º Ano

Tabela de preços atualizada em: 20/12/2013 TABELA DE PREÇOS

Cresant do hotel

6º ANO FUNDAMENTAL

Apresentação do PowerPoint

PLANO DE PATROCÍNIO INTEGRADO DE QUINTA

CIRCULAR NAGUISA N o 06/11

Sistema de Cores

Cronograma Mensal – Dezembro – 8º Ano Marcian Hoff