This translation is older than the original page and might be outdated. See what has changed.


The Group are the tabs which will appear when we create a new project or we edit an existing object of the collection, each group is assigned with an ID, that is used to define into the fields to which tab belongs that field.

If no group is identified for a property, the data layer will always make the properties belong to the first group defined at the collection.

Tabs view on POCKET PC Tabs view on Blackberry Tabs view on IPhone
pda1.jpg bb_pestanas.jpg iphone.jpg


  <group name="General" id="1"></group>
  <group name="Actividad" id="2"></group>
  <group name="Cobro" id="3"></group>
  <group name="Ventas" id="4"></group>
  <GROUP name=”” id=”” disableedit=”” disablevisible=”” imgbk=”” bgcolor=””/>\\


The GROUP node to a visual level, are the tabs of the edition of an object.


ATTRIBUTEDESCRIPTION
nameCaption or literal displayed on the screeen.
idnumeric value which is going to identify in a unique way to that group/tab.
disableeditIf the condition is met , it disables the editing of all the properties/ fields of the tab. IMPORTANT, do not leavy any gap between the field and the value of the condition, for instance: “ESTADO=1”
disablevisibleSimilar than the previous one, but in this case, If the condition is met, the tab is not even showed. Just as it happens with the disableedit, DO NOT leave any gap between the field and the condition value.
imgbk=“fondo.png” background image to show on the tab. When the imgbk attribute lives toghether with bgcolor, the imgbk value prevails.
bgcolor=“#FFFFFF”Background color of the RBG tab.
tab-width=“50%“It allows to define a tab width. By default, it takes the “33%” value.
fixed=“true|false”Fix tab always shown, even if you browse through the rest of the tabs.
height=“10%“ It is only used in fixed=”true” groups. It indicates the height of the window to show.
width=“100%“ It is only used in fixed=”true” groups. It indicates the width ofd the screen to show.
orientation=“top|bottom” It is only used in fixed=”true” groups. It indicates where the blocked group is going to be shown.
animation-inAnimation that occurs when you enter into the group.
animation-outAnimation that occurs when you exit from the group.

All the properties where you put group=“Value” will belong to that group.

Example:

  <group name="General" id="1" disableedit="ESTADO=1 OR VISIBLE='TRUE'" />  
  <prop name="CODIGO" ... group="1">    
<!-- 
	Esto indica que el campo código se verá en la pestaña "General".
	En lugar de deshabilitar un campo concreto, podemos poner una regla a nivel de group para que TODOS los campos
	de dicha pestaña estén deshabilitados. 
-->


To unable all the properties of a tab, to a GROUP level, we can set a rule that is always followed.
For instance: <group name=“Cobro” id=“3” disableedit=“1=1” />


ATTRIBUTEDESCRIPTION
notab=”true|false”By default it is “false”. If it is put to “true”, it hides all the tabs of the edition. That doesn´t mean that we cannot “go from a tab into another one” with buttons or by making “swipe” with the finger, it is simply that the user does not see them on screen and cannot insert them directly.
group-swipe=“true|false”By default to “true”, it allows us to move from one tab to another one by swiping with the finger as if it was a paper sheet. If we put it to “false” and it is combined with notab=“true”, the user wont be able to move anymore from a tab into another one, in such way that the programmer will have to create some buttons that show a tab or another one.
tab-orientation=”top|bottom”It indicates where the tabs on screen are going to be displayed. On the top or bottom. By default, it will be on the top.

If we have several GROUP those will be displayed on screen by order of appearance in the code, NO for its ID.


A way to leave a fixed group (tab) has been defined. It is fixed in all tabs of a collection, so that what changes when we change to another “screen” is only the content that is not “fixed”.

At this moment, only it is possible to put fixed groups at the top and bottom. It is useful when we want to leave a browser header or a screen options bar.

The fixed group definition is made with the attributes to a GROUP: fixed=“true” and orientation=“top|bottom” level.

Once the fixed group is defined with a size, the remaining space will be taken as 100% of the screen, that is, you should NOT count on what the fixed group occupies.

<group name="HEADER" id="10" fixed="true" orientation="top" width="100%" height="7%">
	<prop name="SALIR" type="B" class="btsalirsuper" />
	<prop name="MENU" type="TL" class="tlsuper" title="BASICOS" />
	<prop name="BTMENU" type="B" class="btmenuicon" method="ExecuteNode(onback)" />
</group>


A drawer, is a group of controls that is invisible until it is removed by dragging with the finger from one of the lateral edges of the screen.

The drawer group can be deployed as we are into any group of the collection.

When the drawer is deployed, to what is behind it is applied a semitransparent layer that darkens the background. Clicking on the semitransparent layer hides the drawer.

XML ATTRIBUTES


ATTRIBUTES DESCRIPTION
drawer-orientation Values: left or right. It indicates that the group is a drawer and from where it is deployed.
width Width in pixels or percentage of the drop-down group.
height Height in pixels or percentage of the drop-down group.


Drawer Methods


METHOD DESCRIPTION
ui.showGroup( “param1” ,“param2”, param3 ,“param4”,param5 ) param1: (string), Group we want to show.
param2: (string), entry animation.
param3: (integer), entry duration
param4: (string), exit animation.
param5: (integer), exit duration.
ui.hideGroup(idGrupo) As parameter it is necessary to indicate it the group we want to hide.
ui.toggleGroup(grupo) As parameter it is necessary to indicate it the group we want to show/hide. It acts like a switch, if the group is visible it hides it, and if it is hidden, it shows it.
ui.lockGroup(idGrupo,close) As parameters it is necessary to indicate it the group we want to lock and in which status we want to lock it, visible or hidden. This second parameter is close(booleano) in a way that true will lock it closed and hidden, and false will lock it deployed or visible.
ui.unlockGroup(idGrupo) As parameter it is necessary to indicate it the group we want unlock.
<group name="Drawer" id="99" drawer-orientation="left" width="70%" height="100%">
	<prop .... />
</group>

Example of use:

	ui.showGroup( "1","##ALPHA_IN##",600,"##ALPHA_OUT##",600);