Merge pull request #15362 from lishibo/patch-2

Add documents on hidden parameter behavior

Author: ShannonLeavitt

docs/reporting-services/report-design/customize-the-parameters-pane-in-a-report-report-builder.md

@@ -11,54 +11,80 @@ author: maggiesMSFT
 ms.author: maggies
 ---
 # Customize the Parameters Pane in a Report (Report Builder)
-  When creating paginated reports with parameters in Report Builder, you can customize the Parameters pane. In report design view, you can drag a parameter to a specific column and row in the Parameters pane. You can add and remove columns to change the layout of the pane.  
-  
- When you drag a parameter to a new column and row in the pane, the parameter order changes in the **Report Data** pane. When you change the order of the parameter in the **Report Data** pane, the location of the parameter in the pane is changed. For more information about why parameter order is important, see [Change the Order of a Report Parameter (Report Builder and SSRS)](../../reporting-services/report-design/change-the-order-of-a-report-parameter-report-builder-and-ssrs.md).  
-  
-## To customize the parameters pane  
-  
-1.  On the **View** tab, select the **Parameters** checkbox to display the parameters pane.  
-  
-     ![Access parameters pane from View tab](../../reporting-services/report-design/media/ssrs-customparameter-accessparameterpanedesignmode.png "Access parameters pane from View tab")  
-  
-     The pane appears at the top of the design surface.  
-  
-2.  To add a parameter to the pane, do one of the following.  
-  
-    -   Right click an empty cell in the parameters pane, and then click **Add Parameter**.  
-  
-         ![Add new parameter from parameters pane](../../reporting-services/report-design/media/ssrs-customizeparameter-addnewparameter.png "Add new parameter from parameters pane")  
-  
-    -   Right click **Parameters** in the **Report Data** pane, and then click **Add Parameter**.  
-  
-3.  To move a parameter to a new location in the parameters pane, drag the parameter to a different cell in the pane.  
-  
-     When you change the location of the parameter in the pane, the order of the parameter in the **Parameters** list in the **Report Data** pane is automatically changed. For more information about the impact of the parameter order, see [Change the Order of a Report Parameter (Report Builder and SSRS)](../../reporting-services/report-design/change-the-order-of-a-report-parameter-report-builder-and-ssrs.md)  
-  
-4.  To access the properties for a parameter, do one of the following.  
-  
-    -   Right click the parameter in the parameters pane, and then click **Parameter Properties**.  
-  
-         ![Access parameter properties from the parameters pane](../../reporting-services/report-design/media/ssrs-customizeparameter-accessparameterproperties-composite.png "Access parameter properties from the parameters pane")  
-  
-    -   Right click the parameter in the **Report Data** pane, and then click **Parameter Properties**.  
-  
-5.  To add new columns and rows to the pane, or delete existing rows and columns, right click anywhere in the parameters pane and then click a command on the menu that displays.  
-  
-     ![Add columns and rows to the parameters pane](../../reporting-services/report-design/media/ssrs-customparameter-addcolumnsrows.png "Add columns and rows to the parameters pane")  
-  
-    > [!IMPORTANT]  
-    >  When you delete a column or row that contains parameters, the parameters are deleted from the report.  
-  
-6.  To delete a parameter from the pane and from the report, do one of the following.  
-  
-    -   Right click the parameter in the parameters pane, and then click  **Delete**.  
-  
-         ![Delete parameters from the parameters pane](../../reporting-services/report-design/media/ssrs-customparameter-deleteparameter.png "Delete parameters from the parameters pane")  
-  
-    -   Right click parameter in the **Report Data** pane, and then click **Delete**.  
-  
-## See Also  
- [Report Parameters (Report Builder and Report Designer)](../../reporting-services/report-design/report-parameters-report-builder-and-report-designer.md)  
-  
-  
+  When creating paginated reports with parameters in Report Builder, you can customize the Parameters pane. In report design view, you can drag a parameter to a specific column and row in the Parameters pane. You can add and remove columns to change the layout of the pane.
+
+ When you drag a parameter to a new column and row in the pane, the parameter order changes in the **Report Data** pane. When you change the order of the parameter in the **Report Data** pane, the location of the parameter in the pane is changed. For more information about why parameter order is important, see [Change the Order of a Report Parameter (Report Builder and SSRS)](../../reporting-services/report-design/change-the-order-of-a-report-parameter-report-builder-and-ssrs.md).
+
+## To customize the parameters pane
+
+1.  On the **View** tab, select the **Parameters** checkbox to display the parameters pane.
+
+     ![Access parameters pane from View tab](../../reporting-services/report-design/media/ssrs-customparameter-accessparameterpanedesignmode.png "Access parameters pane from View tab")
+
+     The pane appears at the top of the design surface.
+
+2.  To add a parameter to the pane, do one of the following.
+
+    -   Right click an empty cell in the parameters pane, and then click **Add Parameter**.
+
+         ![Add new parameter from parameters pane](../../reporting-services/report-design/media/ssrs-customizeparameter-addnewparameter.png "Add new parameter from parameters pane")
+
+    -   Right click **Parameters** in the **Report Data** pane, and then click **Add Parameter**.
+
+3.  To move a parameter to a new location in the parameters pane, drag the parameter to a different cell in the pane.
+
+     When you change the location of the parameter in the pane, the order of the parameter in the **Parameters** list in the **Report Data** pane is automatically changed. For more information about the impact of the parameter order, see [Change the Order of a Report Parameter (Report Builder and SSRS)](../../reporting-services/report-design/change-the-order-of-a-report-parameter-report-builder-and-ssrs.md)
+
+4.  To access the properties for a parameter, do one of the following.
+
+    -   Right click the parameter in the parameters pane, and then click **Parameter Properties**.
+
+         ![Access parameter properties from the parameters pane](../../reporting-services/report-design/media/ssrs-customizeparameter-accessparameterproperties-composite.png "Access parameter properties from the parameters pane")
+
+    -   Right click the parameter in the **Report Data** pane, and then click **Parameter Properties**.
+
+5.  To add new columns and rows to the pane, or delete existing rows and columns, right click anywhere in the parameters pane and then click a command on the menu that displays.
+
+     ![Add columns and rows to the parameters pane](../../reporting-services/report-design/media/ssrs-customparameter-addcolumnsrows.png "Add columns and rows to the parameters pane")
+
+    > [!IMPORTANT]
+    >  When you delete a column or row that contains parameters, the parameters are deleted from the report.
+
+6.  To delete a parameter from the pane and from the report, do one of the following.
+
+    -   Right click the parameter in the parameters pane, and then click  **Delete**.
+
+         ![Delete parameters from the parameters pane](../../reporting-services/report-design/media/ssrs-customparameter-deleteparameter.png "Delete parameters from the parameters pane")
+
+    -   Right click parameter in the **Report Data** pane, and then click **Delete**.
+
+## Hidden/Internal parameters in runtime
+If you have hidden/internal parameters, the logic on whether it'll be rendered as empty space in runtime is as follows:
+
+   - If any row or column is full of hidden/internal parameters or empty cell, then it won't be rendered in runtime;
+   - Otherwise, both hidden/internal parameters and empty cell will be rendered as empty space;
+
+For example, `ReportParameter1` is hidden while rests are visible:
+
+![Hidden Parameter Example 1](../../reporting-services/report-design/media/ssrs-hidden-parameter-rb-1.png "One hidden parameter in layout grid")
+
+This will result in an empty space in runtime because there are visible parameters in first column or first row:
+
+![Hidden Parameter Example 1 - runtime](../../reporting-services/report-design/media/ssrs-hidden-parameter-server-1.png "One hidden parameter in layout grid result in empty space in runtime")
+
+Now if we change `ReportParameter3` to hidden as well:
+
+![Hidden Parameter Example 2](../../reporting-services/report-design/media/ssrs-hidden-parameter-rb-2.png "Two hidden parameter in same column")
+
+Then the first column is omitted because the whole column is empty:
+
+![Hidden Parameter Example 2 - runtime](../../reporting-services/report-design/media/ssrs-hidden-parameter-server-2.png "Two hidden parameter in same column in runtime")
+
+## Default layout
+For those reports that were authored before SSRS 2016 version, a default layout grid of 2 columns and N rows will be used in runtime. To change the layout, simply open the report in latest Report Builder and save back, then a customized layout info will be saved to .rdl file as well.
+
+
+## See also
+ [Report Parameters (Report Builder and Report Designer)](../../reporting-services/report-design/report-parameters-report-builder-and-report-designer.md)
+
+