Update some document files

Author: Khojasteh

Docs/README.md

@@ -0,0 +1,14 @@
+Content
+=======
+The `PrintPreview` unit provides the following components:
+
+- **[TPrintPreview](TPrintPreview.md)** \
+  Generates, displays, manages, and prints pages.
+
+- **[TThumbnailPreview](TThumbnailPreview.md)** \
+  Displays the list of pages generated by a [TPrintPreview](TPrintPreview.md) component as thumbnails.
+
+- **[TPaperPreview](TPaperPreview.md)** \
+  Represents a sheet of paper.
+
+In addition, the unit defines some [utility procedures and functions](Globals.md).

Docs/TPaperPreview.Events.md

@@ -7,4 +7,4 @@ In addition to the standard events of Delphi's `TCustomControl` control, the [TP
   `TPaperPaintEvent = procedure(Sender: TObject; Canvas: TCanvas; const Rect: TRect) of object` \
   Occurs when the content of paper needs to be painted.
 
-  Because the control caches the last paint, you need to call one of the `Invalidate` or `Repaint` methods to enforce occurrence of this event.
+  Because the control caches the last paint, an application needs to call one of the `Invalidate` or `Repaint` methods to enforce the occurrence of this event.

Docs/TPrintPreview.Events.md

@@ -5,11 +5,15 @@ In addition to the standard events of Delphi's `TScrollBox` control, the [TPrint
 
 - **`OnAnnotation: TPreviewPageDrawEvent`** \
   `TPreviewPageDrawEvent = procedure(Sender: TObject; PageNo: Integer; Canvas: TCanvas) of object ` \
-  When `Annotation` property is `true`, occurs after a page is displayed. The items drawn on the provided canvas will appear over the preview page, but do not appear on print.
+  Occurs after a page is displayed if the `Annotation` property is `true`. 
+  
+  The items drawn on the provided canvas will appear over the preview page, but do not appear on print.
 
 - **`OnBackground: TPreviewPageDrawEvent`** \
   `TPreviewPageDrawEvent = procedure(Sender: TObject; PageNo: Integer; Canvas: TCanvas) of object` \
-  When `Background` property is `true`, occurs just before a page being displayed. The items drawn on the provided canvas will appear under the preview page, but do not appear on print.
+  Occurs just before a page being displayed if the `Background` property is `true`. 
+  
+  The items drawn on the provided canvas will appear under the preview page, but do not appear on print.
 
 - **`OnBeginDoc: TNotifyEvent`** \
   Occurs when `BeginDoc` method is called.
@@ -43,12 +47,16 @@ In addition to the standard events of Delphi's `TScrollBox` control, the [TPrint
 
 - **`OnProgress: TPreviewProgressEvent`** \
   `TPreviewProgressEvent = procedure(Sender: TObject; Done, Total: Integer) of object` \
-  Occurs periodically during the print and save as PDF/TIFF operations. You can check the value of `State` property to determine which operation is generating this event.
+  Occurs periodically during the print and save as PDF/TIFF operations. 
+  
+  An application can check the value of the `State` property to determine which operation is in progress.
 
 - **`OnPageProcessing: TPreviewPageProcessingEvent`** \
   `TPreviewPageProcessingEvent = procedure(Sender: TObject; PageNo: Integer; var Choice: TPageProcessingChoice) of object` \
   `TPageProcessingChoice = (pcAccept, pcIgnore, pcCancelAll)` \
-  Occurs just before processing a page during the print and save as PDF/TIFF operations. You can check the value of `State` property to determine which operation is generating this event.
+  Occurs just before processing a page during the print and save as PDF/TIFF operations. 
+  
+  An application can check the value of the `State` property to determine which operation is in progress.
 
   The `Choice` parameter can be set to one of the following values:
 
@@ -60,8 +68,12 @@ In addition to the standard events of Delphi's `TScrollBox` control, the [TPrint
 
 - **`OnPrintAnnotation: TPreviewPageDrawEvent`** \
   `TPreviewPageDrawEvent = procedure(Sender: TObject; PageNo: Integer; Canvas: TCanvas) of object` \
-  When `Annotation` property is `true`, occurs after a page is printed. The items drawn on the provided canvas will place over the printed page.
+  Occurs after a page is printed if the `Annotation` property is `true`. 
+  
+  The items drawn on the provided canvas will place over the printed page.
 
 - **`OnPrintBackground: TPreviewPageDrawEvent`** \
   `TPreviewPageDrawEvent = procedure(Sender: TObject; PageNo: Integer; Canvas: TCanvas) of object` \
-  When Background property is `true`, occurs just before a page being printed. The items drawn on the provided canvas will place under the printed page.
+  Occurs just before a page being printed if the `Background` property is `true`. 
+  
+  The items drawn on the provided canvas will place under the printed page.

Docs/TPrintPreview.md

@@ -20,7 +20,7 @@ Here are the key features of the [TPrintPreview](TPrintPreview.md) control:
   - allows inserting, replacing, editing, deleting, and reordering of pages freely at any time
   - can save pages as PDF document by using [Synopse PDF Engine](https://github.com/synopse/SynPDF) or [dsPDF Library](https://torry.net/authorsmore.php?id=2851)
   - can save pages as multi-frame TIFF image.
-  - has a complete set of events
+  - has a complete set of properties and events
 
 See:
   - [Properties](TPrintPreview.Properties.md)

Docs/TThumbnailPreview.Events.md

@@ -21,12 +21,14 @@ In addition to the standard events of Delphi's `TCustomListView` control, the [T
 
 - **`OnPageInfoTip: TPageInfoTipEvent`** \
   `TPageInfoTipEvent = procedure(Sender: TObject; PageNo: Integer; var InfoTip: String) of object` \
-  Occurs when the mouse pointer moves over a thumbnail. The event handler can use the `InfoTip` parameter to specify a text to be shown over the thumbnail.
+  Occurs when the mouse pointer moves over a thumbnail. 
+  
+  The event handler can use the `InfoTip` parameter to specify a text to be shown over the thumbnail.
 
 - **`OnPageSelect: TPageNotifyEvent`** \
   `TPageNotifyEvent = procedure(Sender: TObject; PageNo: Integer) of object` \
   Occurs when a page gets selected.
 
 - **`OnPageUnselect: TPageNotifyEvent`** \
   `TPageNotifyEvent = procedure(Sender: TObject; PageNo: Integer) of object` \
-  Occurs when a selected page becomes deselected.
+  Occurs when a selected page gets deselected.

README.md

@@ -13,11 +13,11 @@ The print preview components consist of three visual components for low level pr
   ![TThumbnailPreview](Images/preview2.png)
 
 - **[TPaperPreview](Docs/TPaperPreview.md)** \
-  This control represents a sheet of paper that can be painted by a custom event handler.
+  This control represents a sheet of paper that an application can draw directly on its canvas.
 
   ![TPaperPreview](Images/preview3.png)
 
-All the print preview components are fully customizable and have a comprehensive set of events.
+All the print preview components are fully customizable and have a comprehensive set of properties and events.
 
 Installation
 ============