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

  <refnamediv>
    <refname>FLpanel</refname>
    <refpurpose>
      Creates a window that contains FLTK widgets.
      <indexterm id="IndexFlpanel"><primary>FLpanel</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      Creates a window that contains FLTK widgets.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>FLpanel</command> &quot;label&quot;, iwidth, iheight [, ix] [, iy] [, iborder]</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis><quote>label</quote></emphasis> -- a double-quoted string containing some user-provided text, placed near the corresponding widget.
    </para>

    <para>
      <emphasis>iwidth</emphasis> -- width of widget.
    </para>

    <para>
      <emphasis>iheight</emphasis> -- height of widget.
    </para>

    <para>
      <emphasis>ix</emphasis> (optional) -- horizontal position of upper left corner of the valuator, relative to the upper left corner of corresponding window (expressed in pixels).
    </para>

    <para>
      <emphasis>iy</emphasis> (optional) -- vertical position of upper left corner of the valuator, relative to the upper left corner of corresponding window (expressed in pixels).
    </para>

    <para>
      <emphasis>iborder</emphasis> (optional) -- border type of the container. It is expressed by means of an integer number chosen from the following:

      <itemizedlist>
        <listitem><para>0 - no border</para></listitem>
        <listitem><para>1 - down box border</para></listitem>
        <listitem><para>2 - up box border</para></listitem>
        <listitem><para>3 - engraved border</para></listitem>
        <listitem><para>4 - embossed border</para></listitem>
        <listitem><para>5 - black line border</para></listitem>
        <listitem><para>6 - thin down border</para></listitem>
        <listitem><para>7 - thin up border</para></listitem>
      </itemizedlist>
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      Containers are useful to format the graphic appearance of the widgets. The most important container is <link linkend="flpanel"><citetitle>FLpanel</citetitle></link>, that actually creates a window. It can be filled with other containers and/or valuators or other kinds of widgets.
    </para>

    <para>
      There are no k-rate arguments in containers.
    </para>

    <para>
      <emphasis>FLpanel</emphasis> creates a window. It must be followed by the opcode <link linkend="flpanelend"><citetitle>FLpanelEnd</citetitle></link> when all widgets internal to it are declared. For example:
      <informalexample>
        <programlisting>
        FLpanel   "PanelPluto",450,550,100,100 ;***** start of container
gk1,ih1 FLslider  "FLslider 1", 500, 1000, 2 ,1, -1, 300,15, 20,50
gk2,ih2 FLslider  "FLslider 2", 300, 5000, 2 ,3, -1, 300,15, 20,100
gk3,ih3 FLslider  "FLslider 3", 350, 1000, 2 ,5, -1, 300,15, 20,150
gk4,ih4 FLslider  "FLslider 4", 250, 5000, 1 ,11,-1, 300,30, 20,200
        FLpanelEnd ;***** end of container
        </programlisting>
      </informalexample>

      will output the following result:

      <mediaobject>
        <imageobject>
          <imagedata fileref="images/flpanel.png" format="PNG">
        </imageobject>

        <textobject>
          <phrase>FLpanel.</phrase>
        </textobject>

        <caption>
          <para>FLpanel.</para>
        </caption>
      </mediaobject>
    </para>
  </refsect1>

  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the flpanel opcode. It uses the files <ulink url="examples/flpanel.orc"><citetitle>flpanel.orc</citetitle></ulink> and <ulink url="examples/flpanel.sco"><citetitle>flpanel.sco</citetitle></ulink>.

      <example>
        <title>Example of the flpanel opcode.</title>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/flpanel.orc" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/flpanel.sco" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>
      </example>
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="flgroup"><citetitle>FLgroup</citetitle></link>, 
      <link linkend="flgroupend"><citetitle>FLgroupEnd</citetitle></link>, 
      <link linkend="flpack"><citetitle>FLpack</citetitle></link>, 
      <link linkend="flpackend"><citetitle>FLpackEnd</citetitle></link>, 
      <link linkend="flpanelend"><citetitle>FLpanelEnd</citetitle></link>, 
      <link linkend="flscroll"><citetitle>FLscroll</citetitle></link>, 
      <link linkend="flscrollend"><citetitle>FLscrollEnd</citetitle></link>, 
      <link linkend="fltabs"><citetitle>FLtabs</citetitle></link>, 
      <link linkend="fltabsend"><citetitle>FLtabsEnd</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>Author: &namegabriel;</para>
    <para>New in version 4.22</para>
    <para>Example written by Iain McCurdy, edited by &namekevin;.</para>
  </refsect1>
</refentry>
