Auxílios do VisualAge Generator


Editor de Composição Visual

O ambiente de desenvolvimento integrado do VisualAge Generator permite a criação de interfaces gráficas com o usuário que podem ser conectadas à partes lógicas e de dados do VAGen. Você pode selecionar uma parte do VAGen a partir da paleta Editor de Composição, soltá-la na superfície de formato livre e editá-la ou conectá-la a uma parte visual para criar uma GUIcliente. Você também pode criar scripts que podem ser usados para acessar GUIclientes e Enterprise JavaBeans de dentro das funções 4GL.

A paleta partes , que encontra-se à esquerda do Editor de Composição Visual, contém o conjunto de partes prontas utilizadas com mais freqüência. A paleta organiza as partes em categorias.

A área de status na parte inferior do Editor de Composição Visual indica a categoria e o bean atualmente selecionados na paleta ou a parte ou conexão atualmente selecionada na superfície de formato livre.


Categoria parte do VAGen

Parte de Registro do VAGen

Selecionar
Registro VAGen
, o Parte de Registro do VAGen, para incluir um registro VAGen a uma superfície de formulário livre.

Parte:
Parte de Registro do VAGen  
registro

Nome de Classe:
HptRecordPart

A interface pública da parte, composta por seus atributos, eventos e ações, aparece no menu Conectar, que fica disponível a partir do menu pop-up da parte. Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

Você pode separar os itens de dados para acessar diretamente seus dados e interfaces públicas.

Você pode separar os seguintes itens e utilizá-los como partes individuais para acessar diretamente seus dados:

Parte de Tabela do VAGen

Selecione a Parte de Tabela do VAGen para incluir tabelas VAGen para superfícies de formulário livre.

Parte:
Parte de Tabela do VAGen  
Parte de Tabela do VAGen

Nome de Classe:
HptTablePart

A interface pública da parte, composta por seus atributos, eventos e ações, aparece no menu Conectar, que fica disponível a partir do menu pop-up da parte. Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

Todos os itens de dados dentro de uma tabela são considerados parte de um item occurs. O atributo de colunas da tabela representa este item occurs. Quando você separa o atributo de colunas da tabela, você pode acessar diretamente os dados e a interface pública dos itens de dados.

Você pode separar os seguintes itens e utilizá-los como partes individuais para acessar diretamente seus dados:

Parte de Programa do VAGen

Selecione a Parte de Programa do VAGen para incluir uma Parte de Programa do VAGen na superfície de formato livre.

Parte:
Parte de Programa do VAGen  
Parte de Programa do VAGen

Nome de Classe:
HptProgramPart

A interface pública da parte, composta por seus atributos, eventos e ações, aparece no menu Conectar, que fica disponível a partir do menu pop-up da parte. Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

Para uma definição mais ampla da função de uma parte não-visual, dê um clique duplo sobre a mesma para abrir a janela de exibição de definições da parte. A janela Parte de Programa do VAGen é exibida.

O VisualAge Generator extende partes não-visuais com a separação VAGen commSession. Consulte a ajuda para a parte Sessão de Comunicação do VAGen para mais informações.

Parte de Programa do VAGenPropriedades

Parte de Programa do VAGenResultado

Nome de Classe:
HptProgramResult

Para utilizar esta parte, solte uma Parte de Programa do VAGen na superfície de formato livre depois separe o lastResult.

O atributo lastResult da Parte de Programa do VAGen representa um objeto do tipo HptCallableFunctionResult e é o resultado da última chamada a esta Parte de Programa do VAGen.

A interface pública da parte, composta por seus atributos, eventos e ações, aparece no menu Conectar, que fica disponível a partir do menu pop-up da parte. Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

Para uma definição mais ampla da função de uma parte não-visual, dê um clique duplo sobre a mesma para abrir a janela de exibição de definições da parte. A janela Propriedades de Resultado Parte de Programa do VAGen é exibida.

Parte de Programa do VAGen linkageInfo

Nome de Classe:
HptCallLinkageInformation

Para utilizar esta parte, solte uma Parte de Programa do VAGen na superfície de formato livre, depois separe o linkageInfo.

O atributo linkageInfo da Parte de Programa do VAGen representa um objeto do tipo HptCallLinkageInformation que contém as informações de ligação necessárias para fazer uma chamada para outra função do programa.

A interface pública da parte, composta por seus atributos, eventos e ações, aparece no menu Conectar, que fica disponível a partir do menu pop-up da parte. Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

Para uma definição mais ampla da função de uma parte não-visual, dê um clique duplo sobre a mesma para abrir a janela de exibição de definições da parte. A janela Propriedades de linkageInfo Parte de Programa do VAGen é exibida.

Parte de Função do VAGen

Selecione a Parte de Função do VAGen para incluir uma função VAGen para superfícies de formulário livre.

Parte:
Parte de Função do VAGen  
Parte de Função do VAGen

Nome de Classe:
HptFunctionPart

A interface pública da parte, composta por seus atributos, eventos e ações, aparece no menu Conectar, que fica disponível a partir do menu pop-up da parte. Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

VAGenCommSessionPart

Nome de Classe:
CmSession

O atributo VAGen CommSession é um atributo somente para leitura que é inicializado para uma parte Sessão de Comunicação VAGen quando a primeira chamada para um servidor VAGen é emitida através da Parte de Programa do VAGen ou a partir de uma instrução CALL do VAGen em uma Função.

Se VAGen inheritsCommSession estiver definido como true, VAGen commSession só será definido se o pai da parte for nil e o atributo VAGen commSessionOwner for nil. No caso em que eles não são nil, primeiro o VAGen commSessionOwner é verificado para a sessão e se for nil, o pai é verificado. Se ambos forem nulos, o atributo VAGen commSession será definido para uma nova instância da parte Sessão de Comunicações.

A finalidade da parte Sessão de Comunicações do VAGen é controlar as Unidades Lógicas de Trabalho (LUWs) em casos onde as chamadas ao servidor foram feitas com a opção cliente da unidade de trabalho.

O atributo VAGen commSession pode ser separado e utilizado visualmente ou pode ser acessado através do código do Smalltalk.

A interface pública da parte, composta por seus atributos, eventos e ações aparece no menu Conectar, que fica disponível a partir do menu pop-up da parte. Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

O dois atributos associados com a parte Sessão de Comunicações do VAGen são o VAGen inheritsCommSession e o VAGen commSessionOwner.

O VAGen inheritsCommSession é um atributo booleano que controla a procura de uma instância de uma parte Sessão de Comunicações do VAGen quando uma chamada a um servidor do VAGen está sendo emitida. Se definido como true, o VAGen commSessionOwner é verificado primeiro. Se o VAGen commSessionOwner estiver definido como nil, o pai é verificado. Se o atributo VAGen inheritsCommSession for false, a parte atual irá retornar a sessão que está armazenada no VAGen commSession.

O VAGen commSessionOwner é um atributo que pode ser definido para qualquer instância de uma subclasse de AbtAppBldrNonVisual. O VAGen commSessionOwner é utilizado em uma hierarquia de partes para controlar quais partes realmente possuem o atributo VAGen commSession definido para uma instância de uma parte Sessão de Comunicações do VAGen. Se VAGen commSessionOwner estiver definido e VAGen inheritsCommSession estiver definido como true, o objeto da sessão será procurado naquela parte.

Detalhes do Repositório VAGen

Selecione a parte Detalhes do Container VAGen para incluir uma parte Gerador do VisualAge que exibe dados como colunas de dados com cada item ocupando uma linha.

Parte:
Detalhes do Repositório VAGen  
cdll

Nome de Classe:
HptContainerDetailsView

Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

Para uma definição mais ampla sobre a aparência e função de uma parte visual, dê um clique duplo sobre a mesma para abrir a janela de exibição de definições da parte. A janela Detalhes do Container VAGen aparece.

Diferenças entre Detalhes do Container e Detalhes do Container VAGen

Os Detalhes do Container VAGen fornecem o suporte de empacotamento que é fornecido na parte Detalhes do Container de Empacotamento. O suporte de pacote permite a recuperação de linhas individuais em pacotes conforme solicitadas pela parte Detalhes do Container VAGen ao invés de ter todas as linhas recuperadas de uma vez. Além do suporte de pacote, os Detalhes do Container VAGen também fornecem alguns outros recursos úteis como os eventos #cellValueChanged e #userInputConvertError.

Os Detalhes do Container VAGen herdam dos Detalhes do Container, sendo assim, eles possuem todos os recursos fornecidos pelo Detalhes do Container. Adicionalmente, ele possui os seguintes recursos:

Variável VAGen

Selecione a parte Variável VAGen para permitir que sua aplicação trabalhe com uma parte que é criada no runtime. Uma variável é um marcador de lugar da parte em si, muito semelhante a um parâmetro em uma linguagem de programação comum.

Quando você acrescenta uma variável na superfície de formato livre, você especifica sua classe e conecta a variável para que, no runtime, ela receba sua identidade de uma parte que esteja em outro lugar em sua aplicação. No runtime, uma parte daquela classe ocupa o lugar da variável.

Por exemplo, você poderia acrescentar uma variável em sua aplicação que contém instâncias de Coleção Ordenada. No runtime, com as conexões apropriadas, a coleção ordenada e seu conteúdo poderiam ser fornecidos por uma fonte externa como um arquivo.

Parte:
Variável VAGen  
Variável VAGen

Nome de Classe:
HptVariable

Você pode acrescentar uma Variável VAGen utilizando a paleta ou selecionando Incluir parte do menu pull-down Opções. Se você inclui uma Variável VAGen utilizando a paleta, a classe padrão é objeto. No entanto, se você inclui uma Variável VAGen utilizando a janela Incluir Parte, você pode escolher que tipo de classe deseja que a variável represente. Você pode alterar a classe da variável depois dela ter sido incluída na superfície de formato livre utilizando o menu pop-up da Variável VAGen.

Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

Diferenças entre Variável VAGen e Variável

A Variável VAGen é destinada a ser usada com outras partes VAGen. Há duas diferenças principais entre a Variável VAGen e a Variável.

  1. Quando um atributo de uma Variável VAGen é conectado ao atributo de outra parte ou ao parâmetro de uma conexão, a Variável VAGen executa a conversão apropriada de seu atributo para o tipo esperado na outra extremidade da conexão.

    Se, por exemplo, você tem uma Variável VAGen que contém um item de dados Num VAGen e você conecta o atributo #data da variável ao #enabled de um botão de comando, a Variável VAGen converte o valor de seu atributo #data de um inteiro ou número em booleano conforme o esperado pelo #enabled para que o alinhamento da conexão seja bem sucedido. Quando você utiliza uma Variável do VisualAge for Smalltalk ao invés de uma Variável VAGen, este alinhamento causará um walkback. Devido a esta conversão automática, recomenda-se que você utilize uma Variável VAGen quando o valor que ela possui for uma parte Dados VAGen ou relacionado a uma parte Dados VAGen. Quando você separa um atributo de uma parte Dados VAGen, uma Variável VAGen é utilizada automaticamente.

  2. Como as partes VAGen não são classes do Smalltalk, não é possível alterar o tipo de uma Variável do VisualAge for Smalltalk para que uma parte VAGen tenha os recursos apropriados listados na hora da edição. Assim, a Variável VAGen tem a opção Alterar Tipo VAGen ao invés de Alterar Tipo para partes Variável do VisualAge for Smalltalk. Alterar Tipo VAGen permite a você especificar, na hora da edição, a parte VAGen que a Variável VAGen irá reter no runtime e isto permite que a parte Variável VAGen mostre todos os recursos que estão disponíveis para aquela parte VAGen.

    Lembre-se que as Variáveis VAGen são marcadores de lugar de outras partes, muito semelhantes ao parâmetros nas linguagens de programação 3GL. Assim, você deve conectar o atributo self da Variável VAGen para identificar a identidade da parte que a Variável VAGen irá receber no runtime.

    A seleção de Alterar Tipo VAGen não é suficiente para identificar a identidade da parte que a Variável VAGen irá receber. Este processo aplica-se apenas à definição da GUI para tornar mais fácil o estabelecimento de conexões aos recursos de uma Variável VAGen.

A Variável VAGen herda da Variável, sendo assim, ela possui os mesmos recursos que a Variável, exceto aqueles acima documentados.

Acessador de Arquivo VAGen

Parte:
Acessador de Arquivo VAGen  
Acessador de Arquivo VAGen

Nome de Classe:
HptFilePart

Utilize a parte Acessador de Arquivo para permitir que os programas manipulem os arquivos de texto. Com esta parte, os programas podem ler arquivos de texto, exibir seu conteúdo em um um controle apto para cadeia, trabalhar com a cadeia de arquivos em si ou salvar a cadeia em qualquer arquivo e chamar o diálogo Arquivo.

A interface pública da parte, composta por seus atributos, eventos e ações, aparece no menu Conectar, que fica disponível a partir do menu pop-up da parte. Para exibir o menu pop-up da parte, clique com o botão 2 do mouse sobre a parte.

Para uma definição mais ampla da função de uma parte não-visual, dê um clique duplo sobre a mesma para abrir a janela de exibição de definições da parte. A janela Propriedades do Acessador de Arquivo VAGen aparece.

Fábrica de Objeto Habilitada para IC VAGen

Selecione a parte Fábrica de Objeto Habilitada para IC VAGen para incluir uma parte que cria instâncias de outra parte.

Utilize a ação nova para criar instâncias. Utilize a exibição de definições para especificar a classe que é instanciada quando a nova ação é executada.

Se você pretende empacotar suas partes utilizando componentes de imagem (IC), você deve utilizar a parte Fábrica de Objetos Habilitada para IC VAGen ao invés da parte Fábrica de Objetos do Smalltalk VisualAge. Caso você já tenha usado a parte Fábrica de Objetos, você ainda pode habilitar sua aplicação para o empacotamento de IC selecionando Habilitar para o Empacotamento IC VAGen a partir da janela Organizador.

Wrapper da Parte Habilitada para IC VAGen

Utilize o Wrapper da Parte Habilitada para IC VAGen para criar um marcador de lugar para uma janela. Por exemplo, se você define uma janela secundária de uma aplicação em uma exibição separada, você pode tê-la representada na superfície de formato livre para que as conexões possam ser feitas a partir da exibição que você está definindo no momento sem que seja necessário incluir uma instância completa daquela exibição.

Se você pretende empacotar suas partes utilizando componentes de imagem (IC), você deve utilizar a parte Wrapper da Parte Habilitada para IC VAGen ao invés da parte Wrapper da Exibição do Smalltalk VisualAge. Caso você já tenha usado a parte Wrapper da Exibição, você ainda pode habilitar sua aplicação para o empacotamento de IC selecionando Habilitar para o Empacotamento IC VAGen a partir da janela Organizador.

Variável Habilitada para IC VAGen

Selecione a parte Variável Habilitada para IC VAGen para habilitar sua aplicação para trabalhar com uma parte que é criada no runtime. Uma variável é um marcador de lugar da parte em si, muito semelhante a um parâmetro em outras linguagens de programação.

Quando você acrescenta uma variável na superfície de formato livre, você especifica sua classe e conecta a variável para que, no runtime, ela receba sua identidade de uma parte que esteja em outro lugar em sua aplicação. No runtime, uma parte daquela classe ocupa o lugar da variável.

Se você pretende empacotar suas partes utilizando componentes de imagem (IC), você deve utilizar a parte Variável Habilitada para IC VAGen ao invés da parte Variável do Smalltalk VisualAge. Caso você já tenha usado a parte Variável, você ainda pode habilitar sua aplicação para o empacotamento de IC selecionando Habilitar para o Empacotamento IC VAGen a partir da janela Organizador.


[ Início da Página | Página Anterior | Próxima Página | Índice ]