 |
 |
 |
GNOME Docking Library Reference Manual |  |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
Synopsis
struct GdlDockPlaceholder; GtkWidget * gdl_dock_placeholder_new (const gchar *name,GdlDockObject *object,GdlDockPlacement position,gboolean sticky); void gdl_dock_placeholder_attach (GdlDockPlaceholder *ph,GdlDockObject *object);
Object Hierarchy
GObject +----GInitiallyUnowned +----GtkWidget +----GtkContainer +----GdlDockObject +----GdlDockPlaceholder
Properties
"floating" gboolean : Read / Write / Construct Only "floatx" gint : Read / Write / Construct Only "floaty" gint : Read / Write / Construct Only "height" gint : Read / Write / Construct "host" GdlDockObject* : Read / Write "next-placement" GdlDockPlacement : Read / Write "sticky" gboolean : Read / Write / Construct Only "width" gint : Read / Write / Construct
Description
A dock placeholder is a widget allowing to keep track of a docking place. Unfortunately, all the details of the initial goal have been forgotten and the code has still some issues.
In GDL 3.6, this part has been deprecated. Placeholder widgets are not used anymore. Instead, closed widgets are hidden but kept in the widget hierarchy.
Details
struct GdlDockPlaceholder
struct GdlDockPlaceholder;
Warning
GdlDockPlaceholder is deprecated and should not be used in newly-written code.
gdl_dock_placeholder_new ()
GtkWidget * gdl_dock_placeholder_new (const gchar *name,GdlDockObject *object,GdlDockPlacement position,gboolean sticky);
Warning
gdl_dock_placeholder_new has been deprecated since version 3.6 and should not be used in newly-written code.
Creates a new dock placeholder at object place. This is a kind of marker
allowing you to dock new items later at this place. It is not completely
working though.
|
Unique name for identifying the dock object. |
|
Corresponding GdlDockObject |
|
The position to dock a new item in object
|
|
TRUE if the placeholder move with the object
|
Returns : |
The newly created placeholder. |
gdl_dock_placeholder_attach ()
void gdl_dock_placeholder_attach (GdlDockPlaceholder *ph,GdlDockObject *object);
Warning
gdl_dock_placeholder_attach has been deprecated since version 3.6 and should not be used in newly-written code.
Move the placeholder to the position of object.
|
The GdlDockPlaceholder object |
|
A new GdlDockObject |
Property Details
The "floating" property
"floating" gboolean : Read / Write / Construct Only
Whether the placeholder is standing in for a floating toplevel dock.
Default value: FALSE
The "floatx" property
"floatx" gint : Read / Write / Construct Only
X coordinate for dock when floating.
Allowed values: >= -1
Default value: -1
The "floaty" property
"floaty" gint : Read / Write / Construct Only
Y coordinate for dock when floating.
Allowed values: >= -1
Default value: -1
The "height" property
"height" gint : Read / Write / Construct
Height for the widget when it's attached to the placeholder.
Allowed values: >= -1
Default value: -1
The "host" property
"host" GdlDockObject* : Read / Write
The dock object this placeholder is attached to.
The "next-placement" property
"next-placement" GdlDockPlacement : Read / Write
The position an item will be docked to our host if a request is made to dock to us.
Default value: GDL_DOCK_CENTER
The "sticky" property
"sticky" gboolean : Read / Write / Construct Only
Whether the placeholder will stick to its host or move up the hierarchy when the host is redocked.
Default value: FALSE
The "width" property
"width" gint : Read / Write / Construct
Width for the widget when it's attached to the placeholder.
Allowed values: >= -1
Default value: -1