Tutorial 8 - Understand API - Questions & Answers

[steven]

Most of developers feel happy when they are using visual builder to design the user interface. Bust some of them get confused when it comes to Sigma Visual API. They don't know how to get started. In this section, I would like to clarify some concepts so you can continue to do with Sigma Visual.

Q: What's the relationship between API and Properties of Components?
In a simple word, very property has two relevant API functions, setter and getter. Take button for example. You can find [caption] when you expand [property] in the [Component Config Window]. So there must be two API functions, setCaption & getCaption. I bieleve you can change it's caption to "Foo" in visual builder.
You can change it by the following code.
button1.setCaption("Foo");
You can get caption string by the following code.
var str = button1.getCaption();

Q: Every event handler has profile as first parameter. What is profile & and what I can do with it?
First parameter, profile, is an object of class linb. UIProfile. It contains all relevant data of component where event is fired. Developer could get an GUI components by profile.boxing().
I write the following codes for a button on click event.
function (profile, e, src, value) {     profile.boxing().setCaption("Foo"); }
With codes above, button changes its caption when clicked.