Skin

structure Skin

A Skin is a set of Style settings defined for various widget types. It defines what default style will be used for each type of widget inside the GUI. Changes to the styles on a GUI:SKIN will affect the subsequently created widgets inside that GUI window. Note that some of the styles are used by subparts of widgets, such as the HORIZONTALSLIDERTHUMB, which is used by a SLIDER when oriented horizontally.

If you create your own composite widgets, you can use ADD and GET to centralize setting up the style of your composite widgets.

If you wish to make a complete new Skin, the cleanest method would be to put all the graphics in a directory, along with a kOS script that given a GUI:SKIN, changes everything in that skin as needed, allowing users to run your script with their GUI:SKIN to make it use your custom skin.

Suffix Type Description
BOX Style Style for Box widgets.
BUTTON Style Style for Button widgets.
HORIZONTALSCROLLBAR Style Style for the horizontal scrollbar of ScrollBox widgets.
HORIZONTALSCROLLBARLEFTBUTTON Style Style for the horizontal scrollbar left button of ScrollBox widgets.
HORIZONTALSCROLLBARRIGHTBUTTON Style Style for the horizontal scrollbar right button of ScrollBox widgets.
HORIZONTALSCROLLBARTHUMB Style Style for the horizontal scrollbar thumb of ScrollBox widgets.
HORIZONTALSLIDER Style Style for horizontal Slider widgets.
HORIZONTALSLIDERTHUMB Style Style for the thumb of horizontal Slider widgets.
VERTICALSCROLLBAR Style Style for the vertical scrollbar of ScrollBox widgets.
VERTICALSCROLLBARLEFTBUTTON Style Style for the vertical scrollbar left button of ScrollBox widgets.
VERTICALSCROLLBARRIGHTBUTTON Style Style for the vertical scrollbar right button of ScrollBox widgets.
VERTICALSCROLLBARTHUMB Style Style for the vertical scrollbar thumb of ScrollBox widgets.
VERTICALSLIDER Style Style for vertical Slider widgets.
VERTICALSLIDERTHUMB Style Style for the thumb of vertical Slider widgets.
LABEL Style Style for Label widgets.
SCROLLVIEW Style Style for ScrollBox widgets.
TEXTFIELD Style Style for TextField widgets.
TOGGLE Style Style for Button widgets in toggle mode (GUI:ADDCHECKBOX and GUI:ADDRADIOBUTTON).
FLATLAYOUT Style Style for Box transparent widgets (GUI:ADDHLAYOUT and GUI:ADDVLAYOUT).
POPUPMENU Style Style for PopupMenu widgets.
POPUPWINDOW Style Style for the popup window of PopupMenu widgets.
POPUPMENUITEM Style Style for the menu items of PopupMenu widgets.
LABELTIPOVERLAY Style Style for tooltips overlayed on Label widgets.
WINDOW Style Style for GUI windows.
FONT string The name of the font used (if STYLE:FONT does not change it for an element).
SELECTIONCOLOR Color The background color of selected text (eg. TEXTFIELD).
ADD(name, style) Style Adds a new style.
HAS(name) Boolean Does the skin have the named style?
GET(name) Style Gets a style by name (including ADDed styles).
Skin:BOX
Type:Style
Access:Get/Set

Style for Box widgets.

Skin:BUTTON
Type:Style
Access:Get/Set

Style for Button widgets.

Skin:HORIZONTALSCROLLBAR
Type:Style
Access:Get/Set

Style for the horizontal scrollbar of ScrollBox widgets.

Skin:HORIZONTALSCROLLBARLEFTBUTTON
Type:Style
Access:Get/Set

Style for the horizontal scrollbar left button of ScrollBox widgets.

Skin:HORIZONTALSCROLLBARRIGHTBUTTON
Type:Style
Access:Get/Set

Style for the horizontal scrollbar right button of ScrollBox widgets.

Skin:HORIZONTALSCROLLBARTHUMB
Type:Style
Access:Get/Set

Style for the horizontal scrollbar thumb of ScrollBox widgets.

Skin:HORIZONTALSLIDER
Type:Style
Access:Get/Set

Style for horizontal Slider widgets.

Skin:HORIZONTALSLIDERTHUMB
Type:Style
Access:Get/Set

Style for the thumb of horizontal Slider widgets.

Skin:VERTICALSCROLLBAR
Type:Style
Access:Get/Set

Style for the vertical scrollbar of ScrollBox widgets.

Skin:VERTICALSCROLLBARLEFTBUTTON
Type:Style
Access:Get/Set

Style for the vertical scrollbar left button of ScrollBox widgets.

Skin:VERTICALSCROLLBARRIGHTBUTTON
Type:Style
Access:Get/Set

Style for the vertical scrollbar right button of ScrollBox widgets.

Skin:VERTICALSCROLLBARTHUMB
Type:Style
Access:Get/Set

Style for the vertical scrollbar thumb of ScrollBox widgets.

Skin:VERTICALSLIDER
Type:Style
Access:Get/Set

Style for vertical Slider widgets.

Skin:VERTICALSLIDERTHUMB
Type:Style
Access:Get/Set

Style for the thumb of vertical Slider widgets.

Skin:LABEL
Type:Style
Access:Get/Set

Style for Label widgets.

Skin:SCROLLVIEW
Type:Style
Access:Get/Set

Style for ScrollBox widgets.

Skin:TEXTFIELD
Type:Style
Access:Get/Set

Style for TextField widgets.

Skin:TOGGLE
Type:Style
Access:Get/Set

Style for Button widgets in toggle mode (GUI:ADDCHECKBOX and GUI:ADDRADIOBUTTON).

Skin:FLATLAYOUT
Type:Style
Access:Get/Set

Style for Box transparent widgets (GUI:ADDHLAYOUT and GUI:ADDVLAYOUT).

Skin:POPUPMENU
Type:Style
Access:Get/Set

Style for PopupMenu widgets.

Skin:POPUPWINDOW
Type:Style
Access:Get/Set

Style for the popup window of PopupMenu widgets.

Skin:POPUPMENUITEM
Type:Style
Access:Get/Set

Style for the menu items of PopupMenu widgets.

Skin:LABELTIPOVERLAY
Type:Style
Access:Get/Set

Style for tooltips overlayed on Label widgets.

Skin:WINDOW
Type:Style
Access:Get/Set

Style for GUI windows.

Skin:FONT
Type:string
Access:Get/Set

The name of the font used (if STYLE:FONT does not change it for an element).

Skin:SELECTIONCOLOR
Type:Color
Access:Get/Set

The background color of selected text (eg. TEXTFIELD).

Skin:ADD(name, style)
Parameters:
  • name – String
  • style – Style - a style to clone here.
Returns:

Style - the copy of the style that was made.

Adds a new style to the skin and names it. The skin holds a list of styles by name which you can retrieve later. Note, this makes a copy of the style you pass in, so changes you make to this new style afterward shouldn’t affect the one you passed in, and visa versa.

Skin:HAS(name)
Parameters:
Returns:

Style

Does the skin have the named style?

Skin:GET(name)
Parameters:
Returns:

Style

Gets a style by name (including ADDed styles).