WebTerm X User Help
There is no "user manual" for the WebTerm X Power Plug-in. However, there are some important things for you to understand. NOTE: This section is written directly to the users of Web pages that have WebTerm X configurations in them. Feel free to copy and distribute this section to your users, or point them to Powerlan's WebTerm X user help page.
How to Interact with an Embedded X Client Window
When an X client window is embedded in a Web page, you can interact with it through mouse clicks and with the keyboard when the embedded window is in "focus."
-
-
| NOTE: You click on the embedded X client to gain "focus" of that client to interact with it.----------------------> |
 |
Figure 5-1 . An embedded window in "focus" in the Web browser
To get the embedded window in focus, just click on any part of the embedded window. The embedded window is in focus when a thin black line surrounds the window within the Web browser.
Then, use the X client application as it was designed: Type into it, or use your mouse to work with it.
How to Generate a Middle Mouse Button Click
Since most Windows systems have a two-button mouse, and X Windows typically uses a three-button mouse, you need to simultaneously RIGHT CLICK + LEFT CLICK to generate the equivalent of a center mouse button click. Since most Windows systems have a two-button mouse, and X Windows typically uses a three-button mouse, you need to simultaneously RIGHT CLICK + LEFT CLICK to generate the equivalent of a center mouse button click.
Forcing WebTerm X to Close: The Taskbar Tray
Whenever a X connection to a host computer is in the process of opening, open, or is in the process of closing, a WebTerm X icon appears in the Windows task tray. The taskbar tray, shown in this figure, is a small part of your Windows task bar that shows applications that are running in the background.
Whenever a X connection to a host computer is in the process of opening, open, or is in the process of closing, a WebTerm X icon appears in the Windows task tray. The taskbar tray, shown in this figure, is a small part of your Windows task bar that shows applications that are running in the background.
-
Figure 5-2 . The WebTerm X Background Application in the Task Bar Tray
Right-click on this icon to see a small menu of actions you can take with the X connection, such as select and copy graphics, select and print graphics, toggling the X root taskbar on and off, or forcing the X server to close.
Note: If you want to force a session to close, regardless of what is in the Web browser or on your Windows desktop, right-click the WebTerm X icon in the taskbar tray and choose Close. Exit this way only if the X client application allows no other alternative.
Copying Text and Graphics from an X Client
You can copy text from or paste text to X windows that have text fields. You can copy graphics from X windows to the Microsoft Windows clipboard.
Copy Text to the Windows Clipboard
WebTerm X automatically copies the primary text selection to the Windows clipboard. Once you've selected text in an X client application, it automatically appears on the Windows clipboard with no further actions.
Paste Text from the Windows Clipboard
When new text appears on the Windows clipboard, WebTerm X changes the primary text selection to the contents of the Windows clipboard. You can paste it to the X client application just as you would from any standard X application: by clicking the middle mouse button. On Windows two-button mouse systems with no mouse macro utility installed, a middle click is accomplished by RIGHT CLICK + LEFT CLICK.
Copy Graphics to the Windows Clipboard
- Right click on the WebTerm X icon in the taskbar tray. Choose Select and Copy Graphics.
- You'll see a crosshair cursor. With this cursor, drag a square around the region of graphics you want to place on the clipboard. When you release the mouse button, the selected area is placed on the Microsoft Windows clipboard.
- Or
- From a client window managed by Microsoft Windows, open the system pull-down menu (the icon at the top left of the client window) for the detached window.
- From the Copy Window menu, choose To Clipboard
Print Graphics from an X client window
- Right click on the WebTerm X icon in the taskbar tray. Choose Select and Print Graphics.
- You'll see a crosshair cursor. With this cursor, drag a square around the region of graphics you want to print. When you release the mouse button, you see a print dialog that lets you indicate how to print the selected area.
- Or
- From a client window managed by Microsoft Windows, click the system pull-down for the detached window (the box at the top left of the client window).
- From the Copy Window menu, choose To Printer. You see a print dialog that lets you indicate how to print the selected area.
Iconify and Manipulate Detached Windows
An X client window appears on your windows desktop with Microsoft Windows borders and controls (if no remote window manager started) or with the borders and controls defined by the remote window manager (if one was started).
Use the window controls to minimize, maximize, restore, resize, move and close X client windows on your Microsoft Windows desktop. If those controls are created by a remote window manager, you may need to click the X Root Taskbar to see the controls for the X client windows.
If X client applications are embedded they are managed by the Web browser and will have no borders, minimize, maximize, or restore controls or menus. Those functions are controlled by the Web browser. Minimize a Web browser with an embedded X client window and the X client window minimizes as part of the browser; move the browser window and the embedded X client moves along with the browser.
The X Root Taskbar: Generating clicks on the root
The X root taskbar allows you to have a screen area that acts as a "root window" you can click on, just as if you were clicking on the root of an actual X terminal. It appears on your windows desktop as a taskbar at the bottom of your screen by default, and can be moved or dragged into a floating toolbar.
The X Root Taskbar only appears while an X client is actively listening for clicks on the X root window. If the X client goes away or stops listening for clicks, the X root taskbar goes away.
If this option is enabled in the configuration that defines the Web page you are using, an X Root Taskbar appears on the your Windows desktop.
This figure shows a detached xterm session managed by the mwm remote window manager.
-
Figure 5-3 . An xterm window with MWM window manager and X Root Taskbar
Since the mwm window manager requires you to be able to generate clicks on the root, WebTerm X displays an X root taskbar. This figure shows it dragged to the center of the screen as a floating toolbar and the pop-up menu that appears from a right-click.
Using the X Root Taskbar
To access pop-up menus (for example, the pop-up menu a window manager displays when a user clicks on the root), left, right, or middle-click on the stippled or colored region of the X Root Taskbar. The root menu that appears (and the click you use to see it) depends upon the window manager or X client application.
Moving and Resizing the X root taskbar
Just like the windows task bar, you can drag the edge to make it wider or thinner, or move it to the top, bottom, left or right of the desktop.
By dragging the X Root Taskbar by the WebTerm X icon toward the center of your display, you can detach it from the sides and move it to anyplace on the desktop. It becomes a "floating toolbar"
Showing and Hiding the X root taskbar
If an X Root Taskbar is displayed, but you want to turn it off, control it from the Windows taskbar notification area:
-
Figure 5-4 . The WebTerm X Background Application in the Task Bar Tray
- Right-click on the WebTerm X session icon in the taskbar notification area
- Select X Root Taskbar and toggle the check mark on or off to show or hide the X Root Task Bar
Embedded Versus Detached Client Windows
Embedded windows appear as a part of the browser window and are managed by it. Minimize a Web browser with an embedded X client window and the X client window minimizes as part of the browser; move the browser window and the embedded X client moves along with the browser.
Detached windows start outside of the browser. They are managed by the remote window manager (if one was started on the host) or by Microsoft Windows. Even if you close the browser, a detached X client windows remain open until you explicitly close them.
If you change the font size that an application uses in an embedded window, the size of the embedded window doesn't change. If a new font size makes you unable to see portions of the embedded window, you should as your administrator to set up this X client application as a detached window instead of an embedded one.
Embedded and Detached Client Windows
If an embedded X client window opens another window (such as a pop-up message or a dialog box where you need to enter more information), that window appears as a detached window on the Microsoft Windows desktop.
If the detached window seems to "disappear," that may be because it went "behind" another window on your desktop. Use your standard Microsoft Windows controls (ALT+TAB, the mouse) to bring the detached window back "to the top."
Dial-in Internet Connections
If you are using a dial-in Internet connection, make sure the connection is up and running before starting the Web browser. The TCP/IP connection must be running before you start the browser with the WebTerm X Power Plug-in installed.
If you start the Web browser first, and then the system dials and connects to the Internet, the WebTerm X connections won't work.
Powerlan Technical Support http://support.powerlan-usa.com/webtermx/
|
