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 » SetAmigaGuideContextA

NAME

        SetAmigaGuideContextA - Set the context ID for an AmigaGuide system.
(V34)

SYNOPSIS

        success = SetAmigaGuideContextA ( handle, context, attrs );
d0 a0 d0 d1
BOOL SetAmigaGuideContextA (AMIGAGUIDECONTEXT, ULONG,
struct TagItem *);
success = SetAmigaGuideContext (handle, context, tag1, ...);
BOOL SetAmigaGuideContext (AMIGAGUIDECONTEXT, ULONG, Tag, ...);

FUNCTION

        This function, and the SendAmigaGuideContext() function, are used to
provide a simple way to display a node based on a numeric value,
instead of having to build up a slightly more complex command
string.

INPUTS

        handle -- Handle to an AmigaGuide system.
context -- Index value of the desired node to display.
future -- Future expansion, must be set to NULL for now.

EXAMPLE

        /* sample context table */
STRPTR ContextArray[] =
{
"MAIN",
"FILEREQ",
"PRINT",
"ABOUT",
NULL
};
/* quickie defines */
#define HELP_MAIN 0
#define HELP_FILEREQ 1
#define HELP_PRINT 2
#define HELP_ABOUT 3
...
struct NewAmigaGuide nag = {NULL};
/* initialize the context table */
nag.nag_Context = ContextArray;
...
/* bring up help on a particular subject */
SetAmigaGuideContext(handle, HELP_ABOUT, NULL);

RESULT

        success - Returns TRUE if a valid context ID was passed,
otherwise returns FALSE.

SEE ALSO

SendAmigaGuideContextA(), SendAmigaGuideCmdA()

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:

Rebels

PHA
RBS
FLT
AFL

Comments:

$VER: d0.se 1.13 Copyright © 2011-2017 Tobias Geijersson support at d0 dot se