David @ Tokyo

Continuing my notes on e17 functions learnt before I forget them...

Issue: You want to restrict the size of a module on your e17 background canvas, because it will just look stupid and ugly at any other size.

E17's gadget manager enables modules to be moved and resized around your desktop. The module doesn't need to worry about this at all, other than to tell the gadman about itself when created.

In your module's .edc file you can define the maximum and minimum width and height for the module's interface. Say you have a group of parts called "main" like yay:

   group
   {
      name: "main";
      min: 10  10;
      max: 256 256;
      ... (definition of the parts of the interface) ...
   }

Here we are describing the interface's name and it's min and max dimensions, but that alone doesn't do anything useful. To actually get e17's gadget manager to honour these size restrictions you'll need to (gasp!) tell the gadman about it, in addition to the other setup.

The e_gadman_client_{min | max}_size_set functions are the ones you need to call to do this, and to extract the min and max values out of your edje (compiled from your .edc) you use the edje_object_size_{min | max}_get functions:

   Evas_Coord w, h;

   ...

   edje_object_size_min_get(face->edje_object, &w, &h);
   e_gadman_client_min_size_set(face->gmc, w, h);
   edje_object_size_max_get(face->edje_object, &w, &h);
   e_gadman_client_max_size_set(face->gmc, w, h);

Now when you try to resize your module it'll be kept within the sane range of sizes that you defined for it.

Labels: enlightenment