Print applet parameters

The print applet has the following parameters:

ParameterTypeDefaultDescription
ActiveBooleanfalse

Specifies whether the print applet attempts to make itself the working applet. Set this to true to give one print applet the priority over another. For example, if two or more print applets are enabled in the same Tarantella session. Note that setting this value to true for more than one applet running simultaneously is not recommended.

EnabledBooleantrue

Specifies whether a print applet can be the working applet. Only the working applet can be used to control and receive information about your print jobs. Use this parameter when two or more print applets are running simultaneously in the same Tarantella session. To give one print applet the priority over others when determining the working applet, set the Active parameter to true. Note that if only one print applet is running it will be the working applet even if Enabled is set to false.

HostBackgroundColorColor definitionFFFFFF (White)

The background color.

ImageGapInteger1

The size (in pixels) of the gap between the printing icons.

ImageSizeInteger32

The size (in pixels) of the printing icons.

By default, Tarantella has 19 x 19 icons available.

Note that if you're using icons larger than the default you may need to increase the size of the print applet.

LayoutStyleLayout indicatorhorizontal

How print icons appear on the webtop, either horizontally (in a row) or vertically (in a column). The order in which icons appear is always: print status, pause/restart printing, cancel printing.

LoginGUIMaskInteger"2"

A bitmask in the range 0 to 15 which controls the appearance of the Tarantella log in dialog.

The bits are as follows:

  • Bit 1 - controls whether or not the log in dialog box displays. This is where the user enters their username and password.
  • Bit 2 - controls whether or not the ambiguous/aged password dialog box displays.
  • Bit 3 - controls whether or not the error dialog box displays.
  • Bit 4 - controls whether or not the log in dialog displays before credentials are submitted. This forces the user to click OK to log in. The values for the username and password are taken from the TarantellaUsername and TarantellaPassword parameters.

If the value of this parameter is:

  • 0 - no dialog boxes display.
  • 15 - all dialog boxes display.

See Logging in with the Tarantella applets for details of when and how you use this parameter.

PrinterTypeStringdefault printer type

The client device's default printer type. Valid values are: PostScript, PCL, Text. This list can be extended. The tta_print_converter script contains more information on how to do this.

If no value is specified, the print applet cooperates with the ttaprinter.cgi CGI program to determine the default printer type (the default behavior).

PrintImageDirStringJava archive

The URL of the print applet icons.

The URL may be absolute or relative to the HTML page containing the print applet.

If any of icon files are missing or no URL is specified, Tarantella looks first in the signed Java™ archive containing the print applet and then in images (relative to the print applet's codebase).

ScriptingBoolean"false"

This parameter is used with the scriptStart method to release/wake-up the applet.

If the parameter is missing or incorrect, the default of false is used.

TarantellaPasswordString""

The password the applet uses to log in to a Tarantella server.

If the value of the TarantellaUsername parameter is an empty string (""), the applet tries to log the user in anonymously (without a password).

If you are concerned about security, you may not want to use this parameter. Users can see the password you supply (by viewing the page source) and they may be authenticated to Tarantella as a different user.

See Logging in with the Tarantella applets for details of when and how you use this parameter.

TarantellaUsernameStringNo default

The username the applet uses to log in to a Tarantella server.

If this parameter is used, the applet tries to log the user in to Tarantella using the values for the TarantellaUsername and TarantellaPassword parameters. If the value of this parameter is an empty string (""), the applet tries to log the user in anonymously (without a password).

See Logging in with the Tarantella applets for details of when and how you use this parameter.

UseNativeStringDefault

Specifies whether to use native methods for printer discovery and printing on Windows systems. Valid values are: Always and Never. If other values are specified, the applet works in its default manner, attempting to print normally (using Java technology methods), but trying native methods if that fails.

Related topics
  • Print applet
  • Applet parameter data types