GDK_ATOM_TO_POINTER()

#define GDK_ATOM_TO_POINTER(atom) (atom)

Converts a GdkAtom into a pointer type.

GDK_POINTER_TO_ATOM()

#define GDK_POINTER_TO_ATOM(ptr)  ((GdkAtom)(ptr))

Extracts a GdkAtom from a pointer. The GdkAtom must have been stored in the pointer with GDK_ATOM_TO_POINTER().

gdk_text_property_to_text_list ()

gint
gdk_text_property_to_text_list (GdkAtom encoding,
                                gint format,
                                const guchar *text,
                                gint length,
                                gchar ***list);

Converts a text string from the encoding as it is stored in a property into an array of strings in the encoding of the current local. (The elements of the array represent the nul-separated elements of the original text string.)

gdk_text_property_to_text_list_for_display ()

gint
gdk_text_property_to_text_list_for_display
                               (GdkDisplay *display,
                                GdkAtom encoding,
                                gint format,
                                const guchar *text,
                                gint length,
                                gchar ***list);

Convert a text string from the encoding as it is stored in a property into an array of strings in the encoding of the current locale. (The elements of the array represent the nul-separated elements of the original text string.)

Since 2.2

gdk_free_text_list ()

void
gdk_free_text_list (gchar **list);

Frees the array of strings created by gdk_text_property_to_text_list().

gdk_text_property_to_utf8_list ()

gint
gdk_text_property_to_utf8_list (GdkAtom encoding,
                                gint format,
                                const guchar *text,
                                gint length,
                                gchar ***list);

Convert a text property in the giving encoding to a list of UTF-8 strings.

gdk_text_property_to_utf8_list_for_display ()

gint
gdk_text_property_to_utf8_list_for_display
                               (GdkDisplay *display,
                                GdkAtom encoding,
                                gint format,
                                const guchar *text,
                                gint length,
                                gchar ***list);

Converts a text property in the given encoding to a list of UTF-8 strings.

Since 2.2

gdk_string_to_compound_text ()

gint
gdk_string_to_compound_text (const gchar *str,
                             GdkAtom *encoding,
                             gint *format,
                             guchar **ctext,
                             gint *length);

Converts a string from the encoding of the current locale into a form suitable for storing in a window property.

gdk_string_to_compound_text_for_display ()

gint
gdk_string_to_compound_text_for_display
                               (GdkDisplay *display,
                                const gchar *str,
                                GdkAtom *encoding,
                                gint *format,
                                guchar **ctext,
                                gint *length);

Convert a string from the encoding of the current locale into a form suitable for storing in a window property.

Since 2.2

gdk_free_compound_text ()

void
gdk_free_compound_text (guchar *ctext);

Frees the data returned from gdk_string_to_compound_text().

gdk_utf8_to_string_target ()

gchar *
gdk_utf8_to_string_target (const gchar *str);

Converts an UTF-8 string into the best possible representation as a STRING. The representation of characters not in STRING is not specified; it may be as pseudo-escape sequences \x{ABCD}, or it may be in some other form of approximation.

gdk_utf8_to_compound_text ()

gboolean
gdk_utf8_to_compound_text (const gchar *str,
                           GdkAtom *encoding,
                           gint *format,
                           guchar **ctext,
                           gint *length);

Convert from UTF-8 to compound text.

gdk_utf8_to_compound_text_for_display ()

gboolean
gdk_utf8_to_compound_text_for_display (GdkDisplay *display,
                                       const gchar *str,
                                       GdkAtom *encoding,
                                       gint *format,
                                       guchar **ctext,
                                       gint *length);

Converts from UTF-8 to compound text.

Since 2.2

gdk_atom_intern ()

GdkAtom
gdk_atom_intern (const gchar *atom_name,
                 gboolean only_if_exists);

Finds or creates an atom corresponding to a given string.

gdk_atom_intern_static_string ()

GdkAtom
gdk_atom_intern_static_string (const gchar *atom_name);

Finds or creates an atom corresponding to a given string.

Note that this function is identical to gdk_atom_intern() except that if a new GdkAtom is created the string itself is used rather than a copy. This saves memory, but can only be used if the string will always exist. It can be used with statically allocated strings in the main program, but not with statically allocated memory in dynamically loaded modules, if you expect to ever unload the module again (e.g. do not use this function in GTK+ theme engines).

Since 2.10

gdk_atom_name ()

gchar *
gdk_atom_name (GdkAtom atom);

Determines the string corresponding to an atom.

gdk_property_get ()

gboolean
gdk_property_get (GdkWindow *window,
                  GdkAtom property,
                  GdkAtom type,
                  gulong offset,
                  gulong length,
                  gint pdelete,
                  GdkAtom *actual_property_type,
                  gint *actual_format,
                  gint *actual_length,
                  guchar **data);

Retrieves a portion of the contents of a property. If the property does not exist, then the function returns FALSE, and GDK_NONE will be stored in actual_property_type.

gdk_property_change ()

void
gdk_property_change (GdkWindow *window,
                     GdkAtom property,
                     GdkAtom type,
                     gint format,
                     GdkPropMode mode,
                     const guchar *data,
                     gint nelements);

Changes the contents of a property on a window.

gdk_property_delete ()

void
gdk_property_delete (GdkWindow *window,
                     GdkAtom property);

Deletes a property from a window.

GdkAtom

typedef struct _GdkAtom            *GdkAtom;

An opaque type representing a string as an index into a table of strings on the X server.

GDK_NONE

#define GDK_NONE            _GDK_MAKE_ATOM (0)

A null value for GdkAtom, used in a similar way as None in the Xlib API.

enum GdkPropMode

Describes how existing data is combined with new data when using gdk_property_change().