Software: Apache/2.2.16 (Debian). PHP/5.3.3-7+squeeze19 uname -a: Linux mail.tri-specialutilitydistrict.com 2.6.32-5-amd64 #1 SMP Tue May 13 16:34:35 UTC uid=33(www-data) gid=33(www-data) groups=33(www-data) Safe-mode: OFF (not secure) /usr/share/doc/libbonoboui2-common/html/ drwxr-xr-x |
Viewing file: Select action/file-type:
SynopsisBonoboUIComponent; BonoboUIComponentPrivate; void (*BonoboUIListenerFn) (BonoboUIComponent *component, const char *path, Bonobo_UIComponent_EventType type, const char *state, gpointer user_data); void (*BonoboUIVerbFn) (BonoboUIComponent *component, gpointer user_data, const char *cname); BonoboUIComponentClass; BonoboUIComponent * bonobo_ui_component_construct (BonoboUIComponent *component, const char *name); BonoboUIComponent * bonobo_ui_component_new (const char *name); BonoboUIComponent * bonobo_ui_component_new_default (void); void bonobo_ui_component_set_name (BonoboUIComponent *component, const char *name); const char * bonobo_ui_component_get_name (BonoboUIComponent *component); void bonobo_ui_component_set_container (BonoboUIComponent *component, Bonobo_UIContainer container, CORBA_Environment *opt_ev); void bonobo_ui_component_unset_container (BonoboUIComponent *component, CORBA_Environment *opt_ev); Bonobo_UIContainer bonobo_ui_component_get_container (BonoboUIComponent *component); void bonobo_ui_component_add_verb (BonoboUIComponent *component, const char *cname, BonoboUIVerbFn fn, gpointer user_data); void bonobo_ui_component_add_verb_full (BonoboUIComponent *component, const char *cname, GClosure *closure); void bonobo_ui_component_remove_verb (BonoboUIComponent *component, const char *cname); void bonobo_ui_component_remove_verb_by_closure (BonoboUIComponent *component, GClosure *closure); void bonobo_ui_component_add_listener (BonoboUIComponent *component, const char *id, BonoboUIListenerFn fn, gpointer user_data); void bonobo_ui_component_add_listener_full (BonoboUIComponent *component, const char *id, GClosure *closure); void bonobo_ui_component_remove_listener (BonoboUIComponent *component, const char *cname); void bonobo_ui_component_remove_listener_by_closure (BonoboUIComponent *component, GClosure *closure); void bonobo_ui_component_set (BonoboUIComponent *component, const char *path, const char *xml, CORBA_Environment *opt_ev); void bonobo_ui_component_set_translate (BonoboUIComponent *component, const char *path, const char *xml, CORBA_Environment *opt_ev); void bonobo_ui_component_set_tree (BonoboUIComponent *component, const char *path, BonoboUINode *node, CORBA_Environment *ev); void bonobo_ui_component_rm (BonoboUIComponent *component, const char *path, CORBA_Environment *ev); gboolean bonobo_ui_component_path_exists (BonoboUIComponent *component, const char *path, CORBA_Environment *ev); CORBA_char * bonobo_ui_component_get (BonoboUIComponent *component, const char *path, gboolean recurse, CORBA_Environment *opt_ev); BonoboUINode * bonobo_ui_component_get_tree (BonoboUIComponent *component, const char *path, gboolean recurse, CORBA_Environment *opt_ev); void bonobo_ui_component_object_set (BonoboUIComponent *component, const char *path, Bonobo_Unknown control, CORBA_Environment *opt_ev); Bonobo_Unknown bonobo_ui_component_object_get (BonoboUIComponent *component, const char *path, CORBA_Environment *opt_ev); void bonobo_ui_component_widget_set (BonoboUIComponent *component, const char *path, GtkWidget *widget, CORBA_Environment *opt_ev); void bonobo_ui_component_freeze (BonoboUIComponent *component, CORBA_Environment *opt_ev); void bonobo_ui_component_thaw (BonoboUIComponent *component, CORBA_Environment *opt_ev); void bonobo_ui_component_set_prop (BonoboUIComponent *component, const char *path, const char *prop, const char *value, CORBA_Environment *opt_ev); gchar * bonobo_ui_component_get_prop (BonoboUIComponent *component, const char *path, const char *prop, CORBA_Environment *opt_ev); void bonobo_ui_component_set_status (BonoboUIComponent *component, const char *text, CORBA_Environment *opt_ev); BonoboUIVerb; #define BONOBO_UI_VERB (name,cb) #define BONOBO_UI_VERB_DATA (name,cb,data) #define BONOBO_UI_UNSAFE_VERB (name,cb) #define BONOBO_UI_UNSAFE_VERB_DATA (name,cb,data) #define BONOBO_UI_VERB_END void bonobo_ui_component_add_verb_list (BonoboUIComponent *component, const BonoboUIVerb *list); void bonobo_ui_component_add_verb_list_with_data (BonoboUIComponent *component, const BonoboUIVerb *list, gpointer user_data); DescriptionThe BonoboUIComponent is the client side portion of the UI merging scheme. It should be implemented by any component that wishes to merge menus / UI. The Component object is neccessary to receive notifications from the associated BonoboUIContainer. Notifications come in two forms - verbs and events. Verbs have an associated ( non translated ) name that is used to match them with callbacks. Events have an associated ( non translated ) id that does the same thing. Events pass a state string. Events are used for eg. toggle buttons, Verbs are used for eg. Menu items. Mostly you don't need to bother with creating your own BonoboUIComponent, if you implement a Control eg. a BonoboUIComponent is created at Control construction time and can be accessed thus: Example 4. Using the UI Component associated with a control
There are several standard placeholders that it is important for containers to implement, basing your UI on the doc/std-ui.xml is a very good starting point. Also in the above example the _label and _tip are not cmd / widget separated - for more information read doc/ui-xml.txt.
Most applications will should not use the BonoboUIComponent in this
way, there is a Example 5. A better way to create your UI
DetailsBonoboUIListenerFn ()void (*BonoboUIListenerFn) (BonoboUIComponent *component, const char *path, Bonobo_UIComponent_EventType type, const char *state, gpointer user_data);
BonoboUIVerbFn ()void (*BonoboUIVerbFn) (BonoboUIComponent *component, gpointer user_data, const char *cname);
BonoboUIComponentClasstypedef struct { BonoboObjectClass parent_class; POA_Bonobo_UIComponent__epv epv; gpointer dummy[6]; /* Signals */ void (*exec_verb) (BonoboUIComponent *comp, const char *cname); void (*ui_event) (BonoboUIComponent *comp, const char *path, Bonobo_UIComponent_EventType type, const char *state); /* Virtual XML Methods */ void (*freeze) (BonoboUIComponent *component, CORBA_Environment *opt_ev); void (*thaw) (BonoboUIComponent *component, CORBA_Environment *opt_ev); void (*xml_set) (BonoboUIComponent *component, const char *path, const char *xml, CORBA_Environment *ev); CORBA_char *(*xml_get) (BonoboUIComponent *component, const char *path, gboolean recurse, CORBA_Environment *ev); void (*xml_rm) (BonoboUIComponent *component, const char *path, CORBA_Environment *ev); void (*set_prop) (BonoboUIComponent *component, const char *path, const char *prop, const char *value, CORBA_Environment *opt_ev); gchar *(*get_prop) (BonoboUIComponent *component, const char *path, const char *prop, CORBA_Environment *opt_ev); gboolean (*exists) (BonoboUIComponent *component, const char *path, CORBA_Environment *ev); } BonoboUIComponentClass;
bonobo_ui_component_construct ()BonoboUIComponent * bonobo_ui_component_construct (BonoboUIComponent *component, const char *name);
Construct the UI component with name
bonobo_ui_component_new ()BonoboUIComponent * bonobo_ui_component_new (const char *name); Create a new UI component with the specified name
bonobo_ui_component_new_default ()BonoboUIComponent * bonobo_ui_component_new_default (void); Create a UI component with a unique default name constructed from various available system properties.
bonobo_ui_component_set_name ()void bonobo_ui_component_set_name (BonoboUIComponent *component, const char *name);
Set the
bonobo_ui_component_get_name ()const char * bonobo_ui_component_get_name (BonoboUIComponent *component);
bonobo_ui_component_set_container ()void bonobo_ui_component_set_container (BonoboUIComponent *component, Bonobo_UIContainer container, CORBA_Environment *opt_ev);
This associates this
bonobo_ui_component_unset_container ()void bonobo_ui_component_unset_container (BonoboUIComponent *component, CORBA_Environment *opt_ev);
This dis-associates the
bonobo_ui_component_get_container ()Bonobo_UIContainer bonobo_ui_component_get_container (BonoboUIComponent *component);
bonobo_ui_component_add_verb ()void bonobo_ui_component_add_verb (BonoboUIComponent *component, const char *cname, BonoboUIVerbFn fn, gpointer user_data); Add a verb to the UI component, that can be invoked by the container.
bonobo_ui_component_add_verb_full ()void bonobo_ui_component_add_verb_full (BonoboUIComponent *component, const char *cname, GClosure *closure); Add a verb to the UI component, that can be invoked by the container.
bonobo_ui_component_remove_verb ()void bonobo_ui_component_remove_verb (BonoboUIComponent *component, const char *cname); Remove a verb by it's unique name
bonobo_ui_component_remove_verb_by_closure ()void bonobo_ui_component_remove_verb_by_closure (BonoboUIComponent *component, GClosure *closure);
remove any verb handled by
bonobo_ui_component_add_listener ()void bonobo_ui_component_add_listener (BonoboUIComponent *component, const char *id, BonoboUIListenerFn fn, gpointer user_data); Add a listener for stateful events.
bonobo_ui_component_add_listener_full ()void bonobo_ui_component_add_listener_full (BonoboUIComponent *component, const char *id, GClosure *closure); Add a listener for stateful events.
bonobo_ui_component_remove_listener ()void bonobo_ui_component_remove_listener (BonoboUIComponent *component, const char *cname); Remove any listener by its unique id
bonobo_ui_component_remove_listener_by_closure ()void bonobo_ui_component_remove_listener_by_closure (BonoboUIComponent *component, GClosure *closure);
bonobo_ui_component_set ()void bonobo_ui_component_set (BonoboUIComponent *component, const char *path, const char *xml, CORBA_Environment *opt_ev);
Set the If you see blank menu items ( or just separators ) it's likely that you should be using bonobo_ui_component_set_translate which substantialy deprecates this routine.
bonobo_ui_component_set_translate ()void bonobo_ui_component_set_translate (BonoboUIComponent *component, const char *path, const char *xml, CORBA_Environment *opt_ev); This routine parses the XML strings, and converts any: _label="Hello World" type strings into the translated, and encoded format expected by the remote BonoboUIContainer.
bonobo_ui_component_set_tree ()void bonobo_ui_component_set_tree (BonoboUIComponent *component, const char *path, BonoboUINode *node, CORBA_Environment *ev);
Set the
bonobo_ui_component_rm ()void bonobo_ui_component_rm (BonoboUIComponent *component, const char *path, CORBA_Environment *ev);
This routine removes a chunk of the XML tree in the
BonoboUIContainer associated with
bonobo_ui_component_path_exists ()gboolean bonobo_ui_component_path_exists (BonoboUIComponent *component, const char *path, CORBA_Environment *ev);
bonobo_ui_component_get ()CORBA_char * bonobo_ui_component_get (BonoboUIComponent *component, const char *path, gboolean recurse, CORBA_Environment *opt_ev);
This routine fetches a chunk of the XML tree in the
BonoboUIContainer associated with
bonobo_ui_component_get_tree ()BonoboUINode * bonobo_ui_component_get_tree (BonoboUIComponent *component, const char *path, gboolean recurse, CORBA_Environment *opt_ev);
This routine fetches a chunk of the XML tree in the
BonoboUIContainer associated with
bonobo_ui_component_object_set ()void bonobo_ui_component_object_set (BonoboUIComponent *component, const char *path, Bonobo_Unknown control, CORBA_Environment *opt_ev);
This registers the
bonobo_ui_component_object_get ()Bonobo_Unknown bonobo_ui_component_object_get (BonoboUIComponent *component, const char *path, CORBA_Environment *opt_ev);
This returns the
bonobo_ui_component_widget_set ()void bonobo_ui_component_widget_set (BonoboUIComponent *component, const char *path, GtkWidget *widget, CORBA_Environment *opt_ev);
bonobo_ui_component_freeze ()void bonobo_ui_component_freeze (BonoboUIComponent *component, CORBA_Environment *opt_ev); This increments the freeze count on the associated BonoboUIContainer, (if not already frozen) this means that a batch of update operations can be performed without a re-render penalty per update. NB. if your GUI is frozen / not updating you probably have a freeze / thaw reference leak/
bonobo_ui_component_thaw ()void bonobo_ui_component_thaw (BonoboUIComponent *component, CORBA_Environment *opt_ev); This decrements the freeze count on the remote associated BonoboUIContainer, (if frozen). This means that a batch of update operations can be performed without a re-render penalty per update. NB. if your GUI is frozen / not updating you probably have a freeze / thaw reference leak/
bonobo_ui_component_set_prop ()void bonobo_ui_component_set_prop (BonoboUIComponent *component, const char *path, const char *prop, const char *value, CORBA_Environment *opt_ev);
This helper function sets an XML property ( or attribute )
on the XML node pointed at by
bonobo_ui_component_get_prop ()gchar * bonobo_ui_component_get_prop (BonoboUIComponent *component, const char *path, const char *prop, CORBA_Environment *opt_ev);
This helper function fetches an XML property ( or attribute )
from the XML node pointed at by
bonobo_ui_component_set_status ()void bonobo_ui_component_set_status (BonoboUIComponent *component, const char *text, CORBA_Environment *opt_ev);
This sets the contents of the status bar to
BonoboUIVerbtypedef struct { const char *cname; BonoboUIVerbFn cb; gpointer user_data; gpointer dummy; } BonoboUIVerb;
BONOBO_UI_VERB()#define BONOBO_UI_VERB(name,cb) { (name), (cb), NULL } This declares and fills a BonoboUIVerb structure suitable for use in constructing a lost of verbs to add with bonobo_ui_component_add_verb_list_with_data.
BONOBO_UI_VERB_DATA()#define BONOBO_UI_VERB_DATA(name,cb,data) { (name), (cb), (data) } This declares and fills a BonoboUIVerb structure suitable for use in constructing a lost of verbs to add with bonobo_ui_component_add_verb_list.
BONOBO_UI_UNSAFE_VERB()#define BONOBO_UI_UNSAFE_VERB(name,cb) { (name), ((BonoboUIVerbFn)(cb)), NULL }
As BONOBO_UI_VERB, but unsafely casts
BONOBO_UI_UNSAFE_VERB_DATA()#define BONOBO_UI_UNSAFE_VERB_DATA(name,cb,data) { (name), ((BonoboUIVerbFn)(cb)), (data) }
As BONOBO_UI_VERB_DATA, but unsafely casts
BONOBO_UI_VERB_END#define BONOBO_UI_VERB_END { NULL, NULL, NULL } The terminator BonoboUIVerb structure for a list of BonoboUIVerbs. bonobo_ui_component_add_verb_list ()void bonobo_ui_component_add_verb_list (BonoboUIComponent *component, const BonoboUIVerb *list); Add a list of verbs with no associated user_data, you probably want bonobo_ui_component_add_verb_list_with_data
bonobo_ui_component_add_verb_list_with_data ()void bonobo_ui_component_add_verb_list_with_data (BonoboUIComponent *component, const BonoboUIVerb *list, gpointer user_data); This is a helper function to save registering verbs individualy it allows registration of a great batch of verbs at one time in a list of BonoboUIVerb terminated by BONOBO_UI_VERB_END
Signal DetailsThe
|
|
the object which received the signal. |
|
|
|
user data set when the signal handler was connected. |
"ui-event"
signalvoid user_function (BonoboUIComponent *bonobouicomponent, gchar *arg1, gint arg2, gchar *arg3, gpointer user_data) : Run First
|
the object which received the signal. |
|
|
|
|
|
|
|
user data set when the signal handler was connected. |
:: Command execute :: | |
--[ c99shell v. 2.0 [PHP 7 Update] [25.02.2019] maintained by KaizenLouie | C99Shell Github | Generation time: 0.0084 ]-- |