COLOR DEFINITIONS
Color definitions describe the way a specific UI element should look like in a specific context.
The only mandatory field is the "uid" attribute.
Please note also that ZAMAE default cache memory is up to
100 different color definitions at a time. This can be modified by placing the values you need in the za_UI_api.initialize()
call in the class of your own that extends the za_UI_api class.
Color definitions are made up of 3 sections:
- the first section is the color and fx description for the unfocused state of the UI object to which this color
definition is applied
- the second section defines the color and fx description for the focused state of the UI object to which this color
definition is applied
- the third section only applies to wrapper type buttons/templates, so you would usually not declare this section on any other button
than wrapper ones.
Each section has a start and ending color. This is for the styles "towhite", "fromwhite" and "centered". If you specify a starting and ending color
and a painting style of "towhite", the UI object that is declared to have this color will be painted in a "starting color" to "ending color" fashion
evenly from top to bottom (up to down). The paint style "fromwhite" will do the same, but in the inverse direction (it's just a matter of what you
like the most). The "centered" style will paint the starting color in the horizontal center of the applied UI object, and will end in the ending color
at both the upper and bottom ends of the UI object.
Each object can also have a border, with a specified color. If the border is set to "undefined", "undef", "-1" or "unknown" (or simply just not declared)
then the UI object to which this color definition is applied will not have a border.
The border attributes are self-explanatives, you will define an RGB (in hex notation) color for border drawing and also a thickness in pixels, which
will surround the UI object to which this color definition is applied, depending on the UI object state (focused or unfocused).
<color uid="69001">
<bkg_rgb_start>FFFFFF</bkg_rgb_start> //background RGB starting color
<bkg_rgb_end>undef</bkg_rgb_end> //background RGB ending color
<bkg_style>transp</bkg_style> //background RGB painting style
<border_rgb>undef</border_rgb> //background RGB for border drawing (UNDEFINED == no border)
<border_thick>undef</border_thick> //background thickness for border drawing (UNDEFINED == no border)
<bkg_focused_rgb_start>undef</bkg_focused_rgb_start> //focused RGB starting color
<bkg_focused_rgb_end>undef</bkg_focused_rgb_end> //focused RGB ending color
<bkg_focused_style>transp</bkg_focused_style> //focused RGB painting style
<border_focused_rgb>undef</border_focused_rgb> //focused RGB for border drawing (UNDEFINED == no border)
<border_focused_thick>undef</border_focused_thick> //focused thickness for border drawing (UNDEFINED == no border)
<bkg_wrap_rgb_start>undef</bkg_wrap_rgb_start> //wrap selected RGB starting color
<bkg_wrap_rgb_end>undef</bkg_wrap_rgb_end> //wrap selected RGB ending color
<bkg_wrap_style>undef</bkg_wrap_style> //wrap selected RGB painting style
<border_wrap_rgb>undef</border_wrap_rgb> //wrap selected RGB for border drawing (UNDEFINED == no border)
<border_wrap_thick>undef</border_wrap_thick> //wrap selected thickness for border drawing (UNDEFINED == no border)
</color>
Back to UI objects listing