Themed View Elements

This is a special purpose element. It allows a hiearchy of theme items representing a visual look to be declared without actually creating an instance of them. Then, an actual instance of that hierarchy can be created dynamically and used to draw the visual look to some user interface component eg. a custom widget.

    <page>
        <text>This is my standard theme</text>
        <image src="hello"/>
        <template name="button">
            <image rect="0,0,0,0" src="buttonbg"/>
            <text rect="0,0,0,0" align="hcenter,vcenter">Click me.</text>
        </template>
    </page>

In the above example a template "button" is defined that declares a visual look consisting of an image and some text. The button template is not drawn as part of the theme, it just exists in its hierarchy as a convenient way to access it. You could create an instance of the "button" template using ThemeTemplateItem::createInstance() and then draw it to a custom widget using ThemedView::paint().

For more information also see the Themed Views: Templates documentation.