skin.ini_description_en.txt

skin components for design of your applicastions

  ===========================================

     8.1. Label
     ==========

   Names of all skin styles for TSXSkinLabel component have "_Label"
at the beginning. I will name them label-styles.
   Label-style has 3 states: normal, highlighted and read-only
(disabled). Properties for these states are set using this notation:
      N_PropertyName=PropertyValue  (for normal state)
      H_PropertyName=PropertyValue  (for highlighted state)
      R_PropertyName=PropertyValue  (for read-only state)
   PropertyName can be:
    - font properties with only state prefix (see section 3.1).
   Example:

      [_Label_Hyperlink]
      N_FontColor=#0000FF
      H_FontStyle=u
      D_FontColor=#A0A0A0

   TSXSkinLabel with SkinStyle='_Label_Hyperlink' is blue, is underlined
when mouse is over and is gray when disabled.

     8.2. Button
     ===========

   Names of all skin styles for TSXSkinButton component have "_Button"
at the beginning. I will name them button-styles.
   According to SXSkinComponents ideology a button can be:
    * normal / highlighted (mouse is over);
    * enabled / disabled;
    * focused / unfocused;
    * normal / down (pressed);
    * checked / unchecked (the same as Down property in VCL).
   Depending on whether a button can be checked (Down in VCL), there
are two ways of button-style states naming:
    - NU, NF, HU, HF, DF and RU,
      the first letter means: N - normal, H - highlighted,
                              D - down (pressed), R - read-only (disabled),
      the second button means: U - unfocused, F - focused;
    - NUU, NFU, HUU, HFU, DFU, RUU, NUC, NFC, HUC, HFC, DFC and RUC,
      the first two letters - the same meaning,
      the third letter means: U - unchecked, C - checked (Down in VCL).
   However, all two-letter states XX are equal to XXU.
   I will call these two and three-letter abbreviations StatePrefixes.
   Properties for these states are set using this notation:
      StatePrefix_PropertyName=PropertyValue
   PropertyName can be one of these:
    - Style - name of general skin style for button background;
    - OverStyle - name of another general skin style, unlike Style, it is
      not used in Transform Effects (usually contains FOCUS_RECT element
      for all focused states);
    - CaptionLeftOffset - positive integer value (caption is glyph, text
      and drop-down glyph with offsets between them);
    - CaptionTopOffset;
    - CaptionRightOffset;
    - CaptionBottomOffset;
    - DefGlyph* - default glyph filter for current state (see section 3.2);
    - font properties without additional prefixes (see section 3.1).
   The heredity principle is used when setting state properties. The
"lowest" state is NUU (NU), it means that properties for all other states
depend on properties of NUU state. E.g. if you set NU_FontName=Arial and
don't set property HU_FontName, then HU_FontName=Arial too. This table
describes, which states are taken into account to set properties for each
state (if some properties are missing):

      ----------------------------------------------------------
      NUU  NFU  HUU  HFU  DFU  RUU  NUC  NFC  HUC  HFC  DFC  RUC
      ----------------------------------------------------------
           NUU  NUU  HUU  NFU  NUU  NUU  NUC  NUC  HUC  DFU  NUC
                     NFU  NUU            NFU  HUU  HFU  NFC  RUU
                     NUU                 NUU  NUU  HUU  NFU  NUU
                                                   NFC  NUC
                                                   NUC  NUU
                                                   NFU
                                                   NUU

      Example: if NFU_FontColor=#FF0000,
                  HUU_FontColor=#808080,
                  HFU_FontColor=#00FFFF,
                  NUU_FontColor=#FFFFFF,

             then NUU_FontColor=#FFFFFF,    NFU_FontColor=#FF0000,
                  HUU_FontColor=#808080,    HFU_FontColor=#00FFFF,
                  DFU_FontColor=#FF0000,    RUU_FontColor=#FFFFFF,
                  NUC_FontColor=#FFFFFF,    NFC_FontColor=#FF0000,
                  HUC_FontColor=#808080,    HFC_FontColor=#00FFFF,
                  DFC_FontColor=#FF0000,    RUC_FontColor=#FFFFFF.

      Note: If NUU font parameters are not set, then TSXSkinButton.Font
            is used instead (with no shadow and no smoothing).

   Common properties for all states (use without state prefixes):
    - HighlightInButton* - parameters of the transform effect, which is
      used when button state changes from normal to highlighted
      (see section 3.3);
    - HighlightOutButton* - state changes from highlighted to normal;
    - CheckButton* - state changes from unchecked to checked;
    - UncheckButton* - state changes from checked to unchecked;
    - DownButton* - state changes from normal (highlighted) to down;
    - UpButton* - state changes from down to normal;
    - EnableButton* - state changes from read-only (disabled) to enabled;
    - DisableButton* - state changes from enabled to read-only (disabled);
    - FocusButton* - state changes from unfocused to focused;
    - UnfocusButton* - state changes from focused to unfocused;
    - HighlightInGlyph* - the same as HighlightOutButton*, but for glyph;
    - HighlightOutGlyph*;
    - CheckGlyph*;
    - UncheckGlyph*;
    - DownGlyph*;
    - UpGlyph*;
    - EnableGlyph*;
    - DisableGlyph*;
    - FocusGlyph*;
    - UnfocusGlyph*;
    - HighlightInDDGlyph* - effect for highlighting of drop-down glyph;
    - HighlightOutDDGlyph*;
    - CheckDDGlyph*;
    - UncheckDDGlyph*;
    - DownDDGlyph*;
    - UpDDGlyph*;
    - EnableDDGlyph*;
    - DisableDDGlyph*;
    - FocusDDGlyph*;
    - UnfocusDDGlyph*;
    - DropDownGlyphWidth - integer pixels number;
    - DropDownGlyphHeight - integer pixels number;
    - DropDownGlyphOffset - pixels number between text and drop-down glyph.

   Variables, those can be used when defining general skin styles
elements parameters:
    * W - TSXSkinButton.Width;
    * H - TSXSkinButton.Height;
    * GlX - X-coordinate of glyph position;
    * GlY - Y-coordinate of glyph position;
    * GlW - glyph width;
    * GlH - glyph height.

     8.3. CheckBox
     =============

   Names of all skin styles for TSXSkinCheckBox component have "_CheckBox"
at the beginning. I will name them checkbox-styles.
   According to SXSkinComponents ideology a checkbox can be:
    * normal / highlighted (mouse is over);
    * enabled / disabled;
    * focused / unfocused;
    * normal / down (pressed);
    * checked / unchecked / grayed (for tristate checkboxes).
   There is an exhaustive list of checkbox states:
      NUU, NFU, HUU, HFU, DFU, RUU, NUC, NFC, HUC,
      HFC, DFC, RUC, NUG, NFG, HUG, HFG, DFG, RUG
   The first button means: N - normal, H - highlighted,
                           D - down (pressed), R - read-only (disabled).
   The second button: U - unfocused, F - focused.
   The third button: U - unchecked, C - checked, G - grayed.
   I will call these three-letter abbreviations StatePrefixes.
   Properties for these states are set using this notation:
      StatePrefix_PropertyName=PropertyValue
   PropertyName can be one of these:
    - Style - name of general skin style for checkbox background;
    - OverStyle - name of another general skin style, unlike Style, it is
      not used in Transform Effects (usually contains FOCUS_RECT element
      for all focused states);
    - Glyph - name of general skin style, which is uses as glyph;
    - GlyphWidth - integer number;
    - GlyphHeight - integer number;
    - CaptionLeftOffset - positive integer value (caption is glyph and
      text with offset between them);
    - CaptionTopOffset;
    - CaptionRightOffset;
    - CaptionBottomOffset;
    - TextLeftOffset - integer value (offset inside a caption);
    - TextTopOffset;
    - TextRightOffset;
    - TextBottomOffset;
    - font properties without additional prefixes (see section 3.1).
   The heredity principle is used when setting state properties. The
"lowest" state is NUU, it means that properties for all other states
depend on properties of NUU state. E.g. if you set NUU_FontName=Arial and
don't set property HUU_FontName, then HUU_FontName=Arial too. This table
describes, which states are taken into account to set properties for each
state (if some properties are missing):

  -----------------------------------------------------------------------
  NUU NFU HUU HFU DFU RUU NUC NFC HUC HFC DFC RUC NUG NFG HUG HFG DFG RUG
  -----------------------------------------------------------------------
      NUU NUU HUU NFU NUU NUU NUC NUC HUC DFU NUC NUC NUG NUG HUG DFC NUG
              NFU NUU         NFU HUU HFU NFC RUU NUU NFC HUC HFC DFU RUC
              NUU             NUU NUU HUU NFU NUU     NUC NUC HUC NFG NUC
                                      NFC NUC         NFU HUU HFU NFC RUU
                                      NUC NUU         NUU NUU HUU NFU NUU
                                      NFU                     NFG NUG
                                      NUU                     NUG NUC
                                                              NFC NUU
                                                              NUC
                                                              NFU
                                                              NUU

   See inherited properties example in section 8.2.

   Common properties for all states (use without state prefixes):
    - HighlightInCheckBox* - parameters of the transform effect, which is
      used when checkbox state changes from normal to highlighted
      (see section 3.3);
    - HighlightOutCheckBox* - state changes from highlighted to normal;
    - CheckCheckBox* - state changes from unchecked to checked;
    - UncheckCheckBox* - state changes from checked to unchecked;
    - DownCheckBox* - state changes from normal (highlighted) to pressed;
    - UpCheckBox* - state changes from pressed to normal (highlighted);
    - EnableCheckBox* -state changes from disabled to enabled;
    - DisableCheckBox* - state changes from enabled to disabled;
    - FocusCheckBox* - state changes from unfocused to focused;
    - UnfocusCheckBox* -state changes from focused to unfocused;
    - HighlightInGlyph* - the same as HighlightOutCheckBox*, but for glyph;
    - HighlightOutGlyph*;
    - CheckGlyph*;
    - UncheckGlyph*;
    - DownGlyph*;
    - UpGlyph*;
    - EnableGlyph*;
    - DisableGlyph*;
    - FocusGlyph*;
    - UnfocusGlyph*.

   Variables, those can be used when defining general skin styles
elements parameters:
    * W - TSXSkinCheckBox.Width;
    * H - TSXSkinCheckBox.Height;
    * GlX - X-coordinate of glyph position;
    * GlY - Y-coordinate of glyph position;
    * GlW - glyph width;
    * GlH - glyph height;
    * TL - TextRect.Left;
    * TT - TextRect.Top;
    * TR - TextRect.Right;
    * TB - TextRect.Bottom.

     8.4. RadioButton
     ================

   Names of all skin styles for TSXSkinRadioButton component have
"_CheckBox" at the beginning. I will name them radiobutton-styles.
   According to SXSkinComponents ideology a radio button can be:
    * normal / highlighted (mouse is over);
    * enabled / disabled;
    * focused / unfocused;
    * normal / down (pressed);
    * checked / unchecked.
   There is an exhaustive list of radio button states:
      NUU, NFU, HUU, HFU, DFU, RUU, NUC, NFC, HUC, HFC, DFC, RUC
   The first button means: N - normal, H - highlighted,
                           D - down (pressed), R - read-only (disabled).
   The second button: U - unfocused, F - focused.
   The third button: U - unchecked, C - checked.
   I will call these three-letter abbreviations StatePrefixes.
   Properties for these states are set using this notation:
      StatePrefix_PropertyName=PropertyValue
   PropertyName can be one of these:
    - Style - name of general skin style for radio button background;
    - OverStyle - name of another general skin style, unlike Style, it is
      not used in Transform Effects (usually contains FOCUS_RECT element
      for all focused states);
    - Glyph - name of general skin style, which is uses as glyph;
    - GlyphWidth - integer number;
    - GlyphHeight - integer number;
    - CaptionLeftOffset - positive integer value (caption is glyph and
      text with offset between them);
    - CaptionTopOffset;
    - CaptionRightOffset;
    - CaptionBottomOffset;
    - TextLeftOffset - integer value (offset inside a caption);
    - TextTopOffset;
    - TextRightOffset;
    - TextBottomOffset;
    - font properties without additional prefixes (see section 3.1).
   The heredity principle is used when setting state properties. The
"lowest" state is NUU, it means that properties for all other states
depend on properties of NUU state. E.g. if you set NUU_FontName=Arial and
don't set property HUU_FontName, then HUU_FontName=Arial too. This table
describes, which states are taken into account to set properties for each
state (if some properties are missing):

      ----------------------------------------------------------
      NUU  NFU  HUU  HFU  DFU  RUU  NUC  NFC  HUC  HFC  DFC  RUC 
      ----------------------------------------------------------
           NUU  NUU  HUU  NFU  NUU  NUU  NUC  NUC  HUC  DFU  NUC
                     NFU  NUU            NFU  HUU  HFU  NFC  RUU
                     NUU                 NUU  NUU  HUU  NFU  NUU
                                                   NFC  NUC
                                                   NUC  NUU
                                                   NFU
                                                   NUU

   See inherited properties example in section 8.2.

   Common properties for all states (use without state prefixes):
    - HighlightInRadioButton* - parameters of the transform effect,
      which is used when checkbox state changes from normal to highlighted
      (see section 3.3);
    - HighlightOutRadioButton* - state changes from highlighted to normal;
    - CheckRadioButton* - state changes from unchecked to checked;
    - UncheckRadioButton* - state changes from checked to unchecked;
    - DownRadioButton* - state changes from normal (highlighted) to
      pressed;
    - UpRadioButton* - state changes from pressed to normal (highlighted);
    - EnableRadioButton* -state changes from disabled to enabled;
    - DisableRadioButton* - state changes from enabled to disabled;
    - FocusRadioButton* - state changes from unfocused to focused;
    - UnfocusRadioButton* -state changes from focused to unfocused;
    - HighlightInGlyph* - the same as HighlightOutCheckBox*, but for glyph;
    - HighlightOutGlyph*;
    - CheckGlyph*;
    - UncheckGlyph*;
    - DownGlyph*;
    - UpGlyph*;
    - EnableGlyph*;
    - DisableGlyph*;
    - FocusGlyph*;
    - UnfocusGlyph*.

   Variables, those can be used when defining general skin styles
elements parameters:
    * W - TSXSkinRadioButton.Width;
    * H - TSXSkinRadioButton.Height;
    * GlX - X-coordinate of glyph position;
    * GlY - Y-coordinate of glyph position;
    * GlW - glyph width;
    * GlH - glyph height;
    * TL - TextRect.Left;
    * TT - TextRect.Top;