![]() |
![]() |
![]() |
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. |