[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        SendAmigaGuideContextA - Align an AmigaGuide system on the context ID
.
                                                               (V34)
   SYNOPSIS
        success = SendAmigaGuideContextA (handle, attrs);
        d0                                 a0      d0

        BOOL SendAmigaGuideContextA (AMIGAGUIDECONTEXT, struct TagItem *);

        success = SendAmigaGuideContext (handle, tag1, ...);

        BOOL SendAmigaGuideContext (AMIGAGUIDECONTEXT, Tag, ...);

   FUNCTION
        This function is used to send a message to an AmigaGuide system to
        align it on the current context ID.

        This function effectively does a:

            SendAmigaGuideCmd(handle 'LINK ContextArray[contextID]', NULL);

   INPUTS
        handle - Handle to an AmigaGuide system.
        future - Future expansion, must be set to NULL for now.

   EXAMPLE

        struct IntuiMessage *imsg;

        ...

        case RAWKEY:
            switch (imsg->Code)
            {
                case 95:
                    /* bring up help on a particular subject */
                    SendAmigaGuideContext(handle, NULL);
                    break;
                ...
            }
            break;

        ...

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

   SEE ALSO
        SetAmigaGuideContextA(), SendAmigaGuideCmdA()