| WideStudio Programming Guide | WideStudio Index Table of contents

> ## How to get the children of the instance

> You can get the children which the instance contains with the following method.

> The method | Description
> WSCbase* getChildInstance(char*) | Returns the child by the instance name
> WSClistData getChildren() | Returns the children
> long getAllChildren(WSClistData&) | Returns recursively all of the children

> ### How to get the child by the specified name

> You can get the child by the specified name with the method: WSCbase::getChildInstance();

>     void event_procedure(WSCbase* object){
>       //get the child which name is "newpbtn001"
>       WSCbase* child = object->getChildInstance("newpbtn001");
>       if (child != NULL){
>         //the child exists.
>         child->setVisible(True);
>       }
>     }

> In the example, WSCbase::getChildInstance() seeks the child which name is "newpbtn001" from the instance: "object" recursively, and returns it if finds or returns NULL if not.

> ### How to get the children

> You can get the children which the instance contains with the method: WSCbase::getChildren();

>     void event_procedure(WSCbase* object){
>       //get the list of the children.
>       WSClistData children = object->getChildren();
>       //get the number of the children.
>       long num = children.getNum();
>       long i;
>       for(i=0; i<num; i++){
>         //get each child from the list.
>         WSCbase* child = (WSCbase*)children[i];
>     //  WSCbase* child = (WSCbase*)children.getData(i); //same as children[i].
>         //access the child.
>         child->setVisible(False);
>       }
>     }

> The example shows acquisition of the children which the instance contains. The method: WSCbase::getChildren() returns the list: WSClistData which contains the children of the instance. You can access each child with the method getData(i),array operator[i] of the list, and cast void* to WSCbase*.

> ### How to get all of the children recursively

> You can get all of the children recursively with the method WSCbase::getAllChildren().

>     void event_procedure(WSCbase* object){
>       //the list for the return value of getAllChildren().
>       WSClistData children;
>       //get all of the children.
>       object->getAllChildren(children);
>       //get the number of children.
>       long num = children.getNum();
>       long i;
>       for(i=0; i<num; i++){
>         //get each child from the list.
>         WSCbase* child = (WSCbase*)children[i];
>         //access the child.
>         child->setVisible(True);
>       }
>     }

> The example shows acquisition of all of the children. The difference from getChildren() is that it returns recursively all of the children of the instance, of the children,....

> ### How to get all of the children of the parent application window

> We call the method: WSCbase::getAllChildren() of the parent application window to get all of the children of it.

>     void cbop(WSCbase* object){
>       //get the parent application window.
>       WSCbase* win = object->getParentWindow();
>       //a list for the return value.
>       WSClistData children;
>       //get all of the children of the application window.
>       win->getAllChildren(children);
>       //get the number of the children.
>       long num = children.getNum();
>       long i;
>       for(i=0; i<num; i++){
>         //get each child.
>         WSCbase* child = (WSCbase*)children[i];
>         //access the child.
>         child->setVisible(False);
>       }
>     }

Document Release 3.70 for WideStudio ver 3.70, May 2004

WideStudio documents index | Table of contents

Copyright(C) WideStudio Development Team, 1999-2004 | Last modified: May 25, 2004