Memorando
Controle utilizado para listar dados de tabela, textos digitados na propriedade linha, ou através de regra no evento na impressão, o qual atribui um valor alfanumérico para este controle.
A impressão do campo memorando está diretamente relacionada com o tamanho que foi atribuído no modelo do gerador. Não executa quebras de linhas controladas ex. 80 colunas / 5 linhas.
Se não houver tabela ou campo associado então imprimirá o que foi digitado na propriedade Linhas.
Observação:
O controle memorando não faz quebra de página, caso o texto exceda o tamanho limite da página, será exibida uma mensagem informado que a Seção ultrapassou o tamanho limite, impedindo a execução do relatório. Para contornar a situação pode-se aumentar o tamanho da página, diminuir o tamanho da fonte ou usar o modo Justificado.
Propriedades:
Nome
O nome do Controle deve ser único no sistema. Disponível: Gráfico.
Imprimir
Imprimir ou não o controle. Disponível: Gráfico.
Cor da Fonte
Selecionar uma cor para o texto do controle.
Fonte
Selecionar um tipo de letra para o controle. Disponível: Gráfico.
Tipo do Caractere
Configurar o tipo do Caracter, disponíveis 4 opções:
- Herdar: define a mesma configuração do componente pai;
- Normal: não altera nada;
- Maiúsculas;
- Minúsculas.
Letra Padrão
Permite voltar a usar o padrão de letra da seção, caso já tenha sido alterado no Controle. Disponível:Gráfico.
Cor Padrão
Permite voltar a usar o padrão de cor da seção, caso já tenha sido alterado no controle. Disponível:Gráfico.
Linha
Linha onde o Controle está posicionado. Esta linha está vinculada a unidade atual. O valor definido no caso de modelos gráficos é em milímetros e no texto é em caracteres. Disponível:Gráfico.
Coluna
Coluna onde o controle está posicionado. Nos modelos gráficos corresponde a milímetros e nos modelos texto a caracteres. Disponível:Gráfico.
Tabela Cadastro
Tabela na qual está cadastrado o campo. Disponível: Gráfico.
Nome Campo
Nome do campo da tabela. Disponível: Gráfico.
Linhas
Texto digitado para a impressão. Disponível: Gráfico.
Quebra de Linhas
Determina se a quebra de linhas deve ser automática. Disponível: Gráfico.
Tamanho Máximo
Tamanho máximo de letras que devem ser digitadas. Disponível: Gráfico.
Nota
A limitação do texto é realizada quando é definida via regra LSP e pela propriedade Linhas.
Indica se o controle deve aumentar o seu tamanho para que o texto seja completamente apresentado na impressão do relatório. O controle aumenta até o limite da página ou até que a quantidade de caracteres apresentados seja igual a quantidade informada na propriedade Tamanho Máximo. O texto que não puder ser apresentado até o limite da página será ignorado. Se o controle não puder ser impresso no espaço restante da página, uma quebra de página é realizada automaticamente pelo gerador.
Observação:
Esta
propriedade não terá efeito quando o controle estiver dentro de uma
seção "Rodapé-Cabeçalho". No caso será sempre Falso.
Exportação:
Indica qual o escopo da seção com relação às exportações de dados;
Justificado
Indica o modo como o texto exibido no controle será justificado. Maiores detalhes no item Justificando o Texto;
Eventos
Na Impressão
Para listar um texto é necessário ter uma regra no evento na impressão deste controle memorando.
ValStr = "Testando escrita de texto!! Este texto que será impresso no memorando pode se exceder a uma linha, pois se o texto exceder a uma linha, uma nova linha será aberta, ou quantas forem necessárias para que o restante da descrição atribuída a este campo seja listado"; /*Atrib. do conteúdo alfanumérico */
Cancel(2); /* Cancela a regra e lista o conteúdo na descrição atrib. p/ ValStr */
Observação
Todas as variáveis alfanuméricas utilizadas em uma regra deve estar definida como alfa em sua regra, independentemente se esta variável já foi definida em outra regra como alfa.
Justificando o texto
Para justificar o texto do controle Memorando, é necessário usar a propriedade Justificado. Esta propriedade pode receber três valores distintos:
- Nenhum: o valor padrão Nenhum indica que o texto será apresentado na sua forma original;
- Modo 1: Indica que o Modo Justificado 1 será usado no texto do controle;
- Modo 2: Indica que será usado o Modo Justificado 2.
Para a explicação do Modo Justificado, considere o seguinte texto exemplo:
Este é um início de parágrafo,
portanto deve respeitar o espaço inicial, após a vírgula não foi apertado
enter, portanto ao justicar pode juntar estas duas linhas. Em seguida
temos os seguintes tópicos:
1-primeiro;
2-segundo;
3-terceiro;
Outro parágrafo inicial aqui, tem
espaços que pode remover não
foi apertado enter, então pode juntar.
O texto original acima seria apresentado da mesma maneira se fosse usado num controle Memorando com a propriedade Justificado indicando Nenhum.
Modo Justificado 1
Este modo indica ao Gerador que todas as quebras de linhas e espaços serão suprimidos do texto original do controle. Este modo economiza mais linhas, porém altera a formatação do texto, podendo inclusive alterar o seu significado. O texto acima seria apresentado da seguinte maneira no Modo 1:
Este é um início de parágrafo, portanto deve respeitar o espaço inicial, após a vírgula não foi apertado enter, portanto ao justicar pode juntar estas duas linhas. Em seguida temos os seguintes tópicos: 1-primeiro; 2-segundo; 3-terceiro; Outro parágrafo inicial aqui, tem espaços que pode remover não foi apertado enter, então pode juntar.
Este modo assume implícitamente as propriedades Tamanho Automático e Quebra Linhas como Verdadeiro. Ou seja, o controle Memorando sempre terá seu tamanho configurado e as quebras de linhas serão geradas automaticamente quando a propriedade Justificado for Modo 1.
O modo justificado 2 permite que o texto seja alinhado à esquerda e à direita considerando as quebras de linhas e espaços iniciais. Os espaços intermediários são ignorados e transformados em um único. Este modo assemelha-se ao texto justificado de editores de texto. Como exemplo, o texto apresentado anteriormente é justificado no modo 2:
Este é um início de parágrafo,
portanto deve respeitar o espaço inicial, após a vírgula não foi apertado
enter, portanto ao justicar pode juntar estas duas linhas. Em seguida
temos os seguintes tópicos:
1-primeiro;
2-segundo;
3-terceiro;
Outro parágrafo inicial aqui, tem
espaços que pode remover não foi apertado enter, então pode juntar.
Neste modo somente assume-se como Verdadeiro o valor da propriedade Quebra Linhas. A propriedade Tamanho Automático tem o seu valor considerado quando o controle for Justificado. Ou seja, pode-se usar o Modo Justificado 2 sem que o controle Memorando tenha o seu tamanho ajustado automaticamente.
Observação
Devido as limitações do HTML, os campos do tipo memo justificados na WEB podem funcionar de forma diferente do Windows. Ideal que a opção esteja como nenhuma para esse tipo de visualização.
Função AlteraControle
A função AlteraControle continua
funcionando com a propriedade Justificado e seus novos valores. Para obter
mais informações sobre a função AlteraControle,
vá para AlteraControle.
Usando a função AlteraControle,
a propriedade Justificado do controle
Memorando pode receber os seguintes
valores:
- Nenhum: indicando que nenhum modo justificado será usado;
- Modo 1: indicando que o modo justificado 1 será usado;
- Modo 2: indicando que o modo justificado 2 será usado;
- Verdadeiro: por compatibilidade, é o mesmo que informar Modo 1;
- Falso: por compatibilidade, é o mesmo que informar Nenhum.
Os valores Verdadeiro e Falso são aceitos normalmente para permitir que modelos em versões anteriores continuem funcionamento adequadamente.
Alinhamento de Valores em Tempo de Desenho
Em tempo de desenho, a propriedade Justificado não tem efeito. Ou seja, durante a edição do modelo o texto do controle Memorando não é ajustado conforme a propriedade Justificado.
Se o texto do controle Memorando for informado durante a edição do modelo, é importante verificar a propriedade QuebrasLinhas. Esta propriedade faz com que o texto seja quebrado em linhas conforme o comprimento máximo do controle em quantidade de caracteres. Ao contrário da propriedade Justificado, Quebras Linhas tem efeito durante a edição do modelo. Isto quer dizer que se ela estiver configurada para Verdadeiro e o texto sendo editado contiver mais caracteres do que o comprimento do controle puder mostrar, as linhas serão quebradas automaticamente.
A observação vale quando um dos Modos Justificados é usado no controle Memorando. Se a propriedade Quebras Linhas estiver configurada como Verdadeiro e a propriedade Justificado estiver como Modo 2, o alinhamento do texto não ocorre conforme descrito acima. Isto acontece porque, em tempo de desenho do modelo, o texto do controle é quebrado para ser menor do que o comprimento do controle. E o Modo Justificado 2 apenas alinha o texto que for maior do que este comprimento.
Portanto, quando o texto for informado em tempo de desenho do modelo e deseja-se usar o Modo Justificado 2, a propriedade QuebrasLinhas deve ser configurada para Falso.