Package: gtk

Function gtk:widget-child-visible

Lambda List

gtk:widget-child-visible (widget)

Syntax

(gtk:widget-child-visible widget) => visible
(setf (gtk:widget-child-visible widget) visible)

Arguments

widget -- a gtk:widget object
visible -- if true, widget should be mapped along with its parent

Details

The gtk:widget-child-visible function returns true if the widget is mapped with the parent. The (setf gtk:widget-child-visible) function sets whether the widget should be mapped along with its parent when its parent is mapped and the widget has been shown with the gtk:widget-show function.

The child visibility can be set for the widget before it is added to a container with the gtk:widget-parent function, to avoid mapping children unnecessary before immediately unmapping them. However it will be reset to its default state of true when the widget is removed from a container.

Note that changing the child visibility of a widget does not queue a resize on the widget. Most of the time, the size of a widget is computed from all visible children, whether or not they are mapped. If this is not the case, the container can queue a resize itself.

This function is only useful for container implementations and never should be called by an application.
 

See also

#2025-2-13