![]() |
![]() |
![]() |
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
);
typedef struct { GObjectClass base; unsigned clip; /* Automaticaly clip to object bounding box */ /* Virtuals */ void (*state_init) (GogView *); 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.
GObjectClass |
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
);
GSList const * gog_view_get_toolkit (GogView *view
);
|
GogView |
Returns : |
toolkit associated with given view. [element-type GogTool][transfer none GogTool] |
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 (GogView *view
,GogViewAllocation const *bbox
);
|
|
|
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
);
When called available
holds the available space and requisition
is populated
with the desired size based on that input and other elements of the view or
its model's state (eg the position).
Remember that the size request is not necessarily the size a view will actually be allocated.
|
a GogView |
|
available space. |
|
a GogViewRequisition. |