Top | ![]() |
![]() |
![]() |
![]() |
gboolean | (*AwnAppletInitFunc) () |
AwnApplet * | (*AwnAppletInitPFunc) () |
AwnApplet * | awn_applet_new () |
const gchar * | awn_applet_get_canonical_name () |
GtkPositionType | awn_applet_get_pos_type () |
void | awn_applet_set_pos_type () |
AwnPathType | awn_applet_get_path_type () |
void | awn_applet_set_path_type () |
gint | awn_applet_get_offset () |
gint | awn_applet_get_offset_at () |
void | awn_applet_set_offset () |
gint | awn_applet_get_size () |
void | awn_applet_set_size () |
const gchar * | awn_applet_get_uid () |
void | awn_applet_set_uid () |
AwnAppletFlags | awn_applet_get_behavior () |
void | awn_applet_set_behavior () |
GtkWidget * | awn_applet_create_default_menu () |
guint | awn_applet_inhibit_autohide () |
void | awn_applet_uninhibit_autohide () |
GdkNativeWindow | awn_applet_docklet_request () |
GtkWidget * | awn_applet_create_pref_item () |
GtkWidget * | awn_applet_create_about_item () |
GtkWidget * | awn_applet_create_about_item_simple () |
gchar * | canonical-name | Read / Write / Construct Only |
gchar * | display-name | Read / Write |
gint | max-size | Read / Write |
gint | offset | Read / Write |
gfloat | offset-modifier | Read / Write |
gint | panel-id | Read / Write / Construct Only |
gint64 | panel-xid | Read |
gint | path-type | Read / Write / Construct |
GtkPositionType | position | Read / Write |
gboolean | quit-on-delete | Read / Write |
gboolean | show-all-on-embed | Read / Write |
gint | size | Read / Write |
gchar * | uid | Read / Write / Construct |
void | applet-deleted | Run First |
void | flags-changed | Run First |
void | menu-creation | Run First |
void | offset-changed | Run First |
void | origin-changed | Run Last |
void | panel-configure-event | Run Last |
void | position-changed | Run First |
void | size-changed | Run First |
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkWindow ╰── GtkPlug ╰── AwnApplet ╰── AwnAppletSimple
gboolean
(*AwnAppletInitFunc) (AwnApplet *applet
);
Function prototype used as entry point for applets. Hook to have an AwnApplet built for you.
AwnApplet * (*AwnAppletInitPFunc) (const gchar *canonical_name
,const gchar *uid
,gint panel_id
);
Function prototype used as entry point for applets. Hook to build your own AwnApplet.
AwnApplet * awn_applet_new (const gchar *canonical_name
,const gchar *uid
,gint panel_id
);
Creates a new AwnApplet which tries to connect via DBus to AwnPanel
with the given ID. You can pass zero panel_id
to not connect to any panel.
const gchar *
awn_applet_get_canonical_name (AwnApplet *applet
);
Retrieve the applet's canonical name.
GtkPositionType
awn_applet_get_pos_type (AwnApplet *applet
);
Gets current position of the applet. See awn_applet_set_pos_type()
.
This value corresponds to the value used by the associated panel.
void awn_applet_set_pos_type (AwnApplet *applet
,GtkPositionType position
);
Sets current position of the applet. Note that setting the position emits the “position-changed” signal.
AwnPathType
awn_applet_get_path_type (AwnApplet *applet
);
Gets currently used path type for this applet. This value corresponds to the value used by the associated panel.
void awn_applet_set_path_type (AwnApplet *applet
,AwnPathType path
);
Sets path type used by this applet. See awn_applet_get_offset_at()
.
gint
awn_applet_get_offset (AwnApplet *applet
);
Gets current offset set for the applet. This value corresponds
to the value used by the associated panel.
see_also
: awn_applet_get_offset_at()
.
gint awn_applet_get_offset_at (AwnApplet *applet
,gint x
,gint y
);
see_also
: awn_applet_set_path_type()
.
Gets offset for widget with [x
, y
] coordinates with respect to the current
path type.
void awn_applet_set_offset (AwnApplet *applet
,gint offset
);
Sets offset used by this applet. Note that setting the offset emits the “offset-changed” signal.
gint
awn_applet_get_size (AwnApplet *applet
);
Gets the current size set for the applet. This value corresponds to the value used by the associated panel.
void awn_applet_set_size (AwnApplet *applet
,gint size
);
Sets new size for the applet. Note that setting the size emits the “size-changed” signal.
const gchar *
awn_applet_get_uid (AwnApplet *applet
);
Gets the unique ID for the applet.
void awn_applet_set_uid (AwnApplet *applet
,const gchar *uid
);
Sets new unique ID for the applet.
AwnAppletFlags
awn_applet_get_behavior (AwnApplet *applet
);
Gets the flags set for this applet.
void awn_applet_set_behavior (AwnApplet *applet
,AwnAppletFlags flags
);
Sets behavior flags for this applet. Note that setting the flags to AWN_APPLET_IS_SEPARATOR or AWN_APPLET_IS_EXPANDER will send a DBus request to the associated AwnPanel which will destroy the socket used by this applet.
GtkWidget *
awn_applet_create_default_menu (AwnApplet *applet
);
Creates an default applet context menu. Includes a dock preferences menu item
guint awn_applet_inhibit_autohide (AwnApplet *applet
,const gchar *reason
);
Requests the associated AwnPanel to disable autohide (if the panel is
already hidden it will unhide) until a call to
awn_applet_uninhibit_autohide()
with the returned ID is made.
void awn_applet_uninhibit_autohide (AwnApplet *applet
,guint cookie
);
Uninhibits autohide of the associated AwnPanel.
See awn_applet_inhibit_autohide()
.
applet |
an AwnApplet. |
|
cookie |
inhibit cookie returned by the call
to |
GdkNativeWindow awn_applet_docklet_request (AwnApplet *applet
,gint min_size
,gboolean shrink
,gboolean expand
);
Requests docklet mode from the associated AwnPanel - all applets will be hidden and only one window will be shown.
applet |
AwnApplet instance. |
|
min_size |
Minimum size required. |
|
shrink |
If true and the panel has greater size than requested, it will shrink to min_size. Otherwise current panel size will be allocated. |
|
expand |
If true the embedded window will be allowed to expand, otherwise the window will be restricted to min_size. |
GtkWidget *
awn_applet_create_pref_item (void
);
Create a Dock Preferences menu item.
GtkWidget * awn_applet_create_about_item (AwnApplet *applet
,const gchar *copyright
,AwnAppletLicense license
,const gchar *version
,const gchar *comments
,const gchar *website
,const gchar *website_label
,const gchar *icon_name
,const gchar *translator_credits
,const gchar **authors
,const gchar **artists
,const gchar **documenters
);
Creates an about dialog and an associated menu item for use in the applet's
context menu. The copyright
and license
parameters are
mandatory. The rest are optional. See also GtkAboutDialog for a description
of the parameters other than license
.
applet |
An AwnApplet. |
|
copyright |
The copyright holder string. |
|
license |
Must be one of the values enumerated in AwnAppletLicense. |
|
version |
Applet version string. |
|
comments |
Comment string. |
|
website |
Website string. |
|
website_label |
Website label string. |
|
icon_name |
Icon name. |
|
translator_credits |
Translator's credit string. |
|
authors |
Array of author strings. |
|
artists |
Array of artist strings. |
|
documenters |
Array of documentor strings. |
GtkWidget * awn_applet_create_about_item_simple (AwnApplet *applet
,const gchar *copyright
,AwnAppletLicense license
,const gchar *version
);
Creates an about dialog and an associated menu item for use in the applet's
context menu. The copyright
and license
parameters are
mandatory. See also GtkAboutDialog for a description
of the parameters other than license
.
applet |
An AwnApplet. |
|
copyright |
The copyright holder string. |
|
license |
Must be one of the values enumerated in AwnAppletLicense. |
|
version |
Applet version string. |
“canonical-name”
property “canonical-name” gchar *
The canonical name of the applet. The format should be considered the same as a GObject property name: a-zA-Z In English, the first character must be a lowercase letter of the English alphabet, and the following character(s) can be one or more lowercase English letters, numbers, and/or minus characters.
For all applets in the Awn Extras project, this name should be the same as the main directory as the applet sources.
Flags: Read / Write / Construct Only
Default value: NULL
“display-name”
property “display-name” gchar *
Display name for the applet.
Flags: Read / Write
Default value: NULL
“max-size”
property “max-size” gint
The maximum visible size of the applet.
Flags: Read / Write
Allowed values: >= 0
Default value: 48
“offset”
property “offset” gint
The icon offset of the bar.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“offset-modifier”
property “offset-modifier” gfloat
The offset modifier for non-linear path types.
Flags: Read / Write
Default value: 1
“panel-id”
property “panel-id” gint
The id of the Awn Panel the applet connects to.
Flags: Read / Write / Construct Only
Allowed values: >= 0
Default value: 0
“panel-xid”
property “panel-xid” gint64
The XID of the awn panel the applet is connected to.
Flags: Read
Default value: 0
“path-type”
property “path-type” gint
Path used on the panel.
Flags: Read / Write / Construct
Allowed values: [0,1]
Default value: 0
“position”
property “position” GtkPositionType
The current bar position.
Flags: Read / Write
Default value: GTK_POS_BOTTOM
“quit-on-delete”
property “quit-on-delete” gboolean
Whether the applet quits when it's socket is destroyed.
Flags: Read / Write
Default value: TRUE
“show-all-on-embed”
property “show-all-on-embed” gboolean
The applet will automatically call show_all when it's embedded in the socket.
Flags: Read / Write
Default value: TRUE
“size”
property “size” gint
The current visible size of the bar.
Flags: Read / Write
Allowed values: >= 0
Default value: 48
“applet-deleted”
signalvoid user_function (AwnApplet *awnapplet, gpointer user_data)
awnapplet |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“flags-changed”
signalvoid user_function (AwnApplet *awnapplet, gint arg1, gpointer user_data)
awnapplet |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“menu-creation”
signalvoid user_function (AwnApplet *awnapplet, GtkMenu *arg1, gpointer user_data)
awnapplet |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“offset-changed”
signalvoid user_function (AwnApplet *awnapplet, gint arg1, gpointer user_data)
awnapplet |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“origin-changed”
signalvoid user_function (AwnApplet *awnapplet, GdkRectangle *arg1, gpointer user_data)
awnapplet |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“panel-configure-event”
signalvoid user_function (AwnApplet *awnapplet, GdkEvent *arg1, gpointer user_data)
awnapplet |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“position-changed”
signalvoid user_function (AwnApplet *awnapplet, GtkPositionType arg1, gpointer user_data)
awnapplet |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
“size-changed”
signalvoid user_function (AwnApplet *awnapplet, gint arg1, gpointer user_data)
awnapplet |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First