SIMPOL Documentation

printform1

The printform1 type was also created in the SIMPOL language library called databaseforms.sml. It provides a set of data-aware types for creating printable forms (forms primarily meant to be printed rather than displayed on the screen). This group of types shares a number of types with the dataform1 type group, and is type tagged as dataform1 as well as dataform1linkcontainer. For details about working with the printform1 family of types, visit Chapter 24, Using Data-Aware Print Forms in SIMPOL.

Table 22.3. printform1
TypeDescription
printform1This represents the entire printable form. The form contains a dring of printform1page objects. Each page contains the graphics and controls that are found on that page. The form also has drings of controls, graphics, datasources, bitmaps, fonts, tables, links, and sibling links.
printform1arcA basic wrapper for the wxgraphicarc type, but also includes the necessary elements to be part of printform1.
printform1bitmapA bitmap object that is also data-aware. Can be a static bitmap or it can have a control source that contains the path name of the bitmap, which can be a file system resource or located on the Internet using the HTTP protocol. Must be stored using the URL format: "file:///c/mystuff/mypic".
dataform1bitmapsourceSupplies the container for the bitmaps used in the form. Also contains the path and file name for images loaded from disk. Allows easy reuse of the same bitmap multiple times on one form (or potentially on multiple pages of a form).
dataform1controlsourceThe information used to connect a database field with a control, including the display format (used both to convert from dates, times, etc. to string for display in the control, as well as to convert from the string value to the target data type for storage in the field). The detail block information is not used when it is part of a printform1control.
dataform1datasourceThis type is used to hold the information necessary to reopen a data source, as well as a reference to the opened data source itself.
printform1ellipseA basic wrapper for the wxgraphicellipse type, but also includes the necessary elements to be part of dataform1.
printform1lineA basic wrapper for the wxgraphicline type, but also includes the necessary elements to be part of dataform1.
dataform1linkThis object contains the information necessary to create a join between two database tables. It is included in the dataform1controlsource type.
printform1pageThis contains the controls, graphics, and the reference to the wxform object (if the form is being displayed) that contains all the wxform controls and graphics that make up one page.
dataform1recordThis is a container for a type(db1record) object. The features for managing modification are not used in printform1, since it is not designed to allow user interaction.
printform1rectangleA basic wrapper for the wxgraphicrectangle type, but also includes the necessary elements to be part of dataform1.
dataform1tableThis type contains a reference to a database table – type(db1table), it also contains an array of field information, a reference to the data source, a reference to the form, a reference to the current index, a dlistnode called parentnode which is used to traverse the tables on the form, and another dlistnode called datasourcenode that is used to traverse the tables in the data source. See below for information on iterating through elements on the form. There is a method called gettablename() that can be used to retrieve the table name of the table regardless of the type of table. It also has events for onnewrecord, onsaverecord, and ondeleterecord that can be defined by the application programmer to take an action at that point.
printform1textThis type enhances the underlying wxformtext type by making it data-aware, so that information from a record can be shown, but not edited.
printform1triangleA basic wrapper for the wxgraphictriangle type, but also includes the necessary elements to be part of dataform1.