Éléments de rapport dans le rendu de type image

Article
12/15/2008

L'extension de rendu de type image rend la mise en page des éléments et des données de rapport sous la forme d'une image statique. La façon dont chaque élément est rendu varie en fonction de l'élément de rapport.

ReportItems

Les éléments de l'élément ReportItems sont rendus comme décrit plus loin dans cette rubrique. Pour chaque élément de rapport, les sous-éléments Name et Label sont ignorés. Les sous-éléments Top, Left, Height, Width et ZIndex déterminent la disposition des éléments dans la page. Pour plus d'informations sur le positionnement, consultez Conception pour une sortie image.

Textbox

Une zone de texte est rendue sous la forme d'un texte justifié à l'intérieur d'un rectangle. Le tableau suivant décrit la façon dont les éléments de l'élément RDL Textbox sont rendus par l'extension de rendu de type image.

Élément RDL	Rendu
Value	Texte avec les propriétés de style appropriées.
CanGrow	Si la valeur de CanGrow est True, la zone de texte se développe verticalement pour loger le texte. Si la valeur de CanGrow est False, le texte est rogné.
CanShrink	Si la valeur de CanShrink est True et si la hauteur du texte est inférieure à la hauteur de la zone de texte, la zone de texte est réduite en conséquence.
HideDuplicates	Le texte dans la zone de texte n'est pas rendu si les données sont identiques à celles de l'enregistrement précédent. Le texte est présenté s'il figure dans la première zone de texte de la page.

Image

Le tableau suivant décrit la façon dont les éléments de l'élément RDL Image sont rendus par l'extension de rendu de type image.

Élément RDL	Rendu
Value	Si la valeur de l'élément RDL Source est External, l'image est récupérée à partir de l'URL puis rendue. Sinon, l'image est récupérée à partir des données de l'image, puis rendue. Si la récupération n'est pas possible, un X rouge est présenté.
Sizing	L'apparence de l'image est déterminée par l'élément RDL Sizing. Si la valeur de Sizing est Clip, l'image est dimensionnée pour correspondre à la résolution de la sortie, puis elle est tronquée à la hauteur et à la largeur spécifiées. Si la valeur est Fit, l'image est dimensionnée à la hauteur et à la largeur spécifiées. Si la valeur est FitProportional, l'image est dimensionnée à la hauteur et à la largeur spécifiées en respectant la proportion initiale de l'image. Si la valeur est AutoSize, l'image est dimensionnée de façon à correspondre à la résolution de la sortie sans tenir compte de la hauteur et de la largeur.

Value

Si la valeur de l'élément RDL Source est External, l'image est récupérée à partir de l'URL puis rendue. Sinon, l'image est récupérée à partir des données de l'image, puis rendue. Si la récupération n'est pas possible, un X rouge est présenté.

Sizing

L'apparence de l'image est déterminée par l'élément RDL Sizing. Si la valeur de Sizing est Clip, l'image est dimensionnée pour correspondre à la résolution de la sortie, puis elle est tronquée à la hauteur et à la largeur spécifiées. Si la valeur est Fit, l'image est dimensionnée à la hauteur et à la largeur spécifiées. Si la valeur est FitProportional, l'image est dimensionnée à la hauteur et à la largeur spécifiées en respectant la proportion initiale de l'image. Si la valeur est AutoSize, l'image est dimensionnée de façon à correspondre à la résolution de la sortie sans tenir compte de la hauteur et de la largeur.

Line

L'élément Line est rendu avec toutes les propriétés de style appropriées.

Rectangle

L'élément Rectangle est rendu avec toutes les propriétés de style appropriées. Le contenu est tracé à l'intérieur du rectangle, lequel se développe pour loger le contenu.

Subreport

Un sous-rapport est rendu par l'extension de rendu de type image. Les sauts de page à l'intérieur d'un sous-rapport sont rendus comme si le sous-rapport était un rectangle. Si le sous-rapport ne s'exécute pas, une erreur apparaît à la place du sous-rapport.

BackgroundImage

Les images d'arrière-plan répétées sont reproduites à l'intérieur de l'élément conteneur. Les images sont tronquées au bord de l'élément conteneur. Les images d'arrière-plan sont tracées sous les éléments dans le conteneur.

BorderStyle

Les bordures sont tracées autour d'un élément comme indiqué dans les éléments Top, Right, Left et Bottom pour les différentes propriétés de bordure. La largeur de l'espacement entre les pointillés et les traits est la même, quelle que soit la résolution.

Lorsque des bordures sont tracées, une moitié de la bordure est tracée à l'intérieur de l'élément, et l'autre moitié est tracée à l'extérieur. Par exemple, une zone de texte avec une largeur de bordure de 4 pixels sera présentée avec 2 pixels de bordure à l'intérieur de la zone de texte et 2 pixels à l'extérieur de la zone de texte.

Fonts

Dans la mesure où le rapport est rendu sur le serveur, toutes les polices utilisées dans le rapport doivent également résider sur le serveur. Si la police n'existe pas sur le serveur, la police GenericSerif GDI+ est utilisée. Si la valeur de l'élément FontWeight est 700, 800, 900, Bold ou Bolder, la police est rendue en gras.

Padding

Le texte est positionné à l'intérieur d'un élément de rapport sur la base des valeurs des éléments PaddingLeft, PaddingRight, PaddingTop et PaddingBottom. L'espace prévu pour la marge intérieure commence au contour de la zone, sans compter les bordures. Si la marge intérieure est inférieure à la moitié de la largeur de la bordure, la bordure empiète sur le texte.

TextDecoration

Dans l'élément TextDecoration, une valeur Underline s'affiche comme ligne sous le texte. Une valeur LineThrough est présentée sous la forme d'un texte barré. Le paramètre Overline n'est pas pris en charge.

Voir aussi