ContainerOrderBack

int ContainerOrderBack(int pcn, int cn);

 

Changes a container's z-order by sending it to the bottom of the "stack" of containers within the parent container.

 

Return Value

 

Returns one if container was found, zero otherwise.

 

Parameters

 

pcn

Handle to a parent container where the container was added.

 

cn

Handle to the container to be sent to the bottom of the "stack".

 

Remarks

 

The ContainerOrderBack() function affects the z-order of a specified container within a parent container by sending it "behind" all of the other containers in the parent container.

 

Availability

 

Available in DragonFireSDK 2.0 and later.

 

Example

 

The sample code below adds some containers to the screen as well as adding containers to those containers.  Additionally, it adds some buttons for changing the z-order of the containers with respect to each other as well as for the containers within containers.

 

#include "DragonFireSDK.h"

 

int cn1;

int cn2;

int cn1a;

int cn2a;

int cn1b;

int cn2b;

int ft;

 

int OnButton(int id)

{

  if (id==1)

      // Bring Red / Green container to the back

       ContainerOrderBack(0,cn1);

  else

  if (id==2)

      // Bring Blue / Yellow container to the back

       ContainerOrderBack(0,cn2);

  else

  if (id==3)

      // Within c1, bring Red to back

       ContainerOrderBack(cn1,cn1a);

  else

  if (id==4)

      // Within c1, bring Green to back

       ContainerOrderBack(cn1,cn1b);

  else

  if (id==5)

      // Within c2, bring Blue to back

       ContainerOrderBack(cn2,cn2a);

  else

  if (id==6)

      // Within c2, bring Yellow to back:

       ContainerOrderBack(cn2,cn2b);

 

  return(id);

}

 

void AppMain()

{

   LandscapeMode();

 

   cn1=ContainerAdd(0,10,50);

   cn1a=ContainerAdd(cn1,0,0);

   cn1b=ContainerAdd(cn1,20,20);

   cn2=ContainerAdd(0,100,140);

   cn2a=ContainerAdd(cn2,0,0);

   cn2b=ContainerAdd(cn2,20,20);

 

  // Add red and green blocks to c1:

   ViewAdd(cn1a,"Images/red.png",0,0);

   ViewAdd(cn1b,"Images/green.png",0,0);

 

  // Add blue and yellow blocks to c2:

   ViewAdd(cn2a,"Images/blue.png",0,0);

   ViewAdd(cn2b,"Images/yellow.png",0,0);

 

   ButtonAdd("Images/Button",0,0,OnButton,1);

   ButtonAdd("Images/Button",60,0,OnButton,2);

   ButtonAdd("Images/Button",120,0,OnButton,3);

   ButtonAdd("Images/Button",180,0,OnButton,4);

   ButtonAdd("Images/Button",240,0,OnButton,5);

   ButtonAdd("Images/Button",300,0,OnButton,6);

 

  int ft=FontAdd("Helvetica","Bold",12,0xffffff);

 

   TextAdd(23,7,"c1",ft);

   TextAdd(83,7,"c2",ft);

   TextAdd(140,7,"c1a",ft);

   TextAdd(200,7,"c1b",ft);

   TextAdd(260,7,"c2a",ft);

   TextAdd(320,7,"c2b",ft);

}

 

void AppExit()

{

 

}

 

void OnTimer()

{

 

}