Skip to content

Commit 055db44

Browse files
Todor vs designer seo (#1644)
* Overview article split Overview article split * Update vs-designer-structure.md * Update how-to-import-reports-created-with-standalone-report-designer.md * Update telerik-reporting-menu.md * Update upgrade-wizard.md * Update visual-studio-problems.md * Update vs-designer-structure.md * Update overview.md * Update vs-designer-structure.md * Update vs-designer-structure.md * Add files via upload
1 parent e07917a commit 055db44

9 files changed

+156
-98
lines changed

designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/how-to-import-reports-created-with-standalone-report-designer.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: "Learn how to use the Import Report Wizard Visual Studio item templ
55
slug: telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/how-to-import-reports-created-with-standalone-report-designer
66
tags: how,to,import,reports,created,with,standalone,report,designer,trdp,trdx
77
published: True
8-
position: 1
8+
position: 11
99
previous_url: /how-to-import-reports-created-with-standalone-report-designer
1010
---
1111

Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Overview
3-
page_title: Visual Studio Report Designer Explained
4-
description: "Learn how to open and use Visual Studio Report Designer, and what its main areas and features are. Discover how to edit report definitions."
3+
page_title: Visual Studio Report Designer
4+
description: "The Visual Studio Report Designer allows for editing CLR / type report definitions (CS or VB files) in the Visual Studio environment."
55
slug: telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/overview
66
tags: overview,visual,studio,report,designer,tool
77
published: True
@@ -21,7 +21,7 @@ The designer gets installed automatically with the [installation of the Telerik
2121

2222
> The Visual Studio Report Designer works only with the last installed Reporting version. If you have multiple Reporting versions installed on the machine, you will be able to edit CS/VB Reports from the last installed version. Consider the [Upgrade Wizard]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/upgrade-wizard%}) for upgrading your ReportLibrary projects.
2323
24-
## Starting the Designer and Opening Reports
24+
## Starting the Visual Studio Report Designer and Opening Reports
2525

2626
To start/open the designer, open an existing CS/VB file containing the report definition, import or create it as explained below.
2727

@@ -56,100 +56,28 @@ You may create a new report through the Telerik Reporting Visual Studio Item Tem
5656

5757
Double-click on the report type in the [Visual Studio Solution Explorer](https://learn.microsoft.com/en-us/visualstudio/ide/use-solution-explorer?view=vs-2022) or right-click on it and select "View Designer" to invoke the Visual Studio Report Designer and open the corresponding report for editing.
5858

59-
## Structure of the Visual Studio Report Designer
59+
## Key Features of the Visual Studio Report Designer
6060

61-
After you have opened a report in the Telerik Visual Studio Report Designer, you may use the following elements it exposes:
61+
Opening a report in the Telerik Visual Studio Report Designer lets you use its key features indicated in the following image:
6262

63-
### Telerik Reporting Menu
63+
![Visual Studio Report Designer's key features.](images/Designer/visual-studio-report-designer-2017.png)
6464

65-
The [menu]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/telerik-reporting-menu%}) lets you run the [Report Explorer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/report-explorer%}), [Data Explorer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/data-explorer%}), [Group Explorer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/group-explorer%}), [Report Wizard]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/report-wizards/band-report-wizard/overview%}) and [Upgrade Wizard]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/upgrade-wizard%}). It is accessible through the __Telerik Menu --> Reporting__ for Visual Studio versions up to 2017. For Visual Studio 2019 and later through the __Extensions Menu --> Telerik --> Reporting__.
65+
Here is the list of the key elements exposed by the VS Report Designer. More detailed information for all of them may be found in the article [Structure of the Visual Studio Report Designer]({%slug visual-studio-report-designer-structure%}):
6666

67-
### Design Views Buttons
68-
69-
Use these buttons to switch between __Design__, __Preview__, and __HTML__ view mode of the report.
70-
71-
### Report Selector Button
72-
73-
Located in the upper left-hand of the report designer. Clicking this button makes the report active in the __Properties__ window.
74-
75-
### Rulers
76-
77-
They are on the top and left side of the designer and provide a point of reference to the report layout.
78-
79-
### Report Sections
80-
81-
The high-level report design consists of report sections for the report header, report footer, page header, page footer, detail, group header, and group footer. Each section can be resized by dragging the sizing grips at the bottom/right of each section. Most sections except the detail can be deleted by selecting the section and hitting the delete key. To delete a group section, you have to delete the whole group from the `Group Explorer`.
82-
83-
### Component Tray
84-
85-
Shows the [DataSource components]({%slug telerikreporting/designing-reports/connecting-to-data/data-source-components/overview%}) that are used in this report.
86-
87-
### Context Menu
88-
89-
The [Context Menu]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/context-menu%}) will conditionally display contents depending on the area that was right-clicked. In the figure below the menu is invoked in the area next to the report design surface.
90-
91-
![Visual Studio Report Designer's main areas/functionalities.](images/Designer/visual-studio-report-designer-2017.png)
92-
93-
### Tooltip Buttons
94-
95-
All the buttons in the tooltip, placed at the lower left corner of the designer, are designed to ease you in your Report designing experience.
96-
97-
![Visual Studio Report Designer's toolstrip used to turn on/off functionalities.](images/Designer/report-designer-toolstrip.png)
98-
99-
They toggle various options that help in aligning, snapping, and stretching the report items and also adjust different designer settings.
100-
101-
#### Zoom
102-
103-
The combo box enables you to easily specify the zoom percentage in which you see the design surface. You can do that by holding the `Ctrl` key and using the mouse wheel to zoom as well.
104-
105-
![Visual Studio Report Designer Zoom configurations.](images/snapGrid.png)
106-
107-
#### Show/Hide the Snap Grid
108-
109-
The button switches on or off the displayed __snap grid__. The snap grid provides a set of horizontal and vertical gridlines that — when you drag an object on the design surface — will *snap* or pull towards the closest vertical or horizontal gridlines. Objects can also snap to column and row dividers within a grid panel. Here is a workspace showing the snap grid turned on:
110-
111-
![Visual Studio Report Designer when snapping to grid is turned on.](images/snapGrid1.png)
112-
113-
#### Turn On/Off Snapping to Gridlines
114-
115-
This option allows you to drag objects on the design surface and have them snap to the grid lines shown on the designer's surface. The snapping will be applied regardless of the visibility of the snap grid.
116-
117-
#### Turn On/Off Snapping to Snaplines
118-
119-
When this option is enabled, it allows you to drag objects on the design surface and snap them to the margins or alignment lines (red dashed line) of other objects within the same container element such as a layout panel, column, and row dividers in a grid panel. If a container has padding applied, it will be taken into account when snapping an object inside the container.
120-
121-
![Visual Studio Report Designer's snapping to snaplines functinality helping with the report items alignment.](images/snapGrid2.png)
122-
123-
#### Show/Hide Dimensions
124-
125-
When enabled, the designer will show the distances from the currently selected object to the nearest elements.
126-
127-
![Report item dimension in the Visual Studio Report Designer when Show Dimensions is enabled.](images/snapGrid3.png)
128-
129-
#### Show/Hide Watermarks
130-
131-
If enabled, the report watermarks will be shown in the designer. Note that the displayed watermarks are just for reference and their contents may not look the same as when rendered.
132-
133-
#### Turn On/Off Pan
134-
135-
This option allows you to switch between drag and pan mode in the designer. When enabled, the cursor is changed to a hand, and clicking and dragging on the designer surface will move the report contents. This tool is useful when working on higher zoom levels.
136-
137-
### Show/Hide the Report MiniMap
138-
139-
In the lower-right corner of the design surface, click Show MiniMap. This element is especially useful when you have zoomed the report and want to focus on a specific element. To hide the map, click on the design surface to have it closed.
140-
141-
![Report minimap when enabled in the Visual Studio Report Designer.](images/snapGrid4.png)
142-
143-
### Change the Alignment of an Element
144-
145-
Alignment determines how an element resizes. For example, a left-aligned element stretches to the right as the parent layout container gets resized. To change the alignment of an element use the __Layout__ toolbar and do *one* of the following:
146-
147-
![Layout toolbar used to change the alignment of a report element in the Visual Studio Report Designer.](images/layoutToolbar.png)
148-
149-
* Select two report items and change their `HorizontalAlignment` by clicking __Left__, __Center__, __Right__, or __Stretch__.
150-
* Select two report items and change their `VerticalAlignment` by clicking __Top__, __Center__, __Bottom__, or __Stretch__. You can also change alignment by moving an element on the design surface.
151-
152-
The Visual Studio Report Designer features also `Properties Explorer`, `Report Explorer`, `Group Explorer`, and `Data Explorer`. The first one is displayed by default in the Visual Studio. The other three can be opened from the Telerik Menu.
67+
* Telerik Reporting Menu
68+
* Design Views Buttons
69+
* Report Selector Button
70+
* Rulers
71+
* Report Sections
72+
* Component Tray
73+
* Context Menu
74+
* Tooltip Buttons
75+
* Show/Hide the Report MiniMap
76+
* Change the Alignment of an Element
77+
* Properties Explorer
78+
* Report Explorer
79+
* Group Explorer
80+
* Data Explorer
15381

15482
> If you are using **Visual Studio 2022**, ensure that the `Platform target` of your `Report Library` project is not set to `x86`, or you won't be able to preview your reports. This is because **Visual Studio 2022** is a 64-bit application and, by design, `.NET` does not allow mixing 32-bit and 64-bit assemblies in the same process.
15583
@@ -159,12 +87,13 @@ All Telerik Reporting CS/VB reports, for example, _ReportName.cs_ inherit from t
15987

16088
You may add custom code to the _ReportName_ type in the `ReportName.cs` file, where you may find by default only the parameterless constructor of the _ReportName_ type. For example, you may add [Report Event Handlers]({%slug telerikreporting/using-reports-in-applications/program-the-report-definition/report-events/using-report-events%}), etc.
16189

162-
## Troubleshooting
90+
## Visual Studio Report Designer Troubleshooting
16391

16492
To troubleshoot problems related to the Visual Studio Report Designer and Visual Studio Project/Item Templates, please, follow the suggestions in the article [Visual Studio Report Designer Troubleshooting]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/visual-studio-problems%}).
16593

16694
## See Also
16795

96+
* [Structure of the Visual Studio Report Designer]({%slug visual-studio-report-designer-structure%})
16897
* [How to use Visual Studio Report Designer to edit CS Reports in .NET Projects]({%slug how-to-use-vs-designer-in-dotnet-core%})
16998
* [Standalone Report Designer Overview]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/overview%})
17099
* [Web Report Designer Overview]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/overview%})

designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/telerik-reporting-menu.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: "Learn what is the Telerik Reporting Menu shown when the Reporting
55
slug: telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/telerik-reporting-menu
66
tags: telerik,reporting,menu
77
published: True
8-
position: 2
8+
position: 21
99
previous_url: /ui-telerik-reporting-menu
1010
---
1111

designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/upgrade-wizard.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: "Learn how the Upgrade Wizard can be used to upgrade a .NET Framewo
55
slug: telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/upgrade-wizard
66
tags: upgrade,wizard
77
published: True
8-
position: 3
8+
position: 31
99
previous_url: /ui-upgrade-wizard
1010
---
1111

designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/visual-studio-problems.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: "Learn how to troubleshoot Visual Studio-related problems, what are
55
slug: telerikreporting/designing-reports/report-designer-tools/desktop-designers/visual-studio-report-designer/visual-studio-problems
66
tags: visual,studio,report,designer,problems
77
published: True
8-
position: 4
8+
position: 41
99
previous_url: /troubleshooting-visual-studio-problems
1010
---
1111

0 commit comments

Comments
 (0)