gdkPropertyGet: gdkPropertyGet
Description
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.Usage
gdkPropertyGet(object, property, type, offset, length, pdelete)
Value
A list containing the following elements:retval[logical] TRUE if data was sucessfully received and stored
in data, otherwise FALSE.actual.property.type[GdkAtom] location to store the actual type of
the property.actual.format[integer] location to store the actual return format of the
data; either 8, 16 or 32 bits.actual.length[integer] location to store the length of the retrieved data, in
bytes. Data returned in the 32 bit format is stored
in a long variable, so the actual number of 32 bit
elements should be be calculated via
actual.length/sizeof(glong) to ensure portability to
64 bit systems.data[raw] location to store a pointer to the data. The retrieved
data should be freed with g() when you are finished
using it.The xgetwindowproperty() function that gdkPropertyGet
uses has a very confusing and complicated set of semantics.
Unfortunately, gdkPropertyGet makes the situation
worse instead of better (the semantics should be considered
undefined), and also prints warnings to stderr in cases where it
should return a useful error to the program. You are advised to use
xgetwindowproperty() directly until a replacement function for
gdkPropertyGet
is provided.
[object Object]
internal