  -27-




  CHAPTER 2 / CONVENTIONS


  This chapter contains information about three conventions that are
  used throughout Take Command:  colors and color names,  keys and
  key names, and popup windows.  These topics are combined here so
  that they will be easy to find when you need to refer to them.
  You will find cross references to this chapter in several other
  parts of this manual.


  Colors and Color Names

       You can use color names in several of the directives in the
       .INI file and in many commands.  The general form of a color
       name is:

            [BRIght] fg ON [BRIght] bg

       where fg is the foreground or text color, bg is the
       background color.

       The available colors are:

            Black         Blue        Green          Red
            Magenta       Cyan        Yellow         White

       Color names and the word BRIght may be shortened to the first
       3 letters.

       You can also specify colors by number instead of by name.
       The numbers are most useful in potentially long .INI file
       directives like ColorDir , where using color names may take
       too much space.  The following numbers are recognized:

                    0 - Black        8 - Gray (bright black)
                    1 - Blue         9 - Bright blue
                    2 - Green        10 - Bright green
                    3 - Cyan         11 - Bright cyan
                    4 - Red          12 - Bright red
                    5 - Magenta      13 - Bright magenta
                    6 - Yellow       14 - Bright yellow
                    7 - White        15 - Bright white

       Use one number to substitute for the [BRIght] fg portion of
       the color name, and a second to substitute for the [BRIght]
       bg portion.  For example, instead of bright cyan on blue you
       could use 11 on 1 to save space in a ColorDir specification.

       The blinking text and border colors that are available with
       4DOS can not be used with Take Command.  This restriction is
       due to limitations inherent in Windows and OS/2, and in
       graphical displays.
  -28-



  Keys and Key Names

       Key names are used to define keystroke aliases, in several of
       the .INI file directives, and with the KEYSTACK command.  The
       format of a key name is the same in all three uses:

            [Prefix-]Keyname

       The key prefix can be left out, or it can be one of the
       following:

            Alt     followed by A - Z, 0 - 9, F1 - F12, or Bksp
            Ctrl    followed by A - Z, F1 - F12, Bksp, Tab, Enter,
                    Up, Down, Left, Right, PgUp, PgDn, Home, End,
                    Ins, or Del
            Shift   followed by F1 - F12 or Tab.

       The possible key names are:

            A - Z         Enter       PgDn
            0 - 9         Up          Home
            F1 - F12      Down        End
            Esc           Left        Ins
            Bksp          Right       Del
            Tab           PgUp

       All key names must be spelled as shown.  Alphabetic keys can
       be specified in upper-case or lower-case.  You cannot specify
       a punctuation key.

       The prefix and key name must be separated by a dash [-].  For
       example:

            Ctrl-F10       This is okay
            Ctrl F10       The space will cause an error

       If you prefer, you can use a numeric value instead of a key
       name.  Use the ASCII code for an ASCII, extended ASCII, or
       control character.  Use the scan code preceded by an at sign
       [@] for extended key codes like F1 or the cursor keys.  For
       example, use 13 for Enter, or @59 for F1.  In general, you
       will find it easier to use the names described above rather
       than key numbers.  See the online help for an explanation and
       list of ASCII and key codes.

       Some keys are intercepted by the operating system and are not
       passed on to Take Command.  For example, Alt-Esc and Ctrl-Esc
       typically pop up a tasklist or are used in switching among
       multiple tasks.  Keys which are intercepted by the operating
       system (including menu accelerators, i.e. Alt plus another
       key) generally cannot be assigned to aliases or with key
       mapping directives, because Take Command never receives these
       keystrokes and therefore cannot act on them.
  -29-



  Popup Windows

       Several features of Take Command display popup windows.  A
       popup window may be used to display filenames, recently-
       executed commands, recently-used directories, the results of
       an extended directory search, or a list created by the SELECT
       command or the @SELECT internal function.

       Popup windows always display a list of choices and a cursor
       bar.  You can move the cursor bar inside the window until you
       find the choice that you wish to make, then press the Enter
       key to select that item.

       Navigation inside any popup window follows the conventions
       described below.  Additional information on each specific
       type of popup window is provided when that window is
       introduced, later in the manual.

       You can control the position and size of most popup windows
       from the Command Line 2 page of the configuration dialogs, or
       with the PopupWinLeft, PopupWinTop, PopupWinWidth, and
       PopupWinHeight directives in the .INI file (see page 186).  A
       few popup windows (e.g., the extended directory search
       window) have their own specific .INI directives, and
       corresponding separate choices in the configuration dialogs.
       You can also change the keys used in most popup windows with
       key mapping directives in the .INI file (see page 186).

       Once a window is open, you can use these navigation keys to
       find the selection you wish to make:

            Up Arrow            Move the selection bar up one line.

            Down Arrow          Move the selection bar one line.

            Left Arrow          Scroll the display left 1 column, if
                                it is a scrolling display (i.e. if
                                it has a horizontal scrollbar).

            Right Arrow         Scroll the display right 1 column,
                                if it is a scrolling display (i.e.
                                if it has a horizontal scrollbar).

            PgUp                Scroll the display up one page.

            PgDn                Scroll the display down one page.

            Ctrl-PgUp or Home   Go to the beginning of the list.

            Ctrl-PgDn or End    Go to the end of the list.

            Esc                 Close the window without making a
                                selection.
  -30-



            Enter               Select the current item and close
                                the window.

       In addition to scrolling through a popup window, you can
       search the list using character matching.  If you press a
       character, the cursor bar will move to the next entry that
       begins with that character.  If you type multiple characters,
       the cursor will move to the entry that begins with the
       character string entered to that point (you can enter a
       search string up to 32 characters long).  If no entry matches
       the character or string that you have typed, Take Command
       beeps and does not move the cursor bar.  To reset the search
       string, press Backspace.

       You can change the keys used in popup windows with key
       mapping directives in the .INI file (see page 190).
