Saltar para o conteúdo principal
Versão: Próximo

QR GET HEADER AND FOOTER

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

ParâmetroTipoDescrição
areaIntegerReferência da área
seletorInteger1= Cabeçalho, 2 = Rodapé
tituloEsqTextTítulo mostrado à esquerda
tituloCentroTextTexto mostrado ao centro
tituloDirTextTexto exibido à direita
altoIntegerAltura do cabeçalho ou rodapé
imagemPictureImagem a exibir
alinImagIntegerAlinhamento atribuído para a Imagem

Esse comando não é seguro para thread e não pode ser usado em código adequado.

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

Ver também

QR SET HEADER AND FOOTER