ASP.NET Web Forms Server Controls
The ASP.NET Web Forms Server Controls package contains a suite of controls and resource to simplify the implementation of common scenarios for providing a controlled printing experience within an ASP.NET Web Forms application/site:
- Installation of the ScriptX add‑on on the client PC including a page crafted to assist the user during the installation process with prompts and screen snips depending upon the browser version being used.
- Initialising print settings such as headers, footers, margins and the printer to use.
- Buttons to initiate printing.
The ASP.NET Web Forms model is one where round-trips to the server are frequent as a click on a client-side button results in a post-back to the server where the button click is processed and new content delivered back to the client PC for display.
This package is dependent upon the following packages:
MeadCo ScriptX - installers for web sites
This package provides the installers for the ScriptX binaries and a custom configuration section that also allows you to specify any Advanced Printing publishing license you have purchased - or the evaluation license.
MeadCo ScriptX JS Simple Wrapper
This packages provides convenient wrappers on some common ScriptX functionality. It is not dependent on any other libray (such as jQuery).
All of the server controls are provided in the namespace MeadCoScriptX:
For convenience, the installer for the NuGet package of the controls adds a reference to this namespace for all pages in your app/site (an update to web.config).
The following controls are provided:
Using licensed features
Some features require an Advanced printing publishing license.
To enable the licensed features, specify your license in the installers config section. For example, to use the evaluation license, edit the config section to include the evaluation license. The section will look like this:
Initialising printing at the client with MeadCoScriptX:ClientPrinting
Initialising printing at the client requires:
- The ScriptX add‑on ‘factory’ object
The section Basic printing with ScriptX illustrates how to do this and while not at all difficult there are tedious aspects such as neatly handling the case of the add‑on needs to be installed.
The MeadCoScriptX:ClientPrinting server control simplifies the coding to an intuitive set of attributes:
|ClientValidate||Specifies whether the ScriptX add‑on is to be installed if the required version isnt already installed. If the value is ‘redirect’ then if the required version is not available the user will be redirected to the installer page.||None - no scripted check is made that ScriptX is available. Internet Explorer will prompt to install the add‑on if it is not installed or a newer version is required.|
|InstallHelperUrl||The url to redirect to when ClientValidate is ‘redirect’ and if the required version of ScriptX is not installed on the client PC||“~/MeadCo.ScriptX/InstallFailed.aspx” [the default handlers installed by the package]|
|PrintTemplate||The template to use. May be one of the values Default, Classic, IE7, IE 5, MaxiPT. This attribute specifies the value of the ScriptX templateUrl property||“Default”|
|footer||The footer text to use. See the footer reference for details.||The user's IE default.|
|header||The header text to use. See the header reference for details.||The user's IE default.|
|headerFooterFont||A description of the font to use. The ScriptX reference for headerFooterFont gives full details.||The user's IE default.|
|printer||The printer to use. A publishing license is required to use this attribute.||The user's default printer.|
|Orientation||The paper orientation - “landscape” or “portrait”||The user's IE default.|
|PaperSource||The name of the paper source to use (e.g. "Tray 1"). A publishing license is required to use this attribute.||The printer default.|
|PaperSize||The name of the paper size to use (e.g. “A4”). A publishing license is required to use this attribute.||The printer default.|
|Units||The measurement units to use for margins - “inches” or “mm”. A publishing license is required to use this attribute.||The user's default units.|
|left||The left margin value in the specified units (may be the users default units). Please note that no margin value can be less than the printer's unprintable margin.||The user's IE default.|
|top||The top margin value in the specified units.||The user's IE default.|
|right||The right margin value in the specified units.||The user's IE default.|
|bottom||The bottom margin value in the specified units.||The user's IE default.|
Print a document with MeadCoScriptX:PrintButton
The MeadCoScriptX:PrintButton element inherits from the standard HTML button element so all the standard attributes such as CssStyle work as expected. As expected, the element provides a button that when clicked will cause the current document, a frame or a document downloaded from a URL to be printed accordiing to the settings described in the MeadCoScriptX:ClientPrinting element.
The MeadCoScriptX:PrintButton provides a button and printing behaviour with a few simple attributes:
|Text||The button text.||Print.|
|Prompt||Whether the user should be prompted to select a printer.||True. To use ‘false’ a publishing license is required.|
|Frame||The name of the frame to be printed.||None. The host document will be printed.|
|DocumentURL||The URL of the document to be printed.||None. The host document will be printed using PrintHtml(). This feature requires a publishing license.|
Preview the current page or frame with MeadCoScriptX:PrintPreviewButton
The MeadCoScriptX:PrintPreviewButton element inherits from the standrad HTML button element so all the standard attributes such as CssStyle work as expected. As expected, the element provides a button that w hen clicked will cause the current document, or a frame to be previewed.
|Text||The button text.||Print.|
|Frame||The name of the frame to be previewed.||None. The host document will be previewed. This feature requires a publishing license.|
Improvements and developments
What else would you like to see in the server controls package? Please use our Contact Us page to send us your ideas.