a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 amigaguide.library
  --background--
  --rexxhost--
  AddAmigaGuideHostA
  AmigaGuideSignal
  CloseAmigaGuide
  GetAmigaGuideAttr
  GetAmigaGuideMsg
  GetAmigaGuideString
  LockAmigaGuideBase
  OpenAmigaGuideA
  OpenAmigaGuideAsyncA
  RemoveAmigaGuideHostA
  ReplyAmigaGuideMsg
  SendAmigaGuideCmdA
  SendAmigaGuideContextA
  SetAmigaGuideAttrsA
  SetAmigaGuideContextA
  UnlockAmigaGuideBase
Include
GuruMeditation
Docs » Autodocs » amigaguide.library » SendAmigaGuideCmdA

NAME

        SendAmigaGuideCmdA - Send a command string to AmigaGuide (V34)

SYNOPSIS

        success = SendAmigaGuideCmdA (handle, cmd, attrs );
          d0                            a0    d0   d1
        BOOL SendAmigaGuideCmdA (AMIGAGUIDECONTEXT, STRPTR, struct TagItem *)
;
        success = SendAmigaGuideCmd (handle, cmd, tag1, ...);
        BOOL SendAmigaGuideCmd (AMIGAGUIDECONTEXT, STRPTR, Tag);

FUNCTION

        This function sends a command string to an AmigaGuide system.  The
        command can consist of any valid AmigaGuide action command.
        The following are the currently valid action commands:
        ALINK <name> - Load the named node into a new window.
        LINK <name> - Load the named node.
        RX <macro> - Execute an ARexx macro.
        RXS <cmd> - Execute an ARexx string file.  To display a picture,
            use 'ADDRESS COMMAND DISPLAY <picture name>', to
            display a text file 'ADDRESS COMMAND MORE <doc>'.
        CLOSE - Close the window (should only be used on windows
            that were started with ALINK).
        QUIT - Shutdown the current database.

INPUTS

        handle - Handle to an AmigaGuide system.
        cmd - Command string.
        attrs - Future expansion, must be set to NULL for now.

TAGS

        AGA_Context (ULONG) - Data is used as an index into nag_Context
            array.  This is used to build and send a LINK command.

EXAMPLE

        /* bring up help on a particular subject */
        SendAmigaGuideCmd(handle, "LINK MAIN", NULL);

RESULT

        Returns TRUE if the message was sent, otherwise returns FALSE.

BUGS

        ALINK does not open a new window when using V39.

SEE ALSO

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Horizon

HZ
SPB
AYS
DC

Comments:
$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se