index :: ui

ui.label

simple label widget

available since version: 0.5

---

information

With spaces, text-align, font customization and word wrap

methods:

• any set label text to given message separated by spaces, but do not change @text property
  

• append appends to @text end
  

• clear clear label text and clear @text property
  

• float set label text to given float, but do not change @text property
  

• list set label text to given list separated by spaces, but do not change @text property
  

• pos set UI element position
  parameters:

  • X top left x-coord
    type: float
    required: True
    

  • Y top right y-coord
    type: float
    required: True
    

• prepend insert into beginning of @text
  

• set set label text and update @text property, so it would be saved in patch
  

• symbol set label text to given symbol, but do not change @text property
  

properties:

• @text Get/set label text
  type: symbol
  default: Label
  

• @align Get/set text align
  type: symbol
  enum: left, center, right
  default: left
  

• @margin_top Get/set text top margin
  type: int
  default: 5
  

• @margin_left Get/set text left margin
  type: int
  default: 5
  

• @margin_right Get/set text right margin
  type: int
  default: 5
  

• @margin_bottom Get/set text bottom margin
  type: int
  default: 5
  

• @receive Get/set receive source
  type: symbol
  default: (null)
  

• @size Get/set element size (width, height pair)
  type: list
  default: 300 47
  

• @pinned Get/set pin mode. if 1 - put element to the lowest level
  type: bool
  default: 1
  

• @text_color Get/set text color (list of red, green, blue values in 0-1 range)
  type: list
  default: 0 0 0 1
  

• @background_color Get/set element background color (list of red, green, blue values in 0-1 range)
  type: list
  default: 1 1 1 1
  

• @fontsize Get/set fontsize
  type: int
  range: 4..100
  default: 32
  

• @fontname Get/set fontname
  type: symbol
  enum: Courier, DejaVu, Helvetica, Monaco, Times
  default: Helvetica
  

• @fontweight Get/set font weight
  type: symbol
  enum: normal, bold
  default: normal
  

• @fontslant Get/set font slant
  type: symbol
  enum: roman, italic
  default: roman
  

keywords:

ui label

Authors: Serge Poltavsky

License: GPL3 or later