18.2. Widget Display Methods

The methods:

  widget.show()
  
  widget.show_all()
  
  widget.hide()
  
  widget.hide_all()
  
  widget.realize()
  
  widget.unrealize()
  
  widget.map()
  
  widget.unmap()

manage the display of the widget.

The show() method arranges to display the widget by using the realize() and map() methods.

The hide() method arranges to remove the widget from the display and also unmaps it using the unmap() method if necessary.

The show_all() and hide_all() methods arrange to show or hide the widget and all its children.

The realize() method arranges to allocate resources to the widget including its window.

The unrealize() method releases the widget window and other resources. Unrealizing a widget will also hide and unmap it.

The map() method arranges to allocate space on the display for the widget; this only applies to widgets that need to be handled by the window manager. Mapping a widget will also cause it to be realized if necessary.

The unmap() method removes a widget from the display and will also hide it if necessary.