WnckActionMenu

## WnckActionMenu WnckActionMenu — a menu widget, used to manipulate a window. |

## Stability Level

Unstable, unless otherwise indicated

## Synopsis

    #include <libwnck/libwnck.h>

                        WnckActionMenu;
    GtkWidget*          wnck_action_menu_new                (WnckWindow *window);
    GtkWidget*          wnck_create_window_action_menu      (WnckWindow *window);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkMenuShell
                                     +----GtkMenu
                                           +----WnckActionMenu

## Implemented Interfaces

WnckActionMenu implements AtkImplementorIface and GtkBuildable.

## Properties

      "window"                   gpointer              : Read / Write / Construct Only

## Description

A WnckActionMenu is a menu containing items to manipulate a window. Relevant actions are displayed in the menu, and updated if the window state changes. The content of this menu is synchronized with the similar menu available in Metacity.

### Note

If there is only one workspace with a viewport, the WnckActionMenu will contain items to move the window in the viewport as if the viewport feature was used to create workspaces. This is useful since viewport is generally used as an alternative way to create virtual desktops.

The WnckActionMenu does not support moving the window in the viewport if there are multiple workspaces on the screen: those two notions are so similar that having both at the same time would result in a menu which would be confusing to the user.

## Details

### WnckActionMenu

    typedef struct _WnckActionMenu WnckActionMenu;

The WnckActionMenu struct contains only private fields and should not be directly accessed.

### wnck_action_menu_new ()

    GtkWidget*          wnck_action_menu_new                (WnckWindow *window);

Creates a new WnckActionMenu. The WnckActionMenu will be filled with menu items for window operations on `window`.

`window` : | the WnckWindow for which a menu will be created.
Returns : | a newly created WnckActionMenu.

Since 2.22

### wnck_create_window_action_menu ()

    GtkWidget*          wnck_create_window_action_menu      (WnckWindow *window);

### Warning

`wnck_create_window_action_menu` has been deprecated since version 2.22 and should not be used in newly-written code. Use `wnck_action_menu_new()` instead.

Creates a new WnckActionMenu. The WnckActionMenu will be filled with menu items for window operations on `window`.

`window` : | the WnckWindow for which a menu will be created.
Returns : | a newly created WnckActionMenu.

## Property Details

### The `"window"` property

      "window"                   gpointer              : Read / Write / Construct Only

The window that will be manipulated through this menu.

## See Also

WnckWindow