Amostra de conjunto de subformulários

A amostra de Conjunto de subformulários demonstra o comportamento de um formulário PDF dinâmico. Quatro amostras demonstram o comportamento de instanciação do objeto Conjunto de subformulários de acordo com as relações variadas do tipo de subformulário e dos valores de ocorrência. O formulário de amostra contém notas numeradas representadas como círculos pretos com números brancos. As observações são explicadas em Sobre a saída do Conjunto de subformulários.

A amostra inclui estes arquivos:

Arquivo

Descrição

SubformSet1.xdp

SubformSet2.xdp

SubformSet3.xdp

SubformSet4.xdp

O arquivo de formulário do Designer localizado na pasta Formulários

DataA.xml

DataB.xml

Arquivos de dados XML, localizados na pasta Dados

SubformSet1 DataA.pdf

SubformSet1 DataB.pdf

SubformSet2 DataA.pdf

SubformSet2 DataB.pdf

SubformSet3 DataA.pdf

SubformSet3 DataB.pdf

SubformSet4 DataA.pdf

SubformSet4 DataB.pdf

Formulários renderizados com dados unidos, localizados na pasta Saídas

Para executar a amostra de Conjunto de subformulários

  1. Abra um dos formulários na pasta Forms, localizada em \PT\Samples\Forms\SubformSet, no Designer.

  2. Selecione Arquivo > Propriedades do formulário para especificar as opções de visualização.

  3. Clique na guia Visualizar e execute as seguintes tarefas:

    • Na lista Tipo de visualização, selecione Formulário impresso (nos dois lados).

    • Na caixa Arquivo de dados, navegue até a pasta Dados e selecione um dos arquivos de dados de amostra (por exemplo, DataA.xml).

    • Clique em OK.

  4. Para visualizar o formulário, clique na guia Visualizar PDF.

A amostra de arquivo PDF de saída na pasta Saídas mostra o formulário renderizado, unido a cada um dos dois conjuntos de dados. Use esses arquivos para comparar os resultados do formulário visualizado.

    Sobre a saída do Conjunto de subformulários

    Esses comentários numerados correspondem aos círculos pretos numerados na amostra de formulário de Conjunto de subformulários.

    1. Dados
    Duas amostras de arquivos de dados estão disponíveis para esta amostra. Essa seção fornece o nome do arquivo de dados unido ao formulário, juntamente com o conteúdo do arquivo de dados. Essas informações são úteis para comparar os dados exibidos na seção 3, “Relacionamento dos subformulários”.

    2. Ocorrência de subformulários
    Cada formulário contém três subformulários. Essa seção fornece valores de ocorrência máxima e contagem mínima dos subformulários. Os valores de ocorrência são especificados na guia Vínculo da paleta Objeto.

    Especificações de subformulários por formulário

    Formulário

    subformA

    subformB

    subformC

    SubformSet1.xdp

    Contagem mín. = 0 Máx. =-1*

    Contagem mín. = 0 Máx. =-1*

    Contagem mín. = 0 Máx. =-1*

    SubformSet2.xdp

    Contagem mín. = 0 Máx. = 1

    Contagem mín. = 0 Máx. = 1

    Contagem mín. = 0 Máx. = 1

    SubformSet3.xdp

    Contagem mín. = 1 Máx. = 1

    Contagem mín. = 1 Máx. = 1

    Contagem mín. = 1 Máx. = 1

    SubformSet4.xdp

    Contagem mín. = 2 Máx. = 2

    Contagem mín. = 1 Máx. = 1

    Contagem mín. = 3 Máx. = 3

    * O valor máximo é ilimitado quando a opção Repetir o subformulário para cada item de dados na guia Vínculo da paleta Objeto está selecionada.

    3. Relacionamento de subformulários
    A terceira seção contém três colunas usadas para comparar o layout dos subformulários em tipos diferentes de relacionamentos:

    Coluna

    Tipo

    Comentários

    1

    Usar todos os subformulários na ordem

    Os subformulários são instanciados na ordem em que estão declarados no formulário. Isso pode fazer com que o conteúdo seja reorganizado para corresponder à ordem do formulário.

    2

    Selecionar um subformulário das alternativas

    Os subformulários são exclusivos, e apenas um subformulário pode ser instanciado. A determinação de qual subformulário deve ser instanciado e baseada nos dados.