PrintDocument for WinForms | ComponentOne
C1.Win.PrintPreview.4.5.2 Assembly / C1.Win.C1Preview.Design Namespace / SampleC1PrintDocument Class / PageConfigureScript Property

In This Topic
    PageConfigureScript Property (SampleC1PrintDocument)
    In This Topic
    Gets or sets the script that is executed when a new page is added to the document. This script executes after the page has been added to the C1.C1Preview.C1PrintDocument.Pages collection but before it is resolved (i.e. when the content of the page has not been laid out yet).

    This script should be used only to change the page layout. Do not use this script to change the page content, as it may cause errors.

    Syntax
    'Declaration
     
    Public Property PageConfigureScript As String
    public string PageConfigureScript {get; set;}
    Remarks

    C1.C1Preview.C1PrintDocument also fires the C1.C1Preview.C1PrintDocument.PageConfigure event at this time.

    The difference between events and scripts is that event handlers belong to the application code, while scripts belong to the document. Thus it is recommended that event handlers be used to perform tasks that implement the overall application logic but do not depend on the specific document being processed.

    On the other hand, scripts should be used to perform tasks directly related to the document itself. Scripts attached to a document are executed regardless of the current application (e.g. when the document is regenerated after being loaded from file by a different program). (For example, a document might contain a script that changes the value of a field in that document when an error occurs.)

    See Also