| Bonobo API Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> |
void (*BonoboUISyncStateFn) ( |
The BonoboUISynchronizer is used internaly by the
void (*BonoboUISyncStateFn) ( |
| sync : | |
| node : | |
| cmd_node : | |
| widget : | |
| parent : |
|
| sync : | |
| node : | |
| cmd_node : | |
| pos : | |
| parent : | |
| Returns : |
|
Used to construct a new synchronizer object
| sync : | the synchronizer |
| engine : | the associated engine |
| is_recursive : | whether it deals with its children recursively |
| has_widgets : | whether it has associated widgets. |
| Returns : | the new object. |
|
| sync : | the synchronizer |
| Returns : | whether this deals with its children recursively |
|
| sync : | the synchronizer |
| Returns : | whether this deals with widgets |
void bonobo_ui_sync_remove_root ( |
This is called when a 'root' or toplevel node is removed that this synchronizer deals with. eg. in the toolbar case, this might trigger hiding an associated dock item.
| sync : | the synchronizer |
| root : | the toplevel node to be removed. |
void bonobo_ui_sync_update_root ( |
This flags the fact that a toplevel node has changed and is used primarily by non-recursive handlers, such as the keybinding sync method.
| sync : | the synchronizer |
| root : | the toplevel node |
void bonobo_ui_sync_state ( |
This method is used to synchronize the state of a node with that of a widget, by ensuring the pertainant attributes are reflected in the widget view.
| sync : | the synchronizer |
| node : | the node |
| cmd_node : | the associated command node |
| widget : | the widget |
| parent : | the parent of node |
void bonobo_ui_sync_state_placeholder
( |
This synchronizes the state of a placeholder, there is a default implementation for this method.
| sync : | the synchronizer |
| node : | the node |
| cmd_node : | the associated command node |
| widget : | the widget |
| parent : | the parent of node |
|
This function causes a child widget to be build that matches node's attributes. This should then be inserted by into parent's associated widget at position pos in the container.
| sync : | the synchronizer |
| node : | the node |
| cmd_node : | the associated command node |
| pos : | the position in the parent container to insert at |
| parent : | the parent of node |
| Returns : | the freshly built widget. |
|
As for bonobo_ui_sync_build but for placeholders
| sync : | the synchronizer |
| node : | the node |
| cmd_node : | the associated command node |
| pos : | position in the parent to insert the built widget |
| parent : | the parent of node |
| Returns : | the freshly built widget. |
|
| sync : | the synchronizer |
| widget : | the widget |
| Returns : | TRUE if this widget should be ignored in a container this is the case for eg. menu tearoffs items, and toolbar popout items. |
|
This method is used to obtain a sensibly ordered list of child widgets of the container associated with node. Essentialy this does something like gtk_container_children but preserving the visible order of the widgets in the list.
| sync : | the synchronizer |
| node : | the node |
| Returns : | An ordered list of child widgets of node |
void bonobo_ui_sync_stamp_root ( |
This asks the synchronizer to stamp all its associated root widget containers into the XML tree.
| sync : | the synchronizer |
|
This is used to determine which, of multiple synchronizers can be used to deal with a specific node type. Each synchronizer deals with different types of node.
| sync : | the synchronizer |
| node : | the node |
| Returns : | TRUE if the synchronizer can deal with this node type |
|
This is used to get an 'attached' widget - some widgets have associated widgets that are coupled in strange ways - eg. GtkMenuItem <-> GtkMenuShell It is neccessary to store the GtkContainer item of these couples in the XML tree, since then we can do things more genericaly and cleanly.
| sync : | the synchronizer |
| widget : | the widget |
| node : | the node |
| Returns : | an assoicated widget or NULL if none exists. |
void bonobo_ui_sync_state_update ( |
This is used to synchronize state with a stateful widget, eg. when a "state" attribute is set, this is not reflected in the normal 'state-sync' process, but occurs later with a set of state_updates to avoid re-enterancy problems.
| sync : | the synchronizer |
| widget : | the widget |
| new_state : | the new state |
|
This is a helper function that applies the hidden attribute from either the node or fallback to the cmd_node to the widget.
| sync : | the synchronizer |
| node : | the node |
| cmd_node : | the associated command node |
| widget : | the widget |
| Returns : | TRUE if the widget's hidden / shown state changed, this is needed to work around some nasty dock sizing bugs. |