<!-- ##### SECTION Title ##### -->
GimpUnitMenu

<!-- ##### SECTION Short_Description ##### -->
Widget for selecting a #GimpUnit.

<!-- ##### SECTION Long_Description ##### -->
<para>
This widget provides a #GtkOptionMenu which contains a list of #GimpUnit's.
</para>
<para>
You can specify the string that will be displayed for each unit by
passing a printf-like @format string to gimp_unit_menu_new().
</para>
<para>
The constructor also lets you choose if the menu should contain items
for GIMP_UNIT_PIXEL, GIMP_UNIT_PERCENT and a "More..." item which will
pop up a dialog for selecting user-defined units.
</para>
<para>
Whenever the user selects a unit from the menu or the dialog, the
"unit_changed" signal will be emitted.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>
#GimpUnit
</para>
<para>
#GimpSizeEntry
</para>
<para>
gimp_coordinates_new()
</para>

<!-- ##### STRUCT GimpUnitMenu ##### -->
<para>

</para>


<!-- ##### FUNCTION gimp_unit_menu_new ##### -->
<para>

<informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2"><colspec colwidth="1*"/><colspec colwidth="8*"/>
<tbody>

<row>
<entry>% f</entry>
<entry>Factor (how many units make up an inch)</entry>
</row>

<row>
<entry>% y</entry>
<entry>Symbol (e.g. "''" for GIMP_UNIT_INCH)</entry>
</row>

<row>
<entry>% a</entry>
<entry>Abbreviation</entry>
</row>

<row>
<entry>% s</entry>
<entry>Singular</entry>
</row>

<row>
<entry>% p</entry>
<entry>Plural</entry>
</row>

<row>
<entry>%%</entry>
<entry>Literal percent</entry>
</row>

</tbody></tgroup></informaltable>

</para>

@format: 
@unit: 
@show_pixels: 
@show_percent: 
@show_custom: 
@Returns: 


<!-- ##### FUNCTION gimp_unit_menu_set_unit ##### -->
<para>

</para>

@menu: 
@unit: 
<!-- # Unused Parameters # -->
@gum: 


<!-- ##### FUNCTION gimp_unit_menu_get_unit ##### -->
<para>

</para>

@menu: 
@Returns: 
<!-- # Unused Parameters # -->
@gum: 


<!-- ##### SIGNAL GimpUnitMenu::unit-changed ##### -->
<para>
This signal is emitted whenever the user selects a #GimpUnit from the
#GimpUnitMenu.
</para>

@gimpunitmenu: the object which received the signal.

