1be6408590
2002-05-13 Sven Neumann <sven@gimp.org> * libgimpwidgets/libgimpwidgets-docs.sgml: added GimpStock section, removed GimpWidgetTypes. * libgimpwidgets/libgimpwidgets-sections.txt: updated. * libgimpwidgets/tmpl/gimpstock.sgml: added GimpStock templates. * libgimpwidgets/tmpl/gimpwidgetstypes.sgml: removed. * libgimpwidgets/tmpl/gimpbutton.sgml * libgimpwidgets/tmpl/gimpchainbutton.sgml * libgimpwidgets/tmpl/gimpcolorarea.sgml * libgimpwidgets/tmpl/gimpcolorbutton.sgml * libgimpwidgets/tmpl/gimpdialog.sgml * libgimpwidgets/tmpl/gimpfileselection.sgml * libgimpwidgets/tmpl/gimphelpui.sgml * libgimpwidgets/tmpl/gimpoffsetarea.sgml * libgimpwidgets/tmpl/gimppatheditor.sgml * libgimpwidgets/tmpl/gimppixmap.sgml * libgimpwidgets/tmpl/gimpquerybox.sgml * libgimpwidgets/tmpl/gimpsizeentry.sgml * libgimpwidgets/tmpl/gimpunitmenu.sgml * libgimpwidgets/tmpl/gimpwidgets.sgml: updated.
117 lines
2.0 KiB
Plaintext
117 lines
2.0 KiB
Plaintext
<!-- ##### 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>
|
|
|
|
@gum:
|
|
@unit:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_unit_menu_get_unit ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@gum:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### 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.
|
|
|