Skip past navigation linksSecure Global Desktop 4.31 Administration Guide > Applets > Print applet parameters

Print applet parameters

The print applet has the following parameters:

Parameter Type Default Description
Active Boolean false

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 Secure Global Desktop session. Note that setting this value to true for more than one applet running simultaneously is not recommended.

Enabled Boolean true

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 Secure Global Desktop 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.

HostBackgroundColor Color definition FFFFFF (White)

The background color.

ImageGap Integer 1

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

ImageSize Integer 32

The size (in pixels) of the printing icons.

By default, Secure Global Desktop 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.

LayoutStyle Layout indicator horizontal

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.

LoginGUIMask Integer "2"

A bitmask in the range 0 to 15 which controls the appearance of the Secure Global Desktop 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 Secure Global Desktop applets for details of when and how you use this parameter.

PrinterType String default 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).

PrintImageDir String Java 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, Secure Global Desktop looks first in the signed Java archive containing the print applet and then in images (relative to the print applet's codebase).

Scripting Boolean "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.

TarantellaPassword String ""

The password the applet uses to log in to a Secure Global Desktop 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 Secure Global Desktop as a different user.

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

TarantellaUsername String No default

The username the applet uses to log in to a Secure Global Desktop server.

If this parameter is used, the applet tries to log the user in to Secure Global Desktop 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 Secure Global Desktop applets for details of when and how you use this parameter.

UseNative String Default

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