Step 2 - Set a property value using the Kanzi Engine API¶

In this step you create in Kanzi Studio a Text Block 2D node and an alias pointing to that node, then using the Kanzi Engine API you set the value of the property that defines the content shown by the Text Block 2D node in your Kanzi application.

To set a property value using the Kanzi Engine API:

In Kanzi Studio in the Node Tree press Alt and right-click the RootPage node and select Text Block 2D.
In the Node Tree press Alt and right-click the Text Block 2D node that you created and select Alias.

Kanzi Studio creates an alias pointing to the node from which you created the alias and adds it to the resource dictionary of its nearest ancestor node that contains a resource dictionary.

In this example the nearest node with a resource dictionary is the Screen node. In the application code of this project you use the name of the alias to find and get that Text Block 2D node.

Tip

You can retrieve alias target nodes with bindings or the Kanzi Engine API using the hash sign (#) followed by the name of the alias, regardless of the node location in the project.

Tip

You can see in the Dictionaries window the list of resources in the resource dictionaries that the node selected in the Node Tree can access.
In Kanzi Studio select File > Export > Export KZB.

In Visual Studio in hello_world.cpp in the beginning of the onProjectLoaded() function add:

void onProjectLoaded() override
{
    // Get the Screen node whose resource dictionary contains the alias to the Text Block 2D node.
    ScreenSharedPtr screenNode = getScreen();
    // Get the Text Block 2D node using the alias you created in the Kanzi Studio project.
    // The name of the alias is the same as the node name you used for the Text Block 2D in the Kanzi Studio project with the # sign prefix.
    TextBlock2DSharedPtr textBlock = screenNode->lookupNode<TextBlock2D>("#Text Block 2D");
    // Set the value of the Text Block 2D Text property to Hello world!.
    textBlock->setText("Hello world!");

    ...
}

When you run your Kanzi application, the setText() function sets the Text property of the Text Block 2D to Hello world! so that the text block shows Hello world!.

This is what your hello_world.cpp looks like when you complete this step.

#include <kanzi/kanzi.hpp>
#include <kanzi/core/log/log.hpp>

using namespace kanzi;

class HelloWorld: public ExampleApplication
{
    void onConfigure(ApplicationProperties& configuration) override
    {
        configuration.binaryName = "hello_world.kzb.cfg";
    }

    void onProjectLoaded() override
    {
        // Get the Screen node whose resource dictionary contains the alias to the Text Block 2D node.
        ScreenSharedPtr screenNode = getScreen();
        // Get the Text Block 2D node using the alias you created in the Kanzi Studio project.
        // The name of the alias is the same as the node name you used for the Text Block 2D in the Kanzi Studio project with the # sign prefix.
        TextBlock2DSharedPtr textBlock = screenNode->lookupNode<TextBlock2D>("#Text Block 2D");
        // Set the value of the Text Block 2D Text property to Hello world!.
        textBlock->setText("Hello world!");

        // Prints Hello world! to the Kanzi debug console.
        kzLogInfo(KZ_LOG_CATEGORY_GENERIC, ("Hello world!"));
    }
};

Application* createApplication()
{
    return new HelloWorld;
};

< Previous step

What's next?¶

In this tutorial you learned how to create a Kanzi Studio project with a C++ application and use the Kanzi Engine API to edit a property of a node you created in Kanzi Studio. To learn more about using the Kanzi Engine API, see:

Step 2 - Set a property value using the Kanzi Engine API¶

What's next?¶

See also¶