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
mwt::WSCvariant mwt::WSCbase_getProperty()	get a value of the specified property
mwt::WSCvariant mwt::WSCbase_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().

#----------------------------------------------------------
#Function for the event procedure
#----------------------------------------------------------
use mwt;
                                                                                
sub event_procedure {
        my ($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());
}
1;

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 a value by short type. The method: getProperty() returns a value by WSCvariant type. The WSCvariant type can convert the various kind of type automatically.

Methods of mwt.SCvariant	function
mwt::WSCvariant_getChar()	To get a value of char type.
mwt::WSCvariant_getUnsignedChar()	To get a value of unsigned char type.
mwt::WSCvariant_getShort()	To get a value of short type.
mwt::WSCvariant_getUnsignedShort()	To get a value of unsigned short type.
mwt::WSCvariant_getLong()	To get a value of long type.
mwt::WSCvariant_getUnsignedLong()	To get a value of unsigned long type.
mwt::WSCvariant_getInt()	To get a value of int type.
mwt::WSCvariant_getUnsignedInt()	To get a value of unsigned int type.
mwt::WSCvariant_getFloat()	To get a value of float type.
mwt::WSCvariant_getDouble()	To get a value of double type.
mwt::WSCvariant_getCharPtr()	To get a value of string type.

---

Setting of property

You can set a value to the property by the method of mwt::WSCbase_setProperty().

#----------------------------------------------------------
#Function for the event procedure
#----------------------------------------------------------
use mwt;
                                                                                
sub event_procedure {
        my ($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);
    return;
}
1;

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.

#----------------------------------------------------------
#Function for the event procedure
#----------------------------------------------------------
use mwt;
                                                                                
sub event_procedure {
  my ($object) = @_;
                                                                                
  $newvlab_001->setProperty("labelString","string1");
  $newvlab_001->update();   # updates the instance
  mwt::WSGIappDev()->update();
                                                                                
  $newvlab_002->setProperty("labelString","string2");
  $newvlab_002->update();    # updates the instance
  mwt::WSGIappDev()->update(); 
  return;
}
1;

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.