gtk.Activatable — An interface for activatable widgets.
| class gtk.Activatable( | 
| 
 | 
            gtk.Activatable
            is implementated by
            gtk.TearoffMenuItem,
            gtk.OptionMenu,
            gtk.LinkButton,
            gtk.RadioButton,
            gtk.RadioToolButton,
            gtk.ToggleButton,
            gtk.SeparatorMenuItem,
            gtk.ImageMenuItem,
            gtk.CheckButton,
            gtk.RadioMenuItem,
            gtk.Button,
            gtk.MenuToolButton,
            gtk.MenuItem,
            gtk.RecentChooserMenu,
            gtk.ToolItem,
            gtk.SeparatorToolItem,
            gtk.CheckMenuItem,
            gtk.ToolButton,
            gtkFontButton.,
            gtk.ScaleButton,
            gtk.ToggleToolButton,
            gtk.VolumeButton,
            gtk.ColorButton.
        
            Activatable widgets can be connected to a
            gtk.Action
            and reflects the state of its action. A GtkActivatable can also provide
            feedback through its action, as they are responsible for activating their related actions. 
        
            When extending a class that is already gtk.Activatable
            it is only necessary to implement the
            gtk.Activatable
            class the "related-action" and "use-action-appearance" properties need to be handled by the implementor.
            Handling these properties is mostly a matter of installing the action pointer and boolean flag on your instance,
            and calling
            gtk.Activatable.do_set_related_action() and
            gtk.Activatable.sync_action_properties()
            at the appropriate times. 
        
    def do_set_related_action(action)| 
 | the gtk.Actionto set. | 
This method is available in PyGTK 2.16 and above.
                The do_set_related_action() method is an
                utility function for
                gtk.Activatable
                implementors. 
            
                When implementing gtk.Activatable
                you must call this when handling changes of the "related-action", and you must also
                use this to break references in GObject->dispose(). 
            
                This function adds a reference to the currently set related action for you,
                it also makes sure the GtkActivatable->update() method is called when the related
                gtk.Action
                properties change and registers to the action's proxy list. 
            
gtk.Action
                property, since this function uses
                gtk.Activatable.get_related_action()
                to retrieve the previous action
                def get_related_action()| Returns : | the related gtk.Actionif one is set. | 
This method is available in PyGTK 2.16 and above.
                The get_related_action() method gets the related
                gtk.Action for activatable.
            
    def get_use_action_appearence()| Returns : | whether activatable uses its actions appearance. | 
This method is available in PyGTK 2.16 and above.
                The get_use_action_appearence() method gets whether
                this activatable should reset its layout and appearance when setting the
                related action or when the action changes appearance.
            
    def set_related_action(action)| 
 | the gtk.Actionto set. | 
This method is available in PyGTK 2.16 and above.
gtk.Activatable
                implementors need to handle the "related-action" property and call
                gtk.Activatable.do_set_related_action()
                when it changes.
            
                The set_related_action() method sets the related action on the activatable object. 
            
    def set_use_action_appearence(use_appearence)| 
 | whether to use the actions appearance. | 
This method is available in PyGTK 2.16 and above.
gtk.Activatable
                implementors need to handle the "related-action" property and call
                gtk.Activatable.do_set_related_action()
                when it changes.
            
                The set_use_action_appearence() method sets whether
                this activatable should reset its layout and appearance when setting the
                related action or when the action changes appearance 
            
    def sync_action_properties(action)| 
 | the related gtk.ActionorNone | 
This method is available in PyGTK 2.16 and above.
                The set_use_action_appearence() method is called to
                update the activatable completely, this is called internally when the "related-action"
                property is set or unset and by the implementing class when "use-action-appearance" changes.