/usr/include/openbox/3.5/obt/link.h is in openbox-dev 3.5.0-2ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 | /* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*-
obt/link.h for the Openbox window manager
Copyright (c) 2009 Dana Jansens
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
See the COPYING file for a copy of the GNU General Public License.
*/
#ifndef __obt_link_h
#define __obt_link_h
#include <glib.h>
G_BEGIN_DECLS
struct _ObtPaths;
typedef enum {
OBT_LINK_TYPE_APPLICATION = 1,
OBT_LINK_TYPE_URL = 2,
OBT_LINK_TYPE_DIRECTORY = 3
} ObtLinkType;
typedef enum {
OBT_LINK_APP_STARTUP_NO_SUPPORT,
OBT_LINK_APP_STARTUP_PROTOCOL_SUPPORT,
OBT_LINK_APP_STARTUP_LEGACY_SUPPORT
} ObtLinkAppStartup;
/*! These bit flags are environments for links. Some links are used or not
used in various environments. */
typedef enum {
OBT_LINK_ENV_OPENBOX = 1 << 0,
OBT_LINK_ENV_GNOME = 1 << 1,
OBT_LINK_ENV_KDE = 1 << 2,
OBT_LINK_ENV_LXDE = 1 << 3,
OBT_LINK_ENV_ROX = 1 << 4,
OBT_LINK_ENV_XFCE = 1 << 5,
OBT_LINK_ENV_OLD = 1 << 6
} ObtLinkEnvFlags;
typedef enum {
/*! The app can be launched with a single local file */
OBT_LINK_APP_SINGLE_LOCAL = 1 << 0,
/*! The app can be launched with multiple local files */
OBT_LINK_APP_MULTI_LOCAL = 1 << 1,
/*! The app can be launched with a single URL */
OBT_LINK_APP_SINGLE_URL = 1 << 2,
/*! The app can be launched with multiple URLs */
OBT_LINK_APP_MULTI_URL = 1 << 3
} ObtLinkAppOpen;
typedef struct _ObtLink ObtLink;
ObtLink* obt_link_from_ddfile(const gchar *name, GSList *paths,
struct _ObtPaths *p);
void obt_link_ref(ObtLink *e);
void obt_link_unref(ObtLink *e);
/*! Returns TRUE if the file exists but says it should be ignored, with
the Hidden flag. No other functions can be used for the ObtLink
in this case. */
gboolean obt_link_deleted (ObtLink *e);
/*! Returns the type of object refered to by the .desktop file. */
ObtLinkType obt_link_type (ObtLink *e);
/*! Returns TRUE if the .desktop file should be displayed to users, given the
current environment. If FALSE, the .desktop file should not be showed.
This also uses the TryExec option if it is present.
@env A semicolon-deliminated list of environemnts. Can be one or more of:
GNOME, KDE, ROX, XFCE. Other environments not listed here may also
be supported. This can be null also if not listing any environment. */
gboolean obt_link_display(ObtLink *e, const gchar *env);
const gchar* obt_link_name (ObtLink *e);
const gchar* obt_link_generic_name (ObtLink *e);
const gchar* obt_link_comment (ObtLink *e);
/*! Returns the icon for the object referred to by the .desktop file.
Returns either an absolute path, or a string which can be used to find the
icon using the algorithm given by:
http://freedesktop.org/wiki/Specifications/icon-theme-spec?action=show&redirect=Standards/icon-theme-spec
*/
const gchar* obt_link_icon (ObtLink *e);
const gchar *obt_link_url_path(ObtLink *e);
const gchar* obt_link_app_executable (ObtLink *e);
/*! Returns the path in which the application should be run */
const gchar* obt_link_app_path (ObtLink *e);
gboolean obt_link_app_run_in_terminal (ObtLink *e);
const gchar*const* obt_link_app_mime_types (ObtLink *e);
const GQuark* obt_link_app_categories (ObtLink *e, gulong *n);
/*! Returns a combination of values in the ObtLinkAppOpen enum,
specifying if the application can be launched to open one or more files
and URLs. */
ObtLinkAppOpen obt_link_app_open(ObtLink *e);
ObtLinkAppStartup obt_link_app_startup_notify(ObtLink *e);
const gchar* obt_link_app_startup_wmclass(ObtLink *e);
G_END_DECLS
#endif
|