Many of the text strings in this document act as buttons when the document is activated. To activate a document, make sure that the ButtonApplications package has been installed (type "Require PCedar ButtonApplications ButtonApplications" to install it). Open a fresh viewer on the document. A button should appear at the top of the Tioga viewer that looks like:

Left-clicking this button activates the document. Right-clicking the button deactivates the document. There are two alternative ways to activate a document. In Tioga, CTRL-L (for Lively) activates and CTRL-SHIFT-L deactivates. Also, the Activity button below activates and deactivates the window that has the current input focus.

You can copy buttons from this document to make control panels of your own. Also, the section on "Buttonizers" will help you turn Tioga and Gargoyle objects into buttons.

To edit a button, use the EditProperties mechanism in Tioga as follows: Select the node that contains the button that you would like to change. Type CTRL-U. Edit the ButtonData node property. Select the expanded nodes and type CTRL-SHIFT-U. Try out the new button. If you don't want to worry about accidentally pushing the button during this process, deactivate the document before editing it and re-activate it later.

You cannot currently edit the text of a button in place if you want the new text to be part of the button. You must expand the node with CTRL-U, edit the Text: line, select the expanded nodes and click CTRL-SHIFT-U. This problem will go away when Tioga has caret properties that work like caret looks. Alternatively, if the button was made by a buttonizer, just type the new text in place and apply the buttonizer a second time.

Patience. The first named multi-state button or radio button that you click in a document may take a while to work. EmbeddedButtons is searching through the document to see if any other buttons have the same name. Subsequent clicks will go faster.

This section contains a small number of examples of each of the four button types. Try them out. Remember to hold down the mouse on the pop-up buttons if you want to see the pop-up menu. The two-state and multi-state buttons change font to show their state. Only one of the radio buttons should be on at a time.

If a menu is provided, this menu is displayed. However, when the button is not linked to an application, left and middle mouse clicks cause the value to increase, right clicks cause the value to decrease, regardless of what the button will do once linked. For example: 14

The buttons in this section turn other objects into buttons. To use them, select a string of Tioga characters, then left-click on one of the buttons. A box will be added around the selected text string, and it will begin to act as a button (if the document in which it is embedded has been activated).

Each of these buttons is a pop-up menu that performs several Tioga editing macros. Select a text string and click a button. The buttons will change the appearance of the string.

 Font Face makes characters look plain, bold, italic, or bold and italic.

 Alphabet changes alphabet between latin (abcedefg...), greek (abcedefg...),
 and math (蝩CC��...).

 Font Size changes character size from small, to normal, to large, to extra large.

The "Boxes" button only works if the EditTool is loaded. Click here:

 EditTool

 Boxes applies a box of width zero, one, or two pixels to selected characters.

 Red Orange Yellow Green Cyan Blue Magenta Adds color to selected characters

These colors were chosen by trial and error by Eric Bier to be readable against a white background and easy to distinguish from each other and from black.

 Red Blue Green Orange Pink Yellow Brown Purple Adds one of the

Boynton colors to selected characters. These eight colors have been found to have names in many cultures. In addition, their color coordinates are chosen to maximize the probability that viewers will agree on their names.

 PropertyTransferButton Transfers its own character properties to the selected text.

 ShowPostfixProperty

 Reverse video reverses selected characters.

 Activity turns activity on or off in the selected Tioga viewer.

Russ Atkinson contributes this extensive set of Tioga macro buttons:

Get Gargoyle. -- forks a Commander to bring Gargoyle into /net/gharlane/cree/gargoyle/

These buttons start up Cedar applications.

DFTool -- The DFTool provides a window interface to Bringover and SModel commands.

EditTool -- The EditTool performs operations for searching and inspecting Tioga documents

Maintain. -- Starts up Maintain, a tool to update e-mail distribution lists

SummonerClient {on/off} -- Left click for On, right click for Off.

WalnutSend -- Creates a Walnut mail sender

Videotape Catalog -- Starts up an XNSChat window and opens Videotape browser documentation. [XNSChat does not work in PCedar.]

These buttons only work when the EditTool is loaded (press to load):

This button using QFind -o to open IODoc.tioga and scroll to a desired location. The file is only opened if the pattern is found.

QFind -o "4. Convert" /R/IODoc.tioga

This button always opens the file, even if the pattern isn't found:

open /R/IODoc.tioga; QFind -o "4. Convert" /R/IODoc.tioga

The next button scrolls to a specified position in IODoc.tioga, rather than searching for a string. The specified position includes comment nodes.

Search for Position 40344 in IODoc.tioga

MasterButton is a pop-up button that can control the multi-state buttons to its right. The shift and control keys determine which button is controled.

MasterButton  One Two Three

This TRUE/FALSE button is a multi-state button. It changes both is value and its appearance when pressed:

FALSE

This button is a pop-up button. It changes its text when pressed because its command applies to itself:

Blue

Print this file.-- prints the file containing this button on a choice of printers (see the menu for choices). Copy this button into any document you want to print.

Using the syntax <Send application1 arg1 arg2 arg3> instead of (arg1 arg2 arg3), it is possible for a button to send a message to an application other than the one mentioned in the MessageHandler: field. This pop-up button sends messages to different applications depending on which menu option is chosen:

Multi-Button

Using the syntax <Do expression1 expression2>, a button can perform two operations with a single click. The above button sends a message to the MessageWindow and a different message to the EmbeddedButtons Typescript when middle-clicked.

This button remembers the text that was selected last time it was right-clicked. It inserts this text at the current insertion point when left-clicked.

RememberText

This button remembers the file name that was selected last time it was right-clicked. It opens this file when left-clicked.

RememberFile

This button inserts the names of all of the implementors of EmbeddedButtons at the current Tioga insertion point. Left-click for grapevine names. Right-click for NS names:

EmbeddedButtons^

You need to create a lot of DF files in PCedar. Here's a button that opens forms for the four main DF files, in a selected directory. Make a Tioga selection of a directory (full path) name and click the button. Be sure that you have write permission in the selected directory.

MakeSuite

The ButtonOpen command (also provided by the ButtonApplications package) reads a DF file and displays its contents as a set of TiogaButtons, each of which opens a file. The following button starts up such a document on Gargoyle-Suite.df, Gargoyle-Source.df, or Gargoyle-PCR.df depending on which mouse button you press. The resulting document of file names opens files in the Gargoyle development directory when you left-click or the release directory when you right-click on the file names:

Gargoyle

Left-clicking this button executes an unregistered Commander command. Right-clicking executes a registered Commander command. Notice the difference in feedback.

Fail or Succeed

This (expanded) button shows an example of using a Tioga command that takes a string as an argument: