home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 1 / Amiga Tools.iso / egs-tools / egs_dev-disk / egsdocs / egsgadbox.doc < prev    next >
Encoding:
Text File  |  1994-06-06  |  51.7 KB  |  2,297 lines
  1. TABLE OF CONTENTS
  2.  
  3. egsgadbox.library/EB_AddFirstSon
  4. egsgadbox.library/EB_AddLastSon
  5. egsgadbox.library/EB_AllocMemCon
  6. egsgadbox.library/EB_CWidth
  7. egsgadbox.library/EB_CalcGadgetGfx
  8. egsgadbox.library/EB_CalcMinMax
  9. egsgadbox.library/EB_CalcPositions
  10. egsgadbox.library/EB_CalcRealSize
  11. egsgadbox.library/EB_ConnectGadgets
  12. egsgadbox.library/EB_CreateActionGadget
  13. egsgadbox.library/EB_CreateArrow
  14. egsgadbox.library/EB_CreateArrowGfx
  15. egsgadbox.library/EB_CreateBackBorder
  16. egsgadbox.library/EB_CreateBoolGadget
  17. egsgadbox.library/EB_CreateBorder
  18. egsgadbox.library/EB_CreateBox
  19. egsgadbox.library/EB_CreateBoxedMultiText
  20. egsgadbox.library/EB_CreateButton24
  21. egsgadbox.library/EB_CreateButtonGadget
  22. egsgadbox.library/EB_CreateCenterText
  23. egsgadbox.library/EB_CreateCheckMarkGadget
  24. egsgadbox.library/EB_CreateDoubleBorder
  25. egsgadbox.library/EB_CreateDropGadget
  26. egsgadbox.library/EB_CreateFillBox
  27. egsgadbox.library/EB_CreateFrontBorder
  28. egsgadbox.library/EB_CreateGadContext
  29. egsgadbox.library/EB_CreateGroupBorder
  30. egsgadbox.library/EB_CreateHorizBox
  31. egsgadbox.library/EB_CreateHorizFill
  32. egsgadbox.library/EB_CreateHorizProp
  33. egsgadbox.library/EB_CreateHorizTable
  34. egsgadbox.library/EB_CreateInfoBox
  35. egsgadbox.library/EB_CreateIntegerGadget
  36. egsgadbox.library/EB_CreateLateBox
  37. egsgadbox.library/EB_CreateMaster
  38. egsgadbox.library/EB_CreateMasterWindow
  39. egsgadbox.library/EB_CreateMultiAction
  40. egsgadbox.library/EB_CreateMultiAction2
  41. egsgadbox.library/EB_CreateMultiActionV
  42. egsgadbox.library/EB_CreateMultiText
  43. egsgadbox.library/EB_CreateNameIntegerGadget
  44. egsgadbox.library/EB_CreateNameRealGadget
  45. egsgadbox.library/EB_CreateNameStringGadget
  46. egsgadbox.library/EB_CreateRealGadget
  47. egsgadbox.library/EB_CreateResponseBox
  48. egsgadbox.library/EB_CreateStringGadget
  49. egsgadbox.library/EB_CreateSuperHorizProp
  50. egsgadbox.library/EB_CreateSuperVertiProp
  51. egsgadbox.library/EB_CreateText
  52. egsgadbox.library/EB_CreateTextAction
  53. egsgadbox.library/EB_CreateTextBoolean
  54. egsgadbox.library/EB_CreateUText
  55. egsgadbox.library/EB_CreateVertiBox
  56. egsgadbox.library/EB_CreateVertiFill
  57. egsgadbox.library/EB_CreateVertiProp
  58. egsgadbox.library/EB_CreateVertiTable
  59. egsgadbox.library/EB_CreateWindow
  60. egsgadbox.library/EB_DeleteGadContext
  61. egsgadbox.library/EB_FindGadget
  62. egsgadbox.library/EB_FreeMemCon
  63. egsgadbox.library/EB_GetStringData
  64. egsgadbox.library/EB_LinkStringGadgets
  65. egsgadbox.library/EB_LinkStringGadgetsID
  66. egsgadbox.library/EB_MAX
  67. egsgadbox.library/EB_MIN
  68. egsgadbox.library/EB_NewFixHeight
  69. egsgadbox.library/EB_NewFixWidth
  70. egsgadbox.library/EB_NewHotKey
  71. egsgadbox.library/EB_NewMaxHeight
  72. egsgadbox.library/EB_NewMaxWidth
  73. egsgadbox.library/EB_NewMinHeight
  74. egsgadbox.library/EB_NewMinWidth
  75. egsgadbox.library/EB_NewPri
  76. egsgadbox.library/EB_NewSameSize
  77. egsgadbox.library/EB_ProcessGadBoxes
  78. egsgadbox.library/EB_ProcessGadBoxesSize
  79. egsgadbox.library/EB_PutIntData
  80. egsgadbox.library/EB_PutRealData
  81. egsgadbox.library/EB_PutStringData
  82. egsgadbox.library/EB_SMatch
  83. egsgadbox.library/EB_SWidth
  84. egsgadbox.library/EB_SetPropBackMap
  85. egsgadbox.library/EB_WriteInfoBox
  86. egsgadbox.library/EB_WriteInfoBoxInt
  87.  
  88. egsgadbox.library/EB_AddFirstSon             egsgadbox.library/EB_AddFirstSon
  89.  
  90.    NAME
  91.     EB_AddFirstSon -- Add son to gadbox
  92.  
  93.    SYNOPSIS
  94.     EB_AddFirstSon(father, son)
  95.                    A0      A1
  96.  
  97.     void EB_AddFirstSon(EB_GadBoxPtr, EB_GadBoxPtr)
  98.  
  99.    FUNCTION
  100.     Add an gadbox as first son to an other gadbox.
  101.  
  102.    INPUTS
  103.     father       -
  104.     son          -
  105.  
  106.    RESULT
  107.  
  108.    SEE ALSO
  109.  
  110.  
  111. egsgadbox.library/EB_AddLastSon               egsgadbox.library/EB_AddLastSon
  112.  
  113.    NAME
  114.     EB_AddLastSon -- Add son to gadbox
  115.  
  116.    SYNOPSIS
  117.     EB_AddLastSon(father, son)
  118.                   A0      A1
  119.  
  120.     void EB_AddLastSon(EB_GadBoxPtr, EB_GadBoxPtr)
  121.  
  122.    FUNCTION
  123.     Add an gadbox as last son to an other gadbox.
  124.  
  125.    INPUTS
  126.     father       -
  127.     son          -
  128.  
  129.    RESULT
  130.  
  131.    SEE ALSO
  132.  
  133.  
  134. egsgadbox.library/EB_AllocMemCon             egsgadbox.library/EB_AllocMemCon
  135.  
  136.    NAME
  137.     EB_AllocMemCon -- Allocate memory to context
  138.  
  139.    SYNOPSIS
  140.     EB_AllocMemCon(con, size)
  141.                    A0   D0
  142.  
  143.     APTR EB_AllocMemCon(EB_ContextPtr, LONG)
  144.  
  145.    FUNCTION
  146.     Allocate memory which is tracked using a context. The memory must be
  147.     freed using EB_FreeMemCon or using EB_DeleteGadContext.
  148.  
  149.    INPUTS
  150.     con     : pointer to context
  151.     size    : size in bytes
  152.  
  153.    RESULT
  154.     pointer to memory or NULL if failed
  155.  
  156.    SEE ALSO
  157.  
  158.  
  159. egsgadbox.library/EB_CWidth                       egsgadbox.library/EB_CWidth
  160.  
  161.    NAME
  162.     EB_CWidth -- evaluate width of character
  163.  
  164.    SYNOPSIS
  165.     EB_CWidth(char, font)
  166.               D2    A1
  167.  
  168.     WORD EB_CWidth(char, EG_EFontPtr)
  169.  
  170.    FUNCTION
  171.     Evaluates the width of one character.
  172.  
  173.    INPUTS
  174.     char         -
  175.     font         -
  176.  
  177.    RESULT
  178.  
  179.    SEE ALSO
  180.  
  181.  
  182. egsgadbox.library/EB_CalcGadgetGfx         egsgadbox.library/EB_CalcGadgetGfx
  183.  
  184.    NAME
  185.     EB_CalcGadgetGfx -- calculate gadgets graphics
  186.  
  187.    SYNOPSIS
  188.     EB_CalcGadgetGfx(con, box)
  189.                      A0   A1
  190.  
  191.     ULONG EB_CalcGadgetGfx(EB_GadContext, EB_GadBoxPtr)
  192.  
  193.    FUNCTION
  194.     Calculates and creates the rendering commands for the gadgets (see
  195.     also EB_ProcessGadBoxes). Normaly you need not call this function, as
  196.     it is part of EB_ProcessGadBoxes.
  197.  
  198.    INPUTS
  199.     con   : pointer to gadget context
  200.     box   : pointer to root of gadbox tree
  201.  
  202.    RESULT
  203.     FALSE if fails, see con->error field for more information
  204.  
  205.    SEE ALSO
  206.  
  207.  
  208. egsgadbox.library/EB_CalcMinMax               egsgadbox.library/EB_CalcMinMax
  209.  
  210.    NAME
  211.     EB_CalcMinMax -- calculates gadgets min and max
  212.  
  213.    SYNOPSIS
  214.     EB_CalcMinMax(box)
  215.                   A0
  216.  
  217.     ULONG EB_CalcMinMax(EB_GadBoxPtr)
  218.  
  219.    FUNCTION
  220.     Calculates the real minimum and maximum values of a gadbox tree,
  221.     according to their given min and max values. Normaly you need not
  222.     call this function, as it is part of EB_ProcessGadBoxes.
  223.  
  224.    INPUTS
  225.     box  : pointer to root of gadbox tree
  226.  
  227.    RESULT
  228.     FALSE if fails, see con->error field for more informations
  229.  
  230.    SEE ALSO
  231.  
  232.  
  233. egsgadbox.library/EB_CalcPositions         egsgadbox.library/EB_CalcPositions
  234.  
  235.    NAME
  236.     EB_CalcPositions -- calculate gadgets position
  237.  
  238.    SYNOPSIS
  239.     EB_CalcPositions(box, x, y)
  240.                      A0   D0 D1
  241.  
  242.     ULONG EB_CalcPositions(EB_GadBoxPtr, WORD, WORD)
  243.  
  244.    FUNCTION
  245.     Calculates the real positions of gadgets and rendering of a gadbox
  246.     tree, according to their minimal sizes. Normaly you need not call
  247.     this function, as it is part of EB_ProcessGadBoxes.
  248.  
  249.    INPUTS
  250.     box    : pointer to root of gadbox tree
  251.     x, y   : upper left relative coordinates
  252.  
  253.    RESULT
  254.     FALSE if fails, see con->error field for more informations
  255.  
  256.    SEE ALSO
  257.  
  258.  
  259. egsgadbox.library/EB_CalcRealSize           egsgadbox.library/EB_CalcRealSize
  260.  
  261.    NAME
  262.     EB_CalcRealSize -- calculate gadgets sizes
  263.  
  264.    SYNOPSIS
  265.     EB_CalcRealSize(box)
  266.                     A0
  267.  
  268.     ULONG EB_CalcRealSize(EB_GadBoxPtr)
  269.  
  270.    FUNCTION
  271.     Calculates the real size of every member in a gadbox tree, according
  272.     to their minimal and maximal values. Normaly you need not call this
  273.     function, as it is part of EB_ProcessGadBoxes.
  274.  
  275.    INPUTS
  276.     box    : pointer to root of gadbox tree
  277.  
  278.    RESULT
  279.     FALSE if fails, see con->error field for more informations
  280.  
  281.    SEE ALSO
  282.  
  283.  
  284. egsgadbox.library/EB_ConnectGadgets       egsgadbox.library/EB_ConnectGadgets
  285.  
  286.    NAME
  287.     EB_ConnectGadgets -- connect gadgets of gadbox tree
  288.  
  289.    SYNOPSIS
  290.     EB_ConnectGadgets(box, first, num)
  291.                       A0   A1     A2
  292.  
  293.     void EB_ConnectGadgets(EB_GadBoxPtr, EI_GadgetPtr *, WORD *)
  294.  
  295.    FUNCTION
  296.     Connects the gadgets of a gadbox tree to a gadget list (or tree if
  297.     master gadgets are used). Normaly you need not call this function, as
  298.     it is part of EB_ProcessGadBoxes.
  299.  
  300.    INPUTS
  301.     box     : pointer to root of gadbox tree
  302.     first   : pointer to EI_GadgetPtr, in which to store the first gadget
  303.     num     : pointer to WORD, in which to store the number of primary gadgets
  304.  
  305.    RESULT
  306.  
  307.    SEE ALSO
  308.  
  309.  
  310. egsgadbox.library/EB_CreateActionGadgetegsgadbox.library/EB_CreateActionGadget
  311.  
  312.    NAME
  313.     EB_CreateActionGadget -- create an action gadget
  314.  
  315.    SYNOPSIS
  316.     EB_CreateActionGadget(con, width, id)
  317.                           A0   A1     D0
  318.  
  319.     EB_GadBoxPtr EB_CreateActionGadget(EB_GadContext, EB_GadBoxPtr, LONG)
  320.  
  321.    FUNCTION
  322.     Creates an action gadget around a gadbox subtree using the id. The
  323.     subtree may only contain rendering information, which is used for the
  324.     gadgets active field. The gadget has flag EI_stdHighlight set, so you
  325.     need no extra border around the gadget.
  326.  
  327.    INPUTS
  328.     con   : pointer to gadcontext
  329.     with  : subtree, describing the gadgets graphic
  330.     id    : gadgets id
  331.  
  332.    RESULT
  333.     NULL if fails, else pointer to new subtree
  334.  
  335.    SEE ALSO
  336.  
  337.  
  338. egsgadbox.library/EB_CreateArrow             egsgadbox.library/EB_CreateArrow
  339.  
  340.    NAME
  341.     EB_CreateArrow -- create an arrow gadget
  342.  
  343.    SYNOPSIS
  344.     EB_CreateArrow(con, dest, id)
  345.                    A0   D0    D1
  346.  
  347.     EB_GadBoxPtr EB_CreateArrow(EB_GadContext, WORD, LONG)
  348.  
  349.    FUNCTION
  350.     Creates an arrow gadget, pointing in direction dest (see
  351.     EI_arrow..).
  352.  
  353.    INPUTS
  354.     con   : pointer to gadcontext
  355.     dest  : pointers destination
  356.     id    : gadgets id
  357.  
  358.    RESULT
  359.     NULL if fails, else pointer to new subtree
  360.  
  361.    SEE ALSO
  362.  
  363.  
  364. egsgadbox.library/EB_CreateArrowGfx       egsgadbox.library/EB_CreateArrowGfx
  365.  
  366.    NAME
  367.     EB_CreateArrowGfx -- creates an arrow
  368.  
  369.    SYNOPSIS
  370.     EB_CreateArrowGfx(con, dest)
  371.                       A0   D0
  372.  
  373.     EB_GadBoxPtr EB_CreateArrowGfx(EB_GadContext, UBYTE)
  374.  
  375.    FUNCTION
  376.     Creates the graphics for an arrow, pointing in direction dest (see
  377.     EI_arrow..).
  378.  
  379.    INPUTS
  380.     con   : pointer to gadcontext
  381.     dest  : pointers destination
  382.  
  383.    RESULT
  384.     NULL if fails, else pointer to new subtree
  385.  
  386.    SEE ALSO
  387.  
  388.  
  389. egsgadbox.library/EB_CreateBackBorder   egsgadbox.library/EB_CreateBackBorder
  390.  
  391.    NAME
  392.     EB_CreateBackBorder -- creates a back border
  393.  
  394.    SYNOPSIS
  395.     EB_CreateBackBorder(con, around, fill)
  396.                         A0   A1      D0
  397.  
  398.     EB_GadBoxPtr EB_CreateBackBorder(EB_GadContext, EB_GadBoxPtr, UBYTE)
  399.  
  400.    FUNCTION
  401.     Creates a border which seems to go into the screen around an
  402.     existing gadbox subtree. This function also creates a little space
  403.     between the inner graphics and the border.
  404.  
  405.    INPUTS
  406.     con    : pointer to gadcontext
  407.     around : subtree, around which to build the border
  408.     fill   : flags, which determine, if the borderspace is allowed to expand
  409.        if needed
  410.  
  411.    RESULT
  412.     NULL if fails, else pointer to new subtree
  413.  
  414.    SEE ALSO
  415.  
  416.  
  417. egsgadbox.library/EB_CreateBoolGadget   egsgadbox.library/EB_CreateBoolGadget
  418.  
  419.    NAME
  420.     EB_CreateBoolGadget -- create boolean gadget
  421.  
  422.    SYNOPSIS
  423.     EB_CreateBoolGadget(con , with, id)
  424.                         A0    A1    D0
  425.  
  426.     EB_GadBoxPtr EB_CreateBoolGadget(EB_GadContext, EB_GadBoxPtr, LONG)
  427.  
  428.    FUNCTION
  429.     Creates an boolean gadget around a gadbox subtree using the id. The
  430.     subtree may only contain rendering information, which is used for the
  431.     gadgets active field. The gadget has flag EI_stdHighlight set, so you
  432.     need no extra border around the gadget.
  433.  
  434.    INPUTS
  435.     con   : pointer to gadcontext
  436.     with  : subtree, describing the gadgets graphic
  437.     id    : gadgets id
  438.  
  439.    RESULT
  440.     NULL if fails, else pointer to new subtree
  441.  
  442.    SEE ALSO
  443.  
  444.  
  445. egsgadbox.library/EB_CreateBorder           egsgadbox.library/EB_CreateBorder
  446.  
  447.    NAME
  448.     EB_CreateBorder -- create space around graphics
  449.  
  450.    SYNOPSIS
  451.     EB_CreateBorder(con, around, fill)
  452.                     A0   A1      D0
  453.  
  454.     EB_GadBoxPtr EB_CreateBorder(EB_GadContext, EB_GadBoxPtr, UBYTE)
  455.  
  456.    FUNCTION
  457.     Creates a little space around a subtree on each side.
  458.  
  459.    INPUTS
  460.     con    : pointer to gadcontext
  461.     around : subtree, around which to build the border
  462.     fill   : flags, which determine, if the borderspace is allowed to expand
  463.        if needed
  464.  
  465.    RESULT
  466.     NULL if fails, else pointer to new subtree
  467.  
  468.    SEE ALSO
  469.  
  470.  
  471. egsgadbox.library/EB_CreateBox                 egsgadbox.library/EB_CreateBox
  472.  
  473.    NAME
  474.     EB_CreateBox -- create gadbox
  475.  
  476.    SYNOPSIS
  477.     EB_CreateBox(con, orient, minWidth, maxWidth, minHeight, maxHeight)
  478.                  A0   D0      D1        D2        D3         D4
  479.  
  480.     EB_GadBoxPtr EB_CreateBox(EB_GadContext, UBYTE, WORD, WORD, WORD, WORD)
  481.  
  482.    FUNCTION
  483.     Creates a simple gadbox.
  484.  
  485.    INPUTS
  486.     con      : pointer to gadcontext
  487.     orient   : orientation of the gadbox:
  488.         EB_horizontal  : the box may have several sons, which are
  489.                  ordered horizontal
  490.         EB_vertical    : the box may have several sons, which are
  491.                  ordered vertical
  492.         EB_unknown     : the box may have only one son
  493.         EB_horizTable  : the box may have several sons, whih may
  494.                  either be unknown, or vertical. All vertical
  495.                  sons must have the same number of sons,
  496.                  because the grandsons are ordered in a table.
  497.         EB_vertiTable  : the box may have several sons, whih may
  498.                  either be unknown, or horizontal. All
  499.                  horizontal sons must have the same number of
  500.                  sons, because the grandsons are ordered in a
  501.                  table.
  502.         EB_select      : the box may have several sons, which all lay
  503.                  at the same location.
  504.  
  505.     minWidth,
  506.     minHeight : minimal size of the box, EB_min for any
  507.     maxWidth,
  508.     maxHeight : maximal size of the box, EB_max for any
  509.  
  510.    RESULT
  511.     NULL if fails, else pointer to new gadbox
  512.  
  513.    SEE ALSO
  514.  
  515.  
  516. egsgadbox.library/EB_CreateBoxedMultiTextegsgadbox.library/EB_CreateBoxedMultiText
  517.  
  518.    NAME
  519.     EB_CreateBoxedMultiText -- create text in box
  520.  
  521.    SYNOPSIS
  522.     EB_CreateBoxedMultiText(con, text)
  523.                             A0   A1
  524.  
  525.     EB_GadBoxPtr EB_CreateBoxedMultiText(EB_GadContext, EB_StrArrayPtr)
  526.  
  527.    FUNCTION
  528.     Creates several lines of text in a back bordered box.
  529.  
  530.    INPUTS
  531.     con    : pointer to gadcontext
  532.     text   : Array of pointers to strings, which build the lines. The last entry
  533.        must contain NULL, for termination.
  534.  
  535.    RESULT
  536.     NULL if fails, else pointer to new subtree
  537.  
  538.    SEE ALSO
  539.  
  540.  
  541. egsgadbox.library/EB_CreateButton24       egsgadbox.library/EB_CreateButton24
  542.  
  543.    NAME
  544.     EB_CreateButton24 -- creates 24 bit button
  545.  
  546.    SYNOPSIS
  547.     EB_CreateButton24(con, around, color, back, fill)
  548.                       A0   A1      D0     D1    D2
  549.  
  550.     EB_GadBoxPtr EB_CreateButton24(EB_GadContext, EB_GadBoxPtr, ULONG, ULONG, UBYTE)
  551.  
  552.    FUNCTION
  553.     Creates the graphics for a special three dimensional button, which
  554.     may be used for bool or action gadgets.
  555.  
  556.    INPUTS
  557.     con     : pointer to gad context
  558.     around  : the buttons text or image
  559.     color   : the buttons color
  560.     back    : the color of the background, surrounding the button
  561.     fill    : flags, defining where to fill around the image
  562.  
  563.    RESULT
  564.     NULL if fails, else pointer to new subtree
  565.  
  566.    SEE ALSO
  567.  
  568.  
  569. egsgadbox.library/EB_CreateButtonGadgetegsgadbox.library/EB_CreateButtonGadget
  570.  
  571.    NAME
  572.     EB_CreateButtonGadget -- creates a round radio button
  573.  
  574.    SYNOPSIS
  575.     EB_CreateButtonGadget(context, id)
  576.                           A0       D0
  577.  
  578.     EB_GadBoxPtr EB_CreateButtonGadget(EB_GadContext, LONG)
  579.  
  580.    FUNCTION
  581.     Creates the gadget and graphics for a radio gadget, that is a round
  582.     3d style gadget with a center that is filled on activation. Normally
  583.     these are used in the radio buttons (gbradio.library).
  584.  
  585.    INPUTS
  586.     con     : pointer to gad context
  587.     id      : id of the gadget
  588.  
  589.    RESULT
  590.     box     : the resulting box or NULL if fails
  591.  
  592.    SEE ALSO
  593.  
  594.  
  595. egsgadbox.library/EB_CreateCenterText   egsgadbox.library/EB_CreateCenterText
  596.  
  597.    NAME
  598.     EB_CreateCenterText -- create centered text
  599.  
  600.    SYNOPSIS
  601.     EB_CreateCenterText(con, str)
  602.                         A0   A1
  603.  
  604.     EB_GadBoxPtr EB_CreateCenterText(EB_GadContext, char *)
  605.  
  606.    FUNCTION
  607.     Creates a text that is centered using surrounding boxes.
  608.  
  609.    INPUTS
  610.     con          -
  611.     str          -
  612.  
  613.    RESULT
  614.     NULL if fails, else pointer to new subtree
  615.  
  616.    SEE ALSO
  617.  
  618.  
  619. egsgadbox.library/EB_CreateCheckMarkGadgetegsgadbox.library/EB_CreateCheckMarkGadget
  620.  
  621.    NAME
  622.     EB_CreateCheckMarkGadget -- make a checkmark gadget
  623.  
  624.    SYNOPSIS
  625.     EB_CreateCheckMarkGadget(context, id)
  626.                              A0       D0
  627.  
  628.     EB_GadBoxPtr EB_CreateCheckMarkGadget(EB_GadContext, LONG)
  629.  
  630.    FUNCTION
  631.     Creates an boolean gadget with a graphic that looks like a
  632.     check-mark. This gadget starts in the off state and comes complete
  633.     with border and everything.
  634.  
  635.    INPUTS
  636.     con   : pointer to gadcontext
  637.     with  : subtree, describing the gadgets graphic
  638.     id    : gadgets id
  639.  
  640.    RESULT
  641.     NULL if fails, else pointer to new subtree
  642.  
  643.    SEE ALSO
  644.  
  645.  
  646. egsgadbox.library/EB_CreateDoubleBorderegsgadbox.library/EB_CreateDoubleBorder
  647.  
  648.    NAME
  649.     EB_CreateDoubleBorder -- create double border
  650.  
  651.    SYNOPSIS
  652.     EB_CreateDoubleBorder(con, around, fill)
  653.                           A0   A1      D0
  654.  
  655.     EB_GadBoxPtr EB_CreateDoubleBorder(EB_GadContext, EB_GadBoxPtr, UBYTE)
  656.  
  657.    FUNCTION
  658.     Creates a double border, normaly used for string/integer gadgets.
  659.  
  660.    INPUTS
  661.     con          -
  662.     around       -
  663.     fill         -
  664.  
  665.    RESULT
  666.     NULL if fails, else pointer to new subtree
  667.  
  668.    SEE ALSO
  669.  
  670.  
  671. egsgadbox.library/EB_CreateDropGadget   egsgadbox.library/EB_CreateDropGadget
  672.  
  673.    NAME
  674.     EB_CreateDropGadget --
  675.  
  676.    SYNOPSIS
  677.     EB_CreateDropGadget(con, with, accept, flags, id)
  678.                         A0   A1    A2      D0     D1
  679.  
  680.     EB_GadBoxPtr EB_CreateDropGadget(EB_GadContext, EB_GadBoxPtr, EI_AcceptListPtr, ULONG, LONG)
  681.  
  682.    FUNCTION
  683.  
  684.    INPUTS
  685.     con          -
  686.     with         -
  687.     accept       -
  688.     flags        -
  689.     id           -
  690.  
  691.    RESULT
  692.  
  693.    SEE ALSO
  694.  
  695.  
  696. egsgadbox.library/EB_CreateFillBox         egsgadbox.library/EB_CreateFillBox
  697.  
  698.    NAME
  699.     EB_CreateFillBox -- create fill box
  700.  
  701.    SYNOPSIS
  702.     EB_CreateFillBox(con, pri)
  703.                      A0   D0
  704.  
  705.     EB_GadBoxPtr EB_CreateFillBox(EB_GadContext, BYTE)
  706.  
  707.    FUNCTION
  708.     Creates a box, that can fill unused areas. It can be used for
  709.     spacing around fixed sized images when changing font size.
  710.  
  711.    INPUTS
  712.     con          -
  713.     pri          -
  714.  
  715.    RESULT
  716.     NULL if fails, else pointer to new subtree
  717.  
  718.    SEE ALSO
  719.  
  720.  
  721. egsgadbox.library/EB_CreateFrontBorder egsgadbox.library/EB_CreateFrontBorder
  722.  
  723.    NAME
  724.     EB_CreateFrontBorder -- creates a front border
  725.  
  726.    SYNOPSIS
  727.     EB_CreateFrontBorder(con, around, fill)
  728.                          A0   A1      D0
  729.  
  730.     EB_GadBoxPtr EB_CreateFrontBorder(EB_GadContext, EB_GadBoxPtr, UBYTE)
  731.  
  732.    FUNCTION
  733.     Creates a border which seems to come out of the screen around an
  734.     existing gadbox subtree. This function also creates a little space
  735.     between the inner graphics and the border.
  736.  
  737.    INPUTS
  738.     con    : pointer to gadcontext
  739.     around : subtree, around which to build the border
  740.     fill   : flags, that determine, if the borderspace is allowed to expand
  741.        if needed
  742.  
  743.    RESULT
  744.     NULL if fails, else pointer to new subtree
  745.  
  746.    SEE ALSO
  747.  
  748.  
  749. egsgadbox.library/EB_CreateGadContext   egsgadbox.library/EB_CreateGadContext
  750.  
  751.    NAME
  752.     EB_CreateGadContext -- create gadget context
  753.  
  754.    SYNOPSIS
  755.     EB_CreateGadContext(font, tfont, color, back)
  756.                         A0    A1     D0     D1
  757.  
  758.     EB_GadContext EB_CreateGadContext(EG_EFontPtr, EG_EFontPtr, LONG, LONG)
  759.  
  760.    FUNCTION
  761.     Creates a gadget context. This structure keeps track of all
  762.     structures that are allocated to create a gadbox tree, and all
  763.     gadgets and substructures. This structure also contains information
  764.     obout the fonts and colors of the gadgets. The structure has to be
  765.     deleted using EB_DeleteGadContext, after the requester/window has
  766.     been closed. This will also delete all associated structures and
  767.     gadgets.
  768.  
  769.    INPUTS
  770.     font     : normal font, if NULL the system window font is used
  771.     tfont    : text gadget font, if NULL the system default font is used
  772.     color,
  773.     back     : colors for 24 bit gadgets, -1 if normal gadgets are to be used
  774.  
  775.    RESULT
  776.     NULL if fails, else pointer to new gadget context
  777.  
  778.    SEE ALSO
  779.  
  780.  
  781. egsgadbox.library/EB_CreateGroupBorder egsgadbox.library/EB_CreateGroupBorder
  782.  
  783.    NAME
  784.     EB_CreateGroupBorder -- creates a nice looking border with text around a box
  785.  
  786.    SYNOPSIS
  787.     EB_CreateGroupBorder(con, around, fill, name)
  788.                          A0   A1      D0    A2
  789.  
  790.     EB_GadBoxPtr EB_CreateGroupBorder(EB_GadContext, EB_GadBoxPtr, LONG, char *)
  791.  
  792.    FUNCTION
  793.     This function will create a 3D border around a box. The top line will
  794.     be broken in the middle and in that break, the name is displayed,
  795.     like this:        +---- Name ----+                |              |
  796.     | Box Contents |                |              |                +--------------+
  797.  
  798.    INPUTS
  799.     con    : pointer to gadcontext
  800.     around : pointer to the interior
  801.     fill   : where you want fill space
  802.     name   : null-terminated string
  803.  
  804.    RESULT
  805.     NULL if fails, else pointer to new subtree
  806.  
  807.    SEE ALSO
  808.  
  809.  
  810. egsgadbox.library/EB_CreateHorizBox       egsgadbox.library/EB_CreateHorizBox
  811.  
  812.    NAME
  813.     EB_CreateHorizBox -- creates horizontal box
  814.  
  815.    SYNOPSIS
  816.     EB_CreateHorizBox(con)
  817.                       A0
  818.  
  819.     EB_GadBoxPtr EB_CreateHorizBox(EB_GadContext)
  820.  
  821.    FUNCTION
  822.     Creates a box that combines several other boxes horizontal. All son
  823.     boxes of a horizontal box are places one besides the other, and build
  824.     a row.
  825.  
  826.    INPUTS
  827.     con    : pointer to gadcontext
  828.  
  829.    RESULT
  830.     NULL if fails, else pointer to new subtree
  831.  
  832.    SEE ALSO
  833.  
  834.  
  835. egsgadbox.library/EB_CreateHorizFill     egsgadbox.library/EB_CreateHorizFill
  836.  
  837.    NAME
  838.     EB_CreateHorizFill -- create horizontal pad
  839.  
  840.    SYNOPSIS
  841.     EB_CreateHorizFill(con, fill, pri)
  842.                        A0   D0    D1
  843.  
  844.     EB_GadBoxPtr EB_CreateHorizFill(EB_GadContext, ULONG, BYTE)
  845.  
  846.    FUNCTION
  847.     Creates a fill element for horizontal boxes. This should be used, to
  848.     separate gadgets or gadget groups, or to create paddings betweeen
  849.     borders.
  850.  
  851.    INPUTS
  852.     con    : pointer to gadcontext
  853.     fill   : flag, that determines, if the fill box is allowed to expand if needed
  854.     pri    : the boxes priority
  855.  
  856.    RESULT
  857.     NULL if fails, else pointer to new subtree
  858.  
  859.    SEE ALSO
  860.  
  861.  
  862. egsgadbox.library/EB_CreateHorizProp     egsgadbox.library/EB_CreateHorizProp
  863.  
  864.    NAME
  865.     EB_CreateHorizProp -- create horizontal propgadget
  866.  
  867.    SYNOPSIS
  868.     EB_CreateHorizProp(con, maximum, size, val, id)
  869.                        A0   D0       D1    D2   D3
  870.  
  871.     EB_GadBoxPtr EB_CreateHorizProp(EB_GadContext, WORD, WORD, WORD, LONG)
  872.  
  873.    FUNCTION
  874.     Creates a horizontal proportional gadget, and all needed graphics.
  875.  
  876.    INPUTS
  877.     con      : pointer to gadcontext
  878.     maximum  : maximum value of slider
  879.     size     : size of slider
  880.     val      : value of slider
  881.     id       : the gadgets id
  882.  
  883.    RESULT
  884.     NULL if fails, else pointer to new subtree
  885.  
  886.    SEE ALSO
  887.  
  888.  
  889. egsgadbox.library/EB_CreateHorizTable   egsgadbox.library/EB_CreateHorizTable
  890.  
  891.    NAME
  892.     EB_CreateHorizTable -- create horizontal table
  893.  
  894.    SYNOPSIS
  895.     EB_CreateHorizTable(con)
  896.                         A0
  897.  
  898.     EB_GadBoxPtr EB_CreateHorizTable(EB_GadContext)
  899.  
  900.    FUNCTION
  901.     Creates a horizontal table, that may contain several vertical boxes,
  902.     and arranges their elements in a table.
  903.  
  904.    INPUTS
  905.     con          -
  906.  
  907.    RESULT
  908.     NULL if fails, else pointer to new subtree
  909.  
  910.    SEE ALSO
  911.  
  912.  
  913. egsgadbox.library/EB_CreateInfoBox         egsgadbox.library/EB_CreateInfoBox
  914.  
  915.    NAME
  916.     EB_CreateInfoBox -- creates information box
  917.  
  918.    SYNOPSIS
  919.     EB_CreateInfoBox(con, info, font, minWidth, maxWidth, justify)
  920.                      A0   A1    A2    D0        D1        D2
  921.  
  922.     EB_GadBoxPtr EB_CreateInfoBox(EB_GadContext, EB_InfoBoxPtr, EG_EFontPtr, WORD, WORD, UBYTE)
  923.  
  924.    FUNCTION
  925.     Creates an information box. This type of box is used, to display
  926.     text in an allready rendered window/gadget. The function modifies a
  927.     given structure by setting real coordinates and real dimensions after
  928.     calculating.
  929.  
  930.    INPUTS
  931.     con       : pointer to gadcontext
  932.     info      : pointer to info box, that is modified
  933.     font      : font, in which to display the text
  934.     minWidth,
  935.     maxWidth  : minimum and maximum dimensions in characters
  936.     justify   : justification of displayed text
  937.  
  938.    RESULT
  939.     NULL if fails, else pointer to new gadbox
  940.  
  941.    SEE ALSO
  942.  
  943.  
  944. egsgadbox.library/EB_CreateIntegerGadgetegsgadbox.library/EB_CreateIntegerGadget
  945.  
  946.    NAME
  947.     EB_CreateIntegerGadget -- creates an integer gadget
  948.  
  949.    SYNOPSIS
  950.     EB_CreateIntegerGadget(con, minChar, digits, id)
  951.                            A0   D0       D1      D2
  952.  
  953.     EB_GadBoxPtr EB_CreateIntegerGadget(EB_GadContext, WORD, WORD, LONG)
  954.  
  955.    FUNCTION
  956.     Creates an integer gadget and associated graphics.
  957.  
  958.    INPUTS
  959.     con     : pointer to gad context
  960.     minChar : minimum number of chars to display
  961.     digits  : number of digits in integer number
  962.     id      : the gadgets id
  963.  
  964.    RESULT
  965.     NULL if fails, else pointer to new subtree
  966.  
  967.    SEE ALSO
  968.  
  969.  
  970. egsgadbox.library/EB_CreateLateBox         egsgadbox.library/EB_CreateLateBox
  971.  
  972.    NAME
  973.     EB_CreateLateBox -- create late calculation box
  974.  
  975.    SYNOPSIS
  976.     EB_CreateLateBox(con, create, minWidth, maxWidth, minHeight, maxHeight)
  977.                      A0   A1      D0        D1        D2         D3
  978.  
  979.     EB_GadBoxPtr EB_CreateLateBox(EB_GadContext, APTR, WORD, WORD, WORD, WORD)
  980.  
  981.    FUNCTION
  982.     Creates a late construction box. The interiour of this type of box
  983.     is created during calculation, by a call to EB_GBCreate. This
  984.     function is called with a pointer to the box in A0. At this time the
  985.     real size of the box is allready calculated and resides in
  986.     box->minWidth and box->maxWidth.
  987.  
  988.    INPUTS
  989.     con        : pointer to gad context
  990.     create     : constructor procedure.
  991.     minWidth,
  992.     minHeight  : minimal dimensions
  993.     maxWidth,
  994.     maxHeight  : maximum dimensions
  995.  
  996.    RESULT
  997.     NULL if fails, else pointer to new subtree
  998.  
  999.    SEE ALSO
  1000.  
  1001.  
  1002. egsgadbox.library/EB_CreateMaster           egsgadbox.library/EB_CreateMaster
  1003.  
  1004.    NAME
  1005.     EB_CreateMaster -- create a master gadget
  1006.  
  1007.    SYNOPSIS
  1008.     EB_CreateMaster(con, type, id)
  1009.                     A0   D0    D1
  1010.  
  1011.     EB_GadBoxPtr EB_CreateMaster(EB_GadContext, LONG, LONG)
  1012.  
  1013.    FUNCTION
  1014.     Creates a master gadget. A master gadget is a gadget, that contains
  1015.     several other gadgets. E.g. a prop gadget with arrows is a master
  1016.     gadget, containing to action gadgets an a normal prop gadget.
  1017.  
  1018.    INPUTS
  1019.     con     : pointer to gadget context
  1020.     type    : custom type id
  1021.     id      : gadget id
  1022.  
  1023.    RESULT
  1024.     NULL if fails, else pointer to new subtree
  1025.  
  1026.    SEE ALSO
  1027.  
  1028.  
  1029. egsgadbox.library/EB_CreateMasterWindowegsgadbox.library/EB_CreateMasterWindow
  1030.  
  1031.    NAME
  1032.     EB_CreateMasterWindow -- creates a master window
  1033.  
  1034.    SYNOPSIS
  1035.     EB_CreateMasterWindow(con, win, width)
  1036.                           A0   A1   A2
  1037.  
  1038.     EB_GadBoxPtr EB_CreateMasterWindow(EB_GadContext, EI_WindowPtr, EB_GadBoxPtr)
  1039.  
  1040.    FUNCTION
  1041.     Creates a window (or uses an exisiting one) that contains only one
  1042.     gadget, a master gadget, that includes all rendering and subgadgets,
  1043.     so it can easily be removed, resized, and added again.
  1044.  
  1045.    INPUTS
  1046.     con          -
  1047.     win          -
  1048.     width        -
  1049.  
  1050.    RESULT
  1051.     NULL if fails, else pointer to new tree
  1052.  
  1053.    SEE ALSO
  1054.  
  1055.  
  1056. egsgadbox.library/EB_CreateMultiAction egsgadbox.library/EB_CreateMultiAction
  1057.  
  1058.    NAME
  1059.     EB_CreateMultiAction -- creates several action gadgets
  1060.  
  1061.    SYNOPSIS
  1062.     EB_CreateMultiAction(con, names, ids, fill)
  1063.                          A0   A1     D0   D1
  1064.  
  1065.     EB_GadBoxPtr EB_CreateMultiAction(EB_GadContext, EB_StrArrayPtr, LONG, UBYTE)
  1066.  
  1067.    FUNCTION
  1068.     Creates several action gadgets in a row. The names of the gadgets
  1069.     must be supplied in an array of pointers to string. The last element
  1070.     in the array must be a NULL for termination.
  1071.  
  1072.    INPUTS
  1073.     con    : pointer to gadget context
  1074.     names  : pointer to array of pointers to string.
  1075.     ids    : first gadgets id, following gadgets have successing numbers
  1076.     fill   : flags, if filling is allowed
  1077.  
  1078.    RESULT
  1079.     NULL if fails, else pointer to new subtree
  1080.  
  1081.    SEE ALSO
  1082.  
  1083.  
  1084. egsgadbox.library/EB_CreateMultiAction2egsgadbox.library/EB_CreateMultiAction2
  1085.  
  1086.    NAME
  1087.     EB_CreateMultiAction2 -- creates a table of action gadgets
  1088.  
  1089.    SYNOPSIS
  1090.     EB_CreateMultiAction2(con, names, ids)
  1091.                           A0   A1     D0
  1092.  
  1093.     EB_GadBoxPtr EB_CreateMultiAction2(EB_GadContext, EB_StrArray2Ptr, LONG)
  1094.  
  1095.    FUNCTION
  1096.     Creates a table of action gadgets. The names of the gadgets must be
  1097.     provided in an array of pointers to arrays of pointers to strings.
  1098.     The last elements in the arrays must be NULL for termination.
  1099.  
  1100.    INPUTS
  1101.     con     : pointer to gadget context
  1102.     names   : pointer to array of pointers to arrays of pointers to strings
  1103.     ids     : The number of the top left gadgets. Gadget ids from left to
  1104.         right increase by one, from top to bottom by 0x100.
  1105.  
  1106.    RESULT
  1107.     NULL if fails, else pointer to new subtree
  1108.  
  1109.    SEE ALSO
  1110.  
  1111.  
  1112. egsgadbox.library/EB_CreateMultiActionVegsgadbox.library/EB_CreateMultiActionV
  1113.  
  1114.    NAME
  1115.     EB_CreateMultiActionV -- creates several action gadgets
  1116.  
  1117.    SYNOPSIS
  1118.     EB_CreateMultiActionV(con, names, ids, fill)
  1119.                           A0   A1     D0   D1
  1120.  
  1121.     EB_GadBoxPtr EB_CreateMultiActionV(EB_GadContext, EB_StrArrayPtr, LONG, UBYTE)
  1122.  
  1123.    FUNCTION
  1124.     Creates several action gadgets in a collumn. The names of the
  1125.     gadgets must be provided in an array of pointers to string. The last
  1126.     element in the array must be a NULL for termination.
  1127.  
  1128.    INPUTS
  1129.     con    : pointer to gadget context
  1130.     names  : pointer to array of pointers to string.
  1131.     ids    : first gadgets id, following gadgets have successing numbers
  1132.     fill   : flags, if filling is allowed
  1133.  
  1134.    RESULT
  1135.     NULL if fails, else pointer to new subtree
  1136.  
  1137.    SEE ALSO
  1138.  
  1139.  
  1140. egsgadbox.library/EB_CreateMultiText     egsgadbox.library/EB_CreateMultiText
  1141.  
  1142.    NAME
  1143.     EB_CreateMultiText --
  1144.  
  1145.    SYNOPSIS
  1146.     EB_CreateMultiText(con, text)
  1147.                        A0   A1
  1148.  
  1149.     EB_GadBoxPtr EB_CreateMultiText(EB_GadContext, EB_StrArrayPtr)
  1150.  
  1151.    FUNCTION
  1152.     Creates several lines of text;
  1153.  
  1154.    INPUTS
  1155.     con    : pointer to gadcontext
  1156.     text   : Array of pointers to strings, which build the lines. The last entry
  1157.        must contain NULL, for termination.
  1158.  
  1159.    RESULT
  1160.     NULL if fails, else pointer to new subtree
  1161.  
  1162.    SEE ALSO
  1163.  
  1164.  
  1165. egsgadbox.library/EB_CreateNameIntegerGadget      egsgadbox.library/EB_CreateNameIntegerGadget
  1166.  
  1167.    NAME
  1168.     EB_CreateNameIntegerGadget -- create integer gadget with name
  1169.  
  1170.    SYNOPSIS
  1171.     EB_CreateNameIntegerGadget(con, name, minChar, digits, id)
  1172.                                A0   A1    D0       D1      D2
  1173.  
  1174.     EB_GadBoxPtr EB_CreateNameIntegerGadget(EB_GadContext, char *, WORD, WORD, LONG)
  1175.  
  1176.    FUNCTION
  1177.     Creates an integer gadget with a name on its left side (see
  1178.     EB_CreateIntegerGadget for more information)
  1179.  
  1180.    INPUTS
  1181.     con          -
  1182.     name         -
  1183.     minChar      -
  1184.     digits       -
  1185.     id           -
  1186.  
  1187.    RESULT
  1188.     NULL if fails, else pointer to new subtree
  1189.  
  1190.    SEE ALSO
  1191.  
  1192.  
  1193. egsgadbox.library/EB_CreateNameRealGadgetegsgadbox.library/EB_CreateNameRealGadget
  1194.  
  1195.    NAME
  1196.     EB_CreateNameRealGadget -- create a real gadget with a name
  1197.  
  1198.    SYNOPSIS
  1199.     EB_CreateNameRealGadget(con, name, minChar, digits, id)
  1200.                             A0   A1    D0       D1      D2
  1201.  
  1202.     EB_GadBoxPtr EB_CreateNameRealGadget(EB_GadContext, char *, WORD, WORD, LONG)
  1203.  
  1204.    FUNCTION
  1205.     Creates an longreal gadget with a name on its left side (see
  1206.     EB_CreateRealGadget for more information)
  1207.  
  1208.    INPUTS
  1209.     con          -
  1210.     name         -
  1211.     minChar      -
  1212.     digits       -
  1213.     id           -
  1214.  
  1215.    RESULT
  1216.     NULL if fails, else pointer to new subtree
  1217.  
  1218.    SEE ALSO
  1219.  
  1220.  
  1221. egsgadbox.library/EB_CreateNameStringGadgetegsgadbox.library/EB_CreateNameStringGadget
  1222.  
  1223.    NAME
  1224.     EB_CreateNameStringGadget -- creates a string gadget with name
  1225.  
  1226.    SYNOPSIS
  1227.     EB_CreateNameStringGadget(con, name, minChar, buffLen, justify, id)
  1228.                               A0   A1    D0       D1       D2       D3
  1229.  
  1230.     EB_GadBoxPtr EB_CreateNameStringGadget(EB_GadContext, char *, WORD, WORD, UBYTE, LONG)
  1231.  
  1232.    FUNCTION
  1233.     Creates an string gadget with a name on its left side (see
  1234.     EB_CreateStringGadget for more information)
  1235.  
  1236.    INPUTS
  1237.     con          -
  1238.     name         -
  1239.     minChar      -
  1240.     buffLen      -
  1241.     justify      -
  1242.     id           -
  1243.  
  1244.    RESULT
  1245.     NULL if fails, else pointer to new subtree
  1246.  
  1247.    SEE ALSO
  1248.  
  1249.  
  1250. egsgadbox.library/EB_CreateRealGadget   egsgadbox.library/EB_CreateRealGadget
  1251.  
  1252.    NAME
  1253.     EB_CreateRealGadget -- creates a longreal gadget
  1254.  
  1255.    SYNOPSIS
  1256.     EB_CreateRealGadget(con, minChar, digits, id)
  1257.                         A0   D0       D1      D2
  1258.  
  1259.     EB_GadBoxPtr EB_CreateRealGadget(EB_GadContext, WORD, WORD, LONG)
  1260.  
  1261.    FUNCTION
  1262.     Creates an longreal gadget and associated graphics.
  1263.  
  1264.    INPUTS
  1265.     con     : pointer to gad context
  1266.     minChar : minimum number of chars to display
  1267.     digits  : number of digits in real number
  1268.     id      : the gadgets id
  1269.  
  1270.    RESULT
  1271.     NULL if fails, else pointer to new subtree
  1272.  
  1273.    SEE ALSO
  1274.  
  1275.  
  1276. egsgadbox.library/EB_CreateResponseBox egsgadbox.library/EB_CreateResponseBox
  1277.  
  1278.    NAME
  1279.     EB_CreateResponseBox -- creates a response box
  1280.  
  1281.    SYNOPSIS
  1282.     EB_CreateResponseBox(con, response, minWidth, maxWidth, minHeight, maxHeight)
  1283.                          A0   A1        D0        D1        D2         D3
  1284.  
  1285.     EB_GadBoxPtr EB_CreateResponseBox(EB_GadContext, EB_ResBoxPtr, WORD, WORD, WORD, WORD)
  1286.  
  1287.    FUNCTION
  1288.     Creates a response box. This box contains a pointer to a structur,
  1289.     in which the resulting coordinates of this box are written. This type
  1290.     is usefull for input and output elements, which are not easy to fit
  1291.     in gadgets and or rendering.
  1292.  
  1293.    INPUTS
  1294.     con       : pointer to gadcontext
  1295.     response  : pointer to response box. In this box the resulting coordinates are
  1296.           written.
  1297.     minWidth,
  1298.     minHeight : minimum dimensions
  1299.     maxWidth,
  1300.     maxHeight : maximum dimensions.
  1301.  
  1302.    RESULT
  1303.     NULL if fails, else pointer to new gadbox
  1304.  
  1305.    SEE ALSO
  1306.  
  1307.  
  1308. egsgadbox.library/EB_CreateStringGadgetegsgadbox.library/EB_CreateStringGadget
  1309.  
  1310.    NAME
  1311.     EB_CreateStringGadget -- create a string gadget
  1312.  
  1313.    SYNOPSIS
  1314.     EB_CreateStringGadget(con, minChar, buffLen, justify, id)
  1315.                           A0   D0       D1       D2       D3
  1316.  
  1317.     EB_GadBoxPtr EB_CreateStringGadget(EB_GadContext, WORD, WORD, UBYTE, LONG)
  1318.  
  1319.    FUNCTION
  1320.     Creates a string gadget, and associated graphics.
  1321.  
  1322.    INPUTS
  1323.     con     : pointer to gadget context
  1324.     minChar : minimal number of characters to be displayed
  1325.     buffLen : size of buffer
  1326.     justify : jsutification of string
  1327.     id      : the gadgets id
  1328.  
  1329.    RESULT
  1330.     NULL if fails, else pointer to new subtree
  1331.  
  1332.    SEE ALSO
  1333.  
  1334.  
  1335. egsgadbox.library/EB_CreateSuperHorizPropegsgadbox.library/EB_CreateSuperHorizProp
  1336.  
  1337.    NAME
  1338.     EB_CreateSuperHorizProp -- create prop gadget with arrows
  1339.  
  1340.    SYNOPSIS
  1341.     EB_CreateSuperHorizProp(con, maximum, size, value, id, flags)
  1342.                             A0   D0       D1    D2     D3  D4
  1343.  
  1344.     EB_GadBoxPtr EB_CreateSuperHorizProp(EB_GadContext, WORD, WORD, WORD, LONG, UBYTE)
  1345.  
  1346.    FUNCTION
  1347.     Creates a proportional gadget with arrows for increasing and
  1348.     decreasing. The arrows work without additional programming. They may
  1349.     be located on any side of the gadgets, determined by the contents of
  1350.     flags. (See EB_CreateHorizProp for further information)
  1351.  
  1352.    INPUTS
  1353.     con          -
  1354.     maximum      -
  1355.     size         -
  1356.     value        -
  1357.     id           -
  1358.     flags        -
  1359.  
  1360.    RESULT
  1361.     NULL if fails, else pointer to new subtree
  1362.  
  1363.    SEE ALSO
  1364.  
  1365.  
  1366. egsgadbox.library/EB_CreateSuperVertiPropegsgadbox.library/EB_CreateSuperVertiProp
  1367.  
  1368.    NAME
  1369.     EB_CreateSuperVertiProp -- create prop gadget with arrows
  1370.  
  1371.    SYNOPSIS
  1372.     EB_CreateSuperVertiProp(con, maximum, size, value, id, flags)
  1373.                             A0   D0       D1    D2     D3  D4
  1374.  
  1375.     EB_GadBoxPtr EB_CreateSuperVertiProp(EB_GadContext, WORD, WORD, WORD, LONG, UBYTE)
  1376.  
  1377.    FUNCTION
  1378.     Creates a proportional gadget with arrows for increasing and
  1379.     decreasing. The arrows work without additional programming. They may
  1380.     be located on any side of the gadgets, determined by the contents of
  1381.     flags. (See EB_CreateVertiProp for further information)
  1382.  
  1383.    INPUTS
  1384.     con          -
  1385.     maximum      -
  1386.     size         -
  1387.     value        -
  1388.     id           -
  1389.     flags        -
  1390.  
  1391.    RESULT
  1392.     NULL if fails, else pointer to new subtree
  1393.  
  1394.    SEE ALSO
  1395.  
  1396.  
  1397. egsgadbox.library/EB_CreateText               egsgadbox.library/EB_CreateText
  1398.  
  1399.    NAME
  1400.     EB_CreateText -- creates a line of text
  1401.  
  1402.    SYNOPSIS
  1403.     EB_CreateText(con, str)
  1404.                   A0   A1
  1405.  
  1406.     EB_GadBoxPtr EB_CreateText(EB_GadContext, char *)
  1407.  
  1408.    FUNCTION
  1409.     Creates one line of text in the contexts font.
  1410.  
  1411.    INPUTS
  1412.     con          -
  1413.     str          -
  1414.  
  1415.    RESULT
  1416.     NULL if fails, else pointer to new subtree
  1417.  
  1418.    SEE ALSO
  1419.  
  1420.  
  1421. egsgadbox.library/EB_CreateTextAction   egsgadbox.library/EB_CreateTextAction
  1422.  
  1423.    NAME
  1424.     EB_CreateTextAction -- create action gadget
  1425.  
  1426.    SYNOPSIS
  1427.     EB_CreateTextAction(con, name, id, fill)
  1428.                         A0   A1    D0  D1
  1429.  
  1430.     EB_GadBoxPtr EB_CreateTextAction(EB_GadContext, char *, LONG, UBYTE)
  1431.  
  1432.    FUNCTION
  1433.     Creates an action gadget around a text.
  1434.  
  1435.    INPUTS
  1436.     con          -
  1437.     name         -
  1438.     id           -
  1439.     fill         -
  1440.  
  1441.    RESULT
  1442.     NULL if fails, else pointer to new subtree
  1443.  
  1444.    SEE ALSO
  1445.  
  1446.  
  1447. egsgadbox.library/EB_CreateTextBoolean egsgadbox.library/EB_CreateTextBoolean
  1448.  
  1449.    NAME
  1450.     EB_CreateTextBoolean -- creates boolean gadget
  1451.  
  1452.    SYNOPSIS
  1453.     EB_CreateTextBoolean(con, name, id, fill)
  1454.                          A0   A1    D0  D1
  1455.  
  1456.     EB_GadBoxPtr EB_CreateTextBoolean(EB_GadContext, char *, LONG, UBYTE)
  1457.  
  1458.    FUNCTION
  1459.     Creates an boolean gadget around a text.
  1460.  
  1461.    INPUTS
  1462.     con          -
  1463.     name         -
  1464.     id           -
  1465.     fill         -
  1466.  
  1467.    RESULT
  1468.     NULL if fails, else pointer to new subtree
  1469.  
  1470.    SEE ALSO
  1471.  
  1472.  
  1473. egsgadbox.library/EB_CreateUText             egsgadbox.library/EB_CreateUText
  1474.  
  1475.    NAME
  1476.     EB_CreateUText --
  1477.  
  1478.    SYNOPSIS
  1479.     EB_CreateUText(con, s, c)
  1480.                    A0   A1 A2
  1481.  
  1482.     EB_GadBoxPtr EB_CreateUText(EB_GadContext, char *, char)
  1483.  
  1484.    FUNCTION
  1485.  
  1486.    INPUTS
  1487.     con          -
  1488.     s            -
  1489.     c            -
  1490.  
  1491.    RESULT
  1492.  
  1493.    SEE ALSO
  1494.  
  1495.  
  1496. egsgadbox.library/EB_CreateVertiBox       egsgadbox.library/EB_CreateVertiBox
  1497.  
  1498.    NAME
  1499.     EB_CreateVertiBox -- create vertical box
  1500.  
  1501.    SYNOPSIS
  1502.     EB_CreateVertiBox(con)
  1503.                       A0
  1504.  
  1505.     EB_GadBoxPtr EB_CreateVertiBox(EB_GadContext)
  1506.  
  1507.    FUNCTION
  1508.     Creates a box that combines several other boxes vertical. All son
  1509.     boxes of a vertical box are placed one below the other, and build a
  1510.     column.
  1511.  
  1512.    INPUTS
  1513.     con          -
  1514.  
  1515.    RESULT
  1516.     NULL if fails, else pointer to new subtree
  1517.  
  1518.    SEE ALSO
  1519.  
  1520.  
  1521. egsgadbox.library/EB_CreateVertiFill     egsgadbox.library/EB_CreateVertiFill
  1522.  
  1523.    NAME
  1524.     EB_CreateVertiFill -- create vertical fill element
  1525.  
  1526.    SYNOPSIS
  1527.     EB_CreateVertiFill(con, fill, pri)
  1528.                        A0   D0    D1
  1529.  
  1530.     EB_GadBoxPtr EB_CreateVertiFill(EB_GadContext, ULONG, BYTE)
  1531.  
  1532.    FUNCTION
  1533.     Creates a fill element for vertical boxes. This should be used, to
  1534.     separate gadgets or gadget groups, or to create paddings betweeen
  1535.     borders.
  1536.  
  1537.    INPUTS
  1538.     con    : pointer to gadcontext
  1539.     fill   : flag, that determines, if the fill box is allowed to expand if needed
  1540.     pri    : the boxes priority
  1541.  
  1542.    RESULT
  1543.     NULL if fails, else pointer to new subtree
  1544.  
  1545.    SEE ALSO
  1546.  
  1547.  
  1548. egsgadbox.library/EB_CreateVertiProp     egsgadbox.library/EB_CreateVertiProp
  1549.  
  1550.    NAME
  1551.     EB_CreateVertiProp -- creates a vertical prop gadget
  1552.  
  1553.    SYNOPSIS
  1554.     EB_CreateVertiProp(con, maximum, size, val, id)
  1555.                        A0   D0       D1    D2   D3
  1556.  
  1557.     EB_GadBoxPtr EB_CreateVertiProp(EB_GadContext, WORD, WORD, WORD, LONG)
  1558.  
  1559.    FUNCTION
  1560.     Creates a vertical proportional gadget, and all needed graphics.
  1561.  
  1562.    INPUTS
  1563.     con      : pointer to gadcontext
  1564.     maximum  : maximum value of slider
  1565.     size     : size of slider
  1566.     val      : value of slider
  1567.     id       : the gadgets id
  1568.  
  1569.    RESULT
  1570.     NULL if fails, else pointer to new subtree
  1571.  
  1572.    SEE ALSO
  1573.  
  1574.  
  1575. egsgadbox.library/EB_CreateVertiTable   egsgadbox.library/EB_CreateVertiTable
  1576.  
  1577.    NAME
  1578.     EB_CreateVertiTable -- creates a table
  1579.  
  1580.    SYNOPSIS
  1581.     EB_CreateVertiTable(con)
  1582.                         A0
  1583.  
  1584.     EB_GadBoxPtr EB_CreateVertiTable(EB_GadContext)
  1585.  
  1586.    FUNCTION
  1587.     Creates a vertical table, that may contain several horizontal boxes,
  1588.     and arranges their elements in a table.
  1589.  
  1590.    INPUTS
  1591.     con          -
  1592.  
  1593.    RESULT
  1594.     NULL if fails, else pointer to new subtree
  1595.  
  1596.    SEE ALSO
  1597.  
  1598.  
  1599. egsgadbox.library/EB_CreateWindow           egsgadbox.library/EB_CreateWindow
  1600.  
  1601.    NAME
  1602.     EB_CreateWindow -- creates a window
  1603.  
  1604.    SYNOPSIS
  1605.     EB_CreateWindow(con, left, top)
  1606.                     A0   D0    D1
  1607.  
  1608.     EB_GadBoxPtr EB_CreateWindow(EB_GadContext, WORD, WORD)
  1609.  
  1610.    FUNCTION
  1611.     Creates a EI_NewWindow structure, associoated to a gadget box. The
  1612.     window will open at left/top, and include all gadboxes, which are
  1613.     added to it. Normally this function is not needed, because it is
  1614.     included in EB_ProcessGadBoxes.
  1615.  
  1616.    INPUTS
  1617.     con          -
  1618.     left         -
  1619.     top          -
  1620.  
  1621.    RESULT
  1622.     NULL if fails, else pointer to new tree
  1623.  
  1624.    SEE ALSO
  1625.  
  1626.  
  1627. egsgadbox.library/EB_DeleteGadContext   egsgadbox.library/EB_DeleteGadContext
  1628.  
  1629.    NAME
  1630.     EB_DeleteGadContext -- delete a gad context
  1631.  
  1632.    SYNOPSIS
  1633.     EB_DeleteGadContext(con)
  1634.                         A0
  1635.  
  1636.     void EB_DeleteGadContext(EB_GadContext)
  1637.  
  1638.    FUNCTION
  1639.     Deletes a gadget context and the two included contexts. All memory
  1640.     which has been allocated to create the gadgets, and the gadgets self
  1641.     are deallocated.
  1642.  
  1643.    INPUTS
  1644.     con          -
  1645.  
  1646.    RESULT
  1647.  
  1648.    SEE ALSO
  1649.  
  1650.  
  1651. egsgadbox.library/EB_FindGadget               egsgadbox.library/EB_FindGadget
  1652.  
  1653.    NAME
  1654.     EB_FindGadget -- find a gadget
  1655.  
  1656.    SYNOPSIS
  1657.     EB_FindGadget(first, num, id)
  1658.                   A0     D0   D1
  1659.  
  1660.     EI_GadgetPtr EB_FindGadget(EI_GadgetPtr, WORD, LONG)
  1661.  
  1662.    FUNCTION
  1663.     Finds a gadget in a gadgetlist by its id.
  1664.  
  1665.    INPUTS
  1666.     first   : pointer to first gadget in the list
  1667.     num     : number of gadgets in the list
  1668.     id      : the gadgets id
  1669.  
  1670.    RESULT
  1671.     pointer to the gadget, or NULL if it was not found
  1672.  
  1673.    SEE ALSO
  1674.  
  1675.  
  1676. egsgadbox.library/EB_FreeMemCon               egsgadbox.library/EB_FreeMemCon
  1677.  
  1678.    NAME
  1679.     EB_FreeMemCon -- deallocate memory
  1680.  
  1681.    SYNOPSIS
  1682.     EB_FreeMemCon(mem)
  1683.                   A0
  1684.  
  1685.     void EB_FreeMemCon(APTR)
  1686.  
  1687.    FUNCTION
  1688.     Deallocates memory that was allocated using EB_AllocMemCon.
  1689.  
  1690.    INPUTS
  1691.     mem          -
  1692.  
  1693.    RESULT
  1694.  
  1695.    SEE ALSO
  1696.  
  1697.  
  1698. egsgadbox.library/EB_GetStringData         egsgadbox.library/EB_GetStringData
  1699.  
  1700.    NAME
  1701.     EB_GetStringData -- extract string from gadget buffer
  1702.  
  1703.    SYNOPSIS
  1704.     EB_GetStringData(gad, str)
  1705.                      A0   A1
  1706.  
  1707.     void EB_GetStringData(EI_GadgetPtr, char *)
  1708.  
  1709.    FUNCTION
  1710.     Extracts a string from a gadgets string buffer.
  1711.  
  1712.    INPUTS
  1713.     gad          -
  1714.     str          -
  1715.  
  1716.    RESULT
  1717.  
  1718.    SEE ALSO
  1719.  
  1720.  
  1721. egsgadbox.library/EB_LinkStringGadgets egsgadbox.library/EB_LinkStringGadgets
  1722.  
  1723.    NAME
  1724.     EB_LinkStringGadgets -- links two string gadgets
  1725.  
  1726.    SYNOPSIS
  1727.     EB_LinkStringGadgets(con, from, to)
  1728.                          A0   A1    A2
  1729.  
  1730.     ULONG EB_LinkStringGadgets(EB_GadContext, EB_GadBoxPtr, EB_GadBoxPtr)
  1731.  
  1732.    FUNCTION
  1733.     Links two string gadgets so that the user can move from one to the
  1734.     other using TAB and SHIFT+TAB. The routine searches for the next
  1735.     string gadget in the subtree.
  1736.  
  1737.    INPUTS
  1738.     con    : pointer to gadget context
  1739.     from   : subtree that contains the first string gadget
  1740.     to     : subtree that contains the second string gadget
  1741.  
  1742.    RESULT
  1743.     FALSE if failed, see error field in context for more information
  1744.  
  1745.    SEE ALSO
  1746.  
  1747.  
  1748. egsgadbox.library/EB_LinkStringGadgetsIDegsgadbox.library/EB_LinkStringGadgetsID
  1749.  
  1750.    NAME
  1751.     EB_LinkStringGadgetsID -- links two string gadgets
  1752.  
  1753.    SYNOPSIS
  1754.     EB_LinkStringGadgetsID(con, from, to, frist, num)
  1755.                            A0   D0    D1  A1     D2
  1756.  
  1757.     ULONG EB_LinkStringGadgetsID(EB_GadContext, LONG, LONG, EI_GadgetPtr, WORD)
  1758.  
  1759.    FUNCTION
  1760.     Links two string gadgets so that the user can move from one to the
  1761.     other using TAB and SHIFT+TAB. The routine searches for the gadgets
  1762.     in a gadget list. If num is -1 the routine takes the list provided by
  1763.     the gadget context.
  1764.  
  1765.    INPUTS
  1766.     con      : pointer to gadget context
  1767.     from, to : the gadgets ids
  1768.     first    : first gadget in the list
  1769.     num      : number of gadgets in the list, or -1
  1770.  
  1771.    RESULT
  1772.     FALSE if failed, see error field in context for more information
  1773.  
  1774.    SEE ALSO
  1775.  
  1776.  
  1777. egsgadbox.library/EB_MAX                             egsgadbox.library/EB_MAX
  1778.  
  1779.    NAME
  1780.     EB_MAX --
  1781.  
  1782.    SYNOPSIS
  1783.     EB_MAX(a, b)
  1784.            D0 D1
  1785.  
  1786.     WORD EB_MAX(WORD, WORD)
  1787.  
  1788.    FUNCTION
  1789.     Finds the largest value of a and b
  1790.  
  1791.    INPUTS
  1792.     a, b: Numbers to compare
  1793.  
  1794.    RESULT
  1795.     max - the largest number of a and b.
  1796.  
  1797.    SEE ALSO
  1798.  
  1799.  
  1800. egsgadbox.library/EB_MIN                             egsgadbox.library/EB_MIN
  1801.  
  1802.    NAME
  1803.     EB_MIN --
  1804.  
  1805.    SYNOPSIS
  1806.     EB_MIN(a, b)
  1807.            D0 D1
  1808.  
  1809.     WORD EB_MIN(WORD, WORD)
  1810.  
  1811.    FUNCTION
  1812.     Finds the smaller of a and b
  1813.  
  1814.    INPUTS
  1815.     a, b: numbers to compare
  1816.  
  1817.    RESULT
  1818.     min - the smaller of a and b.
  1819.  
  1820.    SEE ALSO
  1821.  
  1822.  
  1823. egsgadbox.library/EB_NewFixHeight           egsgadbox.library/EB_NewFixHeight
  1824.  
  1825.    NAME
  1826.     EB_NewFixHeight -- modify a box to fixed height
  1827.  
  1828.    SYNOPSIS
  1829.     EB_NewFixHeight(box)
  1830.                     A0
  1831.  
  1832.     EB_GadBoxPtr EB_NewFixHeight(EB_GadBoxPtr)
  1833.  
  1834.    FUNCTION
  1835.     Modifies a gadbox so that its maximum height equals its minimum
  1836.     height, which has the effect, that the gadbox size is locked to its
  1837.     minimum.
  1838.  
  1839.    INPUTS
  1840.     box   : pointer to gadbox
  1841.  
  1842.    RESULT
  1843.     the same pointer as box
  1844.  
  1845.    SEE ALSO
  1846.  
  1847.  
  1848. egsgadbox.library/EB_NewFixWidth             egsgadbox.library/EB_NewFixWidth
  1849.  
  1850.    NAME
  1851.     EB_NewFixWidth -- modify a box to fixed width
  1852.  
  1853.    SYNOPSIS
  1854.     EB_NewFixWidth(box)
  1855.                    A0
  1856.  
  1857.     EB_GadBoxPtr EB_NewFixWidth(EB_GadBoxPtr)
  1858.  
  1859.    FUNCTION
  1860.     Modifies a gadbox so that its maximum width equals its minimum
  1861.     width, which has the effect, that the gadbox size is locked to its
  1862.     minimum.
  1863.  
  1864.    INPUTS
  1865.     box   : pointer to gadbox
  1866.     width : the new height of the box
  1867.  
  1868.    RESULT
  1869.     the same pointer as box
  1870.  
  1871.    SEE ALSO
  1872.  
  1873.  
  1874. egsgadbox.library/EB_NewHotKey                 egsgadbox.library/EB_NewHotKey
  1875.  
  1876.    NAME
  1877.     EB_NewHotKey --
  1878.  
  1879.    SYNOPSIS
  1880.     EB_NewHotKey(box, key)
  1881.                  A0   D0
  1882.  
  1883.     EB_GadBoxPtr EB_NewHotKey(EB_GadBoxPtr, char)
  1884.  
  1885.    FUNCTION
  1886.  
  1887.    INPUTS
  1888.     box          -
  1889.     key          -
  1890.  
  1891.    RESULT
  1892.  
  1893.    SEE ALSO
  1894.  
  1895.  
  1896. egsgadbox.library/EB_NewMaxHeight           egsgadbox.library/EB_NewMaxHeight
  1897.  
  1898.    NAME
  1899.     EB_NewMaxHeight -- modifies a box maximum height
  1900.  
  1901.    SYNOPSIS
  1902.     EB_NewMaxHeight(box, height)
  1903.                     A0   D0
  1904.  
  1905.     EB_GadBoxPtr EB_NewMaxHeight(EB_GadBoxPtr, WORD)
  1906.  
  1907.    FUNCTION
  1908.     Modifies the maximum height of a gadbox
  1909.  
  1910.    INPUTS
  1911.     box    : pointer to gadbox
  1912.     height : the new height of the box
  1913.  
  1914.    RESULT
  1915.     the same pointer as box
  1916.  
  1917.    SEE ALSO
  1918.  
  1919.  
  1920. egsgadbox.library/EB_NewMaxWidth             egsgadbox.library/EB_NewMaxWidth
  1921.  
  1922.    NAME
  1923.     EB_NewMaxWidth -- modifies a box maximum width
  1924.  
  1925.    SYNOPSIS
  1926.     EB_NewMaxWidth(box, width)
  1927.                    A0   D0
  1928.  
  1929.     EB_GadBoxPtr EB_NewMaxWidth(EB_GadBoxPtr, WORD)
  1930.  
  1931.    FUNCTION
  1932.     Modifies the maximum width of a gadbox
  1933.  
  1934.    INPUTS
  1935.     box   : pointer to gadbox
  1936.  
  1937.    RESULT
  1938.     the same pointer as box
  1939.  
  1940.    SEE ALSO
  1941.  
  1942.  
  1943. egsgadbox.library/EB_NewMinHeight           egsgadbox.library/EB_NewMinHeight
  1944.  
  1945.    NAME
  1946.     EB_NewMinHeight -- modifies a box minimum height
  1947.  
  1948.    SYNOPSIS
  1949.     EB_NewMinHeight(box, height)
  1950.                     A0   D0
  1951.  
  1952.     EB_GadBoxPtr EB_NewMinHeight(EB_GadBoxPtr, WORD)
  1953.  
  1954.    FUNCTION
  1955.     Modifies the minimum height of a gadbox
  1956.  
  1957.    INPUTS
  1958.     box   : pointer to gadbox
  1959.  
  1960.    RESULT
  1961.     the same pointer as box
  1962.  
  1963.    SEE ALSO
  1964.  
  1965.  
  1966. egsgadbox.library/EB_NewMinWidth             egsgadbox.library/EB_NewMinWidth
  1967.  
  1968.    NAME
  1969.     EB_NewMinWidth -- modifies a box minimum width
  1970.  
  1971.    SYNOPSIS
  1972.     EB_NewMinWidth(box, width)
  1973.                    A0   D0
  1974.  
  1975.     EB_GadBoxPtr EB_NewMinWidth(EB_GadBoxPtr, WORD)
  1976.  
  1977.    FUNCTION
  1978.     Modifies the minimum width of a gadbox
  1979.  
  1980.    INPUTS
  1981.     box   : pointer to gadbox
  1982.  
  1983.    RESULT
  1984.     the same pointer as box
  1985.  
  1986.    SEE ALSO
  1987.  
  1988.  
  1989. egsgadbox.library/EB_NewPri                       egsgadbox.library/EB_NewPri
  1990.  
  1991.    NAME
  1992.     EB_NewPri -- modifies a boxes priority
  1993.  
  1994.    SYNOPSIS
  1995.     EB_NewPri(box, pri)
  1996.               A0   D0
  1997.  
  1998.     EB_GadBoxPtr EB_NewPri(EB_GadBoxPtr, BYTE)
  1999.  
  2000.    FUNCTION
  2001.     Modifies the priority of a box.
  2002.  
  2003.    INPUTS
  2004.     box   : pointer to gadbox
  2005.     pri   : new priority
  2006.  
  2007.    RESULT
  2008.     the same pointer as box
  2009.  
  2010.    SEE ALSO
  2011.  
  2012.  
  2013. egsgadbox.library/EB_NewSameSize             egsgadbox.library/EB_NewSameSize
  2014.  
  2015.    NAME
  2016.     EB_NewSameSize -- changes all boxes in list to be same size
  2017.  
  2018.    SYNOPSIS
  2019.     EB_NewSameSize(box)
  2020.                    A0
  2021.  
  2022.     EB_GadBoxPtr EB_NewSameSize(EB_GadBoxPtr)
  2023.  
  2024.    FUNCTION
  2025.     Distributes the running length (width for horizontal boxes, height
  2026.     for vertical boxes) evenly to the boxes in
  2027.  
  2028.    INPUTS
  2029.     box   : pointer to gadbox
  2030.  
  2031.    RESULT
  2032.     the same pointer as box
  2033.  
  2034.    SEE ALSO
  2035.  
  2036.  
  2037. egsgadbox.library/EB_ProcessGadBoxes     egsgadbox.library/EB_ProcessGadBoxes
  2038.  
  2039.    NAME
  2040.     EB_ProcessGadBoxes -- make a window out of a gad box tree
  2041.  
  2042.    SYNOPSIS
  2043.     EB_ProcessGadBoxes(con, root)
  2044.                        A0   A1
  2045.  
  2046.     ULONG EB_ProcessGadBoxes(EB_GadContext, EB_GadBoxPtr)
  2047.  
  2048.    FUNCTION
  2049.     Builds up a new window structure and a list of gadgets out of a gad
  2050.     box tree. Calls EB_CreateWindow, CalcMinMax, CalcRealSize,
  2051.     CalcPositions, CalcGadgetGfx, ConnectGadgets and deletes the
  2052.     tempororay context. The tree is deleted by this operation. If it
  2053.     succeeds, you can open a window, using the EI_NewWindow pointer in
  2054.     the EB_GadContext, and get all rendering and gadgets displayed and
  2055.     ready to use. You may modify the windows flags, but you should not
  2056.     modify its size.
  2057.  
  2058.    INPUTS
  2059.     con    : pointer to gadget context
  2060.     root   : pointer to root of gadbox tree (is disposed during operation)
  2061.  
  2062.    RESULT
  2063.     FALSE if fails, see error field in gadget context for more information
  2064.  
  2065.    SEE ALSO
  2066.  
  2067.  
  2068. egsgadbox.library/EB_ProcessGadBoxesSizeegsgadbox.library/EB_ProcessGadBoxesSize
  2069.  
  2070.    NAME
  2071.     EB_ProcessGadBoxesSize -- fits gadboxes into boxes
  2072.  
  2073.    SYNOPSIS
  2074.     EB_ProcessGadBoxesSize(con, root, width, height)
  2075.                            A0   A1    D0     D1
  2076.  
  2077.     BOOL EB_ProcessGadBoxesSize(EB_GadContext, EB_GadBoxPtr, WORD, WORD)
  2078.  
  2079.    FUNCTION
  2080.     Builds up a new window structure and a list of gadgets out of a gad
  2081.     box tree, very much like EB_ProcessGadBoxes with the difference that
  2082.     the tree is attempted to be fitted into an area of width,height.
  2083.  
  2084.    INPUTS
  2085.     con    : pointer to gadget context
  2086.     root   : pointer to root of gadbox tree (is disposed during operation)
  2087.     width  : desired minimum width
  2088.     height : desired minimum height
  2089.  
  2090.    RESULT
  2091.     FALSE if fails, see error field in gadget context for more information
  2092.  
  2093.    SEE ALSO
  2094.  
  2095.  
  2096. egsgadbox.library/EB_PutIntData               egsgadbox.library/EB_PutIntData
  2097.  
  2098.    NAME
  2099.     EB_PutIntData -- put integer value into gadget
  2100.  
  2101.    SYNOPSIS
  2102.     EB_PutIntData(win, gad, val)
  2103.                   A0   A1   D0
  2104.  
  2105.     void EB_PutIntData(EI_WindowPtr, EI_GadgetPtr, LONG)
  2106.  
  2107.    FUNCTION
  2108.     Puts an integer value in an integer gadget, and refreshes it, if the
  2109.     window is allready open.
  2110.  
  2111.    INPUTS
  2112.     win    : pointer to the gadgets window or NULL, for no refresh
  2113.     gad    : pointer to integer gadget
  2114.     val    : value for gadget
  2115.  
  2116.    RESULT
  2117.  
  2118.    SEE ALSO
  2119.  
  2120.  
  2121. egsgadbox.library/EB_PutRealData             egsgadbox.library/EB_PutRealData
  2122.  
  2123.    NAME
  2124.     EB_PutRealData --
  2125.  
  2126.    SYNOPSIS
  2127.     EB_PutRealData(win, gad, val, field, digits, exp)
  2128.                    A0   A1   D0   D2     D3      D4
  2129.  
  2130.     void EB_PutRealData(EI_WindowPtr, EI_GadgetPtr, double, WORD, WORD, ULONG)
  2131.  
  2132.    FUNCTION
  2133.  
  2134.    INPUTS
  2135.     win          -
  2136.     gad          -
  2137.     val          -
  2138.     field        -
  2139.     digits       -
  2140.     exp          -
  2141.  
  2142.    RESULT
  2143.  
  2144.    SEE ALSO
  2145.  
  2146.  
  2147. egsgadbox.library/EB_PutStringData         egsgadbox.library/EB_PutStringData
  2148.  
  2149.    NAME
  2150.     EB_PutStringData -- puts string in gadget
  2151.  
  2152.    SYNOPSIS
  2153.     EB_PutStringData(win, gad, str)
  2154.                      A0   A1   A2
  2155.  
  2156.     void EB_PutStringData(EI_WindowPtr, EI_GadgetPtr, char *)
  2157.  
  2158.    FUNCTION
  2159.     Puts a string in a string gadget and refreshes it if the window is
  2160.     allready open.
  2161.  
  2162.    INPUTS
  2163.     win    : pointer to the gadgets window or NULL, for no refresh
  2164.     gad    : pointer to integer gadget
  2165.     str    : string for gadget
  2166.  
  2167.    RESULT
  2168.  
  2169.    SEE ALSO
  2170.  
  2171.  
  2172. egsgadbox.library/EB_SMatch                       egsgadbox.library/EB_SMatch
  2173.  
  2174.    NAME
  2175.     EB_SMatch -- number of chars that match in field
  2176.  
  2177.    SYNOPSIS
  2178.     EB_SMatch(str, font, width)
  2179.               A0   A1    D2
  2180.  
  2181.     WORD EB_SMatch(char *, EG_EFontPtr, WORD)
  2182.  
  2183.    FUNCTION
  2184.     Evaluates how many characters of a given string match into a text
  2185.     field.
  2186.  
  2187.    INPUTS
  2188.     str     : pointer to string
  2189.     font    : font for which to evaluate
  2190.     width   : width of the field
  2191.  
  2192.    RESULT
  2193.     number of chars that match into the field, if all characters match, returns
  2194.     the strings length.
  2195.  
  2196.    SEE ALSO
  2197.  
  2198.  
  2199. egsgadbox.library/EB_SWidth                       egsgadbox.library/EB_SWidth
  2200.  
  2201.    NAME
  2202.     EB_SWidth -- evaluate width of string
  2203.  
  2204.    SYNOPSIS
  2205.     EB_SWidth(str, font)
  2206.               A0   A1
  2207.  
  2208.     WORD EB_SWidth(char *, EG_EFontPtr)
  2209.  
  2210.    FUNCTION
  2211.     Evaluates how width a string would be in a given font.
  2212.  
  2213.    INPUTS
  2214.     str    : pointer to string
  2215.     font   : pointer to font
  2216.  
  2217.    RESULT
  2218.     width in pixel
  2219.  
  2220.    SEE ALSO
  2221.  
  2222.  
  2223. egsgadbox.library/EB_SetPropBackMap       egsgadbox.library/EB_SetPropBackMap
  2224.  
  2225.    NAME
  2226.     EB_SetPropBackMap --
  2227.  
  2228.    SYNOPSIS
  2229.     EB_SetPropBackMap(con, win, gad, map)
  2230.                       A0   A1   A2   A3
  2231.  
  2232.     void EB_SetPropBackMap(EB_GadContext, EI_WindowPtr, EI_PropGadPtr, E_EBitMapPtr)
  2233.  
  2234.    FUNCTION
  2235.  
  2236.    INPUTS
  2237.     con          -
  2238.     win          -
  2239.     gad          -
  2240.     map          -
  2241.  
  2242.    RESULT
  2243.  
  2244.    SEE ALSO
  2245.  
  2246.  
  2247. egsgadbox.library/EB_WriteInfoBox           egsgadbox.library/EB_WriteInfoBox
  2248.  
  2249.    NAME
  2250.     EB_WriteInfoBox -- write text in info box
  2251.  
  2252.    SYNOPSIS
  2253.     EB_WriteInfoBox(info, win, str)
  2254.                     A0    A1   A2
  2255.  
  2256.     void EB_WriteInfoBox(EB_InfoBoxPtr, EI_WindowPtr, char *)
  2257.  
  2258.    FUNCTION
  2259.     Writes a text into an info box (see EB_CreateInfoBox), if the string
  2260.     does not fit into the box, it is truncated.
  2261.  
  2262.    INPUTS
  2263.     info    : pointer to info box, initialized by EB_CreateInfoBox
  2264.     win     : pointer to window
  2265.     str     : pointer to string
  2266.  
  2267.    RESULT
  2268.  
  2269.    SEE ALSO
  2270.  
  2271.  
  2272. egsgadbox.library/EB_WriteInfoBoxInt     egsgadbox.library/EB_WriteInfoBoxInt
  2273.  
  2274.    NAME
  2275.     EB_WriteInfoBoxInt -- write number into info box
  2276.  
  2277.    SYNOPSIS
  2278.     EB_WriteInfoBoxInt(info, win, val)
  2279.                        A0    A1   D0
  2280.  
  2281.     void EB_WriteInfoBoxInt(EB_InfoBoxPtr, EI_WindowPtr, LONG)
  2282.  
  2283.    FUNCTION
  2284.     Writes a number into an info box (see EB_CreateInfoBox), if the
  2285.     number does not fit into the box, it is truncated.
  2286.  
  2287.    INPUTS
  2288.     info    : pointer to info box, initialized by EB_CreateInfoBox
  2289.     win     : pointer to window
  2290.     val     : number
  2291.  
  2292.    RESULT
  2293.  
  2294.    SEE ALSO
  2295.  
  2296.  
  2297.