| WideStudio Programming Guide | WideStudio Index Table of contents

> ## How to access a value of the property of the instance

> In the event program, you can access the property of the instance by the method: get/setProperty().

> the access method | Description
> Mpfc::WSCvariant getProperty() | get a value of the specified property
> Mpfc::WSCvariant setProperty() | set a value to the specified property

> ### How to get a value of the properties

> You can get a value of the property by the method of WSCbase::getProperty().

>     def event_procedure(object)

>       # To get a value of the property: "x" by string type.
>       x = object.getProperty("x")
>       printf("x=%s\n",x.getCharPtr())

>       # To get a value of the property: "y" by long type.
>       y =  object.getProperty("y")
>       printf("y=%d\n",y.getLong())

>     end

> In the example of "x", it gets a value by string type. The WSCstring type manages the buffer of the string automatically, so there is no need to manage it by programmer.
> In the example of "y", it gets the value by short type. The method: getProperty() returns a value by WSCvariant type. The WSCvariant type can convert the various kinds of type automatically.

> Methods of Mpfc::WSCvariant | function
> getChar() | To get a value of char type.
> getUnsignedChar() | To get a value of unsigned char type.
> getShort() | To get a value of short type.
> getUnsignedShort() | To get a value of unsigned short type.
> getLong() | To get a value of long type.
> getUnsignedLong() | To get a value of unsigned long type.
> getInt() | To get a value of int type.
> getUnsignedInt() | To get a value of unsigned int type.
> getFloat() | To get a value of float type.
> getDouble() | To get a value of double type.
> getCharPtr() | To get a value of string type.

> ### Setting of property

> You can set a value to the property by the method of WSCbase::setProperty().

>     def event_procedure(object)

>       # To set a value to the property: "x" by string type.
>       x="100"
>       object.setProperty("x",x)

>       # To set a value to the property: "y" by short type.
>       y=100
>       object.setProperty("y",y)

>     end

> In the example of "x", it sets a value by string type. In the example of "y", it sets a value by short type. The parameter of the method: setProperty() is WSCvariant type, so it converts the value automatically.

> ### Updating the instance to reflect the changed value

> Use the method: update(),draw(),redraw() to update the instance to reflect the changed value.

>     def event_procedure(WSCbase* object)

>       $obj1.setProperty("labelString","string1")
>       $obj1.update()   # updates the instance
>       Mpfc::WSGIappDev().update()

>       $obj2.setProperty("labelString","string2")
>       $obj2.update()   # updates the instance
>       Mpfc::WSGIappDev().update()
>     end

> Usually, it updates automatically when the event procedure is done, but if you want to update right away,you can use the method: update(),draw(),redraw().
> The method: update() or draw() updates the instance if needed, but redraw() updates compulsory.

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