Theme (PRIM_THM)

Styles to be used as a base for the application appearance

Ancestors - Object (PRIM_OBJT)

Details

A Theme is a collection of DrawStyles used to configure the appearance and behavior of controls and features of an application.  It is akin to a typical CSS file defined for a web page, providing a central point in which to define the vast majority, if not all, of the styles required in an application.
 
A range of predefined System Themes is shipped with the product providing a base set of colors based on the Google Material Design guidelines. The default theme for Web Pages is 2015Gray. These themes may be entirely adequate for many applications and can be applied with little more than a click or two in the IDE by selecting the required theme from the ribbon.
 
Default themes can be extended by creating a user Themes. A different BaseTheme can be adopted as required, and the default DrawStyles can be modified to implement whatever color scheme is required. In addition, DrawStyles can be created to suit whatever formatting option is desired.
 
Themes are tightly integrated with the IDE. When a Theme is applied to a Web Page for example, the controls and features of the application will immediately respond appearing as they would at runtime. Controls subsequently added to the page will also appear correctly. While a Web Page has the Theme specified, individual reusable parts are designed in isolation with no knowledge of the Theme to be used at run time. To simplify the design process and to bring it in to line with designing a page, the IDE supports a Design Theme. By specifying a design Theme, the IDE is given a context, allowing reusable parts to appear correctly.
 
The Color Palette of a Theme can be modified, but with the exception of the Text, Border and Line colors, it is recommended that new DrawStyles be created.

Properties

Name Description
BaseTheme LANSA supplied theme to be used as a base set of styles and colors
ComponentClassName ComponentClassName is the name of the component's class. Inherited from Object (PRIM_OBJT)
ComponentMembers ComponentMembers provides access to all the member components of this component Inherited from Object (PRIM_OBJT)
ComponentPatternName ComponentPatternName is used to qualify the class of the component. Inherited from Object (PRIM_OBJT)
ComponentTag Generic space allowing a value to be stored for the instance Inherited from Object (PRIM_OBJT)
ComponentType ComponentType gives you access to the type information about the component Inherited from Object (PRIM_OBJT)
ComponentTypeName ComponentTypeName is the fully qualified name of the component's class. Inherited from Object (PRIM_OBJT)
Name Name identifies the component Inherited from Object (PRIM_OBJT)
Owner Owner owns this component Inherited from Object (PRIM_OBJT)
Parent The component instance to which this instance is attached. The visual container for a control or the collector of a set of child instances Inherited from Object (PRIM_OBJT)
Style Reference to a Style used to define theme defaults
Styles Theme default property allowing programmatic access to individual styles
Theme100Color One of a set of complementary predefined base theme colors
Theme200Color One of a set of complementary predefined base theme colors
Theme300Color One of a set of complementary predefined base theme colors
Theme400Color One of a set of complementary predefined base theme colors
Theme500Color One of a set of complementary predefined base theme colors
Theme50Color One of a set of complementary predefined base theme colors
Theme600Color One of a set of complementary predefined base theme colors
Theme700Color One of a set of complementary predefined base theme colors
Theme800Color One of a set of complementary predefined base theme colors
Theme900Color One of a set of complementary predefined base theme colors
ThemeA100Color One of a set of complementary predefined base theme accent colors
ThemeA200Color One of a set of complementary predefined base theme accent colors
ThemeA400Color One of a set of complementary predefined base theme accent colors
ThemeA700Color One of a set of complementary predefined base theme accent colors
ThemeAccentDarkColor One of a set of complementary predefined base theme accent colors
ThemeAccentLightColor One of a set of complementary predefined base theme accent colors
ThemeAccentMediumColor One of a set of complementary predefined base theme accent colors
ThemeBorderColor Base theme border color
ThemeDisabledColor Base theme disabled color
ThemeErrorDarkColor One of a set of complementary predefined base theme error colors
ThemeErrorLightColor One of a set of complementary predefined base theme error colors
ThemeErrorMediumColor One of a set of complementary predefined base theme error colors
ThemeInactiveColor Base theme inactive color
ThemeLineColor Base theme line color
ThemeSuccessDarkColor One of a set of complementary predefined base theme success colors
ThemeSuccessLightColor One of a set of complementary predefined base theme success colors
ThemeSuccessMediumColor One of a set of complementary predefined base theme success colors
ThemeTextColor Base theme text color
ThemeTextLightColor Base theme light text color

Events

Name Description
CreateInstance CreateInstance is signalled when an instance of a component is created Inherited from Theme (PRIM_THM)
DestroyInstance DestroyInstance is signalled when an instance of a component is about to be destroyed Inherited from Theme (PRIM_THM)

See also

All Component Classes

Technical Reference

LANSA Version 15, April 2020