Display Using (--displayusing)

Objects with this attribute

Usage

Object Manager Display Using Pick a setting from the list.
Command line --displayusing webtop | clientwm | newbrowser | independent | kiosk | localx Specify one of the valid settings. Not all settings are available for all types of application.

Description

This attribute determines how the application is displayed to the user. Some settings affect other attributes. For example, in Object Manager choosing Client Window Management disables the attributes for configuring the application's size. On the command line you may specify these other attributes, but they have no effect.

Object ManagerCommand lineApplies toDescription
WebtopwebtopAll application types
  • The application appears on the webtop, alongside the links, embedded within the web page defined in the object's Emulator Applet Page attribute.
Client window managementclientwmX applications
  • The application's windows behave in the same way as those of applications running on the client device. For example, the windows may be resized, moved, minimized and maximized using the client's normal window management controls.
  • The object's Window Close Action attribute determines what happens when the user closes the application's last or main window.
  • Recommended for applications with many top-level resizable windows.
New browser windownewbrowserAll application types
  • The application appears in a new web browser window, embedded within the web page defined in the object's Emulator Applet Page attribute.
Independent windowindependentAll application types
  • The application appears in a new window, without any web browser toolbars or menus.
  • This window may be resized, but this does not resize the application: the window will include scrollbars. The object's Width and Height attributes determine the size of the application.
  • Closing the window may end or suspend the emulator session, depending on the object's Resumable attribute.
  • Recommended for Windows applications.
Kioskkiosk3270 character, character, X and Windows applications
  • The application appears full-screen, with no window decoration.
  • Users may not resize or move the window.
  • Recommended for full-screen desktop sessions.
Local X serverlocalxX and Windows applications
  • The application is displayed using a X server installed on the client device, if one is available. Otherwise, an independent window is used.
  • Applications configured with this setting are not resumable (even if an independent window is used).
  • The client device X server's host access control must grant access to the application server. See your X server's documentation for information about host access control.

If a user presses the Control key while clicking a link, the application is displayed in a different way:

Attribute valueSetting used if Control is pressed
WebtopIndependent window
New browser window, independent window, kiosk, local X serverWebtop
Client window managementClient window management

Examples

--displayusing newbrowser

Displays the application in a new web browser window, within a web page.

--displayusing independent

Displays the application in an independent window.

Related topics
  • Open in new browser window (--newbrowser)
  • Emulator Applet Page (--empage)
  • X Protocol Engine properties (server-specific)
  • Understanding webtop and emulator sessions