4D Doc Center : QR GET HEADER AND FOOTER

4D v14.3

QR GET HEADER AND FOOTER


QR GET HEADER AND FOOTER ( area ; seletor ; tituloEsq ; tituloCentro ; tituloDir ; alto {; imagem {; alinImag}} )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Referência da área
seletor	Inteiro longo	1= Cabeçalho, 2 = Rodapé
tituloEsq	cadeia	Título mostrado à esquerda
tituloCentro	cadeia	Texto mostrado ao centro
tituloDir	cadeia	Texto exibido à direita
alto	Inteiro longo	Altura do cabeçalho ou rodapé
imagem	Imagem	Imagem a exibir
alinImag	Inteiro longo	Alinhamento atribuído para a Imagem

Descrição

O comando QR GET HEADER AND FOOTER permite recuperar o conteúdo e o tamanho do cabeçalho ou rodapé de página.

seletor lhe permite selecionar o cabeçalho ou o rodapé de página:

* se seletor for igual a 1, a informação do cabeçalho se recuperará;
* se seletor for igual a 2, a informação do rodapé se recuperará.

tituloEsq, tituloCentro e tituloDir devolvem os valores para os cabeçalhos/rodapé esquerdo, centro e direita, respectivamente.

altura devolve a altura do cabeçalho/rodapé, expressa na unidade selecionada para o relatório.

imagem devolve uma imagem que se mostra no cabeçalho ou rodapé de página.

alinImag é o atributo de alienação para a imagem mostrada no cabeçalho/rodapé de página

    * Se alinImag devolve 1, a imagem se alinha a esquerda.
    * Se alinImag devolve 2, a imagem se centra.
    * Se alinImag devolve 3, a imagem se alinha a direita.

Se passa um número de area inválido, se gera o erro -9850.
Se o parâmetro seletor for incorreto, se gera o erro -9852.

Exemplo

O código a seguir recupera o conteúdo e a altura do título do cabeçalho e os mostra como alertas:

 QR GET HEADER AND FOOTER(MinhaArea;1;$textEsq;$textCent;$texDir;$altura)

 Case of

    :($textEsq#"")

       ALERT("O título à esquerda é "+Char(34)+$textIzq+Char(34))

    :($textCent#"")

       ALERT("O título do centro é "+Char(34)+$textCent+Char(34))

    :($texDer#"")

       ALERT("O título da direita é "+Char(34)+$texDer+Char(34))

    Else

       ALERT("Não há título de cabeçalho neste relatório.")

 End case

 ALERT("A altura do cabeçalho é "+String($altura))