PrintDocument for WinForms
PageConfigureScript プロパティ (C1PrintDocument)


C1.PrintDocument.4.5.2 アセンブリ > C1.C1Preview 名前空間 > C1PrintDocument クラス : PageConfigureScript プロパティ
新しいページがドキュメントに追加されるときに実行されるスクリプトを取得または設定します。
シンタックス
'宣言
 
Public Property PageConfigureScript As System.String
'使用法
 
Dim instance As C1PrintDocument
Dim value As System.String
 
instance.PageConfigureScript = value
 
value = instance.PageConfigureScript
public System.string PageConfigureScript {get; set;}
解説

このスクリプトは、ページが Pagesコレクションに追加された後で、ページが解決される前に(ページのコンテンツがまだレイアウトされていない)実行されます。

このスクリプトは、ページレイアウトを変更するためにのみ使用してください。エラーになる可能性があるため、このスクリプトを使用して、ページのコンテンツを変更しないでください。

このとき、 C1PrintDocumentPageConfigureイベントも発生させます。

イベントとスクリプトの違いは、イベントハンドラがアプリケーションコードに属するのに対して、スクリプトはドキュメントに属することです。このため、イベントハンドラは、アプリケーション全体のロジックを実装し、処理中の特定のドキュメントには依存しないタスクを実行するために使用することをお勧めします。

一方、スクリプトは、ドキュメント自体に直接関連するタスクを実行するために使用してください。ドキュメントにアタッチされているスクリプトは、現在のアプリケーションに関係なく実行されます(別のプログラムによってファイルからロードされた後でドキュメントが再生成される場合など)。たとえば、ドキュメントには、エラーが発生した場合に、ドキュメント内のフィールドの値を変更するスクリプトを入れることができます。

参照

C1PrintDocument クラス
C1PrintDocument メンバ