By setting the type hint for the window, you allow the window manager to decorate and handle the window in a way which is suitable to the function of the window in your application.
This function should be called before the window becomes visible.
Dialog.with_buttons and other convenience functions in GTK+ will sometimes call set_type_hint on your behalf.
this |
a Window |
hint |
the window type |