| GOffice Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
GogView; GogViewClass; GogViewAllocation; GogViewPadding; GogViewRequisition; GogView * gog_view_find_child_view (GogView const *container,GogObject const *target_model); GogObject * gog_view_get_model (GogView const *view); void gog_view_get_natural_size (GogView *view,GogViewRequisition *requisition); char * gog_view_get_tip_at_point (GogView *view,double x,double y); GogTool * gog_view_get_tool_at_point (GogView *view,double x,double y,GogObject **gobj); GSList const * gog_view_get_toolkit (GogView *view); GogView * gog_view_get_view_at_point (GogView *view,double x,double y,GogObject **obj,GogTool **tool); void gog_view_padding_request (GogView *view,GogViewAllocation const *bbox,GogViewPadding *padding); void gog_view_queue_redraw (GogView *view); void gog_view_queue_resize (GogView *view); void gog_view_render (GogView *view,GogViewAllocation const *bbox); void gog_view_render_toolkit (GogView *view); void gog_view_size_allocate (GogView *view,GogViewAllocation const *allocation); void gog_view_size_child_request (GogView *view,GogViewRequisition const *available,GogViewRequisition *req,GogViewRequisition *min_req); void gog_view_size_request (GogView *view,GogViewRequisition const *available,GogViewRequisition *requisition); gboolean gog_view_update_sizes (GogView *view);
GObject
+----GogView
+----GogAxisBaseView
+----GogOutlinedView
+----GogPlotView
GBoxed +----GogViewAllocation
typedef struct {
GObjectClass base;
unsigned clip; /* Automaticaly clip to object bounding box */
/* Virtuals */
void (*state_init) (GogView *view);
void (*padding_request) (GogView *view, GogViewAllocation const *bbox,
GogViewPadding *padding);
void (*size_request) (GogView *view, GogViewRequisition const *available,
GogViewRequisition *requisition);
void (*size_allocate) (GogView *view, GogViewAllocation const *allocation);
void (*render) (GogView *view, GogViewAllocation const *bbox);
void (*build_toolkit) (GogView *view);
char *(*get_tip_at_point) (GogView *view, double x, double y);
void (*natural_size) (GogView *view, GogViewRequisition *req);
} GogViewClass;
the GogViewClass::clip firled should be set to TRUE to clip drawings to
the vew allocation.
| base class. | |
| state intialization. | |
| padding request. | |
| size request. | |
| size allocate. | |
| render to cairo. | |
| builds the associated toolkit. | |
| gets tip at pointer position. | |
| gets natural size. |
GogView * gog_view_find_child_view (GogView const *container,GogObject const *target_model);
Find the GogView contained in container that corresponds to model.
void gog_view_get_natural_size (GogView *view,GogViewRequisition *requisition);
char * gog_view_get_tip_at_point (GogView *view,double x,double y);
Gets a tip string related to the position as defined by (x,y) in view.
|
GogView |
|
x position |
|
y position |
Returns : |
the newly allocated tip string if the view class supports that or NULL. |
GogTool * gog_view_get_tool_at_point (GogView *view,double x,double y,GogObject **gobj);
|
GogView |
|
in coords |
|
in coords |
|
pointed object or NULL |
Returns : |
tool under cursor for a given view, or NULL. [transfer none]
|
GSList const * gog_view_get_toolkit (GogView *view);
|
GogView |
Returns : |
toolkit associated with given view. [element-type GogTool][transfer none] |
GogView * gog_view_get_view_at_point (GogView *view,double x,double y,GogObject **obj,GogTool **tool);
Gets view under cursor, searching recursively from view. Corresponding object
is stored in obj. This object may or may not be view->model of pointed view.
This function also stores tool under cursor, for the pointed view.
void gog_view_padding_request (GogView *view,GogViewAllocation const *bbox,GogViewPadding *padding);
void gog_view_queue_redraw (GogView *view);
Requests a redraw for the entire graph.
|
a GogView |
void gog_view_queue_resize (GogView *view);
Flags a view to have its size renegotiated; should be called when a model for some reason has a new size request. For example, when you change the size of a legend.
|
a GogView |
void gog_view_render_toolkit (GogView *view);
Render toolkit elements.
|
GogView |
void gog_view_size_allocate (GogView *view,GogViewAllocation const *allocation);
Assign a size and position to a GogView. Primarilly used by containers.
|
a GogView |
|
position and size to be allocated to view
|
void gog_view_size_child_request (GogView *view,GogViewRequisition const *available,GogViewRequisition *req,GogViewRequisition *min_req);
Computes additional requision in req which must be added to parent requisition,
and minimum requisition in min_req which is minimum space for displaying all
children.
|
a GogView |
|
the amount of space available in total |
|
additionnal requisition |
|
minimum size for displaying all children |
void gog_view_size_request (GogView *view,GogViewRequisition const *available,GogViewRequisition *requisition);
Determines the desired size of a view.
Note, that the virtual method deviates slightly from this function. This
function will zero requisition before calling the virtual method.
Remember that the size request is not necessarily the size a view will actually be allocated.
|
a GogView |
|
available space. |
|
a GogViewRequisition. |