Merge pull request #74 from serge-andreyev/pdfcontent

Describe the PDF Content and PDF Signature controls

Author: serge-andreyev

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/report-designer-tools/ui-panels/report-explorer.md

@@ -52,3 +52,7 @@ You can select all report elements with a specific style.
 The Components node lists all [data sources](../../bind-to-data.md) configured for the report. Right-click a data source to customize its settings or add it to the [Report Gallery](report-gallery.md).
 
 ![design-time-report-explorer-data-source-add-to-gallery](../../../../../images/eurd-win-report-explorer-data-source-add-to-gallery.png)
+
+You can convert a **Data Set** data source to an SQL data source. Right-click the Data Set and select **Convert to SqlDataSource** from the context menu. Click **Yes** in the invoked dialog to confirm the selected action.
+
+![design-time-report-explorer-data-source-convert-data-set](../../../../../images/eurd-win-report-explorer-data-source-convert-data-set.png)

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-basic-report-controls.md

@@ -18,6 +18,11 @@ The controls below allow you to embed other reports and customize the report lay
 * [Panel](use-basic-report-controls/panel.md)
 * [Page Break](use-basic-report-controls/page-break.md)
 
+The following controls add PDF-specific features to reports:
+
+* [PDF Content](use-basic-report-controls/pdf-content.md)
+* [PDF Signature](use-basic-report-controls/pdf-signature.md)
+
 Use the following controls to display auxiliary information in a report:
 
 * [Table of Contents](use-basic-report-controls/table-of-contents.md)

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-basic-report-controls/pdf-content.md

@@ -0,0 +1,90 @@
+---
+title: PDF Content
+author: Sergey Andreev
+---
+# PDF Content
+
+**PDF Content** is a control that renders PDF content in a report.
+
+PDF content is rendered on separate pages and uses its own page settings.
+
+![](../../../../../images/eurd-win-pdf-content-diagram.png)
+
+Use one of the following options to specify PDF content:
+
+* [Specify PDF data](#specify-pdf-data).
+
+    This data is stored in the report file. The source of this data does not need to be available when the report is rendered.
+
+* [Specify a reference to a PDF document](#specify-a-reference-to-a-pdf-document).
+
+    The reference to the document is stored in the report definition file. The referenced document should be available when the report is rendered.
+
+## Add a PDF Content Control to a Report
+
+Drop the **PDF Content** item from the Toolbox onto a [band](../../introduction-to-banded-reports.md) on the design surface.
+
+![](../../../../../images/eurd-win-pdf-content-drop-from-toolbox.png)
+
+You can also copy a PDF document from an external application and paste it in your report, or drag a document and drop it onto the design surface. The dragged file's content is assigned to the control's **Source** property as [PDF data](#specify-pdf-data).
+
+![](../../../../../images/eurd-win-pdf-content-drag-file.png)
+
+## Specify PDF Data
+
+You can assign PDF data to the control's **Source** property.
+
+Expand the **PDF Content**'s smart tag and click the **Source** property's ellipsis button to obtain the binary data from a file.
+
+![](../../../../../images/eurd-win-pdf-content-source-ellipsis.png)
+
+When users save a report, the **Source** property value persists in the report file.
+
+> [!TIP]
+> See the [Use Expressions](#use-expressions) section below for information on how to conditionally specify the **Source** property value, or bind it to a report parameter or data source field.
+
+## Specify a Reference to a PDF Document
+
+You can use an external PDF document as a source of PDF data. Set the **Source URL** property to a local file system path or URL.
+
+Expand the **PDF Content**'s smart tag and click the **Source URL** property's ellipsis button to specify the PDF document location in the file system.
+
+![](../../../../../images/eurd-win-pdf-content-sourceurl-ellipsis.png)
+
+To specify the PDF document's location on the Web, use the URL as the **Source URL** property's value.
+
+![](../../../../../images/eurd-win-pdf-content-sourceurl.png)
+
+When users save a report, the URL or path specified in the **Source URL** property is included in the report file. The PDF document should be available at the specified location when a report is printed or rendered in Preview.
+
+> [!TIP]
+> See the [Use Expressions](#use-expressions) section for information on how to conditionally specify the **Source URL** property value, or bind it to a report parameter or data source field.
+
+The **Source URL** property value takes precedence over the **Source** property value. If you specify both properties, **PDF Content** includes the content specified by **Source URL**. However, if the file specified in the **Source URL** property cannot be loaded, the binary data from the **Source** property is used.
+
+## Use Expressions
+
+You can specify an expression that specifies the **Source** or **Source URL** property value. An expression can include [report parameters](../../shape-report-data/use-report-parameters.md) or [data source](../../bind-to-data.md) fields, or it can conditionally specify a property value.
+
+Expand the **PDF Content**'s smart tag.
+
+* Click the **Expression** property's ellipsis button below the **Source** property. Use the invoked **Expression Editor** to create an expression that identifies the source of binary PDF data.
+
+    ![](../../../../../images/eurd-win-pdf-content-source-expression.png)
+
+* Click the **Expression** property's ellipsis button below the **Source URL** property. Use the invoked **Expression Editor** to create an expression the value of which identifies a URL or path to a PDF document.
+
+    ![](../../../../../images/eurd-win-pdf-content-sourceurl-expression.png)
+
+
+## Limitations
+
+* PDF content always starts on a new page. Report content is printed?on a new page after the PDF content is finished.
+
+* PDF content is displayed as an image in Preview. Users cannot select text in PDF content. To allow users to select text, export the report to PDF.
+
+* You cannot add the **PDF Content** control to the following bands:
+    * **Top Margin** / **Bottom Margin**
+    * **Page Header** / **Page Footer**
+    * **Group Header** / **Group Footer** bands (if their **Repeat Every Page** properties are enabled).
+    * **Vertical Header** / **Vertical Detail** / **Vertical Total**

interface-elements-for-desktop/articles/report-designer/report-designer-for-winforms/use-report-elements/use-basic-report-controls/pdf-signature.md

@@ -0,0 +1,82 @@
+---
+title: PDF Signature
+author: Sergey Andreev
+---
+# PDF Signature
+
+**PDF Signature** is a control that adds a visual signature to a report exported to PDF.
+
+You can sign a report document when you [export it to PDF](../../../../print-preview/print-preview-for-winforms/exporting/exporting-from-print-preview.md). The signature information you specify is saved to the document's **PDF Signature Options**. The **PDF Signature** control visualizes the document signature information:
+
+* Certificate name
+* Distinguished name
+* Location
+* Signature date
+* Signature reason
+
+![PDF Signature Overview](../../../../../images/eurd-win-pdf-signature-overview.png)
+
+> [!TIP]
+> For more information on how to create, export, and sign a report, refer to the following tutorial: [Reports with a Visual PDF Signature](../../create-reports/reports-with-visual-pdf-signature.md).
+
+## Add a Signature Control to a Report
+
+Drop the **PDF Signature** control from the **Toolbox** onto a report.
+
+![Drop PDF Signature from the Toolbox](../../../../../images/eurd-win-pdf-signature-drop-from-toolbox.png)
+
+## Report with Multiple Signatures
+
+The first **PDF Signature** control is added to a report with the **Display Document Signature** property enabled. This control visualizes the document signature information.
+
+Other **PDF Signature** controls are added with the **Display Document Signature** property disabled. When a report is exported to PDF, these controls are converted to signature form fields. Users can open an exported file in a PDF editor and put their signatures in these fields.
+
+![Multiple Controls](../../../../../images/eurd-win-pdf-signature-multiple.gif)
+
+Enable a control's **Display Document Signature** property to make it visualize the document's signature information. This property becomes disabled for all other signature controls.
+
+If all signature controls have the **Display Document Signature** property disabled, the signature information is added to an exported file but is not displayed.
+
+## Specify Signature Options
+
+Expand the control's smart tag and enable check boxes for the signature fields that you want to display.
+
+* **Image Display Mode**
+
+  Specifies whether the control shows the signature image. The following property values are available:
+
+  * **Show**
+
+    The control shows a sample signature image. If an exported document is signed, the converted PDF form field shows the actual signature image.
+
+    ![Show Certificate Image](../../../../../images/eurd-win-pdf-signature-showcertificateimage.png)
+
+  * **Hide**
+
+    The control does not show a signature image.
+
+    ![Hide Certificate Image](../../../../../images/eurd-win-pdf-signature-hidecertificateimage.png)
+
+  * **Show Certificate Name As Image**
+
+    The control shows a sample certificate name in place of a signature image. When an exported document is signed, the converted PDF form field shows the actual certificate name.
+
+    ![Show Certificate Name as Image](../../../../../images/eurd-win-pdf-signature-showcertificatenameasimage.png)
+
+* **Display Document Signature**
+
+  Specifies whether the control displays the document signature information. For more information, refer to the following section: [Report with Multiple Signatures](#report-with-multiple-signatures).
+
+The signature control shows the **certificate name**, **distinguished name**, **location**, **signature date**, and **signature reason**. Disable the corresponding options in the control's smart tag to hide these fields.
+
+  ![Disable Signature Options](../../../../../images/eurd-win-pdf-signature-disable-options.png)
+
+Disable the **Show Captions** property to exclude captions from the fields listed above.
+
+  | Show Captions Enabled | Show Captions Disabled |
+  | --- | --- |
+  | ![Show Captions Enabled](../../../../../images/eurd-win-pdf-signature-show-captions-enabled.png) | ![Show Captions Disabled](../../../../../images/eurd-win-pdf-signature-show-captions-disabled.png) |
+
+## Limitations
+
+The **PDF Signature** control is not exported to non-PDF formats. A placeholder is added to exported documents instead.