katze-arrayaction

katze-arrayaction

Synopsis

#include <katze/katze.h>

                    KatzeArrayAction;
                    KatzeArrayActionClass;
GtkToolItem *       katze_array_action_create_tool_item_for
                                                        (KatzeArrayAction *array_action,
                                                         KatzeItem *item);
void                katze_array_action_generate_menu    (KatzeArrayAction *array_action,
                                                         KatzeArray *folder,
                                                         GtkMenuShell *menu,
                                                         GtkWidget *proxy);
KatzeArray *        katze_array_action_get_array        (KatzeArrayAction *array_action);
void                katze_array_action_set_array        (KatzeArrayAction *array_action,
                                                         KatzeArray *array);

Description

Details

KatzeArrayAction

typedef struct _KatzeArrayAction KatzeArrayAction;

KatzeArrayActionClass

typedef struct _KatzeArrayActionClass KatzeArrayActionClass;

katze_array_action_create_tool_item_for ()

GtkToolItem *       katze_array_action_create_tool_item_for
                                                        (KatzeArrayAction *array_action,
                                                         KatzeItem *item);

Creates a tool item for a particular item, that also reflects changes to its properties. In the case of an array, the item will create a popup menu with the contained items.

Note that the label is reasonably ellipsized for you, much like katze_image_menu_item_new_ellipsized().

array_action :

a KatzeArrayAction

item :

a KatzeItem

Returns :

a new tool item

katze_array_action_generate_menu ()

void                katze_array_action_generate_menu    (KatzeArrayAction *array_action,
                                                         KatzeArray *folder,
                                                         GtkMenuShell *menu,
                                                         GtkWidget *proxy);

Generates menu items according to folder, in the way they appear in automatically generated action proxies. The primary use is for implementing "populate-folder".

It is worth noting that folder can be any folder and can be generated dynamically if needed.

The proxy widget must be a related widget on the same screen, but doesn't have to be a proxy of the action.

array_action :

a KatzeArrayAction

folder :

the folder to represent

menu :

the menu shell to populate

proxy :

the proxy, or alternatively a widget in the same window

Since 0.2.8


katze_array_action_get_array ()

KatzeArray *        katze_array_action_get_array        (KatzeArrayAction *array_action);

katze_array_action_set_array ()

void                katze_array_action_set_array        (KatzeArrayAction *array_action,
                                                         KatzeArray *array);