___  __  _________ __  __     __ _________  _________  ______ 
        | |  | \ \__   __// / / /    / / \__   __/  \_  ____/ /  ___/
        | |  | |    | |   | | | |    | |    | |      |   _)_  \__ \
        |  \_/ |    | |   | | | |___ | |    | |      |      \ ___\ \
        \_____ |    | |   |_| |____/ |_|    | |     /_____  / \____/
              \/    |/                      |/            \/  

           (c) Lada 'Ray' Lostak (c) Orcave inc. (c) 1996-2000
Content:

  Enforcer

History:

  08/23/2002 Ray        - initial version


1.0. What it is good for
------------------------
Enforcer is component which allows foring other GUI application input/output and control them.
Enforcer is component, which is available in few applications.

1.1. Enfocer - console utility
------------------------------
Application using Enforcer component in GUI enviroment. It doesn't have any special features.

1.2. Enforcer script language
-----------------------------
Enforce fully uses Imagine scripting language which is extended about some functions:

    run(path_to_process)
        create new process and attach it

    attachImage(image_name)
        attach to process

    attachWindow([window_name])
        attach to window attached process

    attachChildCaption(window_caption)
    attachChildClass(class_name)
        attach to child window with given caption/class name

    keys("key codes to force")

        Key codes is list of 'characters' which are send to application. $ is special char. After $
        follows control directives. Character are not ASCII codes, but VIRUAL KEYS. It means, key
        code 'a' is unknown, only 'A' which represent phsycial 'A' key. Special directive is enclosed
        into '$' characters.

        Special directives:

            {:physical_ascii_text_sent_to_app}

            {ALT-----}
            {CTRL-----}
            {SHIFT----}
            {ENTER}
            {F1}
            ...
            {F12}

            where --- other key/special codes.

            Examples:

                ALT+O   -> "{ALT O}"
        

    wait(msecond_to_wait)
        wait given count of milliseconds

    end
        regualary end attached process
        
    kill
        kill attached process