Formatando texto e importando HTML

Artigo
10/18/2010

Uma caixa de texto pode ser um item de relatório ou uma célula individual dentro de uma região de dados que contém texto, um campo calculado, um ponteiro para um campo em um banco de dados ou uma combinação desses itens. Você pode misturar fontes e cores, adicionar estilos em negrito e itálico e usar estilos de parágrafo, como alinhamento e recuos deslocados. Você pode formatar uma caixa de texto inteira ou formatar texto, números, expressões ou campos específicos dentro da caixa de texto.

Estilo de fonte, tamanho, cor e efeitos, tudo contribui para a legibilidade de um relatório. Fonte, estilo de fonte, tamanho da fonte e efeitos de sublinhados podem ser aplicados ao texto dentro de uma caixa de texto ou região de dados. Por padrão, a fonte de relatório usada é Arial, 10 pontos e preto. Usando a caixa de diálogo Propriedades de Texto, é possível especificar como o texto será exibido quando o relatório for renderizado.

Quando uma expressão simples ou complexa é definida dentro de uma caixa de texto, a representação da interface do usuário resultante dessa expressão é conhecida como um espaço reservado. Você pode definir cores, fontes, ações e outro comportamento em qualquer número de espaços reservados ou seções de texto dentro de uma única caixa de texto.

Criando texto de espaço reservado em uma caixa de texto

O valor de um espaço reservado é sempre uma expressão simples ou complexa. Você pode adicionar um espaço reservado a uma caixa de texto criando uma expressão que usa um dos seguintes métodos:

Arraste um campo do painel Dados do Relatório e solte-o dentro da caixa de texto. Se você arrastar a expressão em qualquer outro lugar no corpo de relatório, uma nova caixa de texto será criada contendo o espaço reservado. O valor desse espaço reservado será a expressão de campo correspondente ao campo que foi solto.
Clique com o botão direito do mouse em qualquer lugar na caixa de texto e selecione Criar Espaço Reservado. Na caixa de diálogo Propriedades do Espaço Reservado, é possível especificar uma expressão como o valor do espaço reservado. Para obter mais informações, consulte Caixa de diálogo Propriedades do Espaço Reservado, Geral.
Digite qualquer expressão simples ou complexa na caixa de texto. Por exemplo, se você digitar Nome: [Nome] na caixa de texto, o texto [Nome] será exibido como um espaço reservado que representa a expressão =Fields!Name.Value. Para obter mais informações sobre o suporte aos tipos de texto de exibição para expressões, consulte Compreendendo expressões simples e complexas (Reporting Services).
Digite uma expressão em uma caixa de texto vazia iniciando com um sinal de igual (=). Quando o foco mudar para fora a caixa de texto, a expressão resultante será convertida em um espaço reservado que pode ser editado. Se a caixa de texto não estiver vazia, ou o sinal de igualdade for inserido em um lugar diferente do primeiro caractere na caixa de texto, o sinal de igualdade será tratado como um literal de cadeia de caracteres e não será criado um espaço reservado. Para obter mais informações sobre como definir expressões simples e complexas, consulte Usando expressões (Reporting Services).

Formatando espaços reservados e texto estático em uma caixa de texto

É possível formatar espaços reservados usando a caixa de diálogo Propriedades do Espaço Reservado. Você pode formatar somente o espaço reservado inteiro, e não seções dele. Para ver a expressão subjacente, passe o mouse sobre o espaço reservado. Para alterar a expressão subjacente, clique duas vezes ou clique com o botão direito no espaço reservado e selecione Propriedades do Espaço Reservado. Também é possível especificar um rótulo da interface do usuário na propriedade Rótulo, na guia Geral da caixa de diálogo Propriedades do Espaço Reservado. Esse será o texto mostrado no tempo de design do espaço reservado.

Diferentemente do texto do espaço reservado, você pode alinhar um texto individual em uma caixa de texto separadamente, usar vários parágrafos em uma única caixa de texto e definir outro comportamento para qualquer subconjunto de texto.

É possível definir cores, fontes, ações e outro comportamento em qualquer subconjunto de texto dentro de uma única caixa de texto para criar uma mala direta ou um modelo de texto no seu relatório. Também é possível usar vários parágrafos dentro de uma única caixa de texto. Por exemplo, se houver dois parágrafos diferentes de texto, é possível separá-los pressionando ENTER na caixa de texto. Você também pode definir um valor de alinhamento para qualquer cadeia de caracteres individual e uma ação para o texto específico na caixa de texto. Isso pode ser útil para adicionar um hiperlink a uma cadeia de caracteres de texto contida em uma caixa de texto.

Dica

As ações definidas na caixa de texto têm uma prioridade mais alta que ações definidas para texto individual em uma caixa de texto.

Para obter mais informações sobre formatação mista, consulte Como formatar o texto em uma caixa de texto.

Importando HTML para uma caixa de texto

O item de relatório da caixa de texto permite inserir texto formatado em HTML recuperado de um campo de seu conjunto de dados em um relatório. O texto pode ser de qualquer expressão simples ou complexa avaliada como HTML formatado corretamente. O texto formatado pode ser renderizado em todos os formatos de saída com suporte, inclusive PDF.

Dica

Ao importar texto contendo marcação HTML, os dados sempre devem ser analisados primeiro pela caixa de texto. Como apenas um subconjunto de marcas HTML possui suporte, o HTML mostrado no relatório renderizado pode ser diferente do HTML original.

A seguir, há uma lista completa de marcas que são renderizadas como HTML quando definidas como texto de espaço reservado:

Hiperlinks: <A href>
Fontes: <FONT>
Cabeçalho, estilo e elementos de bloco: <H{n}>, <DIV>, <SPAN>,<P>, <DIV>, <LI>, <HN>
Formato de texto: <B>, <I>, <U>, <S>
Manipulação de lista: <OL>, <UL>, <LI>

Qualquer outra marcação HTML será ignorada durante o processamento do relatório. Se o HTML representado pela expressão no texto do espaço reservado não estiver bem formado, o espaço reservado será renderizado como texto sem-formatação. Todas as marcas HTML não diferenciam maiúsculas de minúsculas.

Se a caixa de texto contiver apenas um bloco de texto, qualquer HTML no espaço reservado que define os elementos do bloco será renderizado corretamente. Entretanto, se a caixa de texto tiver vários blocos de texto, as marcas HTML serão ignoradas e a estrutura do texto será definida pelos blocos de texto.

Se mais de uma marca for definida para texto, e o Reporting Services detectar um conflito entre o HTML e as restrições de relatório existentes, somente a marca HTML mais interna será tratada como HTML.

Para obter mais informações, consulte Como adicionar HTML a um relatório.

Limitações de atributos de folha de estilos em cascata

Há suporte para somente um conjunto básico de marcas quando são usadas folhas de estilos em cascata (CSS). A seguir há uma lista de atributos com suporte:

alinhamento de texto, recuo de texto
família de fontes, tamanho da fonte
cor
preenchimento, preenchimento inferior, preenchimento superior, preenchimento à direita, preenchimento à esquerda
espessura da fonte

Eis algumas considerações quanto ao uso de CSS:

Valores CSS malformados são ignorados da mesma maneira que HTML malformado.
Quando o atributo e os atributos de estilo CSS existirem na mesma marca, a propriedade CSS tem maior precedência. Por exemplo, se o texto for <p style="text-align: right" align="left">, somente o atributo de alinhamento de texto será aplicado.
Para atributos e a estilos CSS, se uma propriedade for especificada mais de uma vez, somente sua última instância será aplicada. Por exemplo, se o texto for <p align="left" align="right">, ele será alinhado à direita.

Alinhando texto horizontal usando Geral

Na guia Alinhamento da caixa de diálogo Propriedades da Caixa de Texto, você pode especificar como o texto deve ser alinhado horizontalmente. Se você não especificar um valor para o alinhamento, o valor do alinhamento será Padrão. Isso significa que o texto será alinhado com base no tipo de campo do valor do espaço reservado. Se você especificar uma expressão avaliada com um valor diferente de cadeia de caracteres, o texto será alinhado à direita. Se a sua expressão for avaliada com um valor da cadeia de caracteres, o texto será alinhado à esquerda.