BonoboWrapper

Name

BonoboWrapper -- Helper widget for controlling event delivery to embedded components

Synopsis



typedef     BonoboWrapper;
typedef     BonoboWrapperClass;
GtkWidget*  bonobo_wrapper_new              (void);
void        bonobo_wrapper_set_covered      (BonoboWrapper *wrapper,
                                             gboolean covered);
gboolean    bonobo_wrapper_is_covered       (BonoboWrapper *wrapper);
gboolean    bonobo_wrapper_get_visibility   (BonoboWrapper *wrapper);
void        bonobo_wrapper_set_visibility   (BonoboWrapper *wrapper,
                                             gboolean visible);

Description

This is a GtkWidget that acts as a cover on top of another GtkWidget. It enables you to control whether the containee can or can not receive events.

It is used by the BonoboViewFrame object initialization to cover the embedded component and provide control of event delivery on the containee. You should not control this wrapper directly when manipulating Bonobo components. You should use the bonobo_view_set_frame_set_covered() for BonoboView objects.

Details

BonoboWrapper

typedef struct {
	GtkBin bin;

	/* Private data. */
	BonoboWrapperPrivate *priv;
} BonoboWrapper;


BonoboWrapperClass

typedef struct {
	GtkBinClass parent_class;
} BonoboWrapperClass;


bonobo_wrapper_new ()

GtkWidget*  bonobo_wrapper_new              (void);

Creates a new wrapper widget. It starts covered by default.


bonobo_wrapper_set_covered ()

void        bonobo_wrapper_set_covered      (BonoboWrapper *wrapper,
                                             gboolean covered);

Sets the covered status of a wrapper widget by showing or hiding the cover window as appropriate.


bonobo_wrapper_is_covered ()

gboolean    bonobo_wrapper_is_covered       (BonoboWrapper *wrapper);

Queries the covered status of a wrapper widget.


bonobo_wrapper_get_visibility ()

gboolean    bonobo_wrapper_get_visibility   (BonoboWrapper *wrapper);


bonobo_wrapper_set_visibility ()

void        bonobo_wrapper_set_visibility   (BonoboWrapper *wrapper,
                                             gboolean visible);

Use this function to set the visibility of the wrapper's cover window. If the visibility flag is TRUE, then a stipple pattern will be drawn on the cover window to indicate when the wrapper's contents are covered. Of course, this stipple pattern will only be drawn when the cover is there; use bonobo_wrapper_set_covered() to enable the cover.

See Also

GtkWidget BonoboView BonoboViewFrame