Motif: les widgets conteneur

Transcription

1 4. Mtif : les widgets cnteneurs Widgets cnteneur Mtif: les widgets cnteneur Cnteneurs BulletinBard Frm RwClumn PanedWindw Jean Berstel - Institut Gaspard Mnge, Widgets cnteneur Classes de widgets cnteneur Cnstraint et Shell snt des classes Xt Intrinsics Cmpsite Shell Cnstraint BulletinBard RwClumn PanedWindw DrawingArea Frame Scale ScrlledWindw MessageBx SelectinBx Cmmand FileSelectinBx Frm MainWindw Jean Berstel - Institut Gaspard Mnge, 4. -

2 4. Mtif : les widgets cnteneurs Cnteneurs Usage l agencer ses widgets filles seln ses règles de placement; l rérganiser le placement si la gémétrie change. Principe l une widget ne mdifie jamais sa psitin et sa taille de sn prpre chef; l la gestin de la gémétrie est de la respnsabilité de sa mère; l chaque classe a ses prpres règles de gestin de ses filles. Exemples : l BulletinBard ne mdifie pas la gémétrie de ses filles. l RwClumn, les dispse en lignes et/u en clnnes l ScrlledWindw a tujurs au plus filles, dnt deux ascenseurs à emplacements fixes. Widget à cntraintes ( cnstraint widgets ) l nt des ressurces de placement spécifiques: ressurces de cntraintes. l Ces ressurces des ressurces des filles; gérées par les filles l maisexplitées par leur mère (une widget à cntraintes). l C est un mécanisme Intrinsics. Widgets cnteneur Jean Berstel - Institut Gaspard Mnge, Widgets cnteneur La superclasse Mtif des cnteneurs. Détermine le "lk and feel" des cnteneurs. Prcure des ressurces l pur la gestin d mbres l pur les culeurs d activatin l pur le parcurs avec tuches XmNbttmShadwClr Pixel Culeurs pur les mbres du brd XmNtpShadwClr XmNshadwThickness Dimensin Epaisseur de l mbre XmNfregrund Pixel Culeur d encre de la widget XmNhighlightClr Pixel Culeur pur tracer le rectangle d activatin XmNinitialFcus Widget La widget qui est fyer du clavier XmNnavigatinType enum Détermine le mde de parcurs avec les tuches XmNtraversalOn Blean Si True (défaut) permet parcurs par tuches XmNuserData XtPinter permet d accrcher des dnnées Jean Berstel - Institut Gaspard Mnge,

3 4. Mtif : les widgets cnteneurs BulletinBard Widgets cnteneur #include <Xm/BulletinB.h> XtVaCreateManagedWidget(nm, xmbulletinbardwidgetclass, mère,..., NULL) XmCreateCascadeButtn(mère, nm, args, nargs) Cnteneur le plus simple, sans cntraintes de psitin ni de dimensin Cre Cmpsite Cnstraint La valeur pas défaut de la psitin d une fille est (0,0). Par cnséquent, deux filles sans psitin explicite se superpsent! Suvent utilisé cmme frmulaire, ntamment dans les dialgues. A ce titre, dispse de quelques ressurces particulières. BulletinBard Jean Berstel - Institut Gaspard Mnge, 5 Frm #include <Xm/Frm.h> XtVaCreateManagedWidget(nm, xmfrmwidgetclass, mère,..., NULL) XmCreateFrm(mère, nm, args, nargs) Widgets cnteneur Cre Cmpsite Cnstraint Frm Une classe de widgets à cntraintes. Chaque fille peut chisir un type d ancrage : elles peuvent être attachées l à leur mère, l à une sœur, l à une psitin relativement à une grille. Chacun des 4 côtés d une fille peut être ancré. Les ancrages snt cnservés même si la mère est retaillée. Les côtés snt nmmés par XmtpAttachment XmrightAttachment XmbttmAttachment XmleftAttachment L ancrage relativement à la mère u à une sœur signifie l alignement de ce côté sur le même côté u le côté ppsé de la widget cncernée. La relatin d ancrage n est pas symétrique. Jean Berstel - Institut Gaspard Mnge,

4 4. Mtif : les widgets cnteneurs Widgets cnteneur Ressurces d ancrage Chaque côté d'une fille peut être ancrée. L ancrage est relatif l à la mère XmATTACH_FORM u XmATTACH_OPPOSITE_FORM l à une sœur XmATTACH_WIDGET u XmATTACH_OPPOSITE_WIDGET l à une psitin XmATTACH_POSITION l à une valeur initiale XmATTACH_SELF L absence de spécificatin vaut XmATTACH_NONE L ancrage se fait mdul un décalage ( ffset ) qui peut être spécifié pur chaque côté de chaque fille, u glbalement pur tutes les filles par XmhrizntalSpacing et XmverticalSpacing Jean Berstel - Institut Gaspard Mnge, 7 Ancrage à la mère Widgets cnteneur ATTACH_FORM, ATTACH_OPPOSITE_FORM : alignement du côté sur le même côté u le côté ppsé de la mère. XmNtpAttachment XmATTACH_FORM XmNrightAttachment XmATTACH_FORM XmNrightAttachment XmATTACH_OPPOSITE_FORM Jean Berstel - Institut Gaspard Mnge,

5 4. Mtif : les widgets cnteneurs Exemple Les ressurces snt spécifiées pur la widget fille. frme = XtVaCreateManagedWidget("frme", xmfrmwidgetclass, racine, Widgets cnteneur En dur un = XtVaCreateManagedWidget("",xmPushButtnClass, frme, XmNtpAttachment, XmATTACH_FORM, deux = XtVaCreateManagedWidget("",xmPushButtnClass, frme, XmNrightAttachment, XmATTACH_FORM, tris = XtVaCreateManagedWidget("",xmPushButtnClass, frme, XmNrightAttachment, XmOPPOSITE_ATTACH_FORM, Dans le fichier ressurces *.tpattachment : XmATTACH_FORM *.rightattachment : XmATTACH_FORM *.rightattachment : XmOPPOSITE_ATTACH_FORM Jean Berstel - Institut Gaspard Mnge, 9 Ancrage à une sœur Widgets cnteneur ATTACH_WIDGET, ATTACH_OPPOSITE_WIDGET l attachement au côté ppsé pur ATTACH_WIDGET l attachement au même côté pur ATTACH_OPPOSITE_WIDGET De plus, il faut spécifier la sœur sur laquelle n s aligne par: XmNtpWidget XmNrightWidget XmNleftWidget XmNbttmWidget deux = XtVaCreateManagedWidget("", xmpushbuttnclass, frme, XmNleftAttachment, XmATTACH_WIDGET, XmNleftWidget, un, tris = XtVaCreateManagedWidget("", xmpushbuttnclass, frme, XmNrightAttachment, XmATTACH_OPPOSITE_WIDGET, XmNrightWidget, un, Jean Berstel - Institut Gaspard Mnge,

6 4. Mtif : les widgets cnteneurs Widgets cnteneur Un exemple nrd_uest = XtVaCreateManagedWidget("nrd-uest", xmpushbuttngadgetclass, frme, XmNtpAttachment, XmATTACH_FORM, XmNleftAttachment, XmATTACH_FORM, nrd_est = XtVaCreateManagedWidget("nrd-est", xmpushbuttngadgetclass, frme, XmNtpAttachment, XmATTACH_FORM, XmNrightAttachment, XmATTACH_FORM, XmNleftAttachment, XmATTACH_WIDGET, XmNleftWidget, nrd_uest, sud_uest = XtVaCreateManagedWidget("sud-uest", xmpushbuttngadgetclass, frme, XmNbttmAttachment, XmATTACH_FORM, XmNleftAttachment, XmATTACH_FORM, XmNtpAttachment, XmATTACH_WIDGET, XmNtpWidget, nrd_uest, NO SO NE SE sud_est = XtVaCreateManagedWidget("sud-est", xmpushbuttngadgetclass, frme, XmNbttmAttachment, XmATTACH_FORM, XmNrightAttachment, XmATTACH_FORM, XmNleftAttachment, XmATTACH_WIDGET, XmNleftWidget, sud_uest, XtVaSetValues(nrd_est, XmNbttmAttachment, XmATTACH_WIDGET, XmNbttmWidget, sud_est, Jean Berstel - Institut Gaspard Mnge, Widgets cnteneur ancrage en psitin ATTACH_POSITION l la frme est quadrillée par une grille carrée; l la widget est attachée à (un côté d ) une case de la grille. l la grille est défrmée avec la mère : la psitin de chaque fille reste prprtinnelle d'accrd 4 XmNfractinBase dnne le nmbre de cases par ligne u par clnne de la grille (valeur par défaut 00). Le type d attachement pur le côté cncerné, et sa crdnnée crrespndante snt dnnés. Par exemple : XmNtpAttachment, XmATTACH_POSITION XmNtpPsitin, Jean Berstel - Institut Gaspard Mnge,

7 4. Mtif : les widgets cnteneurs Widgets cnteneur ancrage abslu ATTACH_SELF l la psitin est dnnée par ses crdnnées x,y; l si la mère est retaillée, la psitin évlue prprtinnellement. Jean Berstel - Institut Gaspard Mnge, Widgets cnteneur Pièges et prblèmes Le graphe des attachements dit être sans circuit. Les attachements relativement à une sœur (XmATTACH_WIDGET) peuvent être dnnés dans le fichier de ressurces, en spécifiant le nm (chaîne de caractères) de la widget. Une widget dit avir été créée avant qu'n peut y attacher une autre. L attachement cncerne la widget racine dans des widgets cmpsées: l CreateScrlledList u CreateScrlledText returne la widget liste u texte, l c est leur mère (ScrlledWindw) qu il faut attacher! frme = XtVaCreateManagedWidget("frme", xmfrmwidgetclass, racine, XmNfractinBase, 5, txt = XmCreateScrlledText(frme,"bla",NULL,0); XtVaSetValues(XtParent(txt), XmNleftAttachment, XmATTACH_FORM, XmNtpAttachment, XmATTACH_FORM, Jean Berstel - Institut Gaspard Mnge,

8 4. Mtif : les widgets cnteneurs Widgets cnteneur RwClumn #include <Xm/RwClumn.h> XtVaCreateManagedWidget(nm, xmrwclumnwidgetclass, mère,..., NULL) XmCreateRwClumn(mère, nm, args, nargs) Une widget qui agence ses filles en lignes et/u clnnes. Cre Cmpsite L'agencement peut être libre u frcé. Aussi utilisé de façn interne par Mtif pur les menus et les barres de menus. l les fnctins de créatin spécifiques fixent certaines ressurces. Cnstraint Rwclumn Jean Berstel - Institut Gaspard Mnge, 5 Deux agencements Widgets cnteneur spacing marginheigth spacing marginheigth marginwidth marginwidth taille naturelle PACK_TIGHT PACK_COLUMN Jean Berstel - Institut Gaspard Mnge,

9 4. Mtif : les widgets cnteneurs Widgets cnteneur Ressurces des RwClumn Orientatin : XmNrientatin l par défaut verticale (en clnnes); l pur changer en hrizntale (en lignes): XmHORIZONTAL l tut paramètre sur les clnnes (nmbre, ajustement,...) prte alrs sur les lignes. Assemblage ( packing ). :XmNpacking l XmPACK_TIGHT (défaut): les filles snt réparties au mieux, éventuellement en plusieurs clnnes, seln la place dispnible: l XmPACK_COLUMN : le nmbre de clnnes chisies est respecté; s il n y a pas assez de place, une partie des filles n est pas vue. l XmPACK_NONE : les filles snt placées aux crdnnées indiquées, (0,0) par défaut. Utilité bscure. Nmbre de clnnes : XmNnumClumns l suppse que XmNpacking vaut XmPACK_COLUMN ; l les clnnes nt même largeur sauf peut-être la dernière. Pur ajuster aussi la dernière clnne : XmNadjustLast l si False, la dernière clnne a la même largeur que les autres; l si True (défaut), cette clnne est élargie jusqu au côté. Jean Berstel - Institut Gaspard Mnge, 7 PanedWindw #include <Xm/PanedW.h> XtVaCreateManagedWidget(nm, xmpanedwindwwidgetclass, mère,..., NULL) XmCreatePanedWindw(mère, nm, args, nargs) Widgets cnteneur Agence ses filles en une clnne Cre Cmpsite Cnstraint PanedWindw Jean Berstel - Institut Gaspard Mnge, Entre deux filles cnsécutives est ajuté un séparateur muni d une pignée ( sash ). l le séparateur et la pignée snt ajutés autmatiquement; l en agissant sur la pignée, l utilisateur peut agrandir u rétrécir la hauteur d une fille. On peut juer sur la taille extrême d une fille par des ressurces de cntraintes (i.e. de la fille) XmNpaneMinimum, XmNpaneMaximum : hauteur minimale, maximale de la fille; XmNresizeHeight : si False, empêche changement de hauteur; La pignée peut avir une taille autre que par défaut (0 sur 0): XmNsashHeight, XmNsashWidth cntrôlent cette taille; XmNseparatrOn : si False, fait disparaître les lignes séparatrices