Skip to content

Added 'FormulaPrefix' description to Excel Device Information Settings articles #1141

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Sep 14, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ The following table lists the device information settings for rendering in Excel
|ShowGridlines|Boolean|Specifies whether Excel Gridlines are visible. Default value is __false__.|
|UseExtendedFormatting|Boolean|Format strings used throughout the report will be hard-coded with "Custom Format" in Excel which includes the locale information of the server. This way the formatting from the report definition is preserved and does not depend on the client machine locale where the document is opened. The custom format information can be omitted by setting __UseExtendedFormatting = false__. Default value is __true__.|
|SplitWorksheetOnPageBreak|Boolean|Specifies whether rendering should generate a new worksheet on soft page breaks. The supported page breaks are [ReportSection.PageBreak](/api/Telerik.Reporting.ReportSection#Telerik_Reporting_ReportSection_PageBreak) and [TableGroup.PageBreak](/api/Telerik.Reporting.TableGroup#Telerik_Reporting_TableGroup_PageBreak). When _SplitWorksheetOnPageBreak_ is enabled, the report property [SkipBlankPages](/api/Telerik.Reporting.Report#Telerik_Reporting_Report_SkipBlankPages) is respected and the empty worksheets will not be included in the generated document. The worksheet generation algorithm complies with the rules set in the report definition and might differ from the soft page breaks generated by the rendering extensions that utilize the paging algorithm. The default value is __false__.|
|FormulaPrefix|String|By default, all of the generated cell values are marked as values rather than formulae. However, if the values are not escaped, there is no guarantee that Excel will not treat values that start with formula identifier as formulae. The purpose of the __FormulaPrefix__ property is to mitigate this by allowing the user to specify a formula prefix that will be used to escape values that start with a formula identifier. The recommended formula prefix is the single quotes character ` ' `. The **default value** is an empty string which keeps the original cell values intact.|

For an example of how to set up the settings for a rendering extension, see [extensions Element]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-report-engine/extensions-element%}).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ The following table lists the device information settings for rendering in Excel
|UseMetafile|Boolean|A flag specifying whether to render Graph, Map and Barcode items as [Metafile (EMF)](https://learn.microsoft.com/en-us/windows/win32/gdiplus/-gdiplus-metafiles-about) or [Bitmap](https://learn.microsoft.com/en-us/windows/win32/gdiplus/-gdiplus-types-of-bitmaps-about) images. The default value is __true__.|
|UseExtendedFormatting|Boolean|Format strings used throughout the report will be hard-coded with "Custom Format" in Excel which includes the locale information of the server. This way the formatting from the report definition is preserved and does not depend on the client machine locale where the document is opened. The custom format information can be omitted by setting __UseExtendedFormatting = false__. Default value is __true__.|
|SplitWorksheetOnPageBreak|Boolean|Specifies whether rendering should generate a new worksheet on soft page breaks. The supported page breaks are [ReportSection.PageBreak](/api/Telerik.Reporting.ReportSection#Telerik_Reporting_ReportSection_PageBreak) and [TableGroup.PageBreak](/api/Telerik.Reporting.TableGroup#Telerik_Reporting_TableGroup_PageBreak). When _SplitWorksheetOnPageBreak_ is enabled, the report property [SkipBlankPages](/api/Telerik.Reporting.Report#Telerik_Reporting_Report_SkipBlankPages) is respected and the empty worksheets will not be included in the generated document. The worksheet generation algorithm complies with the rules set in the report definition and might differ from the soft page breaks generated by the rendering extensions that utilize the paging algorithm. The default value is __false__.|
|FormulaPrefix|String|By default, all of the generated cell values are marked as values rather than formulae. However, if the values are not escaped, there is no guarantee that Excel will not treat values that start with formula identifier as formulae. The purpose of the __FormulaPrefix__ property is to mitigate this by allowing the user to specify a formula prefix that will be used to escape values that start with a formula identifier. The recommended formula prefix is the single quotes character ` ' `. The **default value** is an empty string which keeps the original cell values intact.|

For an example of how to set up the settings for a rendering extension, see [extensions Element]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-report-engine/extensions-element%}).

Expand Down