User Tools

Site Tools


en:wiki:2.-desarrollo-app:2.3.-codigo:a.-estructura-xml:4.-nodo-frame:start

FRAME Node


Definition


The frame node allows to create visuals in the edition windown. In the web it woul be the equivalent to DIV tag. To respect compatibility with the previous one, the frame node and its use in the prop desn´t affect the interpretation of the machines that not support it.

Sintax:

<frame name="id1" ... />
	<prop name="PRUEBA" ... />
	<prop name="PRUEBA2" ... />
	<frame name="id2" ... />
		<prop name="PRUEBA3" ... />
		<prop name="PRUEBA4" ... />
	</frame>
</frame>

Spatial location of the frames and its elements


The frame nodes may be nested, that is, a frame may be inside of another frame and so on.

The prop nodes inside of a frame behave the same than its location in the group, if it has newline=“false” is located next to the property, otherwise on the bottom. In the frame the lmargin (left margin),tmargin(top margin),rmargin(right margin) and bmargin(bottom margin) attributes are interpreted for all the prop.


Floating frames

A frame can be positioned on a fixed location, “floating” over the screen, keeping away the background screen from being affected by the floating frame.

Positioning is made through the attributes “top” and “left”.

Do not use porcentual values in width and height attributes, try to use pixel values instead.

<frame name="frmFlotante" floating="true" top="300p" left="200p" width="600p" height="300p" class="FrameAnimateFromRight" >
	.....
</frame>

Frame Nodes Attributes


ATTRIBUTES DESCRIPTION
frame string with any format. It indicates the name of the frame father to which that frame belongs to.
newline true | false. (Value by default “true”) It indicates if the frame is located next or alongside the previous element.
forecolor color format string.(Value by default “#000000”) Color with which the borders of the frame are designed with.
bgcolor color format string. (Value by default “#00000000” transparent) Background color of the frame. It meets the format for rectangular gradients ##COLOR1,#COLOR2,#COLOR3
imgbk path format string.(Value by default “” empty) Background image of the frame.
framebox true | false. (Value by default “true”)It allows to show or hide the borders box around the frame.
border-width integer number. (Value by default “1”) .Border width around the frame.
border-left true | false. (Value by default “true”). It allows to define if the left border is shown or it doesn´t.
border-top true | false. (Value by default “true”). It allows to define if the top border is shown or it doesn´t.
border-right true | false. (Value by default “true”). It allows to define if the right border is shown or it doesn´t.
border-bottom true | false. (Value by default“true”). It allows to define if the bottom border is shown or it doesn´t.
align left | right | center | top | bottom. (Value by default “left”). It can be a combination of that values separated by | and positions all the elements within the frame in the location derived from the combination used. There are some no logical combinations, it is made only the combinations which can be made. Example. top | bottom, the combination is dismissed center | top, located at the center on the top of the frame. center, located in the center of the screen. center | left. Located in the horizontal center and to the right.
lmargin Númericofloat.(Value by default “0”). Margin on the left from which the frame is located. Its value is the multiplication of a character width with the standard Font of the device by the indicated value.
tmargin Númericofloat.(Value by default “0”). Top margin from which the frame is located in. Its value is the multiplication of a width of character with the standard Font of the device by the indicated value.
rmargin Númericofloat.(Value by default “0”). Right margin from which the frame is located in. Its value is the multiplication of a width of character with the standard Font of the device by the indicated value.
bmargin Númericofloat.(Value by default “0”). Bottom margin from which the frame is located in. Its value is the multiplication of a width of characte with the standard Font of the device by the indicated value.
lpadding Númericofloat.(Value by default “0”). Internal margin of the frame to the right side from which the elements inside of the frame are located in. Its value is the multiplication of a width of character with the standard Font of the device by the indicated value.
tpadding Númericofloat.(Value by default “0”). Interior margin of the rame in the top part from which the elements inside the frame are located in. Its value is the multiplication of a width of character with the standard Font of the device by the indicated value.
rpadding Númericofloat.(Value by default “0”). Interior margin of the frame to the left side from which the elements inside the frame are located in. Its value is the multiplication of a width of character with the standard Font of the device by the indicated value.
bpadding Númericofloat.(Value by default “0”). Interior margin of the frame in the bottom part from which the elements inside of the frame are located in. Its value is the multiplication of a width of character with the standard Font of the device by the indicated value.
width Dimension type* (value by default adjusted to the children.) It allows to define the frame width in the space it is located in. If it is not defined, it is set to the size of the properties that contain it.
height Tipo dimensión* (value by default adjusted to the children.) It allows to define the frame height of the frame in the space in which is located in. If it is not defined, it is set to the size of the properties that contain it.
floating Valuestrue or false(the false value is the predetermined one). If it is true it indicates that the frame is floating and it will be designed in the coordinates specified in left and top above any other control. The position of the floating frame is relative to the group when is not defined the frame attribute, otherwise (that the frame attribute is defined )its position will be relative to the frame father.
top Decimal value in pixels. It indicates the vertical coordinate where the frame will be positioned in.
scroll true or false value (the false value is the predetermined one). If it is true it indicates that it allows to make scroll if the content area of the frame is bigger.
left Decimal value in pixels. It indicates the horizontal coordinate where the frame will be located in.
animation-in Valuestring. It indicates the animation macro to show the frame.
animation-out Value string. It indicates the animation macro to hide the frame.
animation-in-delay Decimal value in milliseconds. It indicates the animation duration to show the frame.
animation-out-delay Decimal value in milliseconds. It indicates the animation duration to hide the frame.
disablevisible Attribute that allows to decide the visibility in a conditional way, it will be invisible while the condition is fulfilled.
ignore-touch-on-transparent-area Attribute to be used in a floating frame (floating=“true), when ignore-touch-on-transparent-area=“true”, prevents from touching event to hit on a background screen behind a transparent area in a floating frame.

Animation Attributes

It can be defined in the heading of the groups or in the frames the entry effect we want by default for the group or frame…

<group name="General" id="1" height="100%" animation-out="animación de salida" animation-in="animación de entrada" >
<frame name="frmFlotante" floating="true" top="300px" left="200px" width="600px" height="300px" class="FrameAnimateFromRight" >

.FrameAnimateFromTop
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale por arriba. */
	animation-in:##PUSH_DOWN_IN##;		/* Aparece por arriba */
	animation-out:##PUSH_OUT##;		/* Se va por arriba */
}
 
.FrameAnimateFromBottom
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale por abajo. */
	animation-in:##PUSH_IN##;		/* Aparece por abajo */
	animation-out:##PUSH_DOWN_OUT##; 	/* Se va por abajo */
}
 
.FrameAnimateFromRight
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale por la derecha. */
	animation-in:##RIGHT_IN##;
	animation-out:##LEFT_OUT##;
}
 
.FrameAnimateFromLeft
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale por la izquierda. */
	animation-in:##LEFT_IN##;
	animation-out:##RIGHT_OUT##;
}
 
.FrameAnimateRotate3D
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Entra y sale rotando en 3D. */
	animation-in:##ROTATE3D_IN##;
	animation-out:##ROTATE3D_OUT##;
}
 
.FrameAnimateAlpha
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* Aparece y desaparece;. */
	animation-in:##ALPHA_IN##;
	animation-out:##ALPHA_OUT##;
 
	/* ZOOM. */
	animation-in:##ZOOM_IN##;
	animation-out:##ZOOM_OUT##;
}
 
.FrameAnimateZoom
{
	animation-in-delay:500;
	animation-out-delay:500;
 
	/* ZOOM. */
	animation-in:##ZOOM_IN##;
	animation-out:##ZOOM_OUT##;	
}

Dimension type: It is a type of data for the attributes of dimensions on screen. It may have the following formats:

  • N%: It allows to define in percentages of the display. Ex.width=”50%”
  • N: It allows to define in DIP, having into account the display density. Ex.width=”56”
  • Np: It allows to define the dimensions in pixels. Ex.height=”100p” 
en/wiki/2.-desarrollo-app/2.3.-codigo/a.-estructura-xml/4.-nodo-frame/start.txt · Last modified: 2018/09/05 18:34 by ejetoro