Bonobo API Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
struct BonoboView; typedef BonoboViewClass; #define BONOBO_VIEW_VERB_FUNC (fn) void (*BonoboViewVerbFunc) ( |
It is the programmer's responsibility to keep the contents of all the views displaying the same information (modulo per-view state, like the zoom factor). Since GtkWidgets do not support linear zooming, it is essential to understand that you cannot use GtkWidgets inside your view - you must write custom rendering code.
An embeddable view is not a Control - by this I mean that it does not control its own sizing, rendering or layout. It is entirely a slave to the parent with respect to this. A View should never render scroll bars into itself ( unless, exceptionaly if it is activated, and allows the user to pan around a larger area ). Essentialy a non-activated view should only show things that it will print, and should render WYSIWYG as much as possible. Embeddable's views scale linearly to obey the zoom level they are given.
If your component provides menus, then you use the bonobo_view_get_remote_ui_container() to retrieve a Bonobo_UIContainer handle to merge your menu / toolbar items into.
Your component must support zooming to be a true embeddable. There are two ways to support zoom.
Zoom to fit - for simple items such as images this makes sense the item simply displays all of itself scaled to the available size allocated to the GtkWidget.
Scaled - this obeys the zoom factor as set by the container, it also crops the display of the image to the GtkWindow. Connect to the "set_zoom_factor" signal. This signal gives a floating point value that indicates the desired zoom factor set by your container.
typedef struct { BonoboControlClass parent_class; POA_Bonobo_View__epv epv; /* Signals */ void (*do_verb) (BonoboView *view, const CORBA_char *verb_name); void (*set_zoom_factor) (BonoboView *view, double zoom); } BonoboViewClass; |
void (*BonoboViewVerbFunc) ( |
|
item_creator might be NULL for widget-based views.
|
This function creates a new BonoboView object for widget
void bonobo_view_set_embeddable ( |
This function associates view with the specified GnomeEmbeddabe object, embeddable.
void bonobo_view_set_view_frame ( |
Sets the ViewFrame for view to view_frame.
|