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.