Top | ![]() |
![]() |
![]() |
![]() |
MxWindow * | mx_window_new () |
MxWindow * | mx_window_new_with_clutter_stage () |
MxWindow * | mx_window_get_for_stage () |
ClutterActor * | mx_window_get_child () |
void | mx_window_set_child () |
MxToolbar * | mx_window_get_toolbar () |
void | mx_window_set_toolbar () |
gboolean | mx_window_get_has_toolbar () |
void | mx_window_set_has_toolbar () |
gboolean | mx_window_get_small_screen () |
void | mx_window_set_small_screen () |
gboolean | mx_window_get_fullscreen () |
void | mx_window_set_fullscreen () |
void | mx_window_set_title () |
const gchar * | mx_window_get_title () |
void | mx_window_set_icon_name () |
const gchar * | mx_window_get_icon_name () |
void | mx_window_set_icon_from_cogl_texture () |
ClutterStage * | mx_window_get_clutter_stage () |
void | mx_window_get_window_position () |
void | mx_window_set_window_position () |
void | mx_window_get_window_size () |
void | mx_window_set_window_size () |
void | mx_window_present () |
void | mx_window_set_window_rotation () |
MxWindowRotation | mx_window_get_window_rotation () |
void | mx_window_show () |
void | mx_window_hide () |
ClutterActor * | child | Read / Write |
ClutterStage * | clutter-stage | Read / Write / Construct Only |
gboolean | fullscreen | Read / Write |
gboolean | has-toolbar | Read / Write |
gchar * | icon-cogl-texture | Read / Write |
gchar * | icon-name | Read / Write |
gboolean | small-screen | Read / Write |
gchar * | title | Read / Write |
MxToolbar * | toolbar | Read / Write |
MxWindowRotation | window-rotation | Read / Write |
gfloat | window-rotation-angle | Read |
ClutterTimeline * | window-rotation-timeline | Read |
MxWindow is a platform-specific window, providing functions for moving, resizing, icons and rotation. Every window has an associated ClutterStage in which its children are kept. This ClutterStage can be used in the normal way, but to take advantage of automatic resizing and rotation, the MxWindow functions should be used.
When the MxWindow loses its last reference, its contents are destroyed.
MxWindow *
mx_window_new_with_clutter_stage (ClutterStage *stage
);
Creates a new MxWindow, using stage
as the backing ClutterStage. This
function is meant for use primarily for embedding a MxWindow into
a foreign stage when using a Clutter toolkit integration library.
MxWindow *
mx_window_get_for_stage (ClutterStage *stage
);
Gets the MxWindow parent of the ClutterStage, if it exists.
ClutterActor *
mx_window_get_child (MxWindow *window
);
Get the primary child of the window. See mx_window_set_child()
.
void mx_window_set_child (MxWindow *window
,ClutterActor *actor
);
Adds actor
to the window and sets it as the primary child. When the
stage managed in the window changes size, the child will be resized
to match it.
MxToolbar *
mx_window_get_toolbar (MxWindow *window
);
Retrieves the toolbar associated with the window.
void mx_window_set_toolbar (MxWindow *window
,MxToolbar *toolbar
);
Sets the toolbar associated with the window.
Since: 1.2
gboolean
mx_window_get_has_toolbar (MxWindow *window
);
Determines whether the window has a toolbar or not.
See mx_window_set_has_toolbar()
.
void mx_window_set_has_toolbar (MxWindow *window
,gboolean toolbar
);
Sets whether the window has a toolbar or not. If the window has a toolbar, client-side window decorations will be enabled.
gboolean
mx_window_get_small_screen (MxWindow *window
);
Determines if the window is in small-screen mode.
See mx_window_set_small_screen()
.
void mx_window_set_small_screen (MxWindow *window
,gboolean small_screen
);
Enables or disables small-screen mode. This mode is meant primarily for platforms with limited screen-space, such as netbooks. When enabled, the window will take up all available room and will disable moving and resizing.
gboolean
mx_window_get_fullscreen (MxWindow *window
);
Determines if the window has been set to be in fullscreen mode.
Since: 1.2
void mx_window_set_fullscreen (MxWindow *window
,gboolean fullscreen
);
Set the window to be in fullscreen mode or windowed mode.
Setting fullscreen mode doesn't necessarily mean the window is actually fullscreen. Setting this property is only a request to the underlying window system.
Since: 1.2
void mx_window_set_title (MxWindow *window
,const gchar *title
);
Sets the title used for the window, the results of which are window-system specific.
Since: 1.2
const gchar *
mx_window_get_title (MxWindow *window
);
Retrieves the title used for the window.
Since: 1.2
void mx_window_set_icon_name (MxWindow *window
,const gchar *icon_name
);
Set an icon-name to use for the window icon. The icon will be looked up from the default theme.
const gchar *
mx_window_get_icon_name (MxWindow *window
);
Gets the currently set window icon name. This will be NULL
if there is none
set, or the icon was set with mx_window_set_icon_from_cogl_texture()
.
void mx_window_set_icon_from_cogl_texture (MxWindow *window
,CoglHandle texture
);
Sets the window icon from a texture. This will take precedence over any currently set icon-name.
ClutterStage *
mx_window_get_clutter_stage (MxWindow *window
);
Gets the ClutterStage managed by the window.
void mx_window_get_window_position (MxWindow *window
,gint *x
,gint *y
);
Retrieves the absolute position of the window on the screen.
window |
an MxWindow |
|
x |
A pointer for the x-coordinate. |
[out] |
y |
A pointer for the y-coordinate. |
[out] |
void mx_window_set_window_position (MxWindow *window
,gint x
,gint y
);
Sets the absolute position of the window on the screen.
void mx_window_get_window_size (MxWindow *window
,gint *width
,gint *height
);
Retrieves the size of the display area of the window, taking into account any window border. This includes the area occupied by the window's toolbar, if it's enabled.
Since: 1.2
void mx_window_set_window_size (MxWindow *window
,gint width
,gint height
);
Sets the size of the window, taking into account any window border. This corresponds to the window's available area for its child, minus the area occupied by the window's toolbar, if it's enabled.
Setting the window size may involve a request to the underlying windowing system, and may not immediately be reflected.
Since: 1.2
void
mx_window_present (MxWindow *window
);
Present the window. The actual behaviour is specific to the window system.
Since: 1.2
void mx_window_set_window_rotation (MxWindow *window
,MxWindowRotation rotation
);
Set the rotation of the window.
Since: 1.2
MxWindowRotation
mx_window_get_window_rotation (MxWindow *window
);
Retrieve the rotation of the window.
Since: 1.2
struct MxWindow;
The contents of this structure is private and should only be accessed using the provided API.
struct MxWindowClass { GObjectClass parent_class; /* signals, not vfuncs */ void (*destroy) (MxWindow *window); /* padding for future expansion */ void (*_padding_0) (void); void (*_padding_1) (void); void (*_padding_2) (void); void (*_padding_3) (void); void (*_padding_4) (void); };
“child”
property“child” ClutterActor *
ClutterActor used as the window child.
Owner: MxWindow
Flags: Read / Write
“clutter-stage”
property“clutter-stage” ClutterStage *
ClutterStage to use as the window.
Owner: MxWindow
Flags: Read / Write / Construct Only
“fullscreen”
property“fullscreen” gboolean
Window should be set to full-screen mode.
Owner: MxWindow
Flags: Read / Write
Default value: FALSE
“has-toolbar”
property“has-toolbar” gboolean
Window should have a toolbar.
Owner: MxWindow
Flags: Read / Write
Default value: TRUE
“icon-cogl-texture”
property“icon-cogl-texture” gchar *
CoglTexture to use for the window icon.
Owner: MxWindow
Flags: Read / Write
Default value: NULL
“icon-name”
property“icon-name” gchar *
Icon name to use for the window icon.
Owner: MxWindow
Flags: Read / Write
Default value: NULL
“small-screen”
property“small-screen” gboolean
Window should occupy the entire screen contents, without explicitly setting itself fullscreen.
Owner: MxWindow
Flags: Read / Write
Default value: FALSE
“title”
property“title” gchar *
Title to use for the window.
Owner: MxWindow
Flags: Read / Write
Default value: NULL
“toolbar”
property“toolbar” MxToolbar *
The MxToolbar associated with the window.
Owner: MxWindow
Flags: Read / Write
“window-rotation”
property“window-rotation” MxWindowRotation
The window's rotation.
Owner: MxWindow
Flags: Read / Write
Default value: MX_WINDOW_ROTATION_0
“window-rotation-angle”
property“window-rotation-angle” gfloat
The current angle of rotation about the z-axis for the window.
Owner: MxWindow
Flags: Read
Allowed values: [0,360]
Default value: 0
“window-rotation-timeline”
property“window-rotation-timeline” ClutterTimeline *
The timeline used for the window rotation transition animation.
Owner: MxWindow
Flags: Read