Commit 9bf93a6f authored by Matthias Clasen's avatar Matthias Clasen

Add docs

svn path=/trunk/; revision=19167
parent 61666179
2007-12-12 Matthias Clasen <mclasen@redhat.com>
* gdk/gdkapplaunchcontext.c: Add docs
2007-12-12 Matthias Clasen <mclasen@redhat.com> 2007-12-12 Matthias Clasen <mclasen@redhat.com>
* gdk/gdkapplaunchcontext.[hc]: Implement GAppLaunchContext * gdk/gdkapplaunchcontext.[hc]: Implement GAppLaunchContext
......
2007-12-12 Matthias Clasen <mclasen@redhat.com>
* gdk/gdk-docs.sgml:
* gdk/gdk-sections.txt: Add GdkAppLaunchContext
2007-12-11 Mathias Hasselmann <mathias@openismus.com> 2007-12-11 Mathias Hasselmann <mathias@openismus.com>
* docs/reference/gtk/tmpl/gtkdnd.sgml: * docs/reference/gtk/tmpl/gtkdnd.sgml:
......
...@@ -30,6 +30,7 @@ ...@@ -30,6 +30,7 @@
<!ENTITY gdk-Display SYSTEM "xml/gdkdisplay.xml"> <!ENTITY gdk-Display SYSTEM "xml/gdkdisplay.xml">
<!ENTITY gdk-DisplayManager SYSTEM "xml/gdkdisplaymanager.xml"> <!ENTITY gdk-DisplayManager SYSTEM "xml/gdkdisplaymanager.xml">
<!ENTITY gdk-Multihead SYSTEM "multihead.sgml"> <!ENTITY gdk-Multihead SYSTEM "multihead.sgml">
<!ENTITY gdk-AppLaunchContext SYSTEM "xml/gdkapplaunchcontext.xml">
<!ENTITY version SYSTEM "version.xml"> <!ENTITY version SYSTEM "version.xml">
]> ]>
...@@ -84,6 +85,8 @@ ...@@ -84,6 +85,8 @@
&gdk-Pango-Interaction; &gdk-Pango-Interaction;
&gdk-Cairo-Interaction; &gdk-Cairo-Interaction;
&gdk-X-Window-System-Interaction; &gdk-X-Window-System-Interaction;
&gdk-AppLaunchContext;
</reference> </reference>
<index> <index>
...@@ -110,5 +113,8 @@ ...@@ -110,5 +113,8 @@
<index role="2.12"> <index role="2.12">
<title>Index of new symbols in 2.12</title> <title>Index of new symbols in 2.12</title>
</index> </index>
<index role="2.16">
<title>Index of new symbols in 2.16</title>
</index>
</book> </book>
...@@ -1334,3 +1334,16 @@ GDK_HAVE_WCTYPE_H ...@@ -1334,3 +1334,16 @@ GDK_HAVE_WCTYPE_H
gdk_iswalnum gdk_iswalnum
gdk_iswspace gdk_iswspace
</SECTION> </SECTION>
<SECTION>
<INCLUDE>gdk/gdkapplaunchcontext.h</INCLUDE>
<TITLE>Application launching</TITLE>
<FILE>gdkapplaunchcontext</FILE>
gdk_app_launch_context_new
gdk_app_launch_context_set_display
gdk_app_launch_context_set_screen
gdk_app_launch_context_set_desktop
gdk_app_launch_context_set_timestamp
gdk_app_launch_context_set_icon
gdk_app_launch_context_set_icon_name
</SECTION>
...@@ -108,6 +108,16 @@ gdk_app_launch_context_init (GdkAppLaunchContext *context) ...@@ -108,6 +108,16 @@ gdk_app_launch_context_init (GdkAppLaunchContext *context)
context->priv->workspace = -1; context->priv->workspace = -1;
} }
/**
* gdk_app_launch_context_set_display:
* @context: a #GdkAppLaunchContext
* @display: a #GdkDisplay
*
* Sets the display on which applications will be launched when
* using this context. See also gdk_app_launch_context_set_screen().
*
* Since: 2.16
*/
void void
gdk_app_launch_context_set_display (GdkAppLaunchContext *context, gdk_app_launch_context_set_display (GdkAppLaunchContext *context,
GdkDisplay *display) GdkDisplay *display)
...@@ -121,6 +131,18 @@ gdk_app_launch_context_set_display (GdkAppLaunchContext *context, ...@@ -121,6 +131,18 @@ gdk_app_launch_context_set_display (GdkAppLaunchContext *context,
if (display) if (display)
context->priv->display = g_object_ref (display); context->priv->display = g_object_ref (display);
} }
/**
* gdk_app_launch_context_set_screen:
* @context: a #GdkAppLaunchContext
* @screen: a #GdkScreen
*
* Sets the screen on which applications will be launched when
* using this context. See also gdk_app_launch_context_set_display().
* If both @screen and @display are set, the @screen takes priority.
*
* Since: 2.16
*/
void void
gdk_app_launch_context_set_screen (GdkAppLaunchContext *context, gdk_app_launch_context_set_screen (GdkAppLaunchContext *context,
GdkScreen *screen) GdkScreen *screen)
...@@ -135,7 +157,19 @@ gdk_app_launch_context_set_screen (GdkAppLaunchContext *context, ...@@ -135,7 +157,19 @@ gdk_app_launch_context_set_screen (GdkAppLaunchContext *context,
context->priv->screen = g_object_ref (screen); context->priv->screen = g_object_ref (screen);
} }
/**
* gdk_app_launch_context_set_desktop:
* @context: a #GdkAppLaunchContext
* @desktop: the number of a workspace, or -1
*
* Sets the workspace on which applications will be launched when
* using this context when running under a window manager that
* supports multiple workspaces, as described in the
* <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
* Window Manager Hints</ulink>.
*
* Since: 2.16
*/
void void
gdk_app_launch_context_set_desktop (GdkAppLaunchContext *context, gdk_app_launch_context_set_desktop (GdkAppLaunchContext *context,
gint desktop) gint desktop)
...@@ -143,6 +177,16 @@ gdk_app_launch_context_set_desktop (GdkAppLaunchContext *context, ...@@ -143,6 +177,16 @@ gdk_app_launch_context_set_desktop (GdkAppLaunchContext *context,
context->priv->workspace = desktop; context->priv->workspace = desktop;
} }
/**
* gdk_app_launch_context_set_timestamp:
* @context: a #GdkAppLaunchContext
* @timestamp: a timestamp
*
* Sets the timestamp of @context. The timestamp should ideally
* be taken from the event that triggered the launch.
*
* Since: 2.16
*/
void void
gdk_app_launch_context_set_timestamp (GdkAppLaunchContext *context, gdk_app_launch_context_set_timestamp (GdkAppLaunchContext *context,
guint32 timestamp) guint32 timestamp)
...@@ -150,6 +194,16 @@ gdk_app_launch_context_set_timestamp (GdkAppLaunchContext *context, ...@@ -150,6 +194,16 @@ gdk_app_launch_context_set_timestamp (GdkAppLaunchContext *context,
context->priv->timestamp = timestamp; context->priv->timestamp = timestamp;
} }
/**
* gdk_app_launch_context_set_icon:
* @context: a #GdkAppLaunchContext
* @icon: a #GIcon, or %NULL
*
* Sets the icon for applications that are launched with this
* context. See also gdk_app_launch_context_set_icon_name().
*
* Since: 2.16
*/
void void
gdk_app_launch_context_set_icon (GdkAppLaunchContext *context, gdk_app_launch_context_set_icon (GdkAppLaunchContext *context,
GIcon *icon) GIcon *icon)
...@@ -164,6 +218,19 @@ gdk_app_launch_context_set_icon (GdkAppLaunchContext *context, ...@@ -164,6 +218,19 @@ gdk_app_launch_context_set_icon (GdkAppLaunchContext *context,
context->priv->icon = g_object_ref (icon); context->priv->icon = g_object_ref (icon);
} }
/**
* gdk_app_launch_context_set_icon_name:
* @context: a #GdkAppLaunchContext
* @icon_name: an icon name, or %NULL
*
* Sets the icon for applications that are launched with this
* context. The @icon_name will be interpreted in the same way
* as the Icon field in desktop files.
* See also gdk_app_launch_context_set_icon(). If both @icon
* and @icon_name are set, the @icon_name takes priority.
*
* Since: 2.16
*/
void void
gdk_app_launch_context_set_icon_name (GdkAppLaunchContext *context, gdk_app_launch_context_set_icon_name (GdkAppLaunchContext *context,
const char *icon_name) const char *icon_name)
...@@ -172,12 +239,22 @@ gdk_app_launch_context_set_icon_name (GdkAppLaunchContext *context, ...@@ -172,12 +239,22 @@ gdk_app_launch_context_set_icon_name (GdkAppLaunchContext *context,
context->priv->icon_name = g_strdup (icon_name); context->priv->icon_name = g_strdup (icon_name);
} }
/**
* gdk_app_launch_context_new:
*
* Creates a new #GdkAppLaunchContext.
*
* Returns: a new #GdkAppLaunchContext
*
* Since: 2.16
*/
GdkAppLaunchContext * GdkAppLaunchContext *
gdk_app_launch_context_new (void) gdk_app_launch_context_new (void)
{ {
GdkAppLaunchContext *context; GdkAppLaunchContext *context;
context = g_object_new (gdk_app_launch_context_get_type (), NULL); context = g_object_new (gdk_app_launch_context_get_type (), NULL);
return context; return context;
} }
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment