Package: pango

Function pango-layout-serial

Lambda List

pango-layout-serial (layout)

Arguments

layout -- a pango-layout object

Return Value

The current serial number of layout.

Details

Returns the current serial number of layout. The serial number is initialized to an small number larger than zero when a new layout is created and is increased whenever the layout is changed using any of the setter functions, or the pango-context object it uses has changed. The serial may wrap, but will never have the value 0. Since it can wrap, never compare it with "less than", always use "not equals".

This can be used to automatically detect changes to a Pango layout, and is useful for example to decide whether a layout needs redrawing. To force the serial to be increased, use the function pango-layout-context-changed.
 

See also

2021-1-14