Inserts a calendar.
Purpose
Inserts a calendar into the report, formatted as a table.
Compatibility
The macro can be used in the highlighted input document types only. A greyed-out icon indicates not supported.
Updates
The 'style' parameter now applies Word's own built-in style for the Grid Table 5 Dark, Grid Table 6 Colorful and Grid Table 7 Colorful families (and their Accent variants), rather than a look-alike custom style named 'Grid Table 5', 'Grid Table 6' or 'Grid Table 7'. Using one of these styles for several calendars or tables no longer leaves extra styles such as 'Grid Table 51' in the Word document.
History (3)
In Report Studio, a 'title' containing markup characters (angle brackets, ampersands) now renders literally, exactly as Word renders it, instead of being interpreted as markup.
The error shown when endDate and monthsToReport are used together now names those two parameters, rather than naming auto.
The autoFit parameter now works with 'Content' or 'Window' values.
Colours (2)
| Parameter | Type | Presence | Purpose | Options | Default |
| Color | Optional | The highlight background color. |
|
Color [DarkBlue] | |
| Color | Optional | The highlight foreground color. |
|
Color [White] |
Time & Date (3)
| Parameter | Type | Presence | Purpose | Options | Default |
| DateTimeOffset | Optional | The end date in the format YYYY-MM-DD. | N/A | Midnight on the first day of this month | |
| Int32 | Optional | If set, sets 'endDate' to the 'start' plus the specified number of months. | N/A | N/A | |
| DateTimeOffset | Optional | The start date in the format YYYY-MM-DD. | N/A | Midnight on the first day of last month |
General (3)
| Parameter | Type | Presence | Purpose | Options | Default |
| Boolean | Optional | Whether highlighted dates are shown in bold. |
|
true | |
| String | Optional | The time ranges to highlight (currently only single dates are supported). | N/A | N/A | |
| String | Optional | The calendar title. | N/A | N/A |
Examples (3)
Example 1
A plain calendar. By default, this covers the previous calendar month.
[Calendar:]Example 2
Control start and end dates and highlight time ranges.
[Calendar: startDate=2015-10-01, endDate=2015-11-01, highlightTimeRanges=2015-10-03;2015-10-06;2015-10-07]Example 3
Modify the highlight style.
[Calendar: startDate=2015-10-01, endDate=2015-11-01, highlightTimeRanges=2015-10-03;2015-10-06;2015-10-07, highlightForegroundColor=Red, highlightBackgroundColor=White]