Represents the various options controlling scripts and expressions used in a C1PrintDocument, and specified by the ScriptingOptions property.

Namespace:  C1.C1Preview.Scripting
Assembly:  C1.C1Report.2 (in C1.C1Report.2.dll)

Syntax

C#
public class ScriptingOptions
Visual Basic
Public Class ScriptingOptions

Remarks

Scripts and expressions can be used in various contexts in a C1PrintDocument. While the scripting language and the set of available assemblies and namespaces for all those scripts and expressions are defined by the properties of the document's ScriptingOptions, the sets of built-in variable identifiers available to a script or expression depend on the context in which it is defined.

The following tables list the possible contexts, and the identifiers that can be used in scripts and expressions to access context-dependent document data:

  • Text expressions In expressions specified in square brackets in texts of RenderText, RenderParagraph or RenderField objects, the following context-dependent identifiers can be used:
    Id (type)Meaning
    Document (C1PrintDocument)The current document.
    RenderObject (RenderObject)The current render object.
    RenderFragment (RenderFragment)The current render fragment.
    Page (C1Page)The current page.
    PageNo (Int32)The current 1-based page number.
    PageCount (Int32)The total page count.
    PageX (Int32)The current 1-based horizontal page number.
    PageXCount (Int32)The maximum horizontal page count.
    PageY (Int32)The current 1-based vertical (regular) page number.
    PageYCount (Int32)The total vertical page count.
    Aggregates (AggregateCollection)The list of aggregates defined on the current document.
    DataBinding (C1DataBinding)The active databinding (may differ from the value of the DataBinding property on the current render object, e.g. if it is not defined and parent's databinding is being used).
    Fields (FieldCollection)A shortcut to Fields on the active databinding.
    RowNumber (Int32)A shortcut to RowNumber on the active databinding.
    (Note: while square brackets are the default for marking expressions in C1PrintDocument texts, they can be redefined via the TagOpenParen and TagCloseParen properties.).
  • C1DataBinding expressions In expressions used in any of Expressions, Expressions, Filters, OutlineText, the following context-dependent identifiers are available:
    Id (type)Meaning
    Document (C1PrintDocument)The current document.
    DataBinding (C1DataBinding)The current databinding.
    Fields (FieldCollection)The Fields collection of the current databinding.
    Parent (C1DataBinding)The parent databinding. Normally this is the most nested databinding defined on a parent of the object containing the current databinding. For a TableVectorGroup, this may be the databinding defined on another row/column group if that group encloses the current group (i.e. contains all its rows/columns).
  • DataSetField expression In expressions used to specify calculated data set fields (Expression), the following context-dependent identifiers are available:
    Id (type)Meaning
    Document (C1PrintDocument)The current document.
    Fields (DataSetFieldCollection)The Fields collection of the current data set.
  • Document scope scripts In scripts assigned to DocumentStartingScript, DocumentEndedScript, PageConfigureScript or ErrorScript, the following context-dependent identifiers are available:
    Id (type)Meaning
    Document (C1PrintDocument)The current document.
    Tags (TagCollection)The Tags collection of the current document (this is a shortcut to Document.Tags).
  • Render object scope scripts In scripts assigned to ObjectResolvedScript, the following context-dependent identifiers are available:
    Id (type)Meaning
    Document (C1PrintDocument)The current document.
    RenderObject (RenderObject)The current render object.
    Tags (TagCollection)The Tags collection of the current document (this is a shortcut to Document.Tags).
  • Render fragment scope scripts In scripts assigned to FragmentResolvedScript, the following context-dependent identifiers are available:
    Id (type)Meaning
    Document (C1PrintDocument)The current document.
    RenderObject (RenderObject)The current render object.
    RenderFragment (RenderFragment)The fragment that has resolved.
    Tags (TagCollection)The Tags collection of the current document (this is a shortcut to Document.Tags).

Inheritance Hierarchy

System..::..Object
  C1.C1Preview.Scripting..::..ScriptingOptions

See Also