gimp/devel-docs/libgimp/tmpl/gimpsizeentry.sgml

<!-- ##### SECTION Title ##### -->
GimpSizeEntry

<!-- ##### SECTION Short_Description ##### -->
Widget for entering pixel values and resolutions.

<!-- ##### SECTION Long_Description ##### -->
<para>
This widget is used to enter pixel distances/sizes and resolutions.
</para>
<para>
You can specify the number of fields the widget should provide. For
each field automatic mappings are performed between the field's
"reference value" and it's "value".
</para>
<para>
There is a #GimpUnitMenu right of the entry fields which lets you
specify the #GimpUnit of the displayed values.
</para>
<para>
For each field, there can be one or two #GtkSpinButton's to enter
"value" and "reference value". If you specify @show_refval as #FALSE
in gimp_size_entry_new() there will be only one #GtkSpinButton and the
#GimpUnitMenu will contain an item for selecting GIMP_UNIT_PIXEL.
</para>
<para>
The "reference value" is either of GIMP_UNIT_PIXEL or dpi, depending
on which #GimpSizeEntryUpdatePolicy you specify in gimp_size_entry_new().
The "value" is either the size in pixels mapped to the size in a
real-world-unit (see #GimpUnit) or the dpi value mapped to pixels per
real-world-unit.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>
#GimpUnit
</para>
<para>
#GimpUnitMenu
</para>

<!-- ##### STRUCT GimpSizeEntry ##### -->
<para>

</para>


<!-- ##### MACRO GIMP_SIZE_ENTRY ##### -->
<para>
Checks if the passed pointer is a pointer to a #GimpSizeEntry and
performs the cast if valid.
</para>

@obj: The pointer to cast.


<!-- ##### ENUM GimpSizeEntryUpdatePolicy ##### -->
<para>

</para>

@GIMP_SIZE_ENTRY_UPDATE_NONE: 
@GIMP_SIZE_ENTRY_UPDATE_SIZE: 
@GIMP_SIZE_ENTRY_UPDATE_RESOLUTION: 

<!-- ##### STRUCT GimpSizeEntryField ##### -->
<para>

</para>


<!-- ##### FUNCTION gimp_size_entry_new ##### -->
<para>

</para>

@number_of_fields: 
@unit: 
@unit_format: 
@menu_show_pixels: 
@menu_show_percent: 
@show_refval: 
@spinbutton_usize: 
@update_policy: 
@Returns: 


<!-- ##### FUNCTION gimp_size_entry_add_field ##### -->
<para>

</para>

@gse: 
@value_spinbutton: 
@refval_spinbutton: 


<!-- ##### FUNCTION gimp_size_entry_attach_label ##### -->
<para>

</para>

@gse: 
@text: 
@row: 
@column: 
@alignment: 


<!-- ##### FUNCTION gimp_size_entry_set_resolution ##### -->
<para>

</para>

@gse: 
@field: 
@resolution: 
@keep_size: 


<!-- ##### FUNCTION gimp_size_entry_set_size ##### -->
<para>

</para>

@gse: 
@field: 
@lower: 
@upper: 


<!-- ##### FUNCTION gimp_size_entry_set_value_boundaries ##### -->
<para>

</para>

@gse: 
@field: 
@lower: 
@upper: 


<!-- ##### FUNCTION gimp_size_entry_get_value ##### -->
<para>

</para>

@gse: 
@field: 
@Returns: 


<!-- ##### FUNCTION gimp_size_entry_set_value ##### -->
<para>

</para>

@gse: 
@field: 
@value: 


<!-- ##### FUNCTION gimp_size_entry_set_refval_boundaries ##### -->
<para>

</para>

@gse: 
@field: 
@lower: 
@upper: 


<!-- ##### FUNCTION gimp_size_entry_set_refval_digits ##### -->
<para>

</para>

@gse: 
@field: 
@digits: 


<!-- ##### FUNCTION gimp_size_entry_get_refval ##### -->
<para>

</para>

@gse: 
@field: 
@Returns: 


<!-- ##### FUNCTION gimp_size_entry_set_refval ##### -->
<para>

</para>

@gse: 
@field: 
@refval: 


<!-- ##### FUNCTION gimp_size_entry_get_unit ##### -->
<para>

</para>

@gse: 
@Returns: 


<!-- ##### FUNCTION gimp_size_entry_set_unit ##### -->
<para>

</para>

@gse: 
@unit: 


<!-- ##### FUNCTION gimp_size_entry_grab_focus ##### -->
<para>

</para>

@gse: 


<!-- ##### SIGNAL GimpSizeEntry::value-changed ##### -->
<para>

</para>

@gimpsizeentry: the object which received the signal.

<!-- ##### SIGNAL GimpSizeEntry::refval-changed ##### -->
<para>

</para>

@gimpsizeentry: the object which received the signal.

<!-- ##### SIGNAL GimpSizeEntry::unit-changed ##### -->
<para>

</para>

@gimpsizeentry: the object which received the signal.