Introduction :

Un widget de type Toggle est un bouton (ou une entrée de menu) qui possède deux valeurs: On ou Off. Il peut avoir la forme d'un carré (square) ou d'un diamant (diamond).

Les Toggle widgets possèdent, comme les boutons poussoirs, un label qui peut être de type texte ou bien de type pixmap (un dessin).

On peut grouper plusieurs Toggle widgets pour contrôler leur comportement les uns par rapport aux autres. Motif fournit deux types de Toggle widgets qui réagissent différemment lorsqu'ils sont regroupés :

Le widget de type RadioBox

Un seul de ces widgets peut être sur la position On lorsqu'on en groupe plusieurs. Il y a exclusion mutuelle, lorsqu'un d'entre eux est séléctionné, les autres sont mis sur Off. Ils sont en forme de diamant.

Le widget de type CheckBox

Plusieurs CheckBox peuvent être séléctionnés en même temps. Ils sont en forme de carré.

Bases d'utilisation des Toggle widgets

La fonction de Callbacks d'un widget de type Toggle est standard :

   toggle_cbk(Widget w, XtPointerData data, XmToggleCallbackStruct *cbk)

Petit programme d'exemple : toggle.c

#include <Xm/Xm.h>
#include <Xm/ToggleB.h>
#include <Xm/RowColumn.h>

/*--------------------------*/
main(int argc, char **argv)
/*--------------------------*/
{
  Widget toplevel, rowcol, toggle1, toggle2;
  XtAppContext app;
  void toggle1_cbk(), toggle2_cbk();

  toplevel = XtVaAppInitialize(&app, "Toggle", NULL, 0,
			       &argc, argv, NULL, NULL);

  rowcol = XtVaCreateWidget("rowcol",
			    xmRowColumnWidgetClass, toplevel, 
			    XmNwidth, 300,
			    XmNheight, 200,
			    NULL);


  toggle1 = XtVaCreateManagedWidget("Dolby ON/OFF",
				    xmToggleButtonWidgetClass, rowcol, NULL);
        
  XtAddCallback(toggle1, XmNvalueChangedCallback, 
		toggle1_cbk, NULL);
    
  toggle2 = XtVaCreateManagedWidget("Dolby B/C",
				    xmToggleButtonWidgetClass, rowcol, NULL);
        
  XtAddCallback(toggle2, XmNvalueChangedCallback, 
		toggle2_cbk, NULL);
  XtManageChild(rowcol);
  XtRealizeWidget(toplevel);
  XtAppMainLoop(app);
}

/*-------------------------------------------------------*/
void toggle1_cbk(Widget widget, XtPointer client_data,
		 XmToggleButtonCallbackStruct *state)
/*-------------------------------------------------------*/
{  
  printf("%s: %s\n", XtName(widget), 
	 state->set? "on" : "off");
}

/*-------------------------------------------------------*/
void toggle2_cbk(Widget widget, XtPointer client_data, 
XmToggleButtonCallbackStruct *state)
/*-------------------------------------------------------*/
{ 
  printf("%s: %s\n", XtName(widget), state->set? "B" : "C");
}

Grouper des Toggle widgets automatiquement

On peut regrouper "à la main" des RadioBox ou des CheckBox widgets dans une RowCOlumn ou une Form, comme dans le programme d'exemple toggle.c.