acubench - carlospiergentile.files.wordpress.com · criação e manutenção de aplicações cobol...

AcuBenchManual

Desenvolvendo com AcuBench

Manual Inicial

Centro de Serviços INTERON – CSI Apostila AcuBench

Índice

Capítulo I – Introdução ao Acubench............................................................................. 005

Capítulo II – Componentes............................................................................................. 006 – Workspace.................................................................................................. 007 – Projeto......................................................................................................... 007 – Propriedades / Configurações.................................................................... 007 – Layout de Arquivos..................................................................................... 007 – Programa.................................................................................................... 007 – Menu e Barra de Ferramentas do Acubench............................................. 007 – File........................................................................................................... 008 – Edit........................................................................................................... 009 – View......................................................................................................... 010 – Project...................................................................................................... 011 – Build......................................................................................................... 011 – Debug...................................................................................................... 012 – Align......................................................................................................... 013 – Format...................................................................................................... 014 – Tools........................................................................................................ 014

Capítulo III – Definição de Projeto.................................................................................. 016

Capítulo IV – Configuração do Projeto.......................................................................... 018 – Compiler.................................................................................................... 018 – Runtime..................................................................................................... 019 – Environment.............................................................................................. 020 – Library....................................................................................................... 021

Capítulo V – Workspace................................................................................................ 022 – Structure................................................................................................... 022 – Projeto.................................................................................................... 023 – Programa............................................................................................... 023 – File............................................................................................................ 024 – Data.......................................................................................................... 026

Capítulo VI – Layout de Arquivo (fd e sl)........................................................................ 028 – File Designer............................................................................................. 029 – File Control............................................................................................. 029 – Definition................................................................................................ 032 – Key......................................................................................................... 034 – IO Handling............................................................................................ 035

Página 1


– 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............................................................ 045 – Componente Toolbox.............................................................................. 048 – Property Window..................................................................................... 049 – Alphabetic (Propriedades)................................................................... 049 – Label................................................................................................. 049 – Push Button...................................................................................... 050 – Entry Field......................................................................................... 052 – Check Box......................................................................................... 054 – Radio Button..................................................................................... 056 – ScrollBar........................................................................................... 057 – Combo Box....................................................................................... 058 – Bitmap............................................................................................... 060 – Bar.................................................................................................... 061 – Frame................................................................................................ 062 – List Box............................................................................................. 064 – Menu................................................................................................. 067 – Toolbar.............................................................................................. 067 – Tab.................................................................................................... 067 – Grid................................................................................................... 069 – Treeview........................................................................................... 075 – Web Browser.................................................................................... 078 – Status Bar......................................................................................... 079 – Date Entry......................................................................................... 080 – Window............................................................................................. 081 – Event (Eventos)................................................................................... 083 – Label................................................................................................. 083 – Push Button...................................................................................... 084 – Entry Field......................................................................................... 084 – Check Box......................................................................................... 085 – Radio Button..................................................................................... 086 – ScrollBar........................................................................................... 087 – Combo Box....................................................................................... 087 – Bitmap............................................................................................... 088 – Bar.................................................................................................... 088 – Frame................................................................................................ 089 – List Box............................................................................................. 089

Página 2


– Menu................................................................................................. 091 – Toolbar.............................................................................................. 091 – Tab.................................................................................................... 091 – Grid................................................................................................... 092 – Treeview........................................................................................... 094 – Web Browser.................................................................................... 094 – Status Bar......................................................................................... 095 – Date Entry......................................................................................... 095 – Window............................................................................................. 096 – Drag And Drop........................................................................................ 097 – Bitmap............................................................................................... 098 – Check Box......................................................................................... 098 – Combo Box....................................................................................... 098 – Date Entry......................................................................................... 100 – Entry Field......................................................................................... 100 – Grid................................................................................................... 101 – Label................................................................................................. 103 – List Box............................................................................................. 104 – Paged Grid........................................................................................ 106 – Paged List Box.................................................................................. 109 – Radio Button..................................................................................... 114 – Web Browser.................................................................................... 114

Capítulo X – Definição do Report – Programa............................................................. 115 – Section Controller…................................................................................ 116 – Header & Footer.................................................................................. 117 – Detail Section…................................................................................... 117 – Group Section….................................................................................. 117 – Report Componente Toolbox.................................................................. 118 – Property Window..................................................................................... 119 – Alphabetic (Propriedades)................................................................... 119 – Report Label..................................................................................... 119 – Report Entry Field............................................................................. 120 – Report Line………............................................................................. 121 – Report Radio Button......................................................................... 121 – Report Check Box............................................................................. 121 – Report Box………............................................................................. 122 – Report Image.................................................................................... 122 – Report Grid....................................................................................... 123 – Report Occurs…............................................................................... 124 – Report Date Time.............................................................................. 125 – Report Table..................................................................................... 126

Página 3


– Report............................................................................................... 126 – Report Header.................................................................................. 127 – Page Header..................................................................................... 127 – Group Header................................................................................... 128 – Detail................................................................................................. 128 – Group Footer..................................................................................... 128 – Page Footer…................................................................................... 128 – Report Footer.................................................................................... 128 – Event (Eventos)................................................................................... 129 – Drag And Drop........................................................................................ 129 – Principais Parágrafos do Relatório......................................................... 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.............................................................................. 138 – Property Window..................................................................................... 138 – Alphabetic (Propriedades)................................................................... 138 – Event (Eventos)................................................................................... 138 – Principais Parágrafos do Data Set....................................................... 139

Capítulo XV – Geração, Compilação e Execução ........................................................ 140 – Gerar o Programa.................................................................................. 140 – Compilar o Programa............................................................................. 140 – Executar o Programa............................................................................. 141 – Correção de Erros de Compilação......................................................... 142 – IO-Handling......................................................................................... 142 – Eventos............................................................................................... 142 – Relatório.............................................................................................. 142

Capítulo XVI – Passo a Passo no Acubench......... ........................................................ 143 – Criando o Projeto................................................................................... 143 – Criando e Importando a FD/SL.............................................................. 143 – Criando o Programa............................................................................... 145 – Criando o Data Set................................................................................ 145 – Criando a Tela....................................................................................... 146 – Criando o Relatório................................................................................ 147 – Gerando, Compilando e Executando o Programa................................. 149

Página 4


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


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


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 PROJETOProjeto é 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ÇÕESO Acubench permite relacionar configurações e templates para o projeto, ou para

programas individualmente.

o LAYOUT DE ARQUIVOSConsiste 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 PROGRAMAA 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


o MENU E BARRA DE FERRAMENTAS DO ACUBENCH

File: Contém os atributos para o Workspace e o Projeto.

Item Descrição Atalho

New Cria o projeto, o programa, a screen, o report, o documento, a fd e sl. Ctrl+N

Open Abre documento existente. Ctrl+OClose Fecha o documento aberto. Ctrl+QOpen Workspace Abre um Workspace.Save Workspace Salva o Workspace.Close Workspace Finaliza o Workspace.

Open Project Abre um projeto existente no Workspace corrente (*.psf).

Save Project Salva o projeto (*.pjf).Save Salva o documento aberto. Ctrl+S

Save As Salva o documento corrente com outro nome ou local diferente.

Save All Salva Workspace, Projeto e todos documentos abertos.

Page Setup Configura pagina (cabeçalho, rodapé, cores, etc). Ctrl+MPrint Setup Configura a impressora a ser impresso o documento Ctrl+KPrint Preview Preview da impressão.Print Imprime documento aberto.Recent Workspaces Lista os últimos projetos abertos.Exit Finaliza o AcuBench. Ctrl+E

Edit: Contêm atributos do editor e do screen design.Página 8


Item Descrição AtalhoUndo Desfaz a última ação. Ctrl+ZRedo Refaz a última ação. Ctrl+YCut Recorta controle ou string. Ctrl+XCopy Copia controle ou string. Ctrl+CPaste Cola controle ou string. Ctrl+VDelete Elimina o controle ou a string. DEL

Select All Seleciona todo documento ou todos controles do formulário. Ctrl+A

Find Localiza uma string. Ctrl+FFind Next Localiza a próxima string no documento. F3Find in Files Localiza string em arquivos específicos.Find in Objects Localiza string nos controles do Workspace.Replace Substitui string no documento corrente. Ctrl+HReplace in Files Substitui string em arquivos específicos.

Go To

Posiciona o cursor no documento. Begin No inicio da linha.End No fim da linha.Line Na linha optada.Previous Error No erro acima da linha.Next Error No erro abaixo da linha.

BookMark

Insere um marcador no documento.Toggle Bookmark Insere o marcador.

Next Bookmark Posiciona o cursor no marcador abaixo.

Previous Bookmark Posiciona o cursor no marcador acima.

Clear All Bookmarks Apaga todos os marcadores.

Advanced

List Paragraphs Lista todos os parágrafos List Variables Lista todas as variáveis.

List Constants Lista as variáveis de nível 78.

List Copy Files Lista o nome dos copy´s contido no programa.

Code Template Insere código template no documento. Ctrl+J

Open Copy File Abre o copy selecionado.

Insert File Adiciona o conteúdo de um arquivo.

Find Scope Seleciona um bloco.

Verb Block Match Posiciona no final de 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



Toolbars

Standard Visualiza a barra.Project Visualiza a barra.Editor Visualiza a barra.Debug Visualiza a barra.Align Visualiza a barra.

Launch Bar Inclui um link de um aplicativo externo.

Customize Personaliza as barras.Status Bar Visualização da barra de status do Acubench.

Workspace Visualiza janela de propriedades do Workspace.

Output Window Visualiza janela responsável pelo status de busca, compilação, etc.

Property Window Visualiza janela de propriedades do controle e do data set.

Screen Component Toolbox Visualiza janela dos controles da screen design.

Report Component Toolbox Visualiza janela dos controles do report design.

Drag and Drop Visualiza janela de associação entre variável e controle.

Debug Window

Watch Visualiza monitoramento de variáveis.

Call StackVisualiza o nome do arquivo que se encontra cada parágrafo.

Memory Visualiza a quantidade de memória utilizada.

ThreadsMostra todas as threads e permite manipulação de execução das mesmas.

Full Path Filename Visualiza o path dos arquivos relacionados ao projeto.

Rule Bar Visualiza a régua no editor.

Line Number Pane Visualiza no lado esquerdo do editor o número da linha.

Bookmak Pane Disponibiliza área no editor para inserir o marcador de página.

Project: Contêm os atributos do projeto. Este tópico será detalhado no capitulo III.

Página 10


Item Descrição AtalhoAdd/Remove Files Insere arquivos externos no projeto corrente.

New Folder Cria uma nova pasta para ser utilizada pelo projeto.

Settings Configura as opções do compilador, runtime e variáveis de ambiente para o projeto.

Set Active Mode Habilita conjunto de configurações do compilador e do runtime para o projeto.

Properties Visualiza o nome, diretórios do projeto e indica o servidor utilizado com a tecnologia Thin Client.

Create AliasConfigura o servidor que contem o runtime e os programas para serem executados remotamente (Thin Client).

Build: Contêm os atributos para os programas.


Generate Gera o código fonte do componente estrutural selecionado (programa, data layout, etc...).

Regenerate Workspace Gera o código fonte para todos os componentes do Workspace.

Compile Compila o programa selecionado (ccbl32 / ccbl) Ctrl+F7

Build Workspace

Gera os fontes dos programas que foram alterados (indicados pelo símbolo *) e compila todos os programas de todos os projetos pertencentes ao Workspace.

F7

Rebuild Workspace Compila todos os programas de todos os projetos contidos no Workspace (ccbl32 / ccbl).

Reparse Identifica os copy´s contidos no fonte selecionado.

Reparse AllIdentifica os copy´s contidos nos fontes de todos os programas dos projetos pertencentes ao Workspace.

Execute Executa o programa selecionado (wrun32 / runcbl). Ctrl+F5

Debug (Runtime) Executa o programa selecionado com o debug.

Allow Parameters Executa o programa selecionado com outros parâmetros de execução.

Use Thin Client 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



Trace Option

Trace File Cria log de seqüência do arquivo.

Trace Paragraphs Cria log de seqüência de parágrafos.

Trace Screens Cria log de seqüência de sintaxes de screen.

Trace Flush Apaga o conteúdo do log após a operação de Write.

Trace General Cria log de todas as seqüências descritas acima.

Trace Levels Nível de detalhamento do log.

Trace to Debug Window

Cria log de todas as seqüências, menos de nível.

Go Inicia a execução do programa. F8

Restart Finaliza a seção do debug corrente e inicia uma nova seção.

Exit Debbuger Finaliza a seção do debug corrente e continua com o debug aberto. F12

Quit Debbuging Finaliza a seção e o debug.

Interrupt Finaliza a execução do programa e retorna para o debug.

Step Into Executa o debug na seqüência lógica (passo a passo) F11Step Over Executa o debug na seqüência lógica dos parágrafos. F10

Step Out Paragraph Executa o programa na sessão do debug durante a execução de um parágrafo.

Step Out Program Executa o programa na sessão do debug durante a execução da sintaxe “call”.

Auto Step Executa automaticamente o programa passo a passo.

Skip To Line Executa o programa e retorna ao debug na linha solicitada.

Run To Cursor Executa o programa e retorna ao debug na posição do cursor.

Record Script Salva as configurações feitas no debug.

Run Script Executa o debug com as configurações salvas anteriormente.

Breakpoints Marca o parágrafo onde o cursor deverá retornar durante o debug.

Threads Visualiza os threads em execução.Quick Watch Visualiza monitoramento de variáveis.

Align: Contém os parâmetros para o alinhamento dos controles no Screen Design.

Página 12



Align Control

Center Horizontal Centraliza o controle na horizontal com relação à tela.

Center Vertical Centraliza o controle na vertical com relação à tela.

Left

Ajusta os controles a esquerda a partir do que possuir a borda de seleção azul.

Alt+Left

RightAjusta os controles a direita a partir do que possuir a borda de seleção azul.

Alt+Reght

TopAjusta os controles pelo topo a partir do que possuir a borda de seleção azul.

Alt+Up

Bottom

Ajusta os controles pelo rodapé a partir do que possuir a borda de seleção azul.

Alt+Down

To GridPosiciona o controle a partir de um ponto de posicionamento.

Space Evenly

AcrossAjusta espaço vertical a partir do que possuir a borda de seleção azul.

DownAjusta espaço horizontal a partir do que possuir a borda de seleção azul.

Adjacent Horizontal Une os controles na horizontal.

Vertical Une os controles na vertical.

Make Same Size

WidthDefine a largura a partir do que possuir a borda de seleção azul.

HeigthDefine a altura a partir do que possuir a borda de seleção azul.

BothDefine a altura e largura a partir do que possuir a borda de seleção azul.

Size to Content Ajusta o tamanho do controle de acordo com o tamanho do título. (Label, check, radio, etc...). Shift+F7

Lock Controls Impede a movimentação do controle. Ctrl+LTab Order Define a seqüência de accept dos campos. Ctrl+DView Grid Visualiza pontos de posicionamento no formulário. Ctrl+GToggle Guide Habilita a régua.

Format: Contêm parâmetros para o editor.

Página 13



Capitalize Altera a primeira letra da palavra selecionada para maiúscula. Ctrl+G

Uppercase Altera a palavra selecionada para maiúscula. Ctrl+Shift+U

Lowercase Altera a palavra selecionada para minúscula. Ctrl+U

Comment Block Comenta o bloco selecionado acrescentando “*”.

Uncomment Block Descomenta o bloco selecionado retirando “*”.

Sequence Number Reorganiza o documento a partir das linhas informadas.

Indent To Next Altera o recuo da linha de acordo com a próxima linha .

Indent To Previous Altera o recuo da linha de acordo com a linha anterior.

ANSI To Terminal Font Altera o formato do documente de Ansi para Terminal.

Tools : Contêm os utilitários Acucobol e configurações gerais para o Acubench.

Item Descrição

Cblutl Exibe graficamente o utilitário Acucobol cblutl32 responsável pela união de objetos e bibliotecas em um único objeto.

Vio Backup do projeto (.vio)

Logutl Exibe graficamente o utilitário Acucobol logutl, visualizador de log de transação de arquivos vision.

Vision File Utility Exibe graficamente o utilitário Acucobol vutil, manipulador de arquivos indexados vision.

Alfred Executa o aplicativo Alfred, sua funcionalidade é interpretação dos arquivos XFD e visualização dos registros.

Axdefgen ActiveX Definitions Generator, utilitário para criação das bibliotecas de componentes ActiveX.

Netdefgen .Net Definitions Generator, utilitário para manipulação de componentes .Net

Acu4glFD Utilitário Acucobol Acu4glfd para criar fd e sl de uma tabela lida através do ODBC.

Xml2FD Utilitário Acucobol que cria fd e sl no formato binary sequential baseado num documento xml.

Customize Personaliza a barra de ferramentas.Options Configurações Gerais do Acubench

EnvironmentGeneral 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


Debug Parâmetros default para o debug do Workspace.Keyboard Configuração de teclas de atalho.Prefix Prefixo default para a criação de variáveis.Miscellaneous Configuração geral do projeto.

Code EditorGeneral 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 DesignGeneral Define o espaço entre os pontos de posicionamento no formulárioDefault Define valor padrão para as propriedades de cada controle.Visibility Define as propriedades a serem visualizadas no formulário.

Code GeneratorGenerate Documment Arquivos a serem gerados para os programas.Program Tag Seções e copy’s a serem gerados com os programas.

Data DesignGeneral Definição de comentários e cores para os níveis da fd e WorkingGraphical 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 WriterGeneral 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


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


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 ProjetoPágina 17


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


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


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 Indica o runtime utilizado pelo projeto (wrun32/runcbl)COMPILERNAME Indica o compilador utilizado pelo projeto (ccbl32/ccbl)CODE_PREFIX Indica os diretórios onde se encontram os programas acucobol (call)ACUPATH Indica o diretório de instalação dos produtos acucobolCOPY_PATH Indica os diretórios onde se encontram os copy´s dos programas.THINNAME Indica o utilitário utilizado para a tecnologia Thin Client

Página 20


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


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.

Aloja as informações estruturais do projeto e programas 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 DescriçãoSave Workspace Salva as alterações realizadas no Workspace.Close Workspace Fecha o Workspace corrente.Open Project Abre o projeto (*.pjt) no Workspace corrente.

Set Active Mode Habilita um conjunto de configurações do compilador e runtime definidas para o projeto (Settings).

Build WorkspaceGera os fontes dos programas que foram alterados (indicados pelo símbolo *) e compila todos os programas de todos os projetos pertencente ao Workspace.

Rebuild Workspace Compila todos os programas de todos os projetos pertencentes ao Workspace.

Reparse All Identifica os copy´s contidos nos fontes dos programas dos projetos pertencentes ao Workspace.

Find in Objects Localiza uma palavra nos objetos de todos os projetos pertencentes ao Workspace.

Allow DockingAltera a janela do Workspace para floating, permitindo o deslocamento da mesma sem fixar a posição nas laterais da ferramenta Acubench.

Hide Oculta a janela do Workspace.

Página 22


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 DescriçãoNew Program Define um novo programa ao projeto.Add Program Adiciona um programa existente ao projeto. (.psf)Delete Exclui o projeto do Workspace.

Settings Aciona as configurações do compilador, runtime e variáveis de ambiente para o projeto selecionado.

Save Project Salva alterações feitas no projeto. (.pjt)

Build Gera os fontes dos programas que foram alterados (indicados pelo símbolo *) e compila todos os programas do projeto.

Rebuild Compila todos os programas do projeto.Find in Objects Localiza uma palavra nos objetos dos programas do projeto.

Properties Visualiza o nome do projeto, diretórios e indica o servidor utilizado para a tecnologia Thin Client.

Vio Backup do Projeto. (.vio)

Programa: Exibe as seguintes seções de um programa na forma estruturada.

Item Descrição

ScreenHabilita área para o desenvolvimento de delas gráficas e caracter, permitindo a utilização de templates. Arquivos relacionados à seção (*.stf, *.out, *.scr).

ReportHabilita área para o desenvolvimento de relatórios gráficos e caracter, permitindo a utilização de templates. Arquivos relacionados à seção (*.rpt)

Working Habilita área para definição de variáveis e bibliotecas utilizadas no programa. Arquivos relacionados à seção (*.wrk).

Linkage Habilita área para definição de variáveis e bibliotecas de linkage utilizadas no programa. Arquivos relacionados à seção (.lnk).

Event ParagraphAciona o editor para definição de parágrafos lógicos relacionados ao programa e seus controles. Arquivos relacionados à seção (.evt).

Data Set 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


Item DescriçãoView Visualiza o fonte principal do programa (*.cbl).Generate Source Gera fonte Cobol.

New Screen Cria screen (caracter ou gráfica) para o programa utilizando templates (*.stf).

Add Screen Adiciona screen já existente (*.out, *.stf) ao programa.

New Report Cria relatório (caracter ou gráfico) para o programa utilizando templates (*.wif).

Add Report Adiciona relatório existente (*.wif) ao programa.

New Data Set Define os arquivos de dados, definidos no projeto, e a forma 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.

Execute Executa o programa uma vez que o mesmo não contenha erros (wrun32/runcbl).

Debug (Runtime) Depura o programa.Find in Objects Localiza uma palavra nos objetos do programa.

Properties Habilita configuração para definir tela inicial, variáveis de 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


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; *.cobScreen *.scr; *.stfReport *.rpt; *.rtfCopylib *.cpy; *.wrk; *.lnk; *.lks; *.mnu; *.prd; *.evt; *.def.Object *.acu; *.cbx; *.obj; *.libList *.lst; *.log; *.arqResource *.ico; *.bmp; *.jpg; *.jpe; *.jpegFD *.fd;*.sd;*.slRemote *.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 DescriçãoAdd/Remove Files Adiciona fontes externos ao projeto.New Folder Cria uma nova pasta para o projeto.Delete Exclui o projeto do Workspace.

Settings Aciona as configurações do compilador, runtime e variáveis de ambiente para o projeto.

Save Project Salva alterações feitas no projeto (.pjt).

Build Gera os fontes dos programas que foram alterados (indicados pelo símbolo *) e compila todos os programas do projeto.

Rebuild Compila todos os programas do projeto.Find in Objects Localiza uma palavra nos objetos dos programas do projeto.

Properties Visualiza o nome do projeto, diretório e indica o servidor utilizado para a tecnologia Thin Client.

Vio Backup do Projeto. (.vio)

Através do clique do botão direito do mouse sobre uma das pastas será obtido as seguintes propriedades:

Item DescriçãoNew File Cria um novo arquivo na pasta selecionada.Add/Remove Files Adiciona ou remove arquivos na pasta selecionada.

Empty Limpa o conteúdo da pasta, excluindo fisicamente os arquivos existentes na mesma.

Find in Objects Localiza uma palavra nos objetos do projeto.

Properties Habilita as propriedades da pasta selecionada, informando os tipos de arquivos suportados e localização.

Página 25


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 DescriçãoNew FD/SL Cria layout de dados FD e SL (*.dlt).Add FD/SL Adiciona layout de arquivo existente ao projeto (*.dlt).

XML2FD Aciona o utilitário Acucobol XML2FD para criar fd/sl no formato binary sequential baseado num documento XML.

Associate FD/SL Files Estabelece relacionamento entre arquivos.Refresh All Atualiza o conteúdo dos arquivos *.fd e *.sl com os *.dlt.Delete Exclui o projeto do Workspace corrente.

Settings Configura diretivas de compilação, execução e variáveis de ambiente.

Save Project Salva alterações feitas no projeto. (.pjt)

Build Gera os fontes dos layout´s que foram alterados (indicados pelo símbolo *).

Rebuild Gera todos os layout´s do projeto.Find in Objects Localiza uma palavra nos objetos dos programas..

Properties Visualiza o nome e diretório do projeto e indica o servidor utilizado para a tecnologia Thin Client.

Página 26


Vio Backup do Projeto. (.vio)Através do clique do botão direito do mouse sobre o ícone do data layout será obtido

as seguintes informações:

Item DescriçãoView arquivo .fd Visualiza o fonte gerado do arquivo .fd.View arquivo .sl Visualiza o fonte gerado do arquivo .sl.Open Abre a estrutura gráfica do layout do arquivo (*.dlt)Event Editor Abre o Editor para inserção de rotinas lógicas.Generate FD/SL Gera o fonte para fd e sl.

Make XFD FileCria um programa contendo o copy da fd e sl, para que o 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.

PropertiesInforma o nome dos arquivos fd e sl, o diretório e o nome do arquivo Vision. Esta propriedade permite alterar o nome do arquivo fd/sl e o prefixo utilizado nos campos da fd.

Página 27


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


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


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


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


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


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


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


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


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


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.

No menu principal, selecionar FILE NEW, abrirá janela com opções, selecionar a 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


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


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


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


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


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


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


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


2 – Trabalha em conjunto com a variável CONTROL-VALUE , onde o foco retornará 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.

3 – Trabalha em conjunto com a variável CONTROL-VALUE , onde o foco retornará para o valor informado nessa variável, quando ocorrer uma exceção na tela (EXCEPTION-

KEY). 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


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


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


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


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 Descrição(Name) Nome do Controle

Ccol Ajusta a coluna onde o controle se inicia, em relação à tela. (Somente caracter).

Cline Ajusta a linha onde o controle se inicia, em relação à tela. (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.

Column in Pixels Ajusta a coluna onde o controle se inicia, em relação à tela, em pixel.

Csize Ajusta a largura do controle. (Somente caracter).

Destroy Type

Automatic Na finalização da tela o controle será destruído.

Permanent O controle será destruído apenas com o verbo destroy e não assume modify.

Temporary O controle se auto destrói se for adicionado um novo na mesma posição da tela.

Font Informa a fonte do controle.Format Picture Informa a pic do controle, ou a mascara.

Help ID Trabalha em conjunto com a variável de ambiente HELP-PROGRAM, informa o valor do ID criado no help do controle.

ID Identificação do controle.

Justification

Center Centraliza o título do label.Left Alinha o título do label à esquerda.Right Alinha o título do label à direita.Unaligned Não ajusta o título do label.

Página 49


Key Chave de ativação do controle. Para controles nativos não tem necessidade da criação do mesmo.

Label Offset Não utilizado com pixels, ajusta a altura do label em relação ao Entry Field.

Layout Data Ajusta o controle, conforme o resize da tela, podendo apenas mover o controle ou então alterar o seu tamanho.

Line Ajusta a linha onde o controle se inicia, em relação à tela.Lines in Pixels Ajusta a altura do controle em pixels.

No Key Letter Não ativa o “&” para se tornar uma chave, e sim visualiza o caracter.

Size Ajusta a largura do controle.Size in Pixels Ajusta a largura do controle em pixels.Tab Order Posição de accept do controle com relação à tela.Title Texto que será apresentado no controle.Transparent Não mostra o fundo do label.Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).

Propriedade Descrição(Name) Nome do ControleBitmap Adiciona uma imagem ao controle. (aceita BMP ou JPEG).Bitmap Frame Cria uma borda em volta do botão se tiver imagem.Bitmap Handle Define uma variável HANDLE para a imagem.

Bitmap Number Utilizada somente para uma tira de imagens num único arquivo, informa o número da imagem desejada.

Bitmap Square Utilizado somente quando possui imagem, deixa os cantos do botão quadrado.



Clines Ajusta a altura do controle. (Somente caracter).Column Ajusta a coluna onde o controle se inicia, em relação à tela.


Copy Resource Se configurado para verdadeiro, ao gerar o programa o Acucobol adicionará a imagem ao objeto do programa.


Destroy Type




Enable Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).Exception Value Determina a tecla de exceção para o controle.Flat Não apresenta o contorno do botão se tiver imagem.

Página 50



Help ID Trabalha em conjunto com a variável de ambiente HELP-PROGRAM, informa o valor do ID criado no help do controle.




Line Ajusta a linha onde o controle se inicia, em relação à tela.

Line in Pixels Ajusta a linha onde o controle se inicia, em relação à tela em pixels.

Lines Ajusta a altura do controle.Lines in Pixels Ajusta a altura do controle, em pixels.

Multiline Se o título estiver maior que o botão, é adicionada linha para o título.

No Auto Default O botão não será acionado através do “Enter”.No Tab Não passa pelo foco do controle através da tecla “TAB”.

Pop-Up Menu Determina que o controle menu será acionado através do clique com o botão direito do mouse.

Self Act Ativa o valor setado no Exception Value ou Termination Value.Size Ajusta a largura do controle.Size in Pixels Ajusta a largura, em pixels.

Style

Cancel Button

Cria o efeito de cancelar, é o mesmo que utilizar TITLE “Cancel” ESCAPE-BUTTON EXCEPTION-VALUE = 27OBS.: Pode ser alterado o valor de Title e Exception, fornecido pela ferramenta.

Default Button

Cria o efeito do “Enter”, é o mesmo que utilizar EXCEPTION-VALUE = 13.

Escape Button

Define o efeito de ESC, é o mesmo que utilizar EXCEPTION-VALUE = 27.

Ok Button

Cria o efeito de “Enter” é o mesmo que TITLE "OK" DEFAULT-BUTTON TERMINATION-VALUE = 13 OBS.: Pode ser alterado o valor de Title e Exception, forneceido pela ferramenta.

OtherNão cria nenhum estilo para o controle, 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 Texto que será apresentado no controle.Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).

Aditional PropertiesUnframed Não cria uma borda em volta do botão se tiver imagem.

Página 51


Propriedade Descrição(Name) Nome do Controle

Auto O Foco pula para o próximo controle sem pressionar o “Enter” ou “Tab”.

Auto Decimal Informa a quantidade de casas decimais para o campo.

Border3D Borda do controle com efeito 3D.Boxed Borda do controle como efeito 2D. (apenas modify).No Box Não coloca nenhuma borda no controle.

Case

Lower Todos os caracteres serão visualizados em minúsculo.

Mixed Será aceito caracteres MAIÚSCULOS e MINÚSCULOS.

Upper Todos os caracteres serão visualizados em maiúsculo.



Clines Ajusta a altura do controle. (Somente caracter).Color Informa a cor do controle, background e foreground.Column Ajusta a coluna onde o controle se inicia, em relação à tela.



Cursor Utilizado em conjunto com a propriedade NO-AUTOSEL, ele reposiciona o cursor no caracter desejado.

Cursor ColPara campos multiline ele posiciona o cursor na coluna desejada costuma ser utilizado em conjunto com a propriedade CURSOR-ROW.

Cursor RowPara campos multiline ele posiciona o cursor na linha desejada costuma ser utilizado em conjunto com a propriedade CURSOR-COL.

Destroy Type




Enable Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).Font Informa a fonte do controle.Format Picture Informa a pic do controle, ou a mascara.

Help ID Trabalha em conjunto com a variável de ambiente HELP-PROGRAM Informa o valor do ID criado no help do controle.


Página 52


Justification

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.




Line in Pixels Ajusta a linha onde o controle se inicia, em relação à tela em pixel.

Lines Ajusta a altura do controle.Lines in Pixels Ajusta a altura do controle em pixel.

Max Lines Utilizado em conjunto com a propriedade MULTLINE, delimita a quantidade de linhas que o controle terá.

Max Text Determina a quantidade máxima de caracteres a ser digitado.

Max ValueMáximo valor numérico que pode ser digitado no campo. Costuma ser utilizado em conjunto com a propriedade AUTO-SPIN.

Min ValueMínimo valor numérico que pode ser digitado no campo. Costuma ser utilizado em conjunto com a propriedade AUTO-SPIN.

No AutoSel No accept do campo não será selecionado o conteúdo digitado.No Tab Não passa pelo foco do controle através da tecla “TAB”.

Notify ChangeGera o evento NTF-SELCHANGE. Permitindo assim, quando houver alguma alteração na digitação do controle, executar o evento.

Numeric Aceitará somente valor numérico.


Read Only Não haverá accept no campo, porém passa pelo foco do controle.

Required Obriga a digitação no campo.Secure No lugar do caracter digitado será visualizado “*”.Size Ajusta a largura do controle.Size in Pixels Ajusta a largura do controle em pixel.

Página 53


Style

Singleline Todo o conteúdo digitado no entry field ficará numa única linha.

Multiline Permite a entrada de dados em mais de uma linha.

Vscroll Em campos multiline, é executada a quebra de linha.

Vscroll Bar Em campos multiline, cria uma barra de rolagem na vertical.

SpinnerMesmo efeito do AUTO-SPIN, porém usa as teclas de setas no entry field. Quando pressiona a seta, é recebido o evento MSG-SPIN-UP e MSG-SPIN-DOWN.

Auto-Spin

Utilizado em conjunto com as propriedades MIN-VALUE e MAX-VALUE, clicando no scrool são mostrados todos os valores que estão entre essas propriedades.

Tab Order Seqüência de accept do controle com relação à tela.Use Return Finaliza a entrada de dados através do “Enter”.Use Tab Finaliza a entrada de dados através do “Tab”.Value Informa o conteúdo do controle.Value Multiple Inicia o entry field multiline já com um conteúdo.Value Picture Informa a PIC da variável do entry field

Value Variable Informa uma variável para o entry field, podendo ser do arquivo, working, linkage...

Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).Aditional Properties

Action

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.

Selection-Text

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.

Propriedade Descrição(Name) Nome do Controle.

BitmapAdiciona 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.

Bitmap Frame Cria uma borda em volta do check se tiver imagem.Bitmap Handle Define uma variável HANDLE para a imagem.

Página 54










Destroy Type




Enable Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).Exception Value Determina a tecla de exceção para o controle.Flat Não apresenta o contorno do check box se tiver imagem. Font Informa a fonte do controle.Framed Cria uma borda em volta do check box se tiver imagem.





Left Text O título ficara à esquerda da caixa de seleção.Line Ajusta a linha onde o controle se inicia, em relação à tela.


Lines Ajusta a altura do controle.Lines in Pixels Ajusta a altura do controle, em pixel.

Multiline Se o título estiver maior que o check, é adicionada linha para o título.

No Tab Não passa pelo foco do controle através da tecla “TAB”.

Notify Gera o evento CMD-CLICKED sempre que for selecionada a caixa de seleção, gerando uma resposta imediata da ação.


Self Act Ativa o valor setado no Exception Value ou Termination Value.Size Ajusta a largura do controle.

Página 55


Size in Pixels Ajusta a largura, em pixels.Tab Order Seqüência de accept do controle com relação à tela.Termination Value Determina uma tecla de terminação para controle.Title Texto que será apresentado no controle.

Value Recebe dois valores 1 quando selecionado e 0 quando não selecionado.

Value Variable Variável do arquivo, working ou linkage a ser vinculada ao controle.

Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).Vtop O título será alinhado verticalmente no alto do controle.

Aditional PropertiesUnframed Não cria uma borda em volta do check se tiver imagem.


BitmapAdiciona 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.

Bitmap Frame Cria uma borda em volta do radio se tiver imagem.Bitmap Handle Define uma variável HANDLE para a imagem.









Destroy Type




Enable Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).Exception Value Determina a tecla de exceção para o controle.Flat Não apresenta o contorno do radio se tiver imagem. Font Informa a fonte do controle.

Página 56


Group Valor que informa em qual grupo o radio da tela pertence.Group Value Valor recebido para cada radio de um mesmo grupo.





Left Text O título ficara à esquerda da caixa de seleção.Line Ajusta a linha onde o controle se inicia, em relação à tela.



Multiline Se o título estiver maior que o radio, é adicionada linha para o título.

No Group Tab Não passa pelo foco dos radios do mesmo grupo através da tecla “TAB”


Notify Gera o evento CMD-CLICKED sempre que for selecionada a caixa de seleção, gerando uma resposta imediata da ação.


Self Act Ativa o valor setado no Exception Value ou Termination Value.Size Ajusta a largura do controle.Size in Pixels Ajusta a largura, em pixels.Tab Order Seqüência de accept do controle com relação à tela.Termination Value Determina uma tecla de terminação para controle.Title Texto que será apresentado no controle.

Value Recebe o valor do radio selecionado, o informado no Group-Value.

Value Variable Variável do arquivo, working ou linkage a ser vinculada ao controle.

Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).Vtop O título será alinhado verticalmente no alto do controle.

Aditional PropertiesUnframed Não cria uma borda em volta do radio se tiver imagem.




Página 57


Clines Ajusta a altura do controle. (Somente caracter).Column Ajusta a coluna onde o controle se inicia, em relação à tela.



Destroy Type




Enable Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).



Kind Horizontal Informa que a barra de rolagem será na horizontal.Vertical Informa que a barra de rolagem será na vertical.





Max Value Ajusta o valor o máximo na escala de valores legais da barra de rolagem (máximo 65536). O valor default é "100".

Min Value Ajusta o valor o minimo na escala de valores legais da barra de rolagem. O valor default é "0".


Page Size Ajustado para valores indefinidos, descreve o número de dados que aparecem em um "page".


Size Ajusta a largura do controle.Size in Pixels Ajusta a largura, em pixels.Tab Order Seqüência de accept do controle com relação à tela.

Track ThumbGera 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.

Value Recebe o valor do scrool.Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).

Propriedade Descrição

(Name) Nome do ControleAuto Load Monta a leitura do arquivo para carregar os dados no controle.

Página 58


Border3D Borda do controle com efeito 3D.Boxed Borda do controle como efeito 2D. No Box Não coloca nenhuma borda no controle.

Case









Destroy Type




Enable Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).Exception Value Determina a tecla de exceção para o controle.Font Informa a fonte do controle.Format Picture Informa a pic do controle, ou a mascara.


ID Identificação do controle.Item to Add Adiciona um item no controle.






Mass Update

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.

Max Text Determina a quantidade máxima de caracteres a ser digitado.No Tab Não passa pelo foco do controle através da tecla “TAB”.

Página 59


Notify DblClickGera 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 Gera o evento NTF-SELCHANGE. Permitindo assim, quando houver alguma seleção no controle, executar o evento.


Size Ajusta a largura do controle.Size in Pixels Ajusta a largura do controle em pixel.

Style

Drop Down A seleção do registro pode ser feita pelo mouse ou digitando.

Drop ListMesmo que o DROP-DOWN, porém se digitar uma letra, é visualizado o primeiro registro começado por tal.

Stact List O Combo ficará com o aspecto do list box, ou seja todo o conteúdo será visualizado.

Tab Order Seqüência de accept do controle com relação à tela.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.

Value Container Cria variável na working com nível 88 de todo o conteúdo do combo para o caso de ter sido adicionado valores fixos.

Value Default Toda vez que iniciar a tela o controle mostrará item selecionado como padrão.

Value Picture Informa a PIC da variável do controle.

Value Variable Informa uma variável para o controle, podendo ser do arquivo, working, linkage...


Insertion-IndexSe fixado para um valor positivo, o item a ser adicionado no 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.


(Name) Nome do Controle.Bitmap Adiciona uma imagem ao controle, (BMP ou JPEG).

Bitmap EndUtilizado somente para uma tira de imagens num único arquivo, informa o número da última imagem a ser visualizada.

Bitmap Handle Define uma variável HANDLE para a imagem.


Página 60


Bitmap StartUtilizado somente para uma tira de imagens num único arquivo, informa o número da primeira imagem a ser visualizada.

Bitmap TimerUtilizado em animação, informa o tempo (em centésimos de segundo) onde cada imagem aparecerá na tela durante a animação, quando ajustada para "0", não tem animação.

Column Ajusta a coluna onde o controle se inicia, em relação à tela.



Destroy Type










Lines in Pixels Ajusta a altura do controle, em pixel.Size in Pixels Ajusta a largura, em pixels.Tab Order Seqüência de accept do controle com relação à tela.Transparent Color Torna o fundo ou determinada área da imagem transparente.Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).


(Name) Nome do Controle.






Página 61


Destroy Type






Kind Horizontal Informa que a barra será na horizontal.Vertical Informa que a barra será na vertical.




Line Styles

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.

Position Shift

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.

Row´s Setting

Configuração das seguintes propriedades da barra.

Leading Shift

Ao término da linha criada, adiciona-se uma nova linha em pixels na horizontal e apaga a criada. Valores acima de zero a linha será criada a direita, e abaixo de zero será criada a esquerda.

Shading

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: 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.Size Ajusta a largura do controle.Size in Pixels Ajusta a largura, em pixels.Tab Order Seqüência de accept do controle com relação à tela.Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).Width Informa a espessura da barra, em pixels.

Página 62




3D Style

Engraved Faz com que o frame apareça mais baixo do que a superfície da tela.

Lowered Faz com que o interior do frame apareça mais baixo do que a superfície da tela.

Normal Aparece apenas uma linha

Raised Faz com que o interior do frame apareça levantado acima da superfície da tela.

Rimmed Faz com que o frame apareça acima da superfície da tela e o interior no nível da tela.

AlternateUtilizado em conjunto com a propriedade HEAVY ou VERY-HEAVY. Será criada uma barra mais escura no meio das linhas do frame.



Clines Ajusta a altura do controle. (Somente caracter).Color Ajusta a cor do frame e do título.Column Ajusta a coluna onde o controle se inicia, em relação à tela.



Destroy Type




Fill Color

Configuração das seguintes propriedades de cor.Fill Color Preenche o interior do frame.

Fill Percent

Colore uma parte do frame. O valor da propriedade é em porcentagem do frame preenchido variando de 0 a 100. Essa propriedade é usada para criar uma barra de progresso (ou de status).

Fill Color 2

Utilizado somente se o valor de FILL-PERCENT for menor do que "100". A cor especificada por esta propriedade é aplicada à parte do frame que não foi preenchido pelo FILL-COLOR.


Full Height Utilizado em conjunto com a propriedade TITLE POSITION, faz com que o título fique para dentro do controle.

Página 63



High ColorPara 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.






Lines Ajusta a altura do controle.Lines in Pixels Ajusta a altura do controle em pixels.

Low Color Especifica o número da cor mais escura para obter o efeito 3D.

Size Ajusta a largura do controle.Size in Pixels Ajusta a largura, em pixels.Tab Order Seqüência de accept do controle com relação à tela.

Thickness

Default A borda do frame fica numa espessura padrão.

Heavy A borda do frame fica mais grossa do que o padrão.

Very Heavy A borda do frame fica mais grossa do que o padrão e que HEAVY.

Title Texto que será apresentado no controle.

Title Position

Posição onde será apresentado o título do controle. Aceita os seguintes valores:1 Acima à esquerda2 Acima centralizado3 Acima à direita4 Abaixo à esquerda5 Abaixo centralizado6 Abaixo à direita7 Centralizado verticalmente e horizontalmente.

Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).


(Name) Nome do ControleAuto Load Monta a leitura do arquivo para carregar os dados no controle.

Border3D Borda do controle com efeito 3D.Boxed Borda do controle como efeito 2D.No Box Não coloca nenhuma borda no controle.

Página 64


Case








Columns’ Setting

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.

Column Display Define a quantidade de caracteres que serão visualizados em cada coluna.

Justification

Especifica o alinhamento dos dados em cada coluna. Aceita os seguintes valores: Centered Alinhamento centralizado.Left Alinhamento à esquerda.Right Alinhamento à direita.Unaligned Não alinhado.

Separation Adiciona um espaço em branco no término de cada coluna.

Divider Adiciona uma linha divisória entre as colunas. O valor será em pixel.


Destroy Type




Enable Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).Exception Value Determina a tecla de exceção para o controle.Font Informa a fonte do controle.


ID Identificação do controle.Item to Add Adiciona um item no controle.Item Value Recebe o valor de um item dentro do list box.



Página 65





Mass Update

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.

No Search Desabilita a opção de busca no controle.No Tab Não passa pelo foco do controle através da tecla “TAB”.

Notify DblClickGera 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 Gera o evento NTF-SELCHANGE. Permitindo assim, quando houver alguma seleção no controle, executar o evento.

Paged Habilita o paged para o controle, fazendo com que seja montado o list box e lido os registros por páginas.


Selection Index Modifica o item indicado. No comando inquire retorna o indexador do item selecionado.

Size Ajusta a largura do controle.Size in Pixels Ajusta a largura do controle em pixel.Tab Order Seqüência de accept do controle com relação à tela.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.

Value Container Cria variável na working com nível 88 de todo o conteúdo do combo para o caso de ter sido adicionado valores fixos.

Value Picture Informa a PIC da variável do controle.



Insertion-IndexSe fixado para um valor positivo, o item a ser adicionado no 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.

Query Index Utilizado em conjunto com a propriedade ITEM-VALUE, retorna a posição do item no controle.

Reset List Limpa todo o conteúdo do controle.

Search Text Utilizado apenas com a propriedade PAGED, retorna o valor fornecido pelo texto de procura.

Página 66


Sort Order

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.

PL-SORT-NONE (1) Todo o tipo de caractér resultará uma notificação.

PL-SORT-NATIVE (2) Será procurado conforme o caractér é digitado.

PL-SORT-IGNORE-CASE (3)Ignora a forma do caractér retornando todos os valores informados.

Thumb PositionExibe 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.


(Name) Nome do Controle.Handle Variable Define uma variável HANDLE para o menu.

StyleStatic Menu Cria um menu estático.

Pop-Up Menu Determina que o menu será acionado através do clique com o botão direito do mouse.

Tab Order Seqüência de accept do controle com relação à tela.Propriedades dos itens de Menu

Checked O item do menu aparecerá com um check (sinal de conferimento).

Enable Habilita ou desabilita o item de menu.Exception Value Determina valor de exceção para o item de menu.Label Título que aparece em cada item de menu.Separator 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.


(Name) Nome do Controle.Cell Informa se tamanho será em CellsColor Informa a cor do controle, background e foreground.Font Informa a fonte do controle.Handle Variable Define uma variável HANDLE para o toolbar


Lines Ajusta a altura do controle.Tab Order Seqüência de accept do controle com relação à tela.

Página 67




Bitmap Adiciona uma imagem ao controle, (BMP ou JPEG) ela aparecerá ao lado do título de cada aba.

Bitmap Handle Define uma variável HANDLE para a imagem.Bitmap Width Informa a largura da imagem, em pixel.Column Ajusta a coluna onde o controle se inicia, em relação à tela.



Destroy Type





Fixed Width A aba ocupa o mesmo tamanho de espaço independente do título.

Font Informa a fonte do controle.







Lines Ajusta a altura do controle.Lines in Pixels Ajusta a altura do controle, em pixel.Multiline O título aparece em mais de uma linha.No Tab Não passa pelo foco do controle através da tecla “TAB”.


Size Ajusta a largura do controle.Size in Pixels Ajusta a largura, em pixels.

Style Tabs A aba fica com a sua aparência padrãoButtons A aba fica com aparência de botão.

Tab Order Seqüência de accept do controle com relação à tela.

Página 68


Tab Orientation

Top A aba fica no início do controle.

Vertical Left A aba aparecerá na vertical do controle, do lado esquerdo .

Vertical Right A aba aparecerá na vertical do controle, do lado direito.

Bottom A aba aparece na parte inferior do controle.Tab to Add Adiciona uma nova aba para o controle.Value Valor de cada aba do controle.


Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).Propriedades de cada aba

(Name) Nome de determinada aba do Controle.

Bitmap Number Utilizado somente para uma tira de imagens num único arquivo, informa o número da imagem desejada.

Tab Order Seqüência de accept da aba com relação ao controle.Title Título que aparece em cada aba do controle.Visible Variable Variável para visualizar ou não a aba no controle.

Aditional Properties

Flat Buttons Utilizado apenas com a propriedade BUTTONS, o mesmo ficará sem a borda.

Hot Track Ao passar com o mouse sobre o título da aba, seu texto será destacado.

No Dividers Utilizado apenas com a propriedade FLAT-BUTTONS, não aparecerá divisória entre as abas.

No Focus Não seta o foco na aba.Reset List Remove todas as abas do controle.Tab To Delete Exclui determinada aba do controle.



Action

Utilizado em conjunto com a propriedade PAGED, controla a lógica de paginação. Aceita os seguintes valores.

First PageGera o evento MSG-PAGED-FIRST, preenchendo com dados a primeira página do controle.

Last PageGera o evento MSG-PAGED-LAST, preenchendo com dados a última página do controle.

Current PageGera o evento MSG-PAGED-NEXTPAGE, preenchendo com dados a próxima página do controle a partir do Start do arquivo.

Ajustable Columns Altera o tamanho da coluna arrastando o divisor com o mouse.

Página 69


Auto Load Monta a leitura do arquivo para carregar os dados no controle.


Cells’ Setting

Configuração das seguintes propriedades, referente ao título de cada coluna do grid.

Cell Color Informa a cor do título da coluna, background e foreground.

Cell Font Informa a font do título da coluna.Cell Data Descrição do título de cada coluna.

Cell Protection Protege a célula para que não ocorra entrada de dados.

Hidden Data Permite armazenar um dado que não será exibido na célula.

Bitmap Adiciona uma imagem na célula.

Bitmap Hanlde Define uma variável HANDLE para a imagem.

Bitmap TrailingSetado para 1 a imagem aparecerá após o texto da célula, se setado para 0 aparecerá antes. (apenas modify).

Bitmap NumberUtilizado somente para uma tira de imagens num único arquivo, informa o número da imagem desejada.

Bitmap Width Informa a largura da imagem, em pixel.

Copy ResourceSe configurado para verdadeiro, ao gerar o programa o Acucobol adicionará a imagem ao objeto do programa.

Centered Headings Título do cabeçalho fica centralizado independente do alinhamento da coluna

Color Informa a cor do controle, background e foreground.Column Ajusta a coluna onde o controle se inicia, em relação à tela.Column Headings Trata a primeira coluna como cabeçalho.


Página 70


Columns’ Setting

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.

Column Protection Protege a coluna para que não ocorra entrada de dados.


Column Picture Informa o tamanho de cada coluna.

Display Columns Define a quantidade de caractér a ser visualizado em cada coluna.

JustificationCentered Alinhamento centralizado.Left Alinhamento à esquerda.Right Alinhamento à direita.

Data Types

Descreve as características dos dados de cada coluna. Aceita os seguintes valores:

Carac. Desc. Carac. Permitido

“X” Alfanumérico Todos os caracteres.

“U” Alfanumérico Maiúsculo

Todos os caracteres, convertidos automaticamente para maiúsculo.

“L” Alfanumérico Minúsculo

Todos os caracteres, convertidos automaticamente para minúsculo.

“9” NuméricoDígitos, ponto decimal, sinal e espaço.

“Z” Numérico Editado

Dígitos, sinal, período, vírgula, símbolo de moeda, “$”, “*”, “/”, “%” e espaço.

“I” Inteiro Dígitos, sinal e espaço.

“P” Inteiro Positivo

Dígitos e espaço.

“D” Data Dígitos, “/” e Página 71


Cursor Color Ajusta a cor do cursor.Cursor Frame Width Ajusta a largura do cursor, em pixel, na célula.Cursor X Identifica a coluna que está focada.Cursor Y Identifica a linha que está focada.

Destroy Type




Divider Color Define cor para as linhas divisórias.Drag Color Define cor para a área selecionada do grid.


End Color Ajusta cor para a área do grid que não contém células.Font Informa a fonte do controle.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 Identificação do controle.


Last Row Verifica o número da última linha com conteúdo.




Lines Ajusta a altura do controle.Lines in Pixels Ajusta a altura do controle em pixel.No Tab Não passa pelo foco do controle através da tecla “TAB”.Num Columns Determina a quantidade de colunas.

Num Rows Determina a quantidade de linhas, se informar –1 ficará como indeterminado.

Paged Habilita o paged para o controle, fazendo com que seja montado o grid e lido os registros por páginas.


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


Row’s Setting

Configuração das seguintes propriedades, referente a cada 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.

Row Protection Protege a linha para que não ocorra entrada de dados.


Size Ajusta a largura do controle.Size in Pixels Ajusta a largura do controle em pixel.Tab Order Seqüência de accept do controle com relação à tela.Tiled Headings Deixa o título das células de cabeçalho com sombreado.

Use Tab Trabalha as teclas <TAB> e <BACKTAB> como teclas de navegação.

Virtual Width Utilizada com a propriedade HSCROLL, informa uma largura lógica total para o grid.

Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso).Vpadding Informa a altura da célula, valor passado em porcentagem.Vscroll Adiciona uma barra de rolagem na vertical.


Action

Previous PageGera o evento MSG-PAGED-PREVPAGE, preenchendo com dados a página anterior do controle.

Previous

Gera o evento MSG-PAGED-PREV, preenchendo com dados os itens anteriores à página atual, rolando por item.

NextGera o evento MSG-PAGED-NEXT, preenchendo com dados os próximos itens à página atual, rolando por item.

Next PageGera o evento MSG-PAGED-NEXTPAGE, preenchendo com dados a próxima página do controle a partir do Start do arquivo.

Action Hide Drag Remove os valores da propriedade DRAG-COLOR.

Entry Reason

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


File Pos

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:

PAGED-AT-START (2147418113):

Quando informado esse valor o grid não gera os eventos MSG-PAGED-PREV e MSG-PAGED-PREVPAGE.

PAGED-AT-END (2147418114):

Quando informado esse valor o grid não gera os eventos MSG-PAGED-NEXT e MSG-PAGED-NEXTPAGE.

PAGED-EMPTY (2147418115):

Quando informado esse valor o grid não gera os eventos MSG-PAGED-NEXT, MSG-PAGED-NEXTPAGE, MSG-PAGE-PREV e MSG-PAGED-PREVPAGE.

Finish Reason

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:

-1 GRFR-BLANK-PAST-ENDA entrada foi finalizada pelo usuário, porém cancelada pelo controle.

-2 GRFR-TERMINATINGFoi finalizado o grid para ser executado algum outro evento.

-3 GRFR-CELL-CLICKED Foi clicado em outra célula.

-4 GRFR-NAVIGATION-KEYFoi pressionada uma tecla de navegação.

-5 GRFR-ESCAPE-KEY Foi pressionada a tecla <ESC>.

-6 GRFR-ENTER-KEYFoi pressionada a tecla <ENTER>.

-7 GRFR-TAB-KEY Foi pressionada a tecla <TAB>.Hscroll Pos Controla a posição atual da barra de rolagem na horizontal.Insert Rows Insere novas linhas em branco.

Insertion IndexSe fixado para um valor positivo, o próximo item será adicionado na posição informada, se fixado para 0 (zero) o próximo item será adicionado sempre por último.

Mass Update

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 do controle.

Num Col Headings Determina o número de linhas que serão tratados como cabeçalho de coluna.

Record To Delete Exclui o conteúdo de toda uma linha.

Reset Grid Limpa todo o conteúdo e modificações do controle, voltando para configuração inicial. (sem cabeçalho).

Página 74


Search Options

Controla como será apresentada a procura no grid. Recebe os seguintes valores:GRID-SEARCH-FORWARDS

A procura funcionará da esquerda para direita e de cima para baixo.

GRID-SEARCH-WRAP

A procura será realizada apenas em células já carregadas na memória. Obs.: sem a propriedade PAGED.

GRID-SEARCH-IGNORE-CASE

A procura será realizada nas letras em minúscula ou maiúscula.

GRID-SEARCH-MATCH-ANY

A procura será realizada independente da posição do conteúdo indicado.

GRID-SEARCH-MATCH-LEADING

A procura será realizada a partir da posição inicial do conteúdo indicado.

GRID-SEARCH-MATCH-ALL

A procura será realizada somente quando o conteúdo indicado for igual.

GRID-SEARCH-VISIBLE

A procura será realizada nas células onde o conteúdo está sendo visualizado.

GRID-SEARCH-HIDDEN

A procura será realizada somente nas células que possuem valores configurados na propriedade HIDEN-DATA.

GRID-SEARCH-ALL-DATA

A procura será realizada tanto para valores que estão sendo visualizado quanto para os configurados na propriedade HIDDEN-DATA.

GRID-SEARCH-SKIP-CURRENT

A procura será realizada somente para o conteúdo que não começam com o conteúdo indicado.

GRID-SEARCH-MOVES-CURSOR

O cursor se posicionará na célula com o conteúdo encontrado.

GRID-SEARCH-COLUMN

Recebe o valor da coluna onde a busca deve ver realizada, se deseja efetuar a busca para todas as colunas deve-se informar a propriedade GRID-SEARCH-ALL-COLUMNS para 1.

Search Text

A busca será realizada a partir do conteúdo informado nessa propriedade. Aceita os seguintes valores de retorno:

GRDSRCH-NOT-FOUND (0) Não foi encontrado nenhum dado comparado.

GRDSRCH-FOUND (1) A procura foi bem sucedida.

GRDSRCH-WRAPPED (2) A procura foi bem sucedida porém em conteúdo escondido.

Start XUtilizado com as propriedades START-Y, X, Y e REGION-COLOR, informa a coluna inicial para a região a ser informada.

Start YUtilizado com as propriedades START-X, X, Y e REGION-COLOR, informa a linha inicial para a região a ser informada.

Vscroll Pos Utilizada com a propriedade VSCROOL, controla a posição atual da barra.

X Informa o número da coluna do grid.Página 75


Y Informa o número da linha do grid.



Bitmap Adiciona uma imagem ao controle, (BMP ou JPEG) ela aparecerá ao lado de cada item.

Bitmap Handle Define uma variável HANDLE para a imagem.Bitmap Width Informa a largura da imagem, em pixel.


Buttons Imagem com o sinal de “+” ou “-“ que aparece ao lado de cada item.



Clines Ajusta a altura do controle. (Somente caracter).Color Informa a cor do controle, background e foreground.





Destroy Type






Help IDTrabalha em conjunto com a variável de ambiente HELP-PROGRAM Informa o valor do ID criado no help do controle.






Página 76


Lines Ajusta a altura do controle.

Lines At Root Permite que as propriedades SHOW-LINES e BUTTONS sejam aplicadas aos itens de nível superior.

Lines in Pixels Ajusta a altura do controle em pixel.No Tab Não passa pelo foco do controle através da tecla “TAB”.


Show Lines Adiciona linhas entre um item e seu sub-item.Show Selecton Always Mostra a seleção atual do item.Size Ajusta a largura do controle.Size in Pixels Ajusta a largura do controle em pixel.Tab Order Seqüência de accept do controle com relação à tela.



Propriedades de cada item(Name) Nome de cada item do controle.

Bitmap Number Utilizado somente para uma tira de imagens num único arquivo, informa o número da imagem desejada.

Ensure Visible Se o item possuir um ID válido, o item será visualizado no controle.

Expand Configurado para verdadeiro o item aparecerá expandido.

Has ChildrenIndica a quantidade de sub-itens que possui determinado item, através da propriedade ITEM, independente de estar sendo visualizado ou não.

Hidden Data Permite armazenar um dado que não será exibido em um item.

Identified Pointer Variável de ponteiro para identificar cada item do controle.

Label Título que será apresentado em cada item do controle.

Placement

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.


ItemUtilizada em conjunto com outras propriedades, identifica qual o item que foi acionado para executar determinada tarefa.

Item Text Título que cada item do controle receberá.

Item to AddAdiciona um novo item ao controle. Sua posição na hierarquia é determinada através das propriedades PARENT e PLACEMENT.

Item to Delete Apaga determinado item do controle.Item to Empty Apaga todos os sub-itens de um determinado item.

Página 77


Next Item

Retorna o tipo de item encontrado. Aceita os seguintes valores:

TVNI-CHILD Primeiro sub-item de um item principal

TVNI-FIRST-VISIBLE Primeiro item atualmente visível 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.

TVNI-ROOT O item de nível principal em todo o controle.

ParentSe informar o ID de um item já existente, cria um sub-item do mesmo, se deixar zero, cria um item novo de nível principal.

Reset List Remove todos os itens do controle.





Destroy Type





Help IDTrabalha em conjunto com a variável de ambiente HELP-PROGRAM Informa o valor do ID criado no help do controle.







Página 78


Lines in Pixels Ajusta a altura do controle, em pixel.No Tab Não passa pelo foco do controle através da tecla “TAB”.Size Ajusta a largura do controle.Size in Pixels Ajusta a largura, em pixels.Tab Order Seqüência de accept do controle com relação à tela.Value Informa a URL que está sendo exibida no momento.




Busy Indica se o download ou a navegação ainda está sendo carregado.

Clear Selection Limpa a seleção atual.Copy Selection Copia a seleção atual.

Custom Print TemplatePara versões do Internet Explorer 5.5 ou superior, permite a chamada de Modelos de Impressão Personalizados.

File Name Informa o caminho e nome do arquivo para ser usado quando executa o Salvar Como do Browser.

Methods

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 Propriedade Descrição

GOBACK GO-BACK Volta para a URL anterior acessada.

GOFORWARD GO-FORWARD Avança a URL.

GOHOME GO-HOMEAcessa a URL configurada como inicial.

GOSEARCH GO-SEARCH Acessa o Portal da Microsoft.

NAVIGATE VALUE Acessa uma URL ou arquivo.

REFRESH REFRESH Atualiza a página atual.

STOPBROWSER STOP-BROWSER Finaliza um acesso ou download.

Page Setup Aciona a janela de Configurar Página.Print Aciona a janela de Impressão.Print no Prompt Envia direto para a impressora.Print Preview Aciona a janela de Visualizar Impressão.Properties Aciona a janela de Propriedades da página.Save AS Aciona a janela de Salvar Como.

Save As no Prompt Salva um documento com o nome informado na propriedade FILE-NAME, sem adicionar a janela.

Select All Seleciona todos os dados de uma página.Title Informa o título da página.

Página 79


Type Informa o tipo de documento acionado do browser.


(Name) Nome do Controle.Font Informa a fonte do controle.Grip O Controle sempre seguirá o tamanho da tela.Handle Variable Define uma variável HANDLE para o toolbar

Panel’s Setting

Configura as propriedades de cada divisão da barra.

Panel-Index Especifica qual divisão da barra de status irá trabalhar.

Panel Style

Especifica uma borda para a divisão da barra de status. Aceita os seguintes valores:

Flat A divisão terá a mesma altura que o resto da janela, sem bordas visuais.

Lowered A divisão aparece afundada na janela.

Raised A divisão aparece levantada na janela.

Panel Text Especifica o texto a ser visualizado em determinada divisão.

Panel Width Especifica a largura da divisãoTab Order Seqüência de accept do controle com relação à tela.


(Name) Nome do Controle.Calendar Font Informa a fonte do calendário que é aberto.Column Ajusta a coluna onde o controle se inicia, em relação a tela.

Column in Pixels Ajusta a coluna onde o controle se inicia em pixels, em relação a tela.

Destroy Type




Display Format

Forma de como será visualizado o controle. Aceita os seguintes valores:Short Date Apresenta no formato DD/MM/AA.

Long Date Apresenta o formato exato de toda a data Ex: Segunda-feira 16 de maio de 2005

Time Apresenta a hora da máquina localEnable Habilita ou não o accept do controle. (1 verdadeiro, 0 falso).Font Informa a fonte do controle.

Página 80









No F4 Ao pressionar a tecla <F4> o calendário é aberto, com essa propriedade configurada, desabilita essa função.


No UpdownAo 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.

Notify ChangeGera o evento NTF-SELCHANGE. Permitindo assim, quando houver alguma alteração na digitação do controle, executar o evento.


Right Aligment Faz com que o calendário seja alinhado a direita com relação ao controle.

Show NoneAdiciona um check-box dentro do controle, quando o check-box está secionado deixa a data/hora habilitada, quando não selecionado desabilita a data/hora

Size Ajusta a largura do controle.Size in Pixels Ajusta a largura do controle em pixel.

Spinner Habilita as teclas de movimentação para mover os valores do campo

Tab Order Seqüência de accept do controle com relação à tela.Value Recebe o mesmo que VALUE-FORMAT.

Value Format

Formato da data/ hora. Aceita os seguintes valores:

YYYYMMDD Apresentará 8 dígitos, 4 para o ano, 2 para o mês e 2 para o dia.

YYMMDD Apresentará 6 dígitos, 2 para o ano, 2 para o mês e 2 para o dia.

HHMMSStt Apresentará 8 dígitos, de 24 horas incluindo os centésimos de segundo.

HHMMSS Apresentará 6 dígitos, de 24 horas

YYYYMMDD HHMMSSttApresentará 16 dígitos que é a combinação de YYYYMMDD mais HHMMSSHH.


Visible Visualiza ou não o controle na tela. (1 verdadeiro, 0 falso)

Página 81



Absolute Column Informa a coluna inicial, onde a window será visualizada, em pixels.

Absolute Line Informa a linha inicial, onde a window será visualizada em pixels.

Action

Maximize

Utilizada em conjunto com as propriedades RESIZABLE ou AUTO-RESIZE, esta ação maximiza a janela, tendo o mesmo efeito de ter clicado no botão Maximizar.

Minimize

Utilizada em conjunto com a propriedade AUTO-MINIMIZE e somente em janelas INDEPENDENT, esta ação minimiza a janela, tendo o mesmo efeito de ter clicado no botão Minimizar.

Allowing MessagesAny Thread Permite enviar e receber mensagens de todas

as threads.

Last Thread Permite enviar e receber mensagens da ultima thread ativa.

Auto Minimize Utilizada em janelas INDEPENDENT ou INITIAL, o botão de minimizar será habilitado.

Auto Resize Esta propriedade permite maximizar e restaurar uma janela.

Before Time Permite finalizar a tela perante um determinado período em milésimos de segundo sem que ocorra exceção.

Bind To Thread Utilizado para thread, ao fechar a janela principal, a que está 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.

Cell MeasurePixels Cordenadas de tamanho será em pixel.

Control Font Cordenadas de tamanho será de acordo com a font.

Cell Width Define a largura da janela em cell.Color Informa a cor do controle, background e foreground.

Column Variable Ajusta uma variável informando o valor da coluna que a 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.



Página 82


Label Offset Não utilizado com pixels, ajusta a altura do label em relação ao Entry Field.

Layout Manager LM_RESIZE, ativa o resize da tela para poder trabalhar com o layout data nos controles.

Line Variable Ajusta uma variável informando o valor da linha que a janela será iniciada.


Link To Thread Utilizado para thread, ao fechar a janela principal, a que está com essa propriedade não será finalizada.

Main Menu Informa a handle do menu que deseja vincular a tela.Max Lines Informa o maior valor de altura que a janela pode ter.Max Size Informa o maior valor de largura que a janela pode ter.Min Lines Informa o menor valor de altura que a janela pode ter.Min Size Informa o menor valor de largura que a janela pode ter.

ModelessUtilizado para thread, permite obter mais de uma janela ativa, não precisando fechar uma janela para poder abrir outra.


Resizable Permite restaurar a janela manualmente, não sendo automático como no AUTO-RESIZE.

Scroll Adiciona uma barra de rolagem na janelaSize Ajusta a largura do controle.System Menu Habilita ou não os botões de minimizar, maximizar e fechar.Title Informa o título da janela.Title Bar Habilita ou não a barra de título da janela.

Unit Cells Unidade de medida em CellsPixels Unidade de medida em Pixels

User Gray Ajusta a cor dos controles em 3D para o valor 8 (cinza) .User White Ajusta a cor dos controles em 3D para o valor 16 (branco) .Visible Visualiza ou não a janela. (1 verdadeiro, 0 falso)

Window Type

Tipo de Window a ser criada. Aceita os seguintes valores:

Floating É uma sub-window, e sempre estará vinculada a uma window principal.

Independent É uma sub-window, e não se vincula a nenhuma window principal.

InitialÉ uma window principal, tendo propriedades específicas, porém sempre estará vinculada nas sub-window’s.

StandardÉ uma window principal, tendo propriedades específicas e pode trabalhar em paralelo das sub-window’s.


Action Restore Se a window estiver Maximizada ou Minimizada, esta ação restaura a mesma para o seu tamanho original.

Modal Não permite objer mais de uma janela ativa.

Página 83


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 ValueEvent Procedure

Cmd-Clicked 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.

Cmd-Goto A rotina será executada no momento que ocorrer o clique no controle para o foco ficar no mesmo.

Cmd-Help A rotina será executada quando for selecionado o help do controle.

Msg-End-Menu A rotina será executada quando sair do menu pop-up vinculado ao controle.

Msg-Init-Menu A rotina será executada quando clicar com o botão direito para chamar o menu pop-up vinculado ao controle.

Msg-Menu-Input A rotina será executada quando clicar em um item do menu.Msg-Validate A rotina será executada quando finalizar o foco do controle.Other Qualquer outro evento não mencionado acima.

Exception Procedure

Cmd-Clicked

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”, após ocorrer o EVENTO CMD-CLICKED .

Cmd-GotoA rotina será executada no momento que ocorrer o clique no controle para o foco ficar no mesmo, após ocorrer o EVENTO CMD-GOTO.

Cmd-Help A rotina será executada quando for selecionado o help do controle, após ocorrer o EVENTO CMD-HELP, .

Other Qualquer outra exceção não mencionada acima.

Before Procedure A rotina será executada antes do foco chegar no controle.After Procedure A rotina será executada após o foco sair do controle.

Página 84


Link ToA rotina será executada quando for pressionada a tecla de exceção. Obrigatoriamente a propriedade EXCEPTION-VALUE deverá ter um valor.






Msg-Menu-Input A rotina será executada quando clicar em um item do menu.

Msg-Spin-Down Utilizada para a propriedade SPINNER, a rotina será executada quando for clicado na seta para baixo do campo.

Msg-Spin-Up Utilizada somente com propriedade SPINNER, a rotina será executada quando for clicado na seta para cima no campo.

Msg-Validate A rotina será executada quando finalizar o foco do controle.

Ntf-Changed Utilizado somente com a propriedade NOTIFY-CHANGE, a rotina será executada quando houver qualquer entrada de dados.

Other Qualquer outro evento não mencionado acima.Exception Procedure

Cmd-GotoA rotina será executada no momento que ocorrer o clique no botão para o foco ficar no mesmo, após ocorrer o EVENTO CMD-GOTO.

Cmd-Help A rotina será executada quando for selecionado o help do controle, após ocorrer o EVENTO CMD-HELP.

Ntf-ChangedUtilizado somente com a propriedade NOTIFY-CHANGE, a rotina será executada quando houver qualquer entrada de dados, antes do EVENTO NTF-CHANGED.




Cmd-Clicked A rotina será executada no momento que ocorrer o clique no controle, tanto para selecionar quanto para tirar a seleção.


Página 85






Exception Procedure

Cmd-ClickedA rotina será executada no momento que ocorrer o clique no controle, tanto para selecionar quanto para tirar a seleção, se não houver rotina no EVENTO CMD-CLICKED.







Cmd-Clicked A rotina será executada no momento que ocorrer o clique no controle, para a sua seleção.






Exception Procedure

Cmd-ClickedA rotina será executada no momento que ocorrer o clique no controle para a sua seleção, se não houver rotina no EVENTO CMD-CLICKED.

Página 86












Msg-Sb-Next A rotina será executada quando for clicado no botão down / right do scrool bar.

Msg-Sb-NextPage A rotina será executada quando for clicado na região de página down / right do scrool bar.

Msg-Sb-Prev A rotina será executada quando for clicado no botão up / left do scrool bar.

Msg-Sb-PrevPage A rotina será executada quando for clicado na região de page up / left do scrool bar.

Msg-Sb-Thumb A rotina será executada quando for reposicionado o slider do scrool bar.

Msg-sb-Thumbtrack Utilizada com a propriedade TRACK THUMB, a rotina será executada quando for reposicionado o slider do scrool bar.

Msg-Validate A rotina será executada, quando finalizar o foco do controle.Other Qualquer outro evento não mencionado acima.

Exception Procedure




Página 87


Item Value

Event Procedure

Cmd-Dblclick

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.





Msg-Menu-Input A rotina será executada quando clicar em um item do menu.Msg-Validate A rotina será executada, quando finalizar o foco do controle.

Ntf-SelchangeUtilizado somente com a propriedade NOTIFY-SELCHANGE, a rotina será executada quando houver qualquer alteração na seleção de um dado.


Cmd-Dblclick

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, após ocorrer o EVENT CMD-DBLCLICK.



Ntf-SelchangeUtilizado somente com a propriedade NOTIFY-SELCHANGE, a rotina será executada quando houver qualquer alteração na seleção de um dado, antes do EVENTO NTF-CHANGED.




Item Value

Página 88


Event Procedure







Item Value

Event Procedure

Cmd-Dblclick

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.





Msg-Menu-Input A rotina será executada quando clicar em um item do menu.Msg-Validate A rotina será executada, quando finalizar o foco do controle.

Ntf-Pl-FirstUtilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão para ir ao primeiro registro do list.

Ntf-Pl-LastUtilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão para ir no ultimo registro do list.

Ntf-Pl-NextUtilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão para ir ao próximo registro a partir do selecionado.

Ntf-Pl-NextpageUtilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão para ir ao próximo bloco de registros a partir do selecionado.

Página 89


Ntf-Pl-PrevUtilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão para ir ao registro anterior a partir do selecionado.

Ntf-Pl-PrevpageUtilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão para ir ao bloco anterior de registros a partir do selecionado.

Ntf-Pl-SearchUtilizada somente com a propriedade PAGED, a rotina será executada, quando selecionar para ir na página que contem o texto de busca informado.

Ntf-SelchangeUtilizada somente com a propriedade NOTIFY-SELCHANGE, a rotina será executada quando houver qualquer alteração na seleção de um dado.


Cmd-Dblclick

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, após ocorrer o EVENT CMD-DBLCLICK.



Ntf-Pl-FirstUtilizada somente com a propriedade PAGED, a rotina será executada quando for pressionada a tecla “Home” para ir ao primeiro registro do list.

Ntf-Pl-LastUtilizada somente com a propriedade PAGED, a rotina será executada quando for pressionada a tecla “End” para ir no ultimo registro do list.

Ntf-Pl-NextUtilizada somente com a propriedade PAGED, a rotina será executada quando for pressionada a tecla down, para ir ao próximo registro a partir do selecionado.

Ntf-Pl-NextpageUtilizada somente com a propriedade PAGED, a rotina será executada quando for pressionada a tecla page down para ir ao próximo bloco de registros a partir do selecionado.

Ntf-Pl-PrevUtilizada somente com a propriedade PAGED, a rotina será executada quando for pressionada a tecla up, para ir ao registro anterior a partir do selecionado.

Ntf-Pl-PrevpageUtilizada somente com a propriedade PAGED, a rotina será executada quando for pressionada a tecla page up, para ir ao bloco anterior de registros a partir do selecionado.

Ntf-Pl-SearchUtilizada somente com a propriedade PAGED, a rotina será executada, quando selecionar para ir à página que contem o texto de busca informado.

Ntf-SelchangeUtilizada somente com a propriedade NOTIFY-SELCHANGE, a rotina será executada quando houver qualquer alteração na seleção de um dado.

Página 90


Ntf-SelchangeUtilizado somente com a propriedade NOTIFY-SELCHANGE, a rotina será executada quando houver qualquer alteração na seleção de um dado, antes do EVENTO NTF-CHANGED.




Item Value

Link ToA rotina será executada quando for pressionada a tecla de exceção, ou clicado no item de menu. Obrigatoriamente a propriedade EXCEPTION-VALUE deverá ter um valor.


Item Value

Event Procedure


Cmd-Tabchanged A rotina será executada quando for clicado em alguma aba do controle.




Msg-Validate A rotina será executada, quando finalizar o foco do controle.




Página 91



Before-Tabchg-Display A rotina será executada depois que ocorrer o evento CMD-TABCHANGED, antes do display da página.

After-Tabchg-Display A rotina será executada depois que ocorrer o evento CMD-TABCHANGED, depois do display da página.

Item Value

Event Procedure



Msg-Begin-Drag A rotina será executada quando clicar com o mouse na célula e arrastar, antes de soltar novamente.

Msg-Begin-Entry A rotina será executada quando iniciar o accept da célula.

Msg-Begin-Heading-DragA rotina será executada quando clicar com o mouse na célula de cabeçalho e arrastar, antes de soltar novamente.

Msg-Bitmap-Clicked

A rotina será executada quando clicar apenas 1 vez sobre a imagem. OBS: O clique necessariamente deve ser sobre a imagem, se clicar fora ocorrerá outro evento.

Msg-Bitmap-Dblclick

A rotina será executada quando houver um duplo clique sobre a imagem. OBS: O clique necessariamente deve ser sobre a imagem, se clicar fora ocorrerá outro evento.

Msg-Cancel-EntryA rotina será executada quando for pressionada a tecla ESC em uma célula acceptada (no meio de uma digitação)

Msg-Col-Width-Changed A rotina será executada quando for alterada a largura de uma coluna.

Msg-End-Drag A rotina será executada quando clicar com o mouse na célula e arrastar, depois que soltou novamente.

Msg-End-Heading-DragA rotina será executada quando clicar com o mouse na célula de cabeçalho e arrastar, depois que soltou novamente.


Página 92


Msg-Finish-Entry A rotina será executada quando finalizar o accept de uma célula.

Msg-Goto-Cell A rotina será executada quando passar por uma célula através das teclas de movimentação.

Msg-Goto-Cell-Drag A rotina será executada equanto o conjunto de células está sendo arrastado para um outro controle grid.

Msg-Goto-Cell-Mouse A rotina será executada quando for clicado em determinada célula.

Msg-Grid-Rbutton-Down A rotina será executada quando for clicado e mantido abaixado o botão direito do mouse.

Msg-Grid-Rbutton-Up A rotina será executada quando for clicado e soltado o botão direito do mouse.

Msg-Heading-Clicked A rotina será executada ocorrer 1 clique na célula de cabeçalho.

Msg-Heading-Dblclick A rotina será executada ocorrer o duplo clique na célula de cabeçalho.

Msg-Heading-DraggedA rotina será executada quando clicar com o mouse na célula de cabeçalho e arrastar, mantendo o botão pressionado.

Msg-Init-MenuA rotina será executada quando clicar com o botão direito para chamar o menu pop-up vinculado ao controle.


Msg-Paged-First

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.

Msg-Paged-Last

Utilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão, ou pressionado a tecla end, para ir ao último registro do grid.

Msg-Paged-Next

Utilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão, ou pressionado a tecla down, para ir ao próximo registro do grid.

Msg-Paged-Nextpage

Utilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão, ou pressionado a tecla page down, para ir ao próximo bloco de registros do grid.

Msg-Paged-Prev

Utilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão, ou pressionado a tecla up, para ir ao registro anterior ao selecionado do grid.

Msg-Paged-Prevpage

Utilizada somente com a propriedade PAGED, a rotina será executada quando for clicado no botão, ou pressionado a tecla page up, para ir ao bloco anterior de registros do grid.


Página 93



Cmd-GotoA rotina será executada no momento que ocorrer o clique do controle para o foco ficar no mesmo, após ocorrer o EVENTO CMD-GOTO.



Before Procedure A rotina será executada antes do foco chegar no controle.

After Procedure A rotina será executada após o foco sair do controle.

Item Value

Event Procedure




Msg-Init-MenuA rotina será executada quando clicar com o botão direito para chamar o menu pop-up vinculado ao controle.


Msg-Tv-Dblclick A rotina será executada quando ocorrer o duplo clique em algum item do controle.

Msg-Tv-Expanded A rotina será executada logo após o clique no item para abrir os sub-níveis.

Msg-Tv-Expanding A rotina será executada quando clica no item para abrir os sub-níveis.

Msg-Tv-Selchange A rotina será executada quando ocorre a alteração da seleção de item no controle.

Msg-Tv-Selchanging A rotina será executada quando vai ocorrer a alteração da seleção de item no controle.





Página 94





Item Value

Event Procedure



Msg-Wb-Before-Navigate A rotina será executada quando for informada uma nova URL para o controle.

Msg-Wb-Download-BeginA rotina será executada quando uma operação de navegação for executada, logo após o EVENTO MSG-WB-BEFORE-NAVIGATE.

Msg-Wb-Download-Complete A rotina será executada quando uma operação de navegação for finalizada

Msg-Wb-Navigate-Complete A rotina será executada depois que o browser navegou na nova URL informada.

Msg-Wb-Progress-Change A rotina será executada na alteração do status de progresso de um download.

Msg-Wb-Status-Text-Change A rotina será executada quando houver alteração de texto na barra de status.

Msg-Wb-Title-Change A rotina será executada quando houver alteração do título de um documento aberto no browser.


Cmd-HelpA rotina será executada quando for selecionado o help do controle, após ocorrer o EVENTO CMD-HELP.





Página 95


Item Value

Event Procedure






Msg-Spin-Down Utilizada para a propriedade SPINNER, a rotina será executada quando for clicado na seta para baixo do campo.

Msg-Spin-Up Utilizada somente com a propriedade SPINNER, a rotina será executada quando for clicado na seta para cima do campo.

Msg-Validate A rotina será executada quando finalizar o foco do controle.

Ntf-Changed Utilizado somente com a propriedade NOTIFY-CHANGE, a rotina será executada quando houver qualquer entrada de dados.




Ntf-ChangedUtilizado somente com a propriedade NOTIFY-CHANGE, a rotina será executada quando houver qualquer entrada de dados, antes do EVENTO NTF-CHANGED.




Cmd-Activate A rotina será executada quando a janela for ativada.

Cmd-Close A rotina será executada quando for clicado no botão X (sair) da janela.




Página 96


Ntf-Resized Utilizado em conjunto com a propriedade RESIZABLE, a rotina será executada quando for clicado no botão de restaurar.


Cmd-Activate A rotina será executada quando a janela for ativada.

Cmd-Close A rotina será executada quando for clicado no botão X (sair) da janela.

Ntf-Resized Utilizado em conjunto com a propriedade RESIZABLE, a rotina será executada quando for clicado no botão de restaurar.


Before Create A rotina será executada antes da criação da tela.After Create A rotina será executada após a criação da tela.

Before InitdataA 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.

After InitdataA 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..

Before Procedure A rotina será executada antes do foco chegar em cada controle da tela.

After Procedure A rotina será executada após o foco sair de cada controle da tela.

Before Routine A rotina será executada antes do display da tela.After Routine A rotina será executada após o destroy da tela.

Link To

A rotina será executada quando for pressionada a tecla de 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


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.

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


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 ValueStart Key Informa a chave do arquivo para dar o start.Start Value Informa o valor que a chave deve receber antes do start.

Start Value Variable Informa o nome de uma variável, que a chave deve receber o seu conteúdo antes do start.

Start Value Variable Pic Informa o tamanho da variável.

Start Direction Informa a maneira de comparação da chave para o start, podendo ser >=, <=, >, <, = ,<>, etc...

Invalid Key Perform Informa o nome de um parágrafo a ser executado se der erro no start do arquivo.

Read Direction Direção da leitura dos registros, podendo ser next, previous, etc…

Perform Until Condition Informa a condição para sair do loop. Ex: not valid ws-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.

At End Perform Informa o nome de um parágrafo a ser executado quando for final de arquivo.

Not At End Perform Informa o nome de um parágrafo a ser executado enquanto não for final de arquivo.

Página 99


Add Item ConditionInforma 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:

Página 100

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 namevar-arquivo = nome da variável do arquivo que compõe a chavearquivo = nome do arquivo a ser lidochave = nome do campo chavevar-controle = variável do controle combo-box, na propriedade value variable


Não abre nenhuma janela para configuração de propriedades, apenas vincula o nome da variável do arquivo à propriedade VALUE VARIABLE do controle.




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





D-) Grid Column(s): Visualiza os campos do arquivo que foram selecionados para serem carregados os registros em cada coluna do controle.












Add Item ConditionInforma uma condição verdadeira para realizar a atualização no grid. Não é necessário colocar a sintaxe IF.

F-) Funções:



Página 102



Página 103

Acu-nomecontrole-Autoload. MODIFY nomecontrole, X = 1, Y = 1 CELL-DATA = nome-var-arq-col1 MODIFY nomecontrole, X = 2, Y = 1 CELL-DATA = nome-var-arq-col2 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, RECORD-TO-ADD var-controle INITIALIZE var-controle.

Acu-nomecontrole-Autoload-Load. MOVE var-arquivo-col1 TO var-controle-col1. MOVE var-arquivo-col2 TO var-controle-col2.

nomecontrole = nome do controle dado ao grid, na propriedade namevar-arquivo = nome da variável do arquivo que compõe a chavenome-var-arq-col1= nome da variável do arquivo que aparece na coluna 1nome-var-arq-col2= nome da variável do arquivo que aparece na coluna 2arquivo = nome do arquivo a ser lidochave = nome do campo chavevar-controle = variável do controle grid, na propriedade value variablevar-controle-col1 = variável do controle grid, subnivel da variável var-controlevar-controle-col2 = variável do controle grid, subnivel da variável var-controle





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





D-) ListBox Column(s): Visualiza os campos do arquivo que foram selecionados para serem carregados os registros em cada coluna do controle.












Add Item ConditionInforma uma condição verdadeira para realizar a atualização no list box. Não é necessário colocar a sintaxe IF.

F-) Funções:


Salva as configurações.Página 105



Página 106

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.



nomecontrole = nome do controle dado ao list-box, na propriedade namevar-arquivo = nome da variável do arquivo que compõe a chavenome-var-arq-col1= nome da variável do arquivo que aparece na coluna 1nome-var-arq-col2= nome da variável do arquivo que aparece na coluna 2arquivo = nome do arquivo a ser lidochave = nome do campo chavevar-controle = variável do controle list-box, na propriedade value variablevar-controle-col1 = variável do controle list-box, subnivel da variável var-controlevar-controle-col2 = variável do controle list-box, subnivel da variável var-controle


As propriedades configuradas nessa tela, servem para o Acubench gerar o 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 propriedade AUTO LOAD.



Página 107



D-) Grid Column(s): Visualiza os campos do arquivo que foram selecionados para serem carregados os registros em cada coluna do controle.


Item ValueStart Key Informa a chave do arquivo para dar o start.


F-) Funções:




Página 108

Acu-nomecontrole-Autoload. MODIFY nomecontrole, X = 1, Y = 1 CELL-DATA = nome-var-arq-col1 MODIFY nomecontrole, X = 2, Y = 1 CELL-DATA = nome-var-arq-col2 MODIFY nomecontrole, ACTION = ACTION-FIRST-PAGE.

Acu-nomecontrole-Autoload-Add. PERFORM Acu-nomecontrole-Autoload-Load MODIFY nomecontrole, RECORD-TO-ADD var-controle INITIALIZE var-controle.

Acu-nomecontrole-Autoload-Load. MOVE var-arquivo-col1 TO var-controle-col1. MOVE var-arquivo-col2 TO var-controle-col2. nomecontrole = nome do controle dado ao grid, na propriedade namevar-arquivo = nome da variável do arquivo que compõe a chavenome-var-arq-col1= nome da variável do arquivo que aparece na coluna 1nome-var-arq-col2= nome da variável do arquivo que aparece na coluna 2var-controle = variável do controle grid, na propriedade value variablevar-controle-col1 = variável do controle grid, subnivel da variável var-controlevar-controle-col2 = variável do controle grid, subnivel da variável var-controle


E os parágrafos abaixo, permitindo a intervenção do desenvolvedor:

Página 109

* 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.

* Autoload Paged control code generated by Drag-And-Drop Nomecontrole-Ev-Msg-Paged-Prev. PERFORM event-data-2 times read arquivo previous record at end move event-action-fail to event-action exit paragraph end-read end-perform. PERFORM nomecontrole-Autoload-Load. MODIFY nomecontrole, INSERTION-INDEX=2, RECORD-TO-ADD = nomecontrole -Autoload.

* Autoload Paged control code generated by Drag-And-Drop Nomecontrole-Ev-Msg-Paged-First. move low-values to var-chave start estado, key >= var-chave invalid key move event-action-fail to event-action end-start.

* Autoload Paged control code generated by Drag-And-Drop Nomecontrole -Ev-Msg-Paged-Last. move high-values to var-chave start estado, key <= var-chave invalid key move event-action-fail to event-action end-start.

nomecontrole = nome do controle dado ao grid, na propriedade namearquivo = nome do arquivo a ser lidovar-chave = nome da variável do arquivo que compõe a chave


As propriedades configuradas nessa tela, servem para o Acubench gerar o 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 propriedade AUTO LOAD.



Página 110



D-) ListBox Column(s): Visualiza os campos do arquivo que foram selecionados para serem carregados os registros em cada coluna do controle.


Item ValueStart Key Informa a chave do arquivo para dar o start.


F-) Funções:




Página 111

Acu-nomecontrole-Autoload. MODIFY nomecontrole, MASS-UPDATE = 1 MOVE low-value TO var-arquivo START arquivo, KEY >= chave END-START PERFORM nomecontrole-page-size TIMES READ arquivo next RECORD AT END SET nomecontrole-at-end TO TRUE EXIT PERFORM NOT AT END PERFORM Acu-nomecontrole-Autoload-Add END-READ END-PERFORM MODIFY nomecontrole, MASS-UPDATE = 0.



nomecontrole = nome do controle dado ao list-box, na propriedade namevar-arquivo = nome da variável do arquivo que compõe a chavenome-var-arq-col1= nome da variável do arquivo que aparece na coluna 1nome-var-arq-col2= nome da variável do arquivo que aparece na coluna 2arquivo = nome do arquivo a ser lidochave = nome do campo chavevar-controle = variável do controle list-box, na propriedade value variablevar-controle-col1 = variável do controle list-box, subnivel da variável var-controlevar-controle-col2 = variável do controle list-box, subnivel da variável var-controle


E os parágrafos abaixo, permitindo a intervenção do desenvolvedor:

Página 112

* Autoload Paged control code generated by Drag-And-Drop nomecontrole-Ntf-Pl-Next. PERFORM nomecontrole-get-next-item.

* Autoload Paged control code generated by Drag-And-Drop nomecontrole-Ev-Ntf-Pl-Prev. PERFORM nomecontrole-get-prev-item .

* Autoload Paged control code generated by Drag-And-Drop nomecontrole-Ev-Ntf-Pl-Nextpage. MODIFY nomecontrole, MASS-UPDATE = 1 PERFORM nomecontrole-Get-Next-Item nomecontrole-page-size TIMES MODIFY nomecontrole, MASS-UPDATE = 0.

* Autoload Paged control code generated by Drag-And-Drop nomecontrole-Ev-Ntf-Pl-Prevpage. MODIFY nomecontrole, MASS-UPDATE = 1 PERFORM nomecontrole-Get-Prev-Item nomecontrole -page-size TIMES MODIFY nomecontrole, MASS-UPDATE = 0.

* Autoload Paged control code generated by Drag-And-Drop 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 MODIFY nomecontrole, MASS-UPDATE = 1 RESET-LIST = 1. PERFORM nomecontrole-get-next-item nomecontrole-page-size times MODIFY nomecontrole, MASS-UPDATE = 0.

* Autoload Paged control code generated by Drag-And-Drop 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 MODIFY nomecontrole, MASS-UPDATE = 1 RESET-LIST = 1. PERFORM nomecontrole-get-prev-item nomecontrole-page-size TIMES MODIFY nomecontrole, MASS-UPDATE = 0.


Página 113

* Autoload Paged control code generated by Drag-And-Drop 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.

* Autoload Paged control code generated by Drag-And-Drop 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. INITIALIZE nomecontrole-Autoload PERFORM Acu- nomecontrole-Autoload-Load MODIFY nomecontrole, INSERTION-INDEX = 1 ITEM-TO-ADD = nomecontrole-Autoload SET nomecontrole-reading-backwards TO TRUE.


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


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:




nome da variável do arquivo à propriedade VALUE VARIABLE do controle.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.

No menu principal, selecionar FILE NEW, abrirá janela com opções, selecionar a aba Report que será visualizada a seguinte opção:

Página 115


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


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.

Report Footer A impressão será no final do relatório apenas, independendo de 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


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 seguintes propriedades:

Type

Informa a maneira de como será a quebra do relatório. Aceita:Field A quebra será efetuada pelo campo informado.

RecordA quebra será efetuada pelo conteúdo do campo gravado no arquivo, respeitando os parâmetros informados em Grouped By.

Grouped By Informa qual o campo do arquivo que será responsável pela quebra.

Show What

Informa quais seções referentes à quebra será impressa no relatório. Aceita:Header A seção será impressa no inicio de cada quebra.Footer A seção será impressa no final de cada quebra.Both Irá criar as duas seções citadas acima.

Count Height

Calcula a quantidade de linhas de acordo com o layout da pagina para realizar a quebra. Aceita:None Não fará calculo de linhas.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


A-) 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çãoPágina 119


(Name) Nome do ControleBorder Color Informa a cor da borda do controle.

Border Style Boxed Aciona uma borda do controle.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órioFont Informa a fonte do controle.Hyperlink Informa o endereço de hyperlink para vincular ao controle.

Justification

Center Centraliza o texto do controle.Left Alinha o texto do controle à esquerda.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 Ajusta a altura do controle.

Print Condition Informa uma condição para que esse campo seja impresso, podendo ser uma operação aritmética ou comando If.

Size Ajusta a largura do controle.Title Texto que será apresentado no controle.Visible Visualiza ou não o controle no relatório. (1 verdadeiro, 0 falso).

Propriedade Descrição(Name) Nome do ControleBorder Color Informa a cor da borda do controle.


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.

Display TypeKeep Space Aceita qualquer quantidade de espaços entre

as string’s.Preformatted Assume a formatação do campo.Collapse Adiciona somente um espaço entre string’s.


Horizontal Spacing Para campos com decimal, informa o espaço que conterá entre cada caracter.

Hyperlink Informa o endereço de hyperlink para vincular ao controle.

Justification


Line Ajusta a linha onde o controle se inicia, em relação ao relatório.


Página 120



Print If Repeate Se selecionado, imprime o conteúdo do controle mesmo sendo igual ao anteriormente impresso.

Size Ajusta a largura do controle.Value Visualiza o conteúdo do controle.Value Picture Informa a pic da variável relacionada ao controle.

Value Variable Informa variável que será relacionada ao controle e que receberá o seu valor.

Visible Visualiza ou não o controle no relatório. (1 verdadeiro, 0 falso).

Propriedade Descrição(Name) Nome do ControleColor Informa a cor da barra.Column Ajusta a coluna onde o controle se inicia, em relação ao relatório.

Kind Horizontal Assume que a linha será impressa na horizontal.Vertical Assume que a linha será impressa na vertical.



Print If Repeate

Se selecionado, imprime o conteúdo do controle mesmo sendo igual ao anteriormente impresso.

Size Ajusta a largura do controle.Visible Visualiza ou não o controle no relatório. (1 verdadeiro, 0 falso).Width Largura da linha em pixel.

Propriedade Descrição(Name) Nome do Controle.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 Informa a fonte do controle.Group Valor que informa em qual grupo o radio do relatório pertence.Line Ajusta a linha onde o controle se inicia, em relação ao relatório.Lines Ajusta a altura do controle.


Size Ajusta a largura do controle.Title Texto que será apresentado no controle.Value Visualiza o conteúdo do controle.Value Picture Informa a pic da variável relacionada ao controle.



Página 121


Propriedade Descrição(Name) Nome do Controle.Color Informa a cor do texto, background e foreground.Column Ajusta a coluna onde o controle se inicia, em relação ao relatórioFont Informa a fonte do controle.Line Ajusta a linha onde o controle se inicia, em relação ao relatório.Lines Ajusta a altura do controle.


Size Ajusta a largura do controle.Title Texto que será apresentado no controle.

Value Visualiza o conteúdo do controle, podendo ser 0 para falso ou 1 para verdadeiro.



Propriedade Descrição(Name) Nome do Controle.Border Color Informa a cor da borda do controle.


Border Width Largura da borda em pixel.Color Informa a cor da borda.Column Ajusta a coluna onde o controle se inicia, em relação ao relatórioLine Ajusta a linha onde o controle se inicia, em relação ao relatório.Lines Ajusta a altura do controle.


Size Ajusta a largura do controle.Visible Visualiza ou não o controle no relatório. (1 verdadeiro, 0 falso).

Propriedade Descrição(Name) Nome do Controle.Bitmap Adiciona uma imagem ao controle, (BMP ou JPEG).

Bitmap Path

Full Path Informa todo o caminho da imagem para ser localizada.

Dynamic Full Path O caminho da imagem será localizado através da rotina “C$FULLNAME”.

User Defined A imagem será localizada no mesmo diretório que se encontra o arquivo .HTML.

Página 122


Bitmap Position

Center Alinha a imagem centralizada ao controle.

Left Top Alinha a imagem do lado esquedo e no inicio do controle.

Left Bottom Alinha a imagem do lado esquedo e no final do controle.

Right Top Alinha a imagem do lado direito e no inicio do controle.

Right Bottom Alinha a imagem do lado direito e no final do controle.

Bitmap StyleStretch A altura e a largura da imagem será modificada

conforme o tamanho do controle.

Ratio A altura e largura da imagem serão preservadas mesmo alterando o tamanho do controle.

Border Color Informa a cor da borda do controle.


Border Width Largura da borda em pixel.Color Informa a cor da borda.


Hyperlink Informa o endereço de hyperlink para vincular ao controle.Line Ajusta a linha onde o controle se inicia, em relação ao relatório.Lines Ajusta a altura do controle.


Print If Repeat Se selecionado, imprime o conteúdo do controle mesmo sendo igual ao anteriormente impresso.

Size Ajusta a largura do controle.




Auto Resize Se verdadeiro, no momento da leitura dos dados o grid reajusta o tamanho das divisões do controle.





Column Headings Trata a primeira coluna como cabeçalho.

Página 123


Column’s Setting

Configuração das seguintes propriedades, referente a cada coluna do grid.Name Cria uma variável para cada coluna.Pic Informa o tamanho de cada coluna.

Head Informa o título a ser visualizado no cabeçalho da coluna.

Width Informa a largura da coluna.

Align


More Informa outras configurações para a coluna, como fonte, cor e hyperlink.

Font Informa a fonte do controle.Heading Color Define a cor das células de cabeçalho.




Row Color Pattern Intercala cores por linha.Show Grid Line Se verdadeira visualiza todas as linhas do grid.Size Ajusta a largura do controle.Visible Visualiza ou não o controle no relatório. (1 verdadeiro, 0 falso).


Auto Resize Se verdadeiro, no momento da leitura dos dados o controle tem as divisões reajustadas.




Column Ajusta a coluna onde o controle se inicia, em relação ao relatório

Column Headings Trata a primeira coluna como cabeçalho.

Página 124


Column’s Setting

Configuração das seguintes propriedades, referente a cada variável de ocorrencia.Name Cria uma variável para cada coluna.Pic Informa o tamanho de cada coluna.

Head Informa o título a ser visualizado no cabeçalho da coluna.

Width Informa a largura da coluna.

Align


More Informa outras configurações para a coluna, como fonte, cor e hyperlink.

Font Informa a fonte do controle.Heading Color Define a cor das células de cabeçalho.




Row Color Pattern Intercala cores por linha.Show Grid Line Se verdadeira visualiza todas as linhas do occurs.Size Ajusta a largura do controle.Visible Visualiza ou não o controle no relatório. (1 verdadeiro, 0 falso).

Propriedade Descrição(Name) Nome do Controle.Border Color Informa a cor da borda do controle.




Date Format Formato de como o campo será visualizado.Date Picture Format Formato de como o campo será gravado.Font Informa a fonte do controle.Hyperlink Informa o endereço de hyperlink para vincular ao controle.

Justification



Página 125




Print If Repeat Se selecionado, imprime o conteúdo do controle mesmo sendo igual ao anteriormente impresso.

Size Ajusta a largura do controle.Time Format Formato de como o campo será visualizado.Time Picture Format Formato de como o campo será gravado.Value Picture Informa a pic da variável relacionada ao controle.




Bitmap Path

Full Path Informa todo o caminho da imagem para ser localizada.

Dynamic Full Path O caminho da imagem será localizado através da rotina “C$FULLNAME”.

User Defined A imagem será localizada no mesmo diretório que se encontra o arquivo .HTML.



Border Width Largura da borda em pixel.Cell Padding Ajusta a altura da célula.Cell Spacing Elimina linhas em branco na tabela.Color Informa a cor da borda.


Font Informa a fonte do controle.Line Ajusta a linha onde o controle se inicia, em relação ao relatório.Lines Ajusta a altura do controle.Merge Cell Aumenta ou diminui o tamanho das células da tabela


Show Grid Line Se verdadeira visualiza todas as linhas da tabela.Size Ajusta a largura do controle.Table Rearrange Formatação de quantidade de linhas e colunas

Table Setting Configurações das linhas, colunas e tipos de variáveis de cada célula.

Página 126



Propriedade Descrição(Name) Nome do Relatório.

Num Columns Utilizada somente com a propriedade Report Style = N-TOP, informa o número de colunas .

Output File Name Informa o nome físico do arquivo HTML a ser gerado.

Output File Variable Informa o nome de uma variável que receberá o nome físico do arquivo HTML a ser gerado.

Paper Size Informa o tamanho do papel, a horientação do mesmo (paisagem ou retrato) e o tamanho das margens.

Report StyleStandard Utilizada para impressão, pois controla as

quebras.

N-Top Utilizada apenas para visualização pois não controla as quebras.

Target Browser

Specify Internet Explorer Visualiza todas as propriedades adicionadas ao relatório.

Standard HTMLGera com puro HTML não assumindo determinadas propriedades.

Title Texto a ser visualizado na barra Azul quando o HTML do relatório for aberto.

Watermark Informa uma imagem para aparecer como marca d’agua.

Watermark Style

None Não assume nenhum estilo para a marca d’agua.

Center Centraliza a imagem, mais ulitizado para imagens grandes.

Tile Mostra varias vezes a mesma imagem, mais 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 HeaderPropriedade Descrição

(Name) Nome para o item Report Header.Color Cor de fundo da seção e dos controles.Font Fonte da seção.Lines Ajusta a altura da Seção.

Print Before Page Header Informa se a impressão dessa seção será antes da impressão da seção Page Header.

Print Condition Condições para que a seção seja impressa.Size Ajusta a largura da seção.

Skip Page after Print Se verdadeiro após a impressão dessa seção, será impresso uma página em branco.

Página 127


Visible Visualiza ou não a seção no relatório. (1 verdadeiro, 0 falso).

Page HeaderPropriedade Descrição

(Name) Nome para o item Page Header.Color Cor de fundo da seção e dos controles.Font Fonte da seção.Lines Ajusta a altura da Seção.Print Condition Condições para que a seção seja impressa.Size Ajusta a largura da seção.Visible Visualiza ou não a seção no relatório. (1 verdadeiro, 0 falso).

Group HeaderPropriedade Descrição

(Name) Nome para o item Group Header.Color Cor de fundo da seção e dos controles.Font Fonte da seção.Lines Ajusta a altura da Seção.Print Condition Condições para que a seção seja impressa.Size Ajusta a largura da seção.


Skip Page before Print Se verdadeiro antes da impressão dessa seção, será impresso uma página em branco.


DetailPropriedade Descrição

(Name) Nome para o item Detail.Color Cor de fundo da seção e dos controles.Font Fonte da seção.Lines Ajusta a altura da Seção.Print Condition Condições para que a seção seja impressa.Size Ajusta a largura da seção.



Zebra Alterna as cores das linhas do detalhe.

Group FooterPropriedade Descrição

Página 128


(Name) Nome para o item Group Footer.Color Cor de fundo da seção e dos controles.Font Fonte da seção.Lines Ajusta a altura da Seção.Print Condition Condições para que a seção seja impressa.Size Ajusta a largura da seção.




Page FooterPropriedade Descrição

(Name) Nome para o item Page Footer.Color Cor de fundo da seção e dos controles.Font Fonte da seção.Lines Ajusta a altura da Seção.Print Condition Condições para que a seção seja impressa.Size Ajusta a largura da seção.Visible Visualiza ou não a seção no relatório. (1 verdadeiro, 0 falso).

Report FooterPropriedade Descrição

(Name) Nome para o item Report Footer.Color Cor de fundo da seção e dos controles.Font Fonte da seção.Lines Ajusta a altura da Seção.

Print After Page Footer Informa se a impressão dessa seção será depois da impressão da seção Page Footer.

Print Condition Condições para que a seção seja impressa.Size Ajusta a largura da seção.



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


After Print 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-Check-Box, 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


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 para que o Acubench, ao gerar o programa NÃO, apague o conteúdo do parágrafo.

Parágrafos referentes à impressão e visualização:

Página 131


-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


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


Usage

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.

Value Informa um valor para o campo.Redefines Informa uma variável para redefinir.

Occurs

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.

VariableAciona a ocorrencia variável informando um valor mínimo e máximo e uma outra variável para DEPENDING ON.

Key Habilita a sintaxe KEY IS.

Available Fields Visualiza todas as variáveis que possam ser adicionadas como chave.

Key List Informa todas chaves selecionadas.

Order Informa a ordem da chave, podendo ser 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.

More

Informa atributos especiais para o campo. Aceitando os seguintes atributos:Global Habilita a sintaxe IS GLOBAL.External Habilita a sintaxe IS EXTERNAL.

Special NamesInforma que a variável será SPECIAL- NAMES, aceitando os seguintes valores: CURSOR, CRT-STATUS, CHART STATUS, SCREEN CONTROL e EVENT STATUS.

Sign Informa que a variável será SIGN IS, aceitando os seguintes valores: LEADING e TRAILING.

Syncronize Habilita a sintaxe SYNCHRONIZED, aceitando os valores LEFT e RIGHT.

Justified Right Habilita a sintaxe JUSTIFIED RIGHT.Blank when Zero Habilita a sintaxe BLANK WHEN ZERO.

Copy File Habilita somente para variável que pertence a um copy.

Convert Link to Import Inporta a variável para pertencer ao programa.

Name Visualiza o nome do arquivo de cópia.

Comment Comentário para a variável que aparecerá no arquivo de working.

B-) Funções para manipulação das variáveis pertencentes a Working: Exclui variável selecionada.

Página 134


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.

Usage

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.

Página 135


Value Informa um valor para o campo.Redefines Informa uma variável para redefinir.

Occurs

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.

VariableAciona a ocorrencia variável informando um valor mínimo e máximo e uma outra variável para DEPENDING ON.

Key Habilita a sintaxe KEY IS.

Available Fields Visualiza todas as variáveis que possam ser adicionadas como chave.

Key List Informa todas chaves selecionadas.

Order Informa a ordem da chave, podendo ser 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.

More

Informa atributos especiais para o campo. Aceitando os seguintes atributos:Global Habilita a sintaxe IS GLOBAL.External Habilita a sintaxe IS EXTERNAL.

Special NamesInforma que a variável será SPECIAL- NAMES, aceitando os seguintes valores: CURSOR, CRT-STATUS, CHART STATUS, SCREEN CONTROL e EVENT STATUS.

Sign Informa que a variável será SIGN IS, aceitando os seguintes valores: LEADING e TRAILING.

Syncronize Habilita a sintaxe SYNCHRONIZED, aceitando os valores LEFT e RIGHT.

Justified Right Habilita a sintaxe JUSTIFIED RIGHT.Blank when Zero Habilita a sintaxe BLANK WHEN ZERO.

Copy File Habilita somente para variável que pertence a um copy.

Convert Link to Import Inporta a variável para pertencer ao programa.

Name Visualiza o nome do arquivo de cópia.

Comment Comentário para a variável que aparecerá no arquivo de linkage.

B-) Funções para manipulação das variáveis pertencentes a Linkage: Exclui variável selecionada. 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


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


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.


(Name)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


Data Layout Seleciona o arquivo (Data Layout - *.dlt) criado no projeto para ser vinculado ao programa.

Key Seleciona a chave a ser utilizada pelo Data Set do programa.

Referenced Data SetCria 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

After Delete A rotina será executada logo após a execução do parágrafo Acu-nomedataset-Delete definido para o data set.

After Read A rotina será executada logo após a execução do parágrafo Acu-nomedataset-Read definido para o data set.

After Rewrite A rotina será executada logo após a execução do parágrafo Acu-nomedataset-Rewrite definido para o data set.

After Write A rotina será executada logo após a execução do parágrafo Acu-nomedataset-Write definido para o data set.

Before Delete A rotina será executada antes da execução do parágrafo Acu-nomedataset-Delete definido para o data set.

Before Read A rotina será executada antes da execução do parágrafo Acu-nomedataset-Read definido para o data set.

Before Rewrite A rotina será executada antes da execução do parágrafo Acu-nomedataset-Rewrite definido para o data set.

Before Write A rotina será executada antes da execução do parágrafo Acu-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 DescriçãoNew Data Set Cria um Data Set para o programa.Undo Desfaz a última ação.Redo Refaz a última ação desfeita.Cut Recorta o Data Set selecionado.Copy Copia o Data Set selecionado.Past Cola o Data Set selecionado.Delete Exclui o Data Set selecionado.Select All Seleciona todos os Data Set’s.

Referenced FD/SL Files Define a forma de abertura dos arquivos de cada Data Set e os parágrafos que serão gerados referentes a ele.

Find in Objects Localiza uma palavra nos Data Set’s.Página 139


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


Clicar com o botão direito sobre o nome do programa (Workspace aberta, aba 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


- Executar o programa.Clicar com o botão direito sobre o nome do programa (Workspace aberta, aba

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


Capitulo XVI – Passo a Passo no Acubench

Um resumo de como criar Projetos, Arquivos e Programas no Acubench.

Criando o ProjetoNo menu principal, selecionar FILE NEW, abrirá janela com opções, selecionar a

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/SLCom 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


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


Criando o Programa.Com o Workspace aberto, selecionar a aba StructureClicar 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


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


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


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


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-Master-Print-Loop.

Página 149


Obs.: Não esquecer de colocar a rotina após a tag para que o Acubench, ao gerar o programa NÃO, apague o conteúdo do parágrafo.

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 - carlospiergentile.files.wordpress.com · criação e manutenção de aplicações cobol...

Documents