|  |  |  | Clutter-Gtk 1.4.4 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
struct GtkClutterEmbed; struct GtkClutterEmbedClass; GtkWidget * gtk_clutter_embed_new (void); ClutterActor * gtk_clutter_embed_get_stage (GtkClutterEmbed *embed); void gtk_clutter_embed_set_use_layout_size (GtkClutterEmbed *embed,gboolean use_layout_size); gboolean gtk_clutter_embed_get_use_layout_size (GtkClutterEmbed *embed);
  GObject
   +----GInitiallyUnowned
         +----GtkWidget
               +----GtkContainer
                     +----GtkClutterEmbed
GtkClutterEmbed is a GTK+ widget embedding a ClutterStage inside a GTK+ application.
By using a GtkClutterEmbed widget is possible to build, show and interact with a scene built using Clutter inside a GTK+ application.
Though GtkClutterEmbed is a GtkContainer subclass,
it is not a real GTK+ container; GtkClutterEmbed is required to
implement GtkContainer in order to embed a GtkWidget through the
GtkClutterActor class. Calling gtk_container_add() on a GtkClutterEmbed
will trigger an assertion. It is strongly advised not to override the
GtkContainer implementation when subclassing
GtkClutterEmbed.
struct GtkClutterEmbed;
A GtkWidget containing the default Clutter stage.
The GtkClutterEmbed structure contains only private data and should be accessed using the provided API.
struct GtkClutterEmbedClass {
};
Base class for GtkClutterEmbed.
The GtkClutterEmbedClass contains only private data.
GtkWidget *         gtk_clutter_embed_new               (void);
Creates a new GtkClutterEmbed widget. This widget can be used to build a scene using Clutter API into a GTK+ application.
| Returns : | the newly created GtkClutterEmbed | 
ClutterActor *      gtk_clutter_embed_get_stage         (GtkClutterEmbed *embed);
Retrieves the ClutterStage from embed. The returned stage can be
used to add actors to the Clutter scene.
| 
 | a GtkClutterEmbed | 
| Returns : | the Clutter stage. You should never destroy or unref the returned actor. [transfer none] | 
void gtk_clutter_embed_set_use_layout_size (GtkClutterEmbed *embed,gboolean use_layout_size);
Changes the way embed requests size. If use_layout_size is
TRUE, the embed widget will request the size that the
LayoutManager reports as the preferred size. This means that
a Gtk+ window will automatically get the natural and minimum
toplevel window sizes. This is useful when the contents of the
clutter stage is similar to a traditional UI.
If use_layout_size is FALSE (which is the default) then embed
will not request any size and its up to the embedder to make sure
there is some size (by setting a custom size on the widget or a default
size on the toplevel. This makes more sense when using the embed
as a viewport into a potentially unlimited clutter space.
| 
 | a GtkClutterEmbed | 
| 
 | a boolean | 
Since 1.4
gboolean            gtk_clutter_embed_get_use_layout_size
                                                        (GtkClutterEmbed *embed);
Retrieves whether the embedding uses the layout size, see
gtk_clutter_embed_set_use_layout_size() for details.
| 
 | a GtkClutterEmbed | 
| Returns : | TRUEif reporting stage size as widget size,FALSEotherwise. | 
Since 1.4
"use-layout-size" property  "use-layout-size"          gboolean              : Read / Write / Construct
The GtkWidget to be embedded into the GtkClutterActor
Default value: FALSE
Since 1.4