User Tools

Site Tools


columns_ui:config:colour_string

This is an old revision of the document!


Style script

About

The style string is a title formatting script that determines the colour of a cell in the playlist. The global style string is the default for all columns, but you can assign a different style string to a particular column from the columns config page.

Syntax

Setting the text colour

You can set the text colour as follows:

$set_style(text,text colour,selected item text colour[,selected item text colour when window is not focused])

Setting the background colour

You can set the background colour as follows:

$set_style(back,background colour,selected item background colour[,selected item background colour when window is not focused])

Setting the frame style

You can set the frame style as follows:

$set_style(frame part,enabled state[,colour])

where

  • frame part is either frame-top,frame-left,frame-bottom,frame-right
  • enabled state is either 1 (true) or 0 (false).
  • colour is the colour of the frame, required if enabled state is 1.

Technical information

A colour code in the style string differs slightly from colour codes in the display string and other such strings in the following ways:

  • They do not have to be surrounded by '' characters.
  • They do not have to be zero-padded upto six digits.

Of course, doing these things offers little harm, only in the form of neglibly longer parsing.

i.e., in this string a colour code is a hexadecimal number, taken to be in the form BBGGRR, where RR is the red component of the colour, GG is the green component of the colour, and BB is the blue component of the colour. Of course, as already mentioned, leading zeros can be omitted for colour codes in the style string.

Example

The following is an example of a style string:

$set_style(text,FF,0)
$set_style(back,FFFFFF,FFFF)
$set_style(frame-left,1,0)

This string will set colours as follows:

  • Default text - Red
  • Default selected text - Black
  • Background - White
  • Selected background - Yellow
  • Cell frame on left side only - Black colour
columns_ui/config/colour_string.1216240771.txt.gz · Last modified: 2008/07/16 20:39 (external edit)