Applying Style Properties to Report Items

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Each report item has style properties that control the appearance of the item. Properties affect visual elements like borders, colors, fonts, and padding, and international elements like writing direction, language, calendar, and language. Some styles are not available to all report items. For example, font style properties apply only to text boxes and charts. You can apply the same border style and padding properties to all sides of a report item, or you can apply different styles to each side of the item.

To apply a style property, select one or more items on the report design surface and enter a value for the property in the Properties pane. For common properties like font style and borders, you can set properties by using dialog boxes.

Report Item Appearance Properties

Style property Description

BackgroundColor

The color of the background of the item.

BackgroundImage

An image to display as the background of the item.

BorderColor

The color of the border of the item.

BorderStyle

The style of the border of the tiem.

BorderWidth

The width of the border of the item.

Color

The color of the text in the item.

FontFamily

The name of the font to use for the text in the item.

FontSize

The size of the font in points.

FontStyle

The style of the font for the text in the item. For example, italic.

FontWeight

The thickness of the font for the text in the item.

Format

The Microsoft .NET Framework formatting string to apply to the item. For example, C for currency.

InitialToggleState

A boolean that indicaties, for a textbox that is being used as a toggle item, whether the toggle image initially shows as expanded or collapsed.

LineHeight

The height of a line of text. If not specified, the height is based on the font size.

Padding

The amount of space to insert between the edge of the item and the text or image in the item.

TextAlign

The horizontal alignment of the text in the item. For example, left, right, or center.

TextDecoration

Indicates a special effect to apply to the font for the text in the item. For example, underline.

VerticalAlign

The vertical alignment of the text in the item. For example, top, middle, or bottom.

Visibility

Indicates whether the item is hidden and if so, what other item is used as a toggle item to show or hide this one.

Note

Some TextDecoration styles may not display in some environments. For example, the Overline text decoration does not display in a chart.

The FontFamily property lists all fonts that are available on the local computer. If the font that you want exists on the report server but not on the local computer, you can type the name of the font on the server. Any fonts used in a report definition must exist on the report server or client computer for the text to display properly. For example, reports rendered with the Image rendering extension require the fonts to be installed on the server. Reports rendered with the HTML rendering extension require the fonts to be installed on the client computer.

Reporting Services International Properties

Style property Description

Calendar

The calendar to use to format dates.

Direction

Indicates whether text is written left-to-right or right-to-left.

Language

The primary language of the text.

NumeralLanguage

The digit format to use, based on the language property.

NumeralVariant

The variant of digit format to use.

UnicodeBiDi

The level of bidirectional embedding.

WritingMode

Indicates whether text is written horizontally or vertically.

Miscellaneous Properties that Affect Appearance for Data Regions

In addition to style properties, you can set the following properties on a Tablix data region to control its appearance in a report.

Style property Description

FixedColumnHeaders

Keep column headers visible when scrolling through a report.

FixedRowHeaders

Keep row headers visible when scrolling through a report.

LayoutDirection

Whether to draw the Tablix grid layout from left-to-right or from right-to-left.

OmitBorderOnPageBreak

When a report item like a data region displays across page boundaries, whether to include a border at the bottom of the first page and top of the next page for the report item.

RepeatColumnHeaders

Repeat column headers on each page.

RepeatRowHeaders

Repeat row headers on each page.

See Also

Concepts

Formatting Report Items
Defining the Report Layout (Reporting Services)

Other Resources

XNIB: Style Properties Dialog Box, Border and Line Tab

Help and Information

Getting SQL Server 2008 Assistance