| WideStudio Programming Guide | WideStudio Index Table of contents

> ## How to access to the GUI instances

> During the event procedures, access to the instances is the most fundamental. So I will explain various ways of accessing the instance in this section.
> - Accessing of the instance by the parameter of the event procedure
>   In the event procedure which the instance has, we use the parameter of the procedure to access the instance,
> - Accessing of the instance by using the instance management
>   We use the instance management to access the instance except it which the event procedure is set.
> - Accessing of the global instance directly
>   You can use the global instance to access directly. it is easy to access and is good performance, but it makes the possibility of porting worse.

> ### Accessing of the instance by the parameter of the event procedure

>     void event_procedure(WSCbase* object){
>       //accessing the instance.
>       object->setProperty(WSNlabelString,"HELLO WORLD");
>     }

> the pointer: object is the instance which is the client of the event procedure that fired. the type is WSCbase*, so you can access the method of WSCbase, but you must cast the pointer by the method:cast() to access the other subclass: see the chapter of casting sub class.

> ### Accessing of the instance by using the instance management

> The instance management returns the instance by name.

> The instance management class | The instance acquisition method
> WSCbaseList | WSCbaseList* WSGIappObjectList()

> To access of the instance as follows:

>     //to access WSGIappObjectList()
>     #include "WSCbaseList.h"

>     void event_procedure(WSCbase* object){

>       // Acquisition of the instance(1)
>       char* class_name = "WSCvlabel"; //Seek from the instance of WSCvlabel class
>       char* obj_name   = "newvlab_001";     //the instance name is newvlab_001
>       WSCbase* object = WSGIappObjectList()->getInstance(class_name,obj_name);
>       object->setProperty(WSNlabelString,"HELLO WORLD");

>       //Acquisition of the instance(2)
>       char* class_name2 = "WSCbase";  //Seek from all the instances.
>       char* obj_name2   = "newvlab_002";     //the instance name is newvlab_002
>       WSCbase* object2 = WSGIappObjectList()->getInstance(class_name2,obj_name2);
>       object2->setProperty(WSNlabelString,"HELLO WORLD");

> The variable: object is the sought instance by the specified class name and the specified instance name. If you do not want to specify the class name, you can pass "WSCbase", it seeks from all the instances.

> ### Accessing of the global instance directly

> Make the instance global,you can access it directly. See the chapter [Setting of global instance] of Application Builder User's Guide to make it global.

>     #include "WSCvlabel.h" //to access WSCvlabel class

>     void event_procedure(WSCbase* object){
>       //extern of the global instance
>       extern WSCvlabel* newvlab_001;

>       //Access the instance of WSCvlabel*: newvlab_001
>       newvlab_001->setProperty(WSNlabelString, "HELLO WORLD");

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