<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="fllabel">
  <refmeta>
    <refentrytitle>FLlabel</refentrytitle>
  </refmeta>

  <refnamediv>
    <refname>FLlabel</refname>
    <refpurpose>
      A FLTK opcode that modifies the appearance of a text label.
      <indexterm id="IndexFllabel"><primary>FLlabel</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      Modifies a set of parameters related to the text label appearence of a widget (i.e. size, font, alignment and color of corresponding text).
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>FLlabel</command> isize, ifont, ialign, ired, igreen, iblue</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>isize</emphasis> -- size of the font of the target widget. Normal values are in the order of 15. Greater numbers enlarge font size, while smaller numbers reduce it.
    </para>

    <para>
      <emphasis>ifont</emphasis> -- sets the the font type of the label of a widget.
    </para>

    <para>
      Legal values for ifont argument are:

      <itemizedlist>
        <listitem><para>1 - Helvetica (same as Arial under Windows)</para></listitem>
        <listitem><para>2 - Helvetica Bold</para></listitem>
        <listitem><para>3 - Helvetica Italic</para></listitem>
        <listitem><para>4 - Helvetica Bold Italic</para></listitem>
        <listitem><para>5 - Courier</para></listitem>
        <listitem><para>6 - Courier Bold</para></listitem>
        <listitem><para>7 - Courier Italic</para></listitem>
        <listitem><para>8 - Courier Bold Italic</para></listitem>
        <listitem><para>9 - Times</para></listitem>
        <listitem><para>10 - Times Bold</para></listitem>
        <listitem><para>11 - Times Italic</para></listitem>
        <listitem><para>12 - Times Bold Italic</para></listitem>
        <listitem><para>13 - Symbol</para></listitem>
        <listitem><para>14 - Screen</para></listitem>
        <listitem><para>15 - Screen Bold</para></listitem>
        <listitem><para>16 - Dingbats</para></listitem>
      </itemizedlist>
    </para>

    <para>
      <emphasis>ialign</emphasis> -- sets the alignment of the label text of the widget.
    </para>

    <para>
      Legal values for ialign argument are:

      <itemizedlist>
        <listitem><para>1 - align center</para></listitem>
        <listitem><para>2 - align top</para></listitem>
        <listitem><para>3 - align bottom</para></listitem>
        <listitem><para>4 - align left</para></listitem>
        <listitem><para>5 - align right</para></listitem>
        <listitem><para>6 - align top-left</para></listitem>
        <listitem><para>7 - align top-right</para></listitem>
        <listitem><para>8 - align bottom-left</para></listitem>
        <listitem><para>9 - align bottom-right</para></listitem>
      </itemizedlist>
    </para>

    <para>
      <emphasis>ired</emphasis> -- The red color of the target widget. The range for each RGB component is 0-255
    </para>

    <para>
      <emphasis>igreen</emphasis> -- The green color of the target widget. The range for each RGB component is 0-255
    </para>

    <para>
      <emphasis>iblue</emphasis> -- The blue color of the target widget. The range for each RGB component is 0-255
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>FLlabel</emphasis> modifies a set of parameters related to the text label appearance of a widget, i.e.  size, font, alignment and color of corresponding text. This opcode affects (almost) all widgets defined next its location. A user can put several instances of <emphasis>FLlabel</emphasis> in front of each widget he intends to modify. However, to modify a particular widget, it is better to use the opcode belonging to the second type (i.e. those containing the <emphasis>ihandle</emphasis> argument).
    </para>

    <para>
      The influence of <emphasis>FLlabel</emphasis> on the next widget can be turned off by using -1 as its only argument. <emphasis>FLlabel</emphasis> is designed to modify text attributes of a group of related widgets.
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="flcolor"><citetitle>FLcolor</citetitle></link>, 
      <link linkend="flcolor2"><citetitle>FLcolor2</citetitle></link>, 
      <link linkend="flhide"><citetitle>FLhide</citetitle></link>, 
      <link linkend="flsetalign"><citetitle>FLsetAlign</citetitle></link>, 
      <link linkend="flsetbox"><citetitle>FLsetBox</citetitle></link>, 
      <link linkend="flsetcolor"><citetitle>FLsetColor</citetitle></link>, 
      <link linkend="flsetcolor2"><citetitle>FLsetColor2</citetitle></link>, 
      <link linkend="flsetfont"><citetitle>FLsetFont</citetitle></link>, 
      <link linkend="flsetposition"><citetitle>FLsetPosition</citetitle></link>, 
      <link linkend="flsetsize"><citetitle>FLsetSize</citetitle></link>, 
      <link linkend="flsettext"><citetitle>FLsetText</citetitle></link>, 
      <link linkend="flsettextcolor"><citetitle>FLsetTextColor</citetitle></link>, 
      <link linkend="flsettextsize"><citetitle>FLsetTextSize</citetitle></link>, 
      <link linkend="flsettexttype"><citetitle>FLsetTextType</citetitle></link>, 
      <link linkend="flsetvali"><citetitle>FLsetVal_i</citetitle></link>, 
      <link linkend="flsetval"><citetitle>FLsetVal</citetitle></link>, 
      <link linkend="flshow"><citetitle>FLshow</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>Author: &namegabriel;</para>
    <para>New in version 4.22</para>
  </refsect1>
</refentry>
