|
1 | 1 | ---
|
2 | 2 | title: "Hide an item (Report Builder)"
|
3 |
| -description: In Report Builder, you can set the visibility of a report item. You can specify a report parameter or other expression to conditionally hide an item. |
| 3 | +description: Learn how to hide or show a report item in Report Builder, specifically by using report parameters and expressions. |
4 | 4 | author: maggiesMSFT
|
5 | 5 | ms.author: maggies
|
6 |
| -ms.date: 03/01/2017 |
| 6 | +ms.date: 09/04/2024 |
7 | 7 | ms.service: reporting-services
|
8 | 8 | ms.subservice: report-builder
|
9 |
| -ms.topic: conceptual |
| 9 | +ms.topic: how-to |
10 | 10 | ms.custom: updatefrequency5
|
11 | 11 | f1_keywords:
|
12 | 12 | - "sql13.rtp.rptdesigner.shared.visibility.f1"
|
13 | 13 | - "10503"
|
| 14 | +#customer intent: As a SQL Server report designer, I want to hide or show report items to improve report readability and user experience. |
14 | 15 | ---
|
15 | 16 | # Hide an item (Report Builder)
|
16 | 17 |
|
17 |
| - Set the visibility of a report item when you want to conditionally hide an item based on a report parameter or some other expression that you specify. |
| 18 | +In this article, learn how to set the visibility of a report item based on a report parameter or another expression in Report Builder. You can conditionally hide an item to improve the user experience. You can also design a report to allow the user to toggle report item visibility by selecting text boxes in the report. For more information, see [Add an expand or collapse action to a Report Builder paginated report](../../reporting-services/report-design/add-an-expand-or-collapse-action-to-an-item-report-builder-and-ssrs.md). |
18 | 19 |
|
19 |
| -You can also design a report to allow the user to toggle the visibility of report items based on selecting text boxes in the report, for example, for a drilldown report. For more information, see [Add an expand or collapse action to an item (Report Builder)](../../reporting-services/report-design/add-an-expand-or-collapse-action-to-an-item-report-builder-and-ssrs.md). |
20 |
| - |
21 |
| -The following procedures describe how to show or hide a report item in a rendered report based on a constant or an expression. |
| 20 | +The following sections describe how to show or hide a report item in a rendered report based on a constant or an expression. |
22 | 21 |
|
23 | 22 | > [!NOTE]
|
24 | 23 | > [!INCLUDE[ssRBRDDup](../../includes/ssrbrddup-md.md)]
|
25 | 24 |
|
26 |
| -### Hide a report item |
| 25 | +## Hide a report item |
27 | 26 |
|
28 |
| -1. In report design view, right-click the report item and open its **Properties** page. |
| 27 | +1. In the report design view, right-click the report item and select **Text Box Properties**. |
29 | 28 |
|
30 | 29 | > [!NOTE]
|
31 |
| - > To select an entire table or matrix data region, select in the data region to select it, right-click a row, column, or corner handle, and then select **Tablix Properties**. |
32 |
| -
|
33 |
| -1. Select **Visibility**. |
34 |
| - |
35 |
| -1. In **When the report is initially run**, specify whether to hide the item when you first view the report: |
| 30 | + > To select an entire table or matrix data region, choose the data region to select it, right-click a row, column, or corner handle, and then select **Tablix Properties**. |
36 | 31 |
|
37 |
| - - To display the item, select **Show**. |
| 32 | +1. Select **Visibility** in the left pane. |
38 | 33 |
|
39 |
| - - To hide the item, select **Hide**. |
| 34 | +1. Under **When the report is initially run**, specify whether to hide the item when you first view the report. |
40 | 35 |
|
41 |
| - - To specify an expression that is evaluated at run-time, select **Show or hide based on an expression**. Enter the expression or select the expression (**fx**) button to create the expression in the **Expression** dialog. |
| 36 | + - To display the item, select **Show**. |
| 37 | + - To hide the item, select **Hide**. |
| 38 | + - To specify an expression that's evaluated at run-time, select **Show or hide based on an expression**. Enter the expression or select the expression (**fx**) button to create the expression in the **Expression** dialog. |
42 | 39 |
|
43 | 40 | > [!NOTE]
|
44 |
| - > When you specify an expression for visibility, you are setting the Hidden property of the report item, as shown in the following image. The evaluated expression shows the report item when the value is False, and hides the report item when the value is **True**. |
45 |
| - > :::image type="content" source="media/hide-an-item-report-builder-and-ssrs/hiddenproperty-propertiesvisibility.png" alt-text="Screenshot of the Properties_Visibility dialog and Hidden property."::: |
| 41 | + > When you specify an expression for visibility, you set the Hidden property of the report item, as shown in the following image. The evaluated expression shows the report item when the value is **False** and hides the report item when the value is **True**. |
| 42 | + > :::image type="content" source="media/hide-an-item-report-builder-and-ssrs/hiddenproperty-propertiesvisibility.png" alt-text="Screenshot of the Text Box Properties dialog and Expression dialog." lightbox="media/hide-an-item-report-builder-and-ssrs/hiddenproperty-propertiesvisibility.png"::: |
46 | 43 |
|
47 |
| -1. Select **OK** twice. |
| 44 | +1. Select **OK** on the **Expression** dialog, and then select **OK** on the **Text Box Properties** dialog. |
48 | 45 |
|
49 |
| -### Hide static rows in a table, matrix, or list |
| 46 | +## Hide static rows in a table, matrix, or list |
50 | 47 |
|
51 | 48 | 1. In report design view, select the table, matrix, or list to display the row and column handles.
|
52 | 49 |
|
53 |
| -1. Right-click the row handle, and then select **Row Visibility**. The **Row Visibility** dialog opens. |
| 50 | +1. Right-click the row handle, and then select **Row Properties...**. |
54 | 51 |
|
55 | 52 | 1. To set the visibility, follow steps 3 and 4 in the first procedure.
|
56 | 53 |
|
57 | 54 | ### Hide static columns in a table, matrix, or list
|
58 | 55 |
|
59 |
| -1. In Design view, select the table, matrix, or list to display the row and column handles. |
| 56 | +1. In report design view, select the table, matrix, or list to display the row and column handles. |
60 | 57 |
|
61 |
| -1. Right-click the column handle, and then select **Column Visibility**. |
| 58 | +1. Right-click the column handle, and then select **Column Properties...**. |
62 | 59 |
|
63 |
| -1. In the **Column Visibility** dialog, follow steps 3 and 4 in the first procedure. |
| 60 | +1. To set the visibility, follow steps 3 and 4 in the first procedure. |
64 | 61 |
|
65 | 62 | ## Related content
|
66 | 63 |
|
67 |
| -- [Drilldown action (Report Builder)](../../reporting-services/report-design/drilldown-action-report-builder-and-ssrs.md) |
68 |
| -- [Add an expand or collapse action to an item (Report Builder)](../../reporting-services/report-design/add-an-expand-or-collapse-action-to-an-item-report-builder-and-ssrs.md) |
69 |
| -- [Expression examples (Report Builder)](../../reporting-services/report-design/expression-examples-report-builder-and-ssrs.md) |
| 64 | +- [Drilldown action in a paginated report (Report Builder)](../../reporting-services/report-design/drilldown-action-report-builder-and-ssrs.md) |
| 65 | +- [Expression examples in Report Builder paginated reports](../../reporting-services/report-design/expression-examples-report-builder-and-ssrs.md) |
0 commit comments