home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / XmVaCreateSimpleCheckBox.z / XmVaCreateSimpleCheckBox
Encoding:
Text File  |  1998-10-20  |  9.2 KB  |  199 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx - A RowColumn widget convenience
  10.           creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////RRRRoooowwwwCCCCoooolllluuuummmmnnnn....hhhh>>>>
  14.  
  15.           WWWWiiiiddddggggeeeetttt XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx ((((_p_a_r_e_n_t, _n_a_m_e, _c_a_l_l_b_a_c_k, _a_r_g...))))
  16.                WWWWiiiiddddggggeeeetttt    _p_a_r_e_n_t;;;;
  17.                SSSSttttrrrriiiinnnngggg    _n_a_m_e;;;;
  18.                XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc_c_a_l_l_b_a_c_k;;;;
  19.  
  20.  
  21.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  22.           This page documents version 1.2 of the Motif library.
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.           XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx creates an instance of a RowColumn
  26.           widget of type XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA and returns the associated widget
  27.           ID.  This routine uses the ANSI C variable-length argument
  28.           list (varargs) calling convention.
  29.  
  30.           This routine creates a CheckBox and its ToggleButtonGadget
  31.           children.  A CheckBox is similar to a RadioBox, except that
  32.           more than one button can be selected at a time.  The name of
  33.           each button is button__n, where _n is an integer from 0 to one
  34.           minus the number of buttons in the menu.  Buttons are named
  35.           and created in the order in which they are specified in the
  36.           variable portion of the argument list.
  37.  
  38.  
  39.           _p_a_r_e_n_t Specifies the parent widget ID.
  40.  
  41.           _n_a_m_e   Specifies the name of the created widget.
  42.  
  43.           _c_a_l_l_b_a_c_k
  44.                  Specifies a callback procedure to be called when a
  45.                  button's value changes.  This callback function is
  46.                  added to each button after creation as the button's
  47.                  XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk.  The callback function is
  48.                  called when a button's value changes, and the button
  49.                  number is returned in the _c_l_i_e_n_t__d_a_t_a field.
  50.  
  51.  
  52.           The variable portion of the argument list consists of groups
  53.           of arguments.  The first argument in each group is a
  54.           constant or a string and determines which arguments follow
  55.           in that group.  The last argument in the list must be NULL.
  56.           Following are the possible first arguments in each group of
  57.           varargs:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           XXXXmmmmVVVVaaaaCCCCHHHHEEEECCCCKKKKBBBBUUUUTTTTTTTTOOOONNNN
  75.                  This is followed by four additional arguments.  The
  76.                  set specifies one button in the CheckBox and some of
  77.                  its resource values.  Following are the additional
  78.                  four arguments, in this order:
  79.  
  80.  
  81.                  _l_a_b_e_l   The label string, of type XmString.
  82.  
  83.                  _m_n_e_m_o_n_i_c
  84.                          The mnemonic, of type KeySym.  This is
  85.                          ignored in this release.
  86.  
  87.                  _a_c_c_e_l_e_r_a_t_o_r
  88.                          The accelerator, of type String.  This is
  89.                          ignored in this release.
  90.  
  91.                  _a_c_c_e_l_e_r_a_t_o_r__t_e_x_t
  92.                          The accelerator text, of type XmString.  This
  93.                          is ignored in this release.
  94.  
  95.  
  96.           _r_e_s_o_u_r_c_e__n_a_m_e
  97.                  This is followed by one additional argument, the
  98.                  value of the resource, of type XtArgVal.  The pair
  99.                  specifies a resource and its value for the RowColumn
  100.                  widget.
  101.  
  102.           XXXXttttVVVVaaaaTTTTyyyyppppeeeeddddAAAArrrrgggg
  103.                  This is followed by four additional arguments.  The
  104.                  set specifies a resource and its value for the
  105.                  RowColumn widget.  A resource type conversion is
  106.                  performed if necessary.  Following are the additional
  107.                  four arguments, in this order:
  108.  
  109.  
  110.                  _n_a_m_e    The resource name, of type String.
  111.  
  112.                  _t_y_p_e    The type of the resource value supplied, of
  113.                          type String.
  114.  
  115.                  _v_a_l_u_e   The resource value (or a pointer to the
  116.                          resource value, depending on the type and
  117.                          size of the value), of type XtArgVal.
  118.  
  119.                  _s_i_z_e    The size of the resource value in bytes, of
  120.                          type int.
  121.  
  122.  
  123.           XXXXttttVVVVaaaaNNNNeeeesssstttteeeeddddLLLLiiiisssstttt
  124.                  This is followed by one additional argument of type
  125.                  XtVarArgsList.  This argument is a nested list of
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                  varargs returned by XXXXttttVVVVaaaaCCCCrrrreeeeaaaatttteeeeAAAArrrrggggssssLLLLiiiisssstttt.
  141.  
  142.  
  143.           For more information on variable-length argument lists, see
  144.           the X Toolkit Intrinsics documentation.
  145.  
  146.           A number of resources exist specifically for use with this
  147.           and other simple menu creation routines.  For a complete
  148.           definition of RowColumn and its associated resources, see
  149.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))).
  150.  
  151.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  152.           Returns the RowColumn widget ID.
  153.  
  154.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  155.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))),
  156.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX)))),
  157.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))), and XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx((((3333XXXX)))).
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.