<?xml version="1.0"?>
<page id="GimpUi.SizeEntry.new"
      type="topic"
      style="constructor"
      xmlns="http://projectmallard.org/1.0/"
      xmlns:api="http://projectmallard.org/experimental/api/"
      xmlns:ui="http://projectmallard.org/1.0/ui/">
  <info>
    <link xref="GimpUi.SizeEntry" group="constructor" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>Gtk.Widget</api:type>
      </api:returns>
      <api:name>gimp_size_entry_new</api:name>
      <api:arg>
        <api:type>Number(gint)</api:type>
        <api:name>number_of_fields</api:name>
      </api:arg>
      <api:arg>
        <api:type>Gimp.Unit</api:type>
        <api:name>unit</api:name>
      </api:arg>
      <api:arg>
        <api:type>String</api:type>
        <api:name>unit_format</api:name>
      </api:arg>
      <api:arg>
        <api:type>Boolean</api:type>
        <api:name>menu_show_pixels</api:name>
      </api:arg>
      <api:arg>
        <api:type>Boolean</api:type>
        <api:name>menu_show_percent</api:name>
      </api:arg>
      <api:arg>
        <api:type>Boolean</api:type>
        <api:name>show_refval</api:name>
      </api:arg>
      <api:arg>
        <api:type>Number(gint)</api:type>
        <api:name>spinbutton_width</api:name>
      </api:arg>
      <api:arg>
        <api:type>GimpUi.SizeEntryUpdatePolicy</api:type>
        <api:name>update_policy</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>GimpUi.SizeEntry.new</title>
  <synopsis><code mime="text/x-gjs">
function new(number_of_fields: Number(gint), unit: <link href="../Gimp-3.0/Gimp.Unit.html">Gimp.Unit</link>, unit_format: String, menu_show_pixels: Boolean, menu_show_percent: Boolean, show_refval: Boolean, spinbutton_width: Number(gint), update_policy: <link xref="GimpUi.SizeEntryUpdatePolicy">GimpUi.SizeEntryUpdatePolicy</link>): <link href="../Gtk-3.0/Gtk.Widget.html">Gtk.Widget</link> {
    // Gjs wrapper for gimp_size_entry_new()
}
  </code></synopsis>
  <p>Creates a new <link xref="GimpUi.SizeEntry"/> widget.</p>  <p>To have all automatic calculations performed correctly, set up the
widget in the following order:</p>  <p>1. <link xref="GimpUi.SizeEntry.new"/></p>  <p>2. (for each additional input field) <link xref="GimpUi.SizeEntry.add_field"/></p>  <p>3. <link xref="GimpUi.SizeEntry.set_unit"/></p>  <p>For each input field:</p>  <p>4. <link xref="GimpUi.SizeEntry.set_resolution"/></p>  <p>5. <link xref="GimpUi.SizeEntry.set_refval_boundaries"/>
   (or <link xref="GimpUi.SizeEntry.set_value_boundaries"/>)</p>  <p>6. <link xref="GimpUi.SizeEntry.set_size"/></p>  <p>7. <link xref="GimpUi.SizeEntry.set_refval"/> (or <link xref="GimpUi.SizeEntry.set_value"/>)</p>  <p>The <link xref="GimpUi.SizeEntry"/> is derived from <link href="../Gtk-3.0/Gtk.Grid.html">Gtk.Grid</link> and will have
an empty border of one cell width on each side plus an empty column left
of the <link xref="GimpUi.UnitComboBox"/> to allow the caller to add labels or a
<link xref="GimpUi.ChainButton"/>.</p>

<terms>
<item>
<title><code>number_of_fields</code></title>
  <p>The number of input fields.</p>
</item>
<item>
<title><code>unit</code></title>
  <p>The initial unit.</p>
</item>
<item>
<title><code>unit_format</code></title>
  <p>A printf-like unit-format string as is used with
                    gimp_unit_menu_new().</p>
</item>
<item>
<title><code>menu_show_pixels</code></title>
  <p><code>true</code> if the unit menu should contain an item for
                    GIMP_UNIT_PIXEL (ignored if the <code>update_policy</code> is not
                    GIMP_SIZE_ENTRY_UPDATE_NONE).</p>
</item>
<item>
<title><code>menu_show_percent</code></title>
  <p><code>true</code> if the unit menu should contain an item for
                    GIMP_UNIT_PERCENT.</p>
</item>
<item>
<title><code>show_refval</code></title>
  <p><code>true</code> if you want an extra "reference value"
                    spinbutton per input field.</p>
</item>
<item>
<title><code>spinbutton_width</code></title>
  <p>The minimal horizontal size of the <link href="../Gtk-3.0/Gtk.SpinButton.html">Gtk.SpinButton</link>'s.</p>
</item>
<item>
<title><code>update_policy</code></title>
  <p>How the automatic pixel &lt;-&gt; real-world-unit
                    calculations should be done.</p>
</item>
<item>
<title><code>Returns</code></title>
  <p>A Pointer to the new <link xref="GimpUi.SizeEntry"/> widget.</p>
</item>
</terms>

</page>
