## Win32 Specific Support

Win32 Specific Support — Win32 specific API

## Synopsis

    void                clutter_win32_disable_event_retrieval
                                                            (void);
    gboolean            clutter_win32_set_stage_foreign     (ClutterStage *stage,
                                                             HWND hwnd);
    ClutterStage *      clutter_win32_get_stage_from_window (HWND hwnd);
    HWND                clutter_win32_get_stage_window      (ClutterStage *stage);

## Description

The Win32 backend for Clutter provides some specific API, allowing integration with the Win32 API for embedding and manipulating the stage window.

The ClutterWin32 API is available since Clutter 0.8

## Details

### clutter_win32_disable_event_retrieval ()

    void                clutter_win32_disable_event_retrieval
                                                            (void);

Disables retrieval of Windows messages in the main loop. Use to create event-less canvas.

This function can only be called before calling `clutter_init()`.

Since 0.8

### clutter_win32_set_stage_foreign ()

    gboolean            clutter_win32_set_stage_foreign     (ClutterStage *stage,
                                                             HWND hwnd);

Target the ClutterStage to use an existing external window handle.

`stage` : | a ClutterStage
`hwnd` : | an existing window handle
Returns : | `TRUE` if foreign window is valid

Since 0.8

### clutter_win32_get_stage_from_window ()

    ClutterStage *      clutter_win32_get_stage_from_window (HWND hwnd);

Gets the stage for a particular window.

`hwnd` : | a window handle
Returns : | The stage or NULL if a stage does not exist for the window.

Since 0.8

### clutter_win32_get_stage_window ()

    HWND                clutter_win32_get_stage_window      (ClutterStage *stage);

Gets the stage's window handle

`stage` : | a ClutterStage
Returns : | An HWND for the stage window.

Since 0.8